Zenoss, Inc.
www.zenoss.com
Zenoss Installation for Core 2.4
Copyright © 2009 Zenoss, Inc., 275 West St. Suite 204, Annapolis, MD 21401, U.S.A. All rights reserved.
This work is licensed under a Creative Commons Attribution Share Alike 3.0 License. To view a copy of this license, visit http://
creativecommons.org/licenses/by-sa/3.0/; or send a letter to Creative Commons, 171 2nd Street, Suite 300, San Francisco, California,
94105, USA.
The Zenoss logo is a registered trademark of Zenoss, Inc. Zenoss and Open Enterprise Management are trademarks of Zenoss, Inc. in
the U.S. and other countries.
Flash is a registered trademark of Adobe Systems Incorporated.
Java is a registered trademark of Sun Microsystems, Inc.
Linux is a registered trademark of Linus Torvalds.
Oracle and the Oracle logo are registered trademarks of the Oracle Corporation.
SNMP Informant is a trademark of Garth K. Williams (Informant Systems, Inc.).
Sybase is a registered trademark of Sybase, Inc.
Tomcat is a trademark of the Apache Software Foundation.
Windows is a registered trademark of Microsoft Corporation in the United States and other countries.
All other companies and products mentioned are trademarks and property of their respective owners.
iii
1. Installing Zenoss for RHEL 5 or CentOS 5 .......................................................................................... 1
1.1. Prerequisite Tasks ................................................................................................................... 1
1.2. Install the Zenoss Software ...................................................................................................... 1
1.3. Disable or Configure the Firewall ............................................................................................. 2
1.4. What's Next? .......................................................................................................................... 2
2. Installing the Zenoss Virtual Appliance ................................................................................................ 3
2.1. System Requirements .............................................................................................................. 3
2.2. Installing the Zenoss Appliance ................................................................................................ 3
2.3. What's Next? .......................................................................................................................... 3
2.4. Converting the Zenoss Virtual Appliance to ESX ....................................................................... 3
3. Installing Zenoss from the Stack Installers ........................................................................................... 5
3.1. Install Zenoss for SUSE Linux Enterprise Server ....................................................................... 5
3.1.1. Download the Installer .................................................................................................. 5
3.1.2. Launch the Installer ...................................................................................................... 5
3.1.2.1. Command Line .................................................................................................. 5
3.1.2.2. KDE .................................................................................................................. 5
3.1.2.3. Gnome .............................................................................................................. 6
3.1.3. Install Zenoss ............................................................................................................... 6
3.1.4. What's Next? ................................................................................................................ 9
4. Installing from the Zenoss Debian Stack Installer ............................................................................... 10
4.1. Install from the zenoss-stack DEB .......................................................................................... 10
5. Installing Zenoss for Mac OS X ........................................................................................................ 11
5.1. Installation Notes ................................................................................................................... 11
5.2. Installation Procedure ............................................................................................................ 11
5.3. What's Next? ......................................................................................................................... 12
6. Installing Zenoss from Source ........................................................................................................... 13
6.1. Zenoss Source Installation ..................................................................................................... 13
6.2. Major Dependencies .............................................................................................................. 13
6.3. System Setup ........................................................................................................................ 13
6.4. Build and Install Zenoss ......................................................................................................... 13
6.5. Platform-Specific Notes .......................................................................................................... 15
6.5.1. Setting Socket buffers on Unix platforms ...................................................................... 15
6.5.2. Setting up Zenoss to run with a remote MySQL Instance ............................................... 15
7. Other Zenoss Installations ................................................................................................................ 16
7.1. RHEL4 Installation Instructions ............................................................................................... 16
7.1.1. Prerequisite Tasks ...................................................................................................... 16
7.1.2. Install the Zenoss Software ......................................................................................... 16
7.1.3. Disable or Configure the Firewall ................................................................................. 17
7.1.4. What's Next? .............................................................................................................. 17
7.2. FreeBSD Installation Instructions ............................................................................................ 17
7.2.1. FreeBSD 6.1 Installation ............................................................................................. 17
7.2.2. FreeBSD 6.2 Installation ............................................................................................. 18
7.2.3. FreeBSD 6.3 Installation ............................................................................................. 19
7.2.4. FreeBSD 7.0 Installation ............................................................................................. 19
7.2.5. What's Next? .............................................................................................................. 21
8. Upgrading Zenoss ............................................................................................................................ 22
8.1. Overview ............................................................................................................................... 22
8.1.1. Upgrade Paths ........................................................................................................... 22
8.1.2. Back Up Zenoss Data ................................................................................................. 22
8.1.3. After Upgrading .......................................................................................................... 22
8.2. Upgrading the bin Stack Installer ............................................................................................ 22
8.3. Upgrading the Debian Stack Installer ...................................................................................... 23
8.4. Upgrading the Zenoss Virtual Appliance Image ....................................................................... 23
8.5. Upgrading RHEL 4 / CentOS 4 or RHEL 5 / CentOS 5 RPMs ................................................... 24
8.6. Upgrading a Source Tarball Install .......................................................................................... 25
8.7. Upgrading a Subversion Source Checkout .............................................................................. 25
9. Upgrading from a Source Install to a Stack Install .............................................................................. 26
9.1. Upgrading From a Source Install to a Stack Install .................................................................. 26
Zenoss Installation for Core 2.4
iv
10. Removing a Zenoss Instance .......................................................................................................... 28
10.1. Before You Begin ................................................................................................................ 28
10.2. Remove a Zenoss RPM Installation ...................................................................................... 28
10.3. Remove a Zenoss bin Stack Installation ................................................................................ 28
10.4. Remove a Zenoss Debian Stack Installation .......................................................................... 28
10.5. Remove a Zenoss Stack Installation (Mac OS/X) ................................................................... 29
1
Chapter 1. Installing Zenoss for RHEL 5 or
CentOS 5
1.1. Prerequisite Tasks
Run all commands as root, from the machine where you want to install Zenoss.
Before you install:
1. Run the Yellowdog Updater, Modified (YUM), which you will use to install Zenoss. To run YUM, enter this
command:
# yum -y install mysql-server net-snmp net-snmp-utils gmp libgomp libgcj liberation-fonts
2. Download the Zenoss installation files.
3. If you have just installed MySQL, then use the following commands to adjust the permissions:
# /etc/init.d/mysqld restart
# /usr/bin/mysqladmin -u root password ''
# /usr/bin/mysqladmin -u root -h YOUR_SERVER_NAME password ''
Initially, the MySQL password must be blank so that Zenoss can correctly create the database. After
you have installed and started Zenoss, you can change this password.
1.2. Install the Zenoss Software
Follow these steps to install Zenoss for Red Hat Enterprise Linux 5 or CentOS 5.
1. Enter one of the following commands to install the Zenoss RPM.
For 32-bit:
# rpm -ivh zenoss-Version.el5.i386.rpm
For 64-bit:
# rpm -ivh zenoss-Version.el5.x86_64.rpm
Where Version is the current Zenoss version.
2. If MySQL is running on a different server, or has a different root user password, edit the /opt/zenoss/
bin/zenoss_init_pre file and adjust the MYSQLHOST, MYSQLROOTUSER, and MYSQLROOTPASSWD
values.
3. Enter this command to start Zenoss.
# service zenoss start
4. Install the Zenoss Core ZenPacks. Enter one of these commands.
For 32-bit:
# rpm -ivh zenoss-core-zenpacks-Version.el5.i386.rpm
For 64-bit:
# rpm -ivh zenoss-core-zenpacks-Version.el5.x86_64.rpm