5.5.29 Set OS init. settings and IP addr. of virtual servers (Linux)
Function
For a virtual server (Linux) in the VMware vSphere environment, perform the initial OS settings (the computer name, and time zone) and the IP address settings.
Start the newly created virtual server, and initialize the OS and perform customization.
This component requires the following servers:
- vCenter server
This is the server on which VMware vCenter Server is installed.
- ESX server
This is the server on which VMware vSphere ESXi is installed.
- vCenter control server (Execution target server)
This is the server on which VMware vSphere PowerCLI is installed. JP1/AO transfers the component to this server and executes it.
- Virtual server
This is the virtual server that is managed by the vCenter server and VMware vSphere ESXi.
Up to 4 IP addresses can be set for the virtual server. For the first IP address (for management), set the IP address for managing the virtual server that was deployed. For the second to fourth IP addresses for the second, third, and fourth NICs, set IP addresses for management and applications based on the operations being performed by the users. Depending on how many NICs the virtual server has, the setting order of the IP addresses is as follows.
- When the virtual server has one NIC
Set the IP addresses that were specified first in the following order: the IP address for management, the IP address for the second NIC, the IP address for the third NIC, the IP address for the fourth NIC. Note that the other IP addresses are discarded.
- When virtual server has two or more NICs
Set the IP addresses in the following order: the IP address for management, the IP address for the second NIC, the IP address for the third NIC, and the IP address for the fourth NIC. If a specified IP address is blank, set the IP addresses without leaving empty spaces. For example, if the specified IP addresses are the IP address for management, the IP address for the second NIC, and the IP address for the fourth NIC (without any IP address for the third NIC), set the IP address for the fourth NIC to the third NIC of the virtual machine. Note that, if the number of entered IP addresses exceeds the number of NICs held by the virtual server, the excess IP addresses are discarded.
The IP address of the DNS server is set for the virtual server, not for each NIC. Set the DNS server IP addresses to the virtual server that were specified first in the following order: the DNS server IP address for management, the DNS server IP address for the second NIC, the DNS server IP address for the third NIC, and the DNS server IP address for the fourth NIC.
The time zones that can be specified are shown below.
America/Adak
America/Anchorage
America/Boise
America/Chicago
America/Denver
America/Detroit
America/Indiana/Indianapolis
America/Indiana/Knox
America/Indiana/Marengo
America/Indiana/Petersburg
America/Indiana/Tell_City
America/Indiana/Vevay
America/Indiana/Vincennes
America/Indiana/Winamac
America/Juneau
America/Kentucky/Monticello
America/Los_Angeles
America/LouisVille
America/Menominee
America/Monterrey
America/Montevideo
America/New_York
America/Nome
America/North_Dakota/Beulah
America/North_Dakota/Center
America/North_Dakota/New_Salem
America/Phoenix
America/Shiprock
America/Tijuana
America/Vancouver
America/Yakutat
Asia/Chongqing
Asia/Hong_Kong
Asia/Kolkata
Asia/Macau
Asia/Shanghai
Asia/Singapore
Asia/Tokyo
Etc/UTC
Europe/London
Pacific/Honolulu
If nothing is specified, the time zone in the template is used. For this reason, if the value that you want to set in the time zone property list is not found, set the time zone in the template beforehand.
Use situation
This can be used for creating a virtual server for Linux. Calling this after executing the vsphereCreateVM component enables you to perform the OS initial settings.
Prerequisites
For the latest support information about [Required products on the execution target system]/[Required products on the execution target server]/[Prerequisite product OS running in the execution target server], see the release notes.
In addition, the following OS and products use abbreviations. For the abbreviations of OS and products, see the "Preface".
[Required products on the execution target system]
(1) Prerequisite product of vCenter Server
- VMware vCenter Server
(2) Prerequisite product of ESX Server
- VMware vSphere ESXi
(3) Prerequisite OS running in the virtual servers
The following OSs are supported, based on the required products for the vCenter server and the required products for the VMware vSphere ESXi/vCenter control server that manages the virtual server.
- Red Hat Enterprise Linux Server
[Usage conditions for required products in the execution target system]
(1) VMware vSphere ESXi must be managed by VMware vCenter Server.
(2) Setting Requirements of VMware vSphere ESXi
- The data store has been registered.
- The port group has been set. For the port group to be set in the virtual server, specify the port group on the network using the standard virtual switch (vNetwork standard switch/vSphere standard switch).
(3) Virtual server requirements
- VMware Tools has been installed.
- The remote commands have been set to be executable (SSH is enabled in the virtual server).
- The NICs must be already set (up to a maximum of four).
(4) Virtual server requirements
- Duplicate virtual server names must not be managed under the same vCenter.
[Required products on the execution target server]
- VMware PowerCLI
[Prerequisite product OS running in the execution target server]
- Windows Server
Cautions
(1) If the virtual server that is created uses Linux, the domain name and DNS suffix are required. If these are not specified, "localdomain" is set.
(2) Specify the IP address, subnet mask, and default gateway at the same time. If one of these items is not specified, none of these items are set.
(3) If the repeat count for obtaining OS information is not specified, "72" is set.
(4) If the repeat execution interval for obtaining OS information is not specified, "5" is set.
(5) Do not enter values that cannot be set as IP addresses for the IP address that is set to the OS of the virtual server. For example, network addresses, broadcast addresses, and special addresses such as "0.0.0.0" and "255.255.255.255" cannot be specified. If one of these addresses is entered, an error will occur in the deployment of the virtual server. Also, for the IP address for management, enter an IP address capable of communication with the JP1/AO server. Even if the address is correct, the virtual server might fail to deploy.
(6) The IP address is set as described in "Functions", but depending on the order that the NICs were set in the OS of the virtual server, the IP addresses might not be set properly. Make sure that the IP addresses were set after the virtual server is created. If the IP addresses were not set properly, change them manually.
(7) If deploying Linux, set the root password of the template OS using the characters that can be specified in the Linux.adminPassword properties.
(8) The IP address that is set to the virtual server must not duplicate the IP address of any other server. If another server has the same IP address, the NIC of the virtual server is invalid, and the task is abnormally terminated.
(9) You must use open-vm-tools 9.10 or later for VMware Tools. If you use any version older than open-vm-tools 9.10, the host name is not modified and the component is not finished for the duration resulting from the number of attempts to acquire OS information multiplied by the interval for acquiring OS information.
Execution privilege
(1) The following privilege is required for users connected to VMware vCenter Server:
System administrator role
Version
02.11.00
Plug-in tags
Modify VM,VMware vSphere
Plug-in name displayed in the task log
vsphereSetOsinfoLin
Return code
0: Normal
23: Error (Environmental error) Invalid pre-conditioned environment
27: Error (Check the task log for the error details)
28: Error (Network start error) The network did not start after the power turned on
41: Error (An error has been detected in the component) Property not entered (An error has been detected in the component script)
Property list
The following table lists the properties:
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
---|---|---|---|---|---|
VMware.vmName |
Virtual server name |
Specify the name of the virtual server. This name is used to represent the virtual server in VMware vCenter server. It is not used as a host name by the OS. |
-- |
Input |
R |
common.computerName |
Computer/Host name |
Specify the computer name (host name) used by the operating system. The computer name of a maximum of 15 characters is specified, in the case of Windows. The computer name of a maximum of 63 characters is specified, in the case of Linux. |
-- |
Input |
R |
OS.ipAddressMan |
IP address (management LAN) |
Specify the IP address for the management LAN of the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.subnetMaskMan |
Subnet mask (management LAN) |
Specify the subnet mask for the management LAN of the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.defaultGWMan |
Default gateway (management LAN) |
Specify the default gateway for the management LAN of the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.dnsMan |
DNS server IP address (management LAN) |
Specifies the IP address of the DNS server that is set for the virtual server. IPv6 addresses are not supported. |
-- |
Input |
O |
OS.ipAddress2 |
The 2nd IP address |
Specify the 2nd IP address for the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.subnetMask2 |
The 2nd Subnet mask |
Specify the 2nd subnet mask for the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.defaultGW2 |
The 2nd Default gateway |
Specify the 2nd default gateway for the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.dns2 |
The 2nd DNS server IP address |
Specifies the IP address of the DNS server that is set for the virtual server. IPv6 addresses are not supported. |
-- |
Input |
O |
OS.dnsSuffix |
DNS suffix :Linux only |
Specify the DNS suffix of the virtual server (Linux only). When there is no input, "localdomain" is set as the DNS suffix. |
-- |
Input |
O |
OS.workgroupNameDomainName |
Domain name |
Specifies the domain name to which the virtual server belongs. |
-- |
Input |
O |
Linux.adminPassword |
Password of OS user with administrator privileges: Linux-specific |
Specifies the password of the OS user with administrator privileges in order to check OS settings. Specified only if the OS to be created is Linux. |
-- |
Input |
R |
VMware.checkOSInitCount |
Number of attempts to acquire OS information |
Specify the number of times the service attempts to acquire OS information to confirm that the OS has been initialized. The maximum wait time is determined by this property and the property that defines the checkOSInitCountInterval. |
72 |
Input |
O |
VMware.checkOSInitInterval |
Interval for acquiring OS information (minutes) |
Specify the interval at which the service attempts to acquire OS information to confirm that the OS has been initialized. |
5 |
Input |
O |
VMware.vCenterServerName |
VMware vCenter server name |
Specify the host name or IP address of the VMware vCenter server. You cannot specify an IPv6 address. |
-- |
Input |
R |
VMware.userName |
User name for VMware vCenter Server connection |
Specify the user name to use when connecting to the VMware vCenter server. |
-- |
Input |
R |
VMware.password |
Password for VMware vCenter Server connection |
Specify the password to use when connecting to the VMware vCenter server. |
-- |
Input |
R |
VMware.portNumber |
Port number for VMware vCenter Server connection |
Specify the port number to use when connecting to the VMware vCenter server (specifically, the port number of the VMware vCenter server's Web service). If you omit this property, the default value of the VMware vCenter server applies. |
443 |
Input |
O |
VMware.protocol |
Protocol for VMware vCenter Server connection |
Specify the protocol to use when connecting to the VMware vCenter server. |
https |
Input |
R |
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
OS.timeZone |
Time Zone |
Specifies the time zone that is set to the OS of the virtual server. If nothing is entered, the time zone in the template is used. |
-- |
Input |
O |
OS.ipAddress3 |
The 3rd IP address |
Specify the 3rd IP address for the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.subnetMask3 |
The 3rd Subnet mask |
Specify the 3rd subnet mask for the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.defaultGW3 |
The 3rd Default gateway |
Specify the 3rd default gateway for the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.dns3 |
The 3rd DNS server IP address |
Specifies the IP address of the DNS server that is set for the virtual server. IPv6 addresses are not supported. |
-- |
Input |
O |
OS.ipAddress4 |
The 4th IP address |
Specify the 4th IP address for the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.subnetMask4 |
The 4th Subnet mask |
Specify the 4th subnet mask for virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.defaultGW4 |
The 4th Default gateway |
Specify the 4th default gateway for the virtual server. You cannot specify an IPv6 address. |
-- |
Input |
O |
OS.dns4 |
The 4th DNS server IP address |
Specifies the IP address of the DNS server that is set for the virtual server. IPv6 addresses are not supported. |
-- |
Input |
O |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |
common.flag2IPsSetup |
Multiple IP setting for virtual server |
A work property that indicates whether the virtual server has multiple IP addresses (true), or not (false). |
-- |
Output |
O |