Voir la source de SiteWeb:Procédure de migration Drupal 5 à Drupal 6

= Préparation =
# Réaliser un dump SQL de la base de production vers <code>/root/migration/ergoline/dump.sql.bz2</code>.
# Réaliser une copie du répertoire drupal de prodution (<code>/var/www/www.april.org/htdocs/drupal-5.11</code> sur ergoline) dans <code>/root/migration/ergoline/drupal-5.11</code>.
# Vider le repertoire <code>/root/migration/tmp/</code>

= Script de migration =
 $ cd /root/migration
 $ rm -Rf tmp/drupal5
 $ migration.sh $ALIAS | tee migration.$ALIAS.log

Avec $ALIAS l'alias drush d'un site Drupal dans lequel placer la migration. Les alias existant sur cathinone sont
* @test == test.april.org
* @staging == staging.april.org
* default == ce qui est utilisé par le Drupal sur cathinone pour www.april.org (et tout les autres domaines servit par cathinone).

= Post script =

Vérifier le log (à l'écran ou dans le fichier de log). Il est normale d'avoir quelques erreurs (documentée dans le README) et c'est long.

Se connecter avec un compte administrateur (l'utilisateur ''april'' par exemple).

== Ré-importation des traductions ==
# Ouvrir http://$DOMAINE/admin/build/translate/import/package
# Pour '''Language packages''' sélectionner ''Français''
# Ne rien sélectionner pour '''Clean up textgroups in database before reimport'''
# Cliquer sur ''Reimport packages''

== Importation de la page de garde ==
# Ouvrir http://$DOMAINE/admin/build/pages
# Supprimer les pages april et april_en (il faut passer par leur page d'édition)
# Via l'onglet ''Importer une page'' importer les fichier [https://redmine.april.org/projects/siteweb/repository/revisions/master/raw/import/april.panel import/april.panel]. Attention à bien ''Enregistrer'' la page après importation.

== Configuration de blocs ==
Depuis http://$DOMAIN/admin/build/block placer les blocs dans le région et modifier lors configuration comme indiqué

{| border="1"
!Bloc
!Configuration'''
|-
! colspan="2" | barre de gauche
|-
| colspan="2" | ''Aucun bloc dans cette région''
|-
! colspan="2" | barre de droite
|-
| Formulaire de recherche ||
|-
| Adhérer ||
* '''Langue''': Français
|-
| Adhérer (en) ||
* '''Langue''': Anglais
|-
| Utilisateurs en ligne ||
|-
| Déconnexion ||
|-
| Inscription à la lettre d'information ||
* '''Langue''': Français
* '''Afficher le bloc sur certaines pages seulement''':  Afficher le bloc sur toutes les pages exceptées celles listées.
* '''Pages''': ' '
|-
| Menu secondaire ||
|-
| CA ||
|- 
| Traductions ||
|-
| Espace membres ||
|- 
| Navigation ||
|-
| Membres ||
|-
| Activités ||
|-
| Documents ||
|-
| Les_derniers_contenus_nav: Bloc ||
* '''Afficher le bloc pour des rôles spécifiques''' : authenticated user, CA étendu, conseil bénévole, éditeur, membre, permanent, responsable de GdT et traducteur.
* '''Afficher le bloc sur certaines pages seulement''' : Afficher le bloc sur toutes les pages exceptées celles listées.
* '''Pages''': '<front>'
|-
| Sondage le plus récent ||
|-
| Syndication ||
|-
! colspan="2" | navigation bar
|-
| colspan="2" | ''Aucun bloc dans cette région''
|-
! colspan="2" | content top
|-
| colspan="2" | ''Aucun bloc dans cette région''
|-
! colspan="2" | content bottom
|-
| colspan="2" | ''Aucun bloc dans cette région''
|-
! colspan="2" | en-tête
|-
| Connexion utilisateur	||
|-
! colspan="2" | pied de page
|-
| colspan="2" | ''Aucun bloc dans cette région''
|-
! colspan="2" | closure
|-
| colspan="2" | ''Aucun bloc dans cette région''
|-
! colspan="2" | Désactivé
|-
| colspan="2" | ''...''
|}


== Configuration des menus ==

Depuis http://$DOMAIN/admin/build/menu-customize/navigation déplacer l'entrée ''Créer du contenu'' sous ''Mon compte'' et cocher sa case ''Activé''. Cliquer sur ''Enregistrer la configuration'' pour sauver la modification.

Depuis http://$DOMAIN/admin/build/menu-customize/menu-espace-membres, cocher la case ''Déplié'' de l'entrée ''Mon compte / mon adhésion''.

Editer la page ''Gestion d'adhésion'' sur http://$DOMAIN/node/10801/edit. Dans la section ''Paramètres du chemin d'URL'', décocher la case ''Alias automatique'' et entrer "my" comme alias pour la page.

== Lancement de l'ensemble de test windmill ==
 $ cd /root/migration
 $ ./run_test.sh http://$DOMAINE username=$USERNAME password=$PASSWORD april_password=$APRIL_PASSWORD

Avec
* $DOMAINE Le nom de domain auquel le site migré est accessible (www.april.org, test.april.org ou staging.april.org)
* $USERNAME Le login à utiliser pour les tests
* $PASSWORD Le mot de passe pour le login à utiliser pour les tests
* $APRIL_PASSWORD Le mot de passe pour l'utilisateur 'april' (le super-utilisateur)

Note: Pour l'instant les tests test_169LoginDepuisMy, test_Accueil et test_ca échouent. Les problèmes qu'ils testent ne pas résolus (cf. [https://redmine.april.org/issues/169 #169], [https://redmine.april.org/issues/144 #144] et [https://redmine.april.org/issues/146 #146]).
Note bis: A cause d'un bug dans windmill qui détecte mal la fin d'un chargement long (voir très long) de page, certains tests échouent alors qu'ils devraient réussir. :(