Installation de CPS au moyen de l'installation de fichier WAR

Génération du fichier WAR au moyen d'un programme d'installation

La première étape d'installation du fichier WAR pour CPS consiste à employer un programme d'installation pour générer un fichier WAR et les fichiers de données associés dans une structure de répertoire. Le programme d'installation configure également les fichiers WAR pour référencer les fichiers de données installés.

Utilisation du programme d'installation de CPS pour la génération d'un fichier WAR (Windows) :

1. Téléchargez le programme d'installation.

2. Double-cliquez sur le fichier pour lancer le programme d'installation.

3. Lisez et acceptez le contrat de licence pour poursuivre l'installation.

4. Dans la fenêtre Méthode d'installation, sélectionnez l'option relative aux fichiers WAR.

5. Confirmez l'emplacement proposé par défaut ou cliquez sur Choisir pour sélectionner un autre emplacement.

   L'emplacement par défaut est : C:/Program Files/Macromedia/Contribute Publishing Server

6. Suite à l'indicatif, entrez le mot de passe administratif afin de restreindre l'accès à la console CPS.

   Il ne s'agit pas du mot de passe de protection du rôle administrateur de Contribute. Par conséquent, il est recommandé d'en conserver une trace.

7. Cliquez sur Fermer après avoir consulté les informations de la fenêtre récapitulative.

   Le programme d'installation crée une structure de répertoire qui inclut un fichier WAR et les fichiers de données associés.

8. A présent, vous pouvez déployer le fichier WAR.

   Pour plus d'informations, voir Déploiement du fichier WAR.

Utilisation du programme d'installation de CPS pour la génération d'un fichier WAR (UNIX) :

1. Téléchargez le fichier d'installation.

2. Suite à l'indicatif de commande, entrez la commande suivante pour définir les autorisations d'exécution du script de shell d'installation JRun :

   chmod +x pubserver-linux.bin

   Remarque : Si vous installez sur la plate-forme Solaris, remplacez solaris par linux dans la commande.

3. Entrez la commande suivante pour exécuter le script d'installation de JRun :

   sh ./pubserver-linux.bin

   Remarque : Si vous installez sur la plate-forme Solaris, remplacez solaris par linux dans la commande.

   Le programme d'installation extrait les fichiers d'installation, puis exécute le script d'installation.

4. Consultez les différents écrans du contrat de licence, puis acceptez-le pour poursuivre l'installation.

5. Dans la fenêtre Méthode d'installation, sélectionnez l'option relative aux fichiers WAR.

6. Dans l'écran Dossier d'installation, acceptez l'emplacement d'installation par défaut, ou entrez un autre emplacement.

7. Dans l'écran Mot de passe administrateur, entrez un mot de passe administratif pour restreindre l'accès à la console CPS.

   Il ne s'agit pas du mot de passe de protection du rôle administrateur de Contribute. Par conséquent, il est recommandé d'en conserver une trace.

8. Consultez l'écran récapitulatif, puis appuyez sur Entrée lorsque vous êtes prêt.

   Le programme d'installation crée une structure de répertoire qui inclut un fichier WAR et les fichiers de données associés.

9. A présent, vous pouvez déployer le fichier WAR.

   Pour plus d'informations, voir Déploiement du fichier WAR.

Déploiement du fichier WAR

Lorsque vous disposez du fichier WAR, vous êtes prêt à le déployer sur le serveur d'applications J2EE.

L'application CPS doit s'exécuter à partir de la structure de répertoires étendue. Les serveurs d'application J2EE peuvent varier selon la façon dont vous déployez le fichier WAR et créez la structure de répertoires étendue. De manière générale, il existe deux méthodes :

1. Déployez le fichier WAR compressé dans un répertoire de travail.

   Sur certains serveurs d'applications J2EE (par exemple IBM WebSphere), le déploiement décompresse le fichier WAR dans un répertoire de travail, le répertoire décompressé étant ensuite considéré comme l'application. Dans ce cas, vous devez décompresser le fichier WAR et travailler dans la structure de répertoires ainsi créée.

