Dans le cadre de la mise à niveau du logiciel Workplace XT, vous devez effectuer une sauvegarde de l'installation existante et annuler son déploiement.
La mise à niveau peut ensuite être réalisée à l'aide du programme d'installation.
Avertissement : Sites disposant d'une installation IBM® Production Imaging Edition Viewer Pro : Pour mettre à niveau une configuration
Workplace XT version 1.1.4 contenant le logiciel Viewer Pro vers la version 1.1.5, vous devez désinstaller le logiciel comme indiqué dans son
guide d'installation avant d'exécuter le programme d'installation de
Workplace XT.
Important : Dans un environnement de serveurs en cluster à haute disponibilité, ces étapes doivent être réalisées sur tous les noeuds du cluster.
Pour mettre à niveau le logiciel
Workplace XT :
- Connectez-vous au serveur d'applications sur lequel est installé Workplace XT.
Option |
Description |
UNIX |
Connectez-vous sous un compte utilisateur disposant du droit d'écriture sur le répertoire /bin et des droits de lecture, d'écriture et d'exécution sur le répertoire prévu pour la mise à niveau de Workplace XT. |
Windows |
Connectez-vous en tant que membre du groupe d'administrateurs locaux, ou en tant qu'utilisateur possédant des droits équivalents. |
Dans cette documentation, la variable chemin d'installation fait référence au chemin du répertoire d'installation.
La valeur par défaut de cette variable dépend de la version et du système d'exploitation hôte de l'installation du produit :
- Version 1.1.3.x et éditions antérieures
- UNIX : /opt/FileNet/WebClient
- Windows : C:\Program Files\FileNet\WebClient
- Version 1.1.4.0 et éditions suivantes
- UNIX : /opt/IBM/FileNet/WebClient
- Windows : C:\Program Files\IBM\FileNet\WebClient
Conseil : Bien que l'utilisateur du programme d'installation sous UNIX doive avoir accès en écriture sur le répertoire /bin, le programme d'installation de Workplace XT n'y écrit pas.
- Dans Process Task Manager, arrêtez Component Manager (s'il est en cours), puis quittez Process Task Manager.
- (Windows seulement) Dans la console Windows Services, arrêtez le service Process WPXT Services Manager.
- (Windows seulement) Vérifiez dans le Gestionnaire des tâches Windows qu'aucun processus javaw.exe n'est en cours.
Si les applications se sont arrêtées correctement dans les étapes précédentes, aucun processus javaw.exe lié à Workplace XT n'est en cours d'exécution. Si nécessaire, utilisez le Gestionnaire de tâches Windows, ou un autre outil de gestion des processus, pour arrêter tous les processus javaw.exe du répertoire chemin d'installation\_WCjvm\bin.
- Sauvegardez l'application Web (client Web) Workplace XT, annulez son déploiement et supprimez-la du serveur d'applications J2EE.
Option |
Description |
WebSphere Application Server |
- Sauvegardez le répertoire Workplace XT déployé :
racine WAS/profiles/default/installedApps/nom du noeud/WorkplaceXT.ear/nom de l'application.war
- Arrêtez l'application Workplace XT dans la console d'administration WebSphere.
- Désinstallez l'application Workplace XT depuis Applications d'entreprise.
- Sauvegardez les modifications et arrêtez le serveur WebSphere.
- Supprimez le répertoire temporaire Workplace XT (par défaut : WorkplaceXT) dans :
racine WAS/profiles/default/temp/nom du noeud/instance/
- Supprimez tous les dossiers du répertoire wstemp à l'emplacement suivant :
racine WAS/profiles/nom du profil/wstemp
|
WebLogic Server |
- Depuis la console d'administration WebLogic Server, arrêtez le module d'application Web Workplace XT.
- Effectuez une copie de sauvegarde du dossier Workplace XT ou du répertoire déployé de Workplace XT :
- chemin d'installation/WorkplaceXT
- chemin d'installation/deploy/nom de l'application.war
- chemin d'installation/deploy/web-client.ear
- Supprimez le module d'application Web de Workplace XT.
- Arrêtez WebLogic Server.
- Supprimez le répertoire temporaire Workplace XT (par défaut : WorkplaceXT ou client_Web) dans :
racine WL/domaine/servers/instance/tmp/_WL_usr
|
JBoss Application Server |
- Arrêtez le serveur JBoss Application Server.
- Sauvegardez l'application Workplace XT déployée :
racine JBoss/server/nom du serveur/deploy/nom de l'application.war ou .ear
- Supprimez l'application Workplace XT dans le répertoire de déploiement.
- Supprimez tous les fichiers et tous les dossiers dans les répertoires temporaires suivants :
racine JBoss/server/nom du serveur/tmp/deploy
racine JBoss/server/nom du serveur/work/jboss.web/localhost
|
- (Systèmes sur lesquels la préférence de site IBM Content Manager OnDemand (CMOD) est configurée) Déplacez le fichier de clés CMOD et modifiez le paramètre de contexte keyStorePath dans le fichier web.xml.
- Copiez le fichier de clés CMOD, cmodKeyStore.
Le répertoire par défaut est le suivant :
chemin d'installation/WorkplaceXT/WEB-INF
- Placez la copie du fichier cmodKeyStore dans le répertoire Config/WebClient, dans le chemin suivant :
chemin d'installation/FileNet/Config/WebClient
Le chemin par défaut de la variable chemin d'installation varie selon la version de Workplace XT mise à niveau et selon le système d'exploitation :
- Version 1.1.3.x et éditions antérieures
- UNIX : /opt
- Windows : C:\Program Files
- Version 1.1.4.0 et éditions suivantes
- UNIX : /opt/IBM
- Windows : C:\Program Files\IBM
- Remplacez la valeur du paramètre keyStorePath du fichier web.xml par le nouvel emplacement du fichier de clés :
<context-param>
<param-name>keyStorePath</param-name>
<param-value>chemin d'installation/FileNet/Config/WebClient/cmodKeyStore
</param-value>
</context-param>
- Facultatif : Copiez les fichiers de configuration existants.
Si vous avez apporté des modifications aux fichiers de configuration dans le répertoire de déploiement, procédez comme suit avant de mettre à niveau l'installation Workplace XT existante.
Copiez les fichiers ci-dessous :
- WcmApiConfig.properties
- web.xml
du dossier /WEB-INF situé dans le répertoire de sauvegarde de Workplace XT créé à l'étape précédente, dans le répertoire suivant :
chemin d'installation/WorkplaceXT/WEB-INF/
- Mise à niveau à partir de JBoss 4.x.x vers JBoss 5.x.x seulement : Si Workplace XT est mis à niveau sur un système ayant bénéficié d'une mise à niveau de JBoss 4.x.x à JBoss
5.x.x, vous devez éditer le fichier web.xml et le copier dans chemin d'installation/WorkplaceXT/WEB-INF/ avant le déploiement de Workplace XT à l'aide de JBoss 5.x.x.
- Entrez les lignes suivantes à la fin de la section listener correspondante du fichier web.xml :
<listener>
<listener-class>com.sun.faces.config.ConfigureListener</listener-class>
</listener>
- Copiez le fichier jboss-classloading.xml situé dans le répertoire FileNet/WebClient/jboss5, et placez cette copie dans le répertoire chemin d'installation/WorkplaceXT/WEB-INF/.
- Facultatif : Installez le fichier de licence d'IBM Production Imaging Edition Viewer Pro. Si vous avez acquis IBM Production Imaging Edition, le logiciel Viewer Pro peut être installé au cours de l'installation de Workplace XT.
- Pour activer l'installation de Viewer Pro, exécutez le programme d'installation des licences avant de mettre à niveau Workplace XT. Démarrez le programme d'installation de licences d'IBM Production Imaging Edition Viewer Pro de l'une des manières suivantes, selon que vous souhaitez effectuer la mise en niveau en mode interactif ou silencieux :
Option |
Description |
Pour installer la licence IBM Production
Imaging Edition Viewer Pro de façon interactive : |
- Accédez au module d'installation de licences d'IBM Production Imaging Edition Viewer Pro.
- Lancez le programme d'installation (PIEProLic-1.1.5.0-système d'exploitation.bin ou .exe) et suivez les invites des écrans de l'assistant.
|
Pour installer la licence IBM Production
Imaging Edition Viewer Pro en mode silencieux : |
- Accédez au module d'installation d'IBM Production
Imaging Edition Viewer Pro, et copiez le fichier PIEsilent_input.txt dans un répertoire local.
- En vous aidant des valeurs de le feuille de travail, accédez au module IBM Production Imaging Edition Viewer
Pro et éditez le fichier d'entrée en mode silencieux et modifiez-le de façon qu'il contienne des réponses adaptées à votre installation.
Même si vous acceptez toutes les valeurs par défaut du fichier PIEsilent_input.txt, vous devez l'éditer pour accepter le contrat de licence (-V licenseAccepted="true").
- Depuis une invite de commande, naviguez jusqu'au programme d'installation et exécutez-le :
- UNIX
- ./PIEProLic-1.1.5.0-système d'exploitation.bin
-options "chemin du fichier de réponses modifié/XT_silent_upgrade.txt"
-silent
- Windows
- PIEProLic-1.1.5.0-Win.exe -options "chemin du fichier de réponses modifié\XT_silent_upgrade.txt"
-silent
|
Consultez le fichier PIEPro_install_log.txt situé dans le répertoire chemin d'installation/IBM/FileNet/PIEProLicense.
Corrigez les erreurs ou les incidents signalés dans le fichier journal avant de procéder à la mise à niveau de Workplace XT.
Les problèmes sont souvent introduits par le mot "ERROR" en début de ligne.
Remarque : Pour plus d'informations sur IBM Production Imaging Edition Viewer Pro, voir
Production Imaging Edition sur le site Web IBM.
- Démarrez le processus de mise à niveau en suivant l'une des procédures ci-dessous, selon que vous souhaitez effectuer la mise en niveau en mode interactif ou silencieux :
Option |
Description |
Pour mettre à niveau Workplace XT en mode interactif : |
- Accédez au module d'installation de Workplace XT.
- Lancez le programme d'installation (WorkplaceXT-1.1.5.0-système d'exploitation.bin ou .exe) et suivez les invites des écrans de l'assistant. Le programme d'installation détecte et copie les paramètres de l'installation Workplace XT précédente.
|
Pour mettre à niveau Workplace XT en mode silencieux : |
- Accédez au module d'installation de Workplace XT, et copiez le fichier XT_silent_upgrade.txt dans un répertoire temporaire.
- Suivez les instructions du fichier d'entrée en mode silencieux et modifiez ses valeurs de façon qu'il donne des réponses adaptées à votre installation.
Même si vous acceptez toutes les valeurs par défaut du fichier XT_silent_upgrade.txt, vous devez l'éditer pour accepter le contrat de licence (-V licenseAccepted="true").
- Depuis une invite de commande, naviguez jusqu'au programme d'installation et exécutez-le :
- UNIX
- ./WorkplaceXT-1.1.5.0-système d'exploitation.bin
-options "chemin du fichier de réponses modifié/XT_silent_upgrade.txt"
-silent
- Windows
- WorkplaceXT-1.1.5.0-Win.exe -options "chemin du fichier de réponses modifié\XT_silent_upgrade.txt"
-silent
|
- Lorsque la mise à jour est terminée, consultez fichier web_client_install_log_1.1.5.0.txt situé dans le répertoire chemin d'installation/FileNet/WebClient.
Vérifiez qu'il ne contient ni erreurs, ni incidents. Corrigez toutes les erreurs avant de continuer.
- Facultatif : Mettez à jour les fichiers pour la prise en charge des jetons utilisateur par Workplace XT.
Si les jetons utilisateur sont activés sur le système avant la mise à niveau et si vous utilisez la version 4.5.1, 5.0 ou 5.1 de Content Engine, les fichiers authentication-websphere.jar etlog4j-1.2.13.jar doivent être copiés à nouveau. Reportez-vous à l'une des sections ci-dessous pour configurer les jetons utilisateur et connaître l'emplacement à partir duquel ces fichiers doivent être copiés :
Option |
Description |
WebSphere |
- Copiez le fichier authentication-websphere.jar du répertoire :
chemin d'installation/FileNet/WebClient/WorkplaceXT/authenticationFiles
dans le répertoire :
racine WAS/AppServer/lib/ext
- Copiez le fichier log4j-1.2.13.jar du répertoire :
chemin d'installation/FileNet/WebClient/WorkplaceXT/WEB-INF/lib
dans le répertoire :
racine WAS/AppServer/lib/ext
|
WebLogic |
- Copiez le fichier authentication-weblogic.jar du répertoire :
chemin d'installation/FileNet/WebClient/WorkplaceXT/authenticationFiles
dans le répertoire :
racine WL/server/lib/mbeantypes
- Copiez le fichier log4j-1.2.13.jar du répertoire :
chemin d'installation/FileNet/WebClient/WorkplaceXT/WEB-INF/lib
dans le répertoire :
racine WL/server/lib/mbeantypes
|
JBoss |
Copiez le fichier authentication-utils.jar du répertoire :
chemin d'installation/FileNet/WebClient/WorkplaceXT/authenticationFiles
dans le répertoire :
racine JBoss/server/nom du serveur/lib
|
- Mise à niveau de WebLogic version 10.x vers la version 11g seulement : Configurez le paramétrage des cookies de la session Weblogic.
- Accédez au répertoire chemin d'installation/FileNet/WebClient/WorkplaceXT/WEB-INF.
- Sauvegardez le fichier weblogic.xml sous le nom weblogic.xml.bak.
- Copiez le fichier weblogic-11g.xml depuis le répertoire chemin d'installation de WebLogic/WebClient/weblogicFiles vers le répertoire WEB-INF du chemin d'installation de Workplace XT.
- Renommez le fichier weblogic-11g.xml en weblogic.xml. Il est nécessaire de copier et de renommer le fichier weblogic-11g.xml dans le nouvel emplacement avant de déployer Workplace XT à l'aide de WebLogic 11g.