Ensim Corporation


Installing Ensim® Pro and Ensim Basic 3.7 for Linux® (LS) on an existing Fedora™ 1.0 server

January 2, 2004

Introduction

This guide provides instructions on installing Ensim® Pro and Ensim Basic 3.7 for Linux® (LS) on a pre-configured Fedora™ Core 1.0 server using the Installer.

Note icon

For simplicity, we refer to Ensim Pro and Ensim Basic 3.7 for Linux (LS) as Ensim Control Panel throughout this document.

Installing Ensim Control Panel simply involves creating an Installer file (completing the Installation wizard will create this file), then downloading and running this Installer file on the target server. The time required to install Ensim Control Panel is approximately 30 to 40 minutes.

Important icon

Please ensure that the pre-installed Fedora setup meets the following minimum specifications:

Package Group Selection: Network Servers and Text-based Internet
You must select the ncftp package listed in the Package Group Text-based Internet. 
You can opt for an installation type of your choice.

Sections in this guide include:

Before you install

The following section describes the minimum system requirements and provides a checklist to help you prepare for the installation.

System requirements

Your system must meet the following minimum requirements.

Table 1. Requirements for installing Ensim Control Panel 
Requirement
Description
Processor
Intel Pentium® II or III processor, class 500 MHz or above or any Intel-compatible CPU of 500 MHz speed or above
RAM
256 MB
Disk space
At least 20 GB. 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 3.7 for Linux Technical Reference Guide at http://www.ensim.com/support/index.html. The document is not available with this release, but will be available shortly.
Disk partitions
/boot: At least 50 MB
/: All of the remaining disk space since Ensim Control Panel uses the /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 3.7 for Linux Technical Reference Guide at http://www.ensim.com/support/index.html. The document is not available with this release, but will be available shortly.
Connectivity
Network connectivity with access to Internet
Other requirements
  • Ensim Control Panel CD-ROMs (if you want the Installer to obtain installation files from the CD-ROM)
  • DNS server on network
Fedora Core 1.0 Installation type
  • Server
  • Workstation
  • Full (select the “Custom” option and install ALL packages)
  • Custom
  • Personal Desktop
Package Group selection
ANY of the package groups listed on the Package Group Selection screen
Additional requirements
  • “root” user access
  • The file /etc/hosts file on the target server has to contain the server’s host name and IP address, as shown in the following example. If it does not, use an editor to modify the file.

    • ---/etc/hosts begin file--

    127.0.0.1 localhost.localdomain localhost

    1.2.3.4 myhost.mydomain.com myhost

    ---/etc/hosts end file--

    where 1.2.3.4 is the IP address of myhost.mydomain.com

Installation checklist

Use the following checklist to verify that you have adequately prepared your system for a successful installation.

