Pandora:Documentation es:Instalacion

From Pandora FMS Wiki

Jump to: navigation, search

Volver a Indice de Documentacion Pandora FMS

Contents

Instalación de Pandora FMS

Requisitos mínimos hardware

Requisitos para la consola y el servidor

  • Hasta 500 agentes o 5.000 módulos: 3GB de RAM y una CPU de un sólo núcleo a 2GHz de reloj. Disco duro rápido, 7200rpm o equivalente. Se supone que el 80% de los modulos tienen histórico y que la media de muestreo es de 5 minutos.
  • Hasta 2.000 agentes o 10.000 módulos: 6GB de RAM y una CPU de doble núcleo a 2.5GHz de reloj y disco duro rápido (7.200 rpm o más). Se supone que el 80% de los modulos tienen histórico y que la media de muestreo es de 5 minutos. Deberá configurar muy bien MySQL para que aguante la carga.
  • Para más de 4.000 agentes: 12GB de RAM, una CPU con cuatro núcleos a 3GHZ y disco duro muy rápido (15.000 rpm o más). Ademas de los presupuestos anteriores, le recomendamos que instale MySQL en un servidor independiente y que instale Percona XTraDB en lugar del MySQL standard.


Image:template_warning.png

No se recomienda utilizar Pandora FMS en entornos virtualizados, ya que tiene unos requisitos de acceso a disco muy estrictos. En el caso de hacerlo, es imprescindible asignar disco independiente, asi como RAM y CPU. Más que recomendable usar discos SAN en estos entornos

 


Image:Info.png

Sólo se debería usar una máquina virtual como entornos de prueba, certificación o desarrollo, pero nunca se recomienda usarlos en sistemas de producción

 


Se recomienda un minimo de 15GB de disco, recomendado 25GB.

Requisitos minimos de software

La plataforma oficial de Pandora FMS es Linux. Desde la version 5.1 también se soporta Windows Server. Oficialmente se soportan, para el servidor y la consola, las siguientes versiones:


Componente Sistema Operativo
Pandora FMS 5.1 o superior
  • Windows Server (2003 o superior)
  • RedHat Enterprise (RHEL) 6.x
  • CentOS 6.x
  • SLES 11 SP1 o superior
  • OpenSUSE 11.x o superior
  • Debian 5.x o superior.
  • Ubuntu 11 o superior.


Otras plataformas donde Pandora FMS funciona, aunque no demos soporte oficial son:

Componente Sistema Operativo
Pandora FMS 4.0 o superior
  • FreeBSD 9.1
  • Solaris 10 / OpenSolaris


Los agentes de Pandora FMS se pueden ejecutar en cualquier sistema operativo, para más detalles, consulte la sección de requisitos para el agente (más abajo).

Requisitos de Base de datos

Antes de comenzar a instalar Pandora FMS, necesita tener un servidor de MySQL funcionando (Oracle y PostgreSQL se soportan, pero todavia de forma experimental). Esto significa que antes de instalar Pandora, necesita tener corriendo, bien configurado y operativo, el software de base de datos MySQL, puede estar en el mismo servidor fisico donde quiere ejecutar Pandora FMS, o en un servidor independiente, de forma que la consola y el servidor, accedan a él a traves de la red, via TCP/IP. En resumen, necesitará:

  • Dirección IP de su MySQL Server, o 'localhost' si se instala en el mismo servidor de Pandora.
  • Usuario con privilegios para crear bases de datos y usuarios (generalmente root). Este usuario debera poderse conectar desde la IP del servidor donde instalemos pandora fms.
  • Password del usuario con privilegios

Image:template_warning.png

Necesitará tener todo esto ANTES de empezar a instalar Pandora FMS. Si no sabe como se instala un servidor MySQL, busque documentación al respecto sobre el proceso completo. No podemos proporcionar toda esa documentación ya que varía en cada sistema, distribución y/o versión.

 


Image:template_warning.png

El soporte para ORACLE y POSTGRESQL recuerde que es EXPERIMENTAL.

 


Requisitos para el agente

El agente puede ejecutarse en cualquier hardware que pueda ejecutar el sistema operativo mínimo requerido, que es:


Componente Sistema Operativo
Pandora Agent 4.0 o superior
  • RedHat Enterprise (RHEL) 6.x
  • CentOS 6.x
  • SLES 11 SP1 o superior
  • OpenSUSE 11.x o superior
  • Debian 5.x o superior.
  • Ubuntu 11 o superior.
  • HPUX B.11.11 o superior, con Perl 5.8.
  • AIX 4.3.3 o superior, con Perl 5.8.
  • Sistemas BSD (NetBSD, OpenBSD, FreeBSD), con Perl 5.8.
  • MacOSX 10.6 or higher.
  • Solaris 8 o superior, con Perl 5.8.
  • Windows NT4 (ver notas especiales de esta version).
  • Windows XP
  • Windows 2000
  • Windows 2003
  • Windows 2008
  • Windows 7
  • Windows 8
  • Windows 2012
Pandora Android Agent 2.0 o superior
  • Android 2.2 o superior
Pandora Embedded Agent 4.0 o superior
  • Dispositivos embebidos, requiere compilación



Image:Info.png

Existe un agente especial para Windows NT, que es basicamente el agente de Unix compilado para Windows, aunque el rendimiento es muy inferior al de un agente nativo Windows y las funcionalidades de acceso a la API nativa no están presentes

 


Además en entornos UNIX debe estar instalado:

  • Perl 5.8 o superior
  • Opcionalmente el paquete unzip instalado correctamente y accesible en el path del usuario que va a ejecutar el agente.(Sólo si se desean usar las colecciones de ficheros).
  • Opcionalmente, si desea usar el inventario de hardware en los agentes, deberá instalar la herramienta lshw y dejarla accesible en el path del sistema.

Requisitos para el servidor

Aunque puede trabajar sobre cualquier sistema operativo con Perl 5.8 instalado y con iThreads habilitados, se recomienda y está soportado únicamente sobre Linux y FreeBSD. También funciona sobre sistemas Solaris.

Hay que destacar que Pandora FMS necesita un servidor MySQL para almacenar toda la información. Este servidor puede instalarse en cualquier plataforma soportada por MySQL (Windows, Linux, Solaris, etc).

Se deberá tener instalado Perl 5.8, al menos, para que el servidor funcione correctamente. Además de los paquetes de SNMP del sistema operativo (net-snmp) para usar el servicio SNMP de Pandora FMS. También se requiere una base de datos (MySQL). También se requieren los paquetes nmap y opcionalmente el paquete xprobe2 para utilizar las caracteristicas avanzadas de reconserver, así como las bibliotecas traceroute de Perl para poder hacer autodescubrimientos de red. Por último,también es necesario, el cliente binario de WMI para hacer consultas WMI contra sistemas Windows. Dicho cliente binario es parte del proyecto SAMBA (v4) y puede ser compilado -no sin cierta dificultad- en cualquier entorno Unix. La version enterprise requiere un binario que hay que compilar, y para el cual existen versiones de todas las plataformas oficialmente soportadas.

Requisitos para la consola

De igual manera que el servidor, se recomienda su operacion sobre sistemas Linux, pero dado que la interfaz web es una aplicacion AMP pura (Apache, MySQL y PHP), podría trabajar teóricamente sobre cualquier sistema que lo soporte: Windows, Unix, etc.

Requisitos para administrar la herramienta via WEB

Se deberá disponer de un navegador web para instalar y comprobar el funcionamiento de la consola. En principio no se requiere que el navegador tenga el complemento de FLASH instalado, aunque se recomienda para poder hacer uso de las gráficas interactivas en Flash.

Dependencias de paquetes

Pandora FMS depende en gran parte del sistema operativo Linux, pero además necesita paquetes adicionales que muchas veces no vienen instalados de forma predeterminada. En el proceso de instalación se detallan de forma específca esas dependencias para sistemas Debian/Ubuntu y OpenSUSE.

Cuestiones previas a la instalación

MySQL

Necesitará un servidor MySQL operativo ANTES de instalar Pandora, ya que el siguiente paso tras instalar los paquetes de Pandora, es configurar el acceso a la BBDD de datos. Si esta instalando Pandora FMS a la vez que el servidor MYSQL, recuerde que tiene que arrancar y configurar el acceso al usuario root de MySQL. Esto se hace mediante dos comandos:

1. Arrancar:

/etc/init.d/mysql start

2. Configurar el password de root

mysqladmin password <password>

Donde '<password>' es el password que establece para el usuario root. Este password se le pedirá en el proceso de instalación de Pandora FMS.

Orden de instalación de Pandora FMS

Es recomendable seguir el siguiente orden al instalar Pandora FMS:

  1. Instalar la consola
  2. Instalar el servidor

La razón es que la base de datos MySQL que usa el servidor se crea en el proceso de configuración inicial de la consola, y por ello para asegurar el correcto funcionamiento del servidor es recomendable realizar primero el proceso de instalación completo de la consola.

Además no es necesario que la consola y el servidor de Pandora FMS se encuentren alojados en la misma máquina, ya que es posible indicarle al servidor dónde se encuentra la base de datos MySQL mediante el archivo de configuración del servidor.

