Configuración del recopilador Java Nokia5529Idm

Este recopilador utiliza la característica de exportación masiva de red para recuperar datos del EMS Alcatel Lucent 5529 IDM. Antes de ejecutar el recopilador Java Nokia5529Idm en un descubrimiento de red, debe copiar determinados archivos necesarios y configurar los detalles de conexión entre el EMS y Network Manager.

También puede configurar la información adicional que se recuperará del EMS.

Para configurar el recopilador, lleve a cabo los siguientes pasos:

Antes de ejecutar el recopilador, copie los archivos .jar necesarios desde el EMS en el servidor en el que está instalado el recopilador:

Inicie sesión en la página Esquema del IDM con las credenciales de un usuario IDM NBI.
El URL de la página Esquema de IDM es https:// hostname :8443/idm/schemadoc/html/index.html, donde hostname es el nombre o la dirección IP del servidor de IDM.
Haga clic en la URL muestra del cliente y descargue el archivo idm-oss-client.tar.gz en el servidor en el que está instalado el recopilador.
Descomprima el archivo.

Si la versión de EMS es 9.4 o inferior, copie los archivos siguientes en el directorio $NCHOME/precision/collectors/javaCollectors/lib :

axs-mobject-remote-api-9.4-268573.jar
hornetq-core-client-2.3.1.Final-ALU-1
hornetq-jms-client-2.3.1.Final-ALU-1.jar
jaxen-1.1.jar
jboss-as-security-7.2.0.Final-ALU-8.jar
jboss-client.jar
jboss-logging-3.1.2.GA-ALU-1.jar
jboss-remoting-3.2.17.GA.jar
jdom-1.1.2-ALU-2.jar
jms-1.1.jar
log4j-1.2.13.jar
netty-3.6.2.Final-ALU-1.jar
trove-2.1.1.jar

Si la versión de EMS es 9.6.07 o 9.6.08, copie los archivos siguientes en el directorio $NCHOME/precision/collectors/javaCollectors/lib :

axs-encription-app-9.6.07-399857.jar
jboss-logging-3.3.0.Final.jar
slf4j-simple-1.7.21.jar
axs-mobject-api-9.6.07-399857.jar
log4j-1.2.14.jar
wildfly-client-all.jar
axs-mobject-remote-api-9.6.07-399857.jar
picketbox-4.9.6.Final.jar
xbean-2.6.0.jar
idm-oss-client-1_9.6.07-399857.jar
picketbox-infinispan-4.9.6.Final.jar

Si la versión de EMS es 9.7.03, copie los archivos siguientes en el directorio $NCHOME/precision/collectors/javaCollectors/lib :

axs-encription-app-9.7.03-426853.jar
axs-encrypt-utils-9.7.03-426853.jar
axs-jboss-patch-9.7.03-426853.jar
axs-mobject-api-9.7.03-426853.jar
axs-mobject-remote-api-9.7.03-426853.jar
jboss-logging-3.3.1.Final.jar
log4j-api-2.11.0.jar
log4j-core-2.11.0.jar
picketbox-5.0.2.Final.jar
picketbox-infinispan-5.0.2.Final.jar
slf4j-api-1.8.0-beta2.jar
slf4j-simple-1.8.0-beta2.jar
wildfly-client-all.jar
xbean-2.6.0.jar

Cambie al directorio del recopilador:

cd $NCHOME/precision/collectors/javaCollectors/Nokia5529Idm/

En este directorio, busque el archivo de configuración de ejemplo del recopilador Java Nokia5529Idm y cópielo en el archivo de configuración de trabajo utilizando un mandato similar al siguiente ejemplo:
```
cp Nokia5529IdmCollector.properties.sample Nokia5529IdmCollector.properties
```
El archivo de configuración consta de las secciones siguientes:

Propiedades del Recopilador

Parámetros de configuración general para el recopilador, como el número de puerto y los detalles de registro y rastreo.

Propiedades del origen de datos

Detalles del EMS al que se conecta el recopilador. Los datos de estos campos los utiliza Network Manager para modelar el EMS.

Propiedades de la adquisición de datos

Parámetros que especifican los datos a recopilar desde EMS.

Propiedades de SOAP

Parámetros específicos de SOAP.

Propiedades de FTP

