3Com V7000 инструкция обслуживания

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

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

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 Configurations 18 Single-Site Configur ations 19 Multi-Site Configurations 19 VCX Maintenance T asks 21 About VCX Passwor ds 23 VCX File and Directory Name Guide[...]

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 Statistics 41 3 M ANAGING VCX S ERVERS Managing the T omcat Web Server 46 V erifying T omcat Ser ver Status 46 Stopping the T omcat Server 46 Startin g[...]

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 Service 62 V erifying IP Messaging Service Status 62 Starting the IP Messaging Service 62 Stopping the IP Messaging Service 62 Restarting the IP Messaging [...]

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 elephony and Messaging Server 91 Manually Configuring Region to Region Replication 93 V erifying Replication at a Branch Office 96 V erifying the Number of V[...]

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 s 154 Single User Mode Command Syntax 155 Single User Mode Examples 155 Using Batch Mode 156 Managing User Accounts with an XML File 157 Adding User [...]

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.1. Y V erif ying Software V ersions 216 Overview of a 7.1. x to 7.1. y Upgrade 217 Preliminary [...]

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 IP Messagi ng Server 267 Upgrading the Secondary IP T elephony Server 269 Upgrading th e Secondary IP Messa ging Server 270 Set Up Database Replicatio[...]

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

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 describes important features or instructions Caution Information that alerts you to potential loss of data or potential damage to an application, syst[...]

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. The following documents are a part of the VCX IP T elephony So lution: ■ VCX Installation Guide ■ VCX Maintenance Guide ■ VCX Administr[...]

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 . 3 ■ Enterprise Management Suite 2.3 for VCX 7.1 User Guide Digital Gateways ■ V71[...]

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. This chapter includes the follo[...]

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. The VCX architecture provides a dis tributed call pr ocessing system using the SIP signalling proto[...]

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 routing or translat ion (for example, pr ocesses a personal speed dial number) ■ Directory (r outing and translation functions): The routing function i[...]

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. For ex ample, the Call Pr ocessor Service is designed to run on redundant servers so if the primary server fails, the secondary server can take over pr[...]

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. Currently supported h ard ware platforms include: ■ V7000-series systems with IBM X306m or IBM X346 servers ■ V6000 Integrated Branch Communications servers ■ V[...]

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. ■ One server running the Authentication and Directory Server configurati[...]

