Extract a security principal half map
You can extract the list of the users and groups in an environment either from an export file or from an LDAP provider.
To extract user and group data from an export file
- In Enterprise Manager, create an export file that contains the security permissions. For an overview of creating an export file, see Checklist: prepare Content Engine data.
- In FileNet Deployment Manager, right-click the environment and click Open.
- On the Overview tab, click the Retrieve Data button for Security Principal Map.
- Select Export Manifest File and click Next.
- In the Select Manifest File field, enter the fully qualified name of the export manifest file from which the users and group data is to be extracted.
- If you specified a folder for content when you created the export file:
- Select the External Content option.
- In the Select External Content Folder field, enter the fully qualified name of the folder that contains exported content.
If you did not specify a content folder, proceed to the next step.
- If you are updating an existing security principal half map, select one of the following options:
- Merge: Adds new users and groups to the map. Updates existing users and groups with any changes. This option does not delete any users or groups from the map.
- Overwrite: Replaces the contents of the map with the new data.
- Click Finish.
To extract users and group data from an LDAP provider
- In FileNet Deployment Manager, right-click the environment and click Open.
- On the Overview tab, click the Retrieve Data button for Security Principal Map.
- Select From P8 Content Engine's LDAP Provider and click Next.
- Click Retrieve Realms.
- Select the filter to be applied in retrieving the users and groups:
- None: Retrieve data for all users and groups from the LDAP provider. Proceed to step 8.
- Use Environment's Principal Half Map: Retrieve data for only those users and groups identified for a specified environment. Proceed to step 6.
- Use a Label File: Retrieve data for only those users and groups identified in a specified file. Proceed to step 7.
- If you selected Use Environment's Principal Half Map in step 5, select the environment from the Select Environment to Use for Principal Half Map list.
- If you selected Use a Label File in step 5, type the fully qualified name of the file in the Select Flat File to Use field.
NOTE This file must be a text file containing the short name and a label for each user or group to be retrieved. Enter the values for each user and group on a separate line and use a comma to separate the short name and label as follows:
suser, systemuser
CEAdmin, administrator
- Select one of the following options:
- Merge: Append data for any new users and groups to the map and updates data as needed for existing users and groups. This option does not delete any users or groups from the map.
- Overwrite: Replaces the contents of the map with new data.
- Click Finish.