Troubleshooting Access to Hub System

The section describes various topics related to access issues in HVR Hub System, and the workaround for resolving them.

Direct Command Line Interface (CLI) access is required - all commands listed on this page should be executed directly on the machine where the HVR Hub System is installed. Only a user who has install privileges on the machine (e.g. system administrator) may execute these commands.

Unable to Log in

User is not able to log in because of forgotten/wrong username or password. In the HVR UI, the following message is displayed in this scenario:

To resolve this problem, you can use either of the following methods:

Reset User Password
Create New User from CLI
Reset User Password Using Setup Mode

Reset User Password

A user's password can be reset from HVR UI or CLI.

To reset a user's password from HVR UI, perform the following step as a user with SysAdmin permission:

On the System page, select Users tab.
Click More Options menu of the user for whom the password needs to be reset and select Show Preferences.
Click Reset Password.

Create New User from CLI

Create a new user and assign the required privilege.

Create a new user using the command hvruserconfig:
```
hvruserconfig -c new_user
```
To set the authentication mechanism for this user, supply option -A. If option -A is not supplied, then by default the user is created with local authentication.
Grant the required permission to the new user using the command hvrreposconfig:
For example, to grant SysAdmin permission to the new user named myuser:
```
hvrreposconfig -A user:myuser=SysAdmin
```
Since 6.1.5/2, the following command should be used, as -A option is deprecated.
```
hvrreposconfig User_Access.myuser.sysadmin=true
```

Reset User Password Using Setup Mode

Initiate the HVR Hub System setup mode and then reset the user's password from the System Setup page.

Initiating setup mode for a HVR Hub System with live hub(s) will stop all replication activities.
In setup mode, the HVR Hub Server will be stopped, which means all replication activities will be terminated.

Initiate the setup mode using the command hvrhubserverconfig:
```
hvrhubserverconfig Setup_Mode=true
```
Launch HVR UI in a browser and perform the following steps:
If the HVR UI is already open in a browser, just relaunch/refresh the page.
1. On the System Setup page, click Proceed with System Setup.
2. In the section Complete the System Setup, click More Options menu of the user (for whom the password needs to be reset) and select Reset Password.
3. Click Complete System Setup to save the changes and exit setup mode.

Hub User Has Insufficient Privileges

The hub user does not have sufficient privileges/permissions to perform certain operations (e.g. Refresh, Compare) on a hub.

To resolve this problem, you can use either of the following methods:

Grant Permission to User
Grant SysAdmin Permission Using Setup Mode

Grant Permission to User

A user's permissions can be managed from HVR UI and CLI.

To manage a user's permissions from HVR UI, perform the following step as a user with SysAdmin or HubOwner permission:

On the System page, select Permissions tab.
Click Add Access.
Select the User to be granted the permission.
Select the required permission available under CURRENT HUB.
Click Save.

Grant SysAdmin Permission Using Setup Mode

Initiate the hub system setup mode and then grant the user SysAdmin permission from the System Setup page.

Initiating setup mode for a HVR Hub System with live hub(s) will stop all replication activities.
In setup mode, the HVR Hub Server will be stopped, which means all replication activities will be terminated.

Initiate the setup mode using the command hvrhubserverconfig:
```
hvrhubserverconfig Setup_Mode=true
```
Launch HVR UI in a browser and perform the following steps:
If the HVR UI is already open in a browser, just relaunch/refresh the page.
1. On the System Setup page, click Proceed with System Setup.
2. In the section Complete the System Setup, click More Options menu of the user that require SysAdmin permission and select Assign as SysAdmin.
3. Click Complete System Setup to save the changes and exit setup mode.

Hub Server Repository Connectivity Error

The hub server is not able to connect to the hub repository due to a changed repository connection property (e.g. password for the repository database has changed).

To resolve this problem, you can use either of the following methods:

Update Repository Properties Using Setup Mode
Update Repository Properties from CLI

Update Repository Properties Using Setup Mode

Initiate the HVR Hub System setup mode and then reconfigure/update the hub repository connection properties from the System Setup page.

Initiate the setup mode using the command hvrhubserverconfig:
```
hvrhubserverconfig Setup_Mode=true
```
Launch HVR UI in the browser and perform the following steps in System Setup page:
If the HVR UI is already open in a browser, just relaunch/refresh the page.
1. On the System Setup page, click Proceed with System Setup.
2. In the section Connection to Repository Database, click Edit to update the hub repository connection properties.
3. Click Complete System Setup to save the changes and exit setup mode.

Update Repository Properties from CLI

Reconfigure/update the hub repository connection properties directly from CLI using the command hvrhubserverconfig:

hvrhubserverconfig hub_server_property=property_value

For example, if the username and password for the repository database has changed, execute:

hvrhubserverconfig Database_User=mynewrepodb Database_Password=mynewrepodbpassword