Table 2. Installation checklist
1. Verify that you have access to the following
Requirement
Description
Status
Target server’s swap partition size
The target server must have a minimum of 256 MB swap partition size. For information on customizing disk partitions, refer to the document, Ensim Pro 3.7 for Linux Technical Reference Guide at
http://www.ensim.com/support/index.html. The document is not available with this release, but will be available shortly.
o
2. Choose the software repository that you want to use for installing Ensim Control Panel
Requirement
Description
Status
Ensim FTP server
The Installer obtains the installation files from the Ensim FTP server. The Installer knows the address of the Ensim FTP server.
None required
Ensim Control Panel CD-ROMs
Two Ensim Control Panel CD-ROMs (purchased from https://buy.ensim.com). The Installer obtains the installation files from the CD-ROMs.
o
Local FTP server
The Installer obtains the installation files from your local FTP server.
You will need to configure the local FTP server. For instructions, see Setting up a local FTP server to install Ensim Pro and Ensim Basic 3.7 for Linux (LS) at
http://www.ensim.com/support/index.html
o

Installing Ensim Control Panel

The following section provides instructions for installing Ensim Control Panel.

Note icon

Before you follow the instructions in this section, run the Installation Wizard and download the Installer file LWPInstaller.sh to the Fedora Core 1.0 server where you want to install Ensim Control Panel. If you have not downloaded the Installer file, please visit https://lwpwizard.ensim.com/webgui/overview.php and run the wizard.

Procedure icon

To install Ensim Control Panel:

  1. Log on to the Fedora Core 1.0 server where you downloaded the Installer file.
  2. Change to the directory where you saved the Installer file.

    3. #cd /<dir_name> where <dir_name> is the name of the directory where you downloaded the Installer file.

  3. Run the Installer by typing the following command at the prompt:

    4. #sh LWPInstaller.sh

    If you chose the Ensim Control Panel CD-ROM option in Step 3 of the wizard, you will be prompted to insert the CD-ROMs (disk 1 and disk 2).

  4. Optional: Insert the Ensim Control Panel CD-ROM disks (when prompted) in the disk drive of your target server and press Enter.

    5. The Installer begins installation of Ensim Control Panel. All the services and add-ons provided by Ensim Control Panel are installed.

    Note icon

    You must install the Power Tools license to use the Power Tools add-on. See Appendix A: Installing the Power Tools license for details.

  5. After installation, you need to set up Ensim Control Panel before you can access or perform administrative tasks. To set up Ensim Control Panel, open a Web browser, enter the URL http://<server host name (or IP address)> and fill in the required setup information.



Appendix A: Installing the Power Tools license

You must install the Power Tools license before Site Administrators can install and configure the required tool. If the Power Tools license is not installed, Site Administrators will get the following error message when they attempt to install a tool, “ERROR: Power Tools License is not installed. Please install a Power Tools License.”

Procedure icon

To install the Power Tools license:

  1. Log onto the Appliance Administrator control panel.
  2. In the System Menu section, click Configuration.
  3. In the Configuration sub-menu, click License.

    4. The License page opens, displaying the Ensim Control Panel license.

  4. Click the Install/Upgrade Power Tools License tab.
  5. Select one of the following options to install the license.
    • Upload License File. Locate the file on your desktop, and click Upload to upload the license.
    • Copy & Paste License File. Copy the license content into the License text box and click Paste Power Tools License.

      • The Power Tools License is installed.

Appendix B: Troubleshooting installation issues

If you encounter problems that you cannot troubleshoot or resolve using the information in Table 3 or the log files (see Log files), contact Ensim for online support at https://onlinesupport.ensim.com

Table 3. Troubleshooting installation issues (Installer)  
Symptom
Description
Solution
When you run the command,
“hostname” the value "myhost" is returned by the command instead of “myhost.mydomain.com”.
The host name of the server is incorrect.
Check the file /etc/sysconfig/network. The host name must be a fully qualified domain name. See the following example.
Incorrect: myhost
Correct: myhost.mydomain.com
Unable to connect to Ensim’s FTP server.
Failed to download the metadata from ftp.ensim.com.
Error initializing setup.
Ensure that you are connected to the Internet.
Refer to the updates.log file located at /var/log/ensim/
Cannot download Ensim Control Panel.
Error downloading Ensim Control Panel.
Ensure that you are connected to the Internet.
Refer to the updates.log file located at: /var/log/ensim/
During installation, the following message is displayed: check_hostname <FAILED>.
The host file is
incorrect.
The file /etc/hosts should contain the host name and IP address of your server (see the following example). If it does not, use an editor to modify the file.
Example 
---/etc/hosts begin 
file-- 
127.0.0.1 local-
host.localdomain lo-
calhost 
1.2.3.4 myhost.mydo-
main.com myhost 
---/etc/hosts end 
file--
where 1.2.3.4 is the IP address of myhost.mydomain.com
Cannot download or install updates.
Error downloading/installing updates.
The error log contains a list of all the updates that could not be downloaded. Download these updates and install them on the server, before re-starting the server to install Ensim Control Panel.
Refer to the updates.log file located at: /var/log/ensim/

Log files

Ensim Control Panel creates log files that record various actions and events that qualify an installation. You may refer to the log files to troubleshoot fault points encountered during an installation. The log files are emailed to the specified email address.

Table 4. Log files and their description 
File name
Location
Description
updates.log
/var/log/ensim/
Maintains a list of actions recorded while:
  • Downloading and installing the installation RPMs
Provides the following information:
  • Name of the event
  • Status of the event—whether the event was completed with success or encountered warnings or errors.
updates.err
/var/log/ensim/
Maintains a list of unsuccessful events that occurred during the download and installation of the installation RPMs. Only error messages are recorded in this file.
Provides the following information:
  • Brief description of the error
  • Action to be taken to resolve the error
installer.log
/var/log/ensim/
Maintains a list of successful and unsuccessful events recorded during the installation of Ensim Control Panel.
installer.err
/var/log/ensim/
Maintains a list of unsuccessful events recorded during the installation of Ensim Control Panel.
setup.log
/var/log/appliance/
Maintains a list of actions recorded during the setup of Ensim Control Panel. Both successful and unsuccessful events are recorded in this file.
setup.err
/var/log/appliance/
Maintains a list of unsuccessful events recorded during the setup of Ensim Control Panel.
Provides the following information:
  • A brief description of the error
  • Cause of the error

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 and the Ensim logo 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