AX2542

Managing Scheduler servers

On the Servers tab of the Scheduler dialog (Service > Servers), you can view the status of all Scheduler servers for the current system, enable or disable the servers, and change server configuration settings.

NOTE: Only administrators can manage Scheduler servers. Users with the Scheduled Jobs User permission cannot see the Servers tab in the Scheduler dialog.

This tab lists all Scheduler servers for this Axiom Software installation, including system Scheduler Services for on-premise systems Axiom Software systems that are installed on the client's premises. All servers and technical requirements are managed by the client. and Cloud Integration Services for Cloud Service systems. For each server, the following properties are listed:

Item	Description
Server	The server name, including the following appended codes where appropriate: -System indicates the system Scheduler Service -CIS indicates a Cloud Integration Service
Version	The Axiom Software version installed on the server. This should match the version installed on the application server.
Service Status	The status of the service on the server, such as stopped or started.
Processor Status	The status of the server, such as running or stopped.
Processor Enabled	Whether the server is enabled for processing.
Has Embedded App Server	Whether the server uses an embedded application server. This is determined during the installation.

This tab can be useful in troubleshooting—for example, if scheduled jobs are not executing, you can check this tab to see if the Scheduler service has been stopped on a server or if the server is down.

Enabling or disabling server processing

When a new Scheduler server is installed, you must manually enable it within the Scheduler dialog before it will begin processing jobs. Later, if you want to temporarily prevent a Scheduler server from processing jobs, you can disable processing for that server.

NOTE: The system Scheduler service for on-premise systems is enabled automatically. You do not need to manually enable this service.

To enable or disable server processing:

Select the server in the list. In the Configuration details section for that server, select or clear the Schedule Processing Enabled check box, and then click Update.

If a server is disabled, it will not process any new tasks. If the server is currently processing a job when it is disabled, it will finish the current task and then stop processing. The job's settings determine whether the stopped job is rescheduled for processing.

Configuring Scheduler server settings

Each Scheduler server has its own configuration settings that determine behavior such as how many threads are available to process jobs at any one time.

NOTE: We recommend leaving the default Scheduler server configuration settings unless Axiom Software Support has instructed you to change them, based on your particular system and server environment.

To view or edit the configuration settings for a server, select the server in the list. The settings for that server display in the Configuration details section. If you edit a setting, click Update to apply the change.

Item	Description
Max Worker Threads	The maximum number of threads that the Scheduler server has available to process jobs simultaneously. The default is 4. As a guideline, the Scheduler service can typically handle 2 threads per CPU on the Scheduler server. For example, a 4 CPU server could be set to 8 threads. Using a greater number of threads may degrade performance. NOTES: This setting is inapplicable to the system Scheduler service. It creates threads as needed to process system jobs. A Scheduler server will temporarily exceed the configured number of threads if a job's priority elevation is set to Interrupt and no threads are currently available to process it.
Server Poll Rate	The rate at which the Scheduler server checks for new jobs to process, in seconds. The default is 20 seconds.
Retry Rate	The rate at which the Scheduler server will resubmit commands to the application server, in the event the original connection failed. The default is 5 seconds.

Item

Description

Max Worker Threads

The maximum number of threads that the Scheduler server has available to process jobs simultaneously. The default is 4.

As a guideline, the Scheduler service can typically handle 2 threads per CPU on the Scheduler server. For example, a 4 CPU server could be set to 8 threads. Using a greater number of threads may degrade performance.

NOTES:

This setting is inapplicable to the system Scheduler service. It creates threads as needed to process system jobs.
A Scheduler server will temporarily exceed the configured number of threads if a job's priority elevation is set to Interrupt and no threads are currently available to process it.

Server Poll Rate

The rate at which the Scheduler server checks for new jobs to process, in seconds. The default is 20 seconds.

Retry Rate

The rate at which the Scheduler server will resubmit commands to the application server, in the event the original connection failed. The default is 5 seconds.

Removing server registration

If a Scheduler server is no longer valid, or if the Scheduler software was installed on a server in error, you can remove the server registration for Scheduler.

To remove the registration for a Scheduler server:

Right-click the server and then select Remove Server Registration.

The server is removed from the list. Registration can only be removed if no historical job results exist for the server.

If the service is restarted on the machine and the Scheduler installation is pointed to this Axiom Software installation, then the server will be re-registered.