Si desea permitir a sus usuarios acceder al sistema de ayuda por Internet o por una intranet, puede instalar el centro informativo y los conectores de documentación en un servidor. Los clientes visualizan la ayuda navegando a un URL, y el sistema de ayuda se muestra en el navegador Web. El sistema de ayuda del centro informativo se puede usar para las aplicaciones de cliente y para las aplicaciones Web, a cuya ayuda se puede acceder remotamente. Están soportadas todas las características del sistema de ayuda, salvo las ayudas emergentes y la ayuda activa.
El sistema de ayuda del centro informativo permite pasar diversas opciones que pueden utilizarse para personalizar diversos aspectos del centro informativo. Están soportadas las siguientes opciones:
-vmargs -Xmx256M,
aumentará la memoria disponible para el centro informativo y permitirá dar servicio a una colección de manuales más amplia. Estos pasos están destinados al integrador del sistema de ayuda, pero no representan una respuesta para todos los escenarios posibles. Se da por sentado que ha recibido toda la documentación en forma conectores de Eclipse, y que, en general, está familiarizado con el sistema de ayuda de Eclipse.
La clase org.eclipse.help.standalone.Infocenter tiene un método main que puede utilizarse para lanzar el centro informativo desde una línea de mandatos. La sintaxis de los argumentos de línea de mandatos es:
-command start | shutdown | [-eclipsehome eclipseInstallPath] [-host helpServerHost] [-port helpServerPort] [-servertimeout timeout] [-noexec] [platform options] [-vmargs JavaVMarguments]
Para iniciar un centro informativo en el puerto 8081, emita un mandato start ejecutando
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help_2.1.0\help.jar org.eclipse.help.standalone.Infocenter -command start -eclipsehome d:\myApp\eclipse -port 8081
Para cerrar el centro informativo, emita un mandato shutdown ejecutando
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help_2.1.0\help.jar org.eclipse.help.standalone.Infocenter -command shutdown -eclipsehome d:\myApp\eclipse
Inicie el servidor Web. Haga que un navegador Web señale hacia la vía de acceso de la aplicación Web "de ayuda" ejecutada en un puerto especificado al iniciar el centro informativo. En la máquina en la que está instalado el centro informativo, sería http://localhost:8081/help/.
Al incluir el centro informativo como parte de otra aplicación, puede ser más conveniente iniciarlo o detenerlo utilizando las API de Java en lugar de utilizar mandatos del sistema. Si este es el caso, siga estos pasos:
String[] options = new String[] { "-eclipsehome", "d:\\myApp\\eclipse" , "-port", "8081" };
Infocenter infocenter = new Help(options);
helpSystem.start();
Para cerrar el centro informativo:
helpSystem.shutdown();
Eclipse contiene un centro informativo completo y no requiere la ejecución de otro software de servidor. Sin embargo, en un entorno inseguro como Internet, no es aconsejable que los clientes accedan directamente al centro informativo, sino hacerlo disponible a través de un servidor HTTP o un servidor de aplicaciones. La mayoría de servidores se suministran con módulos o servlets para delegar determinadas peticiones a otros recursos web. Por ejemplo, puede configurarse un módulo proxy de Apache HTTP Server para redireccionar las peticiones efectuadas a http://mycompany.com/myproduct/infocenter a http://internalserver:8081/help, que ejecuta un centro informativo. Esto puede lograrse añadiendo las líneas
LoadModule proxy_module modules/ApacheModuleProxy.dll ProxyPass /myproduct http://internalserver:8081/help ProxyPassReverse /myproduct http://internalserver:8081/helpal archivo conf/httpd.conf del servidor Apache que ejecuta el sitio web de mycompany.
El centro informativo no requiere todo el paquete de la plataforma Eclipse.
Es posible ejecutar el centro informativo con los siguientes conectores (ubicados en el directorio eclipse\plugins):
org.apache.lucene
org.apache.xerces
org.eclipse.core.boot
org.eclipse.core.resources
org.eclipse.core.runtime
org.eclipse.help
org.eclipse.help.appserver
org.eclipse.help.webapp
org.eclipse.tomcat
org.eclipse.update.core
Además de estos conectores, dependiendo del sistema operativo o de la arquitectura de la máquina, puede que también sea necesario instalar los fragmentos correspondientes de los conectores anteriores (si existen). Por ejemplo, en Windows es necesario añadir los siguientes fragmentos (también ubicados en el directorio eclipse\plugins):
org.eclipse.core.resources.win32
org.eclipse.update.core.win32