Parámetros específicos de FTP.

Propiedades de JMS

Propiedades relacionadas con Java Messaging System.

Propiedades JMS HTTPS

Propiedades relacionadas con la configuración JMS HTTPS.

Propiedades de CSV

Propiedades relacionadas con archivos de formato de valores separados por comas.
Configure el puerto del recopilador y los parámetros de registro y rastreo:
puerto

Puerto donde se ejecuta el recopilador. El puerto debe coincidir con el puerto configurado en la inserción en la tabla collectorFinder.collectorRules en el archivo DiscoCollectorFinderSeeds.cfg. El valor predeterminado es 8080.

log.filename

Nombre del archivo de registro del recopilador. También puede especificar un patrón para el nombre del archivo de registro utilizando un conjunto de elementos definidos por el sistema. El valor predeterminado es Alcatel5529IdmCollector.log.

log.level
Tiene uno de los valores siguientes:
- NONE
- FINEST
- FINER
- FINE
- CONFIGINFO
- AVISO
- SEVERE
- TODOS
trace.filename

Nombre del archivo de rastreo del recopilador . También puede especificar un patrón para el nombre del archivo de rastreo utilizando un conjunto de elementos definidos por el sistema. El valor predeterminado es Alcatel5529Collector-trace.log.

trace.level
Tiene uno de los valores siguientes:
- NONE
- FINEST
- FINER
- FINE
- CONFIGINFO
- AVISO
- SEVERE
- TODOS
Puede configurar opcionalmente detalles sobre el sistema de gestión de elementos de origen (EMS) en la sección Propiedades de la fuente de datos configurando los siguientes campos genéricos. Los datos de estos campos son utilizados por Network Manager para modelar el EMS.
DataSource.id

Identificador exclusivo para el origen de datos, en forma de un entero. Este campo tiene el valor 1, lo que indica que es el origen de datos primario.

DataSource.descr

Descripción del EMS.

DataSource.emsName

Nombre del EMS.

DataSource.emsPort

Puerto del EMS.

DataSource.emsVersion

Versión del EMS.

DataSource.emsIdentifier

Identificador del EMS y clave para integrar el recopilador de Network Manager con el controlador de Netcool Configuration Manager .

DataSource.emsRole
Rol del EMS. Este parámetro puede tener uno de los valores siguientes:
- desconocido
- primary
- backup
- otros
DataSource.emsStatus
Estado del EMS. Este parámetro puede tener uno de los valores siguientes:
- desconocido
- activo
- down
- otros
En la sección de propiedades Adquisición de datos, configure los parámetros de adquisición de datos:

collectData

El valor predeterminado es true.

Verdadero

Habilita el recopilador. El recopilador recopila datos del EMS.

Falso

Inhabilita el recopilador. El recopilador no recopila datos del EMS.

DataAcquisition.fullDiscoTimeout

El número de segundos que el recopilador espera a que el EMS finalice la operación de exportación masiva de red. El valor predeterminado es 30.

DataAcquisition.domainName

Establece el nombre de dominio del elemento de red en el descubrimiento parcial.

DataAcquisition.exportProfileName

Establece el nombre del perfil de red de exportación. El valor predeterminado es cpp3exportProfile.

DataAcquisition.skipEmsConnection

Establézcalo en true para omitir la recopilación de datos de EMS y leer el archivo CSV de exportación local. La ubicación del archivo se configura en la propiedad DataAcquisition.exportFileLocation . Establézcalo en false para recopilar datos del EMS. El valor predeterminado es false.

DataAcquisition.exportFileLocation

El nombre completo y la ubicación del archivo de inventario de exportación de .csv . Este valor sólo se utiliza si DataAcquisition.skipEmsConnection se establece en true.

DataAcquisition.processVlans

Establézcalo en true para procesar datos de VLAN o en false para no procesar datos de VLAN. El valor predeterminado es false.

DataAcquisition.processLLDP

Establézcalo en true para procesar datos LLDP o en false para no procesar datos LLDP. El valor predeterminado es false.
En la sección de propiedades de SOAP, configure las propiedades de SOAP:

soap.username

Nombre de usuario para el servicio SOAP.

soap.password

Contraseña para el servicio SOAP.

soap.port

