2006-11-21 Raul Mateos <raulofpandora@gmail.com>
* en/pandora_install.xml, en/pandora_advanced.xml, en/pandora_chapter1.xml, en/pandora_chapter2.xml, en/pandora_chapter3.xml, en/pandora_chapter4.xml, en/pandora_chapter5.xml, en/pandora_chapter6.xml, en/pandora_chapter7.xml, en/pandora_chapter8.xml, en/pandora_chapter9.xml, en/pandora_introduction.xml en/pandora_migration.xml, en/pandora_userguide.xml: Text correction. git-svn-id: https://svn.code.sf.net/p/pandora/code/trunk@267 c3f86ba8-e40f-0410-aaad-9ba5e7f4b01f
This commit is contained in:
parent
347301256c
commit
589df51e8b
|
@ -1,7 +1,7 @@
|
||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<chapter>
|
<chapter>
|
||||||
<title>Pandora. Advanced section</title>
|
<title>Pandora FMS advanced section</title>
|
||||||
<sect1><title>Pandora High availabilty features</title>
|
<sect1><title>Pandora FMS High Availability features</title>
|
||||||
<para>
|
<para>
|
||||||
You may setup Pandora for use HA in several scenarios:
|
You may setup Pandora for use HA in several scenarios:
|
||||||
<itemizedlist mark='bullet'>
|
<itemizedlist mark='bullet'>
|
||||||
|
@ -9,17 +9,17 @@
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Database Clustering for HA</emphasis>. You need to
|
<emphasis>Database Clustering for HA</emphasis>. You need to
|
||||||
setup a MySQL5 Cluster. In support forums / wiki are
|
setup a MySQL5 Cluster. In support forums / wiki are
|
||||||
information to make this, you only need to convert DB schama
|
information to make this, you only need to convert DB schema
|
||||||
in a MySQL Cluster compatible tables. This scenario has been
|
in a MySQL Cluster compatible tables. This scenario has been
|
||||||
tested and works fine, but you need some advanced knowledgue
|
tested and works fine, but you need some advanced knowledge
|
||||||
for MySQL Clustering administration.
|
about MySQL Clustering administration.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Multiple Pandora Console</emphasis>. It's easy,
|
<emphasis>Multiple Pandora Console</emphasis>. It's easy,
|
||||||
you only need to setup another one. No locking problems or
|
you only need to setup another one. No locking problems or
|
||||||
incompatibility has been detected in several Pandora
|
incompatibility has been detected in several Pandora FMS
|
||||||
deployments.
|
deployments.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
@ -103,13 +103,13 @@
|
||||||
Data compression based on interpolation and data purge, makes a
|
Data compression based on interpolation and data purge, makes a
|
||||||
smaller database, but this was not enought. Production systems has
|
smaller database, but this was not enought. Production systems has
|
||||||
a limit based on 100 agents, with about ten modules each one. This
|
a limit based on 100 agents, with about ten modules each one. This
|
||||||
was not a high limit for huge enviroments.
|
was not a high limit for huge environments.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
This problem was very important for Pandora future, so we are
|
This problem was very important for Pandora future, so we are
|
||||||
changed the way Pandora store its pada. New data management system
|
changed the way Pandora store its data. New data management system
|
||||||
store only "new" data. If a duplicate value enter the system, it
|
store only "new" data. If a duplicate value enter the system, it
|
||||||
doesnt be stored in database. It's very useful to keep database
|
won't be stored in database. It's very useful to keep database
|
||||||
small. This works for all pandora data modules: numerical,
|
small. This works for all pandora data modules: numerical,
|
||||||
incremental, boolean and string.
|
incremental, boolean and string.
|
||||||
</para>
|
</para>
|
||||||
|
@ -125,11 +125,11 @@
|
||||||
<para>
|
<para>
|
||||||
Changes come with some different ways to reading data. With new
|
Changes come with some different ways to reading data. With new
|
||||||
version, if an agent cannot communicate with Pandora, and Pandora
|
version, if an agent cannot communicate with Pandora, and Pandora
|
||||||
Server doesnt receive data from agent, this "no data" cannot have
|
Server doesn't receive data from agent, this "no data" cannot have
|
||||||
a graphical representation, for module graph there will be no
|
a graphical representation, for module graph there will be no
|
||||||
changes. You will have a graph with a perfect horizontal
|
changes. You will have a graph with a perfect horizontal
|
||||||
line. Pandora, if doesnt receive new values, thinks that is no new
|
line. Pandora, if doesn't receive new values, thinks that there
|
||||||
values, and everything seems to be equal that in the last
|
are no new values, and everything seems to be equal that in the last
|
||||||
notification.
|
notification.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
|
@ -138,8 +138,8 @@
|
||||||
|
|
||||||
<graphic fileref="images/module_graph_full.jpg" scale="60" align="center"/>
|
<graphic fileref="images/module_graph_full.jpg" scale="60" align="center"/>
|
||||||
|
|
||||||
This would be the equivalent graph for the same data, excepting a
|
This would be the equivalent graph for the same data, except a
|
||||||
conexión failure, from 05:55 to 15:29 aproximately.
|
connection failure, from 05:55 to 15:29 aproximately.
|
||||||
|
|
||||||
<graphic fileref="images/module_graph_peak.jpg" scale="60" align="center"/>
|
<graphic fileref="images/module_graph_peak.jpg" scale="60" align="center"/>
|
||||||
</para>
|
</para>
|
||||||
|
|
|
@ -3,10 +3,10 @@
|
||||||
<chapter id="chapter1">
|
<chapter id="chapter1">
|
||||||
<title>Introduction</title>
|
<title>Introduction</title>
|
||||||
<sect1 id="sec1.1">
|
<sect1 id="sec1.1">
|
||||||
<title>What is Pandora?</title>
|
<title>What is Pandora FMS?</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
Pandora is a monitoring tool that allows a system administrator
|
Pandora FMS is a monitoring tool that allows a system administrator
|
||||||
to visually analise the status and efficiency of Operating
|
to visually analise the status and efficiency of Operating
|
||||||
Systems, Servers, Applications and Hardware Systems - such as
|
Systems, Servers, Applications and Hardware Systems - such as
|
||||||
firewalls, proxies, databases, Web servers, tunnelling servers,
|
firewalls, proxies, databases, Web servers, tunnelling servers,
|
||||||
|
@ -53,7 +53,7 @@
|
||||||
<para>
|
<para>
|
||||||
The core server accesses Pandora database, which is shared with
|
The core server accesses Pandora database, which is shared with
|
||||||
the Web server, and stores the processed data packages. The
|
the Web server, and stores the processed data packages. The
|
||||||
server is executed under the name of "Demonio", and processes
|
server is executed under the name of "Demon", and processes
|
||||||
the packages stored in its file system. The data is generated
|
the packages stored in its file system. The data is generated
|
||||||
by the system agents. Despite the server's low system resources
|
by the system agents. Despite the server's low system resources
|
||||||
comsumption and simple installation and operation, the core
|
comsumption and simple installation and operation, the core
|
||||||
|
@ -67,8 +67,8 @@
|
||||||
system only supports MySQL. The central database keeps all the
|
system only supports MySQL. The central database keeps all the
|
||||||
information Pandora needs to work - agent data, settings, user
|
information Pandora needs to work - agent data, settings, user
|
||||||
information, incidents, system settings, etc. The system can use
|
information, incidents, system settings, etc. The system can use
|
||||||
a MySQL cluster to store the information, or a high
|
a MySQL cluster to store the information, or a High
|
||||||
disponibility solution for larger sytems.
|
Availability (HA) solution for larger sytems.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
|
@ -89,7 +89,7 @@
|
||||||
They have been developed to work under a specific platform,
|
They have been developed to work under a specific platform,
|
||||||
making use of the specific tools of the used language:
|
making use of the specific tools of the used language:
|
||||||
VBSCript/Windows Scripting for Microsoft platforms (Win2000,
|
VBSCript/Windows Scripting for Microsoft platforms (Win2000,
|
||||||
WinXP y Win2003) and ShellScripting for Unix - which includes
|
WinXP and Win2003) and ShellScripting for Unix - which includes
|
||||||
GNU/Linux, Solaris, AIX, HP-UX and BSD, as well as the Nokia's
|
GNU/Linux, Solaris, AIX, HP-UX and BSD, as well as the Nokia's
|
||||||
IPSO. Pandora agents can be developed in virtually any language,
|
IPSO. Pandora agents can be developed in virtually any language,
|
||||||
given its simple API and being open source.
|
given its simple API and being open source.
|
||||||
|
|
|
@ -5,30 +5,30 @@
|
||||||
<title>Agents</title>
|
<title>Agents</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
The agents collect information. There are agent based on a software
|
The agents collect information. There are agents based on a software
|
||||||
agent and install in the System to monitor, and network agent, a
|
agent and installed in the System to monitor, and network agents - a
|
||||||
non-physical agent, without need of installing any software, that
|
non-physical agent, without need of installing any software, that
|
||||||
execute network tasks in Pandora Network servers, and showing
|
execute network tasks in Pandora Network servers and shows
|
||||||
information on console inside an Agent.
|
information on console.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
For agents who need to install software onto remote systems,
|
For agents who need to install software into remote systems,
|
||||||
public key of the machine to be monitored needs to be copied onto
|
public key of the machine to be monitored needs to be copied into
|
||||||
Pandora Data server to be able to collect data, as it's specified
|
Pandora Data server to be able to collect data, as it is specified
|
||||||
in detail in Pandora Install documentation.
|
in detail in Pandora Install documentation.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Data collected from the agents are stored in small pieces of
|
Data collected from the agents are stored in small pieces of
|
||||||
information called "modules". Each module store only a kind of
|
information called "modules". Each module stores only a kind of
|
||||||
data. Value of each module is the value of one monitored
|
data. The value of each module is the value of one monitored
|
||||||
variable. The agent must be activated in Pandora's server and a
|
variable. The agent must be activated in Pandora Server and a
|
||||||
group assigned to the agent. The data starts then been
|
group assigned to the agent. The data then begin to be
|
||||||
consolidated in the database and can be accessed.
|
consolidated in the database and can be accessed.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
A network agent NEEDs to be assigned to a Network Server to
|
A network agent NEEDs to be assigned to a Network Server to
|
||||||
execute network tasks. If you cannot see any Network Servers it's
|
execute network tasks. If you cannot see any Network Servers it's
|
||||||
because you has not executed any Network Servers. Please configure
|
because you don't have any Network Server running. Please configure
|
||||||
and run a Network Server before trying to assign a network module
|
and run a Network Server before trying to assign a network module
|
||||||
to an Agent.
|
to an Agent.
|
||||||
</para>
|
</para>
|
||||||
|
@ -72,19 +72,20 @@
|
||||||
<para>
|
<para>
|
||||||
Pandora groups are common to agents, incidents and
|
Pandora groups are common to agents, incidents and
|
||||||
profiles. Groups are added in "Manage Profiles" > "Manage
|
profiles. Groups are added in "Manage Profiles" > "Manage
|
||||||
Groups", Administration menu.
|
Groups" in the Administration menu.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<graphic scale='70' fileref="images/image007.png" valign="bottom"
|
<graphic scale='70' fileref="images/image007.png" valign="bottom"
|
||||||
align="center"/>
|
align="center"/>
|
||||||
|
|
||||||
<para>There are several default groups defined in Pandora. You also can
|
<para>
|
||||||
|
There are several default groups defined in Pandora. You also can
|
||||||
create your own (please use given icons or edit and add your own icons).
|
create your own (please use given icons or edit and add your own icons).
|
||||||
You can also modify default ones.</para>
|
You can also modify default ones.
|
||||||
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
A group is added by clicking "Create group" and assigning a name
|
A group is added by clicking "Create group" and assigning a name to it.
|
||||||
to it.
|
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
A group is deleted by clicking the delete icon
|
A group is deleted by clicking the delete icon
|
||||||
|
@ -95,18 +96,18 @@
|
||||||
<sect1 id="sec3.2">
|
<sect1 id="sec3.2">
|
||||||
<title>Adding an agent</title>
|
<title>Adding an agent</title>
|
||||||
<para>
|
<para>
|
||||||
You can define new agents. Once defined in Pandora console, its
|
You can define new agents. Once defined in Pandora console, it is
|
||||||
ready to receive data from a Software agent (old agents, based
|
ready to receive data from a Software agent (old agents, based
|
||||||
on software installed in a remote machine), or from Network
|
on software installed in a remote machine), or from Network
|
||||||
Agents (assined to a Network Server who run network tasks to
|
Agents (assined to a Network Server who runs network tasks to
|
||||||
monitorize remote systems). You also mix both types of module in
|
monitor remote systems). You can also mix both types of module
|
||||||
the same agent.
|
in the same agent.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Please remember that a network agent NEEDs to be assigned to a
|
Please remember that a network agent NEEDs to be assigned to a
|
||||||
Network Server to execute network tasks. If you cannot see any
|
Network Server to execute network tasks. If you can't see any
|
||||||
Network Servers it's because you has not executed any Network
|
Network Servers it's because you don't have any Network Server
|
||||||
Servers. Please configure and run a Network Server before trying
|
running. Please configure and run a Network Server before trying
|
||||||
to assign a network module to an Agent.
|
to assign a network module to an Agent.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
|
@ -118,8 +119,7 @@
|
||||||
align="center"/>
|
align="center"/>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
To add a new agent the following parameters must be
|
To add a new agent the following parameters must be configured:
|
||||||
configured:
|
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
|
@ -134,36 +134,35 @@
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>IP Address:</emphasis> IP address of an agent. An
|
<emphasis>IP Address:</emphasis> IP address of an agent. An
|
||||||
agent can share its IP address with other agents. Its only
|
agent can share its IP address with other agents. It's only
|
||||||
for informational purposes. In network agents its useful,
|
used for informational purposes. In network agents it's useful,
|
||||||
because use this IP address for all new network module
|
because the Server uses this IP address for all new
|
||||||
definition by default.
|
network module definition by default.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Group:</emphasis> Pandora's group the agent
|
<emphasis>Group:</emphasis> Pandora's group the agent
|
||||||
belongs. In this version of Pandora, an agent only can
|
belongs to. In this version of Pandora, an agent only can
|
||||||
belong to a group.
|
belong to a group.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Interval:</emphasis> Execution interval of an
|
<emphasis>Interval:</emphasis> Execution interval of an
|
||||||
agent. It is the time elapsed in seconds, between two
|
agent. It is the time elapsed in seconds between two
|
||||||
executions. An agent could have a defined interval, but
|
consecutive agent executions. An agent could have a
|
||||||
could have modules with different (bigger or smaller)
|
defined interval, but could have modules with different
|
||||||
intervals. An agent its considered "down" (not responding)
|
(bigger or smaller) intervals. An agent is considered
|
||||||
when Pandora servers (any of them) has no contact with agent
|
"down" (not responding) when Pandora servers (any of them)
|
||||||
in Interval x 2 seconds.
|
has no contact with agent in Interval x 2 seconds.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>OS:</emphasis> The Operating System to be
|
<emphasis>OS:</emphasis> The Operating System to be
|
||||||
monitored. The supported Operating Systems are: AIX, BeOS,
|
monitored. The supported Operating Systems are: AIX, BeOS,
|
||||||
BSD, Cisco, HPUX, Linux, MacOS, Other, Solaris,
|
BSD, Cisco, HP-UX, Linux, MacOS, Other, Solaris, Windows.
|
||||||
Windows.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
|
@ -183,7 +182,7 @@
|
||||||
by the agent are accepted. If modules are not defined, they
|
by the agent are accepted. If modules are not defined, they
|
||||||
are automatically defined by the system. It is recommended
|
are automatically defined by the system. It is recommended
|
||||||
to activate the agents in this mode and change it once the
|
to activate the agents in this mode and change it once the
|
||||||
user is familiar with the system.
|
user is familiar with Pandora FMS.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
|
@ -207,14 +206,14 @@
|
||||||
|
|
||||||
<para>Pandora's agents use the operating system own commands to
|
<para>Pandora's agents use the operating system own commands to
|
||||||
monitor a device. Pandora's server will store and process the
|
monitor a device. Pandora's server will store and process the
|
||||||
output generated by those commands. The commandos are called
|
output generated by those commands. The commands are called
|
||||||
"modules".</para>
|
"modules".</para>
|
||||||
|
|
||||||
<para>If the agent had been added in "normal mode", the modules
|
<para>If the agent had been added in "normal mode", the modules
|
||||||
to be monitored should have been assigned. Those modules must be
|
to be monitored should have been assigned. Those modules must be
|
||||||
configured in the agent configuration file.</para>
|
configured in the agent configuration file.</para>
|
||||||
|
|
||||||
<para>The modules to be processed by Pandora's server are
|
<para>The modules to be processed by Pandora Server are
|
||||||
assigned in the "Manage Agents" option, Administration menu. A
|
assigned in the "Manage Agents" option, Administration menu. A
|
||||||
list with all the agents in Pandora will be shown here.</para>
|
list with all the agents in Pandora will be shown here.</para>
|
||||||
|
|
||||||
|
@ -226,7 +225,7 @@
|
||||||
align="center"/>
|
align="center"/>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
To add a module is neccesary fill some of the following field:
|
To add a module is necessary to fill some of the following fields:
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Module type</emphasis>: type of module,there are the
|
<emphasis>Module type</emphasis>: type of module,there are the
|
||||||
|
@ -250,9 +249,9 @@
|
||||||
<emphasis>generic_data_proc</emphasis>: Boolean data type:
|
<emphasis>generic_data_proc</emphasis>: Boolean data type:
|
||||||
0 means False or "bad values", and 1 means True or "good"
|
0 means False or "bad values", and 1 means True or "good"
|
||||||
value. Generic Proc types are also called "monitors"
|
value. Generic Proc types are also called "monitors"
|
||||||
because could say if something is "ok" or is "wrong". Are
|
because could say if something is "ok" or is "wrong". They
|
||||||
displayed in agent view as little lamps. Red if 0, Green
|
Are displayed in agent view as little lamps. Red if 0, Green
|
||||||
is 1.
|
if 1.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
|
@ -285,7 +284,7 @@
|
||||||
SEND" (you can use the macro ^M to send carriage returns)
|
SEND" (you can use the macro ^M to send carriage returns)
|
||||||
and wait to receive string defined in "TCP RECEIVE". If
|
and wait to receive string defined in "TCP RECEIVE". If
|
||||||
Pandora Network Server received TCP RECEIVE string, it
|
Pandora Network Server received TCP RECEIVE string, it
|
||||||
returns 1 (ok), else return 0 (wrong).
|
returns 1 (ok), else returns 0 (wrong).
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
|
@ -293,18 +292,18 @@
|
||||||
<para>
|
<para>
|
||||||
<emphasis>generic_tcp_data: generic_tcp_string,
|
<emphasis>generic_tcp_data: generic_tcp_string,
|
||||||
generic_tcp_inc</emphasis>, gets numerical data, string
|
generic_tcp_inc</emphasis>, gets numerical data, string
|
||||||
data or incremental data from TCP open port. If cannot
|
data or incremental data from TCP open port. If it cannot
|
||||||
connect, no value returned.
|
connect, no value returned.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>generic_snmp types:</emphasis>: they obtain
|
<emphasis>generic_snmp types:</emphasis>: they get
|
||||||
informacion using SNMP interface. If you enter SNMP
|
information using SNMP interface. If you enter SNMP
|
||||||
community, and IP address, you can walk SNMP MIB from
|
community and IP address, you can walk SNMP MIB from
|
||||||
target using SNMP v1 protocol, and all MIB variables will
|
target using SNMP v1 protocol, and all MIB variables will
|
||||||
be listed to allow you choose one. You also can enter MIB
|
be listed to allow you choose one. You can also enter MIB
|
||||||
using numerical OID or human - comprenhensive format.
|
using numerical OID or human - understandable format.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
|
@ -316,30 +315,30 @@
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Module Group</emphasis>: Is possible group the module
|
<emphasis>Module Group</emphasis>: It is possible to group
|
||||||
in the following groups: General, Networking, Application,
|
modules in the following groups: General, Networking,
|
||||||
System and Misscellaneous:
|
Application, System and Misscellaneous:
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Module Name</emphasis>: Name of the module.
|
<emphasis>Module Name</emphasis>: Name of the module.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Module Interval</emphasis>: Interval of time, in seconds
|
<emphasis>Module Interval</emphasis>: Interval of time in seconds
|
||||||
that the agent wait between each run.
|
that the agent waits between two consecutive executions.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Target IP</emphasis>: IP of the agent.
|
<emphasis>Target IP</emphasis>: IP of the agent.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>TCP port</emphasis>: TCP port to monitor, is possible
|
<emphasis>TCP port</emphasis>: TCP port to monitor, it is possible
|
||||||
configure UDP port if the module type generic_udp_proc is choose.
|
to configure UDP port if the module type generic_udp_proc is chosen.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>SNMP OID</emphasis>: SNMP OID to monitor. If you
|
<emphasis>SNMP OID</emphasis>: SNMP OID to monitor. If you
|
||||||
configure the MIBs in pandora is possible get the value.
|
configure the MIBs in pandora is possible to get the value.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>SNMP Community</emphasis>: Community neccesary to monitor
|
<emphasis>SNMP Community</emphasis>: Community necessary to monitor
|
||||||
a SNMP OID.
|
a SNMP OID.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
|
@ -347,7 +346,7 @@
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>TCP receive</emphasis>: Field to configure the
|
<emphasis>TCP receive</emphasis>: Field to configure the
|
||||||
parameters which we hope receive in a TCP conexion.
|
parameters which we expect to receive in a TCP connection.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Maximum:</emphasis>: Upper threshold for the
|
<emphasis>Maximum:</emphasis>: Upper threshold for the
|
||||||
|
@ -366,8 +365,8 @@
|
||||||
module.
|
module.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
All the modules to be monitored by an agent can be reviewed by
|
All the modules to be monitored by an agent can be reviewed
|
||||||
accessing the agent in the "Manage Agents" option,
|
by accessing the agent in the "Manage Agents" option,
|
||||||
Administration menu.
|
Administration menu.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
@ -400,12 +399,12 @@
|
||||||
<title>Alerts</title>
|
<title>Alerts</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
An alert is Pandora's reaction to an out of range module
|
An alert is Pandora's reaction to an "out of range" module
|
||||||
value. The Alert can consist in sending and e-mail or SMS to
|
value. The Alert can consist of sending an e-mail or SMS to
|
||||||
the administrator, sending a SNMP trap, write the incident
|
the administrator, sending a SNMP trap, write the incident
|
||||||
into the system syslog or Pandora log file, etc. And basically
|
into the system syslog or Pandora log file, etc. Basically,
|
||||||
anything that can be triggered by a script configured in
|
it's anything that can be triggered by a script configured
|
||||||
Pandora's Operating System.
|
in the Operating System where Pandora Servers run.
|
||||||
</para>
|
</para>
|
||||||
<sect3 id="sec3.2.2.1">
|
<sect3 id="sec3.2.2.1">
|
||||||
<title>Adding an Alert</title>
|
<title>Adding an Alert</title>
|
||||||
|
@ -538,13 +537,13 @@
|
||||||
<title>Assigning Alerts</title>
|
<title>Assigning Alerts</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
The next step after an Agent has been added, its
|
The next step after an agent has been added, its
|
||||||
modules have been configurated and the alerts have been
|
modules have been configurated and the alerts have been
|
||||||
defined, it is time to assign those Alerts to the agent.
|
defined, is to assign those alerts to the agent.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
This is done by clicking on the Agent to be configured on the
|
This is done by clicking on the agent to be configured in the
|
||||||
"Manage Agents" option, Administration menu.
|
"Manage Agents" option, Administration menu.
|
||||||
The Alert Assignation form is placed at the bottom of that
|
The Alert Assignation form is placed at the bottom of that
|
||||||
page.
|
page.
|
||||||
|
@ -554,7 +553,7 @@
|
||||||
valign="bottom" align="center"/>
|
valign="bottom" align="center"/>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
To assign an Alert the next fields must be filled in:
|
To assign an alert the next fields must be filled in:
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
|
@ -699,7 +698,7 @@
|
||||||
<sect1 id="sec3.3">
|
<sect1 id="sec3.3">
|
||||||
<title>Agent monitoring</title>
|
<title>Agent monitoring</title>
|
||||||
<para>
|
<para>
|
||||||
When the agents start the data transmission to the server, and
|
When the agents begin to send data to the server, and
|
||||||
it is added in the Web console, Pandora processes and inserts
|
it is added in the Web console, Pandora processes and inserts
|
||||||
the data in the Database. The data are consolidated and can be
|
the data in the Database. The data are consolidated and can be
|
||||||
accessed from the Web console, either as row data or as
|
accessed from the Web console, either as row data or as
|
||||||
|
@ -711,10 +710,10 @@
|
||||||
All the Agents can be accessed from the Operation menu.
|
All the Agents can be accessed from the Operation menu.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
You can view the agents in group you must click in "View aggent"
|
You can view the agents in group you must click in "View agent"
|
||||||
From here the status of the agents can be quickly reviewed
|
From here the status of the agents can be quickly reviewed
|
||||||
thanks to a simple system coloured circles and windows taht
|
thanks to a simple system coloured circles and windows that
|
||||||
appaer when the user pass the mouse on a group.
|
appear when the user pass the mouse on a group.
|
||||||
</para>
|
</para>
|
||||||
<graphic scale='70' fileref="images/groups.png" valign="bottom"
|
<graphic scale='70' fileref="images/groups.png" valign="bottom"
|
||||||
align="center"/>
|
align="center"/>
|
||||||
|
@ -756,7 +755,7 @@
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<inlinegraphic scale='70' fileref="images/b_green.png"/>
|
<inlinegraphic scale='70' fileref="images/b_green.png"/>
|
||||||
All the monitors OK. It's the ideal status.
|
All the monitors are OK. It's the ideal status.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<inlinegraphic scale='70' fileref="images/b_white.png"/>
|
<inlinegraphic scale='70' fileref="images/b_white.png"/>
|
||||||
|
@ -797,17 +796,17 @@
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<inlinegraphic scale='70' fileref="images/dot_red.png"/>
|
<inlinegraphic scale='70' fileref="images/dot_red.png"/>
|
||||||
When at least one alert has been sent within
|
Shown when at least one alert has been sent within
|
||||||
the time threshold of the alert.
|
the time threshold of the alert.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Last contact:</emphasis> Shows the time and date of
|
<emphasis>Last contact:</emphasis> Shows date and time of
|
||||||
the last data package sent by the agent, using a progress bar,
|
the last data package sent by the agent, using a progress bar,
|
||||||
according to value of the interval. If you see the image
|
according to value of the interval. If you see the image
|
||||||
<inlinegraphic scale='70' fileref="images/outof.png"/>,
|
<inlinegraphic scale='70' fileref="images/outof.png"/>,
|
||||||
the agent has not send data during the interval.
|
the agent has not send data during the interval.
|
||||||
Passing the mouse over the image will show you the last contact
|
Passing the mouse over the image will show you the last contact
|
||||||
in time and date format.
|
in date and time format.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Note:</emphasis> The icon <inlinegraphic scale='70'
|
<emphasis>Note:</emphasis> The icon <inlinegraphic scale='70'
|
||||||
|
@ -818,8 +817,10 @@
|
||||||
</sect2>
|
</sect2>
|
||||||
<sect2 id="sec3.3.2">
|
<sect2 id="sec3.3.2">
|
||||||
<title>Accessing the data of an agent</title>
|
<title>Accessing the data of an agent</title>
|
||||||
<para>When an agent is accessed, by clicking on its name, all the
|
<para>
|
||||||
information related to that agent is displayed.</para>
|
When an agent is accessed, by clicking on its name, all the
|
||||||
|
information related to that agent is displayed.
|
||||||
|
</para>
|
||||||
<sect3 id="sec3.3.2.1">
|
<sect3 id="sec3.3.2.1">
|
||||||
<title>Agent general info</title>
|
<title>Agent general info</title>
|
||||||
<para>
|
<para>
|
||||||
|
@ -937,7 +938,7 @@
|
||||||
defined.
|
defined.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Type:</emphasis> Data type of the monitor. For a ç
|
<emphasis>Type:</emphasis> Data type of the monitor. For a
|
||||||
monitor this value is always of the generic_proc type.
|
monitor this value is always of the generic_proc type.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
|
@ -1106,7 +1107,8 @@
|
||||||
<para>
|
<para>
|
||||||
A graph with number of packages sent by each Agent. A
|
A graph with number of packages sent by each Agent. A
|
||||||
package is the number of values from the modules the agent
|
package is the number of values from the modules the agent
|
||||||
sends after each time interval</para>
|
sends after each time interval
|
||||||
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
<graphic scale='70' fileref="images/image031.png"
|
<graphic scale='70' fileref="images/image031.png"
|
||||||
|
@ -1120,42 +1122,42 @@
|
||||||
<sect1 id="sec3.4">
|
<sect1 id="sec3.4">
|
||||||
<title>SNMP Console</title>
|
<title>SNMP Console</title>
|
||||||
<para>
|
<para>
|
||||||
Almost all device can send snmp traps when have any problem as
|
Almost all device can send SNMP traps when have any problem as
|
||||||
reboot lost interface, the temperature is very high, CPU crash,
|
reboot, lost interface, the temperature is very high, CPU crash,
|
||||||
etc ... .With Traps is possible know the problem when it happend.
|
etc. With Traps is possible to know the problem when it happens.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
In Pandora 1.2 there is a SNMP console to recieve snmp trap.
|
In Pandora 1.2 there is a SNMP console to receive SNMP traps.
|
||||||
Is possible configure any device to send snmp trap to Pandora,
|
It is possible configure any device to send SNMP traps to
|
||||||
only need the Pandora IP and Pandora Community.
|
Pandora FMS, you only need the Pandora IP and Community.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
in Operation, SNMP Console the users can see the snmp traps send
|
From SNMP Console in the Operation menu the users can see
|
||||||
to Pandora Server.
|
the SNMP traps sent to Pandora Server.
|
||||||
</para>
|
</para>
|
||||||
<graphic scale='70' fileref="images/SNMP_console.png"
|
<graphic scale='70' fileref="images/SNMP_console.png"
|
||||||
valign="bottom" align="center"/>
|
valign="bottom" align="center"/>
|
||||||
<sect2 id="sec3.4.1">
|
<sect2 id="sec3.4.1">
|
||||||
<title>SNMP Alerts</title>
|
<title>SNMP Alerts</title>
|
||||||
<para>
|
<para>
|
||||||
Just like is posible to generat alert if there is an out of
|
Just like is possible to generat alert if there is an out of
|
||||||
range module value. Is posible generate a alert if a snmp trap
|
range module value. It is possible to generate an alert if an
|
||||||
is received with a anorma value. The Alert can consist in
|
SNMP trap is received with a anorma value. The Alert can consist of
|
||||||
sending and e-mail or SMS to the administrator, sending a SNMP
|
sending and e-mail or SMS to the administrator, sending an SNMP
|
||||||
trap, write the incident into the system syslog or Pandora log
|
trap, write the incident into the system syslog or Pandora log
|
||||||
file, etc. And basically anything that can be triggered by a
|
file, etc. Basically anything that can be triggered by a
|
||||||
script configured in Pandora's Operating System.
|
script configured in the Operating System when Pandora Servers run.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
in Operation, SNMP Console, SNMP Alerts the users can see the
|
In "SNMP Console" > "SNMP Alerts" from Operation menu, the users
|
||||||
snmp Alert configured.
|
can see the configured SNMP Alerts.
|
||||||
</para>
|
</para>
|
||||||
<graphic scale='70' fileref="images/SNMP_alert.png"
|
<graphic scale='70' fileref="images/SNMP_alert.png"
|
||||||
valign="bottom" align="center"/>
|
valign="bottom" align="center"/>
|
||||||
<para> -
|
<para> -
|
||||||
To create a new alert the administrator must click in
|
To create a new alert the administrator must click in
|
||||||
<inlinegraphic scale='50'
|
<inlinegraphic scale='50'
|
||||||
fileref="images/SNMP_alert_create.png"/>. Then appear the
|
fileref="images/SNMP_alert_create.png"/>. Then appears the
|
||||||
following screen:
|
following screen:
|
||||||
</para>
|
</para>
|
||||||
<graphic scale='70' fileref="images/SNMP_alert_create1.png"
|
<graphic scale='70' fileref="images/SNMP_alert_create1.png"
|
||||||
|
|
|
@ -287,23 +287,24 @@
|
||||||
<sect1 id="sec4.5">
|
<sect1 id="sec4.5">
|
||||||
<title>Messages</title>
|
<title>Messages</title>
|
||||||
<para>
|
<para>
|
||||||
In Pandora 1.2 is possible send messages to others user. Each user can
|
In Pandora 1.2 it is possible to send messages to others user.
|
||||||
see his/her messages in Operation, Messages.
|
Each user can see his/her messages in "Messages" in the Operation
|
||||||
|
menu.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<graphic scale='80' fileref="images/messages.png" valign="bottom"
|
<graphic scale='80' fileref="images/messages.png" valign="bottom"
|
||||||
align="center"/>
|
align="center"/>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
To send a message to other user you must click in Operation, Messages,
|
To send a message to other user you must click in "Messages" >
|
||||||
"New mesage"
|
"New mesage" in the Operation menu.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<graphic scale='80' fileref="images/messages1.png" valign="bottom"
|
<graphic scale='80' fileref="images/messages1.png" valign="bottom"
|
||||||
align="center"/>
|
align="center"/>
|
||||||
<para>
|
<para>
|
||||||
Is possible send a mmesage a group in Operation, Messages, Messages to
|
It is possible to send a message to a group from "Messages to groups"
|
||||||
group.
|
> "New mesage" in the Operation menu.
|
||||||
</para>
|
</para>
|
||||||
<graphic scale='80' fileref="images/messages2.png" valign="bottom"
|
<graphic scale='80' fileref="images/messages2.png" valign="bottom"
|
||||||
align="center"/>
|
align="center"/>
|
||||||
|
|
|
@ -110,7 +110,7 @@
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Total events divided by the group the agent raising
|
Total events divided by the group the agent that launched
|
||||||
the event belongs to
|
the event belongs to
|
||||||
<graphic fileref="images/image048.png" valign="bottom"
|
<graphic fileref="images/image048.png" valign="bottom"
|
||||||
align="center"/>
|
align="center"/>
|
||||||
|
|
|
@ -10,8 +10,8 @@
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
The system audit includes actions that somehow try to by pass the
|
The system audit includes actions that somehow try to by pass the
|
||||||
security system: attempts to delete an incident by an unauthorised
|
security system: attempts to delete an incident by an unauthorized
|
||||||
user, attemps to change user profiles by unauthoried users, etc.
|
user, attempts to change user profiles by unauthorized users, etc.
|
||||||
Its main function is, however, to trace the user connections
|
Its main function is, however, to trace the user connections
|
||||||
(login/logout).
|
(login/logout).
|
||||||
</para>
|
</para>
|
||||||
|
|
|
@ -6,8 +6,8 @@
|
||||||
Data Server or SNMP Server.
|
Data Server or SNMP Server.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Is posible manage the Pandora Servers in "Manage Servers" option of the
|
It is possible to manage the Pandora Servers from the "Manage Servers"
|
||||||
Administration menu.
|
option of the Administration menu.
|
||||||
</para>
|
</para>
|
||||||
<graphic scale='60' fileref="images/Servers.png" valign="bottom"
|
<graphic scale='60' fileref="images/Servers.png" valign="bottom"
|
||||||
align="center"/>
|
align="center"/>
|
||||||
|
@ -74,18 +74,18 @@
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Action:</emphasis> Icons to modify a server´s properties or
|
<emphasis>Action:</emphasis> Icons to modify a server's properties or
|
||||||
to delete a server.
|
to delete a server.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
<para>
|
<para>
|
||||||
Is posible delete a with the icon <inlinegraphic
|
It is possible delete a server using the icon <inlinegraphic
|
||||||
fileref="images/cancel.png"/>
|
fileref="images/cancel.png"/>
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Is posible change the server´s propirties with the icon <inlinegraphic
|
It is posible to change the server's properties using the icon
|
||||||
fileref="images/config.png"/>
|
<inlinegraphic fileref="images/config.png"/>
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
In a Server is posiible modify: Name, IP Address and Description.
|
In a Server is posiible modify: Name, IP Address and Description.
|
||||||
|
|
|
@ -13,7 +13,7 @@
|
||||||
<para>
|
<para>
|
||||||
It is obvious that the efficiency and reliability of this
|
It is obvious that the efficiency and reliability of this
|
||||||
module is vital for the correct functioning of Pandora.
|
module is vital for the correct functioning of Pandora.
|
||||||
A regular data base maintainance is needed. To do so the data base
|
A regular data base maintenance is needed. To do so the data base
|
||||||
managers can use standard MySQL commands. Maintaining Pandora database
|
managers can use standard MySQL commands. Maintaining Pandora database
|
||||||
in good condition is critital for Pandora to work properly.
|
in good condition is critital for Pandora to work properly.
|
||||||
</para>
|
</para>
|
||||||
|
@ -63,8 +63,8 @@
|
||||||
"View Agents" > "Statistics" in the Operation menu.
|
"View Agents" > "Statistics" in the Operation menu.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Is posible to view the Data Base information in mode text pich in the
|
It is possible to view the Data Base information in text mode
|
||||||
link "Press here to get DB Info as text"
|
pressing "Press here to get DB Info as text"
|
||||||
</para>
|
</para>
|
||||||
<graphic scale='70' fileref="images/DBText.png" valign="bottom"
|
<graphic scale='70' fileref="images/DBText.png" valign="bottom"
|
||||||
align="center"/>
|
align="center"/>
|
||||||
|
@ -74,7 +74,7 @@
|
||||||
<para>
|
<para>
|
||||||
Pandora counts with powerful tools for the Administrator to manually
|
Pandora counts with powerful tools for the Administrator to manually
|
||||||
purge the majority of data stored in the Database. This includes data
|
purge the majority of data stored in the Database. This includes data
|
||||||
generated by both the agents and the own server.
|
generated by both the agents and the server by its own.
|
||||||
</para>
|
</para>
|
||||||
<sect2 id="sec8.2.1">
|
<sect2 id="sec8.2.1">
|
||||||
<title>Agent's data purge</title>
|
<title>Agent's data purge</title>
|
||||||
|
@ -113,7 +113,7 @@
|
||||||
<title>Purging all the agent's data</title>
|
<title>Purging all the agent's data</title>
|
||||||
<para>
|
<para>
|
||||||
All the out of range data received by an agent can be deleted
|
All the out of range data received by an agent can be deleted
|
||||||
from the "DB Maintainance">"Database Purge" option in the
|
from the "DB Maintenance" > "Database Purge" option in the
|
||||||
Administration menu.
|
Administration menu.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
|
|
|
@ -15,7 +15,7 @@
|
||||||
<emphasis>Language:</emphasis> In following versions or
|
<emphasis>Language:</emphasis> In following versions or
|
||||||
revisions of the actual Pandora version will support more
|
revisions of the actual Pandora version will support more
|
||||||
languages. At the moment version 1.2 supports English, Spanish,
|
languages. At the moment version 1.2 supports English, Spanish,
|
||||||
Spanish Latin-AMerica Bable, Italian, French, Catalan and
|
Spanish Latin-America, Bable, Italian, French, Catalan and
|
||||||
Portuguese of Brazil.
|
Portuguese of Brazil.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
|
@ -52,17 +52,17 @@
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Graph order:</emphasis> This value represents the order
|
<emphasis>Graph order:</emphasis> This value represents the order
|
||||||
to create the graphs. The posibility are Righ to left, or left to
|
to create the graphs. The possibility are right to left, or left to
|
||||||
right.
|
right.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Truetype fonts:</emphasis> This value represents the
|
<emphasis>Truetype fonts:</emphasis> This value represents the
|
||||||
capacity to active the truetypefonts.The posibility are Active or
|
capacity to active the truetypefonts. The possible values are
|
||||||
Disable.
|
Active or Disable.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Background image:</emphasis> This value represents the
|
<emphasis>Background image:</emphasis> This value represents the
|
||||||
image to background, is possibel change it bettwen severaql
|
image to background, it is possible to change it between several
|
||||||
different images.
|
different images.
|
||||||
</para>
|
</para>
|
||||||
<sect1 id="sec9.1">
|
<sect1 id="sec9.1">
|
||||||
|
|
|
@ -4,9 +4,9 @@
|
||||||
<sect1 id="prereq">
|
<sect1 id="prereq">
|
||||||
<title>Prerequisites</title>
|
<title>Prerequisites</title>
|
||||||
<para>
|
<para>
|
||||||
&pandora; is not only a single app, its composed by
|
&pandora; is not only a single app, it is made up by
|
||||||
several shellscript files (Unix Agents), a WEB application in
|
several shellscript files (Unix/Linux Agents), a WEB application
|
||||||
PHP (Console), some code in C++ (Windows Agent), some code in
|
in PHP (Console), some code in C++ (Windows Agent), some code in
|
||||||
PERL5 (Server) and some structure and data in SQL (Database),
|
PERL5 (Server) and some structure and data in SQL (Database),
|
||||||
so, to get all this running you need to have some pieces of
|
so, to get all this running you need to have some pieces of
|
||||||
software installed in your system. This is a list of packages,
|
software installed in your system. This is a list of packages,
|
||||||
|
@ -16,10 +16,10 @@
|
||||||
<sect1 id="servers">
|
<sect1 id="servers">
|
||||||
<title>Pandora Servers</title>
|
<title>Pandora Servers</title>
|
||||||
<para>
|
<para>
|
||||||
Pandora 1.2 has three kind of servers: Data server, Network
|
Pandora FMS 1.2 has three kind of servers: Data server, Network
|
||||||
Server and SNMP Server/Trap console. All of them could be
|
Server and SNMP Server/Trap console. All of them could be
|
||||||
installed in the same machine or in different machines, also,
|
installed in the same machine or in different machines, also,
|
||||||
you could setup many of them in a High Availability enviroment
|
you could setup many of them in a High Availability environment
|
||||||
or using it to manage highs loads of data.
|
or using it to manage highs loads of data.
|
||||||
</para>
|
</para>
|
||||||
<sect2 id="dataserver"><title>Pandora Data Server</title>
|
<sect2 id="dataserver"><title>Pandora Data Server</title>
|
||||||
|
@ -51,16 +51,9 @@
|
||||||
You can find them at http://www.cpan.org or install using your
|
You can find them at http://www.cpan.org or install using your
|
||||||
default package instalation system. These packages are in the
|
default package instalation system. These packages are in the
|
||||||
default distribution of Suse 9.1 and Debian 3.0 GNU/Linux. Also
|
default distribution of Suse 9.1 and Debian 3.0 GNU/Linux. Also
|
||||||
available for Solaris in CPAN repository. If you use Windows go
|
available for Solaris in CPAN repository.
|
||||||
to http://ppm.activestate.com. Or you can use the ppm tool to
|
|
||||||
download the modules:
|
|
||||||
<programlisting>
|
|
||||||
ppm install DBI
|
|
||||||
ppm install DBD-mysql
|
|
||||||
ppm install Datemanip
|
|
||||||
</programlisting>
|
|
||||||
Next, you need to set the TZ (Time Zone) environment
|
Next, you need to set the TZ (Time Zone) environment
|
||||||
variable. In Windows: set TZ=WET (for example)
|
variable.
|
||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
|
@ -129,7 +122,7 @@
|
||||||
<filename>pandora_server_1.2.tar.gz</filename> file.
|
<filename>pandora_server_1.2.tar.gz</filename> file.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Create an user pandora in OS. Usually you do that (in GNU/Linux)
|
Create an user pandora in OS. Usually you do that in GNU/Linux
|
||||||
with commands:
|
with commands:
|
||||||
<programlisting>
|
<programlisting>
|
||||||
useraddd pandora -d /home/pandora
|
useraddd pandora -d /home/pandora
|
||||||
|
@ -179,11 +172,7 @@
|
||||||
dbhost localhost
|
dbhost localhost
|
||||||
</programlisting>
|
</programlisting>
|
||||||
Please change them to your own data. For security reasons isn't
|
Please change them to your own data. For security reasons isn't
|
||||||
recommended use the default values. If you run Pandora Server in
|
recommended use the default values.
|
||||||
Windows, you need to use the backslash twice in $dirname, that is:
|
|
||||||
"\\", for example: my
|
|
||||||
$dirname="C:\\pandora\\pandora_server\\data_in";, not needed in
|
|
||||||
$log_file.
|
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
These are default values, and all must be existing directory and
|
These are default values, and all must be existing directory and
|
||||||
|
@ -193,7 +182,7 @@
|
||||||
Remember: you need to create the directory /opt/pandora/data_in
|
Remember: you need to create the directory /opt/pandora/data_in
|
||||||
where Pandora Server will read and write data, sent by remote
|
where Pandora Server will read and write data, sent by remote
|
||||||
agents using ssh/scp. This directory must be owned or with
|
agents using ssh/scp. This directory must be owned or with
|
||||||
permissions to write for user "pandora". If you dont have a
|
permissions to write for user "pandora". If you don't have a
|
||||||
"pandora" user yet, create it.
|
"pandora" user yet, create it.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
|
@ -302,10 +291,6 @@
|
||||||
cat pandoradb.sql | mysql -D pandora -u root -p
|
cat pandoradb.sql | mysql -D pandora -u root -p
|
||||||
cat pandoradb_data.sql | mysql -D pandora -u root -p
|
cat pandoradb_data.sql | mysql -D pandora -u root -p
|
||||||
</programlisting>
|
</programlisting>
|
||||||
<para>
|
|
||||||
Note: if your system is Windows, use the command type instead of
|
|
||||||
cat.
|
|
||||||
</para>
|
|
||||||
<para>
|
<para>
|
||||||
You can also use the source command, if you are connected to
|
You can also use the source command, if you are connected to
|
||||||
MySQL, from the MySQL prompt:
|
MySQL, from the MySQL prompt:
|
||||||
|
@ -317,9 +302,7 @@
|
||||||
</programlisting>
|
</programlisting>
|
||||||
<para>
|
<para>
|
||||||
This example is valid using root user in
|
This example is valid using root user in
|
||||||
MySQL<footnote><para>Remember if you're in Windows use the
|
MySQL
|
||||||
double slash ("//") with the path to the files, not the
|
|
||||||
backslash ("\").</para></footnote>
|
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Now we will create an user "pandora" and will be given to it
|
Now we will create an user "pandora" and will be given to it
|
||||||
|
@ -340,15 +323,14 @@
|
||||||
authenticating Web Console, you have to change the way the
|
authenticating Web Console, you have to change the way the
|
||||||
password is stored into the database:
|
password is stored into the database:
|
||||||
<programlisting>
|
<programlisting>
|
||||||
mysql> set password for 'babel'@'localhost' = old_password('babel');
|
mysql> set password for 'pandora'@'localhost' = old_password('pandora');
|
||||||
</programlisting>
|
</programlisting>
|
||||||
Please note this user will be used by several babel
|
Please note this user will be used by several pandora
|
||||||
subcomponents(babel Server, babel Web Console) to access
|
subcomponents (Pandora Server, Pandora Web Console) to access
|
||||||
database.
|
database.
|
||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
|
|
||||||
<sect2 id="console_install">
|
<sect2 id="console_install">
|
||||||
<title>Pandora console install.</title>
|
<title>Pandora console install.</title>
|
||||||
<para>Prior to install Pandora console, you need the following
|
<para>Prior to install Pandora console, you need the following
|
||||||
|
@ -486,7 +468,7 @@
|
||||||
They are developed to work under a given platform, making use of
|
They are developed to work under a given platform, making use of
|
||||||
the specific tools of the language being used: VBSCript/Windows
|
the specific tools of the language being used: VBSCript/Windows
|
||||||
Scripting for Microsoft platforms (Win2000, WinXP y Win2003),
|
Scripting for Microsoft platforms (Win2000, WinXP y Win2003),
|
||||||
ShellScripting for UNIX - which includes Linux, Solaris, AIX, HPUX
|
ShellScripting for UNIX - which includes Linux, Solaris, AIX, HP-UX
|
||||||
and BSD, as well as the Nokia's IPSO. Pandora agents can be
|
and BSD, as well as the Nokia's IPSO. Pandora agents can be
|
||||||
developed in virtually any language, given its simple API system
|
developed in virtually any language, given its simple API system
|
||||||
and being open source. There are branches of the Pandora project
|
and being open source. There are branches of the Pandora project
|
||||||
|
|
|
@ -1,25 +1,25 @@
|
||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<chapter>
|
<chapter>
|
||||||
<title>Introduction to Pandora</title>
|
<title>Introduction to Pandora FMS</title>
|
||||||
<sect1><title>Pandora. The Free monitoring system</title>
|
<sect1><title>Pandora. The Free Monitoring System</title>
|
||||||
<para>
|
<para>
|
||||||
Pandora is a monitoring application to watch systems and
|
Pandora FMS is a monitoring application to watch systems and
|
||||||
applications. Pandora allows to know the status of any element of
|
applications. Pandora allows to know the status of any element of
|
||||||
your bussiness systems. Pandora watch for your hardware, your
|
your bussiness systems. Pandora watch for your hardware, your
|
||||||
software, your multilayer system and of course your Operating
|
software, your multilayer system and of course your Operating
|
||||||
System. Pandora could detect a network interface down and the
|
System. Pandora could detect a network interface down and the
|
||||||
movement of any value of the NASDAQ new technology market. If you
|
movement of any value of the NASDAQ new technology market. If you
|
||||||
want, Pandora could sent a SMS message when your systems
|
want, Pandora could sent a SMS message when your systems
|
||||||
fails... or when Google value low below 330$.
|
fails... or when Google value low below US$ 330.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
Pandora adapt, like an octopus, to your systems and requirements,
|
Pandora FMS will adjust, like an octopus, to your systems and
|
||||||
because has been designed to be open, modular, multiplattform and
|
requirements, because it has been designed to be open, modular,
|
||||||
easy to customize.
|
multiplattform and easy to customize.
|
||||||
</para>
|
</para>
|
||||||
</sect1>
|
</sect1>
|
||||||
<sect1>
|
<sect1>
|
||||||
<title>Introducing Pandora.</title>
|
<title>Introducing Pandora FMS.</title>
|
||||||
<para>
|
<para>
|
||||||
&pandora; is a monitoring tool that allows a system
|
&pandora; is a monitoring tool that allows a system
|
||||||
administrator to visually analise the status and efficiency of
|
administrator to visually analise the status and efficiency of
|
||||||
|
@ -90,13 +90,13 @@
|
||||||
the information Pandora needs to work - agent data,
|
the information Pandora needs to work - agent data,
|
||||||
settings, user information, incidents, system settings,
|
settings, user information, incidents, system settings,
|
||||||
etc. The system can use a MySQL cluster to store the
|
etc. The system can use a MySQL cluster to store the
|
||||||
information, or a high disponibility solution for larger
|
information, or a High Availability (HA) solution for larger
|
||||||
sytems.
|
sytems.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
This database can work with any of the platform officially
|
This database can work with any of the platform officially
|
||||||
supported by MySQL. Pandora can be implemented with MySQL
|
supported by MySQL. Pandora can be implemented with MySQL
|
||||||
versions 3.0 and 4.0, although the latest is recommended.
|
versions from 3.0 to 5.0, although the latest is recommended.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
|
@ -114,7 +114,7 @@
|
||||||
AIX, HP-UX and BSD, as well as the Nokia's IPSO. Pandora
|
AIX, HP-UX and BSD, as well as the Nokia's IPSO. Pandora
|
||||||
agents can be developed in virtually any language, given its
|
agents can be developed in virtually any language, given its
|
||||||
simple API and being open source. Windows agent are
|
simple API and being open source. Windows agent are
|
||||||
developed in a free development enviroment for C++ and uses
|
developed in a free development environment for C++ and uses
|
||||||
the same interface and modularity than Unix agents.
|
the same interface and modularity than Unix agents.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
|
@ -261,7 +261,7 @@
|
||||||
<para>
|
<para>
|
||||||
The XML data file generated by every agent is the core of
|
The XML data file generated by every agent is the core of
|
||||||
Pandora. This file has the information gathered by the Agent. Its
|
Pandora. This file has the information gathered by the Agent. Its
|
||||||
easy structure allows that any user could create it's own
|
easy structure allows that any user could create its own
|
||||||
developments to be processed in Pandora, or use the included ones.
|
developments to be processed in Pandora, or use the included ones.
|
||||||
An example of the information included into the data file is the
|
An example of the information included into the data file is the
|
||||||
following one:
|
following one:
|
||||||
|
@ -338,8 +338,8 @@
|
||||||
<para>
|
<para>
|
||||||
<emphasis>Pandora SNMP Server</emphasis>. This is a PERL
|
<emphasis>Pandora SNMP Server</emphasis>. This is a PERL
|
||||||
application that parse output from standard snmptradp (we
|
application that parse output from standard snmptradp (we
|
||||||
provide one binary for snmptrapd, but its possible you need
|
provide one binary for snmptrapd, but it is possible that
|
||||||
to replace it with a binary that runs better in your
|
you need to replace it with a binary that runs better in your
|
||||||
system). This daemon receives SNMP traps, and Pandora SNMP
|
system). This daemon receives SNMP traps, and Pandora SNMP
|
||||||
Server stores in database and fire alerts assigned in
|
Server stores in database and fire alerts assigned in
|
||||||
Pandora SNMP Console.
|
Pandora SNMP Console.
|
||||||
|
|
|
@ -28,7 +28,7 @@
|
||||||
<para>
|
<para>
|
||||||
Read documentation about new features of Pandora 1.2.
|
Read documentation about new features of Pandora 1.2.
|
||||||
Migration process doesnt delete any data, you don't loss any
|
Migration process doesnt delete any data, you don't loss any
|
||||||
agente, config, or enviroment data, but please, read
|
agente, config, or environment data, but please, read
|
||||||
_carefully_ all documentation about this process before
|
_carefully_ all documentation about this process before
|
||||||
trying it.
|
trying it.
|
||||||
</para>
|
</para>
|
||||||
|
|
|
@ -32,7 +32,7 @@
|
||||||
<releaseinfo>&pandora_version;</releaseinfo>
|
<releaseinfo>&pandora_version;</releaseinfo>
|
||||||
<edition>First Edition(&pandora_version;)</edition>
|
<edition>First Edition(&pandora_version;)</edition>
|
||||||
<pubdate>
|
<pubdate>
|
||||||
November 19th, 2006</pubdate>
|
November 21st, 2006</pubdate>
|
||||||
<keywordset>
|
<keywordset>
|
||||||
<keyword>pandora user manual</keyword>
|
<keyword>pandora user manual</keyword>
|
||||||
</keywordset>
|
</keywordset>
|
||||||
|
@ -48,18 +48,23 @@
|
||||||
</legalnotice>
|
</legalnotice>
|
||||||
<revhistory>
|
<revhistory>
|
||||||
<revision>
|
<revision>
|
||||||
|
<revnumber>1.2</revnumber>
|
||||||
|
<date>21 November 2006</date>
|
||||||
|
<revremark>Submitted.</revremark>
|
||||||
|
</revision>
|
||||||
|
<revision>
|
||||||
<revnumber>1.1</revnumber>
|
<revnumber>1.1</revnumber>
|
||||||
<date>10 October 2006</date>
|
<date>10 October 2006</date>
|
||||||
<revremark>Submitted.</revremark>
|
<revremark>Submitted.</revremark>
|
||||||
</revision>
|
</revision>
|
||||||
<revision>
|
<revision>
|
||||||
<revnumber>1.0</revnumber>
|
<revnumber>1.0</revnumber>
|
||||||
<date>11 Sept 2006</date>
|
<date>11 September 2006</date>
|
||||||
<revremark>Submitted.</revremark>
|
<revremark>Submitted.</revremark>
|
||||||
</revision>
|
</revision>
|
||||||
<revision>
|
<revision>
|
||||||
<revnumber>0.1</revnumber>
|
<revnumber>0.1</revnumber>
|
||||||
<date>11 Sept 2006</date>
|
<date>11 September 2006</date>
|
||||||
<revremark>First draft for review.</revremark>
|
<revremark>First draft for review.</revremark>
|
||||||
</revision>
|
</revision>
|
||||||
</revhistory>
|
</revhistory>
|
||||||
|
|
Loading…
Reference in New Issue