Prácticas probadas de IBM Cognos: Instalación de FAP para IBM Cognos Controller 8.5

Tipo de documento: directiva; producto(s): IBM Cognos Controller 8.5 y TM1 9.4; área de interés: gestión financiera

Directivas para instalar y configurar Financial Analytics Publisher.

Wayne Harper, Senior Customer Support Analyst , IBM

Wayne Harper es Senior Customer Support Analyst de IBM Cognos Controller. Se especializa en especificaciones para importaciones de archivos, importaciones de estructuras y data marts de IBM Cognos Controller.



22-09-2010

Introducción

Objetivo

Este documento es una guía con capturas de pantalla para instalar Financial Analytic Publisher (FAP) para su uso con Controller 8.5.

Se presupone que Microsoft SQL Server 2005 es la base de datos usada en la instalación de Controller.

Aplicabilidad

IBM Cognos Controller 8.5 y TM1 9.4

Exclusiones y excepciones

No existen excepciones ni exclusiones conocidas al momento de creación de este documento.


FAP: generalidades

FAP: objetivo

Los cambios que se producen en la base de datos de Controller —sean estructurales o en los datos— pasan a la base de datos temporal de FAP. Luego el servicio FAP transforma estos datos relacionales en un cubo TM1.

Figure 1 shows the data from from IBM Cognos Controller => FAP database => TM1 Cube

Introducción a la integración entre Controller y TM1

Integración entre Controller y TM1

Se presupone que tanto Controller 8.5 como TM1 ya están instalados. Si desea obtener información detallada sobre la instalación de estos productos, consulte la siguiente documentación:

Installing & Configuring IBM Cognos Controller 8.5 server

Nota: Microsoft SQL Server 2000 no es compatible con FAP. Use Microsoft SQL Server 2005 ó 2008.

Para obtener información detallada de los entornos de software compatibles con Controller 8.5, visite la siguiente página:

http://www.ibm.com/support/docview.wss?uid=swg27017475


Instalación de IBM Cognos Controller

Pasos para instalar IBM Cognos Controller

En el disco de instalación de IBM Cognos Controller, seleccione ‘issetup.exe’ del directorio win32. Aparecerá la siguiente pantalla:

Figure 2 shows the installation steps for IBM Cognos Controller
  • Haga clic enNext (Siguiente) > Agree (Aceptar) > Next (Siguiente)
  • Seleccione la ubicación de instalación deseada (la ubicación predeterminada es: C:\Program Files\cognos\c8)
  • De la listaComponent Selection (Selección de componentes), seleccioneFinancial Analytics Publisher
Figure 3 shows the installation of the Financial Analytics Publisher
  • Haga clic enNext (Siguiente) > Next (Siguiente) > Finish (Finalizar)

Instalación de Java JRE 1.6 en donde reside el Cliente FAP

Para instalar Java Runtime Environment (JRE) 1.6:

Paso 1: Copie los archivos relevantes en el mismo servidor donde reside el Cliente FAP

  • Inicie sesión en el servidor de aplicaciones Controller como administrador
  • Ubique la carpeta webcontent\ccr (ubicación predeterminada: C:\Program Files\Cognos\c8\webcontent\ccr)
  • Copie el archivo jre.zip en el servidor donde desea instalar FAP
  • Cree una carpeta C:\Program Files\ibm\java60\
  • Extraiga el archivo jre.zip en esta carpeta

La estructura de carpetas debería quedar así:
C:\Program Files\IBM\Java60\jre\bin
C:\Program Files\IBM\Java60\jre\lib

Paso 2: Configure la variable de sistema 'CCR_JAVA_Home'

  • Haga clic con el botón derecho enMy Computer (Mi PC)y seleccioneProperties (Propiedades)
  • Haga clic en la pestañaAdvanced (Opciones avanzadas)
  • Haga clic en el botónEnvironment Variables (Variables de entorno)
  • Haga clic en el botónNew (Nuevo)del grupoSystem Variables (Variables del sistema)
  • Escriba CCR_JAVA_Home como nombre de laVariable
  • Escriba la ruta de acceso C:\Program Files\IBM\Java60\jre como valor de la Variable (ver la siguiente captura de pantalla)
