3Com 900-0410-01 manual

http://www.3com.com/ Part Number 900-0410-01 Published Octo ber 2006 IP Confer encing Module Installation Guide 3Com ® Convergence Applications Suite VCX System Release 7.2[...]

3Com Corporati on 350 Campus Drive Marlbor ough, MA 01752-3064 Copyright © 2006, 3Com Corporation. All r ights reserved. No part of this documentation may be reproduced in an y form or by any means or used to make any derivative work ( such as translation, transformation , or adaptation) without written permission fr om 3Com Corporation. 3Com Corp[...]

C ONTENTS A BOUT T HIS G UIDE Conventions 5 Notices 5 T ext 6 Related Docum entation 6 Comments 7 1 P RE -I NSTALLATION Configuration Options 9 Option 1: Single Server 9 Option 2: Dual S erver 10 Option 3: Multiple Servers (Fou r to T we lve) 11 Post-installation Setup 12 Gathering Site Information 13 Using DNS 13 Single Server 14 Dual Servers 14 M[...]

Sample vcx-setup Script (Secondary server) 80 Sample vcx-setup Script (Conference server) 92 Post Installation Configuration 104 Set up Confer ence Server Routes 104 Set up Confer ence Attendant Routes 105 T rusted Host Configur ation 106 T est E-Mail Notification Setup 108 Upgrade Installation 109 Distributed Implementation Upgrade Guidelines 109 [...]

A BOUT T HIS G UIDE This section contains an overview of this guide, lists guide conventions, related documentation, and product compatibility . This guide describes how to answer th e 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 questi[...]

6 A BOUT T HIS G UIDE Te x t Ta b l e 2 lists text conventions. Related Documentation These 3Com documents contain ad ditional information about the products in this r elease that are a part of or support the 3Com Convergence Applications Su ite. The following documen ts are a part of the VCX IP T elephony Module: n VCX Installation and Maintenance[...]

Comments 7 The following docu ments are a part of the IP Messaging Module: n IP Messaging Module Product Overview n IP Messaging Module Quick Referenc e Guide - 3Com Native Interface n IP Messaging Module User Guide - 3Co m Native Interface n IP Messaging Module Quick Referenc e Guide - T radition al Interface n IP Messaging Module User Guide - T r[...]

8 A BOUT T HIS G UIDE n Page number n Y our 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 regardi ng 3Com software to your authorized 3Com representative.[...]

1 P RE -I NSTALLATION This chapter provides pre-installation guidelines for the 3Com IP Conferencing Module, which is an optional component of the 3Com VCX ™ V7000 IP T elephony System. n Configuration Options n Gathering Site Information n Wo rksheet Configuration Options This section descr ibes sample hardware/software configurations that suppo[...]

10 C HAPTER 1: P RE -I NSTALLATION Figure 1 Network diagram - single server Option 2: Dual Server If you have two servers, configure th e 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. Configure the secondary server with [...]

Configuration Options 11 Figure 2 Network diagram - two servers Both servers in the conference pool use their eth0 interface to connect to the network. Option 3: Multiple Servers (Four to T welve) If you have between four and twelve servers, configur e the primary server as a “provisioning” server by installing the web console server , presence[...]

12 C HAPTER 1: P RE -I NSTALLATION Figure 3 Network diagram - multiple server s All servers in the pool use their eth0 interface to connect to the network. Upgrades Following the initial implementation, the system can be upgraded in order to incr ease system capacity or provide database r edundancy . Fo r example, adding a second server to a single[...]

Gathering Site Information 13 Once the route is set up, the VCX syst em will forwar d conference calls to the designated endpoin ts—conference servers that pr ovide a “routing” function by redirecting calls to ” hos ting” conference servers. A single conference server can pr ovide both routing and hosting functionality . Setting up a Rout[...]

14 C HAPTER 1: P RE -I NSTALLATION Single Server If your network co ntains a single server , you require the following: n Y ou must dedicate one IP address to the 3Com IP Confer encing Module. n Y ou must assign a host name to th e 3Com IP Conferencing Module. n Y ou must know the IP address of the network gateway . n Y ou must kn ow the IP address[...]

Worksheet 15 Worksheet T o make it easier to configur e your system, you may want to have the necessary information in front of you before you begin to install any server . Ta b l e 3 Network Configuration Parameters Configuration Parameter Value 3Com IP Conferencing Module IP address (eth 0) 3Com IP Conferencing Module host name Subnetwork mask Ga[...]

