Mises à jour avec ReleaseBuilder

Vous pouvez utiliser le générateur d'édition ReleaseBuilder pour comparer les fichiers de configuration XML décrivant votre serveur de transfert (REV1) ainsi que votre serveur de transfert mis à jour (REV2). Vous pouvez également l'utiliser pour créer un fichier de configuration XML contenant les différences entre les deux serveurs. Vous pouvez alors utiliser ce fichier de sortie pour importer uniquement les différences depuis votre serveur de transfert (REV2) vers le serveur de production. Les fonctions qui sont inchangées depuis (REV1) sur le serveur de transfert (REV2) ne sont pas affectées par l'importation.

Avant de commencer

Assurez-vous que vos environnements de développement, de test et de production sont configurés de manière à permettre le déplacement de tous les artefacts et de la configuration.

Il est préférable d'exécuter le générateur d'édition sur un serveur d'intégration ou de transfert. L'exécution du générateur d'édition sur le serveur de production n'est pas conseillée car il consomme des ressources et affecte des services de portail aux utilisateurs.

ReleaseBuilder utile des fichiers de configuration XML pour créer un fichier de configuration XML de différences entre les deux serveurs. Ce fichier est utilisé pour transférer la nouvelle configuration de portail de votre serveur de transfert vers votre serveur de production. Afin d'exporter les configurations des serveurs, utilisez l'interface de configuration XML.

Pourquoi et quand exécuter cette tâche

Les fichiers XML de votre serveur de transfert (REV1) et de votre serveur de transfert mis à jour (REV2) se rapportent à deux exportations provenant du MÊME serveur de portail. La génération d'une édition signifie qu'un fichier XML contenant les mêmes modifications apportées au serveur de transfert entre REV1 et REV2 est généré. Le générateur d'édition n'est pas conçu pour déterminer les différences entre deux serveurs de portail distincts ou les modifications apportées à ces deux serveurs.

Remarque : Les instructions suivantes décrivent la génération d'une édition dans des installations qui n'utilisent pas de portails virtuels. Pour obtenir des instructions sur le transfert de portails virtuels, reportez-vous à la rubrique consacrée à la Génération d'une édition pour des installations de portail virtuel.

