IBM Cognos Incentive Compensation Management Versi.n 8.1.3 ...public.dhe.ibm.com/.../cognos/documentation/varicent/es/8.1.3/ig_ic… · Title: IBM Cognos Incentive Compensation Management

IBM Cognos Incentive Compensation ManagementVersión 8.1.3

Guía de instalación y configuración

��

NotaAntes de utilizar esta información y el producto al que da soporte, lea la información del apartado “Avisos” en la página105.

Información sobre el producto

Este documento se aplica a IBM Cognos Incentive Compensation Management Versión 8.1.3 y puede aplicarsetambién a las versiones posteriores.

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2005, 2015.

Contenido

Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Capítulo 1. Preparación de la instalación del cliente. . . . . . . . . . . . . . . . . 1Descripción general de la aplicación . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Archivos de instalación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Lista de comprobación previa a la instalación . . . . . . . . . . . . . . . . . . . . . . . . 3Requisitos de componente y permisos de base de datos de Microsoft SQL Server . . . . . . . . . . . . 4

Configuración de IBM Cognos Incentive Compensation Management como propietario de la base de datos paraMicrosoft SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Cambio de DEFAULT_SCHEMA mediante Microsoft SQL Server Management Studio . . . . . . . . . . 5Cambio de DEFAULT_SCHEMA mediante una consulta . . . . . . . . . . . . . . . . . . . . 5

Capítulo 2. Instalar el servicio y el cliente de IBM Cognos Incentive CompensationManagement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Instalación del cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Instalación del servicio de Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Establecimiento del inicio automático del servicio de Windows . . . . . . . . . . . . . . . . . 8Archivos de configuración . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Archivo de configuración de cliente . . . . . . . . . . . . . . . . . . . . . . . . . . 8Archivo de configuración del servicio IBM Cognos Incentive Compensation Management . . . . . . . . 9

Actualizaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Actualizaciones estándares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Ejecución de instancias simultáneas de IBM Cognos Incentive Compensation Management . . . . . . . . 22

verificación de la instalación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Apertura de un modelo existente . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Creación de un nuevo modelo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Integración de LDAP con el cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Configuración del archivo de configuración del servicio de Windows para la autenticación LDAP . . . . . 25Cómo otorgar acceso al cliente a los usuarios LDAP o los grupos LDAP . . . . . . . . . . . . . . 26

optimización del rendimiento del nivel de datos . . . . . . . . . . . . . . . . . . . . . . . 27Integración de CLR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Habilitación de la optimización del rendimiento del nivel de datos en el cliente . . . . . . . . . . . 27

Capítulo 3. Herramientas del cliente . . . . . . . . . . . . . . . . . . . . . . . 29servicio de consola . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Instalación del servicio de consola . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Edición del archivo de configuración del servicio de consola . . . . . . . . . . . . . . . . . . 29Inicio del servicio de consola . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

cifrado del archivo de configuración . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Instalación de Configuration File Encrypter. . . . . . . . . . . . . . . . . . . . . . . . 30Ejecución de Configuration File Encrypter . . . . . . . . . . . . . . . . . . . . . . . . 30

Conversor de modelos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Instalación de la herramienta Conversor de modelos . . . . . . . . . . . . . . . . . . . . 31Conversión de un modelo de Microsoft SQL 2000 o 2005 a 2008 . . . . . . . . . . . . . . . . . 31Conversión de un modelo de Microsoft SQL Standard en un modelo de Enterprise . . . . . . . . . . 32Conversión de un modelo de Microsoft SQL 2005 Standard Edition en un modelo de 2008 Enterprise Edition 32Utilización de la característica de optimización del tamaño de Enterprise . . . . . . . . . . . . . . 33

Certificados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Software necesario para utilizar certificados digitales . . . . . . . . . . . . . . . . . . . . 33Herramienta de creación de certificados . . . . . . . . . . . . . . . . . . . . . . . . . 34Configuración de Microsoft Management Console para utilizar certificados digitales . . . . . . . . . . 35Certificados raíz y de servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Dirección IP y puerto del servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Configuración de IBM Cognos Incentive Compensation Management para utilizar certificados . . . . . . 39

Interfaz de línea de comandos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

© Copyright IBM Corp. 2005, 2015 iii

Lista de comprobación previa a la instalación de la interfaz de línea de comandos. . . . . . . . . . . 40Instalación de la interfaz de línea de comandos (CLI) de IBM Cognos Incentive Compensation Management . . 40Configuración de certificados digitales con la CLI . . . . . . . . . . . . . . . . . . . . . 40Conexión a un modelo mediante la interfaz de línea de comandos . . . . . . . . . . . . . . . . 41Comandos de la interfaz de línea de comandos . . . . . . . . . . . . . . . . . . . . . . 41Código de retorno desde la interfaz de línea de comandos. . . . . . . . . . . . . . . . . . . 42

API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Arquitectura de API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Acceso a la API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Especificaciones de API para el procesamiento y el cálculo . . . . . . . . . . . . . . . . . . 45Especificaciones de API para la gestión de datos . . . . . . . . . . . . . . . . . . . . . . 47Especificaciones de API para el almacén de datos. . . . . . . . . . . . . . . . . . . . . . 49Definiciones de objeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Definiciones de excepciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Complemento para Microsoft Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Configuración del lado del servicio para instalar el complemento . . . . . . . . . . . . . . . . 55Configuración del lado del cliente para instalar el complemento . . . . . . . . . . . . . . . . . 57

Capítulo 4. El cliente web de IBM Cognos Incentive Compensation Management . . . . 61Instalación del cliente web con el sistema operativo Solaris . . . . . . . . . . . . . . . . . . . 61Despliegue de Apache Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Instalación y configuración de Java . . . . . . . . . . . . . . . . . . . . . . . . . . 61Instalación y configuración de Apache Tomcat . . . . . . . . . . . . . . . . . . . . . . . 61Despliegue del cliente web con Apache Tomcat . . . . . . . . . . . . . . . . . . . . . . 62Configuración del acceso a la base de datos con Apache Tomcat . . . . . . . . . . . . . . . . . 62Configuración del soporte de varios idiomas y de datos Unicode para Apache Tomcat . . . . . . . . . 63

Despliegue de JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Instalación y configuración de Java para JBoss . . . . . . . . . . . . . . . . . . . . . . . 64Instalación y configuración de JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . 64Configuración del acceso a la base de datos para JBoss . . . . . . . . . . . . . . . . . . . . 64Despliegue del cliente web con JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . 65Configuración del soporte de varios idiomas y de datos Unicode para JBoss. . . . . . . . . . . . . 66

Despliegue de WebSphere 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Despliegue del cliente web en WebSphere 7 . . . . . . . . . . . . . . . . . . . . . . . 66Configuración del acceso a la base de datos con WebSphere . . . . . . . . . . . . . . . . . . 67Utilización de la consola administrativa de WebSphere para iniciar el cliente web . . . . . . . . . . . 68Establecimiento de una propiedad personalizada de contenedor web en WebSphere . . . . . . . . . . 68Configuración del soporte de varios idiomas y de datos Unicode para WebSphere. . . . . . . . . . . 69Despliegue de WebSphere 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Cifrado de los archivos de propiedades . . . . . . . . . . . . . . . . . . . . . . . . . . 72Obtención de contraseñas cifradas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Configuración del cifrado de contraseña del cliente web . . . . . . . . . . . . . . . . . . . 72Configuración del cifrado de contraseña del cliente web en un entorno Windows . . . . . . . . . . . 73Despliegue del cliente web con contraseñas cifradas . . . . . . . . . . . . . . . . . . . . . 73Configuración del soporte de varios idiomas y de datos Unicode para el entorno local . . . . . . . . . 74

Envío de mensajes de correo electrónico a los usuarios cuando haya una consulta pendiente . . . . . . . . 74Cómo evitar que los informes iniciales carguen una gran cantidad de datos . . . . . . . . . . . . . . 75Límites de fila de cuadrícula de datos de informe inicial . . . . . . . . . . . . . . . . . . . . 75Aspecto del cliente web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Configuración de las pestañas web . . . . . . . . . . . . . . . . . . . . . . . . . . 76Cambio del tema del cliente web . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Capítulo 5. Autenticación e inicio de sesión. . . . . . . . . . . . . . . . . . . . 81Opciones de ruta de comunicación . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Opciones de seguridad para la comunicación entre el cliente y el servidor de aplicaciones . . . . . . . . 81Opciones de seguridad para la comunicación entre el servidor de aplicaciones y el servidor de bases de datos 81Métodos de comunicación entre el cliente web y la aplicación web . . . . . . . . . . . . . . . . 82Métodos de cifrado para la comunicación entre el servidor de aplicaciones web y el servidor de bases de datos 82

Opciones de autenticación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Configuración de SiteMinder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

iv IBM Cognos Incentive Compensation Management Versión 8.1.3: Guía de instalación y configuración

Configuración del cliente web para CA SiteMinder . . . . . . . . . . . . . . . . . . . . . 83Acceso al cliente web con SiteMinder. . . . . . . . . . . . . . . . . . . . . . . . . . 83

Configuración de OpenSSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Descarga e instalación de OpenSSO . . . . . . . . . . . . . . . . . . . . . . . . . . 85Configuración de OpenSSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Configuración del proveedor de identidad (IDP) . . . . . . . . . . . . . . . . . . . . . . 85Configuración del proveedor de servicios . . . . . . . . . . . . . . . . . . . . . . . . 86

Configuración de LDAP para el cliente web . . . . . . . . . . . . . . . . . . . . . . . . 88Requisitos de validación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Configuración del archivo ldap.properties . . . . . . . . . . . . . . . . . . . . . . . . 89Configuración del archivo web.xml . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Capítulo 6. Integración . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Conexión a IBM Cognos Territory and Quota Management . . . . . . . . . . . . . . . . . . . 91Conexión a IBM Cognos Producer Lifecycle and Credential Management. . . . . . . . . . . . . . . 91Configuración del cliente web de IBM Cognos Incentive Compensation Management para Salesforce.com . . . . 92Acceso a IBM Cognos Incentive Compensation Management desde Salesforce.com . . . . . . . . . . . 92Integración del cliente web con Oracle CRM . . . . . . . . . . . . . . . . . . . . . . . . 93

Configuración del cliente de IBM Cognos Incentive Compensation Management para la integración con OracleCRM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Configuración del cliente web de IBM Cognos Incentive Compensation Management para su uso con OracleCRM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Personalización del aspecto del cliente para que se corresponda con el de Salesforce.com . . . . . . . . . 95Cambio del tema de IBM Cognos Incentive Compensation Management por Salesforce.com . . . . . . . 95

Integración con el servidor web de Microsoft IIS . . . . . . . . . . . . . . . . . . . . . . . 95Configuración del cliente web para preparar la integración con el servidor web de Microsoft IIS . . . . . . 96Configuración de Apache Tomcat para aceptar solicitudes procedentes de un proxy . . . . . . . . . . 96Configuración de IIS para reenviar solicitudes a IBM Cognos Incentive Compensation Management. . . . . 96

Integración con Autenticación de Windows integrada . . . . . . . . . . . . . . . . . . . . . 99Configuración para Internet Explorer . . . . . . . . . . . . . . . . . . . . . . . . . 100Configuración para Mozilla Firefox . . . . . . . . . . . . . . . . . . . . . . . . . . 100Configuración para Google Chrome . . . . . . . . . . . . . . . . . . . . . . . . . . 100Creación de un archivo de configuración de Kerberos . . . . . . . . . . . . . . . . . . . . 101Configuración del nombre principal de servicio y la tabla de claves . . . . . . . . . . . . . . . 101Configuración del cliente web . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Glosario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111U . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Índice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Contenido v

vi IBM Cognos Incentive Compensation Management Versión 8.1.3: Guía de instalación y configuración

Introducción

Este documento se ha concebido para su utilización con IBM® Cognos IncentiveCompensation Management Versión 8.1.1.

IBM Cognos Incentive Compensation Management permite a las organizacionesautomatizar el proceso de administración, cálculo, creación de informes y análisisde los programas de pago basados en variables. La solución simplifica la gestiónde la remuneración en las organizaciones, ya que incrementa la precisión, reducelos costes y mejora la visibilidad de los planes de remuneración y del rendimientode las ventas.

Destinatarios

Esta guía está dirigida a los usuarios que instalarán y configurarán el cliente web yel cliente de IBM Cognos Incentive Compensation Management.

Búsqueda de información