Figure 4 shows the configuration of the JAVA application

Solución de problemas con el controlador de Java

Si tiene problemas con el controlador de JAVA, consulte la siguiente nota técnica:

http://www.ibm.com/support/docview.wss?uid=swg21440254

Nota: el controlador de Java no está incluido en la instalación de IBM Cognos Controller, por lo que es necesario descargarlo.

Pasos para crear la base de datos de FAP:

Para que los datos pasen de la base de datos de Controller al cubo TM1, se necesita una base de datos intermedia.

Paso 1: Cree una nueva base de datos

Paso 2: Ejecute el script para crear las tablas necesarias

Puede encontrar el script requerido nrtr_createTables.sql en las siguientes ubicaciones (según el tipo de base de datos usado).

SQL Server
C:\Program Files\Cognos\c8\Server\FAP\SQL

u

Oracle
C:\Program Files\Cognos\c8\Server\FAP\Oracle

Una vez ejecutado el script, las siguientes tablas deberían aparecer en la base de datos.

Figure 5 shows the NRTR tables created in the TM1 cube

Creación de un origen ODBC para TM1

Cree un origen de datos ODBC para que TM1 se comunique con la base de datos de FAP.

El origen de datos ODBC se debe crear en el servidor TM1 con el nombre FAP.

Pasos necesarios para crear un origen de datos ODBC

Nota: El software cliente de la base de datos relacional debe estar instalado en la misma computadora donde se crea el origen de datos ODBC FAP y el servidor TM1.

Cree un nuevo origen de datos (DSN de sistema) llamado FAP.

Figure 6 shows the DSN Configuration for the ODBC data source

Seleccione las credenciales de inicio de sesión de la base de datos creada en el ‘paso 5: Cree una base de datos de FAP’.

Figure 7 shows changing the default database

Creación de un directorio en el servidor TM1

Cree un directorio en el servidor TM1

Cree un directorio FAP en TM1; en el ejemplo se usa el directorio ‘C:\TM1_FAP’, pero se puede elegir cualquier directorio.

Figure 8 shows the TM1_FAP directory

Coloque los archivos tm1s.cfg y tm1s.lic en el directorio de datos

En el servidor TM1, ubique los archivos tm1s.cfg y tm1s.lic y cópielos en el directorio de datos recién creado.

Edite el archivo tm1s.cfg en su editor de texto favorito de manera de reflejar su ambiente, por ejemplo:

[TM1S]
DataBaseDirectory={Directorio de datos}
ServerName={Nombre del servidor TM1}
PortNumber={El número de puerto debe ser único para cada servidor TM1}
AdminHost={Servidor físico}
Language=eng
Protocol=tcp

Figure 9 shows the tm1s.cfg file and what needs to be modified

Para obtener mejores resultados, establezca un valor mínimo de 1000 paraGroupsCreationLimit(el valor predeterminado es 20). El número máximo de grupos de GroupsCreationLimit es 65535.

Instale el servidor TM1 como servicio

Al instalar el servidor TM1, se instala de manera automática un servicio de servidor TM1 llamado TM1 Admin Server, que es el principal servicio de Windows para el servidor TM1. Además, es necesario tener instalado un servicio aparte para poder escribir y leer datos del cubo TM1.

Para poder actualizar el cubo TM1, ambos servicios deben estar en estadoStarted (Iniciado).

Pasos

  1. Abra un símbolo del sistema.
  2. Escriba el comando cd C:\Program Files\Cognos\TM1\bin para cambiar de directorio (en el caso de una instalación predeterminada de TM1).
  3. Escriba el comando tm1sd.exe -install -n <tm1servername> -z <”data directory”>, donde <tm1servername> es igual a la variable Servername del archivo tm1s.cfg y <data directory> es la ubicación.

