TANDBERG Video Communication Server Administrator's Manual
TANDBERG Video Communication Server Administrator's Manual

TANDBERG Video Communication Server Administrator's Manual

Table of Contents

Advertisement

Quick Links

Video
Communication
Server
ADMINISTRATOR
GUIDE
Version X4.1
February 2009
Overview and
System
VCS
Zones and
Call
Bandwidth
Firewall
Introduction
Getting started
Applications
Maintenance
Appendices
status
configuration
configuration
neighbors
processing
control
traversal
1
D14049.05
February 2009

Advertisement

Table of Contents
loading

Summary of Contents for TANDBERG Video Communication Server

  • Page 1 Video Communication Server ADMINISTRATOR GUIDE Version X4.1 February 2009 Overview and System Zones and Call Bandwidth Firewall Introduction Getting started Applications Maintenance Appendices status configuration configuration neighbors processing control traversal D14049.05 February 2009...
  • Page 2 What’s in the box? ............21 Overview and status Overview ................ 14 Connecting the cables ............ 21 Overview ................30 VCS and the TANDBERG Total Solution......14 Installation site preparations ........... 21 Overview page ..............30 General installation precautions ........21 Overview and...
  • Page 3: Table Of Contents

    Grey Headline (continued) What’s in this manual? TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Status .................. 31 Configuration Log ............49 SNMP................54 System information ............31 Types of Configuration Log events ......49 About SNMP ............. 54 Ethernet status ............... 31 Administrator sessions ........
  • Page 4 Grey Headline (continued) What’s in this manual? TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring SIP ............... 61 Authentication using a local database ......68 Traversal client zone ............76 Enabling SIP ............. 61 Overview ..............68 Traversal server zone ............76 SIP registration expiry ..........
  • Page 5 Grey Headline (continued) What’s in this manual? TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Clustering and peers ............. 85 Upgrades and downgrades ..........88 Pre-search transforms ............ 96 About clustering.............. 85 Upgrading to X3.0 or later ......... 88 About pre-search transforms ........96 About the configuration master ........
  • Page 6 Grey Headline (continued) What’s in this manual? TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring basic Call Policy using the web interface ..105 Enabling ENUM dialing ..........112 Call IDs, Serial Numbers and Tags ........118 Configuring Call Policy using a CPL script ....... 106 ENUM dialing for outgoing calls ........
  • Page 7 Grey Headline (continued) What’s in this manual? TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Links .................. 125 Firewall traversal About links ..............125 Firewall traversal overview ........... 132 Adding and configuring a traversal client zone ....138 Default links ............125 About Expressway™...
  • Page 8 What’s in this manual? TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring Presence ............ 146 TANDBERG FindMe™ user guide .......... 152 Option keys ................ 158 Enabling and disabling Presence Services ....146 About FindMe ............... 152 Overview ..............158 PUA ..............146 FindMe user accounts ..........
  • Page 9 Grey Headline (continued) What’s in this manual? TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Tools .................. 165 Appendices VCS port reference ............. 184 Check pattern ............... 165 CPL reference ..............173 Overview ..............184 Locate ................165 Overview of CPL on the VCS ...........173 VCS ports ..............
  • Page 10: Legal Notices

    Administrator Guide are which it relates contain information that is Administrator Guide is protected under following patents: subject to change at any time, without notice, proprietary to TANDBERG and its licensors. copyright, patent, and other intellectual • EP01953201 by TANDBERG.
  • Page 11: Safety Instructions And Approvals

    EC declaration of conformity Do not operate the apparatus in areas with high Servicing Water and moisture concentration of dust. Manufacturer: TANDBERG Telecom AS • Do not attempt to service the apparatus • Do not operate the apparatus under or near Product Name:...
  • Page 12: Environmental Issues

    Instead of a range of different user manuals, there is now one systems in your area. Those systems will reuse or recycle most CD – which can be used with all TANDBERG products – in a of the materials of your end of life equipment in a sound way.
  • Page 13 Grey Headline (continued) Environmental issues TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview and System Zones and Call Bandwidth Firewall Introduction Getting started Applications Maintenance Appendices status configuration configuration neighbors processing control traversal D14049.05 February 2009...
  • Page 14 The TANDBERG VCS TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview VCS and the TANDBERG Total Solution The TANDBERG Video Communication Server (VCS) enhances the video experience and provides seamless communication between SIP and H.323 devices utilizing IETF and ITU standards. The VCS is the center of the video communication network, and connects all H.323 and SIP endpoints, infrastructure,...
  • Page 15: Vcs Base Applications

    Grey Headline (continued) The TANDBERG VCS TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE VCS base applications VCS Control VCS Expressway™ The VCS Control provides internal video control and administration for all SIP and H.323 devices. The VCS Expressway provides standards-based firewall traversal for SIP and H.323 devices allowing It is normally deployed within your wide area network with endpoints that are behind the same secure firewall traversal of any firewall or NAT device.
  • Page 16: Standard Features

    System administration using a web interface or RS-232, Telnet, SSH, and HTTPS • • Up to 500 non-traversal calls Can be managed with TANDBERG Management Suite 12 or later • • Up to 100 traversal calls Pre-configured defaults for Microsoft Office Communications Server (OCS) 2007 neighbor zones...
  • Page 17: Optional Features

    Installing the “Device Provisioning” option key on the VCS enables the TMS Agent feature. The TMS Agent allows TANDBERG Movi™ v2.0 clients registered to the VCS to be provisioned with phonebook and configuration information by connecting to the VCS rather than directly to TMS. All phonebook and configuration data is managed in TMS, and distributed to the clients through the TMS Agent...
  • Page 18: What's New In This Version

    TMS Agent your Firewall Administrator to ensure the correct ports are Root account access opened on the firewall. The TMS Agent allows TANDBERG Movi™ v2.0 clients registered to the VCS to be provisioned with phonebook and configuration Access to the root...
  • Page 19: The Administrator Guide

    ADMINISTRATOR GUIDE Using this Administrator Guide This Administrator Guide is provided to help you make the best use of your TANDBERG VCS. Typographical conventions Your approach to this documentation depends on what you want to do and how much you already Most configuration tasks on the VCS can be performed by using either the web interface or a...
  • Page 20: Getting Started

    Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Getting started This section describes how to install the VCS and carry out its initial configuration. It also gives an overview of the VCS’s administration settings and describes how to access the VCS using either the command line interface (CLI) or the web interface.
  • Page 21: What's In The Box

    Make sure that the VCS is accessible and that all cables can The socket outlet shall be installed near to the equipment TANDBERG VCS is delivered in a special shipping box, which be easily connected. and shall be easily accessible.
  • Page 22 • stop bits: 1 • the red ALM LED on the front of the unit has Whether you want to use SSH to the TANDBERG Management Suite (TMS) to • gone out. flow control: none. administer the system. identify the system. See About the system •...
  • Page 23 Grey Headline (continued) Initial configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Initial configuration using the front panel The LCD panel makes it possible to configure " Press ENTER to produce the Main Press ENTER to access the IP Settings Use the...
  • Page 24: System Administration Access

    Configuring administration access Administration session timeout While it is possible to administer the TANDBERG VCS by using a To configure the services by which your system can be accessed: By default, administration sessions do not time out – they remain PC connected directly to the unit via a serial cable, you may wish active until you logout.
  • Page 25 Grey Headline (continued) System administrator access TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Administrator accounts The VCS has a default administrator account You will be taken to the Edit administrator Accessing the root account over SSH Administrator password security with full read/write access. This account is account page.
  • Page 26 Grey Headline (continued) System administrator access TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Web interface Using the web interface To use the web interface: Open a browser window and in the address line type either: • the IP address of the system •...
  • Page 27: General Page Features

    Select All Unselect All you directly to the latest version of the VCS Use these buttons to select and unselect all Administrator Guide on the TANDBERG website. items in the list. Status Information box On configuration pages, this section shows...
  • Page 28 Grey Headline (continued) System administrator access TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Command line interface (CLI) Supported characters Using the CLI How CLI commands are shown in this guide The VCS supports the following characters when entering text in the CLI and web interface:...
  • Page 29 Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview and status This section describes the information that appears on the Overview page and all the pages under the Status menu of the web interface. These pages provide information on the current status and configuration of the VCS.
  • Page 30: Overview Page

    Grey Headline (continued) Overview TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview page Overview page summarizes the current configuration and status of your VCS. Overview page opens automatically when you first log on to the web interface. You can also access it at any time by clicking on the Overview menu at the top left of any page.
  • Page 31: Status

    The date on which this version of the software was released. date Software name The internal TANDBERG reference number for this software release. Software options The maximum number of calls, and the availability of additional VCS features such as User Policy, Device Provisioning (TMS Agent) and Dual...
  • Page 32: Ip Status

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE IP status Resource usage IP status page provides details of the IP and DNS settings of the VCS. Resource Usage page provides statistics about the numbers of current and cumulative calls and registrations on the VCS.
  • Page 33: Registrations By Device

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Registrations by device Registrations by alias Registrations by device page lists each device currently registered with the VCS, and allows you Registrations by alias page lists all the aliases, E.164 numbers and prefixes used by all to remove a device's registration.
  • Page 34: Registration History

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Registration history Registration details Registration history page lists all the registrations that are no longer current. It lists the most Registration details page shows full information about an individual device's registration. The recent historical registrations since the last reboot, up to a maximum of 255.
  • Page 35: Calls

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Calls Call history Disconnect Call status page lists all the calls currently taking place to or Call history page lists all the calls that are no longer active from devices registered with the VCS, or that are passing through that have taken place since the VCS was last restarted.
  • Page 36: Call Summary

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Call summary Call media Call details Call summary page (Status > Calls > Calls Status > Calls Call media page shows information about the most relevant Call details page lists full information about a particular call, >...
  • Page 37: Searches

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Searches Search history Search details About searches Search history page lists the most recent 255 searches that Search details page (Status > Search history, then click have taken place since the VCS was last restarted.
  • Page 38: Local Zone

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Local Zone Zones Local Zone status page lists all the subzones that together make up the Local Zone. This will Zone status page lists all the zones that are currently configured on your VCS, the number of always include the Default Subzone and the Traversal Subzone, plus any other subzones that have calls and amount of bandwidth being used by each, and their current status.
  • Page 39: Links

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Links Pipes Link Status page lists all the links currently configured on your VCS, along with the number of Pipe status page lists all the pipes currently configured on your VCS, along with the number of calls and the bandwidth being used by each link.
  • Page 40: Stun Relays

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE STUN relays Presence STUN Relays page provides a list of all the currently active STUN Relays on the VCS. For each Status > Applications > Presence menu has three sub-menus: Relay, it shows the requesting client address and port and the corresponding VCS address and •...
  • Page 41: Ocs Relay

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE OCS Relay Warnings OCS Relay status page lists all the FindMe aliases being handled by the OCS Relay application, Warnings page provides a list of all the warnings currently in place on your system (and, where and shows the current status of each.
  • Page 42: Eventlog

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Event Log Event Log page allows you to view and search the Event Log, which is a list of all the events Event Log color coding that have occurred on your system since the last upgrade. The Event Log visible on the web Certain events in the Event Log are color-coded so that you can identify them more easily.
  • Page 43: Event Log Format

    _ name the name of the program generating the log message. This could include: tvcs for all messages originating from TANDBERG VCS processes web[ ] for all web login and configuration events tprovisioning for all events associated with the TMS agent but will differ for messages from other applications running on the VCS.
  • Page 44: Message Details Field

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Event Log message _ details Message details field The first field within the field is always In addition to the events described below, a Event and the last field is always Level.
  • Page 45: Events And Levels

    LDAP servers • Neighbor Gatekeeper • NTP servers • Peers Hardware Failure There is an issue with the VCS hardware. If the problem persists, contact your TANDBERG support representative. Overview and System Zones and Call Bandwidth Firewall Introduction Getting started...
  • Page 46 • Non Traversal Call Limit Reached • Traversal Call Limit Reached If this occurs frequently, you may wish to contact your TANDBERG representative to purchase more licences. Message Received An incoming RAS message has been received. Message Received An incoming RAS NSM Keepalive, H.225 or H.245 message has been received.
  • Page 47 Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Event Log Event Description Level Registration Removed Reason A registration has been removed by the VCS. The event parameter specifies the reason why the registration was removed. This is one of: •...
  • Page 48 Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Event Log Event Description Level Unregistration Accepted An unregistration request has been accepted. Unregistration Rejected An unregistration request has been rejected. Unregistration Requested An unregistration request has been received. User session finish A FindMe user has logged out of the system.
  • Page 49: Configuration Log

    Grey Headline (continued) Status TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuration Log Configuration Log page allows you to view and search login and configuration activities Types of Configuration Log events triggered using the VCS web interface. It shows all web login attempts for administrators and Findme users (both failed and successful), and all changes to the VCS configuration made using...
  • Page 50 Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE System configuration This section describes all the options that appear under the System Configuration menu of the web interface. These options enable you to configure the VCS in relation to the network in which it is located, for example its IP settings and the external services used by the VCS (e.g.
  • Page 51: System Configuration

    VCS and the means by which it is accessed by connection between the VCS and the ethernet switch to which it While it is possible to administer the TANDBERG VCS by using a administrators. is connected.
  • Page 52: About Ip Protocols

    Contact your Both protocols. The default is Both. Expressway's public IP address - this is the TANDBERG representative for information. IP address of the outside of the NAT. About LAN configuration IPv4: The VCS will only accept registrations You should configure the LAN 1 port and...
  • Page 53: Dns

    Grey Headline (continued) System configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Time page allows you to configure About the DNS domain name Time page allows you to configure the VCS to use If no NTP server has been configured, the VCS will use the VCS's DNS servers and local an NTP server, and to set the local time zone.
  • Page 54: Login Page

    FindMe users and administrators when attempting to log in using the web interface. About SNMP Tools such as TANDBERG Management Suite (TMS) or HP OpenView may act as SNMP Network Management Systems (NMS). They allow you to monitor your network devices, including the VCS, External manager for conditions that might require administrative attention.
  • Page 55: Logging

    Grey Headline (continued) System configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Logging Overview Setting the Event Log level The VCS provides an Event Logging facility for troubleshooting and auditing purposes. The Event Log You can control which events are logged by the VCS by setting the log level. All events with a level records information about such things as calls, registrations, and messages sent and received.
  • Page 56: Vcs Configuration

    Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE VCS configuration This section provides information on the pages that appear under the Protocols, Registrations Authentication sub-menus of the VCS Configuration menu. These pages allow you to configure the functionality of the VCS in each of these areas.
  • Page 57: H.323 Overview

    Grey Headline (continued) H.323 TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE H.323 overview H.323 endpoint registration About H.323 on the VCS H.323 endpoints in your network must register with the VCS in order to use it as their gatekeeper. There are two ways an H.323 endpoint can locate a VCS with which to register: manually or The VCS supports the H.323 protocol: it is an H.323 gatekeeper.
  • Page 58: Configuring H.323

    Grey Headline (continued) H.323 TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring H.323 H.323 page allows you to enable and disable H.323 on the Registration conflict mode Time to live VCS, and configure H.323-specific ports and settings. An H.323 endpoint may attempt to register with the VCS using an H.323 endpoints must periodically re-register with the VCS in...
  • Page 59: Sip

    Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE SIP overview About SIP on the VCS Using the VCS as a SIP proxy server The VCS supports the SIP protocol. It can act as a: When SIP mode has been enabled the VCS may act as a SIP Proxy server. The role of a proxy server is to forward requests (such as REGISTER and INVITE) from endpoints or other proxy servers.
  • Page 60: Using The Vcs As A Sip Presence Server

    Movi v2.0 clients As for any other SIP endpoint, the VCS acts as a SIP Registrar and SIP Proxy for TANDBERG Movi™ v2.0 clients - no other special support or configuration is required on the VCS. Overview and System...
  • Page 61: Configuring Sip

    Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring SIP SIP domains page allows you to enable and disable SIP on the VCS, SIP protocols and ports Domains page lists the SIP domains for which the VCS and configure SIP-specific ports and settings.
  • Page 62: Interworking

    Grey Headline (continued) Interworking TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Configuring interworking The VCS is able to act as a gateway between SIP and H.323, translating calls from one protocol to Interworking page allows you to allows you to determine whether or not the VCS will act as a the other.
  • Page 63: Registration Control

    Registrations on a VCS Expressway MCU, gateway and Content Server registration In order for an endpoint to use the TANDBERG VCS as its H.323 If a traversal-enabled endpoint registers directly with a VCS H.323 systems such as gateways, MCUs and Content Servers gatekeeper or SIP Registrar, the endpoint must first register with...
  • Page 64: Finding A Vcs With Which To Register

    Grey Headline (continued) Registration control TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Registration overview Finding a VCS with which to register H.323 Before an endpoint can register with a VCS, it must determine which VCS it can or should be There are two ways an H.323 endpoint can locate a VCS with which to register: manually or automatically.
  • Page 65: Authentication

    VCS, that other system may have systems. For TANDBERG endpoints using H.323, the username is the authentication enabled and will therefore require your local VCS This page also allows you to configure a username and password endpoint’s...
  • Page 66: Authentication Using Ldap

    Grey Headline (continued) Registration control TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Authentication using LDAP Overview Securing the LDAP connection with TLS If the VCS is using an LDAP server for authentication, the process is as follows: The traffic between the VCS and the LDAP server can be encrypted using Transport Layer Security (TLS).
  • Page 67: Alias Origin

    LDAP database for its username. (This is to allow for MCUs which additively register aliases Encryption for conferences, for example the TANDBERG MPS (J4.0 and later) which registers ad-hoc Determines whether the connection to the LDAP server will be encrypted. (For more information on conferences.) (This applies to H.323 only).
  • Page 68: Authentication Using A Local Database

    Grey Headline (continued) Registration control TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Authentication using a local database Overview Configuring the local authentication database The local authentication database is included as part of your VCS system. It consists of a list of...
  • Page 69: Registering Aliases

    Grey Headline (continued) Registration control TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Registering aliases About alias registration Attempts to register using an existing alias Once the authentication process (if required) has been An endpoint may attempt to register with the VCS using an alias that is already registered to the system. How this is managed completed, the endpoint will then attempt to register its alias(es) depends on how the VCS is configured and whether the endpoint is SIP or H.323.
  • Page 70: Allow And Deny Lists

    Grey Headline (continued) Registration control TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Allow and Deny Lists About Allow and Deny Lists Activating use of Allow or Deny Lists Removing existing registrations When an endpoint attempts to register with the VCS it presents Registration Configuration...
  • Page 71: Managing Entries In The Allow List

    Grey Headline (continued) Registration control TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Allow and Deny Lists Managing entries in the Allow List Managing entries in the Deny List Registration Allow List page allows you to view and manage the entries in the Allow List.
  • Page 72: Zones And Neighbors

    Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones and neighbors This section begins with an overview of all the different types of subzones and zones and how these fit into the overall structure of your video communication network.
  • Page 73: Introduction

    VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About your video communications network VCS CONTROL The most basic implementation of a TANDBERG video communications network is a single VCS connected to the internet with one or more endpoints registered to it. However, depending...
  • Page 74: Local Zone And Subzones

    Grey Headline (continued) Local Zone and subzones TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Configuring the Local Zone and its subzones The collection of all endpoints, gateways, MCUs and Content Bandwidth management Local Zone matches Servers registered with the VCS make up its Local Zone.
  • Page 75: Traversal Subzone

    Grey Headline (continued) Local Zone and subzones TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Traversal Subzone The Traversal Subzone is a conceptual subzone; no endpoints can be registered to it, but all Configuring the Traversal Subzone ports traversal calls (i.e. calls for which the VCS is taking the media in addition to the signaling) will pass The VCS allows you to configure the range of ports to be used for the media in traversal calls.
  • Page 76: Zones

    firewall traversal on behalf of VCS, gatekeeper, or TANDBERG Border TANDBERG VCS, gatekeeper, or TANDBERG (for example a TANDBERG VCS Expressway or a traversal clients (for example, VCS Controls or Controller), or of a certain type such as ENUM Border Controller), or it could be a SIP device TANDBERG Border Controller).
  • Page 77: Enum Zone

    Grey Headline (continued) Zones TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE ENUM zone DNS zone Default Zone ENUM zones allow you to locate endpoints via an ENUM lookup. DNS zones allow you to locate endpoints via a DNS lookup. You Any incoming calls from endpoints that are not recognized as...
  • Page 78: Adding Zones

    Grey Headline (continued) Zones TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Adding zones Configuring zones - common options In order to neighbor with another system (e.g. another VCS or gatekeeper), create a connection over Once you have created a new zone on the local VCS you must configure it appropriately. For a firewall to a traversal server or traversal client, or create an ENUM or DNS zone, you must add a...
  • Page 79: Configuring Neighbor Zones

    VCS, this will be the port found under Neighbor Interworking SIP commands. They VCS configuration > Protocols > H.323 in the Registration UDP should only be changed on the advice of TANDBERG customer Port field. support. Overview and System...
  • Page 80 Grey Headline (continued) Zones TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring neighbor zones (cont...) Advanced (cont...) SIP UPDATE strip mode Determines whether or not the VCS will strip the UPDATE method from the Allow header of all requests and responses received from this zone.
  • Page 81: Configuring Traversal Client Zones

    If the traversal server is a TANDBERG Border Controller, this H.323 port should include all its Alternates. To edit the client authentication username, either: Specifies the port on the traversal server to be used for H.323...
  • Page 82: Configuring Traversal Server Zones

    Determines whether or not the same two ports will be used for Sets the number of times the client will attempt to send a TCP • If the traversal client is a TANDBERG Gatekeeper, this is its media by two or more calls. probe to the VCS Expressway during call setup.
  • Page 83: Configuring Enum Zones

    Grey Headline (continued) Zones TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring ENUM zones Configuring DNS zones The following options are available (in addition to the common zone options) when configuring an The following options are available (in addition to the common zone options) when configuring a...
  • Page 84 Zones The settings for the pre-configured SDP are configurable using the except on the advice of TANDBERG customer support. Zone [1..200] DNS Interworking SIP commands. They should only be changed on the advice of TANDBERG customer support.
  • Page 85: Clustering And Peers

    Grey Headline (continued) Clustering and peers TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About clustering A VCS can be part of a cluster of up to six VCSs. Each VCS in the cluster is a peer of every other VCS in the cluster.
  • Page 86: Configuring Clusters

    Ensure that all VCSs to be added to the cluster have the same only. Any changes made on other peers will not be Clusters can be monitored from TANDBERG Management Suite software version installed. reflected across the cluster, and will be overwritten the (TMS) version 12.1 and above.
  • Page 87: What Configuration Is And Isn't Replicated

    Failover re-registration to a peer applies to H.323 re-registrations only., The SIP standard currently but you must purchase these separately for has no direct equivalent, but some SIP UAs including TANDBERG Movi™ v2.0 clients also support VCS. We recommend that you set up a remote each peer in the cluster.
  • Page 88: Clustering And Findme

    Grey Headline (continued) Clustering and peers TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Clustering and FindMe Clustering and presence Upgrades and downgrades Overview Clustering supports the use of Presence. The clustering feature was introduced to the VCS in software release X3.0.
  • Page 89: Cluster Subzone

    Grey Headline (continued) Clustering and peers TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Cluster Subzone Neighboring the local VCS to another VCS cluster When two or more VCSs are clustered together, a new subzone Overview Configuration is created within the cluster’s Local Zone. This is the Cluster...
  • Page 90: Dial Plans

    Grey Headline (continued) Dial plans TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About dial plans Flat dial plan Structured dial plan Hierarchical dial plan As you start deploying more than one VCS, The simplest approach is to assign each An alternative deployment would use a...
  • Page 91: Call Processing

    Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Call processing This section provides information on the pages that appear under the Calls, Transforms Policy sub-menus of the VCS Configuration menu. These pages allow you to configure the way in which the VCS receives and process calls.
  • Page 92: Introduction

    Grey Headline (continued) Introduction TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Call processing diagram One of the functions of the VCS is to route calls to their appropriate destination, based on the address or alias received from a locally registered endpoint or external zone.
  • Page 93: Dialing By Address Types

    Grey Headline (continued) Dialing by address types TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About the different address types Dialing by H.323 ID or E.164 alias The destination address that is entered using the caller’s endpoint can take a number of different No special configuration is required in order to place a call using an H.323 ID or E.164 alias.
  • Page 94: Hop Counts

    Grey Headline (continued) Hop counts TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About hop counts Configuring hop counts Each search request is assigned a hop count value by the system that initiates the search. Every Hope counts are configured on a zone basis. To configure the hop count for a zone: time the request is forwarded to another neighbor gatekeeper or proxy, the hop count value is •...
  • Page 95: Searches And Transforms

    Grey Headline (continued) Searches and transforms TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview of searches and transforms About searches About transforms One of the VCS’s functions is to process incoming requests to search for a particular alias. These The VCS allows you to transform the alias in a search request if it matches certain criteria. This...
  • Page 96: Pre-Search Transforms

    Grey Headline (continued) Searches and transforms TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Pre-search transforms About pre-search transforms Pre-search transform process Configuring pre-search transforms Pattern behavior Determines how the matched part of the alias The pre-search transform function allows you Up to 100 pre-search transforms can be...
  • Page 97: Zone Searching And Transforming

    Grey Headline (continued) Searches and transforms TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zone searching and transforming About zone searching About zone transforms Zone search and transform process The VCS allows you to filter the search requests sent to each The VCS allows you to change the alias being searched for Zone searching takes place after call policy has been applied.
  • Page 98: Configuring Zone Searches And Transforms

    Grey Headline (continued) Searches and transforms TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zone searching and transforming Configuring zone searches and transforms Pattern string Default settings (Applies only if the Mode is PatternMatch.) Zone searches and transforms are configured on a zone basis By default the Local Zone and all other configured zones have a...
  • Page 99: Examples

    Grey Headline (continued) Searches and transforms TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Examples • Stripping @domain for dialing to H.323 numbers Explanation The first Local Zone match takes any aliases that are in the format number@domain and transforms these into the format The pre-search transform takes any number-only dial strings (e.g.
  • Page 100: Combining Match Types And Priorities

    Grey Headline (continued) Searches and transforms TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Examples Combining match types Never query a zone Always query a zone, never apply transforms and priorities To configure the zone so that it is never sent an alias search request (for example To configure the zone so that it is always sent search requests using the original...
  • Page 101: Filter Queries To A Zone Without Transforming

    Grey Headline (continued) Searches and transforms TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Examples Filter queries to a zone without transforming It is possible to filter the search requests sent to a zone so that it is only queried for aliases that match certain criteria.
  • Page 102: Query A Zone For Original And Transformed Alias

    Grey Headline (continued) Searches and transforms TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Examples Query a zone for original and transformed alias You may wish to query a zone for the original alias at the same time as you query it for a transformed alias. To do this, configure one match with a mode of AlwaysMatch, and a second...
  • Page 103: Query A Zone For Two Or More Transformed Aliases

    Grey Headline (continued) Searches and transforms TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Examples Query a zone for two or more transformed aliases Zones are queried in order of priority of the matches configured within them. It is possible to configure a single zone with up to five...
  • Page 104: Call Policy

    Grey Headline (continued) Call Policy TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About Call Policy Call Policy and authentication The VCS allows you to set up a set of rules to Call Policy uses the source and destination of a H.323 control which calls are allowed, which calls are call to determine the action to be taken.
  • Page 105: Enabling Call Policy

    Grey Headline (continued) Call Policy TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Enabling Call Policy Configuring basic Call Policy using the web interface Call Policy is enabled and disabled using the Call Policy mode Call Policy rules page lists the web-configured call policy...
  • Page 106: Configuring Call Policy Using A Cpl Script

    Grey Headline (continued) Call Policy TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring Call Policy using a CPL script Overview About CPL XSD files Uploading a CPL script You can use CPL scripts to configure advanced Call Policy. To do The CPL script must be in a format supported by the VCS. The To upload a new CPL file:...
  • Page 107: Uri Dialing

    Grey Headline (continued) URI dialing TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Enabling URI dialing via DNS URI dialing via DNS is enabled separately for outgoing and A URI address typically takes the form name@example.com, where name is the alias and example.com...
  • Page 108: Uri Resolution Process Using Dns

    Grey Headline (continued) URI dialing TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE URI resolution process using DNS When a VCS is attempting to locate a destination URI address using the DNS system, the general process is as follows: The VCS supports the SIP resolution process as outlined in RFC 3263 [16].
  • Page 109: Uri Dialing Via Dns For Outgoing Calls

    Grey Headline (continued) URI dialing TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE URI dialing via DNS for outgoing calls Process Hop count For example: When dialing by URI via DNS, the hop count used is that .*@.* • a match with a...
  • Page 110: Uri Dialing Via Dns For Incoming Calls

    Grey Headline (continued) URI dialing TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE URI dialing via DNS for incoming calls Types of DNS records required Configuring H.323 SRV records The ability of the VCS to receive incoming calls made using URI dialing via DNS relies on the Annex O of H.323 [15]...
  • Page 111: Example Dns Record Configuration

    Grey Headline (continued) URI dialing TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE URI dialing via DNS for incoming calls Firewall traversal Example DNS record configuration Recommended configuration A company with the domain name example.com wants to enable incoming H.323 and SIP calls If URI dialing via DNS is being used in conjunction with firewall traversal, DNS zones should be...
  • Page 112: Enum Dialing

    Grey Headline (continued) ENUM dialing TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Process Enabling ENUM dialing ENUM dialing allows an endpoint to be contacted by a caller When a VCS is attempting to locate a destination endpoint using ENUM dialing is enabled separately for incoming and outgoing dialing an E.164 number - a telephone number - even if that...
  • Page 113: Enum Dialing For Outgoing Calls

    Grey Headline (continued) ENUM dialing TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE ENUM dialing for outgoing calls Prerequisites Process Example In order for a local endpoint to be able to dial another endpoint Below is the process that is followed when an ENUM (E.164) In this example, we wish to call Fred at Example Corp.
  • Page 114: Adding And Configuring Enum Zones

    Grey Headline (continued) ENUM dialing TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE ENUM dialing for outgoing calls Adding and configuring ENUM zones DNS suffix Example converted into an ENUM domain and queried for via DNS. The DNS zone that is to be queried for a...
  • Page 115: Enum Dialing For Incoming Calls

    Grey Headline (continued) ENUM dialing TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE ENUM dialing for incoming calls Prerequisites Configuring DNS NAPTR records Example In order for your locally registered endpoints to be reached using ENUM relies on the presence of NAPTR records, as defined by For example, the record: ENUM dialing, you must configure a DNS NAPTR record that...
  • Page 116: Ip Dialing

    H.323 gatekeeper or SIP traversal Although the VCS supports dialing by IP The options for the Calls to Unknown Registrar (e.g. VCS, gatekeeper or TANDBERG address, it is sometimes undesirable for a IP addresses setting are: Border Controller). Although most calls are...
  • Page 117: Call Configuration

    Grey Headline (continued) Call configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Call routed mode Call loop detection mode Fallback alias Overview Overview Overview It is possible for the VCS to receive a call that is destined for it Calls are made up of two components - signaling and media.
  • Page 118: Call Ids, Serial Numbers And Tags

    Grey Headline (continued) Call IDs, Serial Numbers and Tags TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Identifying a particular call Each call that passes through the VCS is assigned a Call ID and a Call Serial Number. Calls also Identifying calls in the web interface have a Call Tag assigned if this does not already exist.
  • Page 119: Disconnecting Calls

    Call Tag but different Call Serial Number may not timer which should cause them to clear the resources of be affected. any hung SIP calls after a certain period of time. This includes all TANDBERG endpoints. Overview and System Zones and...
  • Page 120: Bandwidth Control

    Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Bandwidth control This section describes the pages that appear under the Local Zone Bandwidth sub-menus of the VCS Configuration menu in the web interface. These pages allow you to control the bandwidth that is used for calls within your local zone, as well as calls out to other zones.
  • Page 121: Bandwidth Control Overview

    VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Bandwidth control on the VCS Example network deployment The TANDBERG VCS allows you to control The diagram below shows a typical network deployment: the amount of bandwidth used by endpoints • a broadband LAN between the Enterprise and the internet, where high bandwidth calls are acceptable on your network.
  • Page 122: Subzones

    Grey Headline (continued) Subzones TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About subzones and bandwidth About the Traversal Subzone About the Default Subzone control The Traversal Subzone is a conceptual subzone. No endpoints can be registered to the Traversal When an endpoint registers with the VCS, Subzone;...
  • Page 123: Creating A Subzone

    Grey Headline (continued) Subzones TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Creating a subzone Configuring a subzone To add a new subzone: To configure an existing subzone: • VCS configuration > Local Zone > Subzones • VCS configuration > Local Zone > Subzones...
  • Page 124: Applying Bandwidth Limitations To Subzones

    Grey Headline (continued) Subzones TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Applying bandwidth limitations to subzones Types of limitations How different bandwidth limitations are managed You can apply bandwidth limits to the Default Subzone, Traversal Subzone and all manually In situations where there are differing bandwidth limitations applied to the same link, the lower limit configured subzones.
  • Page 125: Links

    Grey Headline (continued) Links TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About links Creating and editing links Default links Subzones are connected to other subzones About default links Automatically created links Creating a new link and zones via links. For a call to take place, To create a new link: If a subzone has no links configured, then...
  • Page 126: Pipes

    Grey Headline (continued) Pipes TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About pipes Creating and editing pipes It is possible to control the amount of bandwidth used on calls Creating a new pipe Pipe configuration options between specific subzones and zones. The limits can be applied...
  • Page 127: Applying Pipes To Links

    Grey Headline (continued) Pipes TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Applying pipes to links Pipes are used to restrict the bandwidth of a link. When a pipe is applied to a link, it will restrict the bandwidth of calls made between the two nodes of the link - the restrictions will apply to calls in either direction.
  • Page 128: Default Bandwidth And Downspeeding

    Grey Headline (continued) Default bandwidth and downspeeding TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About the default call bandwidth Configuring default call bandwidth and downspeeding Usually, when a call is initiated the endpoint will include in the request the amount of bandwidth it To configure the default call bandwidth and downspeeding behavior using the web interface:...
  • Page 129: Bandwidth Control Examples

    Grey Headline (continued) Bandwidth control examples TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Example without a firewall An example deployment is shown opposite. In this example, there are three geographically separate offices: Enterprise, Branch and Home. All endpoints in the Enterprise office register with the VCS Control, as do those in the Branch and Home offices.
  • Page 130: Example With A Firewall

    Example with a firewall If we modify the previous example deployment to include firewalls between the offices, we can use TANDBERG’s Expressway™ firewall traversal solution to maintain connectivity. We do this by adding a VCS Expressway outside the firewall on the public internet, which will work in conjunction with the VCS Control and Home and Branch office endpoints to traverse the...
  • Page 131: Firewall Traversal

    Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Firewall traversal This section describes how to configure your VCS Control and VCS Expressway in order to traverse firewalls. It also describes how to configure the additional firewall traversal server functions of a VCS Expressway, including STUN services.
  • Page 132: Firewall Traversal Overview

    In order for firewall traversal to function correctly, the VCS Expressway must have one • In order for the VCS Expressway to act as a firewall traversal server for TANDBERG systems, you traversal server zone configured on it for each client system that is connecting to it (this must create and configure a new traversal server zone on the VCS Expressway for every system...
  • Page 133: Quick Guide To Vcs Traversal Client - Server Configuration

    Grey Headline (continued) Quick guide to VCS traversal client - server configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview VCS Control (client) VCS Expressway (server) Full details of how to configure a VCS Control and VCS Expressway as traversal client and server respectively are given in the following pages.
  • Page 134: Firewall Traversal Protocols And Ports

    firewall in order for connections to be permitted. • on the VCS Expressway. Assent is TANDBERG’s proprietary protocol. Ports are initially configured on the VCS Expressway by the • The server identifies each client by the port on which it H.460.18 and H.460.19 are ITU standards which define...
  • Page 135: Ports For Initial Connections From Traversal Clients

    Grey Headline (continued) Firewall traversal protocols and ports TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Ports for initial connections from Assent ports H.460.18/19 ports Ports for connections out to the public traversal clients internet For connections to the VCS Expressway using...
  • Page 136: Firewall Traversal And Authentication

    However, endpoint clients are only required to along with the corresponding password. authenticate if the VCS Expressway’s Authentication Mode is On. TANDBERG Gatekeeper (version 6.0 and later; 6.1 and later is the VCS Expressway recommended version) • The traversal server zone for the Gatekeeper client must be configured •...
  • Page 137: Other Issues

    DMZ - and your network is configured to prevent direct communication between the two. TANDBERG offers a downloadable tool, the Expressway Port Tester, that allows you to test your With the LAN 2 interface enabled, you can configure the VCS with two separate IP addresses, one firewall configuration for compatibility issues with your network and endpoints.
  • Page 138: Configuring The Vcs As A Traversal Client

    Adding and configuring a traversal client zone To enable your VCS to act as a traversal client on behalf of its endpoints and neighbor gatekeepers, you must create a connection between it and a traversal server (e.g. a TANDBERG VCS Expressway or Border Controller).
  • Page 139: Configuring The Vcs As A Traversal Server

    (e.g. a Allow your VCS to act as a traversal server directly with the VCS Expressway and use it for TANDBERG VCS Control or Gatekeeper) you probe to the VCS Expressway. for other VCSs and TANDBERG Gatekeepers.
  • Page 140: Configuring Traversal Server Ports

    Grey Headline (continued) Configuring the VCS as a traversal server TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring traversal server ports Overview Configuration The VCS Expressway has specific listening ports used for firewall traversal. Rules must be set on To configure the VCS Expressway ports: your firewall to allow connections to these ports.
  • Page 141: Stun Services

    Grey Headline (continued) Configuring the VCS as a traversal server TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE STUN services About STUN STUN Binding Discovery STUN Relay Configuring STUN services STUN is a network protocol that enables a SIP The STUN Binding Discovery service provides The STUN Relay service (formerly known as To configure the STUN Binding Discovery and...
  • Page 142 Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Applications This section provides information on each of the additional services that are available under the Applications menu of the VCS. You may need to purchase the appropriate option key in order to use each of these applications. They are: •...
  • Page 143: Conference Factory

    Multiway enables endpoint users to create a conference while in a call even if their endpoint does (Applications > Conference Factory). not have this functionality built in. Multiway is supported in TANDBERG endpoints including the E20 Mode (software version TE1.0 and later) and MXP range (software version F8.0 and later).
  • Page 144: Presence

    FindMe users. (e.g. another VCS Control or Expressway). Endpoints that support presence, such as TANDBERG Movi™ v2.0 clients, can publish their own The Presence Server is made up of the following services, all of which are enabled (or disabled) status information.
  • Page 145: Presence User Agent (Pua)

    Grey Headline (continued) Presence TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Presence User Agent (PUA) Overview Aggregation of presence information Registration refresh period Endpoints that do not support presence can have status When enabled, the PUA generates presence information for all The PUA will update and publish presence information on receipt published on their behalf by the VCS.
  • Page 146: Configuring Presence

    Grey Headline (continued) Presence TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring Presence Enabling and disabling Presence Services local VCS is authoritative. All other PUBLISH messages will be Presence Server expiration times proxied on in accordance with the VCS’s SIP routing rules.
  • Page 147: Viewing Presence Status

    Grey Headline (continued) Presence TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Viewing presence status Publishers Presentities Subscribers Status > Applications > Presence > Publishers Status > Applications > Presence > Presentities Status > Applications > Presence > Subscribers This page lists each presentity whose presence information is...
  • Page 148: Ocs Relay

    Call Policy • configuring Presence. As this is a complex procedure beyond the scope of this Administrator Guide, TANDBERG have published a separate document describing in detail all the steps required: TANDBERG VCS Control X4 and Microsoft OCS 2007 Deployment Guide [24].
  • Page 149: Findme™ (User Policy)

    User Policy has been enabled. If so, the VCS be the individual’s primary URI. when it is received by the TANDBERG VCS. queries the User Policy Manager to see whether that alias is •...
  • Page 150: Enabling Findme On The Vcs

    Grey Headline (continued) FindMe™ (User Policy) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Enabling FindMe on the VCS Configuring the User Policy Manager FindMe requires a User Policy Manager. The VCS has its own User Policy Manager, but there is also the ability to connect to a User Policy Manager located on another system.
  • Page 151: Managing Findme User Accounts

    Grey Headline (continued) FindMe™ (User Policy) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Managing FindMe user accounts Confirm password About user accounts Disabling a user account Retype the password. FindMe user accounts must be created by a VCS administrator Administrators can delete all the devices that have been before they can be accessed and configured by users.
  • Page 152: Tandberg Findme™ User Guide

    Grey Headline (continued) TANDBERG FindMe™ user guide TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About FindMe Accessing the FindMe configuration page The FindMe feature allows you as an individual or part of a group To configure your FindMe user account, log in using a web browser as described below: to have a single name on which you can always be called, and you chose where calls to that name will be routed.
  • Page 153: Configuring Your Findme User Account

    Grey Headline (continued) TANDBERG’s FindMe™ user guide TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuring your FindMe user account If no devices are configured for a Primary Devices FindMe name, all calls to that name List the all the device(s) that will ring when your will be rejected.
  • Page 154: Maintenance

    Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Maintenance This section describes the pages that appear under the Maintenance menu of the VCS web interface. These pages allow you to perform the following tasks: • upgrade to a new release of softwar •...
  • Page 155: Upgrading Software

    - this is the you wish to take advantage of these new features. Contact your how to obtain these. recommended process TANDBERG representative for more information on all the options available for the latest release of VCS software. • using secure copy (SCP/PSCP...
  • Page 156: Upgrading Using The Web Interface

    The target name must be about the software and hardware that currently make up page (Maintenance > Upgrade) will now show the upgraded /tmp/tandberg-image.tar.gz, e.g. your system. version number. scp s42700x41.tar.gz root@10.0.0.1:/tmp/ tandberg-image.tar.gz Enter the 16-character...
  • Page 157: Downgrading Software

    X3. The password for the default admin administrator account will revert to the default of TANDBERG. Clustering After downgrading from X4 to a version prior to X3, peers in a cluster will no longer share information about bandwidth, presence, and FindMe.
  • Page 158: Option Keys

    : indicates that AES encryption is supported by this software build. Contact your TANDBERG representative for more information on how to purchase any of these When using the CLI to add an extra option key, you can use any unused option index. If you additional features.
  • Page 159: Security

    Grey Headline (continued) Security TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Enabling security For extra security, you may wish to have the VCS communicate To enable security using the web interface: Server certificate data with other systems (e.g. servers such as LDAP servers, neighbor •...
  • Page 160: Administrator Accounts

    Grey Headline (continued) Administrator accounts TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Adding and editing an administrator account Default administrator account Administrator password security To add a new administrator account: • Maintenance > Administrators > Administrator accounts The VCS has a default administrator account with full read-write...
  • Page 161: Backup And Restore

    Grey Headline (continued) Backup and restore TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Creating a backup of your VCS configuration Restoring a previous backup The backup and restore features allow you to create a file To create a backup of the VCS’s current configuration: To restore the VCS to a previous configuration:...
  • Page 162: System Snapshot

    Clicking on this button will initiate the download of the system snapshot file. You will then be asked whether and where you would like to save the file. Select a location from which you can easily send the file to your TANDBERG support representative. Overview and...
  • Page 163: Incident Reporting

    Process ID the process id the VCS application had when the incident occurred. This feature is only intended for use at the request of TANDBERG customer support in exceptional Release a True/False flag indicating if this is release build (rather than a situations, and is off by default.
  • Page 164: Viewing Incident Reports

    Sent: details of the incident have been sent to the URL specified Incident reports sending mode is On, this is the URL of the If you wish to edit the report before sending it to TANDBERG in the Incident reporting configuration page.
  • Page 165: Tools

    Grey Headline (continued) Tools TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Check pattern Locate Check pattern page (Maintenance > Tools > Check pattern) allows you to test whether a pattern Locate page (Maintenance > Tools > Locate) allows you to test whether the VCS can find an or transform you intend to configure on the VCS will have the expected result.
  • Page 166: Port Usage

    Grey Headline (continued) Tools TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Port usage Overview Local VCS inbound ports Local VCS outbound ports Remote listening ports The pages under the Maintenance > Tools > This page shows the listening ports on this...
  • Page 167: Restarting And Shutting Down

    Do not shut down the system while the red ALM LED on the front of the box is on. This hardware fault. Contact your TANDBERG representative. indicates a hardware fault. Contact your TANDBERG representative. Some configuration changes will require a restart of the VCS before they take effect. There will The system must be shut down before it is unplugged.
  • Page 168: Restoring Default Configuration

    Grey Headline (continued) Restoring default configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview It is possible to restore the VCS to its default configuration. This is done using the CLI using xCommand DefaultValuesSet Level: 3 must be used with caution, as it resets the xCommand DefaultValuesSet.
  • Page 169 Grey Headline (continued) Restoring default configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE DefaultValuesSet level 3 (cont.) Default value after xCommand DefaultValuesSet Level: 3 Configuration item Ethernet [1..2] IP V4 SubnetMask 255.255.255.0 Ethernet [1..2] IP V6 Address <blank> Ethernet [1..2] Speed...
  • Page 170 Grey Headline (continued) Restoring default configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE DefaultValuesSet level 3 (cont.) Default value after xCommand DefaultValuesSet Level: 3 Configuration item SNMP SystemContact <blank> SNMP SystemLocation <blank> SystemUnit AdminAccount [1..15] Access ReadWrite SystemUnit AdminAccount [1..15] Name <blank>...
  • Page 171: Password Encryption

    Grey Headline (continued) Password encryption TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Maximum length of passwords All passwords configured on the VCS are stored in encrypted form. This applies to the following, When a password is encrypted, it uses more characters than the original plain text version of the which all have usernames and passwords associated with them: password.
  • Page 172 Grey Headline (continued) TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Appendices This section includes the following appendices which provide supplementary information regarding the administration of the VCS: • CPL referenc • Regular expression referenc • Pattern variable referenc • VCS port referenc •...
  • Page 173: Cpl Reference

    It specifies which fields to match, and then a list of address nodes The VCS supports most of the CPL standard along with some TANDBERG-defined extensions. It contains the possible matches and their associated actions. <incoming>...
  • Page 174: Field

    Grey Headline (continued) CPL reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE address-switch field Within the address-switch node, the mandatory field parameter specifies which address is to be considered. The supported attributes and their interpretation are as follows: Authentication mode: On...
  • Page 175: Subfield

    Grey Headline (continued) CPL reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE address-switch subfield Within the address-switch node, the optional subfield parameter specifies which part of the address is to be considered. The following table gives the definition of subfields for each alias type.
  • Page 176: Location

    Grey Headline (continued) CPL reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE location proxy On executing a proxy node the VCS will attempt to forward the As the CPL script is evaluated it maintains a list of addresses (H.323 IDs, URLs and E.164 numbers) which will be used as the call to the locations specified in the current location set.
  • Page 177: Cpl Examples

    Grey Headline (continued) CPL reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE CPL examples Call screening of authenticated users Call screening based on alias In this example, only calls from users with authenticated source addresses are allowed. In this example, user...
  • Page 178: Call Screening Based On Domain

    Grey Headline (continued) CPL reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE CPL examples Call screening based on domain Change of domain name In this example, user fred will not accept calls from anyone at annoying.com, or from any In this example, Example Inc has changed its domain from example.net...
  • Page 179: Allow Calls From Locally Registered Endpoints Only

    <taa:routed> <address-switch field="registered-origin"> <address-switch field="registered-origin"> <not-present> <not-present> <reject status="403" reason="Only local endpoints can use this <address-switch field="originating-zone"> Tandberg VCS"/> <address is="DefaultZone"> </not-present> <!-- Reject call with a status code of 403 (Forbidden) --> </address-switch> <reject status="403" reason="Denied by policy"/> </taa:routed>...
  • Page 180: Restricting Access To A Local Gateway

    Grey Headline (continued) CPL reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE CPL examples Restricting access to a local gateway Using the rule-switch node In these examples, a gateway is registered to the VCS with a prefix of and the administrator wants to stop calls from outside the organization being routed through it.
  • Page 181: Redirecting Failed Calls Based On Status Code

    Grey Headline (continued) CPL reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE CPL examples <failure> Redirecting failed calls based on status code <!-- General catch-all failure handler for all other error proxy The output from a node allow actions to be taken based on the result of the proxy operation.
  • Page 182: Regular Expression Reference

    Grey Headline (continued) Regular expression reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Common regular expressions Regular expressions can be used in conjunction Character Description Example with a number of VCS features such as alias Matches any single character. transformations, zone transformations, CPL policy and ENUM.
  • Page 183: Pattern Variable Reference

    Grey Headline (continued) Pattern variable reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Valid variable strings The VCS makes use of pattern matching in a String Equals current value(s) returned by... When used in a Match field When used in a Replace field...
  • Page 184: Vcs Port Reference

    Grey Headline (continued) VCS port reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview The VCS uses different IP ports and protocols for different services and functions, and many of these are configurable. The table below lists each of Two services or functions cannot share these services and functions.
  • Page 185 Grey Headline (continued) VCS port reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE VCS ports Service/function Description Default Direction Available range Configurable via Traversal server media Used on the VCS Expressway for demultiplexing 2776 UDP inbound 1024 - 65534 VCS configuration > Expressway > Ports demultiplexing RTP RTP media.
  • Page 186 Grey Headline (continued) VCS port reference TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE VCS ports Service/function Description Default Direction Available range Configurable via Used for sending requests to DNS servers. 10000 - 10210 outbound not configurable H.225 and H.245 call The range of ports to be used for call signalling...
  • Page 187: Dns Configuration

    Grey Headline (continued) DNS configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview Microsoft DNS server This section gives examples of DNS configuration using Using Microsoft DNS Server you can add the SRV record using either the command line or the MMC snap-in.
  • Page 188: Ldap Configuration

    Grey Headline (continued) LDAP configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE About the LDAP databases Microsoft Active Directory The VCS can be configured to use a database on an LDAP Directory Server to store authentication Prerequisites credential information (usernames, passwords, and other relevant information) These step-by-step instructions assume that Active Directory has already been installed.
  • Page 189: Adding H.350 Objects

    Grey Headline (continued) LDAP configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Microsoft Active Directory Add the ldif file to the server using the command: Adding H.350 objects Securing with TLS ldifde -i -c DC=X <ldap _ base> -f filename.ldf To enable Active Directory to use TLS, you must request and...
  • Page 190: Openldap

    Grey Headline (continued) LDAP configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE OpenLDAP Prerequisites Installing the H.350 schemas These instructions assume that an OpenLDAP server has Copy the OpenLDAP files to the OpenLDAP schema directory: already been installed. For details on installing OpenLDAP see /etc/openldap/schemas/commobject.ldif...
  • Page 191: Adding H.350 Objects

    Grey Headline (continued) LDAP configuration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE OpenLDAP Adding H.350 objects Add the H.350 objects Securing with TLS ldif Create an file with the following contents: The connection to the LDAP server can be encrypted by enabling Create the organizational hierarchy Transport Level Security (TLS) on the connection.
  • Page 192: Command Reference - Xconfiguration

    Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview xConfiguration group of commands are used to The valid values for set and change individual items of configuration. Each this command are command is made up of a main element followed by one of the options one or more sub-elements.
  • Page 193 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Administration HTTP Mode: <On/Off> Determines whether HTTP calls will be redirected to the HTTPS port. On: calls will be redirected to HTTPS. Off: no HTTP access will be available.
  • Page 194 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Applications ConferenceFactory Alias: <S:0..60> The alias that will be dialed by the endpoints when the Multiway feature is activated. This must be pre-configured on all endpoints that may be used to initiate the Multiway feature.
  • Page 195 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Applications OCS Relay OCS Routing Prefix: <S:0..128> Prefix applied to requests routed through the VCS proxy, from the OCS Relay. This is then used to route the requests onto to the appropriate Microsoft Office Communications Server (via Neighbor zone matches).
  • Page 196 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Authentication Credential [1..2500] Name: <S: 0, 128> Defines the name for this entry in the local authentication database. xConfiguration Authentication Credential 1 Name: "john smith" Example: Authentication Credential [1..2500] Password: <S: 0, 215>...
  • Page 197 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Bandwidth Default: <64..2048> Sets the bandwidth (in kbps) to be used on calls managed by the VCS in cases where no bandwidth has been specified by the endpoint.
  • Page 198 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Bandwidth Pipe [1..100] Bandwidth PerCall Limit: <1..100000000> If this pipe has limited per-call bandwidth, sets the maximum amount of bandwidth (in kbps) available for any one call.
  • Page 199 Error Reports URL: <S: 0, 128> The URL of the web service to which error reports are sent. Default: http://vcser.tandberg.com/submitapplicationerror/ xConfiguration Error Reports URL: "http://vcser.tandberg.com/submitapplicationerror/" Example: Ethernet [1..2] IP V4 Address: <IPAddr> Specifies the IPv4 address of the specified LAN port.
  • Page 200 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Ethernet [1..2] IP V4 SubnetMask: <IPAddr> Specifies the IPv4 subnet mask of the specified LAN port. Note: You must restart the system for any changes to take effect.
  • Page 201 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE H323 Gatekeeper CallSignaling PortRange End: <1024..65534> Specifies the upper port in the range to be used by calls once they are established. Default: 19999 xConfiguration H323 Gatekeeper CallSignaling PortRange End: 19999 Example: H323 Gatekeeper CallSignaling PortRange Start: <1024..65534>...
  • Page 202 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE H323 Mode: <On/Off> Determines whether or not the VCS will provide H.323 gatekeeper functionality. Default: On xConfiguration H323 Mode: On Example: Interworking Encryption Mode: <Auto/Off> Determines whether or not the VCS will allow encrypted calls between SIP and H.323 endpoints.
  • Page 203 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE IP Gateway: <S: 7..15> Specifies the IPv4 gateway of the VCS. Note: You must restart the system for any changes to take effect. Default: 127.0.0.1 xConfiguration IP Gateway: "192.168.127.0"...
  • Page 204 Example: Option [1..64] Key: <S: 0, 90> Specifies the option key of your software option. These are added to the VCS in order to add extra functionality, such as increasing the VCS’s capacity. Contact your TANDBERG representative for further information.
  • Page 205 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Policy AdministratorPolicy Mode: <On/Off> Enables and disables use of Call Policy. Default: Off xConfiguration Policy AdministratorPolicy Mode: Off Example: Policy UserPolicy Mode: <Off/Local/Remote> Determines the User Policy Manager usage and location.
  • Page 206 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Registration AllowList [1..2500] Pattern Type: <Exact/Prefix/Suffix/Regex> Specifies whether the entry in the Allow List is a prefix, suffix, regular expression, or must be matched exactly. Exact: the string must match the alias character for character.
  • Page 207 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE SIP Mode: <On/Off> Determines whether or not the VCS will provide SIP registrar and SIP proxy functionality. This mode must be enabled in order to use either the Presence Server or the Presence User Agent.
  • Page 208 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE SIP Routes Route [1..20] Header Pattern: <S:0..128> Regular expression to match against the specified SIP header field. Note: this command is intended for developer use only. xConfiguration SIP Routes Route 1 Header Pattern: "(my-event-package) (.*)"...
  • Page 209 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE SIP TCP Outbound Port End: <1024..65534> Specifies the upper port in the range to be used by outbound TCP/TLS SIP connections. Default: 29999 xConfiguration SIP TCP Outbound Port End: 29999 Example: SIP TCP Outbound Port Start: <1024..65534>...
  • Page 210 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE SNMP Mode: <On/Off> Enables or disables SNMP support. Note: You must restart the system for any changes to take effect. Default: Off xConfiguration SNMP Mode: On Example: SNMP SystemContact: <S: 0, 70>...
  • Page 211 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE SystemUnit Password: <S: 0, 65> Defines the password for the default 'admin' account. This account is used to log in to the VCS via Telnet, HTTP(S), SSH, SCP, and on the serial port. The maximum plaintext length is 16 characters, which will then be encrypted.
  • Page 212 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Transform [1..100] Priority: <1..65534> Assigns a priority to the specified transform. Transforms are compared with incoming aliases in order of priority, and the priority must be unique for each transform.
  • Page 213 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Traversal Server STUN Discovery Mode: <On/Off> Determines whether the VCS will offer STUN discovery services to traversal clients. Default: On xConfiguration Traversal Server STUN Discovery Mode: On Example: Traversal Server STUN Discovery Port: <1024..65534>...
  • Page 214 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones LocalZone DefaultSubZone Bandwidth PerCall Intra Limit: <1..100000000> Specifies the bandwidth limit (in kbps) for any one call between two endpoints within the Default Subzone (applies only if Mode is set to Limited).
  • Page 215 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones LocalZone Match [1..5] Pattern Replace: <S:0..60> (Applies only if pattern behavior is set to Replace.) Specifies the string to be used as a substitution for the part of the alias that matched the pattern.
  • Page 216 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones LocalZone SubZone [1..100] Bandwidth PerCall Intra Mode: <Limited/Unlimited/NoBandwidth> Determines whether there is a limit on the bandwidth for any one call between two endpoints within this subzone.
  • Page 217 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones LocalZone Traversal H323 H46019 Demultiplexing Mode: <On/Off> Determines whether the VCS will operate in Demultiplexing mode for calls from traversal-enabled endpoints registered directly with it. On: allows use of the same two ports for all calls.
  • Page 218 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones LocalZone Traversal H323 UDPProbe RetryInterval: <1..65534> Sets the frequency (in seconds) with which traversal-enabled endpoints registered directly with the VCS will send a UDP probe to the VCS.
  • Page 219 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones Zone [1..200] DNS Interworking SIP EmptyInviteAllowed: <On/Off> Determines whether the VCS will generate a SIP INVITE message with no SDP to send to this zone. INVITES with no SDP mean that the destination device is asked to initiate the codec selection, and are used when the call has been interworked locally from H.323.
  • Page 220 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones Zone [1..200] DNS SIP SearchAutoResponse: <On/Off> Determines what happens when the VCS receives a SIP search that originated as an H.323 search, destined for this zone.
  • Page 221 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones Zone [1..200] Match [1..5] Pattern Behavior: <Strip/Leave/Replace> (Applies only if the Match mode is Pattern Match.) Determines whether the matched part of the alias should be modified before an LRQ is sent to this zone.
  • Page 222 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones Zone [1..200] Neighbor Interworking SIP Audio DefaultCodec: <G711u/G711a/G722_48/G722_56/G722_64/G722_1_16/G722_1_24/G722_1_32/G722_1_48/G723_1/G728/G729/AALCD_48/ AALCD_56/AALCD_64/AMR> Specifies which audio codec to use when empty INVITEs are not allowed. Default: G711u xConfiguration Zones Zone 3 Neighbor Interworking SIP Audio DefaultCodec: G711u Example: Zones Zone [1..200] Neighbor Interworking SIP EmptyInviteAllowed: <On/Off>...
  • Page 223 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones Zone [1..200] Neighbor SIP Encryption Mode: <Auto/Off> Determines whether or not the VCS will allow encrypted SIP calls on this zone. Auto: SIP calls will be encrypted if a secure SIP transport (TLS) is used.
  • Page 224 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones Zone [1..200] Neighbor SIP SDP Attribute Line Limit Mode: <On/Off> Determines whether requests containing SDP sent out to this zone will have the length of a=fmtp lines restricted.
  • Page 225 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones Zone [1..200] TraversalClient H323 Port: <1024..65534> Specifies the port on the traversal server to be used for H.323 firewall traversal calls from this VCS. If the traversal server is a VCS Expressway, this must be the port number that has been configured on the VCS Expressway's traversal server zone associated with this VCS.
  • Page 226 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones Zone [1..200] TraversalServer H323 H46019 Demultiplexing Mode: <On/Off> Determines whether the VCS will operate in Demultiplexing mode for calls from the traversal client. On: allows use of the same two ports for all calls.
  • Page 227 Grey Headline (continued) Command reference - xConfiguration TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones Zone [1..200] TraversalServer TCPProbe RetryCount: <1..65534> Sets the number of times the traversal client will attempt to send a TCP probe to the VCS. Default: 5 xConfiguration Zones Zone 5 TraversalServer TCPProbe RetryCount: 5...
  • Page 228: Command Reference - Xcommand

    Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview xCommand group of commands are used The valid values for this to add and delete items and issue system parameter are one of the commands. options shown within the angle brackets.
  • Page 229 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE AdminAccountAdd Creates a new administrator account. Name(r): <S:0..25> Defines the name of an administrator user who can login to the VCS web interface. Password(r): <S:0..65> Defines the password of an administrator user who can login to the VCS web interface. The maximum plaintext length is 16 characters, which will then be encrypted.
  • Page 230 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE CheckBandwidth A diagnostic tool that returns the status and route (as a list of nodes and links) that a call of the specified type and bandwidth would take between two nodes.
  • Page 231 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE CredentialDelete Deletes an entry from the local authentication database. CredentialId(r): <1..2500> The index of the credential to be deleted. xCommand CredentialDelete CredentialId: 2 Example: DefaultLinksAdd Restores links between the Default Subzone, Traversal Subzone and the Default Zone.
  • Page 232 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE DisconnectCall Disconnects a call. Call: <1..900> The index of the call to be disconnected. CallSerialNumber: <S: 1, 255> The serial number of the call to be disconnected.
  • Page 233 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE FeedbackDeregister Deactivates a particular feedback request. ID: <1..3> The index of the feedback request to be deactivated. xCommand FeedbackDeregister ID: 1 Example: FeedbackRegister Activates notifications on the event or status change(s) described by the Expression(s). Notifications are sent in XML format to the specified URL. Up to 15 Expressions may be registered for each of 3 feedback IDs.
  • Page 234 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE FindRegistration Returns information about the registration associated with the specified alias. The alias must be registered on the VCS on which the command is issued. Alias(r): <S: 1, 60>...
  • Page 235 LogPersist Example: OptionKeyAdd Adds a new option key to the VCS. These are added to the VCS in order to add extra functionality, such as increasing the VCS's capacity. Contact your TANDBERG representative for further information. Key(r): <S: 0, 90>...
  • Page 236 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE OptionKeyDelete Deletes a software option key from the VCS. OptionKeyId(r): <1..64> Specifies the ID of the software option to be deleted. xCommand OptionKeyDelete OptionKeyId: 2 Example: PipeAdd Adds and configures a new pipe.
  • Page 237 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE RouteAdd Adds and configures a new IP route (also known as a static route). Address(r): <S: 1, 39> Specifies an IP address used in conjunction with the Prefix Length to determine the network to which this route applies.
  • Page 238 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE SIPRouteAdd Adds a route that will cause SIP messages matching the given criteria to be forwarded to the specified IP address and port. Note: this command is intended for developer use only.
  • Page 239 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE SubZoneAdd Adds and configures a new subzone. SubZoneName(r): <S: 1, 50> Assigns a name to this subzone. Address: <S: 0, 39> Specifies an IP address used (in conjunction with the IP Prefix Length) to identify a subnet to be assigned to this subzone.
  • Page 240 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE TransformAdd Adds and configures a new transform. Pattern(r): <S: 1, 60> Specifies the pattern against which the alias is compared. Type: <Exact/Prefix/Suffix/Regex> Determines the way in which the string must match the alias. Exact: the string must match the alias character for character. Prefix: the string must appear at the beginning of the alias.
  • Page 241 Grey Headline (continued) Command reference - xCommand TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE WarningRaise Raises a warning. Note: this command is intended for developer use only. WarningID(r): <S:36..36> The warning ID. WarningText(r): <S:0..255> The description of the warning. xCommand WarningRaise WarningID: "ab3d63f6-c0bb-4a9c-a121-e683abfedff0" WarningText: "Module foo is malfunctioning”...
  • Page 242: Command Reference - Xstatus

    Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Overview xStatus xStatus group of commands are used to return information about the current status of the VCS. Each element returns information about one or more sub-elements.
  • Page 243 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Alternates: Peer [1..6]: {Hidden for Peer [n] when Peer [n] is self} Status: <Active/Failed/Unknown> Cause: {Visible if status is Failed} <No response from gatekeeper/DNS resolution failed/Invalid IP address>...
  • Page 244 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Subscriptions: Subscribers: Count: <0..n> Max: <0..n> Subscriber [1..2500]: URI: <S: 1,255> Subscription: Count: <1..100> Count: <1..2500> Max: <1..2500> Expired: <1..2500> Presentities: Count: <0..10000> Max: <0..10000> Presentity [1..10000]: URI: <S: 1,255>...
  • Page 245 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE User 1: Alias: <S: 1,255> Subscription: State: <Subscription request sent/Subscription successful/Subscription error response/Failed/Notification received/Active> Registration: State: <Registered/Not Registered> Presence: OCS: Machine: State: <Offline/Available/Undefined> User: State: <Undefined/Busy> VCS: State: <Offline/Online/In a call/Undefined>...
  • Page 246 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Aliases: Alias [1..50]: Type: <E164/H323Id> Value: <S: 1,60> SIP: {visible if Protocol = SIP} Address: <IPv4Addr/[IPv6Addr]>:<1..65534> Transport: <UDP/TCP/TLS/undefined> Aliases: Alias [1..50]: Type: <URL> Value: <S: 1,60> EncryptionType: <None/DES/AES-128>...
  • Page 247 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Bandwidth: Requested: <0..100000000> kbps Allocated: <0..100000000> kbps Route: Zone/Link: <S: 1,50 Node name> {0..150 entries} Media {visible if MediaRouted = True} Channels Channel [1..n] Type: <AUDIO/VIDEO/DATA/BFCP/H224/UNKNOWN> Protocol: <S: 1,20> {RTP Payload Type} Rate: <0..
  • Page 248 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE External Manager: Status: <Inactive/Initializing/Active/Failed> Cause: {Visible if status is Failed} <Failed to connect to external manager / No response from external manager / Failed to register to external manager / DNS resolution failed >...
  • Page 249 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE IPv6: {Visible if Status=Active} Address: <IPv6Addr> {1..2 entries} H46018: CallSignaling: Status: <Active/Inactive/Failed> IPv4: {Visible if Status=Active} Address: <IPv4Addr> {1..2 entries} IPv6: {Visible if Status=Active} Address: <IPv6Addr> {1..2 entries} Protocol: <IPv4/IPv6/Both>...
  • Page 250 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Links: Link [1..100]: Name: <S: 1,50 Link name> Bandwidth: LocalUsage: <0..100000000> ClusterUsage: <0..100000000> Calls: Call [0..900]: {0..900 entries} CallSerialNumber: <S: 1,255> Loggers Logger [1..6] Module: TraceLevel: NTP: Status: <Inactive/Initializing/Active/Failed>...
  • Page 251 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Pipes: Pipe [1..100]: Name: <S: 1,50 Pipe name> Bandwidth: LocalUsage: <0..100000000> ClusterUsage: <0..100000000> Calls: Call [0..900]: {0..900 entries} CallID: <S: 1,255> Registrations: Registration [1..3750]: Protocol: <H323/SIP> Node: <S: 1,50 Node name>...
  • Page 252 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Aliases: Alias [1..50]: Type: <E164/H323Id/URL/Email/GW Prefix/MCU Prefix/Prefix/Suffix/IPAddress> Origin: <Endpoint/LDAP/Combined> Value: <S: 1,60> Traversal: <Assent/H46018> {Visible for Traversal registration} SIP: {Visible if Protocol is SIP} AOR: <S: 1,128>...
  • Page 253 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE SIP: Ethernet [1..2] IPv4: UDP: Status: <Active/Inactive/Failed> Address: <IPv4Addr> TCP: Status: <Active/Inactive/Failed> Address: <IPv4Addr> TLS: Status: <Active/Inactive/Failed> Address: <IPv4Addr> IPv6: UDP: Status: <Active/Inactive/Failed> Address: <IPv6Addr> TCP: Status: <Active/Inactive/Failed>...
  • Page 254 Count: <0..800> Relay [1..800]: Client: <IPv4Addr/IPv6Addr> RelayAddress: <IPv4Addr/IPv6Addr> CreationTime: <Date Time> ExpireTime: <Date Time> SystemUnit: Product: TANDBERG VCS Uptime: <Time in seconds> SystemTime: <Time not set/date-time> TimeZone: <GMT or one of 300 other timezones> LocalTime: <local-date-time> Software: Version: X4.1 Build: <Number/Uncontrolled>...
  • Page 255 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Configuration: NonTraversalCalls: <0..500> TraversalCalls: <0..100> Registrations: <0..2500> Expressway: <True/False> Encryption: <True/False> Interworking: <True/False> UserPolicy: <True/False> DeviceProvisioning: <True/False> DualNetworkInterfaces: <True/False> Hardware: Version: 1.0 SerialNumber: <hardware serial number> UserPolicyManager: Mode: <Off/Local/Remote>...
  • Page 256 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Zones: DefaultZone: Name: “DefaultZone” Bandwidth: LocalUsage: <0..100000000> ClusterUsage: <0..100000000> Calls: {Section visible only if there are calls } Call [0..900]: {0..900 entries} CallId: <S: 1,255> LocalZone: DefaultSubZone: Name: “DefaultSubZone”...
  • Page 257 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE ClusterSubZone: Name: “ClusterSubZone” Bandwidth: LocalUsage: <0..100000000> ClusterUsage: <0..100000000> Calls: {Section visible only if there are calls } Call [0..900]: {0..900 entries} CallId: <S: 1,255> SubZone: [0..100] Name: <S: 1,50 Node name>...
  • Page 258 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Neighbor: {Visible if Type is Neighbor} Peer [1..6]: H323: {Visible if H323 Mode=On for Zone} Status: <Unknown/Active/Failed> Cause: {Visible if Status is Failed} <No response from gatekeeper/DNS resolution failed/Invalid IP address>...
  • Page 259 Grey Headline (continued) Command reference - xStatus TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE TraversalServer: {Visible if Type is TraversalServer} SIP: Port: <Active/Inactive> H323: Port: <Active/Inactive> Peer [1..6]: H323: {Visible if H323 Mode=On for Zone} Status: Active Address: <IPv4Addr/IPv6Addr> {One Address line per address from DNS lookup} Port: <1..65534>...
  • Page 260: Bibliography

    TANDBERG VCS Control X4 and Microsoft OCS 2007 Deployment Guide www.tandberg.com/support/documentation.php TANDBERG Multiway Deployment Guide (document no. D14366) www.tandberg.com/support/documentation.php TANDBERG Provisioning Directory Deployment Guide www.tandberg.com/support/documentation.php TANDBERG Deployment Guide - Creating a Cluster of VCS X4 peers (document no.D14367) www.tandberg.com/support/documentation.php Overview and System Zones and Call...
  • Page 261: Glossary

    A collection of between two and six VCSs that have been configured to work together as a single Local Zone, in order to provide scalability and redundancy. Conference Factory An application that allows the VCS to support TANDBERG's Multiway feature. Multiway enables endpoint users to create a conference while in a call even if their endpoint does not have this functionality built in. See the Conference Factory section for more information.
  • Page 262 The act of crossing a firewall or NAT device. FindMe™ A TANDBERG feature that allows users to have a single alias on which they can be reached regardless of the endpoint(s) they are currently using. FQDN A domain name that specifies the node’s position in the DNS tree absolutely, uniquely identifying the system or device. Note that in order to use FQDNs instead of Fully Qualified Domain Name...
  • Page 263 Grey Headline (continued) Glossary TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Term Definition Link In relation to the VCS, a connection between two nodes. Local call (Also referred to as a non-traversal call.) A call where the signaling but not the media is routed through the local VCS. See the section What are traversal calls? more information.
  • Page 264 Grey Headline (continued) Glossary TANDBERG VIDEO COMMUNICATIONS SERVER ADMINISTRATOR GUIDE Term Definition Proxy, In SIP, an intermediary entity that acts as both a server and a client for the purpose of making requests on behalf of other clients. A proxy server primarily plays the Proxy server role of routing, which means its job is to ensure that a request is sent to another entity “closer”...
  • Page 265 TANDBERG Management Suite TMS Agent A VCS feature that allows TANDBERG Movi™ v2.0 clients registered to the VCS to be provisioned with phonebook and configuration information by connecting to the VCS rather than directly to TMS. See the TMS Agent section for more information.
  • Page 266: Contact Information

    Philip Pedersens vei 20, 1366 Lysaker, Norway Telephone: +47 67 125 125 Fax: +47 67 125 234 Video: +47 67 126 126 Email: tandberg@tandberg.com U.S. HEADQUARTERS 1212 Avenue of the Americas 24th Floor, New York, NY 10036 Telephone: +1 212 692 6500...

Table of Contents