CCNA Voice Portable Command Guide: Cisco Unity Connection and Cisco Unified Presence
Date: Mar 19, 2013
The following topics are covered:
- Cisco Unity Connection Administration Interfaces
- Configuring Class of Service in Cisco Unity Connection
- Configuring Partitions and Search Spaces in Unity Connection
- Configuring User Templates in Cisco Unity Connection
- Managing Users in Cisco Unity Connection
- Adding users manually
- Importing users via AXL from CUCM
- Importing users with LDAP
- Importing users with BAT
- Configuring Call Handlers in Cisco Unity Connection
- Cisco Unity Connection Reports
- Cisco Unified Presence Server Administration Interfaces
- Cisco Unity Connection and Cisco Unified Presence Backup and Restore
Topology
Figure 7-1. Topology
Cisco Unity Connection Administration Interfaces
Cisco Unity Connection
There are six administration interfaces for Cisco Unity Connection. Five interfaces are available via web-based GUI and one CLI available via SSH. It might be confusing to remember which login to use for a particular administration interface.
To help you avoid the confusion, Table 7-1 lists the name of the administration interface, the method to access the interface, and what username and password to use.
Table 7-1 Cisco Unity Connection Administration Interfaces
Administration Interface |
Access Method |
Username/Password Combo |
Cisco Unity Connection Administration |
https://<IPAddress>/cuadmin |
Application Username/Password |
Cisco Unified Serviceability |
https://<IPAddress>/ccmservice |
Application Username/Password |
Cisco Unified OS Administration |
https://<IPAddress>/cmplatform |
Platform Username/Password |
Disaster Recovery System |
https://<IPAddress>/drf |
Platform Username/Password |
Cisco Unity Connection Serviceability |
https://<IPAddress>/cuservice |
Application Username/Password |
Command Line Interface |
SSH to <IPAddress> |
Platform Username/Password |
NOTE There is a web interface for end users to access their voice messages and manage their account. Their account must have a Class of Service (COS) that enables access to the Cisco Personal Communications Assistant (PCA) |
||
End User Web Access |
https://<IPAddress>/ciscopca |
End UserID / Password |
If you have more than one Cisco Unity Connection server in a cluster, be sure to perform all administration on the first node (Publisher).
Table 7-2 Common CLI Commands
admin:? |
Shows available commands |
admin:help <command> |
Help for a command. |
admin:show version active |
Displays active system version. |
admin:show version inactive |
Displays if there are any other alternative versions installed. This is used when an upgrade is performed. |
admin:utils service list |
Displays a list of services and their status. |
admin:show tech all |
Displays useful information for Cisco TAC. |
admin:utils network ping <IPAddress> |
Pings an address and displays the result. |
admin:utils network traceroute <IPAddress> |
Performs a traceroute to an IP address and displays the result. |
admin:quit |
Logs you out and ends the management session. |
Configuring Class of Service in Cisco Unity Connection
This section refers to the network topology referred to in Figure 7-1 and provides configuration steps for Class of Service (COS) in Unity Connection.
The COS defines what features and permissions a user has access to. It also defines the maximum length of the recorded name, greeting, and message.
Figure 7-2. Adding a COS
- Using a web browser, open https://10.0.1.21/cuadmin, and enter the Application username and password.
- Choose Class of Service > Class of Service. Click the Add New button. (Refer to Figure 7-2.)
- Enter Employees_NY_COS as the Display Name.
- Under Licensed Features, check Allow Users to Access Voice Mail Using an IMAP Client. This allows users to use an IMAP email client to access messages for easier message management.
- Under Features, check Allow Users to Use the Messaging Assistant. This feature enables the user to access the Cisco Personal Communications Assistant (PCA), which is a web interface for users to manage their messages.
- Under Message Options, uncheck Allow Users to Send Messages to System Distribution Lists because this option could be abused. (See Figure 7-3.)
Figure 7-3. Restricting Access to System Distribution Lists
- Click the Save button.
Configuring Partitions and Search Spaces in Unity Connection
Partitions and Search Spaces serve a similar function in Cisco Unity Connection as they do in CUCM. Partitions are logical groupings of devices with similar reachability, and a Search Space is an ordered list of partitions.
Extensions must be unique within a Partition, but in a Search Space they do not need to be. So you can have overlapping extensions in a Search Space, like 0 (zero).
In Figure 7-4 the Partitions are organized at the top indicating three locations. Below the Partitions are the Search Spaces that contain an ordered list of Partitions for reachability. The Executives_SS Search Space can access NewYork_PT, Chicago_PT, and LosAngeles_PT, making it possible to do things like send a companywide broadcast message and perform directory searches. The Employees_SS for each location have access to only their own location, and the Marketing_SS Search Space has access to both NewYork_PT and LosAngeles_PT because there are Marketing teams in both locations.
Figure 7-4. Partition and Calling Search Space Relationships
When you are designing your dial plan, it is a good idea to logically separate the areas if possible so that features and functions, like Handlers and Directories, are sectioned from one another, increasing flexibility and lessening the chance for system conflict by overlapping numbers.
To configure a Partition, follow these steps:
- Using a web browser, open https://10.0.1.21/cuadmin, and enter the Application username and password.
- Choose Dial Plan > Partitions. Click the Add New button.
- Enter NewYork_PT in the Name field, and click the Save button.
- The page refreshes, and you can now enter New York Employees in the Description field; click the Save button.
To configure a Search Space, follow these steps:
- Using a web browser, open https://10.0.1.21/cuadmin, and enter the Application username and password.
- Choose Dial Plan > Search Spaces. Click the Add New button.
- Enter Executives_SS in the Name field, and click the Save button.
- The page refreshes, and you can now enter New York Employees in the Description field; click the Save button.
- Move the Partitions from the Unassigned Partitions field up to the Assigned Partitions field by selecting the Partition you want to move and then using the up arrow between the fields. You can then rearrange the order of the Partitions in the Assigned Partitions field using the arrows on the side of the field. (See Figure 7-5.)
Figure 7-5. Rearrange the Partitions by Using the Arrows
Configuring User Templates in Cisco Unity Connection
Before entering large numbers of new users, you can save a lot of time by building a User Template that applies the same settings to all the newly imported users.
- Using a web browser, open https://10.0.1.21/cuadmin, and enter the Application username and password.
- Choose Templates > User Templates. Click the Add New button.
- Enter NewYorkEmployees in the Alias field and New York Employees in the Display Name field. Leave the other settings as default, and click the Save button. (See Figure 7-6.)
Figure 7-6. Save the User Template
- The page refreshes with more settings available. Select NewYork_PT for the Partition.
- Select NYEmployees_SS for the Search Scope.
- Select Employees_NY_COS for the COS, and click the Save button. (See Figure 7-7.)
Figure 7-7. Select Additional COS Options
Managing Users in Cisco Unity Connection
There are four ways to add users to Cisco Unity Connection. Users can be added manually, by synching to a CUCM, by using LDAP, and finally by using the Bulk Administration Tool (BAT).
Adding Users Manually
Adding users manually is typically used after the system is up and running and you are just adding only a few users at a time. If you have multiple users to add, use one of the other methods here to help speed up the process and add the users in a consistent manner.
- Using a web browser, open https://10.0.1.21/cuadmin, and enter the Application username and password.
- Choose Users > Users, and then click the Add New button.
- Because you already created a User Template, be sure it is selected in the Based on Template field. In the Alias field, enter jsmith and in the Extension field, enter 1010. The other fields are optional, but usually you should enter the user’s first and last name in the appropriate fields.
- Click the Save button. The user is added and the template applied to the new user.
- After the user is successfully created, the Edit menu appears. The Edit menu enables the administrator to change the password, roles, message settings, notification devices, and much more. (See Figure 7-8.)
Figure 7-8. Edit Menu
Importing Users via AXL from CUCM
Users can be synched with end users that are already configured on the CUCM system using Administrative XML (AXL).
- Make sure that the AXL service is activated. Using a web browser, open https://10.0.1.21/ccmservice, and enter the Application username and password.
- Choose Tools > Service Activation and check the box next to Cisco AXL Web Service. Then click the Save button. (See Figure 7-9.)
Figure 7-9. Activating Cisco AXL Web Service
- Using the drop-down navigation menu on the upper right of the page, select Cisco Unity Connection Administration, and click the Go button.
- Choose Telephony Integrations > Phone System. Select PhoneSystem; then choose Edit > Cisco Unified Communications Manager AXL Servers. (See Figure 7-10.)
Figure 7-10. Phone System Basics Edit Menu Choices
- Click the Add New button, and enter the CUCM IP Address 10.0.1.20 in the IP Address field. Then enter 8443 in the Port field.
- Click the Save button. (Figure 7-11.) Click the Test button to ensure that the configuration is correct.
Figure 7-11. AXL Test Message Successful
- Choose Users > Import Users. Select PhoneSystem for the Find End Users In field, and click the Find button.
- Choose NewYorkEmployees for the Based on Template field, and then check the boxes next to the users that were found as the search result. Click the Import Selected button. (See Figure 7-12.)
Figure 7-12. Import Selected Users
- Now choose Users > Users, and click the Find button to verify that the users were imported correctly.
Importing Users with LDAP
Table 7-3 contains the details used when configuring LDAP on Cisco Unity Connection.
Table 7-3 LDAP Configuration
LDAP Configuration Name: Corporate LDAP |
Name used in Unity Connection to identify this LDAP Directory |
LDAP Manager Distinguished Name: mike@voicepcg.local |
User with administrative rights to LDAP |
User Search Base: cn=Users, dc=voicepcg, dc=local |
Defines where Unity Connection looks for users |
LDAP Server Information>IP Address: 10.0.1.23 |
Defines the IP address of the LDAP server |
- Make sure that the Cisco DirSync service is activated. Using a web browser, open https://10.0.1.21/ccmservice, and enter the Application username and password.
- Choose Tools > Service Activation, and check the box next to Cisco DirSync then click the Save button.
- Using the drop-down navigation menu on the upper right of the page, select Cisco Unity Connection Administration, and click the Go button.
- Choose System Settings > LDAP > LDAP Setup.
- Check the box for Enable Synchronizing from LDAP Server, and click the Save button. (See Figure 7-13.)
Figure 7-13. LDAP Setup
- Choose System Settings > LDAP > LDAP Directory Configuration, and click the Add New button.
- In the LDAP Configuration Name field, enter Corporate LDAP. In the LDAP Manager Distinguished Name field, enter mike@voicepcg and enter the password twice below. In the LDAP User Search Base field, enter cn=Users, dc=voicepcg, dc=local and in the LDAP Server Information > IP Address field, type 10.0.1.23.
- Click the Save button. Unity Connection attempts to make a connection to the LDAP server, and if it is successful, it saves the configuration. If the connection fails, an error message displays indicating what failed. (See Figure 7-14.)
Figure 7-14. Save the LDAP Configuration
- When the test completes and the page refreshes, click the new button labeled Perform Full Sync Now on the bottom. (See Figure 7-15.)
Figure 7-15. Performing an LDAP Sync
- Choose Users > Import Users. In the Find End User In drop-down, select LDAP Directory, and click the Find button.
- A list of users in LDAP will be returned. Select the NewYorkEmployees template. Next, check the box next to the users you would like to import, and click the Import Selected button. (See Figure 7-16.)
Figure 7-16. Import Users Found in LDAP
- Choose Users > Users to verify that the users were imported successfully.
Importing Users with the Bulk Administration Tool (BAT)
Adding users with the Bulk Administration Tool (BAT) in Cisco Unity Connection is similar to using BAT in CUCM. There are three basic tasks that need to be done to import users using BAT in Cisco Unity Connection.
- Select and export the comma separated value (CSV) file to your workstation.
- Add the users to the downloaded CSV file.
- Upload the CSV file, and import the users into Cisco Unity Connection.
Following is the procedure to import users with BAT in Cisco Unity Connection:
- Using a web browser, open https://10.0.1.21/cuadmin, and enter the Application username and password.
- Choose Tools > Bulk Administration Tool.
- In the Select Operation section, click the radio button next to Export.
- In the Select Object Type section, click the radio button next to Users with Mailbox.
- In the Select File section, type unity_connection.csv in the CSV File field. Click the Submit button. (See Figure 7-17.)
Figure 7-17. Export CSV File with the Bulk Administration Tool (BAT)
- After the export operation finishes, the Status area at the top of the page generates a link that you can use to download the file. Click Download the Export File. (See Figure 7-18.)
Figure 7-18. Download the Export File
- Open the downloaded file with Microsoft Excel or other software that can edit the CSV file. There are many columns to fill in, but just use the following six columns: Alias, FirstName, LastName, DisplayName, Extension, and ListInDirectory. The column letters are included in Figure 7-19, and other columns are hidden that you are not using right now. Add the users as indicated here, and save the edited CSV file.
Figure 7-19. Complete the Columns with User Information
- Using a web browser, open https://10.0.1.21/cuadmin, and enter the Application username and password.
- Choose Tools > Bulk Administration Tool.
- In the Select Operation section, click the radio button next to Update.
- In the Select Object Type section, click the radio button next to Users with Mailbox.
- In the User Template section, click the radio button next to Yes, and select NewYorkEmployees in the drop-down menu.
- In the Select File section, type unity_connection.csv in the CSV File field. In the Failed Objects Filename field, type failed.csv. Click the Submit button. (See Figure 7-20.)
Figure 7-20. Upload the BAT File to Import the Users
- A status section appears and shows the progress of the import. (See Figure 7-21.) After the operation is complete, you can then choose Users > Users to verify that the users were indeed imported. (See Figure 7-22.)
Figure 7-21. BAT Import Successful
Figure 7-22. Verifying That the Users Were Imported
Configuring Call Handlers in Cisco Unity Connection
A call handler can serve multiple functions in Cisco Unity Connection. A call handler can answer calls, take messages, be part of an auto-attendant, play a recorded announcement, and transfer calls to users or other call handlers.
In this example, you create a call handler with which a user can press 0 to go to the operator and press 9 for the directory.
- Using a web browser, open https://10.0.1.21/cuadmin, and enter the Application username and password.
- Choose Call Management > System Call Handlers. Click the Add New button.
Enter Main_Menu_CH in the Display Name field.
- Type 5000 in the Extension field, and click the Save button.
- Select NewYork_PT for the Partition, and click the Play/Record button to record the Main Menu. Click the Save button. (See Figure 7-23.)
Figure 7-23. Record the Main Menu
- Choose Edit > Caller Input. (See Figure 7-24.)
Figure 7-24. Edit the Caller Menu Options
- Select the 0 key. (See Figure 7-25.)
Figure 7-25. Change the Options for “0”
- Select the radio button next to Call Handler, and select Operator from the menu. When users dial 0 from the menu, they will be connected to the operator. Attempt transfer means that the system will transfer the call to the operator’s phone. If you choose Go Directly to Greetings, the operator will not have a chance to answer the call, and the operator’s greeting starts playing.
- Click the Save button. (See Figure 7-26.)
Figure 7-26. Transfer to the Operator Call Handler
- Choose Edit > Caller Input. Select the 9 key. This is the Directory Key.
- Select the radio button next to Directory Handler, and select System Directory Handler. Then click the Save button.
- Choose Edit > Greetings. There are multiple greetings available. (See Figure 7-27.)
Figure 7-27. Greetings
Table 7-4 provides details about how the greetings are used and what greetings override other greetings.
Table 7-4 Greeting Descriptions
Greeting Type
Greeting Override?
Description
Alternate
Overrides all other greetings
Useful for special situations like out of office for an extended period of time.
Busy
Overrides standard, internal, closed, and holiday greetings
Plays when the target’s extension is busy.
Error
None
Plays when a caller enters invalid digits in a call handler/mailbox.
Internal
Overrides standard, closed, and holiday greetings
This greeting is for internal callers and tends to be more informal or adds information that only internal callers need to know like, “I am in the Sales Meeting in Room 1776 today.”
Closed
Overrides standard greeting
Plays when the business is closed according to the active schedule.
Standard
None
Plays when not overridden by another greeting.
Holiday
Overrides the standard and closed greeting
Plays when the business is closed for a holiday as specified in the active schedule’s holiday dates.
- Select the Standard greeting, and record a message for callers indicating that they can dial 0 for the operator or 9 for the directory. Click the Save button.
- Choose Edit > Message Settings. Uncheck Callers Can Edit Messages, and change the Message Recipient to User with Mailbox. Then select user5. Click the Save button. (See Figure 7-28.)
Figure 7-28. Save Call Handler Message Settings
- Choose the owner of the call handler to administer the greetings and other settings. Choose Edit > Call Handler Owners, and click the Add User button. A new window opens with the users available to be the call handler owner. Check jsmith and click Add Selected User. Then click the Close button. (See Figure 7-29.)
Figure 7-29. Add Selected User
Cisco Unity Connection Reports
Cisco Unity Connection includes many built-in reports that you can run to monitor and troubleshoot the system.
- Using a web browser, open https://10.0.1.21/cuservice, and enter the Application username and password.
- Choose Tools > Reports. (See Figure 7-30.)
Figure 7-30. Unity Connection Report List
The reports can be viewed as a web page, comma-separated value (CSV) or PDF.
Cisco Unified Presence Server Administration Interfaces
The Cisco Unified Presence Server uses CUCM for user administration.
Table 7-5 Cisco Unified Presence Server Administration Interfaces
Administration Interface |
Access Method |
Username/Password Combo |
Cisco Unified Presence Administration |
https://<IPAddress>/cupadmin |
Application Username/Password |
Cisco Unified Serviceability |
https://<IPAddress>/ccmservice |
Application Username/Password |
Cisco Unified OS Administration |
https://<IPAddress>/cmplatform |
Platform Username/Password |
Disaster Recovery System |
https://<IPAddress>/drf |
Platform Username/Password |
Cisco Unified Reporting |
https://<IPAddress>/cucreports |
Application Username/Password |
Command Line Interface |
SSH to <IPAddress> |
Platform Username/Password |
End User Web Access |
https://<IPAddress>/cupuser |
End UserID/Password |
Cisco Unity Connection and Cisco Unified Presence Backup and Restore
The Backup and Restore functionality in Cisco Unity Connection and Cisco Unified Presence is the same as CUCM, which is covered in Chapter 8, “Management, Monitoring, and Troubleshooting CUCM” in the “Configuring Backup and Recovery” section. Refer to that chapter and section for details on backup and restore configuration.