Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • The command line option -env=[var_name]=[var_value] adds an environment variable to the JobScheduler.
    • This variable is established  only exists in the scope of the JobScheduler.
  • If a variable [var_name] already exists in the user environment then the value of the -env option will become effective.
  • The Windows Service of the JobScheduler reads the system and user environment only if it runs in the corresponding user account.
  • Environment variables are considered for substitution when used in settings (see Job Scheduler Reference Documentation).

...

  • You will find an example in ./user_bin/jobscheduler_environment_variables.(sh|cmd)-example.
  • Rename this file to ./user_bin/jobscheduler_environment_variables.(sh|cmd) to make it effective.
  • For Unix make sure that ./user_bin/jobscheduler_environment_variables.sh is readable and executable.
  • Edit ./user_bin/jobscheduler_environment_variables.(sh|cmd) if you always want to start the JobScheduler with additional environment variables.  Then it would not be necessary to call the above start script If you want to start the JobScheduler Windows service with the -env option or to reinstall a Windows Servicethen a reinstall is required (see below).

Example snippet of [install_path]/user_bin/jobscheduler_environment_variables.(sh|cmd) for adding an environment variable:

Code Block
 ...
 # unix 
 export hello="world"
 export PERL5LIB=`perl -e 'print join ":", @INC'`
 export TMP="${SCHEDULER_DATA}/tmp"
 ...
Code Block
 ...
 rem windows 
 SET SCHEDULER_PARAMS=%SCHEDULER_PARAMS% -env="hello=world" 
 SET SCHEDULER_START_PARAMS=%SCHEDULER_START_PARAMS% -env="hello=world"
 ...

...

The Windows Service always starts JobScheduler with the options and environment variables that have been used for installation. During the Windows JobScheduler setup a Windows Service is installed that has to be re-installed in order to make new environment variables effective.

For this:

  • stop the JobScheduler if it were startedis running: 
Code Block
 windows-shell>[install_path]\bin\jobscheduler.cmd stop
  • remove the JobScheduler service: 
Code Block
 windows-shell>[install_path]\bin\jobscheduler.cmd remove
  • install the JobScheduler service with -env option or edit the jobscheduler_environment_variables.cmd file as stated above
     
Code Block
 windows-shell>[install_path]\bin\jobscheduler.cmd install -env=hello=world
 ...or...
 windows-shell>[install_path]\bin\jobscheduler.cmd install
 
  • start the JobScheduler service: 
Code Block
 windows-shell>[install_path]\bin\jobscheduler.cmd start_service

Further references

 

...