Procédure

  1. Procédez comme suit pour exporter la configuration du serveur de transfert REV1 :
    A faire : Exportez l'intégralité de la configuration de portail REV1 du serveur de transfert, sans inclure les utilisateurs, les informations sur le contrôle d'accès des utilisateurs ou toute autre configuration utilisateur.
    1. Sur le serveur de transfert, accédez au répertoire wp_profile_root/PortalServer/bin. Ce répertoire contient les outils du portail.
    2. Utilisez l'interface de configuration XML pour exporter la configuration REV1 du serveur de transfert. Un exemple de fichier est disponible, ExportRelease.xml.
      • AIX® HP-UX Linux™ Solaris: ./xmlaccess.sh -in ExportRelease.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://stagingserver.example.com:port/wps/config" -out stagingserverREV1_config.xml
      • IBM® i: xmlaccess.sh -in ExportRelease.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://stagingserver.example.com:port/wps/config" -out stagingserverREV1_config.xml
      • Windows™ : xmlaccess.bat -in ExportRelease.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://stagingserver.example.com:port/wps/config" -out stagingserverREV1_config.xml
      • z/OS® : ./xmlaccess.sh -in ExportRelease.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://stagingserver.example.com:port/wps/config" -out stagingserverREV1_config.xml

      La configuration exportée est stockée dans le fichier stagingserverREV1_config.xml.

  2. Développez et testez de nouvelles fonctions et de nouveaux portlets sur le serveur de transfert. Cette phase s'applique là où vous ajoutez ou supprimez des fonctions. Cette phase peut durer longtemps. Assurez-vous que le serveur de transfert est complètement testé et que le portail est prêt.
  3. Procédez comme suit pour exporter la configuration du serveur de transfert REV2 :
    A faire : Exportez l'intégralité de la configuration de portail REV2 du serveur de transfert, sans inclure les utilisateurs, les informations sur le contrôle d'accès des utilisateurs ou toute autre configuration utilisateur.
    1. On the staging server change to the wp_profile_root/PortalServer/bin directory. Ce répertoire contient les outils du portail.
    2. Exécutez la tâche suivante pour exporter la configuration du serveur de transfert REV2 :
      Remarque : Utilisez l'interface de configuration XML et le fichier exemple fourni appelé ExportRelease.xml.
      • AIX® HP-UX Linux™ Solaris : ./xmlaccess.sh -in ExportRelease.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://stagingserver.example.com:port/wps/config" -out stagingserverREV2_config.xml
      • z/OS® : ./xmlaccess.sh -in ExportRelease.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://stagingserver.example.com:port/wps/config" -out stagingserverREV2_config.xml
      • Windows™ : xmlaccess.bat -in ExportRelease.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://stagingserver.example.com:port/wps/config" -out stagingserverREV2_config.xml
      • IBM® i: xmlaccess.sh -in ExportRelease.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://stagingserver.example.com:port/wps/config" -out stagingserverREV2_config.xml

      La configuration exportée est stockée dans le fichier stagingserverREV2_config.xml.

  4. Si vous avez installé des portlets ou des applications supplémentaires, copiez les fichiers WAR requis depuis le serveur de transfert vers le répertoire d'installation wp_profile_root/PortalServer/deployed/archive sur le serveur de production.
    Remarque : Le répertoire deployed/archive réside toujours dans le chemin d'installation d'origine wp_profile_root, même si le serveur de production utilise un profil supplémentaire créé après l'installation.
    Remarque : Dans la mesure où Windows™ limite la longueur maximale du chemin à 260 caractères, le nom du fichier WAR ne doit pas comporter plus de 25 caractères. L'installation d'un fichier WAR dont le nom comporte plus de 25 caractères entraîne une erreur.
  5. Procédez comme suit pour générer les différences entre les configurations des serveurs de transfert REV1 et REV2 :
    Remarque : Procédez comme suit sur le serveur de transfert et non sur le serveur de production. L'analyse des différences d'édition génère une charge importante sur le système et utilise une grande quantité de mémoire dans le cas d'éditions importantes. Ne l'exécutez donc pas sur le système de production.
    1. Facultatif : Arrêtez le serveur du portail du système de transfert.
      Cette option libère des ressources pour le calcul de la différence entre les éditions.
    2. Sur le serveur de portail que vous venez d'arrêter, accédez au répertoire wp_profile_root/PortalServer/bin.
    3. Afin de générer le fichier de différences contenant le fichier de configuration des ajouts et suppressions, entrez l'une des commandes suivantes :
      Tableau 1. Commandes du fichier de différences
      Système d'exploitation Commande
      AIX® HP-UX Linux™ Solaris ./releasebuilder.sh -inOld stagingserverREV1_config.xml -inNew stagingserverREV2_config.xml -out outputfile.xml
      z/OS® : releasebuilder.sh -inOld stagingserverREV1_config.xml -inNew stagingserverREV2_config.xml -out outputfile.xml
      Windows™ : releasebuilder.bat -inOld stagingserverREV1_config.xml -inNew stagingserverREV2_config.xml -out outputfile.xml
      IBM® i: releasebuilder.sh -inOld stagingserverREV1_config.xml -inNew stagingserverREV2_config.xml -out outputfile.xml

      Le fichier de configuration de sortie obtenu contient les ajouts et suppressions à importer dans le serveur de production.

    4. Facultatif : Redémarrez le serveur de portail sur le système de transfert si vous l'aviez arrêté.
  6. Utilisez le fichier outputfile.xml contenant les différences entre les serveurs de portail REV1 et REV2 pour importer ces différences sur le serveur de production.
    Tableau 2. Tâche permettant d'importer les différences sur le serveur de production
    Système d'exploitation Commande
    AIX® HP-UX Linux™ Solaris ./xmlaccess.sh -in outputfile.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://productionserver.example.com:port/wps/config"
    z/OS® : xmlaccess.sh -in outputfile.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://productionserver.example.com:port/wps/config"
    Windows™ : xmlaccess.bat -in outputfile.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://productionserver.example.com:port/wps/config"
    IBM® i: xmlaccess.sh -in outputfile.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://productionserver.example.com:port/wps/config"
    Notes :
    1. Si les paramètres du portlet sont supprimés d'une configuration, le script de sortie généré par le générateur d'édition ne supprime pas ces paramètres du système cible.
    2. Les fichiers XML créés par le générateur d'édition n'ont aucun niveau de transaction défini. Pour définir un niveau de transaction, éditez le fichier XML créé par le générateur d'édition et ajoutez-y le niveau de transaction.