Ejemplo:

tm1sd.exe -install -n TM1_FAP -z ”C:\TM1_FAP”

Figure 10 shows the command prompt

Una vez que el servicio se crea exitosamente, aparece el mensaje “TM1 Server / tm1servername installed”.

En la ventanaServices (Servicios), inicie el servicio TM1 recién creado.

Figure 11 shows the requirement to start the new TM1 service

El servicio se ejecutará con la cuenta de sistema local.

Figure 12 shows the logon setup

Instalación del servicio FAP

Cree un directorio para almacenar la conexión de datos del servidor TM1

En el servidor TM1, cree un directorio para almacenar los nuevos datos del servidor TM1.

Pasos:

  1. Copie los archivos a la ubicación requerida. Asegúrese de que los archivos y carpetas pertinentes estén en el servidor donde desea instalar el servicio FAP. Puede encontrar los archivos en el directorio C:\Program Files\Cognos\c8\Server\FAP del servidor de aplicaciones (en el caso de una instalación predeterminada). Figure 13 shows the FAP files
  2. Abra un símbolo del sistema.
  3. Escriba lo siguiente (en caso de que FAP se instalara en la ubicación predeterminada):
    cd C:\Program Files\Cognos\c8\Server\FAP
    Opcionalmente, seleccione el directorio donde están los archivos FAPNTService.exe, FAPService.properties y FAPServiceGlue.dll y la carpeta lib.
  4. Escriba lo siguiente para crear el servicio FAP: \WINDOWS\Microsoft.NET\Framework\v2.0.50727\installUtil.exe FAPNTService.exe.

En el cuadro de diálogoSet Service Login (Establecer inicio de sesión de servicio), escriba las credenciales de un usuario administrativo.

Figure 14 shows the signon information

El servicioIBM Cognos FAP Servicedebería figurar entre los servicios.

Figure 15 IBM Cognos FAP Service

Para desinstalar el servicio FAP, use el siguiente comando:

C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\installUtil.exe /u FAPNTService.exe

No inicie el servicio en este momento ya que es necesario editar el archivo FAPService.Properties para asegurarse de que el servicio FAP se pueda conectar a la base de datos de FAP.

Actualice el archivo FAPService.properties

Para asegurarse de que el servicio FAP se pueda conectar a la base de datos de FAP, agregue las propiedades de conexión de la base de datos al archivo FAPService.Properties.

db=<nombre de la base de datos> (SQL Server) or <SID de Oracle> (Oracle)
host=<dns_to_the_FAP_database>
dbType=<oracle>o <sqlserver>
user=<nombre de usuario>
passwd=<contraseña>

El servicio FAP no funcionará si se usa una instancia SQL (por ejemplo, Server\Instance). En este caso, la sintaxis debería ser Server:Port Number (Servidor:Número de puerto). Introduzca la configuración pertinente de la base de datos creada en la sección 5: Cree una base de datos FAP, por ejemplo:

db=WH_WHFAP
host=wbraharperw-xd:1738
dbType=sqlserver
user=fastnet
passwd=********

Una vez actualizado el archivo FAPService.Properties, es necesario iniciar el servicio IBM Cognos FAP.

Si la información de conexión que contiene el archivo FAPService.Properties es inválida, el archivo FAPFatalError.log aparecerá en el directorio donde está ubicado el archivo FAPNTService.exe.

Figure 16 shows invalid file created if there is a problem with the connection information

En ese caso, es necesario corregir el archivo FAPService.Properties.


Instalación del cliente TM1

Este paso únicamente es necesario cuando el servicio Financial Analytics Publisher y el servidor de aplicaciones TM1 están en diferentes servidores.

