Command Line Options

CopyStorm/JobRunner supports the following command line options:

Option Argument(s) Description
-action string The operation CopyStorm/JobRunner should perform. Supported actions include:

  • runScheduled — run available pending jobs.
  • status — display a brief summary of all jobs.
  • makeCredentials — create an encryption token usable with the -cscredentials option.
  • runCopyStorm — used in conjunction with the -jobs flag to force specific CopyStorm jobs to run.
  • runCopyStormMedic — used in conjunction with the -jobs flag to force specific CopyStorm/Medic jobs to run.
-maxJobs integer Limits the number of concurrent CopyStorm and CopyStorm/Medic jobs. The value is global and enforced across all active copies of the CopyStorm/JobRunner.
-jobs string A comma-separated list of unique job ids. Job range expressions are also supported. For example:

  • 1,3,4
  • 1-10,11,12,15-20
-family string Limits the family of tasks that will run when the -runCopyStorm or -runCopyStormMedic option is used. The default value for this parameter is “Default”.
-cscredentials string An encrypted string containing all the information required to connect to a CopyStorm/Director database.
-cstype string The database type of the CopyStorm/Director database. Supported values include:

  • sqlserver
  • oracle
  • mysql
  • postgresql
  • h2
-csdatabase string The JDBC connection string used to connect to the CopyStorm/Director database.
-csuser string The username used to authenticate with the CopyStorm/Director database.
-cspassword string The password used to authenticate with the CopyStorm/Director database.
-apachelog If this flag is present, the org.apache.commons.logging system will be used. Otherwise a default logging system that writes to stderr will be used.
-silent If this flag is present, the application will not generate any messages unless an error is encountered.

The following sample command lines illustrate how the various options are used.

Run All Scheduled Jobs

sh CopyStormJobRunner.sh -action runScheduled -cscredentials “xyzzy”

Run All Scheduled Jobs With Clear Text Credentials

Note: It is bad practice to use clear text credentials on the command line.

CopyStormJobRunner.bat -action runScheduled -cstype postgresql -csdatabase //localhost/copystormjob -csuser root -cspassword mypassword

Run All Scheduled Jobs but No More Than 10 Simultaneously

sh CopyStormJobRunner.sh -action runScheduled -maxJobs 10 -cscredentials “encrypted-credentials-string”

Generate an Encrypted Token That Can be Used for the -cscredentials Option

sh CopyStormJobRunner.sh -action makeCredentials -cstype postgresql -csdatabase //localhost/copystormjob -csuser root -cspassword mypassword

Force the Default CopyStorm Task for Jobs 1 and 5 to Run

sh CopyStormJobRunner.sh -action runCopyStorm -jobs 1,5 -cscredentials “encrypted-credentials-string”

Tell Me How Many Jobs are Running (and other status information)

sh CopyStormJobRunner.sh -action status -cscredentials “encrypted-credentials-string”