7 Managing Users and Groups

This Chapter describes how to manage users and groups as an Administrator. It includes the following sections:

• The Default Account

• Managing Users

• Managing Groups

• Viewing Logs

Note:

• Functions described in this Chapter are only available to Administrators.

• A small mistake made by an Administrator may cause serious damage to the entire Oracle VM Manager environment. Please minimize the number of administrators when creating the accounts.

7.1 The Default Account

Oracle VM Manager provides a default account. The default user name is admin (lowercase). The password is set when you install Oracle VM Manager.

7.2 Managing Users

You can create new users, delete obsolete users, change the users' role, and reset the user password. This section includes the following topics:

• Creating a User

• Viewing Details

• Editing a User

• Changing a Role

• Deleting a User

To search for a user, click Show Search and enter the search criteria.

7.2.1 Creating a User

To create a user:

1. On the Administration page, click the User tab and then click the Create button.

2. Enter the following user information:

   • Username: An account name for the user. You cannot use manager, or user as the user name.

     An account name must consist of alphanumeric characters, and must not contain spaces or special characters, except the underscore (_) and hyphen (-) characters. The maximum name length is 100 characters.

   • Password: The password used by the user to log in to Oracle VM Manager.

   • Retype Password: The user password.

   • First Name: The first name of the user.

   • Last Name: The last name of the user.

   • Email: The user's e-mail address. If the user forgets the password, a new password is sent to this e-mail.

   • Status: Select the account status. It can be Locked or Unlocked. The account is available only when the status is Unlocked. To lock this account, select Locked.

   • Role: Grant the user one of the three roles: User, Manager, or Administrator. For more information about the roles, refer to Section 1.5, "Roles in Oracle VM Manager".

3. Select server pools for the user.

4. Select groups for the user. One user may join multiple groups.

5. Click Confirm.

The user is created.

7.2.2 Viewing Details

To view a user's detailed information:

1. On the Administration page, click the User tab.

2. Click the Show link in the User table to view the server pool(s) the user is allowed to use, and the groups to which the user belongs.

   Figure 7-1 Details of a User

   
   Description of "Figure 7-1 Details of a User"
   
   

7.2.3 Editing a User

Edit the user information when you want to:

• Change the user information, such as e-mail address.

• Change the account status to either lock or unlock the account.

• Change the role.

• Add the user to some groups, or server pools.

• Remove the user from some groups, or server pools.

To edit a user:

1. On the Administration page, search and select the user you want to edit, and click the Edit button.

2. On the Edit page you can update the user information, change the user's role, add the user to groups or server pools, or remove the user from groups or server pools.

   The account status can be Locked or Unlocked. By default, the status is Unlocked. If you lock an account, the user cannot use it any more.

3. Click Apply.

7.2.4 Changing a Role

When a user's role has changed, for example, a common user is assigned as an Administrator, you need to change the user's role in Oracle VM Manager.

For more information about roles, refer to Section 1.5, "Roles in Oracle VM Manager".

To change the user role:

1. On the Administration page, select the target user, and click the Edit button.

2. Select the role accordingly, and then click the Apply button.

7.2.5 Deleting a User

To delete a user:

1. On the Administration page, search and then select the users you want to delete. Click the Delete button.

2. Confirm the users you want to delete.

7.3 Managing Groups

There are many users in the Oracle VM Manager system, and it is time-consuming to assign privileges individually to each user. The group function enables you to add some specific users to a group. After you assign some privileges to the group, all members of this group will have the group privileges. This will facilitate the job for administrators.

This section includes the following topics:

• Default Groups

• Creating a Group

• Adding a User to a Group

• Editing a Group

• Deleting a Group

To search for a group, click Show Search and enter the search criteria.

7.3.1 Default Groups

There are two default groups: Public Group and My Workspace.

• The Public Group contains all public virtual machines. All users can deploy and view virtual machines in the Public Group.

• The My Workspace group only contains private virtual machines. Only the virtual machine owner can manage virtual machines in My Workspace.

7.3.2 Creating a Group

When there are a large number of users, you can combine specific users into a group, or groups. For example, you can combine users who belong to the same server pool into one group.

To create a group:

1. On the Administration page, click the Group tab.

2. Click the Create button, enter the group name and description.

3. Select users for the group. Double-click the user name in the Available Users column to add it to the Selected Users column.

4. Click Confirm.

7.3.3 Adding a User to a Group

To add a user to a new group:

1. On the Administration page, click the User tab.

2. Search and select the user you want to add to the group, and click Edit.

3. In the Group area, double-click the group in the Available Groups column to move it to the Selected Groups column.

4. Check the Group section. Make sure the group you have selected shows up in the Selected Groups column.

5. Click Apply.

7.3.4 Editing a Group

To edit a group, select the group you want to update, and click the Edit button to update the group information. You can also add users to the group, or remove users from the group.

7.3.5 Deleting a Group

To delete a group:

1. On the Administration page, select the group you want to delete, and click the Delete button.

2. Confirm the group you want to delete.

After you delete a group, all users in this group will still remain in the system. If you want to delete users along with the group, see Section 7.2.5, "Deleting a User".

7.4 Viewing Logs

You can view all Oracle VM Manager logs at once, rather than going to the log pages for each object (such as virtual machine or server pool). The log includes message logs for:

• Virtual machines

• Resources such as virtual machine templates and ISO files

• Oracle VM Servers

• Server pools

• Administration tasks

To view the logs, go to the Administration page and click the Log tab. The log information includes:

• The time the message was generated.

• The log level of the message:

  • INFO denotes a normal operational message and is informational only.

  • WARNING denotes a more serious message that may require your attention to resolve.

  • ERROR denotes an error occurred.

• The username that initiated the process that generated the log.

• The target type, such as a virtual machine or server pool.

• The target name, such as the virtual machine or server pool name.

• The operation that generated the message.

• The message.

You can select the refresh rate for the log results using the Refresh in field. Logs can be refreshed manually, or every 10 or 30 seconds.

To search for a log, click Show Search and enter the search criteria.