Pasos para instalar el cliente TM1 en el servidor Financial Analytics Publisher

  • Haga doble clic en el archivosetup.exedel disco de instalación de TM1.
  • En el cuadro de diálogoChoose Setup Language (Elegir idioma de configuración), seleccioneEnglish (Inglés)y haga clic enOK (Aceptar).
  • Haga clic en Aceptar en el cuadro de diálogoNotice to Customers Upgrading to TM1 9.4 (Notificar a clientes que actualizan a TM1 9.4).
  • En la ventanaWelcome to the IBM Cognos TM1 Installation Wizard (Bienvenido al asistente de instalación de IBM Cognos TM1), haga clic en Next (Siguiente).
  • En el cuadro de diálogoLicense Agreement (Contrato de licencia), seleccioneI accept the terms of the license agreement (Acepto los términos del contrato de licencia)y haga clic en Next (Siguiente).
  • En Choose a Product to Install (Elija un producto para instalar), seleccione la opciónTM1 Server and Client (TM1 servidor y cliente)y haga clic en Next (Siguiente).
  • Seleccione el cuadro de diálogoTM1 Rules Editor requires Microsoft .NET Framework Manager Version 3.0 (El editor de reglas de TM1 requiere Microsoft .NET Framework Manager versión 3.0)y haga clic en OK (Aceptar).
  • Asegúrese de queInstall to (Instalar en)quede establecido en C:\Program Files\Cognos\TM1 y queInstallation Type (Tipo de instalación)quede establecido enCustom - Installation for multi-machine/multi-user configurations by IT or Administrator (Personalizada: instalación para configuraciones multimáquina/multiusuario por TI o Administrador), y haga clic en Next (Siguiente).
  • Asegúrese de queComponent Selection (Selección de componentes)esté.
  • Haga clic enNext (Siguiente)para aceptar la configuración del puerto TCP/IP.
  • Escriba el nombre de usuario y la contraseña, vuelva a escribir la contraseña y haga clic enNext (Siguiente).
  • Haga clic enNextpara confirmar la configuración de seguridad.
  • Haga clic enNextpara confirmar la configuración del servidor TM1.
  • Haga clic enNext.
  • Haga clic enFinish (Finalizar).

Agregue una ruta de acceso para las variables del sistema cliente TM1

  • Haga clic con el botón derecho enMy Computer (Mi PC)y seleccioneProperties (Propiedades).
  • Haga clic en la pestaña.
  • Haga clic enEnvironment Variables (Variables de entorno).
  • EnSystem Variables (Variables de entorno), seleccionePath (Ruta de acceso)y haga clic enEdit (Editar).
  • En el cuadro de diálogoVariable value (Valor de la variable), agregue ;C:\Program Files\Cognos\TM1\bin al final del valor. Figure 17 shows adding a path for TM1 Client System Variables
  • Haga clic en OK (Aceptar) en todos los cuadros de diálogo que aparezcan.

Configuración del cliente FAP

Conecte FAP

Abra el cliente FAP. En el menú Inicio, haga clic en Programs (Programas) > IBM Cognos 8 > IBM Cognos Controller > IBM Cognos 8 FAP. Aparecerá el cuadro de diálogo FAP Connect (Conexión FAP).

Figure 18 shows the establishment of the connection to MS SQL Server

Ingrese los detalles necesarios de la base de datos de FAP creada en el paso 5.

Nota: Existe cierta inconsistencia en la manera en que se debe definir el servidor cuando se configura FAP. En el cliente FAP, SQL Server se define como Server\Instance, en lugar de definirse como Server:Port (servicio FAP).

Figure 19 shows an example of the database connection and userid and password

Haga clic enLog in (Iniciar sesión).

Configuración del cliente FAP

Haga clic en la pestañaService Settings (Configuración del servicio). EnClock Interval (Intervalo del reloj), ingrese 15 segundos; enLog file keep items for (El archivo de registro guarda los elementos durante), ingrese 3 días; enTrickle tables purge every (Las tablas por goteo purgan cada), ingrese 2 días.

