Table of Contents

Scope

This document explains

how to download the JobScheduler engine binaries from Maven Central,
the structure of the binaries,
how to setup a minimal JobScheduler with the binaries.

Prerequisites

Starting with release 1.9.6 JobScheduler artifacts are available from http://mvnrepository.com/artifact/com.sos-berlin/jobscheduler.engine.
In order to download the binaries and to integrate them in your application

...

it is required that you have Maven installed.

Maven

Check the Maven Documentation.
SOS uses Maven 3.2.1. Download the latest Maven release
Maven's /bin folder has to be added to the global variable "PATH" in order to take effect.
No further Further configuration is not required for Maven in order to compile. If further configuration is wanted
For individual configuration, for example to receive certain 3rd Party libraries from an official a Maven2 repository , e.g. other than http://repo1.maven.org/maven2, then you have to configure the settings.xml file.

The binaries file

jobscheduler.engine-1.9.6.jar
jobscheduler.engine-1.9.6.pom

The version number 1.9.6 from this sample is based on the semantic versioning scheme. This sample version number is used for the examples in this article.

The structure of the Binaries

The jobscheduler.engine-1.9.6.jar file is a bundle jar with all binaries as well as the JobScheduler engine Java library included.

To integrate the library into your own maven project or to download it via maven, add the following configuration to the pom.xml file of your project.

Code Block

language	xml
title	Maven dependency snippet
collapse	true

<dependency>
  <groupId>com.sos-berlin</groupId>
  <artifactId>jobscheduler.engine</artifactId>
  <version>1.9.6</version>
</dependency>

The structure of the jobscheduler.engine-1.9.6.jar file looks like this:

Code Block

language	text
title	structure of jobscheduler.engine-1.9.6.jar
collapse	true

|-linux-x64											
|	|-bin
|	|	|---.version-engine
|	|	|---scheduler
|	|-lib
|	|	|---libjobscheduler-engine.so
|-linux-x86
|	|-bin
|	|	|---.version-engine
|	|	|---scheduler
|	|-lib
|	|	|---libjobscheduler-engine.so
|-windows-x64
|	|-bin
|	|	|---.version-engine
|	|	|---jobscheduler-engine.dll
|	|	|---scheduler.exe
|-windows-x86
|	|-bin
|	|	|---.version-engine
|	|	|---scheduler.exe
|---com.sos-berlin.jobscheduler.engine-1.9.6.jar

Setting up a JobScheduler with the Binaries

Required configuration files

sos.ini
factory.ini
scheduler.xml

Configuration

Step 1

To get a minimal JobScheduler up and running, create a folder, e.g. myJobScheduler, and copy the binaries according to your operating system as well as the Java library to this folder.

Step 2

Related Issues

Jira
server SOS JIRA
columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId 6dc67751-9d67-34cd-985b-194a8cdc9602
key JS-1508
Jira
server SOS JIRA
columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId 6dc67751-9d67-34cd-985b-194a8cdc9602
key JS-809
Jira
server SOS JIRA
columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId 6dc67751-9d67-34cd-985b-194a8cdc9602
key JS-785

The Binaries File

jobscheduler.engine-1.9.6.jar
jobscheduler.engine-1.9.6.pom

The version number 1.9.6 from this sample is based on the semantic versioning scheme. This sample version number is used for the examples in this article.

The Structure of the Binaries

The jobscheduler.engine-1.9.6.jar file is a bundle jar with all binaries as well as the JobScheduler engine Java library included.

To integrate the library into your own maven project or to download it via maven, add the following configuration to the pom.xml file of your project.

Code Block

language	xml
title	Maven dependency snippet
collapse	true

<dependency>
  <groupId>com.sos-berlin</groupId>
  <artifactId>jobscheduler.engine</artifactId>
  <version>1.9.6</version>
</dependency>

The structure of Add the 3rd Party libraries which are configured in the jobscheduler.engine-1.9.6.pom file to a folder as well as the JDBC database driver you use. If you copy the 3rd party libraries to a different folder then you have to configure the path in the factory.ini file. jar file looks like this:

Code Block

language	text
title	structure of jobscheduler.

Code Block

language	xml
title	dependency snippet from the jobscheduler.engine-1.9.6-pom.jar
collapse	true

