3Com 900-0368-01 User Manual

IP Conferencing Module Installation Guide

3Com® Networked Telephony Systems NBX® System Release 6.0

http://www.3com.com/

Part Number 900-0368-01 Rev AB Published November 2007

3Com Corporation 350 Campus Drive Marlborough, MA 01752-3064

Copyright © 2007, 3Com Corporation. All rights reserved. No part of this documentation may be reproduced in any form or by any means or used to make any derivative work (such as translation, transformation, or adaptation) without written permission from 3Com Corporation.

3Com Corporation reserves the right to revise this documentation and to make changes in content from time to time without obligation on the part of 3Com Corporation to provide notification of such revision or change.

3Com Corporation provides this documentation without warranty of any kind, either implied or expressed, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. 3Com may make improvements or changes in the product(s) and/or the program(s) described in this documentation at any time.

UNITED STATES GOVERNMENT LEGENDS:

If you are a United States government agency, then this documentation and the software described herein are provided to you subject to the following:

United States Government Legend: All technical data and computer software is commercial in nature and developed solely at private expense. Software is delivered as Commercial Computer Software as defined in DFARS 252.227-7014 (June 1995) or as a commercial item as defined in FAR such is provided with only such rights as are provided in 3Com’s standard commercial license for the Software. Technical data is provided with limited rights only as provided in DFAR 252.227-7015 (Nov

1995) or FAR portion of any legend provided on any licensed program or documentation contained in, or delivered to you in conjunction with guide.

Unless otherwise indicated, 3Com registered trademarks are registered in the United States and may or may not be registered in other countries.

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

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

52.227-14 (June 1987), whichever is applicable. You agree not to remove or deface any

2.101(a) and as

CONTENTS

ABOUT THIS GUIDE

Conventions 5

Notices 5

Text 6 Related Documentation 6 Comments 6

1 PRE-INSTALLATION

Configuration Overview 9

Post-installation Setup 10 Gathering Site Information 10

Using DNS 11

Single Server 11 Worksheet 11

2 INSTALLATION SCRIPTS

Overview of Components 15 Initial Installation - Services Installed 16 Initial Installation - Configuration Guidelines 17 Single Server Initial Installation 18

Sample setup Script (All-in-one server) 18 Post Installation Configuration 34

Set up Routes 34

Add Trusted SIP Interfaces 35

Configuring the IP Conferencing Module 36

Test E-Mail Notification Setup 39 Upgrade Installation 40

Sample install-upgrade Script 40

Sample vcx-switchversion Script 43 Managing the Activation Keys 44

3 OBTAINING SUPPORT FOR YOUR PRODUCT

Register Your Product 47 Purchase Value-Added Services 47 Troubleshoot Online 48 Access Software Downloads 48 Telephone Technical Support and Repair 48 Contact Us 49

INDEX

ABOUT THIS GUIDE

This section contains an overview of this guide, lists guide conventions, related documentation, and product compatibility.

This guide describes how to answer the questions in the installation scripts, which run when you first start a 3Com Server. By providing the correct answers to the script questions, you configure the system for initial operation.

This guide is intended for equipment installers who have a thorough understanding of telecommunications, VoIP technology, Linux operating systems, databases, networks, and system administrator privileges.

Release Notes are issued with some products. If the information in the release notes differs from the information in this guide, follow the instructions in the release notes.

Conventions This section describes notice, text, and figure conventions.

Notices Tab le 1 lists notice icons.

Ta bl e 1 Notice Icon Descriptions

Icon Notice Type Description

Information note Information that describes important features or

instructions

IP Conferencing Module

Caution Information that alerts you to potential loss of

data or potential damage to an application, system, or device

Warning

Information that alerts you to potential personal injury

6 ABOUT THIS GUIDE

Te xt Ta bl e 2 lists text conventions.

Ta bl e 2 Text Convention Descriptions

Convention Description

Screen displays This typeface represents information as it appears on the

screen.

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

command exactly as shown and then press Return or Enter. Commands appear in bold. Example:

To remove the IP address, enter the following command:

SETDefault !0 -IP NETaddr = 0.0.0.0

Words in italics Italics are used to:

■ Emphasize a point.

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

the text.

■ Identify menu names, menu commands, and software

button names. Examples:

From the Help menu, select Contents.

Click OK.

Comments Send e-mail comments about this guide or about any Voice product

documentation to:

VOICE_Techcomm_comments@3com.com

Include the following information with your comments:

■ Document title

■ Document part number (found on the front page)

■ Page number

■ Your name and organization (optional)

Example:

Comments 7

IP Conferencing Module Installation Guide System Release 6.0

Part Number 900-0368-01 Page 25

Please address all questions regarding 3Com software to your authorized 3Com representative.

8 ABOUT THIS GUIDE

PRE-INSTALLATION

This chapter provides pre-installation guidelines for the 3Com IP Conferencing Module, which is an optional component of the 3Com NBX Networked Telephony System.

The NBX system does not support presence. References to the “presence server” and “presence database” in this document are applicable to other products in the 3Com Convergence Applications Suite.

■ Configuration Overview

■ Gathering Site Information

■ Worksheet

Configuration Overview

All of the software components of the 3Com IP Conferencing Module must be installed on a single hardware server. Multiple server installations are not supported.

The hardware server that hosts the 3Com IP Conferencing Module software must run the 3Com VCX 3Com price list for details.

Components installed on the single server:

■ conference server/conference attendant server

■ NBX user database

■ conferencing database (master)

■ web console server

™

Linux operating system. Consult the

10 CHAPTER 1: PRE-INSTALLATION

Conference server pool

