Installing Fedora™ Core 1.0 and Ensim® Pro and Ensim Basic 3.7 for Linux® (LS)

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

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

Note that Ensim Control Panel now supports kickstart installation using a CD-ROM installation disk.

Installing Fedora Core 1.0 and Ensim Control Panel involves the following four steps.

It takes approximately five minutes to create the installation disk and another 30 to 40 minutes to install Ensim Control Panel.

Before you install

The following section describes the minimum system requirements and provides a checklist to help you prepare for the Fedora Core 1.0 and Ensim Control Panel installation.

System requirements


Requirements for creating the installation disk
Operating system	A Windows® 98, Windows 2000, Windows NT, Windows XP, or Linux operating system
Connectivity	Internet connectivity
Disk drive	A floppy disk drive (if you choose to create a floppy installation disk) A CD-Writer disk drive (if you choose to create a CD installation disk)

Requirements for installing Fedora Core 1.0 and Ensim Control Panel
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 RAM (512 MB and above is recommended if you plan to use the Tomcat application)
Disk space	At least 20 GB
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.
Disk drives	CD-ROM drive (if you choose the CD-ROM option for installing Fedora Core 1.0, Ensim Control Panel, or for obtaining installation files. Floppy disk drive
Connectivity	Network connectivity with access to Internet
Other requirements	DNS server on network

Installation checklist

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

Table 1. Installation checklist
1. Verify that you have access to the following
Item	Description	Status
a. Kickstart installation disks
Blank floppy disk	Two formatted 3.5 inch disks.	o
Blank CD-RW disk	You need to write the ISO image onto a CD-RW disk. Note: You cannot opt for a kickstart installation of Ensim Control Panel using the CD-RW disk if you choose the CD-ROM option to install the Fedora Core 1.0 operating system.	o
b. Target server settings information
IP address with netmask	Target server’s IP address and netmask.	o
IP address of gateway	Target server’s gateway address.	o
IP address of DNS server	IP address of DNS server.	o
Target server’s RAM	Amount of RAM installed on your target server. Note: This is useful to know when you assign swap space. 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
Item	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) available at http://www.ensim.com/support/index.html	o
3. Choose the software repository that you want to use for installing Fedora Core 1.0
Item	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
FTP server	The Installer obtains the installation files from the specified FTP server. You need to specify: Server name or IP address Installation tree directory name User name and password. If you are using anonymous FTP, set the user name to “anonymous” and the password to your “email address”.	o
Fedora Core 1.0 CD-ROMs	Three Fedora Core 1.0 CD-ROMs. Note: You cannot opt for CD-ROM installation of the Fedora Core 1.0 operating system if you opt for a kickstart installation of Ensim Control Panel using the CD-ROM installation disk.	o
NFS server	You need to specify: NFS server name or IP address NFS server export directory name	o
HTTP server	You need to specify: HTTP server name or IP address Installation tree directory name.	o

Installing Fedora Core 1.0 and Ensim Control Panel

The following section provides instructions for installing Fedora Core 1.0 and Ensim Control Panel.

Before you follow the instructions in this section, run the Installation Wizard and download the Installer file to the computer where you want to create the installation disk. If you have not downloaded the Installer file, please visit
https://lwpwizard.ensim.com/webgui/overview.php and run the wizard.

Log on to the computer where you downloaded the Installer file.

Insert the floppy disk or the CD-RW disk into the respective disk drive of the computer.

To create a floppy installation disk:

Linux systems. Run the Installer LWP_makefloppy.sh using the following command.

#sh LWP_makefloppy.sh

Windows systems. Double-click the file LWP_makefloppy.exe to run the Installer.

To create a CD-RW installation disk ,write the ISO image LWP_Install.iso (using a CD-Writer application) on to the CD-RW disk.

The installation disk is created.

Eject the installation disk from the computer.

If you do not eject the disk, and you restart your desktop, the installation disk erases your desktop machine and attempts to install Ensim Control Panel and Fedora Core 1.0 on your desktop machine. Unless you remove the disk immediately, you could lose all of the data on your desktop.

