User Workspace Management

Accessing the User
Workspace Management Interface

After you have
started the Cisco Modeling Labs server, you can access the User Workspace
Management interface to manage user accounts, projects, licenses, and virtual
machine images on the Cisco Modeling Labs server.

To access the User
Workspace Management interface, complete the following steps:

Step 1

In the Cisco
Modeling Labs server, retrieve the IP address of the VM using the command
ifconfig
eth0.

Step 2

In a web
browser, enter the retrieved IP address or hostname in the format,
http://<IP address |
hostname>/user/login.

Step 3

Log in to the
User Workspace Management interface using the username uwmadmin and the
password password.

The application opens in user mode. To create new users,
projects, and so on, you must be in admin mode.

Step 4

To change to
admin mode, click
Admin under the
Switch Mode section. An overview of the current system-usage statistics for all
the active simulations is displayed.
Figure 1. Current
Usage Statistics

The task bar on
the left enables the following functions:

Projects—Manages resource quota allocations.

Users—Manages user accounts.

Images—Manages virtual machine images on the system.

Flavors—Manages virtual machine flavors on the system.

VM
Control—Allows system administrators to stop specific components of an active
simulation.

Licenses—manages product licenses on the system.

Changing the
Password for the uwmadmin Account

The uwmadmin account
is used to manage server resources and user access. Therefore, to reduce the
risk of unauthorized access, we recommend that you change the default password
for the uwmadmin account to a more secure password on initial login.

Step 1

Login in to the
User Workspace Management interface with username uwmadmin and password
password.

Step 2

Click
Admin under
the
Switch Mode
section to switch to admin mode.

Step 3

Click
Settings and
password.
The
Settings page is displayed.

Figure 2. Settings
Page

Step 4

Click
Change
Password.
The
Change
Password page is displayed.

Step 5

Enter new
password details and click
Confirm to
save the changes.

Managing
Projects

Within the User
Workspace Management interface, a
Project represents a set of resources that are available to each
project. It has the following characteristics:

By default, a project user
account is created for each project.

To add a user as a
standalone user, a project must be assigned to the user. Also, the username
will be the project name.

Additional users can be
assigned to a project, as required.

If a user is added to a
project, the username of the user is prefixed with the project name.

Deleting a user account does
not delete a project that the user is assigned to.

Deleting a project deletes
only the associated default user; nondefault user accounts are not deleted.

Under
General
Settings, add a name and a description for the project. In the
Expires
field, you can either add an expiry date for the project or accept the default,
which is
Never,
meaning the project will never expire. Leave the
Enabled
check box checked, to enable the project for use.

Step 4

Under
Project
Quotas, you can either accept the default values for the system quotas, or
increase or decrease them based on your project requirements:

Instances quota is the
maximum number of virtual machines of any type that can be operational at any
given time within the project per user or for all users associated with that
project.

RAM (MB) is the maximum
RAM that can be consumed by virtual machines running in the project per user or
for all users associated with that project.

VCPUs is the maximum
number of virtual cores consumed by the virtual machines running in the
project.

Step 5

Click
Create.

The Edit User
page appears.

Figure 4. Edit the
Project User

Using this
window, you can add details for the new user created when the project is
created.

Step 6

In the
Password and
Password
again fields, enter a new password for the user.

Note

The default
password can be used, or a more meaningful password can be entered. This
password can also be changed at a later time.

Step 7

In the
Email field,
add a valid email address for the user.
By
default, the user is assigned a member role.

Step 8

In the
Expires
field, you can add an expiry date for the user or accept the default
Never. Leave
the
Enabled
check box selected to enable the project for immediate use. Alternatively, you
can set up a project and users, but cannot enable them to be configured and
available at a later time.

Step 9

Click
Save to save
the changes for the user.

Step 10

(Optional) To
confirm that the project has been added, click
Projects to
view the newly added project, and click
Users to
view the newly added user. Otherwise, logout.

Managing
Users

Within the User
Workspace Management interface, you can manage user accounts, allowing you to
create new users, modify existing user details, and delete users from the
system. User accounts permit access to the Cisco Modeling Cisco Modeling Labs
server from the Cisco Modeling Labs client.

