Configuración en PandoraFMS
Instalar el plugin en el servidor de PandoraFMS
El procedimiento operativo que se describe a continuación está basado en el uso de PandoraFMS enterprise.
Las operaciones que se indican a continuación deben realizarse cuando se instala Control For i por primera vez en una solución de PandoraFMS ya operativa.
Busque el nombre del directorio que contiene los plugins
En PandoraFMS por defecto la ruta para los plugins del servidor es /usr/share/pandora_server/util/plugin pero se puede utilizar una ruta personalizada, en esta guía vamos a utilizar la que viene por defecto y crearemos un directorio llamado pandora_ibm por ejemplo para poner allí todos los ficheros necesarios.
Transferir el plugin al servidor de PandoraFMS
La instalación del producto Control For i ha creado el directorio "/Ctl4i" que contiene el plugin y el fichero de configuración para instalar en el servidor de PandoraFMS.
Transfiera el plugin y el fichero de configuración desde el directorio "/Ctl4i" de la partición IBM i al directorio que contiene los plugins en PandoraFMS. En nuestro ejemplo: "/usr/share/pandora_server/util/plugin/pandora_ibm".
Si descargamos el paquete de la librería de PandoraFMS, se proporcionará una versión actualizada del cliente de Control4i en el mismo paquete, por lo que podremos evitar la transferencia de datos desde la partición de IBM i al servidor de PandoraFMS.
Para descargar el plugin pandora_ibmi, el cliente de Control4i y los ficheros confs vaya a la librería de PandoraFMS: (url: https://pandorafms.com/library/pandorafms-ibm-i-enterprise-plugin/) y haga clic en el enlace del paquete para descargar un fichero zip que incluye los ficheros necesarios.
Luego transfiera estos ficheros al directorio definido en el servidor de PandoraFMS
Cambiar el puerto a utilizar (si se requiere)
Si el puerto 7357 ya está siendo utilizado, se puede cambiar el puerto a utilizar para la comunicación entre el plugin de PandoraFMS y el agente en la partición IBM i.
El puerto por defecto se define en el fichero check_Control4i_Config situado en el mismo directorio que el plugin que se acaba de transferir.
Edite el contenido de este archivo y cambie el número de puerto.
También se puede utilizar un puerto específico definiendo en la definición del plugin pandora_ibmi, que llama al plugin check_Control4i pasándole el parámetro -p seguido del número de puerto a utilizar.
Compruebe que el cliente check_Control4i funciona correctamente
En la partición IBM i, compruebe que el subsistema CONTROL4I está activo. Si no lo está, inícielo con el comando CTSTRSBS.
En el terminal del servidor de PandoraFMS se puede ejecutar:
Asegúrese de que los binarios check_Control4i y pandora_ibmi tienen derechos de ejecución, en caso de no ser así, simplemente ejecútelos:
Si el mensaje devuelto es:
CTL1015 - El subsistema CONTROL4I está en estado *RUN
Se valida la operación del plugin.
Durante el primer uso, es posible que no reciba respuesta de la partición IBM I. Ejecute el mismo comando 3 veces antes para buscar otra causa. La razón es que cuando el agente se inicia (trabajo CTAGENT) las 3 primeras demandas son rechazadas, por una razón técnica.
Configurar el archivo conf de pandora_ibmi
Para obtener métricas utilizando el plugin pandora_ibmi deberemos modificar el fichero de definición pandora_ibmi.conf, con los comandos que queramos ejecutar en la partición IBM i, para obtener una lista completa de comandos disponibles podríamos dirigirnos al documento IBM i check commands.
Para ejecutar un chequeo básico a nuestra partición IBM i definiremos un par de comandos en el archivo de configuración, que se incluye por defecto:
ExecuteEjecutar pandora_ibmi manuallymanualmente
ToPara executeejecutar pandora_ibmi manuallymanualmente simplysimplemente downloaddescargue el archivo zip, descomprímalo en la ruta deseada y muévalo a ella, en nuestro caso /usr/share/pandora_server/util/plugin/pandora_ibm luego ejecute el pandora_ibmi con la ip del host de zipnuestra file, uncompress it on the desired path and move it to it, in our case /usr/share/pandora_server/util/plugin/pandora_ibm then execute the pandora_ibmi with the host ip from ourpartición IBM i partitiony andel thearchivo definitionde definición conf filecomo as parameters.parámetros.
Remember,Recuerda thereque arehay aun couplepar ofde optionalparámetros parametersopcionales weque canpodemos use,utilizar, likecomo the agentel alias, adel customagente, port,un modulepuerto prefix,personalizado, el prefijo del módulo, etc. ButPero thelos mandatoryobligatorios onesson arela ip del host ipy andel command definitionarchivo conf filede definición de comandos.
This isEste aes serverun plugin sode ifservidor, weasí didn'tque getsi anyno obtenemos ningún error andy ase valuedevuelve ofun 1valor isde returned,1, thatsignifica meansque everytodo runsse correctlyejecuta andcorrectamente they agentel agente (withcon defaultnombre namepor indefecto thisen case)este wascaso) createdse onha ourcreado en nuestro servidor de PandoraFMS serverrecuperando retrievinglos thedatos datade oftodos alllos commandscomandos defineddefinidos onen theel command definitionfichero conf filede definición de comandos.
ConfiguringConfigurar monitoringla onmonitorización PandoraFMSen la consola web Consolede PandoraFMS
WeHemos haveconfigurado configurednuestra ourpartición IBM i partitiony andcomprobado chekque theel pandora_ibmi andy theel check_Control4i arefuncionan, working,por solo nowque weahora shoulddebemos configureconfigurar theel plugin inen thela consola web consolepara inpoder orderutilizarlo topara use to monitormonitorizar IBM i.
OnceUna wevez logque inentramos intoen thela consola web consolecomo asusuario anadministrador, administratorel user,primer thepaso firstes stepacceder isa tola accessconsola. theEn console.la Insección thede ServersServidores, section,accedemos wea accessla thepestaña Pluginsde tab.Plugins.
InEn thisesta tabpestaña willaparecerán appeartodos all the serverlos plug-ins thatdel areservidor installedque byse defaultinstalan withpor defecto con Pandora FMS.
ClickHaga onclic Add.en Añadir.
TheLa followingsiguiente windowventana willnos beservirá usedpara toconfigurar configureel theplugin plug-inantes beforede registering it.registrarlo.
TheEl firstprimer sectionapartado isson generallas options,opciones wheregenerales, wedonde canpodemos setestablecer theel namenombre weque wantqueremos todar giveal toplugin, theel plug-in,tipo thede typeplugin, ofestándar plug-in, standard oro Nagios, theel maximumtiempo executionmáximo timede ofejecución thedel plug-inplugin andy auna briefbreve description.descripción.
InEn theel nextsiguiente sectionapartado wedefinimos definela theruta pathdonde wherese theencuentra plug-inel isplugin locatedy anduna serie de macros, que equivalen a serieslos ofparámetros macros,de whichlos areque equivalentse tocompone theel parametersplugin, ofdefiniremos whichel themínimo plug-innecesario ispara composed,este weejemplo willy defineun theañadir minimumsólo necessaryun forparámetro this example and an adding just anopcional extra optionalcomo parameteralias asde agent alias.agente.
ForPara moreobtener informationmás aboutinformación sobre las macros andy howsu theyfuncionamiento, workvisite pleasela visitdocumentación theen onlinelínea documentational about it:respecto:
Finally,Por ifúltimo, wesi havehemos addedañadido executionparámetros parameters,de thisejecución, sectionesta willsección bese usedutilizará topara definedefinir theseestos parametersparámetros by means ofmediante macros. WeTambién canpodemos alsoañadir addvalores defaultpor valuesdefecto toa theseestas macros, sopara thatque theyse willutilicen been usedcaso inde caseque weno doproporcionemos notningún provide a parameter.parámetro.
InEn thiseste case,caso, sincecomo theel onlyúnico mandatoryparámetro parameterobligatorio ises theel tokenparámetro parameter,token, thelos otherotros twodos willse beconfigurarán configuredcon withvalores defaultpor values.defecto.
OnceUna wevez haveque finished,hayamos clickterminado, onpulsamos Create.en NowCrear. weAhora hacetenemos ournuestro plugin defineddefinido readyy forlisto deployment.para ser desplegado.
Despliegue Deploy the serverel plugin intodel anservidor agenten onun agente de PandoraFMS.
CompleteLa documentationdocumentación aboutcompleta serversobre el despliegue de los plugins deploymentdel couldservidor bese foundpuede on:encontrar en:https://pandorafms.com/manual/en/documentation/03_monitoring/03_remote_monitoring#monitoring_with_server_remote_plugins
Here,Aquí wedesplegaremos will deploy the serverel plugin configuredde beforeservidor onconfigurado aanteriormente testen agent,un inagente orderde toprueba, showcon theel basicfin configurationde neededmostrar tola makeconfiguración itbásica work.necesaria para que funcione.
TheEl firstprimer steppaso ises toacceder accessa thela webconsola console.web. InEn thela resourcessección section,de werecursos, accessaccedemos thea managela agentpestaña tab.de gestionar agente.
HereAquí wepodemos couldseleccionar selectel theagente agentpara todesplegar deploy theel plugin oro createcrear uno nuevo, en nuestro caso vamos a newcrear one,uno in our case we are going to create a new one.nuevo.
ClickHaga onclic createen agentcrear andagente fulfily thecumpla name,con groupel andnombre, neededel fields,grupo theny clicklos oncampos create.necesarios, luego haga clic en crear.
OnceUna created,vez creado, una barra de herramientas está disponible en la parte superior derecha, vaya a toolbarla ispestaña availablede onmódulos, theseleccione upperel righttipo side,'crear goun tonuevo themódulo modulesde tab,servidor selectde the type ‘createplugins', a newcontinuación, plugin server module’, thenhaga clic onen create.crear.
SelectSeleccione theel plugin pandora_ibmi pluginque wedefinimos defined beforeantes
ThenA givecontinuación, itdale aun modulenombre namede andmódulo fullfilly therellena fieldslos configuredcampos onconfigurados theen las macros forpara thisesta execution,ejecución, clickhaz onclic create.en crear.
That'sEso ites thetodo, el plugin isya alreadyestá configured,configurado, waitespere aun couplepar ofde secondssegundos andy thenluego govaya toal theojo eyeen onla theparte uppersuperior rightderecha sidepara tover seelos theresultados executionde results.la ejecución.
OnceUna isvez executed,ejecutado, theel plugin generatesgenera aun newnuevo agentagente withcon alltodos thelos commandscomandos defineddefinidos onen theel command definitionfichero conf file:de definición de comandos:
Frompartir now,de weahora, canpodemos useutilizar thela samemisma templateplantilla andy definitiondefinición topara pointapuntar astantas manyparticiones IBMi partitioncomo asqueramos, wesimplemente want,definiendo justun definingnuevo amódulo newcon modulediferentes with differentdirecciones IP addresseso orincluso evendiferentes different command definitionarchivos conf filede fordefinición differentde modules.comandos para diferentes módulos.