Defining Principal Bundles
Principal bundles are containers that you can use to migrate domains, users, and groups from one TDV site to another.
Creating a Principal Bundle
A principal bundle contains a collection of domains, groups, or users (that is, principals) that you can migrate to another TDV as a unit when you execute a deployment. You can create a principal bundle and then add domains, groups and users to the principal bundle. Because a single deployment plan can contain multiple principal bundles, you can organize principals (domains, groups, and users) into multiple principal bundles to suit your needs.
When you add a group to a bundle, you are adding the definition of that group but not the users it contains. You must include the group and the group’s users in the same principal bundle.
Note: The domains, users, and groups that are defined for TDV by default for the composite domain do not appear as available principals in Deployment Manager. These include the composite and admin domains, the admin and all groups, and the admin, anonymous, monitor, nobody, and system users. Only domains, users, and groups that have been added to a TDV instance appear under Available Principals.
To create a principal bundle
1. Click SITES.
2. Select a site.
3. Select the Principal Bundles tab.
4. Under Bundle Definitions, click the + symbol to add a principal bundle.
5. Type a name for your new bundle. Optionally, enter a description of the bundle contents in the Annotation field.
6. Click Add Bundle.
You should see your newly added bundle in the Bundle Definitions column.
Deploying Privileges
To deploy privileges, the principal bundle must have a principal mapping. Setting a value for the principal bundle filter is also recommended.
Adding Principals to a Bundle
To add principals to a bundle
1. Open the Principal Bundles tab.
2. If necessary, under Available Principals, click Refresh to make sure the principals list is up-to-date.
3. Select and drag the domain, group, and user principals from Available Principals to the bundle.
The Available Principals column contains all principals in the site that can be added to the principal bundles. To add principals to a bundle:
You can... | Description |
Select and drag a container | All of the objects beneath it are moved to the bundle. |
Select and drag a specific principal | Only the principal is moved to the bundle. |
Select an available principal or container | Click Add Principle to..., then choose the bundle to which you want to add the principals. |
Note: When adding a group, be sure to also explicitly add the group’s users to the bundle.
Deployment Manager displays principals in each bundle and bundle container.
4. Optionally, drill into the bundles and their containers to view the resources, rename the bundles or their annotations, or delete bundles or containers to customize the bundles for your deployment.
Viewing the Details of a Principal Resource
All of the objects displayed for available principals and principal bundles have properties that can be viewed and in some cases, edited.
To view details of the available and principal resources
1. Click SITES.
2. Select a site.
3. Select the Principal Bundles tab.
4. Select any object under Available Principals or Bundle Definitions.
5. Under Property View, review the details in the fields for the selected item. The properties vary depending on the object type selected:
Principal Properties | Principal Bundle Properties |
Name Path Type (DOMAIN, GROUP, or USER) | Name (editable) Annotation (editable) Original Creation Date Owner Last Modified Date Last Modified User |
6. Optionally, edit the Name or Annotation for bundles.
Copying a Principal Bundle
You can create a duplicate principal bundle that you can use as a starting point for another bundle, for example.
To copy a principal bundle
1. Click SITES.
2. Select a site.
3. Select the Principal Bundles tab.
4. Under Bundle Definitions, select a bundle.
5. Click the Copy Bundle button.
Deployment Manager creates a duplicate bundle and appends “_copy” to the bundle name.
6. Optionally, under Property View, rename the bundle.
Removing a Principal from a Principal Bundle
You can remove a principal container and its resources or a principal in a bundle using the steps below. The principals are still listed under Available Principals.
To remove a principal in a principal bundle
1. Click SITES.
2. Select a site.
3. Select the Principal Bundles tab.
4. Under Bundle Definitions, select a container or a principal in a principal bundle.
5. Click Remove.
Deleting a Principal Bundle
To delete a principal bundle
1. Click SITES.
2. Select a site.
3. Select the Principal Bundles tab.
4. Under Bundle Definitions, select a principal bundle.
5. Click the Delete Bundle button.
6. Click Yes to confirm that you want to delete this bundle.
