You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 2
Next »
Summary
- The Controller makes use of two configuration files:
- the general configuration from
controller.conf
- the security configuration from
private.conf
- Restart the Controller instance to apply changes to any configuration file .
General Configuration
File: joc.properties
Default Location: /var/sos-berlin.com/js7/joc/resources/joc/joc.properties
################################################################################
### If JOC Cockpit is used in a cluster then type a title to identify which node
### is currently used. Further type an ordering (Primary <= 0, Backup > 0) for
### the display order in JOC's dashboard
title = PRIMARY JOC COCKPIT
ordering = 0
###########
daily_plan_timezone = UTC
daily_plan_period_begin = 00:00:00
################################################################################
### Path to log4j configuration file. Path can be absolute or relative
### to this file.
log4j.configuration = log4j2.xml
################################################################################
### Path to hibernate configuration file of JOC's database.
### Path can be absolute or relative to this file.
hibernate_configuration_file = hibernate.cfg.xml
################################################################################
### The time (in seconds) to establish the connection with the
### remote host. Default = 2
jobscheduler_connection_timeout = 2
################################################################################
### The time (in seconds) waiting for data after the connection
### was established; maximum time of inactivity between two data packets.
### Default = 5
jobscheduler_socket_timeout = 5
################################################################################
### Should hostname verification be carried out for https certificate.
### Default false
https_with_hostname_verification = true
################################################################################
### Location, type and password of the Java truststore which contains the
### certificates of eachnJobScheduler Controller for HTTPS connections. Path can be
### absolute or relative to this file.
keystore_path = ../../etc/https-keystore.p12
keystore_type = PKCS12
keystore_password = jobscheduler
key_password = jobscheduler
truststore_path = ../../etc/https-truststore.p12
truststore_type = PKCS12
truststore_password = jobscheduler
################################################################################
### Requests to all web services which modify JobScheduler objects such as
### "start order", "stop job" etc. can contain a comment to describe the reason.
### This flag controls if the comment is required or not. Default false
force_comments_for_audit_log = false
################################################################################
### JOC Cockpit comes with the possibility to configure a security level for the
### signing mechanism, options "high", "medium" and "low".
### high:
### public PGP keys are stored for verification only
### all signing will be done externally outside of JOC Cockpit
### medium:
### a private PGP key will be stored for signing
### signing will be done automatically with the provided key
### low:
### no keys will be stored
### signing will be done internally with default keys
###
### This flag controls the used security level. Default low
security_level = medium
################################################################################
### Settings for a custom logo file on the login page
### The logo file has to be located in ./jetty_base/webapps/root/ext/images
### Possible units for width are according to
### https://www.w3schools.com/cssref/css_units.asp (default px)
### Possible values for the position are "top" or "bottom" (default=bottom).
custom_logo_name =
custom_logo_height =
custom_logo_position =
################################################################################
### A default profile should be available that includes any profile settings
### that are applied by default to new users.
default_profile_account =
################################################################################
### The login dialog provides a 'Remember Me' checkbox. If enable_remember_me
### is false then this checkbox is hidden and unchecked.
enable_remember_me = true
################################################################################
### Pre-defined comments used for example in the 'reasons' describing actions in
### the audit log.
comments = System maintenance; \
Repeat execution; \
Business requirement; \
Restart failed execution; \
Re-instantiate stopped object; \
Temporary stop; \
Change of JobScheduler object; \
Rerun with parameter changes; \
Change of external dependency; \
Application deployment and upgrade
################################################################################
### Normally, the user permissions control if a view such as dashboard,
### workflows, etc are shown or hidden. Here you can force to show (=true) or
### hide (=false) a view independent of the permissions. If the value is unequal
### true or false then the permissions win.
show_view_dashboard =
show_view_dailyplan =
show_view_workflows =
show_view_filetransfers =
show_view_resources =
show_view_history =
show_view_auditlog =
show_view_jobstreams =
show_view_configuration =
Dashboard Settings
Setting | Default Value | Explanation |
---|
title | PRIMARY JOC COCKPIT
SECONDARY JOC COCKPIT | Title of JOC Cockpit widget in Dashboard |
ordering | 0
1 | Display sequence of JOC Cockpit widget in Dashboard |
title:
The title of the respective JOC Cockpit instance as visible from the Cluster Status widget of the JS7 Dashboard view.ordering
: The order of appearance of the respective JOC Cockpit instance with the Cluster Status widget of the JS7 Dashboard view. An ordering 0 indicates the leftmost occurrence.
Daily Plan Settings
Setting | Default Value | Explanation |
---|
daily_plan_timezone | UTC | Specifies the time zone that is used to indicate the period of the Daily Plan |
daily_plan_period_begin | 00:00 | Specifies the offset that is applied to the time zone indicated with the daily_plan_timezone attribute. |
Logger Settings
Setting | Default Value | Explanation |
---|
log4j.configuration | log4j2.xml | Specifies the file name of the log4j2 configuration file to be used. This file is expected with the configuration folder ./resources/joc |
Database Connection Settings
Setting | Default Value | Explanation |
---|
hibernate_configuration_file | hibernate.cfg.xml | Specifies the connection URL, account and authentication for the connection to the database. |
Controller Connection Settings
Setting | Default Value | Explanation |
---|
jobscheduler_connection_timeout | 2 | Specifies the time (in seconds) to establish a connection to a Controller. |
jobscheduler_socket_timeout | 5 | The time (in seconds) waiting for data after the connection to a Controller was established; maximum time of inactivity between two data packets. |
HTTPS Connection Settings
Setting | Default Value | Explanation |
---|
https_with_hostname_verification | false | Specifies if hostname verification should be performed for HTTPS connections. |
keystore_path | ../../etc/https-keystore.p12 | The keystore includes the private key and certificate for incoming HTTPS connections. |
keystore_type
| PKCS12 | The keystore types PKCS12 and JKS are supported. |
keystore_password |
| The keystore is protected by a password. |
key_password |
| The private keys in the keystore are protected by a password. Consider that for PKCS#12 keystores the same password applies for all keys. |
truststore_path | ../../etc/https-truststore.p12 | The truststore includes the public key and/or certificates for incoming HTTPS connections. |
truststore_type | PKCS12 | The truststore types PKCS12 and JKS are supported. |
truststore_password |
| The truststore is protected by a password. |
Operational Settings
Setting | Default Value | Explanation |
---|
|
|
|
security_level | false | When being set to true then JOC Cockpit will require an audit log comment (reason) for any operations that modify the state of an object, such as e.g. starting or killing a job.. |
jobscheduler_socket_timeout | 5 | The time (in seconds) waiting for data after the connection to a Controller was established; maximum time of inactivity between two data packets. |