Conference server Presence server Master database User database Web server

NBX server

Figure 1 Network diagram - single server

Post-installation

Gathering Site Information

After you run the installation script, you need to configure the following:

Setup

Setting up a Route to the Conference Servers

You must configure the NBX dial plan with a route to your conference server. If your implementation has only one server, then a route to a single endpoint is required.

Setting up a Route to the Conference Attendant Servers

As with the conference server, it is necessary to configure a route for the conference attendant server. The NBX dial plan is used for this purpose.

Test E-Mail Notification Setup

You must test the e-mail setup by logging in to the system and sending an e-mail message using Send-only Simple Mail Transfer Protocol (sSMTP). If you fail to receive the test e-mail message, you can check for errors in /opt/logs/vcx-linux/maillog.

The 3Com NBX servers communicate with each other using IP addresses. These addresses must be dedicated (static) and must be compatible with your network design.

Worksheet 11

One or more 3Com IP Conferencing Module servers may be added to a system.

Using DNS 3Com recommends that you configure your DNS servers so that they

know the IP addresses of all NBX servers and gateways. If you prefer to not use DNS, you can edit the /etc/hosts files on the IP Conferencing Module and all of the NBX servers.

3Com does not support NIS or WINS as domain name resolution methods for NBX products.

Single Server You require the following:

■ You must dedicate one IP address to the 3Com IP Conferencing

Module.

■ You must assign a host name to the 3Com IP Conferencing Module.

■ You must know the IP address of the network gateway.

■ You must know the IP addresses of the primary and secondary DNS

servers.

■ You must know the IP addresses of the primary and secondary NTP

servers.

Worksheet To make it easier to configure your system, you may want to have the

necessary information in front of you before you begin to install any server.

Ta bl e 3 Network Configuration Parameters

Configuration Parameter Value

3Com IP Conferencing Module IP address (eth0)

3Com IP Conferencing Module host name

Subnetwork mask

Gateway IP address

Primary DNS server IP address

Secondary DNS server IP address

DNS search path

Primary NTP server IP address

Secondary NTP server IP address

12 CHAPTER 1: PRE-INSTALLATION

Table 3 Network Configuration Parameters (continued)

Continent

Country

Time Zone

Ta bl e 4 System Configuration Parameters

Configuration Parameter Value

Services:

1. Presence and Conference - all in one

2. Conferencing server

3. Conferencing and database server

4. Data server for presence and conferencing

5. Presence server (with database)

Ta bl e 5 E-Mail Notification Parameters

Configuration Parameter Value

Mailhub (computer that handles mail)

Hostname of your computer

Mail name of your system

System user e-mail address

Ta bl e 6 Database Configuration Parameters

Configuration Parameter Value

Database:

1. Local Master: this server will have the master db

2. Local Slave: this server will have the slave db

3. Remote database: db is on another server

Worksheet 13

Ta bl e 7 Initial Configuration Parameters

Configuration Parameter Value

Fully qualified hostname of the installation

Administrator’s e-mail address

Activation key(s)

Minimum value for numeric conference names

Maximum value for numeric conference names

Prefix for Ad Hoc conference names

Prefix for Group Call names

IP address of the primary dialout proxy

IP address of the secondary dialout proxy

Digit Map for DTMF dialout

NBX server Site ID (enter on master only)

NBX Server IP address (primary server: eth0)

Username for NBX database synchronization

Password for NBX database synchronization

14 CHAPTER 1: PRE-INSTALLATION

INSTALLATION SCRIPTS

This chapter describes the initial configuration of each 3Com IP Conferencing Module server in a NBX system. All software components run on each server.

The installation scripts are run on command. Each time a script prompts you for a response, you can accept the default (preconfigured) value by pressing the Return or Enter key, or you can manually enter a different value.

If necessary, you can re-run the scripts and enter new values.

Verify that all the procedures outlined in Chapter 1, “Pre-Installation” have been completed before continuing with this chapter.

Overview of Components

This chapter contains information on the following:

■ Overview of Components

■ Initial Installation - Services Installed

■ Initial Installation - Configuration Guidelines

■ Single Server Initial Installation

■ Post Installation Configuration

■ Upgrade Installation

■ Managing the Activation Keys

This section provides a general description of the various components of the IP Conferencing Module.

16 CHAPTER 2: INSTALLATION SCRIPTS

■ Web Provisioning Server — Allows for the creation of conferences and

maintenance of the server.

■ Conference Server — Allows users to join conferences that support

any or all of audio, video, and desktop sharing communication modes.

■ Conference Attendant — Allows users to join conferences by dialing a

single access number independent of conference ID. The attendant prompts the user for the conference ID and, if required, the conference passcode.

■ Presence Server (optional) — Collects and distributes the online status

information of users.

■ Conference Server Database — Database of IP Conferencing Module

activity. On systems with two or more servers, a single database pair (master and slave) is supported.

■ NBX user database — Database of NBX system users.

The NBX system does not support presence.

Initial Installation Services Installed

When you perform an initial software installation (a “fresh” install), you must run the setup script for each hardware server in your conference server pool. The script provisions the following services on the hardware server:

Network Configuration — For the initial installation, you are prompted to enter general networking settings.

System Configuration — The script prompts you to select the configuration that matches the services you have purchased. Select one of the following:

■ Presence and Conference (All-in-one): Installs all components,

including the conference server, conference attendant server, web server, NBX user database, and conference database.

■ Conferencing server: Installs the conference server and conference

attendant server.

■ Conferencing and database server: Installs the conference server,

conference attendant server, and conference database.

■ Data server for presence and conferencing: Installs the conference

database.

+ 36 hidden pages