Installing Zenoss on Feisty Ubuntu 1. Install Ubuntu 8.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: Code: 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: Code: sudo su Enter your password. 5. Several dependencies are in the 'universe' repository, so we'll need to modify your sources list with your favorite editor: Code: /etc/apt/sources.list Find these two lines: Code: deb http://us.archive.ubuntu.com/ubuntu hardy main restricted deb-src http://us.archive.ubuntu.com/ubuntu hardy main restricted And add the 'universe' repository: Code: deb http://us.archive.ubuntu.com/ubuntu hardy main restricted universe deb-src http://us.archive.ubuntu.com/ubuntu haryd main restricted universe Save the file and close the editor. Then, back at the command line: Code: apt-get update && apt-get upgrade 6. Now we can install the dependencies. From the command line: Code: 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: Code: 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. Edit your bash defaults: Code: /home/zenoss/.bashrc And add these lines to the end: Code: 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: Code: mkdir /usr/local/zenoss chown zenoss /usr/local/zenoss 10. Hardy Heron 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: Code: unlink /usr/bin/python && ln -s /usr/bin/python2.4 /usr/bin/python Then edit: Code: /usr/share/python/debian_defaults and change the default python version if it doesn't already say 2.4 Code: [DEFAULT] # the default python version default-version = python2.5 Change the above line to the following Code: default-version = python2.4 Save and exit the file. 11. Now it's time to install. First, become the zenoss user: Code: su zenoss cd You're in the zenoss user's home directory. Download the latest version of Zenoss here. If you want to use the potentially unstable svn version you can download it by typing: Code: 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: Code: 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: Code: ./install.sh The installation script will ask you a few questions, then install Zenoss. If the compilation fails with: Code: installing nagios make: *** [nagios-install] Error 2 unable to build zenoss and prerequisites, see zenbuild.log You probably need to edit Code: /home/zenoss/zenoss-2.1.3/build/nagios-plugins-1.4.5/plugins/check_pgsql.c and change line 45: Code: #include "netutils.h" #include <libpq-fe.h> to this: Code: #include "netutils.h" #include "pg_config_manual.h" #include <libpq-fe.h> If you run into any other problems and need to run the installation again, clean up what's already been done with: Code: make clean 12. Once Zenoss has been installed successfully, become root again by typing: Code: exit Or hitting Ctrl-D. Set zensocket to setuid: Code: chown root:zenoss /usr/local/zenoss/bin/zensocket chmod 04750 /usr/local/zenoss/bin/zensocket Switch back the Python symlinks: Code: unlink /usr/bin/python && ln -s /usr/bin/python2.5 /usr/bin/python Then edit: Code: /usr/share/python/debian_defaults and change the default python version if it doesn't already say 2.5 Code: [DEFAULT] # the default python version default-version = python2.4 Change the above line to the following: Code: default-version = python2.5 Save and exit the file. And have Zenoss run on system startup: Code: ln -s /usr/local/zenoss/bin/zenoss /etc/init.d sysv-rc-conf Add Zenoss to runlevels 2, 3, 4 and 5. Start Zenoss: Code: /usr/local/zenoss/bin/zenoss start check that Zenoss started properly with: Code: /usr/local/zenoss/bin/zenoss status 13. To monitor your Zenoss server you need to configure it to allow 'public' to read all OIDs (default is to read very few OIDs): Code: cp /etc/snmp/snmpd.conf{,.bak} snmpconf configure snmpd agent to allow public read Code: cp snmpd.conf /etc/snmp/ /etc/init.d/snmpd restart 14. If you haven't already set up a mail server on your machine you can continue on to installing the default ubuntu mail agent (MTA) which is exim4, which may need to be setup if you want email alerts to work with a remote mail server (mail.mydomain.inc): Code: dpkg-reconfigure exim4-config Select default options, except: Code: 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: Code: apt-get install mailutils mail [EMAIL PROTECTED] (press enter for Cc:, type in subject, press enter) (type in body of message, then enter) Code: . (type in single period, then enter, to end composing and email is queued) Code: 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: Code: www.snmp-informant.com - download the free SNMP for Windows. 17. Read the Admin guide at http://www.zenoss.com/download/ -------------------- m2f -------------------- Read this topic online here: http://community.zenoss.com/forums/viewtopic.php?p=20051#20051 -------------------- m2f -------------------- _______________________________________________ zenoss-users mailing list [email protected] http://lists.zenoss.org/mailman/listinfo/zenoss-users