16 C HAPTER 1: P RE -I NSTALLATION Ta b l e 5 E-Mail Noti fication P arameters Configuration Parameter Value Mailhub (computer that handles mail) Hostname of your computer Mail name of your system System user e-mail address Ta b l e 6 Database Configuration Parameters Configuration Parameter Value Database: 1. Local Master: this serv er will have t[...]

2 I NSTALLATION S CRIPTS This chapter de scribes the initial configura tion of each 3Com IP Conferenc ing Module server in a VCX system. All softwar e components run on each ser ver . The installation scripts are run on co mmand. Each time a script p rompts you for a r espo nse, you can accept the default (preconfigured) value by pressing the Retur[...]

18 C HAPTER 2: I NSTALLATION S CRIPTS n Web Pr ovisioning Server — Allows for the creation of conferences and maintenance of the server . n Conference S erver — Allows SIP devices to join confere nces that support an y or all of audi o, video, and d esktop sharing communicat ion modes. n Conference Attendant — Allows users to join confer ence[...]

Initial Installation - Configu ration Guidelines 19 n Pr esence server (with database): Pr esence server , web serve r , VCX user database, and conference & presence database. E-Mail (sSMTP) Configuration — This portion of the script configures the Send-only Simple Mail T ransf er Protocol (sSMTP) that enables the system to send e-mail notifi[...]

20 C HAPTER 2: I NSTALLATION S CRIPTS Dual Server Configuration General installation steps: 1 On the primary server , run th e vcx-setup script: a When prompted to select the services the system will pr ovide, select 1 (presence and conference - all in one). b When prompted to select a database configuration, select 1 (Local Master). c When prompte[...]

