Page 2 - Copyright
ii Copyright Copyright © 2001, Cisco Systems, Inc. Guide Versions The following table matches the software versions with the guide versions: Version This manual is written to support VOCAL Version 1.3.0. Support The primary location for support, information and assistance for the VOCAL system is htt...
Page 3 - UHIDFH; Introduction
3UHIDFH Introduction This chapter is a general introduction to the System Administration manual, and provides information about the intentions and organization of the manual. It also provides information about additional resources available from http://www.vovida.org . Objectives This guide provides...
Page 4 - bold text; Note
iv Documentation Conventions The following is a list of conventions used in this guide: Additional resources PublicationsAn Installation Guide , which includes a system overview, installation instructions and information about provisioning the servers is also available from http://www.vovida.org . O...
Page 5 - Table of Contents; Preface
Table of Contents v Preface Chapter 1. Setting Up Users Working With The GUI Environment . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Adding, Viewing, Editing, and Deleting Users . . . . . . . . . . . . . . . . . . 1-9 Chapter 2. Network Management SNMP Support . . . . . . . . . . . . . . ....
Page 8 - Working With The GUI Environment; Overview; Before you begin
1-2 Working With The GUI Environment Working With The GUI Environment Overview This section describes:• the login screen and how to log into the VOCAL system • the user configuration screen and available the buttons, options boxes, and data fields. Before you begin The machine that was used to insta...
Page 9 - Logging In
Working With The GUI Environment 1-3 Logging In Introduction The Provisioning Login screen provides access for Administrators to work with the users, and for Technicians to work with the servers. Definition The login screen is a java-enabled graphical user interface (GUI) that runs in a web browser....
Page 10 - Items and Fields; Administrator
1-4 Working With The GUI Environment Items and Fields Table 1-2 describes the items found on the Login Screen. Password Administration There is a separate user interface for changing passwords and adding or removing accounts for administrators and technicians.It is not setup as an applet, but you ca...
Page 11 - Overview of the User Configuration Screen
Working With The GUI Environment 1-5 Overview of the User Configuration Screen Introduction This section describes the buttons, option boxes, and data fields on the User Configuration Screen. Screen Capture Figures 1-2 and 1-3 show the User Configuration screen as it appears when you login. Figure 1...
Page 12 - After Data Entry; Buttons; Button; Back
1-6 Working With The GUI Environment After Data Entry Figure 1-3 shows what the screen looks like after some users have been added. For more information about adding users, see “Adding New Users” on page 1-10 . Figure 1-3. User Configuration Screen: After Data Entry Buttons Table 1-4 describes butto...
Page 13 - Option Boxes; Option
Working With The GUI Environment 1-7 Option Boxes The option boxes filter the fields displayed on the User Configuration screen. If none of the boxes is selected, only the Name, User Group, IP and Marshal fields appear. If all of the boxes are selected, then all of the fields appear on the User Conf...
Page 14 - View; Delete; New
1-8 Working With The GUI Environment Right-Mouse-Click Menu Options Table 1-6 shows the options available from the right-mouse-click menu. Option Boxes If you select either Edit or New, you must select at least one option box as well. Depending on which option boxes (show aliases, show admin data, a...
Page 16 - Adding New Users; Caution
1-10 Adding, Viewing, Editing, and Deleting Users Adding New Users Introduction This section describes how to add new users. Procedure: Adding a New User To add a new user, follow these steps: Table 1-7. Adding New Users Step Action 1 Select the Show admin data option box. 2 Right-mouse click and se...
Page 17 - Adding Users: Administrator’s Edit User Screen; Edit User Screen
Adding, Viewing, Editing, and Deleting Users 1-11 Adding Users: Administrator’s Edit User Screen Edit User Screen Figure 1-5 illustrates the edit user screen that appears when the show administrator data option box is checked. Figure 1-5. Edit User Screen: Show Admin Data Name Specify the name of th...
Page 22 - Viewing Users: Individually; Using the right mouse click, select View.; Show user data. Refer to
1-16 Adding, Viewing, Editing, and Deleting Users Viewing Users: Individually Introduction This section describes how to view records for individual users. If you have thousands of users loaded into your system, you will find that it is faster to load the data for individual users, or small groups o...
Page 24 - Load all Users
1-18 Adding, Viewing, Editing, and Deleting Users Screen Capture: Viewing Small Groups of Users Figure 1-7 illustrates selecting the data for a small group of users. Figure 1-7. Displaying Data for Small Groups of Users Load all Users To view information for all users, select the Load all users butt...
Page 25 - Viewing Users: Data Fields Descriptions
Adding, Viewing, Editing, and Deleting Users 1-19 Viewing Users: Data Fields Descriptions Introduction Different data fields appear in the user configuration screen depending on the option boxes selected. Default Data Fields When none of the option boxes are checked, the user configuration screen di...
Page 28 - User Data Field
1-22 Adding, Viewing, Editing, and Deleting Users User Data Field When the Show user data option box is checked, these data field appear in addition to the default data fields: Table 1-11. User Data Fields Field Description Forward All Set Indicates whether Forward All feature is set by the user:• O...
Page 30 - Viewing Users: All Users
1-24 Adding, Viewing, Editing, and Deleting Users Viewing Users: All Users Introduction This section explains how to use the Load all users button and the option boxes to view user data. Overview For situations where you need to compare the data between users, you can click the Load all users button...
Page 32 - Finding Users; When you are finished searching, click Done.
1-26 Adding, Viewing, Editing, and Deleting Users Finding Users Introduction You can highlight any of the users by clicking their record with the mouse. If you have thousands of users, the Find User utility will make your search easier. Procedure: Finding Users The Find button activates a program th...
Page 33 - Deleting Users; Deleting User; Using the right mouse click, select Delete.
Adding, Viewing, Editing, and Deleting Users 1-27 Deleting Users Deleting User To delete a user or multiple users, follow these steps: Table 1-14. Procedure for Deleting Users Step Action 1 To select a user, left mouse click on a row in the table.To select multiple users, hold down the shift key whi...
Page 34 - Editing Users: Administrator Controlled
1-28 Adding, Viewing, Editing, and Deleting Users Editing Users: Administrator Controlled Introduction This section describes how to edit users. Procedure: Editing a User To edit a user, follow these steps: Procedure: Editing Multiple Users To edit multiple users, follow these steps: Note When you e...
Page 35 - Editing User: Show Alias
Adding, Viewing, Editing, and Deleting Users 1-29 Editing User: Show Alias Introduction The aliases names associated with each users can be displayed using the show alias option box. User names with aliases appear in italics. What’s an Alias? An alias is another address or phone number by which a us...
Page 36 - Editing User Features: User Controlled
1-30 Adding, Viewing, Editing, and Deleting Users Editing User Features: User Controlled Introduction The VOCAL system provides a web page for users to maintain some of their features. These features are call User Controlled Features and they include:• JTAPI • Forward all calls • Call blocking • Cal...
Page 37 - Editing User Feature: Edit User Screen
Adding, Viewing, Editing, and Deleting Users 1-31 Editing User Feature: Edit User Screen Show User Data View Figure 1-10 illustrates the edit user screen that appears when Show user data option box checked and the edit right mouse option is used. This screen displays features that can be enabled by ...
Page 39 - Call Screening; ) Right mouse click near the name and number box. Select Add.
Adding, Viewing, Editing, and Deleting Users 1-33 Call Screening The user can screen a call by name and number. To add numbers to screen: 1) Right mouse click near the name and number box. Select Add. 2) A Screen Calls From dialog box appears. Enter the name and number to screen. Click OK. The forma...
Page 41 - HWZRUN0DQDJHPHQW; Topic
1HWZRUN0DQDJHPHQW This chapter describes network management and statistics for the VOCAL system. Topic See Page SNMP Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 MIBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...
Page 42 - SNMP Support; SNMP Version
2-2 SNMP Support SNMP Support Overview VOCAL supports Simple Network Management Protocol (SNMP) monitoring from:• the VOCAL SNMP GUI - this supports monitoring of VOCAL server status. • a third party SNMP network manager. SNMP Version VOCAL supports SNMP version 2 (RFCs 1441 to 1452).
Page 43 - MIBs
SNMP Support 2-3 MIBs Introduction In a TCP/IP-based network, each device maintains a set of variables describing its state. In Simple Network Management Protocol (SNMP), these variables are known as objects, but these objects do not hold the same meaning as those within an object-oriented programmi...
Page 45 - VOCAL SNMP GUI
SNMP Support 2-5 VOCAL SNMP GUI Server Status Monitoring Each VOCAL system server sends (via multicast) heartbeat packets to its peers at a predefined interval. The Heartbeat Server monitors the exchange of heartbeat packets between VOCAL servers and sends server status trap messages to the network ...
Page 46 - VOCAL SNMP GUI Screen Elements; SNMP Controller; ) From the Host View, select a hostname and select a process.
2-6 SNMP Support VOCAL SNMP GUI Screen Elements Hosts & Processes This frame displays the host server and indicates whether they are active (blue) or inactive (red). If a host server contains several processes, it will display a red ball if one or more of the processes is inactive. SNMP Controll...
Page 48 - Features
A-2 Features Features Introduction This section describes the types of feature supported by the VOCAL system. Overview The VOCAL system supports two types of features—core system features and set-based features. Core System Features Core system features are those that involve rerouting calls under c...
Page 49 - Core System Features; Call Blocking
Core System Features A-3 Core System Features Types of Core System Features There are two types of system features—calling features and called features. The calling features are assigned to the call originator. The called features are assigned to the calling destination. Call Blocking The administra...
Page 50 - Call Return
A-4 Core System Features Call Return Call return allows the user to call back the last caller. The user dials *69 to dial up the last caller. Call Screening Call screening allows the user to block calls from a list of numbers. For example, when an screened number calls the user, the caller will rece...
Page 54 - SIP Request Messages
B-2 SIP Request Messages SIP Request Messages Supported SIP Request Messages The VOCAL system supports these SIP request messages: Table B-1. SIP Request Messages Descriptions SIP Request Messages Descriptions INVITE Indicates that the user or service is being invited to participate in a session. AC...
Page 55 - SIP Response Messages; xx Responses
SIP Response Messages B-3 SIP Response Messages SIP Response Messages Category The VOCAL system supports all SIP response messages:• 1xx Responses - Information Responses • 2xx Responses - Successful Responses • 3xx Responses - Redirection Responses • 4xx Responses - Request Failures Responses • 5xx...
Page 56 - xx Responses
B-4 SIP Response Messages • 409 Conflict • 410 Gone • 411 Length Required • 413 Request Entity Too Large • 414 Request-URI Too Large • 415 Unsupported Media Type • 420 Bad Extension • 480 Temporarily not available • 481 Call Leg/Transaction Does Not Exist • 482 Loop Detected • 483 Too Many Hops • 48...
Page 58 - See Page
C-2 Topic (continued) See Page User Agent to User Agent: Consulted Transfer. . . . . . . . . . . . . . . . C-103 User Agent to User Agent: Blind Transfer . . . . . . . . . . . . . . . . . . . . C-122 JTAPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...
Page 59 - SIP Phone: Registration; Call Scenario
SIP Phone: Registration C-3 SIP Phone: Registration Call Scenario Figure C-1 illustrates a SIP phone registering with the Marshal server. Authentication Methods There are three registration methods, no authentication, access list authentication or digest authentication. Table C-1 shows the authentic...
Page 60 - Registration: Access List Authentication; Call Flow Diagram
C-4 SIP Phone: Registration Registration: Access List Authentication Call Flow Diagram Figure C-2 shows a SIP IP phone registering with the Redirect server. The User Agent Marshal server is using the Access List authentication method. Figure C-2. Call Flow Diagram: SIP Phone Registration Call Trace ...
Page 62 - Registration: Digest Authentication
C-6 SIP Phone: Registration Registration: Digest Authentication Call Flow Diagram Figure C-3 shows a SIP IP phone registering with the Redirect server. The User Agent Marshal server is using the Digest authentication method. Figure C-3. Call Flow Diagram: SIP IP Phone Registration — Digest Authentic...
Page 64 - SIP IP Phone to SIP IP Phone: Call Setup and Disconnect
C-8 SIP IP Phone to SIP IP Phone: Call Setup and Disconnect SIP IP Phone to SIP IP Phone: Call Setup and Disconnect Call Scenario Figure C-4 illustrates a call between two, on-network SIP IP phones. Figure C-4. SIP Phone to SIP Phone Call Flow Diagrams Figures C-5 and C-6 show a successful call setu...
Page 67 - Call Trace
SIP IP Phone to SIP IP Phone: Call Setup and Disconnect C-11 Call Trace The following call trace shows a successful call setup between two, on-network IP phones. In this example, the called party terminates the call. ----------------------------------------------------------------- SIP Headers------...
Page 72 - SIP IP Phone to Analog Phone via Gateway
C-16 SIP IP Phone to Analog Phone via Gateway SIP IP Phone to Analog Phone via Gateway Call Scenario Figure C-7 illustrates a SIP phone to analog phone call made over an IP network via a gateway. Figure C-7. SIP IP Phone to Analog Phone via Gateway Call Flow Diagram Figures C-8 and C-9 show a call o...
Page 82 - SIP Phone to Phone via Gateway: Called Party is Busy
C-26 SIP Phone to Phone via Gateway: Called Party is Busy SIP Phone to Phone via Gateway: Called Party is Busy Call Scenario Figure C-10 illustrates User A initiating a call to User B while User B is busy. Figure C-10. SIP Phone to Phone: Called Party is Busy Call Flow Diagram Figures C-11 and C-12s...
Page 91 - SIP IP Phone to SIP IP Phone: Forward All Calls
SIP IP Phone to SIP IP Phone: Forward All Calls C-35 SIP IP Phone to SIP IP Phone: Forward All Calls Call Scenario Figure C-13 illustrates the following call scenario:• User A initiates a call to User B • User B has call forwarding enabled • The call is forwarded to User C Note In this example, all ...
Page 101 - Phone to SIP Phone via Gateway: Call Screening
Phone to SIP Phone via Gateway: Call Screening C-45 Phone to SIP Phone via Gateway: Call Screening Call Scenario Figure C-16 illustrates the following call scenario:• User A initiates a call to User B • User B has call screening enabled • The feature server screene the call and returns a forbidden c...
Page 107 - SIP Phone to PSTN: Call Blocking
SIP Phone to PSTN: Call Blocking C-51 SIP Phone to PSTN: Call Blocking Call Scenario Figure C-16 illustrates the following call scenario:• User A initiates a long distance or 1-900 number call • The VOCAL System blocks the call Figure C-18. SIP IP Phone to Phone: Call Blocking Call Flow Diagram Figu...
Page 112 - SIP IP Phone to SIP IP Phone: Call Return
C-56 SIP IP Phone to SIP IP Phone: Call Return SIP IP Phone to SIP IP Phone: Call Return Call Scenario Figure C-20 illustrates the following call scenario:• User A dials *69 to determine the last number that was called, User B • User A calls User B Figure C-20. SIP Phone to SIP Phone: Call Return Ca...
Page 131 - User Agent to User Agent: Call Waiting
User Agent to User Agent: Call Waiting C-75 User Agent to User Agent: Call Waiting Call Scenario Figure C-25 illustrates the following call scenario:• User A calls User B • While Users A and B are in conversation, User C calls User A • User A is notified that another caller attempting to connect Fig...
Page 147 - SIP IP Phone to SIP IP Phone: Forward to Voice Mail
SIP IP Phone to SIP IP Phone: Forward to Voice Mail C-91 SIP IP Phone to SIP IP Phone: Forward to Voice Mail Call Scenario Figure C-29 illustrates the following call scenario:• User A calls User B • User B does not answer the call • The call is forwarded to the voice mail feature server Figure C-29....
Page 159 - User Agent to User Agent: Consulted Transfer
User Agent to User Agent: Consulted Transfer C-103 User Agent to User Agent: Consulted Transfer Call Scenario Figure C-33 illustrates the following call scenario:• User A calls User B. • User B puts User B on hold and notifies User C about User A’s call. • User B transfers the call to User C. Figure...
Page 178 - User Agent to User Agent: Blind Transfer
C-122 User Agent to User Agent: Blind Transfer User Agent to User Agent: Blind Transfer Call Scenario Figure C-38 illustrates a call scenario in which:• User A calls User B. • User B transfers the call to User C without consulting User C. Figure C-38. User Agent to User Agent: Blind Transfer Call Fl...
Page 196 - JTAPI
C-140 JTAPI JTAPI Call Scenario Figure C-43 illustrates the following call scenario:• A user uses a JTAPI User Agent on a PC to remotely instruct SIP Phone A to call SIP Phone B. Figure C-43. JTAPI Call Flow Diagram Figures C-44, C-45, C-46 and C-47 show third party call control through a JTAPI serv...
Page 215 - Ad Hoc Conference Call Between User Agents
Ad Hoc Conference Call Between User Agents C-159 Ad Hoc Conference Call Between User Agents Call Scenario Figure C-48 illustrates the following call scenario:• User A calls User B • User A brings User C into the conversation via ad hoc conferencing. Figure C-48. User Agent to User Agent to User Agen...
Page 241 - Index
Symbols *69 call flow C-56 Numerics 1xx and 2xx B-33xx Responses B-34xx Responses B-35xx Responses B-46xx Responses B-4900 # Admin Block 1-20900 # User Block 1-23 A Access Level 1-4Access list C-4ACK B-2adding users, see NewAdhoc conferencing A-6Administrator 1-4alias 1-29Aliases 1-32Authentication ...