root/trunk/inst/docs/INSTALL_UBUNTU610.txt

Installing Zenoss on Ubuntu Server

1. Install Ubuntu 6.10. This install tested on a vmplayer image.

2. Login as default user.

Commands that need to run as root will be prefixed with sudo. You can sudo from
the default user.

3. Need to add universe for apt-get use (svn, mysql dev) (using nano for
editor):

sudo nano /etc/apt/sources.list

Uncomment the two lines that contain "dapper univers" by removing #:

deb http://ca.archive.ubuntu.com/ubuntu/ dapper universe deb-src
http://ca.archive.ubuntu.com/ubuntu/ dapper universe

Save file, then refresh at command prompt:

sudo apt-get update

4. Install development tools needed to build Zenoss.

sudo apt-get install -y build-essential libmysqlclient15-dev \ python-dev
svn-buildpackage snmpd snmp \ autoconf swig mysql-server-5.0 mysql-client-5.0

5. Add zenoss user:

sudo adduser zenoss

6. Add zenoss install directory:

sudo mkdir /usr/local/zenoss sudo chown zenoss /usr/local/zenoss

7. Login as zenoss user and set up some variables in login script:

su - zenoss cd        (goto home directory) nano  .bashrc . .bashrc

Add these lines:

export ZENHOME=/usr/local/zenoss export PYTHONPATH=$ZENHOME/lib/python export
PATH=$ZENHOME/bin:$PATH


8. Get latest zenoss tarball. To use subversion to download it, need to download
svn first from universe. Login as root:

apt-get install svn-buildpackage su - zenoss cd

Download latest tar to zenossinst subdir:

svn co http://dev.zenoss.org/svn/trunk/inst zenossinst


9. Install zenoss from its install directory. For mysql, use the default root
user, with the password you used in step 15. For zenoss password, create a new
one:

cd zenossinst ./install.sh

10. Do as the install instructions say and change the permissions on zensocket
(as root):

sudo chown root:zenoss $ZENHOME/bin/zensocket sudo chmod 04750
$ZENHOME/bin/zensocket

11. Start zenoss:

$ZENHOME/bin/zenoss start

12. If install fails, cleanup with:

make clean

13. If install says successful, browse the zenoss portal

Determine your ip address:

/sbin/ifconfig -a | grep addr

Use that address to browse to Zenoss:


Go to http://<your address here>:8080/zport/dmd, for example, you might browse
to http://192.168.1.100:8080/zport/dmd.

Username is "admin" Password is the one entered for Zenoss "admin" user in step
9

14. To monitor your zenoss server, configure your SNMP agent. After installing,
you need to configure it to allow 'public' to read all OIDs (default is to read
very few OIDs):

sudo cp /etc/snmp/snmpd.conf  /etc/snmp//snmpd.conf.bak sudo cp
/home/zenoss/zenossinst/conf/snmpd.conf /etc/snmpd.conf sudo cp snmpd.conf 
/etc/snmp/ sudo /etc/init.d/snmpd restart

15. 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):

sudo dpkg-reconfigure exim4-config

# select default options, except for below) mail sent by smarthost; received via
SMTP or fetchmail mail.mydomain.inc

16. To test mail agent, need to install a frontend (MUA - mail) to exim4:

apt-get install mailutils echo 'this is a test' | mail -s 'test subject'
youremail@yourdomain.inc

# to see if mail is sent or still in queue: sudo mailq


17. Read the Admin guide at www.zenoss.com/download/


18. To add zenoss daemons to run at boot up, login as root. Apached runtime is
90, so we use 95 to have it run after it and mysql. Also need to modify zenoss
script for ZENHOME path:

sudo cp $ZENHOME/bin/zenoss  /etc/init.d sudo nano  /etc/init.d/zenoss

Add the following line to ensure all scripts can find ZENHOME)

export ZENHOME=/usr/local/zenoss

Run the following to get zenoss to start in the proper order

sudo update-rc.d zenoss defaults 95