Puerto para el servicio SOAP.

soap.secure

Esta propiedad puede ser true o false. El valor predeterminado es false. Si está en true, se utiliza una conexión HTTPS segura para conectarse al EMS. Si es false, el recopilador utiliza una conexión HTTP al EMS.

jsse.httpsImpl

El nombre de la clase de implementación HTTPS. El nombre de clase predeterminado es com.ibm.net.ssl.www2.protocol. Esta propiedad sólo entra en vigor cuando la propiedad soap.secure se establece en true.

jsse.trustStore

Ruta completa al archivo trust-store. Esta propiedad sólo entra en vigor cuando la propiedad soap.secure se establece en true.

jsse.trustPass

Contraseña del archivo trust-store. Esta propiedad sólo entra en vigor cuando la propiedad soap.secure se establece en true.

TLSVersion

La versión de protocolo del protocolo SSL TLS. La versión predeterminada es TLSv1.2. Si especifica el valor TLSv1.2 el recopilador utiliza TLS v1.2 en su lugar durante el reconocimiento SSL.

SSLDebugInfo

Si true, la información de rastreo de reconocimiento SSL se registra durante el reconocimiento SSL. Si false, la información de depuración no se imprime. El valor predeterminado es false.

jsse.keystoreType

El tipo de archivo de almacén de claves que utiliza, el valor predeterminado es JKS. Otro tipo posible PKCS12 y otros tipos.
En la sección de propiedades de FTP, configure las propiedades de FTP.

ftp.host

El nombre de host o la dirección IP del servidor en el que se ejecuta el recopilador.

ftp.username

Nombre de usuario de la sesión de FTP. Este usuario debe poder iniciar sesión en el servidor y tener permisos de grabación para el directorio FTP.

ftp.password

La contraseña para el nombre de usuario especificado para la sesión de FTP.

ftp.directory

La vía de acceso completa del directorio de destino para los archivos transferidos desde el EMS. Este directorio está en el servidor en el que se está ejecutando el recopilador. El directorio predeterminado es /tmp.

ftp.compressed

El valor predeterminado es false.

Verdadero

Los archivos se transfieren en un archivo comprimido.

Falso

Los archivos no se comprimen.
En la sección de propiedades JMS, configure las propiedades relacionadas con Java Messaging Service:

jms.username

Nombre de usuario para el servicio JMS.

jms.password

Contraseña para el servicio JMS.

jms.topic

El nombre del tema para escuchar mensajes JMS.

jms.filter

Filtro de mensajes para procesar mensajes específicos. Déjelo en blanco para no utilizar ningún filtro.

jms.durable

Establézcalo en true para habilitar la suscripción duradera. El valor predeterminado es false.

jms.unsubscribe

Configúrelo como true para anular la suscripción del tema cuando se habilite la suscripción duradera. El valor predeterminado es false.

jms.clientId

Identificador de cliente JMS que se va a establecer para suscripciones duraderas.

jndi.properties.file

Vía de acceso completa del archivo jndi.properties que contiene todas las propiedades relacionadas con JNDI. Si esta propiedad no se encuentra o no está configurada, o el archivo es incorrecto, el recopilador utilizará la configuración JNDI predeterminada. Si configura esta propiedad, establezca estas propiedades en el archivo:

java.naming.factory.initial

Especifica la fábrica de contexto inicial a utilizar. El valor de la propiedad debe ser el nombre de clase completo de la clase de fábrica que creará un contexto inicial. El valor predeterminado es org.jboss.naming.remote.client.InitialContextFactory.

Nota: Para AMS/IDM versión 9.7 o 9.7.03 o 9.7.05, utilice el valor java.naming.factory.initial como org.wildfly.naming.client.WildFlyInitialContextFactory.

java.naming.provider.url

Especifica la ubicación del proveedor de servicios JBoss JNDI que utilizará el cliente. La clase NamingContextFactory utiliza esta información para saber a qué servidor JBossNS conectarse. El valor de la propiedad debe ser una serie URL. El formato de este valor es remote://EMS host:port. El valor predeterminado es remote://127.0.0.1:4447. Cambie este valor al host y puerto EMS.

java.naming.factory.url.pkgs