|-linux-x64											
|	|-bin
|	|	|---.version-engine
|	|	|---scheduler
|	|-lib
|	|	|---libjobscheduler-engine.so
|-linux-x86
|	|-bin
|	|	|---.version-engine
|	|	|---scheduler
|	|-lib
|	|	|---libjobscheduler-engine.so
|-windows-x64
|	|-bin
|	|	|---.version-engine
|	|	|---jobscheduler-engine.dll
|	|	|---scheduler.exe
|-windows-x86
|	|-bin
|	|	|---.version-engine
|	|	|---scheduler.exe
|---com.sos-berlin.jobscheduler.engine-1.9.6.jar

Setting up a JobScheduler with the Binaries

Required configuration files

sos.ini
factory.ini
scheduler.xml

Configuration

Step 1

To get a minimal JobScheduler up and running, create a home folder, e.g. myJobScheduler, and copy the binaries according to your operating systemto this folder.

Step 2

Add the following files to a folder:

3rd Party libraries that are configured in the jobscheduler.engine-1.9.6.pom file.
the Java library com.sos-berlin.jobscheduler.engine-1.9.6.jar from the bundle
the JDBC database driver you want to use.

If you copy the 3rd party libraries to a different folder then you have to add this folder to the class_path setting in the [java] section of the factory.ini file.

Code Block

language	xml
title	dependency snippet from the jobscheduler.engine-1.9.6-pom
collapse	true

