3com 900-0234-01 User manual

http://www.3com.com/

Part Number 900-0234-01 Rev AA

Published Decembver 2004

VCX

TM

Administration Guide

V7210 IP Call Processor

V7220 Accounting Suite

3Com Telephones and Attendant Console

VCX Call Records Utility

VCX Complementary Attendant

VCX

™

V7000 IP Telephony Solution

System Release 5.2

3Com Corporation

350 Campus Drive

Marlborough, MA

01752-3064

of this documentation may be reproduced in any form or by any means or used to

make any derivative work (such as translation, transformation, or adaptation)

without written permission from 3Com Corporation.

3Com Corporation reserves the right to revise this documentation and to make

changes in content from time to time without obligation on the part of 3Com

Corporation to provide notification of such revision or change.

3Com Corporation provides this documentation without warranty, term, or condition

of any kind, either implied or expressed, including, but not limited to, the implied

warranties, terms, or conditions of merchantability, satisfactory quality, and fitness

for a particular purpose. 3Com may make improvements or changes in the product(s)

and/or the program(s) described in this documentation at any time.

If there is any software on removable media described in this documentation, it is

furnished under a license agreement included with the product as a separate

document, in the hardcopy documentation, or on the removable media in a directory

file named LICENSE.TXT or !LICENSE.TXT. If you are unable to locate a copy, please

contact 3Com and a copy will be provided to you.

UNITED STATES GOVERNMENT LEGENDS:

If you are a United States government agency, then this documentation and the

software described herein are provided to you subject to the following:

United States Government Legend: All technical data and computer software is

commercial in nature and developed solely at private expense. Software is delivered

as Commercial Computer Software as defined in DFARS 252.227-7014 (June 1995)

or as a commercial item as defined in FAR 2.101(a) and as such is provided with only

such rights as are provided in 3Com’s standard commercial license for the Software.

Technical data is provided with limited rights only as provided in DFAR 252.227-7015

(Nov 1995) or FAR 52.227-14 (June 1987), whichever is applicable. You agree not to

remove or deface any portion of any legend provided on any licensed program or

documentation contained in, or delivered to you in conjunction with guide.

Unless otherwise indicated, 3Com registered trademarks are registered in the United

States and may or may not be registered in other countries.

3Com and the 3Com logo are registered trademarks of 3Com Corporation. VCX is a

trademark of 3Com Corporation.

Other brand and product names may be registered trademarks or trademarks of their

respective holders.

CONTENTS

ABOUT THIS GUIDE

Related Documentation 17

Your Comments 18

1 CONFIGURING THE AUTHENTICATION SERVER

Direct Phone to Gateway Dialing 19

Accessing the Authentication Server Interface 19

Configuring End Users 21

Adding End Users 21

Viewing All End Users 23

Searching for End Users 24

Editing End User Profiles 25

Cloning End Users 25

Deleting End Users 26

Configuring User Phones 27

Adding Phones 27

Deleting Phones from a User 31

Adding Phone Features 32

Editing Phone Features 35

Deleting Phone Features 37

Adding Phone Restrictions 37

Adding Anonymous Call Restrictions 39

Deleting Phone Restrictions 40

Adding Phone Registrations 40

Viewing Phone Registrations 42

Viewing Call History 43

Viewing Phone Ring Tones 45

Adding or Editing Ring Tones of Specific Phones 47

Viewing the LCD Directory 47

Configuring Media Access Control 49

Adding a MAC Address 49

4

Editing a MAC Address 50

Deleting a MAC Address 50

Configuring an Attendant Console 51

Supported Attendant Console Feature Buttons 51

Adding an Attendant Console 51

Editing Feature Mapping Buttons on an Attendant Console 53

Editing Extensions on an Attendant Console 54

Editing Attendant Console Basic Information 54

Deleting an Attendant Console 55

Attendant Console Busy Lamp Flash Descriptions 55

