HOSTnn Keyword


 

     Hostnn="dynamic" | [[serialnum]:{ip | URL}[:{portnum}][:{flags}]

 

This keyword specifies the Sunbelt serial number, IP/URL address, and port number for the data manager servers that are connected to the replication network. All of the HOSTnn definitions must be specified in the configuration file of the primary data manager. Only the HOST00 need be specified in the configuration file of the secondary data managers. Additional host information is transferred from the primary data manager to the secondary data managers during the startup processing. The nn value may be a value from 00 to 03.

 

This keyword must be specified in the replication section that is included in the configuration file for the primary server.

Format:

 

HOSTnn="dynamic" | [[serialnum]:{ip | URL}[:{portnum}][:{flags}]

 

Where:

Hostnn
The HOST00 keyword defines the setting for the primary master data manager in the replication network. The HOST01, HOST02, and HOST03 keywords defines the setting for the first, second, and third secondary data managers respectively.
"dynamic"
If the HOST01, HOST02, or HOST03 keywords are set to a value of "dynamic", the secondary server logs on to the primary server using a dynamic IP address. The feature allows use of a secondary server that does not have a static address. In this case, the serial number, IP/URL, and port number fields are not specified.
serialnum
This parameter is the Sunbelt 'Nnnnnnn' or the 'Dnnnnnn' serial number for the data manager. The serial number can be found in the SUNDM heading information or in a log file logging is enabled. If the data manager is installed with the serial number of "demo", the serial number is 'D999999'.
 
For HOST00, this string defines the serial number for the primary data manager in the network. If the serial number has the format 'Dnnnnnn', the primary data manager is executing in a demo mode. This field is optional and if it not specified, the current SUNDM serial number is used for the primary. For a secondary data manager, this field is not used.
 
For HOST01, this string defines the serial number for the first secondary data manager in the network. If the serial number has the format 'Dnnnnnn', the replication data managers execute in a demo mode. This field must be specified.
 
For HOST02 and HOST03, this string defines the serial numbers for the second and third secondary data managers in the network. This field must be specified. A 'Dnnnnnn' serial number is not allowed for this keyword setting.
 
When executing in demo mode, the following restrictions exist:

 

  1. The SUNDM replication network can only have a primary and one secondary replication server.

  2. A single managed replication directory as specified by the MANAGED_DIR01 is allowed.

  3. A single unmanaged replication directory as specified by the UNMANAGED_DIR01 is allowed.

  4. All other replication directory keywords are ignored.

  5. Any SUNDM data manager with the 'Dnnnnnn' serial number has an expiration date beyond which the software will not execute. The 'sundm -e' command will display the expiration date. Also, these data managers are limited to two managed file logons at any given time.

ip | URL
This parameter is an IP address or the URL of the server executing the data manager task in the format nnn.nnn.nnn.nnn.
port number
This parameter is optional and it specifies the IP port number assigned to the data manager task. The port number 3934 has been assigned as a registered user port number by IANA (Internet Assigned Numbers Authority) and is the default port number.
flags
This optional parameter specifies host flags as defined below.

Note:

 

  1. The HOSTnn IP/URL settings identify the remote URL/IP address used when one replication server connects with another. The HOSTnn settings must not be set to 0.0.0.0 or 127.0.0.1.

  2. The {flags} parameter allows the NO_FILE_DELETES and SECONDARY_SCAN keywords to be turned off or on for individual secondary or backup servers. The flags are represented by alpha characters in a comma separated list. A leading '-' character indicates that the flag is to be cleared. The flags in the HOSTnn keyword override the global NO_FILE_DLETES and SECONDARY_SCAN keyword settings. The currently supported flags are:

  3.  

    Flag

    For a specific host server, the ...

    N or n

    NO_FILE_DELETES is set to be ON.

    -N or -n

    NO_FILE_DELETES is set to be OFF.

    S or s

    SECONDARY_SCAN is set to be ON.

    -S or -s

    SECONDARY_SCAN is set to be OFF.

 

Example 1 (Primary Server)

 

HOST00=N123456:63.162.221.99

HOST01=N000001:www.sunbelt-plb.com

HOST02=dynamic

HOST03=N000099:63.162.1.2:52105

Example 2 (Primary Server)

 

HOST00=:63.162.221.99

HOST01=N000001:www.sunbelt-plb.com

Example 3 (Primary Demo Server)

 

HOST00=N123456:63.162.221.99

HOST01=D999999:210.211.1.2

 

Example 4 (Secondary Server)

 

HOST00=N123456:63.162.221.99

Example 5 (Secondary Server)

 

HOST00=:63.162.221.99

Example 6 (Flags)

 

HOST01=N999999:192.168.110.99:3934:S,N

HOST02=N999999:192.168.110.98:3934:S,-N

 

 

See Also: SUNDM Keywords, SUNADMIN, MAKEMFD



about_sundm FAIL_TIME Keyword IDLE_CLOSE Keyword