2.3.36 Operands related to unit structure

177) pdunit -x host-name
-u unit-identifier
[-d "HiRDB-directory-name"]
[-c host-name]
[-p port-number]
This operand must be specified; it cannot be omitted.
HiRDB/Single Server
The unit structure of a HiRDB/Single Server is defined. The following items can be specified:
  • Host name
  • Unit identifier
  • HiRDB directory name
  • Secondary system host name
Specification guidelines
  • This operand may be omitted if the system consists of a single HiRDB/Single Server. If this operand is omitted, the installation directory is assumed for the HiRDB directory. However, it cannot be omitted when the system switchover facility is used.
  • When the system switchover facility is used, the same definition must be applied to both the primary and secondary systems.
  • In the case of mutual system switchover, a multi-HiRDB structure is used (two different HiRDB/Single Servers coexist in a single host), and the same definition cannot be used for two different HiRDB/Single Servers.
  • Table 2-2 shows the host name when the pdunit operand's -x option and the pd_hostname operand are specified.

    Table 2-2 Host name when pdunit operand's -x option and pd_hostname operand are specified (for HiRDB/Single Server)

    Conditionpdunit operand's -x option valuepd_hostname operand value
    System switchover facility is not usedStandard host name (host name, IP address, or FQDN)Default or standard host name (host name, IP address, or FQDN)
    Host name other than the standard host name (host name, IP address, or FQDN)Standard host name or the host name specified in the pdunit operand's -x option#1 (host name, IP address, or FQDN)
    Loopback address (localhost or 127.0.0.1)#2Loopback address (localhost or 127.0.0.1)#1#2
    Monitor mode (IP address inherited)#3Relocatable IP address, host name with a relocatable IP address, or FQDNStandard host name or the host name specified in the pdunit operand's -x option#1 (host name, IP address, or FQDN)
    (host name, IP address, or FQDN)
    Loopback address (localhost or 127.0.0.1)#2Loopback address (localhost or 127.0.0.1)#1#2
    Monitor mode or server mode (IP address not inherited)#4Primary system's host name (host name, IP address, or FQDN)Primary system's standard host name (host name, IP address, or FQDN)
Note
If the standard host name is specified as FQDN in the pdunit operand's -x option or in the pd_hostname operand, the standard host name must be defined in the FQDN format.
#1
Use the same format as in the pdunit operand's -x option.
#2
localhost can be specified if it can be used as the host name (such as when it is already set in the hosts file or name server).
#3
Specify the virtual network name that is registered in MSCS's resources (network name). For details about registering virtual network names, see the HiRDB Version 8 System Operation Guide.
#4
Specify the secondary system's host name (host name, IP address, or FQDN) in the pdunit operand's -c option.
-x host-name
[Figure]<host name>((1-32 characters))
Specifies in one of the formats listed below the host name of the server machine in which the HiRDB/Single Server is defined. Always use the same specification format for a server machine. For example, once a host name is specified, an IP address must not be specified for a host on the same server machine.
  • host name
  • IP address
  • FQDN
  • loopback address (localhost or 127.0.0.1)
For specification examples, see Settings for a DNS server to manage IP addresses in the HiRDB Version 8 Installation and Design Guide.
When specifying the host name
  • Specify the host name displayed when the hostname command is executed.
  • Host names are case sensitive.
  • You cannot specify aliases for host names.
  • If you do not use a DNS server, register the host name specified here in the hosts file.
When specifying the loopback address
Use the multi-connection address facility or high-speed connection facility. If these functions are not used, the HiRDB server cannot be accessed from other server machines.
-u unit-identifier
[Figure]<identifier>((4 characters))
Specifies a unit identifier. The unit identifier specified here is also specified in the pd_unit_id operand in the unit control information definition.
-d "HiRDB-directory-name"
[Figure]<pathname of up to 200 characters><<value of environment variable PDDIR>>
Specifies the name of the HiRDB directory.
The HiRDB directory name is not case sensitive.C:\hirdb_x is treated as the same as C:\HIRDB_X.
-c host-name
[Figure]<host name>((1-32 characters))
Specifies the secondary system's host name in one of the formats listed below. You specify this option for system switchover in which IP addresses are not inherited. Always use the same specification format for a server machine. For example, once a host name is specified, an IP address must not be specified for a host on the same server machine.
  • host name
  • IP address
  • FQDN
  • loopback address (localhost or 127.0.0.1)
When specifying the host name
  • Host names are case sensitive.
  • You cannot specify aliases for host names.
  • If you do not use a DNS server, register the host name specified here in the hosts file.
When specifying the loopback address
Use the multi-connection address facility or high-speed connection facility. If these functions are not used, the HiRDB server cannot be accessed from other server machines.
-p port-number
[Figure]<unsigned integer>((5001-65535))
Do not specify this option for a HiRDB/Single Server.
HiRDB/Parallel Server
The unit structure of a HiRDB/Parallel Server is defined. The following items can be specified:
  • Host name
  • Unit identifier
  • HiRDB directory name
  • Secondary system host name
  • Unit port number
