Si no ha instalado el producto en el servidor en el que está desplegando la ayuda, puede utilizar Apache Tomcat como una simple solución de servidor de aplicaciones en la que desplegar el sistema de ayuda.
Antes de empezar
- El servidor en el que configura el contenido de la ayuda, debe estar disponible para los usuarios que están protegidos mediante cortafuegos.
- Verifique si tiene un archivo help.war disponible en el servidor.
- Si ha instalado el producto para el que está configurando la ayuda en el servidor, es posible que ya tenga instalado un archivo help.war.
- Examine el directorio directorio_instalación/help y busque el archivo help.war.
- Busque una versión del archivo que incluya la abreviatura del producto como, por ejemplo, clmhelp.war o ramhelp.war
- Busque en el directorio de instalación *help.war.
- Si no ha instalado el producto en el servidor o el producto no incluye un archivo
help.war, descargue una versión del archivo help.war.
- Instale y configure Apache Tomcat.
- Instale Java™ Runtime Environment (JRE) o Java Development Kit (JDK). Puede elegir instalar uno de los kits de desarrollador de IBM®.
- Establezca una variable de entorno con la vía de acceso al JRE o JDK:
- Si ha instalado un JRE, cree una variable de entorno JRE_HOME y establezca el valor en la vía de acceso del directorio donde se ha instalado el JRE. Ejemplos:
- Windows: C:\Archivos de programa\Java70\jre
- Linux: /usr/local/java70/jre
- Si ha instalado un JDK, cree una variable de entorno JAVA_HOME y establezca el valor en la vía de acceso del directorio donde ha instalado el JDK. Ejemplos:
- Windows: C:\Archivos de programa\Java70\
- Linux: /usr/local/java70/
- Descargue la aplicación del servidor Apache Tomcat.
- Extraiga el archivo de Apache Tomcat.
- Mueva la carpeta extraída a una ubicación permanente. Esta ubicación se conoce como CATALINA_HOME. Ejemplo: C:\apache-tomcat-versión
- Cree una variable de entorno CATALINA_HOME y establezca el valor en el directorio CATALINA_HOME. Ejemplo: C:\apache-tomcat-versión
- Añada un usuario administrador del servidor en el archivo CATALINA_HOME/conf/tomcat-users.xml y guarde los cambios. Ejemplo:
<role rolename="gui-administrador"/>
<user username="admin" password="admin" roles="gui-administrador"/>
- Abra el directorio CATALINA_HOME/bin y ejecute el archivo de inicio para iniciar el servidor de Apache Tomcat.
- Windows: startup.bat
- Linux: startup.sh
Apache Tomcat se ejecuta cuando aparece el mensaje de información Server
Startup en número ms en un programa de utilidad de línea de mandatos.
Procedimiento
Para desplegar help.war:
- En un navegador, escriba el URL siguiente para abrir la aplicación Tomcat Manager: http://localhost:8080/manager/html
- Especifique la contraseña y el nombre de usuario.
- En la sección , pulse Choose
file.
- Seleccione el archivo help.war.
- Pulse Deploy. Se despliega el archivo help.war, se inicia y se visualiza en la sección Aplicaciones.
El archivo help.war también se copia en el directorio CATALINA_HOME/webapps.
- Verifique que puede acceder al sistema de ayuda añadiendo help/index.jsp al final del URL de la aplicación del servidor donde help es el nombre del archivo .war. Ejemplo: http://localhost:8080/help/index.jsp.
Nota: - Es posible que el sistema de ayuda no pueda contener contenido de ayuda todavía.
Puede que sea necesario instalar la documentación en el sistema de ayuda la próxima vez.
- Si el sistema de ayuda se despliega en el mismo servidor Apache Tomcat que el producto, el sistema de ayuda se inicia y se detiene cuando la aplicación del producto se inicia y se detiene.
Qué hacer a continuación
- Instale la documentación en el servidor:
- Proporcione el URL del Information Center a los usuarios de su organización para entrar sus preferencias. Asegúrese de que el servidor que proporcione no sea localhost.
Ejemplo: http://server.ibm.com:8080/help/index.jsp