From 9ddb5101be02a48f4c89e199db3cc17a1e39372e Mon Sep 17 00:00:00 2001 From: slerena Date: Thu, 23 Aug 2007 16:05:21 +0000 Subject: [PATCH] 2007-08-23 Sancho Lerena * linux/pandora_agent_intaller: Fixed problem with /var/log/pandora * linux/README: Added, replacing old INSTALL file. * linux/pandora_agent: Fixed problem with old path /var/log/pandora_agent.log git-svn-id: https://svn.code.sf.net/p/pandora/code/trunk@612 c3f86ba8-e40f-0410-aaad-9ba5e7f4b01f --- pandora_agents/ChangeLog | 8 + pandora_agents/linux/INSTALL | 42 ---- pandora_agents/linux/README | 209 +++++++++++++++++++ pandora_agents/linux/pandora_agent | 2 +- pandora_agents/linux/pandora_agent_installer | 3 +- 5 files changed, 220 insertions(+), 44 deletions(-) delete mode 100644 pandora_agents/linux/INSTALL create mode 100644 pandora_agents/linux/README diff --git a/pandora_agents/ChangeLog b/pandora_agents/ChangeLog index db85a16ccb..ab87b05fb4 100644 --- a/pandora_agents/ChangeLog +++ b/pandora_agents/ChangeLog @@ -1,3 +1,11 @@ +2007-08-23 Sancho Lerena + + * linux/pandora_agent_intaller: Fixed problem with /var/log/pandora + + * linux/README: Added, replacing old INSTALL file. + + * linux/pandora_agent: Fixed problem with old path /var/log/pandora_agent.log + 2007-08-20 Sancho Lerena New version of Pandora Agent for Windows (beta2). diff --git a/pandora_agents/linux/INSTALL b/pandora_agents/linux/INSTALL deleted file mode 100644 index 2f240d6e81..0000000000 --- a/pandora_agents/linux/INSTALL +++ /dev/null @@ -1,42 +0,0 @@ -Installing Pandora Agent in Unix systems -======================================== - -Pandora currently has agents for Linux, Solaris, AIX, HP-UX(*), and BSD (IPSO, FreeBSD, OpenBSD...) (*) - -(*) Only Pandora Agent vesion 1.1, not version 1.2 - -Pandora Agent is a shell script that collects info from host machine, write in a XML file (called datafile), and send to the server using SSH (scp) or using any other way, like automated FTP. - -There are two configuration files: - -pandora_agent.conf -pandora_user.conf - -A script file (the pandora agent) - -pandora_agent.sh - -And a startup script - -pandora_agent_daemon - -Pandora Agents use pandora_agent.conf to load initial data and load module data. Modules are atomic source of information. Please refer to Pandora Agents configuration - Quick Guide for more information. - -pandora_user.conf is low level configuration. It will be executed in each iteration of pandora_agent.sh script. Please read it and see how it works. - -There are a startup script called "pandora_agent_daemon" used to load Pandora Agent at boot time, and to stop ip. It depends on what type of Unix are you running. Test it before including it your init level script directory, it accepts start / stop / restart commands, like usual in Unix System V systems. - -Installing Pandora Agent. -========================= -There's a installer for the pandora agent, which is called: -pandora_agent_installer - -You can easily install the PandoraFMS Agent using: -./pandora_agent_installer --install - -To uninstall the agent just use: -./pandora_agent_installer --uninstall - -If you want to reinstall the pandora agent you already installed in your system: -./pandora_agent_installer --force-install - diff --git a/pandora_agents/linux/README b/pandora_agents/linux/README new file mode 100644 index 0000000000..7d8fd18d24 --- /dev/null +++ b/pandora_agents/linux/README @@ -0,0 +1,209 @@ +Pandora FMS : The Free Monitoring System (v1.3) +=============================================== + +http://pandora.sourceforge.net + +What is Pandora FMS +------------------- + +Pandora watches your systems and applications, and allows you to know the status of any element +of those systems. Pandora could detect a network interface down, a defacement in your website, +a memory leak in one of your server app, or the movement of any value of the NASDAQ new +technology market. If you want, Pandora could send out SMS message when your systems fails... +or when Google's value drop below US$ 33. + +Pandora will adjust, like an octopus, to your systems and requirements, because has been +designed to be open, modular, multiplattform and easy to customize and use, all integrated into +a scalable and distributed architecture. + +Pandora runs on any operating system, with specific agents for each platform gathering data and +sending it to a server, it has specific agents for GNU/Linux, AIX, Solaris, HP-UX, BSD/IPSO, +and Windows 2000, XP and 2003. + +Pandora can also monitor any kind of TCP/IP service, without the need to install agents, and +monitor network systems such as load balancers, routers, switches, operating systems, +applications, or simply printers if you need. Pandora also supports SNMP for collecting data +and for receiving traps. + +A few examples of common resources monitored by Pandora could be processor load, disk and +memory usage, running processes, log files, environmental factors such as temperature, or +application values like strings contained in web pages or any possible way to collect data in +an automatic way. + +Pandora FMS Features +-------------------- + + * Lightweigth agents. No need to install adicional software. + * Also could use network to collect data on remote systems. + * High availability for each component. + * Escalable architecture: no liminitation on number of servers you can setup for the same enviroment. + * Internal detection on Network Servers in case of failure, automatic takeover of secondary servers. + * Stores all data for many weeks or months + * Support for implementing redundant and distributed monitoring servers. + * Data is stored in a relational database (MySQL). + * Automatic database optimization for size, using interpolation and compression algorithms. + * Integrated alert systems: send mails, execute scripts, send SMS, or simply write to syslog are a few examples. + * Integrated graphical reporting system for any kind of collected data. + * SNMP Trap reception with Realtime Console. + * Granularity of accesses and user profiles for each group and each user. + * Integrated internal auditing for any operation. + * Alert filtering to avoid false positives. + * Event system with user validation for operation in teams. + * Integrated incident system with flows and different profiles. + * Any collected value can be displayed as graph or data table. + * Alerts can be triggered any kind of event, in many ways. + * WebConsole on line HTML contextual help. + * Integrated DB management: purge and DB compaction. + * Mass configuration/alert manager to copy and distribute agent-module and/or agents/alerts setup to other agents. + * Profiles could be personalized using up to eight security attributes without limitation on groups or profiles. + * Filters for collected data to avoid bad data. + +Install +------- + +Please visit our online documentation site or download install guides at +http://pandora.sourceforge.net. + +Quick Install Guide for Pandora FMS UNIX AGENTS 1.3 +--------------------------------------------------- + +Installing Pandora FMS Agent for unix + +Untar agent tarball, for example at /tmp/pandora_agent + +As root, execute command line installer: + + ./pandora_agent_installer --install + +This should install your agent, setup permissions and place files in their respective locations: + + root@blackbox01:/tmp/pandora/pandora_agents/linux# ./pandora_agent_installer --install + + Pandora FMS Agent Installer 1.0 (c) 2007 Sancho Lerena + This program is licensed under GPL2 Terms. http://pandora.sourceforge.net + + Checking default dir /usr/share/pandora_agent... + Checking Pandora FMS Agent on /usr/bin/pandora_agent.... + Creating Pandora FMS Agent home directory at /usr/share/pandora_agent ... + . + . + + Creating logfile at /var/log/pandora_agent.log... + Copying Pandora FMS Agent to /usr/bin/pandora_agent... + You have your startup script ready at /etc/init.d/pandora_agent_daemon + First you need to copy your public SSH keys (/home/slerena/.ssh/id_dsa) + under /home/pandora/.ssh/authorized_keys on your Pandora FMS Server host + You also need to setup your /etc/pandora/pandora_agent.conf config file + +Setup SSH authentication + +Due that Pandora FMS agent connect by SSH you need to setup SSH keys now. You also can use FTP method by +using .netrc file, but it's much more secure and better to use SFTP with SSH2). + +Probably you want to run Pandora FMS agent under root privileges to grab system data. It's possible that you +don't need to run as root to collect data you need, in that case, procedure are the same, but using another +user. + +Create ssh keys using DSA type for key: + + ssh-keygen -t dsa + +And reply as follows to questions (enter to all questiosn): + + Generating public/private dsa key pair. + Enter file in which to save the key (/root/.ssh/id_dsa): + Created directory '/root/.ssh'. + Enter passphrase (empty for no passphrase): + Enter same passphrase again: + Your identification has been saved in /root/.ssh/id_dsa. + Your public key has been saved in /root/.ssh/id_dsa.pub. + The key fingerprint is: + xx:xx:xx:xx:xx:xx:xx:xx:xx:2d:68:30:f7:53:2d:7e + +You need to add your PUBLIC key (/root/.ssh/id_dsa.pub) to /home/pandora/.ssh/authorized_keys file in each +Pandora FMS data server you want to use with this agent. + +Login to Pandora FMS data server, and add the key on /home/pandora/.ssh/authorized_keys file. You could use +cut and paste, for example, or copying file with scp or ftp from one system to another. Take care of +carriage returns. Public key "appearance" is like as: + + ssh-dss AAAAB3NzaC1kc3MAAACBAMR4WOOvuT3UyZPKC/NcqBuduB/H8oKF2LRv52LX88YNO + kgdIPNOat+NeweCuQdVOaDUNvFTgnyYV6iBtApstzUl6ndKALZlDoZnBYULYTUtBF+cdRHq7v + n0bufIMRHFpg8ZvqR3dBulz6bVQqJu8nqZGQDyLgPEmkQ6O9 root@blackbox01 + +The entire block MUST BE in a SINGLE LINE, if not, don't work. Also, /home/pandora/.ssh/ directory and +/home/pandora/.ssh/authorized_keys in server, should have "pandora" user ownership and permissions set to +700 for directory and 600 for authorized_keys file. + +For example, if you have copied id_dsa.pub to /tmp in server system: + + cat /tmp/id_dsa.pub >> /home/pandora/.ssh/authorized_keys + chmod 600 /home/pandora/.ssh/authorized_keys + chmod 700 /home/pandora/.ssh/ + chown -R pandora /home/pandora/ + +Image:Warning.png Warning! Setting up SSH authentication is a mess due ANY step you missed, makes auth to +fails, so please don't skip nothing + +Always test this connection to check that SSH authentication is working. From your agent system, where +Pandora FMS agent is running, try to contact Pandora FMS server: + + ssh pandora@server_ip + +First time a hostkey authentication changenge should show you something like: + + The authenticity of host 'xxxxx (x.x.x.x)' can't be established. + RSA key fingerprint is 42:d4:a5:f2:a7:b8:1f:c3:d5:42:ab:c7:b5:5b:af:57. + Are you sure you want to continue connecting (yes/no)? + +Reply yes, and you should see the system prompt for user pandora, WITHOUT asking for password, because SSH +automatic authentication, based on DSA Keys, should work and resolve authentication. If not, try to review +previous steps. Note that if you're using scponly protection, shell don't be available, but authentication +will be correct. + +If you have serious problems and get stuck, try to setup maximun verbosity of SSH Daemon on System running +Pandora FMS server: + + vi /etc/ssh/sshd_config + +Replace LogLevel INFO for LogLevel DEBUG2 + +Restart ssh + + /etc/init.d/ssh restart + +Now you have MUCH MORE information about SSH problems. In debian this information is at /var/log/auth.log. +Dont forget to set again LogLevel INFO in your sshd_config and restart again SSH, or too much loggin will be +generated (and performance penalty). + +Configure Pandora FMS agent + +Your config file is at /etc/pandora/pandora_agent.conf, edit it and setup that variables: + + * server_ip: put IP address of your Pandora FMS data server + * debug: set it to zero to not use debug mode. + +Rest of parameters could be default values. + +Check out some of the default modules to have an idea of your agent will do and what kind of information +will report to Pandora FMS data server. This could be modified in any time (restarting agent). + +Run your Pandora FMS unix agent + +First to need to create your agent in your Pandora FMS console as described in "new agent" procedure (but +you don't need to create network modules), only create an agent with the SAME name that have your system. +After creating agent in console, you could launch agent: + + /etc/init.d/pandora_agent_daemon start + +If you have problems, a good idea is restart Pandora FMS agent manually to check errors in startup: + + pandora_agent /etc/pandora + +License +------- + +The project is distributed under the GPL License v2 or later. + +Copyright (C) 2004-2007 Pandora FMS development team + diff --git a/pandora_agents/linux/pandora_agent b/pandora_agents/linux/pandora_agent index 8e8194734e..8a7f073e22 100755 --- a/pandora_agents/linux/pandora_agent +++ b/pandora_agents/linux/pandora_agent @@ -54,7 +54,7 @@ fi NOMBRE_HOST=`/bin/hostname` OS_NAME=`uname -s` -PANDORA_LOGFILE=/var/log/pandora_agent.log +PANDORA_LOGFILE=/var/log/pandora/pandora_agent.log TEMP=/tmp # Read config file diff --git a/pandora_agents/linux/pandora_agent_installer b/pandora_agents/linux/pandora_agent_installer index 5a98eeccde..4e9f588160 100755 --- a/pandora_agents/linux/pandora_agent_installer +++ b/pandora_agents/linux/pandora_agent_installer @@ -12,7 +12,7 @@ PANDORA_BIN=/usr/bin/pandora_agent PANDORA_HOME=/usr/share/pandora_agent PANDORA_TEMP=/var/spool/pandora PANDORA_CFG=/etc/pandora -PANDORA_LOG=/var/log/pandora_agent.log +PANDORA_LOG=/var/log/pandora/pandora_agent.log PANDORA_STARTUP=/etc/init.d/pandora_agent_daemon FORCE=0 LOG_TIMESTAMP=`date +"%Y/%m/%d %H:%M:%S"` @@ -63,6 +63,7 @@ install () { mkdir $PANDORA_TEMP mkdir $PANDORA_TEMP/data_out mkdir $PANDORA_CFG + mkdir /var/log/pandora # Create logfile if [ ! -z "`touch $PANDORA_LOG`" ]