Installation and Uninstallation

This chapter describes how to install and uninstall OpenFrame/HiDB and verify the result. It tells you how to run an installer using the configuration file and verify that the installation was successful. In addition, it outlines some common installation problems and fixes.

1. Installation

This section describes how to install HiDB by using the installer and script.

1.1. Automatic Installation Using the Installer

If you have created the installation properties file described in Creating an Installation Properties File, you can install HiDB in easy steps by using the installer.

The following installation steps can be used on all platforms.

Copy the installer binary file to the directory where HiDB will be installed.
If the installer does not have execution permissions, use the chmod command to grant it those permissions.

The following example illustrates how to grant execution permissions to the installer binary file on a Linux x86 64-machine.
```
$ chmod a+x OpenFrame_HiDB7_2_Linux_x86_64.bin
```
Execute the installer from the console prompt.
```
<installer_file_name> -f <property_file_name>
```
The following methods illustrates how to create the installation properties file as hidb.properties and execute it. Select one of the following two methods and press <Enter> key.
- Method 1
  $ ./OpenFrame_HiDB7_2_Linux_x86_64.bin -f hidb.properties
- Method 2
  $ sh OpenFrame_HiDB7_2_Linux_x86_64.bin -f hidb.properties

The following messages are displayed during the installation.

Preparing to install...
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

Preparing SILENT Mode Installation...

===============================================================================
OpenFrame_HiDB7_2                   (created with InstallAnywhere by Macrovision)
-------------------------------------------------------------------------------




===============================================================================
Installing...
-------------

 [==================|==================|==================|==================]
 [------------------|------------------|------------------|------------------]

Installation Complete.

1.2. Manual Installation by Using Scripts

If you have set all options for automatic creation of data set to NO in the configuration file, you must run the scripts after installation is complete.

The scripts are located in the ${OPENFRAME_HOME}/scripts directory, and you must run the scripts in the following order.

create_hidbcf.sh

Configures HiDB-related error messages and the environment information.
hidb_init.sh

Create the directories and tables required by HiDB.
link_lib_hidb.sh

Installs HiDB-related libraries.
create_lib_hidb.sh

Installs HiDB-related PDS.
create_hidb_dbconn.sh

Configures the database connection information required for using tables in HiDB. .

If all options for automatic creation of data set are set to YES, the script files are automatically executed by the installer in order.

2. Verifying Installation

After installing HiDB, it is recommended to verify if the product is successfully installed with the following two steps:

Directory Check
Startup Check

2.1. Directory Check

When the product installation is completed after installing OpenFrame/Base and OpenFrame/Batch, the following directory is configured (the existing directory structure is not changed even if HiDB is installed). Configure the directory set in the environment variable ${OPENFRAME_HOME} to the home directory.

${OPENFRAME_HOME}
   +---- UninstallerData
   +---- bin
   +---- config
   +---- core
   +---- cpm
   +---- data
   +---- include
   +---- lib
   +---- license
   +---- log
         +---- cmd
         +---- data
         +---- sys
   +---- ofdb_scripts
   +---- outputq
   +---- profile
   +---- sample
   +---- scripts
   +---- schema
   +---- shared
         +---- SMF
         +---- TJES
   +---- spbackup
   +---- spool
   +---- spunpack
   +---- temp
   +---- tsam
         +---- temp
         +---- lib
         +---- copybook
   +---- util
   +---- volume_DEFVOL
   +---- webde
         +---- bin
         +---- copybook

UninstallerData

Contains files for deleting OpenFrame installed in the system.

bin

Contains executable files used in OpenFrame.

config

Contains the configuration files for OpenFrame.

core

Contains Tmax-related files used in OpenFrame, including Tmax server program, service program, and Tmax configuration file.

cpm

Contains character code conversion table files.

data

Contains datafiles and error messages information files used in OpenFrame.

include

Contains header files used to compile applications.

lib

Contains libraries used in OpenFrame.

license

Contains the following OpenFrame license files.

File	Description
licbase.dat	Base license file.
lictjes.dat	Batch (TJES) license file.
lictacf.dat	TACF license file.
lichidb.dat	HiDB license file.
licosc.dat (MVS)	OSC license file.
licosi.dat (MVS)	OSI license file.
licaim.dat (AIM)	AIM license file.

