Install TmaxSoft OpenFrame on Azure

Caution

This article references CentOS, a Linux distribution that is End Of Life (EOL) status. Please consider your use and plan accordingly. For more information, see the CentOS End Of Life guidance.

Learn how to set up an OpenFrame environment on Azure suitable for development, demos, testing, or production workloads. This tutorial walks you through each step.

OpenFrame includes multiple components that create the mainframe emulation environment on Azure. For example, OpenFrame online services replace the mainframe middleware such as IBM Customer Information Control System (CICS), and OpenFrame Batch, with its TJES component, replaces the IBM mainframe's Job Entry Subsystem (JES).

OpenFrame works with any relational database, including Oracle Database, Microsoft SQL Server, IBM Db2, and MySQL. This installation of OpenFrame uses the TmaxSoft Tibero relational database. Both OpenFrame and Tibero run on a Linux operating system. This tutorial installs CentOS 7.3, although you can use other supported Linux distributions. The OpenFrame application server and the Tibero database are installed on one virtual machine (VM).

The tutorial steps you through the installation of the OpenFrame suite components. Some must be installed separately.

Main OpenFrame components:

  • Required installation packages.
  • Tibero database.
  • Open Database Connectivity (ODBC) is used by applications in OpenFrame to communicate with the Tibero database.
  • OpenFrame Base, the middleware that manages the entire system.
  • OpenFrame Batch, the solution that replaces the mainframe's batch systems.
  • TACF, a service module that controls user access to systems and resources.
  • ProSort, a sort tool for batch transactions.
  • OFCOBOL, a compiler that interprets the mainframe's COBOL programs.
  • OFASM, a compiler that interprets the mainframe's assembler programs.
  • OpenFrame Server Type C (OSC), the solution that replaces the mainframe's middleware and IBM CICS.
  • Java Enterprise User Solution (JEUS), a web application server that is certified for Java Enterprise Edition 6.
  • OFGW, the OpenFrame gateway component that provides a 3270 listener.
  • OFManager, a solution that provides OpenFrame's operation and management functions in the web environment.

Other required OpenFrame components:

  • OSI, the solution that replaces the mainframe middleware and IMS DC.
  • TJES, the solution that provides the mainframe's JES environment.
  • OFTSAM, the solution that enables (V)SAM files to be used in the open system.
  • OFHiDB, the solution that replaces the mainframe's IMS DB.
  • OFPLI, a compiler that interprets the mainframe's PL/I programs.
  • PROTRIEVE, a solution that executes the mainframe language CA-Easytrieve.
  • OFMiner, a solution that analyzes the mainframes assets and then migrates them to Azure.

Architecture

The following figure provides an overview of the OpenFrame 7.0 architectural components installed in this tutorial:

OpenFrame components

Azure system requirements

The following table lists the requirements for the installation on Azure.

WinSCP: A popular SFTP client and FTP client you can use
Eclipse for Windows: A development platform supported by TmaxSoft
(Microsoft Visual Studio is not supported at this time)
RequirementDescription
Supported Linux distributions on Azure Linux x86 2.6 (32-bit, 64-bit)
Red Hat 7.x
CentOS 7.x
Hardware Cores: 2 (minimum)
Memory: 4 GB (minimum)
Swap space: 1 GB (minimum)
Hard disk: 100 GB (minimum)
Optional software for Windows users

Prerequisites

Plan on spending a few days to assemble all the required software and complete all the manual processes.

Before getting started, do the following:

  • Get the OpenFrame installation media from TmaxSoft. If you are an existing TmaxSoft customer, contact your TmaxSoft representative for a licensed copy. Otherwise, request a trial version from TmaxSoft.
  • Request the OpenFrame documentation by sending email to support@tmaxsoft.com.
  • Get an Azure subscription if you don't already have one. You can also create a free account before you begin.
  • Optional. Set up a site-to-site VPN tunnel or a jumpbox that restricts access to the Azure VM to the permitted users in your organization. This step is not required, but it is a best practice.

Set up a VM on Azure for OpenFrame and Tibero

You can set up the OpenFrame environment using various deployment patterns, but the following procedure shows how to deploy the OpenFrame application server and the Tibero database on one VM. In larger environments and for sizeable workloads, a best practice is to deploy the database separately on its own VM for better performance.

To create a VM

  1. Sign in to the Azure portal.

  2. Click Virtual machines.

    Resource list in Azure portal

  3. Click Add.

    Add option in Azure portal

  4. To the right of Operating Systems, click More.

    More option in Azure portal

  5. Click CentOS-based 7.3 to follow this walk-through exactly, or you can choose another supported Linux distribution.

    Operating System options in Azure portal

  6. In the Basics settings, enter Name, User name, Authentication type, Subscription (Pay-As-You-Go is the AWS style of payment), and Resource group (use an existing one or create a TmaxSoft group).

  7. When complete (including the public/private key pair for Authentication type), click Submit.

Note

If using an SSH public key for Authentication type, see the steps in the next section to generate the public/private key pair, then resume the steps here.

Generate a public/private key pair

The public key can be freely shared, but the private key should be kept entirely secret and should never be shared with another party. After generating the keys, you must paste the SSH public key into the configuration in effect, uploading it to the Linux VM. It is stored inside authorized_keys within the ~/.ssh directory of the user account's home directory. The Linux VM is then able to recognize and validate the connection once you provide the associated SSH private key in the SSH client.

When giving new individuals access the VM:

  • Each new individual generates their own public/private keys.
  • Individuals store their own private keys separately and send the public key information to the administrator of the VM.
  • The administrator pastes the contents of the public key to the ~/.ssh/authorized_keys file.
  • The new individual connects via OpenSSH.

For more information about creating SSH key pairs, see Create and use an SSH public-private key pair for Linux VMs in Azure.

