Use the qptool changemember
command to change the name of a local user member, external user member, or external group member in specified places. For example, if you have changed the name of an external user in the user directory, use qptool changemember
to make the change in the places to which the user belongs.
The changemember command changes a single user or group name. If you need to change a large number of user or group names, see Renaming of users and groups
The original name is referred to as the source name and the name to which you change, the target name.
Using qptool changemember
, you can do the following tasks:
- Change a user or group name to a new name -- for example, change the name of a user who recently married, so the user can continue to access a place using the new name. In this case, the target name is a new name.
- Change the name of a user or group to the name of another existing user or group -- for example, change the name of a user who leaves the company to the name of a remaining user who assumes the original user's responsibilities. The access the target name has to places is the higher level of access between the source and target names. For example, if the source name is a manager of a place and the target name is a reader of the place, the target name becomes a manager of the place and has access to all pages previously accessible to the source and target names. The same access control principle applies to room access.
- Change the name of a local user to the name of an external user in a user directory -- for example, to move from a pilot deployment that uses local users to a production deployment that uses a corporate directory.
You can make these combinations of name changes:
- Local user name to local user name
- Local user name to external user name
- External user name to external user name
- External group name to external group name
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 the external user's name changes in the user directory, you use the changemember command to change the user's name in a place, so that the name is changed in these security fields and the user's access to the place continues.
You cannot make these combinations of name changes:
- External user name to local user name
- External group name to local user name
- External group name to external user name
- Local user name to external group name
- External user name to external group name
Enter the following command at the server console to rename members in places:
load qptool changemember arguments
are described in Table 1 .
Specify names exactly, remembering to include any spaces and to use the exact character case. If a name contains spaces, put quotation marks (") around it.
Table 1. Arguments for the qptool changemember command
|-?||Prints help on the command.|
|-sourcedn name ||Specifies the distinguished name of an external user or group member as it currently appears in places, for example, "cn=Connor Jones, ou=Sales,o=Acme."|
|-sourceu name ||Specifies the current name of a local user member, for example, "Joe Smith." |
|-sourceg||Indicates that the specified source name is that of an external group.|
|-targetdn name ||Specifies the new distinguished name of an external user or group member. for example: "cn=Representatives,ou=Sales,o=Acme"|
Note: IBM® Lotus® Quickr™ does not look up the target name in the user directory to verify it, so be sure that the name is valid.
|-targetu name ||Specifies the new name of a local user, for example, "Joe Smith."|
|-targetg ||Indicates that the specified target name is that of an external group.|
|-p place(s) ||Specifies a place or a space-separated list of places in which to rename the user or group.|
|-i inputfilename ||XML input file located in the server program directory that specifies the places in which to rename the user or group.|
|-o outputfilename ||XML output file that logs the results of the command. By default the command logs results to qptool.changemember.xml in the server program directory.|
Table 2 provides examples of using the qptool changemember command.
Table 2. Examples of qptool changemember
|Change the name of local user name to an external user name.|
load qptool changemember -p PlaceName -sourceu localuser -targetdn "CN=ExternalUser,O=[Organization]"
|Change an external user name to an external user name.|
load qptool changemember -p PlaceName -sourcedn "CN=External User,O=[Organization]" -targetdn "CN=New External User,O=[Organization]"
|Change an external group name in multiple places.|
load qptool changemember -p PlaceName1 PlaceName2 -sourceg -sourcedn "CN=External Group,O=[Organization]" -targetg -targetdn "CN=New External Group,O=[Organization]"
You also can rely on adminP
to change member names if you have enabled it. Refer to Enabling AdminP to work on the Lotus Quickr server
Parent topic: Managing place membership: qd85