
Creating a Tenant - Once a tenant is configured, create it using the
ux-tenant-create
command as root on
the SMW. To create a tenant named
myTenant
in the configuration:
#
ux-tenant-create myTenant
When this command completes, the tenant VM will be defined and running on the specified host node.
See the
ux-tenant-create
man page for more information on this command.
Stopping and Starting a Tenant
Use the
ux-tenant-stop
and
ux-tenant-start
commands as root on the SMW to start and stop tenant
VMs on Urika-GX.
To stop a running tenant VM named
myTenant
, execute:
#
ux-tenant-stop myTenant
To start that tenant VM execute:
#
ux-tenant-start myTenant
See the
ux-tenant-stop
and
ux-tenant-start
man pages for more information on these commands.
Displaying Tenant Status
Use the
ux-tenant-status
command as root on the SMW to obtain the status of tenant VMs on Urika-GX. To
list the status of all tenants on the system, execute:
#
ux-tenant-status -a
TenantName |PingStatus |SSHStatus |State |LoadAverage |Uptime |Logged In |Management IP |
default |N/A |N/A |notfound |N/A |N/A |None |10.142.150.1 |
cb_tenant_00 |N/A |N/A |notfound |N/A |N/A |None |10.142.166.100 |
cb_tenant_01 |N/A |N/A |notfound |N/A |N/A |None |10.142.166.101 |
cb_tenant_02 |N/A |N/A |notfound |N/A |N/A |None |10.142.166.102 |
cb_tenant_03 |N/A |N/A |notfound |N/A |N/A |None |10.142.166.103 |
The
ux-tenant-status
command can also be used to list the status of a specific tenant or list of tenants. To
list the status of the tenant named
myTenant
in the configuration, execute:
#
ux-tenant-status myTenant
See the
ux-tenant-status
man page for more information on this command.
Removing A Tenant
A tenant VM that is no longer required can be removed by executing the
ux-tenant-remove
command as root
on the SMW. This only removes the tenant VM and its related changes to Urika-GX, it does not remove the tenant
configuration for the tenant VM. Use the
ux-tenant-create
command to recreate a deleted tenant. To remove
a tenant named
myTenant
:
#
ux-tenant-remove myTenant
If the tenant VM is running when the admin attempts to remove it, the removal will fail with an error indicating that
the VM is currently running. In this case, either stop the VM using
ux-tenant-stop
or add the
--force
option
to the
ux-tenant-remove
command as follows:
#
ux-tenant-remove --force myTenant
Security
S3016
194