2. Développez le fichier WAR et déployez la structure étendue en tant que répertoire de travail.

   Sur d'autres serveurs d'application (tels que JRun 4, BEA WebLogic et JBoss), vous devez étendre le fichier WAR de façon manuelle, puis déployer la structure de répertoires étendue, qui devient alors votre répertoire de travail.

   Remarque : Vous devez étendre le fichier WAR puis déployer la structure étendue dans un répertoire de travail sur certains serveurs d'applications Java de façon à empêcher le serveur d'extraire le fichier WAR compressé dans un répertoire temporaire lorsque ce serveur est démarré. Dans ce cas, les données d'application stockées dans le fichier ckm.xml sont écrites à chaque fois que le serveur extrait le fichier WAR compressé dans un répertoire temporaire.

   La méthode de déploiement utilisée dépend du serveur d'applications.

   Pour plus d'informations, consultez la documentation du serveur d'applications Java concernant le déploiement d'un fichier WAR.

   La procédure suivante démontre comment déployer CPS sur un serveur JRun 4.

   Remarque : La procédure suivante suppose qu'une version de JRun 4 est déjà installée.

Déploiement du fichier WAR sur un serveur JRun 4 :

1. Développez de façon manuelle le fichier pubserver.war dans le dossier d'installation.

    Suite à l'invite de commande, changez le dossier d'installation de CPS.

2. Créez votre répertoire de travail, à l'aide de la commande suivante :

   mkdir pubserver-war (UNIX)

   ou

   md pubserver-war (Windows)

   1. Ouvrez votre répertoire de travail, à l'aide de la commande suivante :

      cd pubserver-war 

   2. Développez le fichier WAR dans votre répertoire de travail, à l'aide de la commande suivante :

      java_home/bin/jar -xvf ../pubserver.war 

      où java_home correspond au répertoire racine de votre environnement d'exécution JRE (Java Runtime Environment).

3. Démarrez le serveur JRun si ce dernier n'est pas encore en cours d'exécution.

4. Ouvrez un navigateur Web et saisissez l'URL de la Console d'administration de JRun.

   Pour l'emplacement d'installation par défaut, l'URL est : http://localhost:8000.

   La Console d'administration JRun s'affiche dans votre navigateur Web.

5. Entrez le nom d'utilisateur et le mot de passe de l'administrateur JRun.

6. Développez l'icône du serveur par défaut dans le volet gauche, puis cliquez sur l'icône des composants J2EE.

7. Cliquez sur le bouton Ajouter du panneau Applications Web.

8. Accédez au répertoire de travail que vous avez créé (pubserver-war) en cliquant sur Parcourir, ou en entrant le chemin dans le champ texte Chemin d'accès du fichier.

   Afficher le graphique à sa taille d'origine

   
   

9. Cliquez sur Déployer.

   Le répertoire de travail est déployé dans JRun et l'écran Composants J2EE : Récapitulatif apparaît.

   Remarque : Dans la section des paramètres généraux, confirmez que le chemin de contexte est défini sur /contribute.
   Afficher le graphique à sa taille d'origine

   
   

10. Cliquez sur l'icône Connexion dans le panneau gauche.

    L'écran Afficher le journal s'affiche. Consultez le journal pour vous assurer que le serveur a démarré correctement.

11. Si vous n'avez pas utilisé un programme d'installation pour générer le fichier WAR et configurer les emplacements de fichiers CPS, vous pouvez passer à  Configuration des emplacements des fichiers de CPS ; si vous avez utilisé un programme d'installation, vous pouvez sauter cette étape à moins que vous ne souhaitiez changer l'emplacement de stockage des données CPS.

12. Vous êtes à présent prêt à vous connecter à la console CPS et à configurer CPS.

    Pour plus d'informations, voir Configuration du serveur CPS (Contribute Publishing Server) uniquement.

Déploiement de CPS sur les serveurs d'applications JBoss (Macintosh)

JBoss est un serveur d'applications Java de source ouverte généralement déployé sur les serveurs Macintosh OS X. Adobe recommande de développer de façon manuelle le fichier pubserver.war dans le dossier d'installation, puis de copier le fichier WAR étendu dans le dossier : <accueil_JBoss>/server/default/deploy.

Déploiement de CPS sur le serveur d'applications JBoss :

1. Arrêtez le serveur d'application JBoss en ouvrant une fenêtre de terminal et en exécutant le script shutdown.sh.

   % <JBoss_home>/server/bin/shutdown.sh 

2. Développez de façon manuelle le fichier pubserver.war, puis copiez le fichier WAR étendu dans le dossier <accueil_JBoss>/server/default/deploy.