Initial Installation - Configu ration Guidelines 21 All services will start except DB_watch dog. It starts a fter the secondar y serv er 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 pr ovide, select 4 (Data server for pres[...]

22 C HAPTER 2: I NSTALLATION S CRIPTS When configuring the network para meters on the VCX Linux server , make sure you specify the fully qualified domain name for your system, not just the ho stname. For example, use conf01.yo urcompany .com not conf01. Use a local connection to the ser ver to complete the initial software installation. The vcx-set[...]

Single Server Initial Installation 23 Enter vcx-se tup at the command prompt. --------------------------- ------------------------------------------------ ---------- Welcome to the V CX Linux Network Configuration Wizard ---------- --------------------------- ------------------------------------------------ This wizard sets up network ing and relat[...]

24 C HAPTER 2: I NSTALLATION S CRIPTS ---------- Configuring Netw ork Time Protocol ---------- Enter NTP servers one at a time. When done, enter 0.0.0.0 to stop. Primary NTP Server [192.1 68.1.253] : 10.35.10.51 Secondary NTP Server [192.1 68.1.252] : 10.36.10.51 Additional NTP Server : 10.1.0.3 -------------------------- Configuri ng Time Zone ---[...]

Single Server Initial Installation 25 Please select a time zone f rom the following list: 1. Alaska Time 2. Alaska Time - Alaska p anhandle 3. Alaska Time - Alaska p anhandle neck 4. Alaska Time - west Ala ska 5. Aleutian Islands 6. Central Time 7. Central Time - Michiga n - Wisconsin border 8. Central Time - North D akota - Oliver County 9. Easter[...]

26 C HAPTER 2: I NSTALLATION S CRIPTS Is all of the above informa tion correct? [yes] : --------------------------- ------------------------------------------------ --------------------------- ------------------------------------------------ Please wait while the wizar d completes. Saving configuration...Done . End of Network Configuration The netw[...]

Single Server Initial Installation 27 You have chosen to configur e this system to provide: Presence and Conference - all in one Note that in order for thes e services to work, you must have purchased an appropriate license and ins talled the corresponding license activation key on this system. *** WARNING *** Once you confirm your selection, you c[...]

28 C HAPTER 2: I NSTALLATION S CRIPTS vcx-firewall.1.5.5 : [keep; used in 2.9.3] mysql.3.23.58 : [keep; used in 2.9.3] No extra packages were foun d. End of System Configuration The system configuration is complete . If necessary , you can re-run this portion of the script by entering vcx-setco nfigtype. Start of E-mail (sSMTP) Configuration After [...]

Single Server Initial Installation 29 address for each user, in w hich case don't use FromLineOverride=YES. See the man page.) FromLineOverride? [YES]: Specify how sS MTP handles the Fr om: line of outgo ing mail. (3) hostname sSMTP uses the hostname of your computer to identify itself to the mailhub, and in the Received: headers of the outgoi[...]

30 C HAPTER 2: I NSTALLATION S CRIPTS Tcl is already installed Tcl version is 8.3 Please report any installa tion problem to "3Com Support" <support @3com.com> End of E-mail (sSMTP) Configuration The e-mail config uration is complete . If necessary , you can re-run this portion of the script by entering usr/sbin/smtp-configure. Star[...]

Single Server Initial Installation 31 Enter the administrator's e mail address. [sipadmin@yourcompany.com]: Assuming default value as s ipadmin@yourcompany.com Enter the administrator’ s e-mail address. The default is derived from the hostname de fined in the network config uration (above). If the system is configured to send e-mail notifica[...]

32 C HAPTER 2: I NSTALLATION S CRIPTS The license key sippeng:-:+:2006-11-11:2006 -11-11:-:dcdb0531a90ffbf027786aa0a4732a98 is valid MySQL is needed for your ap plication. mysql is found at /opt/3com /VCX/bin/mysql Assuming mysql is already i nstalled Enter the mysql user name f or accessing the master database.[root]: Assuming default value as r o[...]

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 permiss[...]

34 C HAPTER 2: I NSTALLATION S CRIPTS Creating table domain *** Checking table sipd_log *** Creating table sipd_log *** Checking table conferen ces *** Creating table conferences *** Checking table eventatt endee *** Creating table eventattende e *** Checking table user_con fig *** Creating table user_config *** Checking table cinema * ** Creating [...]

Single Server Initial Installation 35 Creating table Cards *** Checking table groupmem ber *** Creating table groupmember *** Checking table subscrip tion *** Creating table subscription *** Checking table messageb oard *** Creating table messageboard *** Checking table confsrv_ config *** Creating table confsrv_conf ig *** Checking table ua_capab [...]

36 C HAPTER 2: I NSTALLATION S CRIPTS Creating table election *** Checking table persongr oup *** Creating table persongroup *** Checking table sipd_con fig *** Creating table sipd_config *** Checking table ssl_conf ig *** Creating table ssl_config -- createdb is complete -- *IMPORTANT*: Adding admi nistrator root@yourcompany.com with password root[...]

Single Server Initial Installation 37 restarting httpd... Creating a directory client _config to hold the soft client autoconfiguration files... Directory created successfu lly at /opt/3com/components/pres conf.2.5.3/client_config Any files that you store in this directory are accessible via http://master.yourcompany .com/3c3/<CONFIGFILENAME>[...]

38 C HAPTER 2: I NSTALLATION S CRIPTS Stopping VCX-Firewall: [ OK ] Starting VCX-Firewall: [ OK ] Starting VCX Services: Starting vcx/mysql: [ OK ] Starting vcx/confbridge: [ OK ] Starting vcx/sipconf: [ O K ] Starting vcx/sippeng: [ O K ] Starting vcx/vcxdb: [ OK ] Started VCX Services: 5 sta rted. -bash-2.05b# End of IP Confer encing Module Confi[...]

Dual Server Initial Installation 39 The vcx-setup script displays the curr ent settings and then asks you if you want to accept or update them. Sample answers ar e provided in bold type along with explanations of those answers. Explanations are in italics. T o run the vcx-setup script: 1 Log in to the server as r oot . 2 Enter a password (default i[...]

40 C HAPTER 2: I NSTALLATION S CRIPTS Enter DNS servers one at a time. When done, enter 0.0.0.0 to stop. Primary DNS Server [192.1 68.1.1] : 10.25.10.31 Secondary DNS Server [192.1 68.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 cu rrent path unchanged, or spe[...]

Dual Server Initial Installation 41 10. Belize 27. Jamaica 44. United States 11. Canada 28. St Kitts & Nevis 45. Uruguay 12. Chile 29. Cayman Islands 46. St Vincent 13. Colombia 30. St Lucia 47. Venezuela 14. Costa Rica 31. Martinique 48. Virgin Islands (UK) 15. Cuba 32. Montserrat 49. Virgin Islands (US) 16. Dominica 33. Mexico 17. Dominican R[...]

42 C HAPTER 2: I NSTALLATION S CRIPTS 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 informa tion correct? [yes] : --------------------------- -------------[...]

Dual Server Initial Installation 43 Select “1” to install th e following components: - conference server - conference attendant server - presence server - web server - VCX user database - conference & presence databa se. You have chosen to configur e this system to provide: Presence and Conference - all in one Note that in order for thes e [...]

44 C HAPTER 2: I NSTALLATION S CRIPTS Removing unneeded applicati on components from the system. This may take several minut es. Please wait while the operation completes. Determining which packages are not used by any VCX version: oem.7.0.1 : [keep; used in 2.9.3] presconf.2.5.3 : [keep; used in 2.9.3] presconf-conf.2.5.3 : [keep; used in 2.9.3] p[...]

Dual Server Initial Installation 45 (2) FromLineOverride This specifies how sSMTP ha ndles 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 [...]

46 C HAPTER 2: I NSTALLATION S CRIPTS Enter the system us er e-mail address. Note: check with your e-mail admini strat or for the proper system user e-mail address. Wrote configuration file /e tc/ssmtp/ssmtp.conf Starting mysqld daemon with databases from /opt/3comdata/mysql Tcl is already installed Tcl version is 8.3 Please report any installa tio[...]

Dual Server Initial Installation 47 [host.yourcompany.com]: Assuming default value as m aster.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 domai n is root Enter the administrator's e mail address. [sipadmin@yourcompany[...]

48 C HAPTER 2: I NSTALLATION S CRIPTS Assuming mysql is already i nstalled Enter the mysql user name f or accessing the master database.[root]: Assuming default value as r oot Enter the host name on whic h the master database is running. [localhost]: Assuming default value as l ocalhost Enter the mysql password fo r user root at localhost. [NULL]: [...]

Dual Server Initial Installation 49 *** Checking table dialplan *** Creating table dialplan *** Checking table radius_c onfig *** Creating table radius_confi g *** Checking table display *** Creating table display *** Checking table dbserver s *** Creating table dbservers *** Checking table domain * ** Creating table domain *** Checking table sipd_[...]

50 C HAPTER 2: I NSTALLATION S CRIPTS *** Checking table vote *** Creating table vote *** Checking table presence _conf *** Creating table presence_con f *** Checking table eventres ource *** Creating table eventresourc e *** Checking table speed_di al *** Creating table speed_dial *** Checking table vcxdb_co nf *** Creating table vcxdb_conf *** Ch[...]

Dual Server Initial Installation 51 *** Checking table Credenti als *** Creating table Credentials *** Checking table mail_acc ount *** Creating table mail_account *** Checking table eventgro up *** Creating table eventgroup *** Checking table eventgro up_notify *** Creating table eventgroup_n otify *** Checking table gateway_ map *** Creating tabl[...]

52 C HAPTER 2: I NSTALLATION S CRIPTS OK now testing if we can conne ct to the 10.20.30.41 vcx updating the configuration database entries 3Com IP Conferencing Module applications will be automatically restarted when system reboots -- Installing SIP Conferenc ing servers ... -- Changing permissions of all the files in /opt/3com/components/presconf.[...]

Dual Server Initial Installation 53 Select “Y” to comple te the installation an d 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:[...]

54 C HAPTER 2: I NSTALLATION S CRIPTS Start of Network Configuration Configure networking now? [ yes] : Press the Enter or Return key to accept yes as the suggested answer . --------- Configuring Dynam ic Host Configuration Protocol (DHCP) ---------- VCX servers can use DHCP fo r automated configuration, but this requires that the DHCP server is co[...]

Dual Server Initial Installation 55 -------------------------- Configuri ng 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 [...]

56 C HAPTER 2: I NSTALLATION S CRIPTS 7. Central Time - Michiga n - Wisconsin border 8. Central Time - North D akota - 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[...]

Dual Server Initial Installation 57 End of Network Configuration The network configuratio n is complete. If necessary , you can re-run this portion of the script by entering vcx-config-network -wizar d. Start of System Configuration After successful completion of the ne twork configuration, the script will pr ompt you to sele ct a set of services .[...]

58 C HAPTER 2: I NSTALLATION S CRIPTS 'Data server for presence a nd conferencing' server? If you answer 'no' here you can choose an alte rnative configuration. Confirm selection? [no] : y Selection confirmed. *** Assembling VCX.2.9.21 u sing 'VSBOM.xml' *** *** Processing components * ** *** Executing assembly comm an[...]

Dual Server Initial Installation 59 Start of E-mail (sSMTP) Configuration After successful completion of the sy stem configuration, the script will prom pt you to set up the e-mail no tification utility . The utility sends e-mails when conferences are cr ea t ed and modified, and when users attempt to add contacts to their bud dy lists. E-mail noti[...]

60 C HAPTER 2: I NSTALLATION S CRIPTS Hostname of your box [slave .yourcompany.com]: Enter the host name of your computer han dling outgoing mail. (4) rewriteDomain Please enter the mail name of your system. sSMTP uses this value to ad d a domain to unqualified e-mail addresses(addresses without an @-sign). You probably want to use th e domain from[...]

Dual Server Initial Installation 61 Start of Database Configuration After successful completion of the e-mail configuration, the script will pr ompt you to sele ct a database conf iguration. 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 [...]

62 C HAPTER 2: I NSTALLATION S CRIPTS Host Identifier (hostid) of this machine is: 75896dc20fa90922ddbb2b81 Please send an email to vcx conf@3com.com to receive an activation key to activate this product. Please enter the software a ctivation keys one by one; end with an empty line: Send the host ID to 3Com, which will us e it to generate your acti[...]

Dual Server Initial Installation 63 REMOTE is at master.yourcom pany.com Enter the password for root @master.yourcompany.com: pvadmin Enter the password for the master (p rimary) ser ver . # master.yourcompany.com SS H-1.99-OpenSSH_3.6.1p2 # master.yourcompany.com SS H-1.99-OpenSSH_3.6.1p2 Warning: Permanently added the RSA host key for IP address [...]

64 C HAPTER 2: I NSTALLATION S CRIPTS -- Changing permissions of al l 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.c om/mysql -- Changing permissions for presconf1.yourcompany.com -- Changing permissions for master.yourcompan[...]

Multiple Server Initial Installation 65 Would you like to start the 3Com IP Conferencing Module services now? (N/Y) [N]: y Select “Y” to comple te the installation an d start the services. Starting VCX Services: Starting vcx/mysql: [ OK ] Starting vcx/db_watchdog: [ OK ] Started VCX Services: 2 sta rted. All services will start. End of IP Confe[...]

66 C HAPTER 2: I NSTALLATION S CRIPTS --------------------------- ------------------------------------------------ ---------- Welcome to the V CX Linux Network Configuration Wizard ---------- --------------------------- ------------------------------------------------ This wizard sets up network ing and related services. Start of Network Configurat[...]

Multiple Server Initial Installation 67 When done, enter 0.0.0.0 to stop. Primary NTP Server [192.1 68.1.253] : 10.35.10.51 Secondary NTP Server [192.1 68.1.252] : 10.36.10.51 Additional NTP Server : 10.1.0.3 -------------------------- Configuri ng Time Zone -------------------------- Please select a geographic location from the following list: 1. [...]

68 C HAPTER 2: I NSTALLATION S CRIPTS 2. Alaska Time - Alaska p anhandle 3. Alaska Time - Alaska p anhandle neck 4. Alaska Time - west Ala ska 5. Aleutian Islands 6. Central Time 7. Central Time - Michiga n - Wisconsin border 8. Central Time - North D akota - Oliver County 9. Eastern Standard Time - Indiana - Crawford County 10. Eastern Standard Ti[...]

Multiple Server Initial Installation 69 --------------------------- ------------------------------------------------ --------------------------- ------------------------------------------------ Please wait while the wizar d completes. Saving configuration...Done . End of Network Configuration The network configuratio n is complete. If necessary , y[...]

70 C HAPTER 2: I NSTALLATION S CRIPTS appropriate license and ins talled 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 data base)' server? If you answer 'no&a[...]

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 sy stem configuration, the script will prom p[...]

72 C HAPTER 2: I NSTALLATION S CRIPTS Specify how sS MTP handles the Fr om: line of outgo ing 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 th e fully-qualified domain name (FQDN) of y[...]

Multiple Server Initial Installation 73 End of E-mail (sSMTP) Configuration The e-mail config uration 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 pr ompt you to sele ct a database c[...]

74 C HAPTER 2: I NSTALLATION S CRIPTS 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 th at some mail agents may require this to be a valid e-mail address. Host Identifier (hostid) of this machine is: 75896dc20fa90922dd[...]

Multiple Server Initial Installation 75 -- Changing permissions of all the files in /opt/3com/compone nts/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 permiss[...]

76 C HAPTER 2: I NSTALLATION S CRIPTS *** Checking table conferen ces *** Creating table conferences *** Checking table eventatt endee *** Creating table eventattende e *** Checking table user_con fig *** Creating table user_config *** Checking table cinema * ** Creating table cinema *** Checking table address *** Creating table address *** Checkin[...]

Multiple Server Initial Installation 77 *** Checking table Cards ** * Creating table Cards *** Checking table groupmem ber *** Creating table groupmember *** Checking table subscrip tion *** Creating table subscription *** Checking table messageb oard *** Creating table messageboard *** Checking table confsrv_ config *** Creating table confsrv_conf[...]

78 C HAPTER 2: I NSTALLATION S CRIPTS *** Checking table thirdpar ty *** Creating table thirdparty *** Checking table election *** Creating table election *** Checking table persongr oup *** Creating table persongroup *** Checking table sipd_con fig *** Creating table sipd_config *** Checking table ssl_conf ig *** Creating table ssl_config -- creat[...]

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 successfu lly at /opt/3com/components/pres conf.2.5.21/client_config Any files that you store in this d[...]

80 C HAPTER 2: I NSTALLATION S CRIPTS All services will start except DB_watch dog. It starts a fter the secondar y serv er is installed and the database replication process is initiated. End of IP Confer encing Module Configuration Sample vcx-setup Script (Secondary server) This script programs the secondary server in a mu ltiple server configurati[...]

Multiple Server Initial Installation 81 Use DHCP on eth0 to configu re network parameters? [no] : ---------- Configuring Host name ---------- Enter system hostname [loca lhost] : slave.yourcompany.com ---------- Configuring IP I nterface 'eth0' ---------- Enter IP Address [192.168.1.100 ] : 10.20.30.61 Enter Network Subnet Mask [255.255.2[...]

82 C HAPTER 2: I NSTALLATION S CRIPTS 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 fro m the following list: 1. Antigua & Barbuda 18. Ecuador 35. Panama 2. Anguilla 19. Grenada 36. Peru 3. Netherlands Antilles 20. French Guiana 37. S[...]

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: Am erica/New_York -------------------------- CONFIGURATION SUMMARY -------------------------- DHCP state: disabled Hostname[...]

84 C HAPTER 2: I NSTALLATION S CRIPTS ----------------------- Sel ect System Configuration ----------------------- Individual systems may prov ide various services in a VCX installation.You must select the appropriate set of services which this system is to provide. Be certain that t he selection corresponds to the functionality you have purchased.[...]

Multiple Server Initial Installation 85 Performing early startup ta sks: [ OK ] Starting VCX-Firewall: [ OK ] Starting httpd: Removing unneeded applicati on components from the system. This may take several minut es. Please wait while the operation completes. Determining which packages are not used by any VCX version: oem.7.0.1 : [REMOVE] presconf.[...]

86 C HAPTER 2: I NSTALLATION S CRIPTS This is the computer respon sible 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 m ailhub; if it uses an unusual SMTP port number, use the colon syntax foo.bar.baz:2525 Otherwise sSMTP will use th e st[...]

Multiple Server Initial Installation 87 Enter the mail name of your system. (5) root Last and least: if sSMTP fi nds an unqualified e-mail address among the recipients, and it corresponds to a username on your local ma chine with a userid less than 1000, then the e-mail is sent to this value instea d. The idea is that mail sent to 'root' [...]

88 C HAPTER 2: I NSTALLATION S CRIPTS End of Database Configuration The database configuration is comple te. If necessary , you can re-run this portion of the script by entering presconf-setup. Start of IP Conferencing Mod ule Configuration After successful completion of the database configuration, the script will pr ompt you to select an initial c[...]

Multiple Server Initial Installation 89 Enter key: sippeng:master.yourcompany. com:+:-:-:-:5ea71ce717ea55627152a1db82d54592 key ok for sippeng Enter key: License file name: /opt/3co m/components/presconf.2.5.21/presconf_licenses Enter the mysql user name f or accessing the master database.[root]: Assuming default value as r oot Enter the host name [...]

90 C HAPTER 2: I NSTALLATION S CRIPTS Creating cinema_db2.conf on master database server On master database server c opy 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 data bas[...]

Multiple Server Initial Installation 91 restarting httpd... Creating a directory client _config to hold the soft client autoconfiguration files... Directory created successfu lly at /opt/3com/components/pres conf.2.5.21/client_config Any files that you store in this directory are accessible via http://presconf1.yourcomp any.com/3c3/<CONFIGFILENA[...]

92 C HAPTER 2: I NSTALLATION S CRIPTS End of IP Confer encing Module Configuration Sample vcx-setup Script (Confer ence server) This section co ntains a sample of the vcx-setup scr ipt 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 hos[...]

Multiple Server Initial Installation 93 ---------- Configuring IP I nterface '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 Addre ss [10.20.30.254 ] : 10.20.30.254 ---------- Configuring IP I nterface 'eth1' ---------- Interface S[...]

94 C HAPTER 2: I NSTALLATION S CRIPTS Press the Enter or Return key to accept 2 as the suggested answer . Please select a country fro m the following list: 1. Antigua & Barbuda 18. Ecuador 35. Panama 2. Anguilla 19. Grenada 36. Peru 3. Netherlands Antilles 20. French Guiana 37. St Pierre & Miquelon 4. Argentina 21. Greenland 38. Puerto Rico[...]

Multiple Server Initial Installation 95 22. Pacific Time Enter zone [13] : Selected Time Zone: Am erica/New_York -------------------------- CONFIGURATION SUMMARY -------------------------- DHCP state: disabled Hostname: slave.yourcompany .com IP Interfaces: Device IP Address Network Mask Default Gateway eth0 10.20.30.60 255.255.0.0 10.20.30.254 eth[...]

96 C HAPTER 2: I NSTALLATION S CRIPTS provide. Be certain that t he selection corresponds to the functionality you have purchased. Which services will this sy stem provide? 1. Presence and Conferenc e - all in one 2. Conferencing server 3. Conferencing and datab ase server 4. Data server for presen ce and conferencing 5. Presence server (with datab[...]

Multiple Server Initial Installation 97 Removing unneeded applicati on components from the system. This may take several minut es. Please wait while the operation completes. Determining which packages are not used by any VCX version: callprocessor.7.0.13 : [skipped; unknown package] devapp.7.0.13.14 : [skipped; unknown package] devboot.5_0_0_C : [s[...]

98 C HAPTER 2: I NSTALLATION S CRIPTS once users have added their e- ma il addresses to the 3Com IP Confer encing Modu le. Configuration for sSMTP (1) mailhub This is the computer respon sible 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[...]

Multiple Server Initial Installation 99 You probably want to use th e domain from your own e-mail address.You probably want to set up your MUA to handle unqualified addresses itself, i n which case sSMTP will never have to use this. Mail name [slave.yourcompan y.com]: yourcompany.com Enter the mail name of your system. (5) root Last and least: if s[...]

100 C HAPTER 2: I NSTALLATION S CR IPTS 3 Remote database: database is on another server. Please choose one of the ab ove options: 3 Select “3” to specif y that this server will not host a database (all servers except the primar y and secondar y ser vers in a distribu ted system). Available applications: End of Database Configuration The databa[...]

Multiple Server Initial Installation 101 Send the host ID to 3Com, which will us e it to generate your activation keys. Once 3Com has return ed the acti vation keys to you, you can paste them into the install session when prompted. The activation keys are validat ed as they are entered. If validation is successful, the keys will be stored in a lice[...]

102 C HAPTER 2: I NSTALLATION S CR IPTS T o allow access to the conference serv er from the slave (secondary) serv er: 1. Open a command windo w on the the slave (secondar y) server 2. Run remote_access.sh <conf-ser ver hostname | IP> 3. When prompted, enter the password for the conference ser ver (default is pvadmin) As a final step, return [...]

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.your[...]

104 C HAPTER 2: I NSTALLATION S CR IPTS * 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[...]

Post Installation Configuration 105 T o cr eate a route for conferences: 1 Using a browser , log in to the VCX system as admin (default password is besgroup). 2 Set up a Patter n. Pattern Name : 74* Pattern V alue : 74* 3 Create an Endpoint for the route. Ty p e : Te r m i n a l Active : Active Name : Confser Description : Confser IP Address : 10.2[...]

106 C HAPTER 2: I NSTALLATION S CR IPTS In this example, the Conference A ttendant can be acce ssed at extension 8074. T o 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 Patter n. Pattern Name : 8074 Pattern V alue : 8074 3 Create an Endpoint for the ro[...]

Post Installation Configuration 107 T o add the Pr esence and Confer ence Server(s) to the VCX system as a trusted host: 1 Log in to the VCX as r oot . 2 At the prompt, enter: cd /opt/3com/VCX/callprocess or/remoteCli/bin/ ./remoteCli -callp 3 T o check a list of the curr ent trusted hosts, enter: config cct Output similar to the following will app[...]

108 C HAPTER 2: I NSTALLATION S CR IPTS 1 (ACTIVE) 2 (NOT_IN_SERVICE) 3 (NOT_READY) 4 (CREATE_AND_GO) 5 (CREATE_AND_WAIT) 6 (DESTROY) cct -Index -RowStatus -TrustedAddress -Netmask 2 1 10.1.0.157 255.255.255.255 3 1 10.1.1.8 255.255.255.255 5 1 10.1.0.3 255.255.255.255 6 1 10.1.4.1 255.255.255.255 7 1 10.1.1.240 255.255.255.255 8 1 10.1.0.239 255.2[...]

Upgrade Installation 109 Upgrade Installation Software upgrades ar e completed by running two scripts: install-upgrade and vcx-switchversion. Th e install-upgrade script up grades the VCX Linux operating system to the latest vers ion (if necessary) and installs the software packages. The vc x-switchvers ion script p rovisions the system with the so[...]

110 C HAPTER 2: I NSTALLATION S CR IPTS -bash-2.05b# ./install-upgrade Enter ./install-upgrade at the command pr ompt. Start of install-upgrade Script --------------------------- ------------------------------------------------ -------------------------- VCX Upgrade Installer -------------------------- --------------------------- ------------------[...]

Upgrade Installation 111 Setting maximal mount count to -1 Setting interval between ch eck 15552000 seconds Updating fstab files. Configuring GRUB boot loade r...Done. Transferring configuration data. Checking kernel configurati on: ...Selecting standard kerne l Done. Copying configuration files : hosts passwd group resolv.conf ntp.conf modules.con[...]

112 C HAPTER 2: I NSTALLATION S CR IPTS Updating /usr/sbin/vcx-crea tecfg: Done. Configuration transfer comp leted successfully. -------------------------- Package Installation --------------------------- Installing 7 packages... vcx-firewall-1.5.5-1.noar ch.rpm : OK presconf-2.5.13-1.i386.rp m : OK presconf-conf-2.5.13-1.i3 86.rpm : OK presconf-pr[...]

Managing the Activation Keys 113 -bash-2.05b# vcx-switchversion 2.9.3 Enter vcx-switchversion <version-number> at the command prompt. For <version-number> , enter the VCX version numb er that appeared at the end of the install-upgrade script. Start of vcx-switchversion Script -bash-2.05b# vcx-switchvers ion 2.9.13 Checking if VCX can sw[...]

114 C HAPTER 2: I NSTALLATION S CR IPTS 3 Fro m quick links, select Licensing Information . The License Information screen appears, listing the syst em’ s activation keys and host ID. Figure 4 License Information 4 T o delete an activation key , press . 5 T o add an activation key: a Send the host ID (located at the bottom of the screen) to 3Com.[...]

3 O BTAINING S UPPORT FOR YOUR P R ODUCT Register Y our Product W arranty 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. W arranty and other service benefits are enabled through pr oduct re gistrat[...]

116 A PPENDIX 3: O BTAINING S UPPORT FOR YOUR P RODUCT T roubleshoot Online Y ou 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.co m and contains tho usands of technical solutions written by[...]

Contact Us 117 T o send a product dir ectly 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 r etur ned to the sender unopened, at the sender’ s expense. If your product is r egistered and under warranty , you [...]

118 A PPENDIX 3: O BTAINING S UPPORT FOR YOUR P RODUCT 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. 342 080812[...]

I NDEX A activation key , managing 113 C conference attendant 18 conference server 18 conference server database 18 configuration options dual server 10 multiple (four to twelve) servers 11 single server 9 configuration, post install ation 104 D database configuration 19 Domain Name System (DNS) 13 dual server installation database configuration 46[...]

120 I NDEX P post installation configu ration configure trusted hosts 106 overview 104 set up conference attendant r outes 105 set up conference routes 104 test e-mail setup 108 preparing for installation 1 3 presence server 18 presence server database 18 S scripts install-upgrade 109 vcx-switchversion 112 single server installation database confi [...]