Creating a Resource Pool¶

Resource limits are enforced through resource pools. Before you can create a resource pool, you must first create a resource pool template. See Creating a Resource Pool Template. Multiple resource pools can be created from the same resource pool template.

If you already know which users should be members of a resource pool, you may add them when you create the resource pool. You can also add users to or remove users from a resource pool after creating it. See Modifying a Resource Pool. In certain situations, such as a classroom training scenario, you may want to create separate resource pools for each user, each with the same resource limits. To bulk create these resource pools, follow the instructions below, setting the toggle to Individual Pool.

If you are using the LDAP authentication method on your system, users are not actually created in the CML instance until the first time that they log in. To ensure that users are immediately placed into a resource pool when they log in, configure the Resource Pool field in the LDAP settings. You may still need to create a resource pool to use in those settings, but see Configuring LDAP Authentication first.

Procedure

Log into the CML UI as a user with administrator privileges.

Click the Tools ‣ System Administration menu item.

On the System Administration page, click Resource Pools.

The Resource Pools page is shown with a table of all resource pools and templates.

Click the Add button.

The Add Pool/Template (Pool) page is shown.

Click the Template dropdown field and select the template that you want to use for this resource pool.

A new Shared Pool toggle is shown.

Set the toggle to either Shared Pool (the default) or Individual Pool.

Use Shared Pool if you want to create a single resource pool.

Use Individual Pool if you want to create a separate resource pool for each user that you select during resource pool creation. This option provides a bulk creation process for resource pools. CML will create a separate pool for each user. The individual resource pools will each have a unique name based on the pool name that you provided and the user’s name: <pool_name>-<user_id>.

In the Pool Name field, enter a name for your new resource pool.

(Optional) Enter a Description for the new resource pool.

(Optional) Set resource limits on node licenses, vCPU cores, memory usages, or external connectors.

If you do not set any resource limits on the resource pool, it will inherit the resource limits defined on its associated template. If you selected the Individual Pool option above, we recommend managing the resource limits at the resource pool template level. For example, if you are creating individual resource pools for all students in a class, setting limits exclusively on the resource pool template means that you can update the resource limits for all of your students at once by changing the settings on that template.

Click the Next button to move to the next step, Add Users. If you want to create a resource pool with no users, skip this step and proceed to the last step below.

If you selected the Individual Pool option above, then you must click Next and select at least one user. Because that setting creates one resource pool for each selected user, if you do not select any users, no resource pools will be created.

If you selected the Shared Pool option above, then you can create the resource pool without adding users to it.

On the Add Users step of the Add Pool page, click the Add button.

The Add Users to Pool dialog is shown.

In the Add Users to Pool dialog, start typing in the Users field to filter the list of users on your system, or simply click the dropdown to show all users on the system. In either case, check the check box next to a user ID to select that user.

The Add Users to Pool dialog will display the list of users whose names you checked.

Click the Add button on the Add Users to Pool dialog.

The Add Users to Pool dialog closes, and the Add Users step of the Add Pool page shows the list of all selected users. If you need to adjust the list of selected users, you can click Add button again. You may also remove users from the list of selected users by clicking Remove in the Actions column for that user.

If you chose Shared Pool above, the selected users will be added to the resource pool when it is created. If you chose Individual pool above, a separate resource pool will be created for each of the selected users when you click the Create button.

If a user whom you add to the resource pool is currently a member of another resource pool, the user will be removed from the other resource pool when they are added to this resource pool. The UI will warn you about this fact and highlight the affected users in the page.

Once you are done selecting users, click the Create button.

The Resource Pools page is shown with a table of all resource pools and templates. Your newly created resource pool or pools are now available in the list.