<dependencies>
	<dependency>
		<groupId>com.google.guava</groupId>
		<artifactId>guava</artifactId>
		<version>18.<dependencies>
	<dependency>
		<groupId>com.google.guava</groupId>
		<artifactId>guava</artifactId>
		<version>18.0</version>
	</dependency>
	<dependency>
		<groupId>javax.inject</groupId>
		<artifactId>javax.inject</artifactId>
		<version>1</version>
	</dependency>
	<dependency>
		<groupId>com.google.inject</groupId>
		<artifactId>guice</artifactId>
		<version>3.0</version>
	</dependency>
	<dependency>
		<groupId>com.h2database</groupId>
		<artifactId>h2</artifactId>
		<version>1.4.186</version>
	</dependency>
	<dependency>
		<groupId>commons-net</groupId>
		<artifactId>commons-net</artifactId>
		<version>3.3</version>
	</dependency>
	<dependency>
		<groupId>javax.mail</groupId>
		<artifactId>mail</artifactId>
		<version>1.4.7</version>
	</dependency>
	<dependency>
		<groupId>org.eclipse.persistence</groupId>
		<artifactId>javax.persistence</artifactId>
		<version>2.1.0</version>
	</dependency>
	<dependency>
		<groupId>org.scalactic</groupId>
		<artifactId>scalactic_2.11</artifactId>
		<version>2.2.4</version>
	</dependency>
	<dependency>
		<groupId>org.scala-lang</groupId>
		<artifactId>scala-library</artifactId>
		<version>2.11.6</version>
	</dependency>
	<dependency>
		<groupId>org.scala-lang</groupId>
		<artifactId>scala-reflect</artifactId>
		<version>2.11.6</version>
	</dependency>
	<dependency>
		<groupId>org.scala-lang.modules</groupId>
		<artifactId>scala-xml_2.11</artifactId>
		<version>1.0.3</version>
	</dependency>
	<dependency>
		<groupId>xerces</groupId>
		<artifactId>xercesImpl</artifactId>
		<version>2.11.0</version>
	</dependency>
	<dependency>
		<groupId>xml-apis<<groupId>javax.inject</groupId>
		<artifactId>xml-apis<<artifactId>javax.inject</artifactId>
		<version>1.4.01<<version>1</version>
	</dependency>
	<dependency>
		<groupId>joda-time<<groupId>com.google.inject</groupId>
		<artifactId>joda-time<<artifactId>guice</artifactId>
		<version>2<version>3.5<0</version>
	</dependency>
	<dependency>
		<groupId>org<groupId>com.joda<h2database</groupId>
		<artifactId>joda-convert<<artifactId>h2</artifactId>
		<version>1.7<4.186</version>
	</dependency>
	<dependency>
		<groupId>org.eclipse.jetty<<groupId>commons-net</groupId>
		<artifactId>jetty<artifactId>commons-server<net</artifactId>
		<version>8.1.16.v20140903<<version>3.3</version>
	</dependency>
	<dependency>
		<groupId>org<groupId>javax.eclipse.jetty<mail</groupId>
		<artifactId>jetty-servlet<<artifactId>mail</artifactId>
		<version>8<version>1.14.16.v20140903<7</version>
	</dependency>
	<dependency>
		<groupId>org.eclipse.jetty<persistence</groupId>
		<artifactId>jetty-servlets<<artifactId>javax.persistence</artifactId>
		<version>8<version>2.1.16.v20140903<0</version>
	</dependency>
	<dependency>
		<groupId>org.eclipse.jetty<scalactic</groupId>
		<artifactId>jetty-xml<<artifactId>scalactic_2.11</artifactId>
		<version>8<version>2.12.16.v20140903<4</version>
	</dependency>
	<dependency>
		<groupId>org.eclipse.jetty<scala-lang</groupId>
		<artifactId>jetty<artifactId>scala-client<library</artifactId>
		<version>8<version>2.111.16.v20140903<6</version>
	</dependency>
	<dependency>
		<groupId>org.eclipse.jetty<scala-lang</groupId>
		<artifactId>jetty<artifactId>scala-webapp<reflect</artifactId>
		<version>8<version>2.111.16.v20140903<6</version>
	</dependency>
	<dependency>
		<groupId>org.eclipsescala-lang.jetty<modules</groupId>
		<artifactId>jetty-websocket<<artifactId>scala-xml_2.11</artifactId>
		<version>8<version>1.10.16.v20140903<3</version>
	</dependency>
	<dependency>
		<groupId>com.sun.jersey<<groupId>xerces</groupId>
		<artifactId>jersey-server<<artifactId>xercesImpl</artifactId>
		<version>1<version>2.11.19<0</version>
	</dependency>
	<dependency>
		<groupId>com.sun.jersey.contribs<<groupId>xml-apis</groupId>
		<artifactId>jersey<artifactId>xml-guice<apis</artifactId>
		<version>1.19<4.01</version>
	</dependency>
	<dependency>
		<groupId>com.sun.jersey<<groupId>joda-time</groupId>
		<artifactId>jersey<artifactId>joda-client<time</artifactId>
		<version>1<version>2.19<5</version>
	</dependency>
	<dependency>
		<groupId>org.slf4j<joda</groupId>
		<artifactId>slf4j<artifactId>joda-api<convert</artifactId>
		<version>1.7.10<7</version>
	</dependency>
	<dependency>
		<groupId>org.slf4j<eclipse.jetty</groupId>
		<artifactId>slf4j<artifactId>jetty-log4j12<server</artifactId>
		<version>1<version>8.1.716.10<v20140903</version>
	</dependency>
	<dependency>
		<groupId>org.eclipse.slf4j<jetty</groupId>
		<artifactId>jul<artifactId>jetty-to-slf4j<servlet</artifactId>
		<version>1<version>8.1.716.10<v20140903</version>
	</dependency>
	<dependency>
		<groupId>log4j<<groupId>org.eclipse.jetty</groupId>
		<artifactId>log4j<<artifactId>jetty-servlets</artifactId>
		<version>1<version>8.1.216.16<v20140903</version>
	</dependency>
	<dependency>
		<groupId>com<groupId>org.googleeclipse.code.findbugs<jetty</groupId>
		<artifactId>jsr305<<artifactId>jetty-xml</artifactId>
		<version>3<version>8.1.016.0<v20140903</version>
	</dependency>
	<dependency>
		<groupId>javax<groupId>org.wseclipse.rs<jetty</groupId>
		<artifactId>jsr311<artifactId>jetty-api<client</artifactId>
		<version>1<version>8.1.1<16.v20140903</version>
	</dependency>
	<dependency>
		<groupId>com<groupId>org.fasterxmleclipse.jackson.core<jetty</groupId>
		<artifactId>jackson<artifactId>jetty-core<webapp</artifactId>
		<version>2<version>8.1.416.3<v20140903</version>
	</dependency>
	<dependency>
		<groupId>com<groupId>org.fasterxmleclipse.jackson.core<jetty</groupId>
		<artifactId>jackson<artifactId>jetty-databind<websocket</artifactId>
		<version>2<version>8.1.416.3<v20140903</version>
	</dependency>
	<dependency>
		<groupId>com.fasterxmlsun.jackson.core<jersey</groupId>
		<artifactId>jackson<artifactId>jersey-annotations<server</artifactId>
		<version>2<version>1.4.3<19</version>
	</dependency>
	<dependency>
		<groupId>com.fasterxmlsun.jacksonjersey.jaxrs<contribs</groupId>
		<artifactId>jackson-jaxrs-json-provider<<artifactId>jersey-guice</artifactId>
		<version>2.4.3</<version>1.19</version>
	</dependency>
	<dependency>
		<groupId>com.fasterxmlsun.jackson.datatype<jersey</groupId>
		<artifactId>jackson<artifactId>jersey-datatype-guava<client</artifactId>
		<version>2<version>1.4.3<19</version>
	</dependency>
	<dependency>
		<groupId>com.fasterxml.jackson.module<<groupId>org.slf4j</groupId>
		<artifactId>jackson-module-scala_2.11<<artifactId>slf4j-api</artifactId>
		<version>2<version>1.47.3<10</version>
	</dependency>
	<dependency>
		<groupId>commons-beanutils<<groupId>org.slf4j</groupId>
		<artifactId>commons<artifactId>slf4j-beanutils<log4j12</artifactId>
		<version>1.97.2<10</version>
	</dependency>
	<dependency>
		<groupId>io<groupId>org.spray<slf4j</groupId>
		<artifactId>spray-json_2.11<<artifactId>jul-to-slf4j</artifactId>
		<version>1.37.1<10</version>
	</dependency>
	<dependency>
		<groupId>io.spray<<groupId>log4j</groupId>
		<artifactId>spray-http_2.11<<artifactId>log4j</artifactId>
		<version>1.32.2<16</version>
	</dependency>
	<dependency>
		<groupId>io.spray<<groupId>com.google.code.findbugs</groupId>
		<artifactId>spray-client_2.11<<artifactId>jsr305</artifactId>
		<version>1<version>3.30.2<0</version>
	</dependency>
	<dependency>
		<groupId>com<groupId>javax.ws.typesafe<rs</groupId>
		<artifactId>config<<artifactId>jsr311-api</artifactId>
		<version>1.21.1</version>
	</dependency>
	<dependency>
		<groupId>com.fasterxml.typesafejackson.akka<core</groupId>
		<artifactId>akka-actor_2.11<<artifactId>jackson-core</artifactId>
		<version>2.34.9<3</version>
	</dependency>
	<dependency>
		<groupId>com.typesafefasterxml.jackson.akka<core</groupId>
		<artifactId>akka-slf4j_2.11</<artifactId>jackson-databind</artifactId>
		<version>2.34.9<3</version>
	</dependency>
	<dependency>
		<groupId>javax.servlet<<groupId>com.fasterxml.jackson.core</groupId>
		<artifactId>javax.servlet<artifactId>jackson-api<annotations</artifactId>
		<version>3<version>2.14.0<3</version>
	</dependency>
	<dependency>
		<groupId>aopalliance<<groupId>com.fasterxml.jackson.jaxrs</groupId>
		<artifactId>aopalliance<<artifactId>jackson-jaxrs-json-provider</artifactId>
		<version>1<version>2.4.0<3</version>
	</dependency>
	<dependency>
		<groupId>org<groupId>com.fasterxml.jvnetjackson.mimepull<datatype</groupId>
		<artifactId>mimepull<<artifactId>jackson-datatype-guava</artifactId>
		<version>1<version>2.94.4<3</version>
	</dependency>