Further, before you use the disk to install Ensim Control Panel on the target server, back up important data on the target server. The installation disk DELETES ALL of the data on the target server.

Insert the kickstart installation disk in the disk drive of the target server on which you want to install Fedora Core 1.0 and Ensim Control Panel.

If you have chosen to install Fedora Core 1.0 using the set of Fedora CD-ROMs, first insert the Fedora CD-ROM in the disk drive of the target server, not the installation disk.

Restart the target server by shutting it down, then turning it back on.

If you have chosen to install Fedora Core 1.0 using the set of Fedora CD-ROMs, before you kickstart the installation using the floppy installation disk, you must insert the floppy installation disk in the disk drive and at the first boot: prompt, type ks=floppy. The command instructs the Installer to obtain the kickstart configuration file ks.cfg from the floppy installation disk.

Note that the Installer does not support CD-ROM installation of both the Fedora Core 1.0 operating system and the kickstart installation of Ensim Control Panel. If you choose to install Fedora Core 1.0 using the CD-ROM option, you must choose a floppy kickstart installation to install Ensim Control Panel.

Depending on your choice of installation disk, set the appropriate disk drive as the first boot device. For information on changing the boot device, see the troubleshooting information in the section, Appendix B: Troubleshooting installation issues.

In certain older systems, you may need to eject the floppy disk after the first restart, otherwise the installation will not proceed. For additional troubleshooting information, see Appendix B: Troubleshooting installation issues.

The installation disk begins installation of Fedora Core 1.0.

When the installation completes, the server restarts.

If you are performing a CD-ROM kickstart installation, when the server restarts after installation of Fedora Core 1.0, set the hard disk drive as the first boot device, otherwise the Installer will repeat the installation of the operating system.

Optional: If you have configured the Installer to obtain the installation files from the Ensim Control Panel CD-ROM , insert the disks in the disk drive of your target server (when prompted) and press Enter.

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

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

The Installer restarts your target server to complete the installation.

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 following 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.”

Log onto the Appliance Administrator control panel.

In the System Menu section, click Configuration.

In the Configuration sub-menu, click License.

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

Click the Install/Upgrade Power Tools License tab.

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 2, or the log files (see Log files), contact Ensim for online support at https://onlinesupport.ensim.com

Table 2. Troubleshooting installation issues (Installer)
Symptom	Description	Solution
The following message is displayed when you attempt to run the installation file: `Malicious script detected`	You might have an antivirus program running and it has flagged the installation file as a potential virus.	If there are any antivirus programs running on your computer, stop them and attempt to run the installation file again.
The target server does not access the floppy/CD-ROM disk when it starts up; it simply boots normally.	The floppy/CD-ROM disk drive is not designated as the first boot device in the CMOS Setup Utility.	To set the option: Open CMOS Setup from the setup screen. Locate the boot sequence setting field. Change the default entry, to set Floppy or CD-ROM as the first boot device. Save settings, and exit CMOS Setup.
During installation, the target server freezes. The following message is displayed: `Loading aic7xxx driver.`	The system has encountered a Linux interrupt routing problem.	If your system has any unusual hardware, such as a motherboard with an Intel 440GX chipset, you need to pass additional options to the kernel when you start the system. To do so, you need to create a new installation disk and choose to pass the additional options (step 5 of the wizard).
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
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 localhost.localdo- main 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`
The installation fails and the login prompt is set to localhost.localdomain.	The host name is set to localhost.localdomain value.	Check the IP address of the target server. The IP address of the target server must be a valid DNS entry. You will need to create an installation disk again. Refer to the updates.log file located at: /var/log/ensim/
Unable to connect to Ensim’s FTP server.	Failed to download the metadata from Ensim’s FTP server. Error initializing setup.	Ensure that you are connected to the Internet. Refer to the updates.log file located at: /var/log/ensim/
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/
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/

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 3. 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.

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.

All other trademarks and copyrights are the property of their respective owners.