You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 22 Next »

Introduction

The SOS web site offers the Try Out option form to request an immediate product demo. When requesting the demo you will receive a welcome e-mail that includes an invitation link and access data for the JobScheduler demo.

After clicking the Try-Out: Login JOC Cockpit link in the welcome e-mail, you will be presented the JobScheduler Operations Center ( JOC) Login. Use the account and password that you received with the welcome e-mail.

After login you will be presented the initial view, which is referred to as the DASHBOARD, for explanations see Dashboard View. The Dashboard gives a bird's eye view of the JobScheduler's operational status. 

To run job chains from JOC Cockpit, you need to switch to the JOB CHAINS view. To expand the list of folders and to see available job chains, in the left panel navigate the tree and click on the arrows and folders, for detailed explanations refer to Navigation and Usability

After expanding, the top folder will show sub-folders, each including one or more job chains.

All examples in the demo environment follow the same pattern. Each job chain demonstrates an important JobScheduler feature, and most of the job chains use a minimum of two Orders to simulate successful and failed processing.

Shell Script Job

The example 01_JobChainShellJob demonstrate the JobScheduler's capability to execute shell jobs.

  1. To start the example, first you should to list the job chains in the folder. Therefore click on the sub-folder, e.g. 01_JobChainShellJob. The list of job chains will appear in the right panel.



  2. 01_JobChainShellJob: the job chain includes some simple jobs with a shell script as executable. The job chain can be started by two permanent orders to run the job chain with “success” and “error” execution results.

          

  1. The job chain 01_JobChainShellJobs includes 5 job nodes with 2 orders to demonstrate successful and failed execution.

  2. The order start_order_success will simulate successful execution, the order start_order_error will raise an error during execution.

  3. To run any of the orders

    1. click on the action menu of the order, a drop-down menu will appear like this:



    2. click on the Start Order now option to run the order immediately. The order will start, you can see the order passing from one job node to then next.
  4. To check the status of the order

    1. click on the job chain name 01_JobChainShellJobs, the Order History panel will open at the bottom section of the page.
    2. the Order History panel shows the execution history of past and current job chain runs..




  5. The Order History panel shows the last few executions of a job chain, you can use the HISTORY view for a full report. The Order History offers to view the log of past and running orders:
    1. Click on the most recent entry of the start_order_success order to access the log of the order's last run. 



    2. A log window will open and the order log will be displayed. The order log contains log output from all jobs executed by the order. 
    3. You can download the log file by clicking the Download button from the upper right corner of the log window.

Execute Database Statements

The JobschedulerManagedDatabase is a JITL job, it can be used to execute SQL statements or SQL scripts on a number of database products. The JobSchedulerManagedDatabase job abstracts the complexity of executing SQL statements/scripts on database systems. The JITL job uses the Java hibernate interface to connect to the database and to execute SQL statements.

In this example, you are executing a simple SQL statement on the JobScheduler Database to get the JobScheduler Host and URL. The JobSchedulerManagedDatabase job has the capability to convert results of SQL statements to order parameters which can be read by successive jobs in the job chain. This example demonstrates the feature where results from an SQL statement become available to the next job steps as order parameters, e.g. JobScheduler Host and URL values 

  1. To run the job chain

    1. click on the job chain name 02_DatabaseStatement to expand the job chain details, a single order 02_execute_database_statement should be displayed:



  2. To run the order.

    1. click on the action menu of the order. A drop-down menu will appear.
    2. click on Start Order now option to run the order immediately.



    3. To check the status of the order
      1. click on the job chain name 02_DatabaseStatements,
      2. the Order History panel will open to show the past and current executions of the job chain.
    4. From the log output you will see that the SQL statement was executed for the database and the results were transferred to the next job as order parameters.

File Watching

JobScheduler comes with the built-in File Watching feature that allows to automate business processes based on the arrival of files. The file watching job chain starts automatically as soon as a file arrives in a specific folder. Once the job chain is triggered by the file, the complete file path will be available to the job as an environment variable which can be passed to the application or script called by the job. 

  1. To make the 04_FileWatcher job chain start you need to create some files which will trigger the job chain. To this purpose, first, expand the folder and list all the job chains.
  2. Start the order start in the job chain 04_GenerateTestFiles



  3. This will generate five files in the incoming folder that will trigger the job chain 04_FileWatcher



  4. To check the status of the file watcher order
    1. click on the job chain name 04_LoadDWH,
    2. the Order History panel will open to show past and running executions of the job chain..

Agentless Scheduling

JobScheduler has feature-rich Agent Scheduling capabilities using the JobScheduler Universal Agent. Along with the Agent, JobScheduler supports the agentless scheduling over SSH.

This example demonstrates the simple example of executing a shell command on a remote server over SSH. The JITL job JobSchedulerSSHJob uses a built-in interface to execute tasks over SSH. Read more about job parameterization from the before-mentioned link. Find the following example for the JobScheduler SSH Job:

Run the Job

  1. Start the order start_order which will start the 05_execute_remote_command job.



  2. The job 05_execute_remote_command will connect with the remote host and will execute a simple shell command “env | sort”, the results of the command will be stored with the log file.
  3. To open the log file.
    1. click on the job chain name 05_SSHRemoteExecution, the Order History panel will open like this:



    2. click on the order start_order to open the log window.


Multiple Orders and Order Parameters

This example demonstrates the JobScheduler feature of multiple orders assigned to a single job chain and order parameters. JobScheduler job chains can be reused by assigning multiple orders using different parameter sets. This will reduce the number of identical job configurations that you run for similar tasks. The job chain 06_CRM_ERP_Backup_Process includes a single job that accepts parameters. A number of orders are configured to run the job chain. 

The JobScheduler feature can be used in a classic database backup process, a common use case for example to backup two databases, e.g. ERP and CRM databases, with a frequency of daily, weekly and monthly backups. A job chain can be configured to reuse the database backup job by applying parameters from individual orders. When the order will start then the parameters from order will be available to the job as environment variables. 


In the job chain CRM_ERP_Backup_Process multiple orders are used with different parameter sets. The orders are intended for daily, weekly and monthly execution.  

  • DailyBackup orders: are running daily according to the order's run-time. 
  • WeeklyBackup orders: run weekly, e.g. outside of business hours on Saturday or Sunday, according to the order's run-time. 
  • MonthlyBackup orders: will execute on the last day of month.

   

To run the job chain.  

  1. click on job chain 06_CRM_ERP_Backup_Process and expand the job chain details like this:

  

To run the job chain

  1. click on the action menu of any order, e.g. DailyBackupERP, a drop-down menu will open.  
  2. click on Start Order now to start the order.  


  

To check the status of the order  

  1. click on job chain name CRM_ERP_Backup,
  2. the Order History panel will open to display the execution history for past and current job chain runs.

  

You can review the log of the running order like this:

  1. Click on  the DailyBackupERP order to open the log from the Order History tab.   
  2. The log window will open and the order log will be displayed.

     

  







  • No labels