Especifica la lista de prefijos de paquetes que se usarán al cargar en las fábricas de contexto de URL. El valor de la propiedad debe ser una lista de prefijos de paquete separados por dos puntos para el nombre de clase de la clase de fábrica que creará una fábrica de contexto de URL. El valor predeterminado es org.jboss.ejb.client.naming.

java.naming.security.principal

El principal para autenticar. Esta debe ser una serie que represente el nombre de un principal. El valor predeterminado es admin.

java.naming.security.credentials

Las credenciales para autenticar el principal, por ejemplo, la contraseña. El valor predeterminado es admin.

jnp.maxRetries

Un entero que controla el número de reintentos de conexión que se realizarán en la conexión inicial al servidor de nombres. Este parámetro solo se aplica a fallas de ConnectException. Un valor menor o igual a 1 significa que solo se hará un intento. El valor predeterminado es 5.

jnp.timeout

El tiempo de espera de conexión en milisegundos. El valor predeterminado es 30000. Si este valor se establece en 0(cero), la conexión se bloqueará hasta que se agote el tiempo de espera de la capa TCP/IP de la máquina virtual.

jnp.partitionName

Esta propiedad solo es aplicable para una configuración JNDI de clúster. Si no está utilizando una configuración JNDI de clúster, elimine esta propiedad. Especifica el nombre de la partición del clúster al que se debe restringir el descubrimiento. Si está ejecutando el producto en un entorno con varios clústeres, es posible que desee restringir el descubrimiento de nombres a un clúster particular. No hay un valor predeterminado, lo que significa que se aceptará cualquier respuesta de clúster.

jnp.discoveryGroup

Esta propiedad solo es aplicable para una configuración JNDI de clúster. Si no está utilizando una configuración JNDI de clúster, elimine esta propiedad. La dirección IP de multidifusión a la que se envía la consulta de descubrimiento. El valor predeterminado es 228.1.2.5.

jboss.naming.client.connect.options.org.xnio.Options.SSL_STARTTLS

Nota: Esta propiedad sólo es aplicable a AMS/IDM versión 9.6 o superior. Si no está utilizando AMS/IDM versión 9.6 o superior, elimine esta propiedad del archivo.

Parámetro booleano.

jboss.naming.client.connect.options.org.xnio.Options.SASL_POLICY_NOPLAINTEXT

Nota: Esta propiedad sólo es aplicable a AMS/IDM versión 9.6 o superior. Si no está utilizando AMS/IDM versión 9.6 o superior, elimine esta propiedad del archivo.

Parámetro booleano.

jboss.naming.client.remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABLED

Nota: Esta propiedad sólo es aplicable a AMS/IDM versión 9.6 o superior. Si no está utilizando AMS/IDM versión 9.6 o superior, elimine esta propiedad del archivo.

Parámetro booleano.

jboss.naming.client.connect.options.org.xnio.Options.SSL_PROTOCOL

Nota: Esta propiedad sólo es aplicable a AMS/IDM versión 9.6 o superior. Si no está utilizando AMS/IDM versión 9.6 o superior, elimine esta propiedad del archivo.

Especifica el protocolo que se va a utilizar. Los valores permitidos son TLSv1.2.
Configure la sección Propiedades de CSV.
Los datos del EMS se descargará como un archivo con formato de valores separados por comas (CSV). Puede configurar qué valores del EMS para NE y NE System se exportarán a un archivo CSV. Los primeros tres valores siempre se correlacionan con el nombre de NE (o el nombre de NE System), tipo de objeto gestionado e identificador de objeto. Dado que el orden exacto de los valores restantes del archivo CSV puede variar en diferentes sistemas, debe configurar la correlación de forma que los valores se correlacionen de forma correcta con el recopilador.

Restricción: Los valores que utilice para las variables siguientes deben coincidir exactamente con los nombres de atributo exportados por el EMS.
csv.NE.1
Especifica la correlación de la primera variable sin correlacionar para una línea del archivo CSV y describe un NE, es decir, la cuarta variable de la línea. Por ejemplo:
```
csv.NE.1=IP Address
```
csv.NE.n

Especifica la correlación de la siguiente variable sin correlacionar, donde n es un entero que se incrementa en 1 con cada variable posterior.

csv.NE_System.1
Especifica la correlación de la primera variable sin correlacionar para una línea del archivo CSV y describe un NE System, es decir, la cuarta variable de la línea. Por ejemplo:
```
csv.NE_System.1=Contact
```
csv.NE_System.n

Especifica la correlación de la siguiente variable sin correlacionar, donde n es un entero que se incrementa en 1 con cada variable posterior.
En los siguientes datos de ejemplo para un NE, el nombre de NE es ISAM123, el tipo de objeto gestionado es NE y el identificador de objeto es ISAM123.
```
ISAM123,NE,ISAM123,192.168.242.175
```
El valor 192.168.242.175 es la dirección IP. Por lo tanto, debe definir la siguiente propiedad:
```
csv.NE.1=IP Address
```
En los siguientes datos de ejemplo para un NE System, el nombre de NE System es ISAM123, el tipo de objeto gestionado es NE System y el identificador de objeto es ISAM123.
```
ISAM123,NE System,ISAM123,Mike,Main UK ISAM system,R4.5.02,,00:80:C0:52:D4:8F,"Administrators office"/,3FE478262BNAA_E3.2.0.9,EX1234,LEUK,10/9/14 3:11:26 AM
```
Para correlacionar correctamente los valores restantes, defina las siguientes propiedades:
```
csv.NE_System.1=Contact
csv.NE_System.2=Description
csv.NE_System.3=Ethernet DSL
csv.NE_System.4=ETSI Version
csv.NE_System.5=HUB MAC Address
csv.NE_System.6=Location
csv.NE_System.7=MIB Version
csv.NE_System.8=System ID
csv.NE_System.9=Type
csv.NE_System.10=Up Time
```
En la sección de propiedades JMS HTTPS, configure las propiedades relacionadas con el Java Messaging Service seguro:

jms.secure

Si true, se establece la conexión JMS segura HTTPS. Si false, la conexión no es segura. El valor predeterminado es true.

jms.keystore

La ruta completa al archivo trust-store. Esta propiedad sólo entra en vigor cuando la propiedad soap.secure se establece en true.

jms.keypass

Contraseña del archivo trust-store. Esta propiedad sólo entra en vigor cuando la propiedad soap.secure se establece en true.

jndi.isClusterSetup

Establézcalo en true si el servidor JNDI se está ejecutando en modalidad de clúster. Establézcalo en false si el servidor JNDI no se está ejecutando en modalidad de clúster. Si la versión de EMS es 9.6 o superior, establezca el valor en false. El valor predeterminado es true.
En la sección SKIP Properties , configure las propiedades para omitir algunos MO o dispositivos del proceso.
skipMos

Lista de nombres de MO separados por comas que deben omitirse del procesamiento. Si no desea omitir ningún dispositivo, deje esta sección vacía.

skipDevices

Establézcalo en true para omitir dispositivos, o establézcalo en false para no omitir dispositivos. El valor predeterminado es false.

skipDevicesRegex

Lista de patrones de expresiones regulares separados por comas para nombres de dispositivos que se omitirán del procesamiento. Si no desea omitir ningún dispositivo, deje esta sección vacía. En el siguiente ejemplo, se omiten todos los nombres de dispositivos, que se encuentran en la primera columna del archivo CSV, que coinciden con los dos patrones.
```
05-\\d+-\\d+-\\d+(.*), 06-\\d+-\\d+-\\d+(.*)
```
Guarde el archivo de configuración del recopilador.
Comando para ejecutar el recopilador:
Para ejecutar el recopilador, utilice el mandato siguiente y alimente la versión de EMS utilizando el argumento -idmVersion.
```
./run_Nokia5529Idm_collector.sh -Xms512m -Xmx2G –jar Nokia5529Idm/Nokia5529IdmCollector.jar -propsFile Nokia5529Idm/Nokia5529IdmCollector.properties -idmVersion <version> -bg
```
La < versión> debe sustituirse por uno de los valores de la lista siguiente basándose en la versión de EMS de destino.
- 9.7.03
- 9.6.07
- 9.6.08
- 9.5
- 9.4
Nota: Si no se especifica -idmVersion en el mandato mencionado, se tiene en cuenta el valor predeterminado. El valor predeterminado es 9.4. Luego, establece la ruta de clase para la versión 9.4 de las bibliotecas EMS.