• vCenter server -- This is a server on which VMware vCenter Server is installed.
• vCenter control server -- This is a server on which VMware vSphere PowerCLI is installed.
• Virtual server -- This is a virtual server managed by the vCenter server and VMware vSphere ESX.
Usage guidelines
• The VMware vSphere ESXi (or VMware ESX Server) that is to be started cannot be specified. Start
the service template on VMware vSphere ESXi (or VMware ESX Server) that contains virtual servers.
• Adjust the ICMP echo timeout value (common.icmpEchoTimeout property) for the local environment.
• Depending on the state of the system environment, the virtual server might successfully start but the
network connection check might fail, possibly causing the task to end abnormally. Check the task log
to see if an error has occurred with the network connection check (the component "Obtain the IP
address of a virtual server" (vsphereGetVMIPaddress) or the component "Send ICMP echo request
message" (osSendIcmp)). If an error has occurred in these components, check if the virtual server is
started.
• If many IP addresses (#1) are set for the NIC of the virtual server, an error might occur in the
component "Send ICMP echo request message" and the task might end abnormally. Check that the
total length of the IP addresses set for the NIC is within 1,024 characters.
#1: You can set the following IP address types. For example, if 64 or less addresses are set for IPv4
only, no problem will occur.
◦ IPv4 (maximum length is 16 characters)
◦ IPv4 (maximum length is 36 characters)
◦ IPv4 and IPv6 set by DHCP
Restart Virtual Machine: Service details
The general steps for using this service template to restart a virtual machine are as follows:
1.
The status of a virtual server is obtained.
2.
If a virtual server's power status is on, the service template restarts the virtual server. If the virtual
server's power status is off, the corresponding virtual server processing results in an error.
3.
An ICMP echo request is sent to verify that the virtual server is started.
The specified group of virtual servers are turned off according to the number of seconds specified
through the
vmware.checkPowerStateInterval
property and then checked to determine if the
power is off, which it does up to the number of times specified through the
vmware.checkPowerStateCount
property. Therefore, the maximum wait time is the product of
these two property values times two (in seconds). If the default values are not suitable, specify values
that suit your environment.
Service Definition Properties
The following table lists the properties visible in the
Service Definition
window for the Restart Virtual
Machine service template.
234
Restart Virtual Machine: Service details
