http://tomcat.apache.org/

x

Si está utilizando ReportCaster, la ubicación de JDBC debe estar en la CLASSPATH de Tomcat. Tomcat se ejecuta como un servicio Windows, y por tanto, CLASSPATH se encuentra establecido en el registro. Si decidió configurar Tomcat durante la instalación de WebFOCUS, esta ya se ha ocupado de establecerlo por ud.

Para establecer Java Classpath o resolver errores de forma manual, compruebe su campo CLASSPATH y asegúrese de incluir el controlador JDBC.

Nota: Si el controlador no aparece, añada un punto y coma al final del campo Java Classpath. A continuación, añada la ruta absoluta del controlador JDBC de su repositorio. Si necesita más de una fila, sepárelas con puntos y comas. Puede haber espacios en los nombres de los directorios, pero no entre las rutas y los puntos y comas. Asegúrese de incluir el nombre del archivo, y no solo el directorio que contiene el archivo. Por ejemplo:

C:\ibi\tomcat\bin\bootstrap.jar;C:\drivers\sqljdbc.jar

Para más información sobre los controladores JDBC, consulte Temas y tareas adicionales del repositorio de ReportCaster.

x

Por defecto, Tomcat usa los tres puertos TCP listados más abajo.

Puerto predeterminado	Nombre	Use
8080	Puerto listener HTTP	Puede acceder a Tomcat desde un navegador, mediante este puerto. Por ejemplo: http://localhost:8080
8009	Puerto conector	Los servidores Web enrutan las solicitudes a Tomcat, en este puerto. El conector Tomcat (complemento) para IIS utiliza este puerto. Si cambia el puerto y utiliza el conector, cambie el puerto en el archivo workers.properties del conector.
8005	Puerto de desconexión	Tomcat usa este puerto para operaciones internas y desactivación.

Normalmente, no necesita cambiar estos puertos. Sin embargo, si estos puertos no están disponibles o desea modificarlos, haga lo siguiente:

1. Abra el siguiente archivo en el editor de texto:

   C:\ibi\tomcat\conf\server.xml

2. Localice los números de puertos que desea reemplazar (8080, 8009, 8005), y sustitúyalos por los puertos que desea utilizar.
3. Guarde y cierre el archivo.

Si cambia estas opciones predeterminadas, realice las susticiones correspondientes en los procedimientos y ejemplos.

drive:\ibi\WebFOCUS77\webapps\webfocus

http://localhost:8080/ibi_apps/

x

1. Detenga Tomcat desde la ventana Windows Services, pulsando con el botón derecho sobre Apache Tomcat y escoja Detener.
2. Vaya al siguiente directorio en el Explorador de Windows o Mi PC:

   C:\ibi\tomcat\conf\Catalina\localhost

   Nota: Si dispone de una versión existente de Tomcat, que no ha sido instalada por un versión WebFOCUS, el directorio estará bajo:

   C:\Program Files\Apache Software Foundation\Tomcat X.X\conf\Catalina\localhost

   Este directorio puede contener archivos XML, que definen contextos. Si la instalación de WebFOCUS ha instalado y configurado Tomcat por ud., el archivo siguiente debería aparecer, para definir el contexto ibi_apps que implementa su directorio webfocus:

   ibi_apps.xml

   ibi_help.xml

   Si cuenta con una instalación Tomcat independiente, también debería aparecer lo siguiente:

   approot.xml
   ibi_html.xml

   Los nombres de los archivos XML se corresponden con la ruta de contexto utilizada para acceder a la aplicación Web, y deben tener la sintaxis siguiente:

   <?xml version='1.0' encoding='utf-8'?>
   <Context docBase="path_To_WebApplication" path="/contextRoot">
   </Context>

   donde:

   path_To_WebApplication

   Es la ruta absoluta al archivo WAR o al directorio que está implementando.

   contextRoot

   Es la ruta de contexto.

   Nota: Opcionalmente, pueden contener información adicional, como explica la documentación de Tomcat.

   Puede crear o editar los archivos en un editor de texto, como Notepad (Programas, Accesorios, Notepad).

3. Si el archivo ibi_apps.xml no existe, créelo. Por ejemplo:

   <?xml version='1.0' encoding='utf-8'?>
   <Context docBase="c:\ibi\WebFOCUS77\webapps\webfocus" path="/ibi_apps">
   </Context>

   Asegúrese de especificar el directorio correcto en su equipo, y cambie la ruta de contexto, si no está usando la predeterminada (ibi_apps).

4. Si está usando una instalación Tomcat independiente, cree un archivo approot.xml (si no existe). Por ejemplo:

   <?xml version='1.0' encoding='utf-8'?>
   <Context docBase="C:\ibi\apps" path="/approot">
   </Context>

   Asegúrese de especificar el directorio correcto en su equipo.

5. Si está usando una instalación Tomcat independiente, cree un archivo ibi_html.xml (si no existe). Por ejemplo:

   <?xml version='1.0' encoding='utf-8'?>
   <Context docBase="c:\ibi\WebFOCUS77\ibi_html" path="/ibi_html">
   </Context>

   Asegúrese de especificar el directorio correcto en su equipo.

