English dropdown-ico

3Com 900-0410-01 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

Go to page of

Similar user manuals

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of 3Com 900-0410-01, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of 3Com 900-0410-01 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of 3Com 900-0410-01. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of 3Com 900-0410-01 should contain:
- informations concerning technical data of 3Com 900-0410-01
- name of the manufacturer and a year of construction of the 3Com 900-0410-01 item
- rules of operation, control and maintenance of the 3Com 900-0410-01 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of 3Com 900-0410-01 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of 3Com 900-0410-01, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the 3Com service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of 3Com 900-0410-01.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the 3Com 900-0410-01 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

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

  • Page 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[...]

  • Page 3

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

  • Page 4

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

  • Page 5

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

  • Page 6

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

  • Page 7

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

  • Page 8

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

  • Page 9

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

  • Page 10

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

  • Page 11

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

  • Page 12

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

  • Page 13

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

  • Page 14

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

  • Page 15

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

  • Page 16

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

  • Page 17

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

  • Page 18

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

  • Page 19

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

  • Page 20

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

  • Page 21

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

  • Page 22

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

  • Page 23

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

  • Page 24

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

  • Page 25

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

  • Page 26

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

  • Page 27

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

  • Page 28

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

  • Page 29

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

  • Page 30

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

  • Page 31

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

  • Page 32

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

  • Page 33

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

  • Page 34

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

  • Page 35

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

  • Page 36

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

  • Page 37

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

  • Page 38

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

  • Page 39

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

  • Page 40

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

  • Page 41

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

  • Page 42

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

  • Page 43

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

  • Page 44

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

  • Page 45

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

  • Page 46

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

  • Page 47

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

  • Page 48

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

  • Page 49

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

  • Page 50

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

  • Page 51

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

  • Page 52

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

  • Page 53

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

  • Page 54

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

  • Page 55

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

  • Page 56

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

  • Page 57

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

  • Page 58

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

  • Page 59

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

  • Page 60

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

  • Page 61

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

  • Page 62

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

  • Page 63

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

  • Page 64

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

  • Page 65

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

  • Page 66

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

  • Page 67

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

  • Page 68

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

  • Page 69

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

  • Page 70

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

  • Page 71

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

  • Page 72

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

  • Page 73

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

  • Page 74

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

  • Page 75

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

  • Page 76

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

  • Page 77

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

  • Page 78

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

  • Page 79

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

  • Page 80

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

  • Page 81

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

  • Page 82

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

  • Page 83

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

  • Page 84

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

  • Page 85

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

  • Page 86

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

  • Page 87

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

  • Page 88

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

  • Page 89

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

  • Page 90

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

  • Page 91

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

  • Page 92

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

  • Page 93

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

  • Page 94

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

  • Page 95

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

  • Page 96

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

  • Page 97

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

  • Page 98

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

  • Page 99

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

  • Page 100

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

  • Page 101

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

  • Page 102

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

  • Page 103

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

  • Page 104

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

  • Page 105

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

  • Page 106

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

  • Page 107

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

  • Page 108

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

  • Page 109

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

  • Page 110

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

  • Page 111

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

  • Page 112

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

  • Page 113

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

  • Page 114

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

  • Page 115

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

  • Page 116

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

  • Page 117

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

  • Page 118

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

  • Page 119

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

  • Page 120

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