This product sets the host names (computer names) for the virtual servers that are deployed. These names are automatically generated as below:
VXXXXXXXXXNNNN XXXXXXXXX: Nine arbitrary alphanumeric characters (part of the L-Platform ID) NNNN: A four-digit serial number starting from 0001
The setting method can be changed to make the correspondence between these host names and actual servers more obvious.
The following setting methods can be selected:
Setting method number | Setting method | Description |
|---|---|---|
1 | This is the original function. | |
2 | The host name is set to the string that the user specifies as the "server name" in the ROR console. | |
3 | The Template Manager specifies a special string, and the host name is set to a string consisting of this special string followed by a serial number. | |
4 | The host name is set to a string consisting of the tenant ID for the user followed by a serial number. |
Use the following procedure to specify the setting method:
Open the definition file in a text editor.
The definition file is stored in the following location:
[Windows]
<Installation directory for this product>\RCXCFMG\config\vsys_config.xml
[Linux]
/etc/opt/FJSVcfmg/config/vsys_config.xml
Add the following keys and values:
Key name | Setting range | Content |
|---|---|---|
hostname-method | 1 to 4 | Specify the method for setting host names. If this key is omitted, "1" will be used as the default value. Note: The number specified for this key corresponds to the setting method number in the table. |
hostname-header | An arbitrary string with one to eight characters (*) | Specify the particular string to be set as the host name. This key is only valid if "3" is specified for the "hostname-method" key. If this key is omitted, "VM-" will be used as the default value. |
hostname-digits | 1 to 7 | Specify the number of digits for the serial number to be set for the host name. This key is only valid if "3" or "4" is specified for the "hostname-method" key. If this key is omitted, "7" will be used as the default value. |
hostname-check | yes/no | This key specifies whether to check for duplicate host names. This key is only valid if "2" is specified for the "hostname-method" key. yes: Returns a deployment error if the same host name exists on the server where the system has been deployed. no: Does not return an error even if the same host name exists. If this key is omitted, "yes" will be used as the default value. |
*: The characters that can be specified are alphanumeric characters and hyphens ("-"). However, the string cannot consist of only numbers.
A specification example is shown below:
Example
<properties version="1.0">
:
<entry key="hostname-method">3</entry>
<entry key="hostname-header">HOST-</entry>
<entry key="hostname-digits">4</entry>Save the file.
Restart the manager.
Refer to "7.2 Starting and Stopping the Manager" in the Setup Guide CE for information on how to Restart the manager.
The following host name will be automatically generated:
VXXXXXXXXXNNNN XXXXXXXXX: Nine arbitrary alphanumeric characters (part of the system ID) NNNN: A four-digit serial number starting from 0001
This behavior is the original (default) behavior.
This method directly sets the host name to the string that the user has set as the "server name" in the Manager View.
The characters that can be specified for the server name are subject to the following restrictions:
Maximum string length | 15 characters |
Characters that can be specified | Alphanumeric characters or hyphens ("-"). However, the string cannot consist of only numbers. |
A deployment error will occur if a string that does not match these restrictions is specified.
If "yes" has been specified for the "hostname-check" key, a deployment error will occur if you specify a server name that duplicates the name of a server that has already been deployed. (An error will also occur even if the server name duplicates the name of a server belonging to another organization.)
Note
Host names can be set up only when new systems are created.
The host name will not be changed even if the server name is changed by changing the configuration after deployment.
This method sets the host name to a string consisting of the string that the Template Manager has specified for the "hostname-header" key in the definition file, followed by a serial number with the number of digits specified by "hostname-digits".
The serial number starts from 1 and is left padded with zeros.
The serial number that will be set for the next server to be deployed can be checked using the command for displaying a list of serial numbers for host name settings (cfmg_listhostnamecounter).
Refer to "5.1 cfmg_listhostnamecounter (Display List of Serial Numbers for Host Name Settings)" in the Reference Guide for details on this command.
Example
When "VM-" is specified for "hostname-header" and "7" is specified for "hostname-digits"
VM-0000001
A deployment error will occur if the serial number overflows.
Serial numbers are unique within the entire Admin Server, but are managed separately for each of the strings specified for "hostname-header".
If the serial number has overflowed, either reset the serial number using the command for resetting the serial number for host name settings (cfmg_resethostnamecounter) or change the value for "hostname-header" to enable systems to be deployed again.
Refer to "5.2 cfmg_resethostnamecounter (Reset List of Serial Numbers for Host Name Settings)" in the Reference Guide CE for details
This method sets the host name to a string consisting of the tenant ID for the user that made the deployment request, followed by a serial number with the number of digits specified for "hostname-digits".
The serial number starts from 1 and is left padded with zeros.
The serial number that will be set for the next server to be deployed can be checked using the command for displaying a list of serial numbers for host name settings (cfmg_listhostnamecounter).
Refer to "5.1 cfmg_listhostnamecounter (Display List of Serial Numbers for Host Name Settings)" in the Reference Guide for details on this command.
Example
When "DIV" is specified for the tenant ID and "7" is specified for "hostname-digits"
DIV0000001
A deployment error will occur if the serial number overflows.
Serial numbers are managed separately for each organization ID.
If the serial number has overflowed, reset the serial number using the command for resetting the serial number for host name settings (cfmg_resethostnamecounter) to enable systems to be deployed again.
Refer to "5.2 cfmg_resethostnamecounter (Reset List of Serial Numbers for Host Name Settings)" in the Reference Guide for details on this command.