Hub Properties

This section lists and describes the HVR Hub properties.

A hub property specifies the characteristics/attributes of HVR Hub. In the Command Line interface (CLI), the hub properties can be set using the command hvrhubconfig.

A property that is automatically discovered by HVR 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.

Property	Argument	Description
Access_List `Deprecated in v6.1.5/2`	accesslevel	Enables you to set read/write permissions for HVR users connecting to HVR Hub System. HVR allows different access levels for the authenticated users based on their username and the hub database name. The following access levels are supported by HVR: 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 Refresh, Compare, 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`	accesslevel	Enables you to set read/write permissions for all HVR users connecting to HVR Hub System. The following access levels are supported by HVR: 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 Refresh, Compare, 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	moment	Moment (date and time) at which the hub was created.
Creator	name	Name of the user who created the hub
Description	description	Description for hub.
Encrypt_Transaction_Files	true	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	moment	Moment (date and time) at which the hub was FROZEN.
Hub_ID		Unique identifier of the HVR Hub Server.
Hub_Server_HVR_CONFIG		This is a discovered property that stores the directory path of HVR_CONFIG for the HVR Hub Server.
Hub_Server_HVR_HOME		This is a discovered property that stores the directory path of HVR_HOME for the HVR Hub Server.
Hub_Server_HVR_License_Hash		This is a discovered property that stores the list of license identification hashes installed in the HVR Hub Server.
Hub_Server_HVR_Version		This is a discovered property that stores the version of the HVR installed in the HVR Hub Server.
Hub_Server_Operating_System		This is a discovered property that stores the name of the operating system on which the HVR Hub Server is installed/running.
Hub_Server_OS_Fingerprint		This is a discovered property that stores the unique identifier (fingerprint) of the server on which the HVR Hub Server is installed.
Hub_Server_Platform		This is a discovered property that stores the name of the HVR platform used for installing the HVR Hub Server.
Hub_Server_URL	url	Base URL for the HVR Hub Server. This is the URL via which users can access the HVR Hub Server. This URL is supplied in (most) commands using option -R.
Hub_State	state	State of the HVR 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		Specifies the delay between gather cycles of hvrstats job from the HVR log files. The `default` cycle delay is 60 seconds. After this parameter is changed, the hvrstats job must be restarted for the change to become effective.
Statistics_Metrics_Set		Set of metrics gathered by the hvrstats job.
Statistics_Retention_Policy	policy	Specifies the size of history maintained by hvrstats job, before it purges its own rows. Available options for policy are: NONE : History is not maintained by hvrstats job. Does not add history rows to HVR_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 HVR_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 HVR_STATS after 1 year: SMALL: 207K rows MEDIUM: 1222K rows LARGE: 7M rows UNBOUNDED: 75M rows In the User Interface, this property corresponds to the option RETENTION POLICY in Statistics Tuning. To purge the statistics data immediately (as a one-time purge) from the HVR_STATS table, use the command hvrstats (with option -p).
Statistics_Second_Location	path	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		Specifies the lowest time granularity that the hvrstats job gathers metrics. The `default` granularity is 1 min. After this parameter is changed, the hvrstats job must be restarted for the change to become effective.
User_Access `Since v6.1.5/2`	accesslevel	Enables you to set different read/write permissions for HVR users connecting to HVR 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 Refresh, Compare, 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.