Installing MCS and Management Components on UNIX

Management and & Control Services (MCS) and management components can be installed under either Windows or UNIX. The following procedure explains how to install MCS and management components in UNIX environments. You can install using either the default Attachmate HTTP engine or a WebLogic application server. For information about installing in a Windows environment, see Installing MCS and Management Components on Windows.

If you use WebLogic, your WebLogic domain must exist before you begin the installation. If you need to create a new domain, do so using one of the methods provided by BEA.

To install MCS and management components

If necessary, create your WebLogic domain.

Insert the CD that contains the components you want to install, and copy the appropriate file from the CD to your computer.

To install	On this CD	Copy
MCS and the EXTRA! managers for most UNIX environments	Full-featured Emulation Options	/Tar-Ball/EXTRAEmulation.tar.gz
MCS and the EXTRA! managers for OS/390 and z/OS USS environments	Full-featured Emulation Options	/Tar-Ball/EXTRAEmulationUSS.tar.gz
MCS and Terminal Viewers	Browser-based Emulation	BrowserBasedEmulation.tar.gz

For most UNIX environments, to expand the archive into its own empty directory, type the following from the command line:
gunzip -c filename.tar.gz | tar xvf -

where filename is the name of the file you copied from the CD. For example, to expand the tar file for MCS and the EXTRA! X-treme managers, type the following:

gunzip -c EXTRAEmulation.tar.gz | tar xvf -

-or-

For OS/390 and z/OS USS environments, unzip the EXTRAEmulationUSS.tar.gz file on your desktop, transfer the .tar file to the mainframe, and then use the tar command to expand the archive, as follows:

tar -xovf EXTRAEmulationUSS.tar
Change to the directory for your product, for example EXTRAEmulation, and run ./setup.sh.
Review and accept the terms of the license agreement.

Select the components that you want to install, and follow the prompts.

For	You can select
MCS and the EXTRA! managers	Distributable MSI Files for EXTRA! X-treme, the EXTRA! X-treme Connections Pack, and the EXTRA! X-treme Options Pack Management and Control Services Framework EXTRA! X-treme Manager Presentation Manager FTP Client Manager
MCS and Terminal Viewers	Management and Control Services Framework Terminal Viewers Presentation Manager

For more information about the components you can install, see Choosing the Right Components to Install.

The information that you are prompted for varies, depending on which components you are installing. For information about the installation prompts, see Installation Prompts for Management Components (UNIX).

For Solaris, required patches are searched for by the installer. Warning messages are displayed for each path not found. For other environments, you should check with the manufacturer for required patches because, although patches may be required, they are not detected by the installation program.

Before you add a server to an existing MCS cluster, make sure that you have selected to install all of the management components that are already installed on the other servers in that cluster. If you cannot install the same components as part of this installation process (for example, if the servers in the cluster have components from more than one Attachmate product), install this server as a standalone server, and then after you have installed all the necessary components, use the MCS console to add the server to an existing cluster.

When the installation is complete, review the summary information and then press ENTER.

Installation Notes

Installing with limited rights
When you install EXTRA! components, if you are not logged on as the root user or if you do not have root-level rights, your installation location may be limited to your own home directory.
Installing on computers with inadequate memory
To avoid errors associated with attempting to run on a computer with limited RAM or virtual memory, edit attachmateinstalldir/catalina.sh before running the EXTRA! installation. Change the first value in the line
JAVA_OPTS=\"-Xms256m -Xmx256m \"\\
to something smaller, for example,
JAVA_OPTS=\"-Xms32m -Xmx256m \"\\.
If you do not make these changes, you may encounter problems such as being unable to log in to MCS. You can check for associated errors in the EXTRA_setup.log, such as "unable to allocate memory" or "heap allocation failure."
Adjusting the Java VM heap size
The Java VM heap size may need to be adjusted to allow for the number of sessions or threads running in your environment. As noted above, this option can be changed in attachmateinstalldir/catalina.sh, either before or after installation.
Running EXTRA! Mainframe Server Edition as a z/OS started task
During installation, procedures, contained in InstalledLocation/EXTRA.PROC and EXTRAP.PROC, are created that can be added as members of your PROCLIB so that you can run EXTRA! Mainframe Server Edition as a z/OS started task. For information about started tasks, contact your system administrator or refer to the documentation for your host computer.


	Installation, Overview
	Choosing the Right Components to Install
	Installation Prompts for Management Components (UNIX)
	Installing MCS and Management Components in Windows