Cisco Unity Express CLI Administrator
Guide for Cisco CallManager Express,
Release 1.1.2
Corporate Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 526-4100
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
CCSP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick
Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco Certified
Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Empowering the Internet Generation,
Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ
Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing,
ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StrataView Plus, SwitchProbe, TeleRouter, The Fastest Way to Increase Your Internet Quotient, TransPath, and VCO
are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship
between Cisco and any other company. (0411R)
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 2.0
Copyright © 2003–2004, Cisco Systems, Inc.
All rights reserved.
C O N T E N T S
Preface
ix
Purpose
ix
Audience
ix
Document Conventions
x
Obtaining Documentation xi
Cisco.com xi
Ordering Documentation xi
Documentation Feedback
xi
Obtaining Technical Assistance xii
Cisco TAC Website xii
Opening a TAC Case xii
TAC Case Priority Definitions xii
Obtaining Additional Publications and Information
Software Copyrights and Licenses
xiii
xiv
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
1
Feature Overview 1
Differences Between the AIM and NM 3
Software Licenses and Factory-Set Limits 3
Administration Interfaces
5
Differences Between Cisco Unity Express and Cisco Unity
5
Interactions Between Cisco Unity Express and Cisco CME
6
Differences Between Cisco Unity Express and Cisco CME
6
Supported Platforms
Restrictions
7
7
Additional References 9
Related Cisco IOS Documents
RFCs 10
10
Installing Cisco Unity Express Software
Prerequisites
11
11
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
iii
Contents
Installing a New Cisco Unity Express Software Package 15
Activating IP Connectivity to Cisco Unity Express Software 15
EXEC and Configuration Modes 17
Entering the Command Environment 17
Displaying Cisco Unity Express Hardware and Software Versions
Exiting the Command Environment 18
Sequence of Configuration Tasks
18
19
Upgrading the Software or License Version 25
Upgrading to a New License 25
Upgrading to a New Software Image 29
What to Do Next 40
Configuring System Components
41
Configuring the SIP Proxy Server Location for Cisco Unity Express
Prerequisites 42
Example 43
What to Do Next 43
Configuring the Voice Mail Application 43
Sharing Ports Among Applications and Triggers
Prerequisites 44
Example 45
42
44
Configuring the Greeting Management System Application
46
Configuring and Managing the Auto Attendant Application
Prerequisites 47
Examples 50
Configuring Auto Attendant Prompts 51
47
Configuring Auto Attendant Scripts 53
Creating an Auto Attendant Script 53
Uploading the Auto Attendant Script File 53
Downloading an Auto Attendant Script File 53
Deleting an Auto Attendant Script File 54
Configuring SIP Triggers for the Applications
Prerequisites 54
Examples 55
Deleting a SIP Application Trigger
Prerequisites 56
Example 57
54
56
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
iv
Cisco Unity Express Release 1.1.2
Contents
Deleting an Application
Prerequisites 58
Example 59
58
Configuring System-Wide Mailbox Default Values
Configuring the MWI On and Off Extensions
Prerequisites 63
63
Checking AIM Flash Memory Wear Activity
64
Configuring Users, Groups, and Mailboxes
65
Overview
61
65
Prerequisites
65
Adding and Modifying a User 66
Privilege Levels for Users 66
Users and Mailboxes 66
Prerequisites 66
Example 69
Example 70
Adding and Modifying a Group
Prerequisites 71
Example 73
Example 74
71
Creating and Modifying a Voice Mailbox
Types of Mailboxes 75
Limitations 75
Prerequisites 76
Example 78
Unlocking a Voice Mailbox
80
Refreshing Message Waiting Indicators
Backing Up and Restoring Data
Restrictions
81
83
84
Setting Backup Parameters
Prerequisites 85
Example 86
85
Backing Up Files 87
Numbering Scheme for Backup Files
Example 88
Restoring Files
75
87
90
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
v
Contents
Example
91
Copying Configurations 92
Copying from Flash Memory to Another Location 92
Copying from the Network FTP server to Another Location 93
Copying the Flash Running Configuration to Another Location 93
Copying the Network TFTP Configuration to Another Location 94
Troubleshooting
97
Troubleshooting Guidelines 97
System Reports 97
Log Files 98
Users and Groups 98
Hardware and Software 98
Voice Mail 101
Message Waiting Indicators (MWIs)
Auto Attendant Prompts 101
Troubleshooting Commands
Advanced Configuration
101
101
105
Configuring System Engine Parameters
Prerequisites 106
Example 107
Configuring Application Parameters
Prerequisites 108
Examples 110
106
108
Configuring Multiple Triggers for an Application 111
Port Sharing Among Multiple Triggers 111
Prerequisites 111
Example 113
Configuring the Hostname
Example 115
Configuring the DNS Server
Example 116
115
116
Configuring NTP Servers 118
Adding NTP Servers 118
Removing an NTP Server 119
Displaying NTP Server Information
Configuring an External Syslog Server
Prerequisites 121
120
121
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
vi
Cisco Unity Express Release 1.1.2
Contents
Example
122
Configuring the Clock Time Zone
Examples 123
Command Reference
123
125
GLOSSARY
INDEX
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
vii
Contents
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
viii
Cisco Unity Express Release 1.1.2
Preface
This preface describes the purpose, audience, and conventions of the Cisco Unity Express CLI
Administrator Guide for Cisco CallManager Express, and provides information on obtaining related
documentation and assistance.
Purpose
The Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express describes the set of
Cisco Unity Express command-line interface (CLI) commands and tasks for installing, configuring,
managing, and maintaining Cisco Unity Express applications, such as voice mail. This guide parallels
the graphical user interface (GUI) administration tasks described in the Cisco Unity Express GUI
Administrator Guide for Cisco CallManager Express.
The focus of this guide is the Cisco Unity Express application. It does not provide information on
installation of Cisco routers, Cisco modules, the Cisco CallManager Express (CME) server, or the Cisco
IOS CLI commands. For more information about these topics, see “Additional References” on page 9.
Audience
This guide is intended for system installers and administrators who are responsible for installing,
configuring, managing, and maintaining Cisco Unity Express applications on the Cisco CME network.
You will need a working knowledge of Cisco IOS CLI command structure, Cisco routers, and
Cisco CME configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
ix
Preface
Document Conventions
Document Conventions
This guide uses the following conventions:
Table 1
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express Conventions
Convention
Description
boldface text
Boldface text is used for:
plain bold text
•
Keyboard buttons. (Example: Press Esc.)
•
Information that you enter. (Example: Enter
administrator in the User ID field.)
Plain bold text is used for:
•
Text shown on a GUI screen. (Example: User Name)
•
Keys and buttons on a GUI screen. (Example: Click
Add.)
plain bold and underlined text
Plain bold and underlined text is used to represent
icons or buttons on a GUI screen (for example, Click
Apply).
screen
Examples of information displayed on the screen are set in
Courier font.
-
Hyphens separate keys that must be pressed
simultaneously. (Example: Press Ctrl-Alt-Delete.)
(hyphen)
>
(right angle bracket)
A right angle bracket is used to separate selections that you
make on the administration screens. (Example: From the
Home menu, click Configure > Users.)
The following conventions are used to attract the attention of the reader:
Note
Caution
Timesaver
Tip
Means reader take note. Notes contain helpful suggestions or references to material not covered in the
document.
Means reader be careful. In this situation, you might do something that could result in equipment
damage or loss of data.
Means the described action saves time. You can save time by performing the action described in the
paragraph.
Means the following information will help you solve a problem. The tips information might not be
troubleshooting or even an action, but could be useful information, similar to a Timesaver.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
x
Cisco Unity Express Release 1.1.2
Preface
Obtaining Documentation
Obtaining Documentation
Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several
ways to obtain technical assistance and other technical resources. These sections explain how to obtain
technical information from Cisco Systems.
Cisco.com
You can access the most current Cisco documentation on the World Wide Web at this URL:
http://www.cisco.com/univercd/home/home.htm
You can access the Cisco website at this URL:
http://www.cisco.com
International Cisco websites can be accessed from this URL:
http://www.cisco.com/public/countries_languages.shtml
Ordering Documentation
You can find instructions for ordering documentation at this URL:
http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm
You can order Cisco documentation in these ways:
•
Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from
the Ordering tool:
http://www.cisco.com/en/US/partner/ordering/index.shtml
•
Nonregistered Cisco.com users can order documentation through a local account representative by
calling Cisco Systems Corporate Headquarters (California, USA) at 408 526-7208 or, elsewhere in
North America, by calling 800 553-NETS (6387).
Documentation Feedback
You can submit e-mail comments about technical documentation to [email protected].
You can submit comments by using the response card (if present) behind the front cover of your
document or by writing to the following address:
Cisco Systems
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883
We appreciate your comments.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xi
Preface
Obtaining Technical Assistance
Obtaining Technical Assistance
For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, the Cisco
Technical Assistance Center (TAC) provides 24-hour-a-day, award-winning technical support services,
online and over the phone. Cisco.com features the Cisco TAC website as an online starting point for
technical assistance. If you do not hold a valid Cisco service contract, please contact your reseller.
Cisco TAC Website
The Cisco TAC website provides online documents and tools for troubleshooting and resolving technical
issues with Cisco products and technologies. The Cisco TAC website is available 24 hours a day, 365
days a year. The Cisco TAC website is located at this URL:
http://www.cisco.com/tac
Accessing all the tools on the Cisco TAC website requires a Cisco.com user ID and password. If you
have a valid service contract but do not have a login ID or password, register at this URL:
http://tools.cisco.com/RPF/register/register.do
Opening a TAC Case
Using the online TAC Case Open Tool is the fastest way to open P3 and P4 cases. (P3 and P4 cases are
those in which your network is minimally impaired or for which you require product information.) After
you describe your situation, the TAC Case Open Tool automatically recommends resources for an
immediate solution. If your issue is not resolved using the recommended resources, your case will be
assigned to a Cisco TAC engineer. The online TAC Case Open Tool is located at this URL:
http://www.cisco.com/tac/caseopen
For P1 or P2 cases (P1 and P2 cases are those in which your production network is down or severely
degraded) or if you do not have Internet access, contact Cisco TAC by telephone. Cisco TAC engineers
are assigned immediately to P1 and P2 cases to help keep your business operations running smoothly.
To open a case by telephone, use one of the following numbers:
Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553-2447
For a complete listing of Cisco TAC contacts, go to this URL:
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
TAC Case Priority Definitions
To ensure that all cases are reported in a standard format, Cisco has established case priority definitions.
Priority 1 (P1)—Your network is “down” or there is a critical impact to your business operations. You
and Cisco will commit all necessary resources around the clock to resolve the situation.
Priority 2 (P2)—Operation of an existing network is severely degraded, or significant aspects of your
business operation are negatively affected by inadequate performance of Cisco products. You and Cisco
will commit full-time resources during normal business hours to resolve the situation.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xii
Cisco Unity Express Release 1.1.2
Preface
Obtaining Additional Publications and Information
Priority 3 (P3)—Operational performance of your network is impaired, but most business operations
remain functional. You and Cisco will commit resources during normal business hours to restore service
to satisfactory levels.
Priority 4 (P4)—You require information or assistance with Cisco product capabilities, installation, or
configuration. There is little or no effect on your business operations.
Obtaining Additional Publications and Information
Information about Cisco products, technologies, and network solutions is available from various online
and printed sources.
•
Cisco Marketplace provides a variety of Cisco books, reference guides, and logo merchandise. Go
to this URL to visit the company store:
http://www.cisco.com/go/marketplace/
•
The Cisco Product Catalog describes the networking products offered by Cisco Systems, as well as
ordering and customer support services. Access the Cisco Product Catalog at this URL:
http://cisco.com/univercd/cc/td/doc/pcat/
•
Cisco Press publishes a wide range of general networking, training and certification titles. Both new
and experienced users will benefit from these publications. For current Cisco Press titles and other
information, go to Cisco Press online at this URL:
http://www.ciscopress.com
•
Packet magazine is the Cisco quarterly publication that provides the latest networking trends,
technology breakthroughs, and Cisco products and solutions to help industry professionals get the
most from their networking investment. Included are networking deployment and troubleshooting
tips, configuration examples, customer case studies, tutorials and training, certification information,
and links to numerous in-depth online resources. You can access Packet magazine at this URL:
http://www.cisco.com/packet
•
iQ Magazine is the Cisco bimonthly publication that delivers the latest information about Internet
business strategies for executives. You can access iQ Magazine at this URL:
http://www.cisco.com/go/iqmagazine
•
Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering
professionals involved in designing, developing, and operating public and private internets and
intranets. You can access the Internet Protocol Journal at this URL:
http://www.cisco.com/ipj
•
Training—Cisco offers world-class networking training. Current offerings in network training are
listed at this URL:
http://www.cisco.com/en/US/learning/index.html
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xiii
Preface
Software Copyrights and Licenses
Software Copyrights and Licenses
The following software packages are distributed under the terms of the General Public License version 2 :
bash
devfsd
e2fsprogs
fileutils
findutils
gawk
grep
hrtimers
kernel2.4.18
mingetty
modutils
ncurses
net-tools
procps
sh-utils
sysklogd
syslog-ng
sysvinit
tar
textutils
utils-linux
GNU SOFTWARE
Copyright Notice:
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
Preamble
The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General
Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all
its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose
authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License
instead.) You can apply it to your programs, too.
When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure
that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source
code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you
can do these things.
To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the
rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights
that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so
they know their rights.
We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission
to copy, distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this
free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is
not the original, so that any problems introduced by others will not reflect on the original authors' reputations.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xiv
Cisco Unity Express Release 1.1.2
Preface
Software Copyrights and Licenses
Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear
that any patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution andmodification follow.
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be
distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work
based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the
Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation
is included without limitation in the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of
running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on
the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all
the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of
this License along with the Program.
You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange
for a fee.
2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy
and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that inwhole or in part contains or is derived from the Program or
any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License.
c) If the modified program normally reads commands interactivelywhen run, you must cause it, when started running for such
interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice
that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these
conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not
normally print such an announcement, your work based on the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to
those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is
a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other
licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is
to exercise the right to control the distribution of derivative or collective works based on the Program.
In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program)
on a volume of a storage or distribution medium does not bring the other work underthe scope of this License.
3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the
terms of Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of
Sections 1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost
of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be
distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is
allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an
offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete
source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts
used to control compilation and installation of the executable. However, as a special exception, the source code distributed need
not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel,
and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable.
If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xv
Preface
Software Copyrights and Licenses
4. You may not copy, modify, sublicense, or distribute the Programexcept as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this
License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated
so long as such parties remain in full compliance.
5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify
or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore,
by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do
so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from
the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any
further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by
third parties to this License.
7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent
issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this
License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your
obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at
all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies
directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from
distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the
balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances.
It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is
implemented by public license practices. Many people have made generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot impose that choice.
This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License may add an explicit geographical distribution limitation
excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License
incorporates the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such
new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies
to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version
published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose
any version ever published by the Free Software Foundation.
10. If you wish to incorporate parts of the Program into other freeprograms whose distribution conditions are different, write to
the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software
Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of
all derivatives of our free software and of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO
THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT
HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED
ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT
NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH
HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to
make it free software which everyone can redistribute and change under these terms.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xvi
Cisco Unity Express Release 1.1.2
Preface
Software Copyrights and Licenses
To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at lease the "copyright" line and a pointer to where the full notice is
found.
<one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author>
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short
notice like this when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for
details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for
details.
The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course,
the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu
items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to
sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program Gnomovision' (which makes passes at compilers) written
by James Hacker.
<signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice
This General Public License does not permit incorporating your program into proprietary programs. If your program is a
subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you
want to do, use the GNU Library General Public License instead of this License.
CURL SOFTWARE
Curl software is distributed under the terms of the copyright andpermission notice below:
COPYRIGHT AND PERMISSION NOTICE
Copyright (c) 1996 - 2002, Daniel Stenberg, <[email protected]>. All rights reserved.
Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that
the above copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale,
use or other dealings in this Software without prior written authorization of the copyright holder.
EXPAT SOFTWARE
expat software is distributed under the terms of the copyright and permission notice below:
Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd and Clark Cooper
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files
(the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xvii
Preface
Software Copyrights and Licenses
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
ZLIB SOFTWARE
zlib software is distributed under the terms of the copyright and permission notice below:
Copyright notice: (C) 1995-2002 Jean-loup Gailly and Mark Adler
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any
damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and
redistribute it freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use
this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
Jean-loup Gailly
Mark Adler
[email protected]
[email protected]
If you use the zlib library in a product, we would appreciate *not* receiving lengthy legal documents to sign. The sources are
provided for free but without warranty of any kind. The library has been entirely written by Jean-loup Gailly and Mark Adler; it
does not include third-party code.
APACHE SOFTWARE
The following software packages are distributed under APACHE software foundation license.
xerces
jakarta-oro
jakarta-tomcat
Copyright Notice:
====================================================================
The Apache Software License, Version 1.1 Copyright (c) 1999 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following
conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer
in the documentation and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must include the following acknowlegement: "This product
includes software developed by the Apache Software Foundation (http://www.apache.org/)." Alternately, this acknowlegement
may appear in the software itself, if and wherever such third-party acknowlegements normally appear.
4. The names "The Jakarta Project", "Tomcat", and "Apache Software Foundation" must not be used to endorse or promote
products derived from this software without prior written permission. For written permission, please contact [email protected].
5. Products derived from this software may not be called "Apache" nor may "Apache" appear in their names without prior written
permission of the Apache Group.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
====================================================================
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xviii
Cisco Unity Express Release 1.1.2
Preface
Software Copyrights and Licenses
This software consists of voluntary contributions made by many individuals on behalf of the Apache Software Foundation. For
more information on the Apache Software Foundation, please see <http://www.apache.org/>.
LDAP SOFTWARE
ldap software is distributed under the terms of the copyright and permission notice below:
Copyright 1998-2003 The OpenLDAP Foundation
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted only as authorized by the
OpenLDAP Public License. A copy of this license is available at http://www.OpenLDAP.org/license.html or in file LICENSE in
the top-level directory of the distribution.
OpenLDAP is a registered trademark of the OpenLDAP Foundation.
Individual files and/or contributed packages may be copyright by other parties and subject to additional restrictions.
This work is derived from the University of Michigan LDAP v3.3 distribution. Information concerning this software is available
at: http://www.umich.edu/~dirsvcs/ldap/
This work also contains materials derived from public sources. Additional information about OpenLDAP can be obtained at:
http://www.openldap.org/
Portions Copyright (c) 1992-1996 Regents of the University of Michigan.
All rights reserved.
Redistribution and use in source and binary forms are permitted provided that this notice is preserved and that due credit is given
to the University of Michigan at Ann Arbor. The name of the University may not be used to endorse or promote products derived
from this software without specific prior written permission. This software is provided ``as is'' without express or implied warranty.
GLIBC SOFTWARE
glibc software is distributed under the terms of the Lesser General Public License version 2.1 Copyright Notice:
GNU LESSER GENERAL PUBLIC LICENSE
Version 2.1, February 1999
Copyright (C) 1991, 1999 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
[This is the first released version of the Lesser GPL. It also counts as the successor of the GNU Library Public License, version
2, hence the version number 2.1.]
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public Licenses are intended to guarantee your freedom to share
and change free software--to make sure the software is free for all its users.
This license, the Lesser General Public License, applies to some specially designated software packages--typically libraries--of
the Free Software Foundation and other authors who decide to use it. You can use it too, but we suggest you first think carefully
about whether this license or the ordinary General Public License is the better strategy to use in any particular case, based on the
explanations below.
When we speak of free software, we are referring to freedom of use, not price. Our General Public Licenses are designed to make
sure that you have the freedom to distribute copies of free software (and charge for this service if you wish); that you receive source
code or can get it if you want it; that you can change the software and use pieces of it in new free programs; and that you are
informed that you can do these things.
To protect your rights, we need to make restrictions that forbid distributors to deny you these rights or to ask you to surrender
these rights. These restrictions translate to certain responsibilities for you if you distribute copies of the library or if you modify it.
For example, if you distribute copies of the library, whether gratis or for a fee, you must give the recipients all the rights that we
gave you. You must make sure that they, too, receive or can get the source code. If you link other code with the library, you must
provide complete object files to the recipients, so that they can relink them with the library after making changes to the library and
recompiling it. And you must show them these terms so they know their rights.
We protect your rights with a two-step method: (1) we copyright the library, and (2) we offer you this license, which gives you
legal permission to copy, distribute and/or modify the library.
To protect each distributor, we want to make it very clear that there is no warranty for the free library. Also, if the library is
modified by someone else and passed on, the recipients should know that what they have is not the original version, so that the
original author's reputation will not be affected by problems that might be introduced by others.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xix
Preface
Software Copyrights and Licenses
Finally, software patents pose a constant threat to the existence of any free program. We wish to make sure that a company cannot
effectively restrict the users of a free program by obtaining a restrictive license from a patent holder. Therefore, we insist that any
patent license obtained for a version of the library must be consistent with the full freedom of use specified in this license.
Most GNU software, including some libraries, is covered by the ordinary GNU General Public License. This license, the GNU
Lesser General Public License, applies to certain designated libraries, and is quite different from the ordinary General Public
License. We use this license for certain libraries in order to permit linking those libraries into non-free programs.
When a program is linked with a library, whether statically or using a shared library, the combination of the two is legally speaking
a combined work, a derivative of the original library. The ordinary General Public License therefore permits such linking only if
the entire combination fits its criteria of freedom. The Lesser General Public License permits more lax criteria for linking other
code with the library.
We call this license the "Lesser" General Public License because it does Less to protect the user's freedom than the ordinary
General Public License. It also provides other free software developers Less of an advantage over competing non-free programs.
These disadvantages are the reason we use the ordinary General Public License for many libraries. However, the Lesser license
provides advantages in certain special circumstances.
For example, on rare occasions, there may be a special need to encourage the widest possible use of a certain library, so that it
becomes a de-facto standard. To achieve this, non-free programs must be allowed to use the library. A more frequent case is that
a free library does the same job as widely used non-free libraries. In this case, there is little to gain by limiting the free library to
free software only, so we use the Lesser General Public License.
In other cases, permission to use a particular library in non-free programs enables a greater number of people to use a large body
of free software. For example, permission to use the GNU C Library in non-free programs enables many more people to use the
whole GNU operating system, as well as its variant, the GNU/Linux operating system.
Although the Lesser General Public License is Less protective of the users' freedom, it does ensure that the user of a program
that is linked with the Library has the freedom and the wherewithal to run that program using a modified version of the Library.
The precise terms and conditions for copying, distribution and modification follow. Pay close attention to the difference between
a "work based on the library" and a "work that uses the library". The former contains code derived from the library, whereas the
latter must be combined with the library in order to run.
GNU LESSER GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License Agreement applies to any software library or other program which contains a notice placed by the copyright holder
or other authorized party saying it may be distributed under the terms of this Lesser General Public License (also called "this
License"). Each licensee is addressed as "you".
A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs
(which use some of those functions and data) to form executables.
The "Library", below, refers to any such software library or work which has been distributed under these terms. A "work based
on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library
or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter,
translation is included without limitation in the term "modification".)
"Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source
code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to
control compilation and installation of the library.
Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of
running a program using the Library is not restricted, and output from such a program is covered only if its contents constitute a
work based on the Library (independent of the use of the Library in a tool for writing it). Whether that is true depends on what
the Library doesand what the program that uses the Library does.
1. You may copy and distribute verbatim copies of the Library's complete source code as you receive it, in any medium, provided
that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep
intact all the notices that refer to this License and to the absence of any warranty; and distribute a copy of this License along with
the Library.
You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange
for a fee.
2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on the Library, and copy
and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:
a) The modified work must itself be a software library.
b) You must cause the files modified to carry prominent notices stating that you changed the files and the date of any change.
c) You must cause the whole of the work to be licensed at no charge to all third parties under the terms of this License.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xx
Cisco Unity Express Release 1.1.2
Preface
Software Copyrights and Licenses
d) If a facility in the modified Library refers to a function or a table of data to be supplied by an application program that uses
the facility, other than as an argument passed when the facility is invoked, then you must make a good faith effort to ensure that,
in the event an application does not supply such function or table, the facility still operates, and performs whatever part of its
purpose remains meaningful.
(For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the
application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be
optional: if the application does not supply it, the square root function must still compute square roots.)
These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Library,
and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to
those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is
a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other
licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is
to exercise the right to control the distribution of derivative or collective works based on the Library.
In addition, mere aggregation of another work not based on the Library with the Library (or with a work based on the Library) on
a volume of a storage or distribution medium does not bring the other work under the scope of this License.
3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to a given copy of the
Library. To do this, you must alter all the notices that refer to this License, so that they refer to the ordinary GNU General Public
License, version 2, instead of to this License. (If a newer version than version 2 of the ordinary GNU General Public License has
appeared, then you can specify that version instead if you wish.) Do not make any other change in these notices.
Once this change is made in a given copy, it is irreversible for that copy, so the ordinary GNU General Public License applies to
all subsequent copies and derivative works made from that copy.
This option is useful when you wish to copy part of the code of the Library into a program that is not a library.
4. You may copy and distribute the Library (or a portion or derivative of it, under Section 2) in object code or executable form
under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine-readable
source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software
interchange.
If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy
the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not
compelled to copy the source along with the object code.
5. A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled
or linked with it, is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and
therefore falls outside the scope of this License.
However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because
it contains portions of the Library), rather than a "work that uses the library". The executable is therefore covered by this License.
Section 6 states terms for distribution of such executables.
When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may
be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can
be linked without the Library, or if the work is itself a library. The threshold for this to be true is not precisely defined by law.
If such an object file uses only numerical parameters, data structure layouts and accessors, and small macros and small inline
functions (ten lines or less in length), then the use of the object file is unrestricted, regardless of whether it is legally a derivative
work. (Executables containing this object code plus portions of the Library will still fall under Section 6.)
Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6.
Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself.
6. As an exception to the Sections above, you may also combine or link a "work that uses the Library" with the Library to produce
a work containing portions of the Library, and distribute that work under terms of your choice, provided that the terms permit
modification of the work for the customer's own use and reverse engineering for debugging such modifications.
You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered
by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include
the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License. Also, you
must do one of these things:
a) Accompany the work with the complete corresponding machine-readable source code for the Library including whatever
changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked
with the Library, with the complete machine-readable "work that uses the Library", as object code and/or source code, so that the
user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood
that the user who changes the contents of definitions files in the Library will not necessarily be able to recompile the application
to use the modified definitions.)
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xxi
Preface
Software Copyrights and Licenses
b) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (1) uses at run time
a copy of the library already present on the user's computer system rather than copying library functions into the executable, and
(2) will operate properly with a modified version of the library, if the user installs one, as long as the modified version is
interface-compatible with the version that the work was made with.
c) Accompany the work with a written offer, valid for at least three years, to give the same user the materials specified in
Subsection 6a, above, for a charge no more than the cost of performing this distribution.
d) If distribution of the work is made by offering access to copy from a designated place, offer equivalent access to copy the
above specified materials from the same place.
e) Verify that the user has already received a copy of these materials or that you have already sent this user a copy.
For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for
reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that
is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating
system on which the executable runs, unless that component itself accompanies the executable.
It may happen that this requirement contradicts the license restrictions of other proprietary libraries that do not normally
accompany the operating system. Such a contradiction means you cannot use both them and the Library together in an executable
that you distribute.
7. You may place library facilities that are a work based on the Library side-by-side in a single library together with other library
facilities not covered by this License, and distribute such a combined library, provided that the separate distribution of the work
based on the Library and of the other library facilities is otherwise permitted, and provided that you do these two things:
a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library
facilities. This must be distributed under the terms of the Sections above.
b) Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining
where to find the accompanying uncombined form of the same work.
8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License.
Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate
your rights under this License. However, parties who have received copies, or rights, from you under this License will not have
their licenses terminated so long as such parties remain in full compliance.
9. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to
modify or distribute the Library or its derivative works. These actions are prohibited by law if you do not accept this License.
Therefore, by modifying or distributing the Library (or any work based on the Library), you indicate your acceptance of this
License to do so, and all its terms and conditions for copying, distributing or modifying the Library or works based on it.
10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from
the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions. You may not impose
any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance
by third parties with this License.
11. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent
issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this
License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your
obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Library at all.
For example, if a patent license would not permit royalty-free redistribution of the Library by all those who receive copies directly
or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution
of the Library.
If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is
intended to apply, and the section as a whole is intended to apply in other circumstances.
It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the integrity of the free software distribution system which is
implemented by public license practices. Many people have made generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot impose that choice.
This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.
12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Library under this License may add an explicit geographical distribution limitation
excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License
incorporates the limitation as if written in the body of this License.
13. The Free Software Foundation may publish revised and/or new versions of the Lesser General Public License from time to
time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
Each version is given a distinguishing version number. If the Library specifies a version number of this License which applies to
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xxii
Cisco Unity Express Release 1.1.2
Preface
Software Copyrights and Licenses
it and "any later version", you have the option of following the terms and conditions either of that version or of any later version
published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version
ever published by the Free Software Foundation.
14. If you wish to incorporate parts of the Library into other free programs whose distribution conditions are incompatible with
these, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the
Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving
the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO
WARRANTY
15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO
THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME THE
COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT
HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED
ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT
NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH
HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Libraries
If you develop a new library, and you want it to be of the greatest possible use to the public, we recommend making it free software
that everyone can redistribute and change. You can do so by permitting redistribution under these terms (or, alternatively, under
the terms of the ordinary General Public License).
To apply these terms, attach the following notices to the library. It is safest to attach them to the start of each source file to most
effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full
notice is found.
<one line to give the library's name and a brief idea of what it does.> Copyright (C) <year> <name of author>
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License
as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Also add information on how to contact you by electronic and paper mail.
You should also get your employer (if you work as a programmer) or
your school, if any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the library `Frob' (a library for tweaking knobs) written by James
Random Hacker.
<signature of Ty Coon>, 1 April 1990 Ty Coon, President of Vice
That's all there is to it!
BSD LICENSE
The following software packages are distributed under BSD license:
libpcap
tcpdump
tftp-hpa
Copyright Notice:
License: BSD
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following
conditions are met:
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xxiii
Preface
Software Copyrights and Licenses
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer
in the documentation and/or other materials provided with the distribution.
3. The names of the authors may not be used to endorse or promote products derived from this software without specific prior
written permission.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE.
NTP SOFTWARE
ntp software is distributed under the terms of the copyright and permission notice below:
Copyright Notice [sheepb.jpg] "Clone me," says Dolly sheepishly
_________________________________________________________________
The following copyright notice applies to all files collectively called the Network Time Protocol Version 4 Distribution. Unless
specifically declared otherwise in an individual file, this notice applies as if the text was explicitly included in the file.
***********************************************************************
Copyright (c) David L. Mills 1992-2001 Permission to use, copy, modify, and distribute this software and its documentation for
any purpose and without fee is hereby granted, provided that the above copyright notice appears in all copies and that both the
copyright notice and this permission notice appear in supporting documentation, and that the name University of Delaware not be
used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. The University
of Delaware makes no representations about the suitability this software for any purpose. It is provided "as is" without express or
implied warranty.
***********************************************************************
The following individuals contributed in part to the Network Time Protocol Distribution Version 4 and are acknowledged as
authors of this work.
1. [1]Mark Andrews <[email protected]> Leitch atomic clock controller
2. [2]Bernd Altmeier <[email protected]> hopf Elektronik serial line and PCI-bus devices
3. [3]Viraj Bais <[email protected]> and [4]Clayton Kirkwood <[email protected]> port to WindowsNT
3.5
4. [5]Michael Barone <michael,[email protected]> GPSVME fixes
5. [6]Karl Berry <[email protected]> syslog to file option
6. [7]Greg Brackley <[email protected]> Major rework of WINNT port. Clean up recvbuf and iosignal code into
separate modules.
7. [8]Marc Brett <[email protected]> Magnavox GPS clock driver
8. [9]Piete Brooks <[email protected]> MSF clock driver, Trimble PARSE support
9. [10]Reg Clemens <[email protected]> Oncore driver (Current maintainer)
10. [11]Steve Clift <[email protected]> OMEGA clock driver
11. [12]Casey Crellin <[email protected]> vxWorks (Tornado) port and help with target configuration
12. [13]Sven Dietrich <[email protected]> Palisade reference clock driver, NT adj. residuals, integrated Greg's Winnt
port.
13. [14]John A. Dundas III <[email protected]> Apple A/UX port
14. [15]Torsten Duwe <[email protected]> Linux port
15. [16]Dennis Ferguson <[email protected]> foundation code for NTP Version 2 as specified in RFC-1119
16. [17]Glenn Hollinger <[email protected]> GOES clock driver
17. [18]Mike Iglesias <[email protected]> DEC Alpha port
18. [19]Jim Jagielski <[email protected]> A/UX port
19. [20]Jeff Johnson <[email protected]> massive prototyping overhaul
20. [21]Hans Lambermont <[email protected]> or [22]<[email protected]> ntpsweep
21. [23]Poul-Henning Kamp <[email protected]> Oncore driver (Original author)
22. [24]Frank Kardel [25]<[email protected]> PARSE <GENERIC> driver (14 reference clocks),
STREAMS modules for PARSE, support scripts, syslog cleanup
23. [26]William L. Jones <[email protected]> RS/6000 AIX modifications, HPUX modifications
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xxiv
Cisco Unity Express Release 1.1.2
Preface
Software Copyrights and Licenses
24. [27]Dave Katz <[email protected]> RS/6000 AIX port
25. [28]Craig Leres <[email protected]> 4.4BSD port, ppsclock, Magnavox GPS clock driver
26. [29]George Lindholm <[email protected]> SunOS 5.1 port
27. [30]Louis A. Mamakos <[email protected]> MD5-based authentication
28. [31]Lars H. Mathiesen <[email protected]> adaptation of foundation code for Version 3 as specified in RFC-1305
29. [32]David L. Mills <[email protected]> Version 4 foundation: clock discipline, authentication, precision kernel; clock drivers:
Spectracom, Austron, Arbiter, Heath, ATOM, ACTS, KSI/Odetics; audio clock drivers: CHU, WWV/H, IRIG
30. [33]Wolfgang Moeller <[email protected]> VMS port
31. [34]Jeffrey Mogul <[email protected]> ntptrace utility
32. [35]Tom Moore <[email protected]> i386 svr4 port
33. [36]Kamal A Mostafa <[email protected]> SCO OpenServer port
34. [37]Derek Mulcahy <[email protected]> and [38]Damon Hart-Davis <[email protected]> ARCRON MSF clock driver
35. [39]Rainer Pruy <[email protected]> monitoring/trap scripts, statistics file handling
36. [40]Dirce Richards <[email protected]> Digital UNIX V4.0 port
37. [41]Wilfredo Sánchez <[email protected]> added support for NetInfo
38. [42]Nick Sayer <[email protected]> SunOS streams modules
39. [43]Jack Sasportas <[email protected]> Saved a Lot of space on the stuff in the html/pic/ subdirectory
40. [44]Ray Schnitzler <[email protected]> Unixware1 port
41. [45]Michael Shields <[email protected]> USNO clock driver
42. [46]Jeff Steinman <[email protected]> Datum PTS clock driver
43. [47]Harlan Stenn <[email protected]> GNU automake/autoconfigure makeover, various other bits (see the ChangeLog)
44. [48]Kenneth Stone <[email protected]> HP-UX port
45. [49]Ajit Thyagarajan <[email protected]>IP multicast/anycast support
46. [50]Tomoaki TSURUOKA <[email protected]>TRAK clock driver
47. [51]Paul A Vixie <[email protected]> TrueTime GPS driver, generic TrueTime clock driver
48. [52]Ulrich Windl <[email protected]> corrected and validated HTML documents according to the HTML
DTD
_________________________________________________________________
[53]gif
[54]David L. Mills <[email protected]>
References
1. mailto:[email protected]
2. mailto:[email protected]
3. mailto:[email protected]
4. mailto:[email protected]
5. mailto:[email protected]
6. mailto:[email protected]
7. mailto:[email protected]
8. mailto:[email protected]
9. mailto:[email protected]
10. mailto:[email protected]
11. mailto:[email protected]
12. mailto:[email protected]
13. mailto:[email protected]
14. mailto:[email protected]
15. mailto:[email protected]
16. mailto:[email protected]
17. mailto:[email protected]
18. mailto:[email protected]
19. mailto:jagubox.gsfc.nasa.gov
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xxv
Preface
Software Copyrights and Licenses
20. mailto:[email protected]
21. mailto:[email protected]
22. mailto:[email protected]
23. mailto:[email protected]
24. http://www4.informatik.uni-erlangen.de/~kardel
25. mailto:[email protected]
26. mailto:[email protected]
27. mailto:[email protected]
28. mailto:[email protected]
29. mailto:[email protected]
30. mailto:[email protected]
31. mailto:[email protected]
32. mailto:[email protected]
33. mailto:[email protected]
34. mailto:[email protected]
35. mailto:[email protected]
36. mailto:[email protected]
37. mailto:[email protected]
38. mailto:[email protected]
39. mailto:[email protected]
40. mailto:[email protected]
41. mailto:[email protected]
42. mailto:[email protected]
43. mailto:[email protected]
44. mailto:[email protected]
45. mailto:[email protected]
46. mailto:pebbles.jpl.nasa.gov
47. mailto:[email protected]
48. mailto:[email protected]
49. mailto:[email protected]
50. mailto:[email protected]
51. mailto:[email protected]
52. mailto:[email protected]
53. file://localhost/backroom/ntp-stable/html/index.htm
54. mailto:[email protected]
OPENSSL SOFTWARE
openssl software is distributed under the terms of the licenses from the OpenSSL Project and Eric Young ([email protected]).
Both licenses are included below:
OpenSSL License
--------------====================================================================
Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following
conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer
in the documentation and/or other materials provided with the distribution.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xxvi
Cisco Unity Express Release 1.1.2
Preface
Software Copyrights and Licenses
3. All advertising materials mentioning features or use of this software must display the following acknowledgment: "This product
includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote products derived from this
software without prior written permission. For written permission, please contact [email protected].
5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their names without prior
written permission of the OpenSSL Project.
6. Redistributions of any form whatsoever must retain the following acknowledgment: "This product includes software developed
by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)"
THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY EXPRESSED OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
OF SUCH DAMAGE.
* ====================================================================
This product includes cryptographic software written by Eric Young ([email protected]). This product includes software written
by Tim Hudson ([email protected]).
Original SSLeay License
----------------------Copyright (C) 1995-1998 Eric Young ([email protected]) All rights reserved.
This package is an SSL implementation written by Eric Young ([email protected]). The implementation was written so as to
conform with Netscapes SSL.
This library is free for commercial and non-commercial use as long as the following conditions are aheared to. The following
conditions apply to all code found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not just the SSL code. The SSL
documentation included with this distribution is covered by the same copyright terms except that the holder is Tim Hudson
([email protected]).
Copyright remains Eric Young's, and as such any Copyright notices in the code are not to be removed. If this package is used in a
product, Eric Young should be given attribution as the author of the parts of the library used. This can be in the form of a textual
message at program startup or in documentation (online or textual) provided with the package. Redistribution and use in source
and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer
in the documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software must display the following acknowledgement: "This
product includes cryptographic software written by Eric Young ([email protected])" The word 'cryptographic' can be left out if
the rouines from the library being used are not cryptographic related :-).
4. If you include any Windows specific code (or a derivative thereof) from the apps directory (application code) you must include
an acknowledgement: "This product includes software written by Tim Hudson ([email protected])"
THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
The licence and distribution terms for any publically available version or derivative of this code cannot be changed. i.e. this code
cannot simply be copied and put under another distribution licence [including the GNU Public Licence.]
PCRE LICENSE
PCRE is a library of functions to support regular expressions whose syntax and semantics are as close as possible to those of the
Perl 5 language.
Written by: Philip Hazel <[email protected]>
University of Cambridge Computing Service,
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xxvii
Preface
Software Copyrights and Licenses
Cambridge, England. Phone: +44 1223 334714.
Copyright (c) 1997-2001 University of Cambridge
Permission is granted to anyone to use this software for any purpose on any computer system, and to redistribute it freely, subject
to the following restrictions:
1. This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
2. The origin of this software must not be misrepresented, either by explicit claim or by omission. In practice, this means that if
you use PCRE in software which you distribute to others, commercially or otherwise, you must put a sentence like this
Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and
copyright by the University of Cambridge, England. somewhere reasonably visible in your documentation and in any relevant files
or online help data or similar. A reference to the ftp site for the source, that is, to
ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/ should also be given in the documentation.
3. Altered versions must be plainly marked as such, and must not be misrepresented as being the original software.
4. If PCRE is embedded in any software that is released under the GNU General Purpose Licence (GPL), or Lesser General Purpose
Licence (LGPL), then the terms of that licence shall supersede any condition above with which it is incompatible.
The documentation for PCRE, supplied in the "doc" directory, is distributed under the same terms as the software itself.
End
POSTGRESQL SOFTWARE
PostgreSQL software is distributed under the terms of the copyright and permission notice below:
COPYRIGHT NOTICE: PostgreSQL Database Management System (formerly known as Postgres, then as Postgres95)
Portions Copyright (c) 1996-2001, The PostgreSQL Global Development Group
Portions Copyright (c) 1994, The Regents of the University of California
Permission to use, copy, modify, and distribute this software and its documentation for any purpose, without fee, and without a
written agreement is hereby granted, provided that the above copyright notice and this paragraph and the following two paragraphs
appear in all copies.
IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE
OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED
OF THE POSSIBILITY OF SUCH DAMAGE.
THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO
OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
TCL SOFTWARE
tcl software is distributed under the terms of the copyright and permission notice below:
COPYRIGHT NOTICE: This software is copyrighted by the Regents of the University of California, Sun Microsystems, Inc.,
Scriptics Corporation, ActiveState Corporation and other parties. The following terms apply to all files associated with the
software unless explicitly disclaimed in individual files.
The authors hereby grant permission to use, copy, modify, distribute, and license this software and its documentation for any
purpose, provided that existing copyright notices are retained in all copies and that this notice is included verbatim in any
distributions. No written agreement, license, or royalty fee is required for any of the authorized uses. Modifications to this software
may be copyrighted by their authors and need not follow the licensing terms described here, provided that the new terms are clearly
indicated on the first page of each file where they apply.
IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE, ITS
DOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND
DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
MODIFICATIONS.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xxviii
Cisco Unity Express Release 1.1.2
Preface
Software Copyrights and Licenses
GOVERNMENT USE: If you are acquiring this software on behalf of the U.S. government, the Government shall have only
"Restricted Rights" in the software and related documentation as defined in the Federal Acquisition Regulations (FARs) in Clause
52.227.19 (c) (2). If you are acquiring the software on behalf of the Department of Defense, the software shall be classified as
"Commercial Computer Software" and the Government shall have only "Restricted Rights" as defined in Clause 252.227-7013 (c)
(1) of DFARs. Notwithstanding the foregoing, the authors grant the U.S. Government and others acting in its behalf permission
to use and distribute the software in accordance with the terms specified in this license.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
xxix
Preface
Software Copyrights and Licenses
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
xxx
Cisco Unity Express Release 1.1.2
Introduction to Cisco Unity Express Voice Mail
and Auto Attendant
The Cisco Unity Express voice mail and auto attendant applications work with Cisco CallManager
Express (CME) to provide small- and medium-sized companies with the capability to:
•
Create and maintain voice mailboxes for onsite telephone users. Release 1.1 supports up to 100
mailboxes; earlier releases support up to 50 mailboxes. The maximum number of mailboxes depends
on the hardware module and license agreement purchased for Cisco Unity Express.
•
Record and upload messages for callers to hear when they dial the company’s telephone number, and
prompts to guide the callers to specific extensions or employees.
This chapter describes the Cisco Unity Express application and contains the following sections:
•
Feature Overview, page 1
•
Administration Interfaces, page 5
•
Differences Between Cisco Unity Express and Cisco Unity, page 5
•
Interactions Between Cisco Unity Express and Cisco CME, page 6
•
Differences Between Cisco Unity Express and Cisco CME, page 6
•
Supported Platforms, page 7
•
Restrictions, page 7
•
Additional References, page 9
Feature Overview
Cisco Unity Express Release 1.1.2 offers the following features in addition to those in Releases 1.1 and
1.0:
•
Support for an advanced integration module (AIM) with 1GB flash memory.
•
New command-line interface (CLI) commands that display compact flash capacity and NTP server
configuration information (source, servers, and associations).
Cisco Unity Express Release 1.1 features:
•
AIM card with network connectivity through the PCI interface and access to Cisco IOS software and
the console using back-to-back Ethernet through the parallel interface. No external interfaces or
cabling is required.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
1
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
Feature Overview
Note
•
Script editor to create custom scripts for handling incoming calls to the automated attendant (AA).
Activating a custom script deactivates the default auto attendant script that ships with
Cisco Unity Express. The default script cannot be modified. The network module (NM) and the
AIM supports up to four customized auto attendants.
•
Recording of alternate AA greetings and prompts that can be uploaded or downloaded as needed.
These alternate greetings and prompts are in addition to the default greetings and prompts that ship
with Cisco Unity Express. The NM supports up to 50 alternate prompts. The AIM supports up to 25
alternate prompts.
•
Access from the telephone user interface (TUI) to a greeting management system (GMS) for
recording alternate greetings and prompts. Users with administrative privileges have access to the
GMS.
We highly recommend attaching an uninterruptible power supply (UPS) to the router housing the
Cisco Unity Express module. Any reliable UPS unit provides continuous power to maintain the
operation of the router and the Cisco Unity Express module. Consider the unit’s capacity and run time
because power consumption differs among Cisco platforms. Ideally, a UPS should include a signaling
mechanism that directs the router to shut down Cisco Unity Express properly and then powers off the
router.
Cisco Unity Express Release 1.0 features:
•
Linux-based software installed on a module card that is installed in the Cisco CME router. (See the
“Supported Platforms” on page 7.) The software includes the operating system, application
software, and ordered license information.
•
Network module card with access to Cisco IOS software using back-to-back Ethernet and console.
No external interfaces or cabling is required.
•
Four orderable license packages. A license must be ordered for each voice mail system. See
“Software Licenses and Factory-Set Limits” on page 3 for the system capacities available with each
license.
•
Spare modules with factory installed software and license. Upgrades to larger capacity require
purchase of a license and download of the license file.
•
Upgrades or downgrades from one license size to another.
•
Two administrative interfaces. (See the “Administration Interfaces” on page 5.)
•
An integrated administration GUI for both Cisco Unity Express and Cisco CME. The integrated
interface permits configuration of some Cisco CME parameters, such as telephones and extensions.
•
Bulk provisioning of multiple sites using CLI scripts not provided by Cisco Unity Express. Systems
are administered individually.
•
Systems accessible anywhere on the IP network. If the Cisco Unity Express installer uses TFTP; the
site running the installer must be closely located to the TFTP server. All other functions use FTP,
which allows the servers to be anywhere in the IP network.
•
Manual backup and restore using an FTP server located anywhere in the customer network.
•
System reports and log files for troubleshooting.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
2
Cisco Unity Express Release 1.1.2
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
Feature Overview
Differences Between the AIM and NM
Release 1.1.2 supports both the AIM and the NM. Cisco Unity Express features work the same way on
both modules with the following exceptions:
•
The AIM is a 4-port module that stores a maximum of 50 voice mailboxes. The 512 MB flash version
of the AIM supports 8 hours of voice messages while the 1 GB flash version of the AIM supports
14 hours of voice messages. The NM is an 8-port module that stores a maximum of 100 voice
mailboxes and 100 hours of voice messages.
•
A trace or log command issued on the NM automatically saves the data to the disk. On the AIM,
the trace and log data are not saved to flash memory. A new Cisco Unity Express CLI command is
available to save the data to the AIM flash memory.
•
Cisco Unity Express tracks the use and wear activity of the AIM flash memory. This tracking is not
necessary for the NM. The CLI command show interface ide 0 command and the GUI option
Reports > System display the flash memory wear data.
Software Licenses and Factory-Set Limits
Factory-set system limits are determined by the ordered license. Limits for the NM are shown in Table 2
and Table 3. Limits for the AIM are shown in Table 4 and Table 5.
Table 2
System Capacities for Mailboxes, Storage Hours, Ports, Scripts, and Prompts on the NM
Cisco Unity Express
License/Software SKU
Total Mailbox Default
Storage
Mailbox Size
(Hours)
(Minutes)
Number of Number of
Ports
Scripts
Number of
Prompts
SCUE-12CME-1.1.2
100
353
4
8
50
SCUE-25CME-1.1.2
100
171
4
8
50
SCUE-50CME-1.1.2
100
92
8
8
50
SCUE-100CME-1.1.2
100
50
8
8
50
Table 3
Maximum Number of Mailboxes, Groups, Owners, and Members on the NM
Cisco Unity Express
License/Software SKU
Number of
Personal
Mailboxes
Number of
General
Delivery
Mailboxes
Number of
Groups
Number of
Owners
Number of
Members
SCUE-12CME-1.1.2
12
5
20
400
880
SCUE-25CME-1.1.2
25
10
20
400
1000
SCUE-50CME-1.1.2
50
15
30
400
1000
SCUE-100CME-1.1.2
100
20
40
400
1000
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
3
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
Feature Overview
Table 4
System Capacities for Mailboxes, Storage Hours, Ports, Scripts, and Prompts on the AIM
Cisco Unity Express
License/Software SKU
Total
Mailbox
Storage
(Hours)1
Default
Mailbox Size
(Minutes)
Number of
Ports
Number of
Scripts
Number of
Prompts
SCUE-12CME-1.1.2
8 (512 MB) 28
14 (1 GB)
4
4
25
SCUE-25CME-1.1.2
8 (512 MB) 13
14 (1 GB)
4
4
25
SCUE-50CME-1.1.2
8 (512 MB) 7
14 (1 GB)
4
4
25
1. Two different versions of the AIM are supported: the 512 MB flash memory version and the 1 GB flash memory version.
The amount of mailbox storage hours supported depends on which AIM version is being used.
Table 5
Maximum Number of Mailboxes, Groups, Owners, and Members on the AIM
Cisco Unity Express
License/Software SKU
Number of
Personal
Mailboxes
Number of
General
Delivery
Mailboxes
Number of
Groups
Number of
Owners
Number of
Members
SCUE-12CME-1.1.2
12
5
20
100
200
SCUE-25CME-1.1.2
25
10
20
100
200
SCUE-50CME-1.1.2
50
15
20
100
200
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
4
Cisco Unity Express Release 1.1.2
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
Administration Interfaces
Administration Interfaces
Cisco Unity Express offers two administration interfaces:
•
Graphical user interface (GUI)—This user-friendly, web-based interface permits administration of
all voice mail and auto attendant functions and some Cisco CME information, such as extensions,
telephones, and some system-wide parameters.
The GUI is targeted for administrators familiar with web-based applications and who have little or
no experience with Cisco IOS command structure. Refer to the Cisco Unity Express GUI
Administrator Guide for Cisco CallManager Express for the configuration procedures using the GUI
menus and screens.
•
Command-line interface (CLI)—This text-based interface has the same administration and
configuration capabilities as the GUI. Installation, upgrade, and troubleshooting functions are
available only through the CLI commands. The administrator accesses this interface through a
Telnet session to the router.
The CLI is targeted for installers, resellers, support personnel, and others familiar with Cisco IOS
command structure and routers. For them, accessing the system using the CLI may be easier than
using the GUI, especially for troubleshooting, scripting, and bulk provisioning of many sites. See
“Entering the Command Environment” on page 17 for the instructions to enter the CLI environment.
The Cisco Unity Express CLI commands have a structure very similar to Cisco IOS CLI commands.
However, the Cisco Unity Express CLI commands do not affect the Cisco IOS software
configuration. After you have logged in to the Cisco Unity Express module, the command
environment is no longer the Cisco IOS environment.
Error messages in Cisco Unity Express are not always the same as error messages in the Cisco IOS
environment.
The GUI and CLI are accessible from a PC or server anywhere in the IP network. To access the GUI, use
Microsoft Internet Explorer Version 6.0 or a later release. Cisco Unity Express does not support the
Netscape browser. To access the CLI, Telnet to the router, then use a session command.
Differences Between Cisco Unity Express and Cisco Unity
Cisco Unity Express is not the same application as Cisco Unity, although both of them are in the Cisco
family of voice messaging products, and the differences are:
•
Cisco Unity is a Microsoft Windows-based application and uses the Microsoft Windows operating
system’s messaging infrastructure. Cisco Unity Express is a Linux-based application.
•
Cisco Unity is usually deployed in a central location that can be networked with multiple sites.
Cisco Unity Express Release 1.1.2 can be deployed in standalone locations that serve the local
users.
However, a Cisco Unity Express system can be administered from any location that has IP
connectivity with the router housing the Cisco Unity Express application. If several sites in a
network use Cisco Unity Express, they can be administered individually from a single PC or server.
The administrator opens a browser on a PC or server to the GUI at each site or opens a Telnet session
to the CLI at each site.
•
Cisco Unity supports 100 or more mailboxes and Cisco Unity Express supports 100 or fewer
mailboxes.
•
Cisco Unity has a larger set of features than does Cisco Unity Express Release 1.1.2.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
5
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
Interactions Between Cisco Unity Express and Cisco CME
Cisco Unity Express uses Cisco Unity Release 3.1 voice-mail prompt recordings and prompt flow,
which provides the end user with the same voice-mail look-and-feel.
Interactions Between Cisco Unity Express and Cisco CME
Cisco CME is the software that controls the telephony functions. Cisco CME resides on a router, which
accepts incoming and outgoing calls to your network. Cisco CME contains a call agent, which decides
where an incoming or outgoing call should be sent. Cisco CME has a database of information that
contains the telephone hardware identifications, extension numbers associated with the telephones, users
on the system, logins, routing destinations, call handling features, and other system-wide parameters.
Cisco Unity Express is an application that enhances Cisco CME by providing the voice messaging and
automated attendant capabilities. The Cisco Unity Express module contains the voice mail and auto
attendant software. During the system installation process, the installer inserts this module into the
Cisco CME router. A Cisco Unity Express database contains information about the voice mailboxes,
auto attendant prompts, and voice messages. The Cisco Unity Express and Cisco CME databases are
synchronized to ensure that calls are handled correctly and voice messages are received and stored
properly.
The integrated Cisco Unity Express and Cisco CME administration software allows you to configure the
voice mail and auto attendant parameters and some of the Cisco CME parameters, such as extensions
and telephones. As you go through the initialization and configuration procedures, be sure to save your
data so that both databases have current information.
Differences Between Cisco Unity Express and Cisco CME
Cisco Unity Express is not the same application as Cisco CME, although both of them are in the Cisco
family of voice messaging products, and the differences are:
•
Cisco CME requires a web administrator to configure the router and other system components.
Cisco CME users and administrators are stored in the Cisco CME database. Cisco CME does not
treat the web administrator as a telephone user.
Cisco Unity Express permits configured Cisco CME users to be copied into the Cisco Unity Express
database. The Cisco CME administrator ID cannot be copied to the Cisco Unity Express database
and, therefore, cannot be assigned as the administrator ID for Cisco Unity Express.
Caution
Before starting the configuration using the GUI, the Cisco CME administrator must configure at least
one telephone user on Cisco CME who will be copied to Cisco Unity Express during the initialization
phase and designated as the Cisco Unity Express administrator. You need the Cisco Unity Express
administrator’s user ID and password to log back in to Cisco Unity Express GUI after the initialization
process is completed.
•
Cisco Unity Express allows only letters, numbers, and the characters underscore (_), dot (.), and
dash (-) in user IDs. User IDs must start with a letter. Any Cisco CME user IDs that contain other
characters cannot be copied into the Cisco Unity Express database.
•
Spaces are not allowed in passwords. Acceptable password characters are lowercase letters a to z,
uppercase letters A to Z, digits 0 to 9, and the following symbols: - , . + = _ ! @ # $ ^ * ( ) ? / ~ < >
&%
•
Passwords are case sensitive.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
6
Cisco Unity Express Release 1.1.2
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
Supported Platforms
Supported Platforms
Hardware Platforms
•
Cisco 2600XM series routers
•
Cisco 2691 router
•
Cisco 3700 series routers
•
Cisco 3800 series routers
•
Cisco Unity Express network module
•
Cisco Unity Express advanced integration module
Software Platforms
•
Cisco IOS Release 12.3(4)T or a later release for the network module
•
Cisco IOS Release 12.3(7)T or a later release for the AIM
•
(GUI only) Microsoft Internet Explorer Version 6.0 or a later release
•
(GUI only) Microsoft JScript 5.6.x or or a later release
•
Cisco CallManager Express 3.0
Restrictions
The following restrictions apply to Cisco Unity Express Release 1.1.2.
System Functionality
•
For the NM, only one administrator and four users may log in to the GUI simultaneously. For the
AIM, only one administrator and two users may log in to the GUI simultaneously.
•
Date and time cannot be set in the Cisco Unity Express software. Cisco Unity Express can be
configured as a network timer protocol (NTP) client. Please refer to your NTP server CLI for more
information.
•
Cisco Unity Express does not support language customization. Only one language is available, U.S.
English. This language controls the TUI system prompts and greetings. The administrative
interfaces (GUI and CLI) are available only in U.S. English. Cisco CallManager Express 3.0
controls the telephone displays, which may be available in multiple languages, and are independent
of the Cisco Unity Express supported languages.
Voice Mail Application
•
Cisco Unity Express does not support voice mail networking between different sites. Voice mail is
local; users can leave a message with, forward a message to, and reply to a message from other local
users.
•
Cisco Unity Express does not support broadcast messaging.
•
Cisco Unity Express does not support distribution lists.
•
Cisco Unity Express supports two greetings per user, one standard greeting and one alternate
greeting. The greetings’ time is included in the user’s allotted mailbox storage space.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
7
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
Restrictions
Hardware Limitations
Caution
•
Only one Cisco Unity Express module per router chassis is permitted, regardless of the number of
module slots in the chassis.
•
The AIM cannot be installed in slot 0 of the Cisco 3745 router chassis.
•
The NM’s front panel Fast Ethernet 0 port is not used by the Cisco Unity Express applications and
is disabled. The Fast Ethernet 1 port connects the Cisco Unity Express network module to the router
and is the only active Fast Ethernet port on the network module.
•
The hard disk on the NM cannot be replaced. If the network module’s hard disk crashes, the network
module must be replaced.
•
Online insertion and removal (OIR) of the Cisco Unity Express NM is available only on the
Cisco 3745 router. The replacement module must be the same type as the original module. OIR is
not available for the AIM.
If the network module or AIM flash memory card must be replaced, manually shut down the
Cisco Unity Express application before removing the module from the chassis to prevent file corruption
and data loss.
Backup and Restore
Cisco Unity Express does not support the following backup and restore capabilities:
•
Scheduled backup and restore operations. The backup and restore procedures begin when you enter
the appropriate command.
•
Centralized message storage arrangement. The Cisco Unity Express backup files cannot be used or
integrated with other message stores.
•
Selective backup and restore. Only full backup and restore functions are available. Individual voice
mail messages or other specific data cannot be stored or retrieved.
Other Restrictions
•
Cisco Unity Express is an embedded system and provides no access to the Linux system. Users
cannot add other Linux-based applications to the Cisco Unity Express module.
•
Cisco Unity Express does not support managing and configuring using Simple Network
Management Protocol (SNMP) except for hardware inventory.
•
Cisco Unity Express does not support Cisco Networking Services (CNS) or Subnetwork Access
Protocol (SNAP) autoprovisioning.
•
Cisco Unity Express does not support CiscoWorks configmaker.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
8
Cisco Unity Express Release 1.1.2
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
Additional References
Additional References
The following documents have information that may help you in administering the Cisco Unity Express
applications.
Related Topic
Document Title
Cisco Unity Express documents
Cisco module hardware
installation
Cisco Unity Express software
copyrights and licenses
Technical Assistance Center
support documentation for
Cisco Unity Express
Cisco CallManager Express 3.0
•
Cisco Unity Express CLI Administrator Guide for
Cisco CallManager Express, Release 1.1.2 (this document)
•
Cisco Unity Express GUI Administrator Guide for
Cisco CallManager Express, Release 1.1.2
•
Cisco Unity Express Script Editor Installation and
Configuration Guide, Release 1.1.2
•
Cisco Unity Express GUI Administrator Guide for
Cisco CallManager, Release 1.1.2
•
Cisco Unity Express CLI Administrator Guide for
Cisco CallManager, Release 1.1.2
•
Cisco Unity Express Voice Mail System - Quick Start Guide,
Release 1.1.2
•
Cisco Network Modules Hardware Installation Guide
•
Installing Advanced Integration Modules in Cisco 2600
Series, Cisco 3600 Series, and Cisco 3700 Series Routers
•
Advanced Integration Module Quick Start Guide
•
Replacing Compact Flash Memory on Cisco AIM-CUE
Advanced Integration Modules
•
AIM-CUE Slot Restriction on Cisco 3745 Routers
•
Installing Network Modules in Cisco 2800 Series Routers
•
Installing Network Modules in Cisco 3800 Series Routers
•
Installing the AIM-CUE CompactFlash Memory Card
•
“Software Copyrights and Licenses” on page xiv
Technical Notes for Cisco Unity Express
•
Cisco CallManager Express System Administrator Guide 3.0
•
Cisco CallManager Express Command Reference 3.0
•
Cisco SRST System Administrator’s Guide Version 3.0
•
Integrating CiscoCallManager Express with Cisco Unity
Express
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
9
Introduction to Cisco Unity Express Voice Mail and Auto Attendant
Additional References
Related Topic
Document Title
Cisco CallManager Express 3.1
Cisco hardware platforms
•
Cisco CallManager Express 3.1 System Administrator Guide
•
Cisco CallManager Express 3.1 Command Reference
•
Cisco SRST 3.1 System Administrator Guide
•
Integrating Cisco CallManager Express with Cisco Unity
Express
•
Cisco 2600 Series Hardware Installation Guide
•
Cisco 2600 series hardware configuration notes
•
Voice features on Cisco 2600 series routers
•
Cisco 2800 Series Hardware Installation
•
Cisco 3700 Series Hardware Installation Guide
•
Cisco 3700 series hardware configuration notes
•
Software Configuration Guide
•
Cisco 3800 Series Hardware Installation
Related Cisco IOS Documents
Related Topic
Document Title
Cisco IOS configuration
•
Cisco IOS Debug Command Reference, Release 12.3T
•
Cisco IOS Voice Command Reference, Release 12.3T
Note
Cisco IOS configuration examples
Cisco Systems Technologies website at
http://cisco.com/en/US/tech/index.html
Note
Cisco IOS Troubleshooting
information
For general voice configuration topics, refer to the
Cisco IOS Voice Configuration Library, Release 12.3.
From the website, choose a technology category and
subsequent hierarchy of subcategories, then click
Technical Documentation > Configuration
Examples.
Cisco IOS Voice Troubleshooting and Monitoring Guide
RFCs
RFCs
Title
1305
Network Time Protocol (Version 3)
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
10
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Install Cisco Unity Express software after all Cisco CME and Cisco Unity Express hardware and Cisco
CME software installations are complete. This chapter contains the following installation information
and procedures:
•
Prerequisites, page 11
•
Installing a New Cisco Unity Express Software Package, page 15
– Activating IP Connectivity to Cisco Unity Express Software, page 15
– EXEC and Configuration Modes, page 17
– Entering the Command Environment, page 17
– Displaying Cisco Unity Express Hardware and Software Versions, page 18
– Exiting the Command Environment, page 18
•
Sequence of Configuration Tasks, page 19
•
Upgrading the Software or License Version, page 25
Prerequisites
Before the Cisco Unity Express configuration can be started, the Cisco CallManager Express (CME)
system must be installed. If you did not or are not performing the Cisco CME installation, contact the
installer or other support personnel to ensure that the following procedures are completed:
1.
Install all Cisco CME and Cisco Unity Express hardware and verify functionality.
a. Attach the telephones so that they register with the Cisco CME router.
b. Verify that the Cisco CME router is configured with Cisco IOS Release 12.3(4)T or a later
release for the network module (NM) and Cisco IOS Release 12.3(7)T or a later release for the
advanced integration module (AIM).
c. Install the Cisco Unity Express NM or AIM in the same router where Cisco CME is installed.
d. For the NM, verify that the Enable LED is lit.
Caution
If you are installing an AIM-CUE in your Cisco 3745 router, you must install it in the AIM slot labeled
AIM1. Installing this AIM in the AIM slot labeled AIM0 of Cisco 3745 routers can damage the AIM.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
11
Installing Cisco Unity Express Software
Prerequisites
Note
We highly recommend attaching an uninterruptible power supply (UPS) to the router housing the
Cisco Unity Express module. Any reliable UPS unit provides continuous power to maintain the
operation of the router and the Cisco Unity Express module. Consider the unit’s capacity and run time
because power consumption differs among Cisco platforms. Ideally, a UPS should include a signaling
mechanism that directs the router to shut down Cisco Unity Express properly and then powers off the
router.
Cisco IOS Release 12.3(4)T supports automatic switchover to the UPS device if the following
configuration is added to the router:
line aux 0
privilege level 15
modem Dialin
autocommand service-module service-engine slot /0 shutdown no-confirm
where slot is the Cisco Unity Express module’s slot number.
2.
Install and verify Cisco CME software functionality.
a. You should be able to access the Cisco CME configuration web page.
b. Verify that the Cisco CME router flash memory has the following files, which control the
functionality of the Cisco Unity Express GUI:
– CiscoLogo.gif
– Delete.gif
– Plus.gif
– Tab.gif
– admin_user.html
– admin_user.js
– dom.js
– downarrow.gif
– ephone_admin.html
– logohome.gif
– normal_user.html
– normal_user.js
– sxiconad.gif
– telephony_service.html
– uparrow.gif
– xml-test.html
– xml.template
c. Configure the following path in Cisco CME configuration mode:
Router(config)# ip http path flash:
Verify the path with the show running-config command.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
12
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Prerequisites
d. To configure the ip unnumbered command on the service-engine interface, use the Cisco IOS
software commands on the router to create a static route to the Cisco Unity Express module, for
example:
ip route 0.0.0.0 0.0.0.0 91.91.19.1
ip route 10.3.6.128 255.255.255.255 Service-Engine1/0
In this example, 10.3.6.128 is the IP address of the Cisco Unity Express module and
Service-Engine1/0 is the router slot hosting the Cisco Unity Express module.
e. Verify that a SIP dial peer is configured to point to the Cisco Unity Express module, that it
specifies G.711 U-law and SIP Notify for DTMF Relay, and that VAD is turned off, for example:
dial-peer voice 6000 voip <------ SIP dial peer pointing to Cisco Unity Express
destination-pattern 6...
session protocol sipv2
dtmf-relay sip-notify
session target ipv4:10.3.2.100 <---- Cisco Unity Express IP address
codec g711ulaw
no vad
Configure the appropriate number of SIP dial peers to support your dial plan.
f. The FTP server that communicates with Cisco Unity Express must support passive FTP
requests. To configure this functionality on the FTP server, refer to the FTP server
documentation.
g. Verify that a Cisco CME web administrator is configured with a user ID and password, for
example:
telephony-service
.
.
.
web admin system name admin password user1
or
web admin system name admin secret 5 encrypted-password
Note
If you plan to use the Cisco Unity Express graphical user interface (GUI) for configuration
purposes, configure an administrator user ID with a password in the Cisco CME interface.
You must log in to the GUI as this user. If no administrator user is created in Cisco CME,
the administrator cannot proceed with the initialization wizard in the Cisco Unity Express
GUI. In Release 1.1.2, an administrator is created during the installation procedure.
h. Configure the telephones and users. You can create additional users and telephones later using
the Cisco Unity Express CLI commands or GUI options. The CLI commands and GUI options
create the telephone users in the Cisco CME database; use a synchronization CLI command or
GUI option to copy the users and telephones into the Cisco Unity Express database.
Use the following sample ephone-dn and ephone configurations to configure the telephones and
users manually:
ephone-dn 1 <---- ephone dn configuration for a user
number 8004
name User1
call-forward busy 6900
call-forward noan 6900 timeout 10
!
!
ephone-dn 20 <---- ephone dn configuration for a group
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
13
Installing Cisco Unity Express Software
Prerequisites
number 8801
name Salesgroup
call-forward busy 6900
call-forward noan 6900 timeout 10
i. Configure the message waiting indicator (MWI) on and off extensions. Add the wildcard
characters (.) to the DNs to represent the length of a telephone extension number.
Cisco Unity Express requires these wildcards when importing the MWI DNs from
Cisco CallManager Express during the initialization wizard. If the wildcard characters are not
configured in Cisco CallManager Express, the DNs will not appear as available choices in the
MWI extension field. For example:
ephone-dn 30 <---- ephone-dn configurations for MWI on
number 8000.... <---- valid MWI DN 4-digit extension
mwi on
!
!
ephone-dn 31 <---- ephone-dn configurations for MWI off
number 8001.... <---- valid MWI DN 4-digit extension
mwi off
!
!
!
ephone 1 <--- ephone configured for the ephone-dn configured above
username "admin1" password null
mac-address 0009.B7F7.556A
button 1:1 2:20 3:21 4:22 5:23
3.
(Optional) If no users were created in the Cisco CME interface, create a list of all users, groups, and
their extensions. Having this list eases the task of configuring many users and extensions.
4.
(Optional) Create an alternate welcome message for the auto attendant application. A default
welcome message comes with auto attendant. You can create a different message in a .wav file and
install it as part of the auto attendant configuration. See “Recording an Auto Attendant Greeting or
Prompt File” on page 51 for more information.
5.
(Optional) Customize the auto attendant prompt flow to meet your business requirements. See
“Configuring Auto Attendant Scripts” on page 53 for more information.
6.
(Required) Record the IP address of the Cisco Unity Express module. Accessing the GUI to
configure the system requires this IP address.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
14
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Installing a New Cisco Unity Express Software Package
Installing a New Cisco Unity Express Software Package
When you order Cisco Unity Express, Cisco Unity Express software and the purchased license are
installed on the module at the factory. Spare modules also ship with the software and license installed.
Installation of a new package requires the following procedures:
1.
Configure the IP addressing between the module and the router. See “Activating IP Connectivity to
Cisco Unity Express Software” on page 15.
2.
Begin configuring the Cisco Unity Express software. See “Sequence of Configuration Tasks” on
page 19.
Activating IP Connectivity to Cisco Unity Express Software
After installing the Cisco Unity Express module, activate the IP communication link between Cisco
CME and the Cisco Unity Express application.
Prerequisites
The following information is required for activating the software:
•
Slot and unit numbers of the Cisco Unity Express module on the Cisco CME router.
•
Cisco CME router IP address and subnet mask or the unnumbered interface type and number.
•
IP address of the Cisco Unity Express module. This IP address must be on the same subnet as the
Cisco CME router.
•
IP address of the default gateway of the Cisco Unity Express router. This IP address must be the
same IP address as the Cisco CME router.
SUMMARY STEPS
From the Cisco CME router configuration mode:
1.
interface Service-Engine slot/unit
2.
ip address router-ipaddr subnet-mask
or
ip unnumbered type number
3.
service-module ip address cue-side-ipaddr subnet-mask
4.
service-module ip default-gateway gw-ipaddr
5.
exit
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
15
Installing Cisco Unity Express Software
Installing a New Cisco Unity Express Software Package
DETAILED STEPS
Step 1
Command or Action
Purpose
Router(config)# interface Service-Engine slot/unit
Enters interface configuration mode.
Example:
Router(config)# interface Service-Engine 2/0
Step 2
Router(config-if)# ip address cme-ipaddr subnet-mask
Specifies the IP address and subnet mask of the
Cisco CME router.
Example:
Router(config)# ip address 10.16.231.195 255.255.0.0
or
Router(config-if)# ip unnumbered type number
Specifies the interface type and number for the
Cisco CME router.
Example:
Router(config)# ip unnumbered FastEthernet 0/0
Step 3
Router(config-if)# service-module ip address
cue-side-ipaddr subnet-mask
Specifies the IP address of the Cisco Unity Express
module interface. This IP address must be on the
same subnet as the Cisco CME router.
Example:
Router(config)# service-module ip address
10.16.231.190 255.255.0.0
Step 4
Router(config-if)# service-module ip default-gateway
gw-ipaddr
Specifies the IP address the Cisco CME router.
Example:
Router(config)# service-module ip default-gateway
10.16.231.195
Step 5
Router(config-if)# exit
Exits interface configuration mode.
Example:
Router(config-if)# exit
Example
The following example illustrates the IP connectivity activation procedure:
Router(config)# interface Service-Engine 1/0
Router(config-if)# ip address 10.0.0.9 255.0.0.0
Router(config-if)# service-module ip address 10.0.0.10 255.0.0.0
Router(config-if)# service-module ip default-gateway 10.0.100.10
Router(config-if)# exit
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
16
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Installing a New Cisco Unity Express Software Package
What to Do Next
After activating the connectivity to the Cisco Unity Express module, enter the Cisco Unity Express
command environment and start configuring the applications. See “Entering the Command
Environment” on page 17.
EXEC and Configuration Modes
The Cisco Unity Express CLI has two implementation modes for the commands: EXEC and
configuration. Although these two modes operate similarly to the EXEC and configuration modes for
Cisco IOS CLI commands, Cisco Unity Express EXEC mode permits some parameters to be configured
or modified, which is not allowed in Cisco IOS EXEC mode. This Cisco Unity Express capability saves
the configured parameters to Flash memory so that the system has some minimum information available
if a catastrophic failure, such as a disk crash, occurs. The description for each command in this guide
indicates the command mode.
Entering the Command Environment
After the Cisco Unity Express software is installed and active, use this procedure to enter the command
environment.
Prerequisites
For a new Cisco Unity Express software installation, see “Prerequisites” on page 11 and the “Activating
IP Connectivity to Cisco Unity Express Software” section on page 15 before beginning this procedure.
The following information is required to enter the command environment:
•
IP address of the router containing the Cisco Unity Express module
•
Username and password to log in to the router
•
Slot number of the module
1.
Open a Telnet session.
2.
telnet ip-address
3.
Enter the user ID and password of the router.
4.
service-module service-engine slot/port session
SUMMARY STEPS
Note
If the message “Trying ip-address port ...
Connection refused by remote host
appears, enter the command service-module service-engine slot/port session clear
and try Step 4 again.
5.
enable
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
17
Installing Cisco Unity Express Software
Installing a New Cisco Unity Express Software Package
DETAILED STEPS
Command or Action
Purpose
Step 1
Open a Telnet session.
Use a DOS window, secure shell, or a software emulation
tool such as Reflection.
Step 2
C:\> telnet ip-address
Specifies the IP address of the Cisco CME router.
Example:
C:\> telnet 10.16.231.195
Step 3
Username:
Password:
Enter your user ID and password for the router.
Step 4
Router# service-module service-engine
slot/port session
Enters the Cisco Unity Express command environment using
the module located in slot and port. The prompt changes to
“se” with the IP address of the Cisco Unity Express module.
Example:
If the message
“Trying ip-address port ...
Router# service-module service-engine 1/0
session
Connection refused by remote host
appears, enter the command
service-module service-engine slot/port session clear
and try Step 4 again.
Step 5
se-10-0-0-0# enable
Enters Cisco Unity Express EXEC mode. You are ready to
begin the configuration tasks.
Example:
se-10-0-0-0# enable
What to Do Next
Review “Sequence of Configuration Tasks” on page 19.
Displaying Cisco Unity Express Hardware and Software Versions
To display the versions and serial numbers of the installed Cisco Unity Express hardware components,
use the show version command.
To display the versions of the installed Cisco Unity Exprss software components, use the show software
versions command.
Exiting the Command Environment
To exit the Cisco Unity Express Release 1.1.2 command environment, follow these steps:
1.
Return to the Cisco Unity Express EXEC mode.
2.
Press the CTRL-SHIFT-6 keys simultaneously.
3.
Press the lowercase x key separately.
The Cisco CME router prompt appears.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
18
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Sequence of Configuration Tasks
Sequence of Configuration Tasks
After completing the prerequisite activities, begin the configuration tasks. Table 6 lists the configuration
tasks, the chapter that contains the procedure, and additional information needed for each task.
Configuring the System Using the CLI Commands
If you will configure one or more Cisco Unity Express systems exclusively using CLI scripts, enter the
command environment as described in “Entering the Command Environment” on page 17. Proceed with
the scripts, using Table 6 as a guideline for configuring the system components. When entering the GUI
for the first time and the initialization wizard appears, choose the skip option to avoid reconfiguring the
system.
Configuring the System Using the GUI and the Initialization Wizard
The Cisco Unity Express GUI provides the initialization wizard software tool to configure the basic
system parameters and import any users configured with the Cisco CME interface.
If you log in to the GUI web interface after installation, the initialization wizard is the first screen to
appear. You cannot activate it again except by reinstalling Cisco Unity Express software. All the
parameters configured through the initialization wizard are available through GUI screens and CLI
commands. Refer to Chapter 2, “Configuring the System for the First Time,” in the Cisco Unity Express
GUI Administrator Guide for Cisco CallManager Express, Release 1.1 for more information about the
initialization wizard.
Table 6
Configuration Task Sequence
Task and Procedure Location
1.
2.
Additional Information Needed
Configuring the SIP Proxy Server
Location for Cisco Unity Express,
page 42
•
Hostname or IP address of the SIP proxy server.
•
UDP or TCP port on the SIP proxy server.
Configuring the Voice Mail
Application, page 43
•
Maximum number of users who can access voice
mail simultaneously. This number is limited by the
number of ports purchased with Cisco Unity
Express. Check your license agreement and see
“Feature Overview” on page 1 for this maximum
number.
•
Telephone number to access the voice-mail system.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
19
Installing Cisco Unity Express Software
Sequence of Configuration Tasks
Table 6
Configuration Task Sequence (continued)
Task and Procedure Location
3.
Configuring and Managing the Auto
Attendant Application, page 47
Additional Information Needed
•
To use your own welcome greeting, create a .wav
file containing the prerecorded welcome greeting.
This file must be uploaded to Cisco Unity Express
module so that it can be located and saved in the auto
attendant script. Alternatively, you can use the
prompt management system (PMS) to record the
welcome greeting. See “Recording an Auto
Attendant Greeting or Prompt File” on page 51 for
guidelines on recording a greeting.
•
Number of times the auto attendant will replay
instructions to a caller before the call is
disconnected. This count begins when the caller
moves past the main menu and starts to hear
instructions for a submenu. The main menu will play
five times and then, if the caller makes no choice or
incorrect choices, will transfer to the operator.
•
Extension number of the operator. Auto attendant
dials this extension when the caller presses the zero
(“0”) button.
•
Telephone number that the caller must dial to reach
the auto attendant. In many cases, this number is
your company telephone number.
•
Maximum number of callers that auto attendant can
handle simultaneously. This number is limited by
the number of ports purchased with Cisco Unity
Express. Check your license agreement and see
“Feature Overview” on page 1 for this maximum
number.
4.
Configuring the Greeting
Management System Application,
page 46
•
Telephone number for accessing the PMS.
5.
Configuring Auto Attendant Prompts,
page 51
•
Prerecorded prompt files in .wav format. Use the
PMS to record the prompts.
•
Prompt filenames.
•
Preconfigured script files. Use the Cisco Unity
Express script editor to create the files. Refer to the
Cisco Unity Express Script Editor Installation and
Configuration Guide for more information.
•
Script filenames.
6.
Configuring Auto Attendant Scripts,
page 53
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
20
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Sequence of Configuration Tasks
Table 6
Configuration Task Sequence (continued)
Task and Procedure Location
7.
8.
9.
Configuring SIP Triggers for the
Applications, page 54
Configuring System-Wide Mailbox
Default Values, page 61
Configuring the MWI On and Off
Extensions, page 63
Additional Information Needed
•
Telephone number that invokes the application. This
number must be different for voice mail, auto
attendant, and prompt management system.
•
Maximum number of callers, or sessions, the
application can handle simultaneously. The total for
all applications must not exceed the maximum
number of ports for the system. (See Table 2 on
page 3 for the maximum number of ports.) The
applications need not have the same maximum
number; for example, voice mail might need three
sessions while auto attendant needs five sessions.
•
Capacity—The total amount of storage time in hours
allowed for all mailboxes in the system. The factory
default is the maximum allowed storage for your
system.
•
Expiration date—The number of days a message is
saved in the mailbox before the voice-mail system
deletes it. The factory default value is 30 days.
•
Language—The language used for voice-mail
prompts. In Release 1.0, U.S. English is the only
language available.
•
Mailbox size—The maximum number of seconds of
storage for voice messages in a mailbox. The factory
default value is determined by dividing the
maximum storage capacity by the maximum number
of mailboxes (personal plus general delivery).
•
Message length—The maximum number of seconds
for any one stored message in a mailbox. The factory
default is 60 seconds.
•
Recording time—The maximum amount of time for
a user’s recorded mailbox greeting.
•
Operator extension—The extension of the
voice-mail operator.
•
Extension number dedicated to the MWI on
extension.
•
Extension number dedicated to the MWI off
extension.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
21
Installing Cisco Unity Express Software
Sequence of Configuration Tasks
Table 6
Configuration Task Sequence (continued)
Task and Procedure Location
10. Adding and Modifying a User, page 66
Additional Information Needed
•
Username—The user ID. The username must be at
least 3 and no more than 32 characters in length.
Users IDs must start with a letter. Do not use spaces
in the username.
•
(Optional) Full name—First and last name of the
user. Enter this name in quotation marks (“ ”).
•
(Optional) Group—Name of a group in which this
user is a member. If this group does not exist, an
error message appears.
If you create a user or group with the CLI, you must
provide a password and PIN.
•
Password—Temporary password for this user. The
password must be at least 3 and no more than 32
characters in length. Spaces are not allowed. When
the user logs in to the GUI for the first time, the
application requires the user to change the password.
In Release 1.0, the user’s password does not expire.
•
PIN—Personal identification number. The PIN must
be at least 3 and no more than 16 digits in length.
When the user logs in to the voice-mail system for
the first time, the application requires the user to
change the PIN. After the user changes the PIN, the
PIN does not expire.
If you create a user or group with the GUI, you must
decide the policy for handling passwords and PINs.
Tip
You must determine the level of security for your
voice-mail system. Requiring a new user to have
a password to access the GUI and a PIN to access
a voice mailbox helps discourage unauthorized
personnel from gaining entry to the system or to
another user’s mailbox. However, not assigning
a password and PIN makes it easier for a user to
enter the system or mailbox the first time.
Decide whether Cisco Unity Express should generate a
random password and a random PIN for each new user or
if the password and PIN should be blank.
Regardless of the method you use for creating a user,
each new user and each user copied from Cisco CME is
required to change the password when logging in to the
GUI for the first time and the PIN when logging in to the
voice-mail system for the first time.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
22
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Sequence of Configuration Tasks
Table 6
Configuration Task Sequence (continued)
Task and Procedure Location
Additional Information Needed
11. Adding and Modifying a Group,
EXEC mode:
page 71
•
Name of the group.
•
(Optional) Description of the group.
•
(Optional) Full name of the group.
Configuration mode:
•
Name of the group.
•
(Optional) One or more member user IDs.
•
(Optional) User ID of the owner.
•
(Optional) Extension or telephone number of the
group.
•
(Optional) Full E.164 telephone number of the
group.
The group need not have a mailbox associated with it.
Note
If a user must access a general delivery mailbox
(GDM), the user must have a personal mailbox
assigned first.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
23
Installing Cisco Unity Express Software
Sequence of Configuration Tasks
Table 6
Configuration Task Sequence (continued)
Task and Procedure Location
12. Creating and Modifying a Voice
Additional Information Needed
•
Mailbox, page 75
The default mailbox size.
The mailbox size represents the total number of
seconds from all messages stored in a user’s voice
mailbox. Cisco Unity Express calculates a default
value based on the maximum number of mailboxes
and the maximum storage space on the system.
Optionally, you can change the size value for
individual users.
•
The default message storage time.
The message storage time is the number of days that
the system will save old messages. As a message
approaches this storage time, the system alerts the
user to resave or delete the message. If the user takes
no action when the maximum storage time is
reached, the message is deleted from the system.
•
The default message length.
The message length represents the maximum
number of seconds for any message stored in a voice
mailbox. Callers who try to leave a longer message
will be cut off when the maximum time is reached.
Cisco Unity Express calculates a default value based
on the default storage space for a mailbox. You can
change the length value for individual users.
•
Note
•
Telephone numbers for the voice-mail system, auto
attendant, and voice-mail operator extension
The voice-mail telephone number and the
voice-mail operator’s telephone number should
not be the same. If they are, then a user trying to
call the operator while in the voice-mail system
will be directed back to the voice-mail system.
Also, an outside caller who presses the button for
the operator will be connected to the voice-mail
system.
Whether the mailbox uses the standard greeting or
an alternate greeting.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
24
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Upgrading the Software or License Version
Upgrading the Software or License Version
Cisco Unity Express allows you to upgrade to new software versions in the combinations described in
the following sections:
•
Upgrading to a New License—Use your current software version but increase the number of
supported mailboxes.
If you are changing to a smaller mailbox license, verify that the system meets the new license
limit before downloading the new license. For example, if you are downgrading from a 50
mailbox license to a 12 mailbox license, ensure that your system does not have more than 12
configured mailboxes. If you have more than 12 mailboxes, delete the extra mailboxes before
downgrading the license.
Note
•
Upgrading to a New Software Image—Use your current licensed number of mailboxes on a new
software image.
If you are upgrading from Cisco Unity Express Release 1.0, upgrade the bootloader file before
installing a new software image.
Note
Caution
Always do a shutdown of the module before power cycling the router to prevent file corruption and
possible data loss.
Upgrading to a New License
Upgrading to a new license requires the following sequence of activities:
1.
Order the license SKU from the Configurator. Choose a package from the following list:
•
12-mailbox package: SCUE-12CME-1.1.2=
•
25-mailbox package: SCUE-25CME-1.1.2=
•
50-mailbox package: SCUE-50CME-1.1.2=
•
100-mailbox package: SCUE-100CME-1.1.2=
2.
Download the license files from Cisco.com. See “Downloading the License Files” on page 26.
3.
Back up your data and configuration files. See “Backing Up and Restoring Data” section on page 83.
4.
Install the new license file. See “Installing a New Software License File” on page 26.
5.
Restore the data and configuration files. See “Restoring Files” section on page 90.
6.
Reboot the system.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
25
Installing Cisco Unity Express Software
Upgrading the Software or License Version
Downloading the License Files
After ordering the appropriate license SKU, download the corresponding license file and installer file.
Prerequisites
•
Have available the IP address or name of the TFTP server that will store the downloaded files. This
may be the same as the FTP server. Verify that the TFTP server is accessible.
•
Have available the IP address or name of the FTP server that will store the Cisco Unity Express
applications. Verify that the FTP server is accessible.
1.
Go to the Cisco Unity Express page on the Cisco Software Center website
http://www.cisco.com/kobayashi/sw-center/sw-voice.shtml.
2.
Download the appropriate license file from the following list:
PROCEDURE
– cue-vm-12-license.1.1.2.cme.pkg
– cue-vm-25-license.1.1.2.cme.pkg
– cue-vm-50-license.1.1.2.cme.pkg
– cue-vm-100-license.1.1.2.cme.pkg
3.
Copy the file to the FTP server.
4.
Download the installer file: cue-installer.1.1.2
5.
Copy the installer file to the TFTP server.
What to Do Next
Back up your data and configuration files. See the “Backing Up Files” section on page 87.
After the backup, install the new license file. See the “Installing a New Software License File” section
on page 26.
Installing a New Software License File
After downloading the appropriate software files and backing up your configuration and system data,
use this procedure to install the new license files.
Prerequisites
The following information is required to install the software license file:
•
FTP server user ID
•
FTP server password
•
License package name (See “Software Licenses and Factory-Set Limits” on page 3 for the list of
license packages.)
SUMMARY STEPS
Starting from EXEC mode on the Cisco Unity Express module:
1.
reload
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
26
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Upgrading the Software or License Version
2.
Type *** quickly when the boot configuration prompt appears.
3.
boot helper
4.
software install package url ftp://ftp_server_ip_address/license_package.pkg
[username username
5.
password password]
Restart the system.
DETAILED STEPS
Step 1
Reload (shutdown and startup) the Cisco Unity Express module. Interrupt the startup to get the
bootloader prompt. You may see output similar to the following:
se-172.16.0.0# reload
se-172.16.0.0
MONITOR SHUTDOWN...
EXITED: SQL_startup.sh exit status 0
EXITED: LDAP_startup.sh exit status 0
MONITOR EXIT...
INIT: Switching to runlevel: 6
Restarting system.
.
.
System Now Booting ...
Booting from flash..., please wait.
[BOOT-ASM]
7
Step 2
Type *** quickly to change to boot configuration, as shown in the following output:
Please enter '***' to change boot configuration:***
ServicesEngine Bootloader Version : 1.1.X
Step 3
Boot the system from the helper image (cue-installer.1.1.2) located on the TFTP server in the /tftpboot
directory. By default, the system boots from the disk.
The boot is complete when the “Welcome to Cisco Service Engine” message appears. You may see
output similar to the following:
ServicesEngine boot-loader> boot helper
Probing...
.
.
.
INIT: version 2.84 booting
Started device management daemon v1.3.25 for /dev
Remounting the root filesystem read-only...
/dev/root: clean, 653/5688 files, 61894/67100 blocks
FILESYSTEM CLEAN
Remounting the root filesystem read-write...
kernel.sem = 16384 32000 32 128
Welcome to Cisco Service Engine
.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
27
Installing Cisco Unity Express Software
Upgrading the Software or License Version
.
.
se-172.20.231.191installer#>
Step 4
Install the license package software from the FTP server using the following command:
se-172.20.231.191installer#> software install package url
ftp://ftp_server_ip_address/license_package.pkg [ username username password password]
The following example installs the 25-mailbox package on the FTP server at IP address 192.168.10.0
with an FTP server user ID admin and password voice.
se-172.20.231.19installer#> software install package url
ftp://192.168.10.0/cue-vm-25-license.1.1.2.cme.pkg username admin password voice
The following output appears:
umount: /dev/hda1: not mounted
/dev/hda1: clean, 3866/2443200 files, 139430/4883752 blocks
Found Valid Partition.
Connecting to host...
% Total
100
2298
% Received % Xferd
100
2298
0
0
Average Speed
Time
Dload
Current
Left
0:00:00
0:00:00 60666
Upload Total
21277
0
0:00:00
Curr.
Speed
signed value is [1]
Calculated MD5 is: 9981469138d7da7d76b32d3e0735e470
Calculated File Header is: filename: licenses.tgz
filetype: tgz
id: license
signed: 0
checksum: 9981469138d7da7d76b32d3e0735e470
size: 855
sig_ba length is : 975
out_ba length is : 65536
A change has occurred that requires the system to be restarted.
Step 5
Restart the system as shown in the following sample output:
Do you wish to restart now (y,n) [y]y
What to Do Next
Restore the data and configuration files. See the “Restoring Files” section on page 90.
After the restore, reboot the system.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
28
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Upgrading the Software or License Version
Upgrading to a New Software Image
This section describes the procedures for upgrading to a new release of Cisco Unity Express software.
Prerequisites
•
Ensure that the TFTP and FTP servers are configured and active. If the TFTP and FTP servers reside
on the same PC, ensure that the TFTP and FTP programs are activated.
•
Ensure that you can ping the Cisco Unity Express module from the TFTP and FTP servers.
•
A DNS server is optional for initializing the new software. If DNS is desired, install and activate a
DNS server on the PC or server before proceeding.
Sequence of Tasks
Upgrading to a new software image entails the following sequence of tasks:
1.
Download the software image files. See “Downloading the Software Files” on page 29.
If you are upgrading from Cisco Unity Express Release 1.0, download the bootloader file in
addition to the software files.
Note
2.
Back up your data and configuration files. See “Backing Up Files” on page 87.
3.
Enter several configuration parameter values. See “Entering Configuration Parameter Values” on
page 31.
4.
If you are upgrading from Cisco Unity Express Release 1.0, upgrade the bootloader. See “Installing
a New Bootloader File” on page 32.
5.
Install the software files. See “Installing the Software Image Files” on page 33.
6.
Restore the data and configuration files. See “Restoring Files” on page 90.
7.
Reboot the system.
Downloading the Software Files
Downloading the Cisco Unity Express software files is the first software upgrade task. Review the
prerequisites listed above to ensure that all servers and modules are active and available.
SUMMARY STEPS
1.
Go to the Cisco Unity Express page on the Cisco Software Center website at
http://www.cisco.com/kobayashi/sw-center/sw-voice.shtml.
2.
Download the following software files.
If you are upgrading from Cisco Unity Express Release 1.0, download the bootloader file.
3.
copy cue-installer.1.1.2 tftp:/tftpboot
4.
Copy the other software files to the FTP server using the following commands:
a. copy cue-vm.1.1.2.manifest ftp:/var/ftp
b. copy cue-vm.1.1.2.prt1 ftp:/var/ftp
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
29
Installing Cisco Unity Express Software
Upgrading the Software or License Version
c. copy cue-vm-YY-ZZZ.pkg ftp:/var/ftp
d. (Optional) copy cue-bootloader.1.0.17.pkg ftp:/var/ftp
DETAILED STEPS
Step 1
Go to the Cisco Unity Express page on the Cisco Software Center website at
http://www.cisco.com/kobayashi/sw-center/sw-voice.shtml.
Step 2
Download the Cisco Unity Express software files.
– cue-vm.1.1.2.pkg
– cue-vm.1.1.2.manifest
– cue-vm.1.1.2.prt1
– cue-installer.1.1.2
– cue-vm-YYZZZ.pkg
Note
YY represents the number of voice-mail users, and ZZZ represents either Cisco CallManager or
Cisco CallManager Express.
If you are upgrading from Cisco Unity Express Release 1.0, download the bootloader file:
cue-bootloader.1.0.17.pkg.
Step 3
Copy the cue-installer.1.1.2 file to the TFTP server in the /tftpboot directory with the command:
copy cue-installer.1.1.2 tftp:/tftpboot
If you download the files to a different server, copy the cue-installer.1.1.1 file to the TFTP server before
beginning the installation procedure.
Step 4
Copy the other software files and the bootloader file (if you downloaded this file) to the FTP server (such
as the /var/ftp directory) using the following commands. The installation procedure requires the
pathname to the files.
a. copy cue-vm.1.1.2.manifest ftp:/var/ftp
b. copy cue-vm.1.1.2.prt1 ftp:/var/ftp
c. copy cue-vm-YYZZZ.pkg ftp:/var/ftp
d. (Optional) copy cue-bootloader.1.0.17.pkg ftp:/var/ftp
What to Do Next
Back up your data and configuration files. See “Backing Up Files” on page 87.
After backing up the files, configure several parameter values. See “Entering Configuration Parameter
Values” on page 31.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
30
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Upgrading the Software or License Version
Entering Configuration Parameter Values
SUMMARY STEPS
1.
reload
2.
Type “***” to go into the boot loader mode.
3.
config t
4.
Enter the values for the following parameters:
– Network module’s IP address
– Subnet mask
– TFTP server address
– Gateway router address
– Ethernet interface is internal
– Default helper image is cue-installer.1.1.1
– Default boot is helper
5.
Enter boot helper mode.
DETAILED STEPS
Step 1
Type reload to restart the system.
Step 2
Type “***” to go into the boot loader mode.
Step 3
Type config t to go into configuration mode.
Step 4
Enter the values for the following parameters:
Step 5
•
Network module’s IP address
•
Subnet mask
•
TFTP server address
•
Gateway router address
•
Ethernet interface: internal
•
Default helper image: cue-installer.1.1.1
•
Default boot: helper
Enter boot helper mode.
What to Do Next
If you are upgrading from Cisco Unity Express Release 1.0, upgrade the bootloader file. See “Installing
a New Bootloader File” on page 32.
If you are not installing the bootloader file, install the software files. See “Installing the Software Image
Files” on page 33.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
31
Installing Cisco Unity Express Software
Upgrading the Software or License Version
Installing a New Bootloader File
If you have downloaded a new Cisco Unity Express bootloader file, use this procedure to install the file.
Prerequisites
The following information is required to install the bootloader file:
•
FTP server IP address
•
FTP server user ID
•
FTP server password
•
Directory location of the bootloader file on the FTP server.
SUMMARY STEPS
Starting from the bootloader mode on the Cisco Unity Express module:
1.
software install package url ftp://ftp_server_ip_address/cue-bootloader.1.0.17.pkg
[username username
password password]
2.
Update the primary bootloader.
3.
Set the default bootloader.
4.
Do not reboot the system.
DETAILED STEPS
Step 1
Install the bootloader software from the FTP server using the following command:
software install package url ftp://ftp_ser_ip_address/cue-bootloader.1.0.17.pkg [username
username password password]
You may see output similar to the following:
ServicesEngine boot-loader> boot helper
Probing...
.
.
.
Welcome to Cisco Service Engine
.
.
.
se-172.20.231.191installer#>
se-172.20.231.191installer#> software install package url
ftp://ftp_server_ip_address/cue-bootloader.1.0.17.pkg [ username username password password]
Connecting to host...
% Total
% Received % Xferd Average
100 60936
Step 2
100 60936
0
0
Speed
Dload Upload
804k
0
Time
Total
Current
0:00:00 0:00:00
Curr.
Left
Speed
0:00:00 4391k
Update the primary bootloader.
Would you like to update the primary or secondary Bootloader (p,s) [s] p
WARNING:DO NOT POWER OFF ROUTER DURING UPDATE!
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
32
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Upgrading the Software or License Version
Updating...complete.
Step 3
Make the primary bootloader the default bootloader.
The primary bootloader is not the default bootloader boot option. Would you like to make
the primary bootloader the default boot option?
(y,n) [y]
Change default bootloader from secondary to primary completed.
Cleaning up...complete.
A change has occurred that requires the system to be restarted.
Step 4
Do not restart the system, as shown in the following sample output:
Do you wish to restart now (y,n) [y]n
What to Do Next
Upgrade the software image files. See “Installing the Software Image Files” on page 33.
Installing the Software Image Files
After downloading the software files, backing up your data, and installing the bootloader file, if required,
you are ready to install the software image files.
Prerequisites
Installing the software image files requires the following information:
•
TFTP server IP address
•
FTP server IP address
•
FTP server user ID
•
FTP server password
•
License package name
•
Software package name
Install the new software files after backing up current system configurations and data.
Caution
Always do a shutdown of the module before power cycling the router to prevent file corruption and
possible data loss.
SUMMARY STEPS
Starting from EXEC mode on the router:
1.
Load the software. Type software install package url ftp://ftp_ipaddress/cue-vm.1.1.2.pkg
{username username password ftp_password} or
software Install package url ftp://ftp_ipaddress /cue-vm.1.1.2.pkg
2.
Remove the old installation.
3.
Do not reboot the system.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
33
Installing Cisco Unity Express Software
Upgrading the Software or License Version
4.
Install the license information. Type software install package url
ftp://ftp_ipaddress/license_pkg_name
5.
Restart and go to the boot configuration.
6.
Type config to change the default boot source from helper to disk.
Accept all the default values except Default Boot. At that prompt, type disk.
Note
An AIM can be configured to use primary or secondary BIOS. If primary BIOS is configured
as the default, the Cisco Unity Express module boots up normally. If secondary BIOS is
configured as the default, the Cisco Unity Express module boots up using primary BIOS,
looks for the secondary BIOS location, verifies the checksum, then uses the secondary
BIOS.
7.
Type boot disk to boot the newly installed software and license from the disk.
8.
Post-installation configuration starts. Configure one or more DNS servers, NTP servers, the time
zone, and the administrator user ID and password.
Note
9.
Cisco Unity Express automtically changes to daylight savings time on the basis of the
selected time zone.
Log in to Cisco Unity Express.
10. show software version
11. show software license
DETAILED STEPS
Step 1
Load the software using one of the following commands:
software install package url ftp://ftp_ipaddress /cue-vm.1.1.2.pkg {username username password
ftp_password}
or
software Install package url ftp://ftp_ipaddress /cue-vm.1.1.2.pkg
where
•
install—Install with FTP username and password
•
Install—Install without FTP username and password
•
ftp_ipaddress—FTP server IP address
•
/cue-vm.1.1.2.pkg—Name of the software package. Use the slash mark (/) before the package name.
•
username—User ID on the FTP server
•
ftp_password—User’s password on the FTP server
The following examples illustrate the commands:
se-172.20.231.191installer#> software install package url
ftp://10.3.61.16/cue10.0.0.18.pkg username admin password ftpvoice
or
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
34
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Upgrading the Software or License Version
se-172.20.231.191installer#> software Install package url
ftp://10.3.61.16/cue10.0.0.18.pkg
The following example illustrates the output:
mount: /dev/hda1: not mounted
/dev/hda1: clean, 3844/262144 files, 46290/524278 blocks
Found Valid Partition.
Connecting to host...
.
.
.
After the manifest is loaded, the following messages appear:
Manifest
WARNING:
WARNING:
WARNING:
Version matches package version
This is an unrecoverable operation!
This will erase all data on the Service Engine and install new software.
Configuration and user data must be restored after the system restarts.
Caution
This step cleans the disk. All configuration and voice messages will be lost after this step. For
future upgrades and installations, verify that a backup has been done. If it has not, abort at this
step and do a backup first.
Do you wish to continue (y,n) [n]
Step 2
Remove the old installation, if any. The output is similar to the following:
Do you wish to continue (y,n) [n] y
Removing old installation...done.
Retrieving cue10.0.0.18.prt1 from 10.3.61.16
Connecting to host...
.
.
.
100% complete.
Done.
.
.
.
Restoring License from Flash...
Flash license payload verified.
Restore License from Flash complete.
A change has occurred that requires the system to be restarted.
Do you wish to restart now (y,n) [y]
Step 3
Do not reboot the system. The output is similar to the following:
Do you wish to restart now (y,n) [y] n
Welcome to Cisco Service Engine
.
.
.
********** rc.post_install ****************
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
35
Installing Cisco Unity Express Software
Upgrading the Software or License Version
STARTED: cli_server.sh
.
.
.
se-172.20.231.191installer#>
Step 4
Install the license information using the following command:
software install package url ftp://ftp_ipaddress/cue-vm-YYZZZ.1.1.2.pkg
where
•
ftp_ipaddress—IP address of the FTP server
•
/cue-vm-YYZZZ.1.1.2.pkg—Name of the Cisco Unity Express license package. Use the slash mark
(/) before the package name.
The following example installs the 50 mailbox package on FTP server 10.3.61.16:
se-172.20.231.191installer#> software install package url
ftp://10.3.61.16/cue-vm-50cme.1.1.2.pkg
The output is similar to the following:
checksum: 8d8839c790efaf49d6619d4eb0918fca
size: 858
sig_ba length is : 978
out_ba length is : 65536
A change has occurred that requires the system to be restarted.
Do you wish to restart now (y,n) [y]
Step 5
Restart the system and go to the boot configuration. The output is similar to the following:
Do you wish to restart now (y,n) [y] y
INIT: Restarting system.
.
.
.
System Now Booting ...
Booting from flash..., please wait.
[BOOT-ASM]
7
Type *** quickly to interrupt the boot and get to the bootloader prompt.
Please enter '***' to change boot configuration:***
ServicesEngine Bootloader Version : 1.0.5
ServicesEngine boot-loader>
Step 6
Change the default boot source from helper to disk using the config command. Use the show config
command first to display the current settings, then use the config command to change the values.
The following example illustrates the output:
ServicesEngine boot-loader> show config
2w5d: %LINEPROTO-5-UPDOWN: Line protocol on Interface Service-Engine1/0, changed
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
36
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Upgrading the Software or License Version
state to up
IP addr:172.20.231.191
Netmask:255.255.0.0
TFTP server :10.3.61.16
GW IP addr:172.16.231.40
eth int:internal
Default boot:helper
Bootloader Version:1.0.5
Default Helper-file:cue_helper
Default BIOS:
primary
Default bootloader:
primary
Default cpu throttle: 50%
Note
The Default BIOS, Default bootloader, and Default cpu throttle appear
if an AIM is installed in the router. The cpu throttle value is factory set and cannot be
changed.
Note
An AIM can be configured to use primary or secondary BIOS. If primary BIOS is configured
as the default, the Cisco Unity Express module boots up normally. If secondary BIOS is
configured as the default, the Cisco Unity Express module boots up using primary BIOS,
looks for the secondary BIOS location, verifies the checksum, then uses the secondary
BIOS.
ServicesEngine boot-loader>
ServicesEngine boot-loader> config
IP Address [172.20.231.191] >
Subnet mask [255.255.0.0] >
TFTP server [10.3.61.16] >
Gateway [172.16.231.40] >
Default Helper-file [cue_helper] >
Ethernet interface [internal] >
Default Boot [helper] > disk
Updating flash with bootloader configuration
ServicesEngine boot-loader>
Step 7
Boot the newly installed software and license from the disk using the boot disk command. The following
example illustrates the output:
ServicesEngine boot-loader> boot disk
Filesystem type is ext2fs, partition type 0x83
kf: a1 : (hd0,0)/bzImage root=/dev/hda1 ro plat=nm
kf: a2 : (hd0,0)/bzImage root=/dev/hda1 ro plat=nm
in grub_open: (hd0,0)/bzImage root=/dev/hda1 ro plat=nm
.
.
.
FILESYSTEM CLEAN
Remounting the root filesystem read-write...
kernel.sem = 16384 32000 32 128
Welcome to Cisco Service Engine
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
37
Installing Cisco Unity Express Software
Upgrading the Software or License Version
.
.
.
********** rc.post_install ****************
Trace store to HD started
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
Welcome to Cisco Systems Service Engine post installation
configuration tool. This is a one time process which
will guide you through the set up the Service Engine.
Once run the system must be configured and started.
IMPORTANT:: If you do not wish to continue, the system will be halted
IMPORTANT:: so it can be safely removed from the router.
Do you wish to start configuration now (y,n)?
Step 8
Begin configuring Cisco Unity Express.
Do you wish to start configuration now (y,n) ?y
Are you sure (y,n)?y
Enter the IP address of the primary and secondary (if any) DNS servers.
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
IMPORTANT::
DNS Configuration:
This allows the entry of hostnames, for example foo.mycompany.com, instead
of IP addresses like 10.100.10.205 for servers used by Cisco Unity Express.
In order to configure DNS you must know the IP address of at least one of your
DNS Servers.
Would you like to use DNS for CUE (y,n)?y
Enter IP Address of the Primary DNS Server
(IP address): 172.68.226.120
Found server 172.68.226.120
Enter IP Address of the Secondary DNS Server
(IP address, or enter to bypass):
Enter hostname of the Primary NTP Server
(hostname, or enter for 172.100.26.1):
Enter hostname of the Secondary NTP Server
(hostname, or enter to bypass):
Select the correct time zone.
Please 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 Ocean
2) Americas
5) Asia
8) Europe
3) Antarctica 6) Atlantic Ocean
9) Indian Ocean
#? 2
Please select a country:
Please select a country.
1) Anguilla 18) Ecuador
35) Paraguay
2) Antigua & Barbuda 19) El Salvador
36) Peru
3) Argentina 20) French Guiana
37) Puerto Rico
4) Aruba 21) Greenland
38) St Kitts & Nevis
5) Bahamas 22) Grenada
39) St Lucia
.
.
.
When the software has updated the time zone, the software switches to a new run level and displays
the Cisco Unity Express module prompt.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
38
Cisco Unity Express Release 1.1.2
Installing Cisco Unity Express Software
Upgrading the Software or License Version
Changing owners and file permissions.
Change owners and permissions complete.
INIT: Switching to runlevel: 4
INIT: Sending processes the TERM signal
STARTED: DNS_startup.sh
STARTED: cli_server.sh
STARTED: ntp_startup.sh
STARTED: LDAP_startup.sh
STARTED: usermanager_startup.sh
STARTED: SQL_startup.sh
STARTED: HTTP_startup.sh
STARTED: ${ROOT}/usr/wfavvid/wfsysdb_startup.sh
STARTED: ${ROOT}/usr/wfavvid/run
STARTED: start_backuprestore.sh
STARTED: syslog_startup.sh
waiting 1 ...
waiting 2 ...
waiting 3 ...
waiting 4 ...
.
.
.
Enter the user ID and password for the system administrator.
IMPORTANT::
IMPORTANT::
Administrator Account Creation
IMPORTANT::
IMPORTANT:: Create an administrator account. With this account,
IMPORTANT:: you can log in to the Cisco Unity Express GUI and
IMPORTANT:: run the initialization wizard.
IMPORTANT::
Enter administrator user ID:
(user ID): admin
Enter password for admin:
(password):
Confirm password for admin by reentering it:
(password):
SYSTEM ONLINE
se-172.30.231.191>
Step 9
Log in to the system. Press Enter for the password, as shown in the following example:
se-172.30.231.191> enable
Password:
Step 10
Display the software version using the show software version command. The following example
illustrates the output:
se-172.30.231.191> show software version
Installed Packages:
- Core
1.1.2
- Auto Attendant
- Voice Mail
- Boot Loader
1.1.2
1.1.2
1.0.17
Installed Languages:
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
39
Installing Cisco Unity Express Software
Upgrading the Software or License Version
- US English
1.1.2
se-172.30.231.191#
Step 11
Display the software license using the show software license command. The following example
illustrates the output:
se-172.30.231.191> show software license
Core:
- application mode: cme
Voicemail:
- max message size: 6000
- max gdm: 15
- max mailboxes: 50
Auto Attendant:
- max ports: 8
Languages:
- max installed languages: unlimited
- max enabled languages: 1
se-172.30.231.191#
What to Do Next
1.
Restore the data and configuration files. See “Restoring Files” on page 90.
2.
Reboot the system.
3.
Enter the Cisco Unity Express command environment. See “Entering the Command Environment”
on page 17.
Cisco Unity Express CLI Administration Guide for Cisco CallManager Express, Release 1.1.2
40
Cisco Unity Express Release 1.1.2
Configuring System Components
Command-line interface (CLI) commands are available to configure Cisco Unity Express system
components. Some commands are entered in EXEC mode and others in configuration mode.
This chapter configures the basic Cisco Unity Express components:
•
SIP parameters that Cisco Unity Express needs to communicate with Cisco CallManager Express.
•
Voice mail, auto attendant, and greeting management system applications that ship with
Cisco Unity Express.
Additional procedures for configuring optional or advanced system components, such as servers and
custom auto attendant scripts, are described in “Advanced Configuration” on page 105.
All the procedures in this chapter can be implemented using either CLI commands or the graphical user
interface (GUI) options. Use the CLI procedures for bulk provisioning, scripting, upgrading, and
troubleshooting systems.
This chapter contains the following procedures for configuring Cisco Unity Express system components:
•
Configuring the SIP Proxy Server Location for Cisco Unity Express, page 42
•
Configuring the Voice Mail Application, page 43
•
Configuring the Greeting Management System Application, page 46
•
Configuring and Managing the Auto Attendant Application, page 47
•
Configuring Auto Attendant Scripts, page 53
•
Configuring SIP Triggers for the Applications, page 54
•
Deleting a SIP Application Trigger, page 56
•
Deleting an Application, page 58
•
Configuring System-Wide Mailbox Default Values, page 61
•
Configuring the MWI On and Off Extensions, page 63
•
Checking AIM Flash Memory Wear Activity, page 64
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
41
Configuring System Components
Configuring the SIP Proxy Server Location for Cisco Unity Express
Configuring the SIP Proxy Server Location for Cisco Unity
Express
The Session Initiation Protocol (SIP) proxy server resides on the router with an installed
Cisco Unity Express module. The SIP proxy server location information must be configured properly to
enable all communications between Cisco Unity Express and Cisco CallManager Express. The SIP
proxy server also enables the message waiting indicators (MWIs) to work with the Cisco Unity Express
voice mail application.
Note
The SIP proxy server used to support Cisco Unity Express does not provide the full equivalent
functionality as the Cisco SIP Proxy Server product.
Prerequisites
The following information is required to configure the SIP proxy server for Cisco Unity Express:
•
Hostname or IP address of the router where the SIP proxy server resides
•
UDP or TCP port of the router where the SIP proxy server resides
1.
config t
2.
ccn subsystem sip
3.
gateway address ip_address
4.
gateway port port_number
5.
end
6.
exit
7.
show ccn subsystem sip
8.
copy running-config startup-config
SUMMARY STEPS
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ccn subsystem sip
Enters SIP configuration mode.
Step 3
gateway address ip_address
Specifies the hostname or IP address of the router
where the SIP proxy server resides.
Example:
se-10-0-0-0(config-sip)# gateway address 10.100.6.9
Step 4
gateway port port_number
Specifies the UDP/TCP port number on the router
where the SIP proxy server resides.
Example:
se-10-0-0-0(config-sip)# gateway port 5060
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
42
Cisco Unity Express Release 1.1.2
Configuring System Components
Configuring the Voice Mail Application
Command or Action
Purpose
Step 5
end
Exits SIP configuration mode.
Step 6
exit
Exits configuration mode.
Step 7
show ccn subsystem sip
Displays the SIP subsystem parameters.
Example:
se-10-0-0-0# show ccn subsystem sip
Step 8
copy running-config startup-config
Copies the configuration changes to the startup
configuration.
Example
The following example illustrates the show ccn subsystem sip output:
se-10-0-0-0# show ccn subsystem sip
SIP Gateway:
SIP Port Number:
se-10-0-0-0#
10.100.6.9
5060
What to Do Next
Configure the voice mail application. See “Configuring the Voice Mail Application” on page 43.
Configuring the Voice Mail Application
After the Cisco Unity Express software is installed on the system, the voice mail application that ships
with Cisco Unity Express must be configured using the procedures described in this section. The
application is enabled by default.
To configure the voice-mail access and operator telephone numbers, see “Configuring SIP Triggers for
the Applications” on page 54.
The commands are used in both EXEC and configuration modes.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
43
Configuring System Components
Configuring the Voice Mail Application
Sharing Ports Among Applications and Triggers
One of the parameters that you may configure for the voice mail and auto attendant applications is the
maximum number of callers who can access the application concurrently at any given time. This
parameter, maxsessions, is limited by the number of ports on the Cisco Unity Express module. (See
“Software Licenses and Factory-Set Limits” on page 3 for the number of ports on your module.)
Consider your expected call traffic when assigning the number of ports to an application. One
application may need more available ports than another, but each application should have at least one
port available for incoming calls.
Suppose, for example, that your module has 4 ports and you assign 4 to the voice mail application
maxsessions and 4 to the auto attendant maxsessions. If 4 callers access voice mail simultaneously, no
ports will be available for auto attendant callers. Only when 0, 1, 2, or 3 callers access voice mail
simultaneously will at least one port be available for auto attendant.
Suppose, instead, you assign 3 to the voice-mail maxsessions and 3 to the auto attendant maxsessions.
At no time will one application use up all the ports. If voice mail has 3 active calls, then 1 caller can
access auto attendant. A second call to auto attendant will not go through at that moment.
Similarly, you must assign the maxsessions parameter to each application trigger, which is the telephone
number that activates the application’s script. The value of the trigger’s maxsessions must not exceed the
application’s maxsessions value.
Prerequisites
The following information is required to configure the voice mail application:
•
Maximum number of users who can access voice mail simultaneously
1.
config t
2.
ccn application fullname
3.
(Optional) description “text”
4.
maxsessions number
5.
end
6.
exit
7.
show ccn scripts
8.
show ccn application
9.
copy running-config startup-config
SUMMARY STEPS
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
44
Cisco Unity Express Release 1.1.2
Configuring System Components
Configuring the Voice Mail Application
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ccn application fullname
Specifies the application to configure and enters
application configuration mode. Use the full name
of the application for the fullname argument.
Example:
se-10-0-0-0(config)# ccn application voicemail
Step 3
(Optional) Enter a description of the application.
Use double quotes around the text.
description “text”
Example:
se-10-0-0-0(config-application)# description “Voice
Mail”
Step 4
se-10-0-0-0(config-application)# maxsessions 6
Specifies the number of users who can access this
application simultaneously. See “Sharing Ports
Among Applications and Triggers” on page 44 for
guidelines on assigning this value.
Step 5
end
Exits application configuration mode.
Step 6
exit
Exits configuration mode.
Step 7
show ccn scripts
Displays the configured script names and their
descriptions.
maxsessions number
Example:
Example:
se-10-0-0-0# show ccn scripts
Step 8
Displays details about each configured
application.
show ccn application
Example:
se-10-0-0-0# show ccn application
Step 9
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Example
The following example illustrates the show ccn scripts output:
se-10-0-0-0# show ccn scripts
Name:
Create Date:
Last Modified Date:
Length in Bytes:
setmwi.aef
Tue Apr 20 20:22:27 PDT 1993
Tue Apr 20 20:22:27 PDT 1993
21990
Name:
Create Date:
Last Modified Date:
Length in Bytes:
voicebrowser.aef
Tue Apr 20 20:22:39 PDT 1993
Tue Apr 20 20:22:39 PDT 1993
13409
Name:
Create Date:
aa.aef
Tue Apr 20 20:22:47 PDT 1993
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
45
Configuring System Components
Configuring the Greeting Management System Application
Last Modified Date:
Length in Bytes:
Tue Apr 20 20:22:47 PDT 1993
56227
The following example illustrates the show ccn application output:
se-10-0-0-0# show ccn application
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
logoutUri:
bxLogout.jsp
uri:
ogin.vxml
voicemail
Voice Mail
voicebrowser.aef
1
yes
6
http://localhost/voicemail/vxmlscripts/m
http://localhost/voicemail/vxmlscripts/l
se-10-0-0-0#
Configuring the Greeting Management System Application
The Greeting Management System (GMS) application is a telephony-based interface that allows Cisco
Unity Express administrators to record new audio prompts or delete exsiting custom audio prompts
without using a PC or sound-editing software. These prompts can then be used in various Cisco Unity
Express Automated Attendant (AA) scripts, such as the Welcome prompt in the default auto attendant.
The Emergency Alternate Greeting (EAG) is an option within the GMS that allows users to record,
modify, and enable or disable a special greeting to be played prior to the regular greeting, notifying
callers of some temporary event or message.
The Cisco Unity Express module installation automatically configures the GMS application. This
application permits recording and administration of auto attendant prompts using the telephone user
interface (TUI).
Only users with administrative (superuser) privileges or greeting management (ManagePrompt)
privileges have access to the GMS. (See “Adding and Modifying a Group” on page 71 for information
about assigning privileges.) When a caller dials the GMS number, the GMS authenticates the caller by
requesting the caller’s extension and PIN. The GMS disconnects the caller if the caller does not have
administrative authority.
To configure the GMS access telephone number, see “Configuring SIP Triggers for the Applications” on
page 54.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
46
Cisco Unity Express Release 1.1.2
Configuring System Components
Configuring and Managing the Auto Attendant Application
Configuring and Managing the Auto Attendant Application
After the Cisco Unity Express software is installed on the system, the auto attendant application that
ships with Cisco Unity Express must be configured using the procedures described in this section.
The only component of the default auto attendant which resides in the user directory is an audio prompt
file called AAWelcome.wav. This is the default welcome greeting prompt. All other audio prompt files
used by the auto attendant reside in the system directory and cannot be downloaded, copied, or uploaded
by users. To customized the default welcome greeting prompt, see “Customizing the Default Auto
Attendant Welcome Prompt” on page 51.
The default auto attendant script provided with Cisco Unity Express is named aa.aef. This file resides
in the system directory, and cannot be downloaded, copied, or uploaded by users. This default auto
attendant application is also known as the “system script”, or “system AA”. This default script supports
basic functions such as dial-by-extension, dial-by-spelling username, and call operator functions. If
additional functionality is required, then you must create a customized auto attendant script. To create
customized script files, see “Configuring Auto Attendant Scripts” on page 53.
To configure the auto attendant access telephone number, see “Configuring SIP Triggers for the
Applications” on page 54.
The commands are used in both EXEC and configuration modes.
See “Configuring Application Parameters” on page 108 for procedures to configure user-defined
parameters.
Prerequisites
The following information is required to configure auto attendant:
•
To use your own welcome greeting, create a .wav file containing the prerecorded welcome greeting.
This file must be uploaded to Cisco Unity Express module so that it can be located and saved in the
auto attendant script. Alternatively, you can use the greeting management system (GMS) to record
the welcome greeting. See “Recording an Auto Attendant Greeting or Prompt File” on page 51 for
guidelines on recording a greeting. See “Uploading the Auto Attendant Greeting or Prompt File” on
page 52 for the procedure to upload the prompt to Cisco Unity Express.
•
Application name
•
Number of times the auto attendant will replay instructions to a caller before the call is disconnected.
This count begins when the caller moves past the main menu and starts to hear instructions for a
submenu. The main menu will play five times and then, if the caller makes no choice or incorrect
choices, will transfer to the operator.
•
Extension number of the operator. Auto attendant dials this extension when the caller presses the
zero (“0”) button.
•
The customized WAV filename if you change the default auto attendant welcome prompt.
•
Telephone number that the caller must dial to reach the auto attendant. In many cases, this number
is your company telephone number.
•
Maximum number of callers that auto attendant can handle simultaneously. See “Sharing Ports
Among Applications and Triggers” on page 44 for guidelines on assigning this value.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
47
Configuring System Components
Configuring and Managing the Auto Attendant Application
SUMMARY STEPS
1.
config t
2.
ccn application fullname
3.
(Optional) description “text”
4.
maxsessions number
5.
parameter “name” “value”
6.
enabled
7.
end
8.
exit
9.
show ccn scripts
10. show ccn application
11. copy running-config startup-config
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ccn application fullname
Specifies the application to configure and enters
application configuration mode. Use the full name
of the application for the fullname argument.
Example:
se-10-0-0-0(config)# ccn application AutoAttendant
Step 3
description “text”
(Optional) Enter a description of the application.
Use double quotes around the text.
Example:
se-10-0-0-0(config-application)# description “Auto
Attendant”
Step 4
maxsessions number
Example:
se-10-0-0-0(config-application)# maxsessions 4
Specifies the number of users who can access this
application simultaneously. See “Sharing Ports
Among Applications and Triggers” on page 44 for
guidelines on assigning this value.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
48
Cisco Unity Express Release 1.1.2
Configuring System Components
Configuring and Managing the Auto Attendant Application
Step 5
Command or Action
Purpose
parameter “name” “value”
Specifies parameters for the application. Each
parameter must have a name and a value, which is
written within double quotes. The parameters
below are case-sensitive. For more information
about configuring application parameters, see the
“Configuring Application Parameters” section on
page 108.
Example:
se-10-0-0-0(config-application)# parameter “operExtn”
“1000”
se-10-0-0-0(config-application)# parameter “MaxRetry”
“3”
se-10-0-0-0(config-application)# parameter
“welcomePrompt” “ciscowelcome.wav”
For the auto attendant application, the parameters
are:
•
“operExtn”—Extension that the system dials
when a caller presses “0” to reach the auto
attendant operator. This is also the extension
where the call will be transferred to if there is
no user input (timeout).
•
“MaxRetry”—Maximum number of times a
user can incorrectly choose a submenu option
before the application disconnects the call.
The default is 3.
•
“welcomePrompt”—The WAV filename
containing the customized auto attendant
welcome prompt that is uploaded to the Cisco
Unity Express module. This is the only
greeting or prompt that can be customized
when using the default auto attendant. For
more information, see the “Customizing the
Default Auto Attendant Welcome Prompt”
section on page 51.
Note that entering this parameter does not
upload the WAV file to the Cisco Unity
Express module. See the “Uploading the Auto
Attendant Greeting or Prompt File” section
on page 52.
Step 6
Allows the application to be accessible to the
system.
enabled
Example:
se-10-0-0-0(config-application)# enabled
Step 7
end
Exits application configuration mode.
Step 8
exit
Exits configuration mode.
Step 9
show ccn scripts
Displays the configured script names and their
descriptions.
Example:
se-10-0-0-0# show ccn scripts
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
49
Configuring System Components
Configuring and Managing the Auto Attendant Application
Step 10
Command or Action
Purpose
show ccn application
Displays details about each configured
application.
Example:
se-10-0-0-0# show ccn application
Step 11
Copies the configuration change to the startup
configuration.
copy running-config startup-config
Examples
The following example illustrates the show ccn scripts output:
se-10-0-0-0# show ccn scripts
Name:
Create Date:
Last Modified Date:
Length in Bytes:
setmwi.aef
Tue Apr 20 20:22:27 PDT 1993
Tue Apr 20 20:22:27 PDT 1993
21990
Name:
Create Date:
Last Modified Date:
Length in Bytes:
voicebrowser.aef
Tue Apr 20 20:22:39 PDT 1993
Tue Apr 20 20:22:39 PDT 1993
13409
Name:
Create Date:
Last Modified Date:
Length in Bytes:
aa.aef
Tue Apr 20 20:22:47 PDT 1993
Tue Apr 20 20:22:47 PDT 1993
56227
Name:
Create Date:
Last Modified Date:
Length in Bytes:
se-10-0-0-0#
promptmgmt.aef
Tue Apr 20 20:22:59 PDT 1993
Tue Apr 20 20:22:59 PDT 1993
80781
The following example illustrates the show ccn application output:
se-10-0-0-0# show ccn application
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
MaxRetry:
operExtn:
welcomePrompt:
se-10-0-0-0#
autoattendant
autoattendant
aa.aef
2
yes
4
3
1000
AAWelcome.wav
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
50
Cisco Unity Express Release 1.1.2
Configuring System Components
Configuring and Managing the Auto Attendant Application
Configuring Auto Attendant Prompts
Cisco Unity Express supports customized greeting and prompt files. The NM supports up to 50 prompts;
the AIM supports up to 25 prompts. When using the default auto attendant, the only greeting or prompt
that can be customized is the “WelcomePrompt” contained in the AAwelcome.wav file.
Customizing prompts requires the following procedures:
•
Recording an Auto Attendant Greeting or Prompt File, page 51
•
Customizing the Default Auto Attendant Welcome Prompt, page 51
•
Uploading the Auto Attendant Greeting or Prompt File, page 52
•
(Optional) Downloading an Auto Attendant Greeting or Prompt File, page 52
•
(Optional) Deleting an Auto Attendant Greeting or Prompt File, page 52
Recording an Auto Attendant Greeting or Prompt File
Two methods are available to create auto attendant greeting and prompt files:
•
Create a.wav file with the following format: G.711 U-law, 8 kHz, 8 bit, Mono. The file cannot be
larger than 1 MB, which corresponds to a greeting length of approximately 120 seconds. After
recording the greeting, use the GUI or Cisco Unity Express CLI ccn copy url command to copy the
file in to the Cisco Unity Express system. See the next section, “Uploading the Auto Attendant
Greeting or Prompt File,” for the upload procedure.
•
Use the GMS on the TUI to record the greeting or prompt. Dial the GMS telephone number and
select the option to record a greeting. When finished recording, save the file. GMS automatically
saves the file in Cisco Unity Express.
The GMS prompt filename has the format UserPrompt_DateTime.wav, for example:
UserPrompt_11152003144055.wav. You may want to use CLI commands or GUI options to
download the file to a PC, rename the file with a meaningful name, then upload the file back to Cisco
Unity Express.
Cisco recommends using the GMS on the TUI to record greetings and prompts because the GMS
provides higher sound quality compared to .wav files recorded using other methods.
Customizing the Default Auto Attendant Welcome Prompt
The default auto attendant greeting included with the system lasts two seconds and plays the prompt
“Welcome to the Automated Attendant”. You can record a custom welcome prompt specifically for your
system to welcome callers. The default WAV filename is AAwelcome.wav. While the default welcome
prompt in the WAV file lasts two seconds long, you can record a new welcome prompt up to 120 seconds
long. The welcome prompt WAV file can be up to 1 MB in G.711 U-law format.
If you create a customized welcome prompt, use a different WAV filename and upload the new WAV file
to the Cisco Unity Express module. Do not overwrite the default AAwelcome.wav filename. For
information about uploading the welcome prompt WAV file, see “Uploading the Auto Attendant
Greeting or Prompt File” on page 52.
Uploading the prompt will not make the auto attendant start using the new welcome prompt. You need
to configure the prompt name as the parameter as described in the “Configuring and Managing the Auto
Attendant Application” section on page 47.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
51
Configuring System Components
Configuring and Managing the Auto Attendant Application
Note
The WAV file for the welcome prompt is not interruptible, meaning that the longer the recorded welcome
prompt is, the longer callers must wait before being able to enter digits to reach other extensions. Cisco
recommends you record a short welcome prompt so that callers can access the auto attendant system
quickly.
Following this welcome prompt, the default script plays the menu announcement listing the menu
options for callers. These prompts within the default auto attendant provided with the system are not
customizable. Note that if a caller uses the dial-by-extension option, the system will attempt to transfer
to any extension, including extensions not defined using Cisco Unity Express. To prevent callers from
transferring to extensions not defined using Cisco Unity Express, configure class of restrictions (COR)
on the dial-peer, or develop a custom script to prevent the option.
Uploading the Auto Attendant Greeting or Prompt File
After recording the.wav greeting or prompt file, upload the file using the ccn copy command in
Cisco Unity Express EXEC mode:
ccn copy url source-ip-address prompt prompt-filename
Example:
se-10-0-0-0# ccn copy url ftp://10.100.10.123/AAprompt1.wav prompt AAprompt1.wav
se-10-0-0-0# ccn copy url http://www.server.com/AAgreeting.wav prompt AAgreeting.wav
This command is equivalent to using the GUI option Voice Mail > Prompts and selecting Upload.
An error message appears if you try to upload more than the maximum number of prompts allowed on
your Cisco Unity Express module.
Note
The AAWelcome.wav file resides in the Prompts/user/en_US/ directory. All the other system prompts
reside in the Prompts/system/en_US/ directory. When you upload the WAV file using the ccn copy url
command, the updated file is uploaded back to the Prompts/user/en_US/ directory, and not to the
Prompts/system/en_US/ directory.
Downloading an Auto Attendant Greeting or Prompt File
Greetings and prompts can be copied from the auto attendant and stored to another server or PC.
To copy a greeting or prompt file, use the ccn copy command in Cisco Unity Express EXEC mode:
ccn copy prompt prompt-file-name url destination-ip-address
Example:
se-10-0-0-0# ccn copy prompt AAprompt2.wav url ftp://10.100.10.123/AAprompt2.wav
Deleting an Auto Attendant Greeting or Prompt File
To delete an auto attendant greeting or prompt file from Cisco Unity Express, use the ccn delete
command in Cisco Unity Express EXEC mode:
ccn delete prompt prompt-filename
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
52
Cisco Unity Express Release 1.1.2
Configuring System Components
Configuring Auto Attendant Scripts
Example:
se-10-0-0-0# ccn delete prompt AAgreeting.wav
Configuring Auto Attendant Scripts
Cisco Unity Express supports customized script files. The NM supports up to 8 scripts; the AIM supports
up to 4 scripts.
Customizing scripts requires the following procedures:
•
Creating an Auto Attendant Script, page 53
•
Uploading the Auto Attendant Script File, page 53
•
(Optional) Downloading an Auto Attendant Script File, page 53
•
(Optional) Deleting an Auto Attendant Script File, page 54
Creating an Auto Attendant Script
The auto attendant script file is created using the script editor program. Refer to Cisco Unity Express
Script Editor Guide for guidelines and procedures for creating a script file.
The file cannot be larger than 256 KB.
After creating the script, use the GUI or Cisco Unity Express CLI ccn copy command to copy the file in
to the Cisco Unity Express system. See the next section, “Uploading the Auto Attendant Script File,” for
the upload procedure.
Uploading the Auto Attendant Script File
After recording the .wav greeting or prompt file, upload the file using the ccn copy command in
Cisco Unity Express EXEC mode:
ccn copy url source-ip-address script script-filename
Example:
se-10-0-0-0# ccn copy url ftp://10.100.10.123/GMSscript.aef script GMSscript.aef
se-10-0-0-0# ccn copy url http://www.server.com/GMSscript.aef script GMSscript.aef
This command is equivalent to using the GUI option Voice Mail > Scripts and selecting Upload.
An error message appears if you try to upload more than the maximum number of scripts allowed on
your Cisco Unity Express module.
Downloading an Auto Attendant Script File
Scripts can be copied from the auto attendant and stored on another server or PC.
To copy a script file, use the ccn copy command in Cisco Unity Express EXEC mode:
ccn copy script prompt-file-name url destination-ip-address
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
53
Configuring System Components
Configuring SIP Triggers for the Applications
Example:
se-10-0-0-0# ccn copy script GMSscript.aef url ftp://10.100.10.123/GMSscript.aef
Deleting an Auto Attendant Script File
To delete an auto attendant script file from Cisco Unity Express, use the ccn delete command in
Cisco Unity Express EXEC mode:
ccn delete script script-filename
Example:
se-10-0-0-0# ccn delete script GMSscript.aef
Are you sure you want to delete this script? (y/n)
Configuring SIP Triggers for the Applications
After the voice mail, auto attendant and GMS applications are configured, the system must be configured
to start the voice mail, auto attendant, and GMS applications when a specific signal, or trigger, is
invoked. The trigger is a telephone number. When a caller dials a specified telephone number, the SIP
subsystem starts the voice mail, auto attendant, or GMS application.
See “Advanced Configuration” on page 105 for procedures to configure multiple triggers for an
application.
Prerequisites
The following information is required to configure the SIP triggers for auto attendant:
•
Telephone number that invokes the application. The number must be different for voice mail, auto
attendant, and the GMS. The number value should match one of the patterns configured in the
destination-pattern field of the SIP dial peer pointing to Cisco Unity Express.
•
Maximum number of callers, or sessions, that can access the trigger simultaneously. See “Sharing
Ports Among Applications and Triggers” on page 44 for guidelines on assigning this value.
SUMMARY STEPS
Starting from EXEC mode:
1.
config t
2.
ccn trigger sip phonenumber number
3.
application string
4.
enabled
5.
maxsessions number
6.
end
7.
exit
8.
show ccn trigger
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
54
Cisco Unity Express Release 1.1.2
Configuring System Components
Configuring SIP Triggers for the Applications
9.
copy running-config startup-config
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ccn trigger sip phonenumber number
Specifies the telephone number that acts as the trigger
to start the application on the Cisco Unity Express
module and enters trigger configuration mode. The
number value should match one of the patterns
configured in the destination-pattern field of the SIP
dial peer pointing to Cisco Unity Express.
Example:
se-10-0-0-0(config)# ccn trigger sip phonenumber
50150
se-10-0-0-0(config)# ccn trigger sip phonenumber
50160
Step 3
Specifies the name of the application to start when the
trigger is entered.
application string
Example:
se-10-0-0-0(config-trigger)# application voicemail
se-10-0-0-0(config-trigger)# application
autoattendant
se-10-0-0-0(config-trigger)# application
promptmanagement
Step 4
Enables the trigger.
enabled
Example:
se-10-0-0-0(config-trigger)# enabled
Step 5
maxsessions number
Example:
se-10-0-0-0(config-trigger)# maxsessions 3
se-10-0-0-0(config-trigger)# maxsessions 6
Specifies the maximum number of callers the
application can handle simultaneously. See “Sharing
Ports Among Applications and Triggers” on page 44
for guidelines on assigning this value.
Step 6
end
Exits trigger configuration mode.
Step 7
exit
Exits configuration mode.
Step 8
show ccn trigger
Displays the parameter values for all configured
triggers.
Example:
se-10-0-0-0# show ccn trigger
Step 9
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
55
Configuring System Components
Deleting a SIP Application Trigger
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)# maxsessions 4
se-10-0-0-0(config-trigger)# enabled
se-10-0-0-0(config-trigger)# end
se-10-0-0-0(config)#
se-10-0-0-0(config)# ccn trigger sip phonenumber 50160
se-10-0-0-0(config-trigger)# application autoattendant
se-10-0-0-0(config-trigger)# maxsessions 3
se-10-0-0-0(config-trigger)# enabled
se-10-0-0-0(config-trigger)# end
se-10-0-0-0#
The output for show ccn trigger will look similar to the following:
se-10-0-0-0# show ccn trigger
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
50150
SIP
voicemail
systemDefault
5000
yes
4
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
se-10-0-0-0#
50160
SIP
autoattendant
systemDefault
5000
yes
8
Deleting a SIP Application Trigger
Use this procedure to delete a SIP application trigger. Deleting the trigger does not delete the application,
although the application needs at least one trigger in order to be invoked by the system.
Prerequisites
The trigger number is required to delete a trigger.
SUMMARY STEPS
1.
show ccn trigger
2.
config t
3.
no ccn trigger sip phonenumber number
4.
exit
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
56
Cisco Unity Express Release 1.1.2
Configuring System Components
Deleting a SIP Application Trigger
5.
show ccn trigger
6.
copy running-config startup-config
DETAILED STEPS
Command or Action
Purpose
Step 1
show ccn trigger
Displays the currently configured triggers. Look for
the telephone number that you want to delete. Verify
that this telephone number is associated with the
correct application.
Step 2
config t
Enters configuration mode.
Step 3
no ccn trigger sip phonenumber number
Deletes the trigger number.
Example:
se-10-0-0-0(config)# no ccn trigger sip phonenumber
50100
Step 4
exit
Exits configuration mode.
Step 5
show ccn trigger
Displays the configured triggers.
Step 6
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Example
The output for show ccn trigger will look similar to the following:
se-10-0-0-0# show ccn trigger
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
6500
SIP
voicemail
systemDefault
5000
yes
4
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
se-10-0-0-0#
6700
SIP
autoattendant
systemDefault
5000
yes
8
The following configuration removes a trigger from the voice mail application:
se-10-0-0-0# config t
se-10-0-0-0(config)# no ccn trigger sip phonenumber 50170
se-10-0-0-0(config)# exit
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
57
Configuring System Components
Deleting an Application
Now the output for show ccn trigger will look similar to the following:
se-10-0-0-0# show ccn trigger
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
se-10-0-0-0#
50170
SIP
autoattendant
systemDefault
5000
yes
8
Deleting an Application
If you configure an application that you do not want to keep, use this procedure to delete the application
and any triggers associated with that application. If you do not delete the triggers, the application will
be invoked when one of the triggers is called.
After you delete the application and triggers, the script associated with the application remains installed
on your server but is not used by Cisco Unity Express.
To make this application usable, reconfigure it.
The default voice mail, auto attendant, and greeting management system applications that shipped with
Cisco Unity Express cannot be deleted.
Prerequisites
The following information is required to delete an application:
•
Application name
•
All trigger numbers associated with the application
1.
show ccn application
2.
show ccn trigger
3.
config t
4.
no ccn trigger sip phonenumber number
5.
no ccn application name
6.
exit
7.
show ccn application
8.
show ccn trigger
9.
copy running-config startup-config
SUMMARY STEPS
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
58
Cisco Unity Express Release 1.1.2
Configuring System Components
Deleting an Application
DETAILED STEPS
Command or Action
Purpose
Step 1
show ccn application
Displays the currently configured applications.
Look for the name of the application you want
to delete.
Step 2
show ccn trigger
Displays the currently configured triggers. Look
for the telephone numbers associated with the
application you want to delete.
Step 3
config t
Enters configuration mode.
Step 4
no ccn trigger sip phonenumber number
Deletes a trigger associated with this
application. Repeat this command for each
trigger associated with the application.
Examples:
se-10-0-0-0(config)# no ccn trigger sip phonenumber
50170
Step 5
Deletes the application called name.
no ccn application name
Example:
se-10-0-0-0(config)# no ccn application autoattendant
Step 6
exit
Exits configuration mode.
Step 7
show ccn application
Displays the currently configured applications.
Confirm that the deleted application is not
displayed.
Step 8
show ccn trigger
Displays the triggers for each configured
application.
Step 9
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Example
The following is sample output from the show ccn application and show ccn trigger commands:
se-10-0-0-0# show ccn application
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
logoutUri:
bxLogout.jsp
uri:
ogin.vxml
voicemail
voicemail
voicebrowser.aef
1
yes
8
http://localhost/voicemail/vxmlscripts/m
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
autoattendant
autoattendant
aa.aef
2
yes
8
http://localhost/voicemail/vxmlscripts/l
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
59
Configuring System Components
Deleting an Application
MaxRetry:
operExtn:
welcomePrompt:
se-10-0-0-0#
3
0
AAWelcome.wav
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
MaxRetry:
operExtn:
welcomePrompt:
se-10-0-0-0#
myapplication
My AA application
myscript.aef
3
yes
8
3
0
NewAAWelcome.wav
se-10-0-0-0# show ccn trigger
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
6500
SIP
voicemail
systemDefault
5000
yes
3
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
se-10-0-0-0#
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
se-10-0-0-0#
6700
SIP
autoattendant
systemDefault
5000
yes
8
7200
SIP
myapplication
systemDefault
5000
yes
8
The following configuration deletes the auto attendant application and its trigger:
se-10-0-0-0# config t
se-10-0-0-0(config)# no ccn trigger sip phonenumber 50170
se-10-0-0-0(config)# no ccn application myapplication
se-10-0-0-0(config)# exit
Now the output for the show commands looks similar to this:
se-10-0-0-0# show ccn application
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
logoutUri:
bxLogout.jsp
uri:
ogin.vxml
voicemail
voicemail
voicebrowser.aef
1
yes
8
http://localhost/voicemail/vxmlscripts/m
http://localhost/voicemail/vxmlscripts/l
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
60
Cisco Unity Express Release 1.1.2
Configuring System Components
Configuring System-Wide Mailbox Default Values
se-10-0-0-0#
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
MaxRetry:
operExtn:
welcomePrompt:
se-10-0-0-0#
autoattendant
autoattendant
aa.aef
2
yes
8
3
0
AAWelcome.wav
se-10-0-0-0# show ccn trigger
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
6500
SIP
voicemail
systemDefault
5000
yes
3
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
se-10-0-0-0#
6700
SIP
autoattendant
systemDefault
5000
yes
8
Configuring System-Wide Mailbox Default Values
The following system-wide parameters are configurable for all new voice mailboxes. These values are
assigned automatically to a new voice mailbox. Several of these values have factory default values. See
“Feature Overview” on page 1 for the maximum values for your system.
•
Capacity—The total amount of storage time in hours allowed for all mailboxes in the system. The
factory default is the maximum allowed storage for your system.
•
Expiration date—The number of days a message is saved in the mailbox. When the user logs in to
the voice mailbox, the user hears a message listing all the expired messages. The user can save, skip,
or delete each message. The factory default value is 30 days.
•
Language—The language used for voice mail prompts. In Release 1.1.2, U.S. English is the only
language available.
•
Mailbox size—The maximum number of seconds of storage for voice messages in a mailbox. The
factory default value is determined by dividing the maximum storage capacity by the maximum
number of mailboxes (personal plus general delivery).
•
Message length—The maximum number of seconds for any one stored message in a mailbox. The
factory default is 60 seconds.
•
Recording time—The maximum amount of time for a user’s recorded mailbox greeting.
•
Operator extension—The extension of the voice-mail operator.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
61
Configuring System Components
Configuring System-Wide Mailbox Default Values
Caution
The voice-mail telephone number and the voice-mail operator’s telephone number should not be the
same. If they are, then a user trying to call the operator while in the voice-mail system will be directed
back to the voice-mail system. Also, an outside caller who presses the button for the operator will be
connected to the voice-mail system.
See “Creating and Modifying a Voice Mailbox” on page 75 for the procedure to configure different
values for mailbox size, message length, and expiration date for a specific mailbox.
SUMMARY STEPS
1.
config t
2.
voicemail capacity time minutes
3.
voicemail defaults {expiration days | language | mailboxsize mailboxsize_seconds |
messagesize messagesize_seconds}
4.
voicemail operator telephone tel_number
5.
voicemail recording time minutes
6.
exit
7.
copy running-config startup-config
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
voicemail capacity time minutes
Sets the time value as the system-wide maximum
storage space in minutes allowed for all configured
mailboxes.
Example:
se-10-0-0-0(config)# voicemail capacity time 3000
Step 3
voicemail default {expiration days | language |
mailboxsize mailboxsize_seconds |
messagesize messagesize_seconds}
Example:
se-10-0-0-0(config)# voicemail default expiration 30
se-10-0-0-0(config)# voicemail default mailboxsize
300
se-10-0-0-0(config)# voicemail default messagesize
120
Assigns default values for new individual or general
delivery mailboxes. These values can be configured
later to other values for specific mailboxes.
•
expiration days—Sets the number of days a
message can be stored in a mailbox before the
voice-mail system deletes it.
•
language—Specifies the language used for
voice-mail prompts. In Release 1.0, only U.S.
English is available.
•
mailboxsize mailboxsize_seconds—Sets the
maximum number of seconds for storing
messages in a mailbox.
•
messagesize messagesize_seconds—Sets the
maximum number of seconds for a caller’s
message stored in a mailbox.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
62
Cisco Unity Express Release 1.1.2
Configuring System Components
Configuring the MWI On and Off Extensions
Step 4
Command or Action
Purpose
voicemail operator telephone tel_number
Assigns the tel_number value as the voice-mail
operator’s extension. A mailbox owner dials this
extension while in the voice-mail system to reach the
voice-mail operator. Do not assign this extension to a
group. This extension need not be the same as the
auto attendant operator extension.
Example:
se-10-0-0-0(config)# voicemail operator telephone
9000
Step 5
voicemail recording time minutes
Example:
Assigns the time value in minutes as the maximum
recording time for any greeting or message in the
voice-mail system.
se-10-0-0-0(config)# voicemail recording time 10
Step 6
exit
Exits configuration mode.
Step 7
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Configuring the MWI On and Off Extensions
Cisco Unity Express uses the MWI on and off extensions with the affected telephone extension to
generate a SIP call to Cisco CME, which changes the status of the telephone’s MWI light.
Cisco Unity Express refreshes the MWI lights automatically when new messages are received, saved, or
deleted or when the software is initialized.Use the GUI option or CLI commands to refresh the MWI
lights for a specific telephone or for all configured telephones. See “Refreshing Message Waiting
Indicators” on page 81 for the procedure to refresh MWI lights.
Prerequisites
Verify that the MWI on and off extensions are configured on Cisco CME; otherwise, the MWI light will
not work.
The following information is required to configure the MWI on and off extensions:
•
Extension number dedicated to the MWI on extension
•
Extension number dedicated to the MWI off extension
SUMMARY STEPS
Starting from Cisco Unity Express EXEC mode:
1.
config t
2.
ccn application ciscomwiapplication
3.
parameter strMWI_ON_DN on_extension
4.
parameter strMWI_OFF_DN off_extension
5.
end
6.
copy running-config startup-config
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
63
Configuring System Components
Checking AIM Flash Memory Wear Activity
DETAILED STEPS
Command of Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ccn application ciscomwiapplication
Enters configuration mode for the MWI application.
Step 3
parameter strMWI_ON_DN on_extension
Assigns the on_extension value as the MWI on
extension.
Example:
se-10-0-0-0(config-application)# parameter
strMWI_ON_DN 7000
Step 4
parameter strMWI_OFF_DN off_extension
Assigns the off_extension value as the MWI off
extension.
Example:
se-10-0-0-0(config-application)# parameter
strMWI_OFF_DN 7001
Step 5
end
Exits application configuration mode.
Step 6
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Checking AIM Flash Memory Wear Activity
Cisco Unity Express tracks the use and wear of the AIM flash memory as log and trace data are saved
to the module. To display this data, use the show interface ide 0 command in Cisco Unity Express EXEC
mode.
show interface ide 0
The following is sample output:
se-10-0-0-0# show interface ide 0
IDE hd0 is up, line protocol is up
3496 reads, 46828544 bytes
0 read errors
9409 write, 137857024 bytes
0 write errors
0.09933333333333333% worn
To check the log and trace files on the flash memory, use the log trace command in Cisco Unity Express
EXEC mode.
log trace
Logging and tracing to the flash memory is turned off by default. Executing the log trace command starts
the log and trace functions immediately.
The command displays the atrace.log and messages.log files. Each file has a fixed length of 10 MB, and
tracing or logging stops automatically when the file reaches this length. New files overwrite the old files.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
64
Cisco Unity Express Release 1.1.2
Configuring Users, Groups, and Mailboxes
Overview
All configuration and administration functions for Cisco Unity Express are available through the
graphical user interface (GUI). However, you may find using the command-line interface (CLI) is more
efficient than using the GUI. For example, you may want to create a script to configure a large number
of users or mailboxes for a specific system. In this case, the CLI may be more useful.
This chapter contains the commands that would emulate the following tasks available on the GUI, and
contains the following sections:
•
Adding and Modifying a User, page 66
•
Adding and Modifying a Group, page 71
•
Creating and Modifying a Voice Mailbox, page 75
•
Unlocking a Voice Mailbox, page 80
•
Refreshing Message Waiting Indicators, page 81
Prerequisites
Verify that the telephones and extensions connected to the router are configured. If you have not
completed the configuration, refer to the Cisco CallManager Express System Administrator Guide for
your release or go back to the Cisco Unity Express GUI for the procedures.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
65
Configuring Users, Groups, and Mailboxes
Adding and Modifying a User
Adding and Modifying a User
Users configured in Cisco CME may be imported in to the Cisco Unity Express database. Users defined
using the Cisco Unity Express GUI or CLI are not copied to the Cisco CME database.
The procedure described in this section allows you to create a new user in the system. Use the same
commands to modify an existing user’s properties.
Note
To associate a telephone number with a user, you must configure the telephone before using this
procedure. If you have not configured the telephone, refer to the Cisco CME documentation or
the Cisco Unity Express GUI for the procedures.
Privilege Levels for Users
The Cisco Unity Express software recognizes two privilege levels for users: superuser and prompt
management user. An administrator, also called a superuser, has the capability, or privilege, of accessing
all the configuration and maintenance functions, including the prompt management system (PMS). The
prompt management user has access to the PMS but not to any other administrative functions.
These privilege levels are assigned to a group and any member of the group is granted the privilege
rights. The software initialization process created an Administrator group from the imported users
designated as administrators. Other groups can be created with these privileges. Assign users to an
existing group using the CLI commands or the GUI option Configuration > Users.
Users and Mailboxes
Cisco Unity Express supports twice as many users as mailboxes. Some users, such as system
administrators, may not be assigned a voice mailbox. The maximum number of mailboxes is determined
by the license of the module. See “Feature Overview” on page 1 for the maximum number of mailboxes
permitted for your module.
Prerequisites
The following information is required for adding or modifying a user:
•
Username—The user ID. The username must be at least 3 and no more than 32 characters in length.
Cisco Unity Express allows only letters, numbers, and the characters underscore (_), dot (.), and
dash (-) in user IDs. Users IDs must start with a letter. Do not use spaces in the username.
•
(Optional) Full name—First and last name of the user. Enter this name in quotation marks (“ ”).
•
(Optional) Group—Name of an existing group in which this user is a member.
•
Password—Temporary password for this user. The password must be at least 3 and no more than 32
characters in length. Spaces are not allowed. When the user logs in to the GUI for the first time, the
application requires the user to change the password. The user’s password does not expire.
•
PIN—Personal identification number. The PIN must be at least 3 and no more than 16 digits in
length. When the user logs in to the voice-mail system for the first time, the application requires the
user to change the PIN. The PIN does not expire.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
66
Cisco Unity Express Release 1.1.2
Configuring Users, Groups, and Mailboxes
Adding and Modifying a User
SUMMARY STEPS
EXEC mode:
1.
username name [create | delete | fullname [first ‘firstname” | last “lastname” |
display “fullname”] | group groupname | language | password password | pin number]
2.
show users
or
show user detail username name
3.
copy running-config startup-config
Configuration mode:
1.
config t
2.
username name [create | phonenumber phonenumber | phonenumberE164 fullnumber]
3.
exit
4.
show users
or
show user detail username name
5.
copy running-config startup-config
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
67
Configuring Users, Groups, and Mailboxes
Adding and Modifying a User
DETAILED STEPS
EXEC mode:
Step 1
Command or Action
Purpose
username name [ create | delete |
fullname [first ‘firstname” | last “lastname” | display
“fullname”] | group groupname |
language | password password | pin number]
Creates the user with user ID name value. The
optional parameters configure more information for
the user:
•
name—User ID of the user. The user ID must be
at least 3 and no more than 32 characters in
length. Cisco Unity Express allows only letters,
numbers, and the characters underscore (_), dot
(.), and dash (-) in user IDs. Do not use spaces
in the username.
•
create—Creates the user with no other
information.
•
delete—Deletes an existing user.
•
fullname—Specifies a full name for this user.
This full name appears on telephone displays.
•
group—Associates this user with an existing
group.
•
language—Specifies a language for this user.
The default for Release 1.0 is U.S. English.
•
password—Specifies a password for this user.
The password value must be entered within
quotation marks (“ ”). Spaces are not allowed.
Acceptable password characters are lowercase
letters a to z, uppercase letters A to Z, digits 0 to
9, and the following symbols: - , . + = _ ! @ # $
^*()?/~<>&%
•
pin—Specifies a personal identification number
(PIN) for this user. The user enters this number
from the telephone when accessing the
voice-mail system. The PIN may contain a
maximum number of 16 digits. The asterisk (*)
and pound sign (#) may not be used.
Example:
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
Step 2
username
username
username
username
username
username
user1
user2
user2
user2
user2
user2
create
fullname display “User 2”
group sales
password “green”
pin 4444
delete
show users
or
show user detail username name
Example:
Displays a list of user names for all configured
users. This command does not display the details for
the users.
or
Displays the detailed configuration information for
the user with the name value.
se-10-0-0-0# show user detail username user2
Step 3
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
68
Cisco Unity Express Release 1.1.2
Configuring Users, Groups, and Mailboxes
Adding and Modifying a User
Example
The following output illustrates the show users and show user detail username commands:
se-10-0-0-0# show users
user1
user2
se-10-0-0-0# show user detail username user2
Full Name:
User 2
First Name:
Last Name:
user2
Nickname:
user2
Phone:
Phone(E.164):
Language:
en_US
se-10-0-0-0#
Configuration mode:
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
username name [ create | phonenumber phonenumber
phonenumberE164 fullnumber]
|
Example:
Creates the user with user ID name value. The
optional parameters configure more information for
the user:
•
name—User ID of the user. The user ID must be
at least 3 and no more than 32 characters in
length. Cisco Unity Express allows only letters,
numbers, and the characters underscore (_), dot
(.), and dash (-) in user IDs. Do not use spaces in
the username.
•
create—Creates the user with no other
information.
•
phonenumber—Specifies a number or
extension for this user. No spaces or dashes are
allowed.
•
phonenumberE164—Specifies a telephone
number with area code for this user. No spaces or
dashes are allowed.
se-10-0-0-0(config)# username user3 create
se-10-0-0-0(config)# username user3 phonenumber
50180
se-10-0-0-0(config)# username user3 phonenumberE164
13335550180
Step 3
exit
Exits configuration mode.
Step 4
show users
Displays a list of user names for all configured users.
This command does not display the details for the
users.
or
show user detail username name
or
Displays the detailed configuration information for
the user name value.
Example:
se-10-0-0-0# show user detail username user2
Step 5
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
69
Configuring Users, Groups, and Mailboxes
Adding and Modifying a User
Example
The following example illustrates configuring a user and the output from the show commands:
se-10-0-0-0(config)# username user3 create
se-10-0-0-0(config)# username user3 phonenumber 50180
se-10-0-0-0(config)# exit
se-10-0-0-0# show users
user1
user2
user3
se-10-0-0-0# show user detail username user3
Full Name:
User 3
First Name:
Last Name:
user3
Nickname:
user3
Phone:
50180
Phone(E.164):
Language:
en_US
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
70
Cisco Unity Express Release 1.1.2
Configuring Users, Groups, and Mailboxes
Adding and Modifying a Group
Adding and Modifying a Group
A group is a collection of users, usually with a common function or purpose, such as sales, main office,
customer service, or technicians. The group has the following characteristics:
•
Members of the group can be individual users or other groups.
•
The group is assigned an extension. If the members of the group are configured with the extension
as a shared line, then anyone who calls this extension reaches a member of the group.
•
The group usually has a mailbox assigned to it. This mailbox is called a general delivery mailbox.
All members of the group access the mailbox to retrieve messages stored there. See “Types of
Mailboxes” on page 75 for more information about general delivery mailboxes.
•
At least one user must be designated as the owner of the group. The owner adds and deletes users
from the group.
•
Members may belong to more than one group.
•
Members can be added to the group using the configuration mode groupname command or with the
EXEC mode username command. See “Adding and Modifying a User” on page 66 for the
username command.
Users must exist before being added to a group. See “Adding and Modifying a User” on page 66
to configure the user’s detailed information.
Note
•
Only members have access to the messages in a group’s voice mailbox. The owner is not considered
a member of the group. If the owner needs to access the group’s mailbox, add the owner as a member
of the group. (The owner’s name appears twice in the group, once as a member and once as the
owner.)
•
A group may be assigned a privilege level. The privilege level permits the members of the group to
access all or a restricted set of administrative functions. Use the show privileges command to
display the privilege levels installed on your system.
See “Software Licenses and Factory-Set Limits” on page 3 for the maximum number of groups, owners,
and members permitted on your system.
The procedure described in this section allows you to create a new group in the system. Use the same
commands to modify an existing group’s properties.
Prerequisites
The following information is required to define a group:
•
EXEC mode:
– Name of the group
– (Optional) Description of the group
– (Optional) Full name of the group
•
Configuration mode:
– Name of the group
– (Optional) One or more existing member user IDs
– (Optional) User ID of the owner
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
71
Configuring Users, Groups, and Mailboxes
Adding and Modifying a Group
– (Optional) Extension or telephone number of the group
– (Optional) Full E.164 telephone number of the group
– (Optional) Privilege level for the group
SUMMARY STEPS
EXEC mode:
1.
groupname name [create | delete | description “description” | fullname “fullname”]
2.
show groups
or
show group detail groupname name
3.
copy running-config startup-config
Configuration mode:
1.
config t
2.
groupname name [member username | owner ownername| phonenumber phonenumber|
phonenumberE164 fullnumber | privilege privilege-id]
3.
exit
4.
show groups
or
show group detail groupname name
5.
copy running-config startup-config
DETAILED STEPS
EXEC mode:
Step 1
Step 2
Command or Action
Purpose
groupname name [create | delete | description
“description” | fullname “fullname”]
Creates the group with group ID name value.The
optional parameters configure more information for
the group:
Example:
•
se-10-0-0-0# groupname sales fullname “Sales
Department”
se-10-0-0-0# groupname sales description “Retail
Sales Department”
se-10-0-0-0# groupname sales delete
create—Creates the group with no other
information
•
delete—Deletes an existing group.
•
description—Specifies a description of the
group.
•
fullname—Specifies a long name for the group.
show groups
or
show group detail groupname name
Displays a list of group names for all configured
groups. This command does not display the details
for the groups.
or
Example:
se-10-0-0-0# show group detail groupname sales
Step 3
copy running-config startup-config
Displays the detailed configuration information for
the group name value.
Copies the configuration change to the startup
configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
72
Cisco Unity Express Release 1.1.2
Configuring Users, Groups, and Mailboxes
Adding and Modifying a Group
Example
The following example creates a group and displays the output of the show commands:
se-10-0-0-0# groupname sales fullname "Sales Department"
se-10-0-0-0# groupname sales description "CA office"
se-10-0-0-0# show groups
Administrators
sales
se-10-0-0-0# show group detail groupname sales
Full Name:
Sales Department
Description:
CA office
Phone:
Phone(E.164):
Language:
en_US
Owners:
Members:
se-10-0-0-0#
Configuration mode:
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
groupname name [member username | owner ownername|
phonenumber phonenumber| phonenumberE164 fullnumber
privilege privilege-id]
|
Example:
se-10-0-0-0(config)#
se-10-0-0-0(config)#
se-10-0-0-0(config)#
50163
se-10-0-0-0(config)#
14445550163
se-10-0-0-0(config)#
ManagePrompts
Step 3
exit
groupname sales member user1
groupname sales owner user2
groupname sales phonenumber
Creates the user with user ID name value. The
optional parameters configure more information for
the user:
•
member—Associates an existing user as a
member of this group. Repeat this command to
assign multiple users to the group.
•
owner—Specifies the owner of the group. The
owner is not considered a member. If the owner
is to have access to the group’s voice mailbox,
also assign the owner as a member.
•
phonenumber—Associates a number or
extension with this group. No spaces or dashes
are allowed.
•
phonenumberE164—Associates a telephone
number with area code with this group. No
spaces or dashes are allowed.
•
privilege—Specifies the privilege level for the
group. Members assigned to this group have the
designated privilege rights.
groupname sales phonenumberE164
groupname sales privilege
Exits configuration mode.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
73
Configuring Users, Groups, and Mailboxes
Adding and Modifying a Group
Step 4
Command or Action
Purpose
show groups
Displays a list of group names for all configured
groups. This command does not display the details
for the groups.
or
show group detail groupname name
Example:
se-10-0-0-0# show group detail groupname sales
Step 5
copy running-config startup-config
Displays the detailed configuration information for
the group name value.
Copies the configuration change to the startup
configuration.
Example
The following example adds an owner and two members to the group sales and assigns sales a phone
number:
se-10-0-0-0# config t
se-10-0-0-0(config)# groupname sales member user1
se-10-0-0-0((config)# groupname sales member user2
se-10-0-0-0((config)# groupname sales owner user1
se-10-0-0-0((config)# groupname sales phonenumber 50163
se-10-0-0-0((config)# groupname sales phonenumberE164 12225550163
se-10-0-0-0((config)# groupname sales privilege ManagePrompts
sse-10-0-0-0((config)# exit
se-10-0-0-0(# show groups
Administrators
sales
se-1-100-6-10# show group detail groupname sales
Full Name:
Sales Department
Description:
CA office
Phone:
50163
Phone(E.164):
12225550163
Language:
en_US
Owners:
user7
Members:
user1 user2
se-10-0-0-0(#
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
74
Cisco Unity Express Release 1.1.2
Configuring Users, Groups, and Mailboxes
Creating and Modifying a Voice Mailbox
Creating and Modifying a Voice Mailbox
Assign a voice mailbox to a user configured in the Cisco Unity Express database. A mailbox user is
either an individual or the owner of a user group. The user must have an assigned extension.
Not all users or extensions require a voice mailbox. To use mailboxes efficiently, consider the function
or purpose of the user or extension before assigning the mailbox.
The commands to create or modify a voice mailbox are the same.
Types of Mailboxes
Cisco Unity Express supports two types of mailboxes:
•
Personal mailbox—This mailbox is assigned to a specific user and is accessible only by this user.
When a caller leaves a message in this mailbox, the MWI light turns on.
•
General delivery mailbox (GDM)—This mailbox is assigned to a group of users. (See “Adding and
Modifying a Group” on page 71 for the definition of group members.) All members in the group
have access to the mailbox. When a caller leaves a message in this mailbox, no MWI is turned on.
Instead, when a member logs in to the personal mailbox, the mailbox menu allows the member to
access the messages in each GDM to which the member belongs. Only one person can access the
GDM at a time. After the first person saves or deletes a message in the GDM, the message is no
longer played as “new” for any subsequent members.
•
Mailboxes are assigned to an IP telephone under control of the Cisco CME system that resides on
the same router as the Cisco Unity Express module. IP telephones under control of Cisco CME on
another router need their own on-site Cisco Unity Express application.
•
Cisco Unity Express supports IP telephones using Skinny Client Control Protocol (SCCP) or analog
telephones behind an SCCP gateway (such as the Cisco VG248 or the Cisco ATA). Session Initiation
Protocol (SIP) or Media Gateway Control Protocol (MGCP) IP telephones, analog FXS telephones
on the Cisco CME router, and soft telephones are not supported.
•
Only the owner of a personal mailbox can delete messages in the mailbox. Members of a GDM can
delete messages in the mailbox. The administrator cannot delete messages or display the length of
time messages are stored in the system. When the mailbox owner logs in to the voice mailbox, the
application notifies the owner of any expired messages. The owner can delete or save each message.
If a message is saved from the expired messages menu, the expiry timer is restarted for that message.
•
Mailboxes can have different storage sizes. Consider the purpose of the mailbox when assigning a
smaller or larger size than the default. The aggregate of all mailboxes cannot exceed the maximum
storage allowed on your system. See “Feature Overview” on page 1 for the mailbox storage capacity
for your system and use the show voicemail usage command to display the amount of storage
already configured.
Limitations
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
75
Configuring Users, Groups, and Mailboxes
Creating and Modifying a Voice Mailbox
Prerequisites
•
Verify that the users and groups that will have voice mailboxes are configured before using this
procedure. If you have not created the users and groups, see “Adding and Modifying a User” on
page 66 or “Adding and Modifying a Group” on page 71 or return to the Cisco Unity Express GUI
for the procedures.
•
System-wide mailbox default values were configured during the installation process. If necessary,
modify any of the following values for a specific mailbox:
– Mailbox size
– Expiration time
– Message size
Use the show voicemail limits command to display the default values.
•
The default greeting type is standard. Modify this value if the user or group owner has recorded an
alternate greeting.
1.
config t
2.
voicemail mailbox owner name [size seconds]
3.
(Optional) default parameter
4.
(Optional) description “text”
5.
enable
or
disable
6.
expiration time days
7.
greeting {alternate | standard}
8.
mailboxsize seconds
9.
messagesize seconds
SUMMARY STEPS
10. (Optional) no parameter
11. tutorial
12. zerooutnumber “number”
13. end
14. exit
15. show voicemail {detail {mailbox | user} name | limits | mailboxes [idle days] | usage | users}
16. copy running-config startup-config
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
76
Cisco Unity Express Release 1.1.2
Configuring Users, Groups, and Mailboxes
Creating and Modifying a Voice Mailbox
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
voicemail mailbox owner name
[size seconds]
Example:
Creates a mailbox for the name value and with
storage size seconds value, and enters mailbox
configuration mode.
se-10-0-0-0(config)# voicemail mailbox owner user3
se-10-0-0-0(config)# voicemail mailbox owner sales
Step 3
(Optional) Resets the mailbox parameter to the
default system value.
default parameter
Example:
se-10-0-0-0(config-mailbox)# default mailboxsize
Step 4
(Optional) Enter a description of the mailbox. Use
double quotes around the text.
description “text”
Example:
se-10-0-0-0(config-mailbox)# description “User 3
mailbox”
Step 5
Activates or deactivates the new mailbox or
reactivates the disabled mailbox.
enable
or
disable
Example:
se-10-0-0-0(config-mailbox)# enable
se-10-0-0-0(config-mailbox)# disable
Step 6
Sets the number of days that messages are stored in
the mailbox. The default is 30 days.
expiration time days
Example:
se-10-0-0-0(config-mailbox)# expiration time 10
Step 7
greeting
{alternate | standard}
Example:
se-10-0-0-0(config-mailbox)# greeting standard
Step 8
Specifies which greeting to use when a caller reaches
the mailbox. The mailbox owner can record standard
and alternate messages from the telephone user
interface (TUI). If the user has not recorded any
messages, the default recording are used.
Specifies the storage size of the mailbox in seconds.
This is the same as the size parameter.
mailboxsize seconds
Example:
se-10-0-0-0(config-mailbox)# mailboxsize 300
Step 9
Specifies the maximum size of an incoming message,
in seconds.
messagesize seconds
Example:
se-10-0-0-0(config-mailbox)# messagesize 120
Step 10
Deletes or disables the mailbox parameter.
no parameter
Example:
se-10-0-0-0(config-mailbox)# no tutorial
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
77
Configuring Users, Groups, and Mailboxes
Creating and Modifying a Voice Mailbox
Step 11
Command or Action
Purpose
tutorial
Enables the mailbox tutorial program when the
telephone user logs in to the voice-mail system for the
first time. The default is enabled. If the tutorial
command is enabled after the mailbox is configured,
the tutorial will start again but will confirm the user’s
previous choices, rather than erasing them all.
Example:
se-10-0-0-0(config-mailbox)# tutorial
Step 12
Specifies the extension where a caller is routed when
a caller presses “0’ to reach an operator after being
transferred to a subscriber’s mailbox.
zerooutnumber “number”
Example:
se-10-0-0-0(config-mailbox)# zerooutnumber “2100”
Step 13
end
Exits mailbox configuration mode.
Step 14
exit
Exits configuration mode.
Step 15
show voicemail { detail { mailbox | user} name | limits
mailboxes | usage | users}
|
Displays voice mailbox properties.
•
detail—Displays the details for a configured
mailbox or user with name the name value. For
a group mailbox, this is the name of the mailbox,
not the owner of the mailbox. If a user is an
owner of a group mailbox, then details for both
the user’s personal and group mailboxes are
displayed.
•
limits—Displays the default values for all
mailboxes.
•
mailboxes—Displays all configured mailboxes
and their current mailbox storage status. The idle
parameter displays the mailboxes that have been
inactive for at least the specified number of days.
•
usage—Displays how much of the system’s
voice-mail capacity has been used or configured.
•
users—Lists the local voice-mail users.
Example:
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
Step 16
show
show
show
show
show
show
show
show
voicemail
voicemail
voicemail
voicemail
voicemail
voicemail
voicemail
voicemail
detail mailbox sales
detail mailbox user1
detail user user3
limits
mailboxes
mailboxes idle 5
usage
users
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Example
The following example configures a mailbox for a user and displays the output of the show command:.
se-10-0-0-0# config t
se-10-0-0-0(config)# voicemail mailbox owner user3
se-10-0-0-0(config-mailbox)# description "User 3 mailbox"
se-10-0-0-0(config-mailbox)# expiration time 10
se-10-0-0-0(config-mailbox)# greeting alternate
se-10-0-0-0(config-mailbox)# mailboxsize 480
se-10-0-0-0(config-mailbox)# messagesize 120
se-10-0-0-0(config-mailbox)# no tutorial
se-10-0-0-0(config-mailbox)# zerooutnumber “2100”
se-10-0-0-0(config-mailbox)# enable
se-10-0-0-0(config-mailbox)# end
se-10-0-0-0(config)# exit
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
78
Cisco Unity Express Release 1.1.2
Configuring Users, Groups, and Mailboxes
Creating and Modifying a Voice Mailbox
se-10-0-0-0# show voicemail detail mailbox user3
Owner:
/sw/local/users/user3
Type:
Personal
Description:
User 3 mailbox
Busy state:
idle
Enabled:
enabled
Mailbox Size (seconds):
480
Message Size (seconds):
120
Play Tutorial:
false
Space Used (seconds):
0
Total Message Count:
0
New Message Count:
0
Saved Message Count:
0
Expiration (days):
10
Greeting:
alternate
Created/Last Accessed:
Feb 28 1993 19:31:15 PST
se-10-0-0-0# show voicemail limits
Default Mailbox Size (seconds):
Default Caller Message Size (seconds):
Maximum Recording Size (seconds):
Default Message Age (days):
System Capacity (minutes):
Default Prompt Language:
Operator Telephone:
3000
60
900
30
6000
en_US
7000
se-10-0-0-0# show voicemail mailboxes
OWNER
MSGS NEW SAVED MSGTIME MBXSIZE
"user3"
0
0
0
0
480
se-10-0-0-0# show voicemail mailboxes idle 3
OWNER
IDLE MSGS MSGTIME
"user1"
10
0
0
“user2"
10
0
0
“user3"
10
0
0
“user4"
10
0
0
“user5"
10
0
0
“user6"
10
0
0
se-10-0-0-0# show voicemail mailboxes idle 20
OWNER
IDLE MSGS MSGTIME
USED
0 %
MBXSIZE
3000
3000
3000
3000
3000
3000
MBXSIZE
se-10-0-0-0# show voicemail detail user user3
-- Mailboxes owned -"/sw/local/users/user3"
User 3 mailbox
-- Mailboxes accessible -se-10-0-0-0# show voicemail usage
personal mailboxes:
general delivery mailboxes:
orphaned mailboxes:
capacity of voicemail (minutes):
allocated capacity (minutes):
message time used (seconds):
message count:
average message length (seconds):
greeting time used (seconds):
greeting count:
average greeting length (seconds):
total time used (seconds):
total time used (minutes):
percentage used time (%):
se-10-0-0-0#
1
0
0
6000
8.0
0
0
0.0
0
0
0.0
0
0.0
0
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
79
Configuring Users, Groups, and Mailboxes
Unlocking a Voice Mailbox
Unlocking a Voice Mailbox
If a mailbox becomes locked, the telephone user will hear a message stating that the mailbox is
unavailable. Use the voice mailbox unlock command to unlock the mailbox.
Starting in Cisco Unity EXEC mode, enter the following command:
voicemail mailbox unlock {owner name | telephonenumber tel_number}
name
Name of the mailbox owner.
tel_number
Extension or telephone number of the mailbox.
Example:
se-10-0-0-0# voicemail mailbox unlock owner user3
se-10-0-0-0# voicemail mailbox unlock telephonenumber 50174
This command is equivalent to the GUI operation of clicking the Unlock icon under Voice Mail >
Mailboxes.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
80
Cisco Unity Express Release 1.1.2
Configuring Users, Groups, and Mailboxes
Refreshing Message Waiting Indicators
Refreshing Message Waiting Indicators
Occasionally the MWI lights on a user’s telephone get out of synchronization with the voice message
status of the mailbox. When this condition happens, the MWI light is lit although the mailbox has no
new messages or the MWI light is not lit although the mailbox has new messages.
Use the mwi refresh all or mwi refresh telephonenumber command to refresh the MWI lights and to
synchronize the mailbox message status and MWI lights. If the user has no messages, the MWI turns off.
If the user has voice messages, the MWI light turns on.
Starting in Cisco Unity EXEC mode, enter the following command:
mwi refresh all
or
mwi refresh telephonenumber tel_number
where tel_number is the telephone number of a specific extension.
Example:
se-10-0-0-0# mwi refresh all
se-10-0-0-0# mwi refresh telephonenumber 50174
This command is equivalent to the GUI operation of clicking the Refresh All or Refresh Selected
icons under Voice Mail > Message Waiting Indicators > Refresh.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
81
Configuring Users, Groups, and Mailboxes
Refreshing Message Waiting Indicators
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
82
Cisco Unity Express Release 1.1.2
Backing Up and Restoring Data
Cisco Unity Express backup and restore functions use an FTP server to store and retrieve data. The
backup function copies the files from the Cisco Unity Express application to the FTP server and the
restore function copies the files from the FTP server to the Cisco Unity Express application. The FTP
server can reside anywhere in the network if the backup and restore functions can access it with an IP
address.
We recommend that backups be done daily to preserve voice-mail messages and configuration data.
Backup and restore commands are available in configuration mode and in offline mode.
•
In configuration mode, commands are available to set the following parameters:
– Number of backup files to keep. The oldest file is deleted.
– URL of the FTP server where the files will be stored.
•
In offline mode, perform the backup or restore procedure. Decide the following:
– Type of files to be backed up: all files (configuration and data), only configuration files, or only
data files. Data files consist of voice-mail messages. Configuration files consist of all other
system and application parameters.
– Backup filename (used for restore procedure).
– URL of the FTP server where the files will be stored.
Caution
Offline mode terminates all existing voice-mail calls and no new voice-mail calls are allowed. Calls to
auto attendant are allowed. We recommend doing a backup when telephone users are not active on calls.
In Cisco Unity Express EXEC mode, the startup configuration and running configuration can be saved
to various locations, such as the network FTP server, the network TFTP server, and Flash memory.
This chapter contains the following sections:
•
Restrictions, page 84
•
Setting Backup Parameters, page 85
•
Backing Up Files, page 87
•
Restoring Files, page 90
•
Copying Configurations, page 92
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
83
Backing Up and Restoring Data
Restrictions
Restrictions
Cisco Unity Express does not support the following backup and restore capabilities:
•
Scheduled backup and restore operations. The backup and restore procedures begin when the
appropriate command is entered.
•
Centralized message storage arrangement. Cisco Unity Express backup files cannot be used or
integrated with other message stores.
•
Selective backup and restore. Only full backup and restore functions are available. Individual
voice-mail messages or other specific data cannot be stored or retrieved.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
84
Cisco Unity Express Release 1.1.2
Backing Up and Restoring Data
Setting Backup Parameters
Setting Backup Parameters
The backup parameters define the FTP server to use for storing Cisco Unity Express backup files and
the number of files that are stored before the system deletes the oldest one.
All Cisco Unity Express backup files are stored on the specified server. You can copy the backup files
to other locations or servers, if necessary.
Cisco Unity Express automatically assigns a backup ID to the backup file, and you use the backup ID to
restore the file.
Prerequisites
The following information is required for setting the backup parameters:
•
Number of revisions to save before the oldest file is written over
•
FTP server URL
•
User ID of the FTP server login
•
Password of the FTP server login
1.
config t
2.
backup {revisions number | server url ftp-url username ftp_username password ftp_password}
3.
exit
4.
show backup
SUMMARY STEPS
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
backup {revisions number | server url ftp-url username
ftp_username password ftp_password}
Sets the backup parameters.
•
revisions—The number of backup files that will
be stored. When this number is reached, the
system deletes the oldest stored file.
•
server url—The ftp-url value is the URL to the
network FTP server where the backup files will
be stored. The ftp_username and ftp_password
values are the user ID and password for the
network FTP server.
Example:
se-10-0-0-0(config)# backup
se-10-0-0-0(config)# backup
ftp://main/backups username
se-10-0-0-0(config)# backup
ftp://172.168.10.10/backups
password “wxyz”
revisions 5
server url
“admin” password “wxyz”
server url
username “admin”
In the example, main is the hostname of the FTP
server and backups is the directory where
backup files are stored.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
85
Backing Up and Restoring Data
Setting Backup Parameters
Command or Action
Purpose
Step 3
exit
Exits configuration mode.
Step 4
show backup
Displays the backup server configuration
information, including the FTP server URL and the
number of revisions.
Example
The following example configures a backup server and displays the show backup output:
se-10-0-0-0# config t
se-10-0-0-0#(config)# backup server url ftp://172.16.0.0/backups username admin password
voice
se-10-0-0-0#(config)# backup revisions 10
se-10-0-0-0#(config)# exit
se-10-0-0-0#
se-10-0-0-0# show backup
Server URL:
ftp://172.16.0.0/backups
User Account on Server:
admin
Number of Backups to Retain:
10
se-10-0-0-0#
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
86
Cisco Unity Express Release 1.1.2
Backing Up and Restoring Data
Backing Up Files
Backing Up Files
Backup commands must be entered in EXEC mode while the system is in offline mode. Active calls are
terminated and no new calls are accepted. Consider doing the backup procedure at a time when telephone
users are least likely to be on the telephone.
Note
We recommend that you back up your configuration files whenever changes are made to the system or
application files. Data files, which contain voice messages, should be backed up daily to minimize data
loss, such as from a hardware failure.
Numbering Scheme for Backup Files
Three types of backup requests are available: data only, configuration only, or all. Cisco Unity Express
automatically numbers and dates the backup files and identifies the revision number in a backupid field.
Performing different backup types at various times causes different backup IDs for data backups and
configuration backups. For example, the last data backup ID might be 3 and the last configuration backup
might be 4. Performing an “all” backup might result in a backup ID of 5 for both data and configuration.
When restoring the files, refer to the backup ID for the backup file you want to use. Use the show backup
server command for a list of backup IDs.
Caution
Offline mode terminates all existing voice-mail calls and no new voice-mail calls are allowed. Calls to
auto attendant are allowed. We recommend doing a backup when telephone users are not active on calls.
SUMMARY STEPS
1.
offline
2.
backup category {all | configuration | data}
3.
continue
4.
show backup history
5.
show backup server
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
87
Backing Up and Restoring Data
Backing Up Files
DETAILED STEPS
Step 1
Command or Action
Purpose
offline
Enters offline mode. All active voice-mail calls are
terminated.
Example:
se-10-0-0-0# offline
Step 2
backup category {all | configuration | data}
Specifies the type of data to be backed up and stored.
Example:
se-10-0-0-0(offline)# backup category all
se-10-0-0-0(offline)# backup category configuration
se-10-0-0-0(offline)# backup category data
Step 3
Exits offline mode and returns to EXEC mode.
continue
Example:
se-10-0-0-0(offline)# reload
Step 4
show backup history
Displays the backup and restore procedures and the
success or failure of those attempts.
Example:
se-10-0-0-0# show backup history
Step 5
show backup server
Displays the backup files available on the backup
server, the date of each backup, and backup file ID.
Example:
se-10-0-0-0# show backup server
Example
The following example displays the output from the show backup commands:
se-10-0-0-0# show backup history
#Start Operation
Category:
Configuration
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
2
Restoreid:
-1
Description:
CUE test backup
Date:
Sun Jun 13 12:32:48 PDT 1993
Result:
Success
Reason:
#End Operation
#Start Operation
Category:
Data
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
2
Restoreid:
-1
Description:
CUE test backup
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
88
Cisco Unity Express Release 1.1.2
Backing Up and Restoring Data
Backing Up Files
Date:
Sun Jun 13 12:32:57 PDT 1993
Result:
Success
Reason:
#End Operation
#Start Operation
Category:
Configuration
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Restore
Backupid:
2
Restoreid:
1
Description:
Date:
Sun Jun 13 12:37:52 PDT 1993
Result:
Success
Reason:
#End Operation
#Start Operation
Category:
Data
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Restore
Backupid:
2
Restoreid:
1
Description:
Date:
Sun Jun 13 12:38:00 PDT 1993
Result:
Success
Reason:
#End Operation
se-10-0-0-0# show backup server
Category:
Data
Details of last 5 backups
Backupid:
1
Date:
Tue Jul 22 10:55:52 PDT 2003
Description:
Backupid:
Date:
Description:
2
Tue Jul 29 18:06:33 PDT 2003
Backupid:
Date:
Description:
3
Tue Jul 29 19:10:32 PDT 2003
Category:
Configuration
Details of last 5 backups
Backupid:
1
Date:
Tue Jul 22 10:55:48 PDT 2003
Description:
Backupid:
Date:
Description:
2
Tue Jul 29 18:06:27 PDT 2003
Backupid:
Date:
Description:
3
Tue Jul 29 19:10:29 PDT 2003
se-10-0-0-0#
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
89
Backing Up and Restoring Data
Restoring Files
Restoring Files
After the backup files are created, you can restore them when needed. Restoring is done in offline mode,
which terminates all voice-mail active calls and does not permit new voice-mail calls (auto attendant
calls are permitted). You should consider doing the restore when telephone users are least likely to be
on the telephone.
Use the show backup server command to locate the backup ID of the file you want to restore.
SUMMARY STEPS
1.
show backup server
2.
offline
3.
restore id backupid category {all | configuration | data}
4.
reload
5.
show backup history
DETAILED STEPS
Command or Action
Purpose
Step 1
show backup server
Lists the data and configuration backup files. Look at
the backup ID field for the revision number of the file
you want to restore.
Step 2
offline
Enters offline mode. All active voice-mail calls are
terminated.
Example:
se-10-0-0-0# offline
Step 3
restore id backupid category { all | configuration
data}
|
Specifies the backup ID backupid value and the file
type to be restored.
Example:
se-10-0-0-0(offline)# restore id 22 category all
se-10-0-0-0(offline)# restore id 8 category
configuration
se-10-0-0-0(offline)# restore id 3 category data
Step 4
reload
Resets the Cisco Unity Express module so that the
restored values take effect.
Example:
se-10-0-0-0(offline)# reload
Step 5
show backup history
Displays the backup and restore procedures and the
success or failure of those attempts.
Example:
se-10-0-0-0# show backup history
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
90
Cisco Unity Express Release 1.1.2
Backing Up and Restoring Data
Restoring Files
Example
The following example displays the backup server and backup history:
se-10-0-0-0# show backup server
Category:
Data
Details of last 5 backups
Backupid:
1
Date:
Tue Jul 22 10:55:52 PDT 2003
Description:
Backupid:
Date:
Description:
2
Tue Jul 29 18:06:33 PDT 2003
Backupid:
Date:
Description:
3
Tue Jul 29 19:10:32 PDT 2003
Category:
Configuration
Details of last 5 backups
Backupid:
1
Date:
Tue Jul 22 10:55:48 PDT 2003
Description:
Backupid:
Date:
Description:
2
Tue Jul 29 18:06:27 PDT 2003
Backupid:
Date:
Description:
3
Tue Jul 29 19:10:29 PDT 2003
se-10-0-0-0#
se-10-0-0-0# show backup history
Start Operation
Category:
Configuration
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
1
Restoreid:
-1
Description:
test backup 1
Date:
Sun Jun 13 12:23:38 PDT 1993
Result:
Failure
Reason:
Script execution failed: /bin/BR_VMConfg_backup.sh: returnvalue:1
; Server Url:ftp://10.100.10.215/CUE_backup: returnvalue:9 Unable to authenticate
#End Operation
#Start Operation
Category:
Data
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
1
Restoreid:
-1
Description:
test backup 1
Date:
Sun Jun 13 12:23:44 PDT 1993
Result:
Failure
Reason:
Script execution failed: /bin/BR_VMData_backup.sh: returnvalue:1
Voicemail Backup failed; Server Url:ftp://10.100.10.215/CUE_backup: returnvalue:9
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
91
Backing Up and Restoring Data
Copying Configurations
Unable to authenticate
#End Operation
#Start Operation
Category:
Configuration
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
2
Restoreid:
-1
Description:
CUE test backup
Date:
Sun Jun 13 12:32:48 PDT 1993
Result:
Success
Reason:
#End Operation
#Start Operation
Category:
Data
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
2
Restoreid:
-1
Description:
CUE test backup
Date:
Sun Jun 13 12:32:57 PDT 1993
Result:
Success
Reason:
#End Operation
Copying Configurations
The following Cisco Unity Express EXEC commands are available to copy the startup configuration and
running configuration to and from Flash memory, the network FTP server, and the network TFTP server.
Copying from Flash Memory to Another Location
Starting in Cisco Unity Express EXEC mode, use the following command to copy the startup
configuration in Flash memory to another location:
copy startup-config {ftp: userid:password@ftp-server-address/directory |
tftp:tftp-server-address} filename
se-10-0-0-0#
Keyword or Argument
Description
ftp: userid:password@
User ID and password for the FTP server. Include the colon (:) and the at
sign (@) in your entry.
ftp-server-address
IP address of the FTP server.
/directory
(Optional) Directory on the TFTP server where the copied file will reside.
If you use it, precede the name with the forward slash (/).
tftp:tftp-server-address
IP address of the TFTP server.
filename
Name of the destination file that will contain the copied running
configuration.
This command is interactive and prompts you for the information. You cannot enter the parameters in
one line. The following examples illustrate this process.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
92
Cisco Unity Express Release 1.1.2
Backing Up and Restoring Data
Copying Configurations
In this example, the startup configuration is copied to the FTP server, which requires a user ID and
password to transfer files. The IP address of the FTP server is 172.16.231.193. The startup configuration
file is saved on the FTP server with the filename start.
se-10-0-0-0# copy startup-config ftp
Address or name of remote host? admin:[email protected]
Source filename? start
The following example shows the startup configuration copied to the TFTP server, which does not
require a user ID and password. The IP address of the TFTP server is 172.16.231.190. The startup
configuration is saved in the TFTP directory configs as filename temp_start.
se-10-0-0-0# copy startup-config tftp
Address or name of remote host? 172.16.231.190 configs
Source filename? temp_start
Copying from the Network FTP server to Another Location
Starting in Cisco Unity Express EXEC mode, use the following command to copy the network FTP
server configuration to another location:
se-10-0-0-0# copy ftp: {running-config | startup-config}
userid:password@ftp-server-address/directory filename
Keyword or Argument
Description
running-config
Active configuration in Flash memory.
startup-config
Startup configuration in Flash memory.
userid:password@
User ID and password for the FTP server. Include the colon (:) and the
at sign (@) in your entry.
ftp-server-address
IP address of the FTP server.
/directory
(Optional) Directory name for retrieving the file. If you use it, precede
the name with the forward slash (/).
filename
Name of the source file to be copied.
This command is interactive and prompts you for the information. You cannot enter the parameters in
one line. The following example illustrates this process.
In this example, the FTP server requires a user ID and password. The IP address of the FTP server is
10.3.61.16. The file start in the FTP server configs directory is copied to the startup configuration.
se-10-0-0-0# copy ftp: startup-config
!!!WARNING!!! This operation will overwrite your startup configuration.
Do you wish to continue[y]? y
Address or name or remote host? admin:[email protected]/configs
Source filename? start
Copying the Flash Running Configuration to Another Location
Starting in Cisco Unity Express EXEC mode, use the following command to copy the running
configuration in Flash memory to another location:
copy running-config {ftp: userid:password@ftp-server-address/directory |
startup-config | tftp:tftp-server-address} filename
se-10-0-0-0#
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
93
Backing Up and Restoring Data
Copying Configurations
Keyword or Argument
Description
ftp: userid:password@
User ID and password for the FTP server. Include the colon (:) and the
at sign (@) in your entry.
ftp-server-address
IP address of the FTP server.
/directory
(Optional) Directory on the FTP server where the copied file will reside.
If you use it, precede the name with the forward slash (/).
startup-config
Startup configuration in Flash memory.
tftp:tftp-server-address
IP address of the TFTP server.
filename
Name of the destination file that will contain the copied running
configuration.
When you copy the running configuration to the startup configuration, enter the command on one line.
When you copy to the FTP or TFTP server, this command becomes interactive and prompts you for the
information. You cannot enter the parameters in one line. The following example illustrates this
process.
In the following example, the running configuration is copied to the FTP server, which requires a user
ID and password. The IP address of the FTP server is 172.16.231.193. The running configuration is
copied to the configs directory as file saved_start.
se-10-0-0-0# copy running-config ftp:
Address or name of remote host? admin:[email protected]/configs
Source filename? saved_start
In the following example, the running configuration is copied to the startup configuration as file start.
In this instance, enter the command on a single line.
se-10-0-0-0# copy running-config startup-config start
Copying the Network TFTP Configuration to Another Location
Starting in Cisco Unity Express EXEC mode, use the following command to copy the network TFTP
configuration to another location:
se-10-0-0-0#
copy tftp: {running-config | startup-config} tftp-server-address/directory filename
Keyword or Argument
Description
running-config
Active configuration in Flash memory.
startup-config
Startup configuration in Flash memory.
tftp-server-address
IP address of the TFTP server.
/directory
(Optional) Directory on the FTP server where the copied file will reside.
If you use it, precede the name with the forward slash (/).
filename
Name of the source file to be copied.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
94
Cisco Unity Express Release 1.1.2
Backing Up and Restoring Data
Copying Configurations
This command is interactive and prompts you for the information. You cannot enter the parameters in
one line. The following example illustrates this process.
In this example, the TFTP server has IP address 10.3.61.16. The file start in directory configs on the
TFTP server is copied to the startup configuration.
se-10-0-0-0# copy tftp: startup-config
!!!WARNING!!! This operation will overwrite your startup configuration.
Do you wish to continue[y]? y
Address or name of remote host? 10.3.61.16/configs
Source filename? start
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
95
Backing Up and Restoring Data
Copying Configurations
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
96
Cisco Unity Express Release 1.1.2
Troubleshooting
This chapter provides information on troubleshooting some Cisco Unity Express problems and contains
the following sections:
•
Troubleshooting Guidelines, page 97
•
Troubleshooting Commands, page 101
Also check “Restrictions” on page 7 in case system limitations are involved in the problem under
consideration.
Troubleshooting Guidelines
The following sections provide information and suggestions for resolving some problems with the
Cisco Unity Express configuration and applications:
•
System Reports, page 97
•
Log Files, page 98
•
Users and Groups, page 98
•
Hardware and Software, page 98
•
Voice Mail, page 101
•
Message Waiting Indicators (MWIs), page 101
•
Auto Attendant Prompts, page 101
System Reports
Cisco Unity Express provides the following system reports in both graphical user interface (GUI) and
command-line interface (CLI):
•
Mailbox and message statistics
•
Mailbox size monitoring
•
Backup and restore history
•
System hardware parameters
•
Memory and CPU usage (CLI only)
•
Call history
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
97
Troubleshooting
Troubleshooting Guidelines
Log Files
Problem: I cannot display log files in the GUI.
Explanation Log files are kept for error reporting and troubleshooting. The GUI does not have access
to system error messages.
Use the CLI to display log files.
Users and Groups
Problem: I cannot get in to the GUI.
Explanation You forgot to enter a system administrator during the initialization wizard.
Recommended Action Use the administrator login ID created during the post-installation procedure
or create an administrator login ID using the following CLI commands, starting in
Cisco Unity Express EXEC mode, where xyz is the user ID and abc is the user’s password:
a. cue-10-0-0-0# username xyz create
b. cue-10-0-0-0# username xyz password abc
c. cue-10-0-0-0# config t
d. cue-10-0-0-0(config)# groupname Administrators member xyz
Problem: Need to recover a user’s password or personal identification number (PIN).
Explanation The user has forgotten the password or PIN.
Recommended Action For security reasons, passwords and PINs are not displayed on the screen or
printed out. You must create a new password or PIN and give that new code to the user. See “Adding
and Modifying a User” on page 66 for the commands to create a new password or PIN.
Hardware and Software
Rebooting the System
Problem: Is it necessary to reboot the router when rebooting the Cisco Unity Express module?
Explanation A reboot of the Cisco Unity Express module does not require a reboot of the router. The
Cisco Unity Express module and the router can be rebooted independently of each other. However,
if you reboot the router, no calls will reach the module until IP connectivity is reestablished between
the router and the module.
Caution
Always do a shutdown of the module before power cycling the router to avoid data loss or file corruption.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
98
Cisco Unity Express Release 1.1.2
Troubleshooting
Troubleshooting Guidelines
Setting Daylight Savings Time
Problem: Need to set daylight savings time.
Explanation Cisco Unity Express sets daylight savings time automatically on the basis of the time
zone, which is selected during the installation procedure or with the Administration > Network
Time & Time Zone Settings GUI screen.
Communicating Between Components
Problem: Inability to open a session in to the Cisco Unity Express module.
Explanation The TTY line associated with the module is occupied.
Recommended Action Use the service-module service-engine slot/port session clear command to
clear the TTY line.
Problem: Inability to change or remove the IP address or IP default-gateway configurations with the
Cisco Unity Express CLI.
Explanation The IP address and IP default-gateway configurations are controlled from the Cisco IOS
software.
Recommended Action Make the required changes from the service-engine interface.
Problem: Service-module commands do not seem to take effect.
Explanation The service-module status might not be steady-state. RBCP configuration messages go
through only when the service-module is in steady state.
Recommended Action Use the service-module service-engine slot/port reload command to reload
the Cisco Unity Express module.
Problem: Inability to ping the internal address when using the IP unnumbered scheme.
Explanation The IP route table is not correct.
Recommended Action When using IP unnumbered, add a static route pointing to the service-engine
interface.
Problem: Inability to set the speed of the terminal line from the router side or the Cisco Unity Express
side.
Explanation Cisco Unity Express does not have a CLI command to set the speed. The speed is set to
9600, 8-N-1 on both the Cisco CallManager and Cisco Unity Express sides. Although Cisco IOS
software allows you to change the speed settings, the changes do not take effect.
Online Insertion and Removal (OIR)
Problem: I did an OIR of the Cisco Unity Express network module on my router but it does not seem to
be working.
Explanation Only the Cisco 3745 router supports OIR. OIR is not available on the AIM.
Problem: I did an OIR on the Cisco 3745. Now the Cisco Unity Express network module is not working.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
99
Troubleshooting
Troubleshooting Guidelines
Recommended Action OIR requires the following steps:
a. Shut down the service-engine interface.
b. Issue the service-module service-engine slot/port shutdown command.
c. Wait for confirmation that the network module has been shut down.
d. Proceed to do the OIR.
Saving and Viewing Log Files
Problem: Need to be able to store log files to a remote location.
Recommended Action Log files are stored on the disk, which is the default location. You can
configure Cisco Unity Express to store the log files to a separate server. Also, you can copy log files
on the disk to a separate server if they need to be kept for history purposes, for example:
se-10-0-0-0# copy log filename.log url
ftp://ftp-userid:ftp-userpasswd@ftp-ip-address/directory
se-10-0-0-0# copy log messages.log url ftp://admin:[email protected]/log_history
Problem: Cannot display the contents of log files on the GUI.
Explanation The GUI cannot display log files. Troubleshooting commands and files are available
only through the CLI.
Recommended Action Copy the log files from Cisco Unity Express to an external server and use a text
editor, such as vi, to display the content.
Saving Configuration Changes
Problem: Lost some configuration data when the GUI timer expired.
Explanation You did not save the data while you were entering it.
Recommended Action While making some configuration changes in the GUI, use the Apply icon to
save your changes to the running configuration before the timer logs you out of the system. If the
timer logs you out and you did not use the Apply icon, your changes are not saved.
Note
The timer affects only the GUI, not the CLI.
Problem: Lost configuration data when I rebooted the system.
Explanation You did not save the data before the reboot.
Recommended Action Perform a Save Configuration operation in the GUI or enter a copy
running-config startup-config command in the CLI to copy your changes from the running
configuration to the startup configuration. When Cisco Unity Express reboots, it reloads the startup
configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
100
Cisco Unity Express Release 1.1.2
Troubleshooting
Troubleshooting Commands
Voice-mail messages, which are considered application data and are saved directly to the disk,
are preserved automatically in the startup configuration. (They should be backed up to preserve
them on another server in case of a power outage or a new installation.) All other configuration
changes require an explicit “save configuration” operation to preserve them in the startup
configuration.
Note
Voice Mail
Problem: A user received a message with an envelope that says “unknown caller.”
Explanation Cisco Unity Express has a Lightweight Directory Access Protocol (LDAP) directory
with the names and extensions of the users who have voice mailboxes. When a message comes in,
Cisco Unity Express tries to match the caller’s ID (name or extension) to an entry in the LDAP
directory. If a match is found, the user’s name or extension is included in the message envelope.
If a user is configured on Cisco Manager but not in Cisco Unity Express, for example,
Cisco Unity Express has no record of that user in its LDAP directory and announces that caller as
“unknown caller.”
Recommended Action You may want to synchronize the Cisco CallManager and Cisco Unity Express
databases if some Cisco CallManager users are not defined in the LDAP directory.
Cisco Unity Express databases if some Cisco CME users are not defined in the LDAP directory.
Message Waiting Indicators (MWIs)
Problem: After upgrading to a new version of Cisco Unity Express, the MWIs do not light up even when
messages are left in the mailboxes.
Explanation The upgrade procedure removed the IP address of the Session Initiation Protocol (SIP)
subsystem.
Recommended Action Reconfigure the SIP IP address to point to the Cisco CME router.
Auto Attendant Prompts
Problem: The custom auto attendant prompt is not working.
Recommended Action Verify that the prompt format is CCITT G.711 U-law, 8kHz, 8-bit, Mono.
Troubleshooting Commands
Table 7 lists Cisco Unity Express troubleshooting commands. The Cisco Technical Assistance Center
(TAC) may request that you run one or more of these commands when troubleshooting a problem. TAC
personnel will provide additional information about the commands at that time.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
101
Troubleshooting
Troubleshooting Commands
Caution
Some of these commands may impact performance of your system. We recommend that you do not use
these commands unless directed by the TAC.
Table 7
Troubleshooting Commands
Cisco Unity Express Cisco Unity Express
EXEC Mode
Configuration Mode
Command
Purpose
log console
Displays messages on the console
based on severity.
—
Yes
log filter
Displays messages on the console
based on a filter.
—
Yes
log server
Configures an external server for
storing log files.
—
Yes
show arp
Displays the Cisco Unity Express
ARP table entries.
Yes
—
show crash
Prints the most recent crash log.
Yes
—
show errors
Displays any errors reported in the Yes
messages log.
—
show exception
Displays any exceptions that are
thrown out.
Yes
—
show interfaces
Displays all available interfaces.
Yes
—
show log
Displays a specific log.
Yes
—
show logging
Displays the current active logging Yes
level.
—
show logs
Displays a list of log files.
Yes
—
show memory
Displays current
Cisco Unity Express memory
statistics.
Yes
—
show processes
Displays CPU or memory
processes.
Yes
—
show software
Displays configured software
information.
Yes
—
show tech-support Displays complete system
information.
Yes
—
show trace
Do Not Use Except with TAC
Guideance.
Yes
—
show version
Displays the version of all
hardware components.
Yes
—
trace all
Do Not Use Except with TAC
Guideance.
Yes
—
trace ccn
Do Not Use Except with TAC
Guideance.
Yes
—
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
102
Cisco Unity Express Release 1.1.2
Troubleshooting
Troubleshooting Commands
Table 7
Troubleshooting Commands (continued)
Cisco Unity Express Cisco Unity Express
EXEC Mode
Configuration Mode
Command
Purpose
trace config-ccn
Do Not Use Except with TAC
Guideance.
Yes
—
trace overwrite
Do Not Use Except with TAC
Guideance.
—
Yes
trace server
Do Not Use Except with TAC
Guideance.
—
Yes
trace voicemail
Do Not Use Except with TAC
Guideance.
Yes
—
trace
webInterface
Do Not Use Except with TAC
Guideance.
Yes
—
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
103
Troubleshooting
Troubleshooting Commands
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
104
Cisco Unity Express Release 1.1.2
Advanced Configuration
This chapter describes advanced configuration procedures for modifying application parameters after
the initial installation and configuration process described in “Configuring System Components” on
page 41. That earlier chapter includes commands not described in this chapter.
The advanced configuration procedures include:
•
Configuring System Engine Parameters, page 106
•
Configuring Application Parameters, page 108
•
Configuring Multiple Triggers for an Application, page 111
•
Configuring the Hostname, page 115
•
Configuring the DNS Server, page 116
•
Configuring NTP Servers, page 118
•
Configuring an External Syslog Server, page 121
•
Configuring the Clock Time Zone, page 123
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
105
Advanced Configuration
Configuring System Engine Parameters
Configuring System Engine Parameters
Use this procedure to configure parameters that are used across all systems and subsystems in
Cisco Unity Express. This set of parameters affects the underlying software programs, or engine, that
comprise Cisco Unity Express.
For Release 1.1.2, the only parameter available is maxsteps. A script uses this value to limit the number
of steps that can execute for an application script. For example, if a script has an error such that a
customer is returned to the same menu choice in an infinite loop, the system stops the loop when the
maxstep value is reached. Similarly, if a script has procedures with nested steps that exceed the maxstep
value when the script executes, the system stops the script. When this happens, the caller hears a system
message that the system is not available.
Script steps are described in detail in the Cisco Unity Express Script Editor Guide.
Note
Prerequisites
The following information is required to configure system engine parameters.
•
Maximum number of times a script step can execute before an alternate path is invoked.
1.
config t
2.
ccn engine
3.
(Optional) default parameter
4.
maxsteps steps-limit
5.
end
6.
exit
7.
show ccn engine
8.
copy running-config startup-config
SUMMARY STEPS
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ccn engine
Enters Cisco Communication Network engine
configuration mode.
Step 3
default parameter
(Optional) Sets the parameter to the system default
value. The default value for maxsteps is 1000.
Example:
se-10-0-0-0(config-engine)# default maxsteps
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
106
Cisco Unity Express Release 1.1.2
Advanced Configuration
Configuring System Engine Parameters
Step 4
Command or Action
Purpose
maxsteps steps-limit
Specifies the upper limit number of steps in the
telephony application. Refer to the Cisco Unity
Express Script Editor Guide for detailed information
about script steps.
Example:
se-10-0-0-0(config-engine)# maxsteps 200
Step 5
end
Exits Cisco Communication Network engine
configuration mode.
Step 6
exit
Exits configuration mode.
Step 7
show ccn engine
Displays configured Cisco Communication Network
(CCN) engine parameters.
Example:
se-10-0-0-0# show ccn engine
Step 8
copy running-config startup-config
Copies the configuration changes to the startup
configuration.
Example
The following example illustrates the show ccn engine output:
se-10-0-0-0# show ccn engine
Maximum number of Tasks:
Maximum number of Steps:
se-10-0-0-0#
0
200
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
107
Advanced Configuration
Configuring Application Parameters
Configuring Application Parameters
“Configuring System Components” on page 41 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.
Prerequisites
•
Application name
•
Script name for the application
•
Maxsessions value (See for guidelines on assigning this value.)
•
Name and value for each parameter that the script requires. These may vary, depending on the script
you have created.
Note
For more information about creating scripts, refer to the Cisco Unity Express Script Editor
Guide.
SUMMARY STEPS
1.
config t
2.
ccn application fullname
3.
(Optional) default parameter
4.
(Optional) description “text”
5.
maxsessions number
6.
(Optional) no parameter
7.
parameter name “value”
8.
script name [description]
9.
enabled
10. end
11. exit
12. show ccn scripts
13. show ccn application
14. copy running-config startup-config
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
108
Cisco Unity Express Release 1.1.2
Advanced Configuration
Configuring Application Parameters
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ccn application fullname
Specifies the application to configure and enters
application configuration mode. Use the full name
of the application for the fullname argument.
Example:
se-10-0-0-0(config)# ccn application myscript
Step 3
(Optional) Resets the application parameter as
follows:
default parameter
Example:
•
default description—Uses the name of the
application.
•
default enabled—Enables the application.
•
default maxsessions—Uses the number of
ports on your Cisco Unity Express module.
See Table 2 on page 3 or Table 4 on page 4 for
the maximum number of ports.
•
default script—No effect.
•
default parameter—Uses the script’s default
value.
se-10-0-0-0(config-application)# default maxsessions
Step 4
(Optional) Enter a description of the application.
Use double quotes around the text.
description “text”
Example:
se-10-0-0-0(config-application)# description “my
application”
Step 5
se-10-0-0-0(config-application)# maxsessions 5
Specifies the number of users who can access this
application simultaneously. See “Sharing Ports
Among Applications and Triggers” on page 44 for
guidelines on assigning this value.
no parameter
(Optional) Deletes or disables a script value.
maxsessions number
Example:
Step 6
Example:
se-10-0-0-0(config-application)# no description
Step 7
Specifies parameters for the application. Each
parameter must have a name and a value, which is
written within double quotes.
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”
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.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
109
Advanced Configuration
Configuring Application Parameters
Step 9
Command or Action
Purpose
enabled
Allows the application to be accessible to the
system.
Example:
se-10-0-0-0(config-application)# enabled
Step 10
end
Exits application configuration mode.
Step 11
exit
Exits configuration mode.
Step 12
show ccn scripts
Displays the configured script names and their
descriptions.
Example:
se-10-0-0-0# show ccn scripts
Step 13
show ccn application
Displays details about each configured
application.
Example:
se-10-0-0-0# show ccn application
Step 14
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Examples
The following example illustrates the show ccn scripts output:
se-10-0-0-0# show ccn scripts
Name:
Description:
se-10-0-0-0#
myscript.aef
My New Script
The following example illustrates the show ccn application output:
se-10-0-0-0# show ccn application
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
Retries:
WelcomePrompt:
se-10-0-0-0#
myscript
my application
myscript.aef
2
yes
5
4
Welcome.wav
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
110
Cisco Unity Express Release 1.1.2
Advanced Configuration
Configuring Multiple Triggers for an Application
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 CME. If you configure a trigger on Cisco Unity Express, verify that the dial peer exists in Cisco
CME.
Cisco Unity Express supports a maximum of 8 triggers for all applications combined. This applies to
both the NM and the AIM.
Port Sharing Among Multiple Triggers
Each trigger is assigned a maxsessions value. In addition to the guidelines described in “Sharing Ports
Among Applications and Triggers” on page 44, 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 values 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, 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.
Prerequisites
The following information is required to configure the triggers:
•
Telephone number that invokes the application. The number must not be the same for voice mail,
auto attendant, and the greeting management system.
•
Number of milliseconds the system must wait for a caller response before it times out and drops the
call.
•
Language to use for the prompts. For Releases 1.1.2, 1.1, and 1.0, only U.S. English is available.
•
Maximum number of callers, or sessions, the application can handle simultaneously. The total for
all applications must not exceed the maximum number of ports for the system. (See Table 2 on
page 3 or Table 4 on page 4 for the maximum number of ports.) The applications need not have the
same maximum number; for example, voice mail might need three sessions while auto attendant
needs five sessions.
1.
config t
2.
ccn trigger sip phonenumber number
3.
application string
4.
(Optional) default parameter
SUMMARY STEPS
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
111
Advanced Configuration
Configuring Multiple Triggers for an Application
5.
idletimeout time
6.
locale language
7.
maxsessions number
8.
(Optional) no parameter
9.
enabled
10. end
11. Repeat Step 2 to Step 10 to configure additional triggers for this application.
12. exit
13. show ccn trigger
14. copy running-config startup-config
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ccn trigger sip phonenumber number
Specifies the telephone number that acts as the trigger
to start the application and enters trigger
configuration mode. The number value must match a
dial peer configured on Cisco CME.
Example:
se-10-0-0-0(config)# ccn trigger sip phonenumber
50150
se-10-0-0-0(config)# ccn trigger sip phonenumber
50160
Step 3
application string
Example:
se-10-0-0-0(config-trigger)# application
myapplication
Step 4
default parameter
Example:
se-10-0-0-0(config-trigger)# default idletimeout
se-10-0-0-0(config-trigger)# default
myscriptparameter
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.
(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:
•
default application—No effect.
•
default enabled—Enables the application.
•
default idletimeout—Uses 5000 (5 seconds).
•
default locale—Uses the system default.
•
default maxsessions—Uses the number of ports
on your Cisco Unity Express module. See
Table 2 on page 3 or Table 4 on page 4 for the
maximum number of ports.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
112
Cisco Unity Express Release 1.1.2
Advanced Configuration
Configuring Multiple Triggers for an Application
Step 5
Command or Action
Purpose
idletimeout time
Specifies the number of milliseconds to wait for a
caller’s response before timing out and disconnecting
the call.
Example:
se-10-0-0-0(config-trigger)# idletimeout 500
Step 6
Specifies the language to use for the prompts heard
by the caller. In Releases 1.1.2, 1.1, and 1.0, U.S.
English is the only language available.
locale language
Example:
se-10-0-0-0(config-trigger)# locale en_US
Step 7
maxsessions number
Example:
se-10-0-0-0(config-trigger)# maxsessions 3
Step 8
(Optional) Deletes or disables the parameter value.
Using the no command on Cisco Unity Express
system parameters has the following effects:
no parameter
Example:
se-10-0-0-0(config-trigger)# no maxsessions
se-10-0-0-0(config-trigger)# no myscriptparameter
Step 9
Specifies the maximum number of callers the
application can handle simultaneously. See “Sharing
Ports Among Applications and Triggers” on page 44
for guidelines on assigning this value.
•
no application—No effect.
•
no enabled—Disables the application.
•
no idletimeout—No effect.
•
no locale—Uses the system default.
•
no maxsessions—Sets the value to 0.
Enables the trigger.
enabled
Example:
se-10-0-0-0(config-trigger)# enabled
Step 10
end
Step 11
Repeat Step 2 to Step 10 to configure additional triggers for —
this application.
Step 12
exit
Exits configuration mode.
Step 13
show ccn trigger
Displays the parameter values for all configured
triggers.
Exits trigger configuration mode.
Example:
se-10-0-0-0# show ccn trigger
Step 14
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Example
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
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
113
Advanced Configuration
Configuring Multiple Triggers for an Application
se-10-0-0-0(config-trigger)# end
se-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)# end
se-10-0-0-0(config)# exit
se-10-0-0-0#
The output for show ccn trigger might look similar to the following:
se-10-0-0-0# show ccn trigger
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
50150
SIP
voicemail
en_US
500
yes
4
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
se-10-0-0-0#
50160
SIP
voicemail
en_US
1000
yes
8
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
114
Cisco Unity Express Release 1.1.2
Advanced Configuration
Configuring the Hostname
Configuring the Hostname
During the software postinstallation process, the hostname was configured. Use this procedure to change
the hostname.
SUMMARY STEPS
1.
config t
2.
hostname hostname
3.
exit
4.
show hosts
5.
copy running-config startup-config
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
hostname hostname
Specifies the hostname identifying the local
Cisco Unity Express system. Do not include the domain name
as part of the hostname.
Example:
se-10-0-0-0(config)# hostname mainhost
mainhost(config)# no hostname
se-10-0-0-0(config)#
The Cisco Unity Express prompt changes to reflect the
hostname. If you do not enter a hostname, the prompt is formed
using “se” and the IP address of the Cisco Unity Express
network module.
Step 3
exit
Exits configuration mode.
Step 4
show hosts
Displays the host servers configured on the system.
Step 5
copy running-config startup-config
Copies the configuration change to the startup configuration.
Example
The following commands configure the hostname:
se-10-0-0-0# config t
se-10-0-0-0(config)# hostname ca-west
ca-west(config)# exit
ca-west#
The output from the show commands might look similar to the following:
ca-west# show hosts
Hostname:
Domain:
DNS Server1:
DNS Server2:
ca-west#
ca-west
myoffice
10.100.10.130
10.5.0.0
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
115
Advanced Configuration
Configuring the DNS Server
Configuring the DNS Server
During the software postinstallation process, the DNS server and IP addresses were configured. Use this
procedure to change the server name and IP addresses.
SUMMARY STEPS
1.
config t
2.
ip domain-name dns-server-name
3.
ip name-server ip_address [ip_address] [ip_address] [ip_address]
4.
exit
5.
show ip route
6.
copy running-config startup-config
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ip domain-name dns-server-name
Specifies the domain name of the DNS server.
Example:
se-10-0-0-0(config)# ip domain-name mycompany.com
Step 3
ip name-server ip_address [ ip_address] [ ip_address]
[ip_address]
Specifies up to four IP addresses of the DNS server.
Example:
se-10-0-0-0(config)# ip name-server 192.168.0.5
se-10-0-0-0(config)# ip name-server 192.168.0.5
192.168.0.10 192.168.0.12 192.168.0.20
Step 4
exit
Exits configuration mode.
Step 5
show ip route
Displays the IP route destinations, gates, and masks.
Step 6
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Example
The following commands configure the DNS server:
se-10-0-0-0# config t
se-10-0-0-0(config)# ip domain-name myoffice
se-10-0-0-0(config)# ip name-server 10.100.10.130 10.5.0.0
se-10-0-0-0(config)# exit
se-10-0-0-0
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
116
Cisco Unity Express Release 1.1.2
Advanced Configuration
Configuring the DNS Server
The output from the show commands might look similar to the following:
se-10-0-0-0# show ip route
DEST
GATE
10.100.6.9
0.0.0.0
172.16.0.0
0.0.0.0
0.0.0.0
10.100.6.9
se-10-0-0-0#
MASK IFACE
255.255.255.0 eth1
255.0.0.0 lo
0.0.0.0 eth1
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
117
Advanced Configuration
Configuring NTP Servers
Configuring NTP Servers
You can configure NTP servers using the GUI options, the CLI commands, or during the software
postinstallation process. 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.
•
If you use an IP address, you must always refer to the NTP server by that IP address. You cannot use
a hostname to refer to that NTP server.
•
If you use a hostname, you must always refer to the NTP server by that hostname. You cannot use
an IP address to refer to that NTP server.
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.
config t
2.
ntp server {hostname | ip_address} [prefer]
3.
exit
4.
show ntp status
5.
show ntp configuration
6.
copy running-config startup-config
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
ntp server {hostname
| ip_address} [prefer]
Example:
Specifies the name or IP address of the NTP server.
If more than one server is configured, the server with
the prefer attribute is used before the others.
se-10-0-0-0(config)# ntp server 10.0.3.4
se-10-0-0-0(config)# ntp server 10.0.10.20 prefer
Step 3
exit
Exits configuration mode.
Step 4
show ntp status
Displays the NTP subsystem status.
Step 5
show ntp configuration
Displays the configured NTP servers.
Step 6
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
118
Cisco Unity Express Release 1.1.2
Advanced Configuration
Configuring NTP Servers
Example
The following commands configure the NTP server:
se-10-0-0-0# config t
se-10-0-0-0(config)# ntp server 10.100.6.9
se-10-0-0-0(config)# exit
se-10-0-0-0#
The output from the show commands might look similar to the following:
se-10-0-0-0# show ntp status
NTP reference server 1:
Status:
Time difference (secs):
Time jitter (secs):
se-10-0-0-0#
10.100.6.9
sys.peer
3.268110099434328E8
0.1719226837158203
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 t
se-10-0-0-0(config)# ntp server NTP.mine.com
se-10-0-0-0(config)# exit
se-10-0-0-0#
se-10-0-0-0# config t
se-10-0-0-0(config)# ntp server NTP.mine.com
se-10-0-0-0(config)# exit
se-10-0-0-0#
The output from the show commands might look similar to the following:
se-10-0-0-0# show ntp status
NTP reference server 1:
Status:
Time difference (secs):
Time jitter (secs):
172.16.10.1
sys.peer
3.268110099434328E8
0.1719226837158203
NTP reference server 1:
Status:
Time difference (secs):
Time jitter (secs):
se-10-0-0-0#
172.16.10.2
sys.peer
3.268110099434328E8
0.1719226837158203
Removing an NTP Server
Remove an NTP server using its IP address or hostname.
•
If the NTP server was configured using its IP address, use that IP address to remove the server. You
cannot remove the server with its hostname.
•
If the NTP server was configured using its hostname, use that hostname to remove the server. You
cannot remove the server with an IP address.
If the NTP server hostname is associated with more than one IP address, you cannot specify which
IP address to remove. Cisco Unity Express deletes the IP address based on a response from the DNS
server and cannot guarantee which configured NTP server IP address is deleted.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
119
Advanced Configuration
Configuring NTP Servers
If you need to remove the NTP server with a specific IP address, repeat the removal steps enough
times to delete all the NTP servers, update the DNS server with the correct IP address information,
then add the NTP server enough times to assign the NTP server to its appropriate number of IP
addresses.
SUMMARY STEPS
1.
config t
2.
no ntp server {hostname | ip_address} [prefer]
3.
exit
4.
show ntp status
5.
show ntp configuration
6.
copy running-config startup-config
DETAILED STEPS
Command or Action
Step 1
config t
Step 2
no ntp server {hostname
Purpose
Enters configuration mode.
| ip_address}
Specifies the hostname or IP address of the NTP
server to remove.
Example:
se-10-0-0-0(config)# no ntp server 10.0.3.4
se-10-0-0-0(config)# no ntp server myhost
Step 3
exit
Exits configuration mode.
Step 4
show ntp status
Displays the NTP subsystem status.
Step 5
show ntp configuration
Displays the configured NTP servers.
Step 6
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Displaying NTP Server Information
The following commands are available to display NTP server configuration information and status:
•
show ntp associations
•
show ntp servers
•
show ntp source
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
120
Cisco Unity Express Release 1.1.2
Advanced Configuration
Configuring an External Syslog Server
Configuring an External Syslog Server
Cisco Unity Express captures messages that describe activities in the system. Use CLI commands to
display the messages; viewing the messages is not available from the GUI.
The activities are categorized into four different levels of severity with regard to their impact on the
system’s functioning:
•
Information—The message describes normal system activity, including debug, information, and
notice messages.
•
Warning—The message is an alert that a non-normal activity is occurring. The Cisco Unity Express
system continues to function.
•
Error—The message indicates that a system error has occurred. The Cisco Unity Express system
may or may not have stopped functioning.
•
Fatal—The message describes a critical, alert, or emergency situation with the system. The
Cisco Unity Express system has stopped functioning.
These messages are collected and directed to three possible destinations:
•
Messages.log file—This option is the default. The file contains all system messages and resides on
the Cisco Unity Express module hard disk in /var/log/messages.log. You can print the messages,
view them on the console, or copy them to a server to review for troubleshooting and error reporting.
•
Console—Display the messages.log file using the show log name messages.log command. View the
system messages as they occur with the log console info command.
•
External system log (syslog) server—Cisco Unity Express copies the messages to another server
and collects them in a file on that server’s hard disk. The syslog daemon configuration on the
external server determines which directory will save the messages log.
The external server must be configured to listen for UDP on port 514 from the IP address of the
Cisco Unity Express module.
Prerequisites
You need the hostname or IP address of the designated log server.
SUMMARY STEPS
1.
config t
2.
log server address {hostname | IP-address}
3.
exit
4.
show running-config
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
121
Advanced Configuration
Configuring an External Syslog Server
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
log server address {hostname | IP-address}
Specifies the hostname or IP address of the NTP
server designated as the log server.
Example:
se-10-0-0-0(config)# log server 10.187.240.31
se-10-0-0-0(config)# log server logpc
Step 3
exit
Exits configuration mode.
Step 4
show running-config
Displays the system configuration, which includes
the configured log server.
Example
The output from the show running-config command might look similar to the following:
se-10-0-0-0# show running-config
clock timezone America/Los_Angeles
hostname se-10-100-60-2
ip domain-name localdomain
ntp server 10.100.60.1
.
.
.
log server address 10.100.10.210
voicemail default mailboxsize 3000
voicemail capacity time 6000
end
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
122
Cisco Unity Express Release 1.1.2
Advanced Configuration
Configuring the Clock Time Zone
Configuring 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.
config t
2.
clock timezone timezone
3.
exit
4.
show clock detail
5.
copy running-config startup-config
DETAILED STEPS
Command or Action
Purpose
Step 1
config t
Enters configuration mode.
Step 2
clock timezone timezone
Specifies the local time zone. To enter a value for the
timezone argument, you must know the phrase that
represents your time zone.
Example:
se-10-0-0-0(config)# clock timezone
America/Los_Angeles
If you do know the phrase, press <Enter>. A series of
menus will appear to help you choose the time zone.
Step 3
exit
Exits configuration mode.
Step 4
show clock detail
Displays the time zone, clocking resolution, and
current clock time.
Step 5
copy running-config startup-config
Copies the configuration change to the startup
configuration.
Examples
The following commands configure the DNS and NTP servers:
se-10-0-0-0# config t
se-10-0-0-0(config)# clock timezone
Please 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 Ocean
2) Americas
5) Asia 8) Europe
3) Antarctica
6) Atlantic Ocean 9) Indian Ocean
#? 2
Please select a country.
1) Anguilla
18)
2) Antigua & Barbuda
19)
3) Argentina
20)
4) Aruba
21)
5) Bahamas
22)
Ecuador
El Salvador
French Guiana
Greenland
Grenada
35)
36)
37)
38)
39)
Paraguay
Peru
Puerto Rico
St Kitts & Nevis
St Lucia
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
123
Advanced Configuration
Configuring the Clock Time Zone
6) Barbados
7) Belize
8) Bolivia
9) Brazil
10) Canada
11) Cayman Islands
12) Chile
13) Colombia
14) Costa Rica
15) Cuba
16) Dominica
17) Dominican Republi
#? 45
23) Guadeloupe
40) St Pierre & Miquelon
24) Guatemala
41) St Vincent
25) Guyana
42) Suriname
26) Haiti
43) Trinidad & Tobago
27) Honduras
44) Turks & Caicos Is
28) Jamaica
45) United States
29) Martinique
46) Uruguay
30) Mexico
47) Venezuela
31) Montserrat
48) Virgin Islands (UK)
32) Netherlands Antilles 49) Virgin Islands (US)
33) Nicaragua
34) Panama
Please select one of the following time zone regions.
1) Eastern Time
2) Eastern Time - Michigan - most locations
3) Eastern Time - Kentucky - Louisville area
4) Eastern Time - Kentucky - Wayne County
5) Eastern Standard Time - Indiana - most locations
6) Eastern Standard Time - Indiana - Crawford County
7) Eastern Standard Time - Indiana - Starke County
8) Eastern Standard Time - Indiana - Switzerland County
9) Central Time
10) Central Time - Michigan - Wisconsin border
11) Central Time - North Dakota - Oliver County
12) Mountain Time
13) Mountain Time - south Idaho & east Oregon
14) Mountain Time - Navajo
15) Mountain Standard Time - Arizona
16) Pacific Time
17) Alaska Time
18) Alaska Time - Alaska panhandle
19) Alaska Time - Alaska panhandle neck
20) Alaska Time - west Alaska
21) Aleutian Islands
22) Hawaii
#? 16
The following information has been given:
United States
Pacific Time
Therefore TZ='America/Los_Angeles' will be used.
Is the above information OK?
1) Yes
2) No
#? 1
The output from the show command might look like this:
se-10-0-0-0# show clock detail
19:20:33.724 PST Wed Feb 4 2004
time zone:
clock state:
delta from reference (microsec):
estimated error (microsec):
time resolution (microsec):
clock interrupt period (microsec):
time of day (sec):
time of day (microsec):
America/Los_Angeles
unsync
0
175431
1
10000
732424833
760817
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
124
Cisco Unity Express Release 1.1.2
Command Reference
This chapter contains an alphabetical listing of the Cisco Unity Express CLI commands listed in Table 8.
For information on Cisco IOS commands, refer to the 12.3 T Command References.
Cisco Unity Express command-line interface (CLI) commands are available in Cisco Unity Express
EXEC mode, Cisco Unity Express configuration mode, or offline mode.
Table 8
Cisco Unity Express Commands for Cisco CallManager Express
Command
Cisco Unity Express Cisco Unity Express
EXEC Mode
Configuration Mode Offline Mode
backup
—
Yes
backup category
—
—
Yes
ccn application
—
Yes
—
ccn copy
Yes
—
—
ccn copy prompt
Yes
—
—
ccn copy script
Yes
—
—
ccn delete
Yes
—
—
ccn engine
—
Yes
—
ccn subsystem
—
Yes
—
ccn trigger
—
Yes
—
clock timezone
—
Yes
—
continue
—
—
Yes
copy ftp
Yes
—
—
copy running-config
Yes
—
—
copy startup-config
Yes
—
—
copy tftp
Yes
—
—
default
—
Yes
—
erase startup-config
Yes
—
—
gateway address
—
SIP configuration
—
gateway port
—
SIP configuration
—
groupname
Yes
Yes
—
hostname
—
Yes
—
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
125
Command Reference
Table 8
Cisco Unity Express Commands for Cisco CallManager Express (continued)
Command
Cisco Unity Express Cisco Unity Express
EXEC Mode
Configuration Mode Offline Mode
ip domain-name
—
Yes
—
ip name-server
—
Yes
—
log server
—
Yes
—
log trace
Yes
—
—
mwi refresh
Yes
—
—
ntp server
Yes
—
—
offline
Yes
—
—
reload
Yes
—
—
restore
—
—
Yes
show backup
Yes
—
—
show backup history
Yes
—
—
show backup server
Yes
—
—
show ccn application
Yes
—
—
show ccn engine
Yes
—
—
show ccn prompts
Yes
—
—
show ccn scripts
Yes
—
—
show ccn subsystem sip
Yes
—
—
show ccn trigger
Yes
—
—
show clock detail
Yes
—
—
show group detail groupname
Yes
—
—
show groups
Yes
—
—
show hosts
Yes
—
—
show interface ide 0
Yes
—
—
show ip route
Yes
—
—
show ntp associations
Yes
—
—
show ntp servers
Yes
—
—
show ntp source
Yes
—
—
show ntp status
Yes
—
—
show privilege detail
Yes
—
—
show privileges
Yes
—
—
show running-config
Yes
—
—
show software
Yes
—
—
show startup-config
Yes
—
—
show user detail username
Yes
—
—
show users
Yes
—
—
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
126
Cisco Unity Express Release 1.1.2
Command Reference
Table 8
Cisco Unity Express Commands for Cisco CallManager Express (continued)
Command
Cisco Unity Express Cisco Unity Express
EXEC Mode
Configuration Mode Offline Mode
show version
Yes
—
—
show voicemail
Yes
—
—
shutdown
Yes
—
—
username
Yes
Yes
—
voicemail capacity time
—
Yes
—
voicemail default
—
Yes
—
voicemail mailbox owner
—
Yes
—
voicemail mailbox unlock
Yes
—
—
voicemail operator telephone
—
Yes
—
voicemail recording time
—
Yes
—
write
Yes
—
—
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
127
Command Reference
backup
backup
To set the backup parameters, use the backup command in Cisco Unity Express configuration mode. To
delete the number of revisions or the backup server URL, use the no form of this command.
backup {revisions number | server url ftp-url username ftp_username password ftp_password}
no backup {revisions number | server url ftp-url}
Syntax Description
revisions number
Number of revision files stored in the Cisco Unity Express database.
server url ftp-url
URL to the FTP server where the backup files will be stored.
username ftp_username
User ID needed to access the FTP server.
password ftp_password
Password needed to access the FTP server.
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express network
module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Set these parameters before backing up any files.
Consider the amount of storage space each backup file requires when setting the number of files to store.
When the number is reached, the next backup file overwrites the oldest stored backup file.
The system automatically numbers and dates the backup files and identifies the revision number in a
backupid field. Reference this backup ID value when restoring a file.
Performing different backup types at various times causes different backup IDs for data backups and
configuration backups. For example, the last data backup ID might be 3 and the last configuration backup
might be 4. Performing an all backup might result in a backup ID of 5 for both data and configuration.
Examples
The following example sets 7 revisions on FTP server /branch/vmbackups.
se-10-0-0-0> enable
se-10-0-0-0# config t
se-10-0-0-0(config)# backup revisions 7
se-10-0-0-0(config)# backup server url ftp://branch/vmbackups username “admin” password
“mainserver”
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
128
Cisco Unity Express Release 1.1.2
Command Reference
backup
Related Commands
Command
Description
backup category
Specifies the type of data to be backed up.
show backup history
Displays statistics for backed up files.
show backup server
Displays the FTP server designated to store back up files.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
129
Command Reference
backup category
backup category
To specify the type of data to be backed up, use the backup category command in Cisco Unity Express
offline mode.
backup category {all | configuration | data}
Syntax Description
all
Backs up all data.
configuration
Backs up only system and application settings.
data
Backs up only voice-mail messages and application data.
Defaults
All data is backed up.
Command Modes
Cisco Unity Express offline
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command indicates the type of Cisco Unity Express data to be backed up to the FTP server.
When the backup procedure begins, all active calls are terminated. In Release 1.0, Cisco Unity Express
does not support scheduled restores. Consider doing the backup procedure when the telephones are least
active.
Examples
The following examples illustrate all the backup categories:
se-10-0-0-0> enable
cue-10.0.0.0# offline
se-10-0-0-0# backup category all
se-10-0-0-0# continue
se-10-0-0-0> enable
cue-10.0.0.0# offline
se-10-0-0-0# backup category configuration
se-10-0-0-0# continue
se-10-0-0-0> enable
cue-10.0.0.0# offline
se-10-0-0-0# backup category data
se-10-0-0-0# continue
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
130
Cisco Unity Express Release 1.1.2
Command Reference
backup category
Related Commands
Command
Description
continue
Activates the backup or restore process.
offline
Initiates Cisco Unity Express offline mode.
show backup history
Displays details about backed up files.
show backup server
Displays details about the backup server.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
131
Command Reference
ccn application
ccn application
To specify an application to configure, use the ccn application command in Cisco Unity Express
configuration mode. To delete the application, use the default or the no form of this command.
ccn application fullname
no ccn application fullname
Application configuration mode:
(Optional) default parameter
(Optional) description “text”
enabled
maxsessions number
(Optional) no parameter
parameter name “value”
script name description [“description”]
Syntax Description
fullname
Full name of the application.
default parameter
(Optional) Resets the application parameter value as
follows:
•
default description—Uses the name of the
application.
•
default enabled—Enables the application.
•
default maxsessions—Uses the port license number.
•
default script—No effect.
•
default parameter—Uses the script’s default value.
description “text”
(Optional) Specifies a text description of the application.
Use double quotes around the text.
enabled
Allows the application to be accessible to the system.
maxsessions number
Specifies the number of users who can access this
application simultaneously. The maximum value is
determined by the number of ports purchased for the
application.
no parameter
(Optional) Deletes or disables an application parameter
value.
parameter name “value”
Specifies the name and value for the application parameter.
The value must be written within double quotes.
script name description [“description”] Specifies the name of the script and an optional
description, which must be written within double quotes. If
no description is provided, Cisco Unity Express uses the
name value for the description.
Command Modes
Cisco Unity Express configuration
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
132
Cisco Unity Express Release 1.1.2
Command Reference
ccn application
Command History
Usage Guidelines
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
This command specifies the name of the application to configure on the Cisco Unity Express module.
The mode switches to application configuration mode that supports several configurable parameters.
The sequence in which the parameters are configured is optional.
Examples
This example shows the configuration command for auto attendant:
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn application AutoAttendant
se-10-0-0-0(config-application)# description “Release 1 AA”
se-10-0-0-0(config-application)# script naa.aef “New”
se-10-0-0-0(config-application)# maxsessions 8
se-10-0-0-0(config-application)# parameter prompts “5”
se-10-0-0-0(config-application)# enabled
Related Commands
Command
Description
show ccn application
Displays details for each configured application.
show ccn scripts
Displays configured script names and descriptions.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
133
Command Reference
ccn copy
ccn copy
To copy customized prompt and script files to Cisco Unity Express, use the ccn copy command in Cisco
Unity Express EXEC mode.
ccn copy url source-ip-address [prompt prompt-filename | script script-filename]
Syntax Description
url source-ip-address
IP address of the location containing the greeting file.
prompt prompt-filename
Name of the file containing the prompt or greeting.
script script-filename
Name of the file containing the script.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Use this command to copy prompts and script files to Cisco Unity Express.
The prompts must be previously recorded .wav files. Use the prompt management system (PMS) to
record the prompts from the telephone user interface (TUI).
Use the Cisco Unity Express script editor program to create the scripts, which specify how the incoming
auto attendant calls are handled. This includes what prompts the caller hears, when alternate prompts are
played, which extensions should be dialed based on the caller’s key presses, and other similar call
handling characteristics.
Examples
The following example copies a welcome prompt AAHello.wav from the FTP server:
se-10-0-0-0# ccn copy url ftp://172.168.10.0/AAHello.wav prompt AAHello.wav
The following example copies a script AAnight.aef from a PC:
se-10-0-0-0# ccn copy url 172.168.20.10/Scripts script AAnight.aef
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
134
Cisco Unity Express Release 1.1.2
Command Reference
ccn copy
Related Commands
Command
Description
ccn application
Configures an application.
ccn delete
Deletes a prompt or script file from Cisco Unity Express.
show ccn prompts
Displays configured CCN prompt files.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
135
Command Reference
ccn copy prompt
ccn copy prompt
To copy customized prompt files from Cisco Unity Express to another location, use the
ccn copy prompt command in Cisco Unity Express EXEC mode.
ccn copy prompt prompt-filename url destination-ip-address
Syntax Description
prompt-filename
Name of the prompt file to be copied.
url destination-ip-address
Destination URL where the prompt file will be stored.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.1
This command was introduced on the Cisco Unity Express
network module (NM), Advanced Integration Module (AIM), and
in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following example copies a prompt file AAHello.wav to an FTP server:
se-10-0-0-0# ccn copy prompt AAHello.wav url ftp://172.168.10.0/AAHello.wav
The following example copies a prompt file AAHello.wav to a PC:
se-10-0-0-0# ccn copy prompt AAHello.wav url 172.168.20.10/Prompts
Related Commands
Command
Description
ccn copy
Copies script and prompt files to Cisco Unity Express.
ccn copy script
Copies script files from Cisco Unity Express to another location.
ccn delete
Deletes script and prompt files.
show ccn prompts
Displays a list of configured prompt files.
show ccn scripts
Displays a list of configured script files.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
136
Cisco Unity Express Release 1.1.2
Command Reference
ccn copy script
ccn copy script
To copy customized script files from Cisco Unity Express to another location, use the ccn copy script
command in Cisco Unity Express EXEC mode.
ccn copy script script-filename url destination-ip-address
Syntax Description
script-filename
Name of the script file to be copied.
url destination-ip-address
Destination URL where the prompt file will be stored.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.1
This command was introduced on the Cisco Unity Express
network module (NM), Advanced Integration Module (AIM), and
in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following example copies a script file AAnight.aef to an FTP server:
se-10-0-0-0# ccn copy script AAnight.aef url ftp://172.168.10.0/Scripts
The following example copies a prompt file AAHello.wav to a PC:
se-10-0-0-0# ccn copy script AAnight.aef url 172.168.20.10/Scripts
Related Commands
Command
Description
ccn copy
Copies script and prompt files to Cisco Unity Express.
ccn copy prompt
Copies prompt files from Cisco Unity Express to another location.
ccn delete
Deletes script and prompt files.
show ccn prompts
Displays a list of configured prompt files.
show ccn scripts
Displays a list of configured script files.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
137
Command Reference
ccn delete
ccn delete
To delete a script or prompt from the Cisco Unity Express module, use the ccn delete command in Cisco
Unity Express EXEC mode.
ccn delete {prompt prompt-filename | script script-filename}
Syntax Description
prompt prompt-filename
Name of the prompt file.
script script-filename
Name of the script file.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Use this command to delete auto attendant .wav greeting prompts or an application .aef script file. Use
the show ccn prompts or show ccn scripts command to display configured prompts and scripts before
deleting one.
Examples
The following example deletes a script vm.aef:
se-10-0-0-0# show ccn scripts
.
.
.
se-10-0-0-0# ccn delete script vm.aef
The following example deletes a welcome prompt AAHello.wav:
se-10-0-0-0# show ccn prompts
.
.
.
se-10-0-0-0# ccn delete prompt AAHello.wav
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
138
Cisco Unity Express Release 1.1.2
Command Reference
ccn delete
Related Commands
Command
Description
ccn application
Configures an application.
ccn copy
Copies a file from a URL to Cisco Unity Express.
show ccn prompts
Displays configured CCN prompt files.
show ccn scripts
Displays configured CCN script files.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
139
Command Reference
ccn engine
ccn engine
To configure the features shared by all the Cisco Unity Express subsystems, use the ccn engine
command in Cisco Unity Express configuration mode.
ccn engine
Engine configuration mode:
default parameter
maxsteps steps-limit
no parameter
Syntax Description
default parameter
Resets the application parameter value as follows:
•
default maxsteps—Uses 1000.
maxsteps steps-limit
Specifies the upper limit number of steps in the telephony
application. The default value is 1000.
no parameter
Deletes or disables a configuration parameter.
Defaults
maxsteps: 1000 steps
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following example assigns 200 as the maximum number of steps to all Cisco Unity Express
applications:
se-10-0-0-0> enable
se-10-0-0-0# config 5
se-10-0-0-0(config)# ccn engine
se-10-0-0-0(config-engine)# maxsteps 200
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
140
Cisco Unity Express Release 1.1.2
Command Reference
ccn engine
Related Commands
Command
Description
ccn application
Configures an application.
ccn subsystem
Configures the subsystems on Cisco Unity Express.
ccn trigger
Configures the triggers for handling calls to Cisco Unity Express.
show ccn engine
Displays the CCN engine statistics.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
141
Command Reference
ccn subsystem
ccn subsystem
To configure the subsystems used by Cisco Unity Express, use the ccn subsystem command in
Cisco Unity Express configuration mode.
ccn subsystem sip
SIP configuration mode:
gateway address ip_address
gateway port port_number
Syntax Description
sip
Activates the SIP configuration mode.
gateway address ip_address
Hostname or IP address of the SIP proxy server. The default value is
0.0.0.0.
gateway port port_number
UDP or TCP port on the SIP proxy server. The default value is port
5060.
Defaults
ip_address: 0.0.0.0
port_number: 5060
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express network
module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Use the ccn subsystem command to enter SIP configuration mode.
Neither the delete form nor the no form of this command removes the subsystem.
Examples
The following example configures the SIP subsystem gateway with address 192.168.0.5 and port
number 5060:
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn
se-10-0-0-0(config-sip)#
se-10-0-0-0(config-sip)#
se-10-0-0-0(config-sip)#
subsystem sip
gateway address 192.168.0.5
gateway port 5060
end
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
142
Cisco Unity Express Release 1.1.2
Command Reference
ccn subsystem
Related Commands
Command
Description
show ccn subsystem sip
Displays statistics for the configured subsystems.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
143
Command Reference
ccn trigger
ccn trigger
To configure the triggers that activate Cisco Unity Express application functions, use the ccn trigger
command in Cisco Unity Express configuration mode. To delete the trigger, use the default or the no
form of this command.
ccn trigger sip phonenumber number
Trigger configuration mode:
application app-name
default parameter
enabled
end
exit
idletimeout time
locale language
maxsessions number
no parameter
Syntax Description
sip phonenumber number
Specifies the phone number that acts as the trigger to start the
application on the SIP proxy server and enters trigger
configuration mode. The number value should be the last four
digits of the full telephone number that callers dial to reach
the auto attendant.
application app-name
Specifies the name of the application to start when the trigger
is entered.
default parameter
(Optional) Resets the application parameter value as follows:
•
default application—No effect.
•
default enabled—Enables the application.
•
default idletimeout—Uses 5000.
•
default locale—Uses the system default.
•
default maxsessions—Uses the value from the port
license.
enabled
Enables the trigger.
end
Exits trigger configuration mode.
exit
Exits Cisco Unity Express configuration mode.
idletimeout time
Specifies the number of seconds to wait for a caller’s
response before timing out and disconnecting the call.
locale language
Specifies the language to use for the prompts heard by the
caller. For Release 1.0, U.S. English is the only language
available.
maxsessions number
Specifies the maximum number of user who can access this
application simultaneously. The maximum value is
determined by the number of ports purchased for the
application.
no parameter
(Optional) Deletes or disables a parameter value.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
144
Cisco Unity Express Release 1.1.2
Command Reference
ccn trigger
Defaults
Language: U.S. English
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
An application may have several triggers that invoke it, but a trigger must be associated with only one
application.
Examples
The following example configures 7800 as a telephone number that will trigger the voice mail
application. Two callers can reach the voice-mail system using this number at a given time and the
system waits 3 minutes for the callers to respond to prompts before disconnecting the call.
se-10-0-0-0# enable
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn trigger sip phonenumber 50145
se-10-0-0-0(config-trigger)# application voicemail
se-10-0-0-0(config-trigger)# idletimeout 180
se-10-0-0-0(config-trigger)# maxsessions 2
se-10-0-0-0(config-trigger)# enabled
se-10-0-0-0(config-trigger)# end
Related Commands
Command
Description
show ccn trigger
Displays configuration of an application trigger.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
145
Command Reference
clock timezone
clock timezone
To set the time zone for the Cisco Unity Express system, use the clock command in Cisco Unity Express
configuration mode.
clock timezone [timezone]
Syntax Description
timezone
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
(Optional) Time zone of the local branch.
Cisco Unity Express gets the time from the configured NTP server to date stamp system and application
functions. The clock command specifies the local time zone where Cisco Unity Express is installed.
If you know the phrase for the time zone, enter it for the timezone value. If you do not know the time
zone phrase, leave the timezone value blank and a series of menus appear to guide you through the time
zone selection process.
Examples
The following example shows how United States Pacific Time is selected as the time zone:
se-10-0-0-0# config t
se-10-0-0-0# clock
Please 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 Ocean
2) Americas
5) Asia
8) Europe
3) Antarctica
6) Atlantic Ocean
9) Indian Ocean
#? 2
Please select a country.
1) Anguilla
18) Ecuador
35) Paraguay
2) Antigua & Barbuda
19) El Salvador
36) Peru
3) Argentina
20) French Guiana
37) Puerto Rico
4) Aruba
21) Greenland
38) St Kitts & Nevis
5) Bahamas
22) Grenada
39) St Lucia
6) Barbados
23) Guadeloupe
40) St Pierre & Miquelon
7) Belize
24) Guatemala
41) St Vincent
8) Bolivia
25) Guyana
42) Suriname
9) Brazil
26) Haiti
43) Trinidad & Tobago
10) Canada
27) Honduras
44) Turks & Caicos Is
11) Cayman Islands
28) Jamaica
45) United States
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
146
Cisco Unity Express Release 1.1.2
Command Reference
clock timezone
12) Chile
29) Martinique
46) Uruguay
13) Colombia
30) Mexico
47) Venezuela
14) Costa Rica
31) Montserrat
48) Virgin Islands (UK)
15) Cuba
32) Netherlands Antilles 49) Virgin Islands (US)
16) Dominica
33) Nicaragua
17) Dominican Republic
34) Panama
#? 45
Please select one of the following time zone regions.
1) Eastern Time
2) Eastern Time - Michigan - most locations
3) Eastern Time - Kentucky - Louisville area
4) Eastern Time - Kentucky - Wayne County
5) Eastern Standard Time - Indiana - most locations
6) Eastern Standard Time - Indiana - Crawford County
7) Eastern Standard Time - Indiana - Starke County
8) Eastern Standard Time - Indiana - Switzerland County
9) Central Time
10) Central Time - Michigan - Wisconsin border
11) Central Time - North Dakota - Oliver County
12) Mountain Time
13) Mountain Time - south Idaho & east Oregon
14) Mountain Time - Navajo
15) Mountain Standard Time - Arizona
16) Pacific Time
17) Alaska Time
18) Alaska Time - Alaska panhandle
19) Alaska Time - Alaska panhandle neck
20) Alaska Time - west Alaska
21) Aleutian Islands
22) Hawaii
#? 16
The following information has been given:
United States
Pacific Time
Therefore TZ='America/Los_Angeles' will be used.
Is the above information OK?
1) Yes
2) No
#? 1
cue-10-0-0(config)#
Related Commands
Command
Description
ntp server
Specifies the NTP server for Cisco Unity Express.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
147
Command Reference
continue
continue
To return the Cisco Unity Express system to online mode after a backup procedure, use the continue
command in Cisco Unity Express EXEC mode.
continue
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command returns the Cisco Unity Express system to the previous online mode after a backup
procedure. The system begins processing new calls and voice messages.
Examples
The following example illustrates the use of continue in the backup procedure:
se-10-0-0-0# offline
se-10-0-0-0# backup category data
se-10-0-0-0# continue
Related Commands
Command
Description
backup
Identifies the data to be backed up.
offline
Terminates all active calls and prevents new calls from connecting to the
Cisco Unity Express application.
reload
Restarts the Cisco Unity Express system.
restore
Identifies the file to be restored.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
148
Cisco Unity Express Release 1.1.2
Command Reference
copy ftp
copy ftp
To copy the network FTP server information to another destination, use the copy ftp command in
Cisco Unity Express EXEC mode.
copy ftp: {running-config | startup-config} userid:password@ftp-server-address/directory
filename
Syntax Description
running-config
Destination location for the copy procedure is the active configuration in
flash memory.
startup-config
Destination location for the copy procedure is the startup configuration in
flash memory.
userid:password@
User ID and password for the FTP server. Include the colon (:) and the at
sign (@) in your entry.
ftp-server-address
IP address of the FTP server.
/directory
(Optional) Directory name for retrieving the file. If you use it, precede the
name with the forward slash (/).
filename
Name of the source file to be copied.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Copying the FTP server information to the start-up configuration overwrites the startup configuration.
Cisco Unity Express displays a warning that asks you to confirm the overwrite.
The userid:password value is not necessary if your system is configured with anonymous FTP. However,
you must enter a user ID and password if the remote host requires them.
If you do not specify a directory value, the software uses the default FTP directory.
The copy ftp command is an interactive command and prompts you for the necessary information. You
cannot enter the parameters in one command line.
Examples
The following example shows copying the FTP server data in the default directory file start to the
running configuration:
se-10-0-0-0# copy ftp: running-config
Address or name or remote host? admin:[email protected]
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
149
Command Reference
copy ftp
Source filename? start
In this example, the file start in the FTP server to directory is copied to the startup configuration:.
se-10-0-0-0# copy ftp: startup-config
!!!WARNING!!! This operation will overwrite your startup configuration.
Do you wish to continue[y]? y
Address or name or remote host? admin:[email protected]/configs
Source filename? start
Related Commands
Command
Description
copy running-config
Copies the running configuration to another location.
copy startup-config
Copies the startup configuration to another location.
erase startup-config
Deletes configuration data.
write
Copies the running configuration to the startup configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
150
Cisco Unity Express Release 1.1.2
Command Reference
copy running-config
copy running-config
To copy the running configuration information to another destination, use the copy running-config
command in Cisco Unity Express EXEC mode.
copy running-config {ftp:userid:password@ftp-server-address/directory |
startup-config |
tftp:tftp-server-address} filename
Syntax Description
ftp:userid:password@
User ID and password for the FTP server. Include the colon (:) and the at
sign (@) in your entry.
ftp-server-address
IP address of the FTP server.
/directory
(Optional) Directory on the FTP server where the copied file will reside.
If you use it, precede the name with the forward slash (/).
startup-config
Startup configuration in flash memory.
tftp:tftp-server-address
IP address of the TFTP server.
filename
Name of the destination file that will contain the copied running
configuration.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
The userid:password value is not necessary if your system is configured with anonymous FTP. However,
you must enter a user ID and password if the remote host requires them.
If you do not specify a directory value, the software uses the default FTP directory.
When you copy to an FTP or TFTP server, the copy running-config command becomes interactive and
prompts you for the necessary information. You cannot enter the parameters in one command line.
Examples
In this example, the running configuration is copied to the FTP server, which requires a user ID and
password and has an IP address of 172.16.231.193. The running configuration is copied to the configs
directory as file saved_start.
se-10-0-0-0# copy running-config ftp:
Address or name of remote host? admin:[email protected]/configs
Source filename? saved_start
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
151
Command Reference
copy running-config
The following example shows the running configuration copied to the startup configuration as filename
start:
se-10-0-0-0# copy running-config startup-config start
The following example shows the running configuration copied to the TFTP server as filename
temp_start:
se-10-0-0-0# copy running-config tftp:
Address or name of remote host? 172.16.231.190
Source filename? temp_start
Related Commands
Command
Description
copy ftp
Copies network FTP data to another destination.
copy startup-config
Copies the startup configuration to another location.
copy tftp
Copies the TFTP data to another location.
erase startup-config
Deletes configuration data.
write
Copies the running configuration to the startup configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
152
Cisco Unity Express Release 1.1.2
Command Reference
copy startup-config
copy startup-config
To copy the startup configuration information to another destination, use the copy startup-config
command in Cisco Unity Express EXEC mode.
a.
Syntax Description
copy startup-config {ftp:userid:password@ftp-server-address/directory |
tftp: tftp-server-address} filename
ftp:userid:password@
User ID and password for the FTP server. Include the colon (:) and the at
sign (@) in your entry.
ftp-server-address
IP address of the FTP server.
/directory
(Optional) Directory on the FTP server where the copied file will reside. If
you use it, precede the name with the forward slash (/).
tftp:tftp-server-address IP address of the TFTP server.
filename
Name of the destination file that will contain the copied running
configuration.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
The userid:password value is not necessary if your system is configured with anonymous FTP. However,
you must enter a user ID and password if the remote host requires them.
If you do not specify a directory value, the software uses the default FTP directory.
The copy startup-config command is an interactive command and prompts you for the necessary
information. You cannot enter the parameters in one command line.
Examples
In this example, the startup configuration is copied to the FTP server, which requires a user ID and
password to transfer files. The IP address of the FTP server is 172.16.231.193. The startup configuration
file is saved on the FTP server with filename start.
se-10-0-0-0# copy startup-config ftp:
Address or name of remote host? admin:[email protected]
Source filename? start
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
153
Command Reference
copy startup-config
The following example shows the startup configuration copied to the TFTP server, which does not
require a user ID and password. The IP address of the TFTP server is 172.16.231.190. The startup
configuration is saved in directory configs as filename temp_start.
se-10-0-0-0# copy startup-config tftp:
Address or name of remote host? 172.16.231.190/configs
Source filename? temp_start
Related Commands
Command
Description
copy ftp
Copies network FTP data to another location.
copy running-config
Copies the running configuration to another location.
copy tftp
Copies the TFTP data to another location.
erase startup-config
Deletes configuration data.
write
Copies the running configuration to the startup configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
154
Cisco Unity Express Release 1.1.2
Command Reference
copy tftp
copy tftp
To copy the network TFTP server information to another destination, use the copy tftp command in
Cisco Unity Express EXEC mode.
copy tftp: {running-config | startup-config} tftp-server-address/directory filename
Syntax Description
running-config
Destination location for the copy procedure is the active configuration in
flash memory.
startup-config
Destination location for the copy procedure is the startup configuration in
flash memory.
tftp-server-address
IP address of the TFTP server.
/directory
(Optional) Directory on the TFTP server where the copied file will reside.
If you use it, precede the name with the forward slash (/).
filename
Name of the source file to be copied.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Copying the TFTP server information to the startup configuration overwrites the startup configuration.
Cisco Unity Express displays a warning that asks you to confirm the overwrite.
If you do not specify a directory value, the software uses the default TFTP directory.
The copy tftp command is an interactive command and prompts you for the necessary information. You
cannot enter the parameters in one command line.
Examples
The following example shows a TFTP server with the IP address 10.3.61.16. The TFTP server data in
the default directory file start is copied to the running configuration.
se-10-0-0-0# copy tftp: running-config
Address or name of remote host? 10.3.61.16
Source filename? start
In this example, the TFTP server has the IP address 10.3.61.16. The file start in directory configs on the
TFTP server is copied to the startup configuration.
se-10-0-0-0# copy tftp: startup-config
!!!WARNING!!! This operation will overwrite your startup configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
155
Command Reference
copy tftp
Do you wish to continue[y]? y
Address or name of remote host? 10.3.61.16/configs
Source filename? start
Related Commands
Command
Description
copy ftp
Copies network FTP server information to another location.
copy running-config
Copies the running configuration to another location.
copy startup-config
Copies the startup configuration to another location.
erase startup-config
Deletes configuration data.
write
Copies the running configuration to the startup configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
156
Cisco Unity Express Release 1.1.2
Command Reference
default
default
To reset a configuration parameter to its factory-set value, use the default command in CCN
configuration application mode, CCN configuration engine mode, or CCN configuration trigger mode.
default parameter
Syntax Description
parameter
Command Modes
CCN configuration application mode
CCN configuration engine mode
CCN configuration trigger mode
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
The name of the variable to be reset.
The default command sets a Cisco Communication Network (CCN) configuration parameter back to its
factory value.
The parameters that can be reset depends on where the default command is used. See the ccn
application, ccn engine, and ccn trigger commands for lists of available parameters.
Examples
The following examples reset the specified parameters to their factory values:
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn application voicemail
se-10-0-0-0(config-application)# default maxsessions
se-10-0-0-0(config-application)# end
se-10-0-0-0(config)# exit
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn engine
se-10-0-0-0(config-engine)# default maxsteps
se-10-0-0-0(config-engine)# end
se-10-0-0-0(config)# exit
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn trigger sip phonenumber 6700
se-10-0-0-0(config-trigger)# default idletimeout
se-10-0-0-0(config-trigger)# default maxsessions
se-10-0-0-0(config-trigger)# end
se-10-0-0-0(config)# exit
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
157
Command Reference
default
Related Commands
Command
Description
ccn application
Configures the CCN applications, such as voice mail and auto attendant.
ccn engine
Configures the parameters used by all CCN applications
ccn trigger
Configures CCN trigger values for the applications.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
158
Cisco Unity Express Release 1.1.2
Command Reference
erase startup-config
erase startup-config
To erase the startup configuration, use the erase command in Cisco Unity Express EXEC mode.
erase startup-config
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command deletes the startup configuration.
Examples
The following example deletes the startup configuration from flash memory:
se-10-0-0-0# erase startup-config
Related Commands
Command
Description
write
Copies the running configuration to the startup configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
159
Command Reference
groupname
groupname
To configure a Cisco Unity Express group, use the groupname command in either Cisco Unity Express
EXEC mode or configuration mode.
EXEC Mode
groupname name [create | delete | description “description” | fullname display “fullname”]
Configuration Mode
groupname name [member username | owner ownername | phonenumber phonenumber |
phonenumberE164 fullnumber | privilege privilege-id]
Syntax Description
name
The name of the group.
create
(Optional) Creates a user with no other information.
delete
(Optional) Deletes the user.
description “description”
(Optional) Specifies a description of the group. The description
must be enclosed in double quotes (“”).
fullname display “fullname”
(Optional) Specifies a long name of the group as it should appear
on other telephone displays. The name must be entered in double
quotes (“”).
member username
(Optional) Associates an existing user as a member of this group.
If the username value does not exist, this command will create it
with no other information.
owner username
(Optional) Specifies the user who owns this group.
phonenumber phonenumber
(Optional) Associates an extension or number for this group.
phonenumberE164 fullnumber
(Optional) Associates a full telephone number with area code
with this group.
privilege privilege-id
(Optional) Specifies the administrative privilege level for the
group.
Command Modes
Cisco Unity Express EXEC
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
160
Cisco Unity Express Release 1.1.2
Command Reference
groupname
Usage Guidelines
The EXEC version of the command stores the permitted information in Cisco Unity Express flash
memory. If a problem with the disk occurs, this information is available so that the group members may
access the group’s voice mailbox.
The configuration version of the command is stored in the Cisco Unity Express system configuration
file. If a power outage or a system shutdown occurs, the group information can be retrieved.
Members assigned to the group take on the administrative privilege level of the group.
Examples
The following example creates a group Sales with two members and one owner:
se-10-0-0-0> enable
se-10-0-0-0# groupname sales fullname display “Sales New York”
se-10-0-0-0# groupname sales description “Sales group in New York branch”
se-10-0-0-0# config t
se-10-0-0-0(config)# groupname sales phonenumber 50175
se-10-0-0-0(config)# groupname sales phonenumberE164 12225550175
se-10-0-0-0(config)# groupname sales member user4
se-10-0-0-0(config)# groupname sales member user5
se-10-0-0-0(config)# groupname sales owner user6
se-10-0-0-0(config)# groupname sales privilege PromptManage
se-10-0-0-0(config)# exit
Related Commands
Command
Description
show group detail groupname
Displays the configuration details for a specific group.
show groups
Displays a list of configured group names.
show privilege detail
Displays the details for a specific privilege level.
show privileges
Displays all privileges installed on the system.
show users
Displays a list of configured user names.
username
Configures a Cisco Unity Express user.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
161
Command Reference
hostname
hostname
To configure the hostname for the Cisco Unity Express applications, use the hostname command in
Cisco Unity Express configuration mode. To delete the hostname, use the no form of this command.
hostname hostname
no hostname hostname
Syntax Description
hostname
Defaults
IP address of the Cisco Unity Express module
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Name of the host system. Do not include the domain name.
The hostname value identifies the Cisco Unity Express module. The default value is the IP address of
the module.
The Cisco Unity Express uses the hostname value in the module prompt.
Examples
The following example changes the hostname of the module with IP address 10.0.0.0 to mybranch and
then restores the default hostname:
se-10-0-0-0# hostname mybranch
se-mybranch# no hostname mybranch
se-10-0-0-0#
Related Commands
Command
Description
ip domain-name
Specifies the DNS domain name.
ip name-server
Specifies the DNS server name.
ntp server
Specifies the NTP clocking server.
show hosts
Displays all configured hosts.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
162
Cisco Unity Express Release 1.1.2
Command Reference
ip domain-name
ip domain-name
To configure the domain name server (DNS) domain name, use the ip domain-name command in Cisco
Unity Express configuration mode. To delete the domain name, use the no form of this command.
ip domain-name dns-server-name
no ip domain-name
Syntax Description
dns-server-name
Defaults
No domain name is configured.
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Specifies the domain name for the DNS server.
Usage Guidelines
Use this command with the ip name-server command to configure the DNS server.
Examples
The following example changes the domain name to mycompany.com:
se-10-0-0-0# config t
se-10-0-0-0(config)# ip domain-name mycompany.com
Related Commands
Command
Description
hostname
Specifies the server that stores the Cisco Unity Express applications.
ip name-server
Specifies the DNS server.
ntp server
Specifies the NTP clocking server.
show hosts
Displays all configured hosts.
show ip route
Displays IP route destinations, gates, and masks.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
163
Command Reference
ip name-server
ip name-server
To configure the domain name server (DNS) server name, use the ip name-server command in Cisco
Unity Express configuration mode. To delete the name server, use the no form of this command.
ip name-server ip_address [ip_address] [ip_address] [ip_address]
no ip name-server ip_address
Syntax Description
ip_address
Defaults
No name server is configured.
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
IP address of the DNS server.
Usage Guidelines
Use this command with the ip domain-name command to configure the DNS server.
Examples
The following example changes the IP name server to 10.3.61.16:
se-10-0-0-0# config t
se-10-0-0-0(config)# ip name-server 10.1.61.16
Related Commands
Command
Description
hostname
Specifies the server that stores the Cisco Unity Express applications.
ip domain-name
Specifies the DNS domain name.
ntp server
Specifies the NTP clocking server.
show hosts
Displays all configured hosts.
show ip route
Displays IP route destinations, gates, and masks.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
164
Cisco Unity Express Release 1.1.2
Command Reference
log server
log server
To configure an external server for saving log messages, use the log server command in Cisco Unity
Express configuration mode. To delete the log server, use the no form of this command.
log server address {hostname | ip-address}
no log server address {hostname | ip-address}
Syntax Description
hostname
Hostname of the external log server.
ip-address
IP address of the external log server.
Defaults
No external log server is configured. The local hard disk is used for saving log messages.
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
An external log server contains a copy of the messages.log file that is stored on the hard disk of the router
that contains the Cisco Unity Express module. Copying the file to a server permits flexibility in viewing,
printing, and troubleshooting system messages.
Examples
The following example assigns 10.1.61.16 as the external log server:
se-10-0-0-0# config t
se-10-0-0-0(config)# log server address 10.1.61.16
se-10-0-0-0(config)# exit
Related Commands
Command
Description
hostname
Specifies the server that stores the Cisco Unity Express applications.
ip domain-name
Specifies the DNS domain name.
ntp server
Specifies the NTP clocking server.
show hosts
Displays all configured hosts.
show running-config
Displays the log server as part of the configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
165
Command Reference
log trace
log trace
To display persistent storage on the AIM flash memory, use the log trace command in
Cisco Unity Express EXEC mode. To turn off the trace function, use the no form of this command.
log trace
no log trace
Syntax Description
This command has no arguments or keywords.
Defaults
Off
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.1
This command was introduced on the Cisco Unity Express network
module (NM), Advanced Integration Module (AIM), and in Cisco
CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Cisco Unity Express dynamically detects the persistent storage available on the AIM flash memory.
Tracing and logging are turned off by default. Issuing the log trace command turns on the trace and log
functions immediately and generates the atrace.log and messages.log files on the flash memory. These
files have a fixed 10 MB length, and logging stops when the file length is reached. New files write over
old files.
Examples
The following example illustrates the output of the log trace command:
se-10-0-0-0# log trace
Related Commands
Command
Description
show interface ide 0
Displays the amount of wear and usage of the AIM flash memory.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
166
Cisco Unity Express Release 1.1.2
Command Reference
mwi refresh
mwi refresh
To refresh the message waiting indicator (MWI) lights on one or more telephones, use the mwi refresh
command in Cisco Unity Express EXEC mode.
mwi refresh {all | telephonenumber tel_number}
Syntax Description
all
Refreshes all telephones configured on the system.
telephonenumber tel_number
Specifies the telephone number or extension to be refreshed.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Use this command to update the MWI lights when they are not in synchronization with the stored voice
messages.
Refreshing an extension that does not require it will not affect that extension.
Examples
The following example refreshes the MWIs for all telephones:
se-10-0-0-0> enable
se-10-0-0-0# mwi refresh all
The following example refreshes the MWIs for extension 50199:
se-10-0-0-0> enable
se-10-0-0-0# mwi refresh telephonenumber 50199
Related Commands
Command
Description
show groups
Displays a list of all configured groups.
show users
Displays a list of all configured users.
show voicemail
Displays the properties of the configured voice-mail system.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
167
Command Reference
ntp server
ntp server
To specify the Network Time Protocol (NTP) server to keep the system time in synchronization with the
NTP server, use the ntp server command in Cisco Unity Express configuration mode. To delete the NTP
server name, use the no form of this command.
ntp server {hostname | a.b.c.d_address} prefer
no ntp server {hostname | a.b.c.d_address}
Syntax Description
hostname
Hostname of the NTP server.
a.b.c.d_address
IP address of the NTP server.
prefer
(Optional) Marks the server as preferred.
Defaults
Cisco CallManager Express router IP address
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Use this command in conjunction with the clock timezone command to set the timing functions for
Cisco Unity Express systems and applications.
The prefer option indicates that the specified server will be chosen for synchronization from among a
set of correctly operating hosts.
Caution
Examples
The no ntp server command deletes the NTP server and the Cisco CME router IP address. Use this
command with caution as this could disrupt communication between Cisco Unity Express and
Cisco CallManager.
The following example assigns the server with address 192.168.10.0 as the NTP server:
se-10-0-0-0> enable
se-10-0-0-0# config t
se-10-0-0-0(config)# ntp server 192.168.10.0 username admin password myname
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
168
Cisco Unity Express Release 1.1.2
Command Reference
ntp server
The following example assigns the server main_ntp as the NTP server:
se-10-0-0-0> enable
se-10-0-0-0# config t
se-10-0-0-0(config)# ntp server main_ntp
Related Commands
Command
Description
clock timezone
Configures the local time zone.
show clock detail
Displays current clock statistics.
show ntp status
Displays current NTP server statistics.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
169
Command Reference
offline
offline
To enter the environment for the backup and restore procedures, use the offline command in
Cisco Unity Express EXEC mode.
offline
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Backup and restore procedures require that call activity be halted before the procedures begin. The
offline command terminates all active calls and no new calls are accepted. Consider scheduling this
procedure when call activity is at a minimum.
The offline command does not start the backup or restore procedure. Use the continue command to
return to online mode so the voice mail and auto attendant applications can receive calls and voice
messages.
Examples
The following example illustrates the use of the offline command for a backup procedure:
se-10-0-0-0>
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
se-10-0-0-0#
Related Commands
enable
show backup server
offline
backup category configuration
continue
Command
Description
backup
Selects data to back up and initiates the backup process.
continue
Exists offline mode and returns to Cisco Unity Express EXEC mode.
restore
Selects data to restore and initiates the restore process.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
170
Cisco Unity Express Release 1.1.2
Command Reference
reload
reload
To restart the Cisco Unity Express system, use the reload command in Cisco Unity Express EXEC mode.
reload
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Examples
Use this command in these situations:
•
After a shutdown command to restart the Cisco Unity Express system.
•
After a restore command to activate the uploaded file information.
The following example illustrates the use of the reload command after a restore procedure:
se-10-0-0-0# offline
se-10-0-0-0(offline)# restore id data3 category data
se-10-0-0-0(offline)# reload
Related Commands
Command
Description
backup
Backs up system and application data to a backup server.
continue
Exits offline mode and returns to Cisco Unity Express EXEC mode.
offline
Switches the Cisco Unity Express system to offline mode.
restore
Restores backup files from the backup server.
shutdown
Shuts down the Cisco Unity Express system.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
171
Command Reference
restore
restore
To restore a backed up file, use the restore command in Cisco Unity Express offline mode.
restore id backupid category {all | configuration | data}
Syntax Description
id backupid
ID number of the file to be restored.
category
Precedes the name of the file type to be restored.
all
Specifies the file to be restored contains system and application settings,
application data, and voice messages.
configuration
Specifies the file to be restored contains only system and application
settings.
data
Specifies the file to be restored contains only application data and voice
messages.
Command Modes
Cisco Unity Express offline
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
When the restore procedure begins, all active calls are terminated. In Release 1.0, 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 backupid value of the file to be restored.
Examples
The following example restored file with the ID data5 and category data.
se-10-0-0-0> enable
se-10-0-0-0# offline
se-10-0-0-0(offline)# restore id data5 category data
se-10-0-0-0(offline)# reload
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
172
Cisco Unity Express Release 1.1.2
Command Reference
restore
Related Commands
Command
Description
continue
Exits offline mode and returns to Cisco Unity Express EXEC mode.
offline
Enters offline mode.
reload
Activates the uploaded file data.
show backup history
Displays the status of backup procedures.
show backup server
Displays the network FTP server designated as the backup server.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
173
Command Reference
show backup
show backup
To display the server used to store backup files, use the show backup command in Cisco Unity Express
EXEC mode.
show backup
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command displays the FTP server URL, the user account on the FTP server, and the number of
backup file revisions that are to be stored on the server.
Examples
The following is sample output from the show backup command:
se-10-0-0-0# show backup
Server URL:
User Account on Server:
Number of Backups to Retain:
se-10-0-0-0#
ftp://127.0.0.1/ftp
5
Table 9 describes the significant fields shown in the display.
Table 9
Related Commands
show backup Field Descriptions
Field
Description
Server URL
Name and IP address of the backup server.
User Account on Server
User ID on the backup server.
Number of Backups to Retain
Number of backup files to store before the oldest one is written
over.
Command
Description
backup
Selects the backup data and initiates the backup process.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
174
Cisco Unity Express Release 1.1.2
Command Reference
show backup history
show backup history
To display the success or failure of backup and restore procedures, use the show backup history
command in Cisco Unity Express EXEC mode.
show backup history
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command displays each backup file, its backup ID, the type of data stored in the file, and the success
or failure of the backup procedure.
Examples
The following is sample output from the show backup history command:
se-10-0-0-0# show backup history
Start Operation
Category:
Configuration
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
1
Restoreid:
-1
Description:
test backup 1
Date:
Sun Jun 13 12:23:38 PDT 1993
Result:
Failure
Reason:
Script execution failed: /bin/BR_VMConfg_backup.sh: returnvalue:1
; Server Url:ftp://10.100.10.215/CUE_backup: returnvalue:9 Unable to authenticate
#End Operation
#Start Operation
Category:
Data
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
1
Restoreid:
-1
Description:
test backup 1
Date:
Sun Jun 13 12:23:44 PDT 1993
Result:
Failure
Reason:
Script execution failed: /bin/BR_VMData_backup.sh: returnvalue:1
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
175
Command Reference
show backup history
Voicemail Backup failed; Server Url:ftp://10.100.10.215/CUE_backup: returnvalue:9
Unable to authenticate
#End Operation
#Start Operation
Category:
Configuration
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
2
Restoreid:
-1
Description:
CUE test backup
Date:
Sun Jun 13 12:32:48 PDT 1993
Result:
Success
Reason:
#End Operation
#Start Operation
Category:
Data
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Backup
Backupid:
2
Restoreid:
-1
Description:
CUE test backup
Date:
Sun Jun 13 12:32:57 PDT 1993
Result:
Success
Reason:
#End Operation
#Start Operation
Category:
Configuration
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Restore
Backupid:
2
Restoreid:
1
Description:
Date:
Sun Jun 13 12:37:52 PDT 1993
Result:
Success
Reason:
#End Operation
#Start Operation
Category:
Data
Backup Server: ftp://10.100.10.215/CUE_backup
Operation:
Restore
Backupid:
2
Restoreid:
1
Description:
Date:
Sun Jun 13 12:38:00 PDT 1993
Result:
Success
Reason:
#End Operation
Table 10 describes the significant fields shown in the display.
Table 10
show backup history Field Descriptions
Field
Description
Category
Specifies data, configuration, or all backup file.
Backup Server
Backup server location.
Operation
Type of operation performed.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
176
Cisco Unity Express Release 1.1.2
Command Reference
show backup history
Table 10
Related Commands
show backup history Field Descriptions (continued)
Field
Description
Backupid
ID number of the backup file.
Restoreid
ID to use to restore this file.
Description
Optional description of the backup procedure.
Date
Date and time (in hh:mm:ss) when the operation occurred.
Result
Indication of success or failure of the operation.
Reason
If the operation failed, this field gives the reason for the failure.
Command
Description
backup
Selects the backup data and initiates the backup process.
show backup server
Displays the backup file ID.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
177
Command Reference
show backup server
show backup server
To display the details of the most recent backup files, use the show backup server command in Cisco
Unity Express EXEC mode.
show backup server
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command displays backup files available on the backup server, the date of each backup, and the
backup file ID. For information on the success or failure of a backup procedure, see the show backup
history command.
The display shows the file’s backup ID and the type of data stored in the file.
Examples
The following is sample output for the show backup server command:
se-10-0-0-0# show backup server
Category:
Data
Details of last 5 backups
Backupid:
1
Date:
Tue Jul 22 10:55:52 PDT 2003
Description:
Backupid:
Date:
Description:
2
Tue Jul 29 18:06:33 PDT 2003
Backupid:
Date:
Description:
3
Tue Jul 29 19:10:32 PDT 2003
Category:
Configuration
Details of last 5 backups
Backupid:
1
Date:
Tue Jul 22 10:55:48 PDT 2003
Description:
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
178
Cisco Unity Express Release 1.1.2
Command Reference
show backup server
Backupid:
Date:
Description:
Backupid:
Date:
Description:
2
Tue Jul 29 18:06:27 PDT 2003
3
Tue Jul 29 19:10:29 PDT 2003
se-10-0-0-0#
Table 11 describes the significant fields shown in the display.
Table 11
Related Commands
show backup server Field Descriptions
Field
Description
Backupid
ID number of the backup file.
Category
Type of backup file.
Date
Date and time (in hh:mm:ss) when the file was backed up.
Description
Optional description of the backup file.
Command
Description
backup
Selects the backup data and initiates the backup process.
show backup history
Displays the success or failure of backup and restore procedures.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
179
Command Reference
show ccn application
show ccn application
To display the currently configured applications, use the show ccn application command in Cisco Unity
Express EXEC mode.
show ccn application
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following is sample output for the show ccn application command:
cue-10-0-0# show ccn application
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
strMWI_OFF_DN:
strMWI_ON_DN:
CallControlGroupID:
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
logoutUri:
uri:
Name:
Description:
Script:
ID number:
Enabled:
Maximum number of sessions:
MaxRetry:
operExtn:
ciscomwiapplication
ciscomwiapplication
setmwi.aef
0
yes
8
8001
8000
0
voicemail
voicemail
voicebrowser.aef
1
yes
8
http://localhost/voicemail/vxmlscripts/
mbxLogout.jsp
http://localhost/voicemail/vxmlscripts/login.vxml
autoattendant
Auto Attendant
aa.aef
2
yes
8
3
0
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
180
Cisco Unity Express Release 1.1.2
Command Reference
show ccn application
welcomePrompt:
AAWelcome.wav
Table 12 describes the significant fields shown in the display.
Table 12
Related Commands
show ccn application Field Descriptions
Field
Description
CallControlGroupID
Sequence number
Description
Description of the application.
Enabled
Active status state.
ID number
Order of configuration sequence number.
logoutUri
Location of the logout Voice XML script to execute for the
voice mail application.
Maximum number of sessions
Maximum number of concurrent calls the application can
handle.
MaxRetry
Number of times the user can respond incorrectly to submenu
options before the application disconnects the call.
Name
Name of the application.
operExtn
Extension dialed for the auto attendant operator when the caller
presses zero “0”.
Script
Application script filename.
strMWI_OFF_DN
MWI off extension.
strMWI_ON_DN
MWI on extension.
uri
Location of the login Voice XML script to execute for the voice
mail application.
welcomePrompt
Welcome prompt filename.
Command
Description
show ccn engine
Displays the application engine parameters.
show ccn scripts
Displays configured scripts.
show ccn subsystem
sip
Displays configured subsystems.
show ccn trigger
Displays configured triggers for applications.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
181
Command Reference
show ccn engine
show ccn engine
To display the configured Cisco Unity Express software engine, use the show ccn engine command in
Cisco Unity Express EXEC mode.
show ccn engine
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following is sample output for the show ccn engine command:
se-10-0-0-0# show ccn engine
Maximum number of Tasks:
Maximum number of Steps:
LDAP root basedn:
ou=CCN Apps, ou=branch123, o=cisco.com
se-10-0-0-0#
0
1000
ldap://localhost:389/ou=craCME, ou=workflows,
Table 13 describes the significant fields shown in the display.
Table 13
Related Commands
show ccn engine Field Descriptions
Fields
Descriptions
Maximum number of Tasks
Maximum number of tasks the Cisco Communication Network
(CCN) engine can process concurrently.
Maximum number of Steps
Maximum number of steps that can be executed in one script. If the
script reaches this maximum number, the script execution is halted.
Command
Description
show ccn application
Displays configured applications.
show ccn scripts
Displays configured scripts.
show ccn subsystem sip
Displays configured subsystems.
show ccn trigger
Displays configured triggers for applications.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
182
Cisco Unity Express Release 1.1.2
Command Reference
show ccn prompts
show ccn prompts
To display the configured auto attendant greeting prompt files, use the show ccn prompts command in
Cisco Unity Express EXEC mode.
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Use this command before configuring a new prompt file to verify the filenames that exist or before
deleting a prompt to verify the name of the prompt file that must be removed.
Examples
The following is sample output for the show ccn prompts command:
se-10-0-0-0# show ccn prompts
Name:
Length:
Name:
Length:
Name:
Length:
Name:
Length:
Name:
Length:
Name:
Length:
Name:
Length:
Name:
Length:
Name:
Length:
Name:
Length:
Name:
Length:
Name:
Length:
Name:
AABusyExtn.wav
20400
AABusyPhone.wav
12940
AAEnterExtn.wav
20078
AAExtnOutOfService.wav
25462
AAInvalidChoice.wav
24532
AAInvalidExtn.wav
16450
AAInvalidPhone.wav
12620
AAMainMenu.wav
80934
AAOutOfServicePhone.wav
13922
AAPhoneReach.wav
15642
AASorry.wav
32730
AAWelcome.wav
15860
enter_phone_number.wav
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
183
Command Reference
show ccn prompts
Length:
se-10-0-0-0#
11430
Table 14 describes the significant fields shown in the display.
Table 14
Related Commands
show ccn prompts Field Descriptions
Field
Description
Name
Name of the prompt file.
Length
Length in seconds of the prompt file.
Command
Description
show ccn application
Displays configured applications.
show ccn engine
Displays configured application engine parameters.
show ccn scripts
Displays configured application script files.
show ccn subsystem sip
Displays configured subsystems.
show ccn trigger
Displays configured triggers for applications.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
184
Cisco Unity Express Release 1.1.2
Command Reference
show ccn scripts
show ccn scripts
To display script filenames, use the show ccn scripts command in Cisco Unity Express EXEC mode.
show ccn scripts
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following is sample output for the show ccn scripts command:
se-10-0-0-0# show ccn scripts
Name:
Create Date:
Last Modified Date:
Length in Bytes:
setmwi.aef
Tue Apr 20 20:22:27 PDT 1993
Tue Apr 20 20:22:27 PDT 1993
21990
Name:
Create Date:
Last Modified Date:
Length in Bytes:
voicebrowser.aef
Tue Apr 20 20:22:39 PDT 1993
Tue Apr 20 20:22:39 PDT 1993
13409
Name:
Create Date:
Last Modified Date:
Length in Bytes:
aa.aef
Tue Apr 20 20:22:47 PDT 1993
Tue Apr 20 20:22:47 PDT 1993
56227
Name:
Create Date:
Last Modified Date:
Length in Bytes:
promptmgmt.aef
Tue Apr 20 20:22:59 PDT 1993
Tue Apr 20 20:22:59 PDT 1993
80781
Name:
Create Date:
Last Modified Date:
Length in Bytes:
se-10-0-0-0#
checkaltgreet.aef
Tue Apr 20 20:23:10 PDT 1993
Tue Apr 20 20:23:10 PDT 1993
8701
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
185
Command Reference
show ccn scripts
Table 15 describes the significant fields shown in the display.
Table 15
Related Commands
show ccn scripts Field Descriptions
Field
Description
Name
Name of the script file.
Description
Optional description of the script file.
Command
Description
show ccn application
Displays configured applications.
show ccn engine
Displays configured application engine parameters.
show ccn prompts
Displays configured auto attendant prompt files.
show ccn subsystem sip
Displays configured subsystems.
show ccn trigger
Displays configured triggers for applications.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
186
Cisco Unity Express Release 1.1.2
Command Reference
show ccn subsystem sip
show ccn subsystem sip
To display the configured application subsystems, use the show ccn subsystem sip command in
Cisco Unity Express EXEC mode.
show ccn subsystem sip
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following example displays the Session Initiation Protocol (SIP) gateway and SIP port number for
the Cisco Unity Express module:
se-10-0-0-0# show ccn subsystem sip
SIP Gateway:
SIP Port Number:
se-10-0-0-0#
10.100.6.9
5060
Table 16 describes the significant fields shown in the display.
Table 16
Related Commands
show ccn subsystem sip Field Descriptions
Field
Description
SIP Gateway
IP address of the SIP gateway.
SIP Port Number
SIP port number on the module.
Command
Description
show ccn application
Displays configured applications.
show ccn engine
Displays configured application engine parameters.
show ccn scripts
Displays configured scripts.
show ccn trigger
Displays configured triggers for applications.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
187
Command Reference
show ccn trigger
show ccn trigger
To display the currently configured triggers, use the show ccn trigger command in Cisco Unity Express
EXEC mode.
show ccn trigger
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Before deleting an application, use this command to display the triggers associated with the application.
All triggers for the application must be deleted. If they are not deleted, an incoming call that is
configured as a trigger will invoke the application.
Examples
The following is sample output for the show ccn trigger command:
cue-10-0-0# show ccn trigger
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
6800
SIP
voicemail
en_US
5000
yes
8
Name:
Type:
Application:
Locale:
Idle Timeout:
Enabled:
Maximum number of sessions:
cue-10-0-0#
6700
SIP
autoattendant
en_US
5000
yes
8
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
188
Cisco Unity Express Release 1.1.2
Command Reference
show ccn trigger
Table 17 describes the significant fields shown in the display.
Table 17
Related Commands
show ccn trigger Field Descriptions
Field
Description
Name
Telephone number used for the trigger.
Type
Type of trigger.
Application
Application assigned to the trigger.
Locale
Language used for the application prompts.
Idle Timeout
Number of seconds the application waits for a
user response before disconnecting the call.
Enabled
Active or inactive state of the application.
Maximum number of sessions
Number of calls the application can handle
concurrently.
Command
Description
ccn trigger
Configures triggers for an application.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
189
Command Reference
show clock detail
show clock detail
To displays clock statistics, use the show clock detail command in Cisco Unity Express EXEC mode.
show clock detail
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Cisco Unity Express uses the Network Time Protocol (NTP) server for clocking functions. Use the show
clock detail command to display the Cisco Unity Express module clock status.
Examples
The following is sample output for the show clock detail command:
se-10-0-0-0# show clock detail
19:20:33.724 PST Wed Mar 17 1993
time zone:
clock state:
delta from reference (microsec):
estimated error (microsec):
time resolution (microsec):
clock interrupt period (microsec):
time of day (sec):
time of day (microsec):
se-10-0-0-0#
America/Los_Angeles
unsync
0
175431
1
10000
732424833
760817
Table 18 describes the significant fields shown in the display.
Table 18
show clock detail Field Descriptions
Field
Description
time zone
Current time zone setting.
clock state
Synchronization state of the clock.
delta from reference (microsec)
Difference between the module clock and the
NTP reference clock.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
190
Cisco Unity Express Release 1.1.2
Command Reference
show clock detail
Table 18
Related Commands
show clock detail Field Descriptions (continued)
Field
Description
time of day (sec)
Current time of day in seconds.
time of day (microsec)
Current time of day in microseconds.
Command
Description
clock timezone
Configures the local time zone.
ntp server
Specifies the NTP server for Cisco Unity Express.
show ntp status
Displays statistics for the NTP server.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
191
Command Reference
show group detail groupname
show group detail groupname
To display the configured details for a specific group, use the show group detail groupname command
in Cisco Unity Express EXEC mode.
show group detail groupname groupname
Syntax Description
groupname
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Name of the group whose configuration details should be displayed.
Usage Guidelines
This command displays details for a group that was configured using either the Cisco Unity Express
EXEC version or Cisco Unity Express configuration version of the groupname command.
Examples
The following is sample output for the show group detail groupname command:
se-10-0-0-0# show group detail groupname sales
Full Name:
Description:
Phone:
Phone(E.164):
Language:
Owners:
Members:
se-10-0-0-0#
sales
en_US
user2 user8
Table 19 describes the significant fields shown in the display.
Table 19
show group detail groupname Field Descriptions
Field
Description
Full Name
Full name of the group.
Description
Optional description of the group.
Phone
Extension or telephone number assigned to the group.
Phone(E.164)
Complete 11-digit telephone number for the group.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
192
Cisco Unity Express Release 1.1.2
Command Reference
show group detail groupname
Table 19
Related Commands
show group detail groupname Field Descriptions (continued)
Field
Description
Language
Language used by the group for system prompts.
Owners
User ID of the group owner.
Members
User IDs of any members assigned to the group.
Command
Description
groupname
Configures a Cisco Unity Express group.
show groups
Displays a list of group names.
show users
Displays a list of user names.
username
Configures a Cisco Unity Express user.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
193
Command Reference
show groups
show groups
To display a list of configured groups, use the show groups command in Cisco Unity Express EXEC
mode.
show groups
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command displays a list of all groups that were configured using either the Cisco Unity Express
EXEC version or Cisco Unity Express configuration version of the groupname command.
Examples
The following is sample output for the show groups command:
se-10-0-0-0# show groups
Administrators
sales
tech
policy
se-10-0-0-0#
Related Commands
Command
Description
groupname
Configures a Cisco Unity Express group.
show group detail groupname
Displays the configuration details for a specific group.
show users
Displays a list of configured users.
username
Configures a Cisco Unity Express user.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
194
Cisco Unity Express Release 1.1.2
Command Reference
show hosts
show hosts
To display information about the configured hosts, use the show hosts command in Cisco Unity Express
EXEC mode.
show hosts
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following is sample output for the show hosts command:
se-10-0-0-0# show hosts
Hostname:
Domain:
DNS Server1:
se-10-0-0-0#
se-10-100-6-10
localdomain
10.100.10.130
Table 20 describes the significant fields shown in the display.
Table 20
Related Commands
show hosts Field Descriptions
Field
Description
Hostname
Name of the Cisco Unity Express host system.
Domain
Domain name of the host.
DNS Server1
IP address of the DNS server.
Command
Description
hostname
Specifies the server that stores the Cisco Unity Express applications.
ip domain-name
Specifies the DNS domain name.
ip name-server
Specifies the DNS server.
ntp server
Specifies the NTP clocking server.
show ip route
Displays IP route configurations.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
195
Command Reference
show interface ide 0
show interface ide 0
To display the AIM usage and wear status, use the show interface ide command in Cisco Unity Express
EXEC mode.
show interface ide 0
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.1
This command was introduced on the Cisco Unity Express
network module (NM), Advanced Integration Module (AIM), and
in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Run this command periodically to check the wear status of the AIM.
Examples
The following is sample output for the show ip route command:
se-10-0-0-0# show interface ide 0
IDE hd0 is up, line protocol is up
3496 reads, 46828544 bytes
0 read errors
9409 write, 137857024 bytes
0 write errors
0.09933333333333333% worn
Table 21 describes the significant fields shown in the display.
Table 21
show interface ide 0 Field Descriptions
Field
Description
reads
Number of read actions.
bytes
Amount of data read from the flash memory module.
read errors
Number of errors that occurred during the read operations.
write
Number of write actions.
bytes
Amount of data written to the flash memory module.
write errors
Number of errors that occurred during the write operations.
worn
Extent of wear of the flash memory module.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
196
Cisco Unity Express Release 1.1.2
Command Reference
show interface ide 0
Related Commands
Command
Description
log trace
Generates logging and tracing files on the AIM flash memory.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
197
Command Reference
show ip route
show ip route
To display the IP route configurations, use the show ip route command in Cisco Unity Express EXEC
mode.
show ip route
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following is sample output for the show ip route command:
se-10-0-0-0# show ip route
DEST
10.0.6.0
172.16.0.0
0.0.0.0
se-10-0-0-0#
GATE
MASK IFACE
0.0.0.0
255.255.255.0 eth1
0.0.0.0
255.0.0.0 lo
10.0.6.9
0.0.0.0 eth1
Table 22 describes the significant fields shown in the display.
Table 22
show ip route Field Descriptions
Field
Description
DEST
IP address of the destination network.
GATE
IP address of the gateway to access the ^destination network.
MASK
Mask for the gateway IP address.
IFACE
Interface to reach the destination network.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
198
Cisco Unity Express Release 1.1.2
Command Reference
show ip route
Related Commands
Command
Description
hostname
Specifies the server that stores the Cisco Unity Express applications.
ip domain-name
Specifies the DNS domain name.
ip name-server
Specifies the DNS server.
ntp server
Specifies the NTP clocking server.
show hosts
Displays all configured hosts.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
199
Command Reference
show ntp associations
show ntp associations
To display the association identifier and status for all Network Time Protocol (NTP) servers, use the
show ntp associations command in Cisco Unity Express EXEC mode.
show ntp associations [assoc-id association-id]
Syntax Description
assoc-id association-id
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.1.2
This command was introduced on the Cisco Unity Express
network module (NM) and the Advanced Integration Module
(AIM) for both Cisco CallManager and in Cisco CallManager
Express.
(Optional) Displays detailed information about the specified
association ID.
Note
Usage Guidelines
A similar Cisco IOS command was introduced in
Cisco IOS Release 10.0.
The show ntp associations command displays the association identifier and status for all the NTP
servers configured for Cisco Unity Express but does not provide detailed information about the servers.
The show ntp associations assoc-id association-id command provides detailed information on the
status of a specified NTP server.
Use the status field to determine the configuration and status of all the NTP servers. This field consists
of 4 hexadecimal digits:
•
The first two digits specify the server configuration and how far it progressed through the clock
selection process. See Table 23.
•
The second two digits indicate the number of events and the type of the last event. See Table 24.
Table 23 shows common status codes and their meanings. The first digit specifies the configuration,
reachability, and authentication status for the specified server. The second digit records how well the
specified server passed through the clock selection algorithm.
Table 23
Status Field Code Values
Status Field Codes
Meaning
1xxx
Server has sent a peer synchronization request to the local machine but the
server is not configured locally.
7xxx
Server is a peer that is not configured locally but is reachable and using proper
authentication.
8xxx
Server is configured but not authenticated or reachable.
9xxx
Server is configured and reachable.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
200
Cisco Unity Express Release 1.1.2
Command Reference
show ntp associations
Table 23
Status Field Code Values (continued)
Status Field Codes
Meaning
Cxxx
Server is configured to use authentication but is not reachable.
Dxxx
Server is configured to use authentication and is reachable but is not using a
trusted key.
Fxxx
Server is authenticated as a trusted server and is reachable.
x0xx
Server did not pass any sanity checks and is rejected by the client. Possible
causes for this condition include the server failing to authenticate, the server
having a huge error bound (over 16 seconds), or the server existing on a higher
stratum number than the client.
x1xx
Server passed the sanity checks but was not close enough to other servers to
survive the intersection algorithm. This indicates that the server’s clock was
outside the largest possible error bounds of the other clocks, a condition that
almost certainly indicates that the server is set to the wrong time.
x2xx
Server passed the correctness checks (intersection algorithm). This value
indicates that the server is probably configured correctly.
x3xx
Server passed the candidate checks. This means the server was not discarded
because there were too many good servers (over 10).
x4xx
Server passed through the clustering algorithms without being discarded as an
outlier having too much dispersion.
x5xx
Server would be the synchronization source but is too far away. This means
that all the other clocks are either insane or too far away also.
x6xx
Server is the current synchronization source. This is the preferred server status.
x7xx to xFxx
Reserved values. These should not occur in normal usage.
Table 24 lists the event codes. The third digit indicates the number of events that have occurred since the
last time an error was returned to the console by NTP or by one of the show ntp commands. This value
does not wrap and stops incrementing at 15 (or hex F).
For a properly running server, the value should be xx1x, unless one of the show ntp commands has
queried the server since startup. In that case, the value should be xx0x. If the third digit is any other
value, check for the event causing errors.
The fourth digit in the field indicates the last event that occurred. For properly running servers, the event
should be the server becoming reachable.
Table 24
Event Field Code Values
Event Field Codes
Meaning
xxx0
Unspecified event. Either no events have occurred or some sort of special error
has occurred.
xxx1
IP error occurred reaching the server.
xxx2
Unable to authenticate a server that used to be reachable. This indicates that
the keys changed or someone is spoofing the server.
xxx3
Formerly reachable server is now unreachable.
xxx4
Formerly unreachable server is now reachable.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
201
Command Reference
show ntp associations
Table 24
Event Field Code Values (continued)
Event Field Codes
Meaning
xxx5
Server’s clock had an error.
xxx6 to xxxF
Reserved values. These should not occur in normal usage.
The flash field indicates the status of the packets while a series of 12 diagnostic tests are performed on
them. The tests are performed in a specified sequence to gain maximum information while protecting
against accidental or malicious errors.
The flash variable is set to zero as each packet is received. If any bits are set as a result of the tests, the
packet is discarded.
The tests look for the following information:
•
TEST1 through TEST3 check the packet time stamps from which the offset and delay are calculated.
If no bits are set, the packet header variables are saved.
•
TEST4 and TEST5 check access control and cryptographic authentication. If no bits are set, no
values are saved.
•
TEST6 through TEST8 check the health of the server. If no bits are set, the offset and delay relative
to the server are calculated and saved.
•
TEST9 checks the health of the association. If no bits are set, the saved variables are passed to the
clock filter and mitigation algorithm.
•
TEST10 through TEST12 check the authentication state using Autokey public-key cryptography. If
any bits are set and the association was previously marked as reachable, the packet is discarded.
Otherwise, the originate and receive time stamps are saved and processing continues.
Table 25 lists the flash bits for each test.
Table 25
Flash Field Diagnostic Bit Values
Flash Bit Values
Meaning
0x001
TEST1. Duplicate packet. The packet is at best a casual retransmission and
at worst a malicious replay.
0x002
TEST2. Bogus packet. The packet is not a reply to a message previously
sent. This can happen when the NTP daemon is restarted.
0x004
TEST3. Unsynchronized. One or more time-stamp fields are invalid. This
normally happens when the first packet from a peer is received.
0x008
TEST4. Access is denied.
0x010
TEST5. Cryptographic authentication fails.
0x020
TEST6. Server is unsynchronized. Wind up its clock first.
0x040
TEST7. Server stratum is at the maximum of 15. The server is probably
unsynchronized and its clock needs to be wound up.
0x080
TEST8. Either the root delay or the dispersion is greater than 1 second.
0x100
TEST9. Either the peer delay or the dispersion is greater than 1 second.
0x200
TEST10. Autokey protocol has detected an authentication failure.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
202
Cisco Unity Express Release 1.1.2
Command Reference
show ntp associations
Table 25
Examples
Flash Field Diagnostic Bit Values (continued)
Flash Bit Values
Meaning
0x400
TEST11. Autokey protocol has not verified the server, or the peer is
proventic and has valid key credentials.
0x800
TEST12. Protocol or configuration error has occurred in the public key
algorithm, or a possible intrusion event has been detected.
The following is sample output for the show ntp associations command:
se-10-0-0-0# show ntp associations
ind assID status conf reach auth condition last_event cnt
===========================================================
1 37773 9624
yes
yes none sys.peer
reachable 2
Table 26 describes the significant fields shown in the display.
Table 26
show ntp associations Field Descriptions
Field
Description
ind
Index number of the association.
assID
Peer identifier returned by the server.
status
Hexadecimal value of the server status. See Table 23 and Table 24
for a description of these field codes.
conf
Indicates whether the server is configured or not. Valid values are
yes and no.
reach
Indicates whether the peer is reachable or not. Valid values are yes
and no.
auth
Status of the server authentication. Valid values are:
condition
•
ok
•
bad
•
none
•
“”
Type of association in the clock selection process. Valid values are:
•
space—Reject: Peer is discarded as unreachable.
•
falsetick—Peer is discarded as a false tick.
•
excess—Peer is discarded as not among the 10 closest peers.
•
outlier—Peer is discarded as an outlier.
•
candidate—Peer selected for possible synchronization.
•
selected—Almost synchronized to this peer.
•
sys.peer—Synchronized to this peer.
•
pps.peer—Synchronized to this peer on the basis of a
pulse-per-second signal.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
203
Command Reference
show ntp associations
Table 26
show ntp associations Field Descriptions (continued)
Field
Description
last_event
Last event that occurred in the system. Valid values are:
•
(empty)
•
IP error
•
Auth fail
•
lost reach
•
reachable
•
clock expt
See Table 24 for descriptions of these values.
cnt
Number of events that occurred since the last time an error was
returned to the console by NTP. This value does not wrap and stops
incrementing at 15 (or hex F). For a properly functioning server,
this value should be 1 or 0.
The following is sample output for the show ntp associations assoc-id command:
se-10-0-0-0# show ntp associations assoc-id 37773
status=9624 reach, conf, sel_sys.peer, 2 events, event_reach,
srcadr=1.100.10.65, srcport=123, dstadr=1.100.5.2, dstport=123, leap=00,
stratum=8, precision=-18, rootdelay=0.000, rootdispersion=0.031,
refid=127.127.7.1, reach=377, unreach=0, hmode=3, pmode=4, hpoll=10,
ppoll=10, flash=00 ok, keyid=0, offset=-1.139, delay=0.430,
dispersion=14.821, jitter=0.158,
reftime=af4a3bee.f4749337 Thu, Mar 11 1993 14:30:06.954,
org=af4a3bf8.3f18b455 Thu, Mar 11 1993 14:30:16.246,
rec=af4a3bf8.3f71758e Thu, Mar 11 1993 14:30:16.247,
xmt=af4a3bf8.3f545c78 Thu, Mar 11 1993 14:30:16.247,
filtdelay=
0.43
0.63
0.58
0.58
0.48
0.34
0.54
0.45,
filtoffset=
-1.14
-0.98
-0.96
-0.90
-0.90
-0.79
-0.47
-0.45,
filtdisp=
0.01
15.40
30.79
46.14
61.48
76.83
92.19
99.90
Table 27 describes the significant fields shown in the display.
Table 27
show ntp associations assoc-id Field Descriptions
Field
Description
status
Status of the peer. See Table 23, Table 24, and Table 26 for
descriptions of the values in this line.
srcadr
IP address of the host server.
srcport
Port address of the host server.
dstadr
IP address of the destination server.
dstport
Port address of the destination server.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
204
Cisco Unity Express Release 1.1.2
Command Reference
show ntp associations
Table 27
show ntp associations assoc-id Field Descriptions (continued)
Field
Description
leap
Two-bit code warning of an impending leap second to be inserted in
the NTP timescale. Valid values are:
stratum
•
00—No warning
•
01—Last minute has 61 seconds
•
10—Last minute has 59 seconds
•
11—Alarm condition (clock not synchronized)
Server hop count to the primary clock source. Valid values are:
•
0—Unspecified
•
1—Primary clock reference
•
2–255—Secondary reference via NTP
If the stratum value is 15, the server is probably unsynchronized and
its clock needs to be reset.
precision
Precision of the clock, in seconds to the power of two.
rootdelay
Total round trip delay, in seconds, to the primary reference source
at the root of the synchronization subnet.
rootdispersion
Maximum error, in seconds, relative to the primary reference source
at the root of the synchronization subnet.
refid
IP address of the peer selected for synchronization.
reach
Peer reachability status history, in octal. Each bit is set to 1 if the
server is reached during a polling period and is set to 0 otherwise.
The value 377 indicates that the last 8 attempts were good.
unreach
Number of poll intervals since the last valid packet was received.
hmode
Association mode of the host server. Valid values are:
•
0—Unspecified
•
1—Symmetric active
•
2—Symmetric passive
•
3—Client
•
4—Server
•
5—Broadcast
•
6—Reserved for NTP control messages
•
7—Reserved for private use
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
205
Command Reference
show ntp associations
Table 27
show ntp associations assoc-id Field Descriptions (continued)
Field
Description
pmode
Association mode of the peer server. Valid values are:
•
0—Unspecified
•
1—Symmetric active
•
2—Symmetric passive
•
3—Client
•
4—Server
•
5—Broadcast
•
6—Reserved for NTP control messages
•
7—Reserved for private use
hpoll
Minimum interval, in seconds as a power of two, between
transmitted messages from the host.
ppoll
Minimum interval, in seconds as a power of two, between
transmitted messages to the peer.
flash
Status of the packet after a series of diagnostic tests are performed
on the packet. See the description of the flash field values in
Table 25 on page 202.
keyid
ID of cryptographic key used to generate the
message-authentication code.
offset
Time difference between the client and the server, in milliseconds.
delay
Round-trip delay of the packet, in milliseconds.
dispersion
Measure, in milliseconds, of how scattered the time offsets have
been from a given time server.
jitter
Estimated time error, in milliseconds, of the Cisco Unity Express
clock measured as an exponential average of RMS time differences.
reftime
Local time, in time-stamp format, when the local clock was last
updated. If the local clock has never been synchronized, the value
is zero.
org
Local time, in time-stamp format, at the peer when its latest NTP
message was sent. If the peer becomes unreachable, the value is
zero.
rec
Local time, in time-stamp format, when the latest NTP message
from the peer arrived. If the peer becomes unreachable, the value is
zero.
xmt
Local time, in time-stamp format, at which the NTP message
departed the sender.
filtdelay
Round-trip delay, in seconds, between the peer clock and the local
clock over the network between them.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
206
Cisco Unity Express Release 1.1.2
Command Reference
show ntp associations
Table 27
Related Commands
show ntp associations assoc-id Field Descriptions (continued)
Field
Description
filtoffset
Offset, in seconds, of the peer clock relative to the local clock.
filtdisp
Maximum error, in seconds, of the peer clock relative to the local
clock over the network between them. Only values greater than zero
are possible.
Command
Description
show ntp servers
Displays a list of NTP servers and their current states.
show ntp source
Displays the time source for an NTP server.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
207
Command Reference
show ntp servers
show ntp servers
To display a list of Network Time Protocol (NTP) servers and their current states, use the show ntp
servers command in Cisco Unity Express EXEC mode.
show ntp servers
Syntax Description
This command has no keywords or arguments.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.1.2
This command was introduced on the Cisco Unity Express
network module (NM) and Advanced Integration Module (AIM)
for both Cisco CallManager and Cisco CallManager Express.
Usage Guidelines
This command displays a list of NTP servers, their states, and a summary of the remote peers associated
with each server.
Examples
The following is sample output for the show ntp servers command:
se-10-0-0-0# show ntp servers
remote
refid
st t when poll reach
delay
offset jitter
==============================================================================
*10.100.10.65 127.127.7.1
8 u 933 1024 377
0.430
-1.139
0.158
space reject,
x falsetick,
. excess,
- outlyer
+ candidate,
# selected,
* sys.peer,
o pps.peer
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
208
Cisco Unity Express Release 1.1.2
Command Reference
show ntp servers
Table 28 describes the significant fields shown in the display.
Table 28
Related Commands
show ntp servers Field Descriptions
Field
Description
(tally code)
First characters in the display line indicate the status of the
association in the clock selection process. Valid values are:
•
space—Reject: Peer is discarded as unreachable.
•
x—Falsetick: Peer is discarded as a false tick.
•
. —Excess: Peer is discarded as not among the 10 closest peers.
•
– —Outlier: Peer is discarded as an outlier.
•
+—Candidate: Peer selected for possible synchronization.
•
#—Selected: Almost synchronized to this peer.
•
*—Sys.peer: Synchronized to this peer.
•
o—PPS.peer: Synchronized to this peer on the basis of a
pulse-per-second signal.
remote
IP address of the remote server.
refid
Server’s current time source.
st
Hop count (stratum) to the remote server.
t
Type of peer. Valid values are:
•
l—Local
•
u—Unicast
•
m—Multicast
•
b—Broadcast
when
Time when last packet was received.
poll
Polling interval, in seconds.
reach
Peer reachability status history, in octal. Each bit is set to 1 if the
server is reached during a polling period and is set to 0 otherwise.
The value 377 indicates that the last 8 attempts were good.
delay
Round-trip delay of the packet, in milliseconds.
offset
Time difference between the client and the server, in milliseconds.
jitter
Estimated time error, in milliseconds, of the Cisco Unity Express
clock measured as an exponential average of RMS time differences.
Command
Description
show ntp associations
Displays a list of association identifiers and peer statuses for an NTP server.
show ntp status
Displays the master time source for an NTP server.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
209
Command Reference
show ntp source
show ntp source
To display the time source for a Network Time Protocol (NTP) server, use the show ntp source
command in Cisco Unity Express EXEC mode.
show ntp source [detail]
Syntax Description
detail
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.1.2
This command was introduced on the Cisco Unity Express
network module (NM) and Advanced Integration Module (AIM)
for both Cisco CallManager and Cisco CallManager Express.
(Optional) Displays detailed information about the NTP servers.
Usage Guidelines
This command displays the chain of NTP servers back to their master time source, starting from the local
host.
Examples
The following is sample output for the show ntp source command:
se-10-0-0-0# show ntp source
127.0.0.1: stratum 9, offset 0.000015, synch distance 0.03047
10.100.10.65: stratum 8, offset -0.001124, synch distance 0.00003
Table 29 describes the significant fields shown in the display.
Table 29
show ntp source Field Descriptions
Field
Description
(first field)
IP address of the host.
stratum
Server hop count to the primary clock source. Valid values are:
•
0—Unspecified
•
1—Primary clock reference
•
2–255—Secondary reference via NTP
offset
Time offset between the host and the local host, in seconds.
synch distance
Host synchronization distance, which is the estimated error relative to the
primary source.
The following is sample output for the show ntp source detail command:
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
210
Cisco Unity Express Release 1.1.2
Command Reference
show ntp source
se-1-100-5-2# show ntp source detail
server 127.0.0.1, port 123
stratum 9, precision -17, leap 00
refid [1.100.10.65] delay 0.00012, dispersion 0.00000 offset 0.000011
rootdelay 0.00058, rootdispersion 0.03111, synch dist 0.03140
reference time:
af4a3ff7.926698bb Thu, Mar 11 1993 14:47:19.571
originate timestamp: af4a4041.bf991bc5 Thu, Mar 11 1993 14:48:33.748
transmit timestamp: af4a4041.bf90a782 Thu, Mar 11 1993 14:48:33.748
server 1.100.10.65, port 123
stratum 8, precision -18, leap 00
refid [127.127.7.1] delay 0.00024, dispersion 0.00000 offset -0.001130
rootdelay 0.00000, rootdispersion 0.00003, synch dist 0.00003
reference time:
af4a402e.f46eaea6 Thu, Mar 11 1993 14:48:14.954
originate timestamp: af4a4041.bf6fb4d4 Thu, Mar 11 1993 14:48:33.747
transmit timestamp: af4a4041.bfb0d51f Thu, Mar 11 1993 14:48:33.748
Table 30 describes the significant fields shown in the display.
Table 30
show ntp source detail Field Descriptions
Field
Description
server
IP address of the host server.
port
Port number of the host server.
stratum
Server hop count to the primary clock source. Valid values are:
•
0—Unspecified
•
1—Primary clock reference
•
2–255—Secondary reference via NTP
precision
Precision of the clock, in seconds to the power of two.
leap
Two-bit code warning of an impending leap second to be inserted in
the NTP time scale. Valid values are:
•
00—No warning
•
01—Last minute was 61 seconds
•
10—Last minute was 59 seconds
•
11—Alarm condition (clock not synchronized)
refid
IP address of the peer selected for synchronization.
delay
Round-trip delay of the packet, in milliseconds.
dispersion
Measure, in milliseconds, of how scattered the time offsets have
been from a given time server.
offset
Time offset between the host and the local host, in seconds.
rootdelay
Total round-trip delay, in seconds, to the primary reference source
at the root of the synchronization subnet.
rootdispersion
Maximum error, in seconds, relative to the primary reference source
at the root of the synchronization subnet.
synch dist
Host synchronization distance, which is the estimated error relative
to the primary source.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
211
Command Reference
show ntp source
Table 30
Related Commands
show ntp source detail Field Descriptions (continued)
Field
Description
reference time
Local time, in time-stamp format, when the local clock was last
updated. If the local clock has never been synchronized, the value
is zero.
originate timestamp
Local time, in time-stamp format, at the peer when its latest NTP
message was sent. If the peer becomes unreachable, the value is
zero.
transmit timestamp
Local time, in time-stamp format, when the latest NTP message
from the peer arrived. If the peer becomes unreachable, the value is
zero.
Command
Description
show ntp associations
Displays a list of association identifiers and peer statuses for an NTP server.
show ntp servers
Displays a list of NTP servers and their current states.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
212
Cisco Unity Express Release 1.1.2
Command Reference
show ntp status
show ntp status
To display statistics for the Network Time Protocol (NTP) server, use the show ntp status command in
Cisco Unity Express EXEC mode.
show ntp status
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following is sample output for the show ntp status command:
se-10-0-0-0# show ntp status
NTP reference server 1:
Status:
Time difference (secs):
Time jitter (secs):
10.100.6.9
sys.peer
3.268110005008586E8
0.17168384790420532
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
213
Command Reference
show ntp status
Table 31 describes the significant fields shown in the display.
Table 31
Related Commands
show ntp status Field Descriptions
Field
Description
NTP reference server 1
IP address of the NTP server.
Status
Status of the peer association in the clock selection process. Valid
values are:
•
Reject: Peer is discarded as unreachable.
•
Falsetick: Peer is discarded as a false tick.
•
.Excess: Peer is discarded as not among the 10 closest peers.
•
Outlier: Peer is discarded as an outlier.
•
Candidate: Peer selected for possible synchronization.
•
Selected: Almost synchronized to this peer.
•
Sys.peer: Synchronized to this peer.
•
PPS.peer: Synchronized to this peer on the basis of a
pulse-per-second signal
Time difference (secs)
Difference in seconds between the system clock and the NTP server.
Time jitter (secs)
Estimated time error, in seconds, of the Cisco Unity Express clock
measured as an exponential average of root mean square (RMS)
time differences.
Command
Description
clock timezone
Sets the local time zone.
ntp server
Specifies the NTP server for Cisco Unity Express.
show clock detail
Displays clock statistics.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
214
Cisco Unity Express Release 1.1.2
Command Reference
show privilege detail
show privilege detail
To display the description for a specific privilege ID, use the show privilege detail command in
Cisco Unity Express EXEC mode.
show privilege detail privilegeid
Syntax Description
privilegeid
Name of the privilege level to be displayed.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.1
This command was introduced on the Cisco Unity Express
network module (NM) and Advanced Integration Module (AIM),
and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
The Cisco Unity Express software recognizes two privilege levels for users: superuser and prompt
management user. An administrator, also called a superuser, has the capability, or privilege, of accessing
all the configuration and maintenance functions, including the prompt management system (PMS). The
prompt management user has access to the PMS but not to any other administrative functions.
These privilege levels are assigned to a group and any member of the group is granted the privilege
rights. The software initialization process created an Administrator group from the imported users
designated as administrators. Other groups can be created with these privileges.
Examples
The following is sample output for the show privilege detail command:
se-10-0-0-0# show privilege detail superuser
Description:
se-10-0-0-0#
Table 32 describes the significant fields shown in the display.
Table 32
Related Commands
show privilege detail Field Descriptions
Field
Description
Description
Description of the privilege ID.
Command
Description
groupname
Configures a Cisco Unity Express group.
show privileges
Displays the configured privilege levels.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
215
Command Reference
show privileges
show privileges
To display the configured privileges, use the show privilege command in Cisco Unity Express EXEC
mode.
show privileges
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.1
This command was introduced on the Cisco Unity Express
network module (NM), Advanced Integration Module (AIM), and
in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
The Cisco Unity Express software recognizes two privilege levels for users: superuser and prompt
management user. An administrator, also called a superuser, has the capability, or privilege, of accessing
all the configuration and maintenance functions, including the prompt management system (PMS). The
prompt management user has access to the PMS but not to any other administrative functions.
These privilege levels are assigned to a group and any member of the group is granted the privilege
rights. The software initialization process created an Administrator group from the imported users
designated as administrators. Other groups can be created with these privileges.
Examples
The following is sample output for the show privileges command:
se-10-0-0-0# show privilege details
System privileges
Privilegeid
superuser
ManagePrompts
se-10-0-0-0#
Description
Table 33 describes the significant fields shown in the display.
Table 33
show privileges Field Descriptions
Field
Description
Privilegeid
Name of the privilege level.
Description
Description of the privilege ID.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
216
Cisco Unity Express Release 1.1.2
Command Reference
show privileges
Related Commands
Command
Description
groupname
Configures a Cisco Unity Express group.
show privilege detail
Displays the description of the privilege ID.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
217
Command Reference
show running-config
show running-config
To display the current running configuration, use the show running-config command in Cisco Unity
Express EXEC mode.
show running-config [paged]
Syntax Description
paged
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
(Optional) Displays enough output to fill the current viewing screen.
This command displays the running configuration stored in the flash memory.
Use the paged keyword to display the output in screen-length pages.
Examples
The following is sample output for the show running-config command:
se-10-0-0-0# show running-config
Generating configuration:
! Timezone Settings
clock timezone America/Los_Angeles
! host name
hostname se-10-0-0-0
! domain name
ip domain-name localdomain
! DNS Servers
ip name-server 10.100.10.130
ntp server 10.100.6.9
groupname Administrators create
groupname sales create
groupname tech create
username user1 create
username user2 create
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
218
Cisco Unity Express Release 1.1.2
Command Reference
show running-config
username
username
username
username
username
username
username
username
username
username
username
username
username
username
groupname
groupname
groupname
groupname
user3
user4
user5
user6
user7
user8
user9
user1
user2
user4
user6
user7
user8
user9
create
create
create
create
create
create
create
phonenumber
phonenumber
phonenumber
phonenumber
phonenumber
phonenumber
phonenumber
"50140"
"50141"
"50142"
"50143"
"50144"
"50145"
"50146"
Administrators member user4
Administrators member user6
sales member user1
sales member user9
backup server url "ftp://172.16.0.1/ftp" username "" password ""
ccn application autoattendant
description "Auto Attendant"
enabled
maxsessions 8
script "aa.aef"
parameter "MaxRetry" "3"
parameter "operExtn" "0"
parameter "welcomePrompt" "AAWelcome.wav"
end application
ccn application ciscomwiapplication
description "ciscomwiapplication"
enabled
maxsessions 8
script "setmwi.aef"
parameter "strMWI_OFF_DN" "8001"
parameter "strMWI_ON_DN" "8000"
parameter "CallControlGroupID" "0"
end application
ccn application voicemail
description "voicemail"
enabled
maxsessions 8
script "voicebrowser.aef"
parameter "logoutUri" "http://localhost/voicemail/vxmlscripts/
parameter "uri" "http://localhost/voicemail/vxmlscripts/login.
end application
ccn engine
end engine
ccn subsystem sip
gateway address "10.100.6.9"
end subsystem
ccn trigger sip phonenumber 6700
application "autoattendant"
enabled
locale "en_US"
maxsessions 8
end trigger
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
219
Command Reference
show running-config
ccn trigger sip phonenumber 6800
application "voicemail"
enabled
locale "en_US"
maxsessions 8
end trigger
voicemail default mailboxsize 3000
voicemail mailbox owner "user1" size 3000
description "User 1"
end mailbox
voicemail mailbox owner "user2" size 3000
description "User 2"
end mailbox
voicemail mailbox owner "user3" size 3000
description "User 3"
end mailbox
voicemail mailbox owner "user4" size 3000
description "User 4"
end mailbox
voicemail mailbox owner "user5" size 3000
description "User 5"
end mailbox
voicemail mailbox owner "user6" size 3000
description "User 6"
end mailbox
voicemail mailbox owner "user7" size 3000
description "User 7"
end mailbox
voicemail mailbox owner "user8" size 3000
description "User 8"
end mailbox
end
se-10-0-0-0#
Related Commands
Command
Description
copy ftp
Copies network FTP server data to another location.
copy running-config
Copies the running configuration to another location.
copy startup-config
Copies the startup configuration to another location.
copy tftp
Copies network TFTP server data to another location.
erase startup-config
Deletes configuration data.
show startup-config
Displays the startup configuration.
write
Copies the running configuration to the startup configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
220
Cisco Unity Express Release 1.1.2
Command Reference
show software
show software
To display characteristics of the installed software, use the show software command in
Cisco Unity Express EXEC mode.
show software {licenses | packages | versions}
Syntax Description
licenses
Displays the terms and limits of the purchased license for the system.
packages
Displays the configured Cisco Unity Express applications packages.
versions
Displays the current versions of the configured software and applications.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express network
module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Examples
The following is sample output for the show software command:
se-10-0-0-0# show software licenses
Core:
- application mode: CME
- total usable system ports: 8
Voicemail/Auto Attendant:
- max system mailbox capacity time: 6000
- max general delivery mailboxes: 20
- max personal mailboxes: 100
Languages:
- max installed languages: unlimited
- max enabled languages: 1
se-10-0-0-0# show software packages
Installed Packages:
- Core (Integrated Voice Services - Core)
- Auto Attendant (Integrated Voice Services - Auto Attendant)
- Voice Mail (Integrated Voice Services - Voice Mail)
- Boot Loader (Service Engine Bootloader)
Installed Languages:
- US English (Integrated Services Voice Mail US English Prompts)
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
221
Command Reference
show software
se-1-100-6-10# show software versions
Installed Packages:
- Core 1.0.0.21
- Auto Attendant 1.0.0.21
- Voice Mail 1.0.0.21
- Boot Loader 1.0.5
Installed Languages:
- US English 1.0.0.21
Related Commands
Command
Description
show ccn application
Displays the configured applications.
show voicemail
Displays properties configured for the voice-mail system.
voicemail default
Configures default values for the voice mail application.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
222
Cisco Unity Express Release 1.1.2
Command Reference
show startup-config
show startup-config
To display the current startup configuration, use the show startup-config command in
Cisco Unity Express EXEC mode.
show startup-config [paged]
Syntax Description
paged
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
(Optional) Displays enough output to fill the current viewing screen.
Usage Guidelines
This command displays the startup configuration stored in flash memory.
Examples
The following is sample output for the show startup-config command:
se-10-0-0-0# show startup-config
! This adds all the platform CLI commands
!
! host name
hostname se-10-0-0-0
! domain name
ip domain-name localdomain
! DNS Servers
ip name-server 10.100.10.130
! Timezone Settings
clock timezone America/Los_Angeles
end
se-10-0-0-0#
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
223
Command Reference
show startup-config
Related Commands
Command
Description
copy ftp
Copies network FTP server data to another location.
copy running-config
Copies the running configuration to another location.
copy startup-config
Copies the startup configuration to another location.
copy tftp
Copies network TFTP server data to another location.
erase startup-config
Deletes configuration data.
show running-config
Displays the running configuration.
write
Copies the running configuration to the startup configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
224
Cisco Unity Express Release 1.1.2
Command Reference
show user detail username
show user detail username
To display the configured details for a specific user, use the show user detail username command in
Cisco Unity Express EXEC mode.
show user detail username username
Syntax Description
username
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Name of user whose configuration details should be displayed.
Usage Guidelines
This command displays users who were configured using either the Cisco Unity Express EXEC version
or Cisco Unity Express configuration version of the username command.
Examples
The following is sample output for the show user detail username command.
se-10-0-0-0# show user detail username user1
Full Name:
First Name:
Last Name:
Nickname:
Phone:
Phone(E.164):
Language:
se-10-0-0-0#
User 1
user1
user1
50140
en_US
Table 34 describes the significant fields shown in the display.
Table 34
show user detail username Field Descriptions
Field
Description
Full Name
Full name of the user.
First Name
First name of the user.
Last Name
Last name of the user.
Nickname
Optional nickname of the user.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
225
Command Reference
show user detail username
Table 34
Related Commands
show user detail username Field Descriptions (continued)
Field
Description
Phone
Extension or telephone number assigned to the user.
Phone(E.164)
11-digit telephone number assigned to the user.
Language
Language used for prompts for this user.
Command
Description
show users
Displays a list of user names.
username
Configures a Cisco Unity Express user.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
226
Cisco Unity Express Release 1.1.2
Command Reference
show users
show users
To display a list of configured users, use the show users command in Cisco Unity Express EXEC mode.
show users
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command displays a list of all users who were configured using either the Cisco Unity Express
EXEC version or Cisco Unity Express configuration version of the username command.
Examples
The following example lists the users configured in the voice-mail system:
se-10-0-0-0# show users
user1
user2
user3
user4
user5
user6
user7
user8
user9
se-10-0-0-0#
Related Commands
Command
Description
show user detail username
Displays the configuration details for a specific user.
username
Configures a Cisco Unity Express user.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
227
Command Reference
show version
show version
To display the versions of the Cisco Unity Express hardware components, use the show version
command in Cisco Unity Express EXEC mode.
show version
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
The compact flash version was added to the display.
Usage Guidelines
This command displays a list of the installed Cisco Unity Express hardware components with their
versions and serial numbers.
Examples
The following example lists the hardware components for a Cisco Unity Express system:
se-10-0-0-0# show version
CPU Model:
CPU Speed (MHz):
CPU Cache (KByte):
Chassis Type:
Chassis Serial:
Module Type:
Module Serial:
CF info:
Related Commands
Pentium III (Coppermine)
498.677
256
C3745
JMX0633L3RW
NM
JAB0552066P
HITACHI_DK23DA-20
Command
Description
show software
Displays the version numbers of the installed Cisco Unity Express
software components.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
228
Cisco Unity Express Release 1.1.2
Command Reference
show voicemail
show voicemail
To display the properties of the voice-mail system, use the show voicemail command in
Cisco Unity Express EXEC mode.
show voicemail {detail {mailbox | user} name | limits | mailboxes [idle number-of-days] | usage
| users}
Syntax Description
detail {mailbox | user} name
Displays the details for a general delivery mailbox or a user with the
name value. For a general delivery mailbox, user the owner’s name,
not the name of the group.
limits
Displays default values for all mailboxes.
mailboxes
Displays all configured mailboxes and their current storage status.
idle number-of-days
Displays all configured mailboxes that have been inactive for at
least the specified number of days.
usage
Displays how much of the voice-mail system’s capacity has been
used or configured.
users
Lists all the local voice-mail users.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3). The idle
parameter was added.
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
If the user specified with the name value has a personal mailbox and is the owner of a general delivery
mailbox, the show voicemail detail mailbox command displays the detail for all the user’s mailboxes.
Examples
The following is sample output for the show voicemail command:
se-1-100-6-10# show voicemail detail mailbox tech
Owner:
Type:
Description:
Busy state:
Enabled:
Mailbox Size (seconds):
Message Size (seconds):
Play Tutorial:
/sw/local/groups/tech
General Delivery
idle
enabled
3000
60
true
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
229
Command Reference
show voicemail
Space Used (seconds):
Total Message Count:
New Message Count:
Saved Message Count:
Expiration (days):
Greeting:
0
0
0
0
30
standard
se-10-0-0-0# show voicemail detail mailbox user1
Owner:
Type:
Description:
Busy state:
Enabled:
Mailbox Size (seconds):
Message Size (seconds):
Play Tutorial:
Space Used (seconds):
Total Message Count:
New Message Count:
Saved Message Count:
Expiration (days):
Greeting:
/sw/local/users/user1
Personal
user1
idle
enabled
3000
60
true
0
0
0
0
30
standard
Table 35 describes the significant fields shown in the display.
Table 35
show voicemail detail mailbox Field Descriptions
Field
Description
Owner
Path name of the mailbox space. For a general delivery
mailbox, this is not the name of the group owner.
Type
Type of mailbox (general or personal).
Description
Optional description of the mailbox.
Busy state
Current activity state of the mailbox.
Enabled
Indicates whether the mailbox is available to received calls.
Mailbox Size (seconds)
Configured size in seconds of the mailbox.
Message Size (seconds)
Permitted maximum message storage size in seconds.
Play Tutorial
Indication whether the voice-mail tutorial plays on the user’s
first entry into the mailbox.
Space Used (seconds)
Number of seconds used for currently stored messages.
Total Message Count
Number of all stored messages in the mailbox.
New Message Count
Number of new messages in the mailbox.
Saved Message Count
Number of saved messages in the mailbox.
Expiration (days)
Maximum number of days messages can be stored in the
mailbox.
Greeting
Type of active greeting (standard or alternate).
The following is sample output for the show voicemail limits command:
se-10-0-0-0# show voicemail limits
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
230
Cisco Unity Express Release 1.1.2
Command Reference
show voicemail
Default Mailbox Size (seconds):
Default Caller Message Size (seconds):
Maximum Recording Size (seconds):
Default Message Age (days):
System Capacity (minutes):
Default Prompt Language:
Operator Telephone:
se-10-0-0-0#
3000
60
900
30
6000
en_US
6700
Table 36 describes the significant fields shown in the display.
Table 36
show voicemail limits Field Descriptions
Field
Description
Default Mailbox Size (seconds)
Configured size in seconds of any new mailbox.
Default Caller Message Size (seconds)
Permitted maximum message storage size in seconds in
any new mailbox.
Maximum Recording Size (seconds)
Maximum length in seconds of a user’s outgoing greeting.
Default Message Age (days)
Maximum number of days messages can be stored in any
new mailbox.
System Capacity (minutes)
Maximum storage minutes for all messages and greetings
in the system.
Default Prompt Language
Language used for voice-mail prompts.
Operator Telephone
Extension or telephone number for the voice-mail
operator.
The following is sample output for the show voicemail mailboxes command:
se-10-0-0-0# show voicemail mailboxes
OWNER
"user1"
"user2"
"user3"
"user4"
"user5"
"user6"
"user7"
"user8"
"user9"
MSGS NEW
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
SAVED
0
0
0
0
0
0
0
0
0
MSGTIME MBXSIZE
0
3000
0
3000
0
3000
0
3000
0
3000
0
3000
0
3000
0
3000
0
3000
USED
0 %
0 %
0 %
0 %
0 %
0 %
0 %
0 %
0 %
Table 37 describes the significant fields shown in the display.
Table 37
show voicemail mailboxes Field Descriptions
Field
Description
OWNER
User who has a configured mailbox. Other users may be configured on the
system, but only those with mailboxes appear on this list.
MSGS
Total number of messages currently in the owner’s mailbox.
NEW
Number of new messages in the owner’s mailbox.
SAVED
Number of saved messages in the owner’s mailbox.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
231
Command Reference
show voicemail
Table 37
show voicemail mailboxes Field Descriptions (continued)
Field
Description
MSGTIME
Total number of seconds used for messages in the owner’s mailbox.
MBXSIZE
Size in seconds of the owner’s mailbox.
USED
Number of seconds used by the owner for messages.
The following is sample output for the show voicemail mailboxes idle command:
se-10-0-0-0# show voicemail mailboxes idle 7
OWNER
IDLE MSGS
"user1"
11
0
"user2"
11
0
"user3"
11
0
"user4"
11
0
"user5"
11
0
MSGTIME
0
0
0
0
0
MBXSIZE
3000
3000
3000
3000
3000
Table 38 describes the significant fields shown in the display.
Table 38
show voicemail mailboxes idle Field Descriptions
Field
Description
OWNER
User ID of the mailbox owner.
IDLE
Number of days the mailbox has been idle.
MSGS
Number of messages stored in the mailbox.
MSGTIME
Number of minutes of messages currently stored in the mailbox
MAXSIZE
Maximum number of storage minutes for the mailbox.
The following is sample output for the show voicemail usage command:
se-10-0-0-0# show voicemail usage
personal mailboxes:
general delivery mailboxes:
orphaned mailboxes:
capacity of voicemail (minutes):
allocated capacity (minutes):
message time used (seconds):
message count:
average message length (seconds):
greeting time used (seconds):
greeting count:
average greeting length (seconds):
total time used (seconds):
total time used (minutes):
percentage used time (%):
8
0
0
6000
400.0
0
0
0.0
0
0
0.0
0
0.0
0
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
232
Cisco Unity Express Release 1.1.2
Command Reference
show voicemail
Table 39 describes the significant fields shown in the display.
Table 39
show voicemail usage Field Descriptions
Field
Description
personal mailboxes
Number of configured personal mailboxes.
general delivery mailboxes
Number of configured general delivery mailboxes.
orphaned mailboxes
Number of orphaned mailboxes.
capacity of voicemail (minutes)
Maximum number of storage minutes for the voice-mail
system.
allocated capacity (minutes)
Number of storage minutes allocated for the voice-mail
system.
message time used (seconds)
Number of seconds currently used for all messages.
message count
Number of messages currently stored in all mailboxes.
average message length (seconds)
Average length in seconds of all voice messages.
greeting time used (seconds)
Number of seconds used for all mailbox greetings.
greeting count
Number of recorded greetings.
average greeting length (seconds)
Average length in seconds of all greetings.
total time used (seconds)
Total seconds used for all messages and greetings.
total time used (minutes)
Total minutes used for all messages and greetings.
percentage used time (%)
Percentage of total minutes used compared to the
allocated capacity.
The following is sample output for the show voicemail users command:
se-10-0-0-0# show voicemail users
"user1,/sw/local/users"
"user2,/sw/local/users"
"user3,/sw/local/users"
"user4,/sw/local/users"
"user5,/sw/local/users"
“user6,/sw/local/users"
"user7,/sw/local/users"
"user8,/sw/local/users"
"user9,/sw/local/users"
se-10-0-0-0#
Related Commands
Command
Description
voicemail mailbox
owner
Configures a mailbox for a user or group.
voicemail mailbox
unlock
Unlocks a mailbox.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
233
Command Reference
shutdown
shutdown
To turn off the Cisco Unity Express system, use the shutdown command in Cisco Unity Express EXEC
mode.
shutdown
Caution
Always do a shutdown of the module before power cycling the router to prevent file corruption and data
loss.
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Use this command before installing new hardware or software or before removing existing hardware or
software.
Related Commands
Command
Description
reload
Starts the Cisco Unity Express system.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
234
Cisco Unity Express Release 1.1.2
Command Reference
username
username
To configure a Cisco Unity Express user, use the username command in either Cisco Unity Express
EXEC mode or configuration mode.
EXEC Mode
username name [create | delete |
fullname [first ‘first” | last “lastname” | display “fullname”] | group groupname |
language | password password | pin number]
Configuration Mode
username name [password “password” | phonenumber phonenumber |
phonenumberE164 fullnumber | pin number]
Syntax Description
Defaults
name
Specifies the name of the user to be created.
create
(Optional) Creates a user with no other information.
delete
(Optional) Deletes the user.
fullname first “first”
(Optional) First name of the user. The name must be entered in
double quotes (“ ”).
fullname last “lastname”
(Optional) Last name of the user. The name must be entered in
double quotes (“ ”).
fullname display “fullname”
(Optional) Name as the user wants it to appear on other telephone
displays. The name must be entered in double quotes (“ ”).
group groupname
(Optional) Group with which this user is associated. If the
groupname value does not exist, this command creates it.
language
(Optional) In Release 1.0, only the default U.S. English is
available.
password password
(Optional) Password for the user. The password must be entered
in double quotes (“ ”). Valid values contain at least 3 but not more
than 32 characters in length. Spaces are not allowed. Acceptable
password characters are lowercase letters a to z, uppercase letters
A to Z, digits 0 to 9, and the following symbols: - , . + = _ ! @ #
$^*()?/~<>&%
phonenumber phonenumber
(Optional) Extension or number for this user.
phonenumberE164 fullnumber
(Optional) Full telephone number, including area code, for the
user.
pin number
(Optional) PIN for the user. Valid values are at least 3 but not
more than 19 characters in length, consisting of letters and
numbers. No other characters are permitted.
language: U.S. English
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
235
Command Reference
username
Command Modes
Cisco Unity Express EXEC
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
The EXEC version of the command stores the permitted information in Cisco Unity Express flash
memory. If a problem with the disk occurs, this information is available so that the user may access the
voice-mail system.
The configuration version of the command is stored in the Cisco Unity Express system configuration
file. In a power outage or a system shutdown occurs, the user information can be retrieved.
Examples
The following example creates a user user1, assigns her as a member to the sales group, and assigns the
extension 2004, a password, and a PIN.
se-10-0-0-0# username user1 fullname display “User 1”
se-10-0-0-0# username user1 group Sales
se-10-0-0-0# username user1 password “sales123”
se-10-0-0-0# username user1 pin 4122
se-10-0-0-0# config t
se-10-0-0-0(config)# username user1 phonenumber 50188
se-10-0-0-0(config)# username user1 phonenumberE164 12225550188
se-10-0-0-0(config)# end
se-10-0-0-0# show user detail username user1
Full Name:
User 1
First Name:
Last Name:
user1
Nickname:
user1
Phone:
50188
Phone(E.164):
12225550188
Language:
en_US
se-10-0-0-0#
Related Commands
Command
Description
show groups
Displays the configured groups.
show user detail username
Displays details for a specific user.
show users
Displays a list of all user names.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
236
Cisco Unity Express Release 1.1.2
Command Reference
voicemail capacity time
voicemail capacity time
To specify the maximum storage space for all recorded messages and greetings, use the
voicemail capacity time command in Cisco Unity Express configuration mode.
voicemail capacity time minutes
Syntax Description
minutes
Defaults
Licensed storage time
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Total storage time in minutes for all recorded messages and greetings in the
voice-mail system.
Usage Guidelines
This command sets the maximum storage time for all recorded voice mail messages and greetings. The
maximum value permitted is determined by the capacity of your Cisco Unity Express module.
Examples
The following example sets the total capacity for all recorded voice mail messages and greetings to
100 hours (6000 minutes):
se-10-0-0-0# config t
se-10-0-0-0(config)# voicemail capacity time 6000
Related Commands
Command
Description
voicemail default
Displays the properties of a configured mailbox.
voicemail operator telephone
Configures a mailbox.
voicemail recording time
Configures the maximum recording time for any message or
greeting in the voice-mail system.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
237
Command Reference
voicemail default
voicemail default
To assign default values for all new mailboxes, use the voicemail defaults command in
Cisco Unity Express configuration mode.
voicemail default {expiration days | language | mailboxsize mailboxsize_seconds |
messagesize messagesize_seconds}
Syntax Description
expiration days
Sets the number of days a message can be stored in a mailbox
before the voice-mail system deletes it.
language
Specifies the language used for voice-mail prompts. In
Release 1.0, only U.S. English is available.
mailboxsize mailboxsize_seconds
Sets the maximum number of seconds for storing messages in a
mailbox.
messagesize messagesize_seconds
Sets the maximum number of seconds for a caller’s message
stored in a mailbox.
Defaults
language: U.S. English
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command assigns default values for new individual and general delivery mailboxes. These values
can be configured later to other values for specific users or mailboxes.
Examples
The following example sets the default values for new mailboxes:
se-10-0-0-0> enable
se-10-0-0-0# config t
se-10-0-0-0(config)# voicemail default expiration 30
se-10-0-0-0(config)# voicemail default mailboxsize 360
se-10-0-0-0(config)# voicemail default messagesize 90
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
238
Cisco Unity Express Release 1.1.2
Command Reference
voicemail default
Related Commands
Command
Description
voicemail capacity time
Configures the maximum storage capacity for the voice-mail
system.
voicemail operator telephone
Configures a mailbox.
voicemail recording time
Configures the maximum recording time for any message or
greeting in the voice-mail system.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
239
Command Reference
voicemail mailbox owner
voicemail mailbox owner
To create a mailbox for a user or a group, use the voice mailbox owner command in Cisco Unity Express
configuration mode.
voicemail mailbox owner name [size seconds]
Mailbox configuration mode:
default
description “text”
disable
expiration time
greeting [alternate | standard]
mailboxsize mailboxsize_seconds
messagesize messagesize_seconds
no parameter
tutorial [disabled | enabled]
zerooutnumber “number”
Syntax Description
name
Name of the mailbox owner.
size seconds
Storage size of the mailbox in seconds. This is the same value
as mailboxsize.
default
Sets mailbox parameters to the system default values.
description “text”
Specifies a text description of the mailbox. The text must be
enclosed in double quotes (“ ”).
disable
Deactivates the mailbox so no members can access the voice
messages.
expiration time
Specifies the length of time in days that messages can be
stored in the mailbox.
greeting [alternate | standard]
Specifies which greeting a caller hears when reaching the
mailbox.
mailboxsize mailboxsize_seconds
Specifies the storage size of the mailbox in seconds. This is
the same value as for the size keyword.
messagesize messagesize_seconds
Specifies the maximum length in seconds of a message that
can be stored in the mailbox.
no parameter
Deletes the configuration of a specific parameter value.
tutorial [disabled | enabled]
Specifies whether the tutorial should be played. The default
is enabled.
zerooutnumber “number”
Specifies the extension where a caller is routed when a caller
presses “0’ to reach an operator after being transferred to a
subscriber’s mailbox.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
240
Cisco Unity Express Release 1.1.2
Command Reference
voicemail mailbox owner
Defaults
expiration: system-wide value
mailbox size: system-wide value
message size: system-wide value
tutorial: enabled
zerooutnumber: no extension number is configured
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
This command initiates the mailbox configuration mode for mailbox subcommands.
If the name value refers to a user, this command creates a personal mailbox. If the name value refers to
a group, the command creates a general delivery mailbox that several users and other groups can access.
The users and groups must be configured before assigning them to a mailbox. If you have not created
the user or group, see “Adding and Modifying a User” on page 66 or “Adding and Modifying a Group”
on page 71 for the procedures.
The mailbox owner records a standard greeting and an alternate, if needed, from the telephone user
interface (TUI). If the mailbox owner has not recorded any greetings for the mailbox,
Cisco Unity Express uses a default greeting.
The mailboxsize_seconds and messagesize_seconds values depend on the number of mailboxes to be
created and the storage capacity of the voice-mail system. Some mailboxes may need to be larger than
others to accommodate more or longer messages. For example, a customer service department may need
a larger mailbox to accommodate messages from customers. Consider the purpose of the mailbox when
assigning its size and message length.
Using the zerooutnumber sub-command, on a per-user basis you can configure either an extension (like
the operator's extension or a colleague/backup), or to any PSTN number (like a cell phone.
The sequence in which the parameters are configured is optional.
Examples
The following example shows a mailbox created for a user:
se-10-0-0-0#config t
se-10-0-0-0(config)# voicemail mailbox owner user7
se-10-0-0-0(config-mailbox)# description “User 7’s mailbox”
se-10-0-0-0(config-mailbox)# greeting standard
se-10-0-0-0(config-mailbox)# mailboxsize 360
se-10-0-0-0(config-mailbox)# messagesize 150
se-10-0-0-0(config-mailbox)# expiration 21
se-10-0-0-0(config-mailbox)# no tutorial
se-10-0-0-0(config-mailbox)# zerooutnumber “2100”
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
241
Command Reference
voicemail mailbox owner
se-10-0-0-0(config-mailbox)# exit
se-10-0-0-0(config)#
Related Commands
Command
Description
groupname
Configures a Cisco Unity Express group.
show voicemail
Displays the properties of a voice mailbox.
username
Configures a Cisco Unity Express user.
voicemail default
Configures system-wide default voice mailbox values.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
242
Cisco Unity Express Release 1.1.2
Command Reference
voicemail mailbox unlock
voicemail mailbox unlock
To unlock a voice mailbox, use the voice mailbox unlock command in Cisco Unity Express EXEC
mode.
voicemail mailbox unlock {owner name | telephonenumber tel_number}
Syntax Description
owner name
Name of the mailbox owner. For a general delivery mailbox, this
must be the owner’s name, not a group member’s name.
telephonenumber tel_number
Telephone number assigned to the mailbox.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Examples
When a mailbox becomes locked, the owner hears a message stating that the mailbox is unavailable.
The following example unlocks an individual mailbox:
se-10-0-0-0> enable
se-10-0-0-0# voicemail mailbox unlock owner user3
The following example unlocks a general delivery mailbox:
se-10-0-0-0> enable
se-10-0-0-0# voicemail mailbox unlock owner sales
The following example unlocks a mailbox using the extension number:
se-10-0-0-0> enable
se-10-0-0-0# voicemail mailbox unlock telephonenumber 50122
Related Commands
Command
Description
show voicemail
Displays the properties of a configured mailbox.
voicemail mailbox owner
Configures a mailbox.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
243
Command Reference
voicemail operator telephone
voicemail operator telephone
To assign an extension as the voice-mail operator, use the voicemail operator telephone command in
Cisco Unity Express configuration mode.
voicemail operator telephone tel_number
Syntax Description
tel_number
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Extension of the voice-mail operator.
A mailbox owner dials this extension while in the voice-mail system to reach the voice-mail operator.
Do not assign this extension to a group.
This operator extension need not be the same as the auto attendant operator extension. If they are the
same, the voice-mail user who dials the operator extension while in voice mail reaches the auto attendant
menu and then presses “0” to get the operator.
Examples
The following example assigns extension 9000 as the voice-mail operator:
se-10-0-0-0# config t
se-10-0-0-0(config)# voicemail operator telephone 50175
Related Commands
Command
Description
voicemail capacity time
Configures the maximum storage capacity for the voice-mail
system.
voicemail default
Displays the properties of a configured mailbox.
voicemail recording time
Configures the maximum recording time for any message or
greeting in the voice-mail system.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
244
Cisco Unity Express Release 1.1.2
Command Reference
voicemail recording time
voicemail recording time
To specify the maximum recording length for any message or greeting, use the voicemail recording
time command in Cisco Unity Express configuration mode.
voicemail recording time minutes
Syntax Description
minutes
Command Modes
Cisco Unity Express configuration
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Maximum length in minutes for any recorded message or greeting in the
voice-mail system.
Usage Guidelines
This command sets the maximum length for any recorded voice-mail message and greeting. The
maximum value permitted is determined by the capacity of your Cisco Unity Express module.
Examples
The following example sets the maximum recording time for any message or greeting to 15 minutes:
se-10-0-0-0# config t
se-10-0-0-0(config)# voicemail recording time 15
Related Commands
Command
Description
voicemail capacity time
Configures the maximum storage capacity for the voice-mail
system.
voicemail default
Displays the properties of a configured mailbox.
voicemail operator telephone
Configures a mailbox.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
245
Command Reference
write
write
To copy the running configuration to the startup configuration, use the write command in
Cisco Unity Express EXEC mode.
write {erase | memory}
Syntax Description
erase
Erases the startup configuration.
memory
Writes the running configuration to the startup configuration.
Command Modes
Cisco Unity Express EXEC
Command History
Cisco Unity Express Release
Modification
1.0
This command was introduced on the Cisco Unity Express
network module and in Cisco CallManager Express 3.0.
1.1
This command was implemented on the Advanced Integration
Module (AIM) and in Cisco CallManager 3.3(3).
1.1.2
This command was implemented on the Cisco 2800 series and
Cisco 3800 series routers.
Usage Guidelines
Use the write or write memory command as a shortcut for the copy running-config startup-config
command.
Related Commands
Command
Description
erase startup-config
Deletes the current startup configuration.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
246
Cisco Unity Express Release 1.1.2
G L O S S A RY
C
CCN
Cisco Communication Network
CLI
Command-line interface
CME
Cisco CallManager Express
CNS
Cisco Networking Service
D
DNS
Domain Name Server
F
FRU
Field Replaceable Unit
FTP
File Transfer Protocol
G
GUI
Graphical user interface
I
ITS
Cisco IOS Telephony Services—The former name of Cisco CallManager Express.
L
LDAP
Lightweight Directory Access Protocol
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
247
M
MGCP
Media Gateway Control Protocol
MWI
Message waiting indicator
N
NM
Network Module
NTP
Network Time Protocol
O
OIR
Online insertion and removal—Feature that permits the addition, the replacement, or the removal of
cards without interrupting the system power, entering console commands, or causing other software
or interfaces to shutdown. Sometimes called hot swapping or power-on servicing.
P
PIN
Personal Identification Number
R
RTP
Real-Time Transport Protocol
S
SCCP
Skinny Client Control Protocol
SIP
Session Initiation Protocol
SRST
Survivable Remote Site Telephony
SNAP
Subnetwork Access Protocol
SNMP
Simple Network Management Protocol
T
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
248
Cisco Unity Express Release 1.1.2
TFTP
Trivial File Transfer Protocol
TUI
Telephone User’s Interface
U
UART
Universal Asynchronous Receiver/Transmitter—Integrated circuit, attached to the parallel bus of a
computer, used for serial communications. The UART translates between serial and parallel signals,
provides transmission clocking, and buffers data sent to or from the computer.
UDP
User Datagram Protocol
V
Voice Extensible Markup Language
VXML
Note
Refer to Internetworking Terms and Acronyms for terms not included in this glossary.
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
249
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
250
Cisco Unity Express Release 1.1.2
I N D EX
telephone number 47
A
active calls
uploading greeting file 52, 53
auto-provisioning 8
backup 87
restore 90
administration
CLI 5
B
backup
differences 6
active calls 87
GU and CLI 19
command 85
GUI 5
FTP server 83
administrative privilege 66, 215, 216
manual 2
Administrator, Cisco CME 6
numbering scheme 87
Administrator, Cisco Unity Express 6
offline mode 83
Administrator, web 6
parameters 85
AIM
procedure 87
BIOS 34, 37
restrictions 8, 83, 84
boot up process 34, 37
revision number 83
AIM module
backup category command 87, 130
usage 64
backup command 128
wear 64
backup history report 97
alternate welcome greeting 14
boot helper command 27, 32
application command 111
bootloader file
applications
deleting 58
downloading 29
installling 32
atrace.log file 64
broadcast messaging restrictions 7
auto attendant
bulk provisioning 2
configuring 47
deleting a greeting 52, 54
GMS 51
C
maximum retries 47
call agent 6
maximum sessions 47
capacity
operator extension 47
recording a greeting 47, 51, 53
configuring 61
ccn application command 44, 48, 63, 108, 132
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
251
Index
ccn copy command 134
contine 148
ccn copy url command 52, 53
continue 87
ccn delete command 52, 54, 138
copy ftp 93, 149
ccn engine command 106, 140
copy running-config 67, 72, 93, 151
ccn subsystem command 142
copy startup-config 92, 153
ccn subsystem sip command 42
copy tftp 94, 155
ccn trigger command 54, 111, 144
default 106, 108, 111
centralized message storage 8
description 48, 76, 108
Cisco CME
enabled
description 6
enabled command 48
Flash memory files 12
erase startup-config 159
IP path command 12
expiration 76
web administrator 13
gateway address 42
Cisco CME router 6, 15
gateway port 42
Cisco Unity Express
greeting 76
description 6
software files 29
Cisco Unity Express prompt 115
groupname 160
config mode 72
EXEC mode 72
Cisco Unity Express software website 26, 29, 30
hostname 115, 162
CiscoWorks configmaker 8
idletimeout 112
CLI
interface Service-Engine 16
administration 5
ip address 16
CLI administration 5, 19
ip domain-name 116, 163
clock timezone command 123, 146
ip name-server 116, 164
CNS/SNAP 8
IP path 12
command
ip unnumbered 16
application 111
locale 112
backup 85, 128
log trace 64
backup category 87, 130
mailbox size 76
boot helper 27, 32
maxsessions 44, 48, 54, 108, 112
ccn application 44, 48, 63, 108, 132
maxsteps 106
ccn copy 134
message size 76
ccn copy url 52, 53
mwi refresh 81, 167
ccn delete 52, 54, 138
no ccn application 58
ccn engine 106, 140
no ccn trigger 56, 58
ccn subsystem 142
no parameter 112
ccn subsystem sip 42
ntp server 118, 120, 168
ccn trigger 54, 111, 144
offline 87, 90, 170
clock timezone 123, 146
parameter 48, 63, 108
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
252
Cisco Unity Express Release 1.1.2
Index
parameters
voicemail 44
shutdown 234
software install 27, 28, 32
reload 27, 90, 171
software install package 34
restore 172
telnet 18
restore id 90
troubleshooting
script 108
log 101
service-module 16, 18
show 101
session 18
trace 101
show backup 85, 174
username 235
show backup history 87, 90, 175
config mode 67
show backup server 90, 178
EXEC mode 67
show backup server command 87
voice mailbox unlock 80
show ccn applicable 44
voicemail capacity time 62
show ccn application 48, 58, 108, 180
voicemail default 62, 238
show ccn engine 106, 182
voicemail mailbox 76
show ccn prompts 183
voicemail mailbox owner 240
show ccn scripts 44, 48, 108, 185
voicemail mailbox unlock 243
show ccn subsystem sip 42, 187
voicemail operator telephone 62, 244
show ccn trigger 54, 56, 58, 112, 188
voicemail recording time 62, 245
show clock detail 123, 188, 190
write 246
show group detail groupname 72, 192
command environment 17
show groups 72, 194
commands 99
show hosts 115, 195
commnd
show interface ide 0 64
voicemail capacity time 237
show ip route 116, 198
communication link to Cisco CME 15
show ntp associations 200
configuration 100
show ntp configuration 118, 120
running 93
show ntp servers 208
startup 92
show ntp source 210
TFTP 94
show ntp status 118, 120, 213
configuration mode
show running-config 218
backup commands 83
show software 221
definition 17
show software license 40
configurations, copying 92
show software version 39
configuring
show startup-config 223
auto attendant 47
show user detail username 67, 225
capacity 61
show users 67, 227
dial peer 13
show version 228
DNS server 116
show voicemail 76, 229
ephone-dn 13
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
253
Index
expiration date 61
default mailbox size 3, 4
greeting management system 46
default values
host name 115
system-wide 61
IP addresses 15
deleing messages 75
language 61
deleting applications 58
mailbox size 61
deleting triggers 58
message length 61
deployment
multiple triggers 111
Cisco CME 5
MWI lights 63
Cisco Unity Express 5
NTP server 118
description command 48, 76, 108
operator extension
dial peer 13
parameters
differences
operator extension 61
administration 6
recording time 61
Cisco Unity Express and Cisco CME 5
script steps 106
passwords 6, 66, 68, 69
system parameters 106
user IDs 6, 66, 68, 69
voice mail 43
configuring time zone 123
distribution lists restrictions 7
DNS server
connectivity to Cisco CME 15
resolving host name to IP address 118
console display, system messages 121
DNS server, configuring 116
continue command 87, 148
documentation
copy ftp command 93, 149
copy running-config command 67, 72, 93, 151
additional sources 9
downloading license files 26
copy startup-config command 92, 153
copy tftp command 94, 155
E
copying
configurations 92
ephone 13
copying log files, troubleshooting 100
ephone-dn 13
creating users and telephones 13
erase startup-config command 159
EXEC mode
definition 17
D
exiting Cisco Unity Express 18
data loss 25, 33
expiration command 76
databases
expiration date
synchronization 13
configuring 61
date and time restrictions 7
expired messages 75
daylight savings time 99
expiry timer 75
default command 106, 108, 111
extension
default gateway 15
group 71
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
254
Cisco Unity Express Release 1.1.2
Index
external syslog server 121
greeting command 76
greeting management system 66, 215, 216
configuring 46
F
greeting types 76
factory-set system limits 3
greetings
Fast Ethernet ports 8
deleting a file 52, 54
file
uploading 52, 53
atrace.log 64
greetings restrictions 7
messages.log 64, 121
group
definition 71
file size
messages.log 64
mailbox 71
prompt 51
owner 71
script 53
groupname command 160
config mode 72
Flash memory 93
EXEC mode 72
log and trace 64
Flash memory module
groups
extension 71
wear 64
FTP
GUI administration 5, 19
directory 30
server 26, 30
FTP configuration 93
FTP server 2
H
hard disk
replacing restrictions 8
backup and restore 83
hardware platforms 7
G
helper image 27
host name 42
G.711 ulaw 13
host name configuration 115
G711 ulaw 51
hostname command 115, 162
gateway address command 42
gateway port command 42
GDM 75
I
general delivery mailboxes 75
idletimeout 111
GMS 46, 66, 215, 216
idletimeout command 112
recording a greeting 51
initialization wizard 19
telephone numbers 46
installer file 26
graceful shutdown 12
greeting
recording alternate 14
integration
Cisco Unity Express and Cisco CME 6
interaction
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
255
Index
Cisco Unity Express and Cisco CME 6
logging off Cisco Unity Express 18
interface Service-Engine command 16
loop, voice mail 62
IP
lost data, troubleshooting 100
addressing 99
default-gateway 99
unnumbered 99
ip address command 16
IP address, Cisco Unity Express module 14
IP addressing 15
M
mailbox
zerooutnumber 76
mailbox size
IP communication link 15
configuring 61
ip domain-name command 116, 163
default 3, 4
ip name-server command 116, 164
mailbox size command 76
IP network access 2
mailboxes 75
IP path for Cisco CME 12
expiration time 76
ip unnumbered command 16
general delivery 75
greetings 76
group 71
J
limitations 75
JTAPI route point 111
message size 76
number of 3, 4
number supported 66
L
personal 75
storage size 75
language
configuring 61
storage stize 75
language restrictions 7
telephones supported 75
license
types 75
unlocking 80
SKUs 2
upgrading 25
manual backup 2
license files 26
manual restore 2
downloading 26
maximum callers 54, 111
installling 26
maximum retries
Linux software 2
Linux system access 8
locale command 112
auto attendant 47
maximum sessions 54, 111
auto attendant 47
maximum steps 106
log files
maximum users
system 2
troubleshooting 98, 100
log trace command 64
voice mail 44
maxsessions command 44, 48, 54, 108, 112
maxsteps command 106
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
256
Cisco Unity Express Release 1.1.2
Index
maxsteps parameter 106
no ccn trigger command 56, 58
members of a group
no parameter command 112
definition 71
NTP server
hostname 118
message
tutorial 76
IP address 118
message length
removing 119
configuring 61
ntp server command 118, 120, 168
message size command 76
NTP server, configuring 118
message storage
number of
mailboxes 3, 4
restrictions 8
ports 3, 4
messages
expired 75
number of concurrent administrators 7
messages.log file 64, 121
number of concurrent users 7
messages.log, file size 64
numbering scheme, backup files 87
modes
EXEC and configuration 17
module IP address 14
O
modules restrictions 8
offline command 87, 90, 170
MWI extensions 14
offline mode 87, 90
MWI lights
configuring 63
backup commands 83
OIR
off extension 63
restrictions 8
on extension 63
troubleshooting 99
refresh 63
online insertion and replacement
refreshing 81
troubleshooting 101
restrictons 8
operator extension
mwi refresh command 81, 167
auto attendant 47
configuring 61
N
network module
restrictions 8
owner of a group 71
P
shutdown 25, 33
parameter command 48, 63, 108
spare 2
parameters
network module card
backup 85
processor 2
capacity 61
software 2
expiration date 61
networking restrictions 7
language 61
no ccn application command 58
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
257
Index
mailbox size 61
refreshing MWI lights 63, 81
maxsteps 106
reload command 27, 90, 171
message length 61
removing an NTP server 119
recording time 61
reports
backup 97
system-wide
configuring 61
parameters command
voicemail 44
call history 97
CPU usage 97
mailbox 97
passwords
mailbox size 97
characters allowed 6, 66, 68, 69
memory 97
personal mailboxes 75
message status 97
pinging internal address 99
restore 97
platforms
system 2
hardware 7
system hardware 97
software 7
resolving host name to IP address 118
ports
restore
Fast Ethernet 8
active calls 90
number of 3, 4
FTP server 83
restrictions 8
manual 2
primary BIOS 34, 37
procedure 90
privilege
restrictions 8, 83, 84
administrative 66, 215, 216
prompt
selective 8
restore command 172
file size 51
restore history report 97
prompt, formation 115
restore id command 90
provisioning
restrictions
bulk 2
administrators 7
proxy server 42
auto-provisioning with CNS/SNAP 8
backup and restore 83, 84
backups 8
R
broadcast messaging 7
rebooting network module 98
centralized message storage 8
rebooting router 98
CiscoWorks configmaker 8
recording
date and time 7
distribution lists 7
GMS 51
recording a greeting 47
greetings 7
auto attendant 51, 53
language 7
Linux system access 8
recording time
configuring 61
managing with SNMP 8
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
258
Cisco Unity Express Release 1.1.2
Index
modules 8
show ccn subsystem sip command 42, 187
OIR 8
show ccn trigger command 54, 56, 58, 112, 188
replacing hard disk 8
show clock detail command 123, 188, 190
restores 8
show group detail groupname command 72, 192
selective backup 8
show groups command 72, 194
selective restore 8
show hosts command 115, 195
users 7
show interface ide 0 command 64
voice mail 7
show ip route command 116, 198
router
show ntp associations command 200
show ntp configuration command 118, 120
call agent 6
router, Cisco CME 6
show ntp servers command 208
show ntp source command 210
show ntp status command 118, 120, 213
S
show running-config command 218
saving data, troubleshooting 100
show software command 221
script
show software license command 40
show software version command 39
file size 53
script command 108
show startup-config command 223
script steps 106
show user detail username command 67, 225
secondary BIOS 34, 37
show users command 67, 227
selective backup restrictions 8
show version command 228
selective restore restrictionsbackup
show voicemail command 76, 229
shutdown command 234
selective 8
shutdown, network module 25, 33
server
SIP dial peer 13
syslog 121
service-module command 16, 18
SIP proxy server 42
service-module, troubleshooting 99
hostname 42
session command 18
ports 42
sessions 54, 111
SIP triggers 54
deleting 56
setting daylight savings time 99
severity level, system messages 121
SKUs 3, 4, 25
show backup command 85, 174
SNMP 8
show backup history command 87, 90, 175
software files 29
show backup server command 90, 178
installer 26
show ccn applicable 44
installing 33
show ccn application command 48, 58, 108, 180
license 26
show ccn engine command 106, 182
software image, upgrading 25, 29
show ccn prompts command 183
software install command 27, 28, 32
show ccn scripts command 44, 48, 108, 185
software install package command 34
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
259
Index
software platforms 7
voice mail 43
spare network modules 2
telephones supported for voice mail 75
speed of internal line 99
telnet command 18
Startup configuration 92
Telnet session 17
steps
TFTP
configuring 106
directory 30
maximum number 106
server 26, 30
storage hours 3, 4
TFTP configuration 94
superuser 66, 215, 216
time zone
synchronization of databases 13
configuring 123
syslog server 121
timeout 111
system access using IP network 2
total storage hours 3, 4
system capacities 3, 4
triggers
auto attendant 54
system limits
configuring multiple 111
factory set 3
system log files 2
deleting 56, 58
system messages
sessions 54, 111
console display 121
telephone number 54, 111
severity 121
timeout 111
system parameters
configuring 106
voice mail 54
troubleshooting
system reports 2, 97
access to GUI 98
system-wide
copying log files 100
default values 61
system-wide parameters
configuring 61
IP address 99
IP unnumbered 99
IP, default-gateway 99
log files 98
lost data 100
T
MWI lights 101
OIR 99
Table
Table 22 show ntp status Field Descriptions 203, 204, 209,
210, 211
opening a session 99
pinging internal address 99
TCP port 42
rebooting network module 98
telephone number
rebooting router 98
auto attendant 47
saving data 100
triggers 54, 111
service-module status 99
telephone numbers
speed of terminal line 99
auto attendant 47
unknown caller 101
GMS 46
user password 98
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
260
Cisco Unity Express Release 1.1.2
Index
user PIN 98
supported telephones 75
users and groups 98
telephone numbers 43
voice mail 101
telephones supported 75
TUI
recording a greeting 51
tutorial command 76
troubleshooting 101
voice mail loop 62
voice mailbox unlock command 80
voicemail
U
maximum users 44
voicemail capacity time command 62, 237
UDP port 42
voicemail default command 62, 238
uninterruptible power supply 12
voicemail mailbox command 76
unknown caller
voicemail mailbox owner command 240
troubleshooting 101
voicemail mailbox unlock command 243
unlocking a mailbox 80
voicemail operator telephone command 62, 244
upgrading
voicemail recording time command 62, 245
new license 25
software image 25, 29
upgrading the bootloader file 32
W
UPS 12
wav file 51
usage
wear
Flash memory 64
user IDs
characters allowed 6, 66, 68, 69
user password, troubleshooting 98
Flash memory 64
Web admiinistrator 6
web administrator 13
write command 246
user PIN, troubleshooting 98
username command 235
config mode 67
EXEC mode 67
Z
zerooutnumber command 76
users
adding 66
modifying 66
number supported 66
V
voice mail
configuring 43
conflicting extensions 62
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
Cisco Unity Express Release 1.1.2
261
Index
Cisco Unity Express CLI Administrator Guide for Cisco CallManager Express, Release 1.1.2
262
Cisco Unity Express Release 1.1.2