L'outil de ligne de commande de mise à nouveau Content Engine peut être exécuté pour mettre à jour les éléments sélectionnés dans le fichier d'état de la mise à niveau, upgrade.xml.
Avant de mettre à niveau une librairie, l'outil de ligne de commande de mise à niveau Content Engine la met hors ligne. Après sa mise à niveau, l'outil modifie son état dans le fichier upgrade.xml.
Pour effectuer la mise à niveau :
- Connectez-vous au système sur lequel est installé l'outil de ligne de commande de mise à niveau Content Engine en tant qu'utilisateur utilisateur_de_mise_à_niveau_de_ce.
- Accédez au répertoire chemin_d_installation_de_ce\tools\upgrade, qui contient le fichier CE35_to_50Upgrader.bat.
- Facultatif : Pour connaître les options disponibles, lancez l'outil de mise à niveau à partir de la ligne de commande, comme suit : CE35_to_50Upgrader.bat -h
- Exécutez l'outil de mise à niveau à l'aide de la commande suivante :
CE35_to_50Upgrader -i upgrade.xml -r
L'option -r est facultative. Si vous l'ajoutez à la commande, l'outil génère un rapport HTML.
Important : L'outil de mise à niveau ne met à niveau que les éléments dont l'état initial est ReadyToUpgrade (prêt pour la mise à niveau) et dont le paramètre SelectedForUpgrade (sélectionné pour la mise à niveau) est défini à yes.
L'outil de mise à niveau envoie un message d'erreur à la ligne de commande ainsi qu'à un système de consignation log4j à mesure qu'il tente de mettre à niveau chaque élément. Si la mise à niveau d'un élément échoue, l'outil de mise à niveau s'arrête.
- Si la mise à niveau d'un élément échoue, effectuez les opérations suivantes :
- Utilisez les informations (code d'exception et trace de pile) de l'interface de ligne de commande ou du fichier log4j pour corriger les erreurs.
- Editez le fichier upgrade.xml et remplacez les valeurs des états UpgradeStarted (mise à niveau démarrée) ou UpgradeFailed (échec de la mise à niveau) par ReadyToUpgrade.
- Si la mise à niveau d'un module complémentaire de la librairie prend plus de
10 minutes et échoue, notez les messages d'erreur du journal.
Augmentez la durée du délai d'attente du serveur d'applications.
Effectuez les opérations suivantes :
- Augmentez la durée du délai d'attente de transaction du serveur d'applications. Notez les valeurs existantes avant de les modifier. En fonction de votre configuration matérielle, vous pouvez devoir augmenter le délai jusqu'à 6000 secondes.
- IBM® WebSphere Application Server
- Accédez à , et augmentez la valeur du délai autorisé pour la durée de vie des transactions et du délai maximal des transactions.
- Oracle WebLogic Server
- Augmentez la valeur des paramètres et . Utilisez les mêmes valeurs pour les deux paramètres.
- JBoss Application Server
- Editez le fichier jboss-service.xml et définissez la valeur de <attribute name="TransactionTimeout">.
- Redémarrez le serveur d'applications.
- Redémarrez la mise à niveau des modules complémentaires de la librairie.
- A la fin de la mise à niveau, les paramètres de délai d'attente du serveur d'applications peuvent être rétablis à leur valeur précédente.
- Si l'échec est dû à une erreur provoquée par la mise à niveau de la base de données, restaurez celle-ci à partir de la copie de sauvegarde.