La instalación del agente la podemos realizar sin ningún problema antes o después de instalar el servidor y la consola ya que es independiente de estos y puede estar instalado en cualquier máquina.


Instalación de la versión Enterprise de Pandora FMS

A partir de la versión 4.0.2 el numero de licencia de Pandora FMS habilita el uso de las características Enterprise. Esto significa que si tiene instalada una version enterprise 4.0.2 sin un número de licencia válido, no funcionará. Debe instalar primero la version OpenSource, meter el nº de licencia y luego instalar la version enterprise en ese orden. Como resumen:

  • Instale la consola OpenSource.
  • Acceda a la consola, vaya a la seccion de setup e introduzca su licencia ahí (ver imagen más abajo)
  • Instale la consola de la versión Enterprise

No obstante, si lo hace en otro orden, en la propia pantalla que le notificará el error podrá introducir su licencia. La validación de la licencia solo se realiza en la consola. No en el servidor.

Introducir la licencia, en la opcion principal de configuration (setup):





A partir de la versión 5.X, se ha mejorado la seguridad en la licencia y este no es el método correcto. Para instalar la licencia en la versión 5, hay que instalar primero la consola enterprise y acceder a la pantalla de login. Una vez hayamos accedido nos encontraremos con la siguiente pantalla: Activar licencia v5.X


Requisitos específicos de la version Enterprise

Para poder usar el servidor ICMP Enterprise, es necesario una version de NMAP 5.51 o superior.

Instalación mediante el CD "Appliance"

Este CD contiene un sistema CentOS modificado, con el software de Pandora FMS, todas sus dependencias, pre configurado y listo para instalar junto con el sistema operativo en una máquina (virtual o real). Debido a la extensión de esta documentación (hay muchas capturas de pantalla), hemos dedicado un capítulo a la instalación desde el CD de Pandora FMS

Instalación mediante la VM de VMWare

A parte de distribuir la ISO de Centos, podemos encontrar en Sourceforge una imagen Virtual que contiene ya instalada la ISO de PandoraFMS. Esta imagen esta testada con VMWare ESX, VMWare Workstation, Virtualbox e Hyper-V (para que funcione en Hyper-V es necesario exportar el .vmdx a .vdh mediante el ejecutable MVDC.exe disponible tras instalar Microsoft Virtual Machine Converter)

Para la instalación solo tendremos que ejecutar el .ovf para el caso del Virtualbox y VMWare Workstation. En el caso del ESX y de Hyper-V debemos "Importar VM" y seleccionar la imagen.

Las credenciales para esta máquina son:

Usuario: root

Contraseña: pandora


Usuario Consola: admin

Contraseña: pandora


Usario mysql:root

Contraseña: pandora

Instalación en SUSE (OpenSUSE, SLES)

Instalación automática con repo externo

Para poder optar por este método -el más rápido y cómodo-, tiene que tener acceso a internet desde el servidor donde va a instalar pandora. Todos los pasos se deben ejecutar como root (o bajo sudo).

Paso 1. Crear el repo:

zypper ar -G http://artica.es/suse PandoraFMS_Official_Repo

Paso 2. Actualizar información del repo:

zypper refresh

Paso 3. Instalar Pandora FMS:

zypper install pandorafms_agent_unix pandorafms_console pandorafms_server mysql-community-server apache2-mod_php5 

Esto instalará Pandora FMS y todas sus dependencias.

Instalación manual por medio de RPM's

Configuración de repositorios de Software

Las instalación de software sobre SLES / OpenSUSE se hace mediante paquetes .RPM. Dichos paquetes RPM pueden contener software oficial, suministrado por el fabricante – Novell-, por medio del DVD de instalación o repositorios HTTP/FTP en Internet, o también pueden existir otros repositorios no-oficiales, mantenidos por la comunidad de usuarios y desarrolladores de SUSE (OpenSUSE). Dichos repositorios sólo pueden ser accesibles por Internet, pero los paquetes individuales, en formato .RPM pueden ser descargados, copiados a los servidores e instalados de forma manual por línea de comandos.

SLES utiliza una interfaz de administración general – YAST – para la gestión de paquetes y de repositorios de software. Esta interfaz, YAST, se utiliza para la administración de todo el sistema SLES: particionar discos, instalar software, configurar las tarjetas de red, etc. Se puede utilizar mediante interfaz gráfica (X) o mediante cualquier sesion de consola o remota mediante SSH.

Para esta documentación haremos uso del sistema Zypper de Suse que permite resolver dependencias, y descargarse los paquetes directamente de los repositorios en internet. Si no dispone de Zypper, instálelo, es mucho mas cómodo y rápido. Si no puede, tendrá que hacer toda la instalacion manual de paquetes mediante YAST y el CD de instalacion de SUSE.

Instalación previa de dependencias

Hay que instalar las siguientes dependencias de paquetes, incluidas en el sistema SUSE:

apache2 apache2-mod_php5 php5 php5-gd php5-gettext php5-json php5-mbstring php5-ldap php5-mysql \
php5-pear php5-snmp php5-zip nmap perl-DBD-mysql perl-DBI perl-Date-Calc perl-HTML-Parser \
perl-HTML-Encoding perl-HTML-Tree perl-IO-Socket-inet6 perl-Socket6 perl-Mail-Sendmail perl-NetAddr-IP \ 
perl-TimeDate perl-XML-Simple perl-XML-Twig perl-libwww-perl mysql-client mysql-max mysql  \
net-snmp xorg-x11-fonts-core php5-pear-db php5-curl php5-xmlrpc perl-SNMP graphviz graphviz-gd


Image:Info.png

OpenSUSE a diferencia de SLES no dispone del paquete mysql-max, se puede instalar el servidor Mysql standard en su lugar sin problema.

 


Para instalar todas las dependencias ejecute:

zypper install ..

Seguido de toda la lista de paquetes indicada en el párrafo de arriba. Esto le dará una pantalla como la siguiente:

Obteniendo los datos del repositorio...
Leyendo los paquetes instalados...
perl-DBI ya está instalado.
perl-HTML-Parser ya está instalado.
perl-TimeDate ya está instalado.
perl-XML-Simple ya está instalado.
perl-libwww-perl ya está instalado.
xorg-x11-fonts-core ya está instalado.
Resolviendo dependencias...

Los siguientes paquetes NUEVOS van a ser instalados:
  apache2 apache2-mod_php5 apache2-prefork apache2-utils libapr1 libapr-util1 libdnet1 
liblua5_1 libmm14 libmysqlclient15 mysql mysql-client mysql-Max net-snmp nmap 
perl-Bit-Vector perl-Carp-Clan perl-Data-ShowTable perl-Date-Calc perl-Date-Manip 
perl-DBD-mysql perl-HTML-Encoding perl-HTML-Tree perl-IO-Socket-inet6 perl-Socket6 
perl-Mail-Sendmail perl-NetAddr-IP perl-XML-Twig perl-SNMP php5 php5-ctype php5-dom php5-gd 
php5-gettext php5-hash php5-iconv php5-json php5-ldap php5-mbstring php5-mysql 
php5-openssl php5-pdo php5-pear php5-snmp php5-sqlite php5-tokenizer php5-xmlreader 
php5-xmlwriter php5-zip php5-zlib t1lib 

Tamaño de descarga total: 19,1 M. Después de la operación, se utilizarán 55,9 M adicionales.
¿Desea continuar? [SI/no]: 

Al pulsar SI, Zypper empieza a descargar los paquetes y a instalarlos.

Cuando haya terminado, tendrá que instalar algunos paquetes extra. En OpenSuse no existen todas las dependencias que necesita Pandora FMS, por eso se proveen algunos RPM's adicionales para satisfacer estas dependencias desde el sitio web en Sourceforge, estos ficheros .rpm adicionales son los siguientes:

perl-time-format php-pear-xml_rpc wmic smstools perl-HTML-Tree perl-XML-Twig

Image:Info.png

Los paquetes perl-HTML-Tree y perl-XML-Twig deben ser instalados manualmente como se indica anteriormente.

 


De manera opcional y sólo si va a usar Recon Server deberá instalar los siguientes paquetes:

perl-net-traceroute perl-net-traceroute-pureperl xprobe2

Todos estos ficheros RPM se pueden encontrar en el sitio oficial de distribución de software de Pandora FMS, en un apartado de dependencias especiales para OpenSuse.

NOTA: Asegúrese de descargar los RPM's adecuados para la distribución OpenSuse.

Para instalarlos colóquelos en un directorio, por ejemplo /tmp/adicional. En ese directorio ejecute el comando:

rpm -i *.rpm

Instalacion del agente

Deberia haber descargado de nuestro sitio web un paquete RPM similar (puede que cambie algun numero de version o algun otro detalle), pero deberia parecerse a este:

pandorafms_agent-3.0.0-1.noarch.rpm

Para instalarlo simplemente execute este comando:

rpm -i pandorafms_agent-3.0.0-1.noarch.rpm

Si aparecen las frases:

Insserv:warning:script 'smsd' missing LSB tags and overrides Insserv:default-start undefined, assuming default start runlevel (s) for script 'smsd'.

No debe preocuparse, es sólo un mensaje de advertencia, no es ningún error.

