TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

1 / 14

TmaxSoft OpenFrame Installation Procedures and Consideration Guidebook Table of Contents

1. Introduction 2. Pre-Installation Guideline 3. Tibero/TSAM Installation Guideline 4. ProSort Installation Guideline 5. OpenFrame/Base Installation Guideline 6. OpenFrame/Batch Installation Guideline 7. OpenFrame/Tacf Installation Guideline 8. OpenFrame/OSC Installation Guideline 9. Consideration

1. Introduction

This document is designed to instruct the installation of OpenFrame, Demo version. This

document covers only general installation procedures and considerations for your convenience.

This document is a supplement document of our official manual set for your convenience.

Therefore, for more information about OpenFrame Base/Batch/Tacf/Online, We please you to see

our official manual set.

As mentioned above, this document is the supplement document, which means it is not an official

manual set. Therefore, you cannot claim any issues that relate to contents of this document.

While reading, if you face any problem of understanding, please contact TmaxSoft’s engineers for

further assistance.

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

2 / 14

2. Pre-Installation Guideline

OpenFrame, which we provided for the demonstration and test reason, is a 32-bit application.

Therefore, if you are intending to install it on a 64-bit system, please install 32-bit related libraries

and carefully configure your library path before installation.

Before installing the OpenFrame Base/Batch/Tacf/Online, you must provide and install COBOL

Compiler, Tibero, and any related applications. COBOL compiler does not include in the

OpenFrame, so you have to provide your own copy.

Please set your hostname to “oftest” in /etc/hosts right next to your IP address, if it is needed:

$ vi /etc/hosts

Ex)

As a last step of pre-installation, please place your license files in the designated license directory

which is written in your base.install.properties.

Default License Directory: OpenFrame licenses: $HOME/license/oframe/

Tmax license: $HOME/license/tmax/

If you do not have such directory, please make license directory as above.

After pre-installation, following steps should take in an order:

1) Install the Tibero/TSAM(Please see Tibero/TSAM installation guideline in this document)

2) Install a ProSort(ProSort is sorting utility for OpenFrame, which you need to buy

separately. Installing the ProSort is not a mandatory. If you would like to install the

ProSort, please see ProSort installation guide in this document)

3) Install the OpenFrame/Base, and test it(Please see OpenFrame/Base installation guideline

in this document)

4) Install the OpenFrame/Batch, and test it(Please see OpenFrame/Batch installation

guideline in this document)

5) Install the OpenFrame/TACF, and test it(Please see OpenFrame/TACF installation guideline

in this document)

6) Install the OpenFrame/OSC, and test it(Please see OpenFrame/OSC installation guideline

in this document)

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

3 / 14

3. Tibero/TSAM Installation Guideline

The reason of installing the Tibero/TSAM is for using MainFrame’s VSAM files on your UNIX/Linux

system. Installing procedure for Tibero/TSAM is as follow:

1) Upload Tibero tar file on your system and uncompress it.(if it is successful, you will see

tibero directory on your system)

2) Configure your configuration profile by adding Tibero-related options, and apply it

3) Make a license directory in your Tibero directory, and place your Tibero license into the

license directory

4) Go into $TB_HOME/config, and run gen_tip.sh file to make Tibero configuration

files($TB_SID.tip, tbdsn.tbr, psm_commands)

5) Update your $TB_SID.tip to fit into your system

6) Run tb_create_db.sh to initialize the database

(Continue on next page)

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

4 / 14

7) Creating table space for TSAM(VSAM) dataset by using “tbsql tibero/tmax”

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

5 / 14

4. ProSort Installation Guide

Installing procedure for ProSort is as follow:

1) Upload ProSort tar file on your system and uncompress it

2) Configure your configuration profile by adding ProSort-related options, and apply it

3) Place your ProSort license into the ProSort license directory

4) Go into $PROSORT_HOME/config, and run gen_tip.sh file to make ProSort configuration

files

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

6 / 14

5. OpenFrame/Base Installation Guideline

OpenFrame/Base is operated on Tmax, which is a TP-Monitor solution of Tmax. It designed to

