Table Of Contents
Release Notes for the Bulk Administration Tool Release 4.1(1)
Determining the Software Version
New Software Features in Release 4.1(1)
Associating New Phones and Existing Users
Associating Any Number of Existing Devices to a New User
Insert and Delete for VG200 Gateways
Insert, Update, and Delete All Ports for Catalyst 6000 24 Port FXS Gateways
Important Notes for Release 4.1(1)
Limitations and Restrictions for 4.1(1)
Excel Files Creating CSV Data Files
New Software Features in Release 4.0(1)
BAT Excel Spreadsheet for Exporting to CSV File
CTI Port, Cisco IP Phone 7910, and Cisco IP Phone 7940 Support
Tool for Auto Registration Phone Support
Important Notes for Release 4.0(1)
Excel Files Creating CSV Data Files
Updating the Dummy MAC Address
Resolved Caveats - Release 4.1(1)
Resolved Caveats - Release 3.0(3)
Open Caveats for BAT Release 4.1(1)
Obtaining Technical Assistance
Release Notes for the Bulk Administration Tool Release 4.1(1)
April 2, 2001
These release notes describe the new features and caveats for the Cisco Bulk Administration Tool (BAT) Release 4.1(1).
Use these release notes in conjunction with the Bulk Administration Tool User Guide for Release 4.1(1) document, located on Cisco Connection Online (CCO) at
http://www.cisco.com/univercd/cc/td/doc/product/voice/sw_ap_to/admin/index.htm
The latest software upgrades and release notes for Cisco CallManager 4.1(1) are available on Cisco Connection Online (CCO) at:
http://www.cisco.com/cgi-bin/tablebuild.pl/callmgr.
Contents
These release notes discuss the following topics:
•
Obtaining Technical Assistance
Introduction
The Bulk Administration Tool (BAT), a plug-in application to the Cisco CallManager, enables you to add up to 10,000 phones and users to the Cisco CallManager application. Using BAT, you can perform bulk modifications to phones and delete several phones at one time. BAT also supports bulk transactions for VG200 gateways and Catalyst 6000 FXS Ports.
System Requirements
The following specifications apply to BAT Release 4.1(1):
•
•
•
•
Determining the Software Version
If BAT Release 4.1(1) is already installed, click Details on the main BAT page to see the version number.
If BAT is not installed, right click the install executable for BAT (BulkAdministrationTool.exe); choose Properties > Version > Product Version below Item Name.
Related Documents
Refer to the following documents for more information on Cisco CallManager and related applications:
•
•
•
•
•
New and Changed Information
New Software Features in Release 4.1(1)
BAT Release 4.1(1) for Cisco CallManager 3.0 includes the following feature additions or changes:
Associating New Phones and Existing Users
BAT 4.1(1) allows administrators to associate more than one new device to an existing user in the CSV data file. To associate more than one new device to an existing user, the administrator writes the required information in separate records. For example, to associate two new devices to an existing user, the administrator writes two records in the BAT CSV data file.
Note
Associating Any Number of Existing Devices to a New User
The previous release of BAT [4.0(1)] did not allow the administrator to associate more than one existing device to a new user
BAT 4.1(1) CSV data file enables the administrator to associate more than one device to a new user.
The administrator uses this feature when inserting new users. In this release, the CSV data file includes additional fields in which the MAC addresses for existing devices are specified.
Insert and Delete for VG200 Gateways
·BAT 4.1(1) allows the administrator to create VG200 gateways and ports in bulk.
The administrator needs to create a VG200 gateway template to perform this operation.
The BAT CSV file for VG200 gateways records specific fields such as MGCP Domain Name, Description, Description for Ports, Port Directory Numbers, and Route Partitions.
Insert, Update, and Delete All Ports for Catalyst 6000 24 Port FXS Gateways
BAT 4.1(1) allows the administrator to insert and update "ports" for existing Catalyst 6000 (FXS) gateways. BAT does not automatically create Catalyst 6000 (FXS) gateways, so the administrator creates a port template for Catalyst 6000 (FXS) gateways ports (which includes "Port configuration" and "Directory Number Configuration").
The CSV file for Catalyst 6000 (FXS) gateways records specific fields such as Port index, Route partition and directory Number.
Administrators can also choose Catalyst 6000 gateways to delete port configuration. Reach "Delete All Ports" page by clicking "Delete All Ports" link on the Catalyst 6000 "configure ports" web page.
Secure TAPS
The TAPS feature provided in the BAT 4.0(1) release protects important directory numbers from being modified. Previous releases required the administrator to edit a text file TAPSSecureDN.txt to enter all the important directory numbers to be protected. BAT 4.1(1) provides an application, "Secure TAPS," which an administrator can use to specify important directory numbers to be protected.
To access "Secure TAPS," click Start > Programs > Cisco CallManager 3.0 > Bulk Admin Tool > Secure TAPS on the Cisco CallManager server.
Important Notes for Release 4.1(1)
Limitations and Restrictions for 4.1(1)
The following section provides information on the limitations and restrictions for BAT Release 4.1(1).
Netscape Navigator
The following list describes limitations users may encounter while using Netscape Navigator to view BAT 4.1(1):
•
•
•
•
•
Installation
Make sure BAT is installed only on a server running the publisher database.
CSV File Limitation
The following section contains a CSV file limitation for BAT 4.1(1).
Some fields display a CSV file as well as on Phone Template (for example Location, FwdBusy Destination, CallPickUpGroup). In such cases, the value on CSV file has higher precedence compared to one on the Template. If you leave these fields blank on CSV file, BAT uses the value on Template.
Excel Files Creating CSV Data Files
BAT provides Microsoft Excel files to fill up the data and export data to BAT Comma Separated Value (CSV) files. User can fill up data for a maximum of 6 lines (Directory Numbers) for the phone record.
•
•
•
•
Unsupported Directories
Do not use BAT 4.1(1) to add users to the Active Directory or the Netscape Directory.
New Software Features in Release 4.0(1)
BAT Release 4.0(1) for Cisco CallManager 3.0 includes the following feature additions or changes:
•
•
•
•
•
•
BAT Excel Spreadsheet for Exporting to CSV File
BAT includes a Microsoft Excel file (BAT.xls) that provides data files, templates with macros, and support for multiple phone lines and exports the values into CSV files for phones, users, and phone/user/mailbox combinations.
The CSV file for phones contains information about each phone as a record. Make sure all phones in a CSV file are the same model and should have the same number of configured lines. For example, you might create a CSV file for all the Cisco IP Phone 7960 two-line phones and another for all the Cisco IP Phone 7940 one-line phones.
User Profile Updates
The updated user profile includes the following fields and their respective default:
•
•
•
•
Also, BAT allows numbers in the LAST NAME and FIRST NAME of users.
Location
Use locations to implement call admission control in a centralized call-processing system. Call admission control allows you to regulate voice quality by limiting the amount of bandwidth available for calls over links between the locations. Location specifies the remote location accessed using restricted bandwidth connections.
Call Forward Busy Number
Call Forward Busy Number allows you to forward an incoming call to another directory number if the line is busy.
Call Pickup
Call pickup allows you to answer a call that comes in on a directory number other than your own. When you hear an incoming call ringing on another phone, you can redirect the call to your phone by using the call pickup feature.
User Interface Enhancements
You can access BAT 4.0(1) through the Cisco CallManager Administration using Internet Explorer 4.01 Service Pack 2 or later or Netscape Navigator 4.7 or higher. BAT's user interface behaves like the Cisco CallManager Administration window.
From the BATApplication menu, you can go to the Cisco CallManager Administration window.
Update Single Line Screen
BAT 4.0(1) allows you to update a single line on a directory based on a device pool and the calling search space of the device itself. You can modify each line, so that a specific partition can only use specific numbers for Call Forward Answer, Call Forward Busy, and Call Forward No Answer.
For example, you can bar a specific line from using Call Forward No Answer for calls that have toll charges attached.
CTI Port, Cisco IP Phone 7910, and Cisco IP Phone 7940 Support
The BAT 4.0(1) interface configuration screens now include CTI port, and Cisco IP Phones 7910 and 7940 options.
BAT allows you to "Enable CTI usage" for adding bulk users. On the Insert Users and Insert Phones and Users interface screens, you can check a check box to enable CTI usage in DCD.
A tab in the BAT Excel template allows you to create a CSV data file for CTIPort - Users.
Tool for Auto Registration Phone Support
The Tool for Auto Registration Phone Support (TAPS), used in conjunction with BAT, updates auto-registered phones and replaces phones with predefined device configuration.
You must install the TAPS application on an application server and the Cisco CallManager publisher, which may be the same machine.
Note
Note
Important Notes for Release 4.0(1)
Digit Field Display Changes
BAT 4.0(1) supports the entry of 1 to 30 characters in the user ID field. In this version, BAT supports telephone numbers from 1 to 50 digits in length; whereas, in previous versions of BAT, it only supported telephone numbers in 4 to 15 digits range.
CSV File Extension
For BAT 4.0(1) Release, the CSV file may be any type of file.
BAT Error Code Definitions
Code 10001—strErrMessage = "The Call Pickup Group entered does not exist."
Code 10002—strErrMessage = "Route partition for the Call Pickup Group must be a member of the Calling Search Space for that Line."
Code 10003—strErrMessage = "Load information can not be set for CTIPorts."
Code 10004—strErrMessage = "The Location entered does not exist."
Code 10011—strErrMessage = "The UserID already exists."
Code 10012—strErrMessage = "The Manager entered does not exist."
Code 10013—strErrMessage = "Couldn't create user object. Check if DC Directory is running."
User Password Default
When BAT creates the User records in DC directory, the password defaults to abcd
BAT Sessions
Caution
Limitations and Restrictions
The following sections contain the known limitations and restrictions for BAT 4.0(1).
Installation
Make sure BAT is installed only on a server running a publisher database.
CSV File Limitations
The following limitations apply to the CSV files for BAT 4.0(1):
•
•
The CallPickUpGroup(DN/Partition Name) should exist in parent tables; otherwise, BAT discards the record.
Excel Files Creating CSV Data Files
BAT provides Microsoft Excel files to complete the data and export data to BAT Comma Separated Value (CSV) files. User fill up data for a maximum of 6 lines (Directory Numbers) for the phone record.
•
•
•
•
Updating the Dummy MAC Address
When you need to change the dummy MAC address entered by BAT (which has a format BATXXXXXXXXXXXX where XXXXXXXXXXXX is a 12-character hex value) to set it for a hardware phone in the Cisco CallManager Administration page, set the Device Name as SEPYYYYYYYYYYYY where YYYYYYYYYYYY is the real MAC address of the hardware phone, and SEP signifies that it is a real phone.
After updating the MAC address, users can get their predefined device settings using TAPS for BAT. Refer to the Bulk Administration Tool Guide for Cisco CallManager for more information.
Netscape Navigator
The following list describes limitations users may encounter while using Netscape Navigator to view BAT 3.0(3).
•
•
•
•
•
Release 3.0(3)
The Bulk Administration Tool Release 3.0(3), a maintenance release, offers no new features. Refer to the "Resolved Caveats" for more information.
Resolved Caveats
Resolved Caveats - Release 4.1(1)
Table 1 lists and describes resolved caveats in the Bulk Administration Tool Release 4.1(1).
Resolved Caveats - Release 3.0(3)
Table 2 lists and describes resolved caveats in the Bulk Administration Tool Release 3.0(3).
Open Caveats
Open Caveats for BAT Release 4.1(1)
Table 3 describes possible unexpected behaviors by BAT Release 4.1(1).
Service and Support
For service and support, contact Cisco Technical Assistance Center (TAC) at
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
Obtaining Documentation
This section provides different methods of obtaining Cisco documentation.
World Wide Web
You can access the most current Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or http://www-europe.cisco.com.
Documentation CD-ROM
Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM is updated monthly. Therefore, it is probably more current than printed documentation. The CD-ROM package is available as a single unit or as an annual subscription.
Ordering Documentation
Registered CCO users can order the Documentation CD-ROM and other Cisco Product documentation through our online Subscription Services at http://www.cisco.com/cgi-bin/subcat/kaojump.cgi.
Nonregistered CCO users can order documentation through a local account representative by calling Cisco's corporate headquarters (California, USA) at 408 526-4000 or, in North America, call 800 553-NETS (6387).
Obtaining Technical Assistance
Cisco provides Cisco Connection Online (CCO) as a starting point for all technical assistance. Warranty or maintenance contract customers can use the Technical Assistance Center. All customers can submit technical feedback on Cisco documentation using the web, e-mail, a self-addressed stamped response card included in many printed docs, or by sending mail to Cisco.
Cisco.com
Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information and resources at any time, from anywhere in the world. This highly integrated Internet application is a powerful, easy-to-use tool for doing business with Cisco.
Cisco.com provides a broad range of features and services to help customers and partners streamline business processes and improve productivity. Through Cisco.com, you can find information about Cisco and our networking solutions, services, and programs. In addition, you can resolve technical issues with online technical support, download and test software packages, and order Cisco learning materials and merchandise. Valuable online skill assessment, training, and certification programs are also available.
Customers and partners can self-register on Cisco.com to obtain additional personalized information and services. Registered users can order products, check on the status of an order, access technical support, and view benefits specific to their relationships with Cisco.
To access Cisco.com, go to the following website:
http://www.cisco.com
Technical Assistance Center
The Cisco Technical Assistance Center (TAC) is available to warranty or maintenance contract customers who need technical assistance with a Cisco product that is under warranty or covered by a maintenance contract.
To display the TAC web site that includes links to technical support information and software upgrades and for requesting TAC support, use www.cisco.com/techsupport.
To contact by e-mail, use one of the following addresses:
In North America, TAC can be reached at 800 553-2447 or 408 526-7209. For other telephone numbers and TAC e-mail addresses worldwide, consult the following web site: http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml.
Documentation Feedback
If you are reading Cisco product documentation on the World Wide Web, you can submit technical comments electronically. Click Feedback in the toolbar and select Documentation. After you complete the form, click Submit to send it to Cisco.
You can e-mail your comments to bug-doc@cisco.com.
To submit your comments by mail, for your convenience many documents contain a response card behind the front cover. Otherwise, you can mail your comments to the following address:
Cisco Systems, Inc.
Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883We appreciate and value your comments.
AtmDirector, Browse with Me, CCDA, CCDE, CCDP, CCIE, CCNA, CCNP, CCSI, CD-PAC, CiscoLink, the Cisco NetWorks logo, the Cisco Powered Network logo, Cisco Systems Networking Academy, the Cisco Systems Networking Academy logo, Fast Step, Follow Me Browsing, FormShare,FrameShare, GigaStack, IGX, Internet Quotient, IP/VC, iQ Breakthrough, iQ Expertise, iQ FastTrack, the iQ Logo, iQ Net Readiness Scorecard, MGX, the Networkers logo, Packet, PIX, RateMUX, ScriptShare, SlideCast, SMARTnet, TransPath, Voice LAN, Wavelength Router, WebViewer are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, Empowering the Internet Generation, are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, Cisco, the Cisco Certified Internetwork Expert Logo, Cisco IOS, the Cisco IOS logo, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Enterprise/Solver, EtherChannel, EtherSwitch, FastHub, IOS, IP/TV, LightStream, Post-Routing, Pre-Routing, Registrar, StrataView Plus, Stratm, SwitchProbe, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. or its affiliates in the U.S. and certain other countries.
All other brands, names, or trademarks mentioned in this document or Web site 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. (0011R)
Release Notes for the Bulk Administration Tool Release 4.0(1)
Copyright © 2001, Cisco Systems, Inc.
All rights reserved.
Guest
