diff --git a/pandora_doc/en/pandora_advanced.xml b/pandora_doc/en/pandora_advanced.xml index 823973eadb..adf7204c98 100644 --- a/pandora_doc/en/pandora_advanced.xml +++ b/pandora_doc/en/pandora_advanced.xml @@ -1,7 +1,7 @@ - Pandora. Advanced section - Pandora High availabilty features + Pandora FMS advanced section + Pandora FMS High Availability features You may setup Pandora for use HA in several scenarios: @@ -9,17 +9,17 @@ Database Clustering for HA. You need to 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 - tested and works fine, but you need some advanced knowledgue - for MySQL Clustering administration. + tested and works fine, but you need some advanced knowledge + about MySQL Clustering administration. Multiple Pandora Console. It's easy, 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. @@ -103,13 +103,13 @@ Data compression based on interpolation and data purge, makes a smaller database, but this was not enought. Production systems has 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. 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 - 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, incremental, boolean and string. @@ -125,11 +125,11 @@ Changes come with some different ways to reading data. With new 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 - changes. You will have a graph with a perfect horizontal - line. Pandora, if doesnt receive new values, thinks that is no new - values, and everything seems to be equal that in the last + changes. You will have a graph with a perfect horizontal + line. Pandora, if doesn't receive new values, thinks that there + are no new values, and everything seems to be equal that in the last notification. @@ -138,8 +138,8 @@ - This would be the equivalent graph for the same data, excepting a - conexión failure, from 05:55 to 15:29 aproximately. + This would be the equivalent graph for the same data, except a + connection failure, from 05:55 to 15:29 aproximately. diff --git a/pandora_doc/en/pandora_chapter1.xml b/pandora_doc/en/pandora_chapter1.xml index 952ba6d53f..e64a39046b 100644 --- a/pandora_doc/en/pandora_chapter1.xml +++ b/pandora_doc/en/pandora_chapter1.xml @@ -3,10 +3,10 @@ Introduction - What is Pandora? + What is Pandora FMS? - 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 Systems, Servers, Applications and Hardware Systems - such as firewalls, proxies, databases, Web servers, tunnelling servers, @@ -46,18 +46,18 @@ - Core Server: Pandora Core server is the receptor of the data packages and generates the alerts - it is the brain of the system. Several servers can work alongside for - larger systems. It has been developed in Perl and works over + larger systems. It has been developed in Perl and works over any platform, although, the official platform is GNU/Linux. The core server accesses Pandora database, which is shared with the Web server, and stores the processed data packages. The - server is executed under the name of "Demonio", and processes - the packages stored in its file system. The data is generated + server is executed under the name of "Demon", and processes + the packages stored in its file system. The data is generated by the system agents. Despite the server's low system resources comsumption and simple installation and operation, the core - server is the most critical element of the system. The core + server is the most critical element of the system. The core server receives and processes the produced data, and fires the alerts and the events. @@ -67,8 +67,8 @@ system only supports MySQL. The central database keeps all the information Pandora needs to work - agent data, settings, user information, incidents, system settings, etc. The system can use - a MySQL cluster to store the information, or a high - disponibility solution for larger sytems. + a MySQL cluster to store the information, or a High + Availability (HA) solution for larger sytems. @@ -89,7 +89,7 @@ They have been developed to work under a specific platform, making use of the specific tools of the used language: 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 IPSO. Pandora agents can be developed in virtually any language, given its simple API and being open source. diff --git a/pandora_doc/en/pandora_chapter2.xml b/pandora_doc/en/pandora_chapter2.xml index ac5df8f7b2..0946bf83ee 100644 --- a/pandora_doc/en/pandora_chapter2.xml +++ b/pandora_doc/en/pandora_chapter2.xml @@ -4,7 +4,7 @@ A user is based on the user's daily activity. Each user have his/her profile, with a list of actions that can or cannot perform, to access - to Pandora.One or more profiles can be assigned to a single user. + to Pandora. One or more profiles can be assigned to a single user. @@ -24,7 +24,7 @@ access Pandora as well as what each user can do. Groups define elements in common among various users. Each user could be in one or more groups at any one time. Each group has user profiles which - are defined and attached to it. A profile is a list of things a + are defined and attached to it. A profile is a list of things a user can do, such as view incidents, manage database or other. @@ -112,7 +112,7 @@ Adding a user - A user is added clicking on "Manage Users">"Create user" + A user is added clicking on "Manage Users" > "Create user" in the Administration Menu diff --git a/pandora_doc/en/pandora_chapter3.xml b/pandora_doc/en/pandora_chapter3.xml index 157b91673c..e3cce47fa0 100644 --- a/pandora_doc/en/pandora_chapter3.xml +++ b/pandora_doc/en/pandora_chapter3.xml @@ -5,30 +5,30 @@ Agents - The agents collect information. There are agent based on a software - agent and install in the System to monitor, and network agent, a + The agents collect information. There are agents based on a software + agent and installed in the System to monitor, and network agents - a non-physical agent, without need of installing any software, that - execute network tasks in Pandora Network servers, and showing - information on console inside an Agent. + execute network tasks in Pandora Network servers and shows + information on console. - For agents who need to install software onto remote systems, - public key of the machine to be monitored needs to be copied onto - Pandora Data server to be able to collect data, as it's specified + For agents who need to install software into remote systems, + public key of the machine to be monitored needs to be copied into + Pandora Data server to be able to collect data, as it is specified in detail in Pandora Install documentation. Data collected from the agents are stored in small pieces of - information called "modules". Each module store only a kind of - data. Value of each module is the value of one monitored - variable. The agent must be activated in Pandora's server and a - group assigned to the agent. The data starts then been + information called "modules". Each module stores only a kind of + data. The value of each module is the value of one monitored + variable. The agent must be activated in Pandora Server and a + group assigned to the agent. The data then begin to be consolidated in the database and can be accessed. A network agent NEEDs to be assigned to a Network Server to 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 to an Agent. @@ -61,7 +61,7 @@ - Export tabular data in CSV format. + Export tabular data in CSV format. @@ -72,19 +72,20 @@ Pandora groups are common to agents, incidents and profiles. Groups are added in "Manage Profiles" > "Manage - Groups", Administration menu. + Groups" in the Administration menu. - There are several default groups defined in Pandora. You also can + + 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). - You can also modify default ones. + You can also modify default ones. + - A group is added by clicking "Create group" and assigning a name - to it. + A group is added by clicking "Create group" and assigning a name to it. A group is deleted by clicking the delete icon @@ -95,18 +96,18 @@ Adding an agent - 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 on software installed in a remote machine), or from Network - Agents (assined to a Network Server who run network tasks to - monitorize remote systems). You also mix both types of module in - the same agent. + Agents (assined to a Network Server who runs network tasks to + monitor remote systems). You can also mix both types of module + in the same agent. Please remember that a network agent NEEDs to be assigned to a - Network Server to execute network tasks. If you cannot see any - Network Servers it's because you has not executed any Network - Servers. Please configure and run a Network Server before trying + Network Server to execute network tasks. If you can't see any + Network Servers it's because you don't have any Network Server + running. Please configure and run a Network Server before trying to assign a network module to an Agent. @@ -118,8 +119,7 @@ align="center"/> - To add a new agent the following parameters must be - configured: + To add a new agent the following parameters must be configured: @@ -134,36 +134,35 @@ IP Address: IP address of an agent. An - agent can share its IP address with other agents. Its only - for informational purposes. In network agents its useful, - because use this IP address for all new network module - definition by default. + agent can share its IP address with other agents. It's only + used for informational purposes. In network agents it's useful, + because the Server uses this IP address for all new + network module definition by default. Group: 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. Interval: Execution interval of an - agent. It is the time elapsed in seconds, between two - executions. An agent could have a defined interval, but - could have modules with different (bigger or smaller) - intervals. An agent its considered "down" (not responding) - when Pandora servers (any of them) has no contact with agent - in Interval x 2 seconds. + agent. It is the time elapsed in seconds between two + consecutive agent executions. An agent could have a + defined interval, but could have modules with different + (bigger or smaller) intervals. An agent is considered + "down" (not responding) when Pandora servers (any of them) + has no contact with agent in Interval x 2 seconds. OS: The Operating System to be monitored. The supported Operating Systems are: AIX, BeOS, - BSD, Cisco, HPUX, Linux, MacOS, Other, Solaris, - Windows. + BSD, Cisco, HP-UX, Linux, MacOS, Other, Solaris, Windows. @@ -183,7 +182,7 @@ by the agent are accepted. If modules are not defined, they are automatically defined by the system. It is recommended to activate the agents in this mode and change it once the - user is familiar with the system. + user is familiar with Pandora FMS. @@ -207,14 +206,14 @@ Pandora's agents use the operating system own commands to 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". If the agent had been added in "normal mode", the modules to be monitored should have been assigned. Those modules must be configured in the agent configuration file. - The modules to be processed by Pandora's server are + The modules to be processed by Pandora Server are assigned in the "Manage Agents" option, Administration menu. A list with all the agents in Pandora will be shown here. @@ -226,7 +225,7 @@ align="center"/> - 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: Module type: type of module,there are the @@ -250,9 +249,9 @@ generic_data_proc: Boolean data type: 0 means False or "bad values", and 1 means True or "good" value. Generic Proc types are also called "monitors" - because could say if something is "ok" or is "wrong". Are - displayed in agent view as little lamps. Red if 0, Green - is 1. + because could say if something is "ok" or is "wrong". They + Are displayed in agent view as little lamps. Red if 0, Green + if 1. @@ -285,7 +284,7 @@ SEND" (you can use the macro ^M to send carriage returns) and wait to receive string defined in "TCP RECEIVE". If Pandora Network Server received TCP RECEIVE string, it - returns 1 (ok), else return 0 (wrong). + returns 1 (ok), else returns 0 (wrong). @@ -293,18 +292,18 @@ generic_tcp_data: generic_tcp_string, generic_tcp_inc, 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. - generic_snmp types:: they obtain - informacion using SNMP interface. If you enter SNMP - community, and IP address, you can walk SNMP MIB from + generic_snmp types:: they get + information using SNMP interface. If you enter SNMP + community and IP address, you can walk SNMP MIB from target using SNMP v1 protocol, and all MIB variables will - be listed to allow you choose one. You also can enter MIB - using numerical OID or human - comprenhensive format. + be listed to allow you choose one. You can also enter MIB + using numerical OID or human - understandable format. @@ -316,30 +315,30 @@ - Module Group: Is possible group the module - in the following groups: General, Networking, Application, - System and Misscellaneous: + Module Group: It is possible to group + modules in the following groups: General, Networking, + Application, System and Misscellaneous: Module Name: Name of the module. - Module Interval: Interval of time, in seconds - that the agent wait between each run. + Module Interval: Interval of time in seconds + that the agent waits between two consecutive executions. Target IP: IP of the agent. - TCP port: TCP port to monitor, is possible - configure UDP port if the module type generic_udp_proc is choose. + TCP port: TCP port to monitor, it is possible + to configure UDP port if the module type generic_udp_proc is chosen. SNMP OID: 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. - SNMP Community: Community neccesary to monitor + SNMP Community: Community necessary to monitor a SNMP OID. @@ -347,13 +346,13 @@ TCP receive: Field to configure the - parameters which we hope receive in a TCP conexion. + parameters which we expect to receive in a TCP connection. Maximum:: Upper threshold for the value in the module. Any value above this threshold will - be taken as invalid and the whole module will be - discarded. + be taken as invalid and the whole module will be + discarded. Minimum:: Lower threshold for the @@ -366,16 +365,16 @@ module. - All the modules to be monitored by an agent can be reviewed by - accessing the agent in the "Manage Agents" option, - Administration menu. + All the modules to be monitored by an agent can be reviewed + by accessing the agent in the "Manage Agents" option, + Administration menu. - In this screen the modules can be: + In this screen the modules can be: @@ -393,19 +392,19 @@ - However, the type of data of the module can't be modified. + However, the type of data of the module can't be modified. Alerts - 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 + An alert is Pandora's reaction to an "out of range" module + value. The Alert can consist of sending an e-mail or SMS to the administrator, sending a SNMP trap, write the incident - into the system syslog or Pandora log file, etc. And basically - anything that can be triggered by a script configured in - Pandora's Operating System. + into the system syslog or Pandora log file, etc. Basically, + it's anything that can be triggered by a script configured + in the Operating System where Pandora Servers run. Adding an Alert @@ -431,23 +430,23 @@ LogFile. Writes the incident in the log file - + SMS Text. Sends an SMS to a given mobile phone - + SNMP Trap. Sends a SNMP Trap - + Syslog. Sends an alert to the Syslog - + @@ -538,13 +537,13 @@ Assigning Alerts - 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 - defined, it is time to assign those Alerts to the agent. + defined, is to assign those alerts to the agent. - 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. The Alert Assignation form is placed at the bottom of that page. @@ -554,7 +553,7 @@ valign="bottom" align="center"/> - To assign an Alert the next fields must be filled in: + To assign an alert the next fields must be filled in: @@ -589,19 +588,19 @@ Field #1 (Alias, name): Define the used value for the "_field1_" variable. - + Field #2 (Single Line): Define the used value for the "_field2_" variable. - + Field #3 (Full Text): Define the used value for the "_field3_" variable. - + @@ -613,9 +612,9 @@ - Min number of alerts: Minimun number - of alerts that can be sent consecutively. - + Min number of alerts: Minimun number + of alerts that can be sent consecutively. + @@ -660,7 +659,7 @@ module and/or alert configuration from the selected source agents to the selected destination agents. Several agents can be selected, pressing CTRL and the mouse right button - simultaneously. The two tick boxes at the top of the form + simultaneously. The two tick boxes at the top of the form will be used to specify if the configuration to copy is from modules and/or from alerts. @@ -699,7 +698,7 @@ Agent monitoring - 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 the data in the Database. The data are consolidated and can be 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. - 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 - thanks to a simple system coloured circles and windows taht - appaer when the user pass the mouse on a group. + thanks to a simple system coloured circles and windows that + appear when the user pass the mouse on a group. @@ -756,7 +755,7 @@ - All the monitors OK. It's the ideal status. + All the monitors are OK. It's the ideal status. @@ -797,17 +796,17 @@ - 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. - Last contact: Shows the time and date of + Last contact: Shows date and time of the last data package sent by the agent, using a progress bar, according to value of the interval. If you see the image , the agent has not send data during the interval. Passing the mouse over the image will show you the last contact - in time and date format. + in date and time format. Note: The icon Accessing the data of an agent - When an agent is accessed, by clicking on its name, all the - information related to that agent is displayed. + + When an agent is accessed, by clicking on its name, all the + information related to that agent is displayed. + Agent general info @@ -937,7 +938,7 @@ defined. - Type: Data type of the monitor. For a ç + Type: Data type of the monitor. For a monitor this value is always of the generic_proc type. @@ -1100,13 +1101,14 @@ A graph with the number of modules configurated for each agent - + A graph with number of packages sent by each Agent. A package is the number of values from the modules the agent - sends after each time interval + sends after each time interval + SNMP Console - Almost all device can send snmp traps when have any problem as - reboot lost interface, the temperature is very high, CPU crash, - etc ... .With Traps is possible know the problem when it happend. + Almost all device can send SNMP traps when have any problem as + reboot, lost interface, the temperature is very high, CPU crash, + etc. With Traps is possible to know the problem when it happens. - In Pandora 1.2 there is a SNMP console to recieve snmp trap. - Is possible configure any device to send snmp trap to Pandora, - only need the Pandora IP and Pandora Community. + In Pandora 1.2 there is a SNMP console to receive SNMP traps. + It is possible configure any device to send SNMP traps to + Pandora FMS, you only need the Pandora IP and Community. - in Operation, SNMP Console the users can see the snmp traps send - to Pandora Server. + From SNMP Console in the Operation menu the users can see + the SNMP traps sent to Pandora Server. SNMP Alerts - Just like is posible to generat alert if there is an out of - range module value. Is posible generate a alert if a snmp trap - is received with a anorma value. The Alert can consist in - sending and e-mail or SMS to the administrator, sending a SNMP + Just like is possible to generat alert if there is an out of + range module value. It is possible to generate an alert if an + SNMP trap is received with a anorma value. The Alert can consist of + sending and e-mail or SMS to the administrator, sending an SNMP trap, write the incident into the system syslog or Pandora log - file, etc. And basically anything that can be triggered by a - script configured in Pandora's Operating System. + file, etc. Basically anything that can be triggered by a + script configured in the Operating System when Pandora Servers run. - in Operation, SNMP Console, SNMP Alerts the users can see the - snmp Alert configured. + In "SNMP Console" > "SNMP Alerts" from Operation menu, the users + can see the configured SNMP Alerts. - To create a new alert the administrator must click in . Then appear the + fileref="images/SNMP_alert_create.png"/>. Then appears the following screen: Time threshold: Minimum duration between the firing of two consecutive - alerts,in seconds. + alerts, in seconds. - + \ No newline at end of file diff --git a/pandora_doc/en/pandora_chapter4.xml b/pandora_doc/en/pandora_chapter4.xml index d06643e973..206a5395b9 100644 --- a/pandora_doc/en/pandora_chapter4.xml +++ b/pandora_doc/en/pandora_chapter4.xml @@ -243,14 +243,14 @@ A specific incident can be found amongst the incidents created in Pandora by either using a filter, as explained in the first section of this chapter, or by making a query using the "Manage - Incidents">"Searh Incident" tool, in the Operation menu. + Incidents" > "Searh Incident" tool, in the Operation menu. Any text string included as a sub-string in the incident can be searched for using this tool. This search engine looks for the string in the Incident title as well as in the text contained by - the incident. The search engine will not search neither the + the incident. The search engine will not search neither the Comments added to the agent nor the attached files. The search can be performed in addition to group, priority or status filters. @@ -260,7 +260,7 @@ Statistics The incident statisticts are shown in the "Manage - Incidents">"Statistics" option of the Operation menu. They + Incidents" > "Statistics" option of the Operation menu. They can be of five different types: @@ -287,23 +287,24 @@ Messages - In Pandora 1.2 is possible send messages to others user. Each user can - see his/her messages in Operation, Messages. + In Pandora 1.2 it is possible to send messages to others user. + Each user can see his/her messages in "Messages" in the Operation + menu. - To send a message to other user you must click in Operation, Messages, - "New mesage" + To send a message to other user you must click in "Messages" > + "New mesage" in the Operation menu. - Is possible send a mmesage a group in Operation, Messages, Messages to - group. + It is possible to send a message to a group from "Messages to groups" + > "New mesage" in the Operation menu. diff --git a/pandora_doc/en/pandora_chapter5.xml b/pandora_doc/en/pandora_chapter5.xml index 99c07191d7..1da83513ec 100644 --- a/pandora_doc/en/pandora_chapter5.xml +++ b/pandora_doc/en/pandora_chapter5.xml @@ -88,7 +88,7 @@ Three different kinds of graphical statistic representation can be choosen from the "View - Events">"Statistics" option in the Operation menu: + Events" > "Statistics" option in the Operation menu: @@ -110,7 +110,7 @@ - Total events divided by the group the agent raising + Total events divided by the group the agent that launched the event belongs to diff --git a/pandora_doc/en/pandora_chapter6.xml b/pandora_doc/en/pandora_chapter6.xml index 9a4ad4d3ba..18321a2da0 100644 --- a/pandora_doc/en/pandora_chapter6.xml +++ b/pandora_doc/en/pandora_chapter6.xml @@ -10,8 +10,8 @@ The system audit includes actions that somehow try to by pass the - security system: attempts to delete an incident by an unauthorised - user, attemps to change user profiles by unauthoried users, etc. + security system: attempts to delete an incident by an unauthorized + user, attempts to change user profiles by unauthorized users, etc. Its main function is, however, to trace the user connections (login/logout). @@ -39,7 +39,7 @@ User: User that triggerd the event (SYSTEM - isspecial user of the system). + is special user of the system). diff --git a/pandora_doc/en/pandora_chapter7.xml b/pandora_doc/en/pandora_chapter7.xml index 71203f94b6..5075ba19d7 100644 --- a/pandora_doc/en/pandora_chapter7.xml +++ b/pandora_doc/en/pandora_chapter7.xml @@ -6,8 +6,8 @@ Data Server or SNMP Server. - Is posible manage the Pandora Servers in "Manage Servers" option of the - Administration menu. + It is possible to manage the Pandora Servers from the "Manage Servers" + option of the Administration menu. @@ -74,18 +74,18 @@ - Action: Icons to modify a server´s properties or + Action: Icons to modify a server's properties or to delete a server. - Is posible delete a with the icon - Is posible change the server´s propirties with the icon + It is posible to change the server's properties using the icon + In a Server is posiible modify: Name, IP Address and Description. diff --git a/pandora_doc/en/pandora_chapter8.xml b/pandora_doc/en/pandora_chapter8.xml index 827bc4940e..1bf415e607 100644 --- a/pandora_doc/en/pandora_chapter8.xml +++ b/pandora_doc/en/pandora_chapter8.xml @@ -13,7 +13,7 @@ It is obvious that the efficiency and reliability of this 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 in good condition is critital for Pandora to work properly. @@ -35,7 +35,7 @@ DB Information The DB statistics are generated by Agent, on the - "DB Maintenance">"DB Information" in the Administration menu, + "DB Maintenance" > "DB Information" in the Administration menu, and are represented in two kinds of graphs: @@ -60,11 +60,11 @@ align="center"/> These graphs can be also viewed from - "View Agents">"Statistics" in the Operation menu. + "View Agents" > "Statistics" in the Operation menu. - Is posible to view the Data Base information in mode text pich in the - link "Press here to get DB Info as text" + It is possible to view the Data Base information in text mode + pressing "Press here to get DB Info as text" @@ -73,8 +73,8 @@ Manual purge of the Datadase Pandora counts with powerful tools for the Administrator to manually - purge the majority of data stored in the Database.This includes data - generated by both the agents and the own server. + purge the majority of data stored in the Database. This includes data + generated by both the agents and the server by its own. Agent's data purge @@ -89,7 +89,7 @@ without peaks or unreal scales. - From "DB Maintenance">"Database Debug" in the + From "DB Maintenance" > "Database Debug" in the Administration menu any of the out of range data received from a agent's module can be deleted. @@ -113,7 +113,7 @@ Purging all the agent's data 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. @@ -167,7 +167,7 @@ Audit data purge All the audit data generated by the system can be deleted from - "DB Maintenance">"Database Audit", in the Administration + "DB Maintenance" > "Database Audit", in the Administration menu @@ -218,7 +218,7 @@ Event data purge All the event data generated by the system can be deleted from - "DB Maintenance">"Database Event", in the Administration menu + "DB Maintenance" > "Database Event", in the Administration menu The data to be deleted is selected by setting the following diff --git a/pandora_doc/en/pandora_chapter9.xml b/pandora_doc/en/pandora_chapter9.xml index 85a0f51ca6..ba603cb13c 100644 --- a/pandora_doc/en/pandora_chapter9.xml +++ b/pandora_doc/en/pandora_chapter9.xml @@ -15,7 +15,7 @@ Language: In following versions or revisions of the actual Pandora version will support more 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. @@ -52,17 +52,17 @@ Graph order: 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. Truetype fonts: This value represents the - capacity to active the truetypefonts.The posibility are Active or - Disable. + capacity to active the truetypefonts. The possible values are + Active or Disable. Background image: 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. @@ -74,13 +74,13 @@ The links configured in Pandora can be edited through the - "Pandora Setup">"Links" option in the Administration + "Pandora Setup" > "Links" option in the Administration menu. - A new link is created by clicking on "Add".The link can be then + A new link is created by clicking on "Add". The link can be then edited: Prerequisites - &pandora; is not only a single app, its composed by - several shellscript files (Unix Agents), a WEB application in - PHP (Console), some code in C++ (Windows Agent), some code in + &pandora; is not only a single app, it is made up by + several shellscript files (Unix/Linux Agents), a WEB application + in PHP (Console), some code in C++ (Windows Agent), some code in PERL5 (Server) and some structure and data in SQL (Database), so, to get all this running you need to have some pieces of software installed in your system. This is a list of packages, @@ -16,10 +16,10 @@ Pandora Servers - 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 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. Pandora Data Server @@ -51,16 +51,9 @@ You can find them at http://www.cpan.org or install using your default package instalation system. These packages are in the default distribution of Suse 9.1 and Debian 3.0 GNU/Linux. Also - available for Solaris in CPAN repository. If you use Windows go - to http://ppm.activestate.com. Or you can use the ppm tool to - download the modules: - - ppm install DBI - ppm install DBD-mysql - ppm install Datemanip - + available for Solaris in CPAN repository. Next, you need to set the TZ (Time Zone) environment - variable. In Windows: set TZ=WET (for example) + variable. @@ -129,7 +122,7 @@ pandora_server_1.2.tar.gz file. - 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: useraddd pandora -d /home/pandora @@ -179,11 +172,7 @@ dbhost localhost Please change them to your own data. For security reasons isn't - recommended use the default values. If you run Pandora Server in - 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. + recommended use the default values. 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 where Pandora Server will read and write data, sent by remote 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. @@ -302,10 +291,6 @@ cat pandoradb.sql | mysql -D pandora -u root -p cat pandoradb_data.sql | mysql -D pandora -u root -p - - Note: if your system is Windows, use the command type instead of - cat. - You can also use the source command, if you are connected to MySQL, from the MySQL prompt: @@ -317,9 +302,7 @@ This example is valid using root user in - MySQLRemember if you're in Windows use the - double slash ("//") with the path to the files, not the - backslash ("\"). + MySQL Now we will create an user "pandora" and will be given to it @@ -340,14 +323,13 @@ authenticating Web Console, you have to change the way the password is stored into the database: - mysql> set password for 'babel'@'localhost' = old_password('babel'); + mysql> set password for 'pandora'@'localhost' = old_password('pandora'); - Please note this user will be used by several babel - subcomponents(babel Server, babel Web Console) to access + Please note this user will be used by several pandora + subcomponents (Pandora Server, Pandora Web Console) to access database. - Pandora console install. @@ -486,7 +468,7 @@ They are developed to work under a given platform, making use of the specific tools of the language being used: VBSCript/Windows 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 developed in virtually any language, given its simple API system and being open source. There are branches of the Pandora project diff --git a/pandora_doc/en/pandora_introduction.xml b/pandora_doc/en/pandora_introduction.xml index 939fbc8214..3a32e1ffb6 100644 --- a/pandora_doc/en/pandora_introduction.xml +++ b/pandora_doc/en/pandora_introduction.xml @@ -1,25 +1,25 @@ - Introduction to Pandora - Pandora. The Free monitoring system + Introduction to Pandora FMS + Pandora. The Free Monitoring System - 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 your bussiness systems. Pandora watch for your hardware, your software, your multilayer system and of course your Operating System. Pandora could detect a network interface down and the movement of any value of the NASDAQ new technology market. If you 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. - Pandora adapt, like an octopus, to your systems and requirements, - because has been designed to be open, modular, multiplattform and - easy to customize. + Pandora FMS will adjust, like an octopus, to your systems and + requirements, because it has been designed to be open, modular, + multiplattform and easy to customize. - Introducing Pandora. + Introducing Pandora FMS. &pandora; is a monitoring tool that allows a system administrator to visually analise the status and efficiency of @@ -90,13 +90,13 @@ the information Pandora needs to work - agent data, settings, user information, incidents, system settings, 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. This database can work with any of the platform officially 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. @@ -114,7 +114,7 @@ AIX, HP-UX and BSD, as well as the Nokia's IPSO. Pandora agents can be developed in virtually any language, given its 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. @@ -261,7 +261,7 @@ The XML data file generated by every agent is the core of 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. An example of the information included into the data file is the following one: @@ -338,8 +338,8 @@ Pandora SNMP Server. This is a PERL application that parse output from standard snmptradp (we - provide one binary for snmptrapd, but its possible you need - to replace it with a binary that runs better in your + provide one binary for snmptrapd, but it is possible that + you need to replace it with a binary that runs better in your system). This daemon receives SNMP traps, and Pandora SNMP Server stores in database and fire alerts assigned in Pandora SNMP Console. diff --git a/pandora_doc/en/pandora_migration.xml b/pandora_doc/en/pandora_migration.xml index f877e0f97b..ac11b1d7fc 100644 --- a/pandora_doc/en/pandora_migration.xml +++ b/pandora_doc/en/pandora_migration.xml @@ -1,7 +1,7 @@ Migrating from Pandora 1.1 - Migrate Pandora 1.1 to Pandora 1.2 + Migrate Pandora 1.1 to Pandora 1.2 You need a script called pandoradb_1.1_to_1.2.sql provided in Pandora Console Package for 1.2 version. Migrate 1.1 to 1.2 @@ -28,7 +28,7 @@ Read documentation about new features of Pandora 1.2. 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 trying it. diff --git a/pandora_doc/en/pandora_userguide.xml b/pandora_doc/en/pandora_userguide.xml index 21cf5f2596..fd435f872c 100644 --- a/pandora_doc/en/pandora_userguide.xml +++ b/pandora_doc/en/pandora_userguide.xml @@ -32,7 +32,7 @@ &pandora_version; First Edition(&pandora_version;) - November 19th, 2006 + November 21st, 2006 pandora user manual @@ -47,6 +47,11 @@ + + 1.2 + 21 November 2006 + Submitted. + 1.1 10 October 2006 @@ -54,12 +59,12 @@ 1.0 - 11 Sept 2006 + 11 September 2006 Submitted. 0.1 - 11 Sept 2006 + 11 September 2006 First draft for review.