JS7 JobScheduler

Space shortcuts

Page tree

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

Compare with Current View Page History

« Previous Version 10 Next »

Introduction

  • JOC Cockpit offers run-time settings that can be modified using the GUI and which are applied immediately without restarting JOC Cockpit.
  • Settings are available from the installation of JOC Cockpit and are populated with default values.

Settings Page

The Settings page is available from the user menu of an administrative account, located in the right upper corner of any JOC Cockpit view:


The Settings page is organized in sections like this:


Explanation:

  • Download and Upload buttons are provided to manage the JSON representation of settings.
    • Find an example for download: global-setting.json
    • The JSON representation does not include default values that are provided by JOC Cockpit. Instead, it only includes modified values.
  • Settings are organized in the following sections:
    • dailyplan
    • cleanup
    • joc
      • The section includes general settings for operation of JOC Cockpit.
      • The settings for this section are described below in the JOC Cockpit Settings section of this page.
    • git
    • user
      • The section includes settings that are managed per user.
      • The settings for this section are described below in the User Settings section of this page.
  • The name and default value is displayed for each setting.
    • The value of a setting can be modified after clicking the pencil icon .
    • Clicking the icon removes an updated value and the default value becomes active again.

JOC Cockpit Settings

Settings for operation of JOC Cockpit are available from the joc section in the Settings page:


Explanation:

CategorySettingDefault ValueExplanation
Audit Logforce_comments_for_audit_logfalse

Specifies that a reason has to be added for the JS7 - Audit Log for any changes applied to objects such as adding an Order, cancelling an Order etc.

  • This applies to operations from the GUI and to operations from the JS7 - REST Web Service API
  • Specifying the value true for this setting forces any API requests that modify objects to provide  arguments for the Audit Log.
  • Note that the JS7 - Profiles include a related setting to Enable Reasons for Audit Log that has the same effect. However, its use is voluntary and is restricted to the profile's account. The force_comments_for_audit_log setting enforces this behavior for any user accounts regardless of the profile settings of individual user accounts.

comments_for_audit_log

Specifies a list of possible comments for selection by a user when performing a GUI operation that modifies an object. In addition to using list entries, users are free to use individual comments when performing such operations.

  • The list is populated from some well known reasons for object modifications.
  • Users are free to modify list entries and add their own entries for possible comments.

default_profile_accountroot

When user accounts are added to the JOC Cockpit using the JS7 - Identity Services then JS7 - Profiles are created with individual settings for each user account.

  • This setting specifies the account that is used as a template for the profile when user accounts are created.
  • By default the root account is used which boils down to the fact that a new account's profile is populated from settings such as language, theme etc. of the default profile account.
Loginenable_remember_metrue

This setting enables the checkbox Remember me that is available from the login window and that stores the user's credentials such as account and password with a site cookie. As a result the user account and password are populated with the next login.

  • Some users might consider it a security risk to store credentials with browser data.
  • Therefore this setting can be disabled in order not to offer this option to users.
Inventory

copy_paste_suffix, copy_paste_prefix

copy

Specifies the prefix/suffix to be used for object names when performing copy & paste operations in the JOC Cockpit GUI.

  • In the JS7 - Inventory object names are unique per object type, for example Workflows use unique names, however, a Job Resource can use the same name as a Workflow.
  • Therefore when performing copy & paste operations a new object name has to be created. This is achieved by adding a prefix or suffix from which users can choose.

restore_suffix, restore_prefix

restored

The JS7 - Inventory, chapter: Trash Operations allow to add any removed objects to the inventory trash.

  • When removed objects are restored from the inventory trash then the original object name might be used by some newer object.
  • This setting specifies the values for prefix and suffix that are used based on the user's choice when restoring objects from the trash.

import_suffix, import_prefix

imported

The JS7 - Inventory Export and Import operations offer to import objects from an archive file.

  • When objects are imported then their names might conflict with existing object names.
  • This setting specifies the values for prefix and suffix that are applied based on the user's decision to add a prefix or suffix to imported objects.
Viewsshow_view_*

The settings can be used to disable individual views that are offered from the JOC Cockpit GUI by main menu items such as Daily Plan, Monitor, Workflows etc.

Controller

controller_connection_joc_password, controller_connection_history_password


The JS7 offers consistent configuration without use of passwords, see JS7 - Secure Operation. This includes the connection from JOC Cockpit to Controllers that can be secured by JS7 - Configuration for mutual HTTPS Server Authentication and Client Authentication. If users do not wish to configure mutual authentication for Controller connections then a password has to be used to identify JOC Cockpit with the Controller.

  • This applies to two connections established from JOC Cockpit to Controllers that are reflected from separate settings for controller_connection_joc_password and controller_connection_history_password:
    • The JOC Cockpit GUI makes use of a connection to receive events, for example about JS7 - Order State Transitions.
    • The JS7 - History Service is connected to a Controller to receive history information such as the execution status of jobs and any log output of jobs.
  • The password is specified as plain text in the Settings page and as a hashed value in the Controller's private.conf file, see JS7 - Controller Configuration Items, chapter: js7.auth.users: HTTPS Authentication and Authorization.
    • The Show Hash Value link is available from the Settings page to display the hashed value of the password.

    • Users can copy the hashed value to the clipboard and paste it to the Controller's private.conf file.
  • When used with HTTPS mutual authentication
    • the password is not relevant to identify JOC Cockpit with a Controller, however, passwords in the Settings page and in the Controller's private.conf file have to match.
    • an empty password can be used. The corresponding password in the Controller's private.conf file has to be changed to plain:
    • the default password can remain unchanged if the hashed password in the Controller's private.conf file remains unchanged.
  • When used without HTTPS mutual authentication
    • users are strongly encouraged to modify the default password in the Settings page and in the Controller's private.conf file accordingly.

If the password is modified in the Settings page then it has to be modified in the Controller's private.conf file too to make the passwords match.

It is recommended to first modify the password in the active Controller instance's private.conf file, then in the Settings page. Then restart the Controller instance from the Dashboard view. JOC Cockpit will reconnect to the active Controller instance. If a Controller Cluster is used, then apply the same change to the passive Controller instance's private.conf file.

User Settings

When connecting to JOC Cockpit for the first time then users receive a Welcome popup window like this:


The Welcome popup window offers to download defaults for Job Resources and examples for Workflows and related objects.

  • Downloadable files are explained from the JS7 - Getting Started article
  • .The popup window offers three options:
    • Got it: Signals acceptance and prevents further reminders from occurring.
    • Remind me later: within the next 24 hours the Welcome popup window will be displayed once again for the user.
    • Do not remind me: no further reminders occur.


The options of the Welcome popup window are stored with the user's settings like this:



  • No labels