1.0

www.vmware.com
246
VMware ACE Administrator’s Manual
Renewal Plug-Ins
The following table outlines the basic information you need to write renewal plug-ins.
What should the exit code of the
script be?
If access is granted, the exit code should be 0. If access is
denied, the exit code should be nonzero.
Note: This is a reference to the exit code, not the output
value.
Questions Explanation
When does this script execute? This script executes every time the virtual machine is
powered on or reset.
What relevant environment variables
are available to the script?
VMWARE_EXPIRE_TIME
It holds the current expiration time, expressed as seconds
since Jan. 1, 1970 (UTC).
What is the expected output? If the output of this script is greater than 32767, it is
interpreted as a date, expressed as the number of seconds
since Jan. 1, 1970 (UTC). Otherwise, it is interpreted as the
number of days to allow the virtual machine to run,
beginning on the current date.
What can I do with this script? The script may do one of the following:
• Set the virtual machine expired. If the output is a time that
is in the past, the virtual machine is expired. Note that the
value must be greater than 32767, otherwise the output is
treated as a number of days and the virtual machine is
allowed to run for the specified number of days,
beginning on the current date.
• Allow the virtual machine to run. If the output is a date in
the future, expressed as a number of seconds since Jan. 1,
1970 (UTC), the virtual machine is renewed. Times are
rounded up to midnight of the day specified. If the output
is a value less than 32767, the virtual machine is allowed to
run for the specified number of days, beginning on the
current date.
• Take no action. If the output is 0, nothing is changed.
• Set the virtual machine so it never expires. Generate an
output value of -1.
Where should the output of the
script go?
Your script should send its output to StdOut.
Question Explanation