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:

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:

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:

Example JSON:

User_Access={"user1":{"hubowner": true},"user2":{"write_locs":true}}

This is a map property that can store multiple values.