advertisement
NOTE: Deleting a schedule that was deployed as part of a
.job
or
.sar displays a confirmation dialog box. Deleting the schedule undeploys all contents of the
.job
or
.sar
that contains the schedule.
Disable: Disables the selected schedule in the Job Schedules Table. The jobs associated with the schedule are not re-run, but any currently running instances of this job continue to run.
Enable: Enables a disabled job schedule.
Run Now: Forces the specified schedule to run immediately. This updates statistics such as
Last Fire Time.
Removed Jobs or Users: Scheduler Behavior
If a job or a user is undeployed or removed from PlateSpin Orchestrate, the Job Schedules Table continues to list the schedule previously associated to that removed grid object, but the removed grid object no longer displays the icon that represents the object (job or user).
Figure 3-4
Some User Object and Job Object Icons Not Displayed
In the preceding figure, the CpuDiscovery schedule displays no Job icon for the cpuInfo job in the schedules table. Even though the job has been undeployed, the schedule is still listed.
In the osinfo schedule, the system user has no User icon. That user has been removed from PlateSpin
Orchestrate.
If you choose a new user or job to be associated with a schedule, a deleted or undeployed user or job is never displayed in the popup menu for that schedule again.
3.1.2 Creating or Modifying a Job Schedule
The Job Schedule Editor is located immediately below the Job Schedules Table in the Job Scheduler view.
Figure 3-5
The Job Schedule Editor in the Job Scheduler View
28
PlateSpin Orchestrate 2.0 Development Client Reference
There are several times when you can use this part of the Job Scheduler tool:
When you create a new schedule by clicking New.
When you modify the attributes of an existing schedule (available when you select a schedule in the table).
When you create a copy of an existing schedule by clicking Copy.
The Job Schedule Editor lets you create or modify a job schedule by specifying its attributes.
You can use the following controls and data when you create or modify a job schedule:
“Matching Resources” on page 30
“Test Schedule Now” on page 30
Schedule Name
When you create a new schedule, the unique name you specify is displayed in this field. If you select a schedule from the Job Schedules Table, the name of the schedule is displayed in this field. The field is not editable, because schedules cannot be renamed after they are created. (You can use a copy if this is required.)
Job
When you create a new schedule, you need to associate a deployed job with it. You can select the job you want to run from this drop-down list.
If you want to use a previously created schedule to run a different job, you can change the job here.
User
When you create a new schedule, you need to associate a user with it. The user represents the user for whom the job will run. The choice of user might affect the permissions, privileges and constraints of the job. You can select the user from this drop-down list.
If you want a different user to run a job on a previously created schedule, you can change the user here.
If you decide to change the user who runs the job, check the Priority field to make sure that the priority you want is selected.
The PlateSpin Orchestrate Job Scheduler
29
Priority
When you create a new schedule and associate a job and a user with it, a list of possible run priorities becomes available in this drop-down list. The list of priorities varies, depending on the user that is specified in the previous field. In this field, you select the priority of the job that is to be run so that if other jobs are to start concurrently or are competing for resources, PlateSpin
Orchestrate can determine which job takes priority.
Description
For predeployed jobs, this field contains a default description of what the job’s schedule does. The field is editable, so you can enter a description of your own for job schedules that you create.
Matching Resources
This button displays a list of resources where the job runs now or where it could run. This list is useful for checking the context of constraints that might have been affected by a choice of user or by manually specifying additional constraints under the Policy tab. The list is also useful to verify that a discovery job (that is, one that is triggered by the Run on Resource Start option) runs on the preferred set of machines.
Test Schedule Now
Click this button to test the new or modified schedule you are working with. The test runs the new or modified schedule without permanently saving the current configuration of the schedule or recording statistics. This control differs from the Run Now control in the Job Schedules Table, which runs a saved (persisted) schedule, disregarding any unsaved modifications that have been made to it in the Job Schedule Editor.
Triggers
When you click the Triggers tab in the Job Scheduler view, the following page opens:
Figure 3-6
The Schedule Triggers Page in the Job Scheduler
In this view, you can add or define the triggers you want to associate with job schedules. A trigger is the signal to the Job Scheduler to initiate, or “fire” a schedule at a given time or at the occurrence of a given event. Job Scheduler triggers can be classified with regard to two conditions: events and time.
30
PlateSpin Orchestrate 2.0 Development Client Reference
The Triggers table on this page has functionality that lets you decide how you want to display information about the triggers:
You can drag any column in the table to move it left or right in the table according to your preference.
You can mouse over any column heading in the table to view tool tip text about the purpose of the data in that column.
You can right-click any column heading in the table to open the Triggers table column editor dialog box.
Figure 3-7
Trigger Table Column Editor Dialog Box
You can select any column heading in this dialog box to display it in the Triggers table. The columns display the attributes of a previously configured Triggers table. As the figure shows, this dialog box also includes text that clarifies the purpose of the data in each column.
You can create as many triggers as you want to meet any scheduling situation you might have.
Multiple time triggers can be associated with a schedule and multiple schedules can use the same trigger. The triggers you create are retained by the Job Scheduler for you to choose from when you create a schedule for a job. The currently associated triggers are displayed in the list along with a description.
Choose Triggers
This button opens a dialog box where you can choose both predefined and user defined time triggers to associate with this job schedule.
Figure 3-8
Choose Triggers Dialog Box
The PlateSpin Orchestrate Job Scheduler
31
In this dialog box, you can click Add to move a selected trigger to the active, scheduled triggers that are to be associated with this job schedule. You can also click Remove to unassociate a trigger.
When a trigger is moved to the scheduled list, it becomes associated to the job schedule and it is displayed in the Job Scheduler view.
Most example jobs in PlateSpin Orchestrate are associated with event triggers, which are shown in the previous illustration. The dialog box can also list other job schedule triggers that are based on time.
Event Triggers
An Event trigger is the signal to the Job Scheduler to initiate, or “fire” a job when a given event occurs. An Event can be one of three types:
Event objects: These objects are user defined events that are fired when an event rule is triggered. If an event object is deployed, it automatically shows in the trigger chooser as a possible choice.
built-in events: These events are system wide events such as when a resource comes online or when a resource health condition change occurs. Built-in events are always available as a trigger choice. The Job Scheduler has eight possible built-In event triggers:
AGENT_VERSION_MISMATCH
RESOURCE_ONLINE
REPOSITORY_HEALTH
RESOURCE_HEALTH
SERVER_UP
USER_HEALTH
USER_ONLINE
VMHOST_HEALTH
You can select any combination of these event triggers for a single schedule.
The first trigger,
AGENT_VERSION_MISMATCH
, triggers the job when a PlateSpin Orchestrate
Agent of an incompatible version attempts to connect to this Orchestrate Server. It can be used to initiate a configuration management tool for an agent software update or the job could e-mail an administrator to report the incompatible agent. The other seven available built-in event triggers are listed with accompanying descriptions in the dialog box.
External events: These events are fired by an outside process. These are not automatically shown as choices in the trigger chooser, but must be defined by the trigger editor.
An event trigger can be used in conjunction with a time trigger to allow flexibility in scheduling the job application for maximum effectiveness or convenience. Jobs triggered by events require that their job arguments contain a dictionary named context
. For example, your event-triggered job should have this jobarg element in its policy:
<policy>
<jobargs>
<fact name="context" type="Dictionary"
description="Dictionary containing the context for the event" />
</jobargs>
</policy>
32
PlateSpin Orchestrate 2.0 Development Client Reference
Key
AgentBuild
AgentIP
AgentId
AgentMajor
AgentMinor
AgentPoint
JavaMajor
JavaMinor
JavaPoint
JavaVendor
JavaVersion
OsMajor
OsMinor
OsName
OsPoint
OsVendor
OsVersion
SystemArch
UsingJRE r esource
The key/values of the dictionary are dependent on the event type. For event objects, the jobargs.context
dictionary contains the matching context of the triggered rule. For built-in events, the jobargs.context
dictionary contains the key of the object type corresponding to the built-in event and the object ID that caused the event.
For example, if the
USER_ONLINE
event triggers because the user named foo
logs in, the jobargs.context
dictionary contains:
{ user : foo }
Likewise, if the RESOURCE_ONLINE event is triggered because the resource agent named “vmhost1” comes online, the jobargs.context dictionary contains:
{ resource : vmhost1 }
For the
AGENT_VERSION_MISMATCH
event, the jobargs.context
dictionary contains more information, as shown in the following table:
Table 3-1
Dictionary Information
Type
Integer
String
String
Integer
Integer
String
Integer
String
Long
String
String
Integer
Integer
Integer
Integer
Integer
String
String
Boolean
String
The PlateSpin Orchestrate Job Scheduler
33
Time Triggers
A time trigger is the signal to the Job Scheduler to initiate, or “fire” a job when a prescheduled time occurs. A time trigger can be used in conjunction with an event trigger to allow flexibility in scheduling the job application for maximum effectiveness or convenience. No default time triggers are defined in the Job Scheduler. You need to create new time triggers by clicking Edit Triggers.
Edit Triggers
Click Edit Triggers to open the Triggers dialog box.
Figure 3-9
The Triggers Dialog Box
The following controls and information are available in the dialog box:
New: Opens a secondary dialog box where you can create a new time trigger name. When you create the trigger name, the attribute fields in the Triggers dialog box are cleared and you can specify new attributes for the trigger. A new trigger must be given a unique trigger name.
Copy: Lets you modify an existing time trigger by giving it a new name and attributes. This can be helpful if there are only slight differences in the new attributes. A copy of a trigger must be given a unique trigger name.
Deploy: Opens a file chooser where you can choose an existing, stored trigger (that is, a
.trig
file) to deploy.
Delete: Deletes a selected time trigger.
IMPORTANT: Deleted triggers are not recoverable. If the trigger is used by existing schedules, it is removed from all of those schedules when it is deleted.
Trigger Name: Specifies the unique name of the trigger you are creating or modifying. This name is displayed in the Job Scheduler if you choose to associate this trigger with a schedule.
After you create the trigger name, it cannot be modified.
34
PlateSpin Orchestrate 2.0 Development Client Reference
Description: Specifies a description for the time trigger you are creating or modifying. The description is optional and can be as detailed as you want.
If the number of characters in the description string exceeds the space in the Description field, a button is enabled that opens a string editor when clicked.
Save: Clicking this icon saves the defined time trigger and its attributes.
Fire Starting In: Displays multiple fields specifying the time increment and frequency to be used by the trigger to fire the job. If you select this type of time trigger, the Fire using CRON
Expression button becomes inactive.
NOTE: You can use the Fire Starting In control to create either a “one-shot” time trigger or a
“reoccurring” time trigger.
A one-shot time trigger fires just once after a specified period of time. To specify a one-shot trigger, click Fire Starting in, specify the amount of time before firing, then specify 0 as the time to Repeat Indefinitely.
A reoccurring time trigger fires after a specified period and then either fires repeatedly for an indefinite number of times or it fires for a specified number of times. To specify a reoccurring, indefinite trigger, click Fire Starting in, specify the amount of time before firing, then select
Repeat Indefinitely. To specify a reoccurring but finite trigger, click Fire Starting in, specify the amount of time before firing, select Repeat Range, then specify the number of times you want the trigger to fire.
Fire using CRON Expression: Specifies the cron expression that enables the job to fire automatically at a specified time or date. You need to be familiar with cron to use this field.
The Examples list box of selected cron expressions and their associated descriptions is located just below this button. You can use a listed expression as is, or use it as a template to modify the expression to meet your needs.
If you select this type of time trigger, the Fire Starting In and the Fire Using Event buttons become inactive.
For an example of how a cron expression can be implemented in a trigger, see
Assigning a Time Trigger for the New Schedule” on page 44
. For detailed information about
cron syntax, see “Understanding Cron Syntax in the Job Scheduler” on page 37
.
Fire Using Event: Specifies a deployed event or an external event that enables the job to fire when a specified event occurs. Deployed events are defined using an XML syntax. You can specify a deployed event from Events (that is, listed in the Events drop down list) or you can enter the name of an external event. For more information on creating and firing an event, see
If the number of characters in the Fire Using Event description string exceeds the space in the field, a button is enabled that opens a string editor when clicked.
Job Arguments
This tab displays an area (in the lower left corner of the Job Schedule Editor) where possible job arguments are listed. If you select an existing schedule in the Job Schedules Table, any optional job arguments (jobargs) for the associated job are displayed in this area.
The PlateSpin Orchestrate Job Scheduler
35
Figure 3-10
The Job Arguments Area of the Job Scheduler View
The jobargs are defined by the deployed job. Some jobs might already have a default value displayed, but others must have values specified in order for the job to be able to run.
IMPORTANT: Job arguments displayed in blue are required. You must supply data in the accompanying fields.
A job argument defines the values that can be passed in when a job is invoked. These values let you statically define and control job behavior. To learn more about each job argument, mouse over each jobarg line to display tool tip text.
The Job Scheduler uses the values you enter into the fields of this area to build a jobargs namespace in the policy for this job.
Each job argument has an accompanying Lock check box. When Lock is not selected, the accompanying job argument uses the default value specified in the job’s policy. When Lock is selected, the value specified in the field is locked down and overrides the default value in the policy.
A locked value continues to be used even if the policy value is modified.
You can click Restore Jobargs to restore job arguments to the values specified in the job policy. This function removes any changes you might have specified in the Job Scheduler and deselects all Lock check boxes.
For more information, see “ Job Arguments and Parameter Lists ” in the
PlateSpin Orchestrate 2.0
Developer Guide and Reference
.
User Environment
This tab displays an area (in the lower left corner of the Job Schedule Editor) that includes the Pass
User Environment check box. Select this check box if you want to pass the assigned user’s environment variables to the job when it runs. When environment variables are recorded on the user account, selecting the Pass User Environment check box makes those environment variables available to the job and joblet.
A user’s environment is recorded under the user.env
fact on his or her account. This fact can be set when a user logs in to PlateSpin Orchestrate and is persisted until changed. A user’s environment variables can be uploaded with the zos command line tool at login time in one of two variations:
zos login --user=foo --env
This command uploads the entire environment to the Job Scheduler. The upload can also be seen on the User object in the Orchestrate Development Client.
zos login --user=foo --env=PATH
When the user logs in, he or she can specify one or more environment variables to use at login.
The example above would result in just the PATH environment variable being uploaded.
36
PlateSpin Orchestrate 2.0 Development Client Reference
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project