DBS configuration settings

The DBS configuration settings are specified in the form of a set of shell export commands that set variables with pre-defined names. The configuration variables must be specified in the configuration file. If the configuration file is not specified when InstallDBS script is run, a set of default values are used; these are specified below for the individual variables.

General Configuration Specification

Two variables in the general configuration file are used to configure Guardian group of global DBS administrator users, and initial global DBS administrator user. Both group name and group number must not be in use at configuration time. The configured user is added as a Guardian group manager (user number 255) for the global DBS administrator group. The default values are 100 for the group number and TENANT.ADMIN for initial global DBS administrator user.

export DATABASE_ADMIN_GROUP=guardian-group-number
export DATABASE_ADMIN_USER=guardian-username
Where,

guardian-group-number is the group number of the global DBS administrators.

guardian-username is the username of the initial global DBS administrator.

DBS OSS home setting

Though DBS client applications are off-platform applications, some files such as log files, SPJ class and jar files must be available on the system at the time of creating a SPJ. The OSS home setting configures a single OSS home directory for such data. The directory must not exist when configuring DBS. The OSS directory created during database creation is placed in the DBS OSS home directory.

The default value is /mxdbsdata.

export DATABASE_OSS_HOME=oss_path
Where,

oss_path is the full path of a valid OSS directory.

File-sharing group settings

A number of Safeguard file-sharing groups are set aside for DBS use. The name of the file-sharing groups have configurable prefix, combined with the group number.

export DATABASE_FILE_SHARING_GROUPS="fs-group-numbers"
export DATABASE_FSGROUP_PREFIX="fs-group-prefix"
Where,

fs-group-numbers are group numbers of the Safeguard file-sharing groups. fs-group-numbers can be specified in combination of intervals and individual values, separated by spaces. For example, 1001-1200 1300. The group numbers must be between 256 and 65535; group numbers or resulting group names must not exist in Safeguard when configuring DBS. The default value is 1001-1200.

fs-group-prefix is the prefix for the file-sharing group names. The default value is DBS_FS_GROUP.

Guardian user group settings

The group numbers must be 254 or lower; group numbers or resulting group names must not exist in Safeguard when configuring DBS.

export DATABASE_USER_GROUPS="group-numbers"
export DATABASE_USER_PREFIX="group-prefix"
export DATABASE_USER_INITIAL_PW="user-password"
Where,

group-numbers are group numbers of the Safeguard Guardian groups. group_numbers can be specified in combination of intervals and individual values, separated by spaces. The default values is 101-120.

group_prefix is the prefix for the Safeguard Guardian group names. The default value is DBS.

user-password is the initial password for Guardian users. The default value is pw.

CPU setting

Some or all of the CPUs on the system must be configured for user databases. By default, all the active CPUs when configuring DBS are available for DBS use.

export DATABASE_CPUS=cpus
Where,

cpus is list of CPUs configured for DBS use. cpus can be specified in combination of intervals and individual values, separated by spaces.

MXCS settings

Two initial MXOAS services must be configured for DBS use.

The following sample specifies the default values for MXCS settings, except for host name which will default to the host name configured for the $ZTC0 provider. The port numbers must be in the range 1024-65535. The sum of corresponding port number and port range cannot exceed 65535.

export DATABASE_MGMT_HOST_NAME=nonstop-host-name
export DATABASE_MGMT_PORT=2000
export DATABASE_MGMT_PORT_RANGE=60
export DATABASE_MGMT_GENERIC_PROCESS="DBS_MGMT_MXOAS"
export DATABASE_MGMT_PROCESS_NAME="\$ZAS01" 
export DATABASE_MGMT_DS_NAME="DBS_MGMT_DS" 
 
export DATABASE_ACCESS_HOST_NAME=nonstop-host-name
export DATABASE_ACCESS_PORT=2100
export DATABASE_ACCESS_PORT_RANGE=60000
export DATABASE_ACCESS_GENERIC_PROCESS="DBS_ACCESS_MXOAS"
export DATABASE_ACCESS_PROCESS_NAME="\$ZAS02"