1. SNMP and MIBs - Installation and Configuration
To implement the monitoring system, the first step is to install SNMP and MIBs in all the systems to be monitored.
Below is described each system used by each resource in a common island setup:
|VPN Client||Debian 7||vpn|
If you have a different setup you have to change this in order to correctly describe your own environment
Download and install the SNMP and MIBs for each one of the systems:
(For Debian systems, is necessary to add the non-free repositories before installation)
And apply the following default configuration:
- rocommunity- This field must be filled with FIBRE's default community, which is FIBRE-BR.
- syslocation - This field should be filled with the server's location. Like the instituion, the state and the city where the infrastructure is located.
- syscontact - This field should be filled with the sysadmin's e-mail.
- agentaddress - This field should be completed with the ip address of the FIBRE control network inthe system (10.x.0.y), and port 161.
Example for RNP Dom0:
rocommunity FIBRE-BR syslocation RNP, Brasília, DF syscontact firstname.lastname@example.org agentaddress 10.128.0.30:161
2. Monitoring Agents - Installation and Configuration
To deploy an advanced monitoring of some essencial island resources, a monitoring agent must be installed on them.
Additionally, the current version of the Pronto SW firmware don't support the monitoring agent.
In short, the agent don't need to be installed on the DNS, Perfsonar, and on the Pronto SW.
For each other system, download and install the agent as follows:
Edit the agent configuration file for each resource system:
And change the according to your environment. The Proxy IP address follow the pattern: 10.[id].0.160:
Save the changes and exit the editor;
Delete a config file that will be substituted:
Download the "etc-zabbix.tar.gz " file from the ftp://repo.fibre.org.br/Monitoring/ to the /etc/zabbix/ folder on the agent host and extract it:
For the OCF VM only, is necessary to create a read-only user in the MySQL database:
Finally, and for all nodes, restart the monitoring agent service and enable startup on system initialization:
3. Local Proxy - Installation and Configuration
For this installation, use the template zproxy-template.tar.gz available at this address: ftp://repo.fibre.org.br/
Download it where Xen creates its VMs.
Where does the hypervisor creates its VMs?
To verify where the hypervisor is creating its VMs, verify this file: /etc/xen-tools/xen-tools.conf.
The value of the variable dir is the destiny where the VMs are being created.
Due to the Island's firewall constraints, it might be necessary to use the internal address to download. In case of need use this address:
And extract it´s contents:
And access the directory.
Changing directory name
It might be interesting to change the directory name for this pattern: zprozy.institution.fibre.org.br
After that it's necessary to rename and edit and rename this file: zproxy.template
It's necessary to edit the following lines:
The variable disk refers where the VM's disk is located. Below is an example of configuration:
Also it's necessary to configure the network, the vif variable is responsible for this task.
Control Bridge name
Pay attention to the name of your control bridge, also it's necessary to change the mac address.
Example of configuration:
It's a good practice to use this pattern for MAC address generation:
Where XX stands for the Island's ID and YY stands for the service IP, both in hexadecimal form
The next step of editing the file it's to change the name of the VM.
Edit this line:
This edition consists in just replace template to the name of the institution.
After editing, move and rename it to /etc/xen:
And create a symbolic link at the directory called auto:
The next step is to access the console of the VM:
To start using the VM use the following credentials:
4. Related Documents
Below are the documents related to the monitoring solution choosed for the FIBRE NOC Monitoring: