Zenoss, Inc. www.zenoss.com Copyright © 2008 Zenoss, Inc., 275 West St. Suite 204, Annapolis, MD 21401, U.S.A. All rights reserved. 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. SNMP Informant is a trademark of Garth K. Williams (Informant Systems, 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. Zenoss Installation for Core Version 2.3 Zenoss Installation for Core Version 2.3 1. Downloading the Zenoss Files ....................................................................................................... 1 1. Where to Find Zenoss Download Files .................................................................................... 1 2. Installing Zenoss from the Stack Installers ....................................................................................... 2 1. Install Zenoss from the Stack Installers ................................................................................... 2 3. Installing the Zenoss Virtual Appliance ........................................................................................... 7 1. System Requirements .......................................................................................................... 7 2. Installing the Zenoss Appliance ............................................................................................. 7 4. Installing Zenoss for RHEL 4 or CentOS 4 ...................................................................................... 9 1. Prerequisite Tasks ............................................................................................................... 9 2. Install the Zenoss Software ................................................................................................... 9 3. Disable or Configure the Firewall ......................................................................................... 10 5. Installing Zenoss for RHEL 5 or CENTOS 5 .................................................................................. 11 1. Prerequisite Tasks ............................................................................................................. 11 2. Install the Zenoss Software ................................................................................................. 11 3. Disable or Configure the Firewall ......................................................................................... 12 6. Installing from the Zenoss Debian Stack Installer ............................................................................ 13 1. Install from the zenoss-stack DEB ........................................................................................ 13 7. Installing Zenoss from Source ..................................................................................................... 14 1. Zenoss Source Installation .................................................................................................. 14 2. Major Dependencies .......................................................................................................... 14 3. System Setup ................................................................................................................... 14 4. Build and Install Zenoss ..................................................................................................... 15 5. Platform-Specific Notes ..................................................................................................... 16 5.1. Fedora Core 5 ........................................................................................................ 16 5.2. Mac OSX .............................................................................................................. 16 5.3. Setting Socket buffers on Unix platforms .................................................................... 16 5.4. Setting up Zenoss to run with a remote MySQL Instance ................................................ 16 8. Other Zenoss Installations ........................................................................................................... 17 1. Ubuntu Installation ............................................................................................................ 17 1.1. Ubuntu 6.10 .......................................................................................................... 17 1.2. Ubuntu 7.04 .......................................................................................................... 19 2. SLES Installation Instructions ............................................................................................. 21 2.1. SLES 10 Installation Instructions ............................................................................... 21 2.2. SLES 10.2 Instructions ............................................................................................ 22 3. Fedora Core 6 Installation ................................................................................................... 22 4. Zenoss BSD Installation ..................................................................................................... 23 4.1. Overview: Manual Installation .................................................................................. 23 4.2. Overview: Automated Installation .............................................................................. 24 5. FreeBSD Installation Instructions ......................................................................................... 24 5.1. FreeBSD 6.1 Installation .......................................................................................... 24 5.2. FreeBSD 6.2 Installation .......................................................................................... 24 5.3. FreeBSD 6.3 Installation .......................................................................................... 25 9. Upgrading Zenoss ..................................................................................................................... 27 1. Overview ......................................................................................................................... 27 1.1. Back Up Zenoss Data .............................................................................................. 27 1.2. After Upgrading ..................................................................................................... 27 2. Upgrading the Zenoss Stack Installers ................................................................................... 27 3. Upgrading the Zenoss Virtual Appliance Image ....................................................................... 28 4. Upgrading EL4 or EL5 RPMs ............................................................................................. 29 5. Upgrading a Source Tarball Install ........................................................................................ 30 6. Upgrading a Subversion Source Checkout .............................................................................. 30 10. Upgrading from a Source Install to a Stack Install .......................................................................... 31 1. Upgrading From a Source Install to a Stack Install ................................................................... 31 11. Removing a Zenoss Instance ...................................................................................................... 33 1. Overview ......................................................................................................................... 33 2. Removing a Zenoss Instance from RPM Installs ...................................................................... 33 3. Removing a Zenoss Instance from Stack Installers ................................................................... 33 4. Removing a Zenoss Instance from the Mac OSX Stack Installer ................................................. 33 iii Chapter 1. Downloading the Zenoss Files 1. Where to Find Zenoss Download Files Download the Zenoss files for your particular installation from this location: http://www.zenoss.com/download 1 Chapter 2. Installing Zenoss from the Stack Installers 1. Install Zenoss from the Stack Installers Follow these instructions to install Zenoss and the Zenoss stack by using the point-and-click stack installers. 1. Download the Zenoss installation files from: http://www.zenoss.com/download 2. Choose one of the following installation methods, depending on your preference or environment (command line, KDE, or Gnome). a. To open the installer from the command line: Note zenoss*.bin is the current installation file. i. Open a command line prompt, and then change directory (cd) to the directory where you downloaded the installer: $ cd <Your download directory>/ ii. Make the installer executable. Use this command: $ chmod +x ./zenoss*.bin iii. Run the Zenoss installer. Zenoss requires that you perform this installation as the root user. If you know your root password, then use the su command: $ su root -c ./zenoss*.bin If you do not know your root password, then use the sudo command: $ sudo ./zenoss*.bin iv. Answer