</dependencies>

Step 3

Create a sos.ini file and copy your license key to the file. This is a technical license key that ships with the Open Source License and with the Commercial License of the software. The file should look like this:

Code Block

language	text
title	sos.ini
collapse	true

[licence]
key1                    = PUT_YOUR_KEY_HERE

Create a factory.ini file with e.g. the following configuration:

	<dependency>
		<groupId>com.fasterxml.jackson.module</groupId>
		<artifactId>jackson-module-scala_2.11</artifactId>
		<version>2.4.3</version>
	</dependency>
	<dependency>
		<groupId>commons-beanutils</groupId>
		<artifactId>commons-beanutils</artifactId>
		<version>1.9.2</version>
	</dependency>
	<dependency>
		<groupId>io.spray</groupId>
		<artifactId>spray-json_2.11</artifactId>
		<version>1.3.1</version>
	</dependency>
	<dependency>
		<groupId>io.spray</groupId>
		<artifactId>spray-http_2.11</artifactId>
		<version>1.3.2</version>
	</dependency>
	<dependency>
		<groupId>io.spray</groupId>
		<artifactId>spray-client_2.11</artifactId>
		<version>1.3.2</version>
	</dependency>
	<dependency>
		<groupId>com.typesafe</groupId>
		<artifactId>config</artifactId>
		<version>1.2.1</version>
	</dependency>
	<dependency>
		<groupId>com.typesafe.akka</groupId>
		<artifactId>akka-actor_2.11</artifactId>
		<version>2.3.9</version>
	</dependency>
	<dependency>
		<groupId>com.typesafe.akka</groupId>
		<artifactId>akka-slf4j_2.11</artifactId>
		<version>2.3.9</version>
	</dependency>
	<dependency>
		<groupId>javax.servlet</groupId>
		<artifactId>javax.servlet-api</artifactId>
		<version>3.1.0</version>
	</dependency>
	<dependency>
		<groupId>aopalliance</groupId>
		<artifactId>aopalliance</artifactId>
		<version>1.0</version>
	</dependency>
	<dependency>
		<groupId>org.jvnet.mimepull</groupId>
		<artifactId>mimepull</artifactId>
		<version>1.9.4</version>
	</dependency>
