FileNet P8 Application Engine, Version 5.2.1              

Préparation de la mise à niveau de 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.

Pourquoi et quand exécuter cette tâche

  • Lisez les explications relatives à Application Engine dans le manuel Plan and Prepare Your Environment for IBM FileNet P8.
  • Prenez connaissance des étapes nécessaires à la conservation de la configuration 3.5 ou 4.0.1 d'Application Engine. Ces informations vous seront utiles si, pour une raison quelconque, vous souhaitez annuler cette installation.
  • Vérifiez que tous les paramètres nécessaires ont été enregistrés.

    (Recommandations pour les sauvegardes) Pour conserver les paramètres Application Engine existants, enregistrez-les avant de procéder à la mise à niveau.

    • Dans le cadre de la mise à jour, vous allez créer des copies de sauvegarde de tous les fichiers de configuration 3.5 ou 4.0.1 importants.
    • Au cours de la mise à niveau, un certain nombre de fichiers de configuration existants seront déplacés dans le répertoire chemin_d_installation_d_AE/Config/AE nouvellement créé. High availabilityDans un environnement à haute disponibilité, vous devez copier ces fichiers de configuration dans le répertoire partagé de configuration, si vous en utilisez un.
    • 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.
    • Les fichiers existants Actions.xml et web.xml de la version 3.5 ou 4.0.1 sont fusionnés avec ceux de la version 4.0.2 au cours de la mise à niveau.
    • Par ailleurs, tous les commentaires ajoutés au fichier Actions.xml sont perdus lors de la fusion.
  • Si le produit d'expansion IBM® FileNet P8 eForms est installé, désinstallez-le.

Voir la rubrique relative à la suppression des logiciels dans IBM FileNet P8 eForms Installation and Upgrade Guide.

High availabilityImportant : 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 :

Procédure

  1. Connectez-vous au serveur Application Engine.
    Option Description
    AIX, HPUX, Linux, Linux on System z, Solaris 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. (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.
  3. Sauvegardez l'application Web Workplace, annulez son déploiement et supprimez-la du serveur d'applications Java™ EE.

    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. Enregistrez les modifications et arrêtez l'instance 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 l'instance WebLogic Server.
    JBoss Application Server
    1. Arrêtez l'instance 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
  4. 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

  5. High availabilitySi 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\.



Dernière mise à jour : Octobre 2015
p8pup068.htm

© Copyright IBM Corp. 2013, 2015.