Creating a
User

In the User
Workspace Management interface, under
Admin mode,
click
Users.
The Users
page appears, listing all the default users.

Step 2

Click
Add to
create a new user.

The
Create User
page appears.
Figure 5. Create a User

Step 3

In the
Username
field, enter a username for the new user.

Note

To create
multiple users, click the
Add (+)
icon to the right of the
Username
field.

Step 4

In the
Password and
Password
again fields, enter a password for the new user.

Step 5

In the
Email field,
enter a valid email address for the user.

Step 6

From the
Projects
drop-down list, select the applicable project for the user.

Step 7

From the
Role
drop-down list, select the applicable role for the user.

Note

A user with
administrative rights has administrative rights across the entire system.

Step 8

In the
Expires
field, you can either add an expiry date for the user, or accept the default
Never.

Step 9

Leave the
Enabled
check box checked.

Step 10

Click
Create.

The User
<Project-Name>-<Username> page appears.

This page presents details and project quotas for the user.

Step 11

(Optional)
Select
Modify user
to amend the details for a user, or select
Delete user
to delete a user respectively.

Step 12

Click
Users to
view the newly created user.

Managing Virtual
Machine Images

Within the User
Workspace Management interface, you can add new images, update details for
existing images, or delete images from the system.

Note

A Cisco IOSv
image is automatically installed as part of the installation process.
Additional Cisco virtual images are available for use; however, they must be
installed separately. For the most up-to-date list of virtual images, see the
Release Notes for Cisco Modeling Labs 1.0. As a system
administrator, you must notify the Cisco Modeling Labs client users when new
virtual images become available.

From the
Subtype
drop-down list, select the appropriate subtype for the new image.

Step 4

In the
Name/Version
field, enter a name or version number for the image.

Step 5

In the
Image
Path/URL field, enter a path on the Server/VM, an HTTP, FTP or TFTP URL, or
select a file to upload.

Step 6

To upload an
image from your own device, click
Browse to
navigate to the image file.

Step 7

Leave the
Properties
field blank because by default, appropriate properties are automatically set
based on the selected subtype.

Step 8

Click
Create to
create your virtual machine image.

Note

The creation
process can take a while depending on where the image file is located relative
to the Cisco Modeling Labs server. Both VMDK and QCOW2 image formats are
supported. As part of the creation process for images, a Flavor is also
created, containing information on the CPU and memory allocation for the
virtual machine image.

The Image <Image-Name> page
with details and properties about the virtual machine image appears.

Step 9

Click
Images to
view the newly added image.

Step 10

Under the
Options
column, use the
Modify and
Delete
options to amend the details for the virtual machine or to delete a virtual
machine image. After it is installed, the image is available for users to
select for their topology simulation.

Managing Virtual
Machine Flavors

Within the User
Workspace Management interface, as part of the creation process for virtual
machine images, a virtual machine
flavor is created. Flavors are used to define the CPU, memory
(RAM) allocation, disk space, the number of cores, and so on, for each virtual
image.

From the
RAM
drop-down list, select the amount of memory allocation for the flavor.

Step 5

From the
Virtual CPUs
drop-down list, select the number of virtual CPUs for the flavor.

Step 6

Click
Create to
create your virtual machine flavor.

The
Flavor page appears with the newly created flavor listed.

Step 7

Under the
Options
column, use the
Delete
option to delete a virtual machine flavor.

Using the VM Control
Tool

The VM Control tool is
available to aid system administrators with troubleshooting issues encountered
in the User Workspace Management interface. The tool enables system
administrators to stop specific components of an active session. In
circumstances where components of a session fail to be deleted through the
normal shutdown methods, this tool enables system administrators to remove
blocked components.
Figure 8. VM Control
Tool

VM Control
Nodes

The VM Control Nodes
page lists all the nodes for all the currently running projects for all users.
You can delete a specific node or all the nodes for a specific project or
projects.
Figure 9. VM Control
Nodes Page

Step 1

To delete a
specific node:

In the node
list for the applicable project, select the corresponding check box.

Click
Delete in the
Options column.
The
node is deleted.

Step 2

To delete all
the nodes for a specific project:

In the node
list for the applicable project, select the corresponding check box.

