vsx-userguide-ver705
DESCRIPTION
Sansay SBC User guide for VSX-2U modelTRANSCRIPT
SANSAY VSXVOICE SESSION EXCHANGE
USER’S GUIDE
RELEASE 7.05
Important Notices
Warnings!
Before connecting a softswitch to a datacommunications or telecommunications network,
have a qualified professional verify that the unitis connected to a safety/earth ground, either through the AC mains connector or directly
through the terminal at the rear of the chassis.
Before connecting a VSX to a data communications or telecommunications network,
have a qualified professional verify that the unitis connected to a safety/earth ground, either through the AC mains connector or directly
through the terminal at the rear of the chassis.
These are Class B products. In a domestic environment, these products maycause radio interference, in which case the user may be required to takeadequate measures. The domestic environment is an environment wherethe use of broadcast radio and television receivers may be expected withina distance of 10 meters of the apparatus concerned.
Sansay, Inc.4650 Lusk Blvd. Suite 204, San Diego, CA 92121 (858) 678-0200; FAX (858) 678-0203
S-VSX-301-TP-1B
Sansay VSXVoice Session Exchange
User’s Guide
Sansay, Inc.
May, 2006
Fourth Edition (May, 2006)
This edition applies to the Sansay, Inc. VSX product line. The licensed product described in this document and all licensed materials that are available for it are provided by Sansay under terms of the agreement for Sansay licensed products. Sansay periodically makes additions, deletions, or changes to the information in this document. Before you use this document, consult Sansay or your distributor for the most recent edition.
The author and publisher have made reasonable efforts to ensure the accuracy and timeliness of the infor-mation in this book. However, neither the author nor the publisher shall have any liability with respect to loss or damage caused or alleged to be caused by reliance on any information in this book.
Sansay may have patents or pending patent applications covering material in this document. Furnishing this document does not of itself constitute a grant of any license or immunity under any patents, patent applications, trademarks, copyrights, or other rights of Sansay, or of any third party, or any right to refer to Sansay in any advertising or other marketing activities. Sansay assumes no responsibility for any infringe-ment of patents or other rights of third parties that may result from use of the material in this document or for the manufacture, use, lease, or sale of machines or software programs described herein, outside of any responsibilities assumed in the original or subsequent purchase or lease agreements.
This document may contain information about, or make reference to, Sansay products, programming, or ser-vices that are not available in your country. This information must not be construed to mean that Sansay intends to make available such products, programs, or services in your country.
A form for your comments is provided at the back of this document. If the form has been removed, address your comments to: Sansay, Inc., Information Development Group, 4650 Lusk Blvd. Suite 204, San Diego, CA 92121.
Sansay may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
No part of this publication may be reproduced in any manner without the written permission of Sansay, Inc. For information, write to: Sansay, Inc., Legal Office, 4650 Lusk Blvd. Suite 204, CA 92121.
© 2006 by Sansay, Inc.
All rights reserved
Printed in the United States of America
TABLE OF CONTENTS
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiWho Should Use This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiHow To Use This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii
Textual Callouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiiGetting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii
Service and Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1VSX Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Session Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Border Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Protocol Interworking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Gatekeeper Interconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4SIP Proxy Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5VSX OS and Hardware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Redundancy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6High Availability Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Media Switch VMX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7VMX Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8VSX Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Chapter 2. Setting up the VSX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Unpacking the VSX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Installing the VSX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Rack Mounting the VSX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Making External Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Connecting the Local Area Network Port. . . . . . . . . . . . . . . . . . . 11Connecting the Power Cable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Applying System Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Chapter 3. Before You Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Configuration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Configuration Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14System Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Routes Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Users Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapter 4. Initial Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Changing Passwords. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Editing Network Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Setting System Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Submitting the Changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
ix
Sansay VSX User’s Guide
Configuring Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Routes Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Adding Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Chapter 5. Adding and Configuring Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Opening the Resource Add Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Adding Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
General Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Resource Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Digit Translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Ingress Action Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Egress Action Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Codecs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Resource Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Chapter 6. Adding and Configuring Routes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Opening the Add Route Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Configuring a Route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Proportional Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Configuring Route Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Placing Test Calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Importing Routes and Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Exporting Routes and Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Chapter 7. Digit Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Digit Mapping List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Digit Matching Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Chapter 8. Managing Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Opening the Users Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Adding a User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Editing and Deleting Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Editing Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Deleting Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Chapter 9. Viewing Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Opening the Statistics Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Viewing Route Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Viewing System Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Chapter 10. Editing and Deleting Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63How Resources Are Edited. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Editing Gateways . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Deleting Gateways . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Editing Routes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Deleting Routes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Chapter 11. Managing the VSX System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67System Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Edit System Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
x
Table of Contents
Editing Network Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Advanced Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Restoring A Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Saving a Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Upgrading VSX Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Rebooting the System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Restarting the VSX Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Taking the VSX Offline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Upgrading the VSX System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Editing Load Balance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Using Radius Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Collecting Call Detail Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Chapter 12. The VSX Configurator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Configurator GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
System Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85System Page Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Radius Server Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87System Page Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Routes Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Users Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Monitoring Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Trace Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Chapter 13. Sansay SOAP Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97XML Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Editing XML Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97SOAP Client Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Chapter 14. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Failing Calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Tracing Calls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Viewing Call Sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104H323 Protocol Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106SIP Protocol Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Advanced Trace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Configuration Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Retrying the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Information about the Installation . . . . . . . . . . . . . . . . . . . . . . . 109Troubleshooting the VSX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Basic Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Contacting TAC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Contacts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
xi
Sansay VSX User’s Guide
Appendix A. Call Detail Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Call Detail Record Body . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Detail Field Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Release Causes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Sample CDR record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
CDR File Storage/Retrieval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126File Storage Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126File Naming Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126File Retrieval Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Appendix B. VSX Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Environmental Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
xii
LIST OF FIGURES
Figure 1. VSX Session Controller Application Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . 2Figure 2. VSX Border Gateway Application Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Figure 3. VSX Protocol Support Application Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Figure 4. Gatekeeper Interconnect Application Diagram . . . . . . . . . . . . . . . . . . . . . . . . . 4Figure 5. SIP Proxy Connect Application Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Figure 6. VSX 1U and 2U Chassis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Figure 7. NEBS Compliant VSX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Figure 8. High Availability Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Figure 9. VMX Cluster Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Figure 10. VSX Front Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Figure 11. VSX Rear Panel External Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Figure 12. VSX Default IP Address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Figure 13. VSX Login Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Figure 14. Edit Network Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Figure 15. Edit System Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Figure 16. VSX Resources Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Figure 17. Resource Add Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Figure 18. VSX Routes Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Figure 19. Add Route Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Figure 20. VSX Import Form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Figure 21. VSX Save Route Table Form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Figure 22. Digit Mapping List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Figure 23. Digit Mapping Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Figure 24. Digit Mapping Call Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Figure 25. VSX Users Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Figure 26. Add User Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Figure 27. Edit User Form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Figure 28. VSX Gateway Statistics Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Figure 29. VSX Route Statistics Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Figure 30. VSX System Statistics Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Figure 31. System Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Figure 32. Edit System Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Figure 33. Edit Network Connections Form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Figure 34. VSX Advanced System Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Figure 35. Restore System Configuration Form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Figure 36. VSX Save System Configuration Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Figure 37. VSX Upload Code Upgrade Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Figure 38. VSX Reboot System Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Figure 39. VSX Restart Software Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Figure 40. System Offline Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Figure 41. Generate System Key Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Figure 42. Radius Server Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Figure 43. Edit Radius Servers Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Figure 44. VSX Login Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
xiii
Sansay VSX User’s Guide
Figure 45. System Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Figure 46. VSX Resources Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Figure 47. VSX Routes Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Figure 48. VSX Users Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Figure 49. VSX Gateway Stats Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Figure 50. Sansay VSX Trace Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Figure 51. VSX Trace Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Figure 52. Call Sessions Trace Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Figure 53. H.323 Trace Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Figure 54. SIP Protocol Trace Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Figure 55. Advanced Trace window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
xiv
LIST OF TABLES
Table 1. Possible Problem Solutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Table 2. CDR Header Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Table 3. Call Detail Record Body. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Table 4. Detail Field Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Table 5. Release Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Table 6. 1St Release Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Table 7. Release Codes from Stack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Table 8. Release Messages from VSX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Table 9. VSX Internal Release Causes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Table 10. VSX Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Table 11. VSX Server Environmental Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
xv
Sansay VSX User’s Guide
xvi
ABOUT THIS BOOK
This book is designed to help you receive, install, configure and operate your Sansay VSX. It provides information that enables you to configure and operate your VSX within your network and billing system.
Who Should Use This Book
This book is for product distributors, systems integrators, systems analysts, and network administrators who design, install, configure, and maintain communications applica-tions. You can use this book alone if your network is already functional.
If you require information to help you integrate a VSX into your network, refer to the manuals that support your net-work components.
How To Use This Book
If the Sansay product family or the Sansay VSX is new to you, you should read all the chapters in this book sequen-tially to familiarize yourself with all of the product features and functions.
xvii
Sansay VSX User’s Guide
Textual Callouts
This book uses two distinct symbols displayed in the textual margins to call your attention to information that is of par-ticular interest.
These call-outs are:
NoteThis callout indicates that the information presented may be of particular use when operating a Sansay VSX or accompa-nying devices.
CautionThis callout indicates that the information presented may prevent damage to a Sansay VSX or accompanying devices when operating the equipment or may prevent personal injury when installing, operating, or maintaining a Sansay VSX or accompanying devices.
Getting Help
If a problem occurs, a message normally displays on the sys-tem monitor. These messages belong to one of the following categories:
Message Type Displays
Informational Current operating condition
Error Messages about errors that occur during operation of a Sansay VSX.
xviii
About This Book
Service and Support
If you try all of the suggestions that are given in this book and you still need help, you can get assistance directly from the Sansay Technical Assistance Center (TAC) at 1-858-678-0200, Extension 809. Customers outside of the United States of America should contact their local distributor or Regional Support Center at [email protected] for assis-tance.
xix
Sansay VSX User’s Guide
xx
CHAPTER 1
INTRODUCTION
This chapter describes the functionality of a Sansay VSX and describes how the VSX operates within a network envi-ronment.
VSX Applications
The VSX can be implemented to provide the following ser-vices:
• Session Controller – Controls switching and routing between VoIP endpoints
• Border Gateway – Protects internal network topology
• Protocol Interworking – Provides protocol conversion
• Gatekeeper Interconnect
• SIP Proxy
Session Controller
When implemented as a session controller, the VSX:
• Controls routing in VoIP networks
• Centralizes routing tables
• Centralized & accurate CDRs
• Simplifies Gateway configurations
1
Sansay VSX User’s Guide
• Intelligent Route Hunting enhances ASRs
• Is secure and scalable
• Provides real-time performance monitoring
Figure 1 shows the interconnection of the VSX as a session controller.
Figure 1. VSX Session Controller Application Diagram
Border Gateway
When implemented as a border gateway, the VSX:
• Protects all internal IP addresses
• Eliminates load on Softswitches & GWs
• Routes VoIP partner calls
• Originates Media & signaling
• Advertises only one address
Figure 2 on page 3 shows the interconnection of the VSX as a border gateway.
2
Introduction
Figure 2. VSX Border Gateway Application Diagram
Protocol Interworking
The VSX’s versatile protocol compatibility supports:
• Unification of the voice network
• Any-to-any call flow through network
• Handles switching of methods
• H.323 Fast-Start to Slow-Start• H.245 tunneling conversion• Full SIP method support• Any H.323 to SIP
Figure 3 on page 4 shows the interconnection of the VSX as a protocol converter.
3
Sansay VSX User’s Guide
Figure 3. VSX Protocol Support Application Diagram
Gatekeeper Interconnect
The VSX’s gatekeeper interconnect supports:
• Partner configuration as H.323 gatekeeper address• Gateway addresses added as resources
Figure 4 shows the interconnection of the VSX as a gate-keeper.
Figure 4. Gatekeeper Interconnect Application Diagram
4
Introduction
SIP Proxy Connect
The VSX’s SIP Proxy connect supports:
• Configuration of Proxy as SIP Proxy• No Gateway configuration necessary
Figure 2 shows the interconnection of the VSX with a SIP Proxy.
Figure 5. SIP Proxy Connect Application Diagram
VSX OS and Hardware
The VSX unit features:
• Customized Micro-Linux-based Intel platform
• Micro kernel with enhanced network I/F
• Dual Gigabit and 10/100base-T ethernet interface
• 1U Server for lower end apps
• 1000 active calls (H.323 or SIP with media)• Non-redundant. AC only
• 2U for high end apps
• 5000 active calls (H.323 or SIP with media) per chas-sis
• Redundant power, fans, drives. AC only
5
Sansay VSX User’s Guide
• 2U NEBS for Central Office apps
• Same performance but NEBS-3 certified• Redundant. AC or DC power supply option
Figure 6. VSX 1U and 2U Chassis
Redundancy
Multiple VSX servers can be implemented to provide:
• Non-stop call routing
• Mirroring of call state between servers
• Hot swappable load sharing power supplies and fans
• 2 hot-swappable hard drives
• Dual Gigabit Ethernet interfaces
• Full compatibility with HSRP
Figure 7. NEBS Compliant VSX
6
Introduction
High Availability Node
• HA is a fault tolerant, non-stop cluster
• System processes poll each other constantly• In a failure the backup assumes IP address of failed
system• Active calls cleared and logged in redundant CDR file
• Software ensures 99.999% uptime
• MTBF for servers are 36,000 hours
Figure 8. High Availability Node
Media Switch VMX
A VMX unit functions as a high-capacity media router. It requires a VSX unit to control it as shown in Figure 9 on page 8. A VMX implementation can provide:
• A separate media processor for large applications
• Redundancy on system wide level
• Clustered low cost hardware• N:1 redundant media paths
• Hitless failover for active calls
Active VSX System
Standby VSX
Processes and statesmirrored in real time
7
Sansay VSX User’s Guide
• Scalability up to 8 VMX units per cluster
• Over 1,000 calls per VMX
VMX Cluster
To handle call media requirements, multiple VSX units can be implemented in a VMX cluster configuration (Figure 9) to provide:
• Redundant pair for signaling
• VMX cluster for media
Figure 9. VMX Cluster Configuration
VSX Integration
The Sansay VSX can be deployed singularly or in pairs to provide maximum network reliability. In the latter configu-ration, VSXs are interconnected and synchronized through dedicated, 100Base-T LAN interfaces.
A single VSX can support a large network of gateways; how-ever, VSXs can also be deployed regionally and operate together to provide the call processing and switching struc-ture for multiple proprietary networks.
VSX Redundant Pairfor Signaling
VMX Cluster for Media
Call Signaling
Call Media
8
CHAPTER 2
SETTING UP THE VSX
This chapter presents information to guide you through receipt and basic installation of the Sansay VSX.
Unpacking the VSX
The VSX unit is shipped in a cardboard shipping container with all required accessories. The contents include:
• VSX Unit
• Accessory Kit
• User Documentation on CD
9
Sansay VSX User’s Guide
Installing the VSX
The Sansay VSX unit is shipped with all required hardware and software installed. See Figure 10 for a front view of the VSX chassis.
Figure 10. VSX Front Panel
Rack Mounting the VSX
The VSX unit can be free standing or mounted in a rack or on shelves. The compact VSX chassis is designed to occupy a single (1 EIA) rack unit in a standard 19-inch rack. The VSX is also available in a 2 EIA form factor. A VSX chassis is light enough to be installed by one person. The VSX needs to have an Intel rack mount kit in order to install properly, but other systems can be used. If the unit is to be mounted into a rack on a shelf, you will need the appropriate hand tools to accomplish this task. The following tools and supplies are recommended:
• A set of hand tools (such as cordless screwdriver, #2 Phil-lips screwdriver, 5/16” flat blade screwdriver)
• Four #10-24 rack mounting screws
The VSX only needs to be supported by the 4 bolts which go through the rack ears in the front of the system. Make sure the bolts are tight and that system is flush with the rack itself.
10
Setting Up the VSX
Making External Connections
All external connections to the VSX are made through the rear panel of the unit. The types of connections available on the server are as follows:
• 10/100/1000Base-T auto-sensing Ethernet
• Power cord
See Figure 11 for the locations of the above-mentioned ports.
Figure 11. VSX Rear Panel External Connections
Connecting the Local Area Network Port
Connect the 100Base-T ethernet port on the VSX unit to your ethernet by using an RJ-45 ethernet cable. The Ether-net cable should be plugged into a switch or a hub for Inter-net access.
The Ethernet port is 10/100/1000 Base-T auto sensing. It is recommended to use a 100 Base-T full duplex switch for the highest performance. The port in use is the one on the left hand side of the two Ethernet ports when looking at the sys-tem from the rear. This is the port that is farthest from the power supply cable.
Connecting the Power Cable
The VSX must be plugged into an AC power supply, which can be either 120 VAC or 220 VAC. It is highly recom-mended that an Uninterruptible Power Supply be used for the system in order to protect the system from power out-ages. Connect the power cord to the AC receptacle on the VSX unit and then to a grounded AC outlet.
120/250 VACLAN Port
11
Sansay VSX User’s Guide
Applying System Power
After all cable connections to the VSX unit are made, apply AC power by pushing the front panel power button.
The system can be powered off by pushing and holding down the power button for 3 seconds. If power is cut off while the unit is operating it will automatically power up when AC power is reapplied.
12
CHAPTER 3
BEFORE YOU START
Before installing one or more VSXs into your system, make sure that in addition to this guide, you have planned your network topology and are familiar with the necessary:
• System IP Addresses
• Gateway/Resource Address
• Protocols
The entire system should be configured by the web based GUI. To do this you must connect a system (PC or Unix sys-tem) on the same LAN segment (ie, with no routers in between) and open a browser program on the system. The system must be configured to be on the same IP network address as the default IP address of the VSX. The default IP address of the VSX is 192.168.0.100 with a subnet mask of 255.255.255.0. The default gateway is 192.168.0.1. There-fore, any other address on the 192.168.0.0 C-class network would work for the local system.
Configuration Overview
This section presents a high-level approach for initially con-figuring the VSX. This information is presented in the rec-ommended logical sequence.
13
Sansay VSX User’s Guide
Configuration Sequence
This section presents the recommended process flow you need to initially configure a VSX. Access the following screens in the order below:
• System Page
• Resources Page (add gateways)
• Routes Page
• Users Page
System Page
The System page enables you to specify the initial required configuration parameters for the VSX system. See "System Page" on page 85 for more information.
Access the System page by clicking on the System tab on the user interface. From this page you will need to set:
• System FQDN/IP Address
• Alias Name
• System Mode
• Time Zone, Time Server(s) and System Clock
• Call Detail Record ID and Number of Seconds for each CDR file write
• CDR User Password used to retrieve CDR files
• Default Router
• Subnetwork Mask
• Local Payload Port Base Address
• UDP Ports for both SIP and H.323 signaling
14
Before You Start
Resources Page
The Resources page enables you to add, edit, and delete gateways, softswitches, and IP phones. See "Resources Page" on page 89 for more information. See also “Adding and Configuring Resources” on page 25.
Access the Resources page by clicking on the Resources tab on the user interface. From this page you will need to:
• Add and edit network sources
Routes Page
The Routes page enables you to add, edit, and delete routes accessible to the VSX system. You can establish a primary route and up to seven alternate routes. See "Routes Page" on page 91 for more information. See also “Adding and Config-uring Routes” on page 39.
Access the Routes page by clicking on the Routes tab on the user interface. From this page you will need to specify:
• Alias name
• Digit match sequence
• Trunk IDs
Users Page
The Users page enables you to add, edit, and delete users authorized to access the VSX system. In addition, you can establish access priveleges for each user. See "Users Page" on page 93 for more information.
Access the Users page by clicking on the Users tab on the user interface. From this page you will need to:
• Access the system as superuser
15
Sansay VSX User’s Guide
• Add and edit users, set access rights and passwords
• Examine User status
16
CHAPTER 4
INITIAL CONFIGURATION
The Sansay Session Controller features a comprehensive, easy to use graphical user interface that enables you to con-figure and manage the VSX. Using a standard Internet browser you can access this interface by entering the default IP address of the VSX.
Logging In
Open a standard web browser and enter the default IP address of the VSX unit (see below). The default IP address is HTPPS://192.168.0.100:8888/.
Figure 12. VSX Default IP Address
After entering the default IP address of the VSX unit, a wel-come screen should display enabling you to login to the sys-tem. If the browser cannot locate the page, refer to the troubleshooting tips in “Troubleshooting the VSX” on page 110. The welcome screen is shown below in Figure 13.
HTPPS://192.168.0.100:8888/
17
Sansay VSX User’s Guide
Figure 13. VSX Login Screen
Enter your user name and password and click the Login but-ton to proceed to the configuration screens. The default user name is superuser and the default password is sansay. The System Statistics screen displays by default. Click the Users tab to begin to edit the user settings.
Changing Passwords
For security reasons the username and password should be changed from the defaults. These should be easily memo-rized and stored in a secure place. This is done under the Users tab by clicking on the edit link next to the superuser name. Enter the new username and passwords and then click Submit. Log out and then back in to the VSX in order to test the changes.
In order to allow Sansay technical support access to your system please add a user name of your choice with supe-ruser privilege and send email to [email protected] with the username and password of their login.
Editing Network Settings
Click the System tab to begin to edit the system settings.Click the Edit Network Connections tab to set the initial networkconfiguration for the VSX. The Edit Network Connectionspage is shown in Figure 14.
18
Initial Configuration
Figure 14. Edit Network Connections
You will need to specify the following fields:
Lan Interface FQDN/IPSpecify the fully-qualified domain name (IP address) of the VSX system for both the public and private LAN. This will enable you to manage the VSX from any remote system.
Subnet MaskSpecify the ethernet subnetwork mask of the VSX system for both the public and private LAN. If you are not sure of these addresses, check with your network administrator.
Net MaskThe net mask is used to separate the private IP address range from the public range. Commonly the Netmask value is 8, 16, or 24 dependent on the number of networks in use on the private network side.
Specify the net mask for the VSX system. If you are not sure of this value, check with your network administrator.
GatewaySpecify the IP address of the default and private gateways (or the router for the LAN segments) that the VSX will use. If you are not sure of this address, check with your network administrator.
19
Sansay VSX User’s Guide
Setting System Date and Time
Click the Edit System tab to set the system date and time for the VSX. The Edit System page is shown in Figure 15.
Figure 15. Edit System Page
You will need to specify the following field:
Current Time/ Time Zone/Date/TimeSet the system internal time clock/calendar to the current time and date. The date/time stamps are used in the CDR records so the time should be set to the time zone where the VSX is located.
20
Initial Configuration
Submitting the Changes
At this point it is recommended that you submit the new configuration by clicking Submit from the Edit System form. When the System page returns, click Reboot System. The VSX will restart with the new IP address or FQDN.
You can now reconfigure your local system to the proper IP address for the local LAN. When finished you should be able to browse to the VSX via its IP address, but you must append :8888/ to the address. You can then login with the new username and password to set the remaining system parameters as described below.
Once you are logged in again, access the System tab to con-figure the remaining system parameters as described below.
AliasSpecify the alias name for the VSX system. The alias name can be up to 40 characters in length and can include commas, semicolons, spaces, periods, hyphens, underscores, the @ symbol, and question marks.
NTP Server1/2Specify the IP addresses for up to two network time pro-tocol servers used for reference to external time stan-dards. These are optional fields.
The values entered are valid and highly accurate Net-work Time Protocol servers. Due to internal clock drift it is highly recommended that these values be left alone in order to most accurately record CDR information.
CDR File IntervalSpecify the number of seconds that will transpire between CDR file writes.
Local Payload Port StartSpecify the base (starting) address for UDP ports to be used by the VSX system. This value is chosen as a multi-
21
Sansay VSX User’s Guide
ple by 4 of the VSX’s call capacity. The default UDP port base address is 10000.
SIP Port AddressSpecify the SIP port address for the VSX system. The default value is 5060.
H323 Port AddressSpecify the H323 port address for the VSX system. The default value is 1720.
When you have finished editing the system settings, click Submit to assert the changes.
NoteWhen submitting changes to the VSX FQDN, Default Gate-way, Subnet Mask, or Local Payload Port Start settings, the system will restart.
Configuring Resources
You are now ready to configure the system to send and receive calls. Any device which will be either sending you calls (originating) or receiving your calls (terminating) is considered a resource.
After setting the initial system parameters, use the Resource screen to configure gateways, IP phones/clients, soft switches, and proxies. For more information, see “Add-ing and Configuring Resources” on page 25.
Routes Tab
After adding the resource gateways, use the Routes screen to add new routes, or view and edit existing routes. For more information, see “Adding and Configuring Routes” on page 39.
22
Initial Configuration
Adding Users
From here, you will need to access the Users page. The Users page enables you to enter all users authorized to access the VSX system. Initially, the superuser entry dis-plays by default. For more information, see “Managing Users” on page 55.
23
Sansay VSX User’s Guide
24
CHAPTER 5
ADDING AND CONFIGURING RESOURCES
A Resource is any device that will send or receive calls to/from the VSX. It could be an IP gateway as small as a sin-gle analog port, a PC softclient, or a gateway as large as Cisco 5850 or Sonus GSX9000. If a device is not configured into the VSX as a resource it will not be able to generate or receive calls from the VSX.
A Resource can also be a range of IPs, specified using an IP address and a mask range. It is possible to allow calls from an entire B-Class network using an IP address such as 69.63.193.187/16. This Trunk ID would encompass all IPs between 69.63.0.0 - 69.63.254.254.
Read this chapter to learn how to configure gateways, IP phones/clients, soft switches, and proxies.
25
Sansay VSX User’s Guide
Opening the Resource Add Dialog
Access the Resources screen shown below in Figure 16. Click the Add button on the Resources screen to access the Resource Add form shown in Figure 17 on page 27.
Figure 16. VSX Resources Screen
26
Adding and Configuring Resources
.
Figure 17. Resource Add Form
27
Sansay VSX User’s Guide
Adding Resources
When configuring a new resource, the essential parameters are the resource Name (an alias for your convenience), the FQDN or IP address, the VoIP protocol used, the Trunk ID (TID), and the digit stripping or prepending method.
General Info
You will need to configure the following fields and controls:
Trunk IDSpecify the desired trunk ID for the resource. This will be the default trunk ID. For numbering purposes, the TID range for Resources can be 1-49,999.
NameUse this field to specify the resource's alias name. You can enter a name of up to 40 alphanumeric characters, including periods and hyphens. This field is optional.
Company NameUse this field to enter a label to identify the gateway's owner. You can enter a company name of up to 40 alpha-numeric characters, including periods and hyphens. This field is mandatory.
FQDNEnter the fully-qualified domain name or a unique IP address of the new resource (for example, 192.168.0.1). If you do not know the FQDN or the IP address of the resource, check with your network admin-istrator. This field is mandatory.
A range of addresses can be entered using a syntax such as 192.168.0.2 /32. If an FQDN is entered it must be
28
Adding and Configuring Resources
resolvable in the host table which is uploaded through the System Page.
FQDNs should not be used for inbound TIDs. The reason for this is that the inbound calls arrive from a particular IP address. It is very difficult to "reverse-resolve" the IP address into an FQDN name in order to associate it with the proper TID. As such, inbound TIDs need to use fixed IP addresses.
R.7 resolves it from a DNS server configured in the sys-tem page. If the primary DNS server does not reply the VSX query the secondary configured DNS server. If the primary DNS servers responds with a no such host mes-sage the secondary will not be queried.
CPS LimitResources can be controlled on a calls-per-second basis. CPS limiting measures the CPS (inbound and outbound) on the TID and rejects calls that exceed that value. Any value from 1 to 1000 can be entered. Inbound calls that exceed the CPS range are rejected, while outbound calls roll over this route selection and are rerouted if an alter-nate route is configured.
On routes which are commonly overutilized during peak periods it is beneficial to limit the CPS to a reasonable number. This will prevent the VSX from overrunning the terminating resource as well as wasting resources send-ing large quantities of calls to devices which cannot accept them.
Call Number TranslationThis field identifies which Digit Mapping Table (DMT) is used by the resource. The DMT is used to translate ANI and DNIS numbers when they are conditionally matched. These are viewed and configured under the Digit Mapping tab.
29
Sansay VSX User’s Guide
Radius Billing and AuthenticationThe TID can support both Radius billing records and authentication checking by configuration. Radius billing messages use the Cisco Vendor Specific Attributes (VSAs) in the messages and each call attempt will gener-ate messages whether or not it is successful.
A call which is Authorized in the Radius process may specify the time duration for the call to last. This is sometimes used for IVR systems providing a prepaid calling platform.
T38T.38 is used to indicate whether the attached devices can support T.38. This is used to generate the proper signal-ing on the outbound call leg for calls which are received on this TID.
RFC 2833RFC 2833 is used to indicate whether the attached device uses RFC2833 for inbound DTMF Relay.
Payload TypePayload types refers to the RTP payload type used if RFC2833 is enabled.
RTP TOS/DiffservRTP TOS indicated the Diffserve bit settings on RTP traffic outbound to this TID.
NoteWhen adding a new resource, you must specify the resource name, FQDN, and TID.
30
Adding and Configuring Resources
Resource Type
Resource Type fields enable you to select the resource proto-col type and set operational parameters such as Service State, directional properties, network address translation (NAT) and media handling.
ProtocolThe protocol selection is used to control the outbound call request protocol. All calls sent to this resource will use the configured protocol. However, inbound calls are accepted with either SIP GW, SIP Proxy, H.323 GW, H.323 GK, or ENUM Server protocols.
SIP GW will generate invites with the DNIS@ip address of the configured FQDN. SIP Proxy will do the same.
H.323 GK will send LRQs to the configured FQDN. When the ARQs are returned the VSX will generate H.323 GK protocol to the returned FQDN. The VSX does not need to know the addresses of the GWs for outound calls. However on H.323 GKs used for inbound traffic the VSX needs to be configured with the GW addresses unless the configured GK is used in "routed mode".
Port AddressUse this field to specify the port address for the resource. If you do not know the port address of the resource, check with your network administrator.
Service StateDetermine the operational state for the gateway. Select In Service to bring the gateway online, Block to disable access to/from the gateway, or Trace to enable the trac-ing function.
31
Sansay VSX User’s Guide
NoteOnly trace 1 resource or route at a time. This will ensure that the call being traced will be from the desired resource. The VSX will only trace 1 call at a time, so if many resources are being traced, it is not predictable which call will be traced.
DirectionDetermine if the gateway will send calls to the VSX, receive calls from the VSX, or both. Select In to desig-nate the gateway as an ingress gateway to the VSX. Select Out to designate the gateway as an egress gate-way from the VSX. Select Both for bidirectional opera-tion.
The VSX determines inbound calls based on the IP Address and Tech Prefix. If Tech Prefixes are not used, inbound calls will find the first TID that matches the IP address in order or ascending TID number. If you have inbound TIDs, they should be numbered lower than the outbound TIDs.
NATIndicate whether or not the gateway is located behind NAT (network address translation). When accessing a network through a firewall, address translation can be necessary. To indicate address translation is required, select One. Select None to indicate that no network address translation is necessary.
This feature requires the Firewall to be configured to send to the SIP (UDP 5060) messages to the specified gateway. Otherwise traffic we send to the gateway may not reach it. The function of this setting is to ignore the provided SDP and to auto-learn the ports being used on each call.
32
Adding and Configuring Resources
Allow Direct MediaUse this field to enable and disable a direct payload path from gateway to gateway that effectively bypasses the VSX. Select Yes to enable; No to disable direct media support.
In order for the media to bypass the VSX, this setting has to be set to No on both call legs. If one call leg is set to Yes and the other to No, the media is brought back through the VSX.
For greater control of this parameter you can set up sev-eral TIDs that point to the same resource, but with dif-ferent media-handling characteristics.
Digit Translation
Digit Translation fields enable you to enter the number of digits (ie., how many) that you want to strip. The Digit Prepending (or Appending) fields, enable you to enter the exact (literal) digits to be added. It is important to consider your routing table design for it to be flexible and extensible. The VSX system provides to options for both ingress and egress traffic.
The most common approach is to route based on the country code, so you need to consider this when configuring how many digits to strip. You will need to configure the following fields and controls:
MatchUse this field to specify your digit matching require-ments for both ingress and egress traffic. Digit matching is used to determine if the call should use this transla-tion rule or not. If the leading digits on the DNIS do not match the digits entered here, the call will not use the translation values entered. Use All in order to force all calls to use this rule.
33
Sansay VSX User’s Guide
If the match is not met, the call will attempt to match the second translation line. If the match is not met there, the call will go through untranslated.
Action 1Specify the first action to be performed on incoming dialed digits for Ingress 1 and Ingress 2. Select None for no action, Left Strip or Right Strip to mask a specified number of digits, or Prepend to add literally-specified leading digits to the incoming number. For an example, see “Ingress Action Example” on page 36.
Action 2Specify the second action to be performed on resultant incoming digits processed by Action 1 for Ingress 1 and Ingress 2. Select None for no action, Left Strip or Right Strip to mask a specified number of digits, or Prepend to add literally-specified leading digits to the resultant number. For an example, see “Ingress Action Example” on page 36.
34
Adding and Configuring Resources
Digits 1Specify the number of digits to be operated on by the Action 1 setting for both Ingress 1 and Ingress 2.
Digits 2Specify the number of digits to be operated on by the Action 2 setting for both Ingress 1 and Ingress 2.
Action 1Specify the first action to be performed on outgoing dig-its for both Egress 1 and Egress 2. Select None for no action, Left Strip or Right Strip to mask specified digits, or Prepend to add specified leading digits to the outgoing number. For an example, see “Egress Action Example” on page 36.
Action 2Specify the second action to be performed on outgoing digits processed by Action 1 for both Egress 1 and Egress 2. Select None for no action, Left Strip or Right Strip to mask a specified number of digits, or Prepend to add specified leading digits to the outgoing number. For an example, see “Egress Action Example” on page 36.
Digits 1Specify the number of digits to be operated on by the Action 1 setting for both Egress 1 and Egress 2.
Digits 2Specify the number of digits to be operated on by the Action 2 setting for both Egress 1 and Egress 2.
When you have finished making your selections, click Sub-mit to save the configuration. Repeat this process for each new resource. To abandon the changes, click Cancel.
35
Sansay VSX User’s Guide
Ingress Action Example
Suppose the VSX received digits 123 456 7890 from an ingress gateway. If In Action 1 is set to Left Strip, and In Digits 1 is set to 3, the resultant number is 4567890.
If In Action 2 is set to Prepend, and In Digits 2 is literally specified as 234, the resultant number is 2344567890. This resultant number is then processed by digit matching to determine its route. For more information about digit matching, see "Digit Match" on page 41.
Egress Action Example
After digit matching occurs, the outgoing number is then processed by Out Action 1 and Out Action 2, if any. The resultant number is then used for an access code for the international or domestic route, or for adding a carrier pre-fix that identifies the carrier to the terminating partner.
Suppose Out Action 1 were set to Left Strip, and Out Digits 1 were set to 2 (digits). After processing, the resultant num-ber would be 44567890. If Out Action 2 were set to Prepend, and Out Digits 2 were literally specified as 56, the resultant number would be 5644567890.
Codecs
Codec Policy allows you to advertise a specific codec or group of codecs to a resource. This allows you to tailor the codec choices used on each resource and to limit the selection pro-cess of the terminating endpoint.
To use this feature change the setting from transparent to enforced. Then use the pull down menus to select Codec 1, Codec 2 … Codec 8. Codec 1 is advertised as the preferred codec on all calls setup to that resource, Codec 2 is the sec-
36
Adding and Configuring Resources
ond choice, etc. If the Codec Policy is set to Transparent then the other setting have no effect.
NoteThe codec selected for a call is negotiated between endpoints. The originating device advertises the codec choices it would support for that call, and the receiving device chooses from that selection. If there is no overlap between the terminating device's preferences and the originating device's offering, then the call will be rejected.
The VSX normally is transparent to this negotiation but this setting allows it to become an active participant. This setting has no effect on the inbound call attempts for the resource, only the outbound. The route selection will take place nor-mally but the VSX will check the inbound codec offer with the outbound selection if programmed. If there is no match then the call will be rejected. If there is a match then the out-bound call will be placed advertising the codecs that are com-mon.
NoteSome gateways have problems handling call requests with more than one codec offered. For these systems you should only advertise one codec, which will permit the call the work properly for that codec. Early version of Quintum VoIP Gate-ways have this problem.
Resource Groups
A Resource Group is a collection of gateways which are not in a contiguous range, but are part of the same TID. In this configuration you can have up to 64 IP addresses in a single TID. It is not possible to use IP ranges within Resource Groups. For numbering purposes the TID range for Resource Groups can be from 50,000-99,9999.
37
Sansay VSX User’s Guide
38
CHAPTER 6
ADDING AND CONFIGURING ROUTES
Once you have added Gateways and their Trunk IDs to your configuration you can then create Routes which will direct calls to these Trunk IDs. This chapter describes how to use the Add Route dialog to add a new route.
Opening the Add Route Dialog
To access the Add Route dialog, click the Routes tab from the VSX main menu. The Routes page is shown below in Figure 18.
Figure 18. VSX Routes Screen
Click Add Route to open the Add Route dialog shown below (Figure 19).
39
Sansay VSX User’s Guide
Figure 19. Add Route Dialog
40
Adding and Configuring Routes
Configuring a Route
A route is designated by an Alias, Digit Match, and the Route Table it applies to. To set up a route, you will need to configure the following:
AliasAssign an alias name to the new route. You can enter up to 40 alphanumeric characters.
Digit MatchEnter an access code for the route under configuration. You can enter up to 10 characters that range from 0–9, including *, #, +, A, B, C, and D. For example, you can enter 011 (leading digits) for international long-distance routing. Incoming leading digits are first parsed for lead-ing digits 011; then 01; then 0. Calls that match one or more specified leading digits are routed appropriately. If no digit match occurs, the call fails.
Note: The # character is not adviseable to use in VoIP phone calls. The SIP protocol uses URL specifications for phone numbers, and the # symbol is treated differently by various vendors.
The SPX will accept either type of # character in a SIP URL. However it will use the IETF-specified control character (%23) when generating an Invite with the #. Some devices will not recognize this as a # on incoming calls.
Route TableThis control enables you to select an alternate route table. Route tables are configured by using the Route Table List tab on the Routes List page.
TraceUse this control to enable or disable tracing.
41
Sansay VSX User’s Guide
Start/Stop Time of DayUse these fields to configure routing based on time of day. The time of day (TOD) is set to start on Monday 00:00 and go through Sunday 24:00. This is based on the System time, which needs to be considered before configuring. If you are adding a specific TOD route you do not need to stop the reg-ular routing configuration. In other words the times may overlap, and the Route Star Time which is closest to the call time is the one which takes precedence. If you have a TOD Route which starts on Monday 00:00 and another which starts on Monday 06:00, and a call arrives at Monday 06:30 the Route which starts at 06:00 will be used. This means you can leave the normal week long routes in place and create TOD Routes which will supersede them.
Route GroupThis control enables you to select an alternate route group. Route groups are configured by using the Route Groups List tab on the Routes List page. For more infor-mation, see “Configuring Route Groups” on page 44.
PolicyRoutes can be selected from the list on either a top-down basis, or a percentage-based scenario. The policy by default is Top-Down which means that the call attempts will proce-dure Route 1, 2, 3, 4, 5, 6, 7, and 8. The call will route-advance when the call attempt does not reach the Ring (or Alerting) phase. For more information about percentage-based routing, see “Proportional Routing” on page 43.
Trunk ID 1-8Assign a primary route and up to seven alternate routes. You can select trunk IDs from the list of assigned gate-ways.
SubmitClick the Submit button to assert the route configuration you entered. Click Cancel to abandon the route configu-ration. Repeat this process for each new route.
42
Adding and Configuring Routes
Proportional Routing
Proportional Routing is used to divide up calls for a route between several termination resources (TIDs). Proportional routing divides the calls on a percentage basis between the various termination options. To select this option use the pull down menu to select Percentage.
Once this is selected you are required to enter a Load Per-centage figure for each route. The percentage of the load for that route will be shared among the resources based on the percentage entered. A setting of 50% for each of 2 resources for example, will split the call evenly between them. The percentage total of all routes shown on the page must equal 100%.
For example, 50% of the calls can start at Route 1, and the other 50% could start at Route 2. This gives the VSX ability to load-share the initial call request across up to 8 outbound carriers. The percentage-based routing will still alternate-route when a call attempt fails. If the initial call goes to Route 2 and fails, it will still alternate-route to Route 1. This call attempt will not effect the percentage of the calls that are assigned to Route 1. The percentage is only calculated on the first outbound call attempt.
Routes also indicate the alternate routes taken when the outbound call attempts fail, and lets you control the alter-nate routing. The Continuous Routing Yes or No setting enables you to set a Route number to cease alternate calling. This works well with percentage based routing because you can divide up the calls into groups of routes without worry-ing about calls alternate routing between them. Thus you can have 50% of your calls attempt Routes 1,2, and 3 and 50% attempt Routes 4,5,6,7, and 8.
Proportional routing determines the initial call attempt for the outbound calls. If the call fails it will alternate route through the remaining TIDs as configured.
43
Sansay VSX User’s Guide
NoteThis feature is based on a statistical model. It does not ensure that the percentages are matched on every call. For instance in a 50%, 50% model, the calls will not alternate between the two resources. It may be that the calls do not alternate every time, but over time the calls will be evenly split.
Configuring Route Groups
The Route Group List option under the Routes List tab enables you to group your routes together in order to make changes across many routes simpler and easier. If you have several routes that are all treated equally, "Mexico Cellular 1" for example, you can add them as a Route Group. In the case that Mexico Cellular 1 has several different digit matches you can add them as routes but use the Route Group tab. You must first configure a Route Group under the Routes>Route Groups>Add. Here you would specify the routes you would like to use for the Mexico Cellular 1 num-bers. You would first specify a Group ID number which you choose. Then enter the alias you would like to use. "Mexico Cellular 1" in our example case. Then specify the Trunk IDs you want these numbers routed to for termination using the same logic as a single route.
Next you add the specific routes associated with "Mexico Cellular 1" numbers. An example might be 5266431, 55266433, etc. When adding them with the Add Route page you chose the "Mexico Cellular 1" route group. These will reference that routing setup for those calls. So if you need to change the termination partner on those routes you simply need to modify the Route Group instead of the individual routes. As soon as the Route Group is modified the calls to those matches will be routed to the new termination points.
44
Adding and Configuring Routes
Placing Test Calls
Once you have legitimate gateways and routes established, the calls should be able to flow through your system. You can monitor the calls through the Statistics tab. The Show Route Statistics button will show you all of your outbound routes and the ASRs associated with each route. For more information, see “Viewing Statistics” on page 59.
You can also test a destination TI before you add it to the routing table by using the Test Call option on the system page. You can directly dial the TID bypassing the routing process by entering 0000 and then the TID (which must be 5 digits, and may require leading zeros). This allows you to send a number of test calls to the resource to test configura-tion and call quality before adding it to the route table.
Importing Routes and Tables
The Routes page provides controls that enable you to import:
• Routes
• TOD Routes
• Route Groups
• Route Tables
• Digit Matching Tables
45
Sansay VSX User’s Guide
These options can be imported in XML or CSV formats. The VSX Import form is shown in Figure 20.
Figure 20. VSX Import Form.
From the Import form, you can import a file by name, or by navigating to it by using the Browse button. Use the Select the Table Type dropdown to choose the route or table to import. Specify the file format for importing. Select either CSV, or XML.
Select the appropriate import options from the dropdown. Select Update, Delete, or Replace. The Update option adds and updates the routes or tables specified in the imported file in the VSX database. The Delete option removes the routes or tables specified in the imported file from the VSX database. The Replace option deletes existing routes and tables from the database and inserts the routes and tables specified in the imported file into the daatabase.
When all your selections are complete, click Import to upload the file to the VSX.
46
Adding and Configuring Routes
Exporting Routes and Tables
The Routes page provides controls that enable you to export:
• Routes
• TOD Routes
• Route Groups
• Route Tables.
• Digit Matching Tables
These options can be exported in XML or CSV formats. The VSX Export form is shown in Figure 21 on page 47.
NoteIf you are exporting your routes in order to provide a back up configuration you should use the Backup Config option in the System>Advanced page in order to save the entire configura-tion in a smaller file.
Figure 21. VSX Save Route Table Form.
From the Export form, use the Select which Table to export dropdown to choose the route or table to export. Specify the file format for exporting. Select either CSV, or XML.
When all your selections are complete, click Export to down-load the file from the VSX to a workstation.
47
Sansay VSX User’s Guide
48
CHAPTER 7
DIGIT MAPPING
The Digit Mapping page gives access to the Digit Mapping List and Digit mapping Table pages. The digit mapping entries are configurable with the GUI or with XML com-mands.
Sansay offers a SOAP/XML client for use with the VSX or SPX, but any XML client can be used for this task. For more information, see “Sansay SOAP Client” on page 97.
Digit Mapping List
The Digit Mapping List form shown in Figure 22 displays a list of the configured Digit Mapping values. In addition, enables you to add, edit, import and export digit maps.
Figure 22. Digit Mapping List
49
Sansay VSX User’s Guide
To add a DMT value you must first create the table itself. This is done on the Digit Mapping Table List subtab.
The Digit Mapping List performs actions based upon the matching DNIS/ANI combination. For either the DNIS or the ANI you can enter Match, Passthrough, or All. These actions imply:
Match - The values which are used to match the number are replaced by the translated numbers. If there are no numbers in the translated field, the matched digits are stripped.
Passthrough - The entire DNIS or ANI is maintained with no changes.
All - The entire DNIS or ANI is replaced by the value in the translated field.
If a call arrives which does not match the ANI and DNIS in the DMT is will go through the table unchanged and then enter the route selection process.
Digit Matching Table
The Digit Mapping table (DMT) function enables you to manipulate the DNIS or ANI numbers based upon their relationship. This means a specific action can be taken when the DNIS and ANI match the specified values. This gives total control of the outbound numbers for any call. The DMT modification of the digits is done on inbound calls prior to the call being routed. Therefore, if configured to do so, the routing of any call can be done based on the relationship of the DNIS and ANI, not just the DNIS number itself. The Digit Mapping Table is shown in Figure 23 on page 51.
50
Digit Mapping
Figure 23. Digit Mapping Table
The VSX supports up to 1000 different DMT tables which can be assigned independently to the resources. This indi-cates that the calls coming in from that TID will be routed after using the configured DMT. The default is DMT 0 which means no translations will be applied to the call. The maxi-mum number of entries in all of the DMTs is 1,000,000.
It is important to understand that the Ingress Translation functions take place prior the DMT function, so the digits stripped in the resource configuration do not need to be part of the DMT. Only ingress calls on a TID are translated by the DMT; not egress calls. Figure 24 shows the call flow:
51
Sansay VSX User’s Guide
Figure 24. Digit Mapping Call Flow
The DMT entries are only configurable with the GUI or with XML commands. Sansay offers a SOAP/XML client for use with the VSX or SPX, but any XML client can be used for this task.
Two steps must be taken when configuring the DMT. Ini-tially you must add the target table, and secondly you must populate the entries within the DMT. For more information, see “Sansay SOAP Client” on page 97.
In order to add DMTs you need to first create the Table to be populated. Click on the ADD button and simply assign a Table ID and an Alias.
52
Digit Mapping
After the tables are created and populated, assign them to the inbound TIDs using the Digit Mapping List option on the Resource page. For more information, see “Adding Resources” on page 28.
The DMTs provide the following actions based upon the matching DNIS/ANI combination. For either the DNIS or the ANI you can enter Match, Passthrough, or All.
53
Sansay VSX User’s Guide
54
CHAPTER 8
MANAGING USERS
Read this chapter to learn how to add users and manage their ability to access the VSX resources.
Opening the Users Dialog
The Users page enables you to enter all users authorized to access the VSX system. Initially, the superuser entry dis-plays by default. The Users page is displayed in Figure 25.
Figure 25. VSX Users Page
55
Sansay VSX User’s Guide
To access the Add User form (Figure 26), click the Add User button on the Users screen.
Figure 26. Add User Form
Adding a User
As the superuser, you will need to configure the following fields and controls:
Login User IDUse this field to specify the new user's login name. You can enter a user ID name of up to 20 alphanumeric char-acters, including periods and hyphens. This field is required.
AuthorizationUse this field to specify access priveleges for the user. Select one of the following access levels:
• Super User• Read Only• Admin
Select Superuser to allow the new user unlimited access to the VSX configuration.
56
Adding Users
Select Read Only to limit access to viewing existing con-figuration, user information, and statistics.
It is useful to have a read-only user in case you want to doublecheck the configuration or to examine the status of routes.
Select Admin to allow access to manage resources and routes.
PasswordThis field stores the password of the newly-added user. Enter a unique password for the user. You can enter up to 20 characters including letters, numbers, periods and hyphens. Re-enter the password in the password verifi-cation field. Both fields are required.
First/Last NameEnter the first and last name of the user. This informa-tion is displayed when user status is queried. Both fields are required.
Click Submit to upload the user information to the VSX. Repeat this procedure for each new user.
Editing and Deleting Users
In addition to adding users, the Users page enables you to modify the list of authorized users, or to delete users.
Editing Users
To edit a user’s personal information, or to adjust access rights, select a single user listing from the Users page (Fig-ure 25 on page 55) and click its respective Edit link. The Edit User form displays as shown in Figure 27.
57
Sansay VSX User’s Guide
Figure 27. Edit User Form
The fields in this form appear identical to those on the Add User dialog. Make the necessary changes and click Submit. A confirmation dialog displays to verify the new informa-tion. Confirm the information, or click Cancel to abandon the changes. Repeat this procedure for additional users.
Deleting Users
To delete one or more users, select a user from the Users page (Figure 25 on page 55) by checking its respective selec-tion checkbox. Multiple users can be selected in this way. Click Select All to select all listed users.
Click the Delete button. A Confirmation dialog displays to verify the deletion(s). If you change your mind, click Cancel to abandon the delete operation. The Confirmation dialog clears without changing the selected user settings.
Sansay strongly recommends deleting or changing the default username to something unique for each customer. This greatly reduces the security risk with remote access.
58
CHAPTER 9
VIEWING STATISTICS
This chapter describes how to use the Statistics viewer to assess system traffic and performance for the VSX system, its gateways, and routes.
Opening the Statistics Dialog
To access the Statistics dialog (Figure 28), click the Statis-tics tab from the VSX main menu. The Gateway Statistics page displays by default.
Figure 28. VSX Gateway Statistics Dialog
59
Sansay VSX User’s Guide
From this page you can view inbound and outbound Call Attempts (CA), Answer Sieze Ratio (ASR), Failed Call Ratio (FCR), and Average Call Duration (ACD) statistics over 15-minute, one-hour, and 24-hour intervals. ACD is the aver-age time between when an answer message is received and the time the call is disconnected. This is often the same value used for billing.
The Refresh button asserts an immediate update to the Gateway Statistics page. Select the auto-refresh interval by clicking the appropriate radio button.
Viewing Route Statistics
To access the Route Statistics dialog (Figure 29), click the Statistics tab from the VSX main menu. The Gateway Sta-tistics page displays by default. Click Route Stats to display the Route Statistics page.
Figure 29. VSX Route Statistics Window
From this page you can view Call Attempts (CA), Answer Sieze Ratio (ASR), and Fail Call Ratio (FCR) statistics over 15-minute, one-hour, and 24-hour intervals for each table, digit match, route alias, and trunk ID. The Refresh button asserts an immediate update to the Route statistics page. Select the auto-refresh interval by clicking the appropriate radio button.
60
Wiewing Statistics
Viewing System Statistics
VSX System statistics reflect overall system traffic and per-formance. To access the System Statistics page (Figure 30), click the Statistics tab from the VSX main menu. The Gate-way Statistics page displays by default. Click System Statis-tics to display the System Statistics page.
Figure 30. VSX System Statistics Page
61
Sansay VSX User’s Guide
The System Statistics page displays the:
• Number of sessions in progress
• Total number of session attempts
• Peak number of concurrent sessions
• Maximum cuncurrent sessions allowed
• Number of times maximum exceeded
• Time remaining (for demo licences)
• Resource allocations
• Available system space
The Refresh button asserts an immediate update to the Sys-tem Statistics page. Select the auto-refresh interval by click-ing the appropriate radio button. Click Clear to clear the page and begin collecting new statistics.
This page should be checked regularly to ensure that system performance is as expected. The LAN ports should be checked to ensure that errors are not being generated over time. All LAN connections should be Full Duplex to mini-mize transmission errors. Disk space should never fall below 15 GB. If it does, contact Sansay support.
62
CHAPTER 10
EDITING AND DELETING RESOURCES
Read this chapter to understand how to edit and delete the following resources in a VSX environment:
• Gateways
• Routes
How Resources Are Edited
The Resource screen enables you to delete routes and gate-ways from the set of managed resources. The VSX manage-ment software displays warnings when resources to be deleted can affect call traffic. Therefore, you should ensure that any resources to be deleted are carrying no traffic.
63
Sansay VSX User’s Guide
Editing Gateways
To edit a gateway’s configuration, you must first ensure that the gateway is brought out of service. Use the following pro-cedure:
1. Select a gateway from the resource screen. Click the selected gateway’s Edit button.
2. From the Edit Gateway screen, change the gateway’s service state to Provision.
3. From the Edit Gateway screen, change the configuration settings as necessary. When the new settings are com-plete, Click Submit to assert the changes. A Confirma-tion dialog displays to verify the changes.
4. If you change your mind, click Cancel to abort the edits. The Confirmation dialog clears without changing the selected gateway settings.
Deleting Gateways
To delete a gateway from the resource list, use the following procedure:
1. Select a gateway from the resource screen by checking its selection checkbox.
2. Click Delete to delete the Gateway from the resource gateway list. A Confirmation dialog displays to verify the deletion.
3. If you change your mind, click Cancel to abort the dele-tion. The Confirmation dialog clears without changing the selected gateway.
Editing Routes
Use the following procedure to edit a route:
1. Select a route from the Routes screen. Click its respec-tive Edit button. The Edit Route screen displays.
2. From the Edit Route screen, change the configuration
64
Editing and Deleting Resources
settings as necessary. When the new settings are com-plete, Click Submit to assert the changes. A Confirma-tion dialog displays to verify the changes.
3. If you change your mind, click Cancel to abandon the edits. The Confirmation dialog clears without changing the selected route settings.
Deleting Routes
Use the following procedure to delete a route:
1. Select a route from the Routes screen by checking its selection checkbox. Multiple routes can be selected in this way. Click Select All to select all configured routes.
2. Click the Delete button. A Confirmation dialog displays to verify the deletion(s).
3. If you change your mind, click Cancel to abandon the delete operation. The Confirmation dialog clears without changing the selected route settings.
65
Sansay VSX User’s Guide
66
CHAPTER 11
MANAGING THE VSX SYSTEM
This chapter describes how to use the VSX System Page options to modify system settings, manage configurations, and upgrade VSX code.
67
Sansay VSX User’s Guide
System TabThe System page displays read-only information specific to the system’s native hardware and software configuration. The System page is shown in Figure 31.
Figure 31. System Page
The information displayed on the System page is specified by using the Edit System dialog. This must be done when initially configuring the system or when moving the VSX to a different network. For more information, see “Initial Con-figuration” on page 17.
68
Managing the VSX System
The System page displays the following fields and controls:
• Edit System
• Edit Network Connections
• Edit Load-Balance Config
Edit System Page
The Edit System screen is shown in Figure 31. It enables you to change the settings displayed on the System page.
Figure 32. Edit System Page
69
Sansay VSX User’s Guide
From this page you can add or edit the following fields:
Alias NameThis field specifies the alias name for the VSX system. The alias name can be up to 128 alphanumeric characters in length and can include commas, semicolons, spaces, periods, hyphens, underscores, the @ symbol, and question marks.
CDR System NameThe call detail record (CDR) system name parameter speci-fies the CDR filename prefix used for the VSX’s internal file naming convention. Up to eight characters are supported for this filename prefix.
CDR File IntervalSpecify the number of seconds that will transpire between CDR file writes. The default value is 600 seconds (10 min-utes). The value range is 180 to 86,400 seconds.
CDR PasswordThe CDR password enables access to collect call detail records. CDR retrieval can be done by using FTP, SFTP, or SCP. For more information about accessing CDRs, see “Collecting Call Detail Records” on page 81.
Local Payload Port StartThis field displays the base (starting) address for UDP ports used by the VSX system. This value is chosen as a multiple by 4 of the VSX’s call capacity. The default UDP port base address is 10000.
SIP Port AddressSpecify the SIP port address for the VSX system.
H323 Port AddressSpecify the H323 port address for the VSX system.
70
Managing the VSX System
Gatekeeper IDWhen using Gatekeeper-to-Gatekeeper protocol, the VSX must provide the other gatekeeper it's ID. This field is a global gatekeeper ID which will be used for all gate-keeper messages sent from the VSX. This needs to be coordinated with any partners using gatekeeper control for their network.
RAS Port AddressRAS port is used to control what UDP port we send the Radius messages to on the Radius Server. The Shared Secret is the password used for accessing the Radius server.
NTP Server1/2These fields display IP addresses for up to two network time protocol servers used for reference to external time standards.
DNS Server 1/2The VSX can use either a host file or a DNS server to resolve the Fully Qualified Domain Names (FQDNs) to IP addresses. The IP addresses of the DNS servers are entered into these fields.
SIP Reinvite TimerThe VSX can send out a periodic reinvite message to poll the status of the call on the SIP call legs. If the reinvite is not acknowledged the call will be disconnected. This setting controls how frequently the reinvite will be sent out on the call legs. The default value is 11 minutes. The value range is 1 to 180 minutes.
Trace Unauthorized CallThe VSX can automatically log unauthorized calls into the Session Trace file which is viewable in the Trace > Show Session Trace tab. Only one call at a time will be traced, so the file will not get too large or occupy too much processor time. An unauthorized call is one origi-
71
Sansay VSX User’s Guide
nating at an IP address which is not configured in the Resource or Resource Group TIDs.
Current Time/ Time Zone/Date/TimeThese fields display the current system internal time clock/calendar.
NoteWhen changing the VSX FQDN, Default Gateway, Subnet Mask, or Local Payload Port Start settings, the system will prompt you to restart it.
Editing Network Connections
The Edit Network Connections form (Figure 33) enables you to edit FQDN/IP addresses, default gateway addresses, and subnet masks for access networks.
Figure 33. Edit Network Connections Form
LAN Interface FQDN/IPThis field displays the fully-qualified domain name (IP address) of the LAN 1 (public) and LAN2 (private) ethernet ports on the VSX system. This address is specified during initial configuration of the VSX system.
72
Managing the VSX System
Subnet MaskThis field displays the ethernet subnetwork mask for the VSX system. This address is specified during initial configu-ration of the VSX system. The subnet mask controls the boundary between the public and private network address spaces. It indicates how many network addresses are used for the private network; all others are considered public. The default value is 16. The value range is 1-24.
Default GatewayThis field displays the IP address of the default gateway that the VSX will use. This address is specified during ini-tial configuration of the VSX system.
After editing these fields, click Submit to assert the changes or click Cancel to abandon the process.
Advanced Control Panel
Click the Advanced button to access the Advanced Sys-tem control panel shown in Figure 34.
Figure 34. VSX Advanced System Control Panel
From this panel you can:
• Restore a Configuration• Save a Configuration• Upgrade Code• Reboot the System
73
Sansay VSX User’s Guide
• Restart VSX Software• Take the System Offline• Upgrade the System
Restoring A Configuration
The Restore Config button opens the Restore System Configuration form (Figure 35) that enables you to restore the previously-saved configuration after configu-ration changes are made. You can enter the name of the configuration file, or click Browse to navigate to the file you want. After selecting the file, click Submit to rein-state the configuration.
Figure 35. Restore System Configuration Form
Saving a Configuration
The Save Config button opens the Save System Configu-ration dialog (Figure 36) that enables you to save the current configuration to a configuration file.
74
Managing the VSX System
Figure 36. VSX Save System Configuration Dialog
Clicking the active area of the screen opens a browser dialog that enables you to name and store the configura-tion file. It should be noted that the downloaded zip file is not useable for any other purpose than uploading to a VSX. It will not be opened by any other program. The default name is config.zip but should be renamed during the download to a more relevant name. There is also a security issue with some Internet Explorer browsers which can cause the file not to download properly. It is recommended that you use a different browser such as Opera or Firefox if this problem is encountered.
Upgrading VSX Code
The Upgrade Code button opens the Upload Code Upgrade form (Figure 36) that enables you to upgrade or change the system capacity.
Figure 37. VSX Upload Code Upgrade Form
Enter the filename for the code upgrade, or click Browse to navigate to the location of the upgrade file. Click Submit to copy the file.
NoteThe code upload file size is approximately 10 Mbytes and may take over a minute to upload. Please be patient and wait for the upload to finish.
75
Sansay VSX User’s Guide
Rebooting the System
The Reboot System button opens the Reboot System dia-log (Figure 38 on page 76). Click Reboot Now to issue an explicit command that completely reinitializes the VSX system. This action is service-affecting.
Figure 38. VSX Reboot System Dialog
NoteThis action will interrupt service. The VSX code restart is very quick and the downtime should be less then 15 seconds.
Restarting the VSX Software
The Restart Software button opens the Restart Software dialog (Figure 39). Click Restart Now to issue an explicit
76
Managing the VSX System
command that restarts the VSX system software. This action is service-affecting.
Figure 39. VSX Restart Software Dialog
NoteThis action will interrupt service.
Taking the VSX Offline
This action forces the VSX to begin refusing calls. It enables you to drain the calls from the VSX prior to a restart/reboot. All calls that arrive following the execution of this command are replied to with an H.323 "34" or a SIP 503 message. As the existing calls hang up it is possible to wait for all calls to be normally cleared prior to restarting the system. It is par-ticularly useful when load balancing is used in a cluster.
77
Sansay VSX User’s Guide
The System Offline button opens the System Offline dialog (Figure 40). Click Offline Now! to take the VSX offline. This action is service affecting.
Figure 40. System Offline Dialog
NoteThis action will interrupt service.
Upgrading the VSX System
The Upgrade System button opens the Generate System Key (Figure 41 on page 79). This dialog enables you to adjust call capacity, system type, redundancy, and license type for the VSX system. Click Generate System
78
Managing the VSX System
Key to enable the system upgrade. Click Apply Upgrade to update the VSX system.
Figure 41. Generate System Key Dialog
Editing Load Balance
The Load Balancing configuration is used to create a cluster of identically configured systems which share the licenses of a single system. The goal is to establish a redundant config-uration whereby all the origination and termination part-ners are able to send to any VSX in the cluster. This creates an N:1 redundant system that can support multiple fail-over scenarios.
NoteThis button is only viewable if the system has a Load Balanc-ing license.
The configuration involves setting up a Master system and up to 8 Slave systems. The Master is in charge of the config-urations, and the Slave systems are not enabled to edit any parameters. When the configuration on the Master system is changed it is propagated to the Slave systems automati-cally.
The system function is either Master or Slave in the pull down menu. The Slave only inputs the Master IP address, on the Master you need to enter all the Slave's IP address.
79
Sansay VSX User’s Guide
If the databases become out of sync it is could be necessary to execute the "Reset Slave" command which brings the two databases back into lock step.
Using Radius Servers
The VSX System Page allows you to configure the Radius Servers if they are being used. You can configure up to 4 Radius servers for redundancy. Each radius message is sent to the 4 servers in numerical order. Each server will be attempted multiple times set by the Radius Max Resend. The Radius Server page is shown in Figure 42.
Figure 42. Radius Server Page
The Radius Server Shared secret has to be coordinated with the radius system, as well as the UDP used for Authoriza-tion and Accounting. Usually the defaults for the UDP ports are fine. The Radius Resend time can be programmed as well. Depending on the load on the server the resend timer of 3 seconds should be sufficient.
The VSX has a special Radius Recovery feature which increases the reliability of the radius feature. If a specific Radius message is not Acknowledged by any of the pro-grammed radius severs, the VSX will store the message in an error file and will automatically resend the messages to the radius server when it is available again.
80
Managing the VSX System
To edit Radius server settings, click the Edit button. The Edit Radius Server page displays (Figure 43).
Figure 43. Edit Radius Servers Dialog
Use the Radius Server dropdown to enable or disable Radius servers. Click Update to assert your selection.
Collecting Call Detail Records
In order to bill for calls going through the VSX you can retrieve the call detail records (CDRs) by using the Secure Copy Protocol (SCP). The SCP procedure requires a defined user login name with a password. The CDR username and password are configured on the Edit System page. Open an SCP session using one of the following commands:
SCP user@ <IP address>:/CDR/20060401*.cdr
This command will retrieve all the CDR files created on 04/01/2006.
81
Sansay VSX User’s Guide
82
CHAPTER 12
THE VSX CONFIGURATOR
The Sansay VSX features a comprehensive, easy to use graphical user interface that enables you to configure and manage the VSX. Using a standard Internet browser you can access this interface by entering the default IP address of the VSX. The default IP address is 192.168.0.100:8080/.
Logging In
After entering the default IP address of the VSX unit, a wel-come screen displays that enables you to login to the system. The welcome screen is shown below in Figure 44.
Figure 44. VSX Login Screen
Enter your user name and password and click the Login but-ton to proceed to the configuration screens. The default user name is superuser and the default password is sansay.
83
Sansay VSX User’s Guide
Configurator GUI
The VSX configurator consists of six pages that are accessed by clicking their respective tabs. These pages are:
• System • Resources (default)• Routes • Statistics• Trace• Users• Digit Mapping
84
Accessing the Configurator
System PageThe System page displays read-only information specific to the system’s native hardware and software configuration. The Basic System page is shown in Figure 45.
Figure 45. System Page
System Page Controls
The System page displays the following fields and controls:
Edit SystemInvokes the Edit System form that enables you to change the settings displayed on the System page. For more information, see “Edit System Page” on page 69.
85
Sansay VSX User’s Guide
Edit Network ConnectionsThe Edit Network Connections form enables you to edit FQDN/IP addresses, default gateway addresses, and subnet masks for access networks. For more informa-tion, see “Editing Network Connections” on page 72.
Edit Load-Balance ConfigThe Load Balancing configuration is used to create a cluster of identically configured systems which share the licenses of a single system. This button is only viewable if the system has a Load Balancing license. For more information about configuring load balancing, see "Editing Load Balance" on page 79.
Advanced Tab
Click the Advanced tab to access the Advanced System control panel. From this panel you can:
• Restore a Configuration• Save a Configuration• Upgrade Code• Reboot the system• Restart VSX software
For more information, see “Advanced Control Panel” on page 73.Restore Config
The Restore Config button opens the Restore System Configuration form that enables you to restore the previ-ously-saved configuration after configuration changes are made. For more information, see “Restoring A Con-figuration” on page 74.
Save ConfigThe Save Config button opens the Save System Configu-ration dialog that enables you to save the current config-uration to a configuration file. For more information, see “Saving a Configuration” on page 74.
86
Accessing the Configurator
Upgrade CodeThe Upgrade Code button opens the Upgrade Code form that enables you to upgrade or change the system capac-ity. For more information, see “Upgrading VSX Code” on page 75.
Reboot SystemThe Reboot System button opens the Reboot System dia-log. Click Reboot Now to issue an explicit command that completely reinitializes the VSX system. This action is service-affecting. For more information, see “Rebooting the System” on page 76.
Restart SoftwareThe Restart Software button opens the Restart Software dialog. Click Restart Now to issue an explicit command that restarts the VSX system software. This action is service-affecting. For more information, see “Restarting the VSX Software” on page 76.
Radius Server Tab
The Radius Server tab enables you to configure Radius Servers if they are being used. You can configure up to 4 Radius servers for redundancy. For more information about Radius servers, see "Using Radius Servers" on page 80.
System Page Field Descriptions
Alias NameThis field specifies the alias name for the VSX system. The alias name can be up to 128 alphanumeric charac-ters in length and can include commas, semicolons, spaces, periods, hyphens, underscores, the @ symbol, and question marks.
System ModeThis field specifies the type of server the VSX will func-tion as. The default value is Call Server. The Media Server function will be supported in a future release.
87
Sansay VSX User’s Guide
Current Time/ Time Zone/Date/TimeThese fields display the current system internal time clock/calendar.
NTP Server1/2These fields display IP addresses for up to two network time protocol servers used for reference to external time standards.
CDR System NameThe call detail record (CDR) system name parameter specifies the CDR filename prefix used for the VSX’s internal file naming convention. Up to eight characters are supported for this filename prefix.
CDR File IntervalThis parameter specifies the number of seconds that will transpire between CDR file writes.
System FQDN 1This field displays the fully-qualified domain name (IP address) of the VSX system. This address is specified during initial configuration of the VSX system.
Default GatewayThis field displays the IP address of the default gateway that the VSX will use. This address is specified during initial configuration of the VSX system.
Subnet MaskThis field displays the ethernet subnetwork mask for the VSX system. This address is specified during initial con-figuration of the VSX system.
Local Payload Port StartThis field displays the base (starting) address for UDP ports used by the VSX system. This value is chosen as a multiple by 4 of the VSX’s call capacity. The default UDP port base address is 10000.
88
Accessing the Configurator
SIP Port AddressThis parameter specifies the SIP port address for the VSX system.
H323 Port AddressThis parameter specifies the H323 port address for the VSX system.
The information displayed on the System page is specified by using the Edit System dialog. This must be done when initially configuring the system or when moving the VSX to a different network. For more information, see “Edit System Page” on page 69.
Resources Page
After login, the Resource page displays by default. It dis-plays existing connected gateways, IP phones/clients, soft switches, and proxies. In addition, it enables you to add additional gateways and edit existing access parameters. The Resources page is shown in Figure 46.
Figure 46. VSX Resources Page
89
Sansay VSX User’s Guide
The Resources page provides the following fields and con-trols:
Add GatewayInvokes the Add Resource Gateway dialog. For more information about adding gateways, see “Adding and Configuring Resources” on page 25.
Search ControlSorts and lists gateway entries using the first letter of the Company Name field.
Check AllSelects all entries on the Resources page.
DeleteDeletes the selected resources.
Trunk IDDisplays the gateway’s configured Trunk ID.
Company NameDisplays the owner of the configured gateway/resource.
AliasDisplays the alias name given to the gateway/resource.
FQDN/IPDisplays the fully-qualified domain name/IP address for the managed resource.
ProtocolDisplays the signaling protocol assigned to the resource.
PortDisplays the port address used by the resource.
90
Accessing the Configurator
EditInvokes the Edit Resource Gateway dialog. For more information, see “Editing and Deleting Resources” on page 63.
Help Displays online help for the Resources screen.
LogoutLogs out the user and dismisses the Resources screen.
Routes Page
The Routes page enables you to add new routes, or view and edit existing routes. The Routes page is shown in Figure 47.
Figure 47. VSX Routes Page
The Routes page provides the following fields and controls:
Add RouteInvokes the Add Route dialog. For more information about adding routes, see “Adding and Configuring Routes” on page 39.
91
Sansay VSX User’s Guide
Upload Route TableEnables you to upload the Route table in XML or CSV file format. For more information about uploading route tables, see “Importing Routes and Tables” on page 45.
Download Route TableEnables you to download the Route table in XML or CSV file format. For more information about uploading route tables, see “Exporting Routes and Tables” on page 47.
Search ControlSorts and lists route entries using the first letter of the Alias field.
Check AllSelects all entries on the Routes page.
DeleteDeletes the selected routes.
Digit MatchDisplays digit matching criteria for route selection based on the dialed number.
AliasDisplays the alias name assigned to a route.
Route #1-8Displays the routing table associated with each route entry. A primary route and up to seven alternate routes are supported.
EditInvokes the Edit Route dialog. For more information about editing routes, see “Editing and Deleting Resources” on page 63.
LogoutLogs out the user and dismisses the Routes screen.
92
Accessing the Configurator
Users Page
The Users page displays all users authorized to access the VSX system. Initially, the superuser entry displays by default. The Users page is displayed in Figure 48.
Figure 48. VSX Users Page
The Users screen provides the following fields and controls:
Add UserInvokes the Add User dialog. For more information about adding users, see “Managing Users” on page 55.
Search Control Sorts and lists User entries using the first letter of the User ID field. Click All to list all users.
Check AllThe checkbox next to the User ID column selects all entries on the Users page.
DeleteDeletes the selected users.
93
Sansay VSX User’s Guide
User IDDisplays a hyperlinked reference number for the listed user. Clicking this link displays information specific to the selected user.
AuthorizationDisplays the access priveleges granted to the user by the superuser. Access rights can be Superuser, Admin, or Read Only.
Last Login Date/TimeDisplays the most-recent session the listed users were engaged in.
Remote HostDisplays the IP address of the remote host associated with a listed user.
EditInvokes the Edit User dialog. This dialog is used to mod-ify individual user information. For more information, see “Managing Users” on page 55.
Monitoring Page
The VSX Monitoring page is shown in Figure 49 on page 95. Inbound or outbound statistics are collected for in-service trunks at 15- minute, 1-hour, and 24-hour intervals. The Gateway Stats page displays by default.
94
Accessing the Configurator
Figure 49. VSX Gateway Stats Page
For trunks that are in service, the following statistics are displayed:
• CA (Inbound/Outbound calls Attempted)
• ASR (Inbound/Outbound Answer Sieze Ratio)
• FCR (Inbound/Outbound Failed Call Ratio)
• ACD (Inbound/Outbound Average Call Duration)
For More Information, see See "Viewing Statistics" on page 59.
95
Sansay VSX User’s Guide
Trace Page
If calls are failing you may need to enable tracing for the problem gateway or routes. The Trace page enables you to perform traces for troubleshooting purposes.
Figure 50. Sansay VSX Trace Dialog
The Trace page provides the following fields and controls:
• View Call Sessions
• View H323 Protocol
• View SIP Protocol
• Advanced
For more information, see See "Failing Calls" on page 101.
96
CHAPTER 13
SANSAY SOAP CLIENT
This section describes the usage of XML and the SOAP cli-ent used to control the VSX configuration. The SOAP client is not required to use XML with the VSX but it is a conve-nient way to do so. This section discusses how to use the SOAP client but much of it is relevant to systems using direct XML without the Sansay SOAP API.
XML Schema
The SOAP client includes a number of files which are XML schema. These represent the format of the database struc-ture which can be updated on the VSX using XML. It is important to note that the database structure changes as new features are added to the VSX system. If you upgrade a version of software it may include new features which are not in the SOAP client's XML file schema. As such it is worthwhile to Export the new configuration in the GUI using the Export > XML button on the Resource or Route tabs on a new system or after a significant version change.
Editing XML Files
Many companies have an automated system for generating XML files. This might be a billing application, or a special-ized Least Cost Routing application. XML files can also be generated manually. The files can be modified by a number of application such as MS Word or MS Excel. A good free
97
Sansay VSX User’s Guide
XML editor is XML SPY Home Edition and can be found at Altova.
Most of the parameter values in the XML files are explained in other parts of the VSX User Guide for the version of soft-ware in use. The option descriptions will not be repeated here, please refer to the relevant pages for detailed usage.
SOAP Client Functions
The XML interface supports the following functions:
• Add
• Delete
• Upload
• Download
• Update
These functions can be applied to the following database structures:
• Resource
• Resource Group
• Route
• Route Table
• Route Group
• Digit Map Table
• Digit Map Entry
SOAP is a Java application and requires JRE 2.3 or newer. It is designed to run on any OS that supports this environ-ment. In a windows workstation the application can be run from a DOS window inside the directory where the client resides. For a list of variables option you can simply run: run.bat -?. This will present you the proper syntax for the XML commands which you can use to direct your com-mands.
98
Sansay SOAP Client
An example command is c:\soap\run.bat -a192.168.1.2 -usuperuser -psansay upload newroutes.xml route
This will direct the client to login to the VSX at 192.168.1.2 with username superuser, password sansay, and upload the route file newroutes.xml. Keep in mind that an upload will replace the existing route table with the one being uploaded. This means that every route must exist in the table to be uploaded.
An update to the route table will change routes that are in the XML file but not affect ones which are not in the XML file. If there are entries in the XML file that are not in the route table, it will add those entries to the route table.
• Centralizes routing tables
• Centralized & accurate CDRs
• Simplifies Gateway configurations
• Intelligent Route Hunting enhances ASRs
• Is secure and scalable
• Provides real-time performance monitoring
99
Sansay VSX User’s Guide
100
CHAPTER 14
TROUBLESHOOTING
Read this chapter for information on solving problems you may encounter when using the VSX Configurator and ses-sion controller.
Failing Calls
If calls are failing within your network you can verify this by using the Statistics tab. This will show you the percentage of answered calls as well as the percentage of failed calls within the VSX. You can monitor either all the calls inbound from a resource or just the calls outbound to a specific route.
To monitor the Inbound calls, select the Statistics tab and then click the Show Gateway Statistics button. This will show you the calls inbound from each Gateway or partner. The first column is the Trunk ID associated with the resource, the company name, and the gateway alias. The display can be sorted by clicking on the heading for each of these headings. Each TID will show the Inbound Call Attempts (CA), the Answered Sieze Ratio (ASR), and the Failed Call Ratio (FCR).
The ASR is the ratio of the answered calls on the TDM side of the GW versus call attempts. It will normally indicate below 100% because not all calls are answered. If the ASR is 100%, most likely the end gateway is providing you answer supervision on all calls whether they are answered or not.
101
Sansay VSX User’s Guide
This would indicate an unreliable network, and you should recognize the limitations of such a route.
It is important to realize that the statistics displayed are valid only after a statistically valid sample is taken. For example, four successful calls out of five calls is not signifi-cant in terms of long-term percentages. Only when you have above 15-20 calls can you draw any meaningful comparison.
An exception is when the FCR is at 100%. This means that every call has returned a failed call setup. If you have made a change or if this is a recent addition, an FCR of 100% points to a problem. However, when you see the FCR drop below 100%, or when the ASR is above zero, at least some calls are going through. This would indicate a probable cor-rect configuration.
Failed calls occur normally within a VoIP network and are not necessarily a sign of misconfiguration. A failed call can be the result of insufficient capacity, or a misdialed number from the caller. Ideally, the administrator will develop a sense of what the Failed Call Ratio (FCR) is on a particular resource or route and monitor it for change.
The Average Call Duration (ACD) is useful on Outbound Route Statistics. This parameter, shown in seconds, is the average talk time associated with all answered calls. It is the period of time from the Call Answer to the Call Discon-nect messages. If this number is low ( less than 60 seconds) it may reflect bad voice quality. If this is very low (less than 10 seconds) it may reflect a signaling problem or some type of broken audio path. The ACD on international long dis-tance calls over TDMs is approximately 180 seconds. VoIP calls should be in the same range, given a large enough sam-ple.
102
Troubleshooting
Tracing Calls
If the calls are failing you may need to enable tracing for the problem gateway or routes. Tracing is enabled by editing the route or gateway and changing the Service State to Trace. You can then select the Trace tab and use the menu selec-tions.
Figure 51. VSX Trace Window
The Trace dialog provides the following fields and controls:
• View Call Sessions
• View H323 Protocol
• View SIP Protocol
• Advanced
Once you have determined that you may have a routing issue in your network the best place to start is the Trace tab. Normally you have to enable tracing for calls to be traced but there are some exceptions. If a SIP or H.323 message experiences a parsing problem, it will automatically be writ-ten into the trace file for that protocol. Likewise, all calls that use the TID Direct Dialing method of call routing are automatically traced in the View Call Session log as well as the protocol trace on both the inbound and outbound legs. This helps you bring up new routes and observe perfor-mance with test calls to that route.
103
Sansay VSX User’s Guide
Viewing Call Sessions
To view a call session, select the Trace tab and click on the View Call Sessions button. The Call Session trace log (Fig-ure 52) displays basic information about each call which you can verify against expectations.
Figure 52. Call Sessions Trace Log
The View Call Sessions is a very concise and easy to read display of each session that originates or terminates on a traced route or resource. Keep in mind when looking at the trace that calls are not viewable in any of these pages until the call is torn down. An active call is not displayed.
The View Call Session is broken into four parts. The top part shows the session ID number and the overall VSX discon-nect (or release) cause. Hopefully the release cause is a "Normal" which means that the originator or terminator hung up the answered call. This part also shows the Start
104
Troubleshooting
time for the session, the Answer time (if empty it means it was unanswered), and the Release time. One line shows the Stack Cause for either the Originating (O) or Terminating (T) side of the call. These are in accordance with either the IDSN Cause Code (H.323) or the SIP message type. Please see the appendix for cause code listings in “Release Causes” on page 122.
The second portion of the sesson trace shows the Origination TID and the protocol used on this session. The ANI and the DNIS are shown as they arrived to the VSX (untranslated). The IP/UDP for the signaling and media are also shown as is the CODEC list provided on the incoming calls.
The third portion of the trace shows essentially the same information on the Termination side of the call. In this case the information is exactly as it leaves the VSX, ie., post translation. The codec list here should reflect the CODEC used on the call.
The fourth portion shows the media packets that were sent and received on the call. The Orig line shows the voice pack-ets inbound from the origination gateway (Pkt In) and the packets outbound toward the origination gateway (Pkt Out). The bottom line shows the voice packets sent and received from the terminating gateway.
105
Sansay VSX User’s Guide
H323 Protocol Log
For H.323 protocol issues click on the View H.323 Protocol button for further information. The H.323 trace log displays as shown in Figure 53.
Figure 53. H.323 Trace Log
When you have finished examining the trace, click Done to exit the trace log.
106
Troubleshooting
SIP Protocol Log
For SIP protocol issues click on the View SIP Protocol but-ton for further information. The SIP trace log displays as shown in Figure 54.
Figure 54. SIP Protocol Trace Log
When you have finished examining the trace, click Done to exit the trace log.
107
Sansay VSX User’s Guide
Advanced Trace
Advanced tracing gives a detailed view of Call sessions, Pro-tocol tracing and VSX System processes. Advanced tracing tools should only be used under the guidance of the Sansay technical support staff. They are used for detailed debugging of system software. They are not needed for normal trouble-shooting or diagnostics. Large amounts of data are created and these traces should not be left enabled for any length of time.
Figure 55. Advanced Trace window
When you have finished examining the trace, click Hide Advanced to exit the Advanced trace log.
108
Troubleshooting
Configuration Problems
This section presents a summary of the common causes of configuration errors and suggestions to troubleshoot each:
1. A conflict with a selected protocol. • Ensure that the proper protocol is selected for SIP or
H.323 devices.
2. A routing error. • Ensure that the routing rules are consistent with the
call destination. Inspect the routing table entries.
Retrying the Configuration
After eliminating the possible causes of the problem described above, verify connectivity.
If the problem continues, gather the information listed below, record the information and contact Sansay Technical Support.
Information about the Installation
1. Configuration parameters for the gateway in question2. Routing parameters for the route in question3. The number of gateways the problem is occurring on:
(All / Many / Some / Few / One) gateway(s). 4. How frequently the problem occurs: (All / Many / Some /
Few) installation attempts. 5. What custom resources, if any, are in the network?
109
Sansay VSX User’s Guide
Troubleshooting the VSX
If problems occur with the VSX, there are a number of steps you can take to resolve the issue. The list below contains troubleshooting ideas and suggestions.
Basic Steps
• Keep detailed configuration records. Having records always helps track down problems. Be sure to include the names and IP addresses of each resource gateway and softswitch in your network, and where these units are physically located. This list will be an invaluable reference when performing diagnostics.
• Verify the integrity of the network. Make sure you can reach every softswitch and gateway on the network. This can be done through a number of network diagnos-tic tools. One good tool is the ping utility. Ping sends out packets to a remote site, which then returns the packets if the site is up and running properly. Ping is available on DOS and LINUX. The command is: ping <host-name>. You can use an IP address or hostname with ping.
• Verify that the gateways are functioning properly. Make sure the resource gateways in your network are running properly, and are not reporting alarms. Also check the individual configuration of each gateway to ensure that there are no errors or conflicts. Check the Statistics|System page and verify the Ethernet connec-tion is working properly. In general it is expected to be 100 BT FD (full duplex).
• If your VSX is at a remote site, verify that the site is reachable over the network. Make sure the VSX server is running properly. Access the System page of the VSX configurator. This page lists all the events from the event server that have occurred in log form. Examine the log for any anomalies that could point to the symp-toms or cause of a problem. It also lists the VSX’s pro-cesses that are currently running. If a process is down, rebooting the server might bring it back up.
110
Troubleshooting
Frequently Asked Questions
This section lists the most common questions raised while installing and configuring the VSX and related components. If you have encountered a problem, check here to see if your issue is addressed.
Table 1. Possible Problem Solutions
Description Corrective Action
1 How often is the VSX's status updated? The VSX polls the gateway every 20 seconds if it senses no gateway activity.
2 How do I temporarily disable a trunk without deleting it?
Change its Service State to Provision or Block.
3 I have configured a gateway and a route. However, I keep getting a busy tone when I dial the outgoing number. How can I pinpoint the problem?
First, check the In/Out Action rule to ensure that apply-ing the In/Out Action will produce dialed digits that match the configured route.
Make sure that the prefix and DNIS are the correct ones the terminating partner is expecting.
4 What happens if a cable is inadvertently disconnected?
Reconnect the cable and re-organize the operating environment surrounding the server(s).
If the Network cable was disconnected, the VSX will attempt to reconnect within 5 seconds.
If the power cable was disconnected, then the system will come back up after power is re-applied, assuming there were no corruption/damage done to the file sys-tem(s). If the filesystem was damaged, Contact Sansay TAC for assistance on how to recover.
111
Sansay VSX User’s Guide
5 What In Action/Out Action rule should I use?
In/Out Action rules define how dialed digits are parsed before a route search begins. It is used for speeding up route searches. In a PSTN, telephone numbers are pro-visioned such that an EO switch for the dialed number can be efficiently located as digits are dialed.
In North America, telephone numbers (dialing plans) are ten digits in length and use the following format: NPA-NXX-XXXX. NPA is also known as area code, NXX the EO code, and XXXX the subscriber's number. At each level of the PSTN's switch, only a certain number of dig-its in the dialed number are examined to figure out the next switch to pass the phone call to.
In the current PSTN, because switches are organized in a level structure (Class 5, Class 4, etc.), each switch only needs to know how to parse digits at its own level. Within the VSX, the level structure no longer applies. The VSX can have its trunks connected to all levels and across a diverse set of dialing plans (North America, India, etc.).
In/Out Action rules are used to help process different dial plans. Because each trunk group is connected to one switch which has only one dial plan, a In/Out Action rule can be configured for the trunk group that informs the VSX about the dial plan of the incoming call. In/Out Action rules should be used in conjunction with the dial plan in the route table.
For example, in the route table, suppose that one has a route going into the 408 area code as 1 408. Trunks that have a route to area code 408 should have a In/Out Action rule established as 1 3, which means if the first dialed digit is “1” then take the next 3 digits and see if a route can be found. If the caller dials 1-408-555-1234 then the route is selected. If one dials 1-303-555-1234 then no route is found because no 1 303 route exists in the route table.
6 Power fail and restart procedure The system should recover by itself without user inter-vention.
If the system cannot initialize, error messages would display on the terminal/console screen. Contact Sansay TAC for assistance on how to identify the problem.
7 What aids do I have for Fault Detection, Isolation and Recovery?
There are currently no automated procedures for this purpose. Contact Sansay TAC for assistance.
8 How do I measure CPU utilization? Access the VSX Configurator System page from a stan-dard web browser.
Table 1. Possible Problem Solutions
Description Corrective Action
112
Troubleshooting
Getting Help
If after installing and configuring your Sansay equipment, you cannot establish communications to or from the unit, carefully review the information in this book prior to calling Sansay’s Technical Assistance Center (TAC).
Checklist
Ensure that you have checked the following possibilities:
• Reset the equipment. When cycling power, be sure to leave the power off for a minimum of 30 seconds before reapplying power to the unit.
• Check your software version. To ensure that all our cus-tomers have the latest enhancements and product fea-tures, Sansay ships every new or factory-upgraded unit with the latest software version.
Therefore, whenever you are installing units into your system, check each unit to verify that all units are equipped with identical software versions.
113
Sansay VSX User’s Guide
Contacting TAC
If, after carefully reviewing the information in this book your problem persists, contact either your product represen-tative or a service representative at Sansay’s Technical Assistance Center. Prior to calling, ensure that you have assembled all the pertinent data that will assist in resolving your problem. These items include:
• A detailed description of your problem
• A complete listing of your system components and con-figuration. Include your unit’s serial number and the software version number it is running
• A narrative of the actions you performed prior to the problem
• A list of all system messages posted by your unit
Your Sansay service representative will advise you as to the appropriate course of action.
Contacts
Address:
Sansay, Inc.4650 Lusk Blvd. Suite E204San Diego, CA 92121 USA
Telephone:
1-858-678-0200
114
APPENDIX A
CALL DETAIL RECORDS
This chapter defines the content and structure of Sansay's call accounting records–call detail records–in ASCII format, which is applicable to the Sansay VSX. In addition, the func-tional requirements for the VSX are also listed along with the assumptions for the external billing systems.
Introduction
Call detail records (CDRs) are an integral part of the VSX as they contain the usage information to bill your customers. Therefore, you should review the CDR formats in this chap-ter for complete information on the CDR fields. .
Table 1. CDR Header Structure
Parameter Max ASCII Characters
Description Notes
Record Sequence Num-ber
9 Unique identification of this record
Version Number 5 Format version number of records to follow
Record Type 1 Type of CDR being generated 1
Record Data Variable Parameters as defined in “File Retrieval Procedure” on page 127.
2
Notes:1. Current version: V1.8
2. Type: R - Normal CDR record, A - Audit
115
Sansay VSX User’s Guide
CDR fields that contain no data will contain the string NA. The semicolon character (;) is used as a delimiter to separate the fields of a CDR record. Each CDR record in the file is separated by a line feed character (\n).
Call Detail Record Body
The call record parameters shown in Table 2 contain rele-vant information related to a call.
Table 2. Call Detail Record Body
Parameter Max ASCII Characters
Description Notes
ConnectionType 16 Type of connection
SessionID 32 Unique ID assigned to the call by SSM subsystem
Release Cause 4 See “Release Causes” on page 122.
Start Time of Date 32 Indicates Time of Date when the call entered the system
Answer Time of Date 32 Indicates TOD when the call was answered
Release TOD 32 Indicates the TOD when the call was disconnected
Minutes West of Green-wich Mean Time
32 Minutes West of Greenwich Mean Time. Used to calculate the time zone.
Release Cause from Pro-tocol Stack
32 Release cause string from either H323 or SIP protocol stack
New in v1.1
Binary Value of Release Cause from Protocol stack
4 Binary value of the protocol release cause
New in v1.1
First release dialogue 1 O: origination, T: termination New in v1.1
Trunk ID -- Origination 6 Trunk ID for origination GW (resources)
use previous value
VoIP Protocol - Origina-tion
6 VoIP protocol for origination dia-logue
Origination Source Num-ber
128 Source Number in Origination Dia-logue
Origination Source Host Name
128 FQDN or IP address for Source GW in Origination Dialogue
116
Call Detail Records
Origination Destination Number
128 Destination Number in Origination Dialogue
Origination Destination Host Name
128 FQDN or IP address for Destination GW in Origination Dialogue
Origination Call ID 128 Unique ID for the origination dia-logue (leg)
Origination Call ID 128 Unique ID for the origination dia-logue (leg)
Origination Remote Pay-load IP Address
16 Remote Payload IP address for origination dialogue
Origination Remote Pay-load UDP Address
6 Remote Payload UDP address for origination dialogue
Origination Local Payload IP Address
16 Local (VSX) Payload IP address for origination dialogue
Origination Local Payload UDP Address
6 Local (VSX) Payload UDP address for origination dialogue
Origination Codec List 128 Supported Codec list (separated by comma) for origination dialogue
Origination Ingress Pack-ets
10 Number of Ingress (into Sansay system) payload packets in origina-tion dialogue
Origination Egress Pack-ets
10 Number of Egress (out from San-say system) payload packets in origination dialogue
Origination Ingress Octets 10 Number of Ingress (into Sansay system) payload octets in origina-tion dialogue
Origination Egress Octets 10 Number of Egress (out from San-say system) payload octets in origi-nation dialogue
Origination Ingress Packet Loss
10 Number of Ingress (into Sansay system) payload packet loss in origination dialogue
Origination Ingress Delay 10 Average Ingress (into Sansay sys-tem) payload packets delay ( in ms) in origination dialogue
Origination Ingress Packet Jitter
10 Average of Ingress (into Sansay system) payload packet Jitter ( in ms) in origination dialogue
Table 2. Call Detail Record Body
Parameter Max ASCII Characters
Description Notes
117
Sansay VSX User’s Guide
Trunk ID -- Termination 6 TrunkID for termination GW (resources)
VoIP Protocol - Termina-tion
6 VoIP protocol from termination GW
Termination Source Num-ber
128 Source Number in Termination Dia-logue
Termination Source Host Name
128 FQDN or IP address for Source GW in Termination Dialogue
Termination Destination Number
128 Destination Number in Termination Dialogue
Termination Destination Host Name
128 FQDN or IP address for Destination GW in Termination Dialogue
Termination Call ID 128 Unique ID for the termination dia-logue (leg)
Termination Remote Pay-load IP Address
16 Remote Payload IP address for ter-mination dialogue
Termination Remote Pay-load UDP Address
6 Remote Payload UDP address for termination dialogue
Termination Local Payload IP Address
16 Local (VSX) Payload IP address for termination dialogue
2.00,2.10
Termination Local Payload UDP Address
6 Local (VSX) Payload UDP address for termination dialogue
C,2.00,2.10
Termination Codec List 128 Supported Codec list (separated by comma) for termination dialogue
C,2.00,2.10
Termination Ingress Pack-ets
10 Number of Ingress (into Sansay system) payload packets in termi-nation dialogue
I,2.00,2.10
Termination Egress Pack-ets
10 Number of Egress (out from San-say system) payload packets in ter-mination dialogue
f,C,2.00,2.10
Termination Ingress Octets
10 Number of Ingress (into Sansay system) payload octets in termina-tion dialogue
d,2.00,2.10
Termination Egress Octets 10 Number of Egress (out from San-say system) payload octets in ter-mination dialogue
g,2.00,2.10
Termination Ingress Packet Loss
10 Number of Ingress (into Sansay system) payload packet loss in ter-mination dialogue
i,2.00,2.10
Table 2. Call Detail Record Body
Parameter Max ASCII Characters
Description Notes
118
Call Detail Records
Detail Field Information
Termination Ingress Delay 10 Average Ingress (into Sansay sys-tem) payload packets delay ( in ms) in termination dialogue
f,C,2.00,2.10
Termination Ingress Packet Jitter
10 Average of Ingress (into Sansay system) payload packet Jitter ( in ms) in termination dialogue
d,2.00,2.10
Final Route Indication 1 F: Final Route Selection, I: Inter-mediate Route Attempts
New in V1.3
Routing Digits 64 Routing Digit (Digit after Inbound translation, before Outbound Translation).
New in 1.4
Call Duration in Second 6 Call Duration in Seconds. 0 if this is a failed call
New in 1.5
Post Dial Delay in Sec-onds
6 Post dial delay (from call attempt to ring). 0 if this is a failed call
New in 1.6
Ring Time in Second 6 Ring Time in Seconds. 0 if this is a failed call
New in 1.6
Duration in mini-seconds 10 Call duration in mini-seconds New in 1.8
Conf_ID 36 Conference ID New in 1.9
Table 3. Detail Field Information
Field name Size in Bytes
ConnectionType 16
SessionID 32
Release Cause 4
Start Time of Date 32
Answer Time of Date 32
Release TOD 32
Minutes West of Greenwich Mean Time 32
Release Cause from Protocol Stack 32
Binary Value of Release Cause from Protocol stack 4
First release dialogue 1
Table 2. Call Detail Record Body
Parameter Max ASCII Characters
Description Notes
119
Sansay VSX User’s Guide
Trunk ID - Origination 6
VoIP Protocol - Origination 6
Origination Source Number 128
Origination Source Host Name 128
Origination Destination Number 128
Origination Destination Host Name 128
Origination Call ID 128
Origination Remote Payload IP Address 16
Origination Remote Payload UDP Address 6
Origination Local Payload IP Address 16
Origination Local Payload UDP Address 6
Origination Codec List 128
Origination Ingress Packets 10
Origination Egress Packets 10
Origination Ingress Octets 10
Origination Egress Octets 10
Origination Ingress Packet Loss 10
Origination Ingress Delay 10
Origination Ingress Packet Jitter 10
Trunk ID -- Termination 6
VoIP Protocol - Termination 6
Termination Source Number 128
Termination Source Host Name 128
Termination Destination Number 128
Termination Destination Host Name 128
Termination Call ID 128
Termination Remote Payload IP Address 16
Termination Remote Payload UDP Address 6
Termination Local Payload IP Address 16
Termination Local Payload UDP Address 6
Termination Codec List 128
Table 3. Detail Field Information
Field name Size in Bytes
120
Call Detail Records
Termination Ingress Packets 10
Termination Egress Packets 10
Termination Ingress Octets 10
Termination Egress Octets 10
Termination Ingress Packet Loss 10
Termination Ingress Delay 10
Termination Ingress Packet Jitter 10
Final Route Indication 1
Routing Digits 64
Call Duration 6
PDD 6
Ring Time 6
Call Duration in ms 10
Conf-ID 36
Table 3. Detail Field Information
Field name Size in Bytes
121
Sansay VSX User’s Guide
Release Causes
This Section provides a list of the Sansay VSX Call Release causes. The CDR records generated by the Sansay VSX con-tains four fields that can be used to determine the exact cause of a call termination.
1. Session Release Causes: ( Field #3 in CDR body)
This is mainly for successful calls ( answered, ring no answer) calls. All session release causes of 00x indicates the call is not failed ( Field #3 in CDR body). For all the failed calls, the released stack and stack release cause can provide more information.
Table 4. Release Codes
Cause Code Description
01 Normal answered call
02 No Answer, tear down by originator
03 No answer, tear down by the termination
04 NORMAL_NO_ANSWER, tear down by system
402 Service Not Available
403 Termination capability incompatible
404 Outbound digit translation failed
405 Termination rejected for some other reason
406 Termination Route is blocked
500 Originator is not in the Authorized list (source verifica-tion failed)
501 Origination digit translation failed
502 Origination direction is not bi-directional or inbound
503 Origination is not in service state
600 Max system call handling reached
601 System reject call
602 System outbound digit translation error (maybe invalid configuration)
603 System inbound digit translation error (maybe invalid configuration)
122
Call Detail Records
2. 1st Release Dialogue (Field #10 in CDR) – a one char-acter value identifying the side of the call that initiated the teardown.
3. Release Cause from Stack (Field # 9 in CDR0) – an integer value based on the releasing dialogue's protocol. For a H.323 call leg originated release, it will be the real Q.931 value received from the far side.
Q.931 release causes include the following:
For a SIP call leg originated release, it's a RFC 3261 release cause value received from the far side.
Table 5. 1St Release Codes
Cause Code Description
O Origination initiated the teardown.
T Termination initiated the teardown
N The VSX internally initiated the teardown
Table 6. Release Codes from Stack
Cause Code Description
3 No route to destination
16 Normal clearing
17 User Busy
19 No answer from user
21 Call rejected
28 Address incomplete
34 No circuit channel available
123
Sansay VSX User’s Guide
The following is the list that of messages the VSX generates when a specific event occurs:
For a VSX system-originated release, an internal release cause for teardown occurs. If the VSX initiates a call tear-down, the following cause values and strings are written into the CDR:
Table 7. Release Messages from VSX
Cause Code Description
400 “Parse Failed” Malformed message
405 “Method Not Allowed”
Unsupported method
415 “No valid codec” No valid codec could be supported between orig and term call legs.
480 “Temporarily Unavailable”
Overload Throttle Rejection, Max Sessions Exceeded, Demo License Expired, Capacity Exceeded on Route, Radius Server Timeout
481 “Transaction Does Not Exist”
Unknown transaction or dialog
487 “Transaction Ter-minated”
Origination cancel
488 “ReInvite Rejected”
Relay of ReInvite was rejected
500 “Sequence Out of Order”
CSeq counter violation
504 “Server Time-out” Internal VSX failure
Table 8. VSX Internal Release Causes
Cause Code Description
987 “Termination Capacity Exceeded”
Termination capacity exceeded
987 “Origination Capacity Exceeded“
Origination Capacity Exceeded
987 “Term CPS Capacity Exceeded“ Term CPS Capacity Exceeded
987 “Orig CPS Capacity Exceeded“ Orig CPS Capacity Exceeded
987 “Max H323 Legs Exceeded“ Max H323 Legs Exceeded
999 "Demo Licence Expired!" Demo Licence Expired!
999 “VSX Capacity Exceeded" VSX Capacity Exceeded
999 “VSX Operator Reset" VSX Operator Reset
124
Call Detail Records
4. Release Cause String (Field #8 in CDR)- a string of text further identifying the teardown circumstance.
Sample CDR record
An example Call Detail Record is provided below:
Example VSX Call Detail Record
999 “Route Rejected" Route Rejected
999 “Radius Rejected" Radius Rejected
999 “Radius Access Timeout" Radius Access Timeout
999 “Gatekeeper Reject" Gatekeeper Reject
999 “Enum Server Reject" Enum Server Reject
999 “Enum Server Timeout" Enum Server Timeout
999 “DNS Server Reject" DNS Server Reject
999 “DNS/GK Timeout" DNS/GK Timeout
999 “Could not allocate media" Could not allocate media
999 “No Response to INVITE" No Response to INVITE
999 “Ring No Answer Timeout" Ring No Answer Timeout
999 “200 OK Timeout" 200 OK Timeout
999 “Maximum Duration Exceeded" Maximum Duration Exceeded
Table 8. VSX Internal Release Causes
Cause Code Description
002452502;V1.2;R;WithMedia;[email protected];0001;Mon Dec 15 11:38:34 2003;Mon Dec 15 11:38:41 2003;Mon Dec 15 11:38:48 2003;480; EndedByRemoteUser;3;T;000200;H323;;192.188.0.38;9001;192.188.0.28;f0faff54-2e6c-11d8-8c4b-bd4d562c2265;192.188.0.38;18044;192.188.0.28;10756;G.729b;240;460;6066;14060;0;0;0;000200;H323;;192.188.0.28;8811;192.188.0.38;e83af3d3-1d2d-d811-9f98-003048424934;192.188.0.38;19236;192.188.0.28;10758;G.729b;460;240;14060;6066;0;0;0; F;9001;
125
Sansay VSX User’s Guide
CDR File Storage/Retrieval
This section describes the methods used to store and retrieve Sansay CDRs.
File Storage Policy
By default, all CDR files are kept on the system for at least 360 hours. CDR files which are older than 240 hours will be deleted by the VSX system automatically in order to save disk space.
The CDR file is generated in a configurable time interval. The time interval can be configured from 60 seconds to 99,999 seconds.
File Naming Convention
All CDR files are stored on the VSX system at the default directory (/CDR) with the following naming convention:
The file name is assembled using the format YearMonth-Date-HHmm-BeginCDRSeq-EndCDRSeg.xxx, where the Year is 4 digits in length; the Month, Date, Hour field is 2-digits each; the CDRSeq is 9-digits in length. The Hour/Minute field is always in 24-hour format, which ranges in value from 00 through 23. The .xxx suffix/exten-sion indicates the file was completed when .cdr displays. The working CDR file is named cdr.tmp, which has the most current working CDRs before the CDR file interval expired.
For example, the CDR file 20060327-0515-70001-800000.cdr indicates the file was created on 03/27/2006 at 5:15am and contains the CDR records sequence numbers from 70,001 to 80,000.
The CDRSeq is a 9-digit number that wraps when the value exceeds 999,999,999.
Integer fields that contain no data are set to 0; Non-integer fields that contain no data are simply left empty or will con-
126
Call Detail Records
tain the string NA. The semicolon character (;) is used as a delimiter to separate the fields of a CDR record.
File Retrieval Procedure
CDR files can be retrieved using the secure file copy (SCP) or file transfer protocol (FTP) procedure. The SCP procedure requires a defined user login name with a password. The CDR user name and password can be obtained through the VSX Web GUI using a system administrator login. A simple procedure for retrieving CDR files from the VSX system is provided below:
1. Obtain the IP address or the host name of the VSX sys-tem.
2. Open an SCP ( or FTP) session using one of the following command: SCP user@ <IP address>:TBD-directory/ 20060327*.cdr
This command will retrieve all cdr files created in 03/27/2006
3. Repeat Step 2 if necessary.
127
Sansay VSX User’s Guide
128
APPENDIX B
VSX SPECIFICATIONS
This appendix provides product information regarding the server that is used by Sansay’s VSX. All VSX specifications are subject to change without notice. For additional informa-tion regarding VSX servers, contact a Sansay representative or visit the Sansay web site.
Table 9 lists the available VSX servers and their Sansay part numbers.
Table 9. VSX Servers
Sansay Part Number Description
nnn-nnn-nnn VSX 1 Rack Unit, 1000 call capacity
nnn-nnn-nnn VSX 1 Rack Unit, 2000 call capacity
nnn-nnn-nnn VSX 2 Rack Unit, 2000 call capacity
nnn-nnn-nnn VSX 2 Rack Unit, 5000 call capacity
129
Sansay VSX User’s Guide
Environmental Specifications
Table 10 shows the environmental specifications for the VSX servers.
For information on and an illustration of the rear panel con-nectors, see Chapter 2, “Setting up the VSX.”
Table 10. VSX Server Environmental Specifications
Electromagnetic Interference Complies with FCC Rules and Regulations, part 15, as a Class B digital device. Manufacturer's Declaration to EN 55022, EN 60555-2, EN 60555-3, EN 50082-1.
AC Input Power 110/ 220 VAC 50/60Hz per voltage selector switch
Maximum Current Requirements x.x Amps at 110VAC
Maximum Power Dissipation xxx Watts
Physical Dimensions Depth: 387mm (15.25 in)Width: 482mm (19.0 in)Height: 52.6mm (2.1 in)/1 EIA unitsWeight: 6.8kg (15lb)
Operating Temperature +5° to 35°C (41° to 95°F)
Non-Operating Temperature -40° to 65°C (-40° to 149°F)
Maximum Rate of Temperature Change 20°C/hour
Operating Relative Humidity 15% to 80%, noncondensing, max. wet bulb = 26°C
Non-Operating Relative Humidity 5% to 90%, noncondensing
Operating Altitude To 3.0km (10,000 ft) above sea level
Non-Operating Altitude To 4.5km (15,000 ft) above sea level
130
Sansay VSX User’s Guide S-VSX-301-TP-1B
131
Reader’s Comment Form
This book is part of a library that serves as a reference for network communications managers and systems integrators who want to incorporate advanced technology and data transmission over H.323/SIP networks. If you have any comments regarding this book (including its content, organization, and format), print and use this form to commu-nicate them directly to Sansay. You can also send your comments by e-mail to Sansay at [email protected]. If you have received any revision pages to update this book, please identify them.
Your comments will be reviewed and appropriate action taken, as necessary. Sansay may use or distribute the information you supply without incurring any obligation to you.
If you would like additional information regarding the Sansay product line, please con-tact our marketing department at the following address:
Sansay, Inc.4650 Lusk Blvd. Suite 204
San Diego, California 92121U.S.A. 1-(858) 678-0200
Fold along dotted lines and tape. Please do not staple
Fold along dotted lines and tape. Please do not staple
PlacePostageHere
Sansay, Inc.
Information Development
4650 Lusk Blvd. Suite 204
San Diego, CA 92121
WARRANTY
Please take a few minutes to complete the product warranty card found at the back of this book and return it to Sansay, Inc. In addition, if you have any comments or ques-tions regarding Sansay product features, we would appreciate hearing from you. Con-tact our marketing department directly at:
Sansay, Inc.Marketing Department4650 Lusk Blvd. Suite 204
San Diego, CA 92121Tel.: (858) 678-0200 FAX (858) 678-0203
If you have any comments or questions regarding publications for Sansay products, please direct them to the Technical Publications Department at the above address or to [email protected]. Be sure to specify the book and section to which your comment refers.
YOUR SANSAY WARRANTYIMPORTANT - READ CAREFULLY: By opening the software and/or hardware package and using the product, you agree to be bound by the terms of this license agreement. If you do not agree to the terms of this agreement, promptly return this package to the place from which you obtained it for a full refund.
If this product should fail due to defects in materials or workmanship, Sansay Com-munications, Inc. will, at its sole option, repair or replace it with new or rebuilt parts, free of charge, for one (1) year from the date of its shipment from the Sansay factory. This warranty is extended to only the original purchaser and covers only failures due to defect in materials and workmanship that occur during normal use during the period of warranty. It does not cover damage that occurs in shipment, failures caused by products not supplied by Sansay, or failures resulting from accident, misuse, neglect, mishandling, alteration, or modification of the product outside of its pub-lished electrical or environmental specifications, or any other causes other than ordi-nary use. Expendable components are not covered by this warranty.
In order to exercise your rights to repair under this warranty, you must first contact Sansay to obtain a repair authorization (RA) number. If you must return the unit to Sansay for repair while the unit is under warranty, Sansay will pay the cost of ship-ping it to and from Sansay.
Sansay VSX User’s Guide
No express warranties exist except as listed above. IN NO EVENT SHALL SANSAY BE LIABLE FOR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OF THIS PRODUCT, OR ARISING OUT OF ANY BREACH OF THIS WARRANTY. ALL EXPRESS AND IMPLIED WARRANTIES, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE LIMITED TO THE APPLICABLE WARRANTY PERIOD SET FORTH ABOVE. NO EMPLOYEE OR REPRESENTATIVE OF SAN-SAY IS AUTHORIZED TO MODIFY THIS WARRANTY OR SANSAY’S STANDARD WARRANTY FOR ANY PRODUCT.
Some states do not allow the exclusion or limitation of incidental or consequential damages, or limitations on how long an implied warranty lasts, so the above exclu-sions or limitations may not apply to you.
This warranty gives you specific legal rights. You may also have other rights with respect to this product that vary from state to state.
SOFTWARE LICENSE AGREEMENTAny software product, including any documentation relating to or describing such software (hereafter collectively called “Software”), provided by Sansay is furnished to you for installation and use on a single computer. The Software may not be copied, in whole or in part, except for archival purposes, to replace a defective copy, or for pro-gram error verification.
You may not reverse engineer, decompile, or disassemble the Software, except to the extent such foregoing restriction is expressly prohibited by applicable law.
Unless earlier terminated by Sansay as herein provided, the term of each paid-up license shall expire at such time as you discontinue use of the applicable Software on the single processor specified above but otherwise shall be without restriction as to time.
The Software (including any images, applets, photographs, animations, video, audio, music, and text incorporated into the Software) is owned by Sansay or its suppliers and is protected by United States copyright laws and international treaty provisions. Therefore, you must treat the Software like any other copyrighted material (for example, a book or musical recording) except that you may either (a) make one copy of the Software solely for backup or archival purposes, or (b) transfer the Software to a single hard disk provided you keep the original solely for backup or archival pur-poses. You may not copy the printed materials accompanying the Software.
You may not rent or lease the Software, but you may transfer the Software and accompanying written materials on a permanent basis provided you retain no copies and the recipient agrees to the terms of this Agreement. If the Software is an upgrade, any transfer must include the most recent upgrade and all prior versions.
Warranty
SANSAY WARRANTY REGISTRATIONBy returning the warranty card, the Buyer simultaneously registers the warranty for the Sansay products listed hereunder, and indicates acceptance of the software license agreement printed above. Please take a moment to complete this card and mail it immediately. With a record of your ownership on file in the Sansay customer database, we can process any requests for warranty service with the greatest possible speed and accuracy. Thank you.
Sansay, Inc., 4650 Lusk Blvd. Suite 204, San Diego, CA 92121
Sansay VSX User’s Guide
Sansay, Inc.4650 Lusk Blvd. Suite 204, San Diego, CA 92121 (858) 678-0200; FAX (858) 678-0203
S-VSX-301-TP-1B