Gua de Instalacin del

plugin para SAP

PLUGIN SAP PARA PANDORA FMS

Plugin SAP para Pandora FMS

Gua de Instalacin | Versin 20 Octubre 2015

Artica Soluciones Tecnolgicas 2005-2015

Deset Soluciones Tecnolgicas 2012-2015

Index
1. INTRODUCCIN ........................................................................................................................ 3
1.1. Pre-requisitos ...................................................................................................................... 4
2. INSTALACIN ............................................................................................................................ 5
2.1. Ejecucin del instalador ...................................................................................................... 5
2.1.1. Pasos instalacin cliente Pandora FMS ...................................................................... 5
2.1.2. Nuevas confguraciones de sistemas, cambios en los monitores, etc. ...................... 11
2.1.3. Desinstalacin del agente ......................................................................................... 13
2.2. Parmetros a modificar ..................................................................................................... 13
2.3. Mdulos de monitorizacin SAP ....................................................................................... 13
2.4. Instalacin de la licencia ................................................................................................... 13
2.5. Anexo: Tareas de postconfiguracin ................................................................................ 14
2.5.1. Verificacin del buen funcionamiento del plugin ....................................................... 14
2.5.2. Verificacin de las libreras JCO ............................................................................... 14
2.5.3. Verificacin de acceso entre el servidor Pandora FMS y el sistema SAP a
monitorizar ............................................................................................................................. 14
2.6. Anexo: Solucin de problemas ......................................................................................... 15
2.6.1. Error: Texto sobre "versin error minor 49"............................................................... 15
2.6.2. Error: Exception in thread "main" java.lang.NoClassDefFoundError:
com/sap/conn/jco/JCoE Xception .......................................................................................... 15
2.6.3. Error: Java.lang.ExceptionInInitializerError: Error getting the version of
thenativelayer:java.lang.UnsatisfiedLinkError:com.sap.conn.rfc.driver.Cp
icDriver.NativeCpicGetVersion ............................................................................................... 15
2.6.4. Error: (solo en sistemas Windows)............................................................................ 16
2.6.5. Problemas en el lado SAP ........................................................................................ 16
2.6.6. Problemas en el lado Pandora FMS ......................................................................... 16
2.6.7. Datos necesarios para la conexin de Pandora FMS a SAP .................................... 16
2.6.7.1. Permisos del usuario SAP de conexin ............................................................ 16

Page 2
PLUGIN SAP PARA PANDORA FMS

1. INTRODUCCIN
La solucin Pandora FMS plugin de Deset ha sido certificada por SAP como SAP Certified
Integration with SAP NetWeaver.

SAP concedi la certificacin a Deset tras haber superado con xito un riguroso proceso de
auditora que evalu el producto. Esta certificacin reconoce que el software Pandora FMS
plugin est perfectamente alineado con los requerimientos de calidad, cumplimiento de
estndares y seguridad de SAP sobre la integracin con sus soluciones SAP NetWeaver.

La potente y flexible arquitectura de Pandora nos lo permite en base a mdulos remotos plugin
Server. Cero instalacin en el servidor SAP.

Se trata de una aplicacin Java, la cual a su vez requieren las libreras de conectividad SAP
JCO.

Por su diseo de agente satlite no-intrusivo, en los entornos SAP no se instalar nada, ni se
cargar ningn programa, ni se deber parametrizar (o configurar) absolutamente nada.
nicamente se precisar de un usuario de logon SAP con las autorizaciones necesarias para
ejecuciones remotas RFC.

Esto aporta adicionalmente el soporte de los entornos SAP R/3 en todas sus plataformas de
sistemas operativos. Existen dos arquitecturas de instalacin del Plugin para SAP:

1) Plugin SAP instalado dentro del servidor Pandora FMS server:

Pandora FMS Servidor

con plugin Pandora
SAP/R3
Pandora FMS FMS
para SAP Enterprise
SAP RFC
conexin

Este es un modo de funcionamiento avanzado que, por su mayor complejidad, requiere soporte
especfico. No se recomienda pudiendo utilizar el mtodo de uso basado en agente. El modo
plugin era el que se empleaba hasta la versin 5.1 de Pandora FMS, pero su uso no est
recomendado, aunque est completamente operativo y soportado. En la documentacin antigua
se pueden encontrar todava referencias a este modo de funcionamiento, no siendo vlidas a
partir de la versin 5.1 de Pandora FMS.

Page 3
PLUGIN SAP PARA PANDORA FMS

1) Plugin SAP instalado en un servidor Windows (en lugar de dentro del Pandora Server):

