ViPR Controller Understanding Projects and Consistency Groups

Table of Contents

Projects and consistency groups

ViPR Controller enables resources to be grouped into projects and for related resources to be managed as part of a consistency group. This article describes the basic concepts underlying the use of projects and consistency groups and shows you how they can be created when working with the ViPR Controller UI.

Back to Top


Projects enable storage resources (block volumes, file systems and objects) provisioned using ViPR Controller to be grouped logically, and for authorization to perform operations on resources to be based on project membership. All provisioned resources are owned by a project.

For an end-user to be able to use a storage provisioning service, the user must belong to the project that will own the provisioned resource.

At the UI, Tenant Administrators and Project Administrators are responsible for creating projects, using an access control list (ACL) to assign users to projects, and assigning permissions to projects. Projects also have the concept of a Project Owner, which conveys certain administrator rights to a user, and enables a Tenant Administrator to delegate administrator rights for a project to a Project Administrator.

The roles associated with a project and the privileges associated with those roles are listed in the table below.

Projects can have an associated quota which can be used to limit the total amount of provisioned storage that belongs to the project.

The Tenant Settings > Projects page is accessible to Tenant Administrators and Project Administrators and displays the projects that they can perform administration on. For a Tenant Administrator this is a list of all projects in the tenant. For a Project Administrator this list contains the projects that the Project Administrator has created or has been assigned ownership of.

For provisioning end-users, the Tenant Settings > Projects page is NOT accessible. However, provisioning end-users MUST be assigned to at least 1 project by a Tenant or Project Administrator in order to be able to perform any provisioning operations, as all provisioned resources must belong to a project. Similarly, end-users can only view resources associated with projects to which they are assigned.

The use of ACLs with projects is described in Understanding ViPR Controller Users, Roles, and ACLs, which is available from the ViPR Controller Product Documentation Index.

Back to Top

Create or edit a project

Projects can be created and edited from the ViPR Controller UI at the Tenant Settings > Projectspage.

Before you begin

  • You must be either a Tenant Administrator or a Project Administrator to be allowed to create projects.
  • Projects created by a Tenant Administrator can only be administrated by a Project Administrator if the Project Administrator is the project owner.
  • Projects created by a Project Administrator are visible to, and can be administrated by, a Tenant Administrator.


  1. Select Tenant Settings > Projects.
  2. Select Add, to create a new project, or click the project name to edit the project.
  3. Enter the name of the project.
  4. In the Owner field, enter the name of the project owner.
    This is the AD/LDAP name of the user. If you do not enter a name, you will be the project owner.
    The project owner should be a Project Administrator. This provides a way of allowing a project created by a Tenant Administrator to be delegated to a Project Administrator.
    If you are a Tenant Administrator, projects that you own cannot be administrated by Project Administrator unless you make them the owner.
    If you assign project ownership to a provisioning user, the user will not be able to perform administration at the UI.
  5. You can associate a quota with the project to limit the amount of storage provision for the project.
    1. Check the Enable Quota box
    2. In the Quota field, enter the maximum amount of storage that you want to allow.
  6. To assign project permissions to other users, select Add ACL.
    An ACL field is displayed allowing you enter a user or group name and assign a permission.
  7. Enter the name of a user or group and set the Type field to be consistent.
  8. Select the access permission for the user as either ALL or BACKUP.
    ALL permission allows users to provision resources that belong to a project and to run services against resources owned by a project. BACKUP allows a user to view the resources belonging to a project and perform data protection operations.
  9. To add more users or groups, select Add ACL again.
    You can remove an ACL entry by clicking Remove.
  10. When you have added all ACL entries, click Save.
Back to Top

Consistency groups

Volumes can be assigned to consistency groups to ensure that snapshots of all volumes in the group are taken at the same point in time.

The Tenant Settings > Consistency Groups page lists the consistency groups that exist and enables consistency groups to be added or deleted.

Consistency groups are associated with projects, so provisioning users will only be allowed to assign volumes to consistency groups that belong to the same project as the volume.

To use consistency groups, the virtual pool associated with a volume must be configured for multi-volume consistency. Once a virtual pool has multi-volume consistency assigned, volumes created from that pool must always be associated with a consistency group.

Volumes in a consistency group must be treated as group. Once a snapshot of a consistency group is created, ViPR Controller will not allow any more volumes to be added to the consistency group. If a user deletes a single volume from the consistency group, ViPR Controller will first delete all the snapshots on the consistency group and then delete the specified volume.

Volumes associated with a consistency group must all belong to the same physical array. Hence, once a volume has been assigned to a consistency group, only volumes belonging to the same array can be added to the consistency group.

Back to Top

Add a consistency group

Consistency groups can be created and volumes assigned to them during provisioning operations.

Before you begin

  • This operation can be performed by a Tenant Administrator for any project or by a Project Administrator for owned projects.

  • You must know which project you intend to associate the consistency group with.


  1. Select Tenant Settings > Consistency Groups.
  2. If you are the administrator for more than one tenant, select the tenant for which you want to assign the consistency group.
  3. From the Project drop-down, select the project that the consistency group will be associated with.
  4. Select Add.
  5. Enter a name for the consistency group.
  6. Select Save.
Back to Top