Para buscar documentación en la web, incluida toda la documentación traducida,acceda al Knowledge Center de IBM (http://www.ibm.com/support/knowledgecenter).

Fecha de publicación

Este documento se publicó el11 Febrero 2015 .

Características de accesibilidad

Las características de accesibilidad ayudan a los usuarios que tienen unadiscapacidad física, por ejemplo movilidad restringida o visión limitada, a utilizarproductos de tecnología de la información.

Proyecciones futuras

En esta documentación se describe la funcionalidad actual del producto. Puede quese incluyan referencias a elementos que actualmente no están disponibles. Sinembargo, no deberá deducirse su futura disponibilidad real. Estas referencias noconstituyen un compromiso, promesa ni obligación legal que implique la entregade ningún tipo de material, código o funcionalidad. El desarrollo, entrega ycomercialización de las características o funcionalidad son aspectos que quedan ala entera discreción de IBM.

© Copyright IBM Corp. 2005, 2015 vii

http://www-01.ibm.com/support/knowledgecenter

viii IBM Cognos Incentive Compensation Management Versión 8.1.3: Guía de instalación y configuración

Capítulo 1. Preparación de la instalación del cliente

IBM Cognos Incentive Compensation Management es una valiosa herramienta quese puede utilizar para gestionar los pagos a personas que reciben remuneracionesvariables, como el personal de ventas, el personal de administración o los canalesde distribución.

Cognos Incentive Compensation Management permite a las organizaciones diseñar,gestionar y automatizar el cálculo del pago variable de decenas de planes y milesde empleados al mismo tiempo. La aplicación contiene diversos diálogoscontextuales y asistentes diseñados para que le sirvan de guía durante la ejecuciónde tareas.

Para ver una lista actualizada de los entornos soportados por Cognos IncentiveCompensation Management, como sistemas operativos, parches, navegadores,servidores web, servidores de bases de datos y servidores de aplicaciones, consultelos requisitos de software (http://www.ibm.com/support/docview.wss?uid=swg27041272).

Descripción general de la aplicaciónIBM Cognos Incentive Compensation Management es una aplicación de N-nivelesdistribuida.

Las tres aplicaciones siguientes forman parte de la solución integrada:

clienteContiene la interfaz de usuario para realizar el trabajo.

Servidor de aplicacionesContiene la lógica empresarial, el motor de cálculo y el planificador deeventos empresariales.

Servidor de bases de datosAlmacena datos para el modelo de Cognos Incentive CompensationManagement, como la información de dimensiones y los resultadoscalculados.

Se da soporte a diversos servidores de bases de datos diferentes, incluido MicrosoftSQL Server (2005, 2008 ó 2012).

En los puntos siguientes se resumen los detalles del cliente:v Proporciona al administrador de modelos varias opciones administrativas, como

la creación de nuevos modelos, la personalización de las tablas, la importaciónde datos, el cálculo y diversos modos de creación de informes.

v Se encuentra en la estación de trabajo de cada administrador de modelos.v Se comunica con el servidor en un entorno distribuido real y utiliza un archivo

de configuración para especificar la ubicación del servidor de aplicaciones.v Se comunica con el servidor de aplicaciones a través de un canal cifrado escrito

en C # mediante Microsoft .NET Framework.

En los puntos siguientes se resumen los detalles del servidor de aplicaciones:

© Copyright IBM Corp. 2005, 2015 1

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

v La capa de aplicación se puede ejecutar como proceso en un servidor o en variospara proporcionar escalabilidad.

v Contiene la lógica empresarial para el modelo.v Aloja el motor de cálculo para el procesamiento de datos.v Utiliza la capa de datos para comunicarse con la base de datos especificada.v Contiene el planificador de Cognos Incentive Compensation Management, que

planifica y ejecuta eventos empresariales.v Está escrito en C# mediante Microsoft .NET Framework, lo que se traduce en un

producto altamente estable.

Archivos de instalaciónLa aplicación IBM Cognos Incentive Compensation Management se entrega convarios archivos de instalación.

Para utilizar la aplicación, debe instalar el cliente en la estación de trabajo deladministrador y el servicio de Windows Cognos Incentive CompensationManagement debe estar instalado y en ejecución en el servidor. Las herramientas,como Model Upgrader, Conversor de modelos, la interfaz de línea de comandos(CLI), el complemento de IBM Cognos Incentive Compensation Management paraMicrosoft Excel y Configuration File Encrypter, se pueden instalar, pero no sonnecesarias para ejecutar la aplicación principal.

Todas las herramientas y los componentes del cliente deben pertenecer a la mismaversión del producto. Si va a actualizar el cliente y el servicio, también deberánactualizarse todas las demás herramientas de Cognos Incentive CompensationManagement que se utilizan conjuntamente con la aplicación administrativaprincipal.

Tabla 1. Archivos de instalación

Componentes yherramientas de laaplicación

Nombre del archivo deinstalación Descripción

Cliente de Cognos IncentiveCompensation Management

ICM-client El cliente debe estarinstalado para ejecutar laaplicación.

Servicio de Windows CognosIncentive CompensationManagement

ICM-service El servicio de WindowsCognos IncentiveCompensation Management(o servicio de consola) debeestar instalado y en ejecuciónpara que la aplicaciónCognos IncentiveCompensation Managementfuncione correctamente.

Servicio de consola ICM-console El servicio de consola sepuede ejecutar comoalternativa al servicio deWindows Cognos IncentiveCompensation Management.No se precisa si se estáutilizando el servicio deWindows Cognos IncentiveCompensation Management.

2 IBM Cognos Incentive Compensation Management Versión 8.1.3: Guía de instalación y configuración

Tabla 1. Archivos de instalación (continuación)

Componentes yherramientas de laaplicación

Nombre del archivo deinstalación Descripción

CLI (interfaz de línea decomandos)

ICM-cli Es necesario ejecutar elinstalador de CLI para poderutilizar la herramienta CLI.No se precisa para laaplicación Cognos IncentiveCompensation Managementprincipal.

Complemento de IBMCognos IncentiveCompensation Managementpara Microsoft Excel

ICM-exceladdin Es necesario ejecutar elinstalador del complementode IBM Cognos IncentiveCompensation Managementpara Microsoft Excel parautilizar la herramienta. No seprecisa para la aplicaciónprincipal.

Configuration File Encrypter ICM-encrypter Es necesario ejecutar elinstalador de ConfigurationFile Encrypter para poderutilizar Configuration FileEncrypter. No se precisa parala aplicación CognosIncentive CompensationManagement principal.

Conversor de modelos ICM-modelconverter Es necesario ejecutar elinstalador de Conversor demodelos para poderconvertir los modelos a otraversión de Microsoft SQLServer. Solamente se precisapara la conversión demodelos.

Model Upgrader ICM-modelupgrader La herramienta ModelUpgrader debe estarinstalada para actualizar elmodelo de Cognos IncentiveCompensation Managementa una versión más reciente.Si el cliente y el servicio sehan actualizado, los modelosexistentes también debenactualizarse para quefuncionen en la nuevaversión del software.

Lista de comprobación previa a la instalaciónAntes de instalar la aplicación IBM Cognos Incentive Compensation Management,debe realizar algunas tareas previas a la instalación.

Antes de iniciar la instalación, asegúrese de haber llevado a cabo los pasossiguientes:

Capítulo 1. Preparación de la instalación del cliente 3

1. Descargue los archivos de instalación de Cognos Incentive CompensationManagement.

2. Instale Microsoft .NET Framework 4.5 en el servidor y en el cliente (se puededescargar desde http://www.microsoft.com/downloads).

3. Instale Java™ 6.4. Otorgue acceso de administrador a todos los sistemas involucrados.5. Otorgue derechos de usuario de base de datos suficientes o asígnese como

propietario de la base de datos.

Requisitos de componente y permisos de base de datos de MicrosoftSQL Server

Al desplegar IBM Cognos Incentive Compensation Management en Microsoft SQLServer, Cognos Incentive Compensation Management no requiere accesoadministrativo al servidor de bases de datos, pero deben otorgarse derechos depropiedad de base de datos para poder acceder a la base de datos.

Al instalar un modelo, asegúrese de que Cognos Incentive CompensationManagement se ha configurado como propietario de la base de datos (dbo).

Si no es posible otorgar derechos de propietario de la base de datos, debe crearseun usuario con los permisos mínimos necesarios siguientes:v Conectarv Crear tablav Crear vistav Ejecutarv Seleccionarv Suprimirv Insertarv Actualizarv Ver estado de base de datos

Importante: Es preferible otorgar derechos de propietario de la base de datos aCognos Incentive Compensation Management.

También debe instalar los dos componentes siguientes en Microsoft SQL Server:v SQL Server Integration Servicesv SDK de las herramientas de cliente

Configuración de IBM Cognos Incentive CompensationManagement como propietario de la base de datos paraMicrosoft SQL Server

Debe crear un usuario de base de datos que Cognos Incentive CompensationManagement utilizará para acceder a la base de datos y, a continuación, convertireste usuario en el propietario de la base de datos.

Procedimiento1. Cree un usuario de base de datos (ICMDBUser) que Cognos Incentive

Compensation Management utilizará para acceder a la base de datos.2. Inicie sesión en Microsoft SQL Server como administrador.


http://www.microsoft.com/downloads

3. Conéctese a la base de datos utilizada por Cognos Incentive CompensationManagement (ICMDatabase).

4. Ejecute el script siguiente:USE [ICMDatabase]GOIF EXISTS (SELECT*FROM dbo.sysusers WHERE name=N’ICMDBUser’)EXEC dbo.sp_revokedbaccess N’ICMDBUser’;GOsp_changedbowner N’ICMDBUser’

5. Si utiliza Microsoft SQL Server 2005, existen las siguientes opciones deseguridad adicionales:v ICMDBUser debe tener los derechos de creación de base de datos necesarios

sobre ICMDatabase.v ICMDBUser debe tener la propiedad DEFAULT_SCHEMA establecida en dbo. Esto

se puede realizar mediante Microsoft SQL Server Management Studio o conuna consulta.

Cambio de DEFAULT_SCHEMA mediante Microsoft SQLServer Management Studio

El esquema predeterminado para el usuario de la base de datos de IBM CognosIncentive Compensation Management se puede cambiar por el del propietario dela base de datos mediante SQL Server Management Studio.

Procedimiento1. En Microsoft SQL Server Management Studio, expanda la carpeta

ICMDatabase.2. Expanda la carpeta Seguridad.3. Expanda la carpeta Usuarios.4. Pulse con el botón derecho en ICMDBUser y seleccione Propiedades.5. Escriba o seleccione dbo en el campo Esquema predeterminado.

Cambio de DEFAULT_SCHEMA mediante una consultaEl esquema predeterminado del usuario de la base de datos de IBM CognosIncentive Compensation Management se puede cambiar por el del propietario dela base de datos mediante una consulta.

Procedimiento1. Conéctese a ICMDatabase con un cliente SQL.2. Inicie sesión con una cuenta de administrador.3. Ejecute la consulta siguiente: ALTER USER "ICMDBUser" WITH DEFAULT_SCHEMA

dbo;

Capítulo 1. Preparación de la instalación del cliente 5


Capítulo 2. Instalar el servicio y el cliente de IBM CognosIncentive Compensation Management

El servicio de Windows y el cliente de Cognos Incentive CompensationManagement deben estar instalados y en ejecución para que la aplicación CognosIncentive Compensation Management se pueda utilizar.

El cliente es necesario para permitir que los usuarios autorizados creen modelos,personalicen tablas, importen datos, creen cálculos y generen informes sobre losresultados. Para que el cliente se ejecute correctamente, el servicio (o el servicio deconsola) también debe estar instalado y en ejecución.

Instalación del clienteEl cliente de IBM Cognos Incentive Compensation Management debe estarinstalado para ejecutar la aplicación. El cliente debe estar instalado en el sistemadel administrador.

Procedimiento1. Efectúe una doble pulsación en el archivo de instalación ICM-client.exe, que se

encuentra en la carpeta de la versión.

Importante: Si va a actualizar Cognos Incentive Compensation Management,consulte las instrucciones referentes a la actualización.

2. Complete los pasos del asistente de instalación.

Instalación del servicio de WindowsEl servicio de Windows IBM Cognos Incentive Compensation Management debeestar instalado y en ejecución en el servidor para que la aplicación funcionecorrectamente.

El servicio de Windows debe instalarse en el servidor de aplicaciones. Debe tenerel servicio de Windows Cognos Incentive Compensation Management o el serviciode consola instalado y en ejecución para iniciar sesión en el cliente.

Procedimiento1. Efectúe una doble pulsación en el archivo de instalación ICM-service.exe, que

se encuentra en la carpeta de la versión.2. Seleccione la opción de instalación Predeterminado y pulse Siguiente en la

pantalla de bienvenida del instalador.

Importante: Si va a actualizar Cognos Incentive Compensation Management,consulte las instrucciones referentes a la actualización.

3. Complete los pasos del asistente de instalación.

Importante: De forma predeterminada, el tipo de inicio del servicio deWindows Cognos Incentive Compensation Management se establece en manual,lo que significa que debe iniciar manualmente el servicio cada vez que deseenabrir el cliente.


Establecimiento del inicio automático del servicio de WindowsPuede cambiar el tipo de inicio del servicio de Windows IBM Cognos IncentiveCompensation Management manual por automático.

Procedimiento1. Vaya a Panel de control > Herramientas administrativas > Servicios.2. Seleccione Servicio IBM Cognos ICM en el panel Servicios.3. Pulse el botón derecho del ratón y seleccione Propiedades.4. Seleccione Automático como Tipo de inicio.

Archivos de configuraciónAl instalar o actualizar IBM Cognos Incentive Compensation Management, esnecesario editar los archivos de configuración.

Deben modificarse los archivos de configuración siguientes:v IBM Cognos ICM.exe.config en la estación de trabajo del administradorv IBM Cognos ICM Windows Service.exe.config en el servidor de aplicaciones

Si va a actualizar una versión existente de Cognos Incentive CompensationManagement, guarde una copia del archivo IBM Cognos ICM WindowsService.exe.config y IBM Cognos ICM.exe.config para compararlos con losarchivos de configuración actualizados. Asegúrese de que los valores de aplicacióndel nuevo archivo de configuración coincidan con los valores del archivo deconfiguración guardado de la versión anterior.

Atención: Puede convertir en comentarios las líneas del archivo de configuraciónque no desee utilizar; para ello, añada <add key="AllowMultipleInstances" value="true"/>

Para establecer el idioma predeterminado del cliente, elimine la marca decomentario del valor siguiente y edítelo:

<add key="DefaultLanguage" value="EnglishUS"/>

Archivo de configuración del servicio IBM Cognos IncentiveCompensation Management

El archivo de configuración del servicio Cognos Incentive CompensationManagement indica la manera en la que el servidor de aplicaciones se comunicarácon el servidor de bases de datos.

Capítulo 2. Instalar el servicio y el cliente de IBM Cognos Incentive Compensation Management 9

Este cambio debe realizarse en el archivo que se encuentra en el mismo directorioque el archivo IBM Cognos ICM Windows Service.exe.

Configuración de los valores del servidor de bases de datosDebe editar el bloque <databaseServers> en el archivo de configuración delservicio de Windows IBM Cognos Incentive Compensation Management para quese corresponda con el servidor de bases de datos.

De forma predeterminada, el archivo está configurado para una conexión a unabase de datos Microsoft SQL Server 2008.

Procedimiento1. Abra el archivo IBM Cognos ICM Windows Service.exe.config.2. En la sección databaseServers, realice las tareas siguientes:

a. En name, modifique el nombre del servidor de bases de datos.Puede ser un nombre arbitrario, como Superservidor, y está pensado paraidentificar y distinguir el servidor de bases de datos. Si la base de datos esuna instancia con nombre de Microsoft SQL Server 2000 o si utiliza unabase de datos de Microsoft SQL Server 2005, el valor del campo DB Serverdebe tener el formato siguiente: SERVER_NAME\INSTANCE_NAME.

b. Modifique User.Es el mismo que el usuario de la base de datos. En el caso de MicrosoftSQL Server, Cognos Incentive Compensation Management requiere laautenticación de SQL o la autenticación de Windows para conectarse. Por lotanto, debe conectarse con un usuario de base de datos local. Si utiliza laautenticación de Windows, tanto el usuario como la contraseña debenquedar en blanco.

c. Escriba un valor para Password.Esta es la contraseña que corresponde al usuario de la base de datos.

d. Modifique Address.Esta dirección señala la ubicación de la base de datos. La dirección debetener el formato siguiente: SERVER_NAME\INSTANCE_NAME. Si SQL Server noutiliza el puerto predeterminado 1433, debe añadir el número de puerto alcampo de dirección del servidor (por ejemplo, SERVER_NAME\INSTANCE_NAME,PORT_NUMBER).

e. Modifique el valor de Type de la base de datos.f. Modifique DiskPath.

Esta es la ubicación en la que se crean y se almacenan las bases de datos.g. Modifique LogPath.

Esta es la ubicación en la que se crea y se almacena el archivo de registro.h. Modifique TimeoutSeconds.

Es el número de segundos que transcurre antes de que se agote el tiempode espera. El tiempo de espera de base de datos predeterminado es de 90segundos. Es el tiempo mínimo que los clientes tienen que esperar antes deque Cognos avise de que se ha producido un problema con la red o con elservidor. En el caso de los modelos con tiempos de cálculo muyprolongado, este tiempo se pueden aumentar para evitar que se agote eltiempo de espera de base de datos durante el cálculo.


Configuración del acceso a varias bases de datosSi dispone de varios servidores de bases de datos, el archivo IBM Cognos ICMWindows Service.exe.config permite configurar varias secciones de base dedatos.

Esto permite acceder a modelos SQL Unicode y no Unicode con un único servicio.De forma predeterminada, solo existe una sección en el archivo de configuración,pero se pueden añadir otras. Todos los modelos contenidos en cada servidor debases de datos configurado en el archivo de configuración del servicio estánaccesibles en la pantalla de inicio de sesión.

Procedimiento1. Abra el archivo de configuración del servicio de Windows Cognos Incentive

Compensation Management.2. Rellene una sección <databaseServer> para cada servidor.

Atención: Cognos Incentive Compensation Management no se puede ejecutarsin un servicio. No se puede especificar información de base de datos en elarchivo IBM Cognos ICM.exe.config para omitir el servicio y acceder a la basede datos directamente.En el ejemplo siguiente se muestra una configuración para un modelo deMicrosoft SQL Server no Unicode y un modelo de Microsoft SQL ServerUnicode que se ejecutan en el mismo servicio de Windows Cognos IncentiveCompensation Management.<databaseServers><databaseServer Name="NonUnicodeModel"

Address="(local)"Type="SQLServer2008"User="sa"Password=""DiskPath="D:\"LogPath="D:\"TimeoutSeconds="90">

</databaseServer>

<databaseServer Name="UnicodeModel"Address="(local)"Type="SQLServer2008unicode"User="sa"Password=""DiskPath="D:\"LogPath="D:\"TimeoutSeconds="90">

</databaseServer></databaseServers>

Configuración de los valores del servicio de WindowsDespués de configurar los valores del servidor de bases de datos, puede modificardiferentes secciones del archivo de configuración del servicio de Windows IBMCognos Incentive Compensation Management para adaptarlo a sus requisitos deservicio de Windows Cognos Incentive Compensation Management.

Procedimiento1. Modifique los valores ServiceAddress y port de modo que indiquen el nombre

del servidor y el puerto donde se encuentra y se ejecuta el servicio de CognosIncentive Compensation Management Windows Service; por ejemplo,localhost:13105.


2. Modifique el valor SecurityMode.Esto determina la manera en la que se cifra lacomunicación entre el cliente y el servicio de Windows. Están disponibles losvalores siguientes:

Modo de seguridad de la capa de transporte (TLS)Los clientes no se autentican con la infraestructura de comunicacionesde Windows. El servidor debe proporcionar un certificado de confianzapara la autenticación.

modo de seguridad de WindowsLos clientes y los servidores se autentican a través de Kerberos con elcontrolador de dominio como tercero de confianza. No se requierencertificados.

Modo sin protecciónToda la seguridad está inhabilitada.

Atención: Deben configurarse los valores de seguridad tanto del servicio deCognos Incentive Compensation Management Windows Service (IBM CognosICM Windows service.exe.config) como del cliente de Cognos IncentiveCompensation Management (IBM Cognos ICM.exe.config) para ejecutarlos enel mismo modo de seguridad. Ambos archivos se actualizan como corresponda.

3. Si utiliza el modo TLS, cambie el valor de ServiceCertificateName por elnombre de sujeto de un certificado almacenado en el almacén de certificadospersonales de Windows que se utilizará para la autenticación en el servicio deWindows Cognos Incentive Compensation Management.

4. Si utiliza el servicio Cognos Incentive Compensation Management API,modifique APIAddress y value de modo que indiquen el nombre del servidor yel puerto donde se encuentra y se ejecuta el servicio Cognos IncentiveCompensation Management API; por ejemplo, localhost:13115.

5. Si utiliza certificados con el servicio IBM Cognos ICM API, cambieAPISecureAddress y value por el nombre del servidor y el puerto donde seencuentra el servicio Cognos Incentive Compensation Management API, que seejecuta de forma segura y que requiere autenticación por certificado; porejemplo, MobileAPI:13125.

6. Si utiliza certificados con el servicio Cognos Incentive CompensationManagement API, cambie APICertificateName por el nombre del sujeto de uncertificado (CN) almacenado en el almacén de certificados personales deWindows que se utiliza para la autenticación en el servicio API.

Cambio de la comunicación del servicio de Windows por HTTP oHTTPSEl método de comunicación entre el servicio de Windows y el cliente de IBMCognos Incentive Compensation Management se puede cambiar por HTTP oHTTPS; para ello, edite los valores del archivo de configuración del servicio deWindows y del archivo de configuración del cliente.

De forma predeterminada, se utiliza la comunicación TCP.

Procedimiento1. En el archivo de configuración del servicio de Windows Cognos Incentive

Compensation Management, quite las marcas de comentario de la sección HTTPCommunication mode y añada marcas de comentario a la sección TCPCommunication mode.

2. Para utilizar la comunicación HTTP, cambie el valor de SecurityMode por None.3. Para utilizar la comunicación HTTPS, cambie el valor de SecurityMode por TLS.


a. Cambie los valores HttpsDefaultUsername y HttpsDefaultPassword por elnombre de usuario y la contraseña utilizados para autenticar el entorno y labase de datos de Cognos Incentive Compensation Management.

4. Cambie los valores de CommunicationMode y SecurityMode del archivo deconfiguración del cliente de Cognos Incentive Compensation Management porlos mismos valores que los del archivo de configuración del servicio deWindows.a. Si utiliza la comunicación HTTPS, cambie los valores de

HttpsDefaultUsername y HttpsDefaultPassword del archivo de configuracióndel cliente por los mismos valores que los del archivo de configuración delservicio de Windows.

Atención: Es necesario configurar los valores de seguridad tanto del servicioWindows de Cognos Incentive Compensation Management (IBM Cognos ICMWindows Service.exe.config) como del cliente (IBM Cognos ICM.exe.config)para ejecutarlos en el mismo modo de seguridad. Ambos archivos se actualizancomo corresponda.

Configuración de los valores de IBM Cognos IncentiveCompensation ManagementDespués de configurar el acceso a la base de datos, puede configurar los valores dePlanificador y Gestor de tareas en el archivo de configuración del servicio deWindows Cognos Incentive Compensation Management.

Procedimiento1. En la sección de IBM Cognos ICM, edite los valores de SchedulerUser y

SchedulerPassword para que coincidan con el ID de usuario y la contraseña delusuario al que se le ha asignado el rol Planificador en la ventana Gestionarusuarios del cliente de Cognos Incentive Compensation Management.Si SchedulerUser y SchedulerPassword no se actualizan aquí después decambiarlos en el cliente, los procesos planificados no se ejecutarán.Atención: Para ejecutar Planificador, el servicio de Windows Cognos Incentivedebe ejecutarse como servicio de Windows. Asegúrese de que Planificador y elservicio de Windows API de Cognos Incentive Compensation Management sehayan iniciado antes de planificar un proceso.

2. Puede modificar el valor de SchedulerLogPath para actualizar la ubicación delregistro de Planificador.De forma predeterminada, este registro se encuentra en el directorio Service.Debe actualizarse SchedulerLogPath si el servicio de Windows no está instaladoen el directorio predeterminado.

3. Puede modificar el valor de TaskManagerLogPath para actualizar la ubicacióndel registro de Gestor de tareas.De forma predeterminada, este registro se encuentra en el directorio Service.Debe actualizarse TaskManagerLogPath si el servicio de Windows no estáinstalado en el directorio predeterminado.

4. Puede modificar el valor de AllowAnonymousModelCreation para determinar silos administradores pueden crear modelos o no.Si se establece en False, no se pueden crear nuevos modelos.

5. Puede modificar el valor de Language por el idioma que desea utilizar en losregistro del módulo Auditoría.Si Language se establece en EnglishUS, el formato de fecha será mes/día/año. SiLanguage se establece en EnglishGB, el formato de fecha será mes/día/año.


6. Puede quitar marcas de comentario de Saved Import File Directory y editarsu valor para indicar la ubicación en la que Cognos Incentive CompensationManagement buscará los archivos de origen de las importaciones de datos.Este valor tiene que estar definido para poder guardar importaciones enCognos Incentive Compensation Management y debe hacer referencia a undirectorio del mismo sistema que el del servicio de Windows.

7. Puede quitar las marcas de comentario de Saved Publisher File Directory yeditar su valor para indicar la ubicación en la que Cognos IncentiveCompensation Management colocará los archivos publicados que se hanplanificado para su publicación a través de Planificador.Este valor tiene que estar definido para poder planificar la publicación y debehacer referencia a un directorio del mismo sistema que el del servicio deWindows.

8. Puede quitar marcas de comentario de Saved Image File Directory y editar suvalor para indicar la ubicación en la que Cognos Incentive CompensationManagement buscará los archivos de imagen que se utilizarán como gráficos decabecera en la publicación de archivos PDF planificada.Este valor tiene que hacer referencia a un directorio del mismo sistema que eldel servicio de Windows.

Configuración de herramientas externasLa sección Herramientas externas determina los elementos que se pueden utilizarpara planificar y ejecutar procesos que se encuentran fuera de IBM CognosIncentive Compensation Management. Las herramientas externas que se vayan aplanificar mediante Planificador deberán residir en el directorio de herramientasexternas.

Procedimiento1. Quite las marcas de comentario y modifique la sección ExternalToolDirectory

para que señale a la ubicación en la que Cognos Incentive CompensationManagement buscará los elementos utilizados fuera de Cognos IncentiveCompensation Management.

2. Para cambiar el tiempo de ejecución máximo que Planificador asignará a laherramienta, pulse el botón Propiedades en el módulo Planificación del clientede Cognos Incentive Compensation Management.Una vez transcurrido ese tiempo, Planificador continuará con la lista deacciones por realizar.

Configuración de los valores de SSL de correo electrónicoSi el servidor está configurado para enviar mensajes de correo electrónico, laconexión con el servidor de correo electrónico se puede cifrar con SSL en IBMCognos Incentive Compensation Management.

Procedimiento1. Quite las marcas de comentario de la línea bajo Email SSL Settings.2. Establezca la entrada EnableSSLForServerEmails en True.

Configuración de los valores para dispositivos móviles de IBMCognos Incentive Compensation ManagementCognos Incentive Compensation Management se puede configurar para enviardatos a los dispositivos portátiles.


Procedimiento1. Para habilitar la configuración de dispositivos móviles en Cognos Incentive

Compensation Management, establezca el valor EnableHandheld en True y quitelas marcas de comentario de la línea.

2. Puede modificar el valor de MobileDataSynchFrequency para indicar lafrecuencia (en segundos) que los datos de un dispositivo móvil en el que seejecuta la versión móvil de Cognos Incentive Compensation Management sesincronizarán con los datos accesibles a través del servicio Cognos IncentiveCompensation Management API; por ejemplo: 3600.

Configuración de valores de correoPara utilizar el sistema de recordatorios por correo electrónico de Portal Access,deben configurarse los valores de correo en el archivo de configuración del serviciode Windows IBM Cognos Incentive Compensation Management.

El administrador del sistema puede proporcionar información acerca del servidorde correo de la compañía.

El cliente web de Cognos Incentive Compensation Management utiliza la direcciónde correo electrónico y el servidor especificados en el archivo de configuración delservicio de Windows Cognos Incentive Compensation Management para enviarmensajes de correo electrónico desde Planificador; por ejemplo, cuando falla unatarea relacionada con las publicaciones de periodos de Portal Access o cuando unadministrador fuerza la aprobación de un periodo.

El campo de origen smtp, por lo general, se establece en la dirección de correoelectrónico del administrador. Cuando se generan mensajes de correo electrónicode Portal Access, se envían desde la dirección de correo electrónico que se indica acontinuación.

Para enviar mensajes de correo electrónico desde Portal Access, debe configurarsela sección siguiente del archivo de configuración del servicio de Windows CognosIncentive Compensation Management:<system.net><mailSettings><smtp from="[email protected]"><network host="mail.softco.com" port="25" userName="username" password="password"defaultCredentials="true"/></smtp></mailSettings></system.net>

Establecimiento de la dirección de correo electrónico deladministrador de IBM Cognos Incentive CompensationManagementLa dirección de correo electrónico del administrador de Cognos IncentiveCompensation Management se debe configurar en el cliente.

Procedimiento1. Inicie sesión en el cliente de Cognos Incentive Compensation Management.2. Seleccione Administrador > Gestionar usuarios.3. Seleccione el administrador.4. Pulse Editar.5. Establezca la dirección de correo electrónico.


Gestión de los valores de correo electrónico de Portal AccessSi lo desea, puede enviar a los usuarios mensajes de correo electrónico referentes alas validaciones y las consultas disponibles para su revisión en el cliente web deIBM Cognos Incentive Compensation Management.

El envío de mensajes de correo electrónico a los usuarios cuando hay unavalidación pendiente se inicia desde el cliente, por lo que los valores de correoelectrónico deben configurarse en el archivo de configuración del servicio deWindows (o el servicio de consola) Cognos Incentive Compensation Management.El envío de mensajes de correo electrónico a los usuarios cuando hay una consultapendiente se inicia desde el cliente web de Cognos Incentive CompensationManagement, por lo que los valores de correo electrónico deben configurarse en elarchivo mail.properties.

Procedimiento1. Para enviar mensajes de correo electrónico a los usuarios cuando hay una

validación pendiente, debe configurar los valores de correo electrónico en elarchivo de configuración del servicio de Windows Cognos IncentiveCompensation Management.Si utiliza el servicio de consola, el valor de correo electrónico debe configurarseen el archivo de configuración del servicio de consola.

2. Para enviar mensajes de correo electrónico a los usuarios cuando hay unaconsulta pendiente, debe configurar los valores de correo electrónico en elarchivo mail.properties.El archivo mail.properties se encuentra en el directorio siguiente:...\webapps\IBM Cognos ICM\WEB-INF. Debe realizar cambios en la secciónsiguiente:mail.host=smtp.yourdomain.commail.port=25mail.username=usernamemail.passowrd=secretmail.from=varicent@yourdomain.com

3. En el cliente, seleccione Administrador > Opciones administrativas.4. En la pestaña Portal Access, seleccione Enviar correo electrónico a los usuarios

cuando haya una validación pendiente, Enviar correo electrónico a losusuarios cuando haya una consulta pendiente o ambas opciones.

5. Pulse Aceptar.Atención: Debe volver a cargar el archivo ICM.war después de realizarcambios en el archivo de configuración mail.properties.

ActualizacionesLa aplicación Cognos Incentive Compensation Management se puede actualizarcon los arreglos y las mejoras más recientes.

Existen dos formas de llevar a cabo una actualización. Puede realizar unaactualización estándar para sustituir la instalación inicial o instalar un servicionuevo para que se ejecute en paralelo con la instalación inicial.

Actualizaciones estándaresUna actualización estándar sustituye la versión existente de IBM Cognos IncentiveCompensation Management por una versión nueva.


Por ejemplo, si actualiza la versión 7 con la versión 8, la versión 7 deja de estardisponible en su sistema tras la actualización. Si actualiza un modelo anterior a laversión 8.1.0, para poder instalar la versión nueva de Cognos IncentiveCompensation Management, es necesario eliminar la versión anterior de CognosIncentive Compensation Management. Cuando actualice modelos de la versión8.1.0 o más recientes, el proceso de actualización sobrescribe la versión existente.

Todas las herramientas y todos los componentes de Cognos IncentiveCompensation Management deben tener la misma versión para que CognosIncentive Compensation Management funcione correctamente. Por lo tanto, esnecesario eliminar incluso las herramientas opcionales, como el complemento deCognos Incentive Compensation Management para Microsoft Excel y la interfaz delínea de comandos (CLI) de Cognos Incentive Compensation Management, ysustituirlas por la versión más reciente.

Preparación de la actualizaciónAntes de actualizar la instalación de IBM Cognos Incentive CompensationManagement, hay algunos pasos que debe seguir para asegurarse de que laactualización sea correcta.

Realice una copia de seguridad de los modelos de Cognos Incentive CompensationManagement existentes antes de actualizar. Guarde copias de los archivos deconfiguración antes de la actualización para que los valores de base de datos yentorno se puedan comparar con los valores de los archivos de configuración en laversión actualizada. Al actualizar, los valores del archivo de configuración delservicio de Windows Cognos Incentive Compensation Management y el archivo deconfiguración de Cognos Incentive Compensation Management deberánactualizarse manualmente.

Importante: Si va a actualizar un modelo que contiene esquemas en estrellacreados con cálculos, obtendrá un error al intentar actualizar el modelo. A partir dela versión 8.0.4, los esquemas en estrella deben crearse con almacenes de datos.Antes de actualizar el modelo, debe suprimir todos los esquemas en estrellacreados con cálculos y volverlos a crear con almacenes de datos.

Procedimiento1. Haga una copia de seguridad de los archivos de configuración. Si va a

actualizar una versión existente de Cognos Incentive CompensationManagement, deberá realizar una copia de seguridad de los archivos siguientes:v Archivo ICM.exe.config de IBM Cognosv Archivo Service.exe.config de IBM Cognos ICM Windowsv Archivo jdbc.properties

Atención: No puede utilizar los archivos de configuración existentes con unaversión actualizada.

2. Desinstale la versión actual de Cognos Incentive Compensation Management,Cognos Incentive Compensation Management Application Server, el cliente yModel Upgrader, así como otras herramientas de Cognos IncentiveCompensation Management que pueda tener instaladas, como el complementode Cognos Incentive Compensation Management para Microsoft Excel, lainterfaz de línea de comandos (CLI) de Cognos Incentive CompensationManagement y Configuration File Encrypter.Si actualiza un modelo de la versión 8.1.0 o posterior, no es necesariodesinstalar la versión actual. El proceso de actualización sobrescribe la versiónactual a partir de la versión 8.1.0.


3. Haga una copia de seguridad de los modelos de Cognos IncentiveCompensation Management.

Copia de seguridad y restauración de la base de datos deMicrosoft SQL ServerLa copia de seguridad de una base de datos duplica todos los datos contenidos enla base de datos de IBM Cognos Incentive Compensation Management y crea unacopia de la base de datos completa.

Posteriormente se puede volver a crear la base de datos por completo en un solopaso mediante el comando de restauración. La base de datos restaurada es unacopia exacta de la base de datos tal como era en el momento en que finalizó lacopia de seguridad.

Copia de seguridad de una base de datos:

Puede utilizar Administrador corporativo de Microsoft SQL Server para hacer lacopia de seguridad de una base de datos de IBM Cognos Incentive CompensationManagement.

Procedimiento

1. En Administrador corporativo de Microsoft SQL Server, seleccione Copia deseguridad de la base de datos en el menú Herramientas.

2. Seleccione una de las opciones siguientes en Tipo de copia de seguridad:

Copia de seguridad completaHace una copia de seguridad completa de la base de datos.Prácticamente siempre tendrá que iniciar la estrategia de copia deseguridad con una copia de seguridad completa de la base de datos.

Copia de seguridad diferencialAlmacena todos los cambios que se han producido en la base de datosdesde la última copia de seguridad completa.

3. Puede modificar el destino del archivo de copia de seguridad.De forma predeterminada, el archivo de copia de seguridad se almacena en laubicación siguiente: C:\Archivos de programa\Microsoft SQLServer\MSSQL\BACKUP\.

Consejo: La base de datos puede permanecer en línea y ser accesible para losusuarios mientras se lleva a cabo la copia de seguridad.

Restauración de la copia de seguridad de una base de datos:

En el archivo de copia de seguridad, Microsoft SQL Server almacena los nombres ylas ubicaciones de los archivos que se utilizan en la base de datos de IBM CognosIncentive Compensation Management. Tras restaurar la base de datos, SQL Servervuelve a crear todos los archivos necesarios y la base de datos se restaura tal comoera en el momento en el que terminó la copia de seguridad.

Procedimiento

1. Seleccione Restaurar base de datos en el menú Herramientas.2. El campo Restaurar como base de datos corresponde al nombre de la base de

datos que acaba de restaurar.No tiene por qué ser idéntico al nombre de la base de datos original (de la quese ha hecho copia de seguridad).


3. Defina los parámetros de restauración; para ello, seleccione el nombre de labase de datos original y la copia de seguridad almacenada que desea restaurar.

Uso de la copia de seguridad y la restauración para transferir bases de datos deun servidor a otro:

Puede restaurar una copia de seguridad de una base de datos de IBM CognosIncentive Compensation Management en un nuevo servidor si crea una copia deseguridad de la base de datos y la guarda en una ubicación que sea accesibledesde el servidor en el que se va a realizar la restauración.

Procedimiento

1. En el servidor al que desea transferir la base de datos, abra Administradorcorporativo.

2. En el menú Herramientas, seleccione Restaurar base de datos.3. Escriba el nombre con el que desea restaurar la base de datos en el campo

Restaurar como base de datos.4. Seleccione la opción Desde dispositivo.5. Seleccione Nombre de archivo y escriba la ubicación del archivo de copia de

seguridad.

Actualización de la aplicaciónUna vez que haya realizado los pasos de preparación de la actualización, ya estarálisto para instalar la nueva versión de Cognos Incentive CompensationManagement.

Procedimiento1. Instale el cliente de Cognos Incentive Compensation Management.

Para obtener más información, consulte: “Instalación del cliente” en la página 7.2. Instale el servicio de Windows Cognos Incentive Compensation Management;

para ello, seleccione la opción Mantener o actualizar una instancia existente.Para obtener más información, consulte: “Instalación del servicio de Windows”en la página 7.

3. Edite los archivos IBM Cognos ICM.exe.config e IBM Cognos ICM WindowsService.exe.config para que coincidan con las versiones guardadas delmodelo anterior.Para obtener más información, consulte: “Archivos de configuración” en lapágina 8.

4. Instale las herramientas de Cognos Incentive Compensation Managementadicionales que desee, como la interfaz de línea de comandos (CLI).

Actualizaciones de modelosUtilice la herramienta IBM Cognos Incentive Compensation Management ModelUpgrader para actualizar los modelos de base de datos de Cognos IncentiveCompensation Management para que sean compatibles con la versión actualizada.

Una vez que haya finalizado la actualización de una versión existente de CognosIncentive Compensation Management, también deberá actualizar los modelos a lanueva versión.

Las opciones de actualización le permiten controlar el proceso de actualización delos modelos de Microsoft SQL Server y pueden reducir el tamaño de los archivosde registro de transacciones en Microsoft SQL Server.


Atención: Si está realizando una instalación nueva de Cognos IncentiveCompensation Management, no es necesario actualizar los modelos. Los modelossolamente deben actualizarse cuando se actualiza Cognos Incentive CompensationManagement.

Instalación de Model UpgraderLa herramienta Model Upgrader es necesaria para actualizar el modelo de IBMCognos Incentive Compensation Management para que sea compatible con laaplicación actualizada.

Atención: Si tiene instalada una versión anterior de Model Upgrader, asegúresede que la ha eliminado antes de instalar la versión nueva. Si actualiza un modelode la versión 8.1.0 o posterior, no es necesario desinstalar la versión actual. Elproceso de actualización sobrescribe la versión actual a partir de la versión 8.1.0.

Procedimiento1. Efectúe una doble pulsación en el archivo de instalación ICM-

modelupgrader.exe que se encuentra en la carpeta de la versión.2. Complete los pasos del asistente de instalación.

Ejecución de Model UpgraderUna vez que se haya instalado Model Upgrader, debe ejecutar la herramientaModel Upgrader para actualizar el modelo actual para que sea compatible con lanueva versión de IBM Cognos Incentive Compensation Management.

Procedimiento1. En la ubicación que se ha especificado durante la instalación de la herramienta

Model Upgrader, efectúe una doble pulsación en el archivo modelupgrader.exe.Se abrirá la herramienta Model Upgrader.

2. Escriba el nombre de servidor.Este es el nombre del servidor de bases de datos que contiene el modelo. Si labase de datos es una instancia con nombre de Microsoft SQL Server 2000 o siutiliza una base de datos de Microsoft SQL Server 2005, el valor del campoDBServer debe tener el formato siguiente: SERVER_NAME\INSTANCE_NAME.

3. Seleccione el tipo de base de datos en el menú desplegable.Este es el tipo de base de datos al que se conectará, como Microsoft SQL Server2000 o 2005.

4. Escriba el nombre de la base de datos.Este es el nombre del servidor de bases de datos que contiene el modelo deCognos Incentive Compensation Management.a. Si no sabe el nombre de la base de datos, pulse Examinar.b. Seleccione un modelo.

Consejo: La versión de la base de datos aparece entre paréntesis junto acada modelo.

5. Escriba un valor en el campo de tiempo de espera de la base de datos.El valor predeterminado es 90 segundos; probablemente no sea necesariocambiarlo. Sin embargo, debe cambiarlo aquí si ha aumentado el tiempo deespera predeterminado en el archivo de configuración del servicio de WindowsCognos Incentive Compensation Management.

6. Escriba el ID de usuario y la contraseña.


Esto hace referencia al usuario de base de datos con permisos de alteración debase de datos. No es la misma contraseña que la del administrador de CognosIncentive Compensation Management.

7. Pulse Actualizar.

Opciones de Model UpgraderSi selecciona el botón Opciones al ejecutar la herramienta IBM Cognos IncentiveCompensation Management Model Upgrader, podrá establecer la protección frentea errores.

Están disponibles las opciones de protección frente a errores siguientes:

NingunaEsta opción utiliza la cantidad mínima de recursos pero no ofrece ningunaprotección para el modelo en caso de que se produzca un error. Si seproduce un error durante el proceso de actualización, el modelo poractualizar no se podrá recuperar y deberá restaurarse desde una copia deseguridad.

Atención: Debe crearse una copia de seguridad antes de utilizar estaopción.

ParcialSi la actualización de un modelo falla y la opción de protección parcial estáseleccionada, es posible que el error se pueda resolver sin restaurar lacopia de seguridad original del modelo. Además, las actualizacionesfallidas siempre se pueden reiniciar con seguridad al utilizar esta opción.Esta opción utiliza menos recursos que la opción Completa, pero más quela opción Ninguna.

Atención: Debe crearse una copia de seguridad antes de utilizar estaopción.

Versión importanteSi la actualización falla, esta opción retrotraerá la base de datos a la últimaversión correcta de la base de datos que corresponda a una versiónimportante. Los usuarios podrán instalar después la versión importante deCognos Incentive Compensation Management que corresponda y realizarlos cambios necesarios en el modelo para que se pueda actualizar. Despuésde realizar los cambios, Model Upgrader se puede ejecutar de nuevo deforma segura.

Atención: Realice una copia de seguridad de los modelos antes deseleccionar esta opción.

CompletoEl nivel de protección completo garantiza que el modelo se puede utilizarindependientemente de los errores que se encuentren en el proceso deactualización. Si el modelo no se puede actualizar por completo a laversión de la base de datos que elija, el modelo no se modifica. Esta es laopción más segura, pero también es la que utiliza más recursos.

Versión de la base de datos de destinoLa versión de la base de datos de destino en la herramienta IBM Cognos IncentiveCompensation Management Model Upgrader es un valor entero que indica laversión específica de la base de datos a la que se va a actualizar.


La versión de la base de datos es distinta de la versión del software. Si bien hayuna versión de base de datos en concreto para cada versión de software, no hayuna versión de software para cada versión de base de datos.

Puede optar por seleccionar una versión de base de datos para controlar el nivel deprotección frente a errores en diferentes puntos durante la actualización. Laselección de una versión de destino también permite realizar la actualización enincrementos más pequeños para evitar quedarse sin espacio de disco.

Ejecución de instancias simultáneas de IBM Cognos IncentiveCompensation Management

Si es necesario, puede mantener las versiones anteriores de Cognos IncentiveCompensation Management en ejecución junto con una versión nueva.

Puede tener varios servicios de Windows Cognos Incentive CompensationManagement (incluidos planificadores) instalados en un solo sistema. Al utilizaresta opción de actualización, no es necesario desinstalar los servicios instaladosanteriormente. Debe detener el servicio de Windows, el servicio de planificador yla API antes de instalar más servicios de Windows.

Procedimiento1. Efectúe una doble pulsación en el archivo ICM-service.exe, que se encuentra

en la carpeta de la versión.a. Seleccione la opción Instalar una instancia nueva.b. Seleccione la opción Instancia con nombre y especifique un nombre de

instancia para el nuevo servicio; por ejemplo, Service2.Atención: Los nombres de instancias deben ser exclusivos para todos losservicios de Windows, independientemente del número de versión.

c. Especifique un directorio para guardar el nuevo servicio de Windows.El nombre de directorio debe ser exclusivo para cada instalación del serviciode Windows. Por ejemplo, escriba C:\Archivos de programa\IBM CognosICM\Service2.

d. Pulse Instalar.

Importante: Si la instalación no se realiza correctamente, desinstale yvuelva a instalar el servicio de Windows.

2. Repita los pasos anteriores para cada servicio de Windows que desee instalar.3. Vaya a Panel de control > Herramientas administrativas > Servicios.4. Desplácese hacia abajo en la ventana Servicios y busque ICM Windows

Service.El número de servicios de Windows IBM Cognos ICM, IBM Cognos ICM API yScheduler debe ser el mismo que el número de servicios instalados en los pasosanteriores.

5. Pulse con el botón derecho del ratón en el servicio de Windows, por ejemplo, elservicio de Windows IBM Cognos ICM (SERVICE2), y seleccione Propiedades.

6. Asegúrese de que la ruta de archivo del campo Ruta al ejecutable es correcta yque señala a la nueva instalación del servicio de Windows.

7. Repita los pasos 5 y 6 para el resto de los servicios de Windows que hainstalado.


Edición de los archivos de configuración del servicio deWindowsDebe realizar algunos cambios en los archivos de configuración del servicio deWindows Cognos Incentive Compensation Management para indicar cómo secomunica el servidor de aplicaciones con el servidor de bases de datos. Tambiéndeberá añadir instancias del servicio y configurar cada servicio para que se ejecuteen un puerto distinto.

Procedimiento1. Abra la carpeta del nuevo servicio.

Por ejemplo, abra la carpeta Service 2.2. Abra el archivo de configuración IBM Cognos ICM Windows Service.exe y edite

la sección databaseServer.3. Edite la línea <add key="SeviceAddress" value="localhost:13105"/> para que

el servicio utilice un puerto diferente del que utilizan los demás servicios.Por ejemplo, cambie la línea por <add key="SeviceAddress"value="localhost:13106">.

4. En la sección del nombre de la instancia del servicio, asegúrese de que la línea<add key="ServiceInstanceName" value="myinstance"/> no tenga marcas decomentario y que el valor del nombre de la instancia del servicio se hayaactualizado; por ejemplo, <add key="ServiceInstanceName" value="Service2"/>

5. Realice todos los cambios que sean necesarios y, a continuación, guarde y cierreel archivo de configuración.

6. Repita los pasos del 1 al 5 con el resto de las carpetas de servicio que hayacreado.

7. Inicie los servicios de Windows IBM Cognos ICM.

verificación de la instalaciónUna vez que instale o actualice IBM Cognos Incentive Compensation Management,inicie sesión en el cliente para asegurarse de que funciona correctamente.

Apertura de un modelo existenteSi ha actualizado el modelo de IBM Cognos Incentive Compensation Management,inicie sesión en el cliente para asegurarse de que la actualización se ha realizadocorrectamente.

Procedimiento1. Abra el cliente.2. Seleccione Nombre del modelo en el menú desplegable.3. Rellene ID de usuario y Contraseña con sus datos.4. Pulse Iniciar sesión.

Creación de un nuevo modeloAbra el cliente de IBM Cognos Incentive Compensation Management y cree unmodelo para asegurarse de que el cliente se ha instalado correctamente.

Procedimiento1. Abra el cliente.2. Pulse Opciones para cambiar el idioma del cliente y establecer el formato de

fecha.


Seleccione EnglishGB para que el formato de fecha sea día/mes/año oseleccione EnglishUS para que el formato de fecha sea mes/día/año.

3. Pulse Nuevo modelo.4. Dé nombre al modelo.

Cognos Incentive Compensation Management elimina todos los espacios y lossignos de puntuación del nombre del modelo y lo utiliza como nombre de labase de datos en el servidor de bases de datos. El nombre del modelo se puedecambiar en cualquier momento desde Cognos Incentive CompensationManagement, pero el nombre de base de datos establecido inicialmente no sepuede cambiar.

5. Seleccione un valor en El año fiscal actual empezó:.Este es el primer día del año fiscal actual. Cognos Incentive CompensationManagement utiliza esta fecha y el número de periodos de nómina para crearun calendario predeterminado para este nuevo modelo. El calendariopredeterminado se puede modificar y ajustar desde el cliente, o bien se puedesustituir por completo si se comete un error.

6. Seleccione un valor en Número de periodos de nómina.Este es el número de veces por año que la organización paga a los empleados,que puede ser cada semana (52), cada dos semanas (26), dos veces al mes (24) ouna vez al mes (12). El número de periodos de pago se utiliza para crear elcalendario predeterminado, que se usa para establecer las planificaciones depago para las ganancias calculadas. El calendario predeterminado se puedemodificar o sustituir por completo una vez que se haya creado el nuevomodelo.

7. Seleccione la moneda.Debe añadirse una moneda si se va a utilizar para la recopilación o el pago. Sepuede seleccionar más de una moneda. Si necesita una moneda que no está enla lista de selección, pulse Otra monedas para añadir monedas adicionales.Atención: Se pueden añadir monedas sin utilizar el Asistente de nuevomodelo, por lo que la lista se puede ampliar más adelante.

8. Pulse Finalizar.

Integración de LDAP con el clientePuede configurar el cliente de IBM Cognos Incentive Compensation Managementpara que los usuarios puedan iniciar sesión con la autenticación LDAP.

Los usuarios y los grupos LDAP deben configurarse en el archivo de configuracióndel servicio de Windows Cognos Incentive Compensation Management y en elcliente. Los usuarios solamente pueden iniciar sesión en el cliente si se les hacorrelacionado con un rol de Cognos Incentive Compensation Management o sison miembros de un grupo LDAP que se ha correlacionado con un rol de CognosIncentive Compensation Management. Los usuarios LDAP deben tener asignadoun rol de usuario, estar configurados en los valores de LDAP del archivo deconfiguración del servicio de Windows Cognos Incentive CompensationManagement y estar añadidos en la pestaña LDAP del cliente. A continuación, losusuarios podrán iniciar sesión en el cliente con sus ID de usuario y contraseñas deLDAP. Los grupos LDAP deben tener asignado un rol de Cognos IncentiveCompensation Management, estar configurados en los valores de LDAP delarchivo de configuración del servicio de Windows Cognos Incentive CompensationManagement y estar añadidos en la pestaña LDAP del cliente. A continuación, losusuarios LDAP que formen parte de ese grupo LDAP pueden iniciar sesión en elcliente con su SAMAccountName y su contraseña de LDAP.


Cada empleado o grupo en LDAP tiene un nombre distinguido (DN) que leidentifica de forma exclusiva. El nombre distinguido se compone de pares deatributo y valor (por ejemplo, CN=Quality Assurance, OU=Internal, OU=Groups,OU=HQ, DC=hq, DC=IBM Cognos ICM, DC=com). El primer atributo de un nombredistinguido es el nombre común (CN). Cada usuario o grupo tiene un CN que leidentifica (por ejemplo, CN=Dan Huddle o CN=Quality Assurance). Los usuariostambién tiene los atributos SAMAccountName, que actúa como nombre de usuario(por ejemplo, SAMAccountName=dhuddle) y memberOf, que describe los grupos a losque el empleado pertenece (por ejemplo, memberOf=All,All Development,QualityAssurance).

Se aplican las reglas siguientes a los usuarios LDAP para Cognos IncentiveCompensation Management:v Los usuarios LDAP no pueden iniciar sesión si hay un cambio de contraseña

pendiente en la cuenta.v Los usuarios LDAP no pueden iniciar sesión si su cuenta está inhabilitada.v Los usuarios LDAP no pueden iniciar sesión dos veces en el mismo modelo.v Si hay un usuario de Cognos Incentive Compensation Management cuyo

nombre de usuario coincide con el usuario LDAP, el usuario de CognosIncentive Compensation Management tiene prioridad (por ejemplo, CognosIncentive Compensation Management pasará por alto la existencia del usuarioLDAP y se conservarán las reglas que se aplican al usuario de Cognos IncentiveCompensation Management).

v Si el usuario LDAP está correlacionado con diferentes roles de Cognos IncentiveCompensation Management, se otorgan la suma de los permisos.

v El rol de administrador puede cambiarse de nombre y correlacionarse concualquier grupo LDAP y cualquier usuario de este grupo que tenga permisos deadministrador.

v Si un usuario LDAP ha iniciado sesión en el cliente, el elemento de menúCambiar contraseña está inhabilitado.

v Los usuarios LDAP pueden escribir mensajes web y cargar documentos web.v Un usuario LDAP puede ser el planificador (se aplican las mismas reglas que

para un usuario planificador).v Un usuario LDAP puede iniciar sesión para realizar migraciones.

Configuración del archivo de configuración del servicio deWindows para la autenticación LDAP

Debe realizar algunos cambios en el archivo de configuración del servicio deWindows IBM Cognos Incentive Compensation Management para que los usuariospuedan iniciar sesión en el cliente con la autenticación LDAP.

Procedimiento1. En el archivo IBM Cognos ICM Windows Service.exe.config, quite las marcas de

comentario de la sección ldapSettings.2. Edite el valor de ProviderUrl para que indique la dirección del servidor LDAP

en la que se debe buscar.3. Edite el valor ManagerDn.

Se trata de la cuenta que se debe utilizar para realizar la búsqueda en el árbolLDAP.

4. Edite el valor ManagerPassword.Esta es la contraseña de la cuenta ManagerDn.


5. Edite el valor UserSearchFilter.Este es el atributo LDAP que un usuario LDAP debe especificar como ID deusuario en la ventana de inicio de sesión del cliente de Cognos IncentiveCompensation Management.

6. Edite el valor UserGroupAttribute.Este es el atributo LDAP que se debe utilizar al intentar establecer lapertenencia a grupos LDAP.

7. Asigne a UseKerberos el valor true para obtener y utilizar la señal Kerberospara la autenticación.Asigne a UseKerberos el valor False para utilizar LDAP para la autenticación.Si el campo UseKerberos tiene el valor true, los campos ManagerDn yManagerPassword se pasan por alto. En su lugar, se utiliza el usuario con el quese ejecuta el servicio de Windows Cognos Incentive CompensationManagement para realizar la búsqueda del árbol LDAP.Atención: Si la red está configurada con IWA y desea autenticarse como unusuario distinto al que ha utilizado para iniciar la sesión en la red, debe utilizarNTLM, no Kerberos. Kerberos solamente autenticará el usuario que ha iniciadola sesión.

8. Asigne a UseSSL el valor True para utilizar SSL (LDAPS) para comunicarse conel servidor LDAP. Asigne a UseSSL el valor False si no desea utilizar SSL(LDAPS) para comunicarse con el servidor LDAP.Atención: Si se utiliza la autenticación LDAP en un entorno multidominio, nose puede asignar el valor True al campo UseKerberos y al campo UseSSLsimultáneamente. Se puede utilizar o bien SSL o bien Kerberos solamente (oestablecer ambos en False); sin embargo, el establecimiento de ambos camposen True no funcionará en un entorno multidominio.

Cómo otorgar acceso al cliente a los usuarios LDAP o losgrupos LDAP

Los usuarios LDAP o los grupos LDAP deben añadirse y se les debe otorgar accesoal cliente de IBM Cognos Incentive Compensation Management. El usuario o elgrupo LDAP debe estar asociado con un rol de usuario de Cognos IncentiveCompensation Management.

Procedimiento1. En el cliente, vaya a Administrador > Gestionar usuarios.2. Pulse Añadir para añadir un usuario o grupo LDAP.3. Seleccione Usuario LDAP o Grupo LDAP en el menú desplegable Tipo.4. Si ha seleccionado Usuario LDAP, escriba el ID de usuario que coincida con el

valor del atributo LDAP especificado en el perfil de LDAP del usuario en elarchivo de configuración del servicio de Windows (el atributo predeterminadoes SAMAccountName).a. Seleccione un valor en el menú desplegable Rol.

Este es el rol de usuario de Cognos Incentive Compensation Managementque está asociado con el usuario.

5. Si ha seleccionado Grupo LDAP, escriba un valor en CN del grupo quecoincida con el valor de UserGroupAttribute en el archivo de configuración delservicio de Windows Cognos Incentive Compensation Management.

6. Seleccione un valor en el menú desplegable Rol.Este es el rol de usuario de Cognos Incentive Compensation Management queestá asociado con el grupo.


7. Pulse Guardar.

optimización del rendimiento del nivel de datosLa característica de optimización del rendimiento del nivel de datos de IBMCognos Incentive Compensation Management puede mejorar el rendimiento de loscálculos, especialmente en modelos que tienen un número elevado de cálculos querealizan operaciones de multiplicación y división.

Esta característica permite que la base de datos procese una parte más grande delos cálculos y reduce la necesidad de transferencias entre la base de datos y elservicio de Windows Cognos Incentive Compensation Management.

Integración de CLRPara utilizar la característica de optimización del rendimiento del nivel de datos enIBM Cognos Incentive Compensation Management, la característica de integraciónCLR (Common Language Runtime) de Microsoft SQL Server debe estar habilitadapara ejecutar un script para instalar un tipo de datos definido por el usuario.

Para habilitar la integración CLR, utilice la opción clr enabled del procedimientoalmacenado sp_configure.sp_configure ’clr enabled’, 1;GORECONFIGURE;GO

Habilitación de la optimización del rendimiento del nivel dedatos en el cliente

Después de habilitar la característica de integración CLR (Common LanguageRuntime), es necesario activar la optimización del rendimiento en el cliente de IBMCognos Incentive Compensation Management.

Procedimiento1. Vaya a Administrador > Opciones administrativas.2. Pulse la pestaña Cálculo.3. Seleccione la casilla de verificación Habilitar optimización del rendimiento del

nivel de datos.



Capítulo 3. Herramientas del cliente

Cognos Incentive Compensation Management incluye varias herramientasadicionales que no son necesarias para la ejecución de la aplicación cuando seconfigura el modelo inicialmente, y que se pueden instalar posteriormente parallevar a cabo diversas funciones.

Las funciones que estas herramientas pueden realizar son: convertir el modelo,importar datos del modelo a Microsoft Excel y comunicarse con Cognos IncentiveCompensation Management mediante una interfaz de línea de comandos.

servicio de consolaLa herramienta de servicio de consola es una versión del servicio de WindowsCognos Incentive Compensation Management que se ejecuta en un indicador decomandos y utiliza la misma información de configuración que el servicio deWindows.

Se pueden ejecutar varios servicios de consola en el mismo sistema, siempre ycuando cada servicio se haya instalado en un directorio por separado y estéconfigurado para utilizar un puerto diferente.

Instalación del servicio de consolaEl servicio de consola de IBM Cognos Incentive Compensation Management sepuede utilizar para ejecutar el cliente y debe estar instalado en el servidor deaplicaciones.

Procedimiento1. Efectúe una doble pulsación en el archivo de instalación ICM-console.exe, que

se encuentra en la carpeta de la versión.2. Complete los pasos del asistente de instalación.

Edición del archivo de configuración del servicio de consolaEl archivo de configuración del servicio de consola de IBM Cognos IncentiveCompensation Management se debe editar para permitir que el servidor deaplicaciones se comunique con el servidor de bases de datos.

Procedimiento1. Edite la sección databaseServer en el archivo ConsoleService.exe.config para

que haga referencia a la base de datos correcta.2. Edite el valor de ServiceAddress para que haga referencia a un puerto que sea

diferente del de los demás servicios (<add key="ServiceAddress"value="localhost:13112"/>).

3. Edite los valores de seguridad para que coincidan con los valores de seguridaddel cliente.

Inicio del servicio de consolaDespués de editar el archivo de configuración del servicio de consola de IBMCognos Incentive Compensation Management, debe iniciar el servicio de consola.


Procedimiento1. Inicie un indicador de comandos.2. En el directorio en el que se encuentra la consola de servicios, escriba

ConsoleService.Se muestra un mensaje en el que se informa de que el servicio está enejecución.

Importante: Cognos Incentive Compensation Management no se puedeejecutar sin un servicio. No se puede especificar información de base de datosen el archivo IBM Cognos ICM.exe.config para omitir el servicio y acceder a labase de datos directamente.

cifrado del archivo de configuraciónCognos Incentive Compensation Management Configuration File Encrypter sepuede utilizar para cifrar los valores del archivo de configuración del servicio deWindows Cognos Incentive Compensation Management y el archivo deconfiguración del servicio de consola.

Puede cifrar los valores siguientes en los archivos de configuración del servicio deWindows (IBM Cognos ICM Windows Service.exe.config) y del servicio deconsola (ConsoleService.exe.config): DBPassword, DBUser, SchedulerPassword,SchedulerUser, nombre de usuario y contraseña de LDAP y nombre de usuario ycontraseña del servidor de correo. Cognos Incentive Compensation ManagementConfiguration File Encrypter cifra todos los nombres de usuarios y contraseñas enblanco.

Instalación de Configuration File EncrypterAntes de ejecutar Cognos Incentive Compensation Management Configuration FileEncrypter, en primer lugar debe instalarlo mediante el archivo de instalación.

Procedimiento1. Efectúe una doble pulsación en el archivo de instalación ICM-encrypter.exe.2. Complete los pasos del asistente de instalación.

Ejecución de Configuration File EncrypterDespués de instalar Cognos Incentive Compensation Management ConfigurationFile Encrypter, puede utilizarlo para cifrar los valores de los archivos deconfiguración del servicio de Windows y del servicio de consola.

Procedimiento1. Lance Configuration File Encrypter, que se encuentra en la carpeta de la

versión de IBM Cognos ICM.2. Pulse Examinar para buscar el archivo IBM Cognos ICM Windows

Service.exe.config o ConsoleService.exe.config que se va a cifrar.3. Pulse Cifrar.4. Pulse Salir.5. Para descifrar un archivo, repita los pasos anteriores pero seleccione Descifrar

en el paso 3.


Importante: Al cifrar un archivo, se cifrarán ambos conjuntos de nombres deusuario y contraseñas en el archivo (base de datos y planificador). No puedeelegir cifrar solamente uno de los dos.

Conversor de modelosLa herramienta Conversor de modelos permite que los modelos de CognosIncentive Compensation Management creados en Microsoft SQL 2000 o 2005 seconviertan en modelos de Microsoft SQL 2008, y que los modelos creados enMicrosoft SQL Standard Edition se conviertan a Microsoft SQL Enterprise.

La herramienta Conversor de modelos cambia el nivel de compatibilidad delmodelo de Cognos Incentive Compensation Management durante una conversión.Esto permite evitar errores de compatibilidad durante una conversión.

Instalación de la herramienta Conversor de modelosAntes de ejecutar la herramienta Conversor de modelos de IBM Cognos IncentiveCompensation Management, debe instalarla con el archivo de instalación deConversor de modelos.

Procedimiento1. Efectúe una doble pulsación en el archivo de instalación ICM-

modelconverter.exe que se encuentra en la carpeta de la versión.2. Complete los pasos del asistente de instalación.

Importante: Los modelos creados en una edición Standard de Microsoft SQL sepueden restaurar en una edición Enterprise de Microsoft SQL, pero Conversorde modelos tendrá que utilizar características de Enterprise. Los modelos de laedición Enterprise no se pueden restaurar en una versión Standard de SQL. Losmodelos creados en la edición 2000 o 2005 de SQL se pueden restaurar enMicrosoft SQL Server 2008, pero se necesita la herramienta Conversor demodelos para que las características de Microsoft SQL Server 2008 esténdisponibles en esos modelos.

Conversión de un modelo de Microsoft SQL 2000 o 2005 a2008

Un modelo de IBM Cognos Incentive Compensation Management de tipoMicrosoft SQL Server 2000 se puede convertir en un modelo de Microsoft SQLServer 2008.

Procedimiento1. Instale Microsoft SQL Server 2008.

Atención: El servicio de Windows Cognos Incentive CompensationManagement debe estar en ejecución cuando se utiliza la herramientaConversor de modelos.

2. Restaure el modelo de Microsoft SQL 2000 o 2005 en el servidor de MicrosoftSQL 2008.

3. Lance la herramienta Conversor de modelos.4. Escriba el nombre del servidor de SQL 2008 en el campo Nombre del servidor.

Puede ser un nombre arbitrario, como Superservidor, y está pensado paraidentificar y distinguir el servidor de bases de datos. Si la base de datos es unainstancia con nombre de SQL Server 2000 o si utiliza una base de datos de SQL

Capítulo 3. Herramientas del cliente 31

Server 2005, el valor del campo de servidor de bases de datos debe tener elformato siguiente: SERVER_NAME\INSTANCE_NAME.

5. En Tipo de base de datos, seleccione el valor adecuado para el modelo quedesea convertir.Si convierte un modelo Unicode, seguirá siendo Unicode después de laconversión.Atención: Puesto que ha restaurado el modelo en Microsoft SQL 2008 Server,tendrá que seleccionar Microsoft SQL Server 2008 o Microsoft SQL Server 2008Unicode incluso si el modelo original era Microsoft SQL Server 2000 o 2005.

6. Busque el modelo que desea convertir.7. Seleccione Microsoft SQL Server 2008 en el menú Convertir a.8. Escriba sus credenciales de inicio de sesión de Microsoft SQL Server.9. Pulse Convertir.

Importante: La herramienta Conversor de modelos cambia el nivel decompatibilidad de la base de datos si no se ha establecido correctamente alejecutar una conversión.

Conversión de un modelo de Microsoft SQL Standard en unmodelo de Enterprise

Un modelo de IBM Cognos Incentive Compensation Management de tipoMicrosoft SQL Standard se puede convertir en un modelo de SQL Enterprise.

Procedimiento1. Instale Microsoft SQL Server Enterprise Edition.2. Restaure el modelo de Microsoft SQL Standard Edition en el servidor de SQL

Enterprise.3. Lance la herramienta Conversor de modelos.4. Escriba el nombre del servidor de Microsoft SQL Enterprise Edition en el

campo Nombre del servidor.Puede ser un nombre arbitrario, como Superservidor, y está pensado paraidentificar y distinguir el servidor de bases de datos. Si la base de datos es unainstancia con nombre de SQL Server 2000 o si utiliza una base de datos de SQLServer 2005, el valor del campo de servidor de bases de datos debe tener elformato siguiente: SERVER_NAME\INSTANCE_NAME.

5. En Tipo de base de datos, seleccione el valor adecuado para el modelo quedesea convertir.Esta es la versión de Microsoft SQL Server desde la que realiza la conversión.Si convierte un modelo Unicode, seguirá siendo Unicode después de laconversión.

6. Busque el modelo que desea convertir.7. Seleccione Microsoft SQL Server Enterprise Edition en el menú Convertir a.8. Escriba sus credenciales de inicio de sesión de Microsoft SQL Server.

Conversión de un modelo de Microsoft SQL 2005 StandardEdition en un modelo de 2008 Enterprise Edition

Puede convertir un modelo de IBM Cognos Incentive Compensation Managementde tipo Microsoft SQL 2005 Standard Edition en un modelo de tipo Microsoft SQL2008 Enterprise Edition.


Esta conversión debe realizarse en estas dos fases:

Procedimiento1. Convierta el modelo de Microsoft SQL 2005 Standard en un modelo de

Microsoft SQL 2008 Standard.2. Convierta el modelo de Microsoft SQL 2008 Standard en un modelo de

Microsoft SQL 2008 Enterprise Edition.

Utilización de la característica de optimización del tamaño deEnterprise

Puede utilizar la característica de optimización del tamaño de Enterprise de laherramienta Conversor de modelos de IBM Cognos Incentive CompensationManagement con los modelos de Microsoft SQL Enterprise Edition (tanto 2005como 2008) para reducir el tamaño de la base de datos y, potencialmente, reducir eltiempo de cálculo.

Esta característica convierte un tipo de columna de Microsoft SQL Server queutiliza más espacio (tipo decimal) en un tipo de columna de Microsoft SQL Serverque utiliza menos espacio (tipo vardecimal). El tipo de datos vardecimal es unformato de almacenamiento alternativo que se puede utilizar para reducir almínimo el espacio de disco necesario para almacenar los tipos de datos decimalesy numéricos existentes. Para ahorrar espacio de disco se pueden almacenar losdatos decimales y numéricos como columnas de longitud variable, en lugar de conun número fijo de bytes como ocurre en el almacenamiento de tipo decimal.

Procedimiento

Para utilizar el tipo de datos vardecimal en los modelos creados antes de la versión7.0, lleva a cabo los pasos siguientes:1. Actualice a Cognos Incentive Compensation Management versión 7.0 o una

versión posterior.Atención: En la versión 7.2 de Cognos Incentive Compensation Management,ninguno de los modelos de Microsoft SQL 2005 y 2008 Enterprise Edition quese creen tendrán el tipo de datos vardecimal habilitado de formapredeterminada.

2. Si el modelo se ha creado en una edición Standard de SQL, conviértalo a laedición Enterprise.

3. Con Conversor de modelos, seleccione Optimización del tamaño de Enterpriseen el menú desplegable Convertir a.

CertificadosEste apartado le guiará en el proceso de generar certificados SSL (capa de socketsseguros) digitales y configurarlos para su uso con las aplicaciones de CognosIncentive Compensation Management, incluidas Cognos Incentive CompensationManagement y la interfaz de línea de comandos (CLI) de Cognos IncentiveCompensation Management.

Software necesario para utilizar certificados digitalesPara utilizar certificados digitales con IBM Cognos Incentive CompensationManagement, en primer lugar debe instalar software adicional.

Para trabajar con certificados necesitará el software siguiente:


NET Framework redistribuibleVaya a http://msdn.microsoft.com para descargar este software.

Importante: Se necesita la versión 4.5 o una versión posterior parautilizarla con las aplicaciones Cognos Incentive CompensationManagement.

NET Framework SDK\Windows SDKVaya a http://msdn.microsoft.com para descargar este software.

Importante: .NET Framework SDK se ha reemplazado por Windows SDK.Obtenga el SDK adecuado para las versiones del sistema operativoWindows y .NET Framework que se utilicen.

Probablemente necesitará privilegios de administrador para el sistema (servidor)Windows en el que se configurarán los certificados digitales para realizarcorrectamente los pasos de configuración descritos en este documento.

Herramienta de creación de certificadosPuede generar sus propios certificados digitales para realizar pruebas o solucionarproblemas.

Atención: En un entorno de producción, utilice solamente certificados digitalesadquiridos a una entidad emisora de certificados (CA), como Thawte o VeriSign. Eluso de los certificados digitales generados con los pasos siguientes pueden poneren peligro la seguridad del entorno de producción.

La herramienta de creación de certificados (Makecert.exe) incluida en .NETFramework\Windows SDK se utiliza para generar un certificado autofirmado(raíz) predeterminado (denominado "Root Agency" o agencia raíz) y un certificadofirmado por este certificado raíz.

Ejecute el indicador de comandos de SDK instalado y escriba el comandosiguiente. Debe ejecutar CMD como administrador.

makecert -r -pe -n CN="<name of certificate>" -b 01/01/2000 -e 01/01/2036-eku 1.3.1.5.5.7.3.1 -ss my -sr localmachine -sky exchange -sp "MicrosoftRSA SChannel Cryptographic Provider" -sy 12

Conmutadores de línea de comandosExisten varias opciones de línea de comandos que se pueden utilizar para definirlos certificados digitales de IBM Cognos Incentive Compensation Management.

Puede utilizar las opciones de línea de comandos siguientes.

-r Crea un certificado autofirmado. Un certificado autofirmado es uncertificado que no está firmado por una entidad emisora de certificados.Puesto que no lo ha firmado una entidad emisora de certificados, se puedeutilizar para el cifrado necesario en SSL, pero no se puede utilizar para laautenticación de servidor.

-pe Marca la clave privada como exportable.

-n Especifica el nombre de servidor. Este nombre debe cumplir los estándaresX.500. El formato más sencillo es CN="Name", y debe especificar el nombredel servidor (no distingue entre mayúsculas y minúsculas) o la dirección IPdonde se utiliza. Por ejemplo, en el caso de un servidor que se llame"Apple", el nombre del sujeto del certificado debe ser CN="Apple".


http://msdn.microsoft.com

http://msdn.microsoft.com

-b Valor de fecha con el formato mm/dd/aaaa que especifica el inicio delperiodo de validez del certificado. El valor predeterminado es la fecha decreación del certificado.

-e Valor de fecha con el formato mm/dd/aaaa que especifica el final delperiodo de validez del certificado. Si no se establece, el valorpredeterminado es 12/31/2039 11:59:59 GMT.

-eku Especifica en el certificado una lista de identificadores de objetos (OID)para uso mejorado de claves, separados por comas. En el caso de SQLServer, se necesita un certificado SSL que sea válido para la autenticaciónde servidor con un OID de 1.3.6.1.5.5.7.3.1.

-ss Especifica el almacén de certificados en el que se guarda el certificado.Guárdelo en su almacén personal ("my store"), o en cualquier ubicación delalmacén de certificados.

-sr Especifica el almacén de certificados en el que se encuentra el certificado.La ubicación puede ser currentuser (valor predeterminado) olocalmachine. Puesto que este certificado se crea para un servicio, debecolocarse en el sistema local.

-sky Especifica el tipo de clave de certificado. En el caso del algoritmo deintercambio de clave pública RSA, aquí se requiere el intercambio. Este esel tipo de clave utilizado para cifrar y descifrar las claves de sesión.

-sp Especifica el nombre del proveedor de CryptoAPI. En el caso de loscertificados creados para SQL Server, se puede establecer en el proveedorcriptográfico Microsoft RSA SChannel.

-sy Especifica el tipo de proveedor de CryptoAPI. Si el proveedor es elproveedor criptográfico Microsoft RSA SChannel, es 12.

Utilice el comando correspondiente para generar el certificado digital; por ejemplo:makecert -n "CN="Apple" -ss "My" -sr "LocalMachine" -pe -a sha1 -skyexchange Apple.cer

El certificado digital se almacena en un archivo denominado Apple.cer en eldirectorio en el que se ha ejecutado el comando anterior. Para examinar estecertificado digital, abra el archivo (efectuando una doble pulsación en él en elExplorador de Windows) y vea los detalles.

El certificado Apple aparece debajo del certificado raíz de la agencia raíz. Estoindica que el certificado raíz de la agencia raíz se ha emitido y ha firmado elcertificado Apple, con lo que se verifica su autenticidad.

Configuración de Microsoft Management Console para utilizarcertificados digitales

Se puede utilizar Microsoft Management Console (MMC) para ver los certificadosdigitales instalados que se pueden usar con IBM Cognos Incentive CompensationManagement en el repositorio de certificados local, así como importar nuevoscertificados digitales en el repositorio de certificados local.

Procedimiento1. En el menú Inicio de Windows, pulse Ejecutar.2. Escriba mmc y pulse Aceptar.3. Pulse en Archivo > Agregar o quitar complemento.4. Pulse Agregar.


5. Seleccione Certificados y pulse Agregar.6. Seleccione Cuenta de equipo y pulse Siguiente.7. Deje la opción Equipo local seleccionada y pulse Finalizar.

Certificados raíz y de servidorDeben colocarse un certificado raíz y un certificado de servidor en los almaceneslógicos correspondientes mediante la ventana Microsoft Management Console(MMC).

Amplíe el nodo Certificados en la ventana MMC para ver los almacenes lógicos enel repositorio de certificados local.

Tendrá que importar al menos dos certificados digitales en los almacenes lógicossiguientes:v Un certificado raíz en el almacén de entidades de certificación raíz de confianza.v Un certificado de servidor firmado por el certificado raíz en el almacén

personal.

Si ha generado certificados de prueba con los pasos del apartado “Herramienta decreación de certificados” en la página 34, estos certificados digitales ya se hanimportando en los almacenes lógicos correspondientes.

Si ha adquirido certificados digitales de una entidad emisora de certificados deconfianza, estos certificados digitales deben importarse en el repositorio decertificados local. Los certificados digitales adquiridos suelen distribuirse en unúnico archivo de certificado PKCS (Public-Key Cryptography Standards) #12 (conla extensión PFX o P12) que contiene todos los certificados digitales necesarios yuna clave privada para el certificado de servidor firmado. Este archivo suele estarprotegido mediante una contraseña.

Importación de los certificados digitales necesarios contenidosen un archivo de PKCS #12Para utilizar los certificados con IBM Cognos Incentive CompensationManagement, el certificado de servidor contenido en el archivo de PKCS #12 debeimportarse en el almacén personal.

Procedimiento1. Expanda el almacén Personal.2. Seleccione el nodo Certificados hijo.3. Pulse el botón derecho del ratón y seleccione Todas las tareas > Importar.4. Pulse Siguiente.5. Pulse Examinar y localice el archivo de PKCS #12.

Cambie la selección de Archivos de tipo por Personal Information Exchange.6. Una vez que haya localizado el archivo, selecciónelo y pulse Abrir.7. Pulse Siguiente.8. Escriba la contraseña de la clave privada y pulse Siguiente.9. Deje seleccionada la opción Colocar todos los certificados en el siguiente

almacén.10. Pulse Siguiente.11. Revise los valores de importación si es necesario y pulse Finalizar.


Todos los certificados digitales contenidos en el archivo de PKCS # 12 estánahora en el almacén personal, pero solamente el certificado de servidorpertenece a este almacén. El certificado de servidor se pueden identificar comoel certificado con el nombre de servidor, por ejemplo, Apple, especificado en lacolumna Emitido para.

12. Puede efectuar una doble pulsación en este certificado para examinar losdetalles y asegurarse de que la ruta de certificación es completa y que elestado de certificado indica que el certificado es correcto.

13. Mueva el certificado raíz, que es el certificado que figura en primer lugar enla ruta de certificación (por ejemplo, agencia raíz), del almacén personal alalmacén de entidades de certificación raíz de confianza mediante unaoperación de arrastrar y soltar o cortar y pegar.

Dirección IP y puerto del servidorPara configurar certificados para su uso con IBM Cognos Incentive CompensationManagement, la dirección IP del servidor en el que están instalados ahora loscertificados digitales es necesaria para configurar correctamente el servidor con elfin de identificarse a sí mismo.

También es necesario un número de puerto no utilizado para la escucha de lasconexiones SSL iniciadas por los clientes.

Atención: Si se utiliza un nombre de host en lugar de una dirección IP, el nombrede host debe estar correlacionado con la dirección en el archivo de hosts.

Identificación de la dirección IP del servidorAl configurar certificados para su uso con IBM Cognos Incentive CompensationManagement, si no sabe la dirección IP del servidor, puede hacer ping al servidordesde la ventana de indicador de comandos para averiguarla.

Procedimiento1. Abra la ventana de indicador de comandos.2. En la ventana de indicador de comandos escriba: ping <nombre_servidor>,

siendo <nombre_servidor> el nombre del servidor; por ejemplo, Apple.3. Anote la dirección IP desde la que el comando ping responde.

Edición del archivo hostsAl configurar el uso de certificados con IBM Cognos Incentive CompensationManagement, si se utiliza un nombre de host en lugar de una dirección IP, elnombre de host debe estar correlacionado con la dirección en el archivo de hosts.

Procedimiento1. Abra el archivo hosts del directorio siguiente:

C:\Windows\System32\drivers\etc\

2. Correlacione el certificado con la dirección IP del servidor en el que se haimportado el certificado.Por ejemplo, añada el texto siguiente al archivo: 127.0.0.1 <nombre delcertificado>

3. Guarde y cierre el archivo.


Identificación de un número de puerto que no se utilice en elservidorAl configurar certificados para su uso con IBM Cognos Incentive CompensationManagement, si necesita encontrar un puerto que no se utilice en el servidor,puede escribir un comando en la ventana de indicador de comandos para localizaruno.

Procedimiento1. Abra la ventana de indicador de comandos.2. Escriba el comando siguiente en la ventana de indicador de comandos: telnet

<nombre_servidor><número_puerto>, siendo <nombre_servidor> el nombre delservidor (por ejemplo, Apple) y <número_puerto> el número de puerto que seprobará.

3. Si la conexión con el servidor no se puede abrir con el número de puerto dado,este número de puerto no se está utilizando.Anote este número de puerto.Atención: De forma predeterminada, las aplicaciones Cognos IncentiveCompensation Management utilizan los números de puerto 13105, 13115 y13125.

Enlace del certificado al puertoEl certificado SSL debe estar enlazado al puerto de la API de IBM CognosIncentive Compensation Management.

Procedimiento1. Abra Microsoft Management Console.

Para obtener más información, consulte: “Configuración de MicrosoftManagement Console para utilizar certificados digitales” en la página 35.

2. Expanda Certificados > Personal > Certificados.3. Efectúe una doble pulsación en el certificado que ha añadido.4. En la pestaña Detalles, desplácese hasta el final de la lista y pulse Huella

digital.5. Copie el valor que se muestra en la ventana.6. Pegue el valor en un editor de texto y elimine todos los espacios del valor de

huella digital.7. Vaya a Inicio > Todos los programas > Microsoft Windows SDK > CMD

Shell (ejecútelo como administrador).8. En el indicador de comandos, escriba el comando siguiente:

uuidgen

9. Copie el valor de GUID que se muestra y péguelo en un editor de texto.10. En el editor de texto, encierre entre llaves el valor de GUID y, a continuación,

cópielo para poder pegarlo en el comando que creará en el paso siguiente.Por ejemplo, escriba el texto siguiente: {ec8d236c-9a4e-9d9f-2166f1b0ca29}.

11. En el indicador de comandos, escriba el comando siguiente:Netsh http add sslcert ipport=0.0.0.0:13125 certhash=<thumbprint>appid=<GUID> clientcertnegotiation=enable

ipport Dirección IP que se ha configurado en el archivo hosts.

certhashValor de la huella digital después de quitarle los espacios.


appid Valor de GUID encerrado entre llaves.

Configuración de IBM Cognos Incentive CompensationManagement para utilizar certificados

Ahora está preparado para utilizar los certificados digitales configurados paratrabajar con Cognos Incentive Compensation Management o con la interfaz delínea de comandos (CLI) de Cognos Incentive Compensation Management.

Configuración del cliente de IBM Cognos IncentiveCompensation Management y del servicio de Windows parautilizar certificadosPuede configurar Cognos Incentive Compensation Management para que utilicecertificados digitales.

Procedimiento1. Abra el archivo de configuración del servicio IBM Cognos ICM Windows

Service.exe.config.2. Edite el valor de APISecureAddress, donde localhost es el nombre del servidor

y 13125 es el número de puerto configurado para la escucha de las conexionesSSL.

3. Edite el valor de APICertificateName, donde CommonName especifica el nombrecomún del certificado de servidor configurado, que también debe ser el nombredel certificado.En el ejemplo siguiente se muestra la configuración del servicio para que utiliceun certificado llamado MobileAPI y el número de puerto 13125.<add key="APISecureAddress" value="MobileAPI:13125"/>

<add key="APICertificateName" value="MobileAPI"/>

4. Guarde los cambios del archivo de configuración del servicio de WindowsCognos Incentive Compensation Management.

5. Abra el archivo IBM Cognos ICM Client.exe.config.6. Edite el valor de serviceAddress para que contenga el mismo nombre de

servidor y el mismo número de puertos que los especificados en el archivo IBMCognos ICM Windows Service.exe.config.

7. Guarde el archivo de configuración del cliente de Cognos IncentiveCompensation Management.

8. Detenga los servicios Cognos Incentive Compensation Management en el ordensiguiente:a. API de IBM Cognos Incentive Compensation Managementb. Planificador de IBM Cognos Incentive Compensation Managementc. Servicio de Windows IBM Cognos Incentive Compensation Management

9. Inicie los servicios Cognos Incentive Compensation Management en el ordensiguiente:a. Servicio de Windows IBM Cognos Incentive Compensation Managementb. Planificador de IBM Cognos Incentive Compensation Managementc. API de IBM Cognos Incentive Compensation Management


Interfaz de línea de comandosLa CLI de Cognos Incentive Compensation Management es una interfaz de líneade comandos que conecta con los modelos mediante el servicio de WindowsCognos Incentive Compensation Management API.

La interfaz de línea de comandos se puede utilizar para realizar diversas accionesen el modelo.

Lista de comprobación previa a la instalación de la interfaz delínea de comandos

Debe llevar a cabo algunos pasos antes de instalar la interfaz de línea de comandos(CLI).

Para que la interfaz de línea de comandos de Cognos Incentive CompensationManagement se conecte con los modelos en una base de datos configurada, enprimer lugar debe realizar los pasos siguientes:1. Inicie el servicio de Windows Cognos Incentive Compensation Management.2. Especifique valores para las claves APIAddress, APISecureAddress y

APICertificateName en el archivo IBM Cognos ICM WindowsService.exe.config.

3. Inicie el servicio de API de Cognos Incentive Compensation Management.4. Instale un certificado en el sistema en el que se ejecuta la interfaz de línea de

comandos e indique las direcciones de punto final en el archivo deconfiguración de la interfaz de línea de comandos en las que se ejecuta elservicio de API (consulte: “Herramienta de creación de certificados” en lapágina 34).

Instalación de la interfaz de línea de comandos (CLI) de IBMCognos Incentive Compensation Management

Para poder utilizar la CLI de Cognos Incentive Compensation Management, antesdebe instalar la aplicación de interfaz de línea de comandos.

Procedimiento1. Efectúe una doble pulsación en el archivo de instalación ICM-cli.exe que se

encuentra en la carpeta de la versión de IBM Cognos ICM.2. Complete los pasos del asistente de instalación.

Configuración de certificados digitales con la CLIPuede configurar la interfaz de línea de comandos (CLI) de Cognos IncentiveCompensation Management para que utilice certificados digitales.

Procedimiento1. Abra el archivo IBM Cognos ICM Windows Service.exe.config.2. Modifique el valor de APISecureAddress para que señale al servidor y al

número de puerto configurados para la escucha de las conexiones SSL; porejemplo, MobileAPI:13125.

3. Modifique el valor de APICertificateName para que especifique el nombrecomún del certificado de servidor configurado, que también debe ser elnombre del servidor.


4. Guarde los cambios del archivo de configuración del servicio de WindowsCognos Incentive Compensation Management.

5. Inicie (o reinicie) el servicio de Windows Cognos Incentive CompensationManagement para que los cambios del archivo de configuración del servicioentren en vigor.

6. Inicie (o reinicie) el servicio de API para que los cambios del archivo deconfiguración del servicio entren en vigor.

7. Abra el archivo de configuración ICM-CLI.exe.config.8. Modifique el valor de ServiceAddress, donde el nombre del servidor y el

número de puerto coincidirán con los valores especificados en el archivo IBMCognos ICM Windows Service.exe.config.

9. Guarde los cambios del archivo de configuración.10. Ejecute la interfaz de línea de comandos desde una ventana de indicador de

comandos.

Conexión a un modelo mediante la interfaz de línea decomandos

Para conectarse a un modelo de IBM Cognos Incentive Compensation Managementmediante la interfaz de línea de comandos (CLI), necesita saber el nombre delmodelo, el nombre de usuario y la contraseña (si se ha establecido alguna).

Procedimiento1. Abra la ventana de indicador de comandos.2. Vaya al directorio en el que se encuentra la CLI.

Por ejemplo, escriba cd C:\Program Files\IBM Cognos ICM\CLI.3. En la línea de de comandos, escriba lo siguiente:

IBM Cognos ICM CLI -server <nombre_servidor> -model <nombre_modelo>-user <nombre_usuario> -pass <contraseña>

Donde<nombre_servidor> es el nombre del servidor de bases de datos en el que resideel modelo tal como se ha definido en el archivo de configuración (no esnecesariamente el nombre real del servidor).<nombre_modelo> es el nombre de la base de datos que contiene el modelo deCognos Incentive Compensation Management.<nombre_usuario> es el nombre de usuario que se utiliza para iniciar sesión enel modelo.<contraseña> es la contraseña que se utiliza para iniciar sesión en el modelo.Atención: Si no se ha configurado una contraseña para el usuario, omita laparte de <contraseña>.

Comandos de la interfaz de línea de comandosEn el cliente de IBM Cognos Incentive Compensation Management se puedenejecutar diversos procesos mediante la interfaz de línea de comandos (CLI).

Actualmente están disponibles los comandos de ejecución siguientes:

calcallCalcula todos los objetos del modelo.

runproc <process>Ejecuta un proceso guardado denominado <process>.


enablewebuser "true" -payeeid <"ID de beneficiario del usuario web que sehabilitará"> -webpw <"contraseña del usuario web">

Habilite un usuario para el cliente web Cognos Incentive CompensationManagement.

enablewebuser "false" -payeeid <"ID de beneficiario del usuario web que seinhabilitará">

Inhabilite a un usuario web.

changewebuserpassword -payeeid <"ID de beneficiario del usuario web cuyacontraseña se cambiar"> -webpw<"contraseña del usuario web">

Cambie la contraseña de un usuario web.

Atención: Todos los comandos de la CLI distinguen entre mayúsculas yminúsculas.

El comando debe especificarse después de la información de conexión del modelo.

El comando siguiente establecerá la conexión con el modelo SoftCo y calcularátodos los objetos del modelo en un servidor denominado MiServidor:

IBM Cognos ICM CLI -server "MyServer" -model "SoftCo" -user admin -calcall

El comando siguiente establecerá la conexión con el modelo SoftCo, calculará todoslos objetos del modelo en un servidor y ejecutará un proceso guardado llamadoImportaciones en un servidor denominado MiServidor:

IBM Cognos ICM CLI -server "MyServer" -model "SoftCo" -user admin -passsecret -runproc Imports

El comando siguiente establecerá la conexión con el modelo SoftCo y habilitará unusuario para el cliente web de Cognos Incentive Compensation Management en elmodelo en un servidor denominado MiServidor:

IBM Cognos ICM CLI -server "MyServer" -model "SoftCo" -user admin -passsecret -enablewebuser "true" -payeeid "E1000" -webpw "1234"

El comando siguiente establecerá la conexión con el modelo SoftCo e inhabilitaráun usuario del cliente web de Cognos Incentive Compensation Management en elmodelo en un servidor denominado MiServidor:

IBM Cognos ICM CLI -server "MyServer" -model "SoftCo" -user admin -passsecret -enablewebuser "false" -payeeid "E1001"

El comando siguiente establecerá la conexión con el modelo SoftCo y cambiará lacontraseña de un usuario para el cliente web de Cognos Incentive CompensationManagement en el modelo en un servidor denominado MiServidor:

IBM Cognos ICM CLI -server "MyServer" -model "SoftCo" -user admin -passsecret -changewebuserpassword -payeeid "E1000" -webpw "4321"

Código de retorno desde la interfaz de línea de comandosPara saber cuál es el resultado de la ejecución de la interfaz de línea de comandosde IBM Cognos Incentive Compensation Management, consulte el valor que sedevuelve al llamante (ya sea el sistema operativo u otro proceso o herramienta).


Puede que la herramienta de terceros que se utilice para llamar a Cognos IncentiveCompensation Management a través de la CLI necesite saber si el proceso llamadoha finalizado correctamente o si ha fallado. Pueden devolverse los valoressiguientes:v El valor 0 (entero) indica que la ejecución ha sido correcta.v El valor -1 (entero) indica que la ejecución ha fallado.

El procedimiento para recopilar un código de retorno depende por completo delmétodo utilizado para lanzar la aplicación Cognos Incentive CompensationManagement. Es tarea del llamante de la interfaz de línea de comandos de CognosIncentive Compensation Management capturar estos valores para que estainformación se pueda utilizar para realizar más acciones.

APILa API de Cognos Incentive Compensation Management se implementaescribiendo llamadas a funciones en el programa, lo que proporciona el enlacenecesario para la ejecución.

La API permite que los módulos de Cognos Incentive Compensation Managementestén disponibles o enlazados a un programa existente para realizar las tareasnecesarias.

El propósito de este apartado sobre la API es proporcionar a las organizacionescliente que lo deseen acceso a Cognos Incentive Compensation Managementmediante programación con una opción de interoperatividad. A continuación secitan algunos casos de usos habituales:v Organizaciones cliente que desean recuperar datos calculados o estadísticos de

Cognos Incentive Compensation Management para utilizarlos en otrasaplicaciones en sentido descendente, como las aplicaciones de portal, la creaciónde informes u otros sistemas

v Organizaciones cliente que desean utilizar servicios web para lograr una mayorintegración de sus sistemas

v Organizaciones cliente que desean activar Cognos Incentive CompensationManagement mediante programación con software de gestión deaplicaciones/planificación de terceros ya existente

v Organizaciones asociadas que desean una mayor integración de su solución conCognos Incentive Compensation Management

v Organizaciones cliente o asociadas que desean habilitar la aplicación demovilidad de Cognos Incentive Compensation Management

Los escenarios anteriores implican la realización de consultas a Cognos IncentiveCompensation Management, la recuperación de datos del sistema, la actualizaciónde datos en el sistema y la adición de datos al sistema.

Por lo general, los datos pertenecen a uno de estos tipos:v Relacionados con Portal Access (por ejemplo, derechos de acceso, consultas,

aprobaciones o denegaciones)v Estadísticos (por ejemplo, transacciones, porcentajes, cuotas, importes de

remuneración, jerárquicos o datos)

Se puede acceder a toda esta información mediante la inclusión de llamadas en laAPI de Cognos Incentive Compensation Management.


Arquitectura de APIIBM Cognos Incentive Compensation Management proporciona una APIcompatible con WS-I implementada mediante la aplicación WindowsCommunication Foundation (WCF) incorporada en Microsoft .NET Framework 3.0.

WCF da soporte a los estándares de seguridad WS-* mediante enlaces ycomportamientos configurables. De este modo se garantiza que los servicios webson interoperativos al tiempo que incorporan soporte de transacciones, seguridadde extremo a extremo y fiabilidad.

TransaccionesWCF da soporte a WS-AtomicTransaction y WS-Coordination, lo quepermite las transacciones de confirmación en dos fases.

SeguridadWCF da soporte a WS-SecureConversation, WS-Security y WS-Trust, lo quehabilita la seguridad tanto en el nivel de transporte como en el nivel demensaje.

FiabilidadWCF da soporte a WS-ReliableMessaging, lo que permite unacomunicación de extremo a extremo fiable.

Cualquier aplicación compatible con WS-I debe poder interoperar con la API deCognos Incentive Compensation Management. Se han probado aplicaciones decliente basadas en Java y .NET.

Se puede escribir una extensión del servicio web personalizada para su despliegue.Para tratar este tema, póngase en contacto con un representante de ventas deCognos Incentive Compensation Management.

Acceso a la APILa API se aloja como un servicio de Windows, denominado IBM Cognos IncentiveCompensation Management API.

El servicio de Windows Cognos Incentive Compensation Management API debeestar iniciado para disponer de acceso. Los certificados también deben estarinstalados y configurados correctamente para proporcionar una conexión seguraentre el servicio y el cliente preparado para API (consulte (“Certificados” en lapágina 33).

Una vez iniciado el servicio de API, conecte un cliente preparado para API a lasdirecciones siguientes:v https://localhost:13125/API/Calculations

v https://localhost:13125/API/Security

v https://localhost:13125/API/Table

v https://localhost:13125/API/Scheduler

Una vez conectado, se necesitan un nombre de usuario y una contraseña paraobtener acceso. El nombre de usuario se proporciona en el siguiente formato:

<server>/<database>/<user_type>/<username>

Donde:


v servidor es el nombre del servidor de bases de datos especificado en el archivode configuración del servicio de Windows Cognos Incentive CompensationManagement.

v base_datos es el nombre de la base de datos del modelo de Cognos IncentiveCompensation Management al que desea conectarse.

v tipo_usuario es Web (que indica que se trata de un usuario habilitado para web),excepto si se accede al Planificador y la API de almacén de datos, dondetipo_usuarios es Administrator.

v nombre_usuario es la dirección de correo electrónico de un usuario habilitadopara web.

La contraseña es la contraseña especificada para el usuario habilitada para web.

El ejemplo siguiente contiene un nombre de usuario y contraseña arbitrarios:User name: Local/TestModel/Web/[email protected]: secret

Para obtener el archivo WSDL, conecte un navegador web a las direccionessiguientes:v https://localhost:13125/API/Calculations?wsdl

v https://localhost:13125/API/Security?wsdl

v https://localhost:13125/API/Table?wsdl

v https://localhost:13125/API/Scheduler?wsdl

Especificaciones de API para el procesamiento y el cálculoEn las tablas siguientes se indican las especificaciones de API para la ejecución deprocesos y cálculos en IBM Cognos Incentive Compensation Management.

Tabla 2. RunProcess

RunProcess

(Dirección WSDL: https://localhost:13125/API/Scheduler?wsdl)

Descripción Ejecutar el proceso guardado (carpeta) enPlanificador

Entrada Nombre del proceso (carpeta) (cadena)

Salida Ninguna

Nota Solamente usuarios administradores

Excepciones InvalidArgumentException,InvalidDataException,RetiredEndpointException, TokenException

Tabla 3. ComputeAll

ComputeAll

(Dirección WSDL: https://localhost:13125/API/Caculations?wsdl)

Descripción Realizar todos los cálculos

Entrada Ninguna

Salida Ninguna


Excepciones RetiredEndpointException, TokenException


Tabla 4. ComputePlan

ComputePlan

(Dirección WSDL: https://localhost:13125/API/Calculations?wsdl)

Descripción Calcular los resultados para el plan deremuneración dado

Entrada ID del plan (cadena)

Salida Ninguna


Excepciones InvalidArgumentException,RetiredEndpointException, TokenException

Tabla 5. ComputeTailoredReport

ComputeTailoredReport


Descripción Calcular los resultados del informe a medidadado

Entrada ID del informe a medida (cadena)

Salida Ninguna



Tabla 6. ComputePayee

ComputePayee


Descripción Calcular los resultados para el beneficiariodado

Entrada ID del beneficiario (cadena)

Salida Ninguna



Tabla 7. ComputeWebReport

ComputeWebReport


Descripción Calcular los resultados del informe webdado

Entrada ID de informe web (número)

Salida Ninguna




Tabla 8. ComputeWebForm

ComputeWebForm


Descripción Calcular los resultados para el formularioweb dado

Entrada ID del formulario web (número)

Salida Ninguna



Especificaciones de API para la gestión de datosEn las tablas siguientes se indican las especificaciones de API para la gestión dedatos en IBM Cognos Incentive Compensation Management.

Tabla 9. TableExists

TableExists

(Dirección WSDL: https://localhost:13125/API/Table?wsdl)

Descripción Determinar si en el modelo hay una tablacon el nombre especificado

Entrada Nombre de la tabla (cadena)

Salida Valor True (booleano) si la tabla existe en elmodelo y False (booleano) en caso contrario



Tabla 10. GetTablePermissions

GetTablePermissions

(Dirección WSDL: https://localhost:13125/API/Security?wsdl)

Descripción Otorgar permisos de tabla al usuario actualsobre la tabla dada


Salida Lista de permisos de tabla (cadenas)otorgadas al usuario actual sobre la tabladada


Los permisos de tabla pueden sercorresponder a una de las accionessiguientes: Añadir, Editar, Suprimir

Excepciones InvalidArgumentException,InvalidDataException,RetiredEndpointException


Tabla 11. GetTableSchema

GetTableSchema

(Dirección WSDL: https://localhost:13125/API/Table/wsdl)

Descripción Obtener el esquema para la tabla dada,incluidos los tipos de columna y los camposde clave


Salida Objeto TableSchema que contiene el nombrede la tabla (cadena) y una lista de los objetosColumnSchema que contengan el nombre decolumna (cadena), el tipo de columna(cadena), y si la columna es de clave(booleano)

Nota Los tipos de columna pueden ser uno de lossiguientes: Cuadro de texto, Fecha, Lista deselección, Numérico, Correo electrónico,URL, Comentario

Solamente usuarios administradores

Excepciones InvalidArgumentException,InvalidDataException,RetiredEndpointException,PermissionDeniedException, TokenException

Tabla 12. GetTableRow

GetTableRow


Descripción Obtener una sola fila de datos de la tabladada

Entrada Nombre de la tabla (cadena) y lista deobjetos ColumnValuePair que identifican lafila de forma exclusiva

Salida Objeto DataRow que contiene una lista deobjetos ColumnValuePair que corresponden acada columna y su valor



Tabla 13. AddRow

AddRow


Descripción Añadir una fila a la tabla dada

Entrada Nombre de la tabla (cadena) y lista deobjetos ColumnValuePair

Salida Ninguna



Tabla 13. AddRow (continuación)

AddRow



Tabla 14. UpdateRow

UpdateRow


Descripción Actualizar valores para una fila existente enla tabla dada

Entrada Nombre de la tabla (cadena), lista de objetosColumnValuePair originales quecorresponden a una fila en la tabla y unalista de objetos ColumnValuePair nuevos quecontienen valores nuevos

Salida Ninguna



Tabla 15. DeleteRow

DeleteRow


Descripción Suprimir una fila de la tabla dada

Entrada Nombre de la tabla (cadena) y lista deobjetos ColumnValuePair que corresponden auna fila de la tabla

Salida Ninguna



Consejo: Debe proporcionar nombres de columna completos para actualizar osuprimir una fila. Para obtener el nombre de columna completo, llame aGetTableRow con el nombre de la tabla y las columnas clave para obtener toda lafila.

Especificaciones de API para el almacén de datosEn las tablas siguientes se indican las especificaciones de API para las llamadas dealmacén de datos en IBM Cognos Incentive Compensation Management.


Dirección de servicio: https://localhost:13125/API/DataStore

WSDL: http://localhost:13115/API/DataStore/?wsdl

Tabla 16. GetDataStoreID

GetDataStoreID

Descripción Obtener el ID de DataStore correspondienteal nombre dado

Entrada Nombre de DataStore (cadena)

Salida Valor de ID (entero) correspondiente alnombre de DataStore dado

Excepciones TokenException, PermissionDeniedException

Tabla 17. GetDataStoreName

GetDataStoreName

Descripción Obtener el nombre de DataStorecorrespondiente al ID dado

Entrada ID de DataStoreDataStore (entero)

Salida Valor de nombre (cadena) correspondiente alnombre de DataStore


Tabla 18. GetDataStoreIDToNameMapping

GetDataStoreIDToNameMapping

Descripción Obtener la correlación del ID de DataStorecompleto con el nombre de DataStore

Entrada ID de DataStore (entero)

Salida Valor 'true' (booleano) si la tabla existe en elmodelo y 'false' (booleano) en caso contrario


Tabla 19. GetDataStoreSchema

GetDataStoreSchema

Descripción Obtener esquema de tabla de DataStore

Entrada ID de DataStoreDataStore (entero)

Salida TableSchema (esquema de tabla) deDataStore con el ID dado


Tabla 20. GetDataStoreRowRange

GetDataStoreRowRange

Descripción Obtener filas para el ID de DataStore dado


Tabla 20. GetDataStoreRowRange (continuación)

GetDataStoreRowRange

Entrada DataStore ID (entero), ID de DataStore

Restrictions (RestrictionBase), restriccionespara filtrar los datos

StartIndex (entero), índice de inicio de lafila del resultado

Length (entero), número de las filas que serecuperarán

Salida Matriz de DataRow (DataRow[])

Excepciones TokenException, InvalidArgumentException,InvalidDataException, LargeDataException,PermissionDeniedException

Tabla 21. GetDataStoreRowCount

GetDataStoreRowCount

Descripción Obtener el número de filas para el ID dealmacén de datos dado

Entrada ID de DataStore (entero)

Restrictions (RestrictionBase), restriccionespara filtrar los datos

Salida Número de filas de DataStoreDataStore(entero)

Excepciones TokenException, InvalidArgumentException,InvalidDataException,PermissionDeniedException

Definiciones de objetoLos objetos siguientes se representan como definiciones de clase escritas en C#.

ColumnSchemapublic class ColumnSchema{public string Name;public string Type;public bool IsKey;}

Earningspublic class Earnings{public PayeeName PayeeName;public string PlanID;public string Amount;}

EarningsDetailspublic class EarningsDetails{public string[] ColumnHeaders;public EarningsDetailsRow[] Details;}


EarningsDetailsRowpublic class EarningsDetailsRow{public string[] ColumnData;public string Payout;}

Inquirypublic class Inquiry{public int ID;public string Object;public PayeeName Creator;public PayeeName Assignee;public string CreationDate;public string Status;public string Category;public InquiryComment[] Comments;}

InquiryCommentpublic class InquiryComment{public PayeeName Author;public string CreationDate;public string CommentText;}

NameValuepublic class NameValue{public string Name;public string Value;}

PayeeNamepublic class PayeeName{public string ID;public string Name;}

PeriodEarningspublic class PeriodEarnings{public string PeriodType;public PeriodEarningsRow[] Earnings;}

PeriodEarningsRowpublic class PeriodEarningsRow{public string Period;public string Amount;}

PlanEarningspublic class PlanEarnings{public PayeeName PayeeName;public string PlanID;public string Earnings;}


PlanNamepublic class PlanName{public string ID;public string Name;}

PlanPostedpublic class PlanPosted{public PlanName PlanName;public string LastPostedPeriod;}

SignOffpublic class SignOff{public int ID;public string Name;public int NodeID;public string StartDate;public string Object;public string[] Signees;}

TableDatapublic class TableData{public TableSchema Schema;public TableDataRow[] Rows;}

TableDataRowpublic class TableDataRow{public string[] Values;}

TableSchemapublic class TableSchema{public string Name;public ColumnSchema[] Columns;}

WorkflowStatuspublic class WorkflowStatus{public PayeeName PayeeName;public int ApprovalStatus;public bool HasOpenInquiries;}

DataRow{public ColumnValuePair[] Values;}


ColumnValuePairpublic class ColumnValuePair{public string Column;public string Value;}

Definiciones de objetos de almacén de datosPublic abstract class RestrictionBase{}Public abstract class RestrictionGroup : RestrictionBase{Public RestrictionBase[] RestrictionItems;}Public class AllGroup : RestrictionGroup{}Public class AnyGroup : RestrictionGroup{}

Public class Restriction : RestrictionBase{Public ColumnSchema Column;Public Operator OperatorType;Public string Right;}Public enum Operator{LessThan,LessThanEquals,Equals,NotEquals,GreaterThan,GreaterThanEquals,IsNull,IsNotNull}

Definiciones de excepcionesLos objetos siguientes se representan como definiciones de clase escritas en C#.

APIExceptionpublic class APIException{public string Message;}

Descripción: Objeto base que todos los objetos de excepción amplían para heredarel miembro Message, que se utiliza para almacenar una descripción del error queprovoca la excepción.

InvalidArgumentExceptionpublic class InvalidArgumentException : APIException{}

Descripción: Se emite cuando se descubre un argumento (valor de parámetro) noválido para un método.


InvalidDataExceptionpublic class InvalidDataException : APIException{}

Descripción: Se emite cuando se descubren datos no válidos (no existentes).

RetiredEndpointExceptionpublic class RetiredEndpointException : APIException{}

Descripción: Se emite cuando se retira un punto final (método de servicio); porejemplo, cuando deja de existir.

UserTypeExceptionpublic class UserTypeException : APIException{}

Descripción: Se emite cuando el tipo de usuario correspondiente al usuario que hainiciado sesión es incorrecto o no es válido.

PermissionDeniedExceptionpublic class PermissionDeniedException : APIException{}

Descripción: Se emite cuando el usuario no tiene permiso para realizar laoperación.

Complemento para Microsoft ExcelPuede instalar un complemento de Cognos Incentive Compensation Managementpara Microsoft Excel 2003 ó 2007 y 2010 que proporciona a los usuarios unamanera fácil de crear informes con los resultados actualizados de Cognos IncentiveCompensation Management.

Una vez que los usuarios han iniciado sesión en Cognos Incentive CompensationManagement a través de Microsoft Excel, pueden realizar una selección en unalista de esquemas en estrella de Cognos Incentive Compensation Management parasu inclusión en el informe. Mediante la funcionalidad de tabla dinámica típica, losusuarios pueden definir lo que incluirán en el eje X e Y y de qué valores tratará elinforme. Los usuarios también podrán renovar los datos con los datos actualizadosde Cognos Incentive Compensation Management.

Configuración del lado del servicio para instalar elcomplemento

Debe configurar los certificados en el sistema en el que se ejecuta el servicio deWindows Cognos Incentive Compensation Management y modificar el archivo deconfiguración del servicio de Windows.

Configuración de certificadosPara utilizar el complemento de IBM Cognos Incentive Compensation Managementpara Microsoft Excel, debe importar un certificado digital al almacén de entidadesde certificación raíz de confianza y al almacén personal.


Procedimiento1. En el menú Inicio de Windows, pulse Ejecutar.2. Escriba mmc y pulse Aceptar.3. Vaya a Archivo > Agregar o quitar complemento.4. Pulse Agregar.5. Seleccione Certificados y pulse Agregar.6. Seleccione Cuenta de equipo y pulse Siguiente.7. Deje la opción Equipo local seleccionada y pulse Finalizar.8. Pulse Cerrar y, a continuación, Aceptar.9. Expanda Certificados y Entidades de certificación raíz de confianza.

10. Seleccione la carpeta Certificados en Entidades de certificación raíz deconfianza, pulse con el botón derecho y seleccione Todas las tareas >Importar.

11. En el Asistente para importación de certificados, pulse Siguiente.12. Pulse Examinar.13. Abra la carpeta que contiene los certificados y seleccione Todos los archivos

en el menú desplegable Archivos de tipo.14. Seleccione el certificado y pulse Abrir.

En este ejemplo, el certificado se llama MobileAPI.15. Pulse Siguiente.16. Escriba la contraseña de la clave privada, si se necesita, y pulse Siguiente.17. Deje seleccionada la opción Colocar todos los certificados en el siguiente

almacén.18. Pulse Siguiente.19. Revise los valores de importación y pulse Finalizar.20. Expanda la carpeta Personal.21. Seleccione la carpeta Certificados, pulse con el botón derecho y seleccione

Todas las tareas > Importar.22. Complete los pasos para importar el certificado.

El certificado de Mobile API se almacena en ambas carpetas.23. Cierre Microsoft Management Console.

Modificación del archivo de configuración del servicio deWindows IBM Cognos Incentive Compensation ManagementPara utilizar el complemento de Cognos Incentive Compensation Managementpara Microsoft Excel, en el archivo de configuración del servicio de WindowsCognos Incentive Compensation Management, tendrá que configurar una direccióny un puerto de API seguros y añadir el certificado necesario para el acceso.

Procedimiento1. En API secure address and port, cambie Value para que sea igual que

[nombre certificado]:[número de puerto].Por ejemplo, <add key="APISecureAddress" value="MobileAPI:13125">.

2. En API certification required for access, cambie Value para que sea igualque el nombre del certificado.Por ejemplo, <add key="APICertificateName" value="MobileAPI"/>.


Configuración de la identidad del servidor que aloja el servicioPara utilizar el complemento de IBM Cognos Incentive Compensation Managementpara Microsoft Excel, debe configurar la identidad del servidor que aloja el servicioen el archivo hosts.

Procedimiento1. Vaya a C:\Windows\system32\drivers\etc y abra el archivo hosts con el Bloc de

notas.2. Escriba la dirección IP del sistema que aloja el servicio y escriba el nombre del

certificado.La dirección IP y el nombre del certificado deben estar separados por comomínimo un espacio; por ejemplo, 127.0.0.1 MobileAPI.

3. Guarde y cierre el archivo.

Identificación del certificado de servidorPara utilizar el complemento de IBM Cognos Incentive Compensation Managementpara Microsoft Excel, debe identificar el certificado del servidor mediante elprograma de utilidad de configuración HTTP.

Procedimiento1. Ejecute el programa de utilidad de configuración HTTP.2. Seleccione la pestaña SSL y pulse Añadir.3. Especifique la dirección IP del servidor en el campo Dirección IP y un número

de puerto en el campo Puerto.Atención: Si se utiliza un nombre de host en lugar de una dirección IP, elnombre de host debe estar correlacionado con la dirección en el archivo dehosts. Vaya a C:\windows\system32\drivers\ para realizar este cambio.

4. Pulse Examinar y seleccione el certificado de servidor.5. Pulse Aceptar.6. Seleccione la pestaña Permisos y asegúrese de que se hayan otorgado los

permisos al grupo de usuarios pertinente.7. Pulse Aceptar en el diálogo de configuración de SSL.8. Pulse Aceptar para cerrar el programa de utilidad de configuración HTTP.

Configuración del lado del cliente para instalar elcomplemento

Si el servidor utiliza un certificado privado (autofirmado), tendrá que configurarlos certificados, identificar el certificado del servidor y configurar la identidad delservidor que aloja el servicio en el sistema en el que se ejecuta el cliente de CognosIncentive Compensation Management; para ello, siga los mismos pasos que en laconfiguración del lado del servicio.

Se necesitan certificados en ambos lados para que el servicio pueda acceder alcliente de Cognos Incentive Compensation Management. Sin embargo, si elservidor utiliza un certificado de confianza, no es necesario añadir certificados enel sistema en el que se ejecuta el cliente. Deberá instalar software para ejecutar elcomplemento de Cognos Incentive Compensation Management para MicrosoftExcel; a continuación, instale el propio complemento de Cognos IncentiveCompensation Management para Microsoft Excel en el sistema en el que se ejecutael cliente.


Software necesario para ejecutar el complementoAntes de instalar el complemento de Cognos Incentive Compensation Managementpara Microsoft Excel, debe instalar software necesario adicional.

Los usuarios deberán tener el software siguiente instalado en sus sistemas parapoder ejecutar el complemento de Cognos Incentive Compensation Managementpara Microsoft Excel 2007/2010:v herramientas de ensamblados de interoperabilidad primarios de Officev Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 del

tiempo de ejecución) (x86), que se puede obtener en www.microsoft.comv Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0 del

tiempo de ejecución) Service Pack 1 (x86), que se puede obtener enwww.microsoft.com

Los usuarios deberán tener el software siguiente instalado en sus sistemas parapoder ejecutar el complemento de Cognos Incentive Compensation Managementpara Microsoft Excel 2003:v herramientas de ensamblados de interoperabilidad primarios de Officev Microsoft Visual Studio 2005 Tools para Office Runtime, segunda edición, (VSTO

2005 SE) (x86), que se puede obtener en www.microsoft.com

Instalación de la herramienta de ensamblados deinteroperabilidad primarios de OfficePara ejecutar el complemento de Microsoft Excel de IBM Cognos IncentiveCompensation Management, debe tener instalada la herramienta de ensambladosde interoperabilidad primarios de Office.

Procedimiento1. En el Panel de control, seleccione Agregar o quitar programas.2. Seleccione Microsoft Office y pulse Cambiar.3. En Opciones de instalación, expanda Microsoft Office Excel y seleccione

Compatibilidad con programación de .NET.4. Pulse la flecha de la lista desplegable y seleccione Ejecutar desde mi PC.5. Pulse Continuar.6. Cuando el proceso de configuración haya finalizado, pulse Cerrar.

Certificados y serviciosAl instalar el complemento de IBM Cognos Incentive Compensation Managementpara Microsoft Excel, los certificados y los servicios deben estar configurados en ellado del cliente si el servidor utiliza un certificado privado (autofirmado). Si elservidor utiliza un certificado de confianza, no es necesario configurar loscertificados y los servicios en el cliente.

Efectúe las tareas siguientes para configurar los certificados y los servicios en ellado del cliente:v “Configuración de certificados” en la página 55v “Identificación del certificado de servidor” en la página 57v “Configuración de la identidad del servidor que aloja el servicio” en la página

57


Importante: La configuración de los certificados y los servicios en el lado delcliente solamente es necesaria si el servidor utiliza un certificado privado(autofirmado).

Instalación y configuración del complementoCuando se cumplan todos los requisitos, podrá instalar el complemento de CognosIncentive Compensation Management para Microsoft Excel.

Atención: Antes de instalar el complemento de Cognos Incentive CompensationManagement para Microsoft Excel, asegúrese de que el servicio de WindowsCognos Incentive Compensation Management se ha detenido y de que se hareiniciado después de haber realizado los cambios en el archivo de configuracióndel servicio de Windows Cognos Incentive Compensation Management; asegúresetambién de que el servicio Cognos Incentive Compensation Management API estáen ejecución.

Procedimiento1. Ejecute el instalador ICM-exceladdin proporcionado con la versión y siga los

pasos del asistente de instalación.2. Abra Microsoft Excel.

Se ejecutará una instalación rápida del complemento.3. Después de ejecutar el complemento de Cognos Incentive Compensation

Management, verá una pestaña llamada IBM Cognos IncentiveCompensation Management en la barra de menús de Microsoft Excel.

4. Pulse la pestaña IBM Cognos Incentive Compensation Management.5. Para conectar con un modelo, escriba la dirección del servicio.

Es la misma dirección que la que ha especificado en el archivo deconfiguración del servicio de Windows Cognos Incentive CompensationManagement; por ejemplo, MobileAPI:13125.

6. Escriba el nombre del servidor.Es el nombre del servidor que ha especificado en la sección databaseServersdel archivo de configuración del servicio de Windows Cognos IncentiveCompensation Management; por ejemplo, SQLServer2005 (local).

7. Escriba el nombre de la base de datos.Es el nombre de la base de datos que contiene el modelo al que deseaconectarse; por ejemplo, Rivacent.

8. Pulse Información de inicio de sesión.9. Escriba su nombre de usuario y su contraseña para el cliente de Cognos

Incentive Compensation Management y pulse Guardar.10. Pulse Importar esquema en estrella o Importar almacén de datos para

descargar los datos en Microsoft Excel desde el modelo de Cognos IncentiveCompensation Management.



Capítulo 4. El cliente web de IBM Cognos IncentiveCompensation Management

En los temas siguientes se proporcionan las instrucciones para instalar y configurarel cliente web de Cognos Incentive Compensation Management con un desplieguede Apache Tomcat, JBoss o WebSphere basado en el sistema operativo MicrosoftWindows.

Si utiliza otros sistemas operativos, los pasos son similares. En este capítulotambién se explica el soporte de varios idiomas y de datos Unicode y se describe laconfiguración del aspecto del cliente web. Antes de empezar, tenga en cuenta queel cliente web requiere que el servicio de Windows IBM Cognos IncentiveCompensation Management (o la herramienta del servicio de consola) estéinstalado y en ejecución en un servidor junto con un modelo de Cognos IncentiveCompensation Management para que su funcionamiento sea correcto.

Instalación del cliente web con el sistema operativo SolarisEl cliente web de Cognos Incentive Compensation Management se puede instalaren un sistema operativo Solaris.

Procedimiento1. Copie el archivo ICM.war en la ubicación de despliegue.2. Cree un directorio.3. Mueva el archivo ICM.war a ese directorio.4. Descomprima el archivo ICM.war.5. Efectúe el despliegue según las instrucciones proporcionadas para Windows.

Despliegue de Apache TomcatEl cliente web de IBM Cognos Incentive Compensation Management se puededesplegar fácilmente mediante Apache Tomcat versión 6 ó 7.

Para desplegar correctamente el cliente web con Tomcat Manager, antes debe haberinstalado Java.

Instalación y configuración de JavaPara que Apache Tomcat despliegue el cliente web de IBM Cognos IncentiveCompensation Management correctamente, debe haberse descargado e instaladoJava 6 ó 7 JRE.

Procedimiento

Descargue e instale Java 6 ó 7 JRE desde http://www.oracle.com/technetwork/java/javase/downloads/index.html.

Instalación y configuración de Apache TomcatApache Tomcat debe haberse instalado y estar en ejecución en el sistema parapoder desplegar el cliente web de IBM Cognos Incentive CompensationManagement.


http://www.oracle.com/technetwork/java/javase/downloads/index.html


Procedimiento

Descargue e instale Apache Tomcat 6 ó 7 desde el sitio web siguiente:http://tomcat.apache.org/download-60.cgi1. Si va a instalar el cliente web en Windows, descargue y ejecute la distribución

Windows Service Installer de Tomcat.2. Si no va a instalar el cliente web en Windows, instale Tomcat por medio del

archivo proporcionado en el sitio web siguiente: http://tomcat.apache.org

Importante: Cuando Tomcat se ejecuta como servicio, no aparece ningún icono debandeja durante su ejecución. Hay una excepción a esta regla, que se da cuando seopta por ejecutar Tomcat al final del proceso de instalación. A continuación elinstalador creará atajos para iniciar y configurar Tomcat. La aplicación deadministración web de Tomcat solamente se puede utilizar cuando Tomcat está enejecución.

Despliegue del cliente web con Apache TomcatPuede utilizar Tomcat Manager para desplegar el cliente web de IBM CognosIncentive Compensation Management.

Procedimiento1. Vaya a http://localhost:8080.

Apache Tomcat se ejecuta de forma predeterminada en el puerto 8080, pero siha especificado otro número de puerto distinto durante la instalación deTomcat, utilice a ese número de puerto.

2. Pulse el enlace Tomcat Manager e inicie sesión con el nombre de usuario y lacontraseña que se han especificado durante la instalación de Tomcat.

3. En la página de Tomcat Manager, en la sección Deploy, pulse Browse.4. Busque el archivo ICM.war y pulse Deploy.

Cuando la página se renueve, se mostrará un enlace /ICM bajo la cabeceraApplications.Atención: Cognos Incentive Compensation Management requiere que unarchivo WAR que se despliegue como parte de una actualización tenga unnombre exclusivo. Los clientes tendrán que desinstalar el archivo WAR quetengan en ese momento antes de desplegar uno nuevo, o bien cambiar elnombre del archivo WAR nuevo.

5. Pulse el enlace /ICM para verificar el despliegue.Atención: Cuando verifique el despliegue, puede que aparezca una ventanadel cliente web de Cognos Incentive Compensation Management en la que semuestre un error interno. Esto indica que el cliente web se ha desplegado, peroque debe configurarse el acceso a la base de datos de Cognos IncentiveCompensation Management.

Configuración del acceso a la base de datos con ApacheTomcat

El archivo de configuración del cliente web debe modificarse para que señale almodelo de IBM Cognos Incentive Compensation Management.

Una vez que la aplicación se haya desplegado en Tomcat, deberá editarse elarchivo jdbc.properties. Se encuentra en la ubicación predeterminada siguiente:C:\Archivos de programa\Apache Software Foundation\Tomcat6.0\webapps\ICM\WEB-INF\jdbc.properties.


http://tomcat.apache.org/download-60.cgi

http://tomcat.apache.org

Procedimiento1. Abra el archivo jdbc.properties con un editor de texto como, por ejemplo,

WordPad.No use el Bloc de notas, ya que no da soporte al formato de texto de UNIX.

2. Modifique Server con el nombre de host del sistema con SQL Server; porejemplo, localhost:1433.El número de puerto predeterminado de SQL Server es 1433, pero el número depuerto puede ser otro si se conecta a una instancia con nombre. Por ejemplo,una instancia con nombre en \\DBserver\SQL2000 se ejecuta en el puerto 2140.Utilice el Administrador de configuración de SQL Server para comprobar elnúmero de puerto.

3. Modifique el nombre de la base de datos con el nombre de la base de datosque contiene el modelo de Cognos Incentive Compensation Management (sedistingue entre mayúsculas y minúsculas).

4. Modifique username y password con el nombre de usuario y la contraseña de lacuenta de SQL Server con los derechos pertinentes que desea utilizar paraacceder a la base de datos de Cognos Incentive Compensation Management.

5. Guarde el archivo jdbc.properties actualizado.También puede guardar una copia del archivo en otra ubicación para utilizarlacomo referencia cuando la aplicación se vuelva a desplegar; por ejemplo, alrealizar una actualización a una versión más reciente.

6. Vuelva a Tomcat Manager y pulse el enlace Reload correspondiente a /ICMpara propagar los cambios.

7. Vaya a http://localhost:8080/ICM.Si en su servidor se ejecuta el servicio de Windows Cognos IncentiveCompensation Management con un modelo de Cognos Incentive CompensationManagement existente, todos los usuarios que se hayan configurado en PortalAccess mediante el cliente .NET podrán iniciar sesión.

Configuración del soporte de varios idiomas y de datosUnicode para Apache Tomcat

Para dar soporte a la codificación UTF-8 o si se accede a enlaces que contienencaracteres acentuados en el cliente web de IBM Cognos Incentive CompensationManagement, el servidor web debe configurarse de modo que interprete los URIcomo UTF-8. Si utiliza Apache Tomcat como servidor web, el valor predeterminadono es UTF-8, por lo que debe cambiar este valor.

Procedimiento1. Vaya a la ubicación siguiente: C:\Archivos de programa\Apache Software

Foundation\Tomcat 6.0\conf

2. Abra el archivo server.xml.3. Busque el conector que está utilizando el protocolo HTTP.4. Añada la línea siguiente: URIEncoding="UTF-8"

Ahora deberá tener el código siguiente en el archivo server.xml:<Connector port="8080" protocol="HTTP/1.1"

connectionTimeout="20000"redirectPort="8443"URIEncoding="UTF-8"/>

5. Guarde el archivo.6. Reinicie el servicio Apache.

Capítulo 4. El cliente web de IBM Cognos Incentive Compensation Management 63

Despliegue de JBossEl cliente web de IBM Cognos Incentive Compensation Management se puededesplegar mediante JBoss.

El despliegue necesita las tareas siguientes:v Instalar y configurar Javav Instalar y configurar JBossv Desplegar el archivo WAR de ICM y configurar el acceso a la base de datos

Instalación y configuración de Java para JBossAl desplegar el cliente web de IBM Cognos Incentive Compensation Managementen la versión de JBoss más reciente, debe disponer del kit de desarrollo de softwareJava Software Development Kit 5.0 o una versión posterior.

Procedimiento

Descargue e instale Java SDK (JDK 6 Actualización 16) del sitio web siguiente:http://java.sun.com/javase/downloads/index.jsp.

Instalación y configuración de JBossUna vez que el entorno de Java está preparado, puede ir al sitio web de JBoss paradescargar el servidor de aplicaciones y utilizarlo con el cliente web de IBM CognosIncentive Compensation Management.

Procedimiento1. Vaya al sitio web de JBoss siguiente para descargar el servidor web:

http://www.oracle.com/technetwork/java/javase/downloads/index.html2. En la página de descargas Downloads, seleccione la versión de JBoss

Application Server que desea descargar.3. Descargue el archivo correspondiente y extráigalo en el directorio que desee.

Configuración del acceso a la base de datos para JBossDebe editar el archivo de configuración del cliente web de IBM Cognos IncentiveCompensation Management para que señale al modelo de Cognos IncentiveCompensation Management.

Es necesario preconfigurar el archivo jdbc.properties para que, una vez que laaplicación se haya desplegado, el archivo jdbc.properties se pueda copiar y pegaren el archivo WAR de ICM. JBoss no expandirá automáticamente el archivo WARweb de Cognos Incentive Compensation Management.

Procedimiento1. Vaya a la ubicación en la que está almacenado el archivo WAR de Cognos

Incentive Compensation Management.2. Cambie el nombre del archivo WAR por ICM.zip.

Esto permite navegar dentro del archivo WAR.3. Abra el archivo ZIP y vaya a la carpeta WEB-INF.4. Copie el archivo jdbc.properties.5. Salga de la carpeta del ZIP y pegue el archivo jdbc.properties.6. Cambie el nombre de la carpeta del ZIP por ICM.war.


http://java.sun.com/javase/downloads/index.jsp


7. Abra el archivo jdbc.properties con un editor de texto como, por ejemplo,WordPad.No use el Bloc de notas, ya que no da soporte al formato de texto de UNIX.

8. Modifique Server con el nombre de host de la máquina con SQL Server; porejemplo, localhost:1433.El número de puerto predeterminado de SQL Server es 1433, pero el númerode puerto puede ser otro si se conecta a una instancia con nombre (porejemplo, una instancia con nombre en \\DBserver\SQL2000 se ejecuta en elpuerto 2140). Utilice el Administrador de configuración de SQL Server paracomprobar el número de puerto.

9. Modifique database name con el nombre de la base de datos que contiene elmodelo de Cognos Incentive Compensation Management (se distingue entremayúsculas y minúsculas).

10. Modifique username y password con el nombre de usuario y la contraseña dela cuenta de SQL Server con los derechos pertinentes que desea utilizar paraacceder a la base de datos de Cognos Incentive Compensation Management.

11. Guarde el archivo jdbc.properties actualizado.Puede que también quiera guardar una copia del archivo en otra ubicaciónpara utilizarla como referencia cuando la aplicación se vuelva a desplegar; porejemplo, al realizar una actualización a una versión más reciente.

Despliegue del cliente web con JBossDespués de instalar Java y JBoss y de configurar el archivo jdbc.properties, esnecesario desplegar manualmente el cliente web de Cognos IncentiveCompensation Management.

JBoss no desplegará automáticamente el archivo WAR, por lo que deberán seguirsealgunos pasos para configurar el cliente web de Cognos Incentive CompensationManagement.

Procedimiento1. Cree un archivo llamado jboss-web.xml y guárdelo en una ubicación a la que

se pueda acceder.Es recomendable guardar este archivo junto con el archivo ICM.war y el archivojdbc.properties preconfigurado.a. Con WordPad o una aplicación similar, copie el texto siguiente en el archivo

jboss-web.xml:<jboss-web></jboss-web>

b. Guarde el archivo jboss-web.xml.2. Copie la versión del archivo WAR en \jboss-[versión].GA\server\default\

deploy\.Puede cambiar el nombre del archivo WAR por otro que no sea ICM parafacilitar su uso.

3. Cambie la extensión de archivo .war por .zip. De este modo, podrá navegardentro el archivo para ir a \WEB-INF.

4. Sustituya el archivo jdbc.properties por el archivo jdbc.propertiespreconfigurado.


5. Pegue el archivo jboss-web.xml en la carpeta WEB-INF.6. En \jboss-[versión].GA\server\default\deploy, cambie la extensión de

archivo .zip por .war.7. Inicie JBoss ejecutando el archivo run.bat, que se encuentra en la ubicación

siguiente: ....jboss-[versión].GA\bin\run.bat8. Vaya a http://localhost:8080/ICM, siendo ICM el nombre del archivo WAR.

Configuración del soporte de varios idiomas y de datosUnicode para JBoss

Para dar soporte a la codificación UTF-8 o si se accede a enlaces que contienencaracteres acentuados en el cliente web de IBM Cognos Incentive CompensationManagement, el servidor web debe configurarse de modo que interprete los URIcomo UTF-8. Si utiliza JBoss como servidor web, el valor predeterminado no esUTF-8, por lo que debe cambiar este valor.

Procedimiento1. Vaya a la ubicación siguiente: C:\Archivos de programa\JBoss\jboss-

[versión].GA\server\default\deploy\jboss-web.deployer\

2. Abra el archivo server.xml.3. Busque el conector que está utilizando el protocolo HTTP.4. Añada la línea siguiente: URIEncoding="UTF-8"

<Connector port="8080" address="${jboss.bind.address}"maxThreads="250" maxHttpHeaderSize="8192"emptySessionPath="true" protocol="HTTP/1.1"enableLookups="false" redirectPort="8443" acceptCount="100"connectionTimeout="20000" diableUploadTimeout="true" URIEncoding="UTF-8"/>

5. Guarde el archivo.6. Reinicie el servicio web.

Despliegue de WebSphere 7El cliente web de IBM Cognos Incentive Compensation Management se puededesplegar mediante WebSphere.

Después de instalar y configurar WebSphere, debe instalar el archivo WAR deCognos Incentive Compensation Management y configurar el archivo depropiedades de JDBC.

El archivo de registro del cliente web se encuentra en el directorio de instalaciónde WebSphere siguiente: <instalación_WebSphere>\profiles\<perfil del servidor>.

Despliegue del cliente web en WebSphere 7Después de instalar WebSphere, puede desplegar el cliente web de IBM CognosIncentive Compensation Management en la consola administrativa de WebSphere.

Procedimiento1. Inicie sesión en la consola administrativa y seleccione Aplicaciones.2. Seleccione Aplicaciones nuevas.3. Seleccione Aplicación empresarial nueva.4. Busque el archivo WAR que desea desplegar y pulse Siguiente.


5. Seleccione Detallada: mostrar todas las opciones y todos los parámetros deinstalación y pulse Siguiente.

6. Pulse Continuar en la pantalla de avisos de seguridad de la aplicación.7. Especifique un valor en Nombre de aplicación; por ejemplo, ICM803.8. Resalte Todos los permisos de archivos y pulse Siguiente.9. En el paso 2, marque el cuadro de selección y pulse Siguiente.

10. En el paso 3, pulse Siguiente.11. En el paso 4, marque el cuadro de selección que corresponde a la aplicación

actual y pulse Siguiente.12. En el paso 5, marque el cuadro de selección que corresponde a la aplicación

actual y pulse Siguiente.13. En el paso 6, marque el cuadro de selección y pulse Siguiente.14. Especifique una raíz de contexto exclusiva para el archivo WAR (por ejemplo,

/ICM803) y pulse Siguiente.15. Pulse Finalizar en la página de resumen.16. Pulse Guardar.17. Seleccione Servidores > Tipos de servidor > Servidores de aplicaciones

WebSphere > nombre_servidor > Java y gestión de procesos > Definición deproceso > Máquina virtual Java > Propiedades personalizadas.

18. Pulse Nuevo.19. Especifique el nombre como java.awt.headless y establezca el valor en False.20. Pulse Aplicar y, a continuación, Aceptar.21. Seleccione la opción para guardar directamente en la configuración maestra.

Configuración del acceso a la base de datos con WebSphereDespués de desplegar el archivo WAR, deberá editar el archivo jdbc.propertiesen dos ubicaciones para configurar el acceso a la base de datos de IBM CognosIncentive Compensation Management.

Acerca de esta tarea

En el sistema Windows, el archivo se encuentra en las ubicaciones siguientes:v C:\Archivos de programa\IBM\WebSphere\AppServer\profiles\AppSrv01\config\

cells\ [nombre servidor]Node01Cell\ applications\CONTEXTROOT_war.ear\deployments\CONTEXT ROOT_war\CONTEXT ROOT.war\WEB-INF

v C:\Archivos de programa\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\..\..\ ICM.war\WEB-INF

En los sistemas de tipo UNIX, el archivo se encuentra en las ubicaciones siguientes:v /AppServer/profiles/AppSrv01/installedApps/../../ICM.war/WEB-INF Por

ejemplo: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/../../ICM.war/WEB-INF

v /AppServer/profiles/AppSrv01/config/cells/../applications/.../deployments/../../WEB-INF Por ejemplo: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/../applications/.../deployments/../../WEB-INF


WordPad.


No use el Bloc de notas, ya que no da soporte al formato de texto de UNIX.2. Modifique Server con el nombre de host del sistema con SQL Server; por

ejemplo, localhost:1433.El número de puerto predeterminado de SQL Server es 1433, pero el número depuerto puede ser otro si se conecta a una instancia con nombre (por ejemplo,una instancia con nombre en \\DBserver\SQL2000 se ejecuta en el puerto 2140).Utilice el Administrador de configuración de SQL Server para comprobar elnúmero de puerto.



5. Guarde el archivo jdbc.properties actualizado.Puede que también quiera guardar una copia de los archivos en otra ubicaciónpara utilizarla como referencia cuando la aplicación se vuelva a desplegar; porejemplo, al realizar una actualización a una versión más reciente.

Utilización de la consola administrativa de WebSphere parainiciar el cliente web

Después de instalar WebSphere y de desplegar el cliente web de IBM CognosIncentive Compensation Management, puede lanzar el cliente web desde la consolaadministrativa de WebSphere.

Procedimiento1. Inicie sesión en la consola administrativa.2. Seleccione Aplicaciones > Tipos de aplicación > Aplicaciones empresariales

de Websphere.3. Seleccione la aplicación Cognos Incentive Compensation Management.4. Pulse Iniciar.

Atención: Si olvida la raíz de contexto asociada, seleccione el nombre de laaplicación. Seleccione la opción Raíz de contexto para módulos web.

5. Abra un navegador de Internet en el sistema local.6. Vaya a la página de inicio de sesión del cliente web de Cognos Incentive

Compensation Management.Por ejemplo: http://server:9080/CONTEXT ROOT/login.html

Establecimiento de una propiedad personalizada decontenedor web en WebSphere

Para evitar el error de WebSphere Error 404:SRVEO19OE:File not found:/j_spring_security_check al intentar iniciar sesión en el cliente web de IBMCognos Incentive Compensation Management, la propiedad siguiente debe tener elvalor true: com.ibm.ws.webcontainer.invokefilterscompatibility = true.

Procedimiento1. En la consola administrativa, pulse Servidores > Servidores de aplicaciones.2. Pulse el servidor al que se aplicará la propiedad personalizada.3. En Configuración > Valores de contenedor, seleccione Valores de contenedor

Web > Contenedor Web.


4. En Configuración > Propiedades adicionales, seleccione Propiedadespersonalizadas.

5. En la página Propiedades personalizadas, pulse Nueva.6. En la página Valores, escriba el nombre de la propiedad personalizada que se

añadirá en el campo Nombre y el valor que se establecerá en la propiedadpersonalizada en el campo Valor.Atención: Algunas propiedades distinguen entre mayúsculas y minúsculas.

7. Pulse Aplicar o Aceptar.8. Reinicie el servidor para que la propiedad personalizada entre en vigor.

Configuración del soporte de varios idiomas y de datosUnicode para WebSphere

Para dar soporte a la codificación UTF-8 o si se accede a enlaces que contienencaracteres acentuados en el cliente web de IBM Cognos Incentive CompensationManagement, el servidor web debe configurarse de modo que interprete los URIcomo UTF-8. Si utiliza WebSphere como servidor web, el valor predeterminado noes UTF-8, por lo que debe cambiar este valor.

Procedimiento1. Vaya a la ubicación siguiente: C:\Archivos de programa\IBM\WebSphere\

AppServer\properties\

2. Abra el archivo encoding.properties.3. Sustituya "en=ISO-8859-1" por "en=UTF-8".4. Guarde el archivo.5. Reinicie el servicio web.

Despliegue de WebSphere 8El cliente web de IBM Cognos Incentive Compensation Management se puededesplegar mediante WebSphere 8.

Después de instalar y configurar WebSphere, tendrá que instalar el archivo WARde Cognos Incentive Compensation Management y configurar el archivo depropiedades de JDBC.

Configuración de WebSphere 8Antes de desplegar el cliente web de IBM Cognos Incentive CompensationManagement en WebSphere, deberá crear un perfil de servidor de aplicaciones einiciar el servidor.

Procedimiento1. Vaya a Inicio > Todos los programas > IBM WebSphere Application Server

V8.0 > Herramientas > Herramientas de gestión de perfiles.2. Pulse Crear.3. Seleccione Servidor de aplicaciones y pulse Siguiente.4. Seleccione la opción para crear un perfil típico y pulse Siguiente.5. Deseleccione Habilitar seguridad administrativa y pulse Siguiente.6. Anote los valores de Puerto de la consola administrativa y Número de puerto

de transporte HTTP que aparecen.7. Pulse Crear.8. Pulse Finalizar.


Se muestra la ventana WebSphere Application Server - Primeros pasos -<nombre de servidor>.

9. Pulse Iniciar el servidor.

Despliegue del cliente web en WebSphere 8El cliente web de IBM Cognos Incentive Compensation Management se puededesplegar desde la consola administrativa de WebSphere.

Procedimiento1. En el navegador, vaya a la consola administrativa de WebSphere e inicie

sesión.La dirección predeterminada es localhost:9060/ibm/console.

2. En el panel de la izquierda, vaya a Servidores > Tipos de servidor >Servidores de aplicaciones WebSphere.

3. Pulse el servidor correspondiente.4. En el panel derecho, expanda Valores de contenedor Web > Contenedor Web.5. En Propiedades adicionales, pulse Propiedades personalizadas.6. Pulse Nuevo.

a. En el campo Nombre, escribacom.ibm.ws.webcontainer.initFilterBeforeInitServlet.

b. En el campo Valor, escriba true.7. Pulse Nuevo.

a. En el campo Nombre, escribacom.ibm.ws.webcontainer.invokeFilterInitAtStartup.

b. En el campo Valor, escriba true.8. Pulse el enlace para guardar directamente en la configuración maestra.9. En el panel izquierdo, vaya a Aplicaciones > Tipos de aplicación >

Aplicaciones empresariales de WebSphere.10. Seleccione las tres aplicaciones predeterminadas y pulse Desinstalar.11. Pulse Instalar.12. Pulse Examinar y localice el archivo ICM.war.13. Pulse Siguiente.14. Seleccione la opción Vía rápida y pulse Siguiente.15. Deje seleccionado el valor predeterminado en el paso 1, 2, 3 y 4.16. Pulse Finalizar.17. Pulse el enlace para guardar directamente en la configuración maestra.18. Pulse el enlace ICM_war.19. Pulse Gestión de sesión.

a. Seleccione Alterar temporalmente gestión de sesiones.b. Habilite las cookies y la reescritura de URL.

20. Pulse Propiedades del asignador de solicitudes.a. Seleccione Permitir la asignación de solicitudes include a recursos

remotos.b. Seleccione Permitir el servicio de solicitudes include de recursos remotos.

Configuración del acceso a la base de datos con WebSphereDespués de desplegar el archivo WAR, deberá editar el archivo jdbc.propertiesen dos ubicaciones para configurar el acceso a la base de datos de IBM CognosIncentive Compensation Management.



En el sistema Windows, el archivo se encuentra en las ubicaciones siguientes:v C:\Archivos de programa\IBM\WebSphere\AppServer\profiles\AppSrv01\config\

cells\ [nombre servidor]Node01Cell\ applications\CONTEXTROOT_war.ear\deployments\CONTEXT ROOT_war\CONTEXT ROOT.war\WEB-INF

v C:\Archivos de programa\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\..\..\ ICM.war\WEB-INF

En los sistemas de tipo UNIX, el archivo se encuentra en las ubicaciones siguientes:v /AppServer/profiles/AppSrv01/installedApps/../../ICM.war/WEB-INF Por

ejemplo: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/../../ICM.war/WEB-INF

v /AppServer/profiles/AppSrv01/config/cells/../applications/.../deployments/../../WEB-INF Por ejemplo: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/../applications/.../deployments/../../WEB-INF


WordPad.No use el Bloc de notas, ya que no da soporte al formato de texto de UNIX.

2. Modifique Server con el nombre de host del sistema con SQL Server; porejemplo, localhost:1433.El número de puerto predeterminado de SQL Server es 1433, pero el número depuerto puede ser otro si se conecta a una instancia con nombre (por ejemplo,una instancia con nombre en \\DBserver\SQL2000 se ejecuta en el puerto 2140).Utilice el Administrador de configuración de SQL Server para comprobar elnúmero de puerto.



5. Guarde el archivo jdbc.properties actualizado.Puede que también quiera guardar una copia de los archivos en otra ubicaciónpara utilizarla como referencia cuando la aplicación se vuelva a desplegar; porejemplo, al realizar una actualización a una versión más reciente.

Utilización de la consola administrativa de WebSphere parainiciar el cliente webDespués de instalar WebSphere y de desplegar el cliente web de IBM CognosIncentive Compensation Management, puede lanzar el cliente web desde la consolaadministrativa de WebSphere.

Procedimiento1. Inicie sesión en la consola administrativa.2. Seleccione Aplicaciones > Tipos de aplicación > Aplicaciones empresariales

de Websphere.3. Seleccione la aplicación Cognos Incentive Compensation Management.4. Pulse Iniciar.


Atención: Si olvida la raíz de contexto asociada, seleccione el nombre de laaplicación. Seleccione la opción Raíz de contexto para módulos web.

5. Abra un navegador de Internet en el sistema local.6. Vaya a la página de inicio de sesión del cliente web de Cognos Incentive

Compensation Management.Por ejemplo: http://server:9080/CONTEXT ROOT/login.html

Cifrado de los archivos de propiedadesEl cliente web de IBM Cognos Incentive Compensation Management se puedeconfigurar para aceptar contraseñas cifradas en todos los archivos de propiedades,como jdbc.properties y ldap.properties.

Esto proporciona seguridad local adicional en forma de ofuscación. Tenga encuenta que sigue siendo necesario que alguien conozca la clave de cifrado y de quelas contraseñas se transmiten en texto sin formato a menos que se habilite laseguridad de la transmisión, como, por ejemplo, SSL.

Obtención de contraseñas cifradasSi se utiliza el conjunto de herramientas Java Simplified Encryption (Jasypt), sepueden obtener cadenas cifradas para proteger las contraseñas del cliente web deIBM Cognos Incentive Compensation Management.

Procedimiento1. Descargue la distribución de Jasypt más reciente.2. Descomprima el archivo en una ubicación a la que se pueda acceder fácilmente

a través de la línea de comandos, como, por ejemplo, el escritorio.3. Asegúrese de que la variable de entorno JAVA_HOME está establecida y de que

señala a la carpeta de la distribución Java.4. Abra una ventana de indicador de comandos y desplácese hasta la carpeta

Jasypt descomprimida.Atención: Si solamente está disponible Java 5, los usuarios también tendránque descargar ICU4J e incluir el archivo JAR al ejecutar las herramientas de laCLI de Jasypt.

Configuración del cifrado de contraseña del cliente webEl cliente web de Cognos Incentive Compensation Management debe estarconfigurado para interpretar los archivos de propiedades que contienen valorescifrados.

Procedimiento1. Abra el archivo applicationContext.xml.2. Edite el archivo para que tenga el aspecto de la siguiente sección de código:

<bean id="envConfig"class="org.jasypt.encryption.pbe.config.EncironmentStringPBEConfig"><property name="passwordEnvName" value="VARICENT_KEY" />

</bean>

<bean id="configEncryptor"class="org.jasypt.encryption.be.StandardPBEStringEncryptor"><property name="config" ref="envConfig" /></bean>




<constructor-arg ref="configEncryptor" /><property name="locations"><list>

<value>/WEB-INF/jdbc.properties</value><value>/WEBINF/ldap.properties</value><value>/WEB-INF/mail.properties</value><value>/WEBF-INF/saml.properties</value><value>/WEB-INF/siteminder.properties</value>

</list></property></bean>

Configuración del cifrado de contraseña del cliente web en unentorno Windows

Es necesario establecer una variable de entorno del sistema que contenga lacontraseña de cifrado antes del despliegue para que el cliente web de CognosIncentive Compensation Management sepa cómo descifrar las contraseñas cifradas.

Procedimiento1. Haga clic con el botón derecho en Mi PC y seleccione Propiedades.2. Vaya a la pestaña Avanzado y pulse Variables de entorno.3. Bajo Variables del sistema, pulse Nueva.4. Escriba VARICENT_KEY en el primer campo y su contraseña en el segundo

campo.5. Pulse Aceptar para aplicar todos los cambios.6. Si el servicio de contenedor de aplicación web está configurado para ejecutarse

con la cuenta de usuario Sistema local de Windows, será necesario reiniciarWindows.

Despliegue del cliente web con contraseñas cifradasPara desplegar el cliente web de Cognos Incentive Compensation Management, esnecesario que el archivo de propiedades correspondiente esté configurado con lascontraseñas cifradas.

Si se utiliza jdbc.properties como ejemplo:# Microsoft SQL Serverjdbc.productName=sqlserverjdbc.driverClassName=net.sourceforge.jtds.jdbc.Driverjdbc.url=jdbc:jtds:sqlserver://hostname:1433/database

#jdbc.url=jdbc:jtds:sqlserver://localhost:1433/database;instance=SQLEXPRESS

#jdbc.url=jdbc:jtds:sqlserver://localhost:1433/database;domain=DOMAIN;useNTML2=falsejdbc.username=sajdbc.password=ENC(1qZZsaIYYVQ11TsjITcqfg==)

Después de guardar el archivo, deberá reiniciar el servicio de aplicación web deCognos Incentive Compensation Management (por ejemplo, el servicio ApacheTomcat) para que los cambios entren en vigor. En este punto, la variable deentorno que contiene la clave de cifrado se puede eliminar.


Configuración del soporte de varios idiomas y de datosUnicode para el entorno local

Los usuarios pueden establecer su entorno local en el cliente web de IBM CognosIncentive Compensation Management con un parámetro de URL con un código dedos o cuatro letras que solamente debe pasarse una vez por página. Por ejemplo,utilice http://hostname/ICM/home.html?locale=fr para pasar al francés.


Están disponibles los siguientes idiomas:v Inglés: en [Valor predeterminado]. Esto también establecerá el idioma en inglés y

el formato de fecha en mes/día/año.v Inglés: en_GB. Esto establecerá el idioma en inglés y el formato de fecha en

día/mes/año.v Francés: frv Alemán: dev Español: es_ESv Japonés: jav Chino simplificado: zh_CNv Chino tradicional: zh_TWv Coreano: krv Italiano: itv Portugués de Brasil: pt_BRv Español de México: es_MXv Turco: trv Holandés: nlv Sueco: sv

Se puede dar soporte técnico a los tipos de base de datos siguientes:v SQL Server 2005, SQL Server 2005 Unicodev SQL Server 2008, SQL Server 2008 Unicodev SQL Server 2012, SQL Server 2012 Unicode

Procedimiento1. Edite el tipo de base de datos en el archivo IBM Cognos ICM Windows

Service.exe.config.Por ejemplo, <add key="DBType" value="SQLServer2005Unicode"/>.

2. Edite el tipo de base de datos en el archivo jdbc.properties.Por ejemplo, jdbc.productName=sqlserverunicode.

Envío de mensajes de correo electrónico a los usuarios cuando hayauna consulta pendiente

Puede seleccionar que se envíe un mensaje de correo electrónico automáticamenteal gestor de consultas designado cuando se lance una consulta en el cliente web deIBM Cognos Incentive Compensation Management.


Tendrá que configurar valores en el cliente y en los archivos de configuración webde IBM Cognos Incentive Compensation Management para que el mensaje decorreo electrónico se envíe al usuario adecuado cuando se inicie una consulta.

Procedimiento1. Configure los valores de correo electrónico en el archivo mail.properties.

El archivo mail.properties se encuentra en el directorio siguiente:...\webapps\ICM\WEB-INF

Atención: Deberá volver a cargar el archivo ICM.war después de realizarcambios en los archivos de configuración.

2. en el cliente administrativo, vaya a Administrador > Opciones administrativasy pulse la pestaña Portal Access.

3. Seleccione la casilla de verificación Enviar correo electrónico a los usuarioscuando haya una consulta pendiente.

4. Pulse Aceptar.

Cómo evitar que los informes iniciales carguen una gran cantidad dedatos

Si configura el archivo reporting.properties de la carpeta WEB-INF del archivoWAR de IBM Cognos Incentive Compensation Management, puede limitar elnúmero de filas mostradas por una transformación de agregación en el cliente webde Cognos Incentive Compensation Management.

Si un informe inicial contiene una transformación de agregación utilizada por unacuadrícula de datos, un gráfico, una correlación o un control de lista de selección yla transformación de agregación sobrepasa el límite de filas establecido en elarchivo reporting.properties, el informe no se mostrará en el cliente web deCognos Incentive Compensation Management. De forma predeterminada, el valorestá establecido en '0', lo que significa que no hay ningún límite que impida larepresentación del informe.

Procedimiento1. En el archivo ICM.war, vaya a la carpeta WEB-INF.2. Abra el archivo reporting.properties.3. Cambie el valor de reporting.aggregateTransformationRowLimit por el número

máximo de filas que el origen de transformación de agregación puede contenerpara permitir la representación del informe inicial.

4. Reinicie la aplicación de servidor web en la que se está ejecutando el clienteweb de Cognos Incentive Compensation Management.

Límites de fila de cuadrícula de datos de informe inicialEl número de filas que se pueden mostrar en un informe inicial en el cliente webse configura en el archivo reporting.properties.

De forma predeterminada, el límite de filas se establece en 15.000 filas. Puedeincrementar este valor; sin embargo, cuando más elevado sea el número de límitede filas, más tiempo tardará el informe en cargarse en el cliente web. El archivoreporting.properties se encuentra en el directorio siguiente: C:\Archivos deprograma\Apache Software Foundation\Tomcat 6.0\webapps\ICM\WEB-INF.


Si tiene una cuadrícula de datos de gran tamaño y desea limitar el número de filasque se muestran en el informe, puede añadir restricciones y filtros al origen alcrear el informe.

Aspecto del cliente webLa forma en la que las pestañas web se muestran a los distintos usuarios web en elcliente web se configura en el módulo Portal Access en el cliente de CognosIncentive Compensation Management.

El esquema de color y el logotipo mostrados en la pantalla de inicio de sesión parael cliente web también se pueden personalizar en el cliente web.

Configuración de las pestañas webEn el módulo Portal Access del cliente, los administradores pueden personalizarlas pestañas que aparecen en el cliente web de IBM Cognos IncentiveCompensation Management.

Los administradores pueden seleccionar el nombre, el tipo y la secuencia de laspestañas. Esto permite a los administrador crear páginas principales controladaspor informes que sean adecuadas para los distintos grupos de Portal Access.

Se pueden crear pestañas web para planes, informes iniciales, informes a medida yformularios web individuales. También se pueden crear pestañas de móduloseleccionando Edición de datos, Consultas, Libro mayor de beneficiarios, Creaciónde informes, Formularios web o URL externas. Los usuarios pueden organizar laspestañas en grupos de pestañas web, con lo que se crean subpestañas en el clienteweb de Cognos Incentive Compensation Management.

Están disponibles las siguientes pestañas web:v Plan de remuneraciónv Asignación de adelantov Informe de adelantosv URL externov Módulov Edición de datosv Consultasv Libro mayor de beneficiariosv Creación de informesv Formularios webv Informe inicialv Informe a medidav Formulario web

Cuando se asigna un solo objeto a una pestaña web, no se muestra ningunasubpestaña, y se representa directamente el plan, el informe o el formulario.Cuando se asigna más de un objeto a un grupo de pestañas, aparecen lassubpestañas, y es necesario realizar una selección para que aparezca información.Una vez creadas las pestañas web, los administradores deben asignar acceso a lapestaña en sí y los objetos que se incluyen en la pestaña. Si los usuarios no tienenacceso a la pestaña web o a las subpestañas, no las verán en el cliente web deCognos Incentive Compensation Management.


Importante: Si va a actualizar un modelo de la versión 6.0, las pestañas yaconfiguradas se mostrará en Portal Access y en el cliente web de Cognos IncentiveCompensation Management.

Creación de una pestaña webDebe añadir pestañas web en Portal Access para que los usuarios puedan acceder alos elementos del cliente web de IBM Cognos Incentive CompensationManagement.

Procedimiento1. En Portal Access, pulse la pestaña Pestañas web.2. Pulse el icono Añadir pestaña web o pulse con el botón derecho del ratón en la

pantalla y seleccione Añadir pestaña web.3. Dé nombre a la pestaña web.4. Seleccione el tipo de pestaña web en Tipo.5. Seleccione el objeto que se asigna al tipo de pestaña web.

Por ejemplo, si selecciona el tipo Plan de remuneración, debe seleccionar unplan de remuneración.

6. Pulse Finalizar.

Consejo: La primera pestaña que aparece en Portal Access es la primerapestaña que se mostrará en el cliente web de Cognos Incentive CompensationManagement.

Cambio de posición de las pestañas webPuede cambiar el orden y la colocación de las pestañas web después de crearlas enel cliente de IBM Cognos Incentive Compensation Management.

Procedimiento1. En Portal Access, pulse la pestaña Pestañas web.2. Pulse la tecla Mayús y arrastre la pestaña web a la ubicación que desee.

Edición de una pestaña webDespués de crear una pestaña web, puede cambiar el nombre, el tipo y el objetoque se le asignará en el cliente de IBM Cognos Incentive CompensationManagement.

Procedimiento1. En Portal Access, pulse la pestaña Pestañas web.2. Pulse con el botón derecho en una pestaña web y seleccione Editar pestaña

web.3. Realice los cambios necesarios y pulse Finalizar.

Supresión de una pestaña webPuede eliminar las pestañas web que ya no sean necesarias en el cliente de IBMCognos Incentive Compensation Management.

Procedimiento1. En Portal Access, pulse la pestaña Pestañas web.2. Pulse con el botón derecho en una pestaña web y seleccione Suprimir.


Adición de un grupo de pestañas webSe pueden añadir grupos de pestañas web para organizar las pestañas web en elcliente de IBM Cognos Incentive Compensation Management.

Procedimiento1. En Portal Access, pulse la pestaña Pestañas web.2. Pulse el icono Añadir grupo de pestañas web o pulse con el botón derecho del

ratón en la ventana y seleccione Añadir grupo de pestañas web.3. Efectúe una doble pulsación en Nuevo grupo de pestañas web y escriba un

nombre.4. Pulse una pestaña web y arrástrela al grupo de pestañas web.

Eliminación de una pestaña web de un grupoPuede mover una pestaña web de un grupo a otro en el cliente de IBM CognosIncentive Compensation Management.

Procedimiento1. En Portal Access, pulse la pestaña Pestañas web.2. Pulse una pestaña web y muévala por encima del grupo de pestañas web

mientras mantiene pulsada la tecla Mayús.

Establecimiento del acceso a las pestañas webEl usuario necesita acceso a la pestaña web y también a los objetos que contienepara verlos en el cliente web de IBM Cognos Incentive CompensationManagement.

Por ejemplo, si tiene una pestaña web Creación de informes, necesita acceso a lapestaña web Creación de informes y a cada uno de los informes iniciales.

Procedimiento1. En Portal Access, pulse la pestaña Asignación.2. Pulse el botón del ratón debajo de una columna para ver la flecha del menú

desplegable.3. En el menú desplegable, seleccione el árbol Acceso correspondiente a la

pestaña web.

Cambio del tema del cliente webEl esquema de color y el logotipo mostrados en la parte superior de la pantalla enel cliente web de IBM Cognos Incentive Compensation Management se puedenpersonalizar.

Procedimiento1. En el cliente de Cognos Incentive Compensation Management, seleccione

Herramientas > Temas.2. Seleccione la casilla de verificación Habilitar cabecera personalizada.3. Busque la imagen que desea.4. Seleccione Estándar o Salesforce.com para el tema web.5. Pulse Aceptar.

Atención: Los cambios realizados aquí se aplican tanto al cliente web como alcliente de Cognos Incentive Compensation Management. Puede que tenga que


volverse a cargar el despliegue web para que la cabecera personalizada seaplique en el cliente web de Cognos Incentive Compensation Management.



Capítulo 5. Autenticación e inicio de sesión

Existen diversas opciones de comunicación y autenticación al configurarSiteMinder, OpenSSO o LDAP para la autenticación del cliente web de IBMCognos Incentive Compensation Management.

Opciones de ruta de comunicaciónExisten varias opciones para la comunicación entre los componentes de CognosIncentive Compensation Management.

Cognos Incentive Compensation Management consta de los componentes que seindican a continuación, y existen diversas opciones para que se comuniquen entresí:v clientev Servidor de aplicacionesv Servidor de bases de datosv Servidor webv Cliente web

Opciones de seguridad para la comunicación entre el cliente yel servidor de aplicaciones

Puede elegir diferentes niveles de seguridad para la comunicación entre el clientede Cognos Incentive Compensation Management y el servidor de aplicaciones.

En el archivo de configuración del servicio de Windows Cognos IncentiveCompensation Management están disponibles las opciones de seguridad siguientes:

Seguridad TLS - cifrado de la comunicación<add key="SecurityMode" value="TLS"/><add key="ServiceCertificateName" value="varicent.com"/>

Dominio de Windows - red de confianza<add key="SecurityMode" value="Windows"/>

Sin seguridad - sin seguridad<add key="SecurityMode" value="None"/>

Opciones de seguridad para la comunicación entre el servidorde aplicaciones y el servidor de bases de datos

Puede elegir diferentes niveles de seguridad para la comunicación entre el servidorde aplicaciones de Cognos Incentive Compensation Management y el servidor debases de datos.


Puede seleccionar los siguientes niveles de seguridad:

Red de confianzaTradicionalmente, el servidor de aplicaciones web y el servidor de bases dedatos están en la misma red de confianza y no se utiliza el cifrado decanal.

Red de confianza y SSLNuestro conector JDBC desde la aplicación Web hasta el servidor de basesde datos se puede configurar de forma opcional si se desea utilizar SSLpara cifrar la comunicación.

Métodos de comunicación entre el cliente web y la aplicaciónweb

Hay dos tipos distintos de métodos de comunicación disponibles entre el clienteweb y la aplicación web de Cognos Incentive Compensation Management.

Puede seleccionar los siguientes métodos de comunicación:

HTTP tradicional (comunicación no cifrada)HTTP tradicional es el valor de comunicación predeterminado que seutiliza para la comunicación entre el cliente web y la aplicación webCognos Incentive Compensation Management.

HTTP seguro (HTTPS) (comunicación cifrada)La comunicación cifrada se puede lograr mediante el uso de un certificadoSSL que se instala en el servidor web.

Métodos de cifrado para la comunicación entre el servidor deaplicaciones web y el servidor de bases de datos

El servidor de aplicaciones web y el servidor de bases de datos suelen estarinstalados en la misma red de confianza, pero puede optar por utilizar SSL paracifrar la comunicación.

Puede seleccionar los siguientes métodos de cifrado:

Red de confianzaTradicionalmente, el servidor de aplicaciones web y el servidor de bases dedatos están en la misma red de confianza y no se utiliza el cifrado decanal.

Red de confianza y SSLNuestro conector JDBC desde la aplicación web hasta el servidor de basesde datos se puede configurar de forma opcional si se desea utilizar SSLpara cifrar la comunicación.

Opciones de autenticaciónExisten diversas opciones de autenticación para utilizarlas con IBM CognosIncentive Compensation Management.

Cognos Incentive Compensation Management ofrece las opciones de autenticaciónsiguientes:

nativa Los inicios de sesión específicos de Cognos Incentive CompensationManagement se determinan en Acceso del portal, no en SSO (inicio desesión único).


Directorio LDAPPor lo general, integración de Microsoft Active Directory, que permite a losusuarios utilizar sus credenciales de red para iniciar sesión, pero que no lohace automáticamente.

Cualquier recurso SSO compatible con SAML 2 (por ejemplo, CA SiteMinder,Sun OpenSSO, PingIdentity)

Cognos Incentive Compensation Management da soporte de forma nativa ala autenticación SAML2, y autentica automáticamente a los usuarios quetengan un recurso de credenciales compatible con SAML2. SSO es unmétodo de control de acceso que permite a un usuario iniciar sesión unavez y acceder a los recursos de diferentes sistemas de software sin que sele solicite que inicie sesión de nuevo.

SSO personalizadoAlgunos clientes han desarrollado sus propias opciones de autenticaciónpersonalizada. No están soportadas directamente por el equipo de soportede Cognos Incentive Compensation Management.

Configuración de SiteMinderSiteMinder permite a los clientes gestionar los usuarios y los privilegios en unrepositorio externo, incluido un directorio LDAP. Para obtener más información,póngase en contacto con un representante de soporte al cliente de CognosIncentive Compensation Management.

Configuración del cliente web para CA SiteMinderSi desea utilizar SiteMinder para acceder al cliente web de Cognos IncentiveCompensation Management, los administradores de SiteMinder deberán asegurarsede que el cliente web está incluido en el dominio de SiteMinder.

Procedimiento1. Abra web.xml en un editor de texto.2. Cambie security.xml por security-siteminder.xml.3. En el archivo siteminder.properties, defina qué propiedad se utiliza para la

autenticación.De forma predeterminada, Cognos Incentive Compensation Managementconsulta el atributo SM_USER en la cabecera de SiteMinder y utiliza para elcampo Correo electrónico el mismo valor que el del campo Correo electrónicode la tabla de beneficiarios de Cognos Incentive Compensation Management. Sidesea utilizar una columna diferente para la autenticación, cambie el valor desiteminder.userKeyColumn.siteminder.userKeyAttribute=SM_USERsiteminder.userKeyColumn=Email

4. Guarde web.xml y siteminder.properties.5. Reinicie el cliente web de Cognos Incentive Compensation Management

mediante la consola de gestión del servidor web.Los usuarios podrán iniciar sesión en el cliente web con su autenticación de CASiteMinder.

Acceso al cliente web con SiteMinderPara acceder al cliente web de IBM Cognos, debe ir al sitio de SiteMinder yespecificar su nombre de usuario y su contraseña.

Capítulo 5. Autenticación e inicio de sesión 83

Una vez que haya iniciado la sesión en SiteMinder, puede ir a la página principaldel cliente web de Cognos Incentive Compensation Management sin necesidad deespecificar de nuevo sus credenciales de inicio de sesión.

El administrador de SiteMinder puede proporcionar un enlace que le llevedirectamente a la página principal del cliente web de Cognos IncentiveCompensation Management desde el sitio de SiteMinder. Si no se proporcionaningún enlace, puede ir a la página principal del cliente web de Cognos IncentiveCompensation Management por sí mismo después de iniciar sesión en SiteMinder.

Tenga en cuenta que el URL utilizado para ir al cliente web de Cognos IncentiveCompensation Management debe llevarle directamente a la página principal delcliente web de Cognos Incentive Compensation Management (o a otra pantallaposterior a la autenticación), no a la pantalla de inicio de sesión del cliente web(por ejemplo, a http://...home.html, no a http://...login.html). Si va a lapantalla previa a la autenticación del cliente web, se le pedirá que especifique sunombre de usuario y su contraseña de nuevo.

Configuración de OpenSSOIBM Cognos Incentive Compensation Management da soporte de forma nativa a laautenticación a través de Sun OpenSSO, un proveedor de identidad compatible conSAML 2.

En los pasos siguientes se ilustra el modo en que el lenguaje SAML 2 y la soluciónde inicio de sesión único OpenSSO funcionan para autenticar a los usuarios deCognos Incentive Compensation Management para el cliente web de CognosIncentive Compensation Management.

Atención: Cognos Incentive Compensation Management da soporte de formanativa a todos los proveedores de identidad compatibles con SAML 2, por lo que,si bien en este documento se utiliza OpenSSO a modo de ejemplo, los pasossiguientes también se aplican a los demás proveedores de identidad compatiblescon SAML 2.

1. Abra el cliente web de Cognos Incentive Compensation Management en elnavegador.

2. Se evalúa el cliente.3. Cognos Incentive Compensation Management redirige el navegador web al

URL de SSO.4. El navegador web se redirige al URL de SSO.5. El proveedor de SSO de la red del cliente genera una respuesta SAML.6. El cliente devuelve la respuesta SAML codificada al navegador.7. El navegador devuelve la respuesta SAML codificada a Cognos Incentive

Compensation Management.8. Cognos Incentive Compensation Management verifica la respuesta SAML.9. El usuario inicia sesión en Cognos Incentive Compensation Management.

OpenSSO se puede desplegar en una amplia gama de plataformas y contenedoresde aplicaciones, incluidas las aplicaciones siguientes:

Oracle Glassfish ServerServidor de aplicaciones gratuito totalmente compatible con J2EE.


Apache TomcatEl más sencillo de configurar.

En este documento se describe la instalación de OpenSSO en un entorno ApacheTomcat.

Descarga e instalación de OpenSSOOpenSSO se puede descargar e instalar en un entorno Apache Tomcat para su usocon IBM Cognos Incentive Compensation Management.

Antes de empezar

Descargue la versión más reciente de OpenSSO, así como Apache Tomcat y Java.Por ejemplo, descargue lo siguiente:v Java 6 Development Kitv Apache Tomcat 6v OpenSSO Enterprise 8

Procedimiento1. Establezca la agrupación de memoria inicial y máxima de Tomcat en 1024 MB.2. Vaya a Tomcat Manager y despliegue el archivo opensso.war, que se encuentra

en la carpeta opensso/deployable-war de la distribución de OpenSSO.3. Vaya a http://ssohost.domain.com:8080/opensso e inicie el asistente de

configuración de OpenSSO.

Configuración de OpenSSODurante la configuración de la autenticación de OpenSSO con el cliente web deIBM Cognos Incentive Compensation Management, cuando finalice el asistente deconfiguración de OpenSSO, deberá especificar un almacén de datos externo.

Procedimiento1. Inicie sesión en el área de administración de OpenSSO mediante amadmin.

Atención: Tenga en cuenta que todos los URL enviados deben contenernombres de dominio totalmente calificados; por ejemplo, host.domain.com. Nose aceptan los nombres cortos, como, por ejemplo, localhost o host.

2. Aquí se puede especificar un almacén de datos de usuario, como MicrosoftActive Directory.OpenSSO proporciona un servicio integrado con fines de desarrollo y pruebassolamente. Para la producción, se recomienda el producto gratuito OpenDS deOracle si no hay disponible ningún almacén de datos existente. El serviciointegrado se puede utilizar temporalmente para este despliegue hasta que sepueda configurar un almacén de datos externo correctamente más adelante.

Configuración del proveedor de identidad (IDP)Durante la configuración de la autenticación de OpenSSO con el cliente web deIBM Cognos Incentive Compensation Management, para configurar el proveedorde identidad deberá configurar el almacén de claves de OpenSSO.

Configuración del almacén de clavesDurante la configuración de la autenticación de OpenSSO con el cliente web deIBM Cognos Incentive Compensation Management, antes de crear un proveedor deidentidad alojado, deberá configurar el almacén de claves.


OpenSSO proporciona una clave de prueba predeterminada con fines de prueba.Esta clave no debe utilizarse en los entornos de producción.

Adición y configuración del proveedor de identidadDurante la configuración de la autenticación de OpenSSO con el cliente web deIBM Cognos Incentive Compensation Management, debe seleccionar la clave defirma, elegir un nombre para el nuevo círculo de confianza y correlacionar unatributo para utilizarlo como ID de nombre de SAML (SAML NameID).

Procedimiento1. En la pestaña Common Tasks, bajo la cabecera Create SAMLv2 Providers,

pulse Create Hosted Identity Provider.El nombre del IDP debe estar rellenado.

2. Seleccione la clave de firma importada anteriormente.3. Elija un nombre para el nuevo círculo de confianza.4. Correlacione un atributo para utilizarlo en SAML NameID.

Suele ser la dirección de correo electrónico del usuario (el atributo de correoelectrónico).

5. Pulse Configure > Finish.

Importante: Si no se había especificado un almacén de datos de usuarioexterno en el asistente de configuración de OpenSSO, deberá añadirse unusuario de prueba mediante la interfaz de administración de OpenSSO. Sepuede utilizar la cuenta de demostración, pero seguirá siendo necesarioespecificar una dirección de correo electrónico en el perfil del usuario.

Configuración del proveedor de serviciosPara desplegar el cliente web de IBM Cognos Incentive CompensationManagement como proveedor de servicios SAML, tendrá que efectuar algunasconfiguraciones en Apache Tomcat y en el cliente web de Cognos IncentiveCompensation Management.

Para poder desplegar el cliente web de Cognos Incentive CompensationManagement como proveedor de servicios (SP) SAML, es necesario obtener estostres elementos del proveedor de identidad (IDP):v Archivo de metadatos de SAML del proveedor de identidad (normalmente

idp.xml)v Archivo de almacén de claves de SSL (normalmente keystore.jks)v Credenciales de clave de firma en el almacén de claves (alias y contraseña)

Para comenzar, despliegue el archivo ICM.war en el servidor de aplicaciones web.

Bibliotecas validadasLa implementación SAML del cliente web de IBM Cognos Incentive CompensationManagement requiere el uso de más componentes XML avanzados aparte de losdisponibles en la biblioteca estándar.

Para utilizar estos componentes, es necesario configurar la máquina virtual Java.La plataforma Java permite que los usuarios reemplacen las bibliotecas estándarmediante el mecanismo Endorsed Standards Override Mechanism, con lo que lasbibliotecas necesarias se copian en una carpeta validada especial.


Configuración de Apache Tomcat Versión 6:

Durante la configuración de la autenticación de OpenSSO con el cliente web deIBM Cognos Incentive Compensation Management, la carpeta validada("endorsed") desplegada debe copiarse en una carpeta nueva denominada commonen la carpeta de Apache Tomcat principal.

Procedimiento

1. Cree una nueva carpeta llamada common en la carpeta principal de Tomcat.2. Copie la carpeta <ruta de Tomcat>/webapps/ICM/WEB-INF/endorsed desplegada

en la carpeta principal de Apache Tomcat, para que los archivos validadosestén en <ruta de Tomcat>/common/endorsed.

3. Reinicie el servicio Apache Tomcat.

Configuración de OpenSSO e IBM Cognos IncentiveCompensation ManagementDeben configurarse algunos valores para que OpenSSO funcione con CognosIncentive Compensation Management.

Procedimiento1. Configure el acceso a la base de datos en el archivo jdbc.properties.2. Edite web.xml y cambie security.xml por security-saml.xml.3. Copie los archivos idp.xml y keystore.jks obtenidos del proveedor de

identidad en la carpeta deployed/ICM/WEB-INF/saml.4. Edite saml.properties.

Importante: Cuando SAML 2.0 está desplegado en el cliente web y se utilizacon un proveedor IDP que no da soporte a la etiqueta de ámbitoAuthnRequest, esta etiqueta ahora se puede desactivar si se establece el valorde saml.includeScoping en false.

5. Sustituya los marcadores de posición de claves de firma por el alias de clave yla contraseña obtenidos del proveedor de identidad.

6. Seleccione la columna de la tabla de beneficiarios correspondiente (especificadacomo saml.userKeyColumn) si no está utilizando una dirección de correoelectrónico como ID de nombre de SAML (SAML NameID).

7. Vuelva a cargar Cognos Incentive Compensation Management.

Registro de IBM Cognos Incentive Compensation Managementcomo el proveedor de serviciosDebe establecer Cognos Incentive Compensation Management como el proveedorde servicios.

Procedimiento1. En la pestaña Common Tasks, bajo la cabecera Create SAMLv2 Providers,

pulse Register Remote Service Provider.2. Especifique el URL de metadatos de SAML de Cognos Incentive Compensation

Management (vea la nota a continuación) en el primer campo.Asegúrese de que se añade al círculo de confianza existente (por ejemplo, ICM)que se ha creado al configurar el proveedor de identidad (esta opción sueleestar seleccionada de forma predeterminada).

3. Compruebe que el servicio se está ejecutando; para ello, acceda al URL desdeun navegador.


Importante: El URL de metadatos, de forma predeterminada, está disponibleen el subdirectorio /saml/metadata desde el despliegue de Cognos IncentiveCompensation Management instalado. Un despliegue habitual se correspondecon el patrón siguiente: http://<nombre_servidor>/ICM/saml/metadata.

4. Añada el mismo atributo correlacionado en la configuración del proveedor deidentidad (suele ser el atributo de correo).

Verificación del inicio de sesión de IBM Cognos IncentiveCompensation ManagementPuede asegurarse de que el cliente web de Cognos Incentive CompensationManagement se ha configurado correctamente; para ello, vaya a la página de iniciode sesión del cliente web.

Procedimiento1. Vaya a http://<nombre_servidor>/ICM.

El navegador deberá redirigirse automáticamente a la pantalla de inicio desesión de OpenSSO.

2. Inicie sesión.Una vez que OpenSSO haya autenticado correctamente a un usuario, elnavegador se redirigirá a la página principal del cliente web de CognosIncentive Compensation Management.

Importante: El usuario que ha iniciado la sesión puede cerrar la sesión en elcliente web de Cognos Incentive Compensation Management, pero no cerrará lasesión del inicio de sesión único (SSO) hasta que cierre la sesión en elproveedor de identidad (IDP). Esto significa que si se cierra la sesión en elcliente web y se vuelve inmediatamente a alguna vista de Cognos IncentiveCompensation Management, la sesión del usuario se iniciará automáticamente.

Configuración de LDAP para el cliente webPara simplificar el proceso de inicio de sesión, se puede utilizar LDAP para definirel acceso a la aplicación web de IBM Cognos Incentive CompensationManagement.

El cliente web de Cognos Incentive Compensation Management se puedeconfigurar para que recupere la información de autenticación de usuario de undirectorio LDAP con los proveedores de LDAP siguientes:v Microsoft Active Directory, Windows 2000 con Service Pack 4v Microsoft Active Directory, Windows 2003v Microsoft Active Directory, Windows 2008 R2v Microsoft Active Directory, Windows 2012v Open LDAP 2.0.27

Importante: LDAP se puede utilizar para obtener las credenciales de inicio desesión del usuario para el cliente web de Cognos Incentive CompensationManagement, pero no es una solución de SSO. Los usuarios web de CognosIncentive Compensation Management tendrán que especificar las credenciales deinicio de sesión para acceder a la aplicación web.


Requisitos de validaciónLa columna LDAP que se va a correlacionar con IBM Cognos IncentiveCompensation Management para la validación debe contener datos que coincidancon la columna correspondiente en Cognos Incentive Compensation Management.

De forma predeterminada, Cognos Incentive Compensation Management consultael atributo de correo en el directorio LDAP para la validación y compara estecampo con el campo de dirección de correo electrónico de la tabla de beneficiarios.Si el cliente web de Cognos Incentive Compensation Management va a utilizardirecciones de correo electrónico para la validación de los usuarios, las direccionesde correo electrónico de los beneficiarios que están cargadas en la tabla debeneficiarios de Cognos Incentive Compensation Management deben ser idénticasa las cargadas en el directorio LDAP.

Configuración del archivo ldap.propertiesEl archivo ldap.properties define los detalles de la configuración para laautenticación del cliente web de IBM Cognos Incentive Compensation Managementcon LDAP, como el nombre del servidor LDAP y la contraseña del gestor.

Los cambios realizados en este archivo permiten que Cognos IncentiveCompensation Management se conecte con el directorio LDAP del cliente.

Procedimiento

Especifique la dirección URL del servidor LDAP, así como el número de puertoutilizado por el servidor LDAP.Si DC\=yourdomain,DC\=com no se especifica aquí, debe especificarse en la línealdap.managerDn: ldap.providerUrl=ldap://localhost:389/dc=example,dc=com.

Especificación de nombres distinguidos (Dn) en el archivoldap.propertiesEl nombre de usuario y la contraseña del gestor de LDAP se definen en el archivoldap.properties al configurar el cliente web de IBM Cognos IncentiveCompensation Management para la autenticación con LDAP.


cn hace referencia al nombre común (por ejemplo, Juan Pérez) y ou hace referenciaa la unidad organizativa.

Al configurar el cliente web de Cognos Incentive Compensation Management paraque utilice la autenticación LDAP, suele ser mejor utilizar el nombre distinguidocompleto (Dn) para los atributos managerDn y userSearchBase:ldap.managerDn=cn=Administrator,ou=Users,dc=example,dc=comldap.userSearchBase=ou=Accounts,dc=example,dc=com

Importante: Los componentes DC se especifican en estas cadenas. Si utilizanombres distinguidos completos que especifican los componentes DC en lascadenas managerDn y userSearchBase, no debe especificar los componentes DC enla cadena providerUrl.

Por ejemplo, utilice la cadena siguiente: ldap.providerUrl=ldap://localhost:389pero no lo siguiente: ldap.providerUrl=ldap://localhost:389/dc=example,dc=com.


Procedimiento1. Defina la raíz del árbol de búsqueda de usuarios.

Esta información es propia de la configuración LDAP del cliente, y debeproporcionarla el especialista en LDAP de este.ldap.userSearchBase=ou=Accounts

2. Se puede utilizar el campo userSearchFilter para limitar la búsqueda a losmiembros del grupo.Este campo no debería tener que cambiarse.ldap.userSearchFilter=(sAMAccountName={0})

3. Correlacione el atributo mail de LDAP internamente con la columnacorrespondiente.Normalmente, el atributo de correo se correlaciona con el correo electrónico yno es necesario cambiarlo.ldap.userKeyAttribute=mail

ldap.userKeyColumn=Email

Configuración del archivo web.xmlPara habilitar la autenticación LDAP con el cliente web de IBM Cognos IncentiveCompensation Management, debe configurarse el archivo web.xml de la carpetaWEB-INF.

Procedimiento1. En el archivo web.xml, cambie /WEB-INF/security.xml por /WEB-INF/security-

ldap.xml para habilitar la autenticación LDAP.2. Guarde los archivos web.xml y ldap.properties.3. Reinicie el cliente web de Cognos Incentive Compensation Management.

Los usuarios pueden iniciar sesión en el cliente web de Cognos IncentiveCompensation Management con las credenciales de autenticación almacenadasen el directorio LDAP.


Capítulo 6. Integración

El cliente web y el cliente de IBM Cognos Incentive Compensation Management sepueden configurar para integrarlos con aplicaciones externas, como Salesforce.com,o para que se pueda acceder a ellos desde dichas aplicaciones.

El cliente de Cognos Incentive Compensation Management se puede integrar conla aplicación IBM Cognos Territory and Quota Management y la aplicación IBMCognos Producer Lifecycle and Credential Management.

Los informes de detalle de asignación creados en Cognos Territory and QuotaManagement y las tablas de Cognos Producer Lifecycle and CredentialManagement se pueden importar y utilizar como orígenes en los cálculos y losinformes de Cognos Incentive Compensation Management.

Conexión a IBM Cognos Territory and Quota ManagementPara que el cliente de IBM Cognos Incentive Compensation Management importedatos de Cognos Territory and Quota Management, el archivo de configuración delservicio de Windows Cognos Incentive Compensation Management debeactualizarse para que señale a la instancia de Cognos Territory and QuotaManagement.


Compensation Management.2. Vaya a la sección TerritoryManagementServiceAddress.3. En el campo Value, escriba el URL que utiliza para iniciar sesión en Cognos

Territory and Quota Management.Debe omitir HTTPS:// en el URL y añadir :8443 al final del URL.

Conexión a IBM Cognos Producer Lifecycle and CredentialManagement

Para que el cliente de IBM Cognos Incentive Compensation Management importedatos de Cognos Producer Lifecycle and Credential Management, el archivo deconfiguración del servicio de Windows Cognos Incentive CompensationManagement debe actualizarse para que señale a la aplicación Cognos ProducerLifecycle and Credential Management.


Compensation Management.2. Vaya a la sección PLCMServiceAddress.3. En el campo Value, escriba el URL que utiliza para iniciar sesión en Cognos

Producer Lifecycle and Credential Management.


Configuración del cliente web de IBM Cognos Incentive CompensationManagement para Salesforce.com

Después de instalar el cliente web de Cognos Incentive CompensationManagement, el archivo de configuración web web.xml tiene que modificarse paraque se pueda acceder al cliente web a través de Salesforce.com.

El cliente web de Cognos Incentive Compensation Management se debe desplegarprimero.

Procedimiento1. Vaya al archivo web.xml, que de forma predeterminada se encuentra en la

ubicación siguiente: C:\Archivos de programa\Apache SoftwareFoundation\Tomcat 6.0\webapps\ICM\WEB-INF.

2. En la sección Parameters, cambie security.xml por security-salesforce-composite.xml.

3. Después de guardar el archivo, reinicie el cliente web de Cognos IncentiveCompensation Management para que los cambios entren en vigor.

Acceso a IBM Cognos Incentive Compensation Management desdeSalesforce.com

Puede hacer que la aplicación Cognos Incentive Compensation Management seaaccesible desde una pestaña de Salesforce.

Procedimiento1. Inicie sesión en Salesforce.com con un ID de usuario que tenga derechos

administrativos.2. Seleccione el enlace Setup en la parte superior de la pantalla.3. En el panel izquierdo, seleccione Create > Tabs en la sección App Setup.4. Pulse New en la sección Web Tabs. De este modo podrá crear una pestaña

personalizada que muestre el contenido de Cognos Incentive CompensationManagement dentro de la ventana Salesforce.

5. Puede optar por utilizar la anchura total de la página para mostrar laaplicación Cognos Incentive Compensation Management o por tenervisualizada la barra lateral de Salesforce.

6. Pulse Next cuando haya realizado su selección.7. Defina las propiedades de contenido y visualización de la pestaña de Cognos

Incentive Compensation Management; para ello, siga estos pasos:a. En la sección Tab Content Definition, seleccione URL en el menú Tab

Type.b. En el campo Tab Label, especifique el texto que desea que se muestre en

la etiqueta.c. En el campo Tab Name, asigne a la pestaña un nombre exclusivo. Puede

coincidir con la etiqueta de la pestaña.d. Elija el color de la pestaña; para ello, seleccione un estilo de pestaña en

Tab Style en la pantalla de estilos.e. El campo Content Frame Height permite indicar la altura (en píxeles) que

tendrá el marco de contenido de Cognos Incentive CompensationManagement.Especifique una altura de marco de 800 píxeles como mínimo.


8. También tiene la opción de habilitar la pestaña de Cognos IncentiveCompensation Management para el uso móvil; para ello, especifique unapágina inicial personalizada y escriba una descripción para la pestaña.Sin embargo, estos campos no son obligatorios.

9. Pulse el botón Next después de especificar la información de contenido de lapestaña y la información de propiedades de visualización.

10. En la pantalla de detalles de URL, defina la dirección de la aplicación web deCognos Incentive Compensation Management en el servidor de aplicacionesweb en el que se ha desplegado Cognos Incentive CompensationManagement.No es necesario definir campos de fusión en esta pantalla.

11. En URL, especifique el URL de la página principal de la aplicación web deCognos Incentive Compensation Management y seleccione Unicode encoding.Si el cliente web de Cognos Incentive Compensation Management estádesplegado en https://localhost8080/ICM, el URL del cliente web de CognosIncentive Compensation Management para Salesforce es el mismo que el URLsiguiente: https://localhost:8080/ICM/sforce_composite_login?SessionId={!API.Session_ID}&ServerURL={!API.Partner_Server_URL_100}

Atención: Debe incluir los guiones bajos en el URL.12. Pulse Next cuando haya finalizado.13. En la pantalla Add to Profiles puede elegir los perfiles de usuario que podrán

ver la nueva pestaña de Cognos Incentive Compensation Management.14. En la página Add to Custom Apps puede elegir las aplicaciones

personalizadas para las que estará visible la pestaña de Cognos IncentiveCompensation Management.

15. Pulse Guardar.Ahora se puede acceder a la aplicación Cognos Incentive CompensationManagement desde la pestaña que se acaba de crear.

Integración del cliente web con Oracle CRMLos usuarios de Oracle pueden instalar una pestaña de Cognos IncentiveCompensation Management, lo que permite el acceso directo a Cognos IncentiveCompensation Management desde el sitio de Oracle CRM.

Los usuarios que se han iniciado sesión en Oracle CRM no tendrán que volverse aautenticar cuando vayan a la pestaña web de Cognos Incentive CompensationManagement.

Importante: Una vez que la aplicación web Cognos Incentive CompensationManagement esté configurada para la integración con Oracle CRM, los usuarios nopodrán conectarse directamente al cliente web de Cognos Incentive CompensationManagement. El único modo de acceder a Cognos Incentive CompensationManagement será a través de la pestaña de Oracle CRM.

Configuración del cliente de IBM Cognos IncentiveCompensation Management para la integración con OracleCRM

Para integrar Oracle CRM con Cognos Incentive Compensation Management, esnecesario añadir una columna a la tabla de beneficiarios que contenga los nombresde usuario de Oracle CRM de todos los beneficiarios.

Capítulo 6. Integración 93

Procedimiento1. En el modelo al que se accederá a través de Oracle CRM, añada una columna

de texto a la tabla de beneficiarios para utilizarla en la integración con Oracle.Por ejemplo, añada una columna de texto denominada ID de usuario deOracle.

2. Añada a la nueva columna el nombre de usuario de Oracle CRM de cadabeneficiario que vaya a acceder al cliente web de Cognos IncentiveCompensation Management a través de una pestaña en Oracle CRM; porejemplo, rivacent/huddle.

3. Cree una nueva pestaña en Portal Access y habilite el acceso web para losusuarios.a. Vaya a Portal Access > Pestañas web y añada una pestaña web de tipo

Módulo con un objeto de Edición de datos asignado.b. Cree un grupo de Portal Access que contenga todos los beneficiarios que

accederán a Cognos Incentive Compensation Management a través deOracle CRM.Por ejemplo, cree un grupo llamado Grupo de Oracle que contenga todoslos beneficiarios.

c. Cree un árbol de Portal Access y añada el grupo de Portal Access al árbol.Por ejemplo, cree un árbol de Portal Access denominado Árbol de acceso deOracle que contenga el grupo llamado Grupo de Oracle.

d. En la pestaña Asignación, dé acceso a Árbol de acceso de Oracle a lapestaña web de Oracle.

e. En la pestaña Grupos, habilite todos los usuarios del grupo de Oracle conacceso al cliente web de Cognos Incentive Compensation Management.Atención: Aunque es necesario habilitar cada usuario para el acceso web através del cliente de Cognos Incentive Compensation Management, elusuario nunca utilizará la contraseña creada en Cognos IncentiveCompensation Management para acceder al cliente web de CognosIncentive Compensation Management cuando la integración con OracleCRM está activa.

Configuración del cliente web de IBM Cognos IncentiveCompensation Management para su uso con Oracle CRM

Para configurar el acceso al cliente web de Cognos Incentive CompensationManagement a través de una pestaña en Oracle CRM, es necesario editar losarchivos crmondemand.properties y web.xml.

Si el cliente web de Cognos Incentive Compensation Management se hadesplegado en Apache Tomcat, estos archivos se encuentran en la ubicaciónpredeterminada siguiente: C:\Archivos de programa\Apache SoftwareFoundation\Tomcat 6.0\webapps\ICM\WEB-INF.

Procedimiento1. Despliegue el archivo ICM.war y configure el archivo jdbc.properties de modo

que haga referencia a su modelo.2. Abra el archivo crmondemand.properties y realice las modificaciones necesarias

en los campos authenticationURL y userKeyColumn.a. El campo authenticationURL debe contener el URL correspondiente a la

instancia de Oracle CRM desde la que se establece la conexión.


b. El campo userKeyColumn contiene el nombre de la columna que se haañadido a la tabla de beneficiarios de Cognos Incentive CompensationManagement que contiene los nombres de los usuarios de Oracle CRM.

3. Edite el parámetro de seguridad en el archivo web.xml. Cambie/WEB-INF/security.xml por /WEB-INF/security-crmondemand.xml.

4. Reinicie el servicio web de Cognos Incentive Compensation Management.5. Conéctese a la instancia de Oracle CRM, inicie sesión con un usuario incluido

en la columna de la tabla de beneficiarios que contiene los nombres de losusuarios de Oracle y seleccione la pestaña que se ha configurado para conectarcon Cognos Incentive Compensation Management.Para obtener más información sobre la adición de pestañas personalizadas a lasinstancias de Oracle, consulte en la ayuda de Oracle CRM On Demand elapartado que trata de la visualización de páginas externas en las pestañas.

Personalización del aspecto del cliente para que se corresponda conel de Salesforce.com

Una vez que la pestaña de Cognos Incentive Compensation Management se haconfigurado en Salesforce, tal vez desee personalizar el aspecto de CognosIncentive Compensation Management.

Esto se puede hacer en el cliente de Cognos Incentive Compensation Management.

Cambio del tema de IBM Cognos Incentive CompensationManagement por Salesforce.com

Al acceder a Cognos Incentive Compensation Management desde Salesforce, talvez desee configurar el aspecto de Cognos Incentive Compensation Managementpara que se parezca más al resto de Salesforce.

Procedimiento1. Seleccione la opción Temas en el menú Herramientas del cliente de Cognos

Incentive Compensation Management.2. En la sección Tema web, seleccione salesforce.com.

Integración con el servidor web de Microsoft IISPuede configurar el servidor web de IIS de Microsoft con el servidor web de IBMCognos Incentive Compensation Management para que IIS reenvíe las solicitudes aCognos Incentive Compensation Management y envíe las respuestas al usuario.

Esto resulta de utilidad si IIS ya está ejecutando varias páginas web (por ejemplo,http://miempresa.com) y desea integrar Cognos Incentive CompensationManagement como un URL más (por ejemplo, http://miempresa.com/ICM).

El cliente web de Cognos Incentive Compensation Management está creado comouna aplicación web J2EE y necesita un servidor de aplicaciones Java (contenedorde servlet) para ejecutarse. Puesto que IIS no proporciona los servicios de unservidor de aplicaciones Java, el cliente web de Cognos Incentive CompensationManagement no se puede desplegar directamente en IIS. Se puede configurar IISpara enviar a través de un proxy las solicitudes para el cliente web de CognosIncentive Compensation Management a un servidor de aplicaciones en el que está


desplegado Cognos Incentive Compensation Management. Por lo tanto, si su sitioweb principal se ejecuta en IIS, se puede integrar Cognos Incentive CompensationManagement en este sitio web.

Si necesita integrar el cliente web de Cognos Incentive Compensation Managementcon IIS, el cliente web de Cognos Incentive Compensation Management tiene quedesplegarse en un servidor de aplicaciones Java que permita la integración con IIS.Apache Tomcat es uno de estos servidores de aplicaciones.

Configuración del cliente web para preparar la integración conel servidor web de Microsoft IIS

Antes de integrar el servidor web de IIS de Microsoft con el servidor web deCognos Incentive Compensation Management, debe configurar Cognos IncentiveCompensation Management y probar el despliegue.

Procedimiento1. Instale y configure el cliente web de Cognos Incentive Compensation

Management.2. Despliegue el archivo WAR mediante Apache Tomcat.

Configuración de Apache Tomcat para aceptar solicitudesprocedentes de un proxy

Debe configurar Apache Tomcat para aceptar solicitudes procedentes de un proxypara IBM Cognos Incentive Compensation Management desde IIS y habilitar elconector AJP/1.3 en Cognos Incentive Compensation Management.

Procedimiento1. Habilite AJP/1.3 Connector en Apache Tomcat.

a. Edite el archivo server.xml y asegúrese de que AJP/1.3 Connector estáhabilitado (por ejemplo, que no tenga marcas de comentario).El archivo server.xml se encuentra en la ubicación predeterminadasiguiente: C:\Archivos de programa\Apache Software Foundation\Tomcat6.0\conf.

b. Elimine los símbolos de comentario () en la sección siguiente delarchivo conf/server.xml: <Connector port="8009" protocol="AJP/1.3"redirectPort="8443"/>

2. Reinicie Apache Tomcat y asegúrese de que no aparecen errores acerca depuertos utilizado en los registros ni en la consola de Apache Tomcat.

3. Asegúrese de que el conector AJP está a la escucha en el puerto especificado(8009 de forma predeterminada).Una manera de hacer esto es utilizar el comando netstat -na en la ventana decomandos y ver si el puerto 8009 aparece en la salida.

Configuración de IIS para reenviar solicitudes a IBM CognosIncentive Compensation Management

Después de desplegar el cliente web de Cognos Incentive CompensationManagement mediante Apache Tomcat y de configurar Apache Tomcat paraaceptar solicitudes procedentes de un proxy, debe configurar IIS para reenviar lassolicitudes de Cognos Incentive Compensation Management a Apache Tomcat.Deben seguirse los pasos siguientes en el sistema en el que IIS está desplegado.


Procedimiento1. Descargue el archivo ISAPI Redirect DLL del sitio de Apache.2. Al descargar, elija la versión de Windows en la que se está ejecutando IIS

(win32 o win64) y, a continuación, seleccione la versión de jk más recientedisponible(jk-1.2.31).Atención: El archivo para descargar se llama api_redirect_X.X.X.dll,donde X.X.X es el número de versión. Deberá eliminar el número de versióndel archivo DLL (es decir, deberá llamarse isapi_redirect.dll).

3. Coloque la DLL y el archivo de propiedades asociado en un directorio deinstalación.Por ejemplo, suponga que el directorio es C:\tomcat_iis_connector. Coloqueel archivo isapi_redirect.dll en este directorio.

4. Descargue el archivo isapi_redirect.properties y colóquelo en el mismodirectorio que el archivo isapi_redirect.dll.

5. Cree un directorio llamado conf en el directorio de instalación(C:\tomcat_iis_connector\conf).a. Descargue los archivos uriworkermap.properties y

workers.properties.minimal.b. Colóquelos en el directorio C:\tomcat_iis_connector\conf.

6. Cree un directorio llamado logs (C:\tomcat_iis_connector\logs).Aquí se colocarán los registros asociados con la ejecución deisapi_redirect.dll.

7. Puede que tenga que modificar el archivo isapi_redirect.properties en eldirectorio C:\tomcat_iis_connector. El archivo isapi_redirect.propertiesindica el conector en el que se encontrarán sus archivos de configuración ydonde se halla la DLL en relación con el servidor de IIS. En este archivo seencuentran las propiedades siguientes:

extension_uriLa ruta al directorio virtual que contiene el archivoisapi_redirect.dll.

og_fileLa ruta en la que se escribe el archivo de registro

log_levelEl nivel en el que deben generarse los registros.

worker_fileLa ruta del archivo workers.properties.minimal en su instalación.

worker_mount_fileLa ruta del archivo uriworkermap.properties en su instalación.

Si instala el conector en C:\tomcat_iis_connector y sigue las instruccionessiguientes para configurar el directorio virtual para el archivoisapi_redirect.dll, no debe cambiar ninguna de las propiedades en elarchivo proporcionado.

8. En el directorio C:\tomcat_iis_connector\conf, puede que tenga quemodificar los archivos uriworkermap.properties yworkers.properties.minimal.a. Edite el archivo uriworkermap.properties y asegúrese de que contiene la

correlación siguiente para Cognos Incentive Compensation Management:/ICM/*=worker1.


b. Edite el archivo workers.properties.minimal y modifique la propiedadworker.ajp13w.host si es necesario.Esta propiedad debe establecerse en el nombre de host o la dirección IPdel sistema en el que se ejecuta Apache Tomcat. Si Apache Tomcat seejecuta en el mismo sistema que IIS, puede dejar la propiedad establecidaen el valor localhost. Si ha especificado un nombre de host como el valorde esta propiedad, asegúrese de que el sistema con IIS puede resolverlocorrectamente como la dirección IP adecuada.

Si ha modificado el puerto para el conector AJP, tendrá que modificar lapropiedad worker.ajp13w.port.

9. Abra Panel de control > Herramientas administrativas > InternetInformation Services.Atención: Si utiliza IIS 7.0, tendrá que instalar Extensiones ISAPI y FiltrosISAPI.

10. Vaya a menú Inicio > Todos los programas > Herramientas deadministración > Administrador de servicios.a. Seleccione Servidor web (IIS) \\ > Funciones.b. Pulse Agregar servicios de función.

11. Añada un filtro ISAPI a IIS de una de estas dos maneras:v Si utiliza IIS 6.0 o una versión anterior, lleve a cabo lo siguiente:

a. Pulse con el botón derecho en Sitio web predeterminado (o el sitio webque se encargará de enviar por proxy las solicitudes a Cognos IncentiveCompensation Management) > Propiedades.

b. Pulse la pestaña Filtros ISAPI.c. Compruebe si hay un filtro que señale al archivo isapi_redirect.dll y

si se encuentra en la ubicación correcta. Si no es así, pulse Agregar ycree uno.

d. Escriba tomcat en Nombre de filtro y escriba la ubicación del archivoisapi_redirect.dll correspondiente al ejecutable.

e. Pulse Aplicar y, a continuación, Aceptar.v Si utiliza IIS 7.0, lleve a cabo lo siguiente:

a. Pulse Sitio web predeterminado (o el sitio web que se encargará deenviar por proxy las solicitudes a Cognos Incentive CompensationManagement) y pulse Filtros ISAPI.

b. Pulse el icono Filtros ISAPI.c. Compruebe si hay un filtro que señale al archivo isapi_redirect.dll y

si se encuentra en la ubicación correcta. Si no es así, pulse Agregar ycree uno.

d. Escriba tomcat en Nombre de filtro y escriba la ubicación del archivoisapi_redirect.dll.

e. Pulse Aceptar.12. Cree un directorio virtual para Cognos Incentive Compensation Management

en IIS.a. Pulse con el botón derecho en Sitio web predeterminado (o el sitio web

que se encargará de enviar por proxy las solicitudes a Cognos IncentiveCompensation Management) > Nuevo > Directorio virtual.

b. Establezca el alias en el valor de la ruta de contexto, sin barras inclinadas,que se ha establecido en la sección de configuración de Cognos IncentiveCompensation Management de este documento. Puede señalar a cualquierdirectorio.


13. Cree un directorio virtual para acceder al archivo isapi_redirect.dll en IISde una de las maneras siguientes:v Si utiliza IIS 6.0 o una versión anterior, lleve a cabo lo siguiente:

a. Pulse con el botón derecho en Sitio web predeterminado (o el sitio webque se encargará de enviar por proxy las solicitudes a Cognos IncentiveCompensation Management) > Nuevo > Directorio virtual.

b. Establezca el alias en jakarta. Esto debe señalar al directorio en el quese ha instalado el archivo isapi_redirect.dll. En nuestro ejemplo esC:\tomcat_iis_connector.

c. Seleccione la casilla de verificación Ejecutar.v Si utiliza IIS 7.0, lleve a cabo lo siguiente:

a. Pulse con el botón derecho en Sitio web predeterminado o el sitio webque se encargará de enviar por proxy las solicitudes a Cognos IncentiveCompensation Management y pulse Agregar directorio virtual.

b. Establezca el alias.c. Ruta de acceso física debe señalar al directorio en el que se ha instalado

el archivo isapi_redirect.dll. En nuestro ejemplo esC:\tomcat_iis_connector.

d. Pulse el directorio virtual del alias y efectúe una doble pulsación enAsignaciones de controlador.

e. Pulse Modificar permisos de características en el panel Acción.f. Seleccione la casilla de verificación Ejecutar.

14. Si utiliza IIS 6.0 o 7.0, deberá incluir la DLL como extensión del servicio webde una de las maneras siguientes:v Si utiliza IIS 6.0, lleve a cabo lo siguiente:

a. Pulse con el botón derecho del ratón en Extensiones de servicio web >Agregar una nueva extensión de servicio web.

b. Escriba tomcat en Nombre de extensión.c. Añada el archivo isapi_redirect.dll a los archivos necesarios.d. Seleccione la casilla Permitida para la opción Establecer el estado de

extensión.e. Pulse Aceptar.

v Si utiliza IIS 7.0, lleve a cabo lo siguiente:a. Vaya a los servidores y resalte el suyo.b. Vaya a Restricciones de ISAPI y CGI.c. Añada y permita la extensión isapi_redirect.dll.

Integración con Autenticación de Windows integradaPuede configurar el cliente web de IBM Cognos Incentive CompensationManagement para que tenga integración de inicio de sesión único conAutenticación de Windows integrada (IWA).

La sesión de los usuarios web de Cognos Incentive Compensation Management seinicia automáticamente sin necesidad de especificar un nombre de usuario y unacontraseña. Si la autenticación falla, los usuarios tendrán que especificar su nombrede usuario y su contraseña de la cuenta de Windows.


Configuración para Internet ExplorerSi utiliza Internet Explorer, debe habilitar la Autenticación de Windows integrada yañadir la dirección del cliente web de IBM Cognos Incentive CompensationManagement a la zona de intranet local.

Procedimiento1. Vaya a Herramientas > Opciones de Internet > Opciones avanzadas.2. En Seguridad, seleccione Habilitar autenticación integrada de Windows.3. Reinicie Internet Explorer.4. Vaya a Herramientas > Opciones de Internet > Seguridad.5. Seleccione Zona de intranet local.6. Pulse Sitios.7. Pulse Opciones avanzadas.8. Añada la dirección del sitio web en el que se ejecuta el cliente web de Cognos

Incentive Compensation Management.9. Pulse Cerrar y, a continuación, Aceptar.

10. Pulse Nivel personalizado.11. En Autenticación del usuario, asegúrese de que la opción Inicio de sesión

automático sólo en la zona Intranet está seleccionada.Si desea que la aplicación web le pregunte si desea que la autenticación seamanual, seleccione Preguntar por el nombre de usuario y la contraseña en sulugar.

Configuración para Mozilla FirefoxSi utiliza Mozilla Firefox, debe aplicar cambios a algunos valores para habilitar lafuncionalidad IWA para su uso con IBM Cognos Incentive CompensationManagement.

Procedimiento1. En la barra de direcciones, escriba about:config como URL y pulse Ir.2. Si aparece un mensaje de aviso, pulse ¡Tendré cuidado, lo prometo!.3. En el filtro, escriba network.negotiate-auth.trusted-uris.4. Efectúe una doble pulsación en network.negotiate-auth.trusted-uris y escriba la

dirección del servidor.

Configuración para Google ChromeSi utiliza Google Chrome, debe aplicar cambios a algunos valores para habilitar lafuncionalidad IWA para su uso con IBM Cognos Incentive CompensationManagement.

Procedimiento1. Pulse el icono Settings y seleccione Options.2. En la pestaña Under the Hood, pulse Change proxy settings.3. En la pestaña Advanced, seleccione Enable Integrated Windows

Authentication.4. Reinicie Google Chrome y repita los pasos 1 y 2.5. En la pestaña Seguridad, seleccione Zona de intranet local.6. Pulse Sitios.7. Pulse Opciones avanzadas.


8. Añada la dirección del sitio web en el que se ejecuta el cliente web de CognosIncentive Compensation Management a la zona de intranet local.

9. En la pestaña Seguridad, seleccione Nivel personalizado.10. Seleccione Inicio de sesión automático sólo en la zona Intranet.

Si desea que la aplicación web le pregunte si desea que la autenticación seamanual, seleccione Preguntar por el nombre de usuario y la contraseña en sulugar.

Creación de un archivo de configuración de KerberosDeberá crear un archivo de configuración de Kerberos necesario para laconfiguración de IWA con IBM Cognos Incentive Compensation Management.

Procedimiento1. En el servidor web, cree un archivo llamado krb5.ini y colóquelo en el

directorio de Windows (por ejemplo, C:\Windows). Un archivo krb5.ini básicotendrá un aspecto similar al del ejemplo siguiente:krb5.ini------------------------------[libdefaults]default_realm = YOURDOMAIN.COMdefault_tkt_enctypes = aes128-cts rc4-hmac des3-cbc-sha1 des-cbc-md5des-cbc-crcdefault_tgs_enctypes = aes128-cts rc4-hmac des3-cbc-sha1 des-cbc-md5des-cbc-crcpermitted_enctypes = aes128-cts rc4-hmac des3-cbc-sha1 des-cbc-md5des-cbc-crc[realms]YOURDOMAIN.COM = {kdc = kdc.yourdomain.comdefault_domain = YOURDOMAIN.COM

}[domain_realm].YOURDOMAIN.COM = YOURDOMAIN.COM

2. Sustituya YOURDOMAIN.COM por el nombre de dominio de su organización.3. Sustituya kdc.yourdomain.com por la dirección del servidor de Active Directory.4. Configure las listas de tipos de cifrado que desee utilizar.

Configuración del nombre principal de servicio y la tabla declaves

Para la integración del cliente web de IBM Cognos Incentive CompensationManagement con IWA, deberá configurar un nombre principal de servicio (SPN)para el servidor web en Active Directory y generar un archivo de tabla de clavesque contenga una clave secreta compartida. El departamento de TI de suorganización pueden serle de ayuda a la hora de llevar a cabo las tareas de esteapartado.

Procedimiento1. Para crear una cuenta de dominio para el servidor web en Active Directory,

lleve a cabo lo siguiente:a. Añada un nombre de cuenta cuenta_servicio.b. Seleccione una contraseña, por ejemplo, secreta.c. Desactive la opción El usuario debe cambiar la contraseña en el siguiente

inicio de sesión.d. Active la opción La contraseña no caduca nunca.


2. Cree el archivo de tabla de claves http-webserver.keytab mediante ktpass.exe:ktpass -out http-webserver.keytab-princ HTTP/[email protected] [email protected] set-pass secret-crypto RC4-HMAC-NT-pType KRB5_NT_PRINCIPAL-DesOnly

a. Sustituya webserver.yourdomain.com por la dirección del servidor web.b. Sustituya YOURDOMAIN.COM por el nombre de dominio.c. Sustituya secret por la contraseña de la cuenta creada en el paso 1.d. Sustituya RC4-HMAC-NT por el cifrado que utilice el servidor Kerberos.

3. Copie el archivo de tabla de claves generado en el paso 2 (http-webserver.keytab) en una ubicación segura del servidor web a la quesolamente se pueda acceder localmente.Atención: En este caso, el nombre principal de servicio (SPN) elegido esHTTP/[email protected]. Lo necesitará para configurar elcliente web de Cognos Incentive Compensation Management.

Configuración del cliente webDespués de habilitar el navegador para la funcionalidad IWA, también tendrá quehabilitar el cliente web de Cognos Incentive Compensation Management para lafuncionalidad IWA.

Procedimiento1. Despliegue el archivo ICM.war.

Importante: Todos los usuarios web deben figurar en la tabla de beneficiarios,tener una dirección de correo electrónico y formar parte de un grupo de PortalAccess y del árbol de Portal Access de su modelo de Cognos IncentiveCompensation Management.

2. Configure el acceso a la base de datos en el archivo jdbc.properties.3. Configure el archivo web.xml para utilizar la seguridad SPNEGO; para ello,

cambie param-value en security.xml por security-spnego.xml.De manera predeterminada, el archivo se encuentra en C:\Archivos deprograma\Apache Software Foundation\Tomcat 6.0\webapps\ICM\WEB-INF.

4. Configure el archivo spnego.properties para su entorno.De manera predeterminada, se encuentra en C:\Archivos de programa\ApacheSoftware Foundation\Tomcat 6.0\webapps\ICM\WEB-INF.a. Sustituya los valores de ubicación de tabla de claves y de principal de

servicio por los valores obtenidos en el apartado anterior.b. Configure los valores de LDAP para Active Directory.

De forma predeterminada, el filtro de búsqueda es userPrincipalName y nodebe cambiarse a menos que sea necesario.

c. Configure el atributo de cuenta de Active Directory(spnego.ldapUserKeyAttribute and spnego.userKeyColumn) que secorrelacionará con la columna de la tabla de beneficiarios de su modelo.# SPNEGOspnego.kerberosServicePrincipal=HTTP/webserver.yourdomain.com@YOURDOMAIN.COMspnego.kerberosKeyTabLocation=d:/secure/http-webserver.keytab

spnego.ldapProviderUrl-ldap://localhost:389/dc=example,dc=com


spnego.ldapManagerDn=cn=Administrator,ou=Usersspnego.ldapManagerPassword=secretspnego.ldapUserSearchBase=ou=Acccountsspnego.ldapUserSearchFilter=(userPrincipalName={0})spnego.ldapUserKeyAttribute=mail

spnego.userKeyColumn=Email



Avisos

Esta información se ha desarrollado para productos y servicios que se ofrecen entodo el mundo.

Puede que IBM tenga disponible este material en otros idiomas. Sin embargo, esposible que tenga obligación de tener una copia del producto o de la versión delproducto en dicho idioma para acceder a él.

Puede que IBM no ofrezca en algunos países los productos, servicios ocaracterísticas que se explican en este documento. Póngase en contacto con elrepresentante local de IBM para obtener información acerca de los productos yservicios que actualmente están disponibles en su zona. Las referencias aproductos, programas o servicios de IBM no pretenden afirmar o implicar que sólopuedan utilizarse productos, programas o servicios de IBM. En su lugar, podráutilizarse cualquier producto, programa o servicio con características equivalentesque no infrinja ningún derecho de propiedad intelectual de IBM. Sin embargo, seráresponsabilidad del usuario evaluar y verificar el funcionamiento de cualquierprograma, producto o servicio que no sea de IBM. Este documento puede incluirdescripciones de productos, servicios o características que no forman parte de latitularidad de licencia o programa que ha adquirido.

Puede que IBM tenga patentes o solicitudes de patentes pendientes relacionadascon los temas principales que se tratan en este documento. La posesión de estedocumento no le otorga ninguna licencia sobre estas patentes. Puede enviar susconsultas sobre licencias, por escrito, a la dirección siguiente:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785EE. UU.

Para realizar consultas sobre licencias relacionadas con la información de doblebyte (DBCS), póngase en contacto con el Departamento de propiedad intelectual deIBM de su país o envíe sus consultas, por escrito, a la dirección:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japón

El párrafo siguiente no tiene aplicación en el Reino Unido ni en ningún otro paísen el que tales provisiones sean incoherentes con la legislación local:INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONAESTA PUBLICACIÓN "TAL CUAL", SIN GARANTÍAS DE NINGÚN TIPO, YASEAN EXPRESAS O IMPLÍCITAS, INCLUIDAS, PERO SIN LIMITARSE A, LASGARANTÍAS IMPLÍCITAS DE NO INFRACCIÓN, COMERCIALIZACIÓN OIDONEIDAD PARA UNA FINALIDAD DETERMINADA. En algunos estados noestá permitida la renuncia de las garantías expresas o implícitas en determinadastransacciones, por lo tanto, puede que esta declaración no se aplique a su caso.


Esta información podría incluir imprecisiones técnicas o errores tipográficos.Periódicamente se realizan cambios en la información que aquí se presenta; talescambios se incorporarán en nuevas ediciones de la publicación. IBM puedeefectuar, en cualquier momento y sin previo aviso, mejoras y cambios en losproductos y programas descritos en esta publicación.

Cualquier referencia hecha en esta información a sitios web que no son de IBMsólo se proporciona para su comodidad y bajo ninguna circunstancia ha deinterpretarse que IBM representa o se hace responsable del contenido de esos sitiosweb. Los materiales de esos sitios web no forman parte de los materiales de esteproducto de IBM y la utilización de esos sitios web será responsabilidad delusuario.

IBM puede utilizar o distribuir cualquier información que se le facilite de lamanera que considere adecuada, sin contraer por ello ninguna obligación con elremitente.

Los licenciatarios de este programa que deseen obtener información acerca de éstecon el fin de permitir: (i) el intercambio de información entre programas creadosindependientemente y otros programas (incluido el presente) y (ii) la utilizaciónmutua de la información que se ha intercambiado, deben ponerse en contacto con:

IBM Software GroupAttention: Licensing3755 Riverside Dr.Ottawa, ON K1V 1B7Canadá

Dicha información puede estar disponible, sujeta a los términos y condicionesapropiados, incluido en algunos casos, el pago de una tarifa.

El programa bajo licencia que se describe en este documento y todo el materialbajo licencia disponible para éste los proporciona IBM en función de lo dispuestoen el IBM Customer Agreement, el Acuerdo Internacional de Licencia de Programade IBM o cualquier otro acuerdo equivalente celebrado entre ambas partes.

Los datos relacionados con el rendimiento que pudiera contener este documento sehan determinado en un entorno controlado. Por lo tanto, los resultados obtenidosen otros entornos operativos pueden variar significativamente. Puede que algunasmediciones se hayan obtenido en sistemas de desarrollo y no existe ningunagarantía que permita afirmar que puedan obtenerse las mismas mediciones ensistemas de disponibilidad general. Es más, puede que algunas mediciones seanestimaciones obtenidas por extrapolación. Los resultados reales podrían variar. Losusuarios de este documento deben verificar los datos que se aplican a su entornoespecífico.

La información relacionada con productos que no son de IBM se ha obtenido delos proveedores de esos productos, los anuncios que han publicado u otras fuentesde disponibilidad pública. IBM no ha probado esos productos y no puedeconfirmar la precisión de la información relacionada con el rendimiento, lacompatibilidad ni ningún otro aspecto relacionado con productos que no son deIBM. Las preguntas relacionadas con las prestaciones de los productos que no sonde IBM deben dirigirse a los proveedores de esos productos.


Todas las declaraciones relacionadas con futuras directrices o intenciones de IBMestán sujetas a cambios o a su retirada sin previo aviso y sólo representanobjetivos.

Esta información contiene ejemplos de datos e informes que se utilizan enoperaciones empresariales de uso habitual. Para ilustrarlos de la forma máscompleta posible, los ejemplos incluyen nombres de personas, empresas, marcas yproductos. Todos estos nombres son ficticios y cualquier similitud que pudieradarse con nombres y direcciones que utilice una empresa real es pura coincidencia.

Puede que si visualiza esta información en copia software, las fotografías eilustraciones a color no aparezcan.

Este producto de software no utiliza cookies ni ninguna otra tecnología pararecopilar información que permita identificar a las personas.

Marcas registradas

IBM, el logotipo de IBM e ibm.com son marcas registradas de InternationalBusiness Machines Corp., registradas en muchas jurisdicciones de todo el mundo.Otros nombres de productos y servicios pueden ser marcas registradas de IBM ode otras compañías. Hay disponible una lista actual de marcas registradas de IBMen la web en “ Información de copyright y marcas registradas ” enwww.ibm.com/legal/copytrade.shtml.

Los términos siguientes son marcas registradas de otras empresas:v Microsoft, Windows, Windows NT y el logotipo de Windows son marcas

registradas de Microsoft Corporation en los Estados Unidos o en otros países.v UNIX es una marca registrada de The Open Group en los Estados Unidos y en

otros países.v Java y todas las marcas registradas y logotipos basados en Java son marcas

registradas de Oracle o sus filiales.

Avisos 107

http://www.ibm.com/legal/copytrade.shtml


Glosario

Este glosario incluye términos y definiciones deIBM Cognos Incentive CompensationManagement.

En este glosario se utilizan las referenciascruzadas siguientes:v Consulte le remite de un término a un

sinónimo preferido, o de un acrónimo oabreviatura al término definido en su formatocompleto.

v Consulte también le remite a un términorelacionado u opuesto.

Para ver glosarios de otros productos de IBM,vaya a www.ibm.com/software/globalization/terminology (se abre en una ventana nueva).

AActive Directory (AD)

Un servicio de directorio jerárquico quepermite la gestión centralizada y segurade toda una red, que es un componentecentral de la plataforma MicrosoftWindows.

AD Véase Active Directory.

administradorPersona responsable de tareasadministrativas tales como la autorizaciónde acceso y la gestión de contenido. Losadministradores también pueden otorgarniveles de autorización a los usuarios.

agregadoCálculo que devuelve un único valor deresultado de varios miembrosdimensionales o filas de datosrelacionales. Son ejemplos típicos el totaly el promedio.

ajuste asignadoAjuste aplicado al resultado de ladiferencia entre el valor original calculadopara un periodo cerrado y el valor que secalcularía en función de los nuevos datos.

ajuste manualSolución puntual que se aplica endeterminados escenarios. Losadministradores puede añadir ajustes

manuales a cualquier beneficiario paracualquier periodo abierto.

archivo de configuraciónArchivo que especifica las característicasde un programa, dispositivo de sistema,sistema o red.

atributoEn lenguajes de marcación como SGML,XML y HTML, par de nombre y valor deun elemento codificado que modifica lascaracterísticas del elemento.

Bbase de datos (BD)

Recopilación de elementos de datosindependientes que se almacenan juntospara dar servicio a una o másaplicaciones. Véase también servidor debases de datos.

BD Véase base de datos.

beneficiarioPersona que recibe una remuneración oque aprueba los resultados deremuneración.

Ccálculo

Proceso utilizado para transformar unaserie de registros en un resultado nuevo.Por lo general, los cálculos sonmatemáticos, pero también pueden incluirla ordenación, el cambio o la adición a unresultado anterior. Los cálculos permitenal administrador de modelos seleccionarregistros de sus datos de origen, realizaroperaciones con los datos, segmentar losresultados y comenzar otro cálculo apartir de dichos resultados.

certificadoEn seguridad informática, documentodigital que vincula una clave pública a laidentidad del propietario de certificado, loque permite autenticar al propietario delcertificado. Un certificado está expedido


http://www-306.ibm.com/software/globalization/terminology/

http://www-306.ibm.com/software/globalization/terminology/

por una entidad emisora de certificados ycuenta con la firma digital de dichaentidad.

certificado de servidorSello electrónico almacenado en el archivode conjunto de claves del servidor quecontiene una clave pública, un nombre,una fecha de caducidad y una firmadigital. El certificado de servidoridentifica el servidor de forma exclusiva.

certificado digitalDocumento electrónico que se utiliza paraidentificar una persona, un sistema, unservidor, una compañía o alguna otraentidad, y para asociar una clave públicaa la entidad. Un certificado digital loemite una entidad de certificación y estáfirmado digitalmente por esa entidad.

certificado raízCertificado (prueba de identidad y claves)de la entidad emisora de certificados odel firmante de confianza original quecertifica la autenticidad del usuario final ola entidad (o de los firmantesintermedios).

clave primariaObjeto que identifica de forma exclusivaun bean de entidad de un tipodeterminado.

cliente webInterfaz en la que los beneficiarios puedenrevisar y aprobar sus pagos deremuneración a través de un navegadorweb. El cliente web de Cognos ICM seejecuta en diversos contenedores deservlets.

componenteContenedor que se utiliza para organizarun modelo. Al crear un nuevo modelo, enprimer lugar deben crearse loscomponentes, para dar al modelo unainfraestructura y garantizar que sea fácildesplazarse por él. Una vez que loscomponentes se hayan creado, se puedencrear los elementos del modelo, como lastablas, los cálculos y los planes.

conexión de entradaRecurso que se utiliza para importar a uncomponente datos procedentes de lasconexiones salientes seleccionadas. Se

crean para especificar a qué componentedebe conectarse la conexión salienteseleccionada.

conexión salienteUn recurso que se utiliza para exportarlos datos de la tabla de resultados decálculo o un componente. Se crean desdelas tablas, los cálculos y otros orígenes.

consultaSolicitud de información de una base dedatos que se basa en condicionesespecíficas: por ejemplo, una solicitud deuna lista de todos los clientes de unatabla de clientes cuyos saldos sonsuperiores a 1000 dólares.

contenedor de servletComponente de servidor de aplicacionesweb que invoca el servlet de acción y queinteractúa con este para procesarsolicitudes.

Ddelimitador

Carácter, como una coma o tabulación,utilizado para agrupar o separar unidadesde texto marcando el límite entre ellos.

Fflujo de trabajo

Secuencia de actividades realizadas deacuerdo con los procesos comerciales deuna empresa.

Iinicio de sesión único (SSO)

Proceso de autenticación en el que elusuario puede acceder a más de unsistema o aplicación a través de un únicoID de usuario y contraseña.

LLDAP Véase Lightweight Directory Access

Protocol.

Lenguaje de consulta estructurada (SQL)Lenguaje estandarizado para definir ymanipular datos de una base de datosrelacional.

Lightweight Directory Access Protocol (LDAP)Protocolo abierto que utiliza TCP/IP para


permitir el acceso a directorios quesoportan modelos X.500, y que no estásujeto a los requisitos de recursos delprotocolo de acceso a directorios (DAP)X.500, más complejo. Por ejemplo, LDAPse puede utilizar para localizar personas,organizaciones y otros recursos en undirectorio de Internet o intranet.

lista de selecciónLista de valores de celda disponibles paraun usuario al especificar los datos en unacelda.

Ooptimización

Proceso de conseguir un rendimientomejorado en tiempo de ejecución o untamaño de código reducido de unaaplicación. La optimización puederealizarse por un compilador, unpreprocesador o a través de un ajustemanual del código fuente.

Pparámetro (parm)

Valor o referencia que se pasa a unafunción, comando o programa que sirvede entrada o que controla acciones. Elvalor lo suministra un usuario u otroprograma o proceso. Véase tambiénarchivo de configuración.

parm Véase parámetro.

particiónDivisión de un resultado calculado ensubresultados. Las particiones se utilizanpara definir el modo en el que semostrarán los resultados del cálculo. Porejemplo, si el particionamiento se realizapor ID de beneficiario, el resultado delcálculo mostrará el importe calculadopara cada beneficiario.

periodoIntervalo de fechas durante el cual seguardan los datos sociales. Un ejemplo deperiodo sería diciembre de 2000.

Rregla de validación

Regla definida en una definición deatributo que especifica los criterios quedeben cumplir los datos almacenados enuna instancia de este atributo para queese atributo sea válido.

Sservidor

Programa de software o sistema queproporciona servicios a otros programasde software o sistemas.

servidor de aplicacionesPrograma de servidor de una reddistribuida que proporciona el entorno deejecución para un programa de aplicación.

servidor de aplicaciones webEntorno de tiempo de ejecución para lasaplicaciones web dinámicas. Un servidorde aplicaciones web Java EE implementalos servicios del estándar Java EE.

servidor de bases de datosServidor en el que están instaladas la basede datos y la aplicación de base de datos.

servidor webPrograma de software que es capaz deatender solicitudes HTTP (protocolo detransferencia de hipertexto).

SQL Siglas de Structured Query Language.Véase Lenguaje de consulta estructurado(SQL).

SSO Siglas de Single Sign-On. Véase inicio desesión único.

Ttabla de dimensiones

Representación de una dimensión en unesquema en estrella. Cada fila de unatabla de dimensiones representa todos losatributos de un miembro específico de ladimensión.

tabla de hechosTabla relacional que contiene hechos, talescomo unidades vendidas o el coste demercancías y claves foráneas que enlazanla tabla de hechos con cada tabla dedimensión.

Glosario 111

Uunión Acción que combina registros de dos o

más tablas o cálculos en función de unpunto en común. Las uniones se creanañadiendo columnas al origen de datosinicial.

unión externa a la izquierdaUnión cuyo resultado consta de las filascoincidentes de las dos tablas que se hanunido y las filas no coincidentes de laprimera tabla. Véase también unión.

Vvista Tabla virtual que se crea uniendo dos o

más tablas. Las vistas también puedenincluir los resultados de los cálculos.


Índice

Caracteres Especiales.NET Framework redistribuible 33.NET Framework SDK\Windows SDK 33

Aactualizaciones

archivo ICM.exe.config 17descripción general 16estándar 17modelos 19realizar 19

administradorestablecer dirección de correo electrónico 15

almacén de clavesconfigurar 86

Apache Tomcatconfigurar acceso a base de datos con 63configurar para aceptar solicitudes procedentes de un

proxy a través del servidor web de Microsoft IIS 96configurar para reenviar solicitudes a IBM Cognos

Incentive Compensation Management 97configurar soporte de idiomas y Unicode con 63descripción general del despliegue del cliente web 61desplegar aplicación con 62instalar y configurar 62OpenSSO 87

APIacceso a 44arquitectura 44configurar valores de 11descripción general 43especificaciones para el almacén de datos 50especificaciones para la gestión de datos 47especificaciones para procesamiento y cálculo 45

archivo hostseditar 37

archivo ICM.exe.configcopias de seguridad 18descripción general 8desinstalar 17editar 8Model Upgrader 17permitir varias instancias y establecer idioma

predeterminado para 9restaurar datos 18

archivo service.exe.config 23cifrado 30configurar cliente con autenticación LDAP 25configurar entornos para modelos en 8configurar modos de comunicación 12configurar valores del servidor de bases de datos 11configurar valores del servidor de bases de datos en 10configurar varias bases de datos en 11descripción general 8establecer dirección de correo electrónico del

administrador 15gestionar valores de correo electrónico para Portal

Access 16lista de comprobación previa a la instalación 40

archivo service.exe.config (continuación)ubicación 10valores de correo 15valores de herramienta externa 14valores de Incentive Compensation Management 13valores de SSL de correo electrónico 14valores para dispositivos móviles 15

archivos de propiedadescifrado para cliente web 72configurar acceso a base de datos con WebSphere 67, 71configurar acceso a base de datos para JBoss 64configurar acceso a la base de datos con Apache

Tomcat 63configurar cifrado de contraseña del cliente web 72configurar LDAP 89contraseñas cifradas para 72enviar mensajes de correo electrónico cuando haya

consultas pendientes 75especificar nombres distinguidos de LDAP 89valores de correo electrónico de Portal Access 16

autenticaciónconfigurar para cliente web 90descripción general 82IWA 99LDAP 24LDAP para cliente web 88modelos 8OpenSSO 84SiteMinder 83valores del servicio de Windows 11, 12valores del servidor de bases de datos 10

autenticación integrada de WindowsVéase IWA

Bbase de datos

cambiar DEFAULT_SCHEMA mediante consultas 5cambiar DEFAULT_SCHEMA mediante SQL Server

Management Studio 5configurar acceso con Apache Tomcat 63configurar acceso con JBoss 64configurar acceso con WebSphere 67, 71configurar varias 11descripción general del servidor 1propietario para Microsoft SQL Server 4seleccionar versión de destino 22transferir entre servidores 19

bibliotecas validadasSAML 86

CC#

definiciones de excepciones 54definiciones de objeto 51

cálculosespecificaciones API 45mejorar la velocidad con optimización del rendimiento del

nivel de datos 27


cálculos (continuación)mejorar la velocidad con optimización del tamaño de

Enterprise 33certificados

configurar cliente para 57configurar con CLI 40configurar Microsoft Management Console para su uso 35configurar para complemento de Microsoft Excel en

cliente 58configurar para complemento de Microsoft Excel en

servicios 56configurar para su uso por parte del cliente y los

servicios 39enlazar a puertos 38generar 34generar desde línea de comandos 34identificar para complemento de Microsoft Excel 57importar para Microsoft Management Console 36Microsoft Management Console 36software necesario 33

ChromeVéase Google Chrome

cifradoarchivos de propiedades 72configurar 11configurar para contraseña del cliente web 72configurar para contraseñas de cliente web en

Windows 73descripción general 30dominio de Windows 81HTTP 82HTTPS 82red de confianza 82red de confianza y SSL 82seguridad TLS 81

CLIarchivos de instalación 2códigos de retorno 43conectar a modelos con 41configurar certificados digitales con 40descripción general 40ejecutar comandos 41instalar 40lista de comprobación previa a la instalación 40

clientearchivo ICM.exe.config 8archivos de instalación 2cambiar aspecto para que se corresponda con el de

Salesforce.com 95cambiar tema para que se corresponda con el de

Salesforce.com 95configurar para complemento de Microsoft Excel 57configurar para Oracle CRM 94configurar para utilizar certificados 39descripción general 1establecer idioma predeterminado para 9habilitar optimización del rendimiento del nivel de

datos 27herramientas 29instalar 7integrar LDAP con 24, 25lista de comprobación previa a la instalación 3permitir acceso a los usuarios de LDAP 26permitir varias instancias 9preparación de la instalación 1servicio de Windows 7

cliente de Cognos Incentive Compensation ManagementVéase cliente

cliente de IBM Cognos Incentive Compensation ManagementVéase cliente

cliente webacceso con SiteMinder 84archivo web.xml 90cambiar esquema de color y logotipo 76cambiar esquema de color y logotipo para tema 78cifrado de archivos de propiedades 72cifrado de contraseña 72cifrado de contraseña en Windows 73configuración de LDAP 88configurar 102configurar acceso a base de datos con JBoss 64configurar acceso a base de datos con WebSphere 67, 71configurar acceso a la base de datos con Apache

Tomcat 63configurar archivo de configuración de Kerberos 101configurar nombre principal de servicio y tabla de

claves 101configurar para Google Chrome con IWA 100configurar para Internet Explorer con IWA 100configurar para Mozilla Firefox con IWA 100configurar para Oracle CRM 94configurar para Salesforce.com 92configurar para SiteMinder 83configurar soporte de datos Unicode con Apache

Tomcat 63configurar soporte de datos Unicode con JBoss 66configurar soporte de datos Unicode con WebSphere 69configurar soporte de idiomas con Apache Tomcat 63configurar soporte multilingüe con JBoss 66configurar soporte multilingüe con WebSphere 69configurar soporte multilingüe para entorno local 74configurar WebSphere 8 para 69descripción general 61descripción general del despliegue de Apache Tomcat 61descripción general del despliegue de JBoss 64descripción general del despliegue de WebSphere 7 66descripción general del despliegue de WebSphere 8 69desplegar con Apache Tomcat 62desplegar con JBoss 65despliegue con contraseñas cifradas 73despliegue de WebSphere 7 66despliegue de WebSphere 8 70enviar correos electrónicos automáticos de 75especificar nombres distinguidos de LDAP 89establecer propiedad personalizada de contenedor web

para WebSphere 68evitar que los informes iniciales carguen una gran cantidad

de datos 75instalar en Solaris 61instalar y configurar Apache Tomcat 62instalar y configurar Java 61instalar y configurar Java para JBoss 64instalar y configurar JBoss 64integración con aplicaciones externas 91integración con IWA 99límites de fila de cuadrícula de datos de informe inicial

en 75obtener contraseña cifrada 72pestañas web 76propiedades de LDAP 89utilizar consola administrativa de WebSphere para

iniciar 68, 71validación de LDAP 89


cliente web (continuación)verificar inicio de sesión para 88

CLRintegrar con optimización del rendimiento del nivel de

datos 27colores

cambiar en cliente web 76cambiar en cliente web para tema 78

Common Language RuntimeVéase CLR

complementoVéase complemento de Microsoft Excel

complemento de ExcelVéase complemento de Microsoft Excel

complemento de Microsoft Excelarchivos de instalación 2conectar 59configurar certificados para cliente 58configurar certificados para los servicios 56configurar cliente para 57configurar identidad del servidor de alojamiento 57configurar servicio para 55configurar servicios para cliente 58descripción general 55editar archivo de configuración para 56identificar certificado de servidor para 57instalar 59instalar herramienta de ensamblados de interoperabilidad

primarios de 58software para 58

comunicacionesconfigurar modos 12descripción general de la seguridad 81entre cliente web y aplicación web 82entre cliente y servidor de aplicaciones 81entre servidor de bases de datos y servidor de

aplicaciones 82entre servidor de bases de datos y servidor de aplicaciones

web 82configuración 40

acceso a base de datos para cliente web con ApacheTomcat 63

acceso a base de datos para cliente web con JBoss 64acceso a base de datos para cliente web con

WebSphere 67, 71Apache Tomcat 62certificados digitales 40complemento de Microsoft Excel 56ConsoleService.exe.config 29, 30ICM.exe.config 8identidad del servidor de alojamiento para complemento

de Microsoft Excel 57Java 61Java para JBoss 64JBoss 64OpenSSO 84, 85OpenSSO con IBM Cognos Incentive Compensation

Management 87proveedores de servicios 86service.exe.config 8servicio de consola 29soporte multilingüe para cliente web 74soporte multilingüe para cliente web con Apache

Tomcat 63soporte multilingüe para cliente web con JBoss 66soporte multilingüe para cliente web mediante

WebSphere 69

configuración (continuación)soporte Unicode para cliente web 74WebSphere 8 para cliente web 69

Configuration File Encrypterarchivos de instalación 2descripción general 30instalar 30

conformidad con WS-I 44ConsoleService.exe.config 30consultas

cambiar DEFAULT_SCHEMA mediante 5contraseñas

cifrado para archivos de propiedades 72configurar cifrado en cliente web 72configurar cifrado en cliente web en Windows 73desplegar cliente web con cifrado 73obtener cifradas 72

Conversor de modelosVéase Conversor de modelos de gestión

Conversor de modelos de gestiónarchivos de instalación 2convertir modelo de Standard a Enterprise 32convertir modelo de Standard Edition a Enterprise 33convertir modelos 31descripción general 31instalar 31optimizar tamaño de modelo de Enterprise 33

copias de seguridadarchivo ICM.exe.config 18base de datos 18restaurar datos de 18transferir bases de datos entre servidores mediante 19

correo electrónicoconfigurar 14configurar dirección de correo electrónico del

administrador 15configurar valores de 15enviar desde cliente web 75gestionar valores para Portal Access 16

creación anónima de modelosconfigurar 13

DDEFAULT_SCHEMA

cambiar mediante consultas 5cambiar mediante SQL Server Management Studio 5

definiciones de excepciones 54definiciones de objeto 51derechos dbo para Microsoft SQL Server 4desinstalar IBM Cognos Incentive Compensation

Management 17direcciones IP

identificar 37directorio de archivos de imagen guardados

configurar 13directorio de archivos de importación guardados

configurar 13directorio de archivos de la aplicación de publicación

guardadosconfigurar 13

dispositivo portátilconfigurar 15

dominio de Windows 81

Índice 115

Eerror j_spring_security_check

evitar 68estándares de seguridad 44

FFirefox

Véase Mozilla Firefox

Ggestión de relaciones con los clientes

Véase Oracle CRMgestión de relaciones con los clientes de Oracle

Véase Oracle CRMGestor de tareas

configurar 13glosario 109Google Chrome

configurar con IWA 100grupos de usuarios

permitir a grupos de usuarios de LDAP acceder alcliente 26

Hherramienta de ensamblados de interoperabilidad primarios

de Officeinstalar para complemento de Microsoft Excel 58

herramientas externasconfigurar 14

HTTPcomunicación no cifrada entre cliente web y aplicación

web 82configurar para servicio de Windows 12mediante el programa de utilidad de configuración para

identificar el certificado de servidor 57HTTPS

comunicación cifrada entre cliente web y aplicaciónweb 82

configurar para servicio de Windows 12

IIBM Cognos Producer Lifecycle and Credential Management

integración con 91IBM Cognos Territory and Quota Management

integración con 91idiomas

Véase soporte multilingüeinformes

evitar que los informes iniciales carguen una gran cantidadde datos 75

informes a medida 45informes web 45límites de fila de cuadrícula de datos en cliente web 75Presentador 75

informes a medidaespecificaciones de API para 45

informes inicialesevitar que carguen una gran cantidad de datos 75límites de fila de cuadrícula de datos 75

informes webespecificaciones de API para 45

inicio de sesión únicointegración con IWA 99

instalaciónApache Tomcat 62archivos 2cliente 7Configuration File Encrypter 30Conversor de modelos de gestión 31descripción general 1Java 61Java para JBoss 64JBoss 64lista de comprobación 3OpenSSO 85servicio de consola 29servicio de Windows 7

integración con aplicaciones externasdescripción general 91IBM Cognos Producer Lifecycle and Credential

Management 91IBM Cognos Territory and Quota Management 91Oracle CRM 93Salesforce.com 92servidor web de Microsoft IIS 95

interfaz de línea de comandosVéase CLI

Internet Explorerconfigurar con IWA 100

Internet Information ServicesVéase servidor web de Microsoft IIS

IWAconfigurar cliente web con 102configurar cliente web para Google Chrome con 100configurar cliente web para Internet Explorer con 100configurar cliente web para Mozilla Firefox con 100configurar nombre principal de servicio y tabla de claves

para 101crear archivo de configuración de Kerberos para 101habilitar cliente web para 102integración con cliente web 99

JJava

instalar y configurar 61Java para JBoss

instalar y configurar 64JBoss

configurar 64configurar acceso a base de datos con 64configurar soporte multilingüe y Unicode con 66descripción general 64desplegar aplicación con 65instalar 64Java para JBoss 64

KKerberos

autenticar clientes y servidores mediante 8configurar archivo de configuración del servicio de

Windows para autenticación LDAP 25configurar archivo de configuración para 101modo de seguridad de Windows 11

keytabconfigurar para cliente web 101


LLDAP

configurar autenticación para cliente web 90configurar cliente con 25configurar para cliente web 88configurar propiedades para 89especificar nombres distinguidos en 89integrar con cliente 24permitir a los usuarios acceder al cliente 26validar para cliente web 89

Lightweight Directory Access ProtocolVéase LDAP

logotiposcambiar en cliente web 76cambiar en cliente web para tema 78

MManagement Console

Véase Microsoft Management ConsoleMicrosoft Internet Information Services

Véase servidor web de Microsoft IISMicrosoft Management Console

certificados para 36configurar para utilizar certificados 35importar certificados para 36

Microsoft SQL Servercambiar DEFAULT_SCHEMA mediante SQL Server

Management Studio 5convertir modelos a 31convertir modelos a versiones posteriores 31descripción general 1propietario de la base de datos 4requisitos de permisos para base de datos 4

Model Upgraderactualizar modelos con 19archivos de instalación 2ejecutar 20instalar 20protección frente a errores 21versión de base de datos de destino 22

modelo de Enterpriseconvertir modelo de Standard Edition a 33convertir modelo Standard a 32optimizar tamaño 33

modelosabrir 23actualizar 19añadir 23conectar con CLI 41

Mozilla Firefoxconfigurar con IWA 100

Nnombre principal de servicio

configurar para cliente web 101

OOpenSSO

configuración de Apache Tomcat 87configurar 85configurar con IBM Cognos Incentive Compensation

Management 87

OpenSSO (continuación)configurar IDP para 86descargar 85descripción general 84instalar 85

optimización del rendimiento del nivel de datosdescripción general 27habilitar en cliente 27integración con CLR 27

Oracle CRMconfigurar cliente para 94configurar cliente web para 94integración con 93

Ppestañas

Véase pestañas webpestañas web

añadir 77añadir grupos 78descripción general 76editar 77eliminar de grupos 78establecer acceso a 78mover 77suprimir 77

Planificadoracceso de la API a 44configurar 13, 14configurar valores del correo electrónico para 15

Portal Accessconfigurar valores del correo electrónico 15gestionar valores de correo electrónico para 16

proveedor de identidadVéase proveedor de identidad (IDP)

proveedor de identidad (IDP)añadir y configurar 86descripción general 85

proveedor de serviciosregistrar IBM Cognos Incentive Compensation

Management como 87proveedores de servicios

descripción general 86puertos

enlazar certificados 38identificar 37identificar números no utilizados 38

Rred de confianza

dominio de Windows 81entre cliente web y aplicación web 82entre cliente web y aplicación web con SSL 82entre cliente y servidor de aplicaciones 81entre cliente y servidor de aplicaciones con SSL 81entre servidor de aplicaciones y servidor de bases de

datos 82entre servidor de aplicaciones y servidor de bases de datos

con SSL 82entre servidor de bases de datos y servidor de aplicaciones

web 82entre servidor de bases de datos y servidor de aplicaciones

web con SSL 82

Índice 117

registrosauditoría 13Gestor de tareas 13Planificador 13

restauración de datosdescripción general 18desde copias de seguridad 18

SSalesforce.com

cambiar aspecto del cliente para que se corresponda con elde 95

cambiar tema del cliente para que se corresponda con elde 95

configurar cliente web para 92integración con IBM Cognos Incentive Compensation

Management 92tema 78

SAMLbibliotecas validadas 86Configuración de OpenSSO 84configuración de proveedor de servicios 86configurar IDP para 86configurar OpenSSO con IBM Cognos Incentive

Compensation Management 87opciones de autenticación 82registrar IBM Cognos Incentive Compensation

Management como proveedor de servicios en 87Security Assertion Markup Language

Véase SAMLseguridad de la capa de transporte

Véase seguridad TLSseguridad TLS

cambiar comunicación del servicio de Windows 12certificados 11configurar 11opciones de seguridad 81

servicio de consoladescripción general 29editar archivo de configuración 29iniciar 30instalar 29

Servicio de consoladescripción general 2

servicio de Windowsconfigurar 10configurar entornos para 8configurar herramientas externas 14configurar modos de comunicación 12configurar Planificador y Gestor de tareas 13configurar SSL para mensajes de correo electrónico 14configurar valores del servidor de bases de datos 11editar archivos de configuración para 23instalar 7varias instancias 22

Servicio de Windows Cognos Incentive CompensationManagement

Véase servicio de WindowsServicio de Windows IBM Cognos Incentive Compensation

ManagementVéase servicio de Windows

serviciosCognos Incentive Compensation Management for

Windows 2configurar para complemento de Microsoft Excel 55

servicios (continuación)configurar para complemento de Microsoft Excel en

cliente 58configurar para complemento de Microsoft Excel en

servicios 56configurar para utilizar certificados 39consola 2

servidor de aplicacionesdescripción general 1editar archivos de configuración en 8instalar servicio de consola en 29instalar servicio de Windows en 7JBoss 64opciones de seguridad para comunicación con cliente 81opciones de seguridad para comunicación con servidor de

bases de datos 82WebSphere 8 69

servidor webconfigurar Apache Tomcat para aceptar solicitudes

procedentes de un proxy a través del servidor web deMicrosoft IIS 96

configurar para preparar integración con servidor web deMicrosoft IIS 96

servidor web de IISVéase servidor web de Microsoft IIS

servidor web de Microsoft IISconfigurar Apache Tomcat para aceptar solicitudes

procedentes de un proxy a través de 96configurar para reenviar solicitudes a IBM Cognos

Incentive Compensation Management 97configurar servidor web para preparar integración con 96integración con 95

servidoresconfigurar identidad del servidor que aloja el servicio para

complemento de Microsoft Excel 57identificar dirección IP 37identificar números de puerto no utilizados 38identificar puerto 37transferir bases de datos entre 19

SiteMinderacceder al cliente web con 84configurar cliente web para 83descripción general 83

Solarisinstalar cliente web en 61

soporte multilingüeconfigurar para cliente web 74configurar para cliente web con Apache Tomcat 63configurar para cliente web con JBoss 66configurar para cliente web mediante WebSphere 69establecer idioma predeterminado 9seleccionar ajustes de fecha 13seleccionar idioma 13

SQL ServerVéase Microsoft SQL Server

SSLcifrado entre cliente web y aplicación web 82cifrado entre cliente y servidor de aplicaciones 81cifrado entre servidor de aplicaciones y servidor de bases

de datos 82cifrado entre servidor de bases de datos y servidor de

aplicaciones web 82configurar para correo electrónico 14configurar para LDAP 25identificar certificados de servidor 57


TTCP

configurar para servicio de Windows 12temas

cambiar los del cliente para que se correspondan con los deSalesforce.com 95

TomcatVéase Apache Tomcat

UUnicode

configurar soporte para cliente web 74configurar soporte para cliente web con Apache

Tomcat 63configurar soporte para cliente web con JBoss 66configurar soporte para cliente web con WebSphere 69modelos de SQL 11

usuariospermitir a los usuarios de LDAP acceder al cliente 26

Vvalores para dispositivos móviles

configurar 15

WWebSphere 7

configurar acceso a base de datos con 67, 71configurar soporte multilingüe y Unicode con 69descripción general del despliegue del cliente web 66desplegar cliente web 66establecer propiedad personalizada de contenedor web

para 68utilizar consola de administración para iniciar cliente

web 68, 71WebSphere 8

configurar acceso a base de datos con 67, 71configurar para cliente web 69configurar soporte multilingüe y Unicode con 69descripción general del despliegue del cliente web 69desplegar cliente web 70

Windowsestablecer para que se inicie automáticamente 8

Índice 119

Documents

IBM Cognos Incentive Compensation Management Versi.n 8.1.3 ...public.dhe.ibm.com/.../cognos/documentation/varicent/es/8.1.3/ig_ic… · Title: IBM Cognos Incentive Compensation Management