Instalacion del servidor

De igual forma que con agente, ejecute:

rpm -i pandorafms_server-3.0.0-1.noarch.rpm

Si ha instalado previamente el agente, tendrá el siguiente advertencia sin importancia:

useradd: Account `pandora' already exists.

Instalación de la consola

De igual manera, ejecute la herramienta de instalacion de paquetes rpm para instalar el paquete que contiene la consola de Pandora FMS:

rpm -i pandorafms_console-3.0.0-1.noarch.rpm

Si tiene algún problema de dependencias, causado por un fallo en la nomenclatura de un paquete, al instalar la consola como el siguiente:

error: Failed dependencies:
php5-pear-db is needed by pandorafms_console-3.1-1.noarch

Puede forzar las instalación con el flag --nodeps.

Desinstalacion de Pandora FMS

Puede desinstalar cualquiera de los componentes de Pandora FMS con los siguientes comandos:

rpm -e pandorafms_agent
rpm -e pandorafms_console
rpm -e pandorafms_server

La base de datos de Pandora FMS _no_ se desinstala al desinstalar ninguno de los paquetes de Pandora FMS. Sólo se eliminan todos los ficheros (incluidos ficheros de configuración) de cada paquete, pero la base de datos ha de borrarse a mano.

Instalación en Red Hat Enterprise Linux / CentOS / Fedora

La instalación es muy parecida a la de SUSE. Nótese que los paquetes RPM de RHEL/CentOS/Fedora no son los mismos que los de SUSE, dado que los RPM's de SUSE usan una version diferente de empaquetado, con un algoritmo de compresion diferente y los hace incompatibles.

Lo primero de todo, deberá activar ciertos repositorios oficiales de Redhat/Centos/Fedora para realizar la instalación de dependencias. Los repositorios a activar son EXTRAS, UPDATES y la instalación adicional del repositorio EPEL.

Edite /etc/yum.repos.d/CentOS-Base.repo y deje activos los repos EXTRAS, and UPDATES. Generalmente se verán como esto:

[updates]
name=CentOS-$releasever - Updates
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6

[extras]
name=CentOS-$releasever - Extras
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6

Añada el repositorio EPEL:

[EPEL]
Name = EPEL
baseurl = http://dl.fedoraproject.org/pub/epel/6/$basearch/
enabled = 1
gpgcheck = 0

Y actualice la información de sus repositorios:

yum makecache


Instalación mediante el repositorio oficial de Pandora FMS

Para poder realizar esta instalación, necesita YUM y acceso a internet. Primero cree el repositorio oficial de Pandora para CentOS 6. Este repositorio también puede ser usado en RHEL6.

vi /etc/yum.repos.d/pandorafms.repo

Añada este contenido

[artica_pandorafms]
name=CentOS6 - PandoraFMS official repo
baseurl=http://artica.es/centos6
gpgcheck=0
enabled=1

Refresque sus repositorios:

yum makecache

E instale Pandora FMS, junto con el servidor mysql (es una dependencia opcional, pero necesitará un servidor MySQL si no tiene uno ya instalado o accesible en otro servidor).

yum install pandorafms_console pandorafms_server mysql-server

Descargará todos los paquetes necesarios y dejará el sistema listo para su configuración y uso.

Instalación manual, mediante paquetes RPM

La mayoría de las dependencias deberían resolverse usando YUM u otra herramienta automática. Todas las dependencias están marcadas como paquetes necesarios en la definición RPM. Si ya ha configurado en el paso anterior los repositorios necesarios, esa operación será casi automática.

En el caso de CentOS será necesario instalar las siguientes dependencias:

yum install php php-gd graphviz php-mysql php-pear-DB php-zip php-mbstring php-ldap \
php-snmp php-ldap php-common make perl-CPAN perl-HTML-Tree perl-DBI perl-DBD-mysql \ 
perl-libwww-perl perl-XML-Simple perl-XML-Twig perl-XML-SAX perl-NetAddr-IP \ 
net-snmp perl-SNMP net-tools perl-IO-Socket-INET6 perl-Socket6 nmap sudo xprobe2

Puede que si usa Fedora o Redhat cambian un poco los nombres de algunos paquetes, así que usaremos estos añadidos a los anteriores:

yum install net-snmp-perl perl-JSON perl-NetAddr-IP perl-Socket6 \
perl-Time-HiRes perl-XML-Twig perl-IO-Socket-INET6

Algunas dependencias (como wmic o xprobe2) no están en los repositorios oficiales RHEL, sin embargo están disponibles en nuestra página de descarga de Sourceforge en la seccion de "Tools and Dependecies [1].

Mientras tanto, para Red Hat Enterprise Linux 6 bastará con instalar estas otras, pues varios de los paquetes necesarios para la consola y el servidor vienen incluídos en el php y el perl y dependencias de serie:

yum install php php-common graphviz

yum install perl-HTML-Tree perl-DBD-mysql perl-XML-Simple perl-XML-SAX \
perl-NetAddr-IP net-snmp perl-SNMP net-tools perl-IO-Socket-INET6 perl-Socket6 nmap wmic xprobe2

Image:template_warning.png

Si usa una versión inferior a RHEL6, puede ocurrir que algunas dependencias tengan otro nombre. Para el caso de perl-SNMP, en CentOS5, RHEL5, etc, la dependencia a obtener sería net-snmp-perl.

 


Para instalar el RPM basta usar el comando rpm -i o directamente el comando yum, por ejemplo:

rpm -i pandorafms_server-3.2-2.noarch.rpm

o

yum install pandorafms_server-3.2-2.noarch.rpm

Si existiera algún problema a la hora de acceder a la página de instalación de la consola, es conveniente comprobar si SELinux está activado y en tal caso desactivarlo siguiendo los procedimientos del FAQ.


Image:template_warning.png

RHEL/CentOS 5.x por defecto usa PHP 5.1 y este no es compatible con Pandora FMS, se deberá usar PHP 5.2 o superior.

 


Para ello se recomienda usar el siguiente repositorio para CentOS5/RHEL5, que contiene PHP 5.2:

[c5-testing]
name=CentOS-5 Testing 
baseurl=http://dev.centos.org/centos/5/testing/$basearch/
enabled=1
gpgcheck=1
gpgkey=http://dev.centos.org/centos/RPM-GPG-KEY-CentOS-testing

Instalación en Debian/Ubuntu

Se recomienda instalar Pandora FMS sobre una versión 10.04 o superior. En la versión Estable de Debian (Squeeze) existen problemas con algunas librerías y aplicaciones que necesita Pandora FMS para algunos componentes. La libreria LWP de Debian no implementa ciertos métodos para SSL, y esto es necesario para los módulos Enteprise de monitorización WEB, puede solucionarlo instalando una version más nueva de LWP mediante CPAN (método manual).

Image:Info.png

Si instala en una Debian Squeeze, necesitará añadir el repositorio "Non-Free" para tener acceso al paquete snmp-mibs-downloader. Edite el fichero /etc/apt/sources.list y modifique la linea para que sea como "deb http://ftp.us.debian.org/debian/ squeeze main non-free"

 


Image:Info.png

Debido a la forma en que gestiona Debian/Ubuntu los paquetes, es más que recomendable instalar Pandora FMS en un sistema que tenga acceso a los repositorios online de paquetes (o a una réplica en la red local). Una dependencia en Debian puede acarrear decenas de subdependencias, por lo que preparar una lista exacta de paquetes necesarios para la instalacion "offline" puede ser una tarea muy compleja."

 


Instalación usando los repositorios privados de Artica

Existe un método cómodo y rápido, que es agregando el repositorio privado de Artica que contiene los paquetes necesarios para su instalación de Pandora. Esto vale para Debian y Ubuntu:

Edite el fichero /etc/apt/sources.list y agregue la siguiente linea:

deb http://www.artica.es/debian/squeeze /

Ejecute apt-get update como root (o sudo)

apt-get update

Instale Pandora con apt-get:

root@debian:~# apt-get install pandorafms-console pandorafms-server pandorafms-agent-unix
Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following extra packages will be installed:
  apache2-mpm-prefork apache2-utils apache2.2-common dbconfig-common graphviz libapache2-mod-php5 libcgraph5 libcurl3 libgd2-xpm libgvpr1
  libio-socket-inet6-perl libnetaddr-ip-perl libonig2 libqdbm14 libsnmp-perl libsocket6-perl libssh2-1 libtime-format-perl
  libxml-namespacesupport-perl libxml-sax-expat-perl libxml-sax-perl libxml-simple-perl nmap php-db php-gettext php-pear php5 php5-cli php5-common
  php5-curl php5-gd php5-ldap php5-mysql php5-snmp php5-suhosin php5-xmlrpc smistrip snmp snmp-mibs-downloader snmpd xprobe
Suggested packages:
  apache2-doc apache2-suexec apache2-suexec-custom graphviz-doc libgd-tools php5-dev
The following packages will be REMOVED:
  libgd2-noxpm
The following NEW packages will be installed:
  apache2-mpm-prefork apache2-utils apache2.2-common dbconfig-common graphviz libapache2-mod-php5 libcgraph5 libcurl3 libgd2-xpm libgvpr1
  libio-socket-inet6-perl libnetaddr-ip-perl libonig2 libqdbm14 libsnmp-perl libsocket6-perl libssh2-1 libtime-format-perl
  libxml-namespacesupport-perl libxml-sax-expat-perl libxml-sax-perl libxml-simple-perl nmap pandorafms-agent-unix pandorafms-console
  pandorafms-server php-db php-gettext php-pear php5 php5-cli php5-common php5-curl php5-gd php5-ldap php5-mysql php5-snmp php5-suhosin php5-xmlrpc
  smistrip snmp snmp-mibs-downloader snmpd xprobe
0 upgraded, 44 newly installed, 1 to remove and 0 not upgraded.
Need to get 40.9 MB of archives.
After this operation, 90.8 MB of additional disk space will be used.
Do you want to continue [Y/n]? y
WARNING: The following packages cannot be authenticated!
  pandorafms-agent-unix pandorafms-console pandorafms-server
Install these packages without verification [y/N]? y

Instalación manual, mediante paquetes deb

En Debian/Ubuntu las dependencias son las siguientes:

Servidor:

snmp snmpd libtime-format-perl libxml-simple-perl libxml-twig-perl libdbi-perl libnetaddr-ip-perl
libhtml-parser-perl wmi-client xprobe2 nmap libmail-sendmail-perl traceroute 
libio-socket-inet6-perl libhtml-tree-perl libsnmp-perl snmp-mibs-downloader libio-socket-multicast-perl
libsnmp-perl libjson-perl


Image:Info.png

Si el paquete wmi-client no se encuentra en los repositorios, descargarlo desde la web de sourceforge de Pandora FMS

 


Image:Info.png

Si instala en una Debian Squeeze, necesitará añadir el repositorio "Non-Free" para tener acceso al paquete snmp-mibs-downloader.

 


Consola

php5 libapache2-mod-php5 apache2 mysql-server php5-gd php5-mysql php-pear php5-snmp php-db php-gettext 
graphviz mysql-client php5-curl php5-xmlrpc php5-ldap dbconfig-common

Para instalar el paquete del Servidor o de la consola, previamente hay que satisfacer las dependencias, eso se hace instalando todos los paquetes antes mencionados con el comando apt-get, teniendo privilegios de root, por ejemplo:

apt-get install  snmp snmpd libtime-format-perl libxml-simple-perl libxml-twig-perl libdbi-perl 
libnetaddr-ip-perl libhtml-parser-perl wmi-client xprobe2 nmap libmail-sendmail-perl traceroute 
libio-socket-inet6-perl libhtml-tree-perl libsnmp-perl snmp-mibs-downloader libio-socket-multicast-perl
libsnmp-perl libjson-perl php5 libapache2-mod-php5 apache2 mysql-server php5-gd php5-mysql php-pear 
php5-snmp php-db php-gettext graphviz mysql-client php5-curl php5-xmlrpc php5-ldap dbconfig-common

Image:Info.png

El carácter \ se usa como separador de línea. Puede hacer un copiar/pegar de esta documentacion directamente sobre la consola y los saltos de linea serán tenidos en cuenta como tales gracias al carácter \

 


Este comando instalaría todas las dependencias necesarias para instalar el servidor y la consola de Pandora FMS en un sistema Debian/Ubuntu.

La instalación con los paquetes deb es muy sencilla.

Si no tenemos conexion a internet, instalamos las dependencias. Después instalamos los paquetes de Pandora FMS, en este ejemplo se instalan todos los componentes de Pandora FMS juntos, pero pueden ser únicamente uno de ellos.

dpkg -i pandorafms.console_xxx.deb pandorafms.server_xxxx.deb pandorafms.agent_unix_xxx.deb

Si una vez que se ejecute el comando, se ve que faltan dependencias, se puede intentar resolverlas de forma automática con el comando:

apt-get -f install

Esto intentará descargar todos los paquetes necesarios que faltan para que Pandora FMS se instale automáticamente en el sistema. Una vez que se hayan instalado los paquetes necesarios, el sistema automáticamente procederá a la instalación de todos los componentes de Pandora FMS.

Para completar la instalación de la consola de Pandora FMS debe acceder a la url de la consola y seguir los pasos del ayudante de instalación. Si la consola está instalada en un servidor con IP 10.20.34.54 deberá acceder a la siguiente url:

http://10.20.34.54/pandora_console

Desinstalación de Pandora FMS

dpkg -r pandorafms-console-enterprise
dpkg -r pandorafms-console

Instalación en FreeBSD

Desde la version 3.2, Pandora FMS soporta FreeBSD.

Perl con instalación ithread

Para ejecutar el demonio del servidor de pandora, perl deberá estar compilado con el soporte para threads habilitado. Sin embargo, el paquete perl FreeBSD 5.x,perl-5.x.x.pkg, no tiene soporte para threads (hilos). Por tanto, no se puede utilizar.

Deberá compilar e instalar el ejecutable perl 5.x utilizando la coleccion de "Ports" (versiones alternativas) FreeBSD tal como aparece aquí:

cd /usr/ports/lang/perl5.x
make config
  -> Enable THREADS.
make
make install

Instalación de dependencias previas

En FreeBSD las dependencias son las siguientes:

Servidor :

databases/p5-DBI mail/p5-Mail-Sendmail net-mgmt/p5-NetAddr-IP textproc/p5-XML-Simple
devel/p5-Time-Format www/p5-HTML-Parser net/p5-Net-Traceroute-PurePerl
net/p5-IO-Socket-INET6 database/p5-DBD-mysql textproc/p5-XML-Twig converters/p5-JSON
net-mgmt/net-snmp security/nmap net/xprobe sysutils/coreutils net-mgmt/net-snmp
net-mgmt/wmi-client

Para poder instalar el servidor de pandora, tendrá que completar las dependencias antes. Esto debería hacerse utilizando el grupo de puertos. No utilize paquetes.

Puede instalar todas las dependencias que sean como estas:

e.g.) p5-DBI installation.

cd /usr/ports/databases/p5-DBI
make
make install

Consola:

www/apache22, lang/php5, net-mgmt/php5-snmp, www/php5-session, devel/php5-gettext,
converters/php5-mbstring, net/php5-ldap, databases/php5-mysql, graphics/php5-gd, archivers/php5-zip, 
archivers/php5-zlib, devel/php5-json, ftp/php5-curl, devel/pear, databases/pear-DB, net/pear-XML_RPC, 
graphics/graphviz (GTK, GDK_PIXBUF, PERL, PHP should be enabled.)

Para poder instalar la consola de pandora, tendrá que completar las dependencias primero. Puede utilizar grupos de puertos o paquetes.

Instalación de la Consola

No existe fichero de paquetes de la consola de pandora para FreeBSD. Deberá instalar la consola de pandora utilizando el instalador.

En la siguiente sección:"Instalación manual desde las fuentes en Linux/UNix" se describe cómo instalarla utilizando el instalador.

En FreeBSD con apache22, el directorio pandora_consola es:

/usr/local/www/apache22/data/pandora_console

Instalación del Servidor

No existe fichero de paquetes del servidor de pandora para FreeBSD.

Tendrá que instalar el servidor de pandora utilizando el instalador.

En la siguiente sección:"Instalación manual desde las fuentes en Linux/UNix" se describe cómo instalarlo utilizando el instalador.

La ubicación del fichero y el la estructura del script de arranque son diferentes respecto a Linux.

Veremos las peculiaridades de FreeBSD más abajo.

Despues de realizar la instalación, deberá añadir las siguientes líneas a /etc/rc.conf.

pandora_server_enable="YES"
tentacle_server_enable="YES"

Para habilitar los servidores de pandora, pandora y tentacle, se necesitan las siguientes ajustes. De otro modo, no se podran iniciar.

En FreeBSD, la mayoría de los ficheros del servidor de pandora están instalados en /usr/local.

Servidor de pandora, servidor de tentacle:

/usr/local/bin/pandora_server
/usr/local/bin/tentacle_server

Script de inicio:

/usr/local/etc/rc.d/pandora_server
/usr/local/etc/rc.d/tentacle_server

Fichero de configuración:

/usr/local/etc/pandora/pandora_server.conf

util:

/usr/local/share/pandora_server/util/*

Man pages:

/usr/local/man/man1/*

Otros:

The data_in and log directories are the same as Linux.

Instalación del agente

No existe el fichero agentes de pandora para FreeBSD. Deberá instalar el agente de pandora utilizando el instalador.

Para instalar utilizando el instalador, léa con atención la siguiente sección que aparece a continuación:"Instalación manual desde las fuentes en Linux/Unix".

La localización de los ficheros y la estructura del script de inicio son diferentes respecto a Linux.

Estudiaremos las peculiaridades de FreeBSD más adelante.

Después de la instalación, deberá añadir la siguiente línea a /etc/rc.conf.

pandora_agent_enable="YES"

Para habilitar el agente de pandora, se necesitan estos ajustes, de otro modo no se podrán iniciar el proceso.

En FreeBSD, la mayor parte de los ficheros del agente de pandora están instalados en /usr/local.

Agente:

/usr/local/bin/pandora_agent

Script de arranque:

/usr/local/etc/rc.d/pandora_agent

Fichero de configuración:

/usr/local/etc/pandora/pandora_agent.conf

Plugins:

/usr/local/share/pandora_agent/plugins/*

Man pages:

/usr/local/man/man1/*

Otros:

The data_in and log directories are the same as Linux.

Instalación en NetBSD

Pandora desde su versión 5.0 soporta NetBSD.

Instalación de las dependencias previas

En NetBSD las dependencias son las siguientes:

Servidor:

mysql55-server databases/p5-DBI mail/p5-Mail-Sendmail net/p5-NetAddr-IP textproc/p5-XML-Simple 
time/p5-Time-Format www/p5-HTML-Parser net/nmap net/p5-IO-Socket-INET6
database/p5-DBD-mysql textproc/p5-XML-Twig  sysutils/coreutils converters/p5-JSON net/net-snmp


Para instalar el servidor de pandora, primero tendrá que cumplir con las dependencias. Esto debería hacerse utilizando 'pkgsrc'.


Puede instalar todas las dependencias de este modo:


e.g.) p5-DBI installation.

cd /usr/pkgsrc/databases/p5-DBI
make
make install

Además, deberá instalar 'Net::Traceroute::PurePerl' y and 'LWP::Simple' usando CPAN.


perl -MCPAN -e 'install Net::Traceroute::PurePerl'
perl -MCPAN -e 'install LWP::Simple'

'xprobe' debería también ser instalado mediante la compilación del paquete fuente.

Puede descargarlo desde:

http://sourceforge.net/projects/xprobe/files/latest/download


Si no puede compilarlo debido a algún error, modifique los siguientes ficheros e inténtelo de nuevo.

  • Add ' include <cstdlib> ' to 'libs-external/USI++/src/ip.cc'.
  • Add ' include <cstdlib> ' to 'libs-external/USI++/src/misc.cc'.
  • Add ' include <cstring> ' to 'libs-external/USI++/usi++/tcp.h'.

consola:

www/apache22, lang/php54, net/php-snmp, www/ap-php, devel/php-gettext,
converters/php-mbstring, databases/php-ldap, databases/php-mysql, raphics/php-gd,
archivers/php-zip, archivers/php-zlib, textproc/php-json, www/php-curl, lang/pear, 
databases/pear-DB, graphics/graphviz, 

Para instalar la consola de pandora tendrá que cumplir con las dependencias antes. Puede usar 'pkgsrc'.

Además, deberá instalar el 'XML_RPC' usando pear.

pear install XML_RPC

Instalación de la consola

No existe un fichero de paquetes de consola para NetBSD.

Deberá instalar la consola de pandora usando un instalador.

En la sección que viene a continuación describimos cómo usar un instalador. La sección se llama " Manual de instalación desde fuentes en Linux/Unix".

En NetBSD con apache22, el directorio pandora_console es:

/usr/pkg/share/httpd/htdocs/pandora_console

Instalación del servidor

No existe un fichero pandora server para NetBSD

Debería instalar el servidor de pandora usando el instalador.

En la siguiente sección describiremos cómo instalar usando el instalador. La sección se llama " Instalación manual desde fuentes en Linux/Unix".

La localización de los ficheros y la estructura de los scripts de arranque son diferentes respecto a Linux.

Mostraremos aspectos específicos de NetBSD mas abajo.

Después de la instalación, deberá añadir las siguientes lineas a /etc/rc.conf.

pandora_server="YES"
tentacle_server="YES"

Se necesita esta configuración para activar los servidores de pandora, pandora y tentacle. De otro modo, no serán lanzados.

En NetBSD, la mayoría de ficheros del servidor de pandora están instalados en /usr/local.

pandora_server, tentacle_server:

/usr/local/bin/pandora_server
/usr/local/bin/tentacle_server

Script de arranque:

/etc/rc.d/pandora_server
/etc/rc.d/tentacle_server

Fichero de configuración:

/usr/local/etc/pandora/pandora_server.conf

util:

/usr/local/share/pandora_server/util/*

Paginas man:

/usr/share/man/man1/*

Otras: Los directorios data_in y log son los mismos que en Linux.


Instalación del Agente

No existe un fichero pandora agent para NetBSD

Deberá instalar el agente de pandora mediante el uso de un instalador.

En la próxima sección describimos cómo instalar utilizando un instalador. El nombre de esta sección es: " Instalación manual desde fuentes en Linux/Unix".

La localización de los ficheros y la estructura del script de arranque son diferentes respecto a Linux.

Mostraremos algunos aspectos específicos de NetBSD más abajo.

Después de la instalación, deberá añadir la siguiente linea a /etc/rc.conf.

pandora_agent="YES"

Para activar el agente de pandora deben hacerse dichos ajustes. De otro modo, no serán lanzados.

En NetBSD, la mayoría de ficheros del agente de pandora están instalados en /usr/local.

Agente:

/usr/local/bin/pandora_agent

Script de arranque:

/etc/rc.d/pandora_agent

Fichero de configuración :

/usr/local/etc/pandora/pandora_agent.conf

Plugins:

/usr/local/share/pandora_agent/plugins/*

Páginas man:

/usr/share/man/man1/*

Otros: Los directorios data_out y log son los mismos que en Linux.

Instalación manual desde las fuentes en Linux/Unix

Esta opción es especialmente importante si quiere utilizar el código de la versión de desarrollo o directamente de los repositorios de código.

Instalacion previa de software necesario

Dado que va a construir Pandora FMS desde los fuentes necesitará el software básico para compilar e instalar software desde el código. En función de si usa una distro u otra tendra que instalar paquetes tales como make, gcc y otros. También, se recomienda revisar el apartado de dependencias correspondiente a su distribución.

En debian/ubuntu existe un metapaquete que contiene todos:

apt-get install build-essential subversion

En SUSE/Redhat/Fedora debera instalar varios paquetes:

zypper install make automake subversion

Descarga de las fuentes

La opción mas sencilla es descargarse los fuentes en formato "tarball" (.tar.gz, .tgz o .tar.bz2) y descomprimirlo. Para ello visite la página oficial de Pandora FMS, seccion descargas http://pandorafms.org.

Otra interesante opción, si quiere estar "a la última" y utilizar el último código, estable o en desarrollo es utilizar el cliente del sistema de versión de código Subversion (svn), para ello puede visitar la seccion de desarrollo de la página oficial del proyecto Pandora FMS http://pandorafms.org/index.php?sec=community&sec2=development&lang=es.

Para descargarse el código de la versión de desarrollo, usando la línea de comandos del cliente de SVN:

svn co https://svn.code.sf.net/p/pandora/code

Instalación del agente

El agente no requiere compilacion ni preparacion. Una vez que tenemos el agente: pandorafms_3.0_linux.tar.gz

1. Nos hacemos root

su -

2. Lo copiamos a /tmp y dentro de /tmp ejecutamos:

tar xvzf pandorafms_3.0_unix.tar.gz 
cd unix
./pandora_agent_installer --install

3. Arrancamos manualmente el agente

/etc/init.d/pandora_agent_daemon start

Instalación personalizada

A partir de la versión 3.1, el agente puede ser instalado en un directorio definido por el usuario de forma integral, esto significa que se meterán en ese directorio todos los ficheros del agente: logs, ficheros de configuracion, binarios, paginas del man, etc.

Para usar ese método, simplemente ejecutar como el siguiente ejemplo:

./pandora_agent_installer --install /opt/pandora

EL unico fichero que Pandora creará fuera de ese directorio definido por el usuario, es el lanzador del agente en /etc/init.d/pandora_agent_daemon (o equivalente en otros sistemas Unix), y el enlace en el directorio del nivel de arranque del sistema, por ejemplo /etc/rc.d/rc2.d/S90pandora_agent_daemon.

Además, se puede configurar la instalación para que en vez de ejecutarse el agente con usuario root, se pueda ejecutar con otro usuario. Por ejemplo para que el agente se ejecute con el usuario Pandora, sería:

./pandora_agent_installer --install /home/pandora pandora

Cuando se especifica un usuario personalizado hay que instalar el agente en una localización personalizada en la que el usuario tenga permisos de escritura (/home/pandora en el ejemplo anterior).

Instalación de la consola

Una vez que tenemos el fichero comprimido con la consola, que se llamará pandorafms_console-3.0.0.tar.gz o similar:

1. Nos hacemos root

su -

2. Lo copiamos a /tmp y dentro de /tmp ejecutamos:

tar xvzf pandorafms_console-3.0.0.tar.gz 
cd pandora_console
./pandora_console_install --install

Instalación del servidor

Una vez que tenemos el fichero comprimido con el servidor, que se llamará pandorafms_server-3.0.0.tar.gz o similar:

1. Nos hacemos root

su - 

2. Lo copiamos a /tmp y dentro de /tmp ejecutamos:

tar xvzf pandorafms_server-3.0.0.tar.gz 
cd pandora_server
./pandora_server_installer --install

Si existen problemas de dependencias, tendremos que resolverlas antes de intentar la instalación. Podemos forzar la instalacion ignorando el problema de dependencias, pero Pandora FMS no funcionará o no funcionará correctamente.

Desinstalación / Limpia manual del servidor

En un momento dado, si hemos instalado / actualizado varias versiones diferentes, utilizando métodos de instalación diferentes (RPM, Tarball) puede ocurrir que tengamos varias versiones mezcladas y que se estén usando versiones incorrectas de librerias o del propio servidor, el procedimiento siguiente sirve para detectar que versiones hay y borrarlas manualmente:

Los binarios deberán estar siempre en /usr/local/bin, con un enlace a /usr/bin, para comprobarlo simplemente:

ls -la /usr/local/bin/pandora_server
ls -la /usr/local/bin/tentacle_server
ls -la /usr/bin/tentacle_server
ls -la /usr/bin/tentacle_server

Las librerias de Pandora dependen de la version de su distribución, para saber donde están y si hay varias valdría con el comando:

find / -name "WMIServer.pm"

Esto nos mostrará la ruta completa donde está instalada esta librería de Pandora FMS, por ejemplo:

/usr/local/share/perl/5.10.0/PandoraFMS/WMIServer.pm

Puede ocurrir que salga en varios paths:

/usr/local/share/perl/5.10.0/PandoraFMS/WMIServer.pm
/usr/local/share/perl/PandoraFMS/WMIServer.pm

En este caso no podemos saber cual se está usando asi que lo mejor es borrar los directorios completos y reinstalar Pandora FMS:

 rm -Rf /usr/local/share/perl/5.10.0/PandoraFMS
 rm -Rf /usr/local/share/perl/PandoraFMS/

Siempre es buena idea hacer un backup del /etc/pandora/pandora_server.conf por si acaso.

Instalación manual (desde código fuente) del servidor

Alternativamente al script de instalación genérico, se puede "compilar" el código de Pandora FMS, mediante el intérprete Perl de su sistema. Este proceso simplemente instala las librerias y los ejecutables minimos, pero no toca el sistema de scripts de arranque, scripts de mantenimiento, configuración ni ninguna otra cosa que estrictamente la aplicación y sus librerías. Este proceso es el indicado cuando tiene que actualizar el código del servidor, pero sin sobreescribir su configuración.

Para ello, descomprima el código de su servidor en /tmp, tal y como se indica en el paso anterior

1. Nos hacemos root

su -

2. Lo copiamos a /tmp y dentro de /tmp ejecutamos:

tar xvzf pandorafms_server-3.0.0.tar.gz 
cd pandora_server
perl Makefile.PL
make
make install

Observe la salida de error de la pantalla. Si falta alguna dependencia o existe algún otro problema, el sistema le advertirá de ello. Si observa un mensaje similar a:

Warning: prerequisiete Mail::Sendmail 0 not found
Warning: prerequisiete Net::Traceroute::PurePerl 0 not found

Significa que existen algunos paquetes de Perl que Pandora FMS necesita y que el sistema no tiene instalado. Revise los párrafos anteriores para saber como instalar las dependencias necesarias previas para instalar Pandora FMS. No obstante puede "ignorar" esos errores (por eso son warnings y no errores) y forzar la instalación. Con seguridad tendrá problemas en un momento u otro ya que le falta un componente necesario para funcionar. No obstante si se conoce el componente que no esta instalado y no se va a utilizar (p.e: traceroute se utiliza exclusivamente para Pandora FMS Recon Server), se puede continuar con seguridad.

Después de ese proceso, automáticamente se copian los ficheros

/usr/local/bin/pandora_server
/usr/local/bin/pandora_exec

Y varios ficheros .pm (librerias de Perl) que necesita Pandora FMS. Esas librerias .pm se copian a diferentes directorios, dependiendo de la versión de su distribución y de su distribución. Por ejemplo en Ubuntu 9.04 se copian a :

/usr/local/share/perl/5.10.0/PandoraFMS/

En SUSE/SLES 11 se copian a:

/usr/lib/perl5/site_perl/5.10.0/PandoraFMS/

Instalación de la Versión Enterprise

Para la instalación de la versión Enterprise de Pandora FMS, además de instalar los paquetes "Open" de la Consola y el Servidor, debemos instalar otros dos paquetes adicionales de la Consola y el servidor. El paquete de la consola, dependerá de la distribución que tengamos instalada usaremos unos paquetes u otros:

Para Red Hat Enterprise Linux / CentOS / Fedora:

rpm -i pandorafms_console_enterprise-X.X.noarch.rpm

Para SuSe:

rpm -i pandorafms_console_enterprise-X.X.noarch.rpm

En Debian/Ubuntu:

dpkg -i pandorafms_console_enterprise_xxx.deb

Si desea instalar la consola enterprise a través del código fuente:

Una vez que tenemos el fichero comprimido con la consola, que se llamará pandorafms_console_enterprise-X.X.tar.gz o similar:

1. Nos hacemos root

su -

2. Lo copiamos a /tmp y dentro de /tmp ejecutamos:

tar xvzf pandorafms_console-X.Xtar.gz 

Y lo copiamos al directorio donde esté instalada nuestra consola de Pandora FMS Opensource, que puede ser /var/www/pandora_console para Debian o Ubuntu, o bien /srv/www/htdocs/pandora_console/ para SUSE, RH, Fedora, etc (o en otro directorio dependiendo de la distribución).

Debian:

cp -R enterprise /var/www/pandora_console

SUSE:

cp -R enterprise /srv/www/htdocs/pandora_console

3. Cambiamos los permisos para que los ficheros sean propiedad del usuario del servidor web, por ejemplo:

Debian:

chown -R www-data /var/www/pandora_console/enterprise

SUSE:

chown -R wwwrun /srv/www/htdocs/pandora_console/enterprise

En este punto se debe realizar la Activación de la licencia.

Para realizar la instalación del servidor Enterprise, primero hay que asegurarse de que la versión Open del servidor está instalada y después proceder a instalar la versión Enterprise.

Una vez que tenemos el fichero comprimido con el servidor, que se llamará pandorafms_server_enterprise-X.X.tar.gz o similar:

1. Nos hacemos root

su - 

2. Lo copiamos a /tmp y dentro de /tmp ejecutamos:

tar xvzf pandorafms_server_enterprise-X.X.tar.gz 
cd pandora_server/
# ./pandora_server_installer --install

En el caso de que el binario del servidor de Pandora no se encuentre en el directorio por defecto (/usr/bin) habrá que indicar el directorio de la siguiente forma:

# PREFIX=/usr/local ./pandora_server_installer --install

Tras realizar la instalación reiniciaremos el servidor ( /etc/init.d/pandora_server restart ) y nos aparecerán habilitados los servidores Enterprise.





Instalación Consola y Servidor en Windows

A partir de la versión 5.1 de Pandora FMS, existe un instalador para windows que nos permite instalar de forma conjunta Apache, PHP, Mysql, Pandora FMS y algunas dependencias más que son necesarias para el correcto funcionamiento de la consola y el servidor en Windows.

Image:template_warning.png

El soporte para Windows en la consola y el servidor no está recomendado para entornos en producción ya que su rendimiento es inferior a la versión Linux. Estamos trabajando para que en futuras versiones sea más estable y rápido.

 




Se entrega como un autoinstalador en formato ejecutable (.exe) y para su instalación básica solo hay que aceptar todas las opciones que se van indicando.

Seleccione el idioma:



image:Pandora_agent_3.0_RC3_install_windows_01.png



Siga los pasos del instalador:



image:Pandora_server_install_windows_01.png



Acepte los términos de la licencia:



image:Pandora_server_install_windows_02.png



Elija los componentes a instalar:



image:Pandora_server_install_windows_03.png



Este instalador esta principalmente preparado para realizar la instalación sobre un equipo que no tenga ya instalado apache, ni mysql. En el caso de que tenga algún otro servidor web, como pueda ser IIS activado, deberá desactivarlo para que funcione a través de Apache.

Si tiene mysql server ya instalado y funcionando en el equipo antes de instalar el resto de componentes de Pandora, deberá modificar la contraseña de root de mysql, por "pandora". Este cambio es necesario para que se cree la base de datos y se puedan asignar correctamente los permisos a la base de datos de Pandora. Una vez instalado Pandora en el equipo, podrá volver a reemplazar la contraseña.

Tras seleccionar los componentes a instalar deberá indicar la ruta de instalación:



image:Pandora_server_install_windows_04.png



Tras esto empezarán a instalarle los componentes. El único que necesita validación por parte del usuario es Apache. Valdrá con aceptar todas las condiciones que nos pregunten:



image:Pandora_server_install_windows_05.png



A parte de Mysql y Apache, como se indicó anteriormente se instalarán otros componentes, que en el caso de que ya esten instalados con anterioridad le podrá aparecer un mensaje como este:



image:Pandora_server_install_windows_06.png



Espere a que se copien los ficheros y se termine de realizar toda la configuración:



image:Pandora_server_install_windows_07.png



Hasta que se completa la instalación:




image:Pandora_server_install_windows_08.png



Una vez completada se abrirá automáticamente el navegador en la pantalla de login. En el caso de que se haya instalado la versión Enterprise, se le preguntará por el código de licencia que le habrá enviado Artica, para su implementación. El servidor se instala como servicio y se inicia automáticamente en la instalación, salvo en la versión Enterprise, que tras no haberse completado la instalación con un Código de Licencia válido, el servidor no podrá arrancar.

Para poder iniciar de forma rápida el proceso, podrá iniciarlo desde Inicio > Programas:




image:Pandora_server_install_windows_09.png



Una vez que el servicio esta corriendo, ya tiene que aparecer la consola con todos los servidores listos:






Directorios a tener en cuenta en Windows

Hay una serie de directorios que hay que configurar correctamente en el Setup de Pandora FMS. Son los siguientes:

- Directorio remoto de configuración

- Almacenamiento de adjuntos





- Directorio de logs del servidor





- Directorio binarios de Graphviz





Instalación del Agente de Windows

El agente se entrega como un autoinstalador en formato ejecutable (.exe). La instalación básica realiza todos los pasos necesarios y tan sólo es necesario aceptar todas las opciones.

Para instalar el agente de Pandora FMS en Windows sólo hace falta descargarlo y ejecutarlo. El instalador le guiará a través de los pasos necesarios en el idioma que seleccione. En el siguiente ejemplo se muestra la instalación para Windows XP, recuerde que Pandora FMS funciona en cualquier plataforma moderna de Microsoft (2000 o superior). Tambien dispone de versiones de 32 y de 64 bit.



Seleccione el idioma:



image:Pandora_agent_3.0_RC3_install_windows_01.png



Siga los pasos del instalador:



image:Pandora_agent_3.0_RC3_install_windows_02.png



Acepte los términos de la licencia y pulse Next:



image:Pandora_agent_3.0_RC3_install_windows_03.png



Seleccione la ruta donde se instalará el agente de Pandora FMS (por defecto se instala en c:/archivos de programa/pandora_agent), puede cambiarla pulsando Browse..., después pulse Next:



image:Pandora_agent_3.0_RC3_install_windows_04.png



Espere a que se copien los ficheros.



image:Pandora_agent_3.0_RC3_install_windows_06.png



Configure los datos para el agente como la dirección IP (o nombre) del servidor de Pandora FMS que recibirá los datos del agente. Para poder cambiar otros parámetros, tales como cambiar el nombre del agente (por defecto toma el valor del hostname de la máquina) o la ruta de los ficheros temporales tendra que editar a mano la configuracion del agente.



image:Pandora_agent_3.0_RC3_install_windows_07.png



Decida si quiere iniciar en el momento el servicio del agente de Pandora FMS, de lo contrario tendrá que hacerlo de forma manual, o bien se iniciará cuando Windows se reinicie de nuevo.



image:Pandora_agent_3.0_RC3_install_windows_08.png



La instalación ha finalizado, puede cambiar los parámetros del agente en el fichero pandora_agent.conf o bien a través del enlace directo en el menu PandoraFMS.

Instalación desatendida del agente Windows

Desde la versión 3 RC3, Pandora FMS incluye la opción de instalar el agente de windows de forma desatendida, para ello se ejecuta el instalador del agente pasándole el parámetro /mode Silent que indica que la instalación se debe hacer en modo desatendido, además opcionalmente se le puede pasar el parámetro /prefix <Ruta> para indicarle la ruta completa de instalación.

Ejecutar el siguiente comando (donde XXXXX) puede variar en función de la versión del instalador, y <Ruta> es la ruta completa donde se quiere instalar (entrecomillada si lleva espacios).

PandoraFMS_windows_agent_v3.0.XXXXX.setup.exe /mode Silent /prefix <Ruta>

Por ejemplo,para instalar la versión actual, para instalar en c:\agente_pandora\, habría que ejecutar:

PandoraFMS_windows_agent_v3.0.RC3.setup.exe /mode Silent /prefix c:\agente_pandora

Esto instalará Pandora FMS con los valores por defecto en la ruta indicada y arrancará el servicio de Pandora FMS en la máquina. Es necesario ejecutar ese proceso de instalación con privilegios para poder instalar software / servicios en la máquina.

A partir de la VERSIÓN 5.1 del agente, el instalador ha cambiado y para hacer la instalación de forma desatendida hay que realizar la siguiente ejecución:

PandoraFMS_agent_v5.1.exe /S

En el caso de que queramos instalar el agente en otra ruta diferente a la de por defecto:

PandoraFMS_agent_v5.1.exe /S /D=C:\Agente_Pandora

Desinstalación desatendida

El desinstalador que es un ejecutable llamado uninstall.exe que queda en el directorio de instalación de Pandora FMS también permite la desinstalación desatendida, para ello hay que ejecutar el desinstalador con la opción /mode Silent.

Por ejemplo, suponiendo que Pandora FMS esté instalado en el path por defecto:

c:\archivos de programa\pandora_agent

Habría que ejecutar:

“c:\archivos de programa\pandora_agent\uninstall.exe” /mode silent


Instalacion manual del agente de Windows

El agente de windows se puede instalar de forma manual. Aprender como funciona la instalación manual sirve también para comprender como funciona por dentro el Agente y para poder reajustar posteriormente a la instalación ciertos parámetros.

Suponemos que tiene todos los ficheros necesarios del agente, y su estructura de directorios, que resumiendo lo más importante es la siguiente:

  • PandoraAgent.exe: El ejecutable del servicio de Pandora FMS. Veremos más adelante que admite ciertos parámetros que pueden resultarnos de utilidad.
  • pandora_agent.conf: El fichero principal de configuración.
  • libcurl.dll: Librería utilizada por PandoraFMS para subir los ficheros por FTP.
  • libeay32.dll: Librería utilizada por PandoraFMS para cifrar conexiones (SSH y Tentacle).
  • zlub1.dll: Librería utilizada por PandoraFMS para compresión de datos.
  • libodbc++.dll: Librería utilizada por PandoraFMS para consultas ODBC.
  • pandora_agent.log: Log principal del agente.
  • pandora_debug.log: Log principal del agente (Modo debug).
  • /util: Dentro del directorio util se encuentran muchas herramientas "tipicas" Unix, portadas a Win32, tales como grep, gawk, wc, head, tail, etc. Además ahi se encuentra el cliente de tentacle, "tentacle_client.exe" que es el utilizado para enviar los paquetes al servidor de Pandora FMS.

Todo esto se puede bajar de nuestro repositorio de código, tal y como se describe en nuestra página web.

Es más facil si ya tienes instalado un agente windows en una maquina y directamente comprimes el directorio c:\program files\pandora_agent entero y lo copias a otra máquina.


Utilizando PandoraAgent.exe desde la línea de comandos

Si ejecutamos pandoraagent.exe --help, nos mostrará algo similar a esto:

Pandora agent for Windows. Version 3.0(Build 091125)
Usage: PandoraAgent.exe [OPTION]

Available options are:
        --install:  Install the Pandora Agent service.
        --uninstall: Uninstall the Pandora Agent service.
        --test-ssh: Test the SSH Pandora Agent configuration.
        --test-ftp: Test the FTP Pandora Agent configuration.
        --process: Run the Pandora Agent as a user process instead of a service.


Para instalar el servicio (si este no está instalado), basta con ejecutar lo siguiente dentro del directorio donde está el ejecutable (generalmente c:\program files o equivalente).

pandoraagent.exe --install

Esto instará el servicio en la máquina, basandose en el path donde se ubica el .exe

Si queremos desinstalarlo, es el mismo proceso pero:

pandoraagent.exe --uninstall

Si quiere probar una conexion ftp o ssh desde la linea de comando puede utilizar las opciones indicadas arriba.


Agente windows de PandoraFMS como proceso

Es posible, por motivos de depuración, pruebas y otras circunstancias poco habituales, ejecutar el agente en modo "Proceso". Esto se hace ejecutandolo desde linea de comando:

pandoraagent.exe --process

Existen algunas limitaciones en la ejecución al modo proceso, ya que PandoraFMS está pensado para ejecutarse como servicio y bajo el usuario SYSTEM. Si lo ejecuta con otro usuario sin privilegios, habrá funcionalidades que no funcionen correctamente.

Pandora FMS para Windows NT4

Este agente es un puerto del agente Unix (en Perl) compilado con el compilador de Perl ActiveState DevKit. Este es un EXE autónomo con todos los elementos que necesitará para correr. Tiene los mismas características que el agente Unix, pero corriendo en u NT4 box. Esto significa que puede ejecutar comandos y conseguir el rendimiento para generar datos para Pandora FMS.

Puede utilizarse con cualquier Windows (NT4, Win95, Windows 2000-2008, y por supuesto con Windows 7), puede ser útil en sistemas con Windows implantado sin el núcleo WMI, lo que hace que el agente Window estandar de Pandora FMS no funcione adecuadamente.

Instalación del agente

Copie todos los contenidos en un directorio de su elección, por ejemplo en c:\pandora.


Edite pandora_agent.conf y configure sus parámetros, incluyendo el fichero log y el directorio temporal, que debería ser algo como:

c:\pandora\temp and c:\pandora\log.

ASEGURESE de que existen los directorios antes de intentar iniciar el agente de Pandora.


Iniciar el funcionamiento del agente

Este agente no corre como servicio, con lo que necesita instalarlo en el menu startup o iniciarlo manualmente. El shortlink que cree deberá tener un parámetro que será donde esté el directorio principal del agente de Pandora FMS. En este entorno es c:\pandora con lo que el comando que se inicie será:

c:\pandora\pandora_agent.exe c:\pandora

Instalación como servicio

Se proporciona la herramienta srvany.exe para hacer esto. Es un kit de herramientas de recursos para que se cualquier .exe se pueda utilizar como servicio. Sólo tiene que leer la documentación acerca de cómo utilizar srvany( proporcionado con este paquete).

Agente embebido

Pandora FMS tiene un agente muy especial, que llamamos "agente embebido". Es un agente desarrollado en C puro, pensado para ser completamente multiplataforma, lo único que se necesita para compilarlo, linkarlo y usarlo es cualquier sistema que tenga un compilador de C GNU. Lo hemos probado en varias arquitecturas de tipo ARM. Aparte de eso, no necesita nada más para funcionar.

Para poder usarlo, también es necesario compilar y linkar el cliente de tentacle, para poder enviar informacion al servidor de Pandora. Para compilar y linkar ambos, necesita las extensiones GNU y autotools (autoconf, automake, pkg-config, etc).

Necesitará el código fuente del agente embebido, de nuestro repositorio de código SVN, o bien descargarlo de la seccion de descargas de SourceForge así como el código del cliente de tentacle, que se encuentra en el mismo sitio.

Instalación básica

La forma más sencilla de compilar este paquete es:

1. `cd' al directorio que contiene el código fuente. Escriba `./configure' para configurar el paquete para su sistema. Si está usando csh o un sistema antiguo de System V, puede que necesite escribir `sh ./configure'.

La ejecución de `configure' tarda un tiempo, mientras se ejecuta, es normal que imprima por pantalla una gran cantidad de información sobre lo que está realizando.

