Product Knowledge Base

Space shortcuts

Page tree

Introduction - About these tutorials

These tutorials provide an introduction to running JobScheduler Jobs and Orders, starting from the simplest possible 'Hello World' example of an Order Job.

It may be useful at this stage to read the following short articles to find out more about the basic concepts behind JobScheduler Jobs and Orders and how they differ from those of other job scheduling applications:

Requirements

Application Installation

Before starting the tutorials it is assumed that:

  • You have a JobScheduler installed.  FEATURE AVAILABILITY STARTING FROM RELEASE 1.11
    • We recommend that you install the "housekeeping" package when installing the JobScheduler, as part of this package will be used in at least one of the later tutorials.
    • The JobScheduler has been started as a service.
      See the JobScheduler Master - Installation Guide for more information.
    • JOE, which is used to edit Jobs, is usually installed along with the JobScheduler
  • You have installed the JOC Cockpit, which is used to operate the JobScheduler.
    See our JOC Cockpit - Installation article for more information.

Tutorial File Installation

The tutorials start with running a pre-configured Order Job:

  • You will need to download the pre-configured tutorial files:
  • Now unpack the tutorial files and copy the to the JobScheduler's live folder. The live folder is used to store all the objects - Jobs, Job Chains, Orders, etc. - used by the JobScheduler. The live folder is a sub-folder of the JobScheduler's data directory.
    • Windows
      • If JobScheduler was installed using the default paths then its data directory would likely be:
        • C:\ProgramData\sos-berlin.com\jobscheduler\myJobSchedulerID
      • and you would copy the tutorial files to your live folder, e.g.
        • C:\ProgramData\sos-berlin.com\jobscheduler\myJobSchedulerID\config\live
    • Unix
      • On Unix systems the JobScheduler's data directory could be the home directory for the current user:
        • ~/sos-berlin.com/jobscheduler/myJobSchedulerID
      • and you would copy the tutorial files to your live folder
        • ~/sos-berlin.com/jobscheduler/myJobSchedulerID/config/live
    • Where myJobSchedulerID identifies the JobScheduler instance and is specified during installation.

Using the tutorials with the JOC Cockpit and JOE interfaces

Whilst it is possible to operate JobScheduler completely from the command line / in batch, these tutorials rely extensively on the JobScheduler's graphic interfaces JOE and the JOC Cockpit.

  • The JOC Cockpit runs in a web browser and is served by the JobScheduler Web Service via HTTP.
    • To call and open the JOC Cockpit GUI you will need to know:
      • the web address for the GUI
        • with installation using default parameters on the local file system this could be:
          • http://localhost:4446/
      • an authorized account name and password
        • After installation with a default configuration the following account and password is active:
          • root:root
  • JOE (the JobScheduler Object Editor) is a separate application to JobScheduler (i.e. it can be used when the JobScheduler is not running).
    • JOE is installed in the same directory as the JobScheduler:
      • on Windows systems the default installation directory would likely be:
        • C:\Program Files\sos-berlin.com\jobscheduler\myJobSchedulerID
      • on Unix systems this would be:
        • ./opt/sos-berlin.com/jobscheduler/myJobSchedulerID
      • Where myJobSchedulerID identifies the JobScheduler instance and is specified during installation.
    • JOE can be started on Windows from the Start Menu using:
      • Start / All Programs / SOS JobScheduler / [scheduler_id] / JOE (JobScheduler Object Editor)
    • JOE can also be started on both Windows and Unix systems from the bin sub-directory of the JobScheduler installation directory by entering one of the commands:
      • jobeditor.cmd on Windows systems or
      • jobeditor.sh on Unix systems.