VCX Maintenance Tasks 21 The version 7.1 upgrade procedure allows you to enable Global V oicemail Integration on servers running IP Messaging software. However , you must install IP Messaging software on a GVCS, and then set up the GVCS through the IP Messaging adminis trator configuration interface before enabling Global V oicemail Integration on [...]

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). Chapter 2 Maintain VCX system servers. Tasks include: ■ Clearing t[...]

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. See to Appendix E for a descr iption of the VCX commands you can u se to manage and view VC[...]

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 . CAUTION: Do not use operating system comma nds or utilit ies to change these passwords. The v[...]

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 character @ At sign € Euro sign Space and tab characters Ta b l e 6 Characters to Avoid in File and Dir ectory Names (continued) Character Description[...]

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). This includes the following topics: ■ Call Records Service Overview ■ C onfiguri[...]

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. CDRs can be imported by third-party billing platforms to gene[...]

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 . In this exampl[...]

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. 2 At the prompt, e[...]

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. When you create a group, it is ena[...]

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. 3 Enter the name of the group you want to delete. The group is deleted. T o v[...]

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 . The Enter Source Address prompt appear[...]

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. Y ou must enter the correct[...]

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 . Do not try to change a password her e. The Update So[...]

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. The Accounting service is deleted from the group and you ar[...]

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. The Accounting service deta ils are displayed and you a[...]

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. Only the phone extension is displayed . 304001 [...]

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. The codes listed come direc tly from the all processor and correspond to S[...]

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. T o view a CDR stored on a server hosting the Accounting ser[...]

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><a6>16</a6><a7></a7 ><a8>1</a8><a9>1</a9><b1>1</b1><b3>3 04010</b3><b6>[...]

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. The EMS admin[...]

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. ■ The endpoint statist ics and call history tables available for viewing thro[...]

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. Each accoun t has an associated password. See About VCX Passwords for more informat ion. This c[...]

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 . V erifying T[...]

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 VCX Central Manager or any of the web-base d management interfaces (VCX Administrator , VCX User , or IP Messaging) such as “page not found”, “p[...]

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 VCX software writes data to various log files and call information to Call Detail Records (CDRs[...]

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.out ■ /usr/app/gen/cpy4.out Each of these file s resets after a restart of IP Messagi ng. Consequently , these files will not gr ow too large unless the system is extr emely busy or the sys[...]

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

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. A sma ller value initiates the self-cleaning more o[...]

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. The Accounting Ser vice[...]

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. The Co mmon Agent can also be r estarted from the VCX console. Usi[...]

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

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

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

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. 2 Enter the follo wing commands: cd /opt/3com/VCX/scripts[...]

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.d ./<back-end server> restart For < back-end server [...]

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. This is used to control the common logging function, which is shared with all Tier 2 and T[...]

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. 2 Enter the follo wing command: cd /opt/3com/VCX/&[...]

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.d ./commagent start 7 Start the service (see Starting a Service ). Managing the SIP Phone Downloader The SIP Phone Downloa der loads an application image on to a 3Com phone, which enables SIP support[...]

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. 2 Enter the follo wing[...]

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 . Y ou must, however , grant t he management sta tion explicit access to the VCX se rver to enable the exchange of SNMP management and mo nitor[...]

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 ************************************ ***************** supported commands are "show", "add" , "delete", "quit", "help":: ■ T o add an SNMP manageme[...]

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. IP Messaging supports only one codec at a time. ■ If you wan[...]

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. 7 Enter the f[...]

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. 1 Log in to the primary IP Messaging server using the root account.[...]

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. This chapter includes the following topics: ■ VCX Configuration Backup and Restore Overview ■ Backing Up a VCX Configuration ■ Restoring a VCX Configurati[...]

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 relevant VC X configuration data on a machine running one or more VCX services in to a sin gle file, and su bsequently re stor e that configu ration usin[...]

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. If you select this option, the restore operation generates a warning if the system's curre nt IP configur ation does not match the configuration [...]

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 . Configuration files from an y other versions of VCX (or its[...]

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. Note that a VCX component may desi gnate some configuration files and directories as optional. O[...]

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.ta r.gz Examining a Backup File Y ou can use the vcx-backup-query command to view[...]

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). ■ --version — Displays the version of VCX softwar e for the components contained in the b ac[...]

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. Optional files configured after the backup operation ar e r emoved during the restor e ope[...]

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. Backup and Restore Operation Logs Each execution of the vcx-config[...]

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. This chapter includes the following topics: ■ Backing Up a nd Restor ing the Auth entication a nd Dir ectory Se rver Database ■ Exporting T a ble Data[...]

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. This database includes provisioning data configured thr ough the VCX Administrator we[...]

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. cd /opt/3com/VCX/scripts/rc3.d ./S20vcxdata stop 5 Enter the followin g commands to start the VCX Authentication an d Directory server data base backup utility:[...]

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. The steps in this procedur e assume the backup file is lo cated on another Authentication and Directory ser[...]

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. Depending on your VCX configuration, T omcat runs on either the IP T elephony server , t[...]

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. 9 Enter the follo wing command on th [...]

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 . ■ For all the tables under one schema (except the runtime ta[...]

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 . ■ Make sure to enter the pr[...]

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 . Once data is deleted it must be reloaded from the text files. T o clear the configurable tables fr om the back-end server database: 1 Log on to the 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. This chapter includes the followin g topics: ■ Multi-Master Replication Overview ■ Replicated T able Location ■ Manually Configuring Replication for an IP T elephony Server or IP T e[...]

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. Changes applied at one site are captur ed and stored locally befor e being forw arded and appl[...]

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 This section provides instructions on how to manually perform database replication for these two configurations: ■ Regional IP T elephony Ser ver ?[...]

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. Since there ar e only 2 servers in this configuration, enter 1. T ypic[...]

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. Each region has two Au thenticatio[...]

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 . Backing up and restoring data bases is not necessary[...]

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. i Enter the se command s: ./backupVcxdata cd /opt/3com/VCX/vcxdata/db/export There should be a single file with this format: vcxdata<region 2 site ID>backup<[...]

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. l Log in as cworks and ent[...]

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. See Manually Configuring Re plication for an IP T elephony Server or IP T elephony and Messagin[...]

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 . Branch offices 4 thr ough 6 replicate to Region 1 (secondary), which is considered a Master Site since it is not [...]

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). T o delete replication err ors, log onto the serve[...]

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 ■ Sample VCX Server Reconfiguration[...]

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 . Y ou may decide to reconfigure a VCX server if, for example, you are moving it to a new subne twork or if you are expanding your VCX system[...]

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. Ta b l e 9 Changes in Server Configuration Parameter Origin al Val[...]

104 C HAPTER 7: R ECONFIGURING A VCX S ERVER Sample VCX Reconfiguration Script ------------------------------------ --------------------------------------- --------------- Welcome to the VCX R econfiguration Utility ---------------- ------------------------------------ --------------------------------------- This utility allows a previously con fig[...]

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 .... Enter the VCX Site Identification i. e. Site Id: ?? []: [...]

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.coms.rep lication.run.Start dropReplication INFO: ---------------------[...]

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. --------------------- Configuring IP Interface 'eth0' -----[...]

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.35.10. 51 Secondary NTP Server : 10.36.10. 51 In this sample script, NTP server IP addresse[...]

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. Alaska Time - west Alaska 5. Aleutian Islands 6. Central Time [...]

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.3com.com NTP Servers: 10.35.10.51 10.36.10.51 Time Zone: America/New_York ------------------------------------ --------------------------------------- Is all of the above information corr ect[...]

Sample VCX Server Reconfiguration 111 Sample VCX Reconfiguration Script (continued) ------------------------------------ ---------------------------------------- ------------ Welcome to the VCX Serv ice Reconfiguration Wizard ------------ ------------------------------------ ---------------------------------------- ------------------------- Configu[...]

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. The secondary Call Processor acts as a backup if the prima[...]

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. IP address of the secondary Media Ga teway : 10.230.67.15 In this sample [...]

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. Root account password. A blank entry means 'no change&ap[...]

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. V CX provides a UPS monitoring service which tracks the UPS's status and [...]

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.) UPS 'write' community string : private The string you enter here must ma[...]

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. Hostname of peer IP Messaging system : test-four Enter the h[...]

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 . In this sample script, the default answer (N) i ndicates that data ba[...]

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. --------- Configuring additional par ameters for Aut[...]

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. IP Address of the first additional t rap destin[...]

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. (You will be able to enter IP addresses of authorized management stations next. Au[...]

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

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. It describes how to add UPS support to an existing VCX system, and how to monitor UPS status. This chapter includes the followin g topics: ■ UPS Overview ■ Adding UPS Support to an Existing VC[...]

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. A server in a VCX system can be connected to, and can monitor , one or two (if the server has dual power supplies) UPS devi[...]

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. For a list of supported APC UPS devices and VCX hardware platforms, consult with your 3Com Service Representative or your 3Com V oice Au thoriz[...]

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. As a general rule, the power requir e[...]

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

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. For example, enter 10.230.63.3, not 010.230.063.0 03.[...]

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. Single UPS System – Configuring a Slave VCX Server T o enable and config ure a VCX server as a slave in a single UPS system: 1 Log in, using the root account, to the VCX serv er you wa[...]

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.230.63.7 Note that you [...]

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). In this case, the servers should all r emain operational unless both UPS devic[...]

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. Dual UPS System – Configuring the Master VCX Server T o enable and configure a VCX server as the master in a multiple UPS s[...]

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. For example, enter 10.230.63.3, not 010.230.063.0 03. -[...]

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%. After the initial master VCX server configuration, you can change a parameter value by r[...]

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.230.63.5 When this command is executed: ■ UPS monitoring is enabled on the current VCX server [...]

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. In th is mode, command execution does no t provide any interactive pr ompts or queries. Note that you can enter the vcx-ups-setup co mmand with the optional --help argument to display information on[...]

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.0 upsmfr : APC batterycharge : 100.0 upsserial : ES0552000488 upsmodel : Smart-U[...]

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. Power events and VCX server responses ar e shown in Ta b l e 1 1 . T able 11 VCX Serve r Behavior for Power Events Event Respon se Power Loss When one or more VCX ser[...]

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. If multiple VCX servers are powered from the sa me UPS, all servers are provided suffi[...]

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. This chapter includes the followin g topics: ■ Call Processor Overview ■ Configuration Methods ■ Configuring T rusted En dpoints ■ Configuring Accounting and Directory Services[...]

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. Call Processor Advantages The Call Processor advantages a[...]

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 ). The Call Proces[...]

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 endpoint, from the prompt (>) enter: config CcTrusted rowStatus=4 index=< index ID> TrustedAddress=<IP address of endpoi nt> b T o add a rang[...]

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 . 3 Start the rem o te CL I interface: ./remoteCli -callprocessor 4 At the rem o te CL I pr ompt [...]

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. Furthe rmore, if you reconfigure your VCX system using remoteC[...]

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 . 6 To e x i t t h e rem o te CL I interface, enter: ex[...]

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 . 6 To e x i [...]

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. This chapter includes the followin g topics: ■ Command Overview ■ Using Single User Mode ■ Using Batch Mode ■ Files and Dir ectories[...]

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. Y ou can run the command in two modes: ■ Single user mode — In this mode, the command adds one user account at a time based on the user attribu[...]

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. Furthermore, the Authentication and Directory service on the target system must be available (a port m[...]

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: ./user-MAC --verbose-help When you execute the user-MAC command, console output indicates the progr ess of the requested action and provides a summary when fin is[...]

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). --first Yes Single S[...]

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 ). ■ String parameter values that includ e spaces, punctuation, or special characters must be enclosed in double[...]

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 . However , the --site-id parameter is r equired in modify mode if[...]

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. user-MAC --uname jjhonson --password 3dkaRiEI02 --title Mr --first Jack --middle Oli ver --las[...]

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 . If the pars e encounters a formatting error (for example, an a ngle bra[...]

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?, zip?, site?, remote?, pprofile? )> <!ATTLIST transaction type (mod | de lete) #IMPLIED > <!ELEMENT uname (#PCDATA) > <!ELEMENT phone ([...]