</dependencies>

Step 3

Create a sos.ini file and copy your license key to this file. This is a technical license key that ships with the Open Source License and with the Commercial License of the software. The file should look like this:

Code Block

language	text
title	sos.ini
collapse	true

[licence]
key1

Code Block

language	text
title	factory.ini
collapse	true

[spooler]
;                         enable job history, if set to True the scheduler keeps a job history in database tables
history                 = yes


;                         store job protocol for task history (yes|no|gzip, default: no)
history_with_log        = gzip


;                         store job protocol for order history (yes|no|gzip, default: no)
order_history_with_log  = gzip


;                         store protocol for scheduler history (yes|no|gzip, default: no)
history_archive         = gzip


;                         database configuration examples for job history
;						  active configuration
db                      = jdbc -class=org.mariadb.jdbc.Driver jdbc:mysql://localhost:3306/scheduler -user=DB_USER -password=DB_USER_PASSWD
db_class                = SOSMySQLConnection

;                         sample configuration for MySQL
;db                     = jdbc -class=com.mysql.jdbc.Driver jdbc:mysql://localhost:3306/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSMySQLConnection
;                         sample configuration for MySQL via mariaDB
;db                     = jdbc -class=org.mariadb.jdbc.Driver jdbc:mysql://localhost:3306/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSMySQLConnection
;                    = PUT_YOUR_KEY_HERE

Create a factory.ini file with e.g. the following configuration:

Code Block

language	text
title	factory.ini
collapse	true

[spooler]
;    sample  configuration for Oracle
;db                 enable job history, if =set jdbc -class=oracle.jdbc.driver.OracleDriver jdbc:oracle:thin:@//localhost:1521/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class     to True the scheduler keeps a job history in database tables
history          = SOSOracleConnection
;      = yes


;                  sample configuration for Microsoft SQL Server
;db  store job protocol for task history (yes|no|gzip,     default: no)
history_with_log        = jdbc -class=com.microsoft.sqlserver.jdbc.SQLServerDriver jdbc:sqlserver://localhost:1433;sendStringParametersAsUnicode=false;selectMethod=cursor;databaseName=scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_classgzip


;               = SOSMSSQLConnection
;         store job protocol for order            sample configuration for Microsoft SQL Server via jTDS
;dbhistory (yes|no|gzip, default: no)
order_history_with_log  = gzip


;                         store protocol for scheduler history (yes|no|gzip, default: no)
history_archive       = jdbc -class=net.sourceforge.jtds.jdbc.Driver jdbc:jtds:sqlserver://localhost:1433;sendStringParametersAsUnicode=false;selectMethod=cursor;databaseName=scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class gzip


;               = SOSMSSQLConnection
;         database configuration examples for job history
;						  active configuration
db        sample configuration for Postgres SQL
;db          =           = jdbc -class=org.postgresqljdbc -class=org.mariadb.jdbc.Driver jdbc:postgresqlmysql://localhost:54323306/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class                = SOSPgSQLConnectionSOSMySQLConnection

