SuperSTAR Server Outages - Job Queue Manager

Because the Job Queue Manager is a long running process and is reliant on the SuperSTAR platform, any downtime for those systems or the networks connecting them will interrupt the Job Queue Manager’s processing.

Space-Time Research recommends stopping the Job Queue Manager before scheduled outages for the platform, data server or network. If an outage occurs while Job Queue Manager is running it will automatically suspend processing when it loses its connection to the platform or data server. Job Queue Manager will also stop allocating new jobs, but it will allow the Job Executors to complete jobs that are already in the RUNNING state. Jobs in the RUNNING state when the error occurs are likely to end up in the ERROR or RECOVERABLE state. While the Job Queue Manager is in suspended mode, it periodically attempts to re-connect to the platform component(s). As soon as it succeeds in connecting, it resumes processing of jobs. Jobs in the RECOVERABLE state will be re-run automatically. Jobs in the ERROR state will require manual intervention. For information on rescheduling jobs that are in the ERROR state, see the troubleshooting section .

You can configure the frequency at which the Job Queue Manager polls for changes in the platform status. It is also possible to configure email notification when the Job Queue Manager loses its connection to the platform.

Configure Polling Frequency

1. Open <tomcat_home>\webapps\queuedjobservice\WEB-INF\config\common\service-config.xml in a text editor.
   
   

   Make a backup copy of this file before making any changes.

2.  Locate the following line:

   XML

   <property name="platformReconnectFrequency" value="10000"/>

3. Change the value to your preferred polling frequency (in milliseconds).

4. Save your changes.

5. Restart the Tomcat server.

Email Notifications

You can configure Job Queue Manager to send email notifications when it loses its connection to SuperSTAR and again when it regains the connection.

The Job Queue Manager server will not deliver the email notifications if it cannot connect to the email server.

To configure email notifications:

1. Open <tomcat_home>\webapps\queuedjobservice\WEB-INF\classes\log4j.properties in a text editor.
   
   

   Make a backup copy of this file before making any changes.

2. Add the following code to the end of the file (change this example to the appropriate values for your mailserver, from and to addresses):

   POWERSHELL

   log4j.logger.au.com.str.jobqueue.server.Notification=ERROR, mail
   log4j.category.au.com.str.jobqueue.server.Notification=ERROR
   log4j.additivity.au.com.str.jobqueue.server.Notification=false
   
   log4j.appender.mail=org.apache.log4j.net.SMTPAppender
   log4j.appender.mail.BufferSize=1
   log4j.appender.mail.SMTPHost=your.mailserver.com
   log4j.appender.mail.From=From.Address@yourdomain.com
   log4j.appender.mail.To=To.Address@yourdomain.com
   log4j.appender.mail.Subject=Job Queue Manager Notification
   log4j.appender.mail.threshold=ERROR
   log4j.appender.mail.layout=org.apache.log4j.PatternLayout
   log4j.appender.mail.layout.ConversionPattern=%d{ABSOLUTE} %5p %c - %m%n

3. Save your changes.

4. Restart the Tomcat server.