Installing in UNIX

Management & 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.
From the product CD, copy the appropriate file to your computer. The name of the file will differ depending on the product you are installing.

To install
Copy

Synapta Services Builder for CICS Synapta_CICS.tar.gz
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 Synapta Services Builder for CICS, type the following:

gunzip -c Synapta_CICS.tar.gz | tar xvf -
Change to the product directory, for example Synapta_CICS, and run ./setup.sh.

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

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.

Review and accept the terms of the license agreement.
When the installation is complete, review the summary information and then press ENTER.
You can return to the main menu and select other components to install in turn.

Installation Notes

Reassigning file ownership
If you perform an installation while logged in as the root user, you can re-assign file ownership for all Attachmate files to another user. You can choose a user name other than the default. If this user does not exist on the system, the installation script creates it for you, and prompts you for group name, home directory, and password. If you specify a user other than the default, you must specify an existing user account for which a home directory already exists. Assigning files to a system user account such as "nobody" or "other" without an existing home directory will prevent the HTTP engine from restarting properly.
Installing with limited rights
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 Attachmate_install_directory/catalina.sh before running the 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 synapta_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 Attachmate_install_directory/catalina.sh, either before or after installation.


	Installation
	Upgrading
	Installation Prompts for Management Components (UNIX)