Tareas de posinstalación de ReportCaster

Esta sección explica cómo crear el repositorio de ReportCaster y verificar ReportCaster. También contiene información sobre la configuración de ReportCaster. Si utiliza Two-Way Email, aquí encontrará una explicación de los pasos de activación.

Si no usa ReportCaster, vaya a Verificación y seguridad de Managed Reporting y Dashboard.

Para información sobre la configuración NLS, revise esta sección y consulte el manual Administración de ReportCaster.
Principio de página
x
Creación de tablas de repositorio de ReportCaster

En esta sección:

Cómo:

Esta sección explica cómo crear el repositorio de ReportCaster.

Para almacenar la información de envío, además de los informes y archivos distribuidos, ReportCaster debe tener acceso a un repositorio de base de datos. El repositorio de ReportCaster puede almacenarse en cualquier base de datos compatible con JDBC, para la que exista un controlador.

Aviso:

La estructura de la base de datos del repositorio de ReportCaster es distinta en ReportCaster 7.7; por tanto, debe crear un repositorio nuevo, incluso si está migrando desde WebFOCUS 7.1 o anteriores. Para más información acerca de cómo migrar datos de un repositorio existente de ReportCaster, consulte Cómo migrar ajustes y datos de ReportCaster. Si no existe ningún repositorio, use un repositorio DB2. Consulte Cómo configurar un repositorio DB2 para ReportCaster.

x
Procedimiento: Cómo Crear el repositorio de

Nota: Si repositorio requiere el soporte Unicode y necesita crear o volver a crear tablas nuevas de ReportCaster, seleccione la casilla Tipos de datos Unicode, bajo la sección Propiedades de repositorio de la herramienta Configuración de ReportCaster. Para más información, consulte el manual Administración de ReportCaster.

Para crear el repositorio:

  1. Asegúrese de que el servidor de base de datos esté ejecutándose.
  2. Entre a QSH, y vaya Vaya al siguiente directorio: 
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin
  3. Ejecute una de estas utilidades:

    • Para crear y enviar declaraciones SQL, ejecute:

      ./createUtil
      sh./createUtil

    • Para crear declaraciones SQL y escribirlas en un archivo que debe enviarse de forma manual, ejecute:

      ./createDB2
      sh./createDB2

    Aparece la siguiente solicitud:

    Do you want to create the ReportCaster Repository?
WARNING: Running this utility may overwrite any existing
         ReportCaster tables in the configured database.
         Are you sure you want to run this utility?
Please enter Y or N
  4. Introduzca Y. 
    Please choose an option by entering 1 or 2
Enter Q to Quit.
  1) Drop and Create Tables.
  2) Create Tables.
  Q) To Quit
  5. Introduzca 1 o 2, en función de que las tablas existan o no. 
    Please select a Table Group by entering 1 - 9
Enter Q to Quit.
  1) All Tables.
  2) Schedule Tables.
  3) Address Book Tables.
  4) ReportCaster Log Tables.
  5) Caster User Tables.
  6) TwoWay Tables (only if licensed for TwoWay for EMail).
  7) Library Tables (only if licensed for Report Library).
  8) Schedule Blackout Dates Table.
  9) Library Watch List Table.
 10) Custom Scheduling Interval Tables.
 11) Failover and Workload Control Table.
  Q) To Quit
  6. Introduzca 1.

    La utilidad usa la información de conexión e inicio de sesión, proporcionada durante la instalación del servidor de distribución, para crear las declaraciones SQL.

    • Si ha ejecutado createUtil, se envían las declaraciones.
    • Si ha ejecutado createDB2, las declaraciones quedan guardadas en el siguiente archivo, que debe enviarse de forma manual: 
      /install_directory/ibi/WebFOCUS77/ReportCaster/bin/rbcreate.sql

    Nota:

    • Si no puede conectarse, y su repositorio requiere controladores JDBC, asegúrese de que los controladores JDBC se encuentran instalados en el equipo del servidor de distribución. Además, debe comprobar que la ruta correcta del controlador, incluido el nombre del archivo, aparece en:
      /install_directory/ibi/WebFOCUS77/ReportCaster/bin/classpath

      Si hay espacios en las rutas o entre ellas, recibirá un error.

    • Si la utilidad no puede conectarse a la base de datos, compruebe que la ruta correcta del controlador JDBC aparece en:
      /install_directory/ibi/ReportCaster76/bin/classpath

      Normalmente, es:

      /QIBM/ProdData/HTTP/Public/jt400/lib/jt400.jar
    • Si puede conectarse a la base de datos, pero no puede crear tablas, asegúrese de que el id. introducido para la base de datos durante la instalación, tiene permisos de creación. Para cambiar este id. de usuario, consulte Configuración de ReportCaster.
x
Procedimiento: Cómo Crear las tablas de repositorio

Nota: Si repositorio requiere el soporte Unicode y necesita crear o volver a crear tablas nuevas de ReportCaster, seleccione la casilla Tipos de datos Unicode, bajo la sección Propiedades de repositorio de la herramienta Configuración de ReportCaster. Para más información, consulte el manual Administración de ReportCaster.

Para crear las tablas de repositorio:

  1. Entre a la Consola de administración de WebFOCUS y expanda la pestaña ReportCaster en el panel izquierdo.
  2. En el panel izquierdo, bajo la pestaña ReportCaster, pulse Repositorio, y después, Crear todas las tablas.

    Aparece un mensaje en el panel derecho. El pase indica que se han creado las tablas.

  3. Reinicie ReportCaster y el servidor de distribución como se explica a continuación:
    1. Bajo la pestaña ReportCaster, pulse Utilidades y Reiniciar ReportCaster.

      Se abre una ventana de confirmación.

    2. Pulse Aceptar.
  4. Compruebe el estado para verificar que ReportCaster se esté ejecutando en modo completo:

    En la pestaña ReportCaster, pulse Utilidades y Estado de ReportCaster.

    El estado aparece en el panel derecho y debe leerse: 

    The Distribution Server is running in Full Function mode.
x
Cómo verificar las tablas del repositorio de ReportCaster

Opcionalmente, verifique que las tablas siguientes han sido creadas para su repositorio.

Si está usando Two-Way Email y no aparecen las tablas BOTJOURN y BOTTELL, puede crearlas más adelante, como se describe en Activación de Two-Way Email.

Principio de página
x
Verificación de ReportCaster

En esta sección:

Una vez creado el repositorio, es aconsejable probar la configuración de ReportCaster.

Si tiene problemas con la verificación, consulte Cómo resolver problemas en WebFOCUS y ReportCaster Cómo resolver problemas en WebFOCUS y ReportCaster Cómo resolver problemas en WebFOCUS y ReportCaster.

x
Cómo probar, iniciar, y detener el servidor de distribución de ReportCaster

Asegúrese de que ha llevado a cabo los procedimientos de los capítulos anteriores, antes de iniciar el servidor de distribución.

Si está usando un repositorio DB2, asegúrese de que ha llevado a cabo los procedimientos mencionados en Cómo configurar un repositorio DB2 para ReportCaster.

Antes de iniciar o probar el servidor de distribución, debe iniciar los componentes con los que se comunica. Incluyen lo siguiente:

Si el servidor de distribución no puede entrar al repositorio de ReportCaster, se iniciará en modo Consola.

Nota: El servidor de distribución no se iniciará, si no puede conectarse al repositorio, o si su repositorio pertenece a una edición anterior. Debe tratarse de un repositorio válido de ReportCaster 7.7.

x
Procedimiento: Cómo Probar la configuración del servidor de distribución

Para probar la configuración del servidor de distribución, emplee el procedimiento siguiente:

  1. Vaya al siguiente directorio: 
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin
  2. Introduzca el siguiente comando y oprima Enter: 
    ./testcfg
    sh./testcfg

    Se realiza una prueba del formato de la información de configuración, de la conexión y de la estructura del repositorio. Si la configuración es correcta, recibirá este mensaje:

    ReportCaster Repository Release Validation:
ReportCaster Repository tables confirmed to be at the 77 release 
level.
test is successful
    ReportCaster Repository Release Validation:
