Extended Monitoring Guide
Follow these steps to download and install the Zenoss Global Dashboard:
Download the latest version of the Zenoss Global Dashboard.
Extract the tarball and change to the created directory using the following commands:
tar xzf ZenGlobe-2.1.tar.gz cd ZenGlobe-2.1
Install ZenGlobe.
sudo python setup.py install
Prior to starting up the first time, ZenGlobe needs to know the port it should bind to and the Zenoss instance it should use for authentication. Run:
sudo zenglobe configure
Enter the port to which you want ZenGlobe to bind. Make sure you have nothing else listening at that port.
When asked, enter the hostname of a running Zenoss instance that you want ZenGlobe to use for authentication. You can change this setting later, but in order to log in to ZenGlobe the first time, you will need to use the username and password of a user from this Zenoss instance. Anyone with a login to this instance will be able to view the ZenGlobe dashboard, but only the
adminuser will be able to edit settings.Start ZenGlobe using the command:
sudo zenglobe start
Check to make sure that ZenGlobe has started by accessing from your browser:
http://[ZenGlobe machine hostname]:[port]/
You should now see a ZenGlobe login screen.
For security reasons, ZenGlobe must be configured to log in to the remote Zenoss instances from which it gathers data. By default, this is set to be zenglobe:zenglobe; however, it is a good idea to reconfigure ZenGlobe to use a more secure username and password combination.
In a browser, navigate to the Zenoss instance you wish to monitor, click Settings in the left navigation pane.
Select the Users tab.
From the table menu, select . Enter the username that you want ZenGlobe to use to log in to all Zenoss instances (e.g.
zenglobe). You may leave the Email field blank.Click the button to save your changes.
Log in to the Zenoss Global Dashboard as the
adminuser.Note
Only the
adminuser can modify ZenGlobe options.Click the link in the top bar. The configuration box will slide down.
The options in this configuration box are as follows:
Table 52.2. Zen Global Dashboard Configuration Options
Name Description Zenoss Servers
The list of hostnames of the Zenoss instances ZenGlobe will monitor.
Remote Login
The user name and password ZenGlobe will use to access the remote Zenoss instances. By default, it is set to
zenglobe:zenglobe. Follow the instructions in Section 3.2, “Configure Remote Zenoss for Monitoring” to set up matching users on each Zenoss instance to be monitored.URL Template
The template ZenGlobe will use to build the URL by which it accesses monitored Zenoss instances. If you run your Zenoss instances on a different port, or serve them behind Apache with rewritten URLs, you will need to update this value to reflect that change.
Authentication Server
The Zenoss instance against which ZenGlobe authenticates. You may also reset the port and authentication server using the same command line option you used when initially configuring ZenGlobe.