Servidor
Windows Servidor
Servidor
(Agente de Pandora
SAP/R3Sr Pandora FMS FMS
para SAP) Tentacle
RFC
Servidor Protocol
Connection

Ventajas: Simplifica enormemente la instalacin del agente respecto a la arquitectura anterior

(Plugin SAP instalado dentro del servidor Pandora), ya que que en vez de realizar acciones de
instalacin de libreras y otorgar permisos al plugin, hay que usar un simple instalador de un
binario .EXE con la Sonda/agente windows, y en 5 minutos se comenzar la monitorizacin.

** Este documento se refiere nicamente a la instalacin en esta segunda arquitectura:

Agente para Windows, que sondea todos los servidores SAP en remoto, y enva los datos
obtenidos hacia un Servidor Pandora.

1.1. Pre-requisitos
1) Tener instalado Pandora FMS en cualquiera de sus versiones: Para un entorno de Piloto
(Prueba de Concepto) se soporta el uso de Pandora FMS Open Source, sin licencia de Pandora
SAP Agente para Windows (de duracin 30 das). Pasado los 30 das de uso de licencia
temporal, se requiere Licencia Pandora SAP que incluye Pandora FMS Enterprise y soporte
profesional.

2) Un sistema Windows que actuar como servidor.

3) En este sistema Windows: Tener instalado el Java JVM 1.4 o superior en este sistema
donde se ejecute el Agente para Windows.

Importante: En sistema Windows de 32 bits (p.ej. Windows XP) se debe instalar previamente las
libreras vcredist_x86.exe. Pueden obtenerse en el siguiente link:

http://www.deset.es/download/express/vcredist_x86.exe

4) Sobre los requisitos de los servidores SAP a monitorizar: Requerir al administrador de

sistemas SAP la creacin de un usuario de login de acceso por cada servidor SAP a monitorizar.

Page 4
PLUGIN SAP PARA PANDORA FMS

Este usuario debe ser de tipo B-Sistema (System) en versiones SAP ECC, o de tipo C-
Comunicacin / CPI-C/RFC en versiones de SAP anteriores.
Este tipo de usuario imposibilita ser usado por otras personas desde el SAPGUI, y
adicionalmente el de tipo Sistema tiene la ventaja de que no caducan sus passwords (lo cual
obligara a cambiarlas tambin en la configuracin de Pandora FMS). Los permisos del perfil de
autorizacin de dicho usuario se indican al final de este documento con el apartado de Anexo.

No se necesario cumplir ningn requisito adicional. Se soportan todas las versiones de SAP con
stack ABAP, y no es preciso subir de nivel de parche, ni la instalacin de software adicional (ni
ordenes de transporte, ni scripts).

2. INSTALACIN
2.1. Ejecucin del instalador
2.1.1. Pasos instalacin cliente Pandora FMS
Para la instalacin del Agente desde Windows, lo primero que haremos ser descargarnos el
ejecutable de la web. Una vez descargado haremos doble clic sobre el mismo.

Nos pedir que seleccionemos el idioma. Una vez seleecionado hacemos clien el botn
"Siguiente".

Page 5
PLUGIN SAP PARA PANDORA FMS

Aceptaremos los trminos del acuerdo de licencia.

Y seleccionaremos la ruta donde queremos instalar el agente.

Page 6
PLUGIN SAP PARA PANDORA FMS

Nos mostrar un resumen de instalador y pulsaremos "Siguiente".

Al finalizar la instalacin, nos pedir los datos para crear los distintos sistemas a monitorizar. El
primero ser el nombre o IP de nuestro servidor Pandora, junto con el nmero de licencia. En
caso de no disponer de ninguna dejaremos el campo en BLANCO, con lo cual entraremos en
modo Licencia Temporal que nos permitir usar el agente durante 30 das para evaluarla, y una
vez terminado este periodo, contactar con info@deset.es para adquirir la licencia definitiva.

Page 7
PLUGIN SAP PARA PANDORA FMS

Despus daremos de alta los distintos sistemas SAP que queramos monitorizar. Para ello
debemos tener los siguientes datos:

- Agente de Pandora: Nombre del Agente en Pandora. Es el SID del sistema SAP, y este
nombre es el que representar al sistema SAP a monitorizar en la web console (** Importante:
deber contener espacios en blanco o fallar la conexin).

- Hostname: nombre o IP donde est nuestro sistema SAP.

- Mandante: Cliente de trabajo (Ejemplo: 200).

- N de sistema: NR (Ejemplo: 00).

- Usuario: Usuario de login en este sistema SAP. Con los permisos necesarios, ver anexo.
Importante: en sistemas SAP 4.6C o inferior, debe indicarse en maysculas, o de lo contrario
obtendremos error de autorizacin