Configure VM features

  1. In Azure portal, in the Choose a size blade, choose the Linux machine hardware settings you want. The minimum requirements for installing both Tibero and OpenFrame are 2 CPUs and 4 GB RAM as shown in this example installation:

    Create virtual machine - Basics

  2. Click 3 Settings and use the default settings to configure optional features.

  3. Review your payment details.

    Create virtual machine - Purchase

  4. Submit your selections. Azure begins to deploy the VM. This process typically takes a few minutes.

  5. When the VM is deployed, its dashboard is displayed, showing all the settings that were selected during the configuration. Make a note of the Public IP address.

    tmax on Azure dashboard

  6. Open bash or a PowerShell prompt.

  7. For Host Name, type your username and the public IP address you copied. For example, username@publicip.

    Screenshot that shows the PuTTY Configuration dialog box and highlights the Host Name (or IP address) field.

  8. In the Category box, click Connection > SSH > Auth. Provide the path to your private key file.

    PuTTY Configuration dialog box

  9. Click Open to launch the PuTTY window. If successful, you are connected to your new CentOS VM running on Azure.

  10. To log on as root user, type sudo bash.

    Root user logon in command window

Set up the environment and packages

Now that the VM is created and you are logged on, you must perform a few setup steps and install the required preinstallation packages.

  1. Map the name ofdemo to the local IP address, modify /etc/hosts using any text editor. Assuming our IP is 192.168.96.148, this is before the change:

    127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
    ::1              localhost localhost.localdomain localhost6 localhost6.localdomain
    <IP Address>    <your hostname>
    
    • This is after the change:
    127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
    ::1              localhost localhost.localdomain localhost6 localhost6.localdomain
    192.168.96.148   ofdemo
    
  2. Create groups and users:

    sudo adduser -d /home/oframe7 oframe7
    
  3. Change the password for user oframe7:

    sudo passwd oframe7
    
    New password:
    Retype new password:
    passwd: all authentication tokens updated successfully.
    
  4. Update the kernel parameters in /etc/sysctl.conf using any text editor:

    kernel.shmall = 7294967296
    kernel.sem = 10000 32000 10000 10000
    
  5. Refresh the kernel parameters dynamically without reboot:

    sudo /sbin/sysctl -p
    
  6. Get the required packages: Make sure the server is connected to the Internet, download the following packages, and then install them:

    • dos2unix

    • glibc

    • glibc.i686 glibc.x86_64

    • libaio

    • ncurses

      Note

      After installing the ncurses package, create the following symbolic links:

      sudo ln -s /usr/lib64/libncurses.so.5.9 /usr/lib/libtermcap.so
      sudo ln -s /usr/lib64/libncurses.so.5.9 /usr/lib/libtermcap.so.2
      
    • gcc

    • gcc-c++

    • libaio-devel.x86_64

    • strace

    • ltrace

    • gdb

  7. In case of Java RPM installation, do the following:

sudo rpm -ivh jdk-7u79-linux-x64.rpm
  • Add the following contents to the ~./.bash_profile using any text editor:
# JAVA ENV
export JAVA_HOME=/usr/java/jdk1.7.0_79/
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=$CLASSPATH:$JAVA_HOME/jre/lib/ext:$JAVA_HOME/lib/tools.jar
  • Execute the following command to load the profile:
sudo source /etc/profile
  • Validate the java version using the following command:
sudo java –version
java version "1.7.0_79"
Java(TM) SE Runtime Environment (build 1.7.0_79-b15)
Java HotSpot(TM) 64-Bit Server VM (build 24.79-b02, mixed mode)
sudo echo $JAVA_HOME /usr/java/jdk1.7.0_79/

Install the Tibero database

Tibero provides the several key functions in the OpenFrame environment on Azure:

  • Tibero is used as the OpenFrame internal data store for various system functions.
  • VSAM files, including KSDS, RRDS, and ESDS, use the Tibero database internally for data storage.
  • The TACF data repository is stored in Tibero.
  • The OpenFrame catalog information is stored in Tibero.
  • The Tibero database can be used as a replacement for IBM Db2 to store application data.

To install Tibero

  1. Verify that the Tibero binary installer file is present and review the version number.

  2. Copy the Tibero software to the Tibero user account (oframe). For example:

    tar -xzvf tibero6-bin-6_rel_FS04-linux64-121793-opt-tested.tar.gz
    mv license.xml /opt/tmaxdb/tibero6/license/
    
  3. Open .bash_profile using any text editor and paste the following in it:

    # Tibero6 ENV
    export TB_HOME=/opt/tmaxdb/tibero6
    export TB_SID=TVSAM export TB_PROF_DIR=$TB_HOME/bin/prof
    export LD_LIBRARY_PATH=$TB_HOME/lib:$TB_HOME/client/lib:$LD_LIBRARY_PATH
    export PATH=$TB_HOME/bin:$TB_HOME/client/bin:$PATH
    
  4. To execute the bash profile, at the command prompt type:

    source .bash_profile
    
  5. Generate the tip file (a configuration file for Tibero), and check its contents. For example:

    sh $TB_HOME/config/gen_tip.sh
    cat $TB_HOME/config/$TB_SID.tip
    
  6. Modify \$TB_HOME/client/config/tbdsn.tbr using any text editor and put 127.0.0.1 instead of localhost as shown:

    TVSAM=(
    (INSTANCE=(HOST=127.0.0.1)
        (PT=8629)
    (DB_NAME=TVSAM)
          )
     )
    
  7. Create the database. The following output appears:

    Change core dump dir to /opt/tmaxdb/tibero6/bin/prof.
    Listener port = 8629
    Tibero 6
    TmaxData Corporation Copyright (c) 2008-. All rights reserved.
    Tibero instance started up (NOMOUNT mode).
     /--------------------- newmount sql ------------------------/
    create database character set MSWIN949 national character set UTF16;
    /-----------------------------------------------------------/
    Database created.
    Change core dump dir to /opt/tmaxdb/tibero6/bin/prof.
    Listener port = 8629
    Tibero 6
    TmaxData Corporation Copyright (c) 2008-. All rights reserved.
    Tibero instance started up (NORMAL mode).
    /opt/tmaxdb/tibero6/bin/tbsvr
    ………………………..
    Creating agent table...
    Done.
    For details, check /opt/tmaxdb/tibero6/instance/TVSAM/log/system_init.log.
    **************************************************
    * Tibero Database TVSAM is created successfully on Fri Aug 12 19:10:43 UTC 2016.
    *     Tibero home directory ($TB_HOME) =
    *         /opt/tmaxdb/tibero6
    *     Tibero service ID ($TB_SID) = TVSAM
    *     Tibero binary path =
    *         /opt/tmaxdb/tibero6/bin:/opt/tmaxdb/tibero6/client/bin
    *     Initialization parameter file =
    *         /opt/tmaxdb/tibero6/config/TVSAM.tip
    *
    * Make sure that you always set up environment variables $TB_HOME and
    * $TB_SID properly before you run Tibero.
     ******************************************************************************
    
  8. To recycle Tibero, first shut it down using the tbdown command. For example:

    tbdown
    
    Tibero instance terminated (NORMAL mode).
    
  9. Now boot Tibero using tbboot. For example:

    tbboot
    
    Change core dump dir to /opt/tmaxdb/tibero6/bin/prof. Listener port = 8629
    
    Tibero 6
    TmaxData Corporation Copyright (c) 2008-. All rights reserved.
    Tibero instance started up (NORMAL mode).
    
  10. To create a tablespace, access the database using SYS user (sys/tmax), then create the necessary tablespace for the default volume and TACF:

    tbsql tibero/tmax
    
    tbSQL 6
    TmaxData Corporation Copyright (c) 2008-. All rights reserved.
    Connected to Tibero.
    
  11. Now type the following SQL commands:

    SQL> create tablespace "DEFVOL" datafile 'DEFVOL.dbf' size 500M autoextend on; create tablespace "TACF00" datafile 'TACF00.dbf' size 500M autoextend on; create tablespace "OFM_REPOSITORY" datafile 'ofm_repository.dbf' size 300M autoextend on;
    SQL> Tablespace 'DEFVOL' created.
    SQL> Tablespace 'TACF00' created.
    SQL> Tablespace ' OFM_REPOSITORY ' created.
    SQL> SQL> Disconnected.
    
  12. Boot Tibero and verify that the Tibero processes are running:

    tbboot
    ps -ef | egrep tbsvr
    