2. Teclee `make' para compilar el paquete.

3. Opcionalmente, escriba `make check' para verificar el paquete.

4. Escriba `make install' para instalar el programa y el fichero de configuración de ejemplo.

5. Puede borrar los binarios generados, asi como los ficheros objeto del directorio de fuentes, escribiendo 'make clean'. Para borrar tambien los ficheros que se han generado en el proceso de compilación, ejecute `make distclean'.

Nombres en la instalación

Por defecto, make install instará los ficheros en `/usr/local/bin', y `/usr/local/etc'. Puede especificar un prefijo diferente de `/usr/local' especificando al llamar a `configure' la option `--prefix=PATH'. Make install instalará los ficheros siguientes:

 /usr/local/etc/pandora/pandora_agent.conf
 /usr/local/bin/pandora/pandora_agent

Se puede especificar diferentes prefijos de instalación en función de la arquitectura. Si le pasa a configure la opción '--exec-prefix=PATH', el paquete usará ese PATH como prefijo para la instalación de programas y librerías. La documentacion y otros ficheros ordinarios continuarán usando el prefijo habitual.

Además, si usa una estructura de directorios poco habitual, puede pasarle la opcion '--bindir=PATH' para valores alternativos en funcion del tipo de archivo. Ejecute configure --help para una lista de los directorios que puede configurar y que tipos de ficheros van dentro.

