Si vous n'avez pas installé le produit sur le serveur
où vous déployez l'aide, vous pouvez effectuer le déploiement sur le serveur d'applications Apache
Tomcat.
Avant de commencer
- Le serveur sur lequel vous configurez le contenu d'aide
est accessible aux utilisateurs derrière le pare-feu.
- Un fichier help.war se trouve sur votre
serveur.
- Si le produit dont vous configurez l'aide est installé sur le serveur,
il se peut qu'un fichier help.war y soit déjà
installé.
- Recherchez le fichier help.war dans le répertoire répertoire_installation/help.
- Recherchez une version du fichier dont le nom inclut l'abréviation du produit.
Par exemple, clmhelp.war ou ramhelp.war
- Faites une recherche de *help.war dans votre répertoire d'installation.
- Si vous n'avez pas installé le produit sur le serveur ou si votre produit n'incluait pas
de fichier help.war, vous pouvez télécharger ce fichier
à l'adresse http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/war.
- Installez et configurez Apache Tomcat.
- Installez un Java™ Runtime
Environment (JRE) ou un kit de développeur
Java. Vous pouvez installer l'un des kits de développement IBM® du site http://www.ibm.com/developerworks/java/jdk/.
- Configurez une variable d'environnement avec le chemin du JRE ou du kit de développement Java :
- Si vous avez installé un JRE, créez une variable d'environnement JRE_HOME
et définissez la valeur au chemin du répertoire dans lequel vous avez installé
le JRE, par exemple :
- Windows : C:\Program
Files\Java70\jre
- Linux : /usr/local/java70/jre
- Si vous avez installé un kit de développement Java, créez une variable d'environnement JAVA_HOME et définissez la valeur au chemin du répertoire dans lequel vous avez installé le kit de développement Java ; par exemple :
- Windows : C:\Program
Files\Java70
- Linux : /usr/local/java70/
- Téléchargez l'application serveur Apache Tomcat.
- Extrayez le fichier archive compressé d'Apache Tomcat.
- Transférez le dossier extrait à un emplacement définitif. Cet emplacement est
appelé CATALINA_HOME ;
par exemple : C:\apache-tomcat-version
- Créez une variable d'environnement CATALINA_HOME et
définissez la valeur au répertoire CATALINA_HOME ; par
exemple : C:\apache-tomcat-version
- Dans le fichier CATALINA_HOME/conf/tomcat-users.xml,
ajoutez un utilisateur administrateur du serveur et sauvegardez les modifications ; par exemple :
<role rolename="manager-gui"/>
<user username="admin" password="admin" roles="manager-gui"/>
- Ouvrez le répertoire CATALINA_HOME/bin
et démarrez le serveur Apache Tomcat en exécutant le fichier de démarrage. Le nom du fichier
diffère selon votre système d'exploitation :
- Windows : startup.bat
- Linux : startup.sh
Le démarrage
d'Apache Tomcat est effectif lorsqu'un utilitaire de ligne de commande affiche un message d'information indiquant Server
Startup in nombre ms.
Procédure
Pour déployer le fichier help.war, procédez comme suit :
- Dans un navigateur, entrez l'URL suivante pour ouvrir l'application Tomcat
Manager : http://localhost:8080/manager/html
- Entrez le nom d'utilisateur et le mot de passe.
- Dans la section , cliquez sur Choose
file.
- Sélectionnez le fichier help.war.
- Cliquez sur Deploy. Le fichier help.war est déployé et démarré. Son nom
apparaît dans la section Applications. Le fichier help.war est également copié dans le
répertoire CATALINA_HOME/webapps.
- Vérifiez que vous pouvez accéder au système d'aide en ajoutant aide/index.jsp à la fin
de l'URL de l'application serveur, aide représentant ici
le nom de votre fichier .war. Par exemple : http://localhost:8080/help/index.jsp.
Remarque : - Le système d'aide ne contient peut-être pas encore
le contenu d'aide proprement dit. Dans ce cas, il vous reste à y installer la documentation.
- Si votre système d'aide est déployé sur le même serveur Apache Tomcat que
le produit, il démarre et s'arrête lorsque l'application du produit est elle-même démarrée et
arrêtée.
Que faire ensuite
- Installez le contenu de l'aide sur le serveur en effectuant l'une des
tâches suivantes :
- Fournissez l'URL du centre de documentation aux membres d'équipe
de votre organisation. Ils peuvent ajouter cette URL à leurs préférences d'aide du client Rational DOORS afin de rediriger leur accès à l'aide vers le serveur intranet, conformément à la description de
Changer la sélection de contenu d'aide. Assurez-vous que l'URL que vous communiquez ne contient pas localhost en tant
que nom de serveur ; par exemple, http://serveur.ibm.com:8080/aide/index.jsp