Output:

Tibero output

Install ODBC

Applications in OpenFrame communicate with the Tibero database using the ODBC API provided by the open-source unixODBC project.

To install ODBC:

  1. Verify that the unixODBC-2.3.4.tar.gz installer file is present, or use the wget unixODBC-2.3.4.tar.gz command. For example:

    wget ftp://ftp.unixodbc.org/pub/unixODBC/unixODBC-2.3.4.tar.gz
    
  2. Unzip the binary. For example:

    tar -zxvf unixODBC-2.3.4.tar.gz
    
  3. Navigate to unixODBC-2.3.4 directory and generate the Makefile by using the checking machine information. For example:

    ./configure --prefix=/opt/tmaxapp/unixODBC/ --sysconfdir=/opt/tmaxapp/unixODBC/etc
    

    By default, unixODBC is installed in /usr /local, so --prefix passes a value to change the location. Similarly, configuration files are installed in /etc by default, so --sysconfdir passes the value of the desired location.

  4. Execute Makefile: make

  5. Copy the executable file in the program directory after compiling. For example:

    make install
    
  6. Edit the bash profile ~/.bash_profile using any text editor and add the following:

    # UNIX ODBC ENV
    export ODBC_HOME=$HOME/unixODBC
    export PATH=$ODBC_HOME/bin:$PATH
    export LD_LIBRARY_PATH=$ODBC_HOME/lib:$LD_LIBRARY_PATH
    export ODBCINI=$HOME/unixODBC/etc/odbc.ini
    export ODBCSYSINI=$HOME
    
  7. Apply the ODBC. Edit the following files accordingly. For example:

    source ~/.bash_profile
    cd
    odbcinst -j unixODBC 2.3.4
    
    DRIVERS............: /home/oframe7/odbcinst.ini
    SYSTEM DATA SOURCES: /home/oframe7/odbc.ini
    FILE DATA SOURCES..: /home/oframe7/ODBCDataSources
    USER DATA SOURCES..: /home/oframe7/unixODBC/etc/odbc.ini
    SQLULEN Size.......: 8
    SQLLEN Size........: 8
    SQLSETPOSIROW Size.: 8
    
    • Modify odbcinst.ini using any text editor, and add the following contents:
    [Tibero]
    Description = Tibero ODBC driver for Tibero6
    Driver = /opt/tmaxdb/tibero6/client/lib/libtbodbc.so
    Setup =
    FileUsage =
    CPTimeout =
    CPReuse =
    Driver Logging = 7
    
    [ODBC]
    Trace = NO
    TraceFile = /home/oframe7/odbc.log
    ForceTrace = Yes
    Pooling = No
    DEBUG = 1
    
    • Modify odbc.ini using any text editor, and add the following contents:
    [TVSAM]
    Description = Tibero ODBC driver for Tibero6
    Driver = Tibero
    DSN = TVSAM
    SID = TVSAM
    User = tibero
    password = tmax
    
  8. Create a symbolic link and validate the Tibero database connection:

    ln $ODBC_HOME/lib/libodbc.so $ODBC_HOME/lib/libodbc.so.1
    ln $ODBC_HOME/lib/libodbcinst.so $ODBC_HOME/lib/libodbcinst.so.1
    isql TVSAM tibero tmax
    

The following output is displayed:

ODBC output showing connected to SQL

Install OpenFrame Base

The Base application server is installed before the individual services that OpenFrame uses to manage the system on Azure, including the transaction handling server processes.

