You can use the qptool changehierarchy
command to change the hierarchy of external user and group member names in places. For example, if your company name changes, and as a result you change the name hierarchy in the user directory, use qptool changehierarchy
to change the names in places.
About this task
Or if you create a new group with a new hierarchy in your external directory to encompass what was previously two groups, you can change the names of the original group members in places to the name of the new group.
The changehierarchy command does not operate on local users.
If an external user accesses a place through membership in an external group, the user's name is not listed as a member in the place's Contacts1.nsf database, but is included in security fields within the place. For example, if the user creates a page, the user's name is listed in the page's h_Authors field. If you use the changehierarchy command and the name hierarchy you are changing applies to the user's name in a place, the user's name is changed in these security fields and the user's access to the place continues.
Flat Domino® groups are unsupported and will lead to group expansion issues and product limitations. Also, users who are members of external groups cannot take a place offline.
To change the hierarchy of names in places, enter the following command at the server console:
load qptool changehierarchy arguments
are described in Table 1
Specify the name hierarchy exactly, remembering to include any spaces and to use the exact character case that is used in the directory. If a name hierarchy contains spaces, put quotation marks (") around it.
Table 1. Arguments for the qptool changehierarchy command
|-?||Prints help on the command.|
|-sourceh hierarchy ||Specifies the original name hierarchy to change, for example, OU=people,O=group|
|-targeth hierarchy ||Specifies the new name hierarchy, for example, OU=people2,O=group. The name hierarchy you specify should correspond to a valid name hierarchy in the external directory.|
|-a||Changes the hierarchy of member names in all places that have member names with the original name hierarchy. |
|-p place(s) ||Changes the hierarchy of member names in a place or space-separated list of places.|
|-i inputfilename ||Changes the hierarchy of member names in places specified in an XML input file located in the server program directory.|
|-o outputfilename ||XML output file that logs the results of the command. By default the command logs results to qptool.changehierarchy.xml in the server program directory.|
Table 2 provides examples of qptool changehierarchy
Table 2. Examples of qptool changehierarchy
|Change the names of users and groups within the hierarchy OU=boston,O=acme to the hierarchy OU=detroit,O=acme in the place P1|
load qptool changehierarchy -sourceh OU=boston,O=acme -targeth OU=detroit,O=acme -p P1
|Changes the names of users and groups with the hierarchy OU=boston,O=acme to the hierarchy OU=detroit,O=acme in all places|
load qptool changehierarchy -sourceh OU=boston,O=acme -targeth OU=detroit,O=acme -a
You also can rely on adminP
to change the hierarchy of member names if you have enabled it. Refer to Enabling AdminP to work on the Lotus Quickr server
Parent topic: Managing place membership