Note

When
you select the
Name check box
for a particular project, the check boxes for all the nodes in the project are
automatically checked. You cannot deselect individual nodes within a project;
either all the nodes are selected, or no nodes are selected.

Click
Delete
Selected.
All
nodes for the particular project are deleted.

VM Control
Networks

The VM Control
Networks page lists all the networks for all the currently running projects for
all the users. You can delete a specific network or all the networks for a
specific project or projects.
Figure 10. VM Control
Networks Page

Step 1

To delete a
specific network:

In the
network list for the applicable project, select the corresponding
Name check box.

Click
Delete in the
Options column.
The
network is deleted.

Step 2

To delete all
the networks for a specific project:

In the
network list for the applicable project, select the corresponding
Namecheck box.

Caution

When you select the
Name check box,
the check boxes for all the networks in the project are automatically checked.
In the
VM
Control Networks page, for each user's project, two networks are listed in
blue with an information icon. These two networks are specifically created for
use by OpenStack. We recommend that you do not delete these networks. Deselect
the check boxes for these two networks before clicking
Delete
Selected.

Click
Delete
Selected.
All
the networks for the particular project are deleted.

VM Control Ports and
Floating IPs

The
VM Control Ports
and Floating IPs page lists all the ports and floating IPs for all the
currently running projects for all the users. You can delete a specific port or
floating IP, or all the ports and floating IPs for a specific project or
projects.
Figure 11. VM Control
Ports and Floating IPs Page

Step 1

To delete a
specific port or floating IP:

In the port
or floating IP list for the applicable project, select the corresponding check
box.

Click
Delete in the
Options column.
The
port or floating IP is deleted.

Step 2

To delete all
the ports or floating IPs for a specific project:

In the port
or floating IP list for the applicable project, select the
Name check box.

Note

When
you select the
Name check box
for a particular project, the check boxes for all the ports or floating IPs in
the project are automatically checked. You can deselect individual ports and
floating IPs within the project, as required.

Click
Delete
Selected.
All
ports or all floating IPs for the particular project are deleted.

Managing Cisco
Modeling Labs Licenses

Within the User
Workspace Management interface, you can manage Cisco Modeling Labs licenses. A
license specifies the options that are enabled for Cisco Modeling Labs.

The
Licenses page provides details on all the licenses
that are currently in use including the license ID, type of license, number of
nodes per license, and the expiry date.
Figure 12. Licenses
Page

Copy and paste
the license key from the
.lic file into the
Licenses
text area.

Step 6

Click
Register.
The
license is applied.

Step 7

Return to the
Licenses page to view the newly registered license.

Stopping Active
Sessions in the User Workspace Management Interface

If you are a system
administrator, you can terminate active sessions from within the User Workspace
Management interface. You can select one or more sessions to terminate,
including sessions started by other users.

If you are a client
user, you can only terminate a session from within the User Workspace
Management interface that you started.

Details on stopping a
single session or stopping all sessions for a particular project are discussed
in the following section:

Stopping an Active
Session

The Overview page
lists all the active sessions for all the currently running projects for all
the users. You can stop a specific session, or all the sessions for a specific
project or projects.
Figure 14. Overview
Page Listing Active Sessions

Step 1

To stop a
specific session:

In the
session list for the applicable project, select the corresponding check box.

Click
Request to stop
selected. The
Stop
sessions page appears.

Enter your
login password, and click
Request stop.

The session
is terminated.

Note

The
status of the terminated session changes from ACTIVE to STOP in the Overview
page. Additionally, the session is no longer visible in the Cisco Modeling Labs
client.

Step 2

To stop all the
sessions for a specific project:

In the
session list for the applicable project, select the
Session check
box.

Note

When
you select the
Session check
box for a particular project, the check boxes for all the nodes in the project
are automatically selected. You can deselect individual sessions within the
project, as required.

Click
Request to stop
selected. The
Stop
all sessions for all users page appears.

Enter your
login password, and click
Request stop.

The sessions
are terminated.

Note

The
status of the terminated sessions change from ACTIVE to STOP in the Overview
page. Additionally, the sessions are no longer visible in the Cisco Modeling
Labs client.