To install OpenFrame Base

  1. Make sure the Tibero installation succeeded, then verify that the following OpenFrame_Base7_0_Linux_x86_64.bin installer file and base.properties configuration file are present.

  2. Update the bash profile with the following Tibero-specific information:

    alias ofhome='cd $OPENFRAME_HOME'
    alias ulog='cd $OPENFRAME_HOME/log/tmax/ulog'
    alias sysjcl='cd $OPENFRAME_HOME/volume_default/SYS1.JCLLIB'
    alias sysload='cd $OPENFRAME_HOME/volume_default/SYS1.LOADLIB'
    alias sysproc='cd $OPENFRAME_HOME/volume_default/SYS1.PROCLIB'
    alias oscsrc='cd $OPENFRAME_HOME/osc/oivp'
    alias osisrc='cd $OPENFRAME_HOME/osi/oivp'
    alias defvol='cd $OPENFRAME_HOME/volume_default'
    
  3. Execute the bash profile:. .bash_profile

  4. Ensure that the Tibero processes are running. For example:

    ps -ef|grep tbsvr
    

    Base

    Important

    Make sure you start Tibero before installation.

  5. Generate license at technet.tmaxsoft.com and PUT the OpenFrame Base, Batch, TACF, OSC licenses in the appropriate folder:

    cp license.dat /opt/tmaxapp/OpenFrame/core/license/
    cp lictjes.dat lictacf.dat licosc.dat $OPENFRAME_HOME/license/
    
  6. Download the OpenFrame Base binary and base.properties files:

    • Modify the base.properties file accordingly, using any text editor:
    OPENFRAME_HOME= <appropriate location for installation> ex. /opt/tmaxapp/OpenFrame TP_HOST_NAME=<your IP Hostname> ex. ofdemo
    TP_HOST_IP=<your IP Address> ex. 192.168.96.148
    TP_SHMKEY=63481
    TP_TPORTNO=6623
    TP_UNBLOCK_PORT=6291
    TP_NODE_NAME=NODE1
    TP_NODE_LIST=NODE1
    MASCAT_NAME=SYS1.MASTER.ICFCAT
    MASCAT_CREATE=YES
    DEFAULT_VOLSER=DEFVOL
    VOLADD_DEFINE=YES TSAM_USERNAME=tibero
    TSAM_PASSWORD=tmax
    TSAM_DATABASE=oframe
    DATASET_SHMKEY=63211
    DSLOCK_DATA=SYS1.DSLOCK.DATA
    DSLOCK_LOG=SYS1.DSLOCK.LOG
    DSLOCK_SEQ=dslock_seq.dat
    DSLOCK_CREATE=YES
    OPENFRAME_LICENSE_PATH=/opt/tmaxapp/license/OPENFRAME TMAX_LICENSE_PATH=/opt/tmaxapp/license/TMAX
    
  7. Execute the installer using the base.properties file. For example:

    chmod a+x OpenFrame_Base7_0_Linux_x86_64.bin
    ./OpenFrame_Base7_0_Linux_x86_64.bin -f base.properties
    

    When complete, the Installation Complete message is displayed.

  8. Verify the OpenFrame Base directory structure using the ls -ltr command. For example:

    ls -ltr
    
    total 44
    
    drwxrwxr-x. 4 oframe7 oframe7 61 Nov 30 16:57 UninstallerData
    drwxrwxr-x. 2 oframe7 oframe7 4096 Nov 30 16:57 bin
    drwxrwxr-x. 2 oframe7 oframe7 4096 Nov 30 16:57 cpm drwxrwxr-x. 2 oframe7 oframe7 4096 Nov 30 16:57 data
    drwxrwxr-x. 2 oframe7 oframe7 4096 Nov 30 16:57 include
    drwxrwxr-x. 2 oframe7 oframe7 8192 Nov 30 16:57 lib
    drwxrwxr-x. 6 oframe7 oframe7 48 Nov 30 16:57 log
    drwxrwxr-x. 2 oframe7 oframe7 6 Nov 30 16:57 profile
    drwxrwxr-x. 7 oframe7 oframe7 62 Nov 30 16:57 sample
    drwxrwxr-x. 2 oframe7 oframe7 6 Nov 30 16:57 schema
    drwxrwxr-x. 2 oframe7 oframe7 6 Nov 30 16:57 temp
    drwxrwxr-x. 3 oframe7 oframe7 16 Nov 30 16:57 shared
    drwxrwxr-x. 2 oframe7 oframe7 4096 Nov 30 16:58 license
    drwxrwxr-x. 23 oframe7 oframe7 4096 Nov 30 16:58 core
    drwxrwxr-x. 2 oframe7 oframe7 4096 Nov 30 16:58 config
    drwxrwxr-x. 2 oframe7 oframe7 4096 Nov 30 16:58 scripts
    drwxrwxr-x. 2 oframe7 oframe7 25 Nov 30 16:58 volume_default
    
  9. Start OpenFrame Base:

    cp /usr/lib/libtermcap.so.2 $TMAXDIR/lib
    

    Start up Tmax Server using the following command:

    tmboot
    

    tmboot command output

  10. Verify the process status is ready using the tmadmin command in si. RDY is displayed in the status column for each of the processes:

    tmadmin command output

  11. Shut down OpenFrame Base:

    tmdown
    
    Do you really want to down whole Tmax? (y : n): y
    
    TMDOWN for node(NODE1) is starting:
    TMDOWN: SERVER(ofrsasvr:36) downed: Wed Sep  7 15:37:21 2016
    TMDOWN: SERVER(ofrdsedt:39) downed: Wed Sep  7 15:37:21 2016
    TMDOWN: SERVER(vtammgr:43) downed: Wed Sep  7 15:37:21 2016
    TMDOWN: SERVER(ofrcmsvr:40) downed: Wed Sep  7 15:37:21 2016
    TMDOWN: SERVER(ofrdmsvr:38) downed: Wed Sep  7 15:37:21 2016
    TMDOWN: SERVER(ofrlhsvr:37) downed: Wed Sep  7 15:37:21 2016
    TMDOWN: SERVER(ofruisvr:41) downed: Wed Sep  7 15:37:21 2016
    TMDOWN: SERVER(ofrsmlog:42) downed: Wed Sep  7 15:37:21 2016
    TMDOWN: CLH downed: Wed Sep  7 15:37:21 2016
    TMDOWN: CLL downed: Wed Sep  7 15:37:21 2016
    TMDOWN: TLM downed: Wed Sep  7 15:37:21 2016
    TMDOWN: TMM downed: Wed Sep  7 15:37:21 2016
    TMDOWN: TMAX is down
    

Install OpenFrame Batch

OpenFrame Batch consists of several components that simulate mainframe batch environments and is used to run batch jobs on Azure.

