FileNet P8 Application Engine, Version 5.0.+              

Préparation de la mise à niveau d'Application Engine

Avant d'être mise à niveau, l'installation Application Engine doit être préparée. Cette préparation comprend la sauvegarde des fichiers existants et l'annulation du déploiement de l'application Web.

Consultez la rubrique relative à la désinstallation de logiciel dans le manuel IBM FileNet P8 eForms Installation and Upgrade Guide .

Important : Haute disponibilité Dans un environnement de serveurs en cluster à haute disponibilité, ces étapes doivent être réalisées sur tous les noeuds du cluster.
Pour préparer la mise à niveau d'Application Engine, procédez comme suit :
  1. Connectez-vous au serveur Application Engine.
    Option Description
    UNIX Connectez-vous en tant qu'utilisateur disposant des droits de lecture, d'écriture et d'exécution sur le répertoire prévu pour l'installation d'Application Engine.
    Windows Connectez-vous en tant que membre du groupe d'administrateurs locaux, ou en tant qu'utilisateur possédant des droits équivalents.
  2. (Mises à niveau à partir de 3.5 seulement) Vérifiez que le routeur de processus est arrêté.
    Conseil : Bien que le routeur Application Engine ait été supprimé lors de la mise à niveau de Process Engine, il est possible qu'une instance locale, déconnectée, soit en cours sur le serveur.
    1. Lancez Process Task Manager depuis chemin_d_installation_d_AE/Router :
      UNIX
      ./routercmd.sh
      Windows
      routercmd.bat
    2. Arrêtez le routeur s'il fonctionne.

      Il s'agit du routeur configuré et démarré lors de l'installation de FileNet P8 Platform 3.5. Pour plus d'informations, consultez la tâche relative au démarrage du routeur de processus dans le manuel IBM FileNet P8 Platform 3.5 - Guide d'installation et de mise à niveau.

    3. Quittez Process Task Manager.
  3. (Windows) Vérifiez dans le Gestionnaire des tâches Windows qu'aucun processus javaw.exe n'est en cours. Si les applications des étapes précédentes se sont arrêtées correctement, aucun processus javaw.exe lié à Application Engine ne devrait être en cours d'exécution.
    1. Utilisez les Services Windows pour arrêter le service Gestionnaire de services de Process Application Engine. Sélectionnez Démarrer > Tous les programmes > Outils d'administration > Services. Si l'état du Gestionnaire de services de Process Application Engine est Démarré, sélectionnez-le avec le bouton droit et cliquez sur Stop.
    2. Si des processus javaw.exe liés à Application Engine sont encore en cours après l'arrêt du Gestionnaire de services de Process Application Engine, utilisez le Gestionnaire des tâches Windows pour les arrêter.
  4. Sauvegardez l'application Web Workplace, annulez son déploiement et supprimez-la du serveur d'applications J2EE.

    Au cours de cette étape, vous créez une copie de sauvegarde de l'application Web déployée contenant tous les fichiers personnalisés et les fichiers de configuration stockés dans le répertoire WEB-INF.

    Même si le programme d'installation crée une sauvegarde automatique des fichiers de configuration existants d'Application Engine 3.5 ou 4.0.1, il est recommandé de sauvegarder les répertoires ci-dessous pour effectuer une sauvegarde complète du système déployé. Il est possible que vous ayez besoin de ces fichiers ultérieurement pour conserver les paramètres 3.5 ou 4.0.1. Par exemple, lorsque vous copiez des fichiers modifiés dans le répertoire de l'installation Workplace et que vous effectuez la mise à niveau et la configuration d'Application Engine,

    Option Description
    WebSphere Application Server
    1. Faites une copie de sauvegarde du répertoire de déploiement de Workplace (sauvegarde_déploiement) : RACINE_WAS/profiles/default/installedApps/nom_noeud/app_engine_war.ear/app_engine.war

      Le chemin peut être différent si vous avez créé un nouveau profil ou renommé le fichier WAR.

    2. Arrêtez l'application Workplace depuis la console d'administration WebSphere.
    3. Désinstallez l'application Workplace depuis Enterprise Applications.
    4. Sauvegardez les modifications et arrêtez WebSphere Application Server.
    5. Supprimez le répertoire temporaire Workplace (par défaut : app_engine_war) dans : RACINE_WAS/profiles/default/temp/nom_noeud/instance/app_engine.war
    WebLogic Server
    1. Depuis la console d'administration WebLogic Server, arrêtez le module d'application Web Workplace.
    2. Faites une copie de sauvegarde du dossier Workplace (sauvegarde_déploiement) : chemin_d_installation_d_AE/Workplace
    3. Supprimez le module d'application Web de Workplace.
    4. Arrêtez WebLogic Server.
    JBoss Application Server
    1. Arrêtez JBoss Application Server.
    2. Faites une copie de sauvegarde du répertoire de déploiement de Workplace (sauvegarde_déploiement) : RACINE_JBoss/server/default/deploy/Workplace.war
    3. Supprimez le répertoire de déploiement de Workplace : RACINE_JBoss/server/default/deploy/Workplace.war
    4. Supprimez le répertoire temporaire de Workplace pour JBoss : RACINE_JBoss/server/default/work/jboss.web/localhost/Workplace
  5. Copiez les fichiers modifiés dans le répertoire de l'installation Workplace. Au cours de la mise à niveau, les fichiers de configuration sont déplacés du répertoire suivant :

    chemin_d_installation_d_AE/Workplace/WEB-INF

    vers

    chemin_d_installation_d_AE/Config/AE

    Si vous avez modifié certains de ces fichiers directement dans le répertoire de déploiement de Workplace (app_engine.war pour WebSphere Application Server ou Workplace.war pour JBoss) dans l'environnement 3.5. ou 4.0.1, vous devez copier la version modifiée de ces fichiers du répertoire sauvegarde_déploiement vers le répertoire de l'installationchemin_d_installation_d_AE/Workplace/WEB-INF avant de démarrer le programme d'installation.
    • actions.xml
    • bootstrap.properties
    • ClassFilter.xml
    • ConfigurableLabels.xml
    • containericons.properties
    • content_redir.properties
    • customobjecticons.properties
    • download_redir.properties
    • fnsoap.xml
    • icons.properties
    • InfoPages.xml
    • PagingConfiguration.xml
    • PolicyProcessors.xml
    • PrimaryViews.xml
    • PropertiesPages.xml
    • SimpleSearch.xml
    • SystemsPropertiesView.xml
    Pendant la mise à niveau, le programme d'installation crée automatiquement une sauvegarde des fichiers de configuration Application Engine 3.5 ou 4.0.1 existants, en ajoutant le suffixe .old à la fin de leur nom.
    • actions.xml.old
    • ClassFilter.xml.old
    • ConfigurableLabels.xml.old
    • containericons.properties.old
    • content_redir.properties.old
    • icons.properties.old
    • SystemsPropertiesView.xml.old
    • UpdateActions.xml.old
    • UpdateClassFilter.xml.old
    • UpdateConfigurableLabels.xml.old
    • UpdateProps.xml.old
    • UpdateSystemPropertiesView.xml.old
    • UpdateWeb.xml.old
    • web.xml.old

    Les fichiers sauvegardés sont dans : chemin_d_installation_d_AE/backup-4_0_2

  6. Haute disponibilité Si vous réalisez la mise à niveau dans un environnement à haute disponibilité, effectuez en outre les étapes de sauvegarde suivantes .
    • Sauvegardez le fichier partagé bootstrap.properties dans l'emplacement réseau partagé.
    • Copier tous les fichiers de configuration dans le répertoire partagé de configuration, si vous en utilisez un.
    • (Mise à niveau Application Engine 3.5 seulement) Un répertoire partagé de configuration sera créé sous le répertoire d'origine du fichier bootstrap.

      Par exemple : si le répertoire partagé d'amorçage 3.5.x était Z:, le nouveau répertoire partagé de configuration sera Z:\AE\.



Commentaires

Dernière mise à jour : Novembre 2010


© Copyright IBM Corp. 2010.
Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)