Using Batch Mode 159 <user-MAC-transactions> <transaction> <uname>value</uname> <phone>value</phone> <password>value</password> <title>value</title> <first>value</first> <middle>value</middle> <last>value</last> <email>value</email> <stree[...]

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) > <!ELEMENT phonepass (#PCDATA) > <!ELEMENT title (#PCDATA) > <!ELEMENT first (#PCDATA) > <!ELEMENT middle (#PCDATA) > <!ELEMENT last [...]

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.xml map to t[...]

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: ./user-MAC --csv InputFileName .csv [ --non-stop] The CSV file mu st have the following column headings in the following order to be compatible with the user-MAC command line script: UNAM[...]

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. user_MAC_defaults.xsl This XSL file translates XML to HTML to improve readability of[...]

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.0 to 7.1 Upgrade ■ Upgrading a Single-Site Syst[...]

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 . 2 Navigate to [...]

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. Y ou can also upgrade a VCX s[...]

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. The upgrade procedur e you need to perform depends on your VCX system configuration (see VCX Software Components and VCX Ha[...]

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.0 system, and assigns each phone to the appropriate phone profile. However , the VCX administrator should be aware of upgrade implications on the following phone configuration settings: ■ Regi[...]

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 Messaging ■ A pair of Global V oicemail Central Servers (GVCS) to enable Global V oicemail Integration on an entir e IP Messaging system A GVCS coordinates [...]

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.0 software to version 7.1, prompts appear in the upgrade script that allow[...]

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 . b The Enter the Number of MASTER SITEs other than the [...]

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 . 1 T o start the up[...]

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

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. After the system has completed the restart pr ocess, verify that the upgrade has occurred [...]

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. This service should be enabled on this se rver, unless another server dedicated to Adhoc Con ferencing will be used in[...]

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. 1 Stop the T omcat process, first on the primar y VCX server and then[...]

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 . These messages ar e a r[...]

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.: 1 Log in as root on the p rimary IP T elephon y server [...]

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. Th e script executes. 4 Enter the follow ing command to exit the cw orks account and return to the root account: exit 5 Stop IP Messaging, first on the primar y IP Messaging server[...]

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.1. x c.tar cd upgrade-7.1. x c ./insta[...]

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. If you do have a UPS installed and enter y and see Configuring UPS Monitoring for informat ion on the subsequent UPS configura[...]

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.1. x c The system displays several status messag[...]

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. If you answer n to indicate that t[...]

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. 3 The Adhoc Conferencing prompt appears: In order to support "a[...]

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.7.1. x c 7 Stop the Authentication and Directory service by entering the following commands: cd /op[...]

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. 4 After completing the UPS Mon[...]

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. Enter the IP address of the Ma ster Defini tion site or pr ess Ent[...]

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 ./S20vcxdata start 5 Start the T omcat process on the prim ary IP T elephony server and the seconda[...]

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.1. x c is now available ------------------- 5 Change to the new software version by entering this[...]

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. This could take several minutes and it is important the link pointer is correct befor e proc[...]

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. The procedures in this section are based on a multi-site VCX system that includes two regions (Region 1 and Re[...]

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. 2 Stop the T omcat process by entering the following commands: cd /opt/3com/VCX/scripts/r[...]

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.1. x c.tar software up[...]

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. 10 After completing the U[...]

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. See Manually Configuring Replication for an IP T e[...]

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.1. x c The system displays several status messages an[...]

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. The following steps upgrade the databases in each r egion, set up replication in each r egion, and restart the Authentic[...]

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. This is the IP addr ess of the eth0 interface on[...]

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. Enter the IP address of the Master Defi nition site. This is the IP addr ess of the eth0 in[...]

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. ■ Local messaging — Messaging services ar e provided [...]

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. The system displays several status messages. The last two messages ar e: ------------[...]

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. Typically the Central Servers are at one of the regional sites. I[...]

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. 2 Obtain a copy of the vcx-callserver-7.1. x c.tar software upgrade file and place it in the /opt/installtemp dir ectory on the primar y Call server and on the s[...]

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. Enable UPS monitoring? [N] : If you do not have a UPS installed and enter[...]

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. If you see such a prompt, answer y[...]

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. Each branch office[...]

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.1. x c.tar cd upgrade-7.1. x c ./install-upgrade The system m[...]

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. 7 The Global V oicemail I[...]

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.7.1. x c 9 Repeat steps 1 through 8 for all the other branch of fice servers in Region 1. T o upgra[...]

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 . If not, enter n . 6 The UPS Monitoring prompt appears: An Uninterruptible Power Supply (UPS ) can be used with VCX systems to avoid disrupti[...]

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. VCX provides a UPS monitoring service wh ich tracks the UP[...]

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. UPS IP address : Enter the IP address assigned to the UPS. 4 The upgrade script prompts you fo[...]

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%. 8 The upgrade script gives you the opportunity to change your UPS monitoring configuration: Do you wish to change any of the UPS Monitoring parameters? [N] : Enter n (or press Enter) to accep[...]

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.1. x to 7.1. y Upgrade ■ Upgradin[...]

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

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. This section assume s the VCX system is [...]

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. The upgrade procedur e you need to perform depends on your VCX system configuration (see VCX Software Components and [...]

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 offices that use global or local IP Messaging ■ A pair of Global V o icemail Central Servers (GVCS) to enable Global V oicemail Integration on an entir[...]

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. Follow the procedur e in this section to upgrade the two-server configuration, at a single site, from one version of [...]

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. Th e script executes. 4 Enter the follow ing command to exit the cw orks account and retu[...]

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.1. y c is now available ------------------- 2 Switch to the new software version by enterin[...]

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.1. y c is now available ------------------- 2 Switch to the new software version by entering the fo llowing comm[...]

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. Press Enter to acce[...]

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.d ./S20vcxdata start 5 Start the T omcat process on the prim ary VCX server an d the secondary VCX server by entering the fol[...]

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.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 IP T elephony server and the secon[...]

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.1. y c). If the link does not point to the new version, wa[...]

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. This could take several minutes and it is important the link pointer is correct befor e proceedin[...]

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.d ./S20vcxdata stop Upgrading the Secondary IP Messaging Server Follow the steps in this section to upgr[...]

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.d ./S70to[...]

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. Enter y to continue. Th e script executes. When the repl[...]

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.d ./vcx stop 3 Obtain a copy of the vcx-bss-7. 1. y c.tar software upgrad[...]

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. Multi-site VCX systems can be categorized by the method used to implement m essaging. ■ [...]

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. When upgrading a region-to-region of fice configuration, you must drop replication between t[...]

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.d ./S70tomcat stop 3 Log in, as root , to the Authentication and D[...]

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 . The variable y indicates the[...]

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.d ./S70tomcat stop 3 Log in, as root , to the Authentication and D[...]

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 . The variable y indicates the[...]

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. The following steps upgrade the databases in each r egion, set up replication in each r egion, and restart the Aut[...]

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. This is the IP addr ess of the eth0 interface on[...]

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. Enter the IP address of the Master Defi nition site. This is the IP addr ess of the e[...]

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. ■ Local messaging — Messaging services ar e provided [...]

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. If you see such a prompt, answer y. The system[...]

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. 2 Obtain a copy of the vcx-callserver-7.1. y c.tar softwar e upgrade file and place it in the /opt/installtemp dir ectory on the primar y Call server and on the secondary[...]

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 . In a multi-site VCX system, a single Call server typically supports all re[...]

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. As noted in Upgrading a Mu lti-Site VCX System with Branch Offices , multi-site VCX systems can be cate gorized by the method used to implement messa[...]

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.1. y c.tar cd upgrade-7.1. y c ./install-upgrade The sy[...]

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.1. y c.tar cd upgrade-7.1. y c ./install-upgrade The system may p[...]

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.0 to 7.0 Upgrade ■ Upgrading a Single-Site Syst[...]

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 . 2 Navigate to [...]

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

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. After the upgrade, you must restart database r e[...]

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. When you upgrade a primary IP Messaging server running version 6.0 IP Messaging softwar[...]

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 . Y ou do not need to run th[...]

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 server , obt ain the machine ID for the server by entering the following command while logged in to the root account: vcx-showmachineid This command ret[...]

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.activa tion.key CAUTION: Do not edit this file. The activati on key file cont [...]

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. For single-site systems, the site ID is identical for both the primar[...]

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 . ■ Set up database replication on the primary VCX server . See Set[...]

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. When the primary VCX server reboots, IP Messaging restarts and must be stopped before you can upgr[...]

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.0. x services. 5 After the system has completed the restart pr ocess, verify that the upgrade has occurred by entering this command: ls -l /opt/3[...]

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 . d The Enter the MASTER SITE 1 IP Address [0.0.0.[...]

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 . See Po st-Upgrade Requirements . Upgrading a Single-Site Sy stem With Four Servers Single-site V[...]

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. Press Enter to accep[...]

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 . See Upgrading th e Primary IP Messaging Server . ■ Upgrade the secondary IP T ele[...]

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.0.xc). Example Output /opt/3com/VCX -> /opt/3com/VCX.7.0. x c 6 Stop the Aut[...]

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 . ■ If you enter Y , this syst em [...]

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 . Howeve r , you should ensure IP Messaging is fully active before stopping i[...]

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.0. x IP T elephony services. 5 After the system has completed the restart pr ocess, verify that the upgrade has occurred by entering this command[...]

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.0. x IP Messaging services. 5 After the system has completed the restart pr ocess, verify that the upgrade has occurred by entering this command: ls -l /opt/3co[...]

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.0.0.0] p rom pt appears. Enter the IP addr ess of the Master[...]

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 . See Po st-Upgrade Requirements . Upgrading a Multi-Site System With No Branch Offices Some VCX mul[...]

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.0. x c is now available ------------------- 5 Obtain a lice nse key for the server . See Obtainin[...]

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. When upgrading a region-to-region of fice configuration, you must drop replication between [...]

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.e. Site Id pr ompt appears. Enter site ID configured for this[...]

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. If you see su[...]

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 . The variable x in[...]

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. The following steps upgrade the databases in each r egion, set up replication in each r egion, and restart the Authentication and [...]

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. Enter the IP address of the Master Definition site. d The Enter the MASTER SITE[...]

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). Or , the servers may provide messaging services for users connecte[...]

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.0. x c e Specify whether this IP Messaging system will support IP Messaging clients. The upgrade script displa ys the following prompt for the primary IP Messaging server only: Will this [...]

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.0. x IP Messaging services. i A[...]

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. The system displays several status messages. The last two messages are: -------------[...]

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. If you see such a [...]

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 . In this case, the regional of fice pr ovides messaging se rvices for use rs at each bra nch of f[...]

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.0. x c The system displays several status messages and then[...]

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

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.1 to 7.0 ■ Downgrading from 7.1.y to 7.1.x ■ Downgrading from [...]

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 . 2 Navigate to /opt/3com/VCX/scr[...]

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. ■ If you add a server to an existing VCX system (for e[...]

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. ■ The person performing the downgrade sho uld be trained in VCX operation and procedur es, and be fam[...]

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. 1 On the Master Definition Site (the pri[...]

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. 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 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.2.1 to 5.1.3. 1 Log in as root . 2 T o determine which ope rating s[...]

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. CAUTION: Back up all databases before beginning an upgrade. Downgrading Regional Aut[...]

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. The examples in this step use th e[...]

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.x Example: vcx-switchvers[...]

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.2.1 d T o confirm that you have selected the operating system version that you want, repeat the vcx-os-[...]

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.xml Stop Database Replication 1 On the Master Definition Site (the primary server[...]

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.d ./S20vcxdata stop ./S70tomcat stop 2 On the Master Site (the se condary server), log in as root [...]

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.2.1 to 5.1.3. 1 Log in as root . 2 T o determine which ope rating system versions are available, enter this command: vcx-os-query The output from this command appe[...]

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.1. y to 7.1. x . Important Considerations Before performing a downgrade, keep these considerations in mind: ■ Downgrades are typically performed for one of the following reasons: ■ Y ou have suc[...]

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 a Single-Site System (7.1.y to 7. 1.x) This procedure describes how to downgrade a pair of VCX servers running these software configurations: ■ IP T elephony and Messaging ■ IP T e[...]

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.d ./S70tomcat stop 3 On the Master Definition Site (t [...]

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. 1 On the Master Definition Site (the primary server), log in as roo t and enter these commands: cd /opt/3co[...]

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.2.0 to 4.2.1. 1 Log in as root . 2 T o determine which ope rating system versions are available, enter this command: vcx-os-query The output from this comman d appears: OS Ve[...]

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.1.y to 7.1.x) with one difference. Each Authentication and Directory serve[...]

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.2. 0 to 4.2.1. a Log in as root . b T o determine which oper[...]

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.x Example: vcx-switchvers[...]

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.2.0 d T o confirm that you have selected the operating system version that you want, repeat the vc[...]

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.xml Stop Database Replication 1 On the Master Definition Site (the primary [...]

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.d ./S20vcxdata stop ./S70tomcat stop 2 On the Master Site (the se condary server), log in as [...]

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.2.0 to 4.2.1. 1 Log in as root . 2 T o determine which ope rating system versions are available, enter this command: vcx-os-query The output from this command [...]

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. Important Considerations Before performing a downgrade, keep these considerations in mind: ■ Downgrades are typically performed for one of the following reasons: ■ Y ou have successfully upgrad[...]

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.0 software. VCX servers runni ng software versions prior to the 7.0 release do[...]

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. The VCX 6.0.x version has been selected [...]

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 . 2 Enter the follo wing commands: cd /opt/3com/VCX/vcxdata/bin ./dropVcxdata 3 When the[...]

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 . 2 Enter the follo wing commands: cd /opt/3com/VCX/vcxdata/b[...]

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. Also, the order o f the A and B versions may be reversed depending on the upgra[...]

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 . Follow the down gr[...]

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 . ■ Set up database replication fo r both schema pairs on each Authentication and Directory [...]

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.d ./S[...]

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.6.0.x/vcxdata/bin ./restoreVcxdata Enter the site ID f or the branch. 8 Log in as cworks on the bra[...]

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.d ./S30vcxglobaldir start At this point, because t here is a ve rsion mismatch between the branch database a[...]

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. Many of these commands are used (and described) elsewhere in this guide t[...]

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.0 (or earlier). See License Keys for more information. T able 17 VCX I[...]

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. Requires one of the following arguments: ■ help — Displa[...]

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

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.1 and higher, configures UPS monitorin g on the machine. See Adding UPS Support to an Existing VC[...]

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 . This chapter includes the followin g topics: ■ Call Processor CLI Overview ■ C LI Command Descriptions[...]

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. CAUTION: Consult with your authorized 3Com techni cal support represen tative befo re using the rem o teCLI application t[...]

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. Y ou can enter a command without a parameter to disp lay a list of avai lable parameters, for example: > show AcctCfg AcctLogFilter[...]

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. Use the command with a table name as a parameter to configure that ta ble. dia[...]

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 status 57 viewing details 36 Accounting serv ice configuration file modifying 49 Accounting se rvice groups 28 , 29 adding 30 configuring 29 deleting [...]

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 vcx-ups-setup 125 vcx-ups-status 125 Common Agent service 17 restarting 53 starting 52 stopping 52 configuration o ptions ha rd wa re 19 software 17 [...]

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 services 36 localhost_access_l og monitoring 48 logging Accounting service 59 Authentication and Direct ory service 59 M maintenance tasks 21 managing CD[...]

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 exporting 85 exporting for a single table 85 importing 86 timezone configuration 47 To m c a t clear cache 47 monitoring log files 48 starting 46 stoppin[...]

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 configuration options 17 vcx-assemble command 166 , 216 vcx-config-backup command overview 70 vcx-config-network command 47 vcx-config-restor e command ove[...]