root/trunk/inst/docs/INSTALL_UBUNTU704.txt

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 http://us.archive.ubuntu.com/ubuntu feisty main restricted deb-src
http://us.archive.ubuntu.com/ubuntu feisty main restricted

And add the 'universe' repository:

deb http://us.archive.ubuntu.com/ubuntu feisty main restricted universe deb-src
http://us.archive.ubuntu.com/ubuntu 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 http://dev.zenoss.org/svn/trunk/inst 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 http://www.zenoss.com/download/