Ejecución manual

Para una correcta ejecución del plugin PandoraFMS_SAP_Plugin es necesario indicar una serie de parámetros mínimos para todos los casos.

Además de estos parámetros mínimos, dependiendo de si el plugin se ejecuta como plugin de agente o como plugin de servidor, se tendrá que indicar un parámetro con el o los modulos de los que obtener datos según sea el caso.

Por último, y dependiendo del módulo, es posible que acepte parámetros adicionales (ver en secciones siguientes).

De esta forma, los parámetros mínimos obligatorios para cualquier ejecución son:

-l "<license>" -h "<sap_host>" -c "<sap_client>" -s "<sap_system>" -u "<sap_user>" -p "<sap_password>"

O si se hace uso de una contraseña encriptada:

-l "<license>" -h "<sap_host>" -c "<sap_client>" -s "<sap_system>" -u "<sap_user>" -x "<sap_password_encrypted>"

Para una ejecución como plugin de servidor se tendrá que indicar también:

-m "<plugin_module>"

Mientras que para una ejecución como plugin de agente se tendrá que indicar:

-M "<plugin_module>"

Tambien será necesario indicar la ubicación a la librería de "SAP JCO 3" compilada ("libsapjco3.so" para Linux y "sapjco3.dll" para Windows) mediante un parámetro de Java:

-Djava.library.path=<path_to_sapjco_lib_folder>

Viendolo con un par de ejemplos, esta sería una posible ejecución como plugin de servidor:

java \
-Djava.library.path=/usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/ \
-jar /usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/PandoraFMS_SAP_Plugin.jar \
-l "f51a6712-a3fALLp4x0Af3vAfjr9II2f-bas1g74w"
-h "10.5.6.30" \
-c "001" \
-s "00" \
-u "PANDORA01" \
-p "P45sw0rD." \
-m "SYS_INFO"

Cuya salida sería:

System hostname|System IP|System ID|System instance|System version|DB hostname|DBMS|OS
server|10.5.6.30|XYZ|server_XYZ_00|46C|server|MSSQL|Windows NT

Y esta sería una posible ejecución como plugin de agente:

java \
-Djava.library.path=/usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/ \
-jar /usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/PandoraFMS_SAP_Plugin.jar \
-l "f51a6712-a3fALLp4x0Af3vAfjr9II2f-bas1g74w"
-h "10.5.6.30" \
-c "001" \
-s "00" \
-u "PANDORA01" \
-p "P45sw0rD." \
-M "SYS_INFO"

Cuya salida sería:

<module>
<name><![CDATA[SAP System info]]></name>
<type><![CDATA[generic_data_string]]></type>
<data><![CDATA[System hostname|System IP|System ID|System instance|System version|DB hostname|DBMS|OS
server|10.5.6.30|XYZ|server_XYZ_00|46C|server|MSSQL|Windows NT]]></data>
</module>

En el caso de plugin de agente, y como se ha visto en secciones anteriores, es posible indicar varios módulos para monitorizar en una sola ejecución. Por ejemplo:

java \
-Djava.library.path=/usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/ \
-jar /usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/PandoraFMS_SAP_Plugin.jar \
-l "f51a6712-a3fALLp4x0Af3vAfjr9II2f-bas1g74w"
-h "10.5.6.30" \
-c "001" \
-s "00" \
-u "PANDORA01" \
-p "P45sw0rD." \
-M "SYS_INFO" -M "IDOC_FAIL_COUNT" -M "IDOC_OK_COUNT"

Cuya salida sería:

<module>
<name><![CDATA[SAP System info]]></name>
<type><![CDATA[generic_data_string]]></type>
<data><![CDATA[System hostname|System IP|System ID|System instance|System version|DB hostname|DBMS|OS
server|10.5.6.30|XYZ|server_XYZ_00|46C|server|MSSQL|Windows NT]]></data>
</module>
<module>
<name><![CDATA[IDOCs failed from yesterday - Count]]></name>
<type><![CDATA[generic_data]]></type>
<data><![CDATA[0]]></data>
</module>
<module>
<name><![CDATA[IDOCs ok from yesterday - Count]]></name>
<type><![CDATA[generic_data]]></type>
<data><![CDATA[0]]></data>
</module>

También es posible ejecutar el plugin solo para encriptar una contraseña y enmascararla durante la ejecución definitiva del plugin. Por ejemplo, con la siguiente ejecución:

java \
-Djava.library.path=/usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/ \
-jar /usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/PandoraFMS_SAP_Plugin.jar \
-X "P45sw0rD."

Se obtendría la contraseña encriptada:

jc2hV8nK2NLtn5YvYNZzDQ

Para poder lanzar el plugin de esta forma, usando el parámetro "-x" en lugar de "-p" para indicar la contraseña:

java \
-Djava.library.path=/usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/ \
-jar /usr/share/pandora_server/util/plugin/PandoraFMS_SAP_Plugin/PandoraFMS_SAP_Plugin.jar \
-l "f51a6712-a3fALLp4x0Af3vAfjr9II2f-bas1g74w"
-h "10.5.6.30" \
-c "001" \
-s "00" \
-u "PANDORA01" \
-x "jc2hV8nK2NLtn5YvYNZzDQ" \
-m "SYS_INFO"