La migration d'un freedom 2.14 vers un freedom 3.0 se passe en deux étapes qui sont :

• Mise à jour wiff 0.4 vers wiff 0.6
• Mise à jour freedom 2.14 en freedom 3.0
• Installation de `freedom-ecm'

freedom 3.0 nécessite l'utilisation d'un wiff >= 0.6

Pour cela, il faut mettre à jour votre wiff 0.4.x en version 0.6 :

• Editer le fichier `conf/params.xml' dans le répertoire de votre wiff 0.4, et modifier le paramètre `wiff-update-path' pour pointer vers la branche `3.0/tarball/' :

# vi conf/params.xml
[...]
    <param name="wiff-update-path" value="3.0/tarball/" />
[...]

• Recharger l'interface du wiff avec votre navigateur.
• Wiff va détecter et vous demander si vous voulez effectuer une mise-à-jour : répondre “Yes” pour effectuer la mise à jour.

Une fois wiff mis à jour, il faut modifier la liste des dépôts pour déclarer ceux contenant freedom 3.0 :

• Aller dans “Freedom Web Installer” > “Setup”.
• Supprimer les dépôts de la version `2.14' et déclarer les dépôts suivants :

Une fois le Wiff et la liste de dépôts à jour, vous pouvez mettre à jour vos contextes freedom :

• Sélectionner le contexte à upgrader dans la liste “Context List”.
• Modifier les dépôts du contexte dans “Context Information” > “Modify Context”, et cocher les dépôts `freedom 3.0' et `third-party modules' :
  • [✔] freedom 3.0
  • [✔] third-party modules
• Valider avec “Save”.

Mettre à jour les modules installées du contexte :

• Sélectionner les nouvelles version des modules dans la liste “Installed” des modules installés et faire “Upgrade Selection”.
• Ignorer l'erreur sur “Process programs/pre_migration FDL” : `Error: schema “family” already exists'.

Sur freedom 3.0 l'interface utilisateur par défaut est `ECM' et est fournit par `freedom-ecm'.

Si vous n'utilisiez pas au préalable `ECM' , vous pouvez installer celui-ci en sélectionnant `freedom-ecm' dans la liste des modules “Available” puis “Install Selection”.

Si vous ne souhaitez pas utiliser `ECM' comme interface par défaut, il faudra alors changer l'application lancé par défaut par `WEBDESK'. Pour cela, connectez vous en tant qu'admin sur freedom en spécifiant explicitement l'application `WEBDESK' (http://<...>/index.php?app=WEBDESK). Modifier ensuite le paramètre `default start application' de l'application `Noyau' :

• Aller dans l'application “Administration” > “Paramètres de configuration” > “paramètres applicatif” > “Noyau”.
• Positionner le paramètre “default start application” = “WEBDESK”.

freedom 3.0 corrige une utilisation non-standard de la fonction crypt() et lors de la première connexion, un changement de mot de passe peut vous être demandé si votre mot de passe stocké en base a été généré de manière non-standard.

Cette modification n'impacte pas les systèmes configurés pour s'authentifier sur LDAP/Active Directory avec `freedom-networkuser'.

Pour avoir la liste des comptes qui sont impactés par cette modification, vous pouvez exécuter la requêtes SQL suivante sur la table `users' :

freedom=# SELECT login,password FROM users WHERE isgroup = 'N' AND password !~ '^[a-zA-Z0-9./]{2}';
       login       |   password    
-------------------+---------------
 admin             | A^1ul2Jf7VS2M
[...]

Ces comptes devront donc changer leur mot de passe lors de la première connexion à freedom.

La ré-initialisation du mot de passe se fait par mail, avec la le lien “mot de passe oublié ?” sur la page de login. Pour cela, il faut s'assurer que le compte de l'utilisateur soit configuré avec une adresse mail valide.

Si le compte n'a pas d'adresse mail correcte, il faudra alors soit changer son mot de passe en tant qu'admin, soit ajouter une adresse mail au compte, et laisser l'utilisateur dérouler la procédure de changement de mot de passe.

Si c'est le compte admin qui est impacté, alors il faudra soit changer le mot de passe directement en base, soit ajouter une adresse mail valide au compte admin, en suivants les procédures ci-dessous.

Obtenir la forme chiffré de votre mot de passe :

# php -r 'print crypt("secret", "aa")."\n";'
aa3kxsKzvuQMc

La chaîne “secret” est le mot de passe que vous voulez chiffrer, et “aa” est le « salt » qui doit être une chaîne de deux caractères pris dans le set ”./a-zA-Z0-9”.

Modifier le mot de passe dans la table `users' :

freedom=# UPDATE users SET password = 'aa3kxsKzvuQMc' WHERE login = 'admin';

Ajouter une adresse mail au compte `admin' pour pouvoir suivre la procédure de ré-initialisation par e-mail :

freedom=# UPDATE users SET mail = 'admin@example.net' WHERE login = 'admin';