Versions Compared

Key

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

...

  • In a first step update JOC Cockpit.
  • In a second step update Controller and Agents.

Anchor
update_procedure_docker_images
update_procedure_docker_images
Update Procedure for Use of

...

Docker® Images

For any Docker® images for JOC Cockpit, Controller and Agents the following procedure applies:

...

Controller

  • Consider instructions from from
  • Take a backup of the Controller instance's installation directory.
  • Extract the installer archive .tar.gz/.zip file from a neutral directory not related to the current Controller installation. This will create a sub-directory that includes the maintenance release number, for example controller.2.2.2.
  • Stop the Controller:
    • Standalone Controller
      • Stop the Controller instance.
    • Controller Cluster
      • Take a note which Controller instance is the active node when stopping Controller instances.
      • Stop both Controller instances.
      • Stop the Cluster Watch Agent.
  • From the existing Controller installation directory move or remove the lib sub-directory.
  • Copy the lib and bin sub-directories from the extracted installer archive to the Controller instance's installation directory. This will replace the previous lib sub-directory and will overwrite the existing bin sub-directory from the new release. The Controller's instance start script that can contain individual settings is not included with the installer archive and therefore will not be overwritten, see JS7 - Controller - Command Line Operation.
    • For a Controller Cluster consider to perform this step for both Controller instances.
  • For a Controller Cluster update the Cluster Watch Agent as explained below and start the Cluster Watch Agent.
  • Start the Controller.

...

  • Consider instructions from 
  • Take a backup of the Agent's installation directory.
  • Extract the installer archive .tar.gz/.zip file from a neutral directory not related to the current Agent installation. This will create a sub-directory that includes the maintenance release number, for example agent.2.2.2.
  • Stop the Agent.
  • From the existing Agent installation directory move or remove the lib sub-directory.
  • Copy the lib and bin sub-directories from the extracted installer archive to the Agent's installation directory. This will replace the previous lib sub-directory and will overwrite the existing bin sub-directory from the new release. The Agent's instance start script that can contain individual settings is not included with the installer archive and therefore will not be overwritten, see JS7 - Controller - Command Line Operation.
  • Start the Agent.

...

The user account's menu in the right upper corner of any JOC Cockpit page offers the Manage Controller/Agents operation:

Image Modified


The respective page for Controller/Agent management offers the operation to reset an Agent:

Image Modified


Explanation:

  • The Reset operation comes in two flavors:
    • Reset: the Agent is requested to perform a restart. This operation is applicable if no orders started or are running with the Agent.
    • Reset Forced: the Agent is forced to perform a restart and to drop its journal. The Controller will then re-deploy scheduling objects such as workflows to the Agent.
  • The Reset operation can require 10 to 60 seconds ' time depending on the time required to stop and to start the Agent.

...