Pre-installation Tasks

This chapter describes how to perform pre-installation tasks such as verifying hard disk space and creating an installation properties file.

1. Overview

Before installing OpenFrame/HiDB (hereafter HiDB), you need to perform the following tasks:

Check the system requirements for installation
Check that enough disk space is available
Create an installation properties file

2. System Requirements

The following are the system requirements for installing HiDB.

	Requirement
Platform	Solaris 11 (SunOS 5.11) (32-bit, 64-bit)
Linux x86 2.6 (32-bit, 64-bit)
Linux ia64 2.6 (32-bit, 64-bit)
Hardware	More than 5 GB hard disk space
More than 8 GB RAM
Database	Tibero 6 FixSet07
Compiler	MF COBOL, NET COBOL, or OpenFrame COBOL compiler
OpenFrame PL/I compiler
OpenFrame ASM compiler
OpenFrame Product Line	OpenFrame/Base 7.1

Requirement

Platform

Solaris 11 (SunOS 5.11) (32-bit, 64-bit)

Linux x86 2.6 (32-bit, 64-bit)

Linux ia64 2.6 (32-bit, 64-bit)

Hardware

More than 5 GB hard disk space

More than 8 GB RAM

Database

Tibero 6 FixSet07

Compiler

MF COBOL, NET COBOL, or OpenFrame COBOL compiler

OpenFrame PL/I compiler

OpenFrame ASM compiler

OpenFrame Product Line

OpenFrame/Base 7.1

If you have any inquiry on AIX and HP-UX platforms, contact the technical support team.

3. Verifying Available Disk Space

Before installing HiDB, verify that there is enough disk space available. For this, execute the df command at the Unix terminal.

The following example shows how to use the df command to see how much free space is available in a disk that contains the installation directory you have chosen. To display the results in units of GBs, use the -h option. In this example, the command is executed on a Linux machine using the Linux x86 operating system.

$ df -h /home/oframe

The following shows the result.

Filesystem                         Size  Used Avail Use% Mounted on
/dev/mapper/centos_oflinux64-home  144G   49G   96G  34% /home

You can see that the /home/oframe directory is located on the /dev/mapper/centos_oflinux64-home disk. The total size of the disk is 144 GB, of which 34% (49 GB) is in use and 96 GB is available.

4. Verifying OpenFrame Suite Installation

HiDB is affected by other individual products. To install and use HiDB, make sure to install OpenFrame/Base, OpenFrame/Batch, and OpenFrame/TACF first.

The following example shows how to verify the installed OpenFrame suite by using the ofversion tool.