- Password: Contrasea del anterior usuario, para acceso al SAP. Importante: en sistemas SAP
4.6C o inferior, debe indicarse en maysculas, o de lo contrario obtendremos error de
autorizacin.

NOTA: Si queremos dar de alta ms sistemas en la instalacin, pulsaremos sobre aadir

sistemas y volveremos a meter todos estos datos por cada nuevo sistema SAP a monitorizar.

Page 8
PLUGIN SAP PARA PANDORA FMS

Al finalizar pulsaremos Siguiente y nos preguntar si queremos arrancar el servicio respondiendo

que s, para que se conecte al Servidor Pandora y d de alta los sistemas SAP.

Y finalizaremos la instalacin.

Page 9
PLUGIN SAP PARA PANDORA FMS

Una vez acabado, encontraremos una servicio que es el que mandar la informacin a Pandora
FMS.

El servicio, una vez arrancado, comenzar el sondeo remoto de todos los sistemas SAP
configurados, y a su vez enviar los valores de estatus hacia el servidor Pandora .

La primera prueba consistir en acceder al Servidor Pandora con un navegador, y veremos que
se ha creado el agente y todos sus monitores:

Page 10
PLUGIN SAP PARA PANDORA FMS

DES representa el servidor SAP monitorizado.

Localhost.localhost representa al Servidor Pandora.
PANDORA_SAP_CLIENT representa al servidor Windows con el Agente desde
Windows.

2.1.2. Nuevas confguraciones de sistemas, cambios en los monitores, etc.

Ya desde la web Console en el servidor Pandora podremos editar los parmetros de umbral de
cada monitor. Tambin crearemos las alertas y Templates relativos a cada monitor, asignando el
email de la persona que recibir las alertas.

El resto de configuraciones de Aadir nuevos sistemas y Nuevos monitores, debemos hacerlo

editando el fichero .conf en el Servidor Windows donde acabamos de instalar el Agente para
Windows.

En la versin con Licencia adquirida, al disponerse de servidor Pandora FMS versin Enterprise,
dispondremos el modo de remote_config donde esta edicin del fichero .cong lo podremos
hacer mas cmodamente y controladamente desde el propio Web Console.

En la carpeta donde hayamos instalado el cliente, encontraremos un fichero .conf con el nombre
que dimos a los agentes de Pandora FMS.

Page 11
PLUGIN SAP PARA PANDORA FMS

En el caso de querer aadir nuevos monitores a ese sistema los haremos desde ah.

Para dar de alta nuevos sistemas, lo primero que haremos ser parar el servicio. Y despus,
simplemente copiaremos el fichero y lo pondremos con el nombre que queramos para ese
agente, editaremos el fichero y reemplazaremos, la ip o hostname, cliente, mandante, usuario y
contrasea por el del nuevo sistema. Luego editaremos el fichero pandora_agent.conf y
aadiremos al final del mismo una nueva lnea, a continuacin de la que tendremos con el
nombre de nuestros agentes.

broker_agent PANDORA_SAP_XYD
broker_agent Nuevo_agente

Arrancaremos de nuevo el servicio y al rato veremos como en nuestro servidor de Pandora,

automticamente se dar de alta un nuevo sistema

En caso de querer cambiar la licencia temporal por la permanente, simplemente pararemos el

servicio y en los fichero nombre_agente.conf, reemplazaremos la licencia antigua por la nueva
(buscando los parmetros li) . Una vez hecho esto, simplemente arrancaremos el servicio,
quedando la nueva licencia instalada.

Page 12
PLUGIN SAP PARA PANDORA FMS

2.1.3. Desinstalacin del agente

Para la desinstalacin del agente, simplemente iremos al men de Windows y en Pandora FMS
elegiremos "Desinstalar" y seguiremos los pasos para la desinstalacin.

2.2. Parmetros a modificar

server_ip xxxx, se debe sustuir por la IP del servidor de Pandora FMS al que deseamos enviar
la informacin.

group xxxx, se debe sustituir por el grupo de destino.

remote_config 1, se debe descomentar y establecer el valor a 1 para que el agente se puede

configurar remotamente desde la consola de Pandora.

2.3. Mdulos de monitorizacin SAP

Por defecto se encuentras 10 mdulos activados:

Son mdulos para el chequeo habitual diario de los sitemas SAP, y que nos deben servir como
base para definir otros mdulos, la forma de configurarlo es hacer una llamada al plugin variando
el tipo de modulo (parmetro m), siguiendo la siguiente sintaxis:

PARAMETROS POR LINEA DE COMANDOS DEL PLUGIN SAP

