Si vous n'avez pas installé le produit sur le serveur sur lequel vous déployez l'aide,
vous pouvez déployer l'aide sur le serveur d'applications Apache Tomcat.
Avant de commencer
- Le serveur que sur lequel vous configurez le contenu d'aide
doit être accessible aux utilisateurs derrière le pare-feu.
- Un fichier help.war se trouve sur votre serveur.
- Si le produit pour lequel vous configurez l'aide sur le serveur est installé 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 le produit n'est pas installé sur le serveur ou qu'il ne comprenait 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 installer 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é ; par exemple :
- 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é ; par exemple :
- Windows : C:\Program
Files\Java70
- Linux : /usr/local/java70/
- Téléchargez l'application serveur Apache Tomcat.
- Extrayez le contenu de l'archive compressée 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
faites-la pointer sur le répertoire CATALINA_HOME ;
par exemple : C:\apache-tomcat-version
- Ajoutez un utilisateur administrateur du serveur au fichier CATALINA_HOME/conf/tomcat-users.xml et
enregistrez les changements ; 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 startup. Le nom de ce fichier varie selon le système d'exploitation.
- Windows : startup.bat
- Linux : startup.sh
Apache Tomcat
fonctionne 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 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é, démarré et inclus dans la section Applications.
Il 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. Par exemple : http://localhost:8080/help/index.jsp.
Remarque : - Le système d'aide ne contient peut-être pas encore de contenu d'aide. Installez-y 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 d'aide sur le serveur en effectuant l'une des tâches suivantes :
- Si d'autres utilisateurs accèdent à ce contenu d'aide depuis des produits installés sur leurs ordinateurs, indiquez-leur le serveur, le port et le chemin d'accès au système d'aide. Assurez-vous de ne pas indiquer
localhost comme serveur.
Exemple :
http://serveur.ibm.com:8080/nom-aide/index.jsp- Serveur : serveur.ibm.com
- Port : 8080
- Chemin : /nom-aide