ReportCaster Repository tables confirmed to be at the 7.7.02 release 
level.
test is successful

    Si recibe un error, compruebe que el servidor de bases de datos de su repositorio está activado, y que CLASSPATH contiene el controlador JDBC en:

    /install_directory/ibi/WebFOCUS77/ReportCaster/bin/classpath

    Si recibe el error Fallo al probar la conexión a MR: Conexión rechazada, verifique que sus servidores Web y de aplicaciones están activados.

    Además, asegúrese de que está utilizando un repositorio 7.7 y que el id. de usuario y la contraseña son correctos. Si necesita corregir el id. de usuario o la contraseña para acceder al repositorio o a otra información sobre la conexión, consulte Configuración de ReportCaster.

    Si recibe errores, asegúrese de que se está utilizando la información correcta para el repositorio, y que el repositorio pertenece a la edición 7.7.. Para más información sobre cómo cambiar esto, consulte Configuración de ReportCaster.

x
Procedimiento: Cómo Probar los ajustes de conectividad del repositorio

Para verificar, cambiar, o probar los ajustes de conectividad del repositorio:

  1. Entre a la Consola de administración de WebFOCUS y expanda la pestaña ReportCaster en el panel izquierdo.
  2. Siga estos pasos para confirmar que los ajustes de configuración del repositorio son los correctos:
    1. Bajo la pestaña ReportCaster, pulse Repositorio, Conexión.

      El panel derecho muestra los parámetros de base de datos del repositorio.

    2. Revise los ajustes y realice los cambios necesarios.
    3. Pulse Guardar.
  3. Pruebe la conectividad del repositorio del modo siguiente:

    Bajo la pestaña ReportCaster, pulse Repositorio, Probar repositorio.

    Los resultados aparecen en el panel derecho. El pase indica que hay conectividad al repositorio.

  4. Reinicie ReportCaster y el servidor de distribución como se explica a continuación:
    1. Bajo la pestaña ReportCaster, pulse Utilidades, Reiniciar ReportCaster.

      Se abre una ventana de confirmación.

    2. Pulse Aceptar.
  5. Compruebe el estado, para verificar que ReportCaster se está ejecutando en el modo de funcionamiento completo:

    Bajo la pestaña ReportCaster, pulse Utilidades, Estado de ReportCaster.

    El estado aparece en el panel derecho y debe leerse:

    The Distribution Server is running in Full Function mode
x
Procedimiento: Cómo Iniciar el servidor de distribución Desde la consola OMVS

Para iniciar el servidor de distribución, emplee el procedimiento siguiente:

Existen dos formas de iniciar el servidor de distribución. Una es utilizar la consola OMVS. Otra, iniciar el servidor como un trabajo por lotes. Para iniciar el servidor de distribución mediante la consola OMVS, siga estos pasos:

  1. Desde QSH, vaya Vaya al siguiente directorio: 
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin
  2. Introduzca el siguiente comando y oprima Enter: 
    ./schbkr &
    sh./schbkr &

    Cuando se inicie el servidor de distribución, recibirá una salida parecida a esta, dependiendo de los componentes que haya instalado:

    Console is listening on port: 8200
Reader ready
Dispatcher ready  
Console ready

    Cuando aparezca la línea Consola preparada, el servidor de distribución se encuentra activado.

    Nota: El servidor de distribución se iniciará en modo Consola, si no puede conectarse al repositorio, o si su repositorio pertenece a una edición anterior. Debe tratarse de un repositorio válido de ReportCaster 7.7.

  3. Vaya a Cómo Confirmar que el servidor de distribución está activado.
x
Procedimiento: Cómo Iniciar el servidor de distribución de ReportCaster como un trabajo por lotes

Para iniciar el servidor de distribución como un trabajo por lotes, edite el ejemplo JCL siguiente.

  1. Añada una tarjeta de trabajo a su sitio.
  2. Asegúrese de codificar una tarjeta REGION en el JCL. Este número varía en función de su entorno. Se requiere un mínimo de 524M. IBI recomienda 1047M.
  3. Proporcione las rutas correctas en su sistema, en lugar de /install_directory/. 
    //JOB CARD, REGION=1047M
