Ensim® Pro and Ensim Basic 4.0 for Linux® (LS) Installation GuideSeptember 13, 2004
Introduction
This guide provides instructions on installing Ensim® Pro and Ensim Basic 4.0 for Linux® on a Linux server running the Fedora™ Core 1.0 or the Red Hat® Enterprise Linux ES Release 3 operating systems.
For simplicity, we refer to Ensim Pro and Ensim Basic 4.0 for Linux as “Ensim Control Panel,” Fedora Core 1.0 as “Fedora 1.0,” and Red Hat Enterprise Linux ES Release 3 as “RHEL 3,” throughout the document.
Topics include:
Before you install
The following sections describe the minimum system requirements and provides a checklist to help you prepare for the Ensim Control Panel installation. Your system must comply with the stipulated system requirements and the list of packages.
System requirements
Your system must meet the following minimum requirements for installing Ensim Control Panel. The requirements are common to both Fedora 1.0 and RHEL 3 servers except where indicated otherwise.
/home partition to store the site information.You may want to customize your disk partitions to manage the available disk resources on the target server. For information on customizing disk partitions, refer to the document Ensim Pro 4.0 for Linux Technical Reference Guide at http://www.ensim.com/support/pro/linux/index.html.
CD-ROM (if you want the Installer to obtain the installation files from the
CD-ROM)
- DNS server on network
- “root” user access
- The system files /etc/hosts, /etc/resolv.conf, /etc/sysconfig/network, and /etc/sysconfig/network-scripts/ifcfg-eth0 on the target server must include the entries as specified below. If the entries are not present, use an editor to modify the files.
- /etc/hosts file
---/etc/hosts begin file--
127.0.0.1 localhost.localdomain localhost
1.2.3.4 myhost.mydomain.com myhost
---/etc/hosts end file--- /etc/resolv.conf file
---/etc/resolv.conf begin file--
primary_name_server ip_address
secondary_name_server ip_address
---/etc/resolv.conf end file--- /etc/sysconfig/network file
---/etc/sysconfig/network begin file--
NETWORKING=yes
DOMAIN=mydomain.com
HOSTNAME=myhost.mydomain.com
GATEWAY=ip_address_gateway
---/etc/sysconfig/network end file--
- /etc/sysconfig/network-scripts/ifcfg-eth0 file
---/etc/sysconfig/network-scripts/ifcfg-eth0 begin file--
DEVICE=eth0
ONBOOT=yes
BOOTPROTO=static
IPADDR=IP_address_host_server
NETMASK=netmask_value (please check with your service provider)
GATEWAY=ip_address_gateway---/etc/sysconfig/network-scripts/ifcfg-eth0 end file--
Required list of packages
The following section lists the packages and additional RPMs essential to a successful installation. The list of packages and RPMs required for the installation vary for Fedora 1.0 and RHEL 3 servers.
List of packages required for Fedora 1.0 servers
You must select the following package groups.
- Network Servers
- Text-based Internet
You can opt for any of the following installation types—Server, Workstation, Full (select the Custom option and install ALL packages), Custom, Personal Desktop.
List of packages and additional RPMs required for RHEL 3 servers
You must install certain packages and additional RPMs on your RHEL 3 server before you install Ensim Control Panel. Please refer to the section Appendix A: Installing the required packages and RPMs on RHEL 3 servers for detailed instructions.
Installation checklist
Use the following checklist to verify that you have adequately prepared your system for a successful installation.
http://www.ensim.com/support/pro/linux/index.html.
Installing Ensim Control Panel
The following section provides instructions for installing Ensim Control Panel on a Fedora 1.0 or RHEL 3 server. The Installer installs Ensim Control Panel in the text mode; curses-based installation is no longer supported.
Please ensure that your system meets the requirements for a successful installation. Please review the sections System requirements and Required list of packages before you install.
To install Ensim Control Panel:
- Log on to the server on which you want to install Ensim Control Panel.
- Obtain access to the Installer script ensim-installer.sh from one of the following repositories.
Option 1: Ensim Control Panel CD-ROM
You must purchase the Ensim Control Panel CD-ROM from the storefront
https://buy.ensim.com.Mount the CD-ROM to access the Installer script.
You do not have to mount the CD-ROM if you have enabled AutoMount on your server.
- Browse to the Installer script ensim-installer.sh (located at /mnt/cdrom).
Option 2: FTP server
Download the Installer script ensim-installer.sh from the Ensim support page
http://www.ensim.com/support/downloads.html.
The actions and events that qualify an installation are temporarily logged in the file /tmp/install.log.<pid_no> where <pid_no> is the process ID of the installation process. The contents of the temporary log file are later appended to the file /var/log/ensim/installer.log, which can be viewed after the completion of the installation process. To examine the log messages during the installation, you must refer to the temporary log file /tmp/install.log.<pid_no>. The name of the log file can be obtained from the message
Logging to file /tmp/install.log.<pidno> displayed at the start of the installation. Please note the file name in the message for future reference.
#sh ensim-installer.sh --email=<email_address>
where --email is the email address to which success or error messages are sent
You must use the --email option with the script to receive email messages on the status of the installation.
Example
In the following example, the command installs Ensim Control Panel by obtaining the necessary files from Ensim’s FTP server.
#sh ensim-installer.sh --email=admin@example.com
If you want the Installer to obtain the installation files from a local FTP server, you must use the --ftp-server option and specify the host name of the FTP server, otherwise the Installer defaults to Ensim’s FTP server.
The Installer begins installation of Ensim Control Panel. Before installing Ensim Control Panel, the Installer automatically runs the System Checker to ensure that your system is compatible for a successful installation. See Appendix B: Overview of the Ensim Control Panel System Checker for more information about the System Checker.
All the services and add-ons provided by Ensim Control Panel are installed.
If you encounter problems during the installation, please use the information in the section Appendix C: Troubleshooting installation issues to resolve them.
Appendix A: Installing the required packages and RPMs on RHEL 3 servers
The following section explains how to install the required list of packages and additional RPMs essential for the successful installation of Ensim Control Panel.
If you are installing RHEL 3 on your own, please ensure that you select only the packages listed in Step 2. Once you confirm that the required packages are installed, install the additional RPMs as mentioned in the section Installing additional RPMs.
However, if you are working with a pre-configured RHEL 3 server, the package selection is already done. It may, or may not, reflect the required set in Step 2. If the packages are different from this list, you must review the section Installing the complete set of RPMs and install all the RPMs listed in Table 3.
Selecting packages
Select the listed package groups as specified in the procedure.
To select the packages during the installation process:
Installing additional RPMs
This section assumes that you have the required package groups installed—as specified in Step 2.
This section lists the base set of RPMs that must be installed on the server before you install Ensim Control Panel. The RPM versions specified indicate the minimum requirement. You may install a later version of the RPM from the same distribution.
To install the additional RPMs:
- Log on to the server on which you want to install Ensim Control Panel.
- Create a directory extra_rpms to store the additional RPMs.
- Copy the following RPMs from the RHEL CD-ROMs.
- compat-db-4.0.14-5.i386.rpm
- compat-slang-1.4.5-5.i386.rpm
- freetype-devel-2.1.4-4.0.i386.rpm
- httpd-devel-2.0.46-25.ent.i386.rpm
- ImageMagick-5.5.6-4.i386.rpm
- libjpeg-devel-6b-30.i386.rpm
- libpng-devel-1.2.2-16.i386.rpm
- libtiff-devel-3.5.7-13.i386.rpm
- libxml2-python-2.5.10-5
- php-odbc-4.3.2-8.ent.i386.rpm
- php-mysql-4.3.2-8.ent
- php-pgsql-4.3.2-8.ent.i386.rpm
- rh-postgresql-7.3.4-8.i386.rpm
- telnet-server-0.17-26
- Next, log on to the Red Hat Network site http://rhn.redhat.com with your user name and password to download the following RPMs from the Red Hat Network site.
- Click the Channels tab at the top of the page.
- In the ChannelName column, click the link Red Hat Enterprise Linux ES (v. 3 for x86) Extras.
- At the top of the Details page, click the Packages link. The list of packages display.
- Select the packages listed in Step 4, and click Download Packages.
- Verify that all RPM dependencies are satisfied.
#rpm -Uvh *.rpm --test
If a dependency error is evidenced, install the required RPM before proceeding to install the additional RPMs.
- Install the additional RPMs using the following command.
#rpm -Uvh *.rpm
Installing the complete set of RPMs
This section assumes that you do not have the required packages installed—as specified in Step 2.
Table 3 lists the complete set of RPMs that are required for the successful installation of Ensim Control Panel. If you do not have the necessary RPMs installed, you must install them before you install Ensim Control Panel. The RPM versions specified indicate the minimum requirement. You may install a later version of the RPM from the same distribution.
The RPMs in boldface indicate the RPMs that are not available on the RHEL CD-ROMs. These RPMs must be downloaded from the Red Hat Network site http://rhn.redhat.com.
Appendix B: Overview of the Ensim Control Panel System Checker
Before installing Ensim Control Panel, the Installer performs a system check to ensure that your system provides a compatible platform for successful installation. The System Checker reports potential conflicts and ways to resolve them. At the end of the check it displays the number of errors or warnings encountered. The results of the system check (list of checks, status of each check, and details about errors or warnings) are logged in the file /var/log/ensim/installer.log and can be viewed after the completion of the installation process. If you want to view the log details after the system check, please refer to the temporary log file.
Interpreting the results of the system check
As the System Checker performs each check, it displays the name and brief description of the check and the outcome of the check.
The outcome can be any of the following:
- OK. Displayed when the check is successful
- WARNING. Displayed when the check encounters an exception that may interfere with the installation process
- ERROR. Displayed when the check encounters an exception that will interfere with the installation process and cause it to fail
When the outcome of the check is a warning or an error, details about the exception are provided.
The System Checker report provides the following information:
- A detailed list of exceptions observed on the server
- Recommended actions to be performed
The actions recommended provide broad solutions for resolving the observed exceptions. If the actions for resolving the exceptions are appropriate for your server, you must execute them as mentioned. After performing the recommended actions, you must restart the installation by running the ensim-installer.sh script. To restart the installation, please follow the instructions from step 3 specified in the section Installing Ensim Control Panel.
At the end of the check, a summary of the results is displayed, in the following format:
SUMMARY for <hostname>: <n> error(s), <m> warning(s), with issues
Where:
- <hostname> is the name of your Ensim Control Panel server
- <n> indicates the number of errors
- <m> indicates the number of warnings
Appendix C: Troubleshooting installation issues
The following section describes issues that you may encounter during the installation.
If you encounter problems that you cannot troubleshoot or resolve using the information in Table 4 contact Ensim for online support at https://onlinesupport.ensim.com. You may also refer to the log file installer.log to review the list of successful and unsuccessful events recorded during the installation. The log file is located at /var/log/ensim and is emailed to the specified email address.
Feedback and support
To take advantage of Ensim's support services or to find additional product documentation, visit the Ensim support site, http://support.ensim.com.
To log in to Ensim online support, go to https://onlinesupport.ensim.com.
To provide feedback about Ensim products or documentation, please use the feedback form at http://www.ensim.com/about/feedback.asp.
Legal and copyright notice
This document contains information proprietary to Ensim Corporation and its receipt or possession does not convey any rights to reproduce, disclose, manufacture, or sell anything it might describe. Reproduction, disclosure, or use without Ensim’s specific written authorization is strictly forbidden.
Ensim Corporation makes no representations or warranties with respect to the content or use of this document. It also reserves the right to revise this document at any time without the obligation to notify any person of such revision.
Ensim, the Ensim logo, and ServerXchange are registered trademarks of Ensim Corporation.
All other trademarks and copyrights are the property of their respective owners.
© 2004 Ensim Corporation. All rights reserved.
|
Ensim
Corporation www.ensim.com Contact Ensim www.ensim.com/about/contact.html |
