README for Installing RTM for SAS on Linux Platform RTM 2.0.8 SAS Edition June 2012 Platform Computing Corporation ========================= CONTENTS ========================= 1. Introduction 2. Supported systems 3. Components 4. Dependencies 5. Installation 6. Installation using the ISO image 7. Uninstallation 8. Copyrights ========================= 1. Introduction ========================= This document describes the specific requirements for the Platform RTM 2.0.8 SAS Edition installation package for Linux. The normal installation package allows you to install RTM with RedHat Linux. RTM is also distributed as ISO image files for x86_64 platform that include both RTM and CentOS 5.2. The ISO image files are appropriate if you want to install RTM on a bare physical system or a virtual machine and do not wish to install RedHat. You can also use this installation package to upgrade a previous installation of Platform RTM SAS Edition to version 2.0.8, as long as you did not remove any components included in the installation package for the previous version. Note: Ensure that all users have stopped using Platform RTM before you upgrade to the newer version. ========================= 2. Supported systems ========================= Supported platforms: - AMD64 - EM64T Hardware requirements: - 2 GB of RAM - 40 GB of free disk space Supported Linux operating systems: - Red Hat Enterprise Linux 5 or later (64-bit) The installation package file name depends on the operating system: - RHEL 64-bit: rtm2.0.8_sas_rhel_x86_64.bin Supported browsers: - Internet Explorer 7 & 8 (Windows) - Firefox 3.0 and later (Linux and Windows) ========================= 3. Components ========================= The installation package includes the following components: - RTM binary and configuration files - FLEXlm binary files - RRDtool - Cherry Python - Python - python-simplejson - PHP - php-json ========================= 4. Dependencies ========================= The following is a list of packages required by the RTM installation package as dependencies. If the installer detects missing packages from this list, it will exit with a list of the missing packages and the command you need to run to install the missing packages. * chkconfig * coreutils * gd * httpd * initscripts * mod_ssl * mysql * mysql-server * net-snmp * ntp * perl * pexpect * php * pyOpenSSL * rsyslog * rsyslog-mysql * shadow-utils * apr * apr-util * fontconfig * freetype * gdbm * gmp * libXpm * libjpeg * libpng * lm_sensors * net-snmp-libs * perl-DBD-MySQL * perl-DBI * php-cli * php-common * pkgconfig * postgresql-libs * libsysfs * sqlite * libart_lgpl * net-snmp-utils * php-gd * php-mysql * php-snmp * php-pdo * php-ldap Note: 1. If you are using RHEL 6.x, as a pre-install step download the proper PHP-SNMP package since the DVD does not contain the php-snmp package. If using the Red Hat Network, you need to download this package using the optional channel. The following yum command will be used to install 'php-snmp' from the optional channel 'rhel-6-server-optional-rpms': # yum install php-snmp --enablerepo=rhel-6-server-optional-rpms NOTE: Once you install the 'php-snmp' package from RHN using the optional channel, you need to enable the optional channel in order for future RHN updates to succeed. The 'php-snmp' package has dependencies on 'php-common' so you cannot update the core php packages from the 'rhel-6-server-rpms' RHN channel without also updating 'php-snmp' at the same time. If you did not register your RHEL installation with the RHN, download the package from the web. Check the PHP package version on your machine: "rpm -qi php". Download the PHP-SNMP package of the same version that matches your machine's PHP package. - Import the RPM key for installing the CentOS 6.x packages: # rpm --import http://mirror.centos.org/centos/6/os/x86_64/RPM-GPG-KEY-CentOS-6 - Install the 'php-snmp' package using the appropriate command based on your OS version. The following are example commands for RHEL 6.2, 6.1 and 6.0 respectively: # rpm -i http://mirror.centos.org/centos/6.2/os/x86_64/Packages/php-snmp-5.3.3-3.el6_1.3.x86_64.rpm # rpm -i http://mirror.centos.org/centos/6.1/os/x86_64/Packages/php-snmp-5.3.3-3.el6.x86_64.rpm # rpm -i http://vault.centos.org/6.0/os/x86_64/Packages/php-snmp-5.3.2-6.el6.x86_64.rpm 2. Ensure your MySQL packages are from your RHEL distribution or downloaded from Red Hat Network, not from MySQL's download page (www.mysql.com). ========================= 5. Installation ========================= These steps describe the installation of RTM with RedHat Linux using the normal installation package. Prerequisites: - The intended RTM host must have ports 80 (default Apache web server) and 8089 (RTM advocate server) free for use. - If you are upgrading from a previous version, you must not have removed any components included with Platform RTM SAS Edition. - RTM requires access to the LSF master servers on the LIM port using both TCP and UDP protocols. Make sure a firewall on the LSF master machine is not blocking the RTM host from using these ports. - The LSF cluster that RTM monitors must have a shared LSF configuration and a shared directory for RTM host to access. Note: We recommend that the intended RTM host be registered with the Red Hat Network (RHN). If it is not, you will need to manually install any required packages in step 4. Optional: During Platform RTM installation, you may see the following warning messages: warning: rrdtool-1.2.27-3.el5.x86_64.rpm: Header V3 DSA signature: NOKEY, key ID 119cc036217521f6 warning: php-json-1.2.1-5.fc6.x86_64.rpm: Header V3 DSA signature: NOKEY, key ID ­82ed95041ac70ce6 warning: python-cherrypy-3.1.2-1.noarch.rpm: Header V3 DSA/SHA1 Signature, key ID 6b8d79e6: NOKEY This is because the local system's RPM database does not have the required keys to validate the signatures of these packages. To avoid the warnings, download the following keys and import them into the system RPM database before installing RTM: rrdtool-1.2.27-3.el5: #rpm --import http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL php-json-1.2.1-5.fc6: #rpm --import http://archives.fedoraproject.org/pub/archive/fedora/linux/extras/RPM-GPG-KEY-Fedora-Extras python-cherrypy-3.1.2-1 #rpm --import http://apt.sw.be/RPM-GPG-KEY.dag.txt 1. Log into the intended RTM host as root. 2. Run the installation package. rtm2.0.8_sas_rhel_.bin [-y] [-l ] [-d ] [-C][-e | -m -t ] [-p ] [-n ] [-i ] [-g] [-a ] [-b | -r [-s rsh | ssh]] [-h] The following general options are optional: -y Enables silent installation. RTM installs without prompting you for any information. If you also specify "-C", the installer will drop the previous "cacti" database from MySQL (if it exists) without prompting you for confirmation. Note: Specifying this option indicates that you accept the open source license agreements and the License Agreement for Platform RTM Data Poller. -l Specifies the path to the license file. The installer will copy this file to /rtm/etc/rtm.lic after installation. If you are upgrading from a previous version, you do not have to specify a license file, in which case the installer will not update the license file. -d Specifies the path to the installation files. If you do not set this path, then by default RTM will be installed under /opt. Make sure that there is enough free disk space. RTM installation requires a minimum of 40 GB of disk space. -C Deletes the "cacti" database from MySQL, if it exists. Use this option to delete a pre-existing Cacti database prior to installing a fresh copy of Platform RTM. Note: Do not use this option if you are upgrading from a previous version. -h Displays the installation package usage and exits. Use the following options if you want the installer to automatically add an LSF cluster. You cannot use these options if you are upgrading from a previous version of Platform RTM SAS Edition. You must use either -m and -t, or -e; the other options are optional: -e Specifies the LSF_ENVDIR path. Use this option if the intended RTM host has access to the shared LSF_ENVDIR directory from the LSF master host. -m Specifies the name of the LSF master host. If you specify this option, you must also specify the -t option. -t Specifies the LSF LIM port number. If you specify this option, you must also specify the -m option. Default: 7869 -p Specifies the LSF version. The RTM installer uses this to determine which version of the RTM poller to use to poll the cluster. Valid values: * 62: LSF 6.2 * 702: LSF 7.0.2 * 705: LSF 7.0.5 * 706: LSF 7.0.6 * 801: LSF 8.0.1 Default: The installer automatically obtains this using the LSF lsid command, or uses "801" if lsid gives an incorrect version -n Specifies the name of the LSF cluster. Default: The installer automatically obtains this using the LSF lsid command, or uses "defaultCluster" if lsid does not find the cluster name. -i Specifies the IP address of the LSF master host. Use this option if the LSF master host IP address cannot be resolved by RTM -g Specifies that EGO is disabled in the LSF cluster. WARNING: Do not specify this option if your LSF cluster has EGO enabled, otherwise cluster monitoring and control will not work in RTM for this cluster. Default: EGO is enabled. -a Specifies the primary administrator of the LSF cluster. -b Prevents the installer from adding the local host as an LSF client to the cluster. Do not use -b if you are using -r. -r Reconfigures the cluster after adding the local host to the cluster successfully. Do not use -r if you are using -b. -s rsh | ssh Use with -r only. Specify using rsh or ssh to log into the LSF master host to reconfigure the cluster. Default: Log into the LSF master host using rsh. 3. If you did not specify the "-y" option, read and accept the open source license agreements and the License Agreement for Platform RTM for SAS Data Poller. You must read and accept the open source license agreements. In order to install and use the Platform RTM for SAS LSF data pollers, you must also accept the License Agreement for Platform RTM for SAS Data Poller. If you do not accept the License Agreement for the Platform RTM for SAS data poller, the installer will only install the open source components, not the Platform RTM for SAS LSF data pollers. However, you must accept this agreement if you are upgrading from a previous version of Platform RTM SAS Edition. 4. The installer checks to see if RTM-required dependent packages are installed. If any packages are missing, the installer exits after providing a list of missing packages along with the command you need to install them. If the installer indicates that you have missing packages, install the missing packages and restart the installation. 5. If you specified details for the LSF cluster to be added to RTM, check the installer output to see if the LSF cluster was added successfully. If the cluster was not added successfully, you need to add the cluster manually using the RTM Console. 6. If you want the UNIX log file entries in the Syslogs page to show the hosts in your LSF cluster, add the RTM host to LSF cluster hosts that you want to be shown. a. Log into a host in the LSF cluster. b. Edit the /etc/syslog.conf file. vim /etc/syslog.conf c. Add the IP address of the RTM host to the file and save your changes. *.* @ For example, if your RTM host IP address is 192.168.1.5, add the following to the syslog.conf file. *.* @192.168.1.5 d. Restart the syslog service to apply your changes. service syslog restart e. Repeat these steps for all LSF cluster hosts that you want to have displayed in the Syslogs page. 7. To check for issues or errors that may have occurred during installation, refer to /var/log/rtm.install.log 8. Start the MySQL server. 9. If you have not started MySQL before, set a password for the MySQL root user and secure the MySQL installation. Use the mysql_secure_installation utility included with MySQL to improve the security of your MySQL installation: /usr/bin/mysql_secure_installation In addition to setting a password for the MySQL root user, this utility also allows you to remove the test databases and anonymous users that are created by default. These options are strongly recommended for production servers. For more details, refer to the MySQL documentation. ========================= 6. Installation using the ISO image ========================= These steps describe the installation of RTM with CentOS using the ISO image. Prerequisites: The intended RTM host must have ports 80 (default Apache web server) and 8089 (RTM advocate server) free for use. 1. Download the appropriate RTM ISO for your platform from the FTP site and burn the image onto a CD or DVD. 2. Reboot the intended RTM host or virtual machine with the CD or DVD. 3. Follow the dialog prompts to complete the installation. The installer will then install CentOS and RTM onto the host. After the installation is complete, the host will restart and you will have a CentOS distribution with RTM installed. Note: Using the ISO image will not allow you to add a cluster during installation. In addition you must use the RTM Console to apply the license file. For more details on applying the license file, refer to "Configuring date, time, and license information" in the Platform RTM Administrator Guide. ========================= 7. Uninstallation ========================= To remove RTM, run the installation package with the -U option: rtm2.0.8_sas_rhel_.bin -U [-C] The following is optional: -C Deletes the "cacti" database from MySQL, if it exists. The installer will run the "rpm -e" command on the known RTM packages to remove them. The installer logs any errors and messages to the /var/log/rtm.install.log file. ========================= 8. Copyright ========================= 2000-2012 Platform Computing Inc. Although the information in this document has been carefully reviewed, Platform Computing Corporation ("Platform") does not warrant it to be free of errors or omissions. Platform reserves the right to make corrections, updates, revisions or changes to the information in this document. UNLESS OTHERWISE EXPRESSLY STATED BY PLATFORM, THE PROGRAM DESCRIBED IN THIS DOCUMENT IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT WILL PLATFORM COMPUTING BE LIABLE TO ANYONE FOR SPECIAL, COLLATERAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING WITHOUT LIMITATION ANY LOST PROFITS, DATA, OR SAVINGS, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM. This document is protected by copyright and you may not redistribute or translate it into another language, in part or in whole. Internal redistribution You may only redistribute this document internally within your organization (for example, on an intranet) provided that you continue to check the Platform Web site for updates and update your version of the documentation. You may not make it available to your organization over the Internet. Trademarks LSF is a registered trademark of Platform Computing Corporation in the United States and in other jurisdictions. ACCELERATING INTELLIGENCE, PLATFORM COMPUTING, PLATFORM SYMPHONY, PLATFORM JOBSCHEDULER, PLATFORM ENTERPRISE GRID ORCHESTRATOR, PLATFORM EGO, and the PLATFORM and PLATFORM LSF logos are trademarks of Platform Computing Corporation in the United States and in other jurisdictions. UNIX is a registered trademark of The Open Group in the United States and in other jurisdictions. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. Microsoft is either a registered trademark or a trademark of Microsoft Corporation in the United States and/or other countries. Windows is a registered trademark of Microsoft Corporation in the United States and other countries. Intel, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Other products or services mentioned in this document are identified by the trademarks or service marks of their respective owners. Third-party license agreements http://www.platform.com/Company/third.part.license.htm ============================== Revised: June 2012 End: README for Installing RTM for SAS on Linux