To install Batch

  1. Make sure the base installation succeeded, then verify that the OpenFrame_Batch7_0_Fix2_MVS_Linux_x86_64.bin installer file and batch.properties configuration file are present:

  2. Modify the file vi batch.properties using any text editor.

  3. Modify the parameters as follows:

    OPENFRAME_HOME = /opt/tmaxapp/OpenFrame
    DEFAULT_VOLSER=DEFVOL
    TP_NODE_NAME=NODE1
    TP_NODE_LIST=NODE1
    RESOURCE_SHMKEY=66991
    #JOBQ_DATASET_CREATE=YES
    #OUTPUTQ_DATASET_CREATE=YES
    DEFAULT_JCLLIB_CREATE=YES
    DEFAULT_PROCLIB_CREATE=YES
    DEFAULT_USERLIB_CREATE=YES
    TJES_USERNAME=tibero
    TJES_PASSWORD=tmax
    TJES_DATABASE=oframe
    BATCH_TABLE_CREATE=YES
    
  4. To execute the batch installer, at the command prompt type:

    ./OpenFrame_Batch7_0_Fix2_MVS_Linux_x86_64.bin -f batch.properties
    
  5. When the installation is complete, start the installed OpenFrame suites by typing tmboot at the command prompt.

    tmboot output

  6. Type tmadmin at the command prompt to check the OpenFrame process.

    Tmax Admin screen

  7. Execute the following commands:

    $$2 NODE1 (tmadm): quit
    ADM quit for node (NODE1)
    
  8. Use the tmdown command to start up and shut down Batch:

    tmdown
    
    Do you really want to down whole Tmax? (y : n): y
    
    TMDOWN for node(NODE1) is starting:
    TMDOWN: SERVER(ofrsasvr:36) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:44) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(vtammgr: 43) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(ofrcmsvr:40) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:45) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:46) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(ofrdmsvr:38) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:47) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(ofrdsedt:39) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjschd:54) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjinit:55) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:48) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjspbk:57) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:49) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:50) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:51) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(ofrlhsvr:37) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:52) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjmsvr:53) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmjhist:56) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(ofruisvr:41) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(obmtsmgr:59) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(ofrpmsvr:58) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: SERVER(ofrsmlog:42) downed: Wed Sep  7 16:01:46 2016
    TMDOWN: CLL downed: Wed Sep  7 16:01:46 2016
    TMDOWN: TLM downed: Wed Sep  7 16:01:46 2016
    TMDOWN: CLH downed: Wed Sep  7 16:01:46 2016
    TMDOWN: TMM downed: Wed Sep  7 16:01:46 2016
    TMDOWN: TMAX is down
    

Install TACF

TACF Manager is an OpenFrame service module that controls user access to systems and resources through RACF security.