Campo Valor a indicar

Plugin parameters -o <hostname_sap> -c <mand> -s <sn> -m <num. monitor> -i <SID>

-o : indicar hostname de la instancia SAP que queremos monitorizar

-c : indicar el nmero de mandante del sistema SAP

-s : indicar el System Number de la instancia SAP a monitorizar

-i : indicar el SID del sistema SAP

-m : ID del punto de monitorizacin a consultar del sistema SAP.

Ver tabla de Monitores para indicar en el parmetro m los valores admitidos

La lista detalla de mdulos y su significado se puede consultar en el anexo final de esta

documentacin.

2.4. Instalacin de la licencia

Editaremos el fichero pandora_agent.conf, y en todos los lugares donde se encuentre el
parmetro li , a continuacin escribiremos el nmero de licencia, quedando li <numero de

Page 13
PLUGIN SAP PARA PANDORA FMS

licencia> para almacenar la licencia.

2.5. Anexo: Tareas de postconfiguracin

2.5.1. Verificacin del buen funcionamiento del plugin
Accederemos al shell y ejecutaremos el siguiente comando desde el directorio donde instalamos
el agente:

cd <directorio agente windows>

java -classpath <directorio agente windows>/Deset_SAP_Plugin.jar
Deset_SAP_Plugin m 160 -t <ip>

Y si la licencia es correcta o estamos dentro del perodo de licencia temporal obtendremos un

mensaje como este:

C:\Program Files\pandora_agent>java -classpath "C:\Program

Files\pandora_agent\Deset_SAP_Plugin.jar" Deset_SAP_Plugin -m 160 -t 172.20.33.44
<module> <name><![CDATA[SAP-001: SAP
AgentLive]]></name><type><![CDATA[generic_proc]]></type><description><![CDATA[SAP Agentlive: 0 -
OK, 1 - ERROR]]></description><data><![CDATA[1]]></data><min_critical>1</min_critical></module>

Si la licencia ha caducado mostrar un mensaje similiar a este:

C:\Program Files\pandora_agent>java -classpath "C:\Program

Files\pandora_agent\Deset_SAP_Plugin.jar" Deset_SAP_Plugin -m 160 -t 172.20.33.44
-1
***License Expired ***
Expiration Date:20151119
Please contact with Deset www.deset.es, or email to info@deset.es

2.5.2. Verificacin de las libreras JCO

La comprobacin consistir en ejecutar via linea de comandos el monitor Informacin de
Sistema (monitor nmero 120) va lnea de comando. Para ello, ejecutaremos la siguiente lnea:

java -classpath <directorio agente windows>/Deset_SAP_Plugin.jar

Deset_SAP_Plugin -u <usuario_SAP> -p <password_usuario_SAP> -m 120 -s
<System_Number_Instancia_SAP> -t <Ip_Instancia_SAP > -c
<mandante_Instancia_SAP >

2.5.3. Verificacin de acceso entre el servidor Pandora FMS y el sistema SAP a

monitorizar
Se deber comprobar que se accede va red al servidor, a los puertos 3300 (protocolo SAP
RFC). El puerto ser 33NN donde NN corresponde al SAP System Number (nmero de Instancia
SAP).

Se puede realizar un telnet IP_Servidor_SAP 3300 para comprobar la conectividad

Page 14
PLUGIN SAP PARA PANDORA FMS

3. ANEXO: SOLUCIN DE PROBLEMAS

* Error: Texto sobre "versin error minor 49"

Exception in thread "main" java.lang.UnsupportedClassVersionError: Deset_SAP_Plu gin

(Unsupported major.minor version 49.0)

at java.lang.ClassLoader.defineClass0(Native Method) at
java.lang.ClassLoader.defineClass(Unknown Source) at
java.security.SecureClassLoader.defineClass(Unknown Source) at
java.net.URLClassLoader.defineClass(Unknown Source) at
java.net.URLClassLoader.access$100(Unknown Source) at
java.net.URLClassLoader$1.run(Unknown Source) at
java.security.AccessController.doPrivileged(Native Method) at
java.net.URLClassLoader.findClass(Unknown Source) at
java.lang.ClassLoader.loadClass(Unknown Source) at
sun.misc.Launcher$AppClassLoader.loadClass(Unknown Source) at
java.lang.ClassLoader.loadClass(Unknown Source) at
java.lang.ClassLoader.loadClassInternal(Unknown Source)
Significa que estamos con un java jre 1.4. Debemos instalar el >java -version java version
"1.5.0_20" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_20-b02) Java
HotSpot(TM) Client VM (build 1.5.0_20-b02, mixed mode, sharing)
Fichero jre-1_5_0_20-windows-i586-p.exe de 17 Mb

