Cisco Unified MeetingPlace, Release 7.0 -- How to Configure Cisco Unified MeetingPlace for Directory Service
From DocWiki
Main page: Cisco Unified MeetingPlace, Release 7.0
Up one level: Configuration
Saving and Then Clearing the User and Meeting Data on One Application Server
Perform this task only if the following are true:
- You have two Cisco Unified MeetingPlace sites.
- Both Application Servers contain user or meeting data that you want to keep.
- Database replication is not already in use.
Before You Begin
- On both Application Servers, perform an L0 backup. See Backing Up Data Using the CLI.
- Designate one site as "Site 1," and complete the following procedure on the Application Server in "Site 2."
Procedure
- In the Administration Center, complete the following tasks:
- Log in to the CLI as the root user.
- Save user and meeting recordings by entering the following:
- cd /mpx-record
- tar cvf user-recordings.tar $MP_HOME/afs/custom/userprofile
- tar cvf conf-recordings.tar /mpx-record/conf
- Enter the cleardb command to delete user profiles, user groups, meetings, and recordings from the database.
Related Topics
What To Do Next
Proceed to Configuring User Database Replication for Two Sites.
Configuring User Database Replication for Two Sites
Perform this task only if you have two Cisco Unified MeetingPlace sites. User database replication enables the two sites to have synchronized user profiles and user groups.
Note: In this document, a "site" refers to a complete Cisco Unified MeetingPlace system installation, which includes one active Application Server, one active Media Server, and one or more Web Servers.
Before You Begin
- Time must be synchronized between the Application Servers. See How to Immediately Synchronize with the NTP Server.
- Make sure that each Application Server has only one IP address. Remove any other IP addresses by using the net command.
- Configure the Domain Name System (DNS) server for forward and reverse DNS lookup of the hostname-IP address pair for each Application Server. Verify by running the nslookup hostname and nslookup ip-address commands.
- For this task, the Application Server that contains valuable data is in "Site 1."
- If both Application Servers contain user or meeting data that you want to keep, designate one site as "Site 1," and complete Saving and Then Clearing the User and Meeting Data on One Application Server on the Application Server in "Site 2."
- If you do not have a recent backup, run a complete L0 database backup on the Application Server that contains valuable data by completing one of the following tasks:
Restrictions
User database replication for two sites is not supported with Application Server Failover.
Procedure
- Log in to the CLI of the Application Server in Site 2.
- Enter su to get root privileges.
- Enter the following command using the hostname of the Application Server in Site 1:
- mp_replication init -s 2 -n 1 -r hostname-site1 -m
- Log in to the CLI of the Application Server in Site 1.
- Enter su to get root privileges.
- Enter the following commands using the hostname of the Application Server in the specified site:
- mp_replication init -s 1 -n 1 -r hostname-site2 -m
- mp_replication switchON -r hostname-site2 -S -F hostname-site1
- These commands initiate the initial synchronization between the two sites and establishes database replication between the two sites to keep the data synchronized.
Related Topics
What to Do Next
If you need to restore user and meeting data from the second Application Server, proceed to Restoring User and Meeting Data on Application Servers.
If you are configuring RSNA without Directory Service, return to How to Configure User Profiles for RSNA.
Otherwise, proceed to How to Configure User Profiles for Directory Service Users.
Restoring User and Meeting Data on Application Servers
Perform this task only if you have two Cisco Unified MeetingPlace sites.
Before You Begin
- Find the files that you exported in Saving and Then Clearing the User and Meeting Data on One Application Server.
- Perform the following procedure on only one Application Server.
Procedure
- In the Administration Center, complete the following tasks:
- Log in to the CLI as the mpxadmin user.
- Restore user and meeting recordings by entering the following:
- cd /mpx-record
- tar xvf user-recordings.tar
- tar xvf conf-recordings.tar
Related Topics
What To Do Next
If you are configuring RSNA without Directory Service, return to How to Configure User Profiles for RSNA.
Otherwise, proceed to How to Configure User Profiles for Directory Service Users.
How to Configure User Profiles for Directory Service Users
Use these tasks to specify how the system configures certain user profile settings during Directory Service user profile imports from Cisco Unified Communications Manager and during Directory Service user profile updates.
Note: To understand how all user profile fields are configured by Directory Service imports and updates, see Directory Service User Profile Configuration.
Assigning User Groups for Directory Service Users
By default, the system assigns imported Directory Service users to the System User Group.
Before You Begin
If you have multiple Application Servers for multiple sites or for Application Server Failover, perform this task on only one active Application Server.
Procedure
- Log in to the Cisco Unified MeetingPlace Administration Center.
- Click User Configuration > Directory Service > Directory Service Configuration.
- (Release 7.0.2 or later release only) Configure the User groups for imported users field:
- Use filters -- At first import and at each Directory Service user update, the system applies the user group filters, which assign the user group based on the department number of each imported user.
- Manually set (initially to System) -- The first time each Directory Service user is imported, the user is assigned to the preconfigured System User Group. You can then manually modify the Group name user profile field, the value of which is not overwritten during future Directory Service user updates.
- (Release 7.0.1 only) Configure the Manually set user group for imported users (assign to System group initially) field:
- Checked -- The first time each Directory Service user is imported, the user is assigned to the preconfigured System User Group. You can then manually modify the Group name user profile field, the value of which is not overwritten during future Directory Service user updates.
- Unchecked -- At first import and at each Directory Service user update, the system applies the user group filters, which assign the user group based on the department number of each imported user.
- Click Save.
Related Topics
What To Do Next
Proceed to Configuring Directory Service Filters for User Groups if you did one of the following:
- (Release 7.0.2 or later release) You set the User groups for imported users field to Use filters.
- (Release 7.0.1) You unchecked the Manually set user group for imported users (assign to System group initially) field.
Otherwise, proceed to Assigning Time Zones to Directory Service Users.
Configuring Directory Service Filters for User Groups
Use this procedure to configure filters that assign users to specified user groups based on the Department field in Cisco Unified Communications Manager.
Before You Begin
- If you have multiple Application Servers for multiple sites or for Application Server Failover, perform this task on only one active Application Server.
- Configure the system to use Directory Service filters to assign user groups. See Assigning User Groups for Directory Service Users.
- Configure user groups. See Configuring User Profiles and User Groups for Cisco Unified MeetingPlace.
- Obtain the department numbers for the users. See Viewing the Department Number for Users in Cisco Unified Communications Manager.
Restrictions
If you modify existing Directory Service filters for user groups, only the following are affected:
- Subsequently imported Directory Service user profiles that did not already exist in Cisco Unified MeetingPlace.
- Subsequently updated Directory Service user profiles whose user accounts were modified in the LDAP directory or Cisco Unified Communications Manager.
To apply modified user group filters to Directory Service users that have already been imported to Cisco Unified MeetingPlace, see Modifying Directory Service Filters and Applying the Filters to Previously Imported Directory Service User Profiles.
Procedure
- Log in to the Cisco Unified MeetingPlace Administration Center.
- Click User Configuration > Directory Service > Directory Service Filters for Groups.
- Click Add New or Edit.
- Configure the fields described in Table: Field Reference: Add Group Filter Page and Edit Group Filter Page.
Table: Field Reference: Add Group Filter Page and Edit Group Filter Page
| Field | Description |
|---|---|
|
Department number |
The system applies this filter when this field matches the department number of the imported user. |
|
Group |
User group to assign to imported user profiles which match the Department number. |
5. Click Save.
Related Topics
What To Do Next
Proceed to Assigning Time Zones to Directory Service Users.
Assigning Time Zones to Directory Service Users
By default, the system assigns the local time of the Application Server to Directory Service users.
Before You Begin
If you have multiple Application Servers for multiple sites or for Application Server Failover, perform this task on only one active Application Server.
Procedure
- Log in to the Cisco Unified MeetingPlace Administration Center.
- Click User Configuration > Directory Service > Directory Service Configuration.
- Configure the Time zones for imported users field:
- Use filters -- You can specify whether to apply only preconfigured, only custom, or both preconfigured and custom time zone filters. Preconfigured filters are automatically populated when you install the Application Server.
- The specified filters are applied to Directory Service user profiles at each Update users interval.
- When the same Phone prefix is used in a custom filter and in a preconfigured filter, the system applies the custom filter.
- Use user group settings-The time zones of the assigned user groups are reapplied to Directory Service user profiles at each Update users interval.
- Manually set time zones-The first time a Directory Service user is imported, the time zone of the assigned user group is applied to the user profile. You can then manually modify the Time zone field, the value of which is not overwritten during future Directory Service user updates.
- Use filters -- You can specify whether to apply only preconfigured, only custom, or both preconfigured and custom time zone filters. Preconfigured filters are automatically populated when you install the Application Server.
- (Release 7.0.2 and later releases) If the following conditions apply, then configure the Custom TZ pattern length field:
- You enabled the use of custom filters in Step 3.
- Spaces or punctuation are not included in the Telephone Number field in Cisco Unified Communications Manager.
- Click Save.
Related Topics
What To Do Next
If you configured the Time zones for imported users field to apply custom time zone filters, proceed to Configuring Directory Service Filters for Time Zones.
Otherwise, proceed to Assigning Profile Numbers to Directory Service Users.
Configuring Directory Service Filters for Time Zones
Use this procedure to add custom filters that configure the Region and Time zone for each Directory Service user based on the first digits of the Telephone Number field in Cisco Unified Communications Manager. The system comes with preconfigured time zone filters to which you can add custom filters.
The number of phone number digits that the system uses to match a time zone filter depends on the punctuation and spacing in the Telephone Number field in Cisco Unified Communications Manager. See Table: Examples of Phone Prefix Matching for Time Zone Filters. A leading "+" indicates an international number.
If there is no punctuation or spacing in the Telephone Number field in Cisco Unified Communications Manager:
- In Release 7.0.2 and later releases, the system uses the first number of digits specified in the Custom TZ pattern length field to match a time zone filter.
- In Release 7.0.1, the system uses the first three digits of the telephone number to match a time zone filter.
Table: Examples of Phone Prefix Matching for Time Zone Filters
| Sample Phone Number in Cisco Unified Communications Manager | Phone prefix Used to Match a Time Zone Filter |
|---|---|
|
+12 34 555-0123 |
+12 34 |
|
12-345-555-0123 |
12 |
|
(1234)555-0123 |
1234 |
|
123-555-0123 |
123 |
|
1235550123 |
123 |
Before You Begin
- Enable the use of custom filters. See Assigning Time Zones to Directory Service Users.
- If the system does not find a matching phone prefix, the system assigns the local time of the Application Server.
- If you have multiple Application Servers for multiple sites or for Application Server Failover, perform this task on only one active Application Server.
Restrictions
- You cannot modify a preconfigured filter, but you can create a custom filter that overrides the preconfigured one.
- If the system finds the same Phone prefix in a custom filter and in a preconfigured filter, the system applies the custom filter.
- If you modify existing Directory Service filters for time zones, only the following are affected:
- Subsequently imported Directory Service user profiles that did not already exist in Cisco Unified MeetingPlace.
- Subsequently updated Directory Service user profiles whose user accounts were modified in the LDAP directory or Cisco Unified Communications Manager.
- To apply modified time zone filters to Directory Service users that have already been imported to Cisco Unified MeetingPlace, see Modifying Directory Service Filters and Applying the Filters to Previously Imported Directory Service User Profiles.
Procedure
- Log in to the Cisco Unified MeetingPlace Administration Center.
- Click User Configuration > Directory Service > Directory Service Filters for Time Zones.
- Click Add New or Edit.
- Configure the fields described in Table: Field Reference: Add Time Zone Filter Page, Edit Time Zone Filter Page, and View Time Zone Filter Page.
Table: Field Reference: Add Time Zone Filter Page, Edit Time Zone Filter Page, and View Time Zone Filter Page
| Field | Description |
|---|---|
|
Phone prefix |
The system applies this filter when this value matches the first digits of the telephone number of the imported user. |
|
Region |
Determines which options become available in the Time zone field. |
|
Time zone |
Time zone assigned to imported user profiles that match the Phone prefix. |
5. Click Save.
Related Topics
What To Do Next
Proceed to Assigning Profile Numbers to Directory Service Users.
Modifying Directory Service Filters and Applying the Filters to Previously Imported Directory Service User Profiles
Complete this procedure only if you need to modify existing user group or time zone filters and apply those filters to Directory Service user profiles that have already been imported to Cisco Unified MeetingPlace.
Procedure
| Task Number | High-Level Task | Details |
|---|---|---|
|
1. |
Delete the user profiles from Cisco Unified MeetingPlace. |
Complete one of the following tasks: |
|
2. |
Configure the Directory Service filters for user groups. |
Complete one or both of the following tasks: |
|
3. |
Import the user profiles from Cisco Unified Communications Manager. |
|
What To Do Next
Proceed to Configuring Directory Service in Cisco Unified MeetingPlace.
Assigning Profile Numbers to Directory Service Users
By default, the system assigns the Telephone Number field entry in Cisco Unified Communications Manager as the Profile number for each Directory Service user.
Before You Begin
- This configuration option was introduced in Release 7.0.2.
- If you have multiple Application Servers for multiple sites or for Application Server Failover, perform this task on only one active Application Server.
Procedure
- Log in to the Cisco Unified MeetingPlace Administration Center.
- Click User Configuration > Directory Service > Directory Service Configuration.
- Configure the Generate profile number using field:
- Use phone number as profile number
- The system assigns the Telephone Number field entry in Cisco Unified Communications Manager as the Profile number for each Directory Service user.
- If the Telephone Number for a user is blank or conflicts with an existing Profile number in Cisco Unified MeetingPlace, then the system will instead use a six-digit auto-generated profile number.
- Use last `n' digits of phone number as profile number
- You will specify the number of digits in Step 4.
- If the Telephone Number for a user is blank, or if applying this method for a user conflicts with an existing Profile number in Cisco Unified MeetingPlace, then the system will instead use a six-digit auto-generated profile number.
- Use 6 digit auto-generated profile number
- The auto-generated profile numbers start from 100001, and they always contain six digits.
- Use phone number as profile number
- Configure the Number of digits field if you selected Use last `n' digits of phone number as profile number in Step 3.
- If the Telephone Number field entry for a user is shorter than the configured Number of digits, the Telephone Number will be used as is as the Profile number.
- Configure the Apply to field to choose between the following options:
- Apply profile number configuration to new users only.
- Apply profile number configuration to each user profile that gets imported or updated during Directory Service user profile updates or full synchronizations.
- Click Save.
Related Topics
What To Do Next
Proceed to Configuring Directory Service in Cisco Unified MeetingPlace.
Configuring Directory Service in Cisco Unified MeetingPlace
Before You Begin
- Complete these tasks:
- If you have multiple Application Servers for RSNA or for Application Server Failover:
- Configure Directory Service only on one active Application Server.
- Complete the Configuring User Database Replication for Two Sites.
Procedure
- Log in to the Cisco Unified MeetingPlace Administration Center.
- Click User Configuration > Directory Service > Directory Service Configuration.
- Configure the AXL username and AXL password fields:
- If you created an application user in Cisco Unified Communications Manager, enter the user ID and password for that application user.
- If you did not create an application user, enter the username and password for the default administrator user that was configured during the installation of Cisco Unified Communications Manager.
- Note: If you choose to use the default administrator user, you will need to update the AXL username or AXL password in Cisco Unified MeetingPlace whenever the Cisco Unified Communications Manager administrator username or password gets modified.
- In the AXL URL field, enter https://<ip-address>:8443/axl/ using the Cisco Unified Communications Manager IP address.
- Check Update Now.
- (Release 7.0.2 and later releases) Enter the Application Server hostname in the Hostname for Active Directory Service field.
- (Optional) To modify the frequency and other settings of user profile synchronization, configure the remaining fields on the Directory Service Configuration Page.
- Click Save.
Related Topics
What To Do Next
If you are configuring RSNA, return to How to Configure User Profiles for RSNA.