;                         sample configuration for FirebirdMySQL
;db                     = jdbc -class=orgcom.firebirdsqlmysql.jdbc.FBDriverDriver jdbc:firebirdsqlmysql://localhost:30503306/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSFbSQLConnectionSOSMySQLConnection
;                         sample configuration for MySQL via DB2mariaDB
;db                     = jdbc -class=comorg.ibmmariadb.db2jdbc.jcc.DB2DriverDriver jdbc:db2mysql://localhost:500003306/scheduler:driverType=2;retrieveMessagesFromServerOnGetMessage=true; -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSDB2ConnectionSOSMySQLConnection
;                         sample configuration for SybaseOracle
;db                     = jdbc -class=comoracle.sybasejdbc.jdbc3driver.jdbc.SybDriverOracleDriver jdbc:sybaseoracle:Tdsthin:@//localhost:50001521/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSSybaseConnectionSOSOracleConnection
;                         sample configuration for SybaseMicrosoft viaSQL jTDSServer
;db                     = jdbc -class=netcom.sourceforgemicrosoft.jtdssqlserver.jdbc.DriverSQLServerDriver jdbc:jtdssqlserver:sybase://localhost:5000/1433;sendStringParametersAsUnicode=false;selectMethod=cursor;databaseName=scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSSybaseConnectionSOSMSSQLConnection


