diff --git a/contrib/docs/UPGRADE b/contrib/docs/UPGRADE index dc7a735a6f0a95adfe70024479e004ef3d3cd844..852fc886824765caeb0193c9be33a55a6d4ce662 100644 --- a/contrib/docs/UPGRADE +++ b/contrib/docs/UPGRADE @@ -2718,8 +2718,167 @@ Checking your indexed attributes Check that all you index still match with valid attributes present in your ldap directory +Migrate FusionDirectory from 1.0.20 to 1.1 +========================================== +Ubuntu 12.0.4 TLS users +======================= + +FusionDirectory needs the php-cas library for CAS server support. This library can normally be found in universe in the Ubuntu repositories. + +In case you did not find it, grab the deb from there and install it: + +http://packages.ubuntu.com/trusty/all/php-cas/download + +and select your favorite mirror + +Removed plugins +=============== + +- If you used kolab2 plugin you need to remove the plugin and its schema with the following command + +apt-get remove fusiondirectory-plugin-kolab2 +apt-get remove fusiondirectory-plugin-kolab2-schema + + +==== Upgrade schema2ldif ==== + +For Jessie distribution add extra repository + +# fusiondirectory debian-extra repository +deb http://repos.fusiondirectory.org/debian-extra jessie main + +- Update the package list and upgrade schema2ldif + +apt-get update +apt-get install schema2ldif + +==== Upgrade FusionDirectory first ==== + +- Upgrade FusionDirectory core package before other ones to avoid dependencies errors: + +apt-get install fusiondirectory + +- Upgrade FusionDirectory schema package too. + +apt-get install fusiondirectory-schema + +==== Upgrade of LDAP directory ==== + +- Upgrade the core schemas + +fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/core-fd-conf.schema +fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/core-fd.schema + +==== Upgrade of LDAP directory ==== + +- if you are using the argonaut plugin you have to update its schema + +fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/argonaut-fd.schema + +- if you are using the dhcp plugin you have to update its schema + +fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/dhcp-fd.schema + +- if you are using the fai plugin you have to update its schema + +fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/fai.schema + +- if you are using the mail plugin you have to update its schema + +fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/mail-fd.schema + +- if you are using the systems plugin you have to update its schema + +fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/service-fd.schema +fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/systems-fd-conf.schema +fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/systems-fd.schema + +Migrate old objects +=================== + +- If you have systems use this command to migrate them + +fusiondirectory-setup --migrate-systems + +- If you have phones use this command to migrate them + +fusiondirectory-setup --migrate-phones + +- If you have winstations use this command to migrate them + +fusiondirectory-setup --migrate-winstations + +Check for deprecated attributes and objectClasses in your LDAP +============================================================== + +The list-deprecated option of fusiondirectory-setup show deprecated attributes and objectClasses for FusionDirectory +fusiondirectory-setup --list-deprecated +List deprecated attributes and objectclasses +Deprecated attributes: + fdRfc2307bis (FusionDirectory - rfc2307bis) - 1.3.6.1.4.1.38414.8.10.1 + gosaDefaultPrinter (Defines a default printer a user owns) - 1.3.6.1.4.1.10098.1.1.12.13 + gosaUser (GOsa - DN of a user) - 1.3.6.1.4.1.10098.1.1.12.2 + gotoLogoffScript (GOto - specifies a LogoffScript) - 1.3.6.1.4.1.10098.1.1.11.19 + gotoSyslogServer (GOto - Gonicus Terminal Concept, value syslogServer.) - 1.3.6.1.4.1.10098.1.1.1.1 + gotoHotplugDeviceDN (GOto - points to hotplug devices) - 1.3.6.1.4.1.10098.1.1.11.18 + argonautLdap2zoneAllowNotify (Fusion Directory - Argonaut, allow notify.) - 1.3.6.1.4.1.38414.2.13.2 + fdAccountRDN (FusionDirectory - use a placeholder pattern for generating account RDNs) - 1.3.6.1.4.1.38414.8.12.2 + fdMailMethod (FusionDirectory - Mail method) - 1.3.6.1.4.1.38414.10.10.1 + fdPrimaryGroupFilter (FusionDirectory - Primary group filter) - 1.3.6.1.4.1.38414.8.14.1 + fdPasswordHook (FusionDirectory - Password hook (external command)) - 1.3.6.1.4.1.38414.8.13.4 + fdCopyPaste (FusionDirectory - (de)Activate copy/paste) - 1.3.6.1.4.1.38414.8.14.5 + fdIdGenerator (FusionDirectory - An automatic way to generate new user ids) - 1.3.6.1.4.1.38414.8.12.4 + fdPersonalTitleInDN (FusionDirectory - Personal title in dn) - 1.3.6.1.4.1.38414.8.12.5 + fdSnapshotAdminPassword (FusionDirectory - Snaphost admin password) - 1.3.6.1.4.1.38414.8.17.5 + gotoLogonScript (GOto - specifies a LogonScript) - 1.3.6.1.4.1.10098.1.1.11.10 + gotoMode (GOto - Gonicus Terminal Concept, Terminal is active.) - 1.3.6.1.4.1.10098.1.1.1.24 + fdSnapshotURI (FusionDirectory - Snaphost URI) - 1.3.6.1.4.1.38414.8.17.3 + fdSnapshotAdminDn (FusionDirectory - Snaphost admin dn) - 1.3.6.1.4.1.38414.8.17.4 + gotoHotplugDevice (GOto - keeps hotplug devices) - 1.3.6.1.4.1.10098.1.1.11.14 + gosaObject (GOsa - DN of an object) - 1.3.6.1.4.1.10098.1.1.12.3 + gotoLdapServer (LDAP server to use) - 1.3.6.1.4.1.10098.1.1.1.38 +Deprecated objectClasses: + gotoTerminalTemplate (GOto - Gonicus Terminal Concept, objectclass) - 1.3.6.1.4.1.10098.1.2.1.35 + gotoEnvironment (GOto - contains environment settings) - 1.3.6.1.4.1.10098.1.2.1.32 + gosaLockEntry (GOsa - Class for GOsa locking) - 1.3.6.1.4.1.10098.1.2.1.19.2 + goServer (Server description) - 1.3.6.1.4.1.10098.1.2.1.27 + GOhard (Gonicus Hardware definitions, objectclass) - 1.3.6.1.4.1.10098.1.2.1.3 + fdAsteriskPluginConf (FusionDirectory asterisk plugin configuration) - 1.3.6.1.4.1.38414.19.2.1 + gotoDevice (GOto - contains environment settings) - 1.3.6.1.4.1.10098.1.2.1.42 + gotoWorkstation (GOto - Gonicus Terminal Concept, objectclass) - 1.3.6.1.4.1.10098.1.2.1.30 + gosaUserTemplate (GOsa - Class for GOsa User Templates) - 1.3.6.1.4.1.10098.1.2.1.19.11 + gotoPrinter (GOto - Gonicus Terminal Concept, objectclass) - 1.3.6.1.4.1.10098.1.2.1.31 + gotoTerminal (GOto - Gonicus Terminal Concept, objectclass) - 1.3.6.1.4.1.10098.1.2.1.1 + gotoWorkstationTemplate (GOto - Gonicus Terminal Concept, objectclass) - 1.3.6.1.4.1.10098.1.2.1.34 + +The check-deprecated option will output a list of dn using old attributes and objectClasses of they are present in your ldap server + +fusiondirectory-setup --check-deprecated +List LDAP entries using deprecated attributes or objectclasses +There are no entries in the LDAP using obsolete attributes +There are no entries in the LDAP using obsolete classes + +The ldif-deprecated option will output an ldif file on the console that you can use with ldapmodify to clean you ldap server from old attributes. + +fusiondirectory-setup --ldif-deprecated > remove_deprecated.ldif + +If they are old objectClasses it will warn you and you will have to remove them by hand, they have been specified at the check-deprecated step. + +Please read it carefully before applying :!::!: + + +==== Checking your indexed attributes ==== + +Check that all you index still match with valid attributes present in your ldap directory + +==== New format for repository service ==== + +If you have a repository service. +Open and save it back so it will use the new format + +Enjoy :) --- * Further information