handle and manage OpenFrame/Batch, Tacf, and OSC processes. Installing procedure for

OpenFrame/Base is as follow:

1) Creating or editing an installation properties file. The file name has to be

base.install.properties.

We, highly, recommend you to check and match OPENFRAME_HOME, TP_HOST_NAME,

TP_HOST_IP, and TP_TPORTNO in your properties file.

OPENFRAME_HOME directory specified will be used as the OpenFrame home directory

for all other OpenFrame configuration file.

TP_HOST_NAME specifies the host name where OpenFrame will be installed.

TP_HOST_IP specifies the IP address of the computer where OpenFrame will be installed,

as a decimal value.

TP_TPORTNO specifies the default port number used within Tmax as a decimal value.

2) If the installer does not have execution permissions, use the chmod command to grant

the permissions.

3) Execute the installer at the console prompt:

$ <installer_file_name> -f base.install.properties

4) Start OpenFrame/Base through tmboot.

$ tmboot

5) Check that there are no errors during the boot sequence. If errors occur, please see

$OPNEFRAME_HOME/log/tmax/ulog/[ERROR RELATED FILE NAME.err].

(Continue on next page)

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

7 / 14

6) Execute tmadmin($ tmadmin) and use si command to display a list of servers. This shows

whether all server processes have been successfully started.

If all servers appear as RDY (as shown below), OpenFrame/Base has been successfully

installed and started.

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

8 / 14

6. OpenFrame/Batch Installation Guideline

OpenFrame/Batch is a solution that provides an environment same as IBM MainFrame Batch

system on open platform. Installing procedure for OpenFrame/Batch is as follow:

1) Creating or editing an installation properties file. The file name has to be

batch.install.properties.

We, highly, recommend you to check and match OPENFRAME_HOME, DEFAULT_VOLSER,

TP_NODE_NAME, and TP_NODE_LIST in your properties file.

OPENFRAME_HOME directory specified will be used as the OpenFrame home directory

for all other OpenFrame configuration files.

The default volume used by OpenFrame is to be specified. The default volume name

should be the one created when installing OpenFrame/Base.

TP_NODE_NAME and TP_NODE_LIST represent the node which will perform Batch is to be

specified. In the case of multiple nodes, a list of all nodes needs to be specified in

TP_NODE_LIST

To see more detailed descriptions, please refer to OpenFrame Batch manual

2) If the installer does not have execution permissions, use the chmod command to grant

the permissions.

3) Execute the installer at the console prompt:

$ <installer_file_name> -f batch.install.properties

4) Start OpenFrame/Base through tmboot.

$ tmboot

5) Check that there are no errors during the boot sequence. If errors occur, please see

$OPNEFRAME_HOME/log/tmax/ulog/[ERROR RELATED FILE NAME.err].

(Continue on next page)

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

9 / 14

6) Execute tmadmin($ tmadmin) and use si command to display a list of servers. This shows

whether all server processes have been successfully started.

If all servers appear as RDY (as shown below), OpenFrame/Batch has been successfully

installed and started.

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

10 / 14

7. OpenFrame/TACF Installation Guideline

OpenFrame/TACF is a solution that provides an environment same as IBM MainFrame RACF on

open platform. Installing procedure for OpenFrame/TACF is as follow:

1) Creating or editing an installation properties file. The file name has to be

tacf.install.properties.

We, highly, recommend you to check and match OPENFRAME_HOME, TACF_USERNAME,

TACF_PASSWORD, TACF_DATABASE, and TACF_TABLESPACE in your properties file.

OPENFRAME_HOME directory specified will be used as the OpenFrame home directory

for all other OpenFrame configuration files.

TACF_USERNAME, TACF_PASSWORD, TACF_DATABASE, and TACF_TABLESPACE are the

parameters to set environment variables for the TACF module, responsible for the security

and authentication of OpenFrame.

To see more detailed descriptions, please refer to OpenFrame TACF manual.

2) If the installer does not have execution permissions, use the chmod command to grant

the permissions.

3) Execute the installer at the console prompt:

$ <installer_file_name> -f tacf.install.properties

4) Start OpenFrame/Base through tmboot.

$ tmboot