Figure 20 shows the time settings for the trickle publishment
  • Haga clic en la pestaña Sources (Orígenes). Haga clic en New (Nuevo).
  • Agregue los detalles de conexión de su base de datos de IBM Cognos Controller, por ejemplo: Figure 21 shows the entering details of the IBM Cognos Controller database connection
  • Haga clic en Save (Guardar).
  • En la pestaña Sources (Orígenes), aparecerá la siguiente información.
  • Haga clic en Start (Iniciar) para activar el origen IBM Cognos Controller. Figure 22 shows the requirement to start the IBM Cognos Controller datasource connection
  • Haga clic en la pestañaData Marts.
  • Haga clic enNew (Nuevo)para crear una nueva conexión de Data Mart. Figure 23 shows the FAP datamart connection

Información de la configuración:

Source (Origen): definido en la pestaña Source.

Log Level (Nivel de registro): cantidad de detalles de registro proporcionados.

Company Structure (Estructura de la empresa): versión de estructura empresarial que se publicará (período y tipo de consolidación).

Start Period/Actuality (Período de inicio/Actualidad): Período y actualidad deseados.

Admin Host (Host de administración): servidor TM1 (servidor físico); se puede definir por nombre DNS o IP.

Server (Servidor): nombre de servidor TM1 (es decir, nombre de servidor proporcionado en el archivo tm1s.cf; ver detalles en la sección 8

Client (Cliente): nombre de usuario de TM1

Password (Contraseña): contraseña

  • Una vez ingresadas las opciones de configuración requeridas, haga clic enSave (Guardar). Figure 24 shows the database settings
  • Haga clic enStart (Iniciar)para comenzar el proceso de publicación.

Si la configuración es correcta, verá que el estado cambia de Ready to Publish (Listo para publicar) a Initial Publish (Publicación inicial) y luego a Running (En ejecución). Si se produce algún error, haga clic en la pestaña Logs (Registros) para obtener más información.

Nota: Si bien puede haber múltiples data marts, cada uno de ellos debe tener un servidor TM1 único para la publicación.


Datos TM1 después de una publicación

Si la publicación es exitosa, podrá visualizar los siguientes objetos en el servidor TM1.

Figure 25 shows the TM1 Architect folders, tm1 connection info, etc.

Otras fuentes

Existe más documentación disponible en el sitio de prácticas probadas.

  • Extended FAP for IBM Cognos Controller 8.5
  • Connect BI to Controller Datamart
  • Installing IBM Cognos Controller 8.5.1 with IBM BI 8.4.1

Comentarios

developerWorks: Ingrese

Los campos obligatorios están marcados con un asterisco (*).


¿Necesita un IBM ID?
¿Olvidó su IBM ID?


¿Olvidó su Password?
Cambie su Password

Al hacer clic en Enviar, usted está de acuerdo con los términos y condiciones de developerWorks.

 


La primera vez que inicie sesión en developerWorks, se creará un perfil para usted. La información en su propio perfil (nombre, país/región y nombre de la empresa) se muestra al público y acompañará a cualquier contenido que publique, a menos que opte por la opción de ocultar el nombre de su empresa. Puede actualizar su cuenta de IBM en cualquier momento.

Toda la información enviada es segura.

Elija su nombre para mostrar



La primera vez que inicia sesión en developerWorks se crea un perfil para usted, teniendo que elegir un nombre para mostrar en el mismo. Este nombre acompañará el contenido que usted publique en developerWorks.

Por favor elija un nombre de 3 - 31 caracteres. Su nombre de usuario debe ser único en la comunidad developerWorks y debe ser distinto a su dirección de email por motivos de privacidad.

Los campos obligatorios están marcados con un asterisco (*).

(Por favor elija un nombre de 3 - 31 caracteres.)

Al hacer clic en Enviar, usted está de acuerdo con los términos y condiciones de developerWorks.

 


Toda la información enviada es segura.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=90
Zone=Information mgmt
ArticleID=965733
ArticleTitle=Prácticas probadas de IBM Cognos: Instalación de FAP para IBM Cognos Controller 8.5
publish-date=09222010