To install TACF

  1. Verify that the OpenFrame_Tacf7_0_Fix2_Linux_x86_64.bin installer file and tacf.properties configuration file are present.

  2. Make sure the Batch installation succeeded, then modify the file tacf.properties using any text editor.

  3. Modify the TACF parameters:

    OPENFRAME_HOME=/opt/tmaxapp/OpenFrame
    USE_OS_AUTH=NO
    TACF_USERNAME=tibero
    TACF_PASSWORD=tmax
    TACF_DATABASE=oframe
    TACF_TABLESPACE=TACF00
    TACF_TABLE_CREATE=YES
    
  4. After completing TACF installer, apply the TACF environment variables. At the command prompt, type:

    source ~/.bash_profile
    
  5. Execute the TACF installer. At the command prompt, type:

    ./OpenFrame_Tacf7_0_Fix2_Linux_x86_64.bin -f tacf.properties
    

    The output looks something like this:

    Wed Dec 07 17:36:42 EDT 2016
    Free Memory: 18703 kB
    Total Memory: 28800 kB
    
    4 Command Line Args:
    0:  -f 1:  tacf.properties
    2:  -m
    3:  SILENT
    java.class.path:
    /tmp/install.dir.41422/InstallerData
    /tmp/install.dir.41422/InstallerData/installer.zip
    ZGUtil.CLASS_PATH:
    /tmp/install.dir.41422/InstallerData
    tmp/install.dir.41422/InstallerData/installer.zip
    sun.boot.class.path:
    /tmp/install.dir.41422/Linux/resource/jre/lib/resources.jar /tmp/install.dir.41422/Linux/resource/jre/lib/rt.jar /tmp/install.dir.41422/Linux/resource/jre/lib/sunrsasign.jar /tmp/install.dir.41422/Linux/resource/jre/lib/jsse.jar /tmp/install.dir.41422/Linux/resource/jre/lib/jce.jar /tmp/install.dir.41422/Linux/resource/jre/lib/charsets.jar /tmp/install.dir.41422/Linux/resource/jre/lib/jfr.jar /tmp/install.dir.41422/Linux/resource/jre/classes
    
  6. At the command prompt, type tmboot to restart OpenFrame. The output looks something like this:

    TMBOOT for node(NODE1) is starting:
    Welcome to Tmax demo system: it will expire 2016/11/4
    Today: 2016/9/7
    TMBOOT: TMM is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: CLL is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: CLH is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: TLM(tlm) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(ofrsasvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(ofrlhsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(ofrdmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(ofrdsedt) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(ofrcmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(ofruisvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(ofrsmlog) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(vtammgr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjschd) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjinit) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjhist) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmjspbk) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(ofrpmsvr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(obmtsmgr) is starting: Wed Sep  7 17:48:53 2016
    TMBOOT: SVR(tmsvr) is starting: Wed Sep  7 17:48:53 2016
    
  7. Verify that the process status is ready using tmadmin in the si command. For example:

    tmadmin
    

    In the status column, RDY appears:

    RDY in the status column

  8. Execute the following commands in the bash terminal:

    $$2 NODE1 (tmadm): quit
    
    DM quit for node (NODE1)
    
    ```bash
    tacfmgr
    
    ```output
    Input USERNAME  : ROOT
    Input PASSWORD  : SYS1
    
    TACFMGR: TACF MANAGER START!!!
    QUIT TACFMGR: TACF MANAGER END!!!
    
    tmdow
    
  9. Shut the server down using the tmdown command. The output looks something like this:

    tmdown
    
    Do you really want to down whole Tmax? (y : n): y
    
    TMDOWN for node(NODE1) is starting:
    TMDOWN: SERVER(ofrlhsvr:37) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(ofrdsedt:39) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(obmjschd:54) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(obmjmsvr:47) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(obmjmsvr:48) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(ofrdmsvr:38) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(obmjmsvr:50) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(obmjhist:56) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(ofrsasvr:36) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(ofrcmsvr:40) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(obmjspbk:57) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(tmsvr:60) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(ofrpmsvr:58) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: SERVER(obmtsmgr:59) downed: Wed Sep  7 17:50:50 2016
    TMDOWN: CLL downed: Wed Sep  7 17:50:50 2016
    TMDOWN: CLH downed: Wed Sep  7 17:50:50 2016
    TMDOWN: TLM downed: Wed Sep  7 17:50:50 2016
    TMDOWN: TMM downed: Wed Sep  7 17:50:50 2016
    TMDOWN: TMAX is down
    

Install ProSort

ProSort is a utility used in batch transactions for sorting data.

To install ProSort

  1. Make sure the Batch installation was successful, and then verify that the prosort-bin-prosort_2sp3-linux64-2123-opt.tar.gz installer file is present.

  2. Execute the installer using the properties file. At the command prompt, type:

    tar -zxvf prosort-bin-prosort_2sp3-linux64-2123-opt.tar.gz
    
  3. Move the prosort directory to the home location. At the command prompt, type:

    mv prosort /opt/tmaxapp/prosort
    
  4. Create a license subdirectory and copy the license file there. For example:

    cd /opt/tmaxapp/prosort
    mkdir license
    cp /opt/tmaxsw/oflicense/prosort/license.xml /opt/tmaxapp/prosort/license
    
  5. Modify bash.profile using any text editor, update it as follows:

    #       PROSORT
    
    PROSORT_HOME=/opt/tmaxapp/prosort
    PROSORT_SID=gbg
    PATH=$PATH:$PROSORT_HOME/bin LD_LIBRARY_PATH=$PROSORT_HOME/lib:$LD_LIBRARY_PATH LIBPATH$PROSORT_HOME/lib:$LIBPATH
    export PROSORT_HOME PROSORT_SID
    PATH LD_LIBRARY_PATH LIBPATH
    PATH=$PATH:$OPENFRAME_HOME/shbin
    export PATH
    
  6. To execute the bash profile, at the command prompt, type: . .bash_profile

  7. Create the configuration file. For example:

    cd /opt/tmaxapp/prosort/config
    ./gen_tip.sh
    
    Using PROSORT_SID "gbg"
     /home/oframe7/prosort/config/gbg.tip generated
    
  8. Create the symbolic link. For example:

    cd /opt/tmaxapp/OpenFrame/util/
    ln -s DFSORT SORT
    
  9. Verify the ProSort installation by executing the prosort -h command. For example:

    prosort -h
    
    Usage: prosort [options] [sort script files]
    options ------
    -h             Display this information
    -v             Display version information
    -s             Display state information
    -j             Display profile information
    -x             Use SyncSort compatible mode
    

Install OFCOBOL

OFCOBOL is the OpenFrame compiler that interprets the mainframe's COBOL programs.

To install OFCOBOL

  1. Make sure that the Batch/Online installation succeeded, then verify that the OpenFrame_COBOL3_0_40_Linux_x86_64.bin installer file is present.

  2. To execute the OFCOBOL installer, at the command prompt, type:

    ./OpenFrame_COBOL3_0_40_Linux_x86_64.bin
    
  3. Read the licensing agreement and press Enter to continue.

  4. Accept the licensing agreement. When the installation is complete, the following appears:

    Choose Install Folder
    --------------------
    Where would you like to install?
    Default Install Folder: /home/oframe7/OFCOBOL
    
    ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : /opt/tmaxapp/OFCOBOL
    
    INSTALL FOLDER IS: /opt/tmaxapp/OFCOBOL
    IS THIS CORRECT? (Y/N): Y[oframe7@ofdemo ~]$ vi .bash_profile
    
    ============================================================================ Installing...
    ------------
    [==================|==================|==================|==================]
    [------------------|------------------|------------------|------------------]
    
    =============================================================================== Installation Complete
    --------------------
    Congratulations. OpenFrame_COBOL has been successfully installed
    PRESS <ENTER> TO EXIT THE INSTALLER
    
  5. Modify the bash profile file (bash_profile) using any text editor, and verify that is updated with OFCOBOL variables.

  6. Execute the bash profile. At the command prompt, type:

     source ~/.bash_profile
    
  7. Copy the OFCOBOL license to the installed folder. For example:

    mv licofcob.dat $OFCOB_HOME/license
    
  8. Modify the OpenFrame $OPENFRAME_HOME/config/tjclrun.conf configuration file using any text editor. For example:

    • Here's the SYSLIB section before the change:
    [SYSLIB] BIN_PATH=${OPENFRAME_HOME}/bin:${OPENFRAME_HOME}/util:${COBDIR}/bin:/usr/local/bin:/bin LIB_PATH=${OPENFRAME_HOME}/lib:${OPENFRAME_HOME}/core/lib:${TB_HOME}/client/lib:${COBDIR}/lib:/ usr/lib:/lib:/lib/i686:/usr/local/lib:${PROSORT_HOME}/lib:/opt/FSUNbsort/lib
    
    • Here's the SYSLIB section after the change:
    [SYSLIB] BIN_PATH=${OPENFRAME_HOME}/bin:${OPENFRAME_HOME}/util:${COBDIR}/bin:/usr/local/bin:/bin LIB_PATH=${OPENFRAME_HOME}/lib:${OPENFRAME_HOME}/core/lib:${TB_HOME}/client/lib:${COBDIR}/lib:/ usr/lib:/lib:/lib/i686:/usr/local/lib:${PROSORT_HOME}/lib:/opt/FSUNbsort/lib :${ODBC_HOME}/lib
    :${OFCOB_HOME}/lib
    
  9. Review the OpenFrame_COBOL_InstallLog.log file in vi and verify that there are no errors. For example:

    cat $OFCOB_HOME/UninstallerData/log/OpenFrame_COBOL_InstallLog.log
    
    ……..
    Summary
    ------
    Installation: Successful.
    131 Successes
    0 Warnings
    0 NonFatalErrors
    0 FatalError
    
  10. Use the ofcob --version command and review the version number to verify the installation. For example:

    ofcob --version
    
    OpenFrame COBOL Compiler 3.0.54
    CommitTag:: 645f3f6bf7fbe1c366a6557c55b96c48454f4bf
    
  11. Reboot OpenFrame using the tmdown/tmboot command.

Install OFASM

OFASM is the OpenFrame compiler that interprets the mainframe's assembler programs.

To install OFASM

  1. Make sure that the Batch/Online installation succeeded, then verify that the OpenFrame_ASM3_0_Linux_x86_64.bin installer file is present.

  2. Execute the installer. For example:

    ./OpenFrame_ASM3_0_Linux_x86_64.bin
    
  3. Read the licensing agreement and press Enter to continue.

  4. Accept the licensing agreement.

  5. Verify the bash profile is updated with OFASM variables. For example:

    source .bash_profile
    ofasm --version
    
    # TmaxSoft OpenFrameAssembler v3 r328
    (3ff35168d34f6e2046b96415bbe374160fcb3a34)
    
    cat .bash_profile
    
    # OFASM ENV
    export OFASM_HOME=/opt/tmaxapp/OFASM
    export OFASM_MACLIB=$OFASM_HOME/maclib/free_macro
    export PATH="${PATH}:$OFASM_HOME/bin:"
    export LD_LIBRARY_PATH="./:$OFASM_HOME/lib:$LD_LIBRARY_PATH"
    
  6. Open the OpenFrame $OPENFRAME_HOME/config/tjclrun.conf configuration file using any text editor and modify it as follows:

    • Here is the [SYSLIB] section before the change:
    [SYSLIB] BIN_PATH=${OPENFRAME_HOME}/bin:${OPENFRAME_HOME}/util:${COBDIR}/bin:/usr/local/bin:/bi n:${OPENFRAME_HOME}/volume_default/SYS1.LOADLIB LIB_PATH=${OPENFRAME_HOME}/lib:${OPENFRAME_HOME}/core/lib:${TB_HOME}/client/lib:${CO BDIR}/lib:/usr/lib:/lib:/lib/i686:/usr/local/lib:${PROSORT_HOME}/lib:/opt/FSUNbsort/lib:${OFCOB_HOM E}/lib:${ODBC_HOME}/lib:${OFPLI_HOME}/lib
    
    • Here is the [SYSLIB] section after the change:
    [SYSLIB] BIN_PATH=${OPENFRAME_HOME}/bin:${OPENFRAME_HOME}/util:${COBDIR}/bin:/usr/local/bin:/bi n:${OPENFRAME_HOME}/volume_default/SYS1.LOADLIB LIB_PATH=${OPENFRAME_HOME}/lib:${OPENFRAME_HOME}/core/lib:${TB_HOME}/client/lib:${CO BDIR}/lib:/usr/lib:/lib:/lib/i686:/usr/local/lib:${PROSORT_HOME}/lib:/opt/FSUNbsort/lib:${OFCOB_HOM E}/lib:${ODBC_HOME}/lib:${OFPLI_HOME}/lib:${OFASM_HOME}/lib
    
  7. Validate the OpenFrame_ASM_InstallLog.log file, and verify that there are no errors. For example:

    cat $OFASM_HOME/UninstallerData/log/OpenFrame_ASM_InstallLog.log
    
    ……..
    Summary
    ------
    
    Installation: Successful.
    
    55 Successes
    0 Warnings
    0 NonFatalErrors
    0 FatalErrors
    
  8. Reboot OpenFrame by issuing one of the following commands:

    tmdown / tmboot
    

    —or—

    oscdown / oscboot
    

Install OSC

OSC is the OpenFrame environment similar to IBM CICS that supports high-speed OLTP transactions and other management functions.

To install OSC

  1. Make sure the base installation succeeded, then verify that the OpenFrame_OSC7_0_Fix2_Linux_x86_64.bin installer file and osc.properties configuration file are present.

  2. Edit the following parameters in the osc.properties file:

    OPENFRAME_HOME=/opt/tmaxapp/OpenFrame OSC_SYS_OSC_NCS_PATH=/opt/tmaxapp/OpenFrame/temp/OSC_NCS OSC_APP_OSC_TC_PATH=/opt/tmaxapp/OpenFrame/temp/OSC_TC
    
  3. Execute the installer using the properties file as shown:

    chmod a+x OpenFrame_OSC7_0_Fix2_Linux_x86_64.bin
    ./OpenFrame_OSC7_0_Fix2_Linux_x86_64.bin -f osc.properties
    

    When finished, the "Installation Complete" message is displayed.

  4. Verify that the bash profile is updated with OSC variables.

  5. Review the OpenFrame_OSC7_0_Fix2_InstallLog.log file. It should look something like this:

    Summary
    ------
    Installation: Successful.
    
    233 Successes
    0 Warnings
    0 NonFatalErrors
    0 FatalError
    
  6. Modify the $OPENFRAME_HOME/config/ofsys.seq configuration file using any text editor. In the #BASE and #BATCH sections, edit the parameters as shown.

    Before changes
    #BASE
    ofrsasvr
    ofrlhsvr
    ofrdmsvr
    ofrdsedt
    ofrcmsvr
    ofruisvr
    ofrsmlog
    vtammgr
    TPFMAGENT
    
    #BATCH
    #BATCH#obmtsmgr
    #BATCH#ofrpmsvr
    #BATCH#obmjmsvr
    #BATCH#obmjschd
    #BATCH#obmjinit
    #BATCH#obmjhist
    #BATCH#obmjspbk
    #TACF #TACF#tmsvr
    
    After changes 	#BATCH
    #BASE          obmtsmgr
    ofrsasvr       ofrpmsvr
    ofrlhsvr       obmjmsvr
    ofrdmsvr       obmjschd
    ofrdsedt       obmjinit
    ofrcmsvr       obmjhist
    ofruisvr       obmjspbk
    ofrsmlog
    vtammgr        #TACF
    TPFMAGENT      tmsvr
    
  7. Copy the license file. For example:

    cp /home/oframe7/oflicense/ofonline/licosc.dat $OPENFRAME_HOME/license
    cd $OPENFRAME_HOME/license
    ls -l
    
    -rwxr-xr-x. 1 oframe mqm 80 Sep 12 01:37 licosc.dat
    -rwxr-xr-x. 1 oframe mqm 80 Sep  8 09:40 lictacf.dat
    -rwxrwxr-x. 1 oframe mqm 80 Sep  3 11:54 lictjes.da
    
  8. To start up and shut down OSC, initialize the CICS region shared memory by typing osctdlinit OSCOIVP1 at the command prompt.

  9. Run oscboot to boot up OSC. The output looks something like this:

    OSCBOOT : pre-processing       [ OK ]
    
    TMBOOT for node(NODE1) is starting:
    Welcome to Tmax demo system: it will expire 2016/11/4
    Today: 2016/9/12
         TMBOOT: TMM is starting: Mon Sep 12 01:40:25 2016
         TMBOOT: CLL is starting: Mon Sep 12 01:40:25 2016
         TMBOOT: CLH is starting: Mon Sep 12 01:40:25 2016
         TMBOOT: TLM(tlm) is starting: Mon Sep 12 01:40:25 2016
    
  10. To verify that the process status is ready, use the tmadmin command in si. All the processes should display RDY in the status column.

    Processes displaying RDY

  11. Shut OSC down using the oscdown command.

Install JEUS

JEUS (Java Enterprise User Solution) provides the presentation layer of the OpenFrame web application server.

Before installing JEUS, install the Apache Ant package, which provides the libraries and command-line tools needed to install JEUS.

To install Apache Ant

  1. Download Ant binary using the wget command. For example:

    wget http://apache.mirror.cdnetworks.com/ant/binaries/apacheant-1.9.7-bin.tar.gz
    
  2. Use the tar utility to extract the binary file and move it to an appropriate location. For example:

    tar -xvzf apache-ant-1.9.7-bin.tar.gz
    
  3. For efficiency, create a symbolic link:

    ln -s apache-ant-1.9.7 ant
    
  4. Open the bash profile ~/.bash_profile using any text editor, and update it with the following variables:

    # Ant ENV
    export ANT_HOME=$HOME/ant
    export PATH=$HOME/ant/bin:$PATH
    
  5. Apply the modified environment variable. For example:

    source ~/.bash_profile
    

To install JEUS

  1. Extract the installer using the tar utility. For example:

    mkdir jeus7
    tar -zxvf jeus704.tar.gz -C jeus7
    
  2. Change to the jeus7/setup directory (or use the JEUS parameter for your own environment). For example:

    cd jeus7/setup/
    
  3. Execute ant clean-all before performing the build. The output looks something like this:

    Buildfile: /home/oframe7jeus7/setup/build.xml
    
    clean-bin:
    delete-domain:
    [echo] Deleting a domain configuration: domain = jeus_domain
    delete-nodesxml:
    clean-config:
    clean-all:
    BUILD SUCCESSFUL
    Total time: 0 seconds
    
  4. Make a backup of the domain-config-template.properties file. For example:

    cp domain-config-template.properties domain-configtemplate.properties.bkp
    
  5. Open the domain-config-template.properties file using any text editor, and change jeus.password=jeusadmin nodename=Tmaxsoft to jeus.password=tmax1234 nodename=ofdemo

  6. Execute the ant install command to build JEUS.

  7. Update the ~/.bash_profile file with the JEUS variables as shown:

    # JEUS ENV
    export JEUS_HOME=/opt/tmaxui/jeus7 PATH="/opt/tmaxui/jeus7/bin:/opt/tmaxui/jeus7/lib/system:/opt/tmaxui/jeus7/webserver/bin:$ {PATH}"
    export PATH
    
  8. Execute the bash profile. For example:

    . .bash_profile
    
  9. Optional. Create an alias for easy shutdown and boot of JEUS components, using the following commands:

    # JEUS alias
    
    alias dsboot='startDomainAdminServer -domain jeus_domain -u administrator -p jeusadmin'
    alias msboot='startManagedServer -domain jeus_domain -server server1 -u administrator -p jeusadmin'
    alias msdown=`jeusadmin -u administrator -p tmax1234 "stop-server server1"'
    alias dsdown=`jeusadmin -domain jeus_domain -u administrator -p tmax1234 "local-shutdown"'
    
  10. To verify the installation, start the domain admin server as shown:

    startDomainAdminServer -domain jeus_domain -u administrator -p jeusadmin
    
  11. Verify by web logon using the syntax:

    http://<IP>:<port>/webadmin/login
    

    For example, http://192.168.92.133:9736/webadmin/login. The logon screen appears:

    JEUS WebAdmin logon screen

    Note

    If you experience any issues with port security, open port 9736 or disable the firewall (systemctl stop firewall).

  12. To change the hostname for server1, click Lock & Edit, then click server1. In the Server window, change the hostname as follows:

    1. Change Nodename to ofdemo.
    2. Click OK on the right side of the window.
    3. Click Apply changes on the lower left side of the window and for description, enter Hostname change.

    JEUS WebAdmin screen

  13. Verify that the configuration is successful in the confirmation screen.

    jeus_domain Server screen

  14. Start the managed server process "server1" using the following command:

    startManagedServer -domain jeus_domain -server server1 -u administrator -p jeusadmin
    

Install OFGW

OFGW Is the OpenFrame gateway that supports communication between the 3270 terminal emulator and the OSI base and manages the sessions between the terminal emulator and OSI.

To install OFGW

  1. Make sure that JEUS was installed successfully, then verify that the OFGW7_0_1_Generic.bin installer file is present.

  2. Execute the installer. For example:

    ./OFGW7_0_1_Generic.bin
    
  3. Use the following locations for the corresponding prompts:

    • JEUS Home directory
    • JEUS Domain Name
    • JEUS Server Name
    • Tibero Driver
    • Tmax Node ID ofdemo
  4. Accept the rest of the defaults, then press Enter to exit the installer.

  5. Verify that the URL for OFGW is working as expected:

    Type URL
    http://192.168.92.133:8088/webterminal/ and press enter
     < IP >               :8088/webterminal/
    

    The following screen appears:

    OpenFrame WebTerminal

Install OFManager

OFManager provides operation and management functions for OpenFrame in the web environment.

To install OFManager

  1. Verify that the OFManager7_Generic.bin installer file is present.

  2. Execute the installer. For example:

    ./OFManager7_Generic.bin
    
  3. Press Enter to continue, then accept the license agreement.

  4. Choose the install folder.

  5. Accept the defaults.

  6. Choose Tibero as the database.

  7. Press Enter to exit the installer.

  8. Verify that the URL for OFManager is working as expected:

    Type URL http://192.168.92.133:8088/ofmanager and press enter <  IP >  : < PORT >  ofmanager Enter ID:   ROOT
    Password: SYS1
    

The start screen appears:

Tmax OpenFrame Manager logon screen

That completes the installation of the OpenFrame components.

Next steps

If you are considering a mainframe migration, our expanding partner ecosystem is available to help you. For detailed guidance about choosing a partner solution, refer to the Platform Modernization Alliance.