From f080276317512d1c08cbc2f50b10730bf24e8611 Mon Sep 17 00:00:00 2001 From: raulmateos Date: Thu, 21 Sep 2006 10:21:22 +0000 Subject: [PATCH] 2006-09-21 Raul Mateos * en/pandora_install.xml: Updated git-svn-id: https://svn.code.sf.net/p/pandora/code/trunk@182 c3f86ba8-e40f-0410-aaad-9ba5e7f4b01f --- pandora_doc/ChangeLog | 4 ++ pandora_doc/en/pandora_install.xml | 81 ++++++++++++++++-------------- 2 files changed, 46 insertions(+), 39 deletions(-) diff --git a/pandora_doc/ChangeLog b/pandora_doc/ChangeLog index af47d555de..abe0603c05 100644 --- a/pandora_doc/ChangeLog +++ b/pandora_doc/ChangeLog @@ -1,3 +1,7 @@ +2006-09-21 Raul Mateos + + * en/pandora_install.xml: Updated + 2006-09-18 slerena * en/pandora.xml: Moved to pandora_user.xml. A new file called diff --git a/pandora_doc/en/pandora_install.xml b/pandora_doc/en/pandora_install.xml index e266ef42d4..51576a0f7b 100644 --- a/pandora_doc/en/pandora_install.xml +++ b/pandora_doc/en/pandora_install.xml @@ -1,7 +1,7 @@ - + &pandora; installation - + Prerequisites &pandora; is not only a single app, its composed by @@ -13,7 +13,7 @@ libraries and software you need before install &pandora;. - + Pandora Servers Pandora 1.2 has three kind of servers: Data server, Network @@ -22,7 +22,7 @@ you could setup many of them in a High Availability enviroment or using it to manage highs loads of data. - Pandora Data Server + Pandora Data Server To build Pandora Data Server you need to have the following perl modules and software installed in your @@ -64,7 +64,7 @@ - Pandora Network Server + Pandora Network Server Requires SSH Server and Perl v5.8 or higher and the next Perl Modules:
@@ -109,7 +109,7 @@ Network Server must run with root privileges. - Pandora SNMP Server + Pandora SNMP Server You need to install the NET-SNMP package which is included in all GNU/Linux distributions. You have to use the snmptrapd @@ -122,7 +122,7 @@ - Installing Pandora Server + Installing Pandora Server Create the /opt/pandora directory and "gunzip" and "untar" here the @@ -158,7 +158,7 @@ - Configuring your new Pandora Server setup + Configuring your new Pandora Server setup After install Pandora Server in, you will need to edit the file pandora_server.conf, where are defined the @@ -229,7 +229,7 @@ - Setting up SSH configuration + Setting up SSH configuration Pandora, uses SSH protocol to copy XML data packets, generated by the agents, to the server. You need to generate a @@ -254,10 +254,9 @@ - - + Pandora Console and Pandora database - Pandora database install + Pandora database install Please look at MySQL install and management guide (http://dev.mysql.com/doc) to obtain information about how to @@ -350,7 +349,7 @@ - + Pandora console install. Prior to install Pandora console, you need the following dependencies and software needed: @@ -451,7 +450,7 @@ string with big font: TEST and a big table with a lot of info about your PHP installation. - Graphic reporting instalation + Graphic reporting instalation For correct graphic generation, you need to enter the full path to a TrueType font installed in your system. By default a @@ -475,9 +474,8 @@ - - Pandora Agents - Introduction + Pandora Agents + Introduction &pandora; agents collect all system's data. They are executed in each local system, although they can also collect remote @@ -507,7 +505,7 @@ - Generic role of the agents + Generic role of the agents Regardless the platform an agent is running on, this is formed of the following elements: @@ -526,25 +524,26 @@ This simple structure makes it easy the customisation of an - agent. There is no need to "reprogram" the agent to modify the + agent. There is no need to code again the agent to modify the way it works, as the configuration file holds most of the parameters needed to do so. - Main Script + Main Script The main script is the executable file that collects the data specified in the configuration file. It sends the data to the server in XML. In Windows machines application is installed as a service and is executed at the time intervals set in the configuration file. In machines running over UNIX the main script - is run through a special script called pandora_agent_daemon, and + is run through a special script called + pandora_agent_daemon, and runs continuously in the machine as a process. - Configuration File + Configuration File The data collection in the host system is the gathering of independent data units, which are defined in the @@ -568,7 +567,7 @@ - General parameters + General parameters The general parameters of the agent configuration are defined in this section. Some of these parameters are common for all systems @@ -679,7 +678,7 @@ - Module definition + Module definition Each data item that is to be collected must be defined precisely in each module, using the exact syntax. As many values as @@ -861,7 +860,7 @@ -Agent types +Agent types It is possible to monitor virtually any system with Pandora. This can be done either with a local agent collecting data directly from @@ -878,8 +877,8 @@ example, an SNMPGET tool. -UNIX agents -Introduction to Unix agents +UNIX agents +Introduction to Unix agents The in-built UNIX applications and tools make the agents running on this system be very simple. There are also agents developed for AIX, @@ -955,7 +954,7 @@ -Pandora Unix Agent install +Pandora Unix Agent install The software comes in a .tar.gz file. First of all the file needs to be extracted into a folder, usually /opt/pandora_agent, @@ -1007,7 +1006,7 @@ where the activity of the Pandora agent is saved, when the agent is executed in debugging mode. - Key generation + Key generation The SSH keys generated must be: @@ -1045,7 +1044,7 @@ The system must connect successfully BEFORE launching the Pandora agent. - First execution of the Unix agent + First running of the Unix agent To start the agent it is only necessary to execute pandora_agent_daemon start from /opt/pandora_client. Pandora Agent @@ -1066,7 +1065,7 @@ - Advanced agent configuration for Unix + Advanced configuration for Unix Agent The real power of Pandora resides in the capability of the agents to run user defined scripts. This could be used to collect @@ -1154,7 +1153,7 @@ - Implementation examples for Unix Agents + Implementation examples for Unix Agents Example #1: calculate the number of HITS of the main page of an Apache Web server: @@ -1180,6 +1179,7 @@ Complete example of the configuration of an agent for Linux + - - Pandora Windows Agents. - + + Pandora Windows Agents + Build Windows Agent from sources In order to build from sources, you will need the latest @@ -1285,7 +1286,7 @@ installation. - + Windows Agent installation Before running or installation of Pandora Windows service, you @@ -1336,7 +1337,7 @@ - + Windows Agent testing You can check the Pandora Windows Agent output in the @@ -1351,13 +1352,14 @@ "ssh.test". - + Windows Agent configuration All setup is made in babel_agent.conf. This file is a list of keys/values pairs. Here is an example of this file. +