Hub Properties - DSS 6 | Data Source Solutions Documentation
Documentation: Hub Properties - DSS 6 | Data Source Solutions Documentation
Hub Properties
This section lists and describes the DSS Hub properties.
A hub property specifies the characteristics/attributes of DSS Hub. In the Command Line interface (CLI), the hub properties can be set using the command dsshubconfig.
A property that is automatically discovered by DSS when it connects to a database/location is called discovered property. A user cannot specify/input value into a discovered property.
An array property and map property can store multiple values. The syntax for updating them from the Command Line Interface (CLI) varies.
Access_List
**Deprecated in** v6.1.5/2
Argument: accesslevel
Description: Enables you to set read/write permissions for DSS users connecting to DSS Hub System. DSS allows different access levels for the authenticated users based on their username and the hub database name.
The following access levels are supported by DSS:
- ReadOnly: User can view job status and information in Repository tables.
- ReadExec: User can view job status and information in Repository tables. They can also execute Compare and start/stop jobs.
- ReadExecRefresh: User can view job status and information in Repository tables. They can also execute Compare, Refresh, and start/stop jobs.
- ReadWrite: User can view job status and modify information in Repository tables. They can also execute Compare, Refresh, Activate, and start/stop jobs.
- HubOwner: User can view job status and modify information in Repository tables. They can also execute Compare, Refresh, Activate, start/stop jobs, freeze/unfreeze hub, change hub properties, and delete hub.
This is an array property that can store multiple values.
All_User_Access
**Since** v6.1.5/2
Argument: accesslevel
Description: Enables you to set read/write permissions for all DSS users connecting to DSS Hub System.
The following access levels are supported by DSS:
- read: User can view job status and information in Repository tables.
- exec_jobs: User can view job status and information in Repository tables. They can also execute Compare and start/stop jobs.
- exec_refresh: User can view job status and information in Repository tables. They can also execute Compare, Refresh, and start/stop jobs.
- write_locs: User can view job status and modify location information in Repository tables.
- write_channels: User can view job status and modify channel information in Repository tables. They can also execute Compare, Refresh, Activate, and start/stop jobs.
- hubowner: User can view job status and modify information in Repository tables. They can also execute Compare, Refresh, Activate, start/stop jobs, freeze/unfreeze hub, change hub properties, and delete hub.
Example JSON:
All_User_Access={"read":true}
This is a map property that can store multiple values.
Created
Argument: moment
Description: Moment (date and time) at which the hub was created.
Creator
Argument: name
Description: Name of the user who created the hub
Description
Argument: description
Description: Description for hub.
Encrypt_Transaction_Files
Argument: true
Description: If set to true, enables encryption of the Confidential data using the Software or KMS wallet.
This requires the Wallet Property - Type set to SOFTWARE or KMS.
Freeze_Time
Argument: moment
Description: Moment (date and time) at which the hub was FROZEN.
Hub_ID
Description: Unique identifier of the DSS Hub Server.
Hub_Server_DSS_CONFIG
Description: This is a discovered property that stores the directory path of DSS_CONFIG for the DSS Hub Server.
Hub_Server_DSS_HOME
Description: This is a discovered property that stores the directory path of DSS_HOME for the DSS Hub Server.
Hub_Server_DSS_License_Hash
Description: This is a discovered property that stores the list of license identification hashes installed in the DSS Hub Server.
Hub_Server_DSS_Version
Description: This is a discovered property that stores the version of the DSS installed in the DSS Hub Server.
Hub_Server_Operating_System
Description: This is a discovered property that stores the name of the operating system on which the DSS Hub Server is installed/running.
Hub_Server_OS_Fingerprint
Description: This is a discovered property that stores the unique identifier (fingerprint) of the server on which the DSS Hub Server is installed.
Hub_Server_Platform
Description: This is a discovered property that stores the name of the DSS platform used for installing the DSS Hub Server.
Hub_Server_URL
Argument: url
Description: Base URL for the DSS Hub Server. This is the URL via which users can access the DSS Hub Server.
This URL is supplied in (most) commands using option -R.
Hub_State
Argument: state
Description: State of the DSS Hub Server.
Valid values for state are:
- FROZEN: Indicates scheduler is stopped and no jobs can be running in the hub.
- LIVE: Indicates scheduler is running (and replication may be running, activated or deactivated).
- RESTARTING: Indicates a scheduler failure and the hub server is restarting it.
Statistics_Cycle_Delay
Description: Specifies the delay between gather cycles of dssstats job from the DSS log files. The default cycle delay is 60 seconds.
If the value of this property is changed, the dssstats job must be restarted for the change to become effective.
Statistics_Metrics_Set
Description: Set of metrics gathered by the dssstats job.
Statistics_Retention_Policy
Argument: policy
Description: Specifies the size of history maintained by dssstats job, before it purges its own rows.
Available options for policy are:
- NONE: History is not maintained by dssstats job. Does not add history rows to DSS_STATS.
- SMALL: History rows for per-table measurements at 1min/10min/1hour/1day granularity are purged after 1hour/4hours/1day/7days respectively. History rows for all tables (table=*) at 1min/10 min/1hour/1 day granularity are purged after 4hours/1day/7days/30days respectively.
- MEDIUM
default: History rows for per-table measurements at 1min/10min/1hour/1day granularity are purged after 4hours/1day/7days/30days respectively. History rows for all tables (table=*) at 1min/10min/1hour/1day granularity are purged after 1day/7days/30days/never respectively. - LARGE: History rows for per-table measurements at 1min/10min/1hour/1day granularity are purged after 1day/7days/30days/never respectively. History rows for all tables (table=*) at 1min/10min/1hour/1day granularity are purged after 7days/30days/never/never respectively.
- UNBOUNDED: Never purge history rows. Rows continue to grow in DSS_STATS.
A smaller policy will reduce the amount of disk space needed for the hub database. For example, if a hub has 2 channels with same locations (1 capture and 2 targets) and each has 15 busy tables measured using 10 status measurements, then the following is the approximate number of rows in DSS_STATS after 1 year:
- SMALL: 207K rows
- MEDIUM: 1222K rows
- LARGE: 7M rows
- UNBOUNDED: 75M rows
In the DSS UI, this property corresponds to the RETENTION POLICY option in Statistics Tuning.
To purge the statistics data immediately (as a one-time purge) from the DSS_STATS table, use the command dssstats (with option -p).
Statistics_Second_Location
Argument: path
Description: Secondary location (directory path) to store the statistics data in CSV format files. For more information about using this property, see Secondary Storage for Statistics.
Statistics_Time_Granularity_Base
Description: Specifies the lowest time granularity that the dssstats job gathers metrics. The default granularity is 1 min.
If the value of this property is changed, the dssstats job must be restarted for the change to become effective.
User_Access
**Since** v6.1.5/2
Argument: accesslevel
Description: Enables you to set different read/write permissions for DSS users connecting to DSS Hub System, per user.
The following access levels are supported:
- read: User can view job status and information in Repository tables.
- exec_jobs: User can view job status and information in Repository tables. They can also execute Compare and start/stop jobs.
- exec_refresh: User can view job status and information in Repository tables. They can also execute Compare, Refresh, and start/stop jobs.
- write_locs: User can view job status and modify location information in Repository tables.
- write_channels: User can view job status and modify channel information in Repository tables. They can also execute Compare, Refresh, Activate, and start/stop jobs.
- hubowner: User can view job status and modify information in Repository tables. They can also execute Compare, Refresh, Activate, start/stop jobs, freeze/unfreeze hub, change hub properties, and delete hub.
Example JSON:
User_Access={"user1":{"hubowner": true},"user2":{"write_locs":true}}
This is a map property that can store multiple values.