Manuel d'utilisation / d'entretien du produit V7000 du fabricant 3Com
Aller à la page of 344
http://www.3com.com/ Part Number 900-0382-01 Rev AA Published August 2006 VCX ™ Maintenance Guide VCX ™ V7000 IP Telephony Solution Convergence Applica tion Suite System Relea se 7.
3Com Corporati on 350 Campus Drive Marlbor ough, MA 01752-3064 Copyright © 2002–200 6, 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 permis sion from 3Com Corporation.
C ONTENTS A BOUT T HIS G UIDE Conventions 12 Related Documentation 13 Comments 14 1 VCX S YSTEM M AINTENANCE O VERVIEW Network-based T elephony 16 VCX Softwar e Components 16 VCX Hardwar e Configurati.
4 Listing All Configured Accounting Services 36 Viewing Accounting Service Details 36 Managing CDRs and Super CDRs 37 Understanding CDR Fields 37 Viewing CDRs 40 Viewing Super CDRs 41 QoS Monitoring S.
5 SNMP Support 59 Managing the SIP Phone Downloader 61 Starting the SIP Phone Downloa der 61 Stopping the SIP Phone Downloader 61 Restarting the SIP Phone Downloader 61 Managing the IP Messaging Servi.
6 6 M ANUALLY C ONFIGURING M ULTI -M ASTER R EPLICATION Multi-Master Replication Overview 90 Replicated T able Locat ion 90 Manually Configuring Replication for an IP T elephony Server or IP T elephon.
7 Adding Primary and Seco ndary Authentication and Dir ectory Servers 147 10 M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE Command Overview 150 Using Single User Mode 152 Command Mode.
8 Upgrading the Regional IP Messaging Servers 200 Upgrading the Regional Call Servers 203 Upgrading the Re gional Call Records Server 205 Upgrading Branch Of fices 207 Configuring UPS Monitoring 211 B U PGRADING VCX S ERVER S OFTWAR E F ROM V7.1. X TO V7.
9 Upgrading th e Secondary VCX Ser ver 261 Set Up Database Replication 262 Upgrading a Single-Site Syst em W ith Four Servers 264 Upgrading the Primary IP T elephony Server 266 Upgrading th e Primary .
10 F C ALL P ROC E S S OR C OMMAND L INE I NTERFACE C OMMANDS Call Processor CLI Overview 336 CLI Command Descriptions 337 I NDEX.
A BOUT T HIS G UIDE This guide describes how to maintain 3Com ® VCX IP T elephony Solution software. VCX softwar e runs on either the 3Com V6000 or 3Com V7000 server platforms. This guide describes how to maintain VCX ™ IP T elephony Solution components, which include the VCX software services running in standard VCX softwar e configurations.
12 A BOUT T HIS G UIDE Conventions T able 1 and T able 2 list convent ions that are used thr oughout this guide. Ta b l e 1 Notice Icons Icon Notice Type Description Information note Information that .
Related Documentation 13 Related Documentation These 3Com documents contain ad ditional in formation about the products in this r elease that ar e a part of or support the 3Com Convergence Applications Suite.
14 A BOUT T HIS G UIDE The following documents provide information on products that support this release: Enterprise Management Suite ■ Enterprise Management Suit e Gett ing Started Guide, V ersion 2.3 ■ Enterprise Management Suite User Guide, Ve r s i o n 2 .
1 VCX S YSTEM M AINTENANCE O VERVIEW The 3Com® VCX IP T elephony Solution delivers reliable, highly-scalable, compr ehensive sta ndar ds-based IP tele phony for large enterprises. This chapter provides an overview of the VCX™ syst em and the steps required to maintain the servers and services in a VCX environment.
16 C HAPTER 1: VC X S YSTEM M AINTENANCE O VERVIEW Network-based T elephony The VCX IP T elephony Solution (r efer red to in this guide as the VCX system) merges telephony with ne tworking by delivering business telephone service over a data network.
VCX Software Components 17 Authentication (for examp le, validating a user name and password) Authorization (for example, verifying a user is allowed to make an international call) User -specifi c rou.
18 C HAPTER 1: VC X S YSTEM M AINTENANCE O VERVIEW Ta b l e 3 VCX Software Configuration Options Depending on the har dware co nfiguration, some services ar e typically installed in redundant pairs.
VCX Hardware Configurations 19 There ar e two basic configuration o ptions, single-site and multi-site systems. The hardware servers in each option type r un the VCX operating system.
20 C HAPTER 1: VC X S YSTEM M AINTENANCE O VERVIEW ■ One or two servers running the IP Messaging services configuration. The number of servers depends on whether the branch offices are configur ed with IP Messaging services or obtain that service from the r egional office.
VCX Maintenance Tasks 21 The version 7.1 upgrade procedure allows you to enable Global V oicemail Integration on servers running IP Messaging software.
22 C HAPTER 1: VC X S YSTEM M AINTENANCE O VERVIEW Ta b l e 4 VCX Maintenance T asks Task Purpose Referenc e Configure accounting group s on the Call Records service. Identifies the Acc ounting services from which the Call Records service should collect Call Detail Records (CDRs).
About VCX Passwords 23 The tasks in Ta b l e 4 are performed by exec uting co mmands on the appropria te VCX server . Commands can be executed either l ocally through a console terminal attached to the server or remotely through a Secure Shell (SSH) session.
24 C HAPTER 1: VC X S YSTEM M AINTENANCE O VERVIEW default passwords. Consult with your VCX installer for the current passwords. Note that these passwords can be cha nged after the initial installation by running the vcx-reconfigure script. See Chapter 7 .
VCX File and Directory Name Guidelines 25 $ Dollar sign ! Exclamation mark < and > Left and right carets | Bar & Ampersand ; Semicolon ( and ) Left and right parentheses # Pound or hash char.
26 C HAPTER 1: VC X S YSTEM M AINTENANCE O VERVIEW.
2 C ONFIGURING THE C ALL R ECORDS S ERVICE This chapter describes how to configure accounting groups on the Call Records service. An accounting group identifies the Accounting services from which the Call Recor ds service should collect Call Detail Recor ds (CDRs).
28 C HAPTER 2: C ONFIGURING THE C ALL R EC ORDS S ERVICE Call Records Service Overview A Call Detail Recor d (CDR) contains information about a processed call. This inform ation can in clude the iden ti ty of the calling and called parties, the duration of the call, and the type of call.
Configuring an Accounting Service Group 29 For example, your VCX system could in clude the following componen ts: ■ The East region includes two sites (call processors) each runnin g an Accounting service: SalesE and EngE. ■ The West region includes two sites (call processors) each running an Accounting service: SalesW and EngW .
30 C HAPTER 2: C ONFIGURING THE C ALL R EC ORDS S ERVICE Adding an Accounting Group T o add an accounting group: 1 Log on to the VCX server hosting the Call Records service as cworks and enter these commands: cd /opt/3com/VCX/bssxml/bin ./config.sh A menu of configuration options appears followed by the SELECT OPERA T ION prompt.
Configuring an Accounting Service Group 31 Enabling and Disabling Gr oups Y ou can enable or disabl e configured groups. A disabled gr oup stops collecting CDRs from member Accounting services. The CDRs are stor ed on each server hosting an Accounting service and accumulate as long a s there is enough di sk space.
32 C HAPTER 2: C ONFIGURING THE C ALL R EC ORDS S ERVICE A menu of configuration options appears followed by the SELECT OPERA T ION prompt. 2 At the prompt, enter 103 . The Enter the Gro up Name to Delete prompt appears. The configured groups ar e listed above the prompt.
Adding Accounting Services to th e Call Records Service 33 4 Enter a unique identifier that you want to assign to the Accounting service. For instance, if it is a bran ch of fice in Joliet, IL, you could use branchJolietIL as the identifier . There is no name length limit for an Accounting service identifier .
34 C HAPTER 2: C ONFIGURING THE C ALL R EC ORDS S ERVICE a At the Enter Password for Username prompt , enter cworks . An asterisk (*) appears at the Passwo rd prompts. Enter and re-enter the password for the user (default username is cw orks). The ‘cworks’ in the bracket after the prompt is not the defau lt password.
Adding Accounting Services to th e Call Records Service 35 empty password is accep ted, which is p robably not the co rrect password for that user (cworks) on the Accoun ting service. The Do you want to Update Password prompt appears. 6 Re-enter the password already assigned for the cworks user .
36 C HAPTER 2: C ONFIGURING THE C ALL R EC ORDS S ERVICE empty password is accep ted, which is p robably not the co rrect password for that user (cworks) on the Accoun ting service. The Are you sure you w ant to Delete this Source prompt appears. 6 Enter y to delete the Accounting service.
Managing CDRs and Super CDRs 37 3 The scre en displays the number of co nfigur ed Accounting services. Pr ess Enter to view t he Accounting services (clustered in their group) until you reach the Enter Source Name to View Details pr ompt. 4 Enter the name of the appropriate Accounting service.
38 C HAPTER 2: C ONFIGURING THE C ALL R EC ORDS S ERVICE b0 SESSIONSEQUENCEEND Indicates when a session sequence ends. For internal use only. N/A b1 ACCTAUTHENTICATIONFAILURECNT Account Auth Failure Count 1 b3 CALLINGPARTYE164ADDRESS An E.164 number from which the call is placed to the access gateway.
Managing CDRs and Super CDRs 39 f4 CALLTERMINATIONCAUSE Reason for call disconnect or not completed. Note that a value of zero indicates that the call has not been disconnected, or that no disconnect reason was given. Only one value can be prov ided as the disconnect reason.
40 C HAPTER 2: C ONFIGURING THE C ALL R EC ORDS S ERVICE Viewing CDRs CDRs are stor ed on the server hosting the Accounting service. In a multi-site VCX system, the CDR s gathered by multiple Accounting services and stored on multiple se rvers can be sent to a single Call Records service.
QoS Monitoring Statistics 41 cdr<Year Month Date Hour Minutes Thr eeExtraNumbers>_c.xml A CDR looks similar to this: <cdr_collection><cdr><a0>1</a0><a4>2 </a4>.
42 C HAPTER 2: C ONFIGURING THE C ALL R EC ORDS S ERVICE in XML format and stored on the Accounting server in the /opt/3com/VCX/acctxml/qos dire ctory . Y ou can use a third-party application to download the QDRs and create r eports. QoS monitoring, as implemented on a VCX system, covers 3Com IP telephones (models 310x ) as endpoints.
QoS Monitoring Statistics 43 ■ Packet Loss Av erage ■ Round T rip Delay Average Note the following QoS mon itoring considerations: ■ QoS configuration in formation (for example, monitored endpoints and thresholds) is persistent across system re boots and upgrades.
44 C HAPTER 2: C ONFIGURING THE C ALL R EC ORDS S ERVICE.
3 M ANAGING VCX S ERVERS This chapter describes various ma intenance tasks you may need to perform on the VCX services running on servers in your VCX system. Most maintenance tasks require loggi ng in to a VCX server using one of the VCX system accounts.
46 C HAPTER 3: M ANAGING VCX S ER VERS Managing the T omcat W eb Server The T omcat web server allows administ rators and users to access web-based VCX mana gement and pr ovisionin g interfaces. The T omcat server can run on an IP T elephony and IP Messaging Server , an IP T elephony Server , an IP Messaging Server , or a Call Server .
Changing a Daylight Saving and Time Zone Configuration 47 cd /opt/3com/VCX/scripts/rc3.d ./S70tomcat start exit Clearing the T omcat Cache If your browser generates page er r ors while acc essing the .
48 C HAPTER 3: M ANAGING VCX S ER VERS 3 Enter the follo wing command: setup timezone 4 Follow the prompts to change the time zone setting. 5 Enter the follo wing commands: save exit The configuration too l applies the changes.
Managing Log and CDR Files 49 ■ Additional IP Messaging files you s hould periodically examine include: ■ /usr/app/gen/app.out ■ /usr/app/gen/eml_client.
50 C HAPTER 3: M ANAGING VCX S ER VERS Accounting server , do not change this setting. The Ca ll Records service will purge CDRs fr om the Accounti ng server after collecting them. If you do not have Call Records service, change this setting to AUTO_CLEAN_IF_NO_LATEST_UPDATE="Y" to enable self-c leaning on the Accounting service.
Verifying Service Operation 51 If you enable generation of QoS statistics and QDRs, change this setting to AUTO_CLEAN_IF_NO_LATEST_UPDATE="Y" to enable self-cleaning on the Accounting service. The variable AUTO_CLEAN_IF_NO_LATEST_UPDATE_INTERVAL is set to 96 hours (four days) by default.
52 C HAPTER 3: M ANAGING VCX S ER VERS Starting the Common Agent T o start the Common Agent: 1 Log in using the root account. 2 Enter the follo wing commands: cd /opt/3com/VCX/commagent/vcx-scripts/init. d ./commagent start Stopping the Common Agent you can stop the Common Agent usi ng operating system commands or using EMS.
Managing the Com mon Agent 53 Restarting the Common Agent If the Common Agent is curr ently running, use EMS to restart the Common Agent immediately or gracefully . If the Common Agent is stopped, EMS will not be able to co mmunicate with the VCX system to issue the restart command.
54 C HAPTER 3: M ANAGING VCX S ER VERS Managing the Call Processor Service This section describes how to st art a nd stop the Call Processor service, and how to view Call Processor service status. The script that starts the Call Proc essor service runs the Call Processor service in the background with the Ca ll Pr ocessor process monitor .
Managing the Call Processor Service 55 Stopping the Call Proc essor Y ou can stop the Call Processor service using operating system commands or by using EMS. Using Operating System Commands T o stop the Call Processor servic e using operating system commands: 1 Log in into the server hosting the Call Processor service using the vcx account.
56 C HAPTER 3: M ANAGING VCX S ER VERS Using EMS T o restart the Call Pr ocessor service from EMS: 1 From the Explor er tab, right-click the 3Com Call Processor service. 2 From the pop-up menu, select Maintena nce , then select Har d Restart to shutdown and restart the Call Pr ocessor service.
Managing the Accounting Service and the Authentication and Directory Service 57 Viewing Service Status T o view the status of the Accounting service or the Authenticatio n and Directory service: 1 Log in to the server hosting the service whose status you want to view using the ro ot account.
58 C HAPTER 3: M ANAGING VCX S ER VERS Restarting a Service T o restart the Accounting service or the Authentication and Directory service: 1 Log in to the server hosting the service you want to restart using the root account. 2 Enter the follo wing commands: cd /opt/3com/VCX/scripts/rc3.
Managing the Accounting Service and the Authentication and Directory Service 59 Enabling Server Logging The files acctxmlconfig.xml (Accounting service) and vcxdataconfig.xml (Authentication and Directory service) each have a setting to enable server logging.
60 C HAPTER 3: M ANAGING VCX S ER VERS V erifying SNMP Support T o verify that either the acctxmlconfig.xml (Accounting service) or vcxdataconfig.xml (Authentication and Directory service) files ar e set up for the back-end se rver: 1 Log in to the server hosting the service using the root account.
Managing the SIP Phone Downloader 61 6 Start the Common Agent service by entering the following commands: cd /opt/3com/VCX/commagent/vcx-scrip ts/init.
62 C HAPTER 3: M ANAGING VCX S ER VERS Managing the IP Messaging Service The IP Messaging service provides voicemail and unified messaging services to users. V erifying IP Messaging Service Status T o verify the stat us of the IP Messaging service: 1 Log in to the server hosting the IP Messaging service using the app account.
Managing Authorized SNMP Station Access 63 Managing Authorized SNMP Station Access Y ou can use an SNMP management station, such as 3Com Co rporation’ s Enterprise Management Suite, to manage a VCX server .
64 C HAPTER 3: M ANAGING VCX S ER VERS delete :- Remove an authorized stati on entry quit:- exit this utility help:- show commands that are suppor ted ************************************ ************.
Changing Codecs 65 If you want to enable a set of language prompts that are compatible with the currently operating codec, simp ly run the add_language utility as described in “Adding a Set of Languag e Prompts” in the IP Messaging Module Operations and System Administ ration Guide.
66 C HAPTER 3: M ANAGING VCX S ER VERS 4 Enter the followin g command to switch to the directory containing the add_language and cha nge_codec: utilities: cd /usr/app/app.dir 5 Enter the following command to run the add_language utility: ./add_language 6 Enter the appropriate response to the prompt to add UK English language pr ompts.
Changing Codecs 67 (US English). The steps in the exam ple install the G.729a codec and convert any e xisting custom p rompt s and voice mail m essages to the G.729a codec format. IP Messaging must not be active ly proces sing calls whi le the codec_data_convert utility is running.
68 C HAPTER 3: M ANAGING VCX S ER VERS.
4 B ACKING U P AND R ESTORING A VCX C ONFIGURATION This chapter describes how to back up and restor e a VCX system configuration using the vcx-config-backup and vcx-config-restore commands.
70 C HAPTER 4: B ACKING U P AND R ESTORING A VCX C ONFIGURATION VCX Configuration Backup and Restore Overview The VCX configuration backup and restor e feature allows you to completely back up all rel.
VCX Configuration Backup and Restore Overview 71 Note that the vcx-config-restore command includes a parameter , exclude-os , that excludes the operating system information from a restor e operation.
72 C HAPTER 4: B ACKING U P AND R ESTORING A VCX C ONFIGURATION apply the old configuration by restoring the backup file to the upgraded system. ■ Y ou can backup and restor e the currently active version of VCX software and the currently active version of the VCX operating system only .
Backing Up a VCX Configuration 73 ■ --test — Lists the files that would be backed up but does not create the backup file. The backup file is created in the /opt/3com/VCX/backup dir ectory . The directory will be created if it does not already exist.
74 C HAPTER 4: B ACKING U P AND R ESTORING A VCX C ONFIGURATION For example, a backup file crea ted on 28 April 2006 on a VCX IP T elephony and IP Messaging server na med reg2a7 running version 7.1.1 would have the following filename: reg2a7_VCX.7_1_1_all_060428104340.
Restoring a VCX Configuration 75 The optional arguments inclu de: ■ --help — Displays information on command usage. ■ --fullauto — Displays complete in formation about th e backup file (version, operating system ve rsion, components, and so on).
76 C HAPTER 4: B ACKING U P AND R ESTORING A VCX C ONFIGURATION VCX Configuration , some configuration files and directories may be designated as optional. Optional files and directories are backed up if present when the vcx-config-backup command is executed.
Backup and Restore Operation Logs 77 Note that, for security reasons the VCX fir ewall is not stopped. Furthermore, the Common Agent stops only briefly while its own restore is done. For EMS-based operations, this minimizes the time during which remote manageability i s unavailable.
78 C HAPTER 4: B ACKING U P AND R ESTORING A VCX C ONFIGURATION.
5 M ANAGING A UTHENTICATION AND D IR ECTORY S ERVICE D ATABASES This chapter d escribes how to manage the database associated with each Authentication and Directory service.
80 C HAPTER 5: M ANAGING A UTHENTICATION AND D IR ECTORY S ERVICE D ATABASES Backing Up and Restoring the Authentication and Directory Server Database Y our VCX system includes backup and restor e utilities for the VCX Authentication and Directory server database.
Backing Up and Re storing the Authent i cation and Directory Server Database 81 4 Enter the following commands to change the directory and stop the VCX Authentication and Directory service.
82 C HAPTER 5: M ANAGING A UTHENTICATION AND D IR ECTORY S ERVICE D ATABASES T o run the VCX Authentication and Directory server database restor e utility: 1 Log in to the server hosting the Au thentication and Directory database backup file.
Backing Up and Re storing the Authent i cation and Directory Server Database 83 scp or ssh, you will be prompted to confirm that you want t o trust the target server . 1 Log in to both the primary and seco ndary servers hosting T omcat using the tomcat account.
84 C HAPTER 5: M ANAGING A UTHENTICATION AND D IR ECTORY S ERVICE D ATABASES 8 Enter the site ID o f the Master Definition site. The vcxdata<site ID>backup.<version number>.tgz back up file located at /opt/3com/VCX/auth/db/import/ is restor ed to the VCX Authentication and Directory server database.
Exporting Table Data 85 cd /opt/3com/VCX/scripts/rc3.d ./S20vcxdata start Exporting T able Data Use the CWDA T A package to export ta bles into flat files. Export d ata as follows: ■ For one table in a schema (except the runtime tables). See Exporting T able Data for a Single T able .
86 C HAPTER 5: M ANAGING A UTHENTICATION AND D IR ECTORY S ERVICE D ATABASES T o export all the tables in a schema : 1 From a SQL Plus command line, login as <schema> . 2 Execute the following: For this procedur e, change the following to match the system: ■ Change the value of p_ dir to the export director y .
Exporting Table Data 87 Clearing the Configurable T ables Use this procedur e to clear all the data tables in either the Accounting service, or the Authentication and Directory server .
88 C HAPTER 5: M ANAGING A UTHENTICATION AND D IR ECTORY S ERVICE D ATABASES.
6 M ANUALLY C ONFIGURING M ULTI -M ASTER R EPLICATION This chapter describes Multi-Mast er Replication (MMR) and how to manually configure it in your VCX system.
90 C HAPTER 6: M ANUALLY C ONFIGURING M ULTI -M ASTER R EPLICATION Multi-Master Replication Overview Multi-Master Replication (MMR) is the process of copying and maintaining database tables in multiple databases that make up a distributed database system.
Manually Configuring Replication for an IP Tel ephony Server or IP Telephony and Messaging Server 91 Manually Configuring Replication for an IP T elephony Server or IP T elephony and Messaging Server .
92 C HAPTER 6: M ANUALLY C ONFIGURING M ULTI -M ASTER R EPLICATION The Enter the VCX Site Identification i.e. Site Id: appears. 4 Enter the site ID o f the office you are logged into. The Enter the Number of MASTER SITEs other than the MAST ER DEFINITION SITE [1] prompt appears.
Manually Configuring Region to Regio n Replication 93 Manually Configuring Region to Region Replication For multi-site configurations with 2 Regions, each region contains a replicated copy of the other region's database. For example, consider a multi-site configuration with two regions, Region 1 and Region 2.
94 C HAPTER 6: M ANUALLY C ONFIGURING M ULTI -M ASTER R EPLICATION d Enter y . 3 If you ar e setting up r eplication after pr ovisioning data has been added to the re gional database, th e following pr ocedure for backing up and r estoring data must be performed; otherwise, continue with step 4 .
Manually Configuring Region to Regio n Replication 95 g Log in as cworks , and ent er these commands: cd /opt/3com/VCX/vcxdata/bin ./restoreVcxdata h Enter th e Site ID for Reg ion 1.
96 C HAPTER 6: M ANUALLY C ONFIGURING M ULTI -M ASTER R EPLICATION h Enter Site ID of Region 2. i For the Master Definition Site ent er the IP address of Region 2. j For the Master Site enter the IP address of Region 1. k On each VCX Authentication and Directory server run checkReplication to verify replication is normal.
Verifying the Number of VCX Data Schemas in a Region 97 The Enter the Number of MASTER SITEs other than the MASTER DEFINITION SI TE [1]: pr ompt ap pears. T o determine the number of Master Site s associated with this branch, use the listVcxdata command.
98 C HAPTER 6: M ANUALLY C ONFIGURING M ULTI -M ASTER R EPLICATION Branch offices 1 thr ough 3 replicate to Region 1 (primary), but since Region 1 (primary) is the Master Definition Site, there ar e only 3 Master sites in this cluster .
Deleting Replicatio n Errors 99 BRANCH1StLOUIS BRANCH2MADISON VCXDATA Schema Count: 3 Deleting Replication Errors This section provides details on how to use the VCX replication error deletion script. Replication errors oc casionally need to be deleted (for instance, before you perform an upgrade).
100 C HAPTER 6: M ANUALLY C ONFIGURING M ULTI -M ASTER R EPLICATION.
7 R ECONFIGURING A VCX S ERVER This chapter describes how to reconfigure a VCX server using the vcx-reconfigure command. This chapter includes the following topics: ■ Reconfiguration Overview ■ Sa.
102 C HAPTER 7: R ECONFIGURING A VCX S ERVER Reconfiguration Overview Reconfiguring a VCX server enable s you to modify it s networking parameters and the configuration of th e services that run on the server .
Sample VCX Server Reconfiguration 103 Sample VCX Serv er Reconfiguration The sample reconfiguration script in this section is based on a two-server configuration. The change s made ar e described in Ta b l e 9 . Any configuration parameters not listed in Ta b l e 9 remain unchanged.
104 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script ------------------------------------ --------------------------------------- --------------- Welcome to the VCX R econfig.
Sample VCX Server Reconfiguration 105 Sample VCX Reconfiguration Script (continued) Do you want to change any networking configuration? [no] : yes Dropping replication - please wait. Copyright (C) 2005 3COM Corporation. All rights reserved. Multi-Master Replication DROP Start Configuring .
106 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script (continued) VCXDATATESTONEX Database Multi-Maste r Replication DROP Process starting ... For Log Details Refer to ../log/repl ication_VCXDATATESTONEX_DROP200503300731 .log Dec 14, 2005 9:05:25 AM com.
Sample VCX Server Reconfiguration 107 Sample VCX Reconfiguration Script (continued) -------------------------- Configuri ng Hostname --------------------------- Enter system hostname : test-three In this sample script, the hos t name is being chan ged from test-one to test-three.
108 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script (continued) -------------------- Configuring Net work Time Protocol -------------------- Enter NTP servers one at a time. When done, enter 0.0.0.0 to stop. Primary NTP Server : 10.
Sample VCX Server Reconfiguration 109 Sample VCX Reconfiguration Script (continued) In this sample script, the co untr y code remains unchanged. Please select a time zone from the f ollowing list: 1. Alaska Time 2. Alaska Time - Alaska panhandle 3. Alaska Time - Alaska panhandle neck 4.
110 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script (continued) DNS Servers: 10.25.10.31 10.26.10.31 10.27.10.31 Search Domains: ne.
Sample VCX Server Reconfiguration 111 Sample VCX Reconfiguration Script (continued) ------------------------------------ ---------------------------------------- ------------ Welcome to the VCX Serv i.
112 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script (continued) The SIP default dialing domain is us ed to construct the SIP URI for outbound SIP requests. Enter the SIP default dialing domain : 1.1.1.1 In this sample script, the di aling domain remains unchanged.
Sample VCX Server Reconfiguration 113 Sample VCX Reconfiguration Script (continued) The secondary Media Gateway is an ad ditional interface between the VCX IP Telephony system and the external te lephone network. If there is no secondary Media Gateway, leave this entry blank.
114 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script (continued) --------------- Configuring addition al parameters for System --------------- This section allows you to change the password for each VCX system account. Press Enter to accept the current password.
Sample VCX Server Reconfiguration 115 Sample VCX Reconfiguration Script (continued) ---------- Configuring additional pa rameters for UPS Monitoring ----------- An Uninterruptible Power Supply (UPS ) can be used with VCX systems to avoid disruption due to a power outage.
116 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script (continued) The SNMP 'write' community string co nfigured in the UPS is required. (For security reasons, it is recommended that the default value provided by the UPS be changed.
Sample VCX Server Reconfiguration 117 Sample VCX Reconfiguration Script (continued) -------- Configuring additional para meters for IP Messaging Service -------- The hostname of the other IP Messagi ng system is needed in order to set up Intelligent Mirroring redundancy wit h this system.
118 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script (continued) IP Messaging includes an optional ab ility to back up messages to an external server. Enable data backup server for IPMS? [N] : Press the Enter or Ret urn key to accept the default answer .
Sample VCX Server Reconfiguration 119 Sample VCX Reconfiguration Script (continued) Do you wish to change any of the IP Messaging System parameters? [N] : Press the Enter or Return key to accept the data that you have accepted or changed. T o review the data an d make additional changes, enter Y.
120 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script (continued) In some cases it may be desirable fo r SNMP Traps to be sent to multiple destinations. Additional Trap Desti nations can be entered here. Enter a blank input to indicate that all des tinations have been entered.
Sample VCX Server Reconfiguration 121 Sample VCX Reconfiguration Script (continued) Common Agent supports a management s tation authentication feature. Answering 'Y' here will allow only a set of pre-identified SNMP management stations to manage the system.
122 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script (continued) ---------------------------- Applyin g Changes ----------------------------- The script displays several status me ssages. The last me ssage reminds you to reboot all servers after they have all been reconfigu red and to reboot them all at the same tim e.
8 M ANAGING U NINTERRUPTIBLE P OWER S UPPLIES This chapter describes how to mana ge one or more Uninterruptible Power Supplies (UPS) in your VCX sy stem.
124 C HAPTER 8: M ANAGING U NINTERRUPT IBLE P OWER S UPPLIES UPS Overview Critical network equipment is ofte n connect ed to an Uninterruptible Power Supply (UPS) to ensure continued operation in the event of mains power loss.
Adding UPS Support to an Existing VCX S ystem 125 UPS Configuration Options For the current VCX software release, 3Com Corporation supports UPS hardwar e fr om America n Power Conver sion (APC) Corporation.
126 C HAPTER 8: M ANAGING U NINTERRUPT IBLE P OWER S UPPLIES ■ Set up two UPS devices to service a single VCX server with r edundant power supplies. ■ Set up one UPS to service multiple VCX servers. ■ Set up two UPS devices to service multiple VCX servers thr ough one server with redundant power supplies.
Adding UPS Support to an Existing VCX S ystem 127 Requirements Setting up a VCX system to use UP S power and to monitor UPS status using the vcx-ups-setup command requir es the following configuration information for each UPS in the VCX system: ■ IP address of the UPS — Y ou mu st know the pre-configured IP addr ess assigned to the UPS.
128 C HAPTER 8: M ANAGING U NINTERRUPT IBLE P OWER S UPPLIES Enter N (you must uppercase) to indicate ther e is a single UPS se rvicing the entire VCX system. -- upsipaddr < IP Address of the UPS > Enter the IP address of the UPS. Use dotted decimal notation but do not enter leading zeros.
Adding UPS Support to an Existing VCX S ystem 129 Note that you must include all the vcx-ups-setup command parameters even if you are only changing a single value.
130 C HAPTER 8: M ANAGING U NINTERRUPT IBLE P OWER S UPPLIES After the initial slave VCX server configuration, you can change a parameter value by reentering the vcx-ups-setup command. In the following example, the IP address of the master VCX server is changed: vcx-ups-setup --master N --monitormu ltipleups N --upsserver 10.
Adding UPS Support to an Existing VCX S ystem 131 devices are used to pr ovide power . For servers with redundant power supplies, ensure that each power supply is connected to a differ ent UPS (and if possible, you should conn ect each UPS to differ ent mains cir cuits).
132 C HAPTER 8: M ANAGING U NINTERRUPT IBLE P OWER S UPPLIES Figure 4 T wo UPS Devices Powering Redundant VCX Servers When you have multiple UPS device s, you should connect each UPS to differ ent mains circuits if possible.
Adding UPS Support to an Existing VCX S ystem 133 Enter Y (you must uppercase) to indicate ther e are multiple UPS devices servicing the VCX system. -- upsipaddr < IP Address of the UPS > Enter the IP addr ess of th e first UPS. Use dotted decimal notation but do not enter leading zeros.
134 C HAPTER 8: M ANAGING U NINTERRUPT IBLE P OWER S UPPLIES ■ The IP address of the second UPS is 10.230.63.4. ■ The community string the second UPS will use to communicate with the master VCX server is private. ■ The low battery threshold charge is 33%.
Adding UPS Support to an Existing VCX S ystem 135 The following example shows the syntax required to initially co nfigure a slave VCX server in a system su pported by multip le UPS devices: vcx-ups-setup --master N --monitormu ltipleups Y --upsserver 10.
136 C HAPTER 8: M ANAGING U NINTERRUPT IBLE P OWER S UPPLIES The optional ar gument --fullauto specifies that the command should run in automatic mode.
Monitoring UPS Status 137 The following ex amples of the vcx-ups-status co mm a nd w ere e nt e red on the master VCX server that is monitoring a si ngle UPS. The first command example uses the --all parameter: vcx-ups-status ups0 --all upsstatus : online upsload : 033.
138 C HAPTER 8: M ANAGING U NINTERRUPT IBLE P OWER S UPPLIES VCX Server Response to Power Events This section descr ibes how UPS-supported VCX systems respond to various power events.
VCX Server Response to Power Event s 139 Final Shutdown The UPS receives a signal to turn off after a time delay (the default is 270 seconds) to allo w for the last shutdown steps to complete. The VCX system generates a trap indicating that shu tdown in imminent.
140 C HAPTER 8: M ANAGING U NINTERRUPT IBLE P OWER S UPPLIES.
9 C ONFIGURING THE C ALL P RO C E S S O R The VCX Call Pr ocessor provides call r o uting as well as other call services for the VCX IP T e lephony Solution.
142 C HAPTER 9: C ONFIGURING THE C ALL P ROCESSOR Call Processor Overview The Call Processor handles both call processing and call routing and acts as a SIP back-to-back user agen t. This means that the Call Processor actually serves as one active end point fo r each signaling leg of a call.
Configuring Trusted Endpoints 143 ■ Through the remo t eC l i Command Line Interpreter The re mo t eC li interface is run from a co nsole attached to t he VCX server . This command allows you to configure trusted end points (described in this chapter) and other VCX components (see Call Pr ocessor Command Line Interface Commands ).
144 C HAPTER 9: C ONFIGURING THE C ALL P ROCESSOR 3 Start the rem o te CL I interface: ./remoteCli -callprocessor 4 Add either a single or range of trusted endpoints: a T o add a single trusted endpoi.
Configuring Accounti ng and Directory Services 145 Editing T rusted Endpoints T o edit a trusted endpoint of a Call Processor using the CLI: 1 Log onto the server hosting the Call Processor . 2 Navigate to the /opt/3com/VCX/callproce ssor/remoteCli/bin .
146 C HAPTER 9: C ONFIGURING THE C ALL P ROCESSOR CAUTION: If you add one or both of these ser vices using the method describe d in this section and lat er you run the vcx-reco nfigure command, the list of services provided in vcx-reconfigure will override those defined using remoteCli.
Configuring Accounti ng and Directory Services 147 config accts pri=2 IpAddress= <IP add ress of secondary accounting server> config accts pri=2 LocalIpAddress= <I P address of call processor> config acctc use=true 5 The interface lists the IP ad dre ss of the new Accounting server .
148 C HAPTER 9: C ONFIGURING THE C ALL P ROCESSOR config authc use=false config auths pri=2 IpAddress= <IP add ress of secondary authentication server> config auths pri=2 LocalIpAddress= <I P address of call processor> config authc use=true 5 The interface lists the IP address of the new Authentication and Directory Server .
10 M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE This chapter describes how to add, modify , and delete user accounts using the user-MAC command.
150 C HAPTER 10: M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE Command Overview The user-MAC command enables the automated creation of VCX user accounts and phone extension assignments.
Command Overview 151 Y ou can create, modify , or delet e user accounts on remote sites. ■ T o create, modify , or delete user accounts on a b ranch office fr om the regional office associated with the branch, you must use the Site Id attribute.
152 C HAPTER 10: M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE mode, the requir ed syntax, and examples. For online help with command syntax, enter the following command: .
Using Single User Mode 153 --password or --pa Yes Single String The value specifies th e password the user enters to access the VCX User Provisioning interface. To create the account with the default password (changeme), omit this field. --title or --t Yes Single String The value specifies an hon orific (for example, Mr or Ms).
154 C HAPTER 10: M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE Note the following syntax conside rations: ■ Full parameter and abbr eviated parameter names must be prefaced with two hyphe ns (for example, --p assword ).
Using Single User Mode 155 If you want to change the account’ s user name, you enter the user-MAC command with --modify plus the --uname parameter and the --new-uname parameter . Y ou cannot use the user-MAC command with the --modify to change the value of the --site-id parame ter .
156 C HAPTER 10: M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE The following example adds a user account for jjohnson and assigns the user the phone extension 2314323. The account will be created on the branch office with the site ID Br3.
Using Batch Mode 157 Batch mode processing can run in eith er stop mode (the default) or non-stop mode (the user-MAC command line includes the --non-stop qualifier). For both modes, during th e initial parse, the input file is validated for format but not for content validity .
158 C HAPTER 10: M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE newPhone?, newUname?, password?, title?, first?, middle?, last?, email?, street1?, street2?, city?, state?, country?, zi.
Using Batch Mode 159 <user-MAC-transactions> <transaction> <uname>value</uname> <phone>value</phone> <password>value</password> <title>value</t.
160 C HAPTER 10: M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE street1, street2, city, state, country, zip, site, remote, pprofile )> <!ELEMENT password (#PCDATA) > <!ELEM.
Using Batch Mode 161 <city>Unknown</city> <state>Unknown</state> <country>BLANK</country> <zip>00000</zip> <site>BLANK</site> <remote>BLANK</remote> <pprofile>BLANK</pprofile> </user_MAC_defaults> The default values spe cified in user-MAC-defaults.
162 C HAPTER 10: M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE Use the following syntax to s pec ify a CSV file as input to the user-MAC command: .
Files and Directories 163 user_MAC_defaults.dtd This DTD file specifies the structure of the XML file that contains default values used by the user-MAC command script. user_MAC_defaults.xml This XML file con tains default values used by the user-MAC command script.
164 C HAPTER 10: M ANAGING U SER A CCOUNTS U SING THE C OMMAND L INE I NTERFACE.
A U PGRADING VCX S ERVER S OFTWAR E F RO M V7.0 TO V7.1 This appendix describes the procedur es requir ed to upgrade a system running VCX server software version 7.0 to VCX server software version 7.1. This appendix includes the following topics: ■ V erifying Software V ersions ■ Overview of a 7.
166 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 V erifying Software V ersions This section describes how to verify the software versions o f individual components and entire r eleases. V erifying Component Software V ersions T o verify what the component software versions ar e: 1 Log onto the VCX system as root .
Overview of a 7.0 to 7.1 Upgrade 167 Overview of a 7.0 to 7.1 Upgrade This section provides an overview of the pr ocedures r equired to upgrade your VCX system, to an ope rational state , fro m version 7. 0 to 7.1. This appendix describes how to up grade a VCX server by entering commands at a locally attached c onsole.
168 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 Preliminary Steps Pr ior to performing any upgrade, you should check the follow ing: ■ Check the configuration type of the system you are going to upgrade.
Overview of a 7.0 to 7.1 Upgrade 169 The VCX v7.1 upgr ade procedur e creates one or mor e phone profiles based on data configured for phones in the VCX v7.
170 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 ■ Multi-site systems that include servers at regional of fices and servers at branch offices that use global or local IP Messagin.
Upgrading a Single-Site Sy stem With Two Server s 171 participating IP Messa ging serv ers (see Configuration Upgrade Options ). ■ Uninterruptible Power Su pply (UPS) Monitoring — Allows any server to be monitored by a UPS (see Chapter 8 ). When you upgrade VCX version 7.
172 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 a The Enter the VCX Site Identification i.e. Site Id pr ompt appears. Enter site ID configured for this syst em. For single-site systems, the site ID is identical for both the primary VCX server and the secon dary VCX server .
Upgrading a Single-Site Sy stem With Two Server s 173 ■ Upgrade the secondary VCX ser ver . See Upgrading the Seco ndary VCX Server . ■ Set up database replication on the primary VCX server . See Set Up Database Replication . Upgrading the Primary VCX Server Follow the steps in this section to upgrade the primary VCX server .
174 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 An Uninterruptible Power Supply (UPS ) can be used with VCX systems to avoid disruption due to a power outage. VCX provides a UPS monitoring service wh ich tracks the UPS's status and performs a safe shutdown when the its battery is depleted during a long power outage.
Upgrading a Single-Site Sy stem With Two Server s 175 6 After completing the Adhoc Confer encing, UPS Monitoring, and Global V oicemail Integration prompts, the server reboots. When the reboot process has been completed, the system starts VCX 7.1. x services.
176 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 3 The Adhoc Conferencing prompt appears: In order to support "ad-hoc" confere nces with more than 3 participants, the Adhoc Conference S ervice is used.
Upgrading a Single-Site Sy stem With Two Server s 177 6 Stop the Authenticatio n and Directory service by entering the following commands: cd /opt/3com/VCX/scripts/rc3.d ./S20vcxdata stop Set Up Database Replication Follow the steps in this section to set up database replication.
178 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 Enter y to continue. Th e script executes. During script execution, messages appear describing the replication setup. Messages also ap pear stating that firewall setup should allow communicat ion between the primary VCX server and the secondary VCX server .
Upgrading a Single-Site System With Four Server s 179 Follow the procedur es in this section to upgrade the four -server configuration at a single site from VCX version 7.0 softwar e to VCX version 7.1 software. Before you begin the upgrade procedures on the four servers, perform these steps.
180 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 e The Do you want to continue with the above settings? [n/y]: pr ompt appe ars. Enter y to continue.
Upgrading a Single-Site System With Four Server s 181 Upgrading the Primary IP T elephony Server Follow the steps in this section to upgrade the primary IP T elephony server . 1 T o start the upgrade process, enter these commands on the primary IP T elephony server: cd /opt/installtemp tar xvf vcx-softswitch-7.
182 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 Enable UPS monitoring? [N] : If you do not have a UPS installed and enter n (or press Ente r ); the remaining UPS configuration prompts are not displayed.
Upgrading a Single-Site System With Four Server s 183 ------------------- Installation Com pleted Successfully ------------------- ------------------- VCX version 7.1. x c is now available ------------------- 2 Switch to the new software version by entering the fo llowing command: vcx-switchversion 7.
184 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 feature's operation. Typically the Central Servers are at one of the regional sites. Is this a Central Server for Global Voicemail? [N] : If this server has been configur ed as a Global V oicemail Central Server , enter y a nd go to st ep 5.
Upgrading a Single-Site System With Four Server s 185 2 Switch to the new software version by entering the fo llowing command: vcx-switchversion 7.1. x c The system displays several status messages and pr ovides prompts that allow you enable Adhoc Conf erencing and UPS Monitoring.
186 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 minutes and reenter the command. This could take several minutes and it is important the link pointer is correct befor e proceeding. Example Output /opt/3com/VCX -> /opt/3com/VCX.
Upgrading a Single-Site System With Four Server s 187 If you do not have a UPS installed and enter n (or press Enter ); the remaining UPS configuration prompts are not displayed. If you do have a UPS installed and enter y and see Configuring UPS Monitoring for informat ion on the subsequent UPS configuration pr ompts.
188 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 b The Enter the Number of MASTER SITEs other than the MASTER DEFINITION SITE [1]: pr ompt appears. Press Enter to accept the default. c The Enter the MASTER DEFINITION SITE IP Address [ IP address ] prompt appears.
Upgrading a Multi-Site System With No Branch Office s 189 4 Start the Aut hentication and Director y service on the primary IP T elephony server and the secondary IP T elephony server by entering the following commands: cd /opt/3com/VCX/scripts/rc3.d .
190 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 The system displays several status messages. The last two messages ar e: ------------------- Installation Com pleted Successfully ------------------- ------------------- VCX version 7.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 191 ls -l /opt/3com/VCX The symbolic link (VCX) should point to the new version of the VCX software (7.1. x c). If the link does not point to the new version, wait a few minutes and reenter the command.
192 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 System Administration Guide for more information and for configuration options. The components in a multi-site VC X system can be set up in many possible configurat ions.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 193 depends on how the servers have been installed and how replication has been set up. T o upgrade the Authentication and Dir ectory server in Region 1: 1 Log in, as root , to the Call server in Region 1.
194 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 e The Do you want to continue with the above settings? [n/y]: pr ompt appe ars. Enter y to continue. Th e script executes. 5 Enter the follow ing command to exit the cw orks account and return to the root account: exit 6 Obtain a copy of the vcx-dataserver-7.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 195 If you do not have a UPS installed and enter n (or press Enter ); the remaining UPS configuration prompts are not displayed. If you do have a UPS installed and enter y and see Configuring UPS Monitoring for informat ion on the subsequent UPS configuration pr ompts.
196 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 b The Enter the Number of MASTER SITEs other than the MASTER DEFINITION SITE : pr ompt appears. Enter the number of Master sites. T o determin e the number of Master sites associated with this server , use the listVcxdata command.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 197 ------------------- Installation Com pleted Successfully ------------------- ------------------- VCX version 7.1. x c is now available ------------------- 8 Change to the new software version by entering this command: vcx-switchversion 7.
198 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 At this point, you have upgraded t he Authentication and Directory server on Region 1 and R egion 2, and you ha ve stopped database replication in both regions.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 199 T elephony and Messaging Server for more information. In this example, the re is one Master site, Re gion 2. c The Enter the MASTER DEFINITION SITE IP Address [ IP address ] prompt appears. Enter the IP address of the Master Defi nition site.
200 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 T elephony and Messaging Server for more information. In this example, the re is one Master site , Region 1. c The Enter the MASTER DEFINITION SITE IP Address [ IP address ] prompt appears.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 201 prov ided by a pair of Global V oicemail Central Servers (GVCS) to enable global voicemail integration on an enti re IP Messaging system. See Upgrading a Multi-Site VCX Sy stem with Branch Of fices and the IP Messaging documentation.
202 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 The system may prompt you to c onfirm that a new operating system version will be installed and indicate s which disk partition will be used after the upgrade. If you see such a prompt, answer y.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 203 b The upgrade script asks if this server as a Global V oicemail Centr al Server: In a Global Voicemail system, one si te's IPMSG servers are designated as the Central Servers an d coordinate the feature's operation.
204 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 T o upgrade the Call servers: 1 Log on, as root , to the primary Call server and the secondary Call server in a region.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 205 status and performs a safe shutdown when the its battery is depleted during a long power outage. To use this feature, you must have a compatible UPS insta lled and configured in accordance with the VCX documentatio n.
206 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 cd /opt/installtemp tar xvf vcx-bss-7.1. x c.tar cd upgrade-7.1. x c ./install-upgrade The system may prompt you to c onfirm that a new operating system version will be installed and indicate s which disk partition will be used after the upgrade.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 207 minutes and reenter the command. This could take several minutes and it is important the link pointer is correct befor e proceeding. Example Output: /opt/3com/VCX -> /opt/3com/VCX.7.1. x c Upgrading Branch Of fices This section describes how to up grade branch offices.
208 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 vcx-all-7.1.3c.tar) that will r eplace the curr ent version. The le tter c is always appended to the version number . 3 T o start the upgrade process, enter the followin g commands: cd /opt/installtemp tar xvf vcx-all-7.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 209 If you do not have a UPS installed and enter n (or press Enter ); the remaining UPS configuration prompts are not displayed. If you do have a UPS installed and enter y and see Configuring UPS Monitoring for informat ion on the subsequent UPS configuration pr ompts.
210 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 minutes and reenter the command. This could take several minutes and it is important the link pointer is correct befor e proceeding. Example Output /opt/3com/VCX -> /opt/3com/VCX.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 211 Use the Adhoc service on this server ? (Y/N) [Y] : If you want this server to act as a multi-caller (up to 6 callers) conferenc ing server , enter y .
212 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 This section assumes you have answered y to the following prompt during an upgrade to VCX version 7.1 software: An Uninterruptible Power Supply (UPS ) can be used with VCX systems to avoid disruption due to a power outage.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 213 UPS Monitoring requires a net work-enabled UPS. Enter the IP address assigned to the UPS's manage ment card or Ethernet interface. Note: The UPS must alrea dy be configured with this address.
214 A PPENDIX A: U PGRADING VCX S ERVER S OFTWARE F ROM V7.0 TO V7.1 Enter the UPS battery threshold charge. The default is 25%. The range is from 25% to 75%.
B U PGRADING VCX S ERVER S OFTWAR E F RO M V7.1. X TO V7.1. Y This appendix describes the procedur es requir ed to upgrade a system running VCX server software version 7.1. x to VCX server softwar e version 7.1. y . This appendix includes the following topics: ■ V erifying Software V ersions ■ Overview of a 7.
216 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y V erifying Software V ersions This section describes how to verify the software versions o f individual components and entire r eleases. V erifying Component Software V ersions T o verify what the component software versions ar e: 1 Log onto the VCX system as root .
Overview of a 7.1. x to 7.1. y Upgrade 217 Overview of a 7.1. x to 7.1. y Upgrade This section provides an overview of the pr ocedures r equired to upgrade your VCX system from one version of VCX software (7.1. x ) to a later version (7.1. y ). These procedures upgrade the VCX system to an operational state.
218 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y Preliminary Steps Pr ior to performing any upgrade, you should check the follow ing: ■ Check the configuration type of the system you are going to upgrade.
Upgrading a Single-Site Sy stem With Two Server s 219 Supported on: ■ Single-site systems with four servers ■ Multi-site systems that include servers at regional of fices and servers at branch off.
220 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y ■ In a four -server configur ation, one pair of servers runs IP T elepho ny server software; the seco nd pair of servers runs IP Messaging server software.
Upgrading a Single-Site Sy stem With Two Server s 221 Enter the IP addr ess of the Master Site. This is typically the IP addr ess of the secondary VCX server . e The Do you want to continue with the above settings? [n/y]: pr ompt appe ars. Enter y to continue.
222 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y The system displays several status messages. The last two messages ar e: ------------------- Installation Com pleted Successfully ------------------- ------------------- VCX version 7.
Upgrading a Single-Site Sy stem With Two Server s 223 The system displays several status messages. The last two messages ar e: ------------------- Installation Com pleted Successfully ------------------- ------------------- VCX version 7.
224 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y Enter site ID configured for this syst em. For single-site systems, the site ID is identical for both the primary VCX server and the secon dary VCX server . b The Enter the Number of MASTER SITEs other than the MASTER DEFINITION SITE [1]: pr ompt appears.
Upgrading a Single-Site System With Four Server s 225 4 Start the Authentica tion and Director y service on the primary VCX server and the secondary VCX server by entering the following commands: cd /opt/3com/VCX/scripts/rc3.
226 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y The drop replication script starts. Follow these st eps: a The Enter the VCX Site Identification i.
Upgrading a Single-Site System With Four Server s 227 7 Obtain a copy of the vcx-ipmsg- 7.1. y c.tar software upgrade file and place it in the /opt/inst alltemp directory on the primary IP Messaging server and on the secondary IP Messaging server . Next, execute the following steps in the order listed: ■ Upgrade the primary IP T elephony server .
228 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y 3 After the system has completed the restart pr ocess, verify that the upgrade has occurred by entering this command: ls -l /opt/3com/VCX The symbolic link (VCX) should point to the new version of the VCX software (7.
Upgrading a Single-Site System With Four Server s 229 ls -l /opt/3com/VCX The symbolic link (VCX) should point to the new version of the VCX software (7.1. y c). If the link does not point to the new version, wait a few minutes and reenter the command.
230 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y Example Output /opt/3com/VCX -> /opt/3com/VCX.7.1. y c 4 Stop the Authentication and Directory service by entering the following commands: cd /opt/3com/VCX/scripts/rc3.
Upgrading a Single-Site System With Four Server s 231 Set Up Database Replication Follow the steps in this section to set up database replication. 1 Stop the T omcat process, first on th e primary IP T elephony server and then on the secondary IP T elephony se rver by entering these commands (log in as root ): cd /opt/3com/VCX/scripts/rc3.
232 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y secondary IP T e lephony server . These messages are a reminder—firewall setup was performed during VCX softw are installation. f The Have you executed the ABOVE mentioned VCX-FIREWALL steps? [y/n]: pr ompt a ppears.
Upgrading a Multi-Site System With No Branch Office s 233 Upgrading the Call Records Server T o upgrade the Call Records server: 1 Log in to the Call Records server as root . 2 Stop all VCX processes on the Call Recor ds server by enter ing the following command: cd /etc/init.
234 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y Upgrading a Multi-Site VCX System with Branch Offices Some multi-site VCX systems have r e gional offices and branch offices. Each branch office is associ ated with a regional of fice.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 235 section are based on a multi-site VCX system that includ es two regions (Region 1 and Region 2) with multiple branch offices in each region. All upgrade commands are executed locally at the console.
236 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y T o upgrade the Authentication and Directory server in Region 1: 1 Log in, as root , to the Call server in Region 1. 2 Stop the T omcat process by entering the following commands: cd /opt/3com/VCX/scripts/rc3.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 237 5 Enter the follow ing command to exit the cw orks account and return to the root account: exit 6 Obtain a copy of the vcx-dataserver-7.1. y c.tar softwar e upgrade file and place it in the /opt/installtemp dir ectory on the Authentication and Directory server .
238 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y T o upgrade the Authentication and Directory server in Region 2: 1 Log in, as root , to the Call server in Region 2. 2 Stop the T omcat process by entering the following commands: cd /opt/3com/VCX/scripts/rc3.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 239 5 Enter the follow ing command to exit the cw orks account and return to the root account: exit 6 Obtain a copy of the vcx-dataserver-7.1. y c.tar softwar e upgrade file and place it in the /opt/installtemp dir ectory on the Authentication and Directory server .
240 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y At this point, you have upgraded t he Authentication and Directory server on Region 1 and R egion 2, and you ha ve stopped database replication in both regions.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 241 T elephony and Messaging Server for more information. In this example, the re is one Master site, Re gion 2. c The Enter the MASTER DEFINITION SITE IP Address [ IP address ] prompt appears. Enter the IP address of the Master Defi nition site.
242 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y T elephony and Messaging Server for more information. In this example, the re is one Master site , Region 1. c The Enter the MASTER DEFINITION SITE IP Address [ IP address ] prompt appears.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 243 prov ided by a pair of Global V oicemail Central Servers (GVCS) to enable global voicemail integration on an enti re IP Messaging system. See Upgrading a Multi-Site VCX Sy stem with Branch Of fices and the IP Messaging documentation.
244 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y tar xvf vcx-ipmsg-7.1. y c.tar cd upgrade-7.1. y c ./install-upgrade The system may prompt you to c onfirm that a new operating system version will be installed and indicate s which disk partition will be used after the upgrade.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 245 T o upgrade the Call servers: 1 Log on, as root , to the primary Call server an d the secondary Call server in a region.
246 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y 4 Upgrade the secondary Call server by following the procedur e described in step 3. Upgrading the Regional Call Records Server This section describes how to upgrade regional the Call Records server .
Upgrading a Multi-Site VCX Sy stem with Branch Offices 247 Upgrading the Branch Of fices This section describes how to up grade branch offices. Each branch office is associated with a regional office.
248 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y vcx-all-7.1.3c.tar) that will r eplace the curr ent version. The le tter c is always appended to the version number . 3 T o start the upgrade process, enter the followin g commands: cd /opt/installtemp tar xvf vcx-all-7.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 249 vcx-all-7.1.3c.tar) that will r eplace the curr ent version. The letter c is always appended to the version number . 3 T o start the upgrade process, enter the followin g commands: cd /opt/installtemp tar xvf vcx-softswitch-7.
250 A PPENDIX B: U PGRADING VCX S ERVER S OFTWARE F ROM V7.1. X TO V7.1. Y.
C U PGRADING VCX S ERVER S OFTWAR E F RO M V6.0 TO V7.0 This appendix describes the procedur es requir ed to upgrade a system running VCX server software version 6.0 to VCX server software version 7.0. This appendix includes the following topics: ■ V erifying Software V ersions ■ Overview of a 6.
252 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 V erifying Software V ersions This section describes how to verify the software versions o f individual components and entire r eleases. V erifying Component Software V ersions T o verify what the component software versions ar e: 1 Log onto the VCX system as root .
Overview of a 6.0 to 7.0 Upgrade 253 Enterprise Management Suite User Guide for VCX V7000 Components for informat ion. All components in a VCX system must run the same version of VCX so f tw a re.
254 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 Enter: ./checkReplication The returned status should be NORMAL . If r eplication errors need to be cleared: Enter: ./deleteReplicationErrors CAUTION: Do not attempt an upgrade if there are replication errors th at cannot be deleted.
Overview of a 6.0 to 7.0 Upgrade 255 Wi th version 7.0, you can set up IP Messaging in a client/server configuration. An IP Messaging server can support up to 20 IP Messaging clients. See the IP Messaging Ope rations and S ystem Administration Guide for details.
256 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 Y ou must execute the following steps on each server running the Call Processor service. Depending on your VCX system configuration, these servers could include the IP T elepho ny and IP Messaging server , the Call server , and the IP T elephony server .
Overview of a 6.0 to 7.0 Upgrade 257 key file after installing the new software, and install the license key before switching to the new version. Once you have installed the new VC X softwar e on a se.
258 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 total 8 lrwxrwxrwx 1 root root 63 Jun 15 2006 activation.key -> /opt/3com/licenses/SNAm-Fro7-vrJa-YK hH-H8az-db7Q.activation. key -rw-r--r-- 1 root root 1792 Jun 15 2006 SNAm-Fro7-vrJa-YKhH-H8az-db7Q.
Upgrading a Single-Site Sy stem With Two Server s 259 cd /opt/3com/VCX/vcxdata/bin su cworks ./dropReplication The drop replication script starts. Follow these st eps: a The Enter the VCX Site Identification i.e. Site Id pr ompt appears. Enter site ID configured for this syst em.
260 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 Next, execute the following steps in the order listed: ■ Upgrade the pr imary VCX server . See Upgrading the Primary VCX Server . ■ Upgrade the secondary VCX ser ver . See Upgrading th e Secondary VCX Server .
Upgrading a Single-Site Sy stem With Two Server s 261 /opt/3com/VCX -> /opt/3com/VCX.7.0. x c 6 Stop the Authenticatio n and Directory service by entering the following commands: cd /opt/3com/VCX/scripts/rc3.d ./S20vcxdata stop 7 Stop IP Messaging.
262 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 The system displays several status messages and then reboots. After the the reboot pr ocess has been completed, the system starts VCX 7.
Upgrading a Single-Site Sy stem With Two Server s 263 c The Enter the MASTER DEFINITION SITE IP Address [ IP address ] prompt appears. Enter the IP address of the Ma ster Defini tion site or pr ess Enter if the displayed address is correct. This is typically the IP address of the primary VCX server .
264 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 6 Start IP Messaging on the pr imary VCX server by entering the following command: ./S60ums start Run the admincfg script on bo th the primary VCX server and the secondary VCX server .
Upgrading a Single-Site System With Four Server s 265 Enter site ID configured for this syst em. For single-site systems, the site ID is identical for both the primary IP T elephony server and the secondary IP T elepho ny server . b The Enter the Number of MASTER SITEs other than the MASTER DEFINITION SITE [1]: pr ompt appears.
266 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 Next, execute the following steps in the order listed: ■ Upgrade the primary IP T elephony server . See Upgrad ing the Primary IP T elephony Server . ■ Upgrade the primary IP Messaging server .
Upgrading a Single-Site System With Four Server s 267 5 After the system has completed the restart pr ocess, verify that the upgrade has occurred by entering this command: ls -l /opt/3com/VCX The symbolic link (VCX) should point to the new version of the VCX software (7.
268 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 IP Messaging can be deployed in a client/server configuration to supp ort more users and distribute services. ■ If you enter N , this system will be configured as the primary IP Messaging server and no client configuration prompts will appear .
Upgrading a Single-Site System With Four Server s 269 Example Output /opt/3com/VCX -> /opt/3com/VCX.7.0. x c 7 Stop IP Messaging. When the pr im ary IP Messaging reboots, IP Messaging restarts and must be stopped before you can upgrade the secondary IP Messaging server .
270 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 The system displays several status messages and then reboots. After the the reboot pr ocess has been completed, the system starts VCX 7.
Upgrading a Single-Site System With Four Server s 271 The system displays several status messages and then reboots. After the the reboot pr ocess has been completed, the system starts VCX 7.
272 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 Enter the IP address of the Ma ster Defini tion site or pr ess Enter if the displayed address is correct. This is typically the IP address of the primary IP T elephony server . d The Enter the MASTER SITE 1 IP Address [0.
Upgrading a Multi-Site System With No Branch Office s 273 6 Start IP Messaging on the primary IP Messaging server b y entering the following command: ./S60ums start Run the admincfg script on bo th the primary VCX server and the secondary VCX server .
274 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 The system displays several status messages. The last two messages ar e: ------------------- Installation Com pleted Successfully ------------------- ------------------- VCX version 7.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 275 and Region 2) with multiple branch offices in each region. The pr ocedures describe the upgrade process for both local and gl obal messaging. All upgrade commands are executed locally at the console.
276 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 4 Stop database replication by entering the following commands: cd /opt/3com/VCX/vcxdata/bin su cworks ./dropReplication The drop replication script starts. Follow these st eps: a The Enter the VCX Site Identification i.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 277 7 Enter the se command s: cd /opt/installtemp tar xvf vcx-dataserver-7.0. x c.tar cd upgrade-7.0. x ./install-upgrade The system may prompt you to c onfirm that a new operating system version will be installed and indicate s which disk partition will be used after the upgrade.
278 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 15 Enter the follow ing command to exit the cw orks account and return to the root account: exit 16 Obtain a copy of the vcx-dataserver-7.0. x c.tar software upgrade file and place it in the /opt/installtemp dir ectory on the Authentication and Directory server .
Upgrading a Multi-Site VCX Sy stem with Branch Offices 279 At this point, you have upgraded t he Authentication and Directory server on Region 1 and R egion 2, and you ha ve stopped database replication in both regions.
280 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 Manually Configuring Replication for an IP T elephony Server or IP T elephony and Messaging Server for more information. c The Enter the MASTER DEFINITION SITE IP Address [ IP address ] prompt appears.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 281 Upgrading the Regional IP Messaging Servers This section describes how to u pgrad e regional IP Me ssaging servers. These servers may provide messaging services for user s connected to the regional of fice (local messaging).
282 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 d Switch to the new software vers ion by entering the follo wing command: vcx-switchversion 7.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 283 h Press Enter to accept the default answer ( N ). If you enter Y , the script presents each of the items that you entered and allows you to accept the value or change it. The system reboots. After the reboot process has been completed, the system starts VCX 7.
284 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 The system may prompt you to c onfirm that a new operating system version will be installed and indicate s which disk partition will be used after the upgrade. If you see such a prompt, answer y.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 285 3 Enter the se command s: cd /opt/installtemp tar xvf vcx-bss-7.0. x c.tar cd upgrade-7.0. x c ./install-upgrade The system may prompt you to c onfirm that a new operating system version will be installed and indicate s which disk partition will be used after the upgrade.
286 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 ■ In a multi-site VCX system configur ed to use global messaging, the IP Messaging server is located on the regional of fice. Each branch office runs the IP T elephony server o nly .
Upgrading a Multi-Site VCX Sy stem with Branch Offices 287 5 Obtain a license key for the server . See Obtaining a License Key File . 6 Install the license key . See Installing a License Key File . 7 Switch to the new software version by entering the fo llowing command: vcx-switchversion 7.
288 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0 4 T o start the upgrade process, enter the followin g commands: cd /opt/installtemp tar xvf vcx-softswitch-7.
Upgrading a Multi-Site VCX Sy stem with Branch Offices 289 serv er , IP T elephony se rver , and Call Processing ser ver). See Post-Upg rade Requirements .
290 A PPENDIX C: U PGRADING VCX S ERVER S OFTWARE F ROM V6.0 TO V7.0.
D D OWNGRADING VCX S ERVER S OFTWAR E This appendix describes the procedur es you can perform to downgrade the VCX software running on your system to a previously installed version. This chapter includes the followin g topics: ■ V erifying Software V ersions ■ Downgrading from 7.
292 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE V erifying Software V ersions This section describes how to verify the software versions o f individual components and entire r eleases. V erifying Component Software V ersions T o verify what the component software versions ar e: 1 Log onto the VCX system as root .
Downgrading from 7.1 to 7.0 293 All components in a VCX system must run the same version of VCX so f tw a re. T hi s req u ire m en t ha s the following implications: ■ Y ou cannot upgrade or downgr ade one component in a VCX system and not upgrade or downgrad e the other system components.
294 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE ■ The VCX system supports two operating system images. If the upgrade required installation of a new VCX operating system version, then the downgrade must revert to the pr evious installation.
Downgrading from 7.1 to 7.0 295 Stop Database Replication If the server is running IP T elephony and IP Messaging server softwar e or IP T elephony server software, yo u must stop datab ase replication. CAUTION: If the server is running IP Messaging ser ver software do n ot perform the steps in this section.
296 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE VCX systems require mirroring between IP Messaging ser vers. Y ou must restore the database on both servers.
Downgrading from 7.1 to 7.0 297 installed and if so, how to revert to the previous version. This operation must be performed on all VCX server s. The examples in this procedure use the assumption that upgrad ing from version 7. 0 to 7.1 changed the operati ng system version f rom 4.
298 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE Downgrading a Multiple-Site System (7.1 to 7. 0) For VCX systems that are installed at multiple sites, upgrades and downgrades must be performed using a specific sequence of servers, as described in this secti on.
Downgrading from 7.1 to 7.0 299 3 Switch operating system version The upgrade from 7.0 to 7.1 may or may not have required the installation of a new VCX operating sy stem version. This step describes how to determine if a new operating sy stem version was installed and if so, how to revert to the previous version.
300 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE Downgrading the Call Records Server The Call Records server is a stand- alone server (it has no secondary server). T o downgrade a Call Records serve r , perform these steps: 1 T o switch the VCX version, log in as root and enter this command: vcx-switchversion --manual 7.
Downgrading from 7.1 to 7.0 301 The order of the A and B versions may be r eversed depending on the upgrade hi story of the system. c When you are downgrading, use the earlier of th e two operating system versions in this command: vcx-os-switch 4.
302 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE the databases still contain 7.1 versioned data. This combinati on will not operate successfully . 2 Update the pointer to the configuration file using this co mmand: SetConfigFile /opt/3com/VCX/conf/VCX Configuration.
Downgrading from 7.1 to 7.0 303 Establish Database Replication On Master De finition S ite, establ ish database r epli cation. 1 On the Master Definition Site (the primary server), log in as roo t and enter these commands: cd /opt/3com/VCX/scripts/rc3.
304 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE The examples in this procedure use the assumption that upgrad ing from version 7. 0 to 7.1 changed the operating system version from 4.
Downgrading from 7.1.y t o 7.1.x 305 Downgrading from 7.1.y to 7.1.x Follow the procedur es in this section to downgrade your VCX system from version 7.
306 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE Note that the downgrade procedure does not r emove VCX version 7.1. y software fr om your VCX system.
Downgrading from 7.1.y t o 7.1.x 307 1 On the Master Definition Site (the primary server), log in as roo t and enter these commands: cd /opt/3com/VCX/scripts/rc3.d ./S70tomcat stop 2 On the Master Site (the se condary server) log in as root and enter these commands: cd /opt/3com/VCX/scripts/rc3.
308 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE Establish VCX Database Replication On Master Definition Site that is running IP T elephony and IP Messaging server software or IP T elephony se rver software, establish database replication.
Downgrading from 7.1.y t o 7.1.x 309 The examples in this procedure use the assumption that upgrad ing from version 7.1.x to 7.1.y changed the op erating system version from 4.
310 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE Downgrading Regional Authentication and Dir ectory Servers If a downgrade is requir ed on a re gional Authentication and Directory server , the procedur e is the same as that described in Downgrading a Single-Site System (7.
Downgrading from 7.1.y t o 7.1.x 311 how to determine if a new operating sy stem version was installed and if so, how to revert to the previous version. The examples in this step use th e assumption that upgrad ing from version 7.1.x to 7. 1.y changed th e operating system vers ion from 4.
312 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE Downgrading the Call Records Server The Call Records server is a stand- alone server (it has no secondary server). T o downgrade a Call Records serve r , perform these steps: 1 T o switch the VCX version, log in as root and enter this command: vcx-switchversion --manual 7.
Downgrading from 7.1.y t o 7.1.x 313 The order of the A and B versions may be r eversed depending on the upgrade hi story of the system. c When you are downgrading, use the earlier of th e two operating system versions in this command: vcx-os-switch 4.
314 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE but the databases still contain 7.1.y ve rsioned data. This combination will not operate successfully . 2 Update the pointer to the configuration file using this co mmand: SetConfigFile /opt/3com/VCX/conf/VCX Configuration.
Downgrading from 7.1.y t o 7.1.x 315 Establish Database Replication On Master De finition S ite, establ ish database r epli cation. 1 On the Master Definition Site (the primary server), log in as roo t and enter these commands: cd /opt/3com/VCX/scripts/rc3.
316 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE The examples in this procedure use the assumption that upgrad ing from version 7.1.x to 7.1.y changed the op erating system version from 4.
Downgrading from 7.0 to 6.0 317 Downgrading from 7.0 to 6.0 Follow the procedur es in this section to downgrade your VCX system from version 7.0 to 6.0.
318 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE The downgrade proc edure does not remove VCX version 7.0 software from your VCX system. If you have configured a VCX server running version 7.0 software for RAID operation, you cannot downgrade that ser ver to version 6.
Downgrading from 7.0 to 6.0 319 The vcx-switchversion command: ■ Stops VCX services ■ Changes the /opt/3com/VCX link to po int to the requested VCX version ■ Issues a warning that databases must be restor ed CAUTION: Do not reboot the system or restart VCX ser vices until databases have been re stored.
320 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE Remove V ersion 7.0 Database Schema s T o remove the version 7.0 database schema, perform the following steps, first on the primary server , then on the secondar y server: 1 Log in to the server as cworks user .
Downgrading from 7.0 to 6.0 321 Restart VCX Database Replication On Master Definition Site that is running the IP T elephony and IP Messaging or IP T elephony software configuration, r estart database replication. 1 Log in to the Master Definition Site (the primary server) as cworks user .
322 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE The output from this command is similar to the following: OS Version Partition La bel Status A 3.4.0 /dev/hda2 /A B 4.2.1 /dev/hda3 /B active The operating system versions that you see may var y from the example shown.
Downgrading from 7.0 to 6.0 323 ■ Downgrade the IP M essaging servers in e ach region. ■ Downgrade the Call servers in ea ch region. ■ Downgrade the Call Records server . If the upgrade process fails whil e upgrading any type of VCX server , consult with your 3Com repr esentati ve before attempting to downgrade the server .
324 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE c Select option 2 - Create as Back up Database schema for a Regional Office. ■ Restore databases to the schema and backup schema on each Authentication and Directory server . Se e Restore VCX Databases .
Downgrading from 7.0 to 6.0 325 T o downgrade a bran ch server: 1 Log in as root on the primary and secon dary regional Call servers and the branch. 2 Stop the T omcat process, first on th e primary Call server , then on the secondary Call server , and then on th e branch server by entering the following commands: cd /opt/3com/VCX/scripts/rc3.
326 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE a Copy the backup data (tgz file) fo r branch schema to the following two locations: /opt/3com/VCX/vcxdata/db/import /opt/3com/VCX/vcxdata/db/export b Enter the follo wing commands: cd /opt/3com/VCX.
Downgrading from 7.0 to 6.0 327 ./S70tomcat start 14 Log in as root to the regional Authentication and Directory server associated with the branch and enter the follo wing commands to start the globaldir service: cd /opt/3com/VCX/scripts/rc3.
328 A PPENDIX D: D OWNGRADING VCX S ERVER S OFTWARE.
E VCX C OMMANDS This appendix describes the VCX co mman ds you can use to manage and view VCX components. This appendix includes the following topic: ■ Command Descriptions.
330 A PPENDIX E: VCX C OMMANDS Command Descriptions This guide describes how to ma intain your VCX system. Most maintenance operations requir e en tering commands to perform a particular task or to run a script. The tables in this appendix describe all available VCX commands.
Command Descriptions 331 Ta b l e 1 8 lists commands you can use to manage VCX software licenses. For VCX versions 7.0 and higher , you must obtain and activate a license key for each VCX server b efore you can install new server software, or upgrade from VCX softwar e version 6.
332 A PPENDIX E: VCX C OMMANDS Ta b l e 1 9 lists commands you can use to view version information of various VCX software components. vcx-licensequery Displays in formation about the currently installed VCX software license, for example, serial number, customer name, and expiration date.
Command Descriptions 333 Ta b l e 2 0 lists miscellaneous system commands. vcx-showphone softwareversion Supports the following arguments: ■ devapp — Displays the version of application software running on telephones connected to the system. ■ devboot — Displays the version of boot software running on telephones connected to the system.
334 A PPENDIX E: VCX C OMMANDS T able 20 Miscellaneous System Comma nds Command Description vcx-sysinfo Displays system information, fo r example, host name, serial number, networking information, and disk information. vcx-ups-setup For VCX version s 7.
F C ALL P R OCESSOR C OMMAND L INE I NTERFACE C OMMANDS This chapter contain s a complete listi ng of command lin e interface (CLI) commands available for m a naging the call processor .
336 A PPENDIX F: C ALL P ROCESSOR C OMMAND L INE I NTERFACE C OMMANDS Call Processor CLI Overview The call processor can be configur ed from the server wher e the call processor was installed by usin g the remoteCLI application.
CLI Command Descriptions 337 > conf cct row=4 index=1 trustedaddr =<IP address> Y ou can enter the help command at the remote CLI application pr ompt ( > help ) to display a list of application commands.
338 A PPENDIX F: C ALL P ROCESSOR C OMMAND L INE I NTERFACE C OMMANDS show Lists all of the Call Processor tables that are used for configuration. Use the command with a table name as a parameter to view details of that table. config Lists all of the configurable tables.
CLI Command Descriptions 339.
I NDEX A Accounting s ervice 17 , 28 adding to the Call Records service 32 deleting from a group 35 editing information in a group 34 listing 36 logging 59 maintenance 56 starting 57 stopping 57 view .
341 vcx-licenseinstall 257 vcx-licensequery 258 vcx-listversions 166 , 216 vcx-os-query 297 , 30 9 vcx-os-switch 297 , 309 vcx-reconfigure 63 , 102 vcx-showconfigty pe 168 , 218 vcx-showmachin eid 257.
342 C HAPTER : I NDEX stopping 62 IP T elephony and IP Messagin g Server configuring replication 91 IP T elephony Server configuring replication 91 L license keys 256 listing configured Accounting ser.
343 Authentication and Directory service 57 Call Processor service 55 Common Agent service 52 IP Messaging service 62 SIP Phone downloader service 61 Super CDRs managing 37 viewing 41 T table data exp.
344 C HAPTER : I NDEX determining location (IP address) 56 VCX system filename guidelines 24 hardwar e components configuration options 19 maintenance tasks 21 overview 16 software components 16 confi.
Un point important après l'achat de l'appareil (ou même avant l'achat) est de lire le manuel d'utilisation. Nous devons le faire pour quelques raisons simples:
Si vous n'avez pas encore acheté 3Com V7000 c'est un bon moment pour vous familiariser avec les données de base sur le produit. Consulter d'abord les pages initiales du manuel d'utilisation, que vous trouverez ci-dessus. Vous devriez y trouver les données techniques les plus importants du 3Com V7000 - de cette manière, vous pouvez vérifier si l'équipement répond à vos besoins. Explorant les pages suivantes du manuel d'utilisation 3Com V7000, vous apprendrez toutes les caractéristiques du produit et des informations sur son fonctionnement. Les informations sur le 3Com V7000 va certainement vous aider à prendre une décision concernant l'achat.
Dans une situation où vous avez déjà le 3Com V7000, mais vous avez pas encore lu le manuel d'utilisation, vous devez le faire pour les raisons décrites ci-dessus,. Vous saurez alors si vous avez correctement utilisé les fonctions disponibles, et si vous avez commis des erreurs qui peuvent réduire la durée de vie du 3Com V7000.
Cependant, l'un des rôles les plus importants pour l'utilisateur joués par les manuels d'utilisateur est d'aider à résoudre les problèmes concernant le 3Com V7000. Presque toujours, vous y trouverez Troubleshooting, soit les pannes et les défaillances les plus fréquentes de l'apparei 3Com V7000 ainsi que les instructions sur la façon de les résoudre. Même si vous ne parvenez pas à résoudre le problème, le manuel d‘utilisation va vous montrer le chemin d'une nouvelle procédure – le contact avec le centre de service à la clientèle ou le service le plus proche.