Specification guidelines
  • This operand may be omitted if the system consists of a single unit. If this operand is omitted, the installation directory is assumed for the HiRDB directory.
  • Information on all units that comprise the HiRDB/Parallel Server must be defined with this operand. For example, if there are three units, three pdunit operands must be specified.
  • This operand cannot be omitted when the system switchover facility is used.
  • When the system switchover facility is used, the same definition must be applied to both the primary and secondary systems.
  • In the case of mutual system switchover, a multi-HiRDB structure is used (two different units coexist in a single host), and the same definition cannot be used for two different units.
  • Table 2-3 shows the host name when the pdunit operand's -x option and the pd_hostname operand are specified.

    Table 2-3 Host name when pdunit operand's -x option and pd_hostname operand are specified (for HiRDB/Parallel Server)

    Conditionpdunit operand's -x option valuepd_hostname operand value
    System switchover facility is not usedStandard host name (host name, IP address, or FQDN)Default or standard host name (host name, IP address, or FQDN)
    Host name other than the standard host name (host name, IP address, or FQDN)Standard host name (host name, IP address, or FQDN)
    Monitor mode (IP address inherited)#1Relocatable IP address, host name with a relocatable IP address, or FQDNPrimary system's standard host name (host name, IP address, or FQDN)
    Monitor mode or server mode (IP address not inherited)#2Primary system's host name (host name, IP address, or FQDN)Primary system's standard host name (host name, IP address, or FQDN)
Note
If the standard host name is specified as FQDN in the pdunit operand's -x option or in the pd_hostname operand, the standard host name must be defined in the FQDN format.
#1
Specify the virtual network name to be registered in the MSCS resource (network name). For details on virtual network name registration, see the HiRDB Version 8 System Operation Guide.
#2
  • Specify the secondary system's host name (host name, IP address, or FQDN) in the pdunit operand's -c option.
  • The same host name cannot be specified more than once in the pdunit operand's -x and -c options. The following shows examples of correct and incorrect specifications:
Correct examples
pdunit -x hostA ... -c hostAA
pdunit -x hostB ... -c hostBB
Incorrect examples
pdunit -x hostA ... -c hostB
pdunit -x hostB ... -c hostA
For an example of HiRDB system definition that uses system switchover in which IP addresses are not inherited, see C.4 Example 4 (HiRDB/Parallel Server: when the standby system switchover facility is used).
-x host-name
[Figure]<host name>((1-32 characters))
Specifies in one of the formats listed below the host name of the server machine in which the HiRDB/Parallel Server is defined. Always use the same specification format for a server machine. For example, once a host name is specified, an IP address must not be specified for a host on the same server machine.
  • host name
  • IP address
  • FQDN
For specification examples, see Settings for a DNS server to manage IP addresses in the HiRDB Version 8 Installation and Design Guide.
When specifying the host name
  • Specify the host name displayed when the hostname command is executed.
  • Host names are case sensitive.
  • You cannot specify aliases for host names.
  • If you do not use a DNS server, register the host name specified here in the hosts file.
-u unit-identifier
[Figure]<identifier>((4 characters))
Specifies a unit identifier. The unit identifier specified here is also specified in the pd_unit_id operand in the unit control information definition of each unit.
-d "HiRDB-directory-name"
[Figure]<pathname of up to 200 characters><<value of environment variable PDDIR>>
Specifies the name of the HiRDB directory.
The HiRDB directory name is not case sensitive.C:\hirdb_x is treated as the same as C:\HIRDB_X.
Notes
  • When using the standby-less system switchover (1:1) facility
    Specify the same HiRDB directory name in the normal and back-end server units.
  • When using the standby-less system switchover (effects distributed) facility
    Specify the same HiRDB directory name in all units belonging to the same HA group.
  • The environment variable that is set in the unit that executed the pdstart -q command is set for the environment variable PDDIR. If you omit the -d option for a system composed of multiple units, specify the same HiRDB directory name for all units.
-c host-name
[Figure]<host name>((1-32 characters))
Specifies the secondary system's host name in one of the formats listed below. You specify this option for system switchover in which IP addresses are not inherited. Always use the same specification format for a server machine. For example, once a host name is specified, an IP address must not be specified for a host on the same server machine.
  • host name
  • IP address
  • FQDN
This option cannot be specified for the units described below. If it is specified, HiRDB cannot start (message KFPS01896-E is output).
  • Unit to which the standby-less system switchover (1:1) facility is applied. (IP address inheriting does not occur.)
  • Unit to which the standby-less system switchover (effects distributed) facility is applied. (IP address inheriting does not occur.)
When specifying the host name
  • Host names are case sensitive.
  • You cannot specify aliases for host names.
  • If you do not use a DNS server, register the host name specified here in the hosts file.
-p port-number
[Figure]<unsigned integer>((5001-65535))
This option is specified when the system switchover facility is used. Specifies the port number of the unit.
If this option is omitted, the port number of the local system (the value of the pd_name_port operand) is assumed.
Specification guidelines
  • For the unit in which the system manager is located, the port number specified in pd_name_port is specified.
  • For a unit in which the system manager is not located, the port number of that unit is specified.
  • If there are multiple units in a single server machine, as in a mutual system switchover configuration, a different port number must be specified for each unit.
Notes
  • Specify a number that is not within the range of port numbers assigned automatically by the OS. The range of port numbers assigned automatically by the OS depends on the OS.
  • If a port number is specified that is within the range of port numbers assigned automatically by the OS, that number might be being used by another program. If it is, HiRDB cannot start.
  • If you use the standby-less system switchover (1:1) facility, specify the same port number for the normal BES unit and the alternate BES unit.
  • If you use the standby-less system switchover (effects distributed) facility, specify the same port number for all units belonging to the same HA group.