Chapter 6. Workspaces Use workspaces to select specific systems and group them together. You can view and manage the individual workspaces and the system membership of each group. In addition, you can filter your system lists across applications by workspaces. You can also manage user access to specific workspaces to enhance security. Workspaces have the following characteristics: Workspaces are only for systems. You cannot add workspaces as children of another workspace. Each system can belong to only one workspace. Using workspaces is not mandatory; systems that are not assigned to specific workspaces can remain unassigned. Additional resources For more information about user access, refer to User Access Guide for Role-based Access Control (RBAC) . For more information about user access to workspaces, refer to User access for RBAC in system inventory . 6.1. Creating Workspaces Prerequisites You must be an Organization administrator (member of the Default administrator access group) or have the Workspace administrator role. Procedure On the Red Hat Hybrid Cloud Console, navigate to Inventory . Click the Inventory drop-down menu and select Workspaces . Click Create workspace . The Create workspace dialog box displays. Type a name for the workspace in the Workspace name field. Names can consist of lowercase letters, numbers, spaces, hyphens (-), and underscores (_). Click Create . A Workspace created message displays, and the new workspace appears in the list of workspaces. 6.2. Adding systems to a newly created workspace Note Each system can belong to only one workspace. In the current release of Workspaces, a system cannot be reassigned to a different workspace in a single step. You must first remove the system from its current workspace, and then assign it to a new workspace. Prerequisites Organization Administrator access to Insights for Red Hat Enterprise Linux, or Workspaces administrator permissions to the group, or both inventory:groups:write and inventory:groups:read permissions to the group Procedure On the Red Hat Hybrid Cloud Console, navigate to Inventory . Select Workspaces . Click the name of the group to which you want to add systems. A page for Workspaces displays with the name of the workspace and two tabs, Systems and Group Details . On the Systems tab, click Add systems . The Add systems dialog box displays and shows the systems available for you to view in inventory. Select the systems you want to add to the workspace. Note If you select a system that already belongs to another workspace, a warning message displays: One or more of the selected systems already belong to a workspace. Make sure that all the systems you have selected are ungrouped, or you will not be able to proceed. When you have finished selecting systems, click Add systems . The Workspaces page displays and includes the systems you added to the workspace. 6.2.1. Adding a system and creating a workspace from the Inventory systems page Prerequisites Organization administrator access to Insights for Red Hat Enterprise Linux, or Workspace administrator permissions to the group, or both inventory:groups:write and inventory:groups:read permissions to the group Procedure On the Red Hat Hybrid Cloud Console, navigate to Inventory . The list of systems in your inventory appears. Locate the system that you want to add. Click the More options icon (...) on the far right side of the system listing. Select Add to workspace from the pop-up menu. The Add to workspace dialog box displays. Click Create a new workspace . The Create workspace dialog box displays. Type a name for the new group in the Name field and click Create . The Inventory page appears and displays a status (success or failure) message. 6.3. Removing systems from the workspace You can remove systems from the workspace from two pages in the Red Hat Hybrid Cloud Console: the Workspaces page and the Systems page. 6.3.1. Removing systems from the workspace using the Workspaces page Prerequisites You must be an Organization administrator (member of the Default admin access group), or have the Workspace administrator role, or have the inventory:group:write permissions for that particular workspace. Procedure On the Red Hat Hybrid Cloud Console, navigate to Inventory . Click the Inventory drop-down menu and select Workspaces . The Workspaces page displays. Select the workspace that contains the systems that you want to remove. Locate the system that you want to remove from the workspace. Click the More options icon (...) on the far right side of the system listing. Select Remove from workspace from the pop-up menu. The Remove from workspace? dialog box displays. Optional: To remove multiple systems from the workspace at once, select each system you want to remove, and then select Remove from workspace from the More options menu (the options icon (...)) in the toolbar. Click Remove . The Workspace page displays and shows the updated workspace with a status (success or failure) message. 6.3.2. Removing systems from the workspace using the Systems page Prerequisites Organization administrator access to Insights for Red Hat Enterprise Linux, or Workspace administrator permissions to the workspace, or both inventory:groups:write and inventory:groups:read permissions to the workspace Procedure On the Red Hat Hybrid Cloud Console, navigate to Inventory . Click the Inventory drop-down menu and select Systems . The Systems page displays. Locate the system that you want to remove from the workspace. Click the More options icon (...) on the far right side of the system listing. Select Remove from workspace from the pop-up menu. The Remove from workspace? dialog box displays. Note If any of the systems you selected do not belong to any workspace, the Remove from workspace option remains disabled. Make sure that you select only systems that belong to the workspace. Optional: To remove multiple systems from the workspace, select each system you want to remove, and then select Remove from workspace from the More options (the options icon (...)) menu. Click Remove . The Systems page displays and shows a status (success or failure) message. 6.4. Renaming the workspace Prerequisites You must be an Organization administrator (member of the Default Administrator access group), or have the Workspace administrator role, or have the inventory:group:write permissions for that particular workspace. Procedure On the Red Hat Hybrid Cloud Console, navigate to Inventory . Click the Inventory drop-down menu and select Workspaces . The Workspaces page displays. Click the Workspace actions drop-down menu in the upper right corner of the Workspaces page. Select Rename from the drop-down menu. The Rename workspace dialog box displays. Type the new name into the Name field, and click Save . The Workspaces page shows the renamed workspace in the list of workspaces. 6.5. Deleting the workspace Note Before you delete a workspace, make sure that the workspace does not contain any systems. You can only delete empty workspaces. If you attempt to delete a workspace that still contains systems, Insights returns a warning message. Prerequisites You must be an Organization administrator (member of the Default admin access group), or have the Workspace administrator role, or have the inventory:group:write permissions for that particular workspace. Procedure On the Red Hat Hybrid Cloud Console, navigate to Inventory . Click the Inventory drop-down menu and select Workspaces . The Workspaces page displays. Click the options icon (...) on the far right side of the listing for the group you want to delete. Select Delete from the pop-up menu. The Delete workspace dialog box displays. Select the checkbox to acknowledge that the delete operation cannot be undone. Click Delete . The Workspaces page shows an updated list of Workspaces and a status (success or failure) message. Note You can also delete the workspace from within the page for the workspace itself. Navigate to the Workspace and click the Actions drop-down menu, and then select Delete .

Commands: