Chapter 22: Wake on LAN Jobs

Chapter 22: Wake on LAN Jobs

Wake on LAN Jobs 
You can save energy using the agent's Wake on LAN (WOL) feature to automate the
startup and shutdown of your computers. WOL lets you define and schedule WOL jobs
to send a signal to a server to turn it on. When the server is no longer needed, you can
schedule a different command job to power it down.
Note: To run these jobs, your system requires CA WA Agent for UNIX, Linux, or
Windows. Your agent administrator must configure the agent to support WOL. For more
information about configuring the agent to support WOL, see the CA Workload
Automation Agent for UNIX, Linux, or Windows Implementation Guide.
Wake on LAN (WOL) is a hardware and software solution that lets you wake up a
computer remotely. The solution requires an ACPI-compliant computer and a special
software program that sends a signal to the computer's network card to wake it up. The
agent provides the AMD magic packet to broadcast the signal to a computer that has
been soft-powered-down (ACPI D3-warm state).

Define a Wake on LAN Job 
You can define a Wake on LAN (WOL) job to send a signal to a server to turn it on. The
job can wake up a remote computer that has been soft-powered-down (ACPI D3-warm
state).
Note: To run these jobs, your system requires CA WA Agent for UNIX, Linux, or
Windows. Your agent administrator must configure the agent to support WOL. For more
information about configuring the agent to support WOL, see the CA Workload
Automation Agent for UNIX, Linux, or Windows Implementation Guide.






Follow these steps: 
1. Insert a job and specify the following attributes in the definition:
job_type: WOL
Specifies that the job type is Wake on LAN.
machine
Specifies the name of the machine on which the job runs.
broadcast_address
Specifies the IP address of the LAN or subnet of the computer that receives the
Wake on LAN (WOL) signal.
mac_address
Specifies the Media Access Control (MAC) address of the computer that
receives the Wake on LAN (WOL) signal.

2. (Optional) Specify optional Wake on LAN attributes:
■ job_class
■ ping_host
■ ping_ports
■ ping_timeout
■ wake_password


3. (Optional) Specify common attributes that apply to all job types.
The Wake on LAN job is defined.
 Define a Wake on LAN Job


Notes:
■ Attributes that have a default value automatically apply to the job definitions;
therefore, they are optional. For example, jobs with no specified job type are
defined as command jobs by default. Other optional attributes specify information
that is not required but affects how or when a job runs, such as attributes that
specify scheduling conditions.
■ Some optional attributes are common to all job types but others apply to certain
jobs types only. Optional attributes that apply to all job types are known as
common optional attributes. For more information about common optional
attributes and the values that you can specify for them (including their default
values when applicable), see the Reference Guide.
■ For information about required attributes and job type specific optional attributes,
see the procedure topics that provide instructions for defining jobs.
■ This guide provides instructions for defining jobs interactively. You also create job
definitions in script files and then import them using the jil command or use CA
WCC to define them. For more information about the JIL command and JIL syntax,
see the Reference Guide. For more information about using CA WCC to define the
job, see the CA Workload Control Center Workload Scheduling Guide.

Example: Wake Up a Server and Ping the Default Port
This example broadcasts the WOL signal to the subnet with the 172.16.255.255 IP
address and the 00-11-43-73-38-DC MAC address. After the agent sends the WOL signal,
the agent pings the default ports at the 172.16.1.101 IP address to verify if these ports
are available. If at least one of these ports is available, the job completes successfully;
otherwise, it fails.
insert_job: wol_default_job
job_type: WOL
machine: agentnme
broadcast_address: 172.16.255.255
mac_address: 00-11-43-73-38-DC
ping_host: 172.16.1.101 Attributes with Default Values

462 User Guide

Example: Wake Up a Server and Ping a Port
This example broadcasts the WOL signal to the subnet identified by the 172.16.255.255
broadcast IP address and the server with the 00-1E-4F-C1-0F-FE MAC address. After the
agent sends the Wake on LAN (WOL) signal, the agent pings port 7 at the 172.16.1.101
IP address to ensure it is available. If port 7 is available, the job completes successfully;
otherwise, it fails.
insert_job: wol_job
job_type: WOL
machine: agentnme
broadcast_address: 172.16.255.255
mac_address: 00-1E-4F-C1-0F-FE
ping_host: 172.16.1.101
ping_ports: 7
Example: Broadcast the WOL Signal Including a Password
This example broadcasts the WOL signal including a password to the subnet with the
172.16.255.255 broadcast IP address and the server with the 11-22-33-44-55-66 MAC
address. If the specified password matches the password stored on the server's network
card, the server wakes up. The job completes successfully after the scheduler sends the
WOL signal without verifying that the machine starts.
insert_job: wol_pwd_job
job_type: WOL
machine: agentnme
broadcast_address: 172.16.255.255
mac_address: 11-22-33-44-55-66
wake_password: AA-BB-CC-DD-EE-FF
Attributes with Default Values
Attributes that have a default value automatically apply to the job definition. Therefore,
you do not have to specify those attributes in the definition. Your agent administrator
can define some default values on the agent in the agentparm.txt file.
If you specify the attribute in a job definition, it overrides the default.
 Attributes with Default Values



The following Wake on LAN job attributes have default values:
port
Specifies the ports to contact after the agent sends the Wake on LAN (WOL) signal.
If you do not enter a value, the agent contacts the defaults ports.
Defaults: 21 (ftp), 22 (ssh), 23 (telnet), 80 (http), 111 (sunrpc), 135 (epmap), 139
(netbios-ssn), 445 (microsoft-ds)
timeout
Specifies the timeout for the ping in seconds.
Default: 120 seconds
Note: For more information about JIL job types and other job definition attributes, the
values that you can specify for those attributes, and JIL syntax, see the Reference Guide.

Example: Specify a Timeout Limit When you Broadcast the WOL Signal to a MAC
address
This example broadcasts the WOL signal to the subnet identified by the 172.16.255.255
broadcast IP address and the server identified by the 00-1E-4F-C1-0F-FE MAC address.
After the agent sends the Wake on LAN (WOL) signal, the agent pings port 7 at the
172.16.1.101 IP address to ensure it is available. If port 7 becomes available within 5
minutes (300 seconds), the job completes successfully; otherwise, it exceeds the
timeout limit and fails.
insert_job: wol_job
job_type: WOL
machine: agentnme
broadcast_address: 172.16.255.255
mac_address: 00-1E-4F-C1-0F-FE
ping_host: 172.16.1.101
ping_ports: 7
ping_timeout: 300