Page History

Installation Procedure

General requirements:

• A JobScheduler Master is up and running.
• A Java Run-time Environment in version 1.8 or newer is installed on the system(s) the Agent is to be installed on.
• We recommend that you use the SOS XML Editor to manage the configuration files required for the Batch Installer. More information about the installation and use of the XML editor will be provided later in this article.

1. Download and Extract the Batch Installer and Agent Files

The following steps have to be carried out. Files can be downloaded from http://www.sos-berlin.com/jobscheduler-downloads

• 1.1 Unix

1. • Download the "JobScheduler Universal Agent" tarball for Unix.
   • Download the "Universal Agent Batch Installer". The archive contains the following folders and sub-folders: 
     • live/batch_install_universal_agent
       
       • This folder contains the Jobs and Job Chain used to carry out the installation.
       • Extract these files to the the live folder of the JobScheduler Master: SCHEDULER_DATA/config/live.
     • batch_install
       
       • This folder contains the configuration files for the Batch Installer.
       • Extract these files to the config directory of the JobScheduler Master: SCHEDULER_DATA/config.
   • Copy the JobScheduler Universal Agent installation file to the SCHEDULER_DATA/config/batch_install folder.

• 1.2 Windows
  • Download the "JobScheduler Universal Agent" for Windows.
  • Download the "Universal Agent Batch Installer". The archive contains the following folders and sub-folders
    • the live/batch_install_universal_agent folder
      
      • This folder contains the Jobs and Job Chain used to carry out the installation. 
      • Extract these files to the live folder of the JobScheduler Master SCHEDULER_DATA/config/live.
    • the batch_install folder
      
      • This folder contains the configuration files for the Batch Installer.  
      • Extract these files to the JobScheduler configuration directory SCHEDULER_DATA/config.
  • Copy the JobScheduler Universal Agent installation file to the folder SCHEDULER_DATA/config/batch_install folder.

2

. Configure the Transfer of the Universal Agent Installation Files and the Installation of the Agents

2.1 Edit the XML Configuration files

Configuring complex XML files with a text editor is often a tedious and error-prone procedure. To get around this, we recommend that you use our XML Editor to manage the configuration files required for the Batch Installer. The XML Editor automatically validates configuration files and therefore reduces the possibility of configuration errors. See the Using the XML Editor chapter below for more detailed information about using the XML Editor. 

• After downloading the XML Editor, extract the contents of the zip file to a convenient folder (an installation routine is not required) and start the sos.xml.editor.exe program.
• Use the XML Editor to configure transfer of the Universal Agent installation files:
  
  • Open your yade_agent_batch_installer_settings.xml YADE configurationfile, which is located in the config/batch_installer folder and assign the following schema in the XML Editor:
    • http://www.sos-berlin.com/schema/yade/YADE_configuration_v1.0.xsd.
    • See the YADE profiles for the file transfer chapter below for instructions on how to configure the YADE configuration file.
• Use the XML Editor to configure the installation of the Universal Agents:
  
  • Open your batch_installer_config_file.xml configuration file in the XML Editor and assign the scheduler_universal_agent_installations.xsd schema: both files are located in the config/batch_installer folder.
    
    • See the Batch Installer Configuration File chapter below for instructions on how to configure the Batch Installer configuration file.

2.2 Configure the JobScheduler Jobs

Once the Job and Job Chain have been extracted to the live folder of your JobScheduler Master carry out the following: 

• AgentBatchInstaller Job:
  
  • Set the parameter values for the AgentBatchInstaller job in your JobScheduler Master.

  • Set the installation_definition_file job parameter to the path that points to the Batch Installer configuration file.

3 Installation of the Agents

The Agents can be installed after the XML configuration files and JobScheduler Jobs have been configured. Start a task for the AgentBatchInstaller job as follows:

1. Open a JobScheduler Operating Center (JOC) browser window for the JobScheduler master.
2. Go on the "Jobs" Window and open the "batch_installer_universal_agent" folder.
3. Right click on the job to open the context menu.

4. Select the Start task immediately operation.
5. This job will create the appropriate Orders for the JobScheduler as explained in the description of the Batch Installer Application.