Configuración de una conexión a Collector Server y adaptación del perfil de configuración del cliente

Debe configurar una conexión segura entre la API y la instancia de Collector Server. Además, debe configurar el perfil de configuración del cliente para la conexión segura y, opcionalmente, para usarlo por Datacap.

Acerca de esta tarea

Para que la API pueda establecer una conexión entre Datacap y Collector Server, debe proporcionar el nombre de host y el número de puerto de Collector Server. Además, puede especificar si se debe crear un archivo de rastreo para la API. Puede proporcionar la información completa en el perfil de configuración de cliente e inicializar la API con los valores del perfil de configuración de cliente. O bien, puede pasar la información necesaria como parámetros durante la inicialización de la API.

Procedimiento

Configuración de una conexión segura en Collector Server. Si hay varios usuarios en la computadora donde se ejecuta Datacap, decida cuál de estos usuarios tendrá permiso para utilizar la API. Decida también si varios usuarios compartirán un certificado.
Configuración de una conexión segura en el sistema con la API. Copie las carpetas con los almacenes de claves del cliente en el sistema donde se ejecute Datacap.
Si desea ejecutar Rulerunner como servicio, mueva el perfil de configuración de cliente csclient.ini al directorio siguiente:
C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\IBM\iccsap

Cada usuario que tenga permitido utilizar la API debe tener acceso a un almacén de claves de cliente.
Puede inicializar la API con o sin el uso del perfil de configuración de cliente:
- Si no desea utilizar los valores del perfil de configuración de cliente, asegúrese de que el perfil contiene al menos la sección siguiente:
```
[ARCHPRO_CONNECTIONPARAMETER]
almacén de claves=ruta
```
  ruta representa el nombre de archivo completamente calificado del almacén de claves del cliente.
- Si desea utilizar las valores del perfil de configuración de cliente, la sección ARCHPRO_CONNECTIONPARAMETER debe contener valores adicionales:
  1. Establezca los siguientes parámetros obligatorios:
```
Server=server_name
Port=port
almacén de claves=ruta
```
    nombre_servidor
    
    El nombre de host o la dirección IP de del sistema donde se ejecuta Collector Server.
    
    puerto
    
    El número de puerto que se ha especificado para la palabra clave ARCHPRO_PORT en el perfil de configuración de servidor.
    
    vía_acceso
    
    El nombre de archivo completo del almacén de claves de almacén de claves del cliente que contiene el certificado del usuario.
    Ejemplo:
```
Server=myICCSAPServer
Port=7654
keystore=C:\Users\cuser1\AppData\Roaming\IBM\iccsap\security\client_1\client_1.kdb
```
  2. Si se va a crear un archivo de rastreo para la API, establezca los parámetros siguientes:
```
DLLTraceFile=trace_file
DLLTraceLevel=1
DLLTraceMax=max_trace_size
Interactive=0
```
    trace_file hace referencia a la vía de acceso completa del archivo de rastreo. max_trace_size hace referencia al tamaño máximo del archivo de rastreo, en KB. El valor predeterminado es 1024.
    
    El parámetro Interactive está establecido en 0 para suprimir las ventanas emergentes que aparecen en caso de error y que requieren su interacción.
    Ejemplo:
```
DLLTracefile=c:\temp\dlltrace.trc
DLLTraceLevel=1
DLLTraceMax=1024
Interactive=0
```