Configuring Patterns 55

Configuring URI Translation Patterns 57

Adding URI Translation Pattern 57

Deleting URI Translation Patterns 59

Configuring Class of Service 60

Adding a Class of Service 60

Enabling or Disabling Inbound or Outbound Calls in a Class of

Service 62

Adding or Deleting Elements from a Class of Service 62

Enabling or Disabling Trunk to Trunk Calls for a Class of Service 63

Configuring Class of Service Elements 64

Adding Class of Service Elements 64

Editing Class of Service Elements 65

Configuring Type of Service 65

Adding a Type of Service 66

Deleting Type of Services 67

Editing Type of Services 68

Configuring Emergency Services 68

Adding ERLs 69

Adding or Editing the Emergency Defaults 73

Deleting ERLs 74

Editing IP Addresses of an ERL 74

Deleting IP Addresses from an ERL 75

Editing Emergency Digits 75

Deleting Emergency Digits from an ERL 76

Editing Emergency Gateway IP Addresses from an ERL 76

Deleting Emergency Gateway IP Addresses from an ERL 77

Editing Emergency Lines to an ERL 77

5

Deleting Emergency Lines from an ERL 78

Configuring Dial Plans 79

Adding Dial Plans 79

Editing Dial Plan Names 82

Editing Dial Rules Associated with a Dial Plan 83

Deleting Dial Plans 83

Configuring Dial Rules 83

Adding Dial Rules 84

Deleting Dialing Rules 85

Configuring Call Park 85

Configuring the Server 87

Enabling VPN Translation 87

2 CONFIGURING THE DIRECTORY SERVER

Accessing the Directory Server Configurables 89

Configuring a Call Route through the Web Provisioning Server 90

Managing Patterns 91

Adding Patterns 91

Editing Patterns 91

Deleting Patterns 91

Managing Out Dial Patterns 92

Adding Out Dial Patterns 92

Editing Out Dial Patterns 93

Deleting Out Dial Patterns 94

Managing Requestors 94

Adding Requestors 94

Editing Requestors 96

Deleting Requestors 96

Managing Holidays 97

Adding Holidays 97

Editing Holidays 98

Deleting Holidays 99

Managing Week Day Bands 99

Adding Week Day Bands 99

Editing Week Day Bands 101

Deleting Week Day Bands 101

Managing Day Time Bands 102

6

Adding Day Time Bands 102

Editing Day Time Bands 103

Deleting Day Time Bands 104

Managing Calendar Bands 105

Adding Calendar Bands 105

Editing Calendar Bands 106

Deleting Calendar Bands 107

Managing End Points 108

Adding End Points 108

Editing End Points 111

Deleting End Points 111

Adding or Editing Out Dial Patterns of End Points 112

Deleting Out Dial Patterns from Existing End Points 113

Managing End Point Black Lists 114

Adding End Point Black Lists 114

Deleting End Point Black Lists 116

Managing End Point White Lists 116

Adding White Lists 116

Deleting End Point White Lists 118

Managing Routes 118

Adding Routes 118

Editing Routes 121

Deleting Routes 122

Assigning End Points and Bundles to Routes 122

Editing Priorities of Bundles or End Points Assigned to a Route 123

Unassigning End Points or Bundles Assigned to Routes 124

Assigning Out Dial Patterns for Routes 124

Unassigning Out Dial Patterns of Routes 126

Managing URI Route Maps 127

Adding URI Route Maps 127

Deleting URI Route Maps 131

Globally Editing URI Mapped Routes Source Based Routing

Properties 131

Managing URI Route Black Lists 132

Adding Black Listed End Points to URI Route Maps 132

Deleting Black Listed End Points from a URI Route Map 133

Managing URI Translation 134

Understanding Translation Algorithms 134

7

Adding Destination URI Translations 135

Globally Editing URI Translation Sourced Based Route Properties 137

Server Configuration 138

Globally Configuring Routes 138

Resetting Globally Provisioned Routes 139

3 CONFIGURING THE ACCOUNTING SERVER

Database Identification Configuration 141

Changing the Database Name 141

Changing the Database Server Name 141

Changing the Database User Name 142

Changing the Database User Password 142

Configuring the Database Keep Alive Timeout 143

Configuring the Client Activity Interval 143

Server Configuration File 143

Enterprise Management Suite 144

Configuring Client Request Threads 144

Server Configuration File 144

Enterprise Management Suite 144

Configuring the Logging Level 145

Server Configuration File 145

Enterprise Management Suite 145

Enabling Packet Tracing 146

Server Configuration File 146

Enterprise Management Suite 146

Creating Backup Configuration Files 147

Creating a CFM Backup File 147

Setting the Current Configuration as Baseline 147

Restoring Backup Configuration Files 148

Selecting the Planned CFM File 148

SNMP Support 149

Enabling SNMP Support 149

3Queue Protocol Support 149

Enabling and Disabling 3Q 149

4 CONFIGURING THE CALL PROCESSOR

Call Processor Overview 151

8

Call Processor Advantages 151

Configuration Methods 152

Through EMS 152

Through CLI 152

Configuring Call Control 152

Through EMS 152

Configuring Trusted Endpoints 153

Adding Trusted Endpoints 153

Editing Trusted Endpoints 155

Deleting Trusted Endpoints 156

Verifying Call Processor Version 157

Configuring the Back-end Server Plugins 157

Adding Primary and Secondary Accounting Servers 157

Editing Accounting Server IP Addresses 159

Removing Accounting Servers 159

Adding Primary and Secondary Authentication Servers 160

Editing Authentication Server IP Addresses 161

Removing Authentication Servers 162

Adding Primary and Secondary Directory Servers 162

Editing Directory Server IP Addresses 163

Removing Directory Servers 164

Enabling or Disabling Accounting Server 164

Enabling or Disabling Authentication Server 165

Enabling or Disabling Directory Server 165

Monitoring Call Statistics 165

5 CONFIGURING TELEPHONES

Configuring 3Com Telephones 167

3Com Telephone Local User Interface Menus 167

Assessing the Telephone LUI Menus 168

Administration Telephone Feature Keys 176

6 CONFIGURING THE COMPLEMENTARY ATTENDANT

Logging into the CAS 177

Updating Telephone Directory 178

Changing the Telephone Associated with the CAS 179

Uninstalling the CAS 180

9

7 CALL REPORTING

Call Detail Records Introduction 181

CDR Generating Components 181

Logging into the Call Report Utility 182

Updating the CDR Fields 182

Retrieving VCX CDRs Manually 182

Retrieving VCX CDRs Automatically 183

Changing the Servers Associated with the Call Report Utility 183

Uninstalling the Call Report Utility 184

Supported VCX CDR Field Descriptions 185

8 CONFIGURING THE SIP PHONE DOWNLOADER

Configuring the SIP Phone Downloader 187

Through the SipPhoneDL.xml File 187

Through Enterprise Management Suite 188

Device Mapping through EMS 190

9 MAINTAINING THE V7000 IP TELEPHONY SUITE

Overall System Maintenance 193

Upgrading a VCX System 193

Downgrading from 5.2 to 5.0 194

Verifying Software Versions 198

Clearing Cache from Tomcat 198

Stopping Tomcat 199

Rediscovering the IP Telephony Server in EMS 199

Saving the 3Com VCX IP Telephony Server Configuration in EMS 199

Restoring the 3Com VCX IP Telephony Server Configuration in

EMS 200

Changing a Daylight Savings and Timezone Configuration 200

Call Processor Maintenance 202

Starting the Call Processor 202

Restarting the Call Processor 202

Stopping the Call Processor 202

Verifying the Call Processor State 202

Back-end Server Maintenance 203

Starting the Accounting, Authentication, and Directory Servers 203

10

Stopping the Accounting, Authentication, and Directory Servers 203

Backing Up and Restoring Databases 204

Exporting Table Data 207

Importing Saved Table Data 209

Clearing the Configurable Tables 209

Running Individual Tasks on the Accounting Server 210

Monitoring Accounting Server Activity on the Accounting Server 211

Checking the Data on the Accounting Server 212

Manually Completing an Incomplete Call on the Billing Support

Server 212

Enabling Message Tracing 213

Enabling Server Logging 214

SNMP Support 214

Restarting Systems and Services in Enterprise Management Suite 215

Reserving and Unreserving the Back-end Server in EMS 216

Updating the Server State in EMS 216

Enabling Back-end Server Traps in EMS 216

A CALL PROCESSOR COMMAND LINE INTERFACE COMMANDS

Call Processor CLI Overview 221

B MANUALLY CONFIGURING THE AUTHENTICATION SERVER

Authentication File Location 223

Configuring Authentication Server Database Tables 223

Configuring bridge_map 223

Configuring bw_list 224

Configuring code_feature_type 225

Configuring cos_elm 226

Configuring cos_elm_pattern_map 226

Configuring cos_name 227

Configuring cos_name_elm_map 228

Configuring dial_plan 229

Configuring dial_plan_rule_map 229

Configuring dial_rule 230

Configuring elin 231

Configuring elin_selection_algo 231

Configuring erl 232

11

Configuring erl_direct 232

Configuring erl_elin_map 233

Configuring erl_es_number_map 233

Configuring es_contact 233

Configuring es_defaults 234

Configuring es_number 234

Configuring feature_uri_info 235

Configuring patterns 236

Configuring persons 236

Configuring person_uri_map 245

Configuring selective_ringing 245

Configuring server_configuration 246

Configuring support_profiles 246

Configuring tos_feature_map 247

Configuring tos_name 248

Configuring trans_src_dest 248

Configuring trusted_clients 249

Configuring uri_access_code 250

Configuring uri_bw_list_map 251

Configuring uri_feature_map 251

Configuring uri_sip_phone_profile 252

Configuring uri_speed_dial 254

Configuring week_days 254

C MANUALLY CONFIGURING THE DIRECTORY SERVER

Manually Configuring a Call Route by Bulk Loading 257

Configuring Load Balancing 258

Enabling and Disabling Load Balancing 258

Directory Server Database Table Descriptions 259

Configuring datetime_bands_data.txt 259

Configuring day_time_bands_data.txt 259

Configuring week_day_bands_data.txt 260

Configuring desturi_route_ep_blacklist_map_data.txt 261

Configuring desturi_route_map_data.txt 261

Configuring desturi_translation_data.txt 263

Configuring ep_blist_map_data.txt 265

Configuring ep_data.txt 265

12

Configuring ep_outdial_map_data.txt 268

Configuring ep_wlist_map_data.txt 268

Configuring global_policy_data.txt 269

Configuring global_policy_map_data.txt 269

Configuring holidays_data.txt 270

Configuring outdial_patterns_data.txt 270

Configuring patterns_data.txt 272

Configuring patterns_testcall_map_data.txt 272

Configuring requestors_data.txt 273

Configuring route_data.txt 274

Configuring route_ep_map_data.txt 275

Configuring route_ep_outdial_map_data.txt 276

Configuring trusted_clients_data.txt 276

D MANUALLY CONFIGURING THE ACCOUNTING SERVER

Configuring Accounting Server Database Tables 279

Configuring acct_server_config 280

Configuring acct_server_list 280

Configuring bss_acct_server_map 281

Configuring bss_server_list 282

Configuring job_delete_cdrs 282

Configuring job_export_cdrs 284

Configuring job_export_fields_map 286

Configuring job_uploadruntimecdr 287

Configuring upload_history 288

E MANUALLY CONFIGURING THE BILLING SUPPORT SERVER

Manually Creating Database Links 289

Manually Configuring Upload from Multiple Accounting Servers 290

Manually Configuring Oracle Jobs on an Accounting Server 292

Manually Uploading CDRs 293

Manually Running the CDR Upload 294

Manually Scheduling the CDR Upload 294

Manually Merging CDRs into Super CDRs 295

Manually Running the CDR Merge 295

Manually Scheduling the CDR Merge 296

Manually Exporting Super CDRs 297

13

Manually Populating the User Call History 297

Manually Running the Super CDR Export 298

Manually Scheduling the Super CDRs Export 298

Manually Deleting CDRs 299

Manually Running the Super CDR Delete 300

Manually Scheduling the Super CDR Delete 300

Manually Dropping a Scheduled Job 301

Manually Acquiring a Job Number 301

Manually Dropping a Job 301

Manually Resuming a Broken Job 301

Manually Acquiring a Broken Job Number 301

Manually Resuming a Job 302

Viewing the Log Files 302

Manually Configuring the Database Tables through Bulk Loading 303

Configuring bss_server_config 303

Configuring bss_server_list 304

Configuring acct_server_list 305

Configuring bss_acct_server_map 305

Configuring job_collect_cdr 306

Configuring job_delete_cdr 308

Configuring job_export_fields_map 310

Configuring job_export_supercdr 311

Configuring job_merge_cdr 312

Configuring supercdr_hold 314

F COMMON COMMANDS

Using the Database Bulk Load 315

Editing the Text Files 316

Loading Data into the Database 316

Appending Data to the Database 317

Clearing the Database 318

Back-end Server Configuration Tab Descriptions 320

Tab Location 320

3 Q Protocol Configuration 320

BES Common Configuration 321

BES Common Statistics 321

Database Configuration 322

14

Flow Control Configuration 322

Identification 323

State 323

ABOUT THIS GUIDE

This chapter contains an overview of this guide, lists guide conventions,

related documentation, and product compatibility, and describes how to

contact Customer Service.

This guide describes how to configure and maintain the following:

■ Oracle

®

database software

■ VCX Linux operating system

■ VCX

™

V7210 IP Call Processor

■ VCX

™

V7220 Accounting Suite

■ 3Com Telephones and Attendant Console

■ 3Com Call Records Utility

■ VCX Complementary Attendant

This guide is intended for operators and administrators of the system

and assumes you have a thorough understanding of

telecommunications, VoIP technology, Linux operating system, Oracle

databases, network knowledge, and system administrator privileges.

Release notes are issued with some products. If the information in the

release notes differs from the information in this guide, follow the

instructions in the release notes.

16 ABOUT THIS GUIDE

Table 1 and Table 2 list conventions that are used throughout this guide.

Table 1 Notice Icons

Icon Notice Type Description

Information note Information that describes important features or

instructions

Caution Information that alerts you to potential loss of data or

potential damage to an application, system, or device

Warning Information that alerts you to potential personal injury

Table 2 Text Conventions

Convention Description

Screen displays This typeface represents information as it appears on the

screen.

Syntax The word “syntax” means that you must evaluate the syntax

provided and then supply the appropriate values for the

placeholders that appear in angle brackets. Example:

To enable RIPIP, use the following syntax:

SETDefault !<port> -RIPIP CONTrol =

Listen

In this example, you must supply a port number for <port>.

Commands The word “command” means that you must enter the

command exactly as shown and then press Return or Enter.

Commands appear in bold. Example:

To remove the IP address, enter the following command:

SETDefault !0 -IP NETaddr = 0.0.0.0

The words “enter”

and “type”

When you see the word “enter” in this guide, you must type

something, and then press Return or Enter. Do not press

Return or Enter when an instruction simply says “type.”

Words in italics Italics are used to:

■ Emphasize a point.

■ Denote a new term at the place where it is defined in the

text.

■ Identify menu names, menu commands, and software

button names. Examples:

From the Help menu, select Contents.

Click OK.

Related Documentation 17

These 3Com documents contain additional information about the

products in this release that are a part of or support the VCX V7000 IP

Telephony Solution and the 3Com Convergence Application Suite.

The following documents are a part of the VCX V7000 IP Telephony

Solution:

■ VCX

Installation and Maintenance Guide

■ VCX Administration Guide

■ VCX Business Telephone Quick Reference Guide

■ VCX

Basic Telephone Quick Reference Guide

■ V7000 Telephone Guide

■ VCX Security Guide

The following documents are a part of the 3Com Convergence

Application Suite:

■ V7350 IP Messaging Suite Product Overview

■ V7350 IP Messaging Suite Installation Guide

■ V7350 IP Messaging - 3Com Native Interface AT - A - GLANCE

■ V7350 IP Messaging Suite User Guide - 3Com Native Interface

■ V7350 IP Messaging - Traditional Interface AT - A - GLANCE

■ V7350 IP Messaging Suite User Guide - Traditional Interface

■ V7350 IP Messaging Suite Operations and System Administration

Guide

■ 3Com E-Mail Reader Application ReadMe

■ V7350 IP Messaging Suite Intelligent Mirroring Guide

■ IP Conferencing Module Installation Guide

■ IP Conferencing Module User and Administration Guide

■ Convergence Center Client User and Administration Guide

The following documents provide information on products that support

this release:

■ Enterprise Management Suite User Guide, Version 2.0

■ VCX

V7111 Fast Track Installation Guide

18 ABOUT THIS GUIDE

■ VCX

V7111 VoIP SIP Gateways User Manual

■ VCX

V7122 Gateway Fast Track Installation Guide

■ VCX

V7122 VoIP SIP Gateways User Manual

Your Comments Your suggestions are important to us because we want to make our

documentation more useful to you.

Please send e-mail comments about this guide or any of the 3Com Voice

Products documentation and Help systems to:

[email protected]

Please include the following information with your comments:

■ Document title

■ Document part number (found on the front page)

■ Page number

■ Your name and organization (optional)

Example:

VCX Administration Guide

Part Number 900-0234-01 Rev AA

Page 25

Please address all questions regarding the 3Com software to your

authorized 3Com representative.

1

CONFIGURING THE

AUTHENTICATION SERVER

This chapter provides information on how to configure the

authentication server through the provisioning server. Use the web

provisioning server to manage rate plans, patterns, and calls plans and

to add and manage users in specific network domains. Also, use the

web provisioning server to search users based on select criteria.

View no more than 50,000 objects through the provisioning server at a

time; otherwise, it could overload the provisioning server.

Be sure to set your Web browser preferences so that the cache is updated

when ever you modify or view a new web page.

Direct Phone to

Gateway Dialing

This feature allows for remote survivability and requires no configuration.

Sites that do not have a local VCX V7000 IP Telephony Suite can still

make calls to each other as well as to the PSTN when the connection to

the remote IP Telephony Suite is lost, for instance, because of LAN issues

or a down IP Telephony Suite.

Accessing the

Authentication

Server Interface

To access the authentication server interface through the web

provisioning server:

1 From a standard web browser, log into 3Com VCX 7000 main web page,

which is usually http://<IP address of VCX 7000 server>/voipadmin.

2 Click VCX Administrator Interface and log in.

3 At the top of the main page of the web provisioning server, click Users.

The 3COM Voice Core Exchange Authentication Server main page

appears. See Figure 1.

20 CHAPTER 1: CONFIGURING THE AUTHENTICATION SERVER

Figure 1 Authentication Server Main Page

Page is loading ...

3com 900-0234-01 User manual

This manual is also suitable for

3com 900-0234-01 User manual

Related papers

Other documents