VSX Gaia CLI Commands

This section describes how to use Gaia CLI commands on VSX Gateways. For more about Gaia CLI commands, see the R77 Gaia Administration Guide.

Included Topics Changing the Context Configuring Roles on Virtual Devices Showing Virtual Devices

Changing the Context

Many CLI commands for VSX are run on each context (Virtual Device) separately. Change the context to a different Virtual Device and then run the command.

Use the set virtual-system or vsenv command to change context to a different Virtual Device.

• set virtual-system - Run from the CLI
• vsenv - Run from Expert mode

Syntax

set virtual-system <vsid>

vsenv <vsid>

Parameter	Description
vsid	ID of the Virtual Device.

Example

set virtual-system 3

Output

Context is set to vsid 3

Configuring Roles on Virtual Devices

Configure roles permissions for users on each Virtual Device. When you create Virtual Devices, they do not receive any role permissions. You can use the CLI to:

• Add a new role definition to a Virtual Device.
• Delete a role definition from a Virtual Device or all the Virtual Devices.

R77 VSX does not support the Gaia WebUI. You cannot configure role permissions for the WebUI.

For more about configuring roles, see the R77 Gaia Administration Guide.

Syntax

add rba role <name> virtual-system-access <vsid>

delete rba role <name> virtual-system-access <vsid|all>

Parameter	Description
name	Role name as a character string that contains letters, numbers or the underscore (_) character. The role name must start with a letter.
vsid	ID of the Virtual Device. Use commas to enter multiple Virtual Devices.
all	Deletes access permissions to all Virtual Devices.

Example

add rba role newRole domain-type System all-features

add rba role newRole virtual-system-access 0,2,3

Adding Roles

Use the CLI to create and configure roles for the VSX Gateway. Assign Virtual Devices to a role, so that the users of that role can access them.

To create roles for a VSX Gateway:

1. Create the role. Run add rba role
2. Add Virtual Devices to the role. Run add rba role <name> virtual-system-access <vsid>
3. Save the role. Run save config

This is an example of creating roles.

GizaVSXGW1:0> add rba role newRole domain-type System all-features GizaVSXGW1:0> add rba role newRole virtual-system-access 0,2,3 GizaVSXGW1:0> save config

Adding Users

Use the CLI to create new users and assign them to a role.

To add users to a role:

1. Create the user. Run add user <username> uid <user-id> homedir <home directory path>
2. Create a password for the user. Run set user <username> password
3. Add the user to a role. Run add rba user role <role name>
4. Save the user. Run save config

This is an example of creating users.

GizaVSXGW1:0> add user user1 uid 160 homedir /home/user1 WARNING Must set password and a role before user can login. - Use 'set user USER password' to set password. - Use 'add rba user USER roles ROLE' to set a role. - Use 'add rba role ROLE virtual-system-access' to set allowed virtual-system role. GizaVSXGW1:0> set user user1 password New password: Verify new password: GizaVSXGW1:0> add rba user user1 roles newRole

Adding or Deleting Virtual Devices to a Role

Use the add and delete rba role commands to configure the role permissions for Virtual Devices.

Syntax

add rba role <name> virtual-system-access <vsid>

delete rba role <name> virtual-system-access <vsid|all>

Parameter	Description
name	Role name as a character string that contains letters, numbers or the underscore (_) character. The role name must with a letter.
vsid	ID of the Virtual Device. Use commas to enter multiple Virtual Devices.
all	Deletes access permissions to all Virtual Devices.

Example

add rba role newRole virtual-system-access 0,2

delete rba role newRole virtual-system-access all

Showing Virtual Devices

Use the virtual-system command to show the Virtual Devices on the VSX Gateway.

Syntax

show virtual-system all

Output

Virtual Systems list VS ID VS NAME 0 VSX_GW 1 VSX_GW1_VSW 2 VS1 3 VS2