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