Commit 533e6a65 authored by Benoit Mortier's avatar Benoit Mortier
Browse files

Updating UPGRADE release notes

Signed-off-by: default avatarBenoit Mortier <>
parent 0c64802d
......@@ -457,6 +457,214 @@ fusiondirectory-setup –ldif-deprecated will output an ldif file on the console
!! Please read it carefully before applying !!
Migrate FusionDirectory from to 1.0.9
Backup you template First
The template system has been completely rewritten, and the old template will not be converted, so you need to backup them, remove them from FusionDirectory and then redo them.
The new system is much cleaner because template are stored in they own branch now and are the basis for having template for the whole application in the future.
Moved Attributes
We cleaned the core of FusionDirectory to only used classical attributes and objectClass, so the FusionDirectory special attributes on the first page of FusionDirectory
are now managed by the personal plugin.
The personal plugin has been made to manage all kind of personal data and is best suited to contain those data not normalized.
So of you use personalTitle, dateOfBirth, gender you will need to install the personal plugin.
- 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
Removed obsolete plugins
In this version we removed obsolete plugin, because they where based on software no longer existing
or needed an sql backend and we decided they need to be rewritten using the now ldap backend of those softwares :
asterisk : old plugin not maintainable anymore based on the sql backend, but now asterisk has an ldap backend has well.
fax : old code based on the gofax software from gonicus, not maintained anymore upstream.
openstack-compute : openstack management interface changed and this plugin is no longer relevant
uw-imap : long gone imap server, nobody that whe know still use it
They are no longer supported and should be removed from your installation
apt-get remove fusiondirectory-plugin-asterisk
apt-get remove fusiondirectory-plugin-fax
apt-get remove fusiondirectory-plugin-openstack-compute
apt-get remove fusiondirectory-plugin-uwimap
New Plugin for peoples using a mix of groupOfNames and posixGroup on the same object
We cleaned the code of FusionDirectory and by default it make posixGroup or clean standard compliant groupOfNames.
If you need a mix of groupOfNames and posixGroup on the same object you will need to install a new plugin called mixedgroups.
! Please take note that this plugin is for special cases and need modified core schema. !
If you need to have a link between user and groups you are better using the standard compliant groupOfNames or roles for examples for web applications.
apt-get install fusiondirectory-plugin-mixedgroups
Upgrade of LDAP directory
- Upgrade Core FusionDirectory Schema
The password recovery schema has been migrated into the core schema so you must remove it first
fusiondirectory-insert-schema -e recovery-fd
Are you sure you want to empty schema(s) recovery-fd? [Yes/No]?
- Upgrade the core-fd.schema and core-fd-conf.schema
fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/core-fd.schema
fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/core-fd-conf.schema
- Upgrade the argonaut.schema if you use the argonaut plugin
fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/argonaut-fd.schema
- Upgrade the fai-fd-conf.schema if you use the fai plugin
fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/fai-fd-conf.schema
- Upgrade the mail-fd.schema if you use the mail plugin
fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/mail-fd.schema
- Upgrade the personal-fd.schema if you use the personal plugin
fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/personal-fd.schema
- Upgrade the proxy-fd.schema if you use the squid plugin
fusiondirectory-insert-schema -m /etc/ldap/schema/fusiondirectory/proxy-fd.schema
- Upgrade the service-fd.schema, systems-fd.schema, systems-fd-conf.schema if you use the system plugin
The Phone object has been migrated to the system plugin due to the removal of the asterisk plugin.
fusiondirectory-insert-schema -e asterisk-fd-conf
Are you sure you want to empty schema(s) asterisk-fd-conf? [Yes/No]?
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
Check for deprecated attributes and objectClasses in your LDAP
fusiondirectory-setup --list-deprecated show deprecated attributes and objectClasses for FusionDirectory
List deprecated attributes and objectclasses
Deprecated attributes:
gotoXResolution (GOto - Gonicus Terminal Concept, value xResolution.) -
ghSoundAdapter (Hardware definitions, value soundAdapter) -
gotoShare (GOto - specifies a share) -
fdSnapshotAdminDn (FusionDirectory - Snaphost admin dn) -
gotoXDriver (GOto - Gonicus Terminal Concept, value xDriver.) -
gotoXMouseType (Hardware definitions, value Type of mouse) -
gotoLpdEnable (GOto - Gonicus Terminal Concept, value lpdEnable.) -
fdAccountRDN (FusionDirectory - use a placeholder pattern for generating account RDNs) -
gotoScannerBackend (GOto - Gonicus Terminal Concept, value scannerBackend.) -
gotoXVsync (GOto - Gonicus Terminal Concept, value xVsync.) -
gotoSysStatus (Keeps current system status - info shown in GOsa) -
academicTitle (Field to represent the academic title) -
gotoXKbModel (GOto - Gonicus Terminal Concept, value xKbmodel.) -
fdSnapshotURI (FusionDirectory - Snaphost URI) -
ghMemSize (Hardware definitions, value memSize) -
gotoProfileQuota (GOto - save quota for home) -
gotoScannerClients (GOto - Gonicus Terminal Concept, value scannerClients.) -
fdPersonalTitleInDN (FusionDirectory - Personal title in dn) -
fdCopyPaste (FusionDirectory - (de)Activate copy/paste) -
gotoFloppyEnable (GOto - Gonicus Terminal Concept, value floppyEnable.) -
ghIdeDev (Hardware definitions, value ideDev) -
gotoXMouseport (GOto - Gonicus Terminal Concept, value xMouseport.) -
gotoXKbLayout (GOto - Gonicus Terminal Concept, value xKblayout.) -
gotoAutoFs (GOto - Gonicus Terminal Concept, value autofs.) -
gotoProfileFlags (GOto - Flags for Profile handling - C is for caching) -
gosaDefaultLanguage (GOsa - Defines the default language for a user) -
fdSnapshotAdminPassword (FusionDirectory - Snaphost admin password) -
gotoHardwareChecksum (GOto - quick way to see if something has changed) -
gotoProfileServer (GOto - specifies the profile server) -
gotoXMouseButtons (GOto - Gonicus Terminal Concept, value xMouseButtons.) -
gotoXHsync (GOto - Gonicus Terminal Concept, value xHsync.) -
ghCpuType (Hardware definitions, value cpuType) -
gotoLpdServer (GOto - Gonicus Terminal Concept, value lpdServer.) -
ghScsiDev (Hardware definitions, value scsiDev) -
ghNetNic (Hardware definitions, value Network Device) -
fdPasswordHook (FusionDirectory - Password hook (external command)) -
ghGfxAdapter (Hardware definitions, value Grafikkarte) -
gotoScannerModel (GOto - Gonicus Terminal Concept, value scannerModel.) -
gotoRootPasswd (GOto - Gonicus Terminal Concept, value rootPasswd.) -
ghInventoryNumber (Unique number for inclusion in an inventory) -
gotoCdromEnable (GOto - Gonicus Terminal Concept, value cdromEnable.) -
gotoModules (GOto - Gonicus Terminal Concept, value kernel modules.) -
gotoXKbVariant (GOto - Gonicus Terminal Concept, value xKbvariant.) -
gotoXMonitor (GOto - Gonicus Terminal Concept, value xMonitor.) -
fdRfc2307bis (FusionDirectory - rfc2307bis) -
gotoFontPath (GOto - Gonicus Terminal Concept, value fontPath.) -
gosaSubtreeACL (GOsa - ACL entry) -
gosaLoginRestriction (GOsa - Multivalue attribute to carry a number of allowed ips/subnets) -
fdIdGenerator (FusionDirectory - An automatic way to generate new user ids) -
ghUsbSupport (Hardware definitions, value usbSupport) -
gotoAdaptPath (GOto - Gonicus Terminal Concept, value adaptpath.) -
gotoFilesystem (GOto - Gonicus Terminal Concept, value filesystem.) -
gotoSndModule (GOto - Gonicus Terminal Concept, value sound Modules.) -
gotoScannerEnable (GOto - Gonicus Terminal Concept, value scannerEnable.) -
gotoXColordepth (GOto - Gonicus Terminal Concept, value xColordepth.) -
Deprecated objectClasses:
gosaUserTemplate (GOsa - Class for GOsa User Templates) -
gosaAccount (GOsa - Class for GOsa Accounts) -
goCupsServer (CUPS server description) -
gosaObject (GOsa - Class for GOsa settings) -
gosaCacheEntry (GOsa - Class for GOsa caching) -
fusiondirectory-setup --check-deprecated will output a list of dn using old attributes and objectClasses
fusiondirectory-setup --check-deprecated
List LDAP entries using deprecated attributes or objectclasses
cn=fusiondirectory,ou=configs,dc=fusiondirectory,dc=org contains an obsolete attribute
uid=fd-admin,ou=people,dc=fusiondirectory,dc=org uses the obsolete object class gosaAccount
fusiondirectory-setup --ldif-deprecated will output an ldif file on the console that you can use with ldapmodify to clean you ldap server from old attributes.
If they are old objectClasses it will warn you and you will have to remove it by hand, they have been specified at the fusiondirectory-setup --check-deprecated step.
fusiondirectory-setup --ldif-deprecated
# Print an LDIF removing deprecated attributes
# WARNING: There are entries in the LDAP using obsolete classes, you need to edit them manually
**Please read it carefully before applying :!: :!:**
* Further information
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment