IP Conferencing Module Installation Guide 3Com® Convergence Applications Suite VCX System Release 7.2 http://www.3com.
3Com Corporation 350 Campus Drive Marlborough, MA 01752-3064 Copyright © 2006, 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.
CONTENTS ABOUT THIS GUIDE Conventions 5 Notices 5 Text 6 Related Documentation Comments 7 1 6 PRE-INSTALLATION Configuration Options 9 Option 1: Single Server 9 Option 2: Dual Server 10 Option 3: Multiple Servers (Four to Twelve) Post-installation Setup 12 Gathering Site Information 13 Using DNS 13 Single Server 14 Dual Servers 14 Multiple Servers (Four to Twelve) 14 Worksheet 15 2 11 INSTALLATION SCRIPTS Overview of Components 17 Initial Installation - Services Installed 18 Initial Installation - Con
Sample vcx-setup Script (Secondary server) 80 Sample vcx-setup Script (Conference server) 92 Post Installation Configuration 104 Set up Conference Server Routes 104 Set up Conference Attendant Routes 105 Trusted Host Configuration 106 Test E-Mail Notification Setup 108 Upgrade Installation 109 Distributed Implementation Upgrade Guidelines 109 Sample install-upgrade Script 109 Sample vcx-switchversion Script 112 Managing the Activation Keys 113 3 OBTAINING SUPPORT FOR YOUR PRODUCT Register Your Product 115
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® IP Conferencing Module Server. By providing the correct answers to the script questions, you configure the system for initial operation.
ABOUT THIS GUIDE Text Table 2 lists text conventions. Table 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: n n n Emphasize a point.
Comments 7 The following documents are a part of the IP Messaging Module: n IP Messaging Module Product Overview n IP Messaging Module Quick Reference Guide - 3Com Native Interface n IP Messaging Module User Guide - 3Com Native Interface n IP Messaging Module Quick Reference Guide - Traditional Interface n IP Messaging Module User Guide - Traditional Interface n IP Messaging Module Operations and System Administration Guide n E-Mail Reader Application Quick Start Guide The following document
ABOUT THIS GUIDE n Page number n Your name and organization (optional) Example: IP Conferencing Module Installation Guide System Release 7.1 Part Number 900-0353-01 Page 25 Please address all questions regarding 3Com software to your authorized 3Com representative.
1 PRE-INSTALLATION This chapter provides pre-installation guidelines for the 3Com IP Conferencing Module, which is an optional component of the 3Com VCX™ V7000 IP Telephony System. Configuration Options n Configuration Options n Gathering Site Information n Worksheet This section describes sample hardware/software configurations that support the 3Com IP Conferencing Module. Three basic configurations are possible. The option you select depends on the number of hardware servers you have.
CHAPTER 1: PRE-INSTALLATION Figure 1 Network diagram - single server Conference server pool Conference server Presence server Master database User database Web server VCX or NBX server Option 2: Dual Server If you have two servers, configure the primary server as a “provisioning” server by installing the web console server, initial master database, VCX user database, presence server, and conference server on it.
Configuration Options 11 Figure 2 Network diagram - two servers Conference server pool Conference server Presence server Master database User database Web console Conference server Slave database Primary Server Secondary Server VCX or NBX server Both servers in the conference pool use their eth0 interface to connect to the network.
CHAPTER 1: PRE-INSTALLATION Figure 3 Network diagram - multiple servers Conference server pool Conference server Conference server Presence server Master database User database Web server Primary Server Conference server Slave database Conference server Conference server Secondary Server VCX or NBX server All servers in the pool use their eth0 interface to connect to the network.
Gathering Site Information 13 Once the route is set up, the VCX system will forward conference calls to the designated endpoints—conference servers that provide a “routing” function by redirecting calls to ”hosting” conference servers. A single conference server can provide both routing and hosting functionality. Setting up a Route to the Conference Attendant Servers As with conference servers, it is necessary to configure a route for conference attendant servers.
CHAPTER 1: PRE-INSTALLATION Single Server Dual Servers If your network contains a single server, you require the following: n You must dedicate one IP address to the 3Com IP Conferencing Module. n You must assign a host name to the 3Com IP Conferencing Module. n You must know the IP address of the network gateway. n You must know the IP addresses of the primary and secondary DNS servers. n You must know the IP addresses of the primary and secondary NTP servers.
Worksheet Worksheet 15 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.
CHAPTER 1: PRE-INSTALLATION Table 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 Table 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.
2 INSTALLATION SCRIPTS This chapter describes the initial configuration of each 3Com IP Conferencing Module server in a VCX 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.
CHAPTER 2: INSTALLATION SCRIPTS Initial Installation Services Installed n Web Provisioning Server — Allows for the creation of conferences and maintenance of the server. n Conference Server — Allows SIP devices to join conferences that support any or all of audio, video, and desktop sharing communication modes. n Conference Attendant — Allows users to join conferences by dialing a single access number independent of conference ID.
Initial Installation - Configuration Guidelines n 19 Presence server (with database): Presence server, web server, VCX user database, and conference & presence database. E-Mail (sSMTP) Configuration — This portion of the script configures the Send-only Simple Mail Transfer Protocol (sSMTP) that enables the system to send e-mail notifications when conferences are created or modified, or when users add contacts to their buddy lists. Database Configuration — Select a database configuration for this server.
CHAPTER 2: INSTALLATION SCRIPTS Dual Server Configuration General installation steps: 1 On the primary server, run the vcx-setup script: a When prompted to select the services the system will provide, select 1 (presence and conference - all in one). b When prompted to select a database configuration, select 1 (Local Master). c When prompted to start the 3Com IP Conferencing Services, enter Y. All services will start except DB_watchdog.
Initial Installation - Configuration Guidelines 21 All services will start except DB_watchdog. It starts after the secondary server is installed and the database replication process is initiated. 2 On the secondary server, run the vcx-setup script: a When prompted to select the services the system will provide, select 4 (Data server for presence and conferencing). b When prompted to select a database configuration, select 2 (Local Slave: this server will have a slave database).
CHAPTER 2: INSTALLATION SCRIPTS When configuring the network parameters on the VCX Linux server, make sure you specify the fully qualified domain name for your system, not just the hostname. For example, use conf01.yourcompany.com not conf01. Use a local connection to the server to complete the initial software installation. The vcx-setup script is divided into five sections: n network configuration n system configuration n e-mail configuration n database configuration n initial configuration.
Single Server Initial Installation Enter vcx-setup at the command prompt. ------------------------------------------------------------------------------------ Welcome to the VCX Linux Network Configuration Wizard -----------------------------------------------------------------------------------This wizard sets up networking and related services. Start of Network Configuration Configure networking now? [yes] : Press the Enter or Return key to accept yes as the suggested answer.
CHAPTER 2: INSTALLATION SCRIPTS ---------- Configuring Network Time Protocol ---------Enter NTP servers one at a time. When done, enter 0.0.0.0 to stop. Primary NTP Server [192.168.1.253] : 10.35.10.51 Secondary NTP Server [192.168.1.252] : 10.36.10.51 Additional NTP Server : 10.1.0.3 -------------------------- Configuring Time Zone -------------------------Please select a geographic location from the following list: 1. Africa 2. Americas 3. Antarctica 4. Arctic Ocean 5. Asia 6. Atlantic Ocean 7.
Single Server Initial Installation Please select a time zone from the following list: 1. Alaska Time 2. Alaska Time - Alaska panhandle 3. Alaska Time - Alaska panhandle neck 4. Alaska Time - west Alaska 5. Aleutian Islands 6. Central Time 7. Central Time - Michigan - Wisconsin border 8. Central Time - North Dakota - Oliver County 9. Eastern Standard Time - Indiana - Crawford County 10. Eastern Standard Time - Indiana - Starke County 11. Eastern Standard Time - Indiana - Switzerland County 12.
CHAPTER 2: INSTALLATION SCRIPTS Is all of the above information correct? [yes] : ----------------------------------------------------------------------------------------------------------------------------------------------------Please wait while the wizard completes. Saving configuration...Done. End of Network Configuration The network configuration is complete. If necessary, you can re-run this portion of the script by entering vcx-config-network -wizard.
Single Server Initial Installation You have chosen to configure this system to provide: Presence and Conference - all in one Note that in order for these services to work, you must have purchased an appropriate license and installed the corresponding license activation key on this system. *** WARNING *** Once you confirm your selection, you cannot change it.
CHAPTER 2: INSTALLATION SCRIPTS vcx-firewall.1.5.5 mysql.3.23.58 : [keep; used in 2.9.3] : [keep; used in 2.9.3] No extra packages were found. End of System Configuration The system configuration is complete. If necessary, you can re-run this portion of the script by entering vcx-setconfigtype. Start of E-mail (sSMTP) Configuration After successful completion of the system configuration, the script will prompt you to set up the e-mail notification utility.
Single Server Initial Installation 29 address for each user, in which case don't use FromLineOverride=YES. See the man page.) FromLineOverride? [YES]: Specify how sSMTP handles the From: line of outgoing mail. (3) hostname sSMTP uses the hostname of your computer to identify itself to the mailhub, and in the Received: headers of the outgoing mail. This has relatively little effect on how the mail is handled. Use the fully-qualified domain name (FQDN) of your computer(foo.bar.baz).
CHAPTER 2: INSTALLATION SCRIPTS Tcl is already installed Tcl version is 8.3 Please report any installation problem to "3Com Support" End of E-mail (sSMTP) Configuration The e-mail configuration is complete. If necessary, you can re-run this portion of the script by entering usr/sbin/smtp-configure. Start of Database Configuration After successful completion of the e-mail configuration, the script will prompt you to select a database configuration.
Single Server Initial Installation 31 Enter the administrator's email address. [sipadmin@yourcompany.com]: Assuming default value as sipadmin@yourcompany.com Enter the administrator’s e-mail address. The default is derived from the hostname defined in the network configuration (above). If the system is configured to send e-mail notification of conference events to users, the e-mails will appear to be sent from the administrator (sipadmin@yourcompany.com).
CHAPTER 2: INSTALLATION SCRIPTS The license key sippeng:-:+:2006-11-11:2006-11-11:-:dcdb0531a90ffbf027786aa0a4732a98 is valid MySQL is needed for your application. mysql is found at /opt/3com/VCX/bin/mysql Assuming mysql is already installed Enter the mysql user name for accessing the master database.[root]: Assuming default value as root Enter the host name on which the master database is running. [localhost]: Assuming default value as localhost Enter the mysql password for user root at localhost.
Single Server Initial Installation 33 Enter the digitmap for DTMF dialout.[[1-7]XX|9XXXXXXXXXX|91XXXXXXXXX|9011.XT]: Assuming default value as [1-7]XX|9XXXXXXXXXX|91XXXXXXXXX|9011.XT Enter the digit map used to define the dial plan for DTMF dialout. Several lines of text appear before the next prompt. -- Creating cinema_db.conf -- Changing permissions of all the files in /opt/3com/components/presconf.2.2.2.190 to 755. -- Trying to load fbsql.so... -- fbsql is loaded...
CHAPTER 2: INSTALLATION SCRIPTS Creating table domain *** Checking table sipd_log *** Creating table sipd_log *** Checking table conferences *** Creating table conferences *** Checking table eventattendee *** Creating table eventattendee *** Checking table user_config *** Creating table user_config *** Checking table cinema *** Creating table cinema *** Checking table address *** Creating table address *** Checking table confinstances *** Creating table confinstances *** Checking table person *** Creat
Single Server Initial Installation Creating table Cards *** Checking table groupmember *** Creating table groupmember *** Checking table subscription *** Creating table subscription *** Checking table messageboard *** Creating table messageboard *** Checking table confsrv_config *** Creating table confsrv_config *** Checking table ua_capabilities *** Creating table ua_capabilities *** Checking table trusted_host *** Creating table trusted_host *** Checking table vmail *** Creating table vmail *** Checking
CHAPTER 2: INSTALLATION SCRIPTS Creating table election *** Checking table persongroup *** Creating table persongroup *** Checking table sipd_config *** Creating table sipd_config *** Checking table ssl_config *** Creating table ssl_config -- createdb is complete -- *IMPORTANT*: Adding administrator root@yourcompany.com with password root -- Database is successfully initialized. MYSQL host is localhost MYSQL user is root Enter the IP address of the VCX Data Server: 10.20.30.
Single Server Initial Installation 37 restarting httpd... Creating a directory client_config to hold the soft client autoconfiguration files... Directory created successfully at /opt/3com/components/presconf.2.5.3/client_config Any files that you store in this directory are accessible via http://master.yourcompany.com/3c3/.xml If you have not already entered the license string during installation you must do so from the web interface before trying to run any application in 3Com software.
CHAPTER 2: INSTALLATION SCRIPTS Stopping VCX-Firewall: [ OK ] Starting VCX-Firewall: [ OK ] Starting VCX Services: Starting vcx/mysql: [ OK ] Starting vcx/confbridge: [ Starting vcx/sipconf: [ OK ] Starting vcx/sippeng: [ OK ] Starting vcx/vcxdb: [ OK OK ] ] Started VCX Services: 5 started. -bash-2.05b# End of IP Conferencing Module Configuration Following successful completion of the script, the 3Com IP Conferencing Module services will be installed.
Dual Server Initial Installation 39 The vcx-setup script displays the current settings and then asks you if you want to accept or update them. Sample answers are provided in bold type along with explanations of those answers. Explanations are in italics. To run the vcx-setup script: 1 Log in to the server as root. 2 Enter a password (default is pvadmin). 3 Press Enter (or Return). -bash-2.05b# vcx-setup Enter vcx-setup at the command prompt.
CHAPTER 2: INSTALLATION SCRIPTS Enter DNS servers one at a time. When done, enter 0.0.0.0 to stop. Primary DNS Server [192.168.1.1] : 10.25.10.31 Secondary DNS Server [192.168.1.2] : 10.26.10.31 Tertiary DNS Server [0.0.0.0] : 0.0.0.0 ---------- Configuring DNS Search Path ---------Press Enter to leave the current path unchanged, or specify a new search path, with spaces separating each entry. DNS Search Path []: yourcompany.
Dual Server Initial Installation 10. Belize 11. Canada 12. Chile 13. Colombia 14. Costa Rica 15. Cuba 16. Dominica 17. Dominican Republic Enter country [44] : 27. 28. 29. 30. 31. 32. 33. 34. Jamaica St Kitts & Nevis Cayman Islands St Lucia Martinique Montserrat Mexico Nicaragua 44. 45. 46. 47. 48. 49. United States Uruguay St Vincent Venezuela Virgin Islands (UK) Virgin Islands (US) Press the Enter or Return key to accept 44 as the suggested answer.
CHAPTER 2: INSTALLATION SCRIPTS DNS Servers: 10.25.10.31 10.26.10.31 Search Domains:yourcompany.com NTP Servers: 10.35.10.51 10.36.10.51 10.1.0.3 Time Zone: America/New_York --------------------------------------------------------------------------Is all of the above information correct? [yes] : ----------------------------------------------------------------------------------------------------------------------------------------------------Please wait while the wizard completes.
Dual Server Initial Installation Select “1” to install the following components: - conference server - conference attendant server - presence server - web server - VCX user database - conference & presence database. You have chosen to configure this system to provide: Presence and Conference - all in one Note that in order for these services to work, you must have purchased an appropriate license and installed the corresponding license activation key on this system.
CHAPTER 2: INSTALLATION SCRIPTS Removing unneeded application components from the system. This may take several minutes. Please wait while the operation completes. Determining which packages are not used by any VCX version: oem.7.0.1 presconf.2.5.3 presconf-conf.2.5.3 presconf-presence.2.5.3 presconf-vcxdb.2.5.3 presconf-web.2.5.3 vcx-firewall.1.5.5 mysql.3.23.
Dual Server Initial Installation 45 (2) FromLineOverride This specifies how sSMTP handles the From: line of outgoing mail. If FromLineOverride=YES, sSMTP will leave the From: line alone if it already exists. If FromLineOverride has any other value, or there is no From: line, sSMTP creates the From: line using your username (or the -f command-line option), and the value of the rewriteDomain option (step (4), below). If you use a mail user agent (MUA; e.g.
CHAPTER 2: INSTALLATION SCRIPTS Enter the system user e-mail address. Note: check with your e-mail administrator for the proper system user e-mail address. Wrote configuration file /etc/ssmtp/ssmtp.conf Starting mysqld daemon with databases from /opt/3comdata/mysql Tcl is already installed Tcl version is 8.3 Please report any installation problem to "3Com Support" End of E-mail (sSMTP) Configuration The e-mail configuration is complete.
Dual Server Initial Installation 47 [host.yourcompany.com]: Assuming default value as master.yourcompany.com Enter the fully qualified hostname of the machine you are installing on. Assuming the userid of the administrator who will manage the applications for your domain is root Enter the administrator's email address. [sipadmin@yourcompany.com]: Assuming default value as sipadmin@yourcompany.com Enter the administrator’s e-mail address.
CHAPTER 2: INSTALLATION SCRIPTS Assuming mysql is already installed Enter the mysql user name for accessing the master database.[root]: Assuming default value as root Enter the host name on which the master database is running. [localhost]: Assuming default value as localhost Enter the mysql password for user root at localhost. [NULL]: Assuming default value as NULL -- Creating cinema_db.conf -- Changing permissions of all the files in /opt/3com/components/presconf.2.2.2.190 to 755.
Dual Server Initial Installation *** Checking table dialplan *** Creating table dialplan *** Checking table radius_config *** Creating table radius_config *** Checking table display *** Creating table display *** Checking table dbservers *** Creating table dbservers *** Checking table domain *** Creating table domain *** Checking table sipd_log *** Creating table sipd_log *** Checking table conferences *** Creating table conferences *** Checking table eventattendee *** Creating table eventattendee *** Chec
CHAPTER 2: INSTALLATION SCRIPTS *** Checking table vote *** Creating table vote *** Checking table presence_conf *** Creating table presence_conf *** Checking table eventresource *** Creating table eventresource *** Checking table speed_dial *** Creating table speed_dial *** Checking table vcxdb_conf *** Creating table vcxdb_conf *** Checking table RoomACL *** Creating table RoomACL *** Checking table Cards *** Creating table Cards *** Checking table groupmember *** Creating table groupmember *** Check
Dual Server Initial Installation 51 *** Checking table Credentials *** Creating table Credentials *** Checking table mail_account *** Creating table mail_account *** Checking table eventgroup *** Creating table eventgroup *** Checking table eventgroup_notify *** Creating table eventgroup_notify *** Checking table gateway_map *** Creating table gateway_map *** Checking table confusers *** Creating table confusers *** Checking table thirdparty *** Creating table thirdparty *** Checking table election *** Cr
CHAPTER 2: INSTALLATION SCRIPTS OK now testing if we can connect to the 10.20.30.41 vcx updating the configuration database entries 3Com IP Conferencing Module applications will be automatically restarted system reboots when -- Installing SIP Conferencing servers ... -- Changing permissions of all the files in /opt/3com/components/presconf.2.5.21. restarting httpd... Creating a directory client_config to hold the soft client autoconfiguration files...
Dual Server Initial Installation 53 Select “Y” to complete the installation and start the services. Starting VCX Services: Starting vcx/mysql: [ OK ] Starting vcx/db_watchdog: Starting Darabase Watchdog: Missing database configuration file; cannot continue. [FAILED] Starting vcx/sippeng: [ OK ] Starting vcx/vcxdb: [ OK ] Started VCX Services: 3 started, 1 failed to start All services will start except DB_watchdog.
CHAPTER 2: INSTALLATION SCRIPTS Start of Network Configuration Configure networking now? [yes] : Press the Enter or Return key to accept yes as the suggested answer. --------- Configuring Dynamic Host Configuration Protocol (DHCP) ---------VCX servers can use DHCP for automated configuration, but this requires that the DHCP server is configured to provide the proper options. Unless you know that your environment is set up in this way, you should say 'no' here and configure static network parameters.
Dual Server Initial Installation -------------------------- Configuring Time Zone -------------------------Please select a geographic location from the following list: 1. Africa 2. Americas 3. Antarctica 4. Arctic Ocean 5. Asia 6. Atlantic Ocean 7. Australia 8. Europe 9. Indian Ocean 10. Pacific Ocean Enter continent [2] : Press the Enter or Return key to accept 2 as the suggested answer. Please select a country from the following list: 1. Antigua & Barbuda 18. Ecuador 2. Anguilla 19. Grenada 3.
CHAPTER 2: INSTALLATION SCRIPTS 7. Central Time - Michigan - Wisconsin border 8. Central Time - North Dakota - Oliver County 9. Eastern Standard Time - Indiana - Crawford County 10. Eastern Standard Time - Indiana - Starke County 11. Eastern Standard Time - Indiana - Switzerland County 12. Eastern Standard Time - Indiana - most locations 13. Eastern Time 14. Eastern Time - Kentucky - Louisville area 15. Eastern Time - Kentucky - Wayne County 16. Eastern Time - Michigan - most locations 17. Hawaii 18.
Dual Server Initial Installation 57 End of Network Configuration The network configuration is complete. If necessary, you can re-run this portion of the script by entering vcx-config-network -wizard. Start of System Configuration After successful completion of the network configuration, the script will prompt you to select a set of services. ----------------------- Select System Configuration ----------------------Individual systems may provide various services in a VCX installation.
CHAPTER 2: INSTALLATION SCRIPTS 'Data server for presence and conferencing' server? here you can choose an alternative configuration. If you answer 'no' Confirm selection? [no] : y Selection confirmed. *** *** *** *** Assembling VCX.2.9.21 using 'VSBOM.xml' *** Processing components *** Executing assembly commands *** Assembly complete *** The VCX assembly has been created.
Dual Server Initial Installation 59 Start of E-mail (sSMTP) Configuration After successful completion of the system configuration, the script will prompt you to set up the e-mail notification utility. The utility sends e-mails when conferences are created and modified, and when users attempt to add contacts to their buddy lists. E-mail notification works once users have added their e-mail addresses to the 3Com IP Conferencing Module.
CHAPTER 2: INSTALLATION SCRIPTS Hostname of your box [slave.yourcompany.com]: Enter the host name of your computer handling outgoing mail. (4) rewriteDomain Please enter the mail name of your system. sSMTP uses this value to add a domain to unqualified e-mail addresses(addresses without an @-sign). You probably want to use the domain from your own e-mail address.You probably want to set up your MUA to handle unqualified addresses itself, in which case sSMTP will never have to use this.
Dual Server Initial Installation 61 Start of Database Configuration After successful completion of the e-mail configuration, the script will prompt you to select a database configuration. There are different ways to install and access the database. 1 Local Master: this server will have the master database. 2 Local Slave: this server will have a slave database. 3 Remote database: database is on another server.
CHAPTER 2: INSTALLATION SCRIPTS Host Identifier (hostid) of this machine is: 75896dc20fa90922ddbb2b81 Please send an email to vcxconf@3com.com to receive an activation key to activate this product. Please enter the software activation keys one by one; end with an empty line: Send the host ID to 3Com, which will use it to generate your activation keys. Once 3Com has returned the activation keys to you, you can paste them into the install session when prompted.
Dual Server Initial Installation 63 REMOTE is at master.yourcompany.com Enter the password for root@master.yourcompany.com: pvadmin Enter the password for the master (primary) server. # master.yourcompany.com SSH-1.99-OpenSSH_3.6.1p2 # master.yourcompany.com SSH-1.99-OpenSSH_3.6.1p2 Warning: Permanently added the RSA host key for IP address '10.1.0.249' to the list of known hosts. root@master.yourcompany.com's password: OK now testing if we can connect to master.yourcompany.
CHAPTER 2: INSTALLATION SCRIPTS -- Changing permissions of all the files in /opt/3com/components/presconf.2.5.21 to 755. -- Trying to load fbsql.so... -- fbsql is loaded... -- Opening the database sql://root:NULL@master.yourcompany.com/mysql -- Changing permissions for presconf1.yourcompany.com -- Changing permissions for master.yourcompany.com -- Changing permissions for presconf1.yourcompany.com -- Changing permissions for presconf1.yourcompany.
Multiple Server Initial Installation 65 Would you like to start the 3Com IP Conferencing Module services now? (N/Y) [N]: y Select “Y” to complete the installation and start the services. Starting VCX Services: Starting vcx/mysql: Starting vcx/db_watchdog: Started VCX Services: 2 started. [ [ OK OK ] ] All services will start.
CHAPTER 2: INSTALLATION SCRIPTS ------------------------------------------------------------------------------------ Welcome to the VCX Linux Network Configuration Wizard -----------------------------------------------------------------------------------This wizard sets up networking and related services. Start of Network Configuration Configure networking now? [yes] : Press the Enter or Return key to accept yes as the suggested answer.
Multiple Server Initial Installation When done, enter 0.0.0.0 to stop. Primary NTP Server [192.168.1.253] : 10.35.10.51 Secondary NTP Server [192.168.1.252] : 10.36.10.51 Additional NTP Server : 10.1.0.3 -------------------------- Configuring Time Zone -------------------------Please select a geographic location from the following list: 1. Africa 2. Americas 3. Antarctica 4. Arctic Ocean 5. Asia 6. Atlantic Ocean 7. Australia 8. Europe 9. Indian Ocean 10.
CHAPTER 2: INSTALLATION SCRIPTS 2. Alaska Time - Alaska panhandle 3. Alaska Time - Alaska panhandle neck 4. Alaska Time - west Alaska 5. Aleutian Islands 6. Central Time 7. Central Time - Michigan - Wisconsin border 8. Central Time - North Dakota - Oliver County 9. Eastern Standard Time - Indiana - Crawford County 10. Eastern Standard Time - Indiana - Starke County 11. Eastern Standard Time - Indiana - Switzerland County 12. Eastern Standard Time - Indiana - most locations 13. Eastern Time 14.
Multiple Server Initial Installation 69 ----------------------------------------------------------------------------------------------------------------------------------------------------Please wait while the wizard completes. Saving configuration...Done. End of Network Configuration The network configuration is complete. If necessary, you can re-run this portion of the script by entering vcx-config-network -wizard.
CHAPTER 2: INSTALLATION SCRIPTS appropriate license and installed the corresponding license activation key on this system. *** WARNING *** Once you confirm your selection, you cannot change it. Are you absolutely certain that you wish to configure this system as an 'Presence server (with database)' server? If you answer 'no' here you can choose an alternative configuration. Confirm selection? [no] : y Confirm your selection by typing “y.” Selection confirmed. *** *** *** *** Assembling VCX.2.9.
Multiple Server Initial Installation 71 Successfully removed extra packages. End of System Configuration The system configuration is complete. If necessary, you can re-run this portion of the script by entering vcx-setconfigtype. Start of E-mail (sSMTP) Configuration After successful completion of the system configuration, the script will prompt you to set up the e-mail notification utility.
CHAPTER 2: INSTALLATION SCRIPTS Specify how sSMTP handles the From: line of outgoing mail. (3) hostname sSMTP uses the hostname of your computer to identify itself to the mailhub, and in the Received: headers of the outgoing mail. This has relatively little effect on how the mail is handled. Use the fully-qualified domain name (FQDN) of your computer(foo.bar.baz). If it doesn't have a FQDN, use some name for your box. Hostname of your box [master.yourcompany.
Multiple Server Initial Installation 73 End of E-mail (sSMTP) Configuration The e-mail configuration is complete. If necessary, you can re-run this portion of the script by entering usr/sbin/smtp-configure. Start of Database Configuration After successful completion of the e-mail configuration, the script will prompt you to select a database configuration. There are different ways to install and access the database. 1 Local Master: this server will have the master database.
CHAPTER 2: INSTALLATION SCRIPTS If the system is configured to send e-mail notification of conference events to users, the e-mails will appear to be sent from the administrator (sipadmin@yourcompany.com). Note that some mail agents may require this to be a valid e-mail address. Host Identifier (hostid) of this machine is: 75896dc20fa90922ddbb2b81 Please send an email to vcxconf@3com.com to receive an activation key to activate this product.
Multiple Server Initial Installation 75 -- Changing permissions of all the files in /opt/3com/components/presconf.2.2.2.190 to 755. -- Trying to load fbsql.so... -- fbsql is loaded... -- Opening the database sql://root:NULL@localhost/mysql -- Changing permissions for master.yourcompany.com -- Changing permissions for localhost -- Changing permissions for master.yourcompany.com -- Changing permissions for master.yourcompany.com -- Flushing privleges -- Calling createdb Create the database.
CHAPTER 2: INSTALLATION SCRIPTS *** Checking table conferences *** Creating table conferences *** Checking table eventattendee *** Creating table eventattendee *** Checking table user_config *** Creating table user_config *** Checking table cinema *** Creating table cinema *** Checking table address *** Creating table address *** Checking table confinstances *** Creating table confinstances *** Checking table conferencing_config *** Creating table conferencing_config *** Checking table registrar_presen
Multiple Server Initial Installation *** Checking table Cards *** Creating table Cards *** Checking table groupmember *** Creating table groupmember *** Checking table subscription *** Creating table subscription *** Checking table messageboard *** Creating table messageboard *** Checking table confsrv_config *** Creating table confsrv_config *** Checking table ua_capabilities *** Creating table ua_capabilities *** Checking table trusted_host *** Creating table trusted_host *** Checking table vmail *** Cre
CHAPTER 2: INSTALLATION SCRIPTS *** Checking table thirdparty *** Creating table thirdparty *** Checking table election *** Creating table election *** Checking table persongroup *** Creating table persongroup *** Checking table sipd_config *** Creating table sipd_config *** Checking table ssl_config *** Creating table ssl_config -- createdb is complete -- *IMPORTANT*: Adding administrator root@master.yourcompany.com with password root -- Database is successfully initialized.
Multiple Server Initial Installation 79 -- Changing permissions of all the files in /opt/3com/components/presconf.2.5.21. restarting httpd... Creating a directory client_config to hold the soft client autoconfiguration files... Directory created successfully at /opt/3com/components/presconf.2.5.21/client_config Any files that you store in this directory are accessible via http://master.yourcompany.com/3c3/.
CHAPTER 2: INSTALLATION SCRIPTS All services will start except DB_watchdog. It starts after the secondary server is installed and the database replication process is initiated. End of IP Conferencing Module Configuration Sample vcx-setup Script (Secondary server) This script programs the secondary server in a multiple server configuration. The slave database is installed and initially hosted on the secondary server.
Multiple Server Initial Installation Use DHCP on eth0 to configure network parameters? [no] : ---------- Configuring Hostname ---------Enter system hostname [localhost] : slave.yourcompany.com ---------- Configuring IP Interface 'eth0' ---------Enter IP Address [192.168.1.100 ] : 10.20.30.61 Enter Network Subnet Mask [255.255.255.0 ] : 255.255.255.0 Enter Default Gateway Address [10.20.30.254 ] : 10.20.30.
CHAPTER 2: INSTALLATION SCRIPTS 8. Europe 9. Indian Ocean 10. Pacific Ocean Enter continent [2] : Press the Enter or Return key to accept 2 as the suggested answer. Please select a country from the following list: 1. Antigua & Barbuda 18. Ecuador 2. Anguilla 19. Grenada 3. Netherlands Antilles 20. French Guiana 4. Argentina 21. Greenland 5. Aruba 22. Guadeloupe 6. Barbados 23. Guatemala 7. Bolivia 24. Guyana 8. Brazil 25. Honduras 9. Bahamas 26. Haiti 10. Belize 27. Jamaica 11. Canada 28.
Multiple Server Initial Installation 83 18. Mountain Standard Time - Arizona 19. Mountain Time 20. Mountain Time - Navajo 21. Mountain Time - south Idaho & east Oregon 22. Pacific Time Enter zone [13] : Selected Time Zone: America/New_York -------------------------- CONFIGURATION SUMMARY -------------------------DHCP state: disabled Hostname: slave.yourcompany.com IP Interfaces: Device eth0 eth1 IP Address Network Mask 10.20.30.60 255.255.0.0 (interface is disabled) Default Gateway 10.20.30.
CHAPTER 2: INSTALLATION SCRIPTS ----------------------- Select System Configuration ----------------------Individual systems may provide various services in a VCX installation.You must select the appropriate set of services which this system is to provide. Be certain that the selection corresponds to the functionality you have purchased. Which services will this system provide? 1. 2. 3. 4. 5.
Multiple Server Initial Installation Performing early startup tasks: Starting VCX-Firewall: Starting httpd: [ [ OK OK 85 ] ] Removing unneeded application components from the system. This may take several minutes. Please wait while the operation completes. Determining which packages are not used by any VCX version: oem.7.0.1 presconf.2.5.21 presconf-conf.2.5.21 presconf-presence.2.5.21 presconf-vcxdb.2.5.21 presconf-web.2.5.21 vcx-firewall.1.5.6 mysql.3.23.
CHAPTER 2: INSTALLATION SCRIPTS This is the computer responsible for handling your outgoing mail. It could be the SMTP server of your ISP, or a departmental mailhub. Use the fully-qualified domain name (foo.bar.baz) of the mailhub; if it uses an unusual SMTP port number, use the colon syntax foo.bar.baz:2525 Otherwise sSMTP will use the standard SMTP port number (25). (Note that sSMTP can support a user-dependent mailhub with the'reverse aliases' feature, for which see the man page.
Multiple Server Initial Installation 87 Enter the mail name of your system. (5) root Last and least: if and it corresponds then the e-mail is should probably go sSMTP finds an unqualified e-mail address among the recipients, to a username on your local machine with a userid less than 1000, sent to this value instead. The idea is that mail sent to 'root' to 'postmaster' instead. If you set up your MUA to do its own handling of unqualified addresses, this is irrelevant.
CHAPTER 2: INSTALLATION SCRIPTS End of Database Configuration The database configuration is complete. If necessary, you can re-run this portion of the script by entering presconf-setup. Start of IP Conferencing Module Configuration After successful completion of the database configuration, the script will prompt you to select an initial configuration. Enter the fully qualified hostname for this installation. [slave.yourcompany.com]: Assuming default value as slave.yourcompany.
Multiple Server Initial Installation 89 Enter key: sippeng:master.yourcompany.com:+:-:-:-:5ea71ce717ea55627152a1db82d54592 key ok for sippeng Enter key: License file name: /opt/3com/components/presconf.2.5.21/presconf_licenses Enter the mysql user name for accessing the master database.[root]: Assuming default value as root Enter the host name on which the master database is running. []: master.yourcompany.com Enter the host name of the master (primary) server.
CHAPTER 2: INSTALLATION SCRIPTS Creating cinema_db2.conf on master database server On master database server copy cinema_db.conf to cinema_db1.conf In my.cnf on master, ensure server-id exists and binary logging is enabled. MySQL my.cnf files updated. Copying modified my.cnf file back to master database server Grant access to master database from this server Opening slave database. On slave run mysql CHANGE MASTER and have it point to the master db.
Multiple Server Initial Installation 91 restarting httpd... Creating a directory client_config to hold the soft client autoconfiguration files... Directory created successfully at /opt/3com/components/presconf.2.5.21/client_config Any files that you store in this directory are accessible via http://presconf1.yourcompany.com/3c3/.
CHAPTER 2: INSTALLATION SCRIPTS End of IP Conferencing Module Configuration Sample vcx-setup Script (Conference server) This section contains a sample of the vcx-setup script for the conference servers in a multiple server configuration that has between four and twelve servers. In a multiple server configuration, up to ten servers can host conferences. Two others (the primary and secondary servers) must be dedicated to hosting the redundant database.
Multiple Server Initial Installation ---------- Configuring IP Interface 'eth0' ---------Enter IP Address [192.168.1.100 ] : 10.20.30.62 Enter Network Subnet Mask [255.255.255.0 ] : 255.255.255.0 Enter Default Gateway Address [10.20.30.254 ] : 10.20.30.254 ---------- Configuring IP Interface 'eth1' ---------Interface State : disabled Note that ‘eth1’ is not used for the 3Com IP Conferencing Module. ---------- Configuring DNS Servers ---------Enter DNS servers one at a time. When done, enter 0.0.0.
CHAPTER 2: INSTALLATION SCRIPTS Press the Enter or Return key to accept 2 as the suggested answer. Please select a country from the following list: 1. Antigua & Barbuda 18. Ecuador 2. Anguilla 19. Grenada 3. Netherlands Antilles 20. French Guiana 4. Argentina 21. Greenland 5. Aruba 22. Guadeloupe 6. Barbados 23. Guatemala 7. Bolivia 24. Guyana 8. Brazil 25. Honduras 9. Bahamas 26. Haiti 10. Belize 27. Jamaica 11. Canada 28. St Kitts & Nevis 12. Chile 29. Cayman Islands 13. Colombia 30. St Lucia 14.
Multiple Server Initial Installation 22. Pacific Time Enter zone [13] : Selected Time Zone: 95 America/New_York -------------------------- CONFIGURATION SUMMARY -------------------------DHCP state: disabled Hostname: slave.yourcompany.com IP Interfaces: Device eth0 eth1 IP Address Network Mask 10.20.30.60 255.255.0.0 (interface is disabled) Default Gateway 10.20.30.254 DNS Servers: 10.25.10.31 10.26.10.31 Search Domains:yourcompany.com NTP Servers: 10.35.10.51 10.36.10.51 10.1.0.
CHAPTER 2: INSTALLATION SCRIPTS provide. Be certain that the selection corresponds to the functionality you have purchased. Which services will this system provide? 1. 2. 3. 4. 5. Presence and Conference - all in one Conferencing server Conferencing and database server Data server for presence and conferencing Presence server (with database) Enter your choice (1-5) : 2 Select “2” to install the following components: - conference server - conference attendant server.
Multiple Server Initial Installation 97 Removing unneeded application components from the system. This may take several minutes. Please wait while the operation completes. Determining which packages are not used by any VCX version: callprocessor.7.0.13 devapp.7.0.13.14 devboot.5_0_0_C devdnldsvr.07.00.05.06 oem.7.0.1 presconf.2.5.21 presconf-conf.2.5.21 presconf-presence.2.5.21 presconf-vcxdb.2.5.21 presconf-web.2.5.21 vcx-firewall.1.5.6 ACE.5.3.6 mysql.3.23.58 oracle.9.2.0.4 STLport.4.6.1 xerces.
CHAPTER 2: INSTALLATION SCRIPTS once users have added their e-mail addresses to the 3Com IP Conferencing Module. Configuration for sSMTP (1) mailhub This is the computer responsible for handling your outgoing mail. It could be the SMTP server of your ISP, or a departmental mailhub. Use the fully-qualified domain name (foo.bar.baz) of the mailhub; if it uses an unusual SMTP port number, use the colon syntax foo.bar.baz:2525 Otherwise sSMTP will use the standard SMTP port number (25).
Multiple Server Initial Installation 99 You probably want to use the domain from your own e-mail address.You probably want to set up your MUA to handle unqualified addresses itself, in which case sSMTP will never have to use this. Mail name [slave.yourcompany.com]:yourcompany.com Enter the mail name of your system.
CHAPTER 2: INSTALLATION SCRIPTS 3 Remote database: database is on another server. Please choose one of the above options: 3 Select “3” to specify that this server will not host a database (all servers except the primary and secondary servers in a distributed system). Available applications: End of Database Configuration The database configuration is complete. If necessary, you can re-run this portion of the script by entering presconf-setup.
Multiple Server Initial Installation 101 Send the host ID to 3Com, which will use it to generate your activation keys. Once 3Com has returned the activation keys to you, you can paste them into the install session when prompted. The activation keys are validated as they are entered. If validation is successful, the keys will be stored in a license file and the installation session will continue. If validation is unsuccessful, the installation session will be aborted. Enter key: sipconf:conf.yourcompany.
CHAPTER 2: INSTALLATION SCRIPTS To allow access to the conference server from the slave (secondary) server: 1. Open a command window on the the slave (secondary) server 2. Run remote_access.sh 3. When prompted, enter the password for the conference server (default is pvadmin) As a final step, return to the conference server and enter “Y” at the prompt. The SIP conferencing server will be running at conf.yourcompany.
Multiple Server Initial Installation ------------ 103 Trying to load fbsql.so... fbsql is loaded... Opening the database sql://root:NULL@perfconf.yourcompany.com/mysql Changing permissions for conf.yourcompany.com Changing permissions for conf.yourcompany.com Changing permissions for conf.yourcompany.com Changing permissions for conf.yourcompany.com Changing permissions for conf.yourcompany.com Flushing privleges Opening the database sql://root:NULL@perfconf.yourcompany.
CHAPTER 2: INSTALLATION SCRIPTS * Output, from this install session, was saved to: * install_log.Jan_12_2006 **************************************************** Would you like to start the 3Com IP Conferencing Module services now? (N/Y) [N]: y Starting VCX Services: Starting vcx/db_watchdog: [ OK ] Starting vcx/confbridge: [ OK ] Starting vcx/sipconf: [ OK ] Started VCX Services: 3 started. -bash-2.05b# All services will start.
Post Installation Configuration 105 To create a route for conferences: 1 Using a browser, log in to the VCX system as admin (default password is besgroup). 2 Set up a Pattern. Pattern Name : 74* Pattern Value : 74* 3 Create an Endpoint for the route. Type : Terminal Active : Active Name : Confser Description : Confser IP Address : 10.20.30.60 IP Port : 5060 4 Create a route. Name : Confser Code Contact : use default Sort Policy : use default 5 Assign an endpoint to the route created in step 3.
CHAPTER 2: INSTALLATION SCRIPTS In this example, the Conference Attendant can be accessed at extension 8074. To set up the route for the Conference Attendant: 1 Using a browser, log in to the VCX system as admin (default password is besgroup). 2 Set up a Pattern. Pattern Name : 8074 Pattern Value : 8074 3 Create an Endpoint for the route. Type : Terminal Active : Active Name : Confser Description : Confatt IP Address : 10.20.30.
Post Installation Configuration 107 To add the Presence and Conference Server(s) to the VCX system as a trusted host: 1 Log in to the VCX as root. 2 At the prompt, enter: cd /opt/3com/VCX/callprocessor/remoteCli/bin/ ./remoteCli -callp 3 To check a list of the current trusted hosts, enter: config cct Output similar to the following will appear: To add/delete rows for dynamic tables, set the RowStatus field along with the key.
CHAPTER 2: INSTALLATION SCRIPTS 1 2 3 4 5 6 (ACTIVE) (NOT_IN_SERVICE) (NOT_READY) (CREATE_AND_GO) (CREATE_AND_WAIT) (DESTROY) cct -Index 2 3 5 6 7 8 9 -RowStatus 1 1 1 1 1 1 1 -TrustedAddress 10.1.0.157 10.1.1.8 10.1.0.3 10.1.4.1 10.1.1.240 10.1.0.239 10.1.1.1 -Netmask 255.255.255.255 255.255.255.255 255.255.255.255 255.255.255.255 255.255.255.255 255.255.255.255 255.255.255.
Upgrade Installation Upgrade Installation 109 Software upgrades are completed by running two scripts: install-upgrade and vcx-switchversion. The install-upgrade script upgrades the VCX Linux operating system to the latest version (if necessary) and installs the software packages. The vcx-switchversion script provisions the system with the software packages. It is possible to upgrade from Apps 2.0 to Apps 3.0 provided that the server is designated as either an all-in-one or primary server.
CHAPTER 2: INSTALLATION SCRIPTS -bash-2.05b# ./install-upgrade Enter ./install-upgrade at the command prompt. Start of install-upgrade Script ---------------------------------------------------------------------------------------------------- VCX Upgrade Installer ---------------------------------------------------------------------------------------------------------------------------- Pre-Installation Checks ------------------------Checking that required files are present...
Upgrade Installation Setting maximal mount count to -1 Setting interval between check 15552000 seconds Updating fstab files. Configuring GRUB boot loader...Done. Transferring configuration data. Checking kernel configuration: ...Selecting standard kernel Done. Copying configuration files: hosts passwd group resolv.conf ntp.conf modules.conf sysconfig/network sysconfig/hwconf sysconfig/network-scripts/ifcfg-eth0 sysconfig/network-scripts/ifcfg-eth1 .vcx-config-network ssmtp/revaliases ssmtp/ssmtp.
CHAPTER 2: INSTALLATION SCRIPTS Updating /usr/sbin/vcx-createcfg: Done. Configuration transfer completed successfully. -------------------------- Package Installation --------------------------Installing 7 packages... vcx-firewall-1.5.5-1.noarch.rpm presconf-2.5.13-1.i386.rpm presconf-conf-2.5.13-1.i386.rpm presconf-presence-2.5.13-1.i386.rpm presconf-vcxdb-2.5.13-1.i386.rpm presconf-web-2.5.13-1.i386.rpm oem-a-7.0.1-2.i386.rpm : : : : : : : OK OK OK OK OK OK OK 7 packages installed.
Managing the Activation Keys 113 -bash-2.05b# vcx-switchversion 2.9.3 Enter vcx-switchversion at the command prompt. For , enter the VCX version number that appeared at the end of the install-upgrade script. Start of vcx-switchversion Script -bash-2.05b# vcx-switchversion 2.9.13 Checking if VCX can switch to VCX.2.9.13 ls: /opt/3com/VCX.2.9.13/scripts/upgrade/C??*: No such file or directory Checking os versions: YES Switching VCX to VCX.2.9.13: ...setting up ...
CHAPTER 2: INSTALLATION SCRIPTS 3 From quick links, select Licensing Information. The License Information screen appears, listing the system’s activation keys and host ID. Figure 4 License Information 4 To delete an activation key, press . 5 To add an activation key: a Send the host ID (located at the bottom of the screen) to 3Com. b When 3Com returns the new activation key, paste it into the license string box and press Add.
3 Register Your Product OBTAINING SUPPORT FOR YOUR PRODUCT Warranty and other service benefits start from the date of purchase, so it is important to register your product quickly to ensure you get full use of the warranty and other service benefits available to you. Warranty and other service benefits are enabled through product registration. Register your product at http://eSupport.3com.com/. 3Com eSupport services are based on accounts that you create or have authorization to access.
APPENDIX 3: OBTAINING SUPPORT FOR YOUR PRODUCT Troubleshoot Online You will find support tools posted on the 3Com web site at http://www.3com.com/ 3Com Knowledgebase helps you troubleshoot 3Com products. This query-based interactive tool is located at http://knowledgebase.3com.com and contains thousands of technical solutions written by 3Com support engineers.
Contact Us 117 To send a product directly to 3Com for repair, you must first obtain a return authorization number (RMA). Products sent to 3Com, without authorization numbers clearly marked on the outside of the package, will be returned to the sender unopened, at the sender’s expense. If your product is registered and under warranty, you can obtain an RMA number online at http://eSupport.3com.com/. First time users will need to apply for a user name and password.
APPENDIX 3: OBTAINING SUPPORT FOR YOUR PRODUCT Country Telephone Number Country Telephone Number Austria Belgium Denmark Finland France Germany Hungary Ireland Israel Italy 01 7956 7124 070 700 770 7010 7289 01080 2783 0825 809 622 01805 404 747 06800 12813 1407 3387 1800 945 3794 199 161346 Luxembourg Netherlands Norway Poland Portugal South Africa Spain Sweden Switzerland U.K.
INDEX A I activation key, managing 113 initial installation dual server installation 38 guidelines 19 IP conferencing module overview 19 multiple server 65 overview 18 post installation configuration 104 services database configuration 19 e-mail configuration 19 network configuration 18 system configuration 18 single server installation 22 installing, server components 17 install-upgrade script, overview 109 interactive voice response system 18 IP Conferencing Module configuration 19 C conference atten
INDEX P post installation configuration configure trusted hosts 106 overview 104 set up conference attendant routes 105 set up conference routes 104 test e-mail setup 108 preparing for installation 13 presence server 18 presence server database 18 S scripts install-upgrade 109 vcx-switchversion 112 single server installation database configuration 30 e-mail configuration 28 IP Conferencing Module configuration 30 network configuration 23 setup script (all-in-one) 22 system configuration 26 site infor
