Migration d'un serveur autonome HCL Digital Experience 9.0 vers WebSphere® Application Server 9.0
Vous pouvez migrer votre profil HCL Digital Experience vers IBM® WebSphere® Application Server 9.0.0.2 ou version ultérieure. Deux options existent pour ce processus de migration : locale ou distante. Pour une migration locale uniquement : installez la dernière version de WebSphere® Application Server sur le même serveur où CL Digital Experience 9.0 est installé. Pour une migration à distance uniquement : installez HCL Digital Experience 9.0 avec la dernière version de IBM® 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.
Avant de commencer
Pourquoi et quand exécuter cette tâche
- v85_wp_profile_name
- Ce terme fait référence au profil HCL Digital Experience d'origine sur l'installation 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 Digital Experience 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 v85.
- v90_wp_profile_path
- Ce terme fait référence au chemin complet vers le profil 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.0.2 ou version ultérieure.
Procédure
- Pour une migration locale uniquement : installez WebSphere® Application Server 9.0.0.2. Pour une migration à distance uniquement : installez HCL Digital Experience 9.0 sur le serveur distant cible. Utilisez le même chemin de répertoire d'installation HCL Digital Experience que le serveur source.
-
Créez un profil de base sur le serveur WebSphere®Application Server 9.0.0.2 cible à l'aide de l'option de ligne de commande manageprofiles.
Important :
- La migration de WebSphere® Application Server 9.0.0.2 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.0.2 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 Digital Experience 8.5 et de WebSphere® Application Server 8.5.5.5.
- Si vous exécutez cette commande sur IBM® i, vous devez ajouter le paramètre
-serverName WebSphere_Portal.
- AIX® :
./manageprofiles.sh -create -defaultPorts -enableAdminSecurity false -profileName v90_wp_profile_name -profilePath v90_wp_profile_path -templatePath v90_was_root_path/profileTemplates/default -nodeName source_node_name -cellName source_cell_name -hostName host_name -isDefault -omitAction samplesInstallAndConfig defaultAppDeployAndConfig - HP-UX :
./manageprofiles.sh -create -defaultPorts -enableAdminSecurity false -profileName v90_wp_profile_name -profilePath v90_wp_profile_path -templatePath v90_was_root_path/profileTemplates/default -nodeName source_node_name -cellName source_cell_name -hostName host_name -isDefault -omitAction samplesInstallAndConfig defaultAppDeployAndConfig - IBM® i:
manageprofiles.sh -create -defaultPorts -enableAdminSecurity false -profileName v90_wp_profile_name -profilePath v90_wp_profile_path -templatePath v90_was_root_path/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 v90_wp_profile_name -profilePath v90_wp_profile_path -templatePath v90_was_root_path/profileTemplates/default -nodeName source_node_name -cellName source_cell_name -hostName host_name -isDefault -omitAction samplesInstallAndConfig defaultAppDeployAndConfig - Solaris :
./manageprofiles.sh -create -defaultPorts -enableAdminSecurity false -profileName v90_wp_profile_name -profilePath v90_wp_profile_path -templatePath v90_was_root_path/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 v90_wp_profile_name -profilePath v90_wp_profile_path -templatePath v90_was_root_path/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.
-
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é.
-
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 :
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=v90_was_root_path -DWasPassword=password - HP-UX :
./ConfigEngine.sh install-wp-migration-files -DNewWasLocation=v90_was_root_path -DWasPassword=password - IBM® i:
ConfigEngine.sh install-wp-migration-files -DNewWasLocation=v90_was_root_path -DWasPassword=password - Linux™ :
./ConfigEngine.sh install-wp-migration-files -DNewWasLocation=v90_was_root_path -DWasPassword=password - Solaris :
./ConfigEngine.sh install-wp-migration-files -DNewWasLocation=v90_was_root_path -DWasPassword=password - Windows™ :
ConfigEngine.bat install-wp-migration-files -DNewWasLocation=v90_was_root_path -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.
- AIX® :
-
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 v90_wp_profile_path/bin :
- AIX® :
./osgiCfgInit.sh -all - HP-UX :
./osgiCfgInit.sh -all - IBM® i:
osgiCfgInit.sh -all - Linux™ :
./osgiCfgInit.sh -all - Solaris :
./osgiCfgInit.sh -all - Windows™ :
osgiCfgInit.bat -all
- AIX® :
-
Pour une migration à distance uniquement : Sur le serveur HCL Digital Experience 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 - HP-UX :
cd PortalServer_root/bin ./genRemMigPkg.sh remote_zip_dir - IBM® i:
cd PortalServer_root/bin genRemMigPkg.sh remote_zip_dir - Linux™ :
cd PortalServer_root/bin ./genRemMigPkg.sh remote_zip_dir - Solaris :
cd PortalServer_root/bin ./genRemMigPkg.sh remote_zip_dir - Windows™ :
cd PortalServer_root\bin genRemMigPkg.bat remote_zip_dir
Où
remote_zip_direst 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 fichier PORTAL_V8.5.0.0_WAS_V90_OS.arch_RemoteMigrSupport.jar depuis le serveur cible HCL Digital Experience 9.0 vers le serveur source HCL Digital Experience 9.0. 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écutezchmod -R 755 supp_dir. - AIX® :
-
Dans le serveur HCL Digital Experience, procédez comme suit pour préparer le profil HCL Digital Experience pour la commande WASPreUpgrade.
-
Les commandes WASPreUpgrade et WASPostUpgrade utilisées dans la migration d'HCL Digital Experience utilisent trop de mémoire et peuvent entraîner une exception OutOfMemoryException. Pour éviter cette erreur, procédez comme suit :
- Arrêtez HCL Digital Experience avant d'exécuter la commande WASPreUpgrade.
-
Affectez au minimum la valeur 20480 à la limite de descripteur de fichier.
ulimit -n 20480 -
Affectez au minimum la valeur 65536 à la limite de pile.
ulimit -s 65536 -
AIX® uniquement : Utilisez les étapes suivantes pour augmenter la longueur maximale de la ligne de commande avec des variables d'environnement :
-
Pour une migration locale uniquement : exécutez la commande WASPreUpgrade à partir du répertoire v90_was_root_path/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 v85_was_root_path -javaoption -Xmx2048m -oldProfile v85_wp_profile_name -username was_admin_user -password was_admin_user_pswrd - HP-UX :
./WASPreUpgrade.sh temp_dir v85_was_root_path -javaoption -Xmx2048m -oldProfile v85_wp_profile_name -username was_admin_user -password was_admin_user_pswrd - IBM® i:
WASPreUpgrade temp_dir v85_was_root_path -javaoption -Xmx2048m -username was_admin_user -password was_admin_user_pswrd - Linux™ :
./WASPreUpgrade.sh temp_dir v85_was_root_path -javaoption -Xmx2048m -oldProfile v85_wp_profile_name -username was_admin_user -password was_admin_user_pswrd - Solaris :
./WASPreUpgrade.sh temp_dir v85_was_root_path -javaoption -Xmx2048m -oldProfile v85_wp_profile_name -username was_admin_user -password was_admin_user_pswrd - Windows™ :
WASPreUpgrade.bat temp_dir v85_was_root_path -javaoption -Xmx2048m -oldProfile v85_wp_profile_name -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 :- Si vous exécutez cette commande sous IBM® i, le répertoire du profil source est utilisé à la place du répertoire v85_was_root_path.
- Si vous exécutez cette commande sous Windows™, le chemin de temp_dir ne peut pas contenir d'espace.
Par exemple, votre commande pourrait ressembler à :
./WASPreUpgrade.sh /opt/IBM/wasMigrateBackup /opt/IBM/WebSphere/AppServer -javaoption -Xmx2048m -oldProfile v85_wp_profile_name -username was_admin_user -password was_admin_user_pswrd - AIX® :
-
Pour une migration à distance uniquement : compressez et copiez la sauvegarde créée par la commande
WASPreUpgradedu serveur source vers le serveur cible. Extrayez la sauvegarde dans un répertoire temporaire tel que temp_dir. -
Pour une migration locale uniquement : exécutez la commande
WASPostUpgradeà partir du répertoire v90_was_root_path/bin. Pour une migration à distance uniquement : exécutez la commandeWASPostUpgradeà partir du répertoire v90_was_root_path/bin sur le serveur cible distant. La commandeWasPostUpgrademigre 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 v90_wp_profile_name -oldProfile v85_wp_profile_name -javaoption -Xmx2048m - HP-UX :
./WASPostUpgrade.sh temp_dir -profileName v90_wp_profile_name -oldProfile v85_wp_profile_name -javaoption -Xmx2048m - IBM® i:
WASPostUpgrade temp_dir -profileName v90_wp_profile_name -javaoption -Xmx2048m - Linux™ :
./WASPostUpgrade.sh temp_dir -profileName v90_wp_profile_name -oldProfile v85_wp_profile_name -javaoption -Xmx2048m - Solaris :
./WASPostUpgrade.sh temp_dir -profileName v90_wp_profile_name -oldProfile v85_wp_profile_name -javaoption -Xmx2048m - Windows™ :
WASPostUpgrade.bat temp_dir -profileName v90_wp_profile_name -oldProfile v85_wp_profile_name -javaoption -Xmx2048m
Important : Sur IBM® i, n'incluez pas l'indicateur -oldProfile. Pour IBM®i, le nouveau nom de profil HCL Digital Experience doit correspondre au nom de profil HCL Digital Experience d'origine.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 :
- AIX® :
-
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 v90_wp_profile_name action-copy-ce-script-native-encoding -DWasPassword=password -DPortalAdminPwd=password - HP-UX :
./ConfigEngine.sh -profileName v90_wp_profile_name action-copy-ce-script-native-encoding -DWasPassword=password -DPortalAdminPwd=password - IBM® i:
ConfigEngine.sh -profileName v90_wp_profile_name action-copy-ce-script-native-encoding -DWasPassword=password -DPortalAdminPwd=password - Linux™ :
./ConfigEngine.sh -profileName v90_wp_profile_name action-copy-ce-script-native-encoding -DWasPassword=password -DPortalAdminPwd=password - Solaris :
./ConfigEngine.sh -profileName v90_wp_profile_name action-copy-ce-script-native-encoding -DWasPassword=password -DPortalAdminPwd=password - Windows™ :
ConfigEngine.bat -profileName v90_wp_profile_name action-copy-ce-script-native-encoding -DWasPassword=password -DPortalAdminPwd=password
- AIX® :
- Désactivez la syndication et la recherche Portal dans votre environnement source.
- Créez une copie de la base de données source d'HCL Digital Experience. Reportez-vous à la documentation de votre base de données pour savoir comment créer la sauvegarde.
- Modifiez le fichier wkplc_dbdomain.properties sur le serveur cible HCL Digital Experience 9.0 afin qu'il pointe vers la copie de la base de données.
-
Modifiez les fichiers de propriétés suivants afin que les paramètres pointent vers les nouveaux emplacements de répertoire d'v90_was_root_path/ :
- Open a command prompt and change to the v90_wp_profile_path/ConfigEngine directory.
-
Exécutez la commande suivante :
- AIX® :
./ConfigEngine.sh validate-database -DWasPassword=password -DPortalAdminPwd=password - HP-UX :
./ConfigEngine.sh validate-database -DWasPassword=password -DPortalAdminPwd=password - IBM® i:
ConfigEngine.sh validate-database -DWasPassword=password -DPortalAdminPwd=password - Linux™ :
./ConfigEngine.sh validate-database -DWasPassword=password -DPortalAdminPwd=password - Solaris :
./ConfigEngine.sh validate-database -DWasPassword=password -DPortalAdminPwd=password - Windows™ :
ConfigEngine.bat validate-database -DWasPassword=password -DPortalAdminPwd=password
- AIX® :
-
Exécutez la commande suivante pour recréer vos sources de données :
- AIX® :
./ConfigEngine.sh connect-database -DWasPassword=password -DPortalAdminPwd=password - HP-UX :
./ConfigEngine.sh connect-database -DWasPassword=password -DPortalAdminPwd=password - IBM® i:
ConfigEngine.sh connect-database -DWasPassword=password -DPortalAdminPwd=password - Linux™ :
./ConfigEngine.sh connect-database -DWasPassword=password -DPortalAdminPwd=password - Solaris :
./ConfigEngine.sh connect-database -DWasPassword=password -DPortalAdminPwd=password - Windows™ :
ConfigEngine.bat connect-database -DWasPassword=password -DPortalAdminPwd=password
- AIX® :
-
Exécutez la commande post-was-migration-update suivante :
- AIX® :
./ConfigEngine.sh post-was-migration-update -DWasPassword=password -DoldProfileLocation=v85_wp_profile_path - HP-UX :
./ConfigEngine.sh post-was-migration-update -DWasPassword=password -DoldProfileLocation=v85_wp_profile_path - IBM® i:
ConfigEngine.sh post-was-migration-update -DWasPassword=password -DoldProfileLocation=v85_wp_profile_path - Linux™ :
./ConfigEngine.sh post-was-migration-update -DWasPassword=password -DoldProfileLocation=v85_wp_profile_path - Solaris :
./ConfigEngine.sh post-was-migration-update -DWasPassword=password -DoldProfileLocation=v85_wp_profile_path - Windows™ :
ConfigEngine.bat post-was-migration-update -DWasPassword=password -DoldProfileLocation=v85_wp_profile_path
- AIX® :
-
Start the HCL Digital Experience server.
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.
- Réexécutez la commande install-wp-migration-files de l'étape 3.
-
Une fois la migration de votre profil dans WebSphere®Application Server 9.0.0.2 terminée, vous pouvez toujours utiliser l'assistant de configuration dans le répertoire v85_AppServer root/profiles/cw_profile. If you want to have the wizard also running on WebSphere® Application Server 9.0.0.2, run the following command from the v90_wp_profile_path/ConfigEngine directory.
- AIX® :
./ConfigEngine.sh create-config-wizard -DWizardUserid=userID -DWizardPassword=password -DWasPassword=password - HP-UX:
./ConfigEngine.sh create-config-wizard -DWizardUserid=userID -DWizardPassword=password -DWasPassword=password - Linux™ :
./ConfigEngine.sh create-config-wizard -DWizardUserid=userID -DWizardPassword=password -DWasPassword=password - Solaris :
./ConfigEngine.sh create-config-wizard -DWizardUserid=userID -DWizardPassword=password -DWasPassword=password - Windows™ :
ConfigEngine.bat create-config-wizard -DWizardUserid=userID -DWizardPassword=password -DWasPassword=password
- AIX® :