Funcionalidades del agente embebido

En este momento, el agente soporta únicamente las funcionalidades básicas, es decir, la obtención de informacion via la invocacion de comandos del sistema con module_exec y module_plugin. Cualquier información que se quiera obtener del sistema monitoreado, debe ser mediante estas directivas.

Configuracion inicial después de la instalacion

El orden que debe seguir despues de la instalación, es

  1. Crear la base de datos, mediante el wizard de instalacion de la consola web de Pandora FMS.
  2. Modificar las configuracion del servidor, incluyendo las credenciales de acceso a la BBDD generadas por el paso anterior.
  3. Arrancar servidor.
  4. Arrancar agente local (si se necesita).
  5. Acceder a la consola de Pandora FMS por primera vez para comenzar a usar Pandora FMS.

Configuracion inicial de la Consola

Estamos suponiendo que va a ejecutar todos los componentes (Base de datos, Consola, Servidor y Agente) sobre la misma máquina. Si todavía no lo ha hecho, arranque el servidor mysql y establezca una contraseña de administrador (root).

/etc/init.d/mysql start

Y ahora establezca la password, por ejemplo "pandora123" para el usuario root de su MYSQL:

mysqladmin password pandora123

Ahora levante el servidor Apache en su servidor:

/etc/init.d/apache2 start

