Table Of Contents
R
Last Updated: June 30, 2007
reload
To restart the Cisco Unity Express system, use the reload command in Cisco Unity Express offline mode.
reload
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express offline
Command History
Usage Guidelines
Use this command in the following situations:
•After a shutdown command to restart the Cisco Unity Express system.
•After a restore command to activate the uploaded file information.
Examples
The following example illustrates the use of the reload command after a restore procedure:
se-10-0-0-0# offlinese-10-0-0-0(offline)# restore id data3 category datase-10-0-0-0(offline)# reloadRelated Commands
remote cache enable
To enable the least recent used (LRU) cache on the local system, use the remote cache enable command in Cisco Unity Express configuration mode. To disable the LRU cache, use the no form of this command.
remote cache enable
no remote cache enable
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
An LRU cache is a database of remote subscribers' first names, last names, and spoken names. These remote subscribers are not configured in the Remote User Directory. The subscribers contained in the cache are referred to as cached subscribers.
Network messages update the contents of the LRU cache. When a local sender addresses a voice-mail message to a remote subscriber, the system accesses this information to send a spoken name confirmation about the remote subscriber to the local sender. Each time a network message arrives from a cached subscriber or each time a local sender sends a voice message to a cached subscriber, the system updates the time stamp of the cached subscriber's entry in the LRU cache.
The maximum capacity of the LRU cache is 50 subscribers on the network module (NM) and 20 subscribers on the advanced integration module (AIM). When the LRU cache reaches its maximum capacity, a new entry erases the existing entry with the oldest time stamp. This means that the next time a local sender calls a remote subscriber, the sender will not receive a spoken name confirmation if the remote subscriber is no longer in the LRU cache.
Do one or both of the following to avoid the inconsistent confirmation response:
•To ensure that a sender always receives a spoken name confirmation for a remote subscriber, configure the remote subscriber in to the Remote User Directory.
•Disable the LRU cache.
The LRU cache contents are saved after system reloads.
The GUI Defaults > Voice Mail option also permits changing the status of the LRU cache.
Examples
The following example illustrates enabling the LRU cache on the local system:
se-10-0-0-0# config tse-10-0-0-0(config)# remote cache enablese-10-0-0-0(config)# exitThe following example illustrates disabling the LRU cache on the local system:
se-10-0-0-0# config tse-10-0-0-0(config)# no remote cache enablese-10-0-0-0(config)# exitRelated Commands
remote copy spokenname
To upload or download a spoken name for a remote subscriber, use the remote copy spokenname command in Cisco Unity Express EXEC mode.
Uploading the Spoken Name
remote copy spokenname username username url url loginname server-login password server-password
Downloading the Spoken Name
remote copy spokenname url url username username loginname server-login password server-password
Syntax Description
username username
Remote subscriber ID.
url url
URL to the spoken name file on the server.
loginname server-login
Server login.
password server-password
Server password.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
Use the Administration via Telephone (AvT) options to record the spoken names. Those name files are stored in the Lightweight Directory Access Protocol (LDAP) on the Cisco Unity Express module. If you download the files to a server other than the Cisco Unity Express module, you can upload those files to another Cisco Unity Express module in the network.
Examples
The following example uploads the spoken name file user5.wav for remote subscriber user5:
se-10-0-0-0# remote copy spokenname username user5 url ftp:/10.4.51.66/tsmith.wav loginname admin password testThe following example downloads the spoken name file user5.wav for remote subscriber user5:
se-10-0-0-0# remote copy spokenname url ftp:/10.4.51.66/tsmith.wav username user5 loginname admin password testremote username fullname
To associate a full name with a remote subscriber, use the remote username fullname command in Cisco Unity Express EXEC mode. To delete the remote username, use the no form of this command.
remote username username fullname {display display-name | first first-name | last last-name}
no remote username username fullname {display display-name | first first-name | last last-name}
Syntax Description
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
An error message appears if the username does not exist.
Examples
The following example configures several remote subscribers.
se-10-0-0-0# config tse-10-0-0-0(config)# remote username user2 location sjc createse-10-0-0-0(config)# remote username user2 phonenumber 84444se-10-0-0-0(config)# remote username user5 location sjc createse-10-0-0-0(config)# remote username user5 phonenumber 81111se-10-0-0-0(config)# remote username user3 location nyc createse-10-0-0-0(config)# remote username user3 phonenumber 92222se-10-0-0-0(config)# remote username user4 location nyc createse-10-0-0-0(config)# remote username user4 phonenumber 93333se-10-0-0-0(config)# endse-10-0-0-0# remote username user5 fullname display "User 5"se-10-0-0-0# remote username user5 fullname first Userse-10-0-0-0# remote username user5 fullname last 5se-10-0-0-0# remote username user3 fullname display "User 3"se-10-0-0-0# remote username user3 fullname first Userse-10-0-0-0# remote username user3 fullname last 3se-10-0-0-0# remote username user4 fullname display "User 4"se-10-0-0-0# remote username user4 fullname first Userse-10-0-0-0# remote username user4 fullname last 4se-10-0-0-0# remote username user1 fullname display "User 1"se-10-0-0-0# remote username user1 fullname first Userse-10-0-0-0# remote username user1 fullname last 1The following example deletes the display name for remote subscriber User5:
se-10-0-0-0# no remote username user5 fullname display "User 5"The following example deletes the first name for remote subscriber User5:
se-10-0-0-0# no remote username user5 fullname first UserThe following example deletes the last name for remote subscriber User5:
se-10-0-0-0# no remote username user5 fullname last 5Related Commands
remote username location
To configure a remote subscriber on the local Cisco Unity Express system, use the remote username location command in Cisco Unity Express EXEC mode or configuration mode. To delete a remote user from the system, use the no form of this command.
remote username username location location-id create
no remote username username
Syntax Description
username
Name of the remote subscriber.
location-id
Location ID of the remote site.
create
Creates the remote subscriber.
Defaults
No remote subscribers are configured.
Command Modes
Cisco Unity Express EXEC
Cisco Unity Express configurationCommand History
Usage Guidelines
This command creates a remote subscriber on the local system so that a local voice-mail sender can address a remote recipient using dial-by-name. Additionally, the system provides the sender with a spoken name confirmation of the remote recipient so that the sender can verify that the name and location are correct.
Use the remote username location command once to associate the remote subscriber with a network location.
In Release 2.1, regardless of the license level, the network module (NM) supports a maximum of 50 remote subscribers and the advanced integration module (AIM) supports a maximum of 20 remote subscribers.
An error message appears if one of the following conditions occurs:
•A subscriber, group, or remote subscriber exists with this username.
•The maximum number of remote subscribers is already configured on the system.
•The location ID does not exist.
•The location ID is the local location.
Examples
The following example configures several remote subscribers.
se-10-0-0-0# config tse-10-0-0-0(config)# remote username user2 location sjc createse-10-0-0-0(config)# remote username user2 phonenumber 84444se-10-0-0-0(config)# remote username user5 location sjc createse-10-0-0-0(config)# remote username user5 phonenumber 81111se-10-0-0-0(config)# remote username user3 location nyc createse-10-0-0-0(config)# remote username user3 phonenumber 92222se-10-0-0-0(config)# remote username user4 location nyc createse-10-0-0-0(config)# remote username user4 phonenumber 93333se-10-0-0-0(config)# endse-10-0-0-0# remote username user5 fullname display "User 5"se-10-0-0-0# remote username user5 fullname first Userse-10-0-0-0# remote username user5 fullname last 5se-10-0-0-0# remote username user3 fullname display "User 3"se-10-0-0-0# remote username user3 fullname first Userse-10-0-0-0# remote username user3 fullname last 3se-10-0-0-0# remote username user4 fullname display "User 4"se-10-0-0-0# remote username user4 fullname first Userse-10-0-0-0# remote username user4 fullname last 4se-10-0-0-0# remote username user2 fullname display "User 2"se-10-0-0-0# remote username user2 fullname first Userse-10-0-0-0# remote username user2 fullname last 2se-10-0-0-0#The following example deletes the remote subscriber User2:
se-10-0-0-0# config tse-10-0-0-0(config)# no remote username user2se-10-0-0-0(config)# endRelated Commands
remote username phonenumber
To associate a telephone number with a remote subscriber, use the remote username phonenumber command in Cisco Unity Express configuration mode. To delete the telephone number, use the no form of this command.
remote username username phonenumber extension-number
no remote username username phonenumber extension-number
Syntax Description
Defaults
No phone numbers are configured for the remote subscribers.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
The local system does not verify the remote extension number.
An error message appears if one of the following conditions occurs:
•The username does not exist.
•The length of the extension number does not fall within the maximum and minimum extension lengths for the subscriber's location.
Examples
The following example configures several remote subscribers.
se-10-0-0-0# config tse-10-0-0-0(config)# remote username user2 location sjc createse-10-0-0-0(config)# remote username user2 phonenumber 84444se-10-0-0-0(config)# remote username user5 location sjc createse-10-0-0-0(config)# remote username user5 phonenumber 81111se-10-0-0-0(config)# remote username user3 location nyc createse-10-0-0-0(config)# remote username user3 phonenumber 92222se-10-0-0-0(config)# remote username user4 location nyc createse-10-0-0-0(config)# remote username user4 phonenumber 93333se-10-0-0-0(config)# endse-10-0-0-0# remote username user2 fullname display "User 2"se-10-0-0-0# remote username user2 fullname first Userse-10-0-0-0# remote username user2 fullname last 2se-10-0-0-0# remote username user5 fullname display "User 5"se-10-0-0-0# remote username user5 fullname first Userse-10-0-0-0# remote username user5 fullname last 5se-10-0-0-0# remote username user3 fullname display "User 3"se-10-0-0-0# remote username user3 fullname first Userse-10-0-0-0# remote username user3 fullname last 3se-10-0-0-0# remote username user4 fullname display "User 4"se-10-0-0-0# remote username user4 fullname first Userse-10-0-0-0# remote username user4 fullname last 4se-10-0-0-0#The following example deletes extension 84444 from remote subscriber User 4:
se-10-0-0-0# config tse-10-0-0-0(config)# no remote username user4 phonenumber 84444se-10-0-0-0(config)# endRelated Commands
restore
To restore a backup file, use the restore command in Cisco Unity Express offline mode.
restore id backup-id category {all | configuration | data}
Syntax Description
Command Modes
Cisco Unity Express offline
Command History
Usage Guidelines
When the restore procedure begins, all active calls are terminated. Cisco Unity Express does not support scheduled restores. Consider restoring a file when the telephones are least active.
After the restore procedure is complete, use the reload command to activate the file data.
Use the show backup history command to locate the backup-id value of the file to be restored.
Examples
The following example restores the file with the ID data5, which is a data-only file.
se-10-0-0-0> enablese-10-0-0-0# offlinese-10-0-0-0(offline)# restore id data5 category datase-10-0-0-0(offline)# reloadRelated Commands
restore factory default
To restore the system to the factory defaults, use the restore factory default command in Cisco Unity Express offline mode.
restore factory default
Caution This feature is not reversible. All data and configuration files are erased. Use this feature with caution. It is recommended that you do a full system backup before proceeding with this feature.
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express offline
Command History
Usage Guidelines
Restoring the system to the factory defaults has the following effects:
•Replaces the current database with an empty database.
•Initializes the Lightweight Directory Access Protocol (LDAP) to an empty state.
•Replaces the startup configuration with the template startup configuration that ships with the system.
•Erases all postinstallation configuration data.
•Deletes all subscriber and custom prompts.
When the system is clean, the administrator sees a message that the system will reload, and the system begins to reload. When the reload is complete, the system prompts the administrator to go through the postinstallation process.
When logging in to the graphical user interface (GUI), the administrator has the option to run the initialization wizard.
Examples
The following example illustrates restoring the system to factory defaults.
Step 1 se-10-0-0-0# offline
This command puts the system into offline mode.
Step 2 (offline)# restore factory default
This operation will cause all the configuration and data on the system to be erased. This operation is not reversible. Do you wish to continue? (n)Step 3 Do one of the following:
•Enter n if want to retain the system configuration and data.
The operation is cancelled, but the system remains in offline mode. To return to online mode, enter continue.
•Enter y if you want to erase the system configuration and data.
When the system is clean, a message appears indicating that the system will start to reload. When the reload is complete, a prompt appears to start the postinstallation process.
Related Commands
Command Descriptioncontinue
Returns to the Cisco Unity Express online mode.
offline
Enters the Cisco Unity Express offline mode.
restriction create
To create a restriction table, use the restriction create command in Cisco Unity Express configuration mode.
restriction table-name create
Syntax Description
Command Default
This command has no default value.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
Use the restriction create command in Cisco Unity Express configuration mode to define a new restriction table
Examples
The following example creates a restriction table called fax-restriction.
se-10-0-0-0# config tse-10-0-0-0(config)# restriction fax-restriction createRelated Commands
restriction delete
To delete a restriction table, use the restriction delete command in Cisco Unity Express configuration mode.
restriction table-name delete
Syntax Description
Command Default
This command has no default value.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
Use the restriction delete command in Cisco Unity Express configuration mode to delete a restriction table.
Examples
The following example deletes a restriction table called fax-restriction.
se-10-0-0-0# config tse-10-0-0-0(config)# restriction fax-restriction deleteRelated Commands
Command Descriptionrestriction create
Creates a restriction table.
show restriction-table
Displays information about the specified restriction tables.
restriction dial-string
To specify a dial string for a restriction table, use the restriction dial-string command in Cisco Unity Express configuration mode. To delete the dial string from the table, use the no form of this command.
restriction table-name dial-string preference preference-number pattern pattern-string
{allowed | disallowed} [insert]no restriction table-name dial-string preference preference-number
Syntax Description
Command Default
The default preference number is 1.
The default pattern is *.
The default pattern is allowed.Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Version Modification2.3
This command was introduced.
3.0
This command was modified to allow you to specify which restriction table to configure.
Usage Guidelines
The asterisk (*) in the pattern allows matches of zero or more digits. The dot (.) acts as a placeholder for exactly one digit. Include external and long-distance access codes in the dial pattern.
The default pattern * has preference 1 by default. The administrator can modify this setting.
When a subscriber tries to set up or change a phone number assigned to a device, the system verifies that the number has the allowed number of digits. If the number does not have the allowed number of digits, the subscriber receives an error message.
If the number of digits is acceptable, the system checks the number against the dial patterns in the restriction table, starting with the first pattern (preference 1). If the number does not match the first pattern, the system checks the next pattern in the table (preference 2), and so forth until a match is found. If a match is found, the system either permits or restricts the call as specified in the dial string. If no match is found, the subscriber receives an error message. The default pattern * cannot be deleted or modified.
The default pattern * is allowed by default. The administrator can modify this setting.
The system displays an error message if the preference number is less than 1 or greater than 10.
If insert is not used, the system replaces any existing dial string with the given preference with this new dial string. The system displays an error message if no existing dial string has the given preference.
Examples
The following example creates a dial-string allowing calls to area code 222.
se-10-0-0-0# config tse-10-0-0-0(config)# restriction fax-restrict dial-string preference 2 pattern 91222....... allowed insertRelated Commands
Command DescriptionSpecifies the maximum number of digits in a restricted number.
Specifies the minimum number of digits in a restricted number.
restriction max-digits
To specify the maximum number of digits for a specified restriction table, use the restriction max-digits command in the Cisco Unity Express configuration mode. To use the default value, use the no form of this command.
restriction table-name max-digits maximum-digits
no restriction table-name max-digits maximum-digits
Syntax Description
Command Default
The maximum number of digits is 1.
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Version Modification2.3
This command was introduced.
3.0
This command was modified to allow you to specify which restriction table to configure.
Usage Guidelines
This value applies only to phone devices and numeric pagers.
Maximum number of digits applies to phone numbers that a subscriber assigns to devices that will receive message notifications. When a subscriber tries to set up or change a phone number assigned to a device, the system verifies that the number has the allowed number of digits. If the number does not have the allowed number of digits, the subscriber receives an error message.
Examples
The following example sets the maximum number of digits in a phone number for message notification to 12 in a restriction table called fax-restriction.
se-10-0-0-0# config tse-10-0-0-0(config)# restriction fax-restriction msg-notification max-digits 12Related Commands
Command DescriptionSpecifies the maximum number of digits in a restricted number.
show restriction-table
Displays information about the specified restriction tables.
restriction min-digits
To specify the minimum number of digits for a specified restriction table, use the restriction min-digits command in the Cisco Unity Express configuration mode.To use the default value, use the no form of this command.
restriction table-name min-digits minimum-digits
no restriction table-name min-digits minimum-digits
Syntax Description
Command Default
The minimum number of digits is 1.
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Version Modification2.3
This command was introduced.
3.0
This command was modified to allow you to specify which restriction table to configure.
Usage Guidelines
This value applies only to phone devices and numeric pagers.
The minimum number of digits applies to phone numbers that a subscriber assigns to devices that will receive message notifications. When a subscriber tries to set up or change a phone number assigned to a device, the system verifies that the number has the allowed number of digits. If the number does not have the allowed number of digits, the subscriber receives an error message.
Examples
The following example sets the minimum number of digits in a phone number for message notification to 6 in a restriction table called fax-restriction.
se-10-0-0-0# config tse-10-0-0-0(config)# restriction fax-restriction msg-notification min-digits 6Related Commands
Command DescriptionSpecifies the maximum number of digits in a restricted number.
show restriction-table
Displays information about the specified restriction tables.