root/branches/zenoss-2.1.x/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/