3. Créez le dossier « database ».

   Ce dossier permet de stocker les informations de connexion et relatives à l'utilisateur.

4. Créez le fichier database.xml dans le dossier database. Si vous employez un répertoire utilisateur à base de fichier, assurez-vous que le fichier user_directory.xml figure également dans le dossier database. Par défaut, le contenu du fichier user_directory.xml a l'aspect suivant :

   <?xml version="1.0" encoding="UTF-8"?> 
   <directory> 
   </directory>

5. Suite à l'invite de commande, sélectionnez le dossier WEB-INF/config dans votre environnement de travail CPS.

6. Ouvrez le fichier ckm.xml dans un éditeur de texte.

   Remarque : Vous pouvez modifier l'emplacement du dossier de base de données et des fichiers d'erreur en fonction de vos critères de déploiement.

7. Vous pouvez changer la valeur du chemin en <répertoire_accueil> pour désigner le dossier créé à l'étape 3 pour stocker des informations sur les utilisateurs et les connexions.

   L'exemple suivant transforme le chemin du dossier de données en : < Macintosh HD >/Contribute Publishing Server/database.

   Remarque : Si vous avez déjà ajouté des informations sur l'utilisateur et la connexion dans CPS, déplacez ces informations de l'emplacement actuel vers le nouvel emplacement que vous avez défini.

   Par exemple :

   <plugin_fileDatabase> 
   <home_directory><Macintosh HD>/Contribute Publishing Server/database 
   </home_directory> 
   </plugin_fileDatabase>

8. Vous pouvez changer la valeur du chemin en <paramètres_journalisation> pour indiquer à quel emplacement vous souhaitez stocker les journaux d'erreurs et sorties CPS.

   Par exemple :

   <out> 
       <file><Macintosh HD>/Contribute Publishing Server/logs/out.log</file> 
   </out> 
   <err> 
       <file><Macintosh HD>/Contribute Publishing Server/err.log</file> 
   </err> 

9. Enregistrez et fermez ckm.xml, puis redémarrez votre serveur d'applications JBoss.

   Pour redémarrer JBoss, exécutez le script run.sh dans une fenêtre de terminal.

   % <JBoss_home>/server/bin/run.sh 

10. Vous êtes à présent prêt à vous connecter à la console CPS et à configurer CPS.

    A l'aide d'un navigateur Web, utilisez l'URL suivante : https://<serveur>/8080/cps/<racine_contexte>/admin.

    Remplacez les variables <serveur> et <racine_contexte> par le nom de domaine (ou l'adresse IP) de votre serveur et le nom racine du contexte CPS (le nom du fichier WAR).

    Pour plus d'informations, voir Configuration du serveur CPS (Contribute Publishing Server) uniquement.

Configuration des emplacements des fichiers de CPS

CPS stocke les informations de connexion et de l'utilisateur, ainsi que les journaux, dans votre système de fichiers local, puis indique l'endroit où ces fichiers ont été stockés.

Configuration du fichier WAR :

1. Suite à l'invite de commande, sélectionnez le dossier WEB-INF\config dans votre environnement de travail CPS.

2. Ouvrez le fichier ckm.xml dans un éditeur de texte.

3. Vous pouvez changer la valeur du chemin en <répertoire_accueil> pour indiquer à quel emplacement vous souhaitez stocker les informations sur les utilisateurs et les connexions.

   Remarque : Si vous avez déjà ajouté des informations sur l'utilisateur et la connexion dans CPS, déplacez ces informations de l'emplacement actuel vers le nouvel emplacement que vous avez défini.

4. Vous pouvez changer la valeur du chemin en <paramètres_journalisation> pour indiquer à quel emplacement vous souhaitez stocker les journaux d'erreurs et sorties CPS.

   Par exemple :

   <out> 
       <file>C:\Contribute Publishing Server\logs\out.log</file> 
   </out> 
   <err> 
       <file>C:\Contribute Publishing Server\err.log</file> 
   </err> 

5. Enregistrez et fermez ckm.xml, puis redémarrez votre serveur d'applications JBoss.

6. Vous êtes à présent prêt à vous connecter à la console CPS et à configurer CPS.

   Pour plus d'informations, voir Configuration du serveur CPS (Contribute Publishing Server) uniquement.