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.