Installing Zenoss on Feisty Ubuntu
1. Install Ubuntu 7.04 Server from an installation CD.
2. Log in as the default user.
3. Install ssh so you can putty (remote terminal) from your desktop:
sudo apt-get install ssh
ifconfig | grep cast(to see what your IP is)
4. Either via SSH or on the box itself, become the root user:
sudo su
[Enter password]
5. Several dependencies are in the 'universe' repository, so we'll need to
modify your sources list (here we'll use vim as an editor):
vim /etc/apt/sources.list
Find these two lines:
deb feisty main restricted
deb-src feisty main restricted
And add the 'universe' repository:
deb feisty main restricted universe
deb-src feisty main restricted universe
Save the file and close the editor. Then, back at the command line:
apt-get update && apt-get upgrade
6. Now we can install the dependencies. From the command line:
apt-get install mysql-server mysql-client python-dev python2.4-dev
build-essential subversion libmysqlclient15-dev snmpd autoconf
snmp swig python-setuptools sysv-rc-conf bzip2
7. Add the 'zenoss' user that will run the application:
adduser zenoss
If security isn't an issue, use the password 'zenoss'. Use defaults for
everything else.
8. Zenoss requires some environment variables to be set, so we need to add them
to the 'zenoss' user's bash startup script. Enter the command:
vim /home/zenoss/.bashrc
And add these lines to the end:
export ZENHOME=/usr/local/zenoss
export PYTHONPATH=$ZENHOME/lib/python
export PATH=$ZENHOME/bin:$PATH
Save the file and close the editor.
9. Now we'll make the directory into which Zenoss will install. Run:
mkdir /usr/local/zenoss
chown zenoss /usr/local/zenoss
10. Feisty Fawn ships with Python 2.5, but certain dependencies of Zenoss are
unable to build properly with this version. Once Zenoss has been installed,
it will run just fine under 2.5, but we'll need to change the symlink for
the installation. Run:
unlink /usr/bin/python && ln -s /usr/bin/python2.4 /usr/bin/python
11. Now it's time to install. First, become the zenoss user:
su zenoss
cd
You're in the zenoss user's home directory. Download the latest version of
Zenoss here. If you want to use svn to download it, run:
svn co zenoss-install
If you want to use a tarball, download it to this directory and run:
tar xzf zenoss-[X.XX].tar.gz
Replacing the [X.XX] with the version you've downloaded.
Now that you've got Zenoss, cd to the directory that was just created. All
that's left to do is:
./install.sh
The installation script will ask you a few questions, then install Zenoss.
If you run into any problems and need to run the installation again, clean
up what's already been done with:
make clean
12. Once Zenoss has been installed successfully, become root again by typing:
exit
Or hitting Ctrl-D. Set zensocket to setuid:
chown root:zenoss /usr/local/zenoss/bin/zensocket
chmod 04750 /usr/local/zenoss/bin/zensocket
Switch back the Python symlinks:
unlink /usr/bin/python && ln -s /usr/bin/python2.5 /usr/bin/python
And have Zenoss run on system startup:
ln -s /usr/local/zenoss/bin/zenoss /etc/init.d
sysv-rc-conf
Add Zenoss to runlevels 2, 3, 4 and 5. Reboot, and check that Zenoss
started properly with:
/usr/local/zenoss/bin/zenoss status
13. To monitor your Zenoss server, install SNMP agent:
apt-get install snmpd
You need to configure it to allow 'public' to read all
OIDs (default is to read very few OIDs):
cp /etc/snmp/snmpd.conf{,.bak}
snmpconf(configure snmpd agent to allow public read)
cp snmpd.conf /etc/snmp/
/etc/init.d/snmpd restart
14. Default ubuntu mail agent (MTA) is exim4, which may need to be
setup if you want email alerts to work with a remote mail server
(mail.mydomain.inc):
dpkg-reconfigure exim4-config
Select default options, except:
mail sent by smarthost; received via SMTP or fetchmail
mail.mydomain.inc
15. To test mail agent, need to install a frontend (MUA - mail) to
exim4:
apt-get install mailutils
mail youremail@yourdomain.inc
(press enter for Cc:, type in subject, press enter)
(type in body of message, then enter)
. (type in single period, then enter, to end composing and email is queued)
mailq (to see if mail is sent or still in queue)
16. For Windows monitoring, install SNMP from add/remove Windows
monitoring components, then install SNMP-Informant:
www.snmp-informant.com - download the free SNMP for Windows.
17. Read the Admin guide at
For more information, please visit
