Migration d'un serveur autonome HCL Portal vers IBM WAS 9.0.5

Vous pouvez migrer votre profil HCL Digital Experience vers WebSphere Application Server 9.0.5. Deux options existent pour ce processus de migration : locale ou distante.

Avant de commencer

Assurez-vous de migrer votre collection de recherche avant de migrer votre serveur Portal
Remarque :
  • 1. Pour une migration locale uniquement : Installez la dernière version de WebSphere Application Server sur le même serveur où HCL Portal 9.0 est installé.
  • 2. Pour une migration à distance uniquement : Installez HCL Portal 9.0 avec la dernière version de WebSphere Application Server sur un serveur séparé, qui sera le serveur cible pour la migration. Dans les deux scénarios, faites une copie de la base de données source à utiliser sur le serveur cible. La migration à distance est une meilleure option, car elle laisse intact l'environnement de migration source. Pour une migration locale, le profil de migration source n'est plus utilisable après la migration.
Préambules
Planification de l'installation d'HCL Digital Experience

Pourquoi et quand exécuter cette tâche

Aux fin de ces instructions, les termes suivants sont utilisés :
v85_wp_profile_name
Ce terme fait référence au profil HCL Portal d'origine sur l'installation de WebSphere Application Server 8.5.5.5 ou version ultérieure.
v90_wp_profile_name
Ce terme fait référence au nouveau profil HCL Portal sur l'installation WebSphere Application Server 9.0 ou version ultérieure.
v85_wp_profile_path
Ce terme fait référence au chemin complet vers le profil Versio 8.5.
v90_wp_profile_path
Ce terme fait référence au chemin complet vers le profil HCL Portal 9.0.
v85_was_root_path
Ce terme fait référence au chemin complet d'installation de WebSphere Application Server 8.5.5.5 ou version ultérieure.
v90_was_root_path
Ce terme fait référence au chemin complet d'installation de WebSphere Application Server 9.0.5 ou version ultérieure.

Procédure

  1. Pour une migration locale uniquement : Installez WebSphere® Application Server 9.0.5. Pour une migration à distance uniquement : Installez HCL Digital Experience 9.5 sur le serveur distant cible. Utilisez le même chemin de répertoire d'installation HCL Digital Experience que le serveur source.
  2. Créez un profil de base sur le serveur WebSphere Application Server 9.0.5 cible à l'aide de l'option de ligne de commande manageprofiles.
    Important :
    • La migration de WebSphere Application Server 9.0.5 est différente de la migration d'HCL Digital Experience standard, car les références dans l'environnement source sont mises à jour pour pointer vers l'environnement WebSphere® Application Server 9.0.5 cible.
    • Utilisez le même nom de cellule et le même nom de nœud que ceux utilisés pour l'installation d'HCL Portal 9.5 et de WebSphere® Application Server 9.0.5 ou version ultérieure.
    • AIX® : ./manageprofiles.sh -create -defaultPorts -enableAdminSecurity false -profileName -profilePath -templatePath /profileTemplates/default -nodeName source_node_name -cellName source_cell_name -hostName host_name -isDefault -omitAction samplesInstallAndConfig defaultAppDeployAndConfig
    • Linux™ : ./manageprofiles.sh -create -defaultPorts -enableAdminSecurity false -profileName -profilePath -templatePath /profileTemplates/default -nodeName source_node_name -cellName source_cell_name -hostName host_name -isDefault -omitAction samplesInstallAndConfig defaultAppDeployAndConfig
    • Windows™ : manageprofiles.bat -create -defaultPorts -enableAdminSecurity false -profileName -profilePath -templatePath /profileTemplates/default -nodeName source_node_name -cellName source_cell_name -hostName host_name -isDefault -omitAction samplesInstallAndConfig defaultAppDeployAndConfig
    Où les valeurs suivantes sont définies :
    source_node_name
    Le nom du nœud sur l'installation source.
    source_cell_name
    Le nom de cellule sur l'installation source.
    host_name
    Le nom d'hôte de l'environnement.
  3. Ouvrez une invite de commande.
    Remarque : Si vous êtes invité à ouvrir un fichier de propriétés, il s'agit de fichiers ASCII qui doivent être ouverts avec l'outil approprié.
  4. Pour une migration locale uniquement : accédez au répertoire v85_wp_profile_path/ConfigEngine. Ensuite, exécutez la tâche install-wp-migration-files pour installer les fichiers propres à HCL Digital Experience dans l'installation de WebSphere Application Server 9.0.5 :
    Remarque : Vérifiez que le dossier de fichiers qui contient les fichiers binaires source est activé en mode lecture/écriture. Si le dossier est en lecture seule, la tâche install-wp-migration-files échoue.
    • AIX® : ./ConfigEngine.sh install-wp-migration-files -DNewWasLocation= -DWasPassword=password
    • Linux™ : ./ConfigEngine.sh install-wp-migration-files -DNewWasLocation= -DWasPassword=password
    • Windows™ : ConfigEngine.bat install-wp-migration-files -DNewWasLocation= -DWasPassword=password
    Remarque :
    • Si cette étape échoue, ConfigEngine peut ne pas fonctionner. Pour corriger cette erreur, restaurez le fichier ConfigEngine.migration.bak créé dans le répertoire racine ConfigEngine. Remplacez ConfigEngine.migration.bak par ConfigEngine.sh ou ConfigEngine.bat, selon votre système d'exploitation.
      Remarque : Si ConfigEngine.migration.bak n'a pas été créé, l'échec s'est produit avant la modification du fichier. Par conséquent, ConfigEngine doit fonctionner.
    • Pour IBM® i, l'erreur suivante peut être ignorée : ConfigEngine.sh: 001-0050 Syntax error on line 252: token "fi" not expected.
  5. Assurez-vous que le cache OSGi a été effacé de la nouvelle installation WebSphere® Application Server 9.0 en exécutant la commande suivante à partir du répertoire /bin :
    • AIX® : ./osgiCfgInit.sh -all
    • Linux™ : ./osgiCfgInit.sh -all
    • Windows™ : osgiCfgInit.bat -all
  6. Pour une migration à distance uniquement : Sur le serveur HCL Portal 9.0, exécutez la commande suivante pour créer le fichier PORTAL_V8.5.0.0_WAS_V90_OS.arch_RemoteMigrSupport.jar. Par exemple, le fichier peut être PORTAL_V8.5.0.0_WAS_V90_windows.x86_RemoteMigrSupport.jar.
    • AIX® : cd PortalServer_root/bin ./genRemMigPkg.sh remote_zip_dir
    • Linux™ : cd PortalServer_root/bin ./genRemMigPkg.sh remote_zip_dir
    • Windows™ : cd PortalServer_root\bin genRemMigPkg.bat remote_zip_dir

    Où remote_zip_dir est un répertoire existant utilisé pour contenir le fichier généré. Veillez à indiquer le chemin d'accès complet au répertoire. Copiez le fichierPORTAL_V8.5.0.0_WAS_V90_OS.arch_RemoteMigrSupport.jar depuis le serveur cible HCL Portal vers le serveur source HCL Portal. Extrayez le fichier JAR dans un répertoire de travail. Par exemple, extrayez PORTAL_V8.5.0.0_WAS_V90_linux.amd64_RemoteMigrSupport.jar.

    Linux only : Vérifiez que les droits en lecture et d'exécution sont définis sur les fichiers extraits. Par exemple: exécutez chmod -R 755 supp_dir.
  7. Dans le serveur HCL Portal source, procédez comme suit pour préparer le profil HCL Digital Experience pour la commande WASPreUpgrade.
    1. Désinstallez toutes les applications inutiles.
    2. Supprimez les applications de sauvegarde et désinstallées.
    3. Supprimez les éventuels fichiers de journalisation ou fichiers temporaires qui occupent beaucoup d'espace et dont vous n'avez plus besoin. Pour cela, vous devrez peut-être arrêter le serveur HCL Portal. Les emplacements suivants sont destinés aux fichiers temporaires communs :
      • /temp/
      • /wstemp/
      • /config/temp/
  8. Les commandes WASPreUpgrade et WASPostUpgrade utilisées dans la migration d'HCL Portal utilisent trop de mémoire et peuvent entraîner une exception OutOfMemoryException. Pour éviter cette erreur, procédez comme suit :
    1. Vérifiez que vous utilisez une taille de segment de mémoire suffisamment grande. En règle générale, l'utilisation d'une taille de segment de mémoire de 2 Go est suffisante. Elle est spécifiée à l'aide de la variable -javaoption -Xmx2048m lors de l'exécution des commandes WASPreUpgrade ou WASPostUpgrade. Augmentez la taille de segment de mémoire en augmentant la variable -Xmx2048m. -Xmx4096m est une valeur possible.
    2. Vérifiez que la taille du profil d'HCL Digital Experience a été réduite en supprimant les fichiers inutiles. Dans la plupart des cas, la taille du profil HCL Portal (wp_profile) ne doit pas être supérieure à 2 Go. Recherchez les fichiers de plus de 10 Mo pour trouver tous les fichiers qui peuvent expliquer la taille volumineuse du profil.
      Par exemple:
      • Sous Linux™, la commande suivante vous permet de trouver les fichiers dont la taille est supérieure à 10 Mo : > find . -type f -size +10000k -exec ls -lh {} \; | awk '{ print $9 ": " $5 }'.
      • Sous Windows™, vous pouvez lancer la recherche suivante dans Windows™ Explorer : *.* size:> 10MB
  9. Arrêtez HCL Portal avant d'exécuter la commande WASPreUpgrade.
  10. Affectez au minimum la valeur 20480 à la limite de descripteur de fichier. 
    ulimit -n 20480
  11. Affectez au minimum la valeur 65536 à la limite de pile. 
    ulimit -s 65536
  12. AIX® uniquement : Utilisez les étapes suivantes pour augmenter la longueur maximale de la ligne de commande avec des variables d'environnement :
    1. Exécutez la commande suivante pour interroger les attributs système : 
      lsattr -EH -l sys0 | grep ncargs
      La commande renvoie une valeur semblable à celle de l'exemple illustré ci-dessous :
      ncargs  256  ARG/ENV list size in 4K byte blocks  True
    2. Si la valeur ncargs est inférieure à 512, exécutez la commande suivante pour augmenter la valeur : 
      chdev -l sys0 -a ncargs=1024
  13. Pour une migration locale uniquement : exécutez la commande WASPreUpgrade à partir du répertoire /bin. Pour une migration à distance uniquement : exécutez la commande WASPreUpgrade à partir du répertoire working_directory/bin contenant le package de migration à distance copié précédemment. Pour une migration à distance uniquement : ajoutez le paramètre supplémentaire -machineChange true.
    • AIX® : ./WASPreUpgrade.sh temp_dir -javaoption -Xmx2048m -oldProfile -username was_admin_user -password was_admin_user_pswrd
    • Linux™ : ./WASPreUpgrade.sh temp_dir -javaoption -Xmx2048m -oldProfile -username was_admin_user -password was_admin_user_pswrd
    • Windows™ : WASPreUpgrade.bat temp_dir -javaoption -Xmx2048m -oldProfile -username was_admin_user -password was_admin_user_pswrd
    Où les valeurs suivantes sont définies :
    temp_dir
    Répertoire temporaire dans lequel la sauvegarde est stockée.
    Remarque :
    • HCL Digital Experience Windows™, the temp_dir cannot have spaces in the path.

    Par exemple, votre commande pourrait ressembler à : ./WASPreUpgrade.sh /opt/HCL/wasMigrateBackup /opt/HCL/WebSphere/AppServer -javaoption -Xmx2048m -oldProfile -username was_admin_user -password was_admin_user_pswrd

  14. Pour une migration à distance uniquement : compressez et copiez la sauvegarde créée par la commande WASPreUpgrade du serveur source vers le serveur cible. Extrayez la sauvegarde dans un répertoire temporaire tel que temp_dir.
  15. Pour une migration locale uniquement : exécutez la commande WASPostUpgrade à partir du répertoire /bin. Pour une migration à distance uniquement : exécutez la commande WASPostUpgrade à partir du répertoire /bin sur le serveur cible distant. La commande WasPostUpgrade migre le profil source sauvegardé vers le nouveau profil.
    Remarque : Si la sécurité est activée sur votre profil, ajoutez les paramètres -username was_userid -password was_userid_password à votre tâche WASPostUpgrade.
    • AIX® : ./WASPostUpgrade.sh temp_dir -profileName -oldProfile -javaoption -Xmx2048m
    • Linux™ : ./WASPostUpgrade.sh temp_dir -profileName -oldProfile -javaoption -Xmx2048m
    • Windows™ : WASPostUpgrade.bat temp_dir -profileName -oldProfile -javaoption -Xmx2048m
    Par exemple, votre commande pourrait ressembler à : ./WASPostUpgrade.sh /opt/IBM/wasMigratedBackup -profileName wp_profile -oldProfile wp_profile -javaoption -Xmx2048m.

    Si WASPreUpgrade réussi, mais que la commande WASPostUpgrade entraîne une erreur, procédez comme suit :

    1. Vérifiez qu'un seul profil existe dans le profil de sauvegarde.
    2. Si nécessaire, supprimez la collection de recherche pour réduire la taille des données.
    3. Déplacez les données JCR pendant la migration.
      Remarque : Java™ Content Repository peut stocker des fichiers liés à l'index dans des sous-répertoires du profil WebSphere®, tels que jcr, qui peuvent utiliser beaucoup d'espace. Ces données ne sont pas modifiées par le processus de migration, elles peuvent donc être temporairement retirées de l'ancien profil ou du répertoire de sauvegarde en vue de la migration. Déplacez le répertoire vers le nouveau profil une fois la migration terminée.
    4. Assurez-vous qu'aucun chemin ne contient le caractère :. Le caractère peut provoquer des problèmes pour les commandes WASPreUpgrade et WASPostUpgrade.
  16. Si les noms de profil source et cible ne sont pas identiques, exécutez la tâche action-copy-ce-script-native-encoding dans le chemin d'accès ConfigEngine source :
    Remarque : Le chemin ConfigEngine source doit se trouver dans le même chemin que les chemins PortalServer et AppServer. N'exécutez pas cette tâche à partir du chemin ConfigEngine situé dans le profil source.
    • AIX® : ./ConfigEngine.sh -profileName action-copy-ce-script-native-encoding -DWasPassword=password -DPortalAdminPwd=password
    • Linux™ : ./ConfigEngine.sh -profileName action-copy-ce-script-native-encoding -DWasPassword=password -DPortalAdminPwd=password
    • Windows™ : ConfigEngine.bat -profileName action-copy-ce-script-native-encoding -DWasPassword=password -DPortalAdminPwd=password
  17. Désactivez la syndication et la recherche Portal dans votre environnement source.
  18. Créez une copie de la base de données source d'HCL Portal. Refer to your database documentation for instructions on how to create the backup.
  19. Modifiez le fichier wkplc_dbdomain.properties sur le serveur cible HCL Portal afin qu'il pointe vers la copie de la base de données.
  20. Modifiez les fichiers de propriétés suivants afin que les paramètres pointent vers les nouveaux emplacements de répertoire d'/ :
    1. Depuis le répertoire /ConfigEngine/properties :
      • Vérifiez que le paramètre DbLibrary du fichier wkplc_dbtype.properties pointe vers la classe de pilote JDBC correcte. La valeur est .zip ou .jar. Par exemple: /derby/lib/derby.jar.
      • Vérifiez que le paramètre WpsInstallLocation situé dans le fichier wkplc.properties pointe vers l'emplacement d'installation d'HCL Portal. Par exemple: la valeur peut-être le répertoire /opt/HCL/PortalServer.
      • Vérifiez que les mots de passe administratifs du fichier wkplc_dbdomain.properties n'ont pas été supprimés par le groupe de correctifs.
      • Vérifiez que les propriétés WasRemoteHostName, WasSoapPort, WpsHostName dans wkplc.properties sont définies sur les valeurs correctes.
    2. Pour une migration locale uniquement : depuis le répertoire /PortalServer, modifiez les paramètres suivants dans le fichier wps.properties :
      • WasRootDir=/
      • ProfileDirectory=
  21. Open a command prompt and change to the /ConfigEngine directory.
  22. Exécutez la commande suivante :
    • AIX® : ./ConfigEngine.sh validate-database -DWasPassword=password -DPortalAdminPwd=password
    • Linux™ : ./ConfigEngine.sh validate-database -DWasPassword=password -DPortalAdminPwd=password
    • Windows™ : ConfigEngine.bat validate-database -DWasPassword=password -DPortalAdminPwd=password
  23. Exécutez la commande suivante pour recréer vos sources de données :
    • AIX® : ./ConfigEngine.sh connect-database -DWasPassword=password -DPortalAdminPwd=password
    • Linux™ : ./ConfigEngine.sh connect-database -DWasPassword=password -DPortalAdminPwd=password
    • Windows™ : ConfigEngine.bat connect-database -DWasPassword=password -DPortalAdminPwd=password
  24. Exécutez la commande post-was-migration-update suivante :
    • AIX® : ./ConfigEngine.sh post-was-migration-update -DWasPassword=password -DoldProfileLocation=
    • Linux™ : ./ConfigEngine.sh post-was-migration-update -DWasPassword=password -DoldProfileLocation=
    • Windows™ : ConfigEngine.bat post-was-migration-update -DWasPassword=password -DoldProfileLocation=
  25. Démarrez le serveur HCL Portal.
    Remarque : En cas d'échec de la migration de WebSphere Application Server :
    • Consultez le journal du travail dans le répertoire temporaire de WebSphere Application Server afin de résoudre les erreurs de migration de WebSphere Application Server.
    • Rexécutez la commande install-wp-migration-files de l'étape 3.
  26. Une fois la migration de votre profil dans WebSphere Application Server 9.0.5 terminée, vous pouvez toujours utiliser l'assistant de configuration dans le répertoire v85_AppServer root/profiles/cw_profile. Si vous souhaitez que l'assistant s'exécute également sur WebSphere® Application Server 9.0.5, exécutez la commande suivante à partir du répertoire /ConfigEngine.
    • AIX® : ./ConfigEngine.sh create-config-wizard -DWizardUserid=userID -DWizardPassword=password -DWasPassword=password
    • Linux™ : ./ConfigEngine.sh create-config-wizard -DWizardUserid=userID -DWizardPassword=password -DWasPassword=password
    • Windows™ : ConfigEngine.bat create-config-wizard -DWizardUserid=userID -DWizardPassword=password -DWasPassword=password