Ahora ya puede entrar via web a la direccion IP de su servidor para realizar la post-instalacion de Pandora FMS via web. Esta post-instalacion sirve para crear la base de datos de Pandora FMS y configurar en el servidor de Pandora las credenciales de acceso (usuario, password y nombre de BD) a la BBDD establecidas por el usuario.

Si la IP de su servidor es, por ejemplo, 192.168.5.54, ponga en su navegador

http://192.168.5.54/pandora_console/install.php

A partir de ahora solo tiene que seguir los pasos que se le indican para crear la BBDD de Pandora FMS.



Image:Pandora_install_1.png



Pulse siguiente.



Image:Pandora_install_2.png



Esta pantalla se utiliza para verificar que tiene todas las dependencias de software instaladas correctamente.

Nota: en el caso de que necesite instalar alguna dependencia, será necesario reiniciar el servidor web para que éste las reconozca.



Image:Pandora_install_3.png



Aquí configura los datos de acceso a su servidor MySQL. Debe introducir la password de root que definió en el paso anterior (pandora123 en nuestro ejemplo).



Image:Pandora_install_4.png



Aquí se muestra la contraseña de acceso a la base de datos.



Image:Paso5.png



Finalización de la instalación.



Image:Paso6.png



Llegado a este punto, tendra que borrar el fichero "install.php" a mano, para ello vaya a:

  • (DEBIAN/UBUNTU) /var/www/pandora_console y borre el fichero "install.php"
  • (FEDORA/CENTOS/REDHAT) /var/www/htdocs/pandora_console y borre el fichero "install.php"
  • (SUSE) /srv/www/htdocs/pandora_console y borre el fichero "install.php".

