-
Cisco Unity Express 2.3 CLI Administrator Guide
-
Cisco Unity Express Features
-
Overview of Cisco Unity Express Voice Mail and Auto Attendant
-
Entering and Exiting the Command Environment
-
Configuration Tasks
-
Configuring System Components
-
Configuring Users and Groups
-
Configuring Mailboxes
-
Configuring Distribution Lists
-
Configuring Security
-
Configuring SNMP Monitoring
-
Configuring Broadcast Messages
-
Configuring Integrated Messaging
-
Configuring Message Notification
-
Configuring VoiceView Express
-
Advanced Configuration
-
Networking Cisco Unity Express
-
Monitoring the System
-
Backing Up and Restoring Data
-
Troubleshooting
-
Index
-
Table Of Contents
Configuring Application Parameters
Required Data for This Procedure
Configuring Multiple Triggers for an Application
Port Sharing Among Multiple Triggers
Required Data for This Procedure
Displaying NTP Server Information
Required Data for This Procedure
Configuring the Clock Time Zone
Advanced Configuration
Last Updated: July 25, 2006
This chapter describes advanced configuration procedures for modifying application parameters after the initial installation and configuration process described in the section "Configuring System Components" on page 33. That earlier chapter includes commands not described in this chapter.
The advanced configuration procedures include:
•
Configuring Application Parameters
•
•
Configuring Application Parameters
The section "Advanced Configuration" described how to configure parameters for the applications that shipped with Cisco Unity Express. This procedure describes how to configure parameters for your custom auto-attendant application script.
Required Data for This Procedure
•
•
•
•
Note
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
DETAILED STEPS
Step 1
config t
Example:se-10-0-0-0# config t
Enters configuration mode.
Step 2
ccn application full-name
Example:se-10-0-0-0(config)# ccn application myscript
Specifies the application to configure and enters application configuration mode. Use the full name of the application for the full-name argument.
Step 3
default parameter
Example:se-10-0-0-0(config-application)# default maxsessions(Optional) Resets the application parameter as follows:
•
•
•
•
•
Step 4
description "text"
Example:se-10-0-0-0(config-application)# description "my application"
(Optional) Enter a description of the application. Use double quotes around the text.
Step 5
maxsessions number
Example:se-10-0-0-0(config-application)# maxsessions 5
Specifies the number of callers who can access this application simultaneously. See "Port Sharing Among Multiple Triggers" for guidelines on assigning this value.
Step 6
no parameter
Example:se-10-0-0-0(config-application)# no description
(Optional) Deletes or disables a script value.
Step 7
parameter name "value"
Example:se-10-0-0-0(config-application)# parameter MaxRetry "4"
se-10-0-0-0(config-application)# parameter WelcomePrompt "Welcome.wav"
Specifies parameters for the application. Each parameter must have a name and a value, which is written within double quotes.
Step 8
script name [description "description"]
Example:se-10-0-0-0(config-application)# script myscript.aef description "My New Script"
Specifies the name of the script and an optional description, which must be written within double quotes. If no description is provided, the system uses the name value for the description.
Step 9
enabled
Example:se-10-0-0-0(config-application)# enabled
Allows the application to be accessible to the system.
Step 10
end
Example:se-10-0-0-0(config-application)# end
Exits application configuration mode.
Step 11
exit
Example:se-10-0-0-0(config)# exit
Exits configuration mode.
Step 12
show ccn scripts
Example:se-10-0-0-0# show ccn scriptsDisplays the configured script names and their descriptions.
Step 13
show ccn application
Example:se-10-0-0-0# show ccn applicationDisplays details about each configured application.
Step 14
copy running-config startup-config
Example:se-10-0-0-0# copy running-config startup-config
Copies the configuration changes to the startup configuration.
Examples
The following example illustrates the show ccn scripts output:
se-10-0-0-0# show ccn scriptsName: myscript.aefDescription: My New Scriptse-10-0-0-0#The following example illustrates the show ccn application output:
se-10-0-0-0# show ccn applicationName: myscriptDescription: my applicationScript: myscript.aefID number: 2Enabled: yesMaximum number of sessions: 5Retries: 4WelcomePrompt: Welcome.wavse-10-0-0-0#Configuring Multiple Triggers for an Application
Your network may require additional triggers for one or more Cisco Unity Express applications. For example, customers may be able to dial more than one telephone number to contact your company. These telephone numbers would activate the auto-attendant application.
Use this procedure to configure the additional triggers. The trigger must match a dial peer configured on Cisco Unified CME or a JTAPI route point on Cisco Unified CallManager. If you configure a trigger on Cisco Unity Express, verify that the dial peer exists in Cisco Unified CME or the route point exists on Cisco Unified CallManager.
Cisco Unity Express supports a maximum of 8 triggers for all applications combined. This applies to the CUE-NM-EC, CUE-NM, and CUE-AIM.
Port Sharing Among Multiple Triggers
Each trigger is assigned a maxsessions value. In addition to the guidelines described in "Port Sharing Among Multiple Triggers", one other consideration is needed.
The maximum number of callers that can access an application concurrently is determined by the application's maxsession value if the total maxsessions value from all its triggers exceeds the application's maxsessions value.
For example, suppose your module has 8 ports and you assigned the auto-attendant application a maxsessions value of 5. Your auto-attendant application has 2 triggers. You configure one trigger with a maxsessions value of 2 and the other trigger with a maxsessions value of 4. The maximum number of callers that can access the auto-attendant application simultaneously is 5, not 6.
Suppose, instead, that you configure one trigger with a maxsessions value of 2 and the other trigger with a maxsessions value of 2. The maximum number of simultaneous callers to the application is 4, not 5.
Required Data for This Procedure
The following information is required to configure the triggers:
•
•
•
•
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
DETAILED STEPS
Step 1
config t
Example:se-10-0-0-0# config t
Enters configuration mode.
Step 2
ccn trigger {sip | jtapi} phonenumber number
Example:se-10-0-0-0(config)# ccn trigger sip phonenumber 50150
se-10-0-0-0(config)# ccn trigger jtapi phonenumber 50160
Specifies the telephone number that acts as the trigger to start the application and enters trigger configuration mode.
•
•
•
Step 3
application string
Example:se-10-0-0-0(config-trigger)# application myapplication
Specifies the name of the application to start when the telephone number is dialed, which, in turn, invokes the appropriate application script. This application name must match the name that was configured with the ccn application name command.
Step 4
default parameter
Example:se-10-0-0-0(config-trigger)# default idletimeout
se-10-0-0-0(config-trigger)# default maxsessions
(Optional) Resets the application parameter to the script-defined default value. Using the default command on Cisco Unity Express system parameters has the following effects:
•
•
•
•
•
Step 5
idletimeout time
Example:se-10-0-0-0(config-trigger)# idletimeout 500
Specifies the number of milliseconds to wait for a caller's response before timing out and disconnecting the call.
Step 6
locale language
Example:se-10-0-0-0(config-trigger)# locale en_ENU
Specifies the language to use for the prompts heard by the caller. Cisco Unity Express supports only one language installed on the system. This option cannot be changed.
Step 7
maxsessions number
Example:se-10-0-0-0(config-trigger)# maxsessions 3
Specifies the maximum number of callers the application can handle simultaneously. See "Port Sharing Among Multiple Triggers" for guidelines on assigning this value.
Step 8
no parameter
Example:se-10-0-0-0(config-trigger)# no maxsessions
(Optional) Deletes or disables the parameter value. Using the no command on Cisco Unity Express system parameters has the following effects:
•
•
•
•
•
Step 9
enabled
Example:se-10-0-0-0(config-trigger)# enabled
Enables the trigger.
Step 10
end
Example:se-10-0-0-0(config-trigger)# end
Exits trigger configuration mode.
Step 11
Repeat Step 2 to Step 10 to configure additional triggers for this application.
—
Step 12
exit
Example:se-10-0-0-0(config)# exit
Exits configuration mode.
Step 13
show ccn trigger
Example:se-10-0-0-0# show ccn trigger
Displays the parameter values for all configured triggers.
Step 14
copy running-config startup-config
Example:se-10-0-0-0# copy running-config startup-config
Copies the configuration changes to the startup configuration.
Examples
The following sample configuration sets two triggers for the voice-mail application:
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn trigger sip phonenumber 50150
se-10-0-0-0(config-trigger)# application voicemail
se-10-0-0-0(config-trigger)# idletimeout 500
se-10-0-0-0(config-trigger)# maxsessions 4
se-10-0-0-0(config-trigger)# enabled
se-10-0-0-0(config-trigger)# endse-10-0-0-0(config)#se-10-0-0-0(config)# ccn trigger sip phonenumber 50160
se-10-0-0-0(config-trigger)# application voicemail
se-10-0-0-0(config-trigger)# idletimeout 1000
se-10-0-0-0(config-trigger)# maxsessions 8
se-10-0-0-0(config-trigger)# enabled
se-10-0-0-0(config-trigger)# endse-10-0-0-0(config)# exitse-10-0-0-0#The output for the show ccn trigger command might look similar to the following:
se-10-0-0-0# show ccn triggerName: 50150Type: SIPApplication: voicemailLocale: en_ENUIdle Timeout: 500Enabled: yesMaximum number of sessions: 4Name: 50160Type: SIPApplication: voicemailLocale: en_ENUIdle Timeout: 1000Enabled: yesMaximum number of sessions: 8se-10-0-0-0#
Configuring the Hostname
During the software postinstallation process, the hostname was configured. Use this procedure to change the hostname.
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
Examples
The following commands configure the hostname:
se-10-0-0-0# config tse-10-0-0-0(config)# hostname mainhostca-west(config)# exitca-west#The output from the show hosts command might look similar to the following:
ca-west# show hostsHostname: mainhostDomain: myofficeDNS Server1: 10.100.10.130DNS Server2: 10.5.0.0ca-west#Configuring the DNS Server
During the software postinstallation process, the DNS server and IP addresses may have been configured. Use this procedure to change the server name and IP addresses.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
DETAILED STEPS
Examples
The following commands configure the DNS server:
se-10-0-0-0# config tse-10-0-0-0(config)# ip domain-name mycompanyse-10-0-0-0(config)# ip name-server 10.100.10.130 10.5.0.0se-10-0-0-0(config)# exitse-10-0-0-0#The output from the show hosts command might look similar to the following:
se-10-0-0-0# show hostsHostname: se-10-100-6-10Domain: mycompanyDNS Server1: 10.100.10.130se-10-0-0-0#Configuring NTP Servers
During the software postinstallation process, the Network Time Protocol (NTP) server may have been configured. Cisco Unity Express accepts a maximum of three NTP servers. Use this procedure to add or delete NTP servers.
Adding NTP Servers
You can designate an NTP server using its IP address or its hostname.
Cisco Unity Express uses the DNS server to resolve the hostname to an IP address and stores the IP address as an NTP server. If DNS resolves the hostname to more than one IP address, Cisco Unity Express randomly chooses one of the IP addresses that is not already designated as an NTP server.
To configure an NTP server with multiple IP addresses for a hostname, repeat the configuration steps using the same hostname. Each iteration assigns the NTP server to its remaining IP addresses.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
DETAILED STEPS
Examples
The following commands configure the NTP server:
se-10-0-0-0# config tse-10-0-0-0(config)# ntp server 10.100.6.9se-10-0-0-0(config)# exitse-10-0-0-0#The output from the show ntp status command might look similar to the following:
se-10-0-0-0# show ntp statusNTP reference server 1: 10.100.6.9Status: sys.peerTime difference (secs): 3.268110099434328E8Time jitter (secs): 0.1719226837158203se-10-0-0-0#The following example configures an NTP server with a hostname that points to two IP addresses 172.16.10.1 and 172.16.10.2:
se-10-0-0-0# config tse-10-0-0-0(config)# ntp server NTP.mine.comse-10-0-0-0(config)# exitse-10-0-0-0#se-10-0-0-0# config tse-10-0-0-0(config)# ntp server NTP.mine.comse-10-0-0-0(config)# exitse-10-0-0-0#The output from the show ntp status command might look similar to the following:
se-10-0-0-0# show ntp statusNTP reference server 1: 172.16.10.1Status: sys.peerTime difference (secs): 3.268110099434328E8Time jitter (secs): 0.1719226837158203NTP reference server 1: 172.16.10.2Status: sys.peerTime difference (secs): 3.268110099434328E8Time jitter (secs): 0.1719226837158203se-10-0-0-0#Removing an NTP Server
Remove an NTP server using its IP address or hostname.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
DETAILED STEPS
Displaying NTP Server Information
The following commands are available to display NTP server configuration information and status:
•
•
•
•
The following is sample output for the show ntp associations command:
se-10-0-0-0# show ntp associationsind assID status conf reach auth condition last_event cnt===========================================================1 61253 8000 yes yes none rejectThe following is sample output for the show ntp servers command:
se-10-0-0-0# show ntp serversremote refid st t when poll reach delay offset jitter==============================================================================1.100.6.9 0.0.0.0 16 u - 1024 0 0.000 0.000 4000.00space reject, x falsetick, . excess, - outlyer+ candidate, # selected, * sys.peer, o pps.peerThe following is sample output for the show ntp source command:
se-10-0-0-0# show ntp source127.0.0.1: stratum 16, offset 0.000013, synch distance 8.672010.0.0.0: *Not Synchronized*The following is sample output for the show ntp status command:
se-10-0-0-0# show ntp statusNTP reference server : 10.100.6.9Status: rejectTime difference (secs): 0.0Time jitter (secs): 4.0Configuring a Syslog Server
Cisco Unity Express captures messages that describe activities in the system. These messages are collected and directed to a messages.log file on the Cisco Unity Express module hard disk, the console, or an external system log (syslog) server. The messages.log file is the default destination.
This section describes the procedure for configuring an external server to collect the messages. To view the messages, see "Viewing System Activity Messages" on page 256.
Required Data for This Procedure
You need the hostname or IP address of the designated log server.
SUMMARY STEPS
1.
2.
3.
4.
DETAILED STEPS
Examples
The output from the show running-config command might look similar to the following:
se-10-0-0-0# show running-configclock timezone America/Los_Angeleshostname se-10-0-0-0ip domain-name localdomainntp server 10.100.60.1...log server address 10.100.10.210voicemail default mailboxsize 3000voicemail capacity time 6000endConfiguring the Clock Time Zone
During the software postinstallation process, the time zone of the local Cisco Unity Express module was configured. Use this procedure to change the module's time zone.
Cisco Unity Express automatically updates the clock for daylight savings time on the basis of the selected time zone.
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
Examples
The following commands configure the clock time zone:
se-10-0-0-0# config tse-10-0-0-0(config)# clock timezonePlease identify a location so that time zone rules can be set correctly.Please select a continent or ocean.1) Africa 4) Arctic Ocean 7) Australia 10) Pacific Ocean2) Americas 5) Asia 8) Europe3) Antarctica 6) Atlantic Ocean 9) Indian Ocean#? 2Please select a country.1) Anguilla 18) Ecuador 35) Paraguay2) Antigua & Barbuda 19) El Salvador 36) Peru3) Argentina 20) French Guiana 37) Puerto Rico4) Aruba 21) Greenland 38) St Kitts & Nevis5) Bahamas 22) Grenada 39) St Lucia6) Barbados 23) Guadeloupe 40) St Pierre & Miquelon7) Belize 24) Guatemala 41) St Vincent8) Bolivia 25) Guyana 42) Suriname9) Brazil 26) Haiti 43) Trinidad & Tobago10) Canada 27) Honduras 44) Turks & Caicos Is11) Cayman Islands 28) Jamaica 45) United States12) Chile 29) Martinique 46) Uruguay13) Colombia 30) Mexico 47) Venezuela14) Costa Rica 31) Montserrat 48) Virgin Islands (UK)15) Cuba 32) Netherlands Antilles 49) Virgin Islands (US)16) Dominica 33) Nicaragua17) Dominican Republic 34) Panama#? 45Please select one of the following time zone regions.1) Eastern Time2) Eastern Time - Michigan - most locations3) Eastern Time - Kentucky - Louisville area4) Eastern Standard Time - Indiana - most locations5) Central Time6) Central Time - Michigan - Wisconsin border7) Mountain Time8) Mountain Time - south Idaho & east Oregon9) Mountain Time - Navajo10) Mountain Standard Time - Arizona11) Pacific Time12) Alaska Time13) Alaska Time - Alaska panhandle14) Alaska Time - Alaska panhandle neck15) Alaska Time - west Alaska16) Aleutian Islands17) Hawaii#? 11The following information has been given:United StatesPacific TimeTherefore TZ='America/Los_Angeles' will be used.Local time is now: Tue Jul 18 02:02:19 PDT 2006.Universal Time is now: Tue Jul 18 09:02:19 UTC 2006.Is the above information OK?1) Yes2) No#? 1Save the change to startup configuration and reload the module for the new timezone to take effect.se-10-0-0-0(config)# endse-10-0-0-0#The output from the show clock detail command might look similar to the following:
se-10-0-0-0# show clock detail19:20:33.724 PST Wed Feb 4 2004time zone: America/Pacificclock state: unsyncdelta from reference (microsec): 0estimated error (microsec): 175431time resolution (microsec): 1clock interrupt period (microsec): 10000time of day (sec): 732424833time of day (microsec): 760817
