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