Significa que estamos con un java jre 1.4. Debemos instalar el >java -version java version
"1.5.0_20" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_20-b02) Java
HotSpot(TM) Client VM (build 1.5.0_20-b02, mixed mode, sharing)

Fichero jre-1_5_0_20-windows-i586-p.exe de 17 Mb

* Error: Exception in thread "main" java.lang.NoClassDefFoundError:

com/sap/conn/jco/JCoE Xception

Significa que se debe copiar el fichero sapjco3.jar en c:\archivos de programa\java\

jre1.5.0_20\lib\ext

* Error: Java.lang.ExceptionInInitializerError: Error getting the version of the

nativelayer:java.lang.UnsatisfiedLinkError:com.sap.conn.rfc.driver.CpicDriver.Nati
veCpicGetVersion

Significa que nos hemos equivocado al instalar la versin adecuada del SAP JCO 3.0
Posiblemente hemos usado la versin para CPU 64 bits en un sistema Linux Pandora con CPU
32 Bits. El tipo de CPU del sistema se averigua con el comando uname -a La solucin ser
instalar la versin adecuada del JCO (32 bits).

Page 15
PLUGIN SAP PARA PANDORA FMS

* Error: (solo en sistemas Windows)

java.lang.UnsatisfiedLinkError: no sapjco3 in java.library.path at

java.lang.ClassLoader.loadLibrary(Unknown Source) at java.lang.Runtime.loadLibrary0(Unknown
Source) at java.lang.System.loadLibrary(Unknown Source)
at com.sap.conn.jco.rt.DefaultJCoRuntime.loadLibrary(DefaultJCoRuntime.j ava:425)
at com.sap.conn.jco.rt.DefaultJCoRuntime.registerNativeMethods(DefaultJC oRuntime.java:293)

Significa que en la ruta path no se encuentra el fichero sapjco3.dll

* Problemas en el lado SAP

Problemas de conexin a la monitorizacin de rendimiento (CCMS).

Solucin: Acceda a la transaccin RZ15 para ver el log CCMS (BC XMI). Debe verse cada
conexin de los monitores de Pandora FMS en intervalos de 5 minutos. Si no hubiera traza,
miraremos el log de errores de conexin de RFC para validar si los datos de
usuario/password/permisos/ firewall/conectividad son correctos. La traza est en: <directorio
agente windows>/util/dev_jco_rfc.trc

*Problemas en el lado Pandora FMS

Lo primero ser comprobar la correcta ejecucin del Plugin accediendo al log de Pandora:
<directorio agente windows>/pandora_agentg.log. Aqu se reflejarn todos los errores de
conexin al servidor SAP (traza RFC) y de todas las ejecuciones erroneas del plugin.

Ejemplo de error: Caused by: com.sap.conn.rfc.exceptions.RfcGetException: You are not

authorized to logon to the target system (error code 2).

Este texto indica que el usuario de conexin, o no tiene suficientes permisos, o el password no
se ha escrito correctamente en el Monitor de Pandora FMS (por ejemplo, por no escribirlo en
maysculas).

* Datos necesarios para la conexin de Pandora FMS a SAP

Permisos del usuario SAP de conexin: Usuario SAP de tipo sistemas o comunicacin, para
cada sistema a monitorizar. La recomendacin es que sea de tipo sistema, pero si el usuario que
se crea es de tipo C (comunicacin), revisar si el sistema tiene habilitado el parmetro
login/password_max_idle_initial con valor distinto de 0. Si este parmetro esta en valor distinto
de 0, lo que hace es bloquear los usuarios que tienen la contrasea inicializada transcurrido el
valor indicado en el parmetro. Por lo que es recomendable siempre no dejar la contrasea
inicializada al usuario, para evitar problemas.

Page 16
PLUGIN SAP PARA PANDORA FMS

Para la creacin del usuario en el sistema SAP, ser necesario que tenga los siguientes objetos
de autorizacin.

Objeto de Autorizacin "S_RFC":

Campo ACTVT Actividad, indicar "16 Ejecutar"

Campo RFC_TYPE Tipo de objeto RFC a proteger, indicar "X FUGR" Grupo Funciones

Campo RFC_NAME Nombre del objeto RFC a proteger, indicar los valores I*, R*, S*, O*, T*

Objeto de Autorizacin S_TABU_DIS

Campo ACTVT, indicar 03 Visualizar

Campo DICBERCLS, indicar *

Objetos de autorizacion: S_XMI_LOG y S_XMI_PROD (con todos sus campos con

valores *)

Page 17