;                         logsample level (info|debug1|...|debug9, default: info)
log_level configuration for Microsoft SQL Server via jTDS
;db              = info
;      = jdbc -class=net.sourceforge.jtds.jdbc.Driver jdbc:jtds:sqlserver://localhost:1433;sendStringParametersAsUnicode=false;selectMethod=cursor;databaseName=scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class               log= directorySOSMSSQLConnection
log_dir;                 = logs
;        sample configuration for Postgres SQL
;db                 log filename and log categories= (see http://www.sos-berlin.com/doc/en/scheduler.doc/factory_ini_spooler.xml#entry_log)
logjdbc -class=org.postgresql.Driver jdbc:postgresql://localhost:5432/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class                     = PATH/TO/YOUR/logs/scheduler.log


[java]
class_path           = SOSPgSQLConnection
;   = PATH/TO/YOUR/3rdPartyLibraries/*.jar;
;                     sample configuration for Firebird
;db put your Java VM parameters here
options               = jdbc -class= -Dlog4j.configuration="fileorg.firebirdsql.jdbc.FBDriver jdbc:firebirdsql:///PATH/TO/YOUR/log4j.properties"
;localhost:3050/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSFbSQLConnection
;                  enable detailed Java debug messages
debug       sample configuration for DB2
;db                     = jdbc -class=com.ibm.db2.jcc.DB2Driver jdbc:db2://localhost:50000/scheduler:driverType=2;retrieveMessagesFromServerOnGetMessage=true; -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSDB2Connection
;                         sample configuration for Sybase
;db                     = jdbc -class=com.sybase.jdbc3.jdbc.SybDriver jdbc:sybase:Tds:localhost:5000/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSSybaseConnection
;                         sample configuration for Sybase via jTDS
;db                     = jdbc -class=net.sourceforge.jtds.jdbc.Driver jdbc:jtds:sybase://localhost:5000/scheduler -user=DB_USER -password=DB_USER_PASSWD
;db_class               = SOSSybaseConnection


;                         log level (info|debug1|...|debug9, default: info)
log_level               = info
;                         log directory
log_dir                 = logs
;                         log filename and log categories (see http://www.sos-berlin.com/doc/en/scheduler.doc/factory_ini_spooler.xml#entry_log)
log                     = PATH/TO/YOUR/logs/scheduler.log


[java]
class_path              = PATH/TO/YOUR/3rdPartyLibraries/*.jar;
;                         put your Java VM parameters here
options                 = -Dlog4j.configuration="file:///PATH/TO/YOUR/log4j.properties"
;                         enable detailed Java debug messages
debug                   = no

Info

For this example, we created a libs folder in the home folder and copied the 3rd party libraries and the jdbc driver to this folder. Therefore we can use a relative path in the factory.ini.

We set the class path in the factory.ini like this:

[java]
class_path = libs/*.jar;

Otherwise an absolute path to the folder where the 3rd party libraries are copied to has to be configured.

Create a file scheduler.xml and configure the port your JobScheduler should listen to:

...

Code Block

language	powershell
title	start.cmd
collapse	true

@echo
set exepath=%~dp0
scheduler.exe -sos.ini="%exepath%sos.ini" -config="%exepath%scheduler.xml" -ini="%exepath%factory.ini"

Additional configuration

Code Block

language	text
title	log4j.properties
collapse	true

log4j.rootCategory=info, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L) - %m%n
log4j.logger.org.hibernate=fatal
log4j.logger.JobScheduler=fatal
log4j.logger.com.sos.scheduler.engine=info
# see http://www.sos-berlin.com/doc/en/scheduler.doc/api/Log-javax.script.xml
log4j.logger.com.sos.scheduler.engine.jobapi.scripting=debug, scheduler
log4j.appender.scheduler=org.apache.log4j.ConsoleAppender
log4j.appender.scheduler.layout=org.apache.log4j.PatternLayout
log4j.appender.scheduler.layout.ConversionPattern=%5p [%t] (%F:%L) - %m%n

Now your home folder should contain at least these files (windows-x64 example, other platforms differ):

factory.ini
jobscheduler-engine.dll
log4j.properties(optional)
scheduler.exe
scheduler.xml
sos.ini
start.cmd

Testing the JobScheduler

Create a folder with the name live in your working directory (your home folder). Create a simple job in the live folder .like this:

Code Block

language	xml
title	hello world job example
collapse	true

<?xml version="1.0" encoding="ISO-8859-1"?>
<job ><job>
    <script  language="shell">
        <![CDATA[echo Hello World!]]>
    </script>
    <run_time  once="yes"/>
</job>

Open a console in your working directory home folder and start the JobScheduler with the start.cmd start script.
If you have configured logging (log4j.properties and path to the properties file in the factory.iniini file) then you should see a task log and job log for the sample job like this:

Code Block

language	text
title	task log
collapse	true

2015-10-07 14:58:45.515+0200 [info]   SCHEDULER-918  state=starting (at=never)
2015-10-07 14:58:45.516+0200 [info]   SCHEDULER-987  Starting process: "C:\Users\YOUR_USERNAME\AppData\Local\Temp\\sos5051B.cmd"
2015-10-07 14:58:45.526+0200 [info]    
2015-10-07 14:58:45.526+0200 [info]   PATH_TO_YOUR_FOLDER>echo Hello World!  
2015-10-07 14:58:45.526+0200 [info]   Hello World!
2015-10-07 14:58:45.527+0200 [info]   SCHEDULER-915  Process event
2015-10-07 14:58:45.556+0200 [info]   SCHEDULER-918  state=closed
2015-10-07 14:58:45.556+0200 [info]   SCHEDULER-962  Protocol ends in logs/task.HalloWorldExample.log

Code Block

language	text
title	job log
collapse	true

2015-10-07 14:58:45.507+0200 [info]   SCHEDULER-893  Job is 'active' now
2015-10-07 14:58:45.512+0200 [info]   SCHEDULER-930  Task 6114864 started - cause: period_once
2015-10-07 14:59:45.716+0200 [info]   SCHEDULER-931  state=stopped
2015-10-07 14:59:45.717+0200 [info]   SCHEDULER-962  Protocol ends in logs/job.HalloWorldExample.log

Change Management References

Jira

server	SOS JIRA
columns	type,key,issuelinks,fixversions,status,priority,summary,updated
maximumIssues	20
jqlQuery	labels in (binary-files)
serverId	6dc67751-9d67-34cd-985b-194a8cdc9602

Space shortcuts

Page tree

Versions Compared

Old Version 7

New Version Current

Key

Scope

Prerequisites

Maven

The binaries file

The structure of the Binaries

Setting up a JobScheduler with the Binaries

Required configuration files

Configuration

Step 1

Step 2

Related Issues

The Binaries File

The Structure of the Binaries

Setting up a JobScheduler with the Binaries

Required configuration files

Configuration

Step 1

Step 2

Step 3

Step 3

Additional configuration

Testing the JobScheduler

Change Management References

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 7

New Version Current

Key

Scope

Prerequisites

Maven

The binaries file

The structure of the Binaries

Setting up a JobScheduler with the Binaries

Required configuration files

Configuration

Step 1

Step 2

Related Issues

The Binaries File

The Structure of the Binaries

Setting up a JobScheduler with the Binaries

Required configuration files

Configuration

Step 1

Step 2

Step 3

Step 3

Additional configuration

Testing the JobScheduler

Change Management References