Para borrar un fichero en linux, use el comando rm seguido del fichero a borrar, por ejemplo:

rm install.php


Aplicación de la licencia

La versión Enterprise de Pandora FMS viene asociada a una clave individual para cada instalación. Para poder usar las funcionalidades Enterprise y realizar actualizaciones automáticas de la consola es necesario introducir el número de licencia proporcionado por Artica.

Tras instalar la versión Enterprise de la Consola de Pandora FMS, sea cual sea el método de instalación, deberá acceder a la consola de Pandora ( http://IP/pandora_console/ ) y le aparecerá la siguiente pantalla de bienvenida para aceptar la licencia.


Image:license_accept.png


Tras aceptar la misma, el esquema de la base de datos de Pandora FMS cambiará, añadiéndose las nuevas tablas necesarias para la utilización de la versión Enterprise, y le aparecerá una nueva pantalla donde podrá introducir el código de licencia que desde Artica le habrán enviado.


Image:license_setup.png


Para versiones inferiores a la versión 5, hay que introducir directamente el License Key, pero para la versión 5 o superior se realizará un procedimiento específico que se le indicará en un documento de bienvenida junto a la Licencia.

Image:Info.png

Es muy importante que no se arranque el demonio pandora_server con la versión Enterprise del mismo instalada, sin haber habilitado antes la versión Enterprise de la consola, ya que se producirán errores.

 


Configuracion inicial básica del Servidor

Pandora FMS ha configurado su Base de datos y generado un usuario de mysql para acceder a la misma. Ha generado un password aleatorio para el usuario "pandora" y que debe ser el que utilice para modificar el password que se define en el servidor de Pandora FMS.

Para este ultimo paso, tiene que editar el fichero /etc/pandora/pandora_server.conf de su instalacion de Pandora y buscar la linea:

dbpass pandora

Y sustituir "pandora" por el password que ha generado el instalador. Una vez que lo ha hecho y grabado el fichero, ya puede arrancar el servidor de Pandora FMS de la siguiente manera:

/etc/init.d/pandora_server start

Deberia dar una salida similar a esta:

Pandora FMS Server 3.0-dev Build PS090915 Copyright (c) 2004-2009 ArticaST
This program is OpenSource, licensed under the terms of GPL License version 2.
You can download latest versions and documentation at http://www.pandorafms.org 

 [*] Backgrounding Pandora FMS Server process.
 
Pandora Server is now running with PID 2085

Image:Info.png

El tentacle_server esta seteado para iniciarse en con el sistema, pero si usas el pandora server sin reiniciar la maquina, es recomendable levantar el servicio a mano

 


Configuracion inicial básica del Agente

Ya puede arrancar el agente local de su máquina (viene preconfigurado para enviar datos a la misma máquina donde se ejecuta, mediante tentacle), para empezar a recoger datos automáticamente:

/etc/init.d/pandora_agent_daemon start

Ahora ya puede acceder a su consola WEB de Pandora FMS a traves de la URL:

http://x.x.x.x/pandora_console

Donde x.x.x.x es la IP de la máquina donde ha instalado la consola de Pandora FMS.

Volver a Indice de Documentacion Pandora FMS