Installing a Requestor

To install the .NET requestor on a machine running Windows 2000 Server or Windows 2003 Server:

1. Insert the product CD into the CD drive.

   If the setup utility does not run automatically, browse to the CD root directory and double-click autosetup.exe.

2. Select Install .NET Requestor.

3. Type the access code for your installation, and then click Next.

   The access code is located on the Attachmate Software License Agreement or the Attachmate Additional License Agreement.

4. Respond to the subsequent prompts.

The following procedure explains how to install these components in UNIX environments.

To install the Java requestor on a machine running a non-Windows operating system:

1. From the product CD, copy the file CICS_Bridge.tar.gz to your computer.

2. To expand the archive into its own empty directory, type the following from the command line:

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

3. Change to the CICS_Bridge directory and run ./setup.sh.

4. Review and accept the terms of the license agreement.

5. Follow the remaining prompts.

   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.

6. When the installation is complete, you can return to the main menu and select other components to install.

• 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 attachmateinstalldir/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. 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 attachmateinstalldir/catalina.sh, either before or after installation.