5) Check that there are no errors during the boot sequence. If errors occur, please see

$OPNEFRAME_HOME/log/tmax/ulog/[ERROR RELATED FILE NAME.err].

(Continue on next page).

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

11 / 14

6) Execute tmadmin($ tmadmin) and use si command to display a list of servers. This shows

whether all server processes have been successfully started.

If all servers appear as RDY (as shown below), OpenFrame/TACF has been successfully

installed and started.

7) Run tacfmgr

$ tacfmgr

8) Enter the information to check if login process works:

SYS1

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

12 / 14

8. OpenFrame/OSC Installation Guideline

OpenFrame/OSC is a solution that provides an environment same as IBM CICS on open platform.

Installing procedure for OpenFrame/OSC is as follow:

1) Creating or editing an installation properties file. The file name has to be

osc.install.properties.

We, highly, recommend you to check and match OPENFRAME_HOME, TP_NODE_NAME,

SYS1_USERNAME, SYS1_PASSWORD, SYS1_DATABASE, DEFAULT_VOLSER, TACF_USERNAME,

TACF_PASSWORD, TACF_DATABASE, and OSC_APP_TDQ_LONG_ADDRESS in your

properties file.

OPENFRAME_HOME directory specified will be used as the OpenFrame home directory

for all other OpenFrame configuration files.

TP_NODE_NAME should be the same as those specified in Tmax.

DEFAULT_VOLSER specifies a default volume name to be used in OpenFrame. The name

must be the same as that specified while installing OpenFrame/Base.

TACF_USERNAME, TACF_PASSWORD, TACF_DATABASE are the parameters required to set

environment variables for the TACF module, responsible for the security and

authentication of OpenFrame/OSC. However, If OpenFrame/TACF is installed; you do not

need to set the items explained in this section.

OSC_APP_TDQ_LOG_ADDRESS specifies the address of the OSC TDQ log server, which

stores log TDQ.

(Continue on next page)

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

13 / 14

2) If the installer does not have execution permissions, use the chmod command to grant

the permissions.

3) Execute the installer at the console prompt:

$ <installer_file_name> -f osc.install.properties

4) Run oscboot and check that there are no errors during the boot sequence

$ oscboot

.

5) Execute tmadmin($ tmadmin) and use si command to display a list of servers. This shows

whether all server processes have been successfully started.

If all servers appear as RDY (as shown below), OpenFrame/OSC has been successfully

installed and started.

6) Check that there are no errors during the boot sequence. If errors occur, please see

$OPNEFRAME_HOME/log/tmax/ulog/[ERROR RELATED FILE NAME.err].

7) OSCOIVP1 is a demo application to test the OpenFrame/OSC. Please use 3270 emulator

or similar application to test it.

TmaxSoft OpenFrame Installation Procedure and Consideration Guidebook

14 / 14

9. Consideration

1) OpenFrame, which we provided for the demonstration and test reason, is 32-bit

applications. Therefore, if you want to install it on 64-bit system, please carefully

configure your library path before installation.

2) Related to above subject, if 32bit libraries (such as glibc-devel) not installed on your 64-

bit system. You might need to install such as required.

Ex)

‘File does not exist’ Error Required 32-bit Library

crti.o glibc-devel-2.12-1.80.el6.i686

libstdc++.so.6 libstdc++-4.4.6-4.el6.i686

libncurses.so.5 ncurses-5.7-3.20090208.el6.i686

ncurses-libs-5.7-3.20090208.el6.i686

libtermcap.so.2 compat-libtermcap-2.0.8-49.el6.i686

3) You should set your OpenFrame install property files thoughtfully, conflicting port number

or host name could cause a problem while your installation.

4) If you need to reinstall the OpenFrame, you also should drop all the tables in the Tibero

before re-installation.

5) After reboot your system, if you face a trouble with your online regions, please try below

procedures:

i. Check your Cobol compiler

ii. tbboot (Booting up the Tibero)

iii. osctdlinit [REGION NAME]

iv. oscboot –r [REGION NAME]

6) If you have a problem with accessing your osc with terminals, please try to deactivate

your firewall and selinux settings.