Si vous comptez déployer le système d'aide sur un serveur autre que celui où vous
avez installé le produit, vous pouvez utiliser Apache Tomcat comme solution de serveur d'applications simple.
Avant de commencer
- Le serveur sur lequel vous configurez le contenu d'aide
doit être accessible aux utilisateurs derrière le pare-feu.
- Vérifiez qu'un fichier help.war est
disponible sur votre serveur.
- Si vous avez installé le produit dont vous configurez l'aide sur
le serveur, un fichier help.war est peut-être 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, téléchargez une version
du fichier help.war.
- Installez et configurez Apache Tomcat.
- Installez un JRE (Java™ Runtime
Environment) ou JDK (Java Development
Kit). Vous pouvez opter pour l'installation de
l'un des kits de développement IBM®.
- Configurez une variable d'environnement avec le chemin du JRE ou du JDK :
- Si vous avez installé un JRE, créez une variable d'environnement JRE_HOME et faites-la pointer
sur le répertoire où ce JRE est installé. Exemples :
- Windows : C:\Program
Files\Java70\jre
- Linux : /usr/local/java70/jre
- Si vous avez installé un JDK, créez une variable d'environnement JAVA_HOME et faites-la pointer
sur le répertoire où ce JDK est installé. Exemples :
- Windows : C:\Program
Files\Java70
- Linux : /usr/local/java70/
- Téléchargez l'application serveur Apache Tomcat.
- Extrayez l'archive d'Apache Tomcat.
- Transférez le dossier extrait à un emplacement définitif. On utilise CATALINA_HOME pour faire
référence à cet emplacement.
Exemple : C:\apache-tomcat-version
- Créez une variable d'environnement CATALINA_HOME et donnez-lui pour valeur
le nom du répertoire CATALINA_HOME. Exemple : C:\apache-tomcat-version
- Ajoutez un utilisateur administrateur du serveur au fichier CATALINA_HOME/conf/tomcat-users.xml et
enregistrez les changements. Exemple :
<role rolename="manager-gui"/>
<user username="admin" password="admin" roles="manager-gui"/>
- Ouvrez le répertoire CATALINA_HOME/bin et
exécutez le fichier startup pour démarrer le serveur Apache Tomcat.
- Windows : startup.bat
- Linux : startup.sh
Le démarrage
d'Apache Tomcat est effectif lorsqu'un utilitaire de ligne de commande affiche le message d'information Server
Startup in nombre ms.
Procédure
Pour déployer le fichier help.war :
- Dans un navigateur, entrez l'URL suivante pour ouvrir Tomcat
Manager Application : 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 du serveur, aide représentant ici
le nom de votre fichier .war. 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 la documentation sur le serveur :
- Indiquez aux utilisateurs le serveur, le numéro de port et le chemin du système d'aide afin qu'ils
entrent ces informations sur la page Système d'aide
d'IBM Installation Manager.
Assurez-vous de ne pas indiquer
localhost comme serveur.
Exemple : Pour
http://serveur.ibm.com:8080/aide/index.jsp,
les valeurs à entrer sont :
- Serveur : serveur.ibm.com
- Port : 8080
- Chemin : /aide