6. Reinicie Tomcat desde la ventana Servicios.

x

Esto no debe tenerse en cuenta si acaba de instalar WebFOCUS por primera vez, aunque sí debe estar al corriente de ello cuando instale un paquete de servicios o una edición nueva. Al actualizar WebFOCUS o instalar un paquete de servicios, Tomcat debe usar las nuevas aplicaciones Web, en vez de las copias de la edición anterior guardadas en la caché.

• Si instala un paquete de servicios en el mismo lugar y ha implementado los directorios ampliados, las nuevas aplicaciones Web deberían utilizarse automáticamente, aunque debe eliminar los siguientes directorios, y después reiniciar Tomcat:

  C:\ibi\tomcat\work\Catalina\localhost\ibi_apps

  C:\ibi\tomcat\work\Catalina\localhost\ibi_html (si se había implementado anteriormente)

  C:\ibi\tomcat\work\Catalina\localhost\ibi_help

  C:\ibi\tomcat\work\Catalina\localhost\approot (si se había implementado anteriormente)

  Nota: El archivo redirect.war está disponible para redirigir aplicaciones personalizadas, con URLs que contienen rcaster como raíz de contexto de ReportCaster. Si piensa implementar este archivo, también debe eliminar el siguiente archivo de trabajo, y después reiniciar Tomcat.

  \tomcat_home\work\Catalina\localhost\rcaster

• Si está realizando la instalación en un lugar diferente o ha implementado archivos WAR, elimine completamente los contextos existentes de WebFOCUS, y vuelva a crearlos. Para eliminar los contextos, puede usar la Herramienta administrativa de Tomcat o eliminar los archivos y directorios correspondientes de la ruta de contexto. Por ejemplo:

  C:\ibi\tomcat\conf\Catalina\localhost\ibi_apps.xml

  C:\ibi\tomcat\work\Catalina\localhost\ibi_apps

  C:\ibi\tomcat\work\Catalina\localhost\ibi_help

  C:\ibi\tomcat\webapps\ibi_apps

  Nota: Al implementar archivos WAR, Tomcat los amplía en su propia estructura de directorios y no siempre conoce su ubicación original.

x

Para su comodidad, puede acceder a la ventana Propiedades de Apache Tomcat seleccionando Programas, Information Builders, Tomcat, y a continuación, Utilidad de configuración de Tomcat. La imagen siguiente muestra Apache Tomcat 6 para la ventana Propiedades de WebFOCUS.

x

1. Si no se han iniciado, active lo siguiente:
   • Apache Tomcat
   • Servidor de informes de WebFOCUS
2. Para probar el contexto ibi_apps, vaya al siguiente URL desde un navegador Web:

   http://localhost:8080/ibi_apps/diagnostics/about.jsp

   Debería aparecer una página con información sobre la generación. Si no aparece, compruebe que ha creado el contexto WebFOCUS. Su recibe un error de compilación JSP, consulte Cómo resolver problemas en WebFOCUS y ReportCaster.

3. Si está utilizando Tomcat con IIS, vaya a Cómo configurar Microsoft IIS 6.0. El resto del procedimiento está dedicado a la configuración independiente de Tomcat.

   La abreviación siguiente se usa para los URL, en todo el manual.

   http://hostname:port

   donde:

   hostname

   Es el nombre del host en que se ejecuta Tomcat.

   port

   Es el puerto HTTP; 8080 por defecto.

4. Introduzca el siguiente URL, sensible al uso de mayúsculas y minúsculas, para acceder a la página Bienvenido a WebFOCUS, que presenta vínculos a todas las características de WebFOCUS:

   http://hostname:port/ibi_apps/

   Puede marcar esta página y utilizarla más adelante. A esta página también se le denomina página principal de WebFOCUS.

5. En la página Bienvenido a WebFOCUS, pulse Ejecutar como procedimiento almacenado, o vaya a la página siguiente:

   http://hostname:port/ibi_html/

   Aparece una página que le permite ejecutar procedimientos.

6. Pulse Ejecutar, para probar el procedimiento.

   Si recibe un error como este

   Error attaching to Server: EDASERVE

   Confirme que el servidor de informes WebFOCUS está activado. Si el servidor de informes WebFOCUS se encuentra activado, asegúrese de que el Cliente WebFOCUS conoce el HOST y PORT del servidor, utilizando la Consola de administración de WebFOCUS y seleccionando Servidores de informes, o comprobando:

   drive:\ibi\WebFOCUS77\client\wfc\etc\odin.cfg

7. Si se le pide que inicie la sesión, introduzca un id. de usuario y una contraseña. Por defecto, este es un id. de usuario y una contraseña, que pueden conectarse al equipo que está ejecutando el servidor de informes WebFOCUS.

   Normalmente, los procedimientos se inician mediante el miniservidor WebFOCUS, y debería aparecer un informe. Puede utilizar un miniservidor para ejecutar un procedimiento de forma manual; por ejemplo, carinst.fex:

   http://hostname:port/ibi_apps/WFServlet?IBIF_ex=carinst

8. Si está utilizando una configuración independiente de Tomcat, vaya a Tareas de posinstalación de WebFOCUS.