File

Description

licbase.dat

Base license file.

lictjes.dat

Batch (TJES) license file.

lictacf.dat

TACF license file.

lichidb.dat

HiDB license file.

licosc.dat (MVS)

OSC license file.

licosi.dat (MVS)

OSI license file.

licaim.dat (AIM)

AIM license file.

log

Contains log files generated by OpenFrame and the following subdirectories, each of which depends on the log file type. For more information, refer to "Appendix D. Log Management" in OpenFrame Base Guide.

Directory	Description
cmd	Contains operation logs of OpenFrame.
sys	Contains system logs of OpenFrame.
data	Contains data logs of OpenFrame.

2.2. Startup Check

Perform a startup check in the following order.

If all the options for automatically creating a script are set to 'YES', open the ${OPENFRAME_HOME}/UninstallerData/log/install_hidb.log file with a text editor to check if any error logs are present.

create_hidbcf.sh START
Logged-in as [ROOT]
[tacflogin -i"ROOT[SYS1]/SYS1"] returned 0
COMPLETED SUCCESSFULLY!
[/home/oframe3/OpenFrame/bin/oferror insert -p /home/oframe3/OpenFrame/data/errcode_imsx.msg] returned 0
COMPLETED SUCCESSFULLY.
[/home/oframe3/OpenFrame/bin/ofconfig import -n NODE1 -f /home/oframe3/OpenFrame/config/openframe_hidb.conf] returned 0
COMPLETED SUCCESSFULLY.
[/home/oframe3/OpenFrame/bin/ofconfig load] returned 0
hidb_init.sh START
Logged-in as [ROOT]
[tacflogin -i"ROOT[SYS1]/SYS1"] returned 0
hidbinit version 7.2.0(4) obuild@tplinux32:ofsrc7/ims(#2) 2007-11-10 10:43:12
Initialize OpenFrame HiDB Tables

hidbinit: ofschema DLI object directory for HiDB is created - /home/oframe3/OpenFrame/hidb/hidb_sch/dlilibs
hidbinit: creating OFM_HIDB_DBD_MASTER
hidbinit: "OFM_HIDB_DBD_MASTER" created
hidbinit: creating OFM_HIDB_DBD_DATASET
hidbinit: "OFM_HIDB_DBD_DATASET" created
hidbinit: creating OFM_HIDB_DBD_AREA
hidbinit: "OFM_HIDB_DBD_AREA" created
hidbinit: creating OFM_HIDB_DBD_SEGMENT
hidbinit: "OFM_HIDB_DBD_SEGMENT" created
hidbinit: creating OFM_HIDB_DBD_FIELD
hidbinit: "OFM_HIDB_DBD_FIELD" created
hidbinit: creating OFM_HIDB_DBD_LCHILD
hidbinit: "OFM_HIDB_DBD_LCHILD" created
hidbinit: creating OFM_HIDB_DBD_XDFLD
hidbinit: "OFM_HIDB_DBD_XDFLD" created
hidbinit: creating OFM_HIDB_DBD_DFSMARSH
hidbinit: "OFM_HIDB_DBD_DFSMARSH" created
hidbinit: creating OFM_HIDB_DBD_DFSMAP
hidbinit: "OFM_HIDB_DBD_DFSMAP" created
hidbinit: creating OFM_HIDB_DBD_DFSCASE
hidbinit: "OFM_HIDB_DBD_DFSCASE" created
hidbinit: creating OFM_HIDB_DBD_COLUMN
hidbinit: "OFM_HIDB_DBD_COLUMN" created
hidbinit: creating OFM_HIDB_PARENT_KEY_CONN
hidbinit: "OFM_HIDB_PARENT_KEY_CONN" created
hidbinit: creating OFM_HIDB_PSB_MASTER
hidbinit: "OFM_HIDB_PSB_MASTER" created
hidbinit: creating OFM_HIDB_PCB_MASTER
hidbinit: "OFM_HIDB_PCB_MASTER" created
hidbinit: creating OFM_HIDB_PSB_SENSEG
hidbinit: "OFM_HIDB_PSB_SENSEG" created
hidbinit: creating OFM_HIDB_PSB_INDEX
hidbinit: "OFM_HIDB_PSB_INDEX" created
hidbinit: creating OFM_HIDB_PSB_SENFLD
hidbinit: "OFM_HIDB_PSB_SENFLD" created
hidbinit: creating OFM_HIDB_CHECKPOINT
hidbinit: "OFM_HIDB_CHECKPOINT" created
hidbinit: creating OFM_HIDB_CHECKPOINT_C
hidbinit: "OFM_HIDB_CHECKPOINT_C" created
hidbinit: creating OFM_HIDB_CHECKPOINT_POSITION
hidbinit: "OFM_HIDB_CHECKPOINT_POSITION" created

hidbinit: successfully finished the request

[hidbinit create -t OFM_REPOSITORY] returned 0
link_lib_hidb.sh START
create_lib_hidb START
Logged-in as [ROOT]
[tacflogin -i"ROOT[SYS1]/SYS1"] returned 0
pdsgen version 7.1.0(0) obuild@tplinux32:ofsrc7/base(#1) 2007-11-09 16:45:00
PDS Dataset Generation Program

pdsgen: *** PDS IMS.DBDLIB is created.

[pdsgen IMS.DBDLIB DEFVOL -f L -l 32760] returned 0
pdsgen version 7.1.0(0) obuild@tplinux32:ofsrc7/base(#1) 2007-11-09 16:45:00
PDS Dataset Generation Program

pdsgen: *** PDS IMS.PSBLIB is created.

[pdsgen IMS.PSBLIB DEFVOL -f L -l 32760] returned 0
pdsgen version 7.1.0(0) obuild@tplinux32:ofsrc7/base(#1) 2007-11-09 16:45:00
PDS Dataset Generation Program

pdsgen: *** PDS IMS.RESLIB is created.

[pdsgen IMS.RESLIB DEFVOL -f L -l 32760] returned 0
pdsgen version 7.1.0(0) obuild@tplinux32:ofsrc7/base(#1) 2007-11-09 16:45:00
PDS Dataset Generation Program

pdsgen: *** PDS IMS.ACBLIB is created.

[pdsgen IMS.ACBLIB DEFVOL -f L -l 32760] returned 0
create_hidb_dbconn.sh START
Modified [HIDB_CLIENT\] section on /home/oframe3/OpenFrame/config/dbconn.conf successfully.
Modified [HIDB_BACKUP\] section on /home/oframe3/OpenFrame/config/dbconn.conf successfully.

Check if hidbcmd tool is running without errors.

$ hidbcmd -h
hidbcmd version 7.2.0(4) obuild@tplinux32:ofsrc7/ims(#2) 2007-11-10 10:43:12
HiDB DL/I Funcion Test Tool



Usage: hidbcmd -p PSBNAME [-pi PCBNUM]
       hidbcmd -d DBDNAME
       hidbcmd -h

Environment Commands ---------------------------------------------
     DETAILON     Detail infomation of PCB to result of DL/I Call
     DETAILOFF    Simple infomation of PCB to result of DL/I Call(Default)
     DEBUGON      Display input SSA
     DEBUGOFF     Debugon option off(Default)
     INHEXON      Input DATA conversion hex to char
     INHEXOFF     INHEX option off(Default)
     SSAHEXON     SSA value conversion hex to char
     SSAHEXOFF    SSAHEX option off(Default)

DL/I Commands ----------------------------------------------------
     FUNC -s "{SSA}" [-i "{DATA}"
          @ example
              GN
              GU -s "SEG1    (SEG1FLD1 =ABC)"
              ISRT -s "SEG1    " -i "ABC123"
              @ INHEXON
              ISRT -s "SEG1    " -i "414243313233"
              @ SSAHEXON
              GU -s "SEG1    (SEG1FLD1 =414243)"
     COMMIT
     ROLLBACK
     TAB          Print Table name of now position

Informational Commands -------------------------------------------
     HELP
     EXIT|QUIT

3. Uninstallation

HiDB can be uninstalled by using the uninstallation utility provided by the installer.

In the Unix terminal, run Uninstall_HiDB file in the ${OPENFRAME_HOME}/UninstallerDat directory.
```
$ ./Uninstall_HiDB
```
HiDB is removed by the uninstallation program.

4. Checking the Uninstallation

Since the uninstallation program deletes only the files created during the HiDB installation, any remaining directories and files must be deleted manually.