$ ofversion
ofversion version 7.1.0(0) obuild@tplinux64:ofsrc71/base(#1) 2021-03-17 23:07:27
Print OpenFrame Version Information

OpenFrame Solution is Composed of
- OpenFrame/Base 7.1 64bit
- OpenFrame/Batch MVS 7.1 64bit
- OpenFrame/TACF 7.1 64bit

For installation and verification of the OpenFrame suite, refer to Installation Guide for each product.

5. Creating an Installation Properties File

You can install HiDB by executing the installation script after configuring values in the installation properties file. The installer performs the installation by using the values defined in the properties file.

This section describes the items to be included in the HiDB installation properties file. A sample installation properties file is shown in Sample Installation Properties File.

The name of a properties file must be hidb.properties. The file must be a general text file. It is recommended to create a properties file by referring to the sample configuration file provided with the installer. When creating an installation properties file, set all options for automatically creating data sets to either 'YES' or 'NO'.

5.1. Setting the OpenFrame Installation Directory

To install HiDB, set an installation directory. Enter the absolute path in which OpenFrame is installed. The directory set here is used as OpenFrame’s home directory in all configuration files. Other products running on OpenFrame/Base must also be installed in the same directory.

The following is the item required to set OpenFrame’s home directory.

OPENFRAME_HOME=path

Item	Description
OPENFRAME_HOME	Unix directory or file path.

Item

Description

OPENFRAME_HOME

Unix directory or file path.

The following is an example of setting the OpenFrame home directory to /home/oframe/OpenFrame.

OPENFRAME_HOME=/home/oframe/OpenFrame

5.2. Setting HiDB

Sets environment values related to paths and the database account used in HiDB.

COPYBOOK_DIR=<path>
HIDB_OBJECT_DIR=<path>
HIDB_IMPORT_DIR=<path>
DEFAULT_VOLSER=<volume>
SYSTEM_TABLESPACE=<tablespace>
TABLESPACE=<tablespace>
DATABASE=<database_name>
USERNAME=<user_name>
PASSWORD=password
HIDB_PRECOMP_INCLUDE1=<path>
HIDB_PRECOMP_INCLUDE2=<path>
HIDB_PRECOMP_INCLUDE3=<path>

Item	Description
COPYBOOK_DIR	Path to the copybook file created by referencing DBD segments.
HIDB_OBJECT_DIR	Path to the pc file created by referring to DBD control blocks and copybooks.
HIDB_IMPORT_DIR	Path to the temporary file used to load data sets to the HiDB database.
DEFAULT_VOLSER	Name of the default volume to use in OpenFrame.
SYSTEM_TABLESPACE	Tablespace that manages the data generated by OpenFrame/Base.
TABLESPACE	Tablespace that manages the data generated by HiDB.
DATABASE	Database name (DSN) to access.
USERNAME	User ID for accessing the database using HiDB. Set to a string with numbers (0 to 9), alphabetic characters (A to Z, a to z), and special characters (@, #, $, _).
PASSWORD	User’s password to access the database using HiDB.
HIDB_PRECOMP_INCLUDE1, HIDB_PRECOMP_INCLUDE2, HIDB_PRECOMP_INCLUDE3	Paths to C header files used to precompile the pc files.

Item

Description

COPYBOOK_DIR

Path to the copybook file created by referencing DBD segments.

HIDB_OBJECT_DIR

Path to the pc file created by referring to DBD control blocks and copybooks.

HIDB_IMPORT_DIR

Path to the temporary file used to load data sets to the HiDB database.

DEFAULT_VOLSER

Name of the default volume to use in OpenFrame.

SYSTEM_TABLESPACE

Tablespace that manages the data generated by OpenFrame/Base.

TABLESPACE

Tablespace that manages the data generated by HiDB.

DATABASE

Database name (DSN) to access.

USERNAME

User ID for accessing the database using HiDB.

Set to a string with numbers (0 to 9), alphabetic characters (A to Z, a to z), and special characters (@, #, $, _).

PASSWORD

User’s password to access the database using HiDB.

HIDB_PRECOMP_INCLUDE1, HIDB_PRECOMP_INCLUDE2, HIDB_PRECOMP_INCLUDE3

Paths to C header files used to precompile the pc files.

The following is an example of setting various paths and the database account.

COPYBOOK_DIR=/home/oframe/OpenFrame/hidb/copybook
HIDB_OBJECT_DIR=/home/oframe/OpenFrame/hidb/hidb_sch
HIDB_IMPORT_DIR=/home/oframe/OpenFrame/hidb/hidb_import
DEFAULT_VOLSER=DEFVOL
SYSTEM_TABLESPACE=OFM_REPOSITORY
TABLESPACE=DEFVOL
DATABASE=oframe
USERNAME=tibero
PASSWORD=tmax
HIDB_PRECOMP_INCLUDE1=/usr/include
HIDB_PRECOMP_INCLUDE2=/usr/local/include
HIDB_PRECOMP_INCLUDE3=/usr/lib/gcc/x86_64-redhat-linux/4.8.2/include

5.3. Setting Libraries

Sets environment values related to names of the system libraries used in HiDB and whether to create it or not.

DBDLIB_NAME=<dsname>
PSBLIB_NAME=<dsname>
RESLIB_NAME=<dsname>
ACBLIB_NAME=<dsname>

LIB_CREATE=YES|NO

Item	Description
DBDLIB_NAME	Name of a system library data set that stores DBD control blocks.
PSBLIB_NAME	Name of a system library data set that stores PSB control blocks.
RESLIB_NAME	Name of a system library data set that stores DAB control blocks.
ACBLIB_NAME	Name of a system library data set that stores ACB control blocks.
LIB_CREATE	Option whether to create system library data sets used in HiDB. YES: System library data sets are automatically created during HiDB installation. NO: System library data sets are not created during installation. To create them manually, run create_lib_hidb.sh script in the ${OPENFRAME_HOME}/scripts directory.

Item

Description

DBDLIB_NAME

Name of a system library data set that stores DBD control blocks.

PSBLIB_NAME

Name of a system library data set that stores PSB control blocks.

RESLIB_NAME

Name of a system library data set that stores DAB control blocks.

ACBLIB_NAME

Name of a system library data set that stores ACB control blocks.

LIB_CREATE

Option whether to create system library data sets used in HiDB.

YES: System library data sets are automatically created during HiDB installation.
NO: System library data sets are not created during installation. To create them manually, run create_lib_hidb.sh script in the ${OPENFRAME_HOME}/scripts directory.

The following is an example of configuring the system library names and whether to create it.

DBDLIB_NAME=IMS.DBDLIB
PSBLIB_NAME=IMS.PSBLIB
RESLIB_NAME=IMS.RESLIB
ACBLIB_NAME=IMS.ACBLIB

LIB_CREATE=YES

5.4. Setting the License

To operate HiDB, issue the license file and copy it to a specified directory. The installer automatically copies the license file to the ${OPENFRAME_HOME}/license directory.

OPENFRAME_LICENSE_PATH=<path>

Item	Description
OPENFRAME_LICENSE_PATH	Absolute path to HiDB license file. The license file in this path is copied to the ${OPENFRAME_HOME}/license directory.

Item

Description

OPENFRAME_LICENSE_PATH

Absolute path to HiDB license file. The license file in this path is copied to the ${OPENFRAME_HOME}/license directory.

The following is an example of specifying the absolute path for the license file.

OPENFRAME_LICENSE_PATH=/home/oframe/Installer/license/OPENFRAME