//*-----------------------------------------------------------------*
//* JCL to start up the Distribution Server  *
//*-----------------------------------------------------------------*
//*
//DSERVER  EXEC PGM=BPXBATCH,
// PARM='SH /install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr'
//STDOUT DD PATHOPTS=(OCREAT,OTRUNC,OWRONLY),PATHMODE=SIRWXU,
// PATH='/install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr.out'
//STDERR DD PATHOPTS=(OCREAT,OTRUNC,OWRONLY),PATHMODE=SIRWXU,
// PATH='/install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr.err'
//STDENV DD  *
_BPX_BATCH_SPAWN=YES
_BPX_SHAREAS=REUSE
/*
//
x
Procedimiento: Cómo Confirmar que el servidor de distribución está activado

Cuando el servidor de distribución se inicia de forma correcta, aparecen mensajes como estos: 

z/OS IBIF 21.00 03 2098 hostname Repository Monitor ready
Console ready
Console is listening on port: 8200
Reader ready
Dispatcher ready
Repository Monitor finished

La primera línea presenta la información del sistema, mientras que la segunda muestra el puerto utilizado por el servidor de distribución.

  • Si inicia el servidor de distribución a través de OMVS, aparecen mensajes en la pantalla. Puede que tarden unos minutos en aparecer.
  • Si inicia el servidor de distribución a través de JCL, aparecen mensajes en: 
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr.out

Si tiene problemas para iniciar el servidor de distribución, puede que necesite actualizar el .profile del id. de usuario que lo está iniciando. Puede que también tenga que cambiar los parámetros de conexión a su repositorio. Para más información, consulte Configuración de ReportCaster.

Nota: El servidor de distribución no se iniciará, si no puede conectarse al repositorio, o si su repositorio pertenece a una edición anterior. Debe tratarse de un repositorio válido de ReportCaster 7.7.

x
Procedimiento: Cómo Detener el servidor de distribución Desde la consola OMVS

Para detener el servidor de distribución, haga lo siguiente:

Existen dos formas de detener el servidor de distribución. Una es la de utilizar la consola OMVS. La otra, deteniendo el servidor como un trabajo por lotes. Para detener el servidor de distribución mediante la consola OMVS, haga lo siguiente:

  1. Desde QSH, vaya Vaya al siguiente directorio: 
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin
  2. Introduzca el siguiente comando y oprima Enter: 
    ./stopit
    sh./stopit
  3. Espere unos minutos. Puede que el servidor de distribución tarde cierto tiempo en detenerse.
  4. Espere unos minutos. Puede que el servidor de distribución tarde cierto tiempo en detenerse. A continuación, emita lo siguiente para confirmar que se ha detenido el servidor de distribución. 
    netstat -a | grep 8200

    donde:

    8200

    Es el puerto del servidor de distribución.

    Si recibe una respuesta que dice LISTEN:

    tcp        0      0 *:8200        *:*              LISTEN

    El servidor de distribución aún no se ha detenido. Espere unos minutos e inténtelo de nuevo. Si sigue sin detenerse, finalice el proceso manualmente. Para ello, inicie la sesión como raíz y emita 

    netstat -nlp | grep 8200

    Después, finalice el proceso que aparece al final de la línea.
x
Procedimiento: Cómo Detener el servidor de distribución como un trabajo por lotes

Para detener el servidor de distribución como un trabajo por lotes, edite el ejemplo JCL siguiente:

  1. Añada una tarjeta de trabajo a su sitio.
  2. Proporcione las rutas correctas en su sistema, en lugar de /install_directory/. 
    //*
//*-----------------------------------------------------------------*
//* JCL to STOP the Distribution Server  *
//*-----------------------------------------------------------------*
//*
//DSERVER  EXEC PGM=BPXBATCH,
// PARM='SH /install_directory/ibi/WebFOCUS77/ReportCaster/bin/stopit'
//STDOUT DD PATHOPTS=(OCREAT,OTRUNC,OWRONLY),PATHMODE=SIRWXU,
// PATH='/install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr.out'
//STDERR DD PATHOPTS=(OCREAT,OTRUNC,OWRONLY),PATHMODE=SIRWXU,
// PATH='/install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr.err'
//STDENV DD  *
_BPX_BATCH_SPAWN=YES
_BPX_SHAREAS=REUSE
x
Procedimiento: Cómo Iniciar el servidor de distribución para producción

Al ejecutar el servidor de distribución en modo producción, debe iniciarlo con el comando nohup. Esto garantiza que el servidor de distribución seguirá ejecutándose, aunque cierre las sesiones telnet o SSH. Para ello:

  1. Vaya al siguiente directorio: 
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin
  2. Introduzca el siguiente comando y oprima Enter: 
    nohup ./schbkr &

    La salida queda escrita en un archivo nohup.out.
x
Procedimiento: Cómo Ejecutar el servidor de distribución en un lote

Para enviar el trabajo de activación del servidor de distribución a un lote, introduzca:

SBMJOB CMD(QSH CMD('sh /install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr')
) JOB(SBMDS) JOBQ(QBATCH)

Nota: Primero, ejecute el servidor de distribución en modo interactivo. Si el servidor se activa sin problemas, deténgalo y, a continuación, ejecútelo en un lote.
x
Referencia: Cómo detener el servidor de distribución en un lote

Para enviar el trabajo de desactivación del servidor de distribución a un lote, introduzca:

SBMJOB CMD(QSH CMD('sh /install_directory/ibi/WebFOCUS77/ReportCaster/bin/stopit')
) JOB(SBMDS) JOBQ(QBATCH)
x
Cómo verificar ReportCaster

Tras iniciar el servidor de distribución, pruebe la configuración de ReportCaster por medio de sus interfaces.

x
Procedimiento: Cómo Verificar ReportCaster
  1. Inicie el servidor de distribución de ReportCaster y todos sus componentes, si aún no lo ha hecho.
  2. Pulse Administración de ReportCaster en la página de bienvenida de WebFOCUS.

    Se abre la página de inicio de sesión de ReportCaster en su navegador.

    Si la página no aparece, asegúrese de que su navegador Web y los servidores de aplicaciones estén ejecutándose. Compruebe que la aplicación Web de ReportCaster ha quedado implementada en su servidor de aplicaciones. Si es necesario, asegúrese de que su servidor Web es capaz de enrutar solicitudes al servidor de aplicaciones.

    Si recibe los errores siguientes:

    • Unable to communicate with the Distribution Server to obtain
configuration information. Please confirm that the Distribution Server
is started and that the values of the Distribution Server server
host and port are correct.

      Asegúrese de que el servidor se encuentre iniciado, y que el CLASSPATH de su servidor de aplicaciones incluya el controlador JDBC de su repositorio. En Tomcat, puede establecer CLASSPATH mediante la ventana Configuración de Tomcat, como se indica en Cómo Establecer CLASSPATH para el repositorio deReportCaster.

      Los archivos del controlador JDBC, con sus respectivos nombres, deben estar incluidos en el CLASSPATH. No es suficiente con indicar el directorio que contiene los archivos del controlador. Si cambia la variable CLASSPATH, tendrá que reiniciar el servidor de aplicaciones.

    • The Distribution Server is started in console mode. Additional
configuration may be required to connect to the ReportCaster
repository. Please check the scheduler.log file for details.

      Cuando el servidor de distribución se inicia en modo Consola, la causa más probable es un problema del repositorio de ReportCaster. Puede que el controlador JDBC no se encuentre en la ruta de clase del servidor de distribución. Puede que el id. de usuario o la contraseña sean incorrectos. Puede que las tablas no hayan sido creadas, o que no estén actualizadas a la edición 7.7. La clave fiable de inicio de sesión de Managed Reporting está en blanco. Para más detalles, consulte el archivo schedule.log. Este archivo está situado en el directorio ibi/WebFOCUS77/ReportCaster/log.Este archivo está situado en el directorio ibi\WebFOCUS77\ReportCaster\log.

    • ReportCaster cannot communicate with the ReportCaster Repository. 
Check that the Application Server is properly configured with the
correct JDBC driver.

      Ambos servidores, el de distribución y el de aplicaciones, necesitan comunicarse con el repositorio de ReportCaster. Compruebe que el servidor de aplicaciones está configurado para utilizar el controlador JDBC del repositorio de ReportCaster.

  3. Entre a ReportCaster

    Por defecto, admin es un nombre de usuario administrador, válido. La contraseña de admin no queda definida hasta que ud. la establezca, así que puede dejar en blanco este campo.

    Aparece la interfaz Administración de ReportCaster, como se muestra en la imagen siguiente. Si recibe errores, reinicie el servidor de distribución, inténtelo de nuevo, y consulte Sugerencias de resolución de problemas de Reportcaster Sugerencias de resolución de errores de ReportCaster Sugerencias de resolución de errores de ReportCaster.

    Esta interfaz le permite monitorizar y configurar ReportCaster, y acceder a sus utilidades.

  4. Pulse la pestaña Configuración, para entrar a la herramienta Configuración de servidor de ReportCaster.

    Se abre la interfaz Configuración de servidor de ReportCaster.

    Esta herramienta de configuración de servidor sirve para modificar la configuración de ReportCaster, editando el archivo de configuración de ReportCaster:

    drive:\ibi\WebFOCUS77\ReportCaster\cfg\dserver.xmls
    /install_directory/ibi/WebFOCUS77/ReportCaster/cfg/dserver.xmls

    Puede que los cambios efectuados no se apliquen hasta que reinicie los servidores de distribución y de aplicaciones.

    Cuando se abre la interfaz, comprueba que los componentes Web de ReportCaster pueden comunicarse con el servidor de distribución. Si recibe un error de conexión, consulte Sugerencias de resolución de problemas de ReportcasterSugerencias de resolución de errores de ReportCasterSugerencias de resolución de errores de ReportCaster.

  5. Seleccione la carpeta Propiedades de seguridad.
  6. Pulse el botón Administrador, situado a la derecha de la carpeta Propiedades de administrador.
  7. Pulse el botón Abrir carpeta, situado a la derecha del valor admin del campo Administrador.
  8. Introduzca y confirme una contraseña para el Id. de usuario admin, y pulse Aceptar. Normalmente, los ids. de usuario de ReportCaster se encuentran almacenados en el repositorio de ReportCaster. Sin embargo, por razones de seguridad, el usuario Administrador se controla desde esta interfaz y no está almacenado en el repositorio.

    Si emplea Managed Reporting, esta contraseña debe coincidir con la contraseña que utilice, o vaya a utilizar, para el administrador de Managed Reporting.

    Nota: Si su servidor Web requiere HTTPS y está usando la Librería de informes o Managed Reporting, actualice los URL, mediante la interfaz Configuración del servidor de ReportCaster. Para la librería de informes, seleccione la carpeta Librería de informes y modifique la propiedad URL predeterminado de librería para notificación por email, para usar HTTPS en vez de HTTP. Para Managed Reporting, seleccione la carpeta Managed Reporting y modifique la propiedad Nodo de repositorio, para usar HTTPS en vez HTTP.

  9. Pulse Guardar y Aceptar.

    Aparece un mensaje indicando que debe reiniciar ReportCaster, para que se efectúen los cambios.

  10. Pulse Aceptar.
  11. Pulse el botón Reiniciar de la barra de herramientas, para volver a iniciar ReportCaster.
  12. Opcionalmente, para asegurarse de que sus cambios han quedado aplicados, detenga y reinicie el servidor de distribución, en lugar de usar el botón Reiniciar. Además, reinicie el servidor de aplicaciones.
Principio de página
x
Configuración de ReportCaster

En esta sección:

El manual Administración de ReportCaster ofrece información detallada sobre la configuración de ReportCaster.

La mayoría de los parámetros de configuración se establece desde la herramienta Configuración de servidor de ReportCaster, a la que se puede acceder a través de la página de bienvenida, pulsando Administración de ReportCaster. Puede abrir la página de bienvenida de WebFOCUS desde el URL siguiente:

La mayoría de los parámetros de configuración se establecen desde la interfaz Configuración de servidor de ReportCaster, a la que se accede pulsando Administración de ReportCaster, después de iniciar la sesión en esta página:

http://hostname:port/ibi_apps/welcome.jsp

Si no puede entrar a la interfaz desde el servidor Web, o el servidor de distribución no se ha iniciado, acceda a la herramienta de configuración de la línea de comandos, desde el equipo del servidor de distribución, si tiene un entorno Windows X. Para iniciar la interfaz Configuración de servidor de ReportCaster en Windows X, ejecute lo siguiente:

/install_directory/ibi/WebFOCUS77/ReportCaster/bin/editit

Si no hay disponible un entorno Window X, puede usar las rutinas descritas más abajo.

Si no puede acceder a la interfaz Configuración de servidor de ReportCaster, puede editarla utilizando las rutinas descritas en Cómo cambiar los parámetros de configuración con rutinas.

Una vez en la interfaz Administración de ReportCaster, seleccione la pestaña Configuración, para acceder a los ajustes de configuración.

Si no puede entrar a la interfaz desde el servidor Web, o el servidor de distribución no se ha iniciado, puede editar la configuración desde el menú Inicio del equipo del servidor de distribución, seleccionando Programas, Information Builders, WebFOCUS 77, ReportCaster, Servidor de distribución, Configuración, y Editar.

Para más información sobre la herramienta de configuración de la línea de comandos, consulte Temas y tareas adicionales del repositorio de ReportCaster.

Para más información sobre la configuración de la línea de comandos, consulte Temas y tareas adicionales del repositorio de ReportCaster.

Para información sobre la configuración NLS, revise esta sección y consulte el manual Administración de ReportCaster.
x
Cómo configurar ReportCaster con el servidor de distribución en un equipo independiente

Si el servidor de distribución está instalado en un equipo independiente al Cliente WebFOCUS, debe configurar ReportCaster correctamente, para que pueda funcionar. Los pasos de esta sección se refieren a la instalación del Cliente WebFOCUS y ReportCaster, no a una instalación de ReportCaster independiente.

  1. Si su servidor Web o equilibrador de carga está configurado para SSL, debe modificar los ajustes del nodo de repositorio y del URL predeterminado de librería. Puede configurar ReportCaster para SSL y cambiar de HTTP a HTTPS en los ajustes de nodo de repositorio y URL predeterminado de librería, o bien apuntar ReportCaster al puerto listener HTTP, que no sea SSL, de su servidor de aplicaciones (si está disponible). Para más información sobre cómo configurar un host, consulte Cómo configurar un host interno, alternativo para ReportCaster Cómo configurar un host interno, alternativo para ReportCaster. Para editar el ajuste Nodo de repositorio, entre al panel Info MR de configuración del servidor de ReportCaster. Para editar el ajuste URL predeterminado de librería, entre al panel Librería de configuración del servidor de ReportCaster.
  2. Para usar la Autorización/Autenticación externa o fiable, debe configurar la clave fiable para Inicio de sesión MR. Inicie el servidor de aplicaciones y el de distribución. Cuando la clave fiable está en blanco, el servidor de distribución se inicia en modo Consola.
  3. Entre a la Consola de administración de WebFOCUS.
  4. Pulse ReportCaster.
  5. Pulse Configuración. Aparece la pantalla ReportCaster - Configuración, con un mensaje que señala que la clave fiable está en blanco, como se aprecia en la imagen siguiente.

  6. Pulse Guardar.
  7. Pulse Aceptar, para reiniciar ReportCaster.
x
Cómo configurar un host interno, alternativo para ReportCaster

El ajuste Nodo de repositorio de ReportCaster está configurado para apuntar al servidor Web especificado durante la instalación. Cuando este servidor Web está configurado con un producto de inicio de sesión único, como SiteMinder, Oblix, Tivoli, o ClearTrust, o con un certificado SSL autofirmado o incorrecto, los componentes de miniservidor y servidor de distribución de ReportCaster no podrán conectarse a este servidor Web.

Aunque ReportCaster es capaz de establecer conexiones https, normalmente se requiere más pasos de configuración. Los certificados autofirmados no son considerados como fiables por parte del JVM en que se ejecuta ReportCaster, y suelen dar lugar a errores de conexión. Los certificados caducados, o los que hayan sido generados para un sitio Web pero se estén usando en otro, también producen problemas de conexión.

Puede registrar el certificado con su JVM, para evitar estos problemas (consulte el manual Seguridad y administración de WebFOCUS). También puede volver a configurar el nodo de repositorio, para que apunte al listener HTTP (si está disponible) del servidor de aplicaciones. Esto puede llevarse a cabo en la mayoría de servidores de aplicaciones, incluidos Tomcat, WebSphere y WebLogic, como se muestra más abajo.

Nota: Si el servidor de distribución de ReportCaster está en la misma máquina que WebFOCUS, puede emplear localhost. De lo contrario, introduzca el nombre del host. Pregunte a su administrador acerca del número de puerto que debe especificar.

Esta configuración alternativa de host también puede utilizarse para evitar problemas de conexión entre ReportCaster y productos de inicio de sesión único (SSO). Aunque puede configurar algunos de estos productos SSO para que admitan la autenticación Web básica, permitida por ReportCaster mediante el ajuste Usuario HTTP, no es obligatorio que el servidor de distribución de ReportCaster y sus miniservidores de programaciones se conecten a través del producto SSO.
x
Cómo cambiar los parámetros de configuración con rutinas

Muchas de las rutinas le permiten cambiar los ajustes de configuración del servidor de distribución. El servidor de distribución no puede iniciarse a menos que sea capaz de conectarse al repositorio. Si no puede iniciar el servidor de distribución, use estas rutinas para corregir los ajustes de conexión. Las rutinas se encuentran instaladas en:

/install_directory/ibi/WebFOCUS77/ReportCaster/bin

Están disponibles las siguientes rutinas:

Rutina

Propósito

dbname

Cambia el parámetro Nombre de base de datos. Este parámetro solo es necesario cuando se está utilizando un repositorio DB2 en z/OS. Unified Server USS. Leído por la utilidad createDB2, para añadir el nombre de la base de datos al SQL de creación.

dbpass

Cambia la contraseña empleada para acceder al repositorio.

dbuser

Cambia el id. de usuario utilizado para acceder al repositorio.

repclass

Cambia la clase JDBC utilizada para acceder al controlador del repositorio. Consulte Temas y tareas adicionales del repositorio de ReportCaster, para más información sobre este valor.

repurl

Cambia el URL JDBC utilizado para acceder repositorio. Consulte Temas y tareas adicionales del repositorio de ReportCaster, para más información sobre este valor.

twowaymailserver

Cambia el nombre del servidor de correo utilizado con Two-Way Email.

Para ejecutar una rutina, ejecútela cuando reciba un aviso de consola, con el primer argumento como el valor que desea establecer.

Para ejecutar una rutina, ejecútela bajo OMVS, con el primer argumento como el valor que desea establecer.

Para ejecutar una rutina, ejecútela desde qsh, con el primer argumento como el valor que desea establecer.

Advertencia: Si uno de los valores contiene un punto y coma, debe colocarlo entre comillas.
Ejemplo: Cómo ejecutar rutinas de configuración

Si durante la instalación introduce un id. de usuario y una contraseña incorrectos para entrar al repositorio, cámbielos del modo siguiente.

  1. Desde qsh, vayaVaya al siguiente directorio:
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin
  2. Ejecute lo siguiente para cambiar el id. de usuario utilizado para entrar al repositorio:
    ./dbuser userID

    donde:

    userID

    Es el id. de usuario correcto, para entrar al repositorio. En DB2, debe tratarse del propietario de la base de datos.

  3. Ejecute lo siguiente para cambiar la contraseña utilizada para entrar al repositorio:
    ./dbpass password

    donde:

    password

    Es la contraseña correcta para entrar al repositorio. En DB2, debe tratarse del propietario de la base de datos.

Las otras rutinas (por ejemplo, repurl, repclass) se ejecutan del mismo modo. Si su URL o CLASS contiene un punto y coma, colóquelos entre comillas a la hora de ejecutar las rutinas.
x
Referencia: JDBC URL y CLASS para DB2 en IBM i

El JDBC CLASS para DB2 en IBM i debe ser:

com.ibm.as400.access.AS400JDBCDriver

El JDBC URL para DB2 en IBM i debe ser:

jdbc:as400://hostname/library

donde:

hostname

Es el nombre del host del equipo IBM i.

library

Es el nombre de la librería del repositorio de Reportcaster.
x
Cómo configurar la memoria disponible para el informe de registro de ReportCaster

El tamaño del informe de registro de ReportCaster está limitado por la cantidad de memoria disponible para Java Virtual Machine (JVM). Cuando se sobrepasa la memoria del JVM, aparece un mensaje Java OutOfMemoryException.

Para controlar el tamaño del informe de registro, puede establecer los siguientes parámetros de la herramienta Configuración de servidor de ReportCaster.
x
Cómo configurar el tamaño del montón para el servidor de distribución de ReportCaster

Si el servidor de distribución de ReportCaster experimenta un error de falta de memoria Java, aumente la cantidad de memoria (tamaño del montón) disponible para Java en el servidor de distribución. Esto se consigue pasando los parámetros de la línea de comandos Java:

java -Xms<initial heap size> -Xmx<maximum heap size>

Por ejemplo, 

java -Xms256m -Xmx512m

Además:

Para activar el cambio, debe reiniciar el servidor de distribución.
x
Cómo configurar el tamaño del montón para el servidor de distribución de ReportCaster

Si el servidor de distribución de ReportCaster experimenta un error de falta de memoria Java, aumente la cantidad de memoria (tamaño del montón) disponible para Java en el servidor de distribución. Esto se consigue pasando los parámetros de la línea de comandos Java en su rutina de inicio de ReportCaster, situada en:

/install-dir/ibi/WebFOCUS77/ReportCaster/bin/schbkr

Incluya el texto siguiente en la línea de comandos Java:

-DXms256m -DXmx512m
x
Cómo configurar la conmutación por error y distribución de carga de trabajo de ReportCaster

La característica Conmutación por error del servidor de distribución le permite configurar un servidor de distribución de copia de seguridad que reanude las operaciones de ReporCaster, en el caso de una interrupción (programada o no programada) en el servicio del servidor de distribución primario. Se monitoriza el servidor de distribución primario, para verificar que está operativo. Si ocurre una interrupción del servicio, se dispara el servidor de distribución de conmutación por error para que asuma el rol del servidor primario.

La característica Distribución de carga de trabajo permite que ReportCaster distribuya trabajos programados a distintos servidores de distribución, proporcionando un método rápido y efectivo para procesar un gran número de programaciones de ReportCaster. Puede instalar múltiples servidores de distribución en uno o varios hosts. Uno de ellos queda designado como Administrador de carga de trabajo, mientras que los demás se denominan Trabajadores. El Administrador de carga de trabajo y los Trabajadores compartirán el repositorio de ReportCaster. La distribución de carga de trabajo se establece a través de la herramienta Configuración de ReportCaster. Todos los servidores comparten un conjunto de información de configuración, mientras que el Administrador de carga de trabajo se ocupa de dirigir cualquier cambio a los Trabajadores.

En cuanto a su aplicación de ReportCaster, puede configurar la conmutación por error, la distribución de carga de trabajo, o ambas. El procedimiento siguiente incluye instrucciones para configurar ambas, pero indica cuándo debe saltarse los pasos correspondientes, en el caso de que solo vaya a configurar una de ellas.
x
Procedimiento: Cómo Configurar la conmutación por error y la distribución de carga de trabajo

Para configurar la conmutación por error, la distribución de carga de trabajo, o ambas:

  1. Instale WebFOCUS y ReportCaster.
  2. Configure todos los ajustes que no correspondan a la conmutación por error y la distribución de carga de trabajo, en ReportCaster. Estos incluyen los servidores de datos, la seguridad, opciones predeterminadas de programación, opciones de librería, formatos, tareas, métodos de distribución, etc.
  3. Inicie WebFOCUS y ReportCaster, y realice una prueba con la creación y ejecución de una programación.

    Si no está configurando la conmutación por error, vaya al paso 5.

  4. Para configurar la conmutación por error, actualice los ajustes siguientes de WebFOCUS y del servidor de distribución ReportCaster:
    1. En la Consola de administración de WebFOCUS, añada el nombre del equipo y el número de puerto de conmutación por error al panel Ajustes de aplicaciones. Para acceder a él, desde el panel izquierdo, amplíe la pestaña Configuración, después Ajustes de aplicaciones, y seleccione ReportCaster, como se muestra en la siguiente imagen.

      Añada el nombre del host de conmutación por error al final del nombre del host primario, en el campo agent_node, mediante un punto y coma para separar los nombres; por ejemplo:

      hostname1:hostname2

      Añada el número de puerto de conmutación por error al final del número de puerto primario, en el campo agent_port, mediante un punto y coma para separarlos; por ejemplo:

      8200:8201
    2. Pulse Guardar.
    3. En la carpeta Servidores de distribución de la herramienta Configuración de ReportCaster, pulse el botón situado a la derecha de la propiedad Servidor de distribución de conmutación por error. Aparece el cuadro de diálogo Servidor de distribución de conmutación por error, como se indica a continuación.

    4. Seleccione la casilla Activado.
    5. Introduzca el nombre de host del servidor de distribución de conmutación por error, en el campo Host.

      Los nombres de host distinguen las mayúsculas de las minúsculas y deben coincidir exactamente en cualquier lugar de la instalación en que aparezcan citados.

    6. Introduzca o establezca el número de puerto del servidor de distribución de conmutación por error, en el campo Puerto.
    7. Opcionalmente, cambie el valor del campo Intervalo de conmutación por error a la frecuencia (en minutos) con que el servidor de distribución de conmutación por error comprueba que el servidor de distribución primario se está ejecutando. El valor predeterminado es de un minuto.
    8. Pulse Aceptar.

    Si está configurando la distribución de carga de trabajo, permanezca en la herramienta Configuración de ReportCaster, y vaya al próximo paso.

    Si no está configurando la distribución de carga de trabajo, vaya al paso 6.

  5. Configure la distribución de carga de trabajo:
    1. En la carpeta Servidores de distribución de la herramienta Configuración de ReportCaster, pulse el botón situado a la derecha de la propiedad Distribución de carga de trabajo. Aparece el cuadro de diálogo Distribución de carga de trabajo, como se muestra a continuación.

    2. Seleccione la casilla Activado.
    3. Pulse Añadir. Se abre el cuadro de diálogo Distribución de carga de trabajo, como se muestra a continuación.

    4. En el campo Nombre de trabajador, introduzca un nombre descriptivo para el servidor de distribución de trabajadores.
    5. En el campo Host de servidor de distribución de trabajadores, introduzca el nombre del host.
    6. En el campo Puerto de servidor de distribución de trabajadores, introduzca el número del puerto.
    7. Continúe añadiendo los trabajadores necesarios para su configuración de distribución de carga de trabajo, pulsando Añadir y repitiendo los pasos anteriores.

      La imagen siguiente muestra dos servidores de trabajador, con un host y un puerto asignados a cada trabajador.

    Si no está configurando la conmutación por error, vaya al paso 8.
  6. Instale el servidor de distribución de conmutación por error.

    Nota: Para instalar solo el servidor de distribución, durante la instalación de WebFOCUS, retire la marca de WebFOCUS y seleccione Servidor de distribución de ReportCaster, desde la ventana Seleccionar componentes para instalar.

  7. Copie el archivo de configuración de ReportCaster (dserver.xmls) del servidor de distribución primario (situado en el directorio ibi/WebFOCUS77/ReportCaster/cfg), en el directorio correspondiente del equipo de conmutación por error.

    Si no está configurando la distribución de carga de trabajo, vaya al paso 13.

  8. Instale el primer servidor de distribución del trabajador.

    Nota: Para instalar solo el servidor de distribución, durante la instalación de WebFOCUS, retire la marca de WebFOCUS y seleccione Servidor de distribución de ReportCaster, desde la ventana Seleccionar componentes para instalar.

  9. Copie el archivo de configuración de ReportCaster (dserver.xmls) del servidor de distribución primario (situado en el directorio ibi/WebFOCUS77/ReportCaster/cfg), en el directorio correspondiente del primer servidor de distribución del trabajador.
  10. Instale el próximo servidor de distribución del trabajador.
  11. Copie el archivo de configuración de ReportCaster (dserver.xmls) del servidor de distribución primario (situado en el directorio ibi/WebFOCUS77/ReportCaster/cfg), en el directorio correspondiente del próximo servidor de distribución del trabajador.
  12. Repita los pasos 10 y 11 por cada servidor de distribución del trabajador, que esté utilizando en su configuración de distribución de carga de trabajo.
  13. Reinicie la aplicación WebFOCUS en el servidor de aplicaciones.
  14. Reinicie el servidor de distribución primario.
  15. Si ha configurado la conmutación por error, inicie el servidor de conmutación por error.
  16. Si ha configurado la distribución de carga de trabajo, inicie el primer servidor de distribución del trabajador, y después haga lo mismo con los servidores posteriores del trabajador.
x
Cómo cambiar la plantilla predeterminada de la Herramienta de programación

El archivo SchedulePreferences.xml contiene la información sobre las plantillas personalizada y estándar, además de la relacionada al botón Programar disponible en Developer Studio.

  1. Localice el archivo SchedulePreferences.xml file en el directorio \ibi\WebFOCUS77\config\caster. En UNIX, el directorio es /ibi/ WebFOCUS77/Config/caster.
  2. Localice el archivo SchedulePreferences.xml file en la carpeta /ibi/ WebFOCUS77/Config/caster.
  3. Haga una copia de seguridad del archivo antes de empezar.
  4. Abra el archivo SchedulePreferences.xml en un editor de texto. La plantilla Personalizada consiste en la información perteneciente al elemento SchedulePreference, que contiene la etiqueta <id>Custom<id>. Al cambiar las opciones de programación asociadas a la plantilla Personalizada, modifique únicamente la información relativa a este elemento. Este es el elemento SchedulePreference de la plantilla Personalizada:
    <SchedulePreference __cn="ibi.broker.api.data.preference.schedule.SchedulePreference">
   <id>Custom</id> 
   <name></name>
   <description></description>
.
.
.
</SchedulePreference>

    Importante: No modifique la información del elemento SchedulePreference que contiene la etiqueta <id>Standard<id>

    <SchedulePreference __cn="ibi.broker.api.data.preference.schedule.SchedulePreference">
   <id>Standard</id> 
.
.
.
</SchedulePreference>

    La plantilla Personalizada lista todos los métodos de distribución, formatos de salida de informes, tipos de tareas, intervalos de programación, opciones de notificación y demás propiedades de una programación. Eliminando una entrada de la plantilla personalizada, el administrador puede limitar las opciones de programación disponibles al usuario de la herramienta de programación.

    Tenga en cuenta que algunas opciones pueden estar ya limitadas por los ajustes globales de la herramienta de configuración de ReportCaster. Por tanto, incluso si la entrada no queda eliminada de la plantilla personalizada, puede que la opción controlada por dicha entrada no esté disponible en la herramienta de programación.

  5. Cuando haya terminado de editar el archivo SchedulePreference.xml, guarde sus cambios y reinicie el servidor de aplicaciones. Cuando se aplica la plantilla personalizada a la herramienta de programación, las opciones disponibles reflejan los cambios efectuados en la plantilla.

    Nota:

    • La plantilla personalizada no se aplica por defecto.
    • Para más información acerca de cómo activar la plantilla Personalizada en el Dashboard, consulte el Manual del administrador de WebFOCUS Managed Reporting.
    • También puede aplicar la plantilla personalizada cuando está usando la herramienta de programación fuera del Dashboard. Para más información, consulte el manual Seguridad y administración de WebFOCUS.

Consulte los ejemplos siguientes para ver las distintas formas en que se puede modificar la plantilla personalizada.

Ejemplo: Cómo limitar los formatos disponibles

En este ejemplo, los únicos que aparecerán como formatos disponibles de salida de informes, en la herramienta de programación, son EXL07, EXL2K, HTML, and PDF. Los otros formatos (<formatItem>) han sido borrados de la plantilla personalizada.

<taskPreference __cn="ibi.broker.api.data.preference.schedule.TaskPreference">
   <show>true</show>
   <collapsed>false</collapsed>
   <formatItem>EXL07</formatItem>
   <formatItem>EXL2K</formatItem>
   <formatItem>HTML</formatItem>
   <formatItem>PDF</formatItem>
   <taskType>TaskWFServerProcedure</taskType>.
.
.
<taskType>TaskWFServerProcedure</taskType>
Ejemplo: Cómo limitar los métodos de distribución disponibles

En este ejemplo, los únicos que aparecerán como métodos de distribución disponibles en la herramienta de programación, son Email y Librería. Los otros métodos (<methodItem>) han sido borrados de la plantilla personalizada.

</destinationPreference>
<methodItem>EMAIL</methodItem>
<methodItem>LIBRARY</methodItem>
<storageLibraryPreference __cn="ibi.broker.api.data.preference.schedule.StorageLibraryPreference">
Ejemplo: Cómo limitar las tareas disponibles

En este ejemplo, los únicos que aparecerán como tareas disponibles en la herramienta de programación, son los Informes estándar y Mis informes. Los otras tareas (<taskType>) han sido borradas de la plantilla personalizada.

<formatItem>SVG</formatItem>
<taskType>TaskStandardReport</taskType>
<taskType>TaskMyReport</taskType>
<alertType>AUTO</alertType>
Ejemplo: Cómo limitar los intervalos de programación disponibles

En este ejemplo, los únicos que aparecerán como intervalos disponibles en la herramienta de programación, son los periodos Diario, Semanal, Mensual y Personalizado. Los otros intervalos (<timeInfoTypeItem>) han sido borrados de la plantilla personalizada.

<timeInfoPreference __cn="ibi.broker.api.data.preference.schedule.TimeInfoPreference">
   <show>true</show>
   <collapsed>false</collapsed>
   <timeInfoTypeItem>DAY</timeInfoTypeItem>
   <timeInfoTypeItem>WEEK</timeInfoTypeItem>
   <timeInfoTypeItem>MONTH</timeInfoTypeItem>
   <timeInfoTypeItem>CUSTOM</timeInfoTypeItem>
   <secondaryRunInterval>true</secondaryRunInterval>
</timeInfoPreference>
x
Cómo configurar la distribución FTP

Si está usando informes preparados, los servidores Web y de aplicaciones requieren acceso de escritura al directorio a los que se distribuye informes FTP. Por defecto, esto es: 

/install_directory/ibi/WebFOCUS77/ibi_html/prepared

El directorio está determinado por el parámetro BKR_REPORT_DIR del siguiente archivo:

/install_directory/ibi/WebFOCUS77/client/wfc/etc/cgivars.wfs
x
Cómo configurar ReportCaster para gráficos

Para que ReportCaster pueda distribuir gráficos, debe establecer DISPLAY o utilizar la opción headless (sin soporte gráfico). Esto es similar a la configuración Gráficos de lado del servidor, tratada en Cómo verificar y resolver errores en gráficos de lado del servidor (PCHOLD) Cómo verificar y resolver errores en gráficos de lado del servidor (PCHOLD).

Si desea usar los gráficos, debe actualizar el archivo schbkr para incluir la opción headless de Java. Esto es similar a la configuración Gráficos de lado del servidor, tratada en Cómo activar los gráficos de lado del servidor.
x
Procedimiento: Cómo Configurar ReportCaster para gráficos

El procedimiento de distribución de gráficos depende de la presencia de un X Windows Server.

Para distribuir gráficos, siga uno de estos métodos:

  • Si tiene un X Windows Server, puede establecer la variable DISPLAY en el nombre del host de X Server. Asegúrese de que X Server acepte la conexión. Para ello, edite el siguiente archivo:
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr

    Añada una línea para exportar la variable DISPLAY. Por ejemplo: 

    #!/bin/ksh   
 export DISPLAY=localhost:0  
CLASSPATH=/usr/local/drivers/ojdbc15.jar:
  /home/wf77/ibi/WebFOCUS77/ReportCaster/lib/SCHScheduler.jar
export CLASSPATH
java ibi.broker.SCHScheduler /home/wf77/ibi/WebFOCUS77/ReportCaster

  • Si no cuenta con un servidor X, puede establecer la opción headless (sin soporte gráfico) de Java, cuando se inicie el servidor de distribución. Sin embargo, no se admite los gráficos GIF ni el motor GRAPH32 anterior. Para ello, edite el siguiente archivo:

    /install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr

    Coloque la opción headless después del comando java. Por ejemplo: 

    java -Djava.awt.headless=true ibi.broker.SCHScheduler 
/home/wf77/ibi/WebFOCUS77/ReportCaster
x
Procedimiento: Cómo Configurar ReportCaster para gráficos

El procedimiento de distribución de gráficos depende de la presencia de un X Windows Server.

Para distribuir gráficos, siga uno de estos métodos:

  • Si tiene un X Windows Server, puede establecer la variable DISPLAY en el nombre del host de X Server.
    1. Asegúrese de que X Server acepte la conexión. Para ello, edite el siguiente archivo:
      /install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr

      Añada una línea para exportar la variable DISPLAY. Por ejemplo: 

      #!/bin/ksh   
 export DISPLAY=localhost:0  
CLASSPATH=/usr/local/drivers/ojdbc15.jar:
  /home/wf77/ibi/WebFOCUS77/ReportCaster/lib/SCHScheduler.jar
export CLASSPATH
java ibi.broker.SCHScheduler /home/wf77/ibi/WebFOCUS77/ReportCaster
    2. Si su base de datos es de tipo DB2, añada el controlador JDBC a /installation_directory/ibi/WebFOCUS77/ReportCaster/bin/classpath:
      /QIBM/ProdData/HTTP/Public/jt400/lib/jt400.jar

      Por ejemplo: 

      CLASSPATH=.:/QIBM/ProdData/HTTP/Public/jt400/lib/jt400.jar:/ install_directory/ibi/WebFOC6US77/ReportCaster/lib/reportcaster.jar:
  • Si no cuenta con un servidor X, puede establecer la opción headless (sin soporte gráfico) de Java, cuando se inicie el servidor de distribución. Sin embargo, no se admite los gráficos GIF ni el motor GRAPH32 anterior. Para ello, edite el siguiente archivo:
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr

    Coloque la opción headless después del comando java. Por ejemplo: 

    java -Djava.awt.headless=true ibi.broker.SCHScheduler 
/home/wf77/ibi/WebFOCUS77/ReportCaster
x
Procedimiento: Cómo Configurar ReportCaster para gráficos

Abra el archivo schbkr situado en: 

/install_directory/ibi/WebFOCUS77/ReportCaster/bin/schbkr

Añada la declaración de la opción headless de Java, como se muestra en el ejemplo siguiente: 

#!/bin/ksh -Djava.awt.headless=true/install_directory/ibi/WebFOCUS77/ReportCaster/bin/classpath
java ibi.broker.SCHScheduler $DSINSTALL

donde:

$DSINSTALL
Es la ruta completa a la instalación de ReportCaster.
Principio de página
x
Cómo redirigir las aplicaciones Web con la raíz de contexto RCASTER

En WebFOCUS Edición 7.7, las aplicaciones web de WebFOCUS y ReportCaster han quedado combinadas en una sola aplicación. En ediciones anteriores, ambas aplicaciones se implementaban por separado, con raíces de contexto únicas cuyos valores eran ibi_apps y rcaster. En WebFOCUS 7.7, solo hay una ruta de contexto para WebFOCUS y ReportCaster, con un valor predeterminado ibi_apps.

Sin embargo, los usuarios que tengan aplicaciones Web con referencias codificadas a rcaster, en el URL o en una ruta de contexto específica de ReportCaster, se verán afectados. Para resolver esta situación, implemente el archivos redirect.war para redirigir los URL que hacen referencia a rcaster, o a una ruta de contexto específica, a la ruta de contexto única.

Nota: Los procedimientos que invocan la subrutina DSTRUN también requieren la implementación del archivo redirect.war, o tendrá que modificarlos para que apunten a /ibi_apps.
Principio de página
x
Cómo sincronizar usuarios de Managed Reporting

Cómo:

Nota: Information Builders recomienda que sincronice los usuarios de Managed Reporting, antes de aplicar la seguridad externa. Si ya se ha aplicado la seguridad externa, desactívela temporalmente, sincronice los usuarios de Managed Reporting, y vuelva a activar la seguridad.

La sincronización de usuarios de Managed Reporting es un paso obligatorio cuando se está migrando desde ReportCaster 4, o se está migrando el repositorio de Managed Reporting, pero no el de ReportCaster.

Si no usa Managed Reporting, vaya a Activación de Two-Way Email.

Si no usa Managed Reporting, vaya a Cómo migrar ajustes y datos de ReportCaster.

ReportCaster y Managed Reporting usan los mismos ids. de usuario, aunque se almacenan por separado en un repositorio de Managed Reporting y en otro de ReportCaster. Normalmente, cuando crea o edita un id. de usuario en Managed Reporting, se sincroniza automáticamente con el repositorio de ReportCaster. Sin embargo, cuando crea un nuevo repositorio vacío de ReportCaster, no contiene ningún id. de usuario. Si el repositorio de Managed Reporting contiene ids. de usuario, pero no el de ReportCaster, debe ejecutar una utilidad que coloque los ids. de usuario de Managed Reporting en el repositorio de ReportCaster.

Normalmente, la sincronización no tiene mucha relevancia cuando se instala por primera vez o al usar o migrar un repositorio existente de ReportCaster 5.2.3, o superior. Sin embargo, si tiene repositorios nuevos, asegúrese de establecer una dirección de email y una contraseña para el administrador de Managed Reporting, como se explica en Verificación y seguridad de Managed Reporting y Dashboard.

Sugerencia: Si no usa Managed Reporting, puede crear usuarios en ReportCaster o realizar una carga masiva de los usuarios existentes en el repositorio de ReportCaster. Para realizar una carga masiva de los usuarios que no pertenezcan a Managed Reporting, consulte el manual Administración de ReportCaster, para obtener información sobre la utilidad Sincronizar usuarios externos (addextusers).

Si no necesita sincronizar los ids. de usuario, vaya a Activación de Two-Way Email.

Nota: Al cambiar el logaritmo de cifrado de usuarios del antiguo valor predeterminado de WebFOCUS a DES o Triple DES, primero debe migrar los usuarios de Managed Reporting del logaritmo de cifrado anterior al nuevo. Para más información, consulte el capítulo Características de cifrado WebFOCUS, en el manual Administración y seguridad de WebFOCUS. A continuación, cambie los ajustes de cifrado a DES o Triple DES, desde la interfaz Configuración de servidor de ReportCaster. Para más información, consulte Proveedores de cifrado opcional para ReportCaster en Seguridad de ReportCaster, en el manual Administración de ReportCaster. Si cuenta con un número elevado de usuarios, el proceso de modificación de los métodos de cifrado puede resultar complicado.

Si no necesita sincronizar los ids. de usuario, vaya a Cómo migrar ajustes y datos de ReportCaster. En el caso de que esté migrando Managed Reporting, pero al mismo tiempo esté usando un repositorio nuevo de ReportCaster, debería sincronizar los repositorios.

Nota: Information Builders recomienda que sincronice los usuarios de Managed Reporting, antes de aplicar la seguridad externa. Si ya se ha aplicado la seguridad externa, desactívela temporalmente, sincronice los usuarios de Managed Reporting, y vuelva a activar la seguridad.

x
Procedimiento: Cómo Ejecutar la utilidad de sincronización de usuarios de Managed Reporting

Si va a migrar datos de Managed Reporting, hágalo antes de este procedimiento. Para más información sobre migraciones de Managed Reporting, consulte Migración de Managed Reporting y Dashboard.

  1. Si el servidor de distribución y el Cliente WebFOCUS no están en el mismo equipo, copie los siguientes archivos del equipo del equipo del Cliente WebFOCUS a un directorio del equipo del servidor de distribución: 
    /install_directory/ibi/WebFOCUS77/basedir/user.htm
    /install_directory/ibi/WebFOCUS77/basedir/role.htm
  2. Compruebe que el servidor de su base de datos de repositorio se está ejecutando, antes de intentar cargar datos en la misma.
  3. Si el servidor de distribución no se está ejecutando, inícielo. El servidor de distribución debe estar activado para ejecutar esta utilidad. Para ver una explicación, consulte Cómo Iniciar el servidor de distribución Desde la consola OMVS .
  4. Abra el siguiente archivo en el editor de texto: 
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin/rcusersync

    El archivo debería ser similar a este:

    . ./classpath
java ibi.broker.DSTMRESynchronize 
/install_directory/ibi/WebFOCUS77/basedir/user.htm 
/install_directory/ibi/WebFOCUS77/basedir/role.htm
   admin "" $DSHOST:$DSPORT
    java ibi.broker.DSTMRESynchronize 
{MRBASEDIR}/user.htm 
{MRBASEDIR}/role.htm
   admin "" $DSHOST:$DSPORT

    donde:

    install_directory

    Es la ruta absoluta al repositorio (directorio basedir) de Managed Reporting que contiene los archivos user.htm y role.htm. Si el Cliente WebFOCUS y el servidor de distribución están en equipos diferentes, aparece {MRBASEDIR}, que debe editarse para especificar la ruta absoluta.

    $DSHOST

    Es el nombre del host en que se encuentra instalado el servidor de distribución.

    $DSPORT

    Es el puerto del servidor de distribución. Está predeterminado, aunque si cambia los ajustes después de la instalación, también debe cambiarlos aquí.

  5. Si el Cliente WebFOCUS y el servidor de distribución de ReportCaster están en equipos diferentes, reemplace: Reemplace: 
    {MRBASEDIR}

    por la ruta absoluta al repositorio de Managed Reporting (directorio basedir) que contiene los archivos user.htm y role.htm. Por ejemplo: 

    /install_directory/ibi/WebFOCUS77/basedir
  6. Si establece una contraseña para el administrador de ReportCaster predeterminado, y ha reiniciado el servidor de distribución, sustituya lo siguiente por la constraseña del administrador de ReportCaster: 
    ""

    Por ejemplo: 

    . ./classpath
java ibi.broker.DSTMRESynchronize 
/home/wf77/ibi/WebFOCUS77/basedir/user.htm 
/home/wf77/ibi/WebFOCUS77/basedir/role.htm
   admin password localhost:8200
  7. Guarde y cierre el archivo.
  8. Si no se encuentra ahí, vaya al directorio ReportCaster/bin: 
    cd /install_directory/ibi/WebFOCUS77/ReportCaster/bin
  9. Debido a que la contraseña del administrador está en el archivo, puede asegurarla emitiendo lo siguiente: 
    chmod 700 rcusersync
  10. Ejecute el archivo rcusersync: 
    ./rcusersync
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin/rcusersync

Nota:

x
Procedimiento: Cómo Ejecutar la utilidad de sincronización de usuarios de Managed Reporting

Si va a migrar datos de Managed Reporting, hágalo antes de este procedimiento. Para más información sobre migraciones de Managed Reporting, consulte Migración de Managed Reporting y Dashboard.

  1. Si el servidor de distribución y el Cliente WebFOCUS no están en el mismo equipo, copie los siguientes archivos del equipo del equipo del Cliente WebFOCUS a un directorio del equipo del servidor de distribución: 
    drive:\ibi\WebFOCUS77\basedir\user.htm
    drive:\ibi\WebFOCUS77\basedir\role.htm
  2. Compruebe que el servidor de su base de datos de repositorio se está ejecutando, antes de intentar cargar datos en la misma.
  3. Si no se está ejecutando, inicie el servidor de informes. El servidor de distribución debe estar activado para ejecutar esta utilidad.
  4. Ejecute la utilidad de desde el menú Inicio seleccionando Programas, Information Builders, WebFOCUS 77, ReportCaster, Migración y utilidades de bases de datos y después, Sincronizar usuarios de Managed Reporting.

    Se abre la ventana Sincronización de usuarios MR.

  5. Pulse Exploración de usuario, para especificar la ubicación del archivo user.htm para Managed Reporting. Si el servidor de distribución está en la misma máquina que Managed Reporting, la ubicación predeterminada es: 
    drive:\ibi\WebFOCUS77\basedir\user.htm
  6. Pulse Exploración de rol, para especificar la ubicación del archivo role.htm para Managed Reporting. Si el servidor de distribución está en la misma máquina que Managed Reporting, la ubicación predeterminada es: 
    drive:\ibi\WebFOCUS77\basedir\role.htm
  7. Especifique el Id. de administrador de ReportCaster y laContraseña.

    Cuando se instala ReportCaster por primera vez, admin es un id. de usuario válido, y la contraseña debe haberse establecido en Cómo verificar ReportCaster. Sin embargo, la nueva contraseña no tendrá efecto hasta que reinicie el servidor de distribución.

  8. Pulse Sincronizar usuarios.

    Durante el proceso de sincronización, aparece una ventana con información. Revise la información de registro mostrada. Si hay errores, resuélvalos e inténtelo de nuevo.

  9. Si quiere guardar esta información de registro, pulse Guardar. De lo contrario, cierre esta ventana y el resto de las ventanas de la utilidad.

Nota:

Principio de página
x
Activación de Two-Way Email

Si su licencia incluye Two-Way Email, la ayuda de Two-Way Email queda instalada junto con el Cliente WebFOCUS y ReportCaster. Después de instalar y configurar completamente WebFOCUS y ReportCaster, active Two-Way Email del modo siguiente.

  1. Asegúrese de que haya un buzón y un id. de usuario para la cuenta Two-Way Email en su servidor de correo. Además, compruebe que existe una cuenta para e-mails erróneos.
  2. Acceda a la interfaz Configuración de servidor de ReportCaster.

    Puede entrar a través del menú Inicio de Windows, en el equipo del servidor de distribución, seleccionando Programas, Information Builders, WebFOCUS 77, ReportCaster, Servidor de distribución, Configuración y Editar.

  3. Seleccione la carpeta Two Way.
  4. Amplíe Two-Way predeterminado.
  5. Rellene los campos, para especificar los parámetros de Two-Way Email.

    Parámetro

    Descripción

    Activado

    Indique si Two-Way Email debe estar activado.

    Nombre del servidor Two Way

    Indique el servidor de informes WebFOCUS que va a utilizarse por defecto. Por ejemplo:

    EDASERVE

    Usuario de Two Way

    No es obligatorio.

    Cuenta

    Especifique la dirección de e-mail de la bandeja de entrada Two-Way Email.

    Cuenta de error

    Especifique la dirección de e-mail erróneo Two-Way Email.

    Cuenta de respuesta predeterminada de Two Way

    Opcionalmente, especifique una dirección de respuesta diferente a la dirección de e-mail especificada en la propiedad Cuenta.

    Registro de eventos

    Con el valor predeterminado es suficiente.

    Tipo de informe Two Way

    El valor predeterminado es En línea.

    Especifique el tipo de informe entregado por Two-Way Email. Otras opciones son el Archivo adjunto HTML y Archivo adjunto Active HTML.

    Nota: Para usar la opción de archivo adjunto HTML activo, debe tener la licencia para ejecutar informes HTML activos.

    Servidor de correo

    Especifique el nombre de host del servidor de correo utilizado con Two-Way Email.

    Protocolo

    Especifique POP3 o IMAP.

    Usuario de correo

    Especifique el inicio de sesión para la dirección de e-mail de la bandeja de entrada.

    Frecuencia de correo

    Con el valor predeterminado es suficiente.
  6. Si el servidor de distribución se está ejecutando, deténgalo.
  7. Inicie el servidor de distribución en modo comando.

    Debe aparecer lo siguiente:

    Reader ready Two-Way listener ready Dispatcher ready
Console ready

    Si aparece la línea Listener de Two-Way preparado, indica que Two-Way Email se encuentra activado. Si no puede iniciar Two-Way Email, compruebe que los parámetros introducidos sean los correctos. El servidor de correo debe estar activado y las direcciones de e-mail deben existir, o de lo contrario no podrá iniciar Two-Way Email.

    Puede ejecutar el servidor de distribución en modo servicio o comando. El modo comando solo es necesario la primera vez que confirme que el listener de Two-Way Email se encuentra activado.

    Una vez creado, puede crear las tablas del repositorio de Two-Way Email (BOTJOURN, BOTTELL).

  8. Si necesita crear las tablas del repositorio de Two-Way Email (BOTJOURN, BOTTELL), ejecute la siguiente utilidad y escoja crear (o abandonar/crear) solo las tablas Two-Way Email:
    drive:\ibi\WebFOCUS77\ReportCaster\bin\rccreateutil.bat
    /install_directory/ibi/WebFOCUS77/ReportCaster/bin/createUtil

    Asegúrese de que solo ha escogido las tablas Two-Way Email. Para más información sobre esta utilidad, consulte Cómo abandonar o crear grupos de tablas específicas.

WebFOCUS