First Time IT or CSE Installation

Installing CA Gen on UNIX and Linux › First Time IT or CSE Installation

First Time IT or CSE Installation

Although you need a root account to install CA Gen products, root should not own the product files. The USD creates and modifies root-controlled files to manage the installation.

Follow these steps:

Log in as a root user to begin the installation process on all UNIX and Linux platforms.
Note: The root user must be using the Bourne shell, sh, or one of its descendants, ksh or bash.
Create UNIX or Linux user login accounts and groups for the IT and for the CSE, if they do not exist. You can use the same user for both components. These users own the installation after it finishes. To increase security, the user and group cannot be privileged accounts such as root or sys.
Change directories to the CA Gen download folder and execute the setup program:
```
cd /<CA Gen download folder>
./setup (or ./setup -I instance_name)
```
Note: The Installation dialogs display in Graphical User Interface (GUI) mode or VT100 mode (character terminal interface). When these conditions exist, dialogs display in GUI mode:
- The JRE release that is defined in the Technical Requirements is available, enter the following command to know the JRE version:
```
java -version
```
- You have an X Terminal or an X-Terminal emulator on your desktop.
- Your DISPLAY environment variable is set appropriately for your X-Terminal.
- The Java \bin directory must be in your PATH.
- Set JAVA_HOME to the directory in which Java is installed
- When these conditions fail to exist, the dialogs display in VT100 mode. To force VT100 mode, use the -V argument with setup.
  Note: Dialogs are presented in this chapter using VT100 mode.
A Welcome screen opens the first time that you install this release of CA Gen:
```
+------------------------------------------------------------------------------+
| CA Gen Installation Wizard                                                   |
+------------------------------------------------------------------------------+

Welcome to the CA Gen setup wizard.


This process will install version number:
8.5

Copyright (c) 2013, CA. All rights reserved.

Visit https://support.ca.com/ in order to review the Release Notes and User Documentation.


To continue, click next.


[ Next ] [ Cancel ]
```
Select Next and press Enter to continue.
The Licensing screen opens.

After reading the license agreement, scroll to the bottom of the license agreement and press the button to indicate you accept the terms of the license agreement.

+------------------------------------------------------------------------------+ | Install Implementation Toolset | +------------------------------------------------------------------------------+ Implementation Toolset To install the Implementation Toolset (IT) including the communcation daemons, select the checkbox and enter the user and group who will own the IT installation tree. Using root should be avoided for security reasons. This user and group must already exist. Install IT: [X] Owner: ................................................................ Group: ................................................................ IT directory: /opt/CA/CAGen.................................................... [ Back ] [ Next ] [ Cancel ]

Complete the fields in the Install Implementation Toolset screen.

Install IT

Leave the X to install the IT. Remove the X to skip IT installation.

Owner

Specify the name of the user who owns the IT installation tree. This is a mandatory field and there is no default. The system running the installation validates the input value.

Group

Specify the name of the group that owns the IT installation tree. This is a mandatory field and there is no default. The system running the installation validates the input value.

Note: For security reasons, do not use root or one of the system-defined groups.

IT directory

Enter the name of the directory in which to install the IT. In GUI mode, you can use the Browse button to the right of the field.

Note: The install creates the installation directory if necessary. Root owns the installation directory when the install creates it. If the directory exists, ownership does not change. The IT user must have permission to create objects in the installation directory. If the designated owner does not have permission to own the installation directory, the process terminates and writes an error to the log file and std.out.

Click Next.

+------------------------------------------------------------------------------+ | Install Client Server Encyclopedia | +------------------------------------------------------------------------------+ Client Server Encyclopedia To install the Client Server Encyclopedia (CSE) or its Update API, select the appropriate checkboxes and enter the user name who will own the Encyclopedia installation tree. This user may be different than the Implementation Toolset owner. Using root should be avoided for security reasons. This user and group must already exist. Install CSE: [X] Install Update API: [ ] Owner: ......................................................... Group: ......................................................... CSE Directory: /opt/CA/CAGen.....................................[ ... ] [ Back ] [ Next ] [ Cancel ]

Complete the fields on the Install Client-Server Encyclopedia screen.

Install CSE

Leave the X to install the CSE. Remove the X to skip the CSE installation.

Install Update API

Enter an X to install the encyclopedia Update API. Leave it blank to skip installing it during this installation.

Owner

Enter the name of the user that owns the encyclopedia installation tree. This is a mandatory field and there is no default. The system running the installation validates the input value.

Group

Enter the name of the group that owns the encyclopedia installation tree. This is a mandatory field and there is no default. The system running the installation validates the input value.

Note: For security reasons, do not use root or one of the system-defined groups.

CSE Directory

Enter the name of the directory in which to install the CSE. In GUI mode, you can use the Browse button to the right of the field.

Note: The install creates the installation directory if necessary. Root owns the installation directory when the install creates it. The designated owner must have permission to create objects in the installation directory. If the designated owner does not have permission to own the installation directory, the process terminates and writes an error to the log file and standard out (stdout).
Click Next.
The Summary screen opens so you can review the parameters. Click Back to change parameters.
Click Install Product to start the installation process.

When the installation completes, it offers the opportunity to view the CA Gen Readme file.

+------------------------------------------------------------------------------+ | Success | +------------------------------------------------------------------------------+ The installation of CA Gen has executed successfully. [ View Readme ] Shows installation notes, latest changes, and fixes. More information concerning the details of this interaction can be found in the the directory /opt/CA/installer/log [ Ok ]

Note: If this installation is the first installation of the IT or CSE on this system, update user accounts that need access to these products to provide that access. If this installation is an update to an existing installation, change the CA Gen defined environment to point to the new release of the IT or CSE for user accounts that have access to these newly installed products.

Notes:

For more information about configuring and using the CSE, see the Client Server Encyclopedia User Guide.
For more information about CSE operation, administration, and performance tuning, see the Client Server Encyclopedia Administration Guide.
For more information about setting the environment variables, see the UNIX and Linux Implementation Toolset Guide.

If you installed the IT, it also installed the daemons for the Transaction Enabler. For more information about daemons for Transaction Enabler, see the Transaction Enabler User Guide.

The installation delivers a number of configuration files with the IT. Configuration files are files that you can modify after installing the IT. These files include build script files, initialization files, sample files, and user exit files. When you install the IT, you must modify some configuration files and must rebuild libraries and applications. For more information about the configuration files that are used by the IT, see the UNIX and Linux Implementation Toolset Guide.

When you install the CSE, configure it before you can use it. For more information about configuration, see the Client Server Encyclopedia User Guide.