Installing

Once controlled that all the required software components have been correctly installed on your system, you may start with the XFRAME set up.

Each XFRAME installation should belong to a dedicated non-root user and contained in a dedicated directory.

By default, XFRAME is installed in /opt/xframe.

More than one XFRAME instances may be installed on one system: just install them in different users and directories. It means you may have different versions of XFRAME and same system, and let users to use the one they need.

An example scenario: XFRAME v4.0.0 installed as user "xframeprod" in /opt/xframe-prod and used by the production environment, and XFRAME v4.0.5 installed as user "xframetest" in /opt/xframe-test and used by the testing team.

IMPORTANT: before to start with the XFRAME setup, please take a look to the README files deployed with the XFRAME distribution and contained in XFRAME setup tarball: they should contain important notices about your platform or some of the third-party tool you are going to use with XFRAME.

Task to perform as root user

In order to install XFRAME the following task must be done as root user:

1.	create a group named "xframe"

2.	create a user named "xframe", belonging to the xframe group. We suggest to assign "/opt/xframe" as the home directory. This user must use KSH or BASH and have umask set to 022.

3.	check for the owner and group of the assigned home directory, to be sure they are consistent with the physical user and group identifiers.

Task to perform as the xframe user

1.	log in as the "xframe" user

2.	check if required software is available for the "xframe" user. To do this, try issuing the following command:

# cc
# perl -v
# echo $JAVA_HOME
# java -version
# javac

If the COBOL compiler is Microfocus COBOL:

# cob
# cobrun

If the COBOL compiler is ACUCOBOL:

# ccbl
# runcbl

If the COBOL compiler is OpenCOBOL no preliminar step is required. OpenCOBOL must be installed after XFRAME installation. Check the OpenCOBOL installation section.

If ORACLE(tm) RDBMS is required, issue:

# echo $ORACLE_HOME
# proc
# procob
# sqlplus

If DB2(tm) RDBMS is required, issue:

# echo $DB2_HOME
# db2

3.	identify the XFRAME distribution archive required and copy it from your distribution media, or directly download it from http://www.htwc.it in a temporary directory on your system.

4.	Decompress the archive using gzip and tar, and run the installation script 'install.ksh'.

# tar xf xframe.tar
# mkdir /tmp/xframe-setup-3.3.10
# cd /tmp/xframe-setup-3.3.10
# mv /some/where/xframe-AIX-PPC-32-3.3.10.tgz .
# gzip -d xframe-AIX-PPC-32-3.3.10.tgz
# tar xf xframe-AIX-PPC-32-3.3.10.tar
# ksh ./install.ksh

Then follow the install instructions provided by the installation procedure. Installation procedure will show the machine serial number. Provide this number to HTWC to obtain the correct license key.