background image

28

C

HAPTER

 2: C

ONFIGURING

 

THE

 C

ALL

 R

ECORDS

 S

ERVICE

Call Records Service 
Overview

A Call Detail Record (CDR) contains information about a processed call. 
This information can include the identity 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 generate billing statements.

In a VCX system, CDRs can be generated by a call processor or by an IP 
Messaging server. 

Call processor CDRs are collected by one or more VCX Accounting 
services and then sent to the Call Records service. This chapter 
describes how to set up this system.

IP Messaging CDRs are generated and collected by the IP Messaging 
system. Refer to the 

IP Messaging Module Operations and System 

Administration Guide

 for information.

Depending on your VCX system configuration, an Accounting service can 
run on any of these servers:

IP Telephony and Messaging Server

IP Telephony Server

Call Server

The Accounting service collects CDRs for the server on which it runs, 
which then provides the CDRs to the Call Records service. 

The Call Records service can run on any of these servers:

IP Telephony and Messaging Server

IP Telephony Server

Call Records Server (a standalone server, usually located in a regional 
office)

You can use a CDR utility, such as the VCX Call Reports application, to 
create CDR reports. You can import CDRs from either an Accounting 
service or, more typically, from the Call Records service and generate 
calling usage reports. 

CDR Collection

A VCX system requires only one Call Records service to manage all the 
Accounting services. The Call Records service collects CDRs from an 
Accounting service, by default, every 10 minutes. Each Accounting 
service collects CDRs in one of four CDR working files (cdrworking1, ... 

Summary of Contents for VCX V7000

Page 1: ...http www 3com com Part Number 900 0382 01 Rev AF Published November 2007 VCX Maintenance Guide VCX V7000 IP Telephony Solution Convergence Application Suite System Release 7 1 ...

Page 2: ... UNITED STATES GOVERNMENT LEGENDS If you are a United States government agency then this documentation and the software described herein are provided to you subject to the following United States Government Legend All technical data and computer software is commercial in nature and developed solely at private expense Software is delivered as Commercial Computer Software as defined in DFARS 252 227...

Page 3: ...figurations 19 VCX Maintenance Tasks 21 About VCX Passwords 23 VCX File and Directory Name Guidelines 24 2 CONFIGURING THE CALL RECORDS SERVICE Call Records Service Overview 28 CDR Collection 28 Accounting Service Groups 30 Configuring an Accounting Service Group 30 Adding an Accounting Group 31 Viewing Configured Group Details 31 Enabling and Disabling Groups 32 Deleting Groups 32 Adding Accounti...

Page 4: ...ache 47 Changing a Daylight Saving and Time Zone Configuration 47 Managing Log and CDR Files 48 Tomcat and IP Messaging Log File Maintenance 48 CDR File Maintenance 49 QDR File Maintenance 50 Verifying Service Operation 51 Managing the Common Agent 51 Starting the Common Agent 52 Stopping the Common Agent 52 Restarting the Common Agent 53 Managing the Call Processor Service 54 Verifying the Call P...

Page 5: ...rent Codec 66 4 BACKING UP AND RESTORING A VCX CONFIGURATION VCX Configuration Backup and Restore Overview 70 VCX Configuration Backup File Contents 70 Backup and Restore Considerations 71 Backing Up a VCX Configuration 72 About the Backup File 73 Examining a Backup File 74 Restoring a VCX Configuration 75 Backup and Restore Operation Logs 77 5 MANAGING AUTHENTICATION AND DIRECTORY SERVICE DATABAS...

Page 6: ... Reconfiguration Overview 102 Sample VCX Server Reconfiguration 103 8 MANAGING UNINTERRUPTIBLE POWER SUPPLIES UPS Overview 124 UPS Configuration Options 125 Adding UPS Support to an Existing VCX System 125 UPS Setup Options 125 Requirements 127 Adding Single UPS Device Support 127 Adding Multiple UPS Support 130 Disabling UPS Monitoring on a VCX Server 135 Monitoring UPS Status 136 VCX Server Resp...

Page 7: ...oftware Versions 166 Overview of a 7 0 to 7 1 Upgrade 167 Preliminary Steps 168 Post Upgrade Considerations 168 Configuration Upgrade Options 169 Configuring New Features 170 Upgrading a Single Site System With Two Servers 171 Upgrading the Primary VCX Server 173 Upgrading the Secondary VCX Server 175 Set Up Database Replication 177 Upgrading a Single Site System With Four Servers 178 Upgrading th...

Page 8: ...stem With Four Servers 225 Upgrading the Primary IP Telephony Server 227 Upgrading the Primary IP Messaging Server 228 Upgrading the Secondary IP Telephony Server 229 Upgrading the Secondary IP Messaging Server 230 Set Up Database Replication 231 Upgrading a Multi Site System With No Branch Offices 232 Upgrading the Call Records Server 233 Upgrading a Multi Site VCX System with Branch Offices 234 ...

Page 9: ...ade Order 275 Upgrading the Regional Authentication and Directory Servers 275 Upgrading the Regional IP Messaging Servers 281 Upgrading the Regional Call Servers 283 Upgrading the Regional Call Records Server 284 Upgrading the Branch Offices 285 D DOWNGRADING VCX SERVER SOFTWARE Verifying Software Versions 292 Downgrading from 7 1 to 7 0 293 Important Considerations 293 Downgrading a Single Site S...

Page 10: ...10 F CALL PROCESSOR COMMAND LINE INTERFACE COMMANDS Call Processor CLI Overview 336 CLI Command Descriptions 337 INDEX ...

Page 11: ...ning in standard VCX software configurations This guide is for operators and administrators of the system and assumes the reader has a thorough understanding of telecommunications VoIP technology database technology and network and system administration operation Many tasks require system administrator privileges Release notes are issued with some products If the information in the release notes d...

Page 12: ...he word syntax means that you must evaluate the syntax provided and then supply the appropriate values for the placeholders that appear in angle brackets Example To enable RIPIP use the following syntax SETDefault port RIPIP CONTrol Listen In this example you must supply a port number for port Commands The word command means that you must enter the command exactly as shown and then press Return or...

Page 13: ...hone Guide VCX Manager s Telephone Guide VCX Feature Codes for Analog Telephones Quick Reference Guide VCX Security Guide The following documents are a part of the IP Messaging Module IP Messaging Module Quick Reference Guide 3Com Native Interface IP Messaging Module User Guide 3Com Native Interface IP Messaging Module Quick Reference Guide Traditional Interface IP Messaging Module User Guide Trad...

Page 14: ...e Version 4 8 Analog Gateways V7111 Analog Fast Track Installation Guide Version 4 8 V7111 Analog User Guide Version 4 8 V6000 Analog Fast Track Installation Guide Version 4 8 V6000 Analog User Guide Version 4 8 Comments Send e mail comments about this guide or about any Voice product documentation to VOICE_Techcomm_comments 3com com Include the following information with your comments Document ti...

Page 15: ... large enterprises This chapter provides an overview of the VCX system and the steps required to maintain the servers and services in a VCX environment This chapter includes the following topics Network based Telephony VCX Software Components VCX Hardware Configurations VCX Maintenance Tasks About VCX Passwords VCX File and Directory Name Guidelines ...

Page 16: ...s and gateways which provide user access to the Public Switched Telephone Network PSTN VCX system components can be installed in different configurations according to the features required and the number of subscribers that must be supported The system configuration determines the tasks you must perform to enable communication between components VCX Software Components describes the VCX software c...

Page 17: ...t Connects other software components and the VCX server operating system to the Enterprise Management Suite EMS or other SNMP based network management tools Provisioning Service Provides a web based user interface for managing authentication and directory data Call Records Service Stores CDRs received from the Accounting Service Sometimes referred to as the Billing Server IP Messaging Service Prov...

Page 18: ... Records Service is typically enabled on a dedicated server VCX Hardware Configurations This section briefly describes the basic hardware configurations that support VCX systems Refer to the VCX Installation Guide for more information Because VCX system software can be installed in a wide variety of hardware configurations you must understand how your VCX system has been installed before you confi...

Page 19: ...ecords Service is enabled on the primary server only Two Pair of Servers This configuration includes two pairs of servers Two servers run the IP Telephony software configuration The Call Records Service is enabled on the primary server only Two servers run the IP Messaging configuration Multi Site Configurations Multi site configurations can be configured in two ways Multiple regional offices all ...

Page 20: ...ing configuration enables each branch office to have its own local IP Messaging service The IP Telephony configuration requires that each branch office obtain IP Messaging services from the regional office referred to as global messaging The 3Com V6000 series Integrated Branch server runs the IP Telephony and IP Messaging configuration which enables local IP Messaging service As an alternative to ...

Page 21: ...t with both management servers or have a minimum of 200 Mbps IP backbone on a dual subnet network configuration See the IP Messaging Module Operations and System Administration Guide for details VCX Maintenance Tasks This section describes the maintenance tasks you may need to periodically perform to for example backup a database add an Accounting service group to the Call Records service or upgra...

Page 22: ... using the backup file Chapter 4 Back up and restore a VCX provisioning data Back up provisioning data for example user accounts dial plans and phone extensions stored in the VCX Authentication and Directory service database and subsequently restore that provisioning data using the backup file Chapter 5 Configure Multi Master Replication Multi Master Replication MMR is the process of copying and m...

Page 23: ...t The username and default password for each account is shown in Table 5 During the VCX installation procedure the installer has the option to change the default password for each account 3Com Corporation strongly recommends for security reasons that installers change the Upgrade VCX system software Upgrade VCX system software to a later release Appendix A for version 7 0 to version 7 1 upgrades A...

Page 24: ...ows and then transferred to a VCX system A valid Windows file or directory name may not be compatible with VCX Linux conventions To ensure that the names of any transferred files are compatible with the VCX conventions please use the following guidelines File and directory names composed of upper and lower case letters numbers hyphens and underscores are generally valid but do not begin a name wit...

Page 25: ...n 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 Table 6 Characters to Avoid in File and Directory Names continued Character Description ...

Page 26: ...26 CHAPTER 1 VCX SYSTEM MAINTENANCE OVERVIEW ...

Page 27: ...ting group identifies the Accounting services from which the Call Records service should collect Call Detail Records CDRs This includes the following topics Call Records Service Overview Configuring an Accounting Service Group Adding Accounting Services to the Call Records Service Managing CDRs and Super CDRs QoS Monitoring Statistics ...

Page 28: ...ding on your VCX system configuration an Accounting service can run on any of these servers IP Telephony and Messaging Server IP Telephony Server Call Server The Accounting service collects CDRs for the server on which it runs which then provides the CDRs to the Call Records service The Call Records service can run on any of these servers IP Telephony and Messaging Server IP Telephony Server Call ...

Page 29: ... service checks each Accounting service every 10 minutes there may be no XML file available for upload because neither threshold event has occurred since the last upload You cannot adjust the cdrworking threshold limits 500 CDRs or 1 hour but you can change 10 minute timer used by the Call Records service to check the Accounting services for available XML files You may want to adjust the timer acc...

Page 30: ... service groups Sales and Eng Sales would include SalesE and SalesW Eng would include EngE and EngW Configuring an Accounting Service Group Each Accounting service must be contained in a group A group must be created before you can add any Accounting services to the Call Records service You can configure as many groups as you want for your system but each Accounting service can only be assigned to...

Page 31: ...o list the existing accounting enter 104 at the SELECT OPERATION prompt Viewing Configured Group Details Use this function to list the Accounting services associated with a specific group This function also shows whether or not a group is enabled and how often it collects CDRs from the Accounting services To view group details 1 Log on to the VCX server hosting the Call Records service as cworks a...

Page 32: ...nter the Group Name to Enable or the Enter the Group Name to Disable prompt appears depending on the state of the group The configured groups are listed above the prompt 3 Enter the name of the group you want to enable or disable The Do you want to Enable Disable this Group y n prompt appears 4 Enter either y or n depending on the state you need the group to be in The new state is applied to the g...

Page 33: ...Group then assign the group to the Call Records service If you have a multiple site configuration includes more than one server be sure to add all Accounting services to the Call Records server This includes all the regional offices primary and secondary and any branch offices To add Accounting services to the Call Records service 1 Log on to the VCX server hosting the Call Records service as cwor...

Page 34: ...e Default Accounting Server Source Configuration prompt appears 3Com recommends using the default source configuration which identifies where the CDRs are stored on the Accounting service If you enter n a At the Enter Source Path prompt enter the path where you want the CDRs to be stored The default is opt 3com VCX acctxml db export b At the Enter Source Username enter cworks An asterisk appears a...

Page 35: ... use this feature if you need to update Accounting service information To edit Accounting service information 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 OPERATION prompt 2 At the prompt enter 202 3 The screen displays the number of configured Accou...

Page 36: ...stored on the Accounting service To delete an Accounting service from a 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 OPERATION prompt 2 At the prompt enter 203 3 The screen displays the number of configured Accounting services Press Enter to vi...

Page 37: ... bssxml bin config sh A menu of configuration options appears followed by the SELECT OPERATION prompt 2 At the prompt enter 204 3 The screen displays the number of configured Accounting services Press Enter to view the Accounting services clustered in their group until you reach the main menu prompt Viewing Accounting Service Details Use this option to view which group an Accounting service belong...

Page 38: ...o the VCX Call Reports application see the VCX Administration Guide This application allows you to view export and create reports based on retrieved CDRs Understanding CDR Fields Each CDR and Super CDR XML file consists of HTML tags that are used to identify specific variables See Table 7 for the names of the variables associated with the HTML tags and the CDR field descriptions and values Table 7...

Page 39: ...IFIER This is a globally unique call ID For internal use only N A e5 CALLTYPE Indicates the type of call placed 1 Phone to phone 2 PC to phone 3 Phone to PC 4 Fax to fax 1 e6 CALLSTARTTIMEINGRESSGWACCESS Date and time when the call accessed the ingress gateway 20050414 19 54 07 e8 CALLSTARTTIMEANSWERED Date and time when the call is answered For example receipt of answer supervision until call dis...

Page 40: ...er 80990ea1 8cab d911 9410 a c771eb4454b o0 FEATURESUSED Indicates the feature used during a call 1 Serial Call 2 Camp On 4 Transfer to Vmail 16 Malicious Call Trace 32 Do Not Disturb 64 Directed Call Pickup 128 Emergency Call 256 Calling Identity Supression 512 Call forward busy 1024 Call forward unconditional 2048 Call forward ring no answer 4096 Group Page 8192 Hunt Group 16384 Group Pickup 327...

Page 41: ...that a call was transferred to 74000002 o7 TRANSFERINGPARTYURI URI of the transferring Transferring Party URI 74000003 o8 REFERENCECALLID This is the reference text call ID for when silent monitor and barge in is used Not supported in this release N A o9 FORWARDINGPARTYURI Forwarding party URI Not supported in this release N A p1 GROUPNAME The name of a hunt group that was defined when it was crea...

Page 42: ...lected CDRs See CDR Collection for more information 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 304010 b3 b6 98437911 b6 b9 304002 b9 c2 98437f49 c2 e5 1 e5 e6 2005041120 32 22 e6 e8 2005041120 32 22 e8 f0 2005041120 32 43 f0 f2 21 f2 f3 0 f3 h7 1 h7 h8 0 h8 j5 2 j5 l1 008fbe79 36a9 d911 89b3 b82da66107be l1 o0 4 o0 o1 114000001 o1 o2 si...

Page 43: ...rough the 3Com Enterprise Management Suite EMS version 2 3 QoS statistics also generate QDRs Quality of Service Detail Records in XML format and stored on the Accounting server in the opt 3com VCX acctxml qos directory You can use a third party application to download the QDRs and create reports QoS monitoring as implemented on a VCX system covers 3Com IP telephones models 310x as endpoints The EM...

Page 44: ...d Mean Opinion Score Average Jitter Average Packet Loss Average Round Trip Delay Average Note the following QoS monitoring considerations QoS configuration information for example monitored endpoints and thresholds is persistent across system reboots and upgrades The endpoint statistics and call history tables available for viewing through EMS do not persist across reboots of the system upgrades o...

Page 45: ...See About VCX Passwords for more information This chapter includes the following topics Managing the Tomcat Web Server Changing a Daylight Saving and Time Zone Configuration Managing Log and CDR Files Verifying Service Operation Managing the Common Agent Managing the Call Processor Service Managing the Accounting Service and the Authentication and Directory Service Managing the SIP Phone Downloade...

Page 46: ...3 7 496564 95892 S Jun05 5 37 opt 3com VCX j2sdk bin java Xms32m Xmx256m Djava util logging manager org apache juli ClassLoaderLogManager Djava endorsed dirs opt 3com VCX tomcat common endorsed classpath opt 3com VCX tomcat bin bootstrap jar opt 3com VCX tomcat bin commons log root 17471 0 0 0 0 3888 600 pts 0 S 06 57 0 00 grep tomcat Stopping the Tomcat Server You may need to stop and start the T...

Page 47: ...s rc3 d S70tomcat start Changing a Daylight Saving and Time Zone Configuration If you need to modify the daylight saving and time zone configuration for a VCX system you should use the vcx config network tool Although it appears time zone and daylight saving time settings can be modified using the Enterprise Management Suite EMS all configurations are not currently supported you cannot change the ...

Page 48: ... files Accounting service for CDR and QDR collection Tomcat and IP Messaging Log File Maintenance Files in the tomcat directory opt 3com VCX tomcat logs you should monitor include catalina out files for example catalina 2006 07 10 log localhost_access_log files for example localhost_access_log 2006 08 08 txt There is currently no mechanism in place to roll over these files or limit file size You c...

Page 49: ...CX system does not include a Call Records service you can configure the Accounting service to be self cleaning by editing the Accounting service configuration file or modifying the appropriate SNMP MIB variables To modify the Accounting service configuration file 1 Log in to the server running the Accounting service using the root account 2 Enter the following command cd opt 3com VCX acctxml conf ...

Page 50: ...File Maintenance Management of QDRs storage is similar to CDR management except that QDR generation is disabled by default see QoS Monitoring Statistics and QDRs are not collected by the Call Records service You can however configure the Accounting service to be self cleaning by editing the Accounting service configuration file or modifying the appropriate SNMP MIB variables To modify the Accounti...

Page 51: ...d Directory Service Common Agent IP Messaging system or the Call Processor associated monitor process is running log in to the appropriate server as root and enter ps A grep cw In the list that appears verify that these process names are displayed cw_acctxml Accounting Service cw_vcxdata Authentication and Directory Service cw_cagent Common Agent cw_ipums IP Messaging System cw_procmon Monitor pro...

Page 52: ...ommon Agent using operating system commands 1 Log in to the server running the Common Agent you want to stop using the root account 2 Enter the following commands cd opt 3com VCX commagent vcx scripts init d commagent stop Using EMS Use EMS to stop the Common Agent immediately or gracefully To stop the Common Agent immediately 1 From the Explorer tab right click 3Com SNMP Agent 2 From the pop up m...

Page 53: ... root account 2 Enter the following commands cd opt 3com VCX commagent vcx scripts init d commagent start The commagent script does not accept restart or status as a valid arguments Using EMS You can use EMS to restart the Common Agent immediately or gracefully To restart the Common Agent immediately 1 From the Explorer tab right click 3Com SNMP Agent 2 From the pop up menu select Maintenance then...

Page 54: ...rocessor service does not need to be started again unless one of the following exceptions occurs You stop the Call Processor service using the script with the stop option The process monitor exceeds the set number of automatic restarts Verifying the Call Processor Status To verify that the Call Processor service is running 1 Log in into the server hosting the Call Processor service using the root ...

Page 55: ...service 2 From the pop up menu select Maintenance then select Hard Shutdown A dialog box appears and displays the progress of the command When the command has been completed the Working icon changes to a Finished icon Restarting the Call Processor You can restart the Call Processor service using operating system commands or using EMS Restarting the Call Processor service stops and restarts the Cal...

Page 56: ...onfiguration The Accounting service always runs on the server hosting the IP Telephony server The Authentication and Directory service can run on either the IP Telephony server or in some multi site configurations on the Authentication and Directory server To determine where the IP address a service is running enter the following command logged in as root on the server hosting the primary call pro...

Page 57: ...he Authentication and Directory service 1 Log in to the server hosting the service you want to start using the root account 2 Enter the following commands cd opt 3com VCX scripts rc3 d back end server start For back end server enter one of the following identifiers For an Accounting service enter S40acctxml For an Authentication and Directory service enter S20vcxdata Stopping a Service To stop the...

Page 58: ...olic Notation ASN 1 This produces an understandable output that can be used for trouble locating and clearing ASN 1 is a message formatting and encoding standard which is the basis of the 3Queue protocol used between Tier 2 and Tier 3 To enable message tracing 1 Log in to the server hosting the service using the root account 2 Stop the service see Stopping a Service 3 Enter the following command t...

Page 59: ...nter the following command to change directories cd opt 3com VCX schema conf For schema enter acctxml for the Accounting service or enter vcxdata for the Authentication and Directory service 4 Edit the acctxmlconfig xml file or the vcxdataconfig xml file and enable server logging Example BES_COMMONLOGG_CONFIG Set Y or N to enable or Disable LOG_INFO LOG_FILE_PATH log LOG_FILE_NAME AuthServer LOG_T...

Page 60: ...like this Enable or Disable SNMP Common Agent M Interface 0 OFF 1 ON M ENABLED VALUE 1 5 If SNMP support is disabled continue with Enabling SNMP Support Enabling SNMP Support To enable SNMP support 1 Log in to the server hosting the service using the root account 2 Stop the Common Agent service by entering the following commands cd opt 3com VCX commagent vcx scripts init d commagent stop 3 Stop th...

Page 61: ...downloader using the root or vcx account 2 Enter the following commands cd opt 3com VCX devdnldsvr vcx scripts init d S90devdnldsvr start Stopping the SIP Phone Downloader To stop the SIP phone downloader application 1 Log in to the server hosting the SIP phone downloader using the root or vcx account 2 Enter the following commands cd opt 3com VCX devdnldsvr vcx scripts init d S90devdnldsvr stop R...

Page 62: ...o start the IP Messaging service 1 Log in to the server hosting the IP Messaging service using the app account 2 Enter the following commands cd opt 3com VCX scripts rc3 d S60ums start Stopping the IP Messaging Service To stop the IP Messaging service 1 Log in to the server hosting the IP Messaging service using the app account 2 Enter the following commands cd opt 3com VCX scripts rc3 d S60ums st...

Page 63: ... through EMS must be deleted through cagManageAuthorizedStations or through EMS You cannot selectively remove one of these stations while running vcx reconfigure refer to the VCX Installation Guide for information to vcx reconfigure Authorized stations added through cagManageAuthorizedStations or EMS are not visible from vcx reconfigure If you disable management station authentication while runnin...

Page 64: ...k into a voice waveform Software called a codec coder decoder converts the audio information between digital and analog formats Digitized audio formats have different properties Each format represents a compromise between bandwidth and audio quality that is high quality audio typically requires more network bandwidth Compressing the digitized audio data can conserve bandwidth with little compromis...

Page 65: ...ake the change on both the primary IP Messaging server and the secondary IP Messaging server CAUTION If you configure an existing IP Messaging system to use a different codec all custom prompts and voice mail messages saved in the previous codec format will be lost To avoid this loss run the codec_data_convert utility before running the change_codec utility See Converting Prompts and Messages to a...

Page 66: ...s are already enabled Converting Prompts and Messages to a Different Codec IP Messaging supports only one codec at a time and operates with the G 711a codec by default If you want to switch to a different codec for example switch from the default codec to the G729a codec you can run the change_codec utility However if you run the change_codec utility on an IP Messaging system on which custom promp...

Page 67: ...d opt installtemp 3 Enter the following command to install the G 729a codec vcx install UMS UK EN G729a SPEAK 1 1 i386 rpm 4 Enter the following command to switch to the directory containing the codec_data_convert utility cd usr app app dir 5 Enter the following command to run the codec_data_convert utility codec_data_convert g711u g729a If the utility runs successfully it returns a list of conver...

Page 68: ...68 CHAPTER 3 MANAGING VCX SERVERS ...

Page 69: ...p and restore 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 Configuration Backup and Restore Operation Logs ...

Page 70: ...ore to completely back up an entire VCX system you must perform a configuration backup operation on each machine in your VCX system 3Com Corporation recommends that you back up configuration files on your VCX system once a week However you should back up a configuration whenever you make changes A restored system will not include configuration changes made after the last backup was performed VCX C...

Page 71: ...nt hardware as part of a recovery operation in which case a new license key will be required CAUTION VCX configuration backup files may contain sensitive information and should be stored in a manner that ensures access only by authorized individuals Backup and Restore Considerations Note the following considerations when backing up and restoring a VCX configuration Database content provisioning an...

Page 72: ...component or a subset of components on a single machine Backup files are not encrypted Backup files typically contain sensitive information and must be treated with care and stored securely Files that do not contain configuration data for example log files and cache files are not backed up Configuration files associated with the VCX operating system that are not typically modified in the course of...

Page 73: ...the restore operation See Restoring a VCX Configuration About the Backup File This section describes the filename format location and contents of the VCX configuration backup file When you run the vcx config backup command VCX software creates a backup file in gzipped tar format The individual files which represent the complete configuration are contained within this archive file Each backup file ...

Page 74: ...backup vcx backup query optional arguments backup filename cfgtype Specifies the configuration type of the system on which the vcx config backup command was executed Possible values include all Indicates the host system is running as an IP Telephony and IP Messaging Server softswitch Indicates the host system is running as an IP Telephony Server ums Indicates the host system is running as an IP Me...

Page 75: ...le For backup filename enter the name of the backup file you want to examine See About the Backup File for a description of backup filenames Restoring a VCX Configuration This section describes how to use the vcx config restore command to restore a VCX configuration backup file When you run the vcx config restore command by default the restore operation first creates a new backup of the VCX system...

Page 76: ...f you do not specify a path for the backup filename the command looks for the backup file in the current location and then in the opt 3com VCX backup directory The optional arguments include help Displays information on command usage fullauto Specifies that the command should run in automatic mode In this mode command execution does not provide any interactive prompts or queries exclude os Restore...

Page 77: ...store command is tracked using syslog Information about each backup and restore operation is written to var log messages Logged messages for each operation include information such as the type of operation backup or restore the name of the backup file the success or failure of the operation and if the operation failed a reason for the failure You can use the following command to display the last t...

Page 78: ...78 CHAPTER 4 BACKING UP AND RESTORING A VCX CONFIGURATION ...

Page 79: ...ABASES This chapter describes how to manage the database associated with each Authentication and Directory service This chapter includes the following topics Backing Up and Restoring the Authentication and Directory Server Database Exporting Table Data ...

Page 80: ... Depending on the reason for the backup this server may be the primary or secondary server For example if you are performing a routine database backup you would execute the steps on the machine hosting the primary Authentication and Directory server However if the primary Authentication and Directory server database is corrupt you would execute the steps on the machine hosting the secondary Authen...

Page 81: ...to use this backup file immediately to restore the database on another server you should copy the file to an archive server 7 Restart the Tomcat and the VCX Authentication and Directory services a Log in to the server hosting Tomcat using the tomcat account and enter the following commands cd opt 3com VCX scripts rc3 d S70tomcat start b Log in to the server hosting the Authentication and Directory...

Page 82: ... the host enter y This permanently adds the IP address to the list of known hosts Repeat step 3 to copy the backup file to the secondary Authentication and Directory server CAUTION When you use the scp command to copy the database backup files to the down server you may see a warning message about a man in the middle attack This message indicates that the security key that was associated with the ...

Page 83: ...the IP Telephony server the IP Telephony and IP Messaging server or the Authentication and Directory standalone server 4 Enter the following commands on each server to change the directory and stop the VCX Authentication and Directory service cd opt 3com VCX scripts rc3 d S20vcxdata stop 5 Enter the following command on both the primary and secondary Authentication and Directory servers cd opt 3co...

Page 84: ...ing the Number of VCX Data Schemas in a Region for more information b Enter the number of Master sites The Enter the MASTER DEFINITION SITE IP Address IP address prompt appears c Enter the IP Address of the Master Definition site The Enter the MASTER SITE 1 IP Address 0 0 0 0 prompt appears If the configuration includes more than one Master Site this question repeats until the number of master sit...

Page 85: ...e Oracle initialization folder Runtime tables cannot be exported To export data for a single table 1 From a SQL Plus command line login as schema 2 Execute the following For this procedure change the following to match the system Change the value of p_dir to the export directory Change the p_tabname to the name of the table being exported Make sure to enter the procedure name EXACTLY as shown SET ...

Page 86: ...ethods may overwrite existing files in the opt 3com VCX schema db schema bulkload directory To prevent files from being overwritten rename or move the current txt files If the data in the database and the data being importing have duplicated data the duplicate data needs to be cleared before loading custom data Tables need to be manually edited using a graphic tool such as Oracle DB Studio if the ...

Page 87: ...ctory server Once data is deleted it must be reloaded from the text files To clear the configurable tables from the back end server database 1 Log on to the directory server as cworks 2 Change to the opt 3com VCX schema bin directory cd opt 3com VCX schema bin 3 Clear the data by entering the following command besbulkload pl s TNSname n schema p schema_password clear ...

Page 88: ...88 CHAPTER 5 MANAGING AUTHENTICATION AND DIRECTORY SERVICE DATABASES ...

Page 89: ...ter includes the following topics Multi Master Replication Overview Replicated Table Location Manually Configuring Replication for an IP Telephony Server or IP Telephony and Messaging Server Manually Configuring Region to Region Replication Verifying Replication at a Branch Office Verifying the Number of VCX Data Schemas in a Region Deleting Replication Errors ...

Page 90: ...g master sites Some advantages to MMR include Supports highly available data access by remote sites Provides data that is updated frequently and propagated automatically Allows real time data propagation Can provide failover protection When you set up MMR the databases to be replicated must be in the same state If for example database A has been populated with provisioning data and database B is e...

Page 91: ...s the Call Records Services the Call Processor IP Messaging Services and the Authentication and Directory Services In this case there is only one Region the single site One server is designated as the Primary and one is designated the Secondary For these configurations replication must be started manually with the setupReplication script 1 Perform the following steps on the primary and secondary s...

Page 92: ... The Enter the MASTER SITE 1 IP Address 0 0 0 0 prompt appears 7 Enter the IP Address of the secondary regional server Master Site The schema name and IP addresses of the Master Definition Site primary server and Master Site secondary server are listed The Do you want to continue with the above settings n y prompt appears 8 Enter y to configure replication between the primary and secondary regiona...

Page 93: ...ase 1 Install the Region 2 VCX Authentication and Directory server database R2DB on the VCX Authentication and Directory server for Region 1 a Log on as cworks on the primary Region 1 VCX Authentication and Directory server and enter these commands cd opt 3com VCX vcxdata bin installVcxdata b Select option 2 to BACKUP ROCSA c Enter the VCX Site ID of Region 2 when prompted The Do you want to conti...

Page 94: ...erver log in as root and enter these commands cd opt 3com VCX scripts rc3 d S70tomcat stop c On the Region 1 VCX Authentication and Directory server log in as root and enter these commands cd opt 3com VCX scripts rc3 d S20vcxdata stop d Log in as cworks and enter these commands cd opt 3com VCX vcxdata bin backupVcxdata cd opt 3com VCX vcxdata db export There should be a single file with this forma...

Page 95: ...X Authentication and Directory server as cworks and enter these commands cd opt 3com VCX vcxdata bin restoreVcxdata l Enter the Site ID for Region 2 4 Set up replication on both of the VCX Authentication and Directory servers a Verify that Tomcat on Region 1 s Call server is stopped b On Region 1 s VCX Authentication and Directory server login as cworks and enter these commands cd opt 3com VCX vcx...

Page 96: ...se commands cd opt 3com VCX scripts rc3 d S20vcxdata start Verifying Replication at a Branch Office Database replication between a branch office and the regional office associated with the branch is started automatically when VCX software is installed on the branch This section describes how to verify that replication is enabled For replication of branch databases the host Regional data server of ...

Page 97: ...er Site When the NORMAL Status returned you know the replication is configured This script can take 20 45 minutes to output the status Verifying the Number of VCX Data Schemas in a Region The listVcxdata command lists the Master Definition Site depending on which server this command is issued at and all of the Master Sites in the same cluster as the Master Site you are logged on to Both the Master...

Page 98: ... Sites in it If you executed the listVcxdata command on branch 4 no Master Definition Site would be listed just the 4 Master Sites since the Master Definition site is not in the same cluster as that branch Figure 1 Replication Setup between Master Definition Site and Master Sites To list all of the VCX data schemas associated with the server you are logged on to 1 Login on the office you want to v...

Page 99: ...ls on how to use the VCX replication error deletion script Replication errors occasionally need to be deleted for instance before you perform an upgrade To delete replication errors log onto the server hosting the VCX Authentication and Directory server as cworks and enter these commands cd opt 3com VCX vcxdata bin deleteReplicationErrors ...

Page 100: ...100 CHAPTER 6 MANUALLY CONFIGURING MULTI MASTER REPLICATION ...

Page 101: ...GURING A VCX SERVER 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 ...

Page 102: ... VCX server enter this command on the console vcx reconfigure CAUTION Do not run this command using a remote ssh login The script restarts networking at one point and you will lose your connection You cannot use the vcx reconfigure command to change these items Configuration Type You cannot modify a Call Processing Server to become an IP Messaging Server Role You cannot change a primary server to ...

Page 103: ...t listed in Table 9 remain unchanged Table 9 Changes in Server Configuration Parameter Original Value New Value IP Address eth0 10 230 64 30 10 230 64 40 IP Address eth1 10 230 64 31 10 230 64 41 Partner IP Address eth0 10 230 66 30 10 230 67 40 Partner IP Address eth1 10 230 66 31 10 230 67 41 Server Name test one test three Site Description Site One Site Three Partner Server Name test two test f...

Page 104: ...e and to re establish replication if it was dropped The correct procedures must be followed for this process to succeed Do you wish to reconfigure the system at this time no yes Starting reconfiguration Preparing For Reconfiguration VCX services are currently running stopping them now Stopping VCX Services Stopping vcx devdnldsvr OK Stopping vcx callp OK Stopping vcx tomcat OK Stopping vcx ums OK ...

Page 105: ...work interface The script prompts you with the existing IP address of eth0 on this server Enter the new IP address for eth0 Enter the MASTER SITE 1 IP Address 0 0 0 0 10 230 67 40 The term Master Site is an Oracle term In this sample script the term equates to the secondary server Authentication and Directory tasks are associated with the eth0 network interface Enter the IP address of eth0 on the ...

Page 106: ... active has been deactivated dropped The script now presents the network parameters and allows you to change them VCX Network Configuration Utility This wizard reconfigures networking and related services The current values of networking parameters will be displayed and you will be able to make any changes necessary Configuring Dynamic Host Configuration Protocol DHCP VCX servers can use DHCP for ...

Page 107: ...tate enabled IP Address 10 230 64 41 Network Subnet Mask 255 255 255 0 Default Gateway Address 10 230 64 254 In this sample script the IP address of eth1 is being changed from 10 230 64 31 to 10 230 64 41 Other parameters remain unchanged Configuring DNS Servers Enter DNS servers one at a time When done enter 0 0 0 0 to stop Primary DNS Server 10 25 10 31 Secondary DNS Server 10 26 10 31 Tertiary ...

Page 108: ...9 Indian Ocean 10 Pacific Ocean Enter continent 2 Please select a country from the following list 1 Antigua Barbuda 18 Ecuador 35 Panama 2 Anguilla 19 Grenada 36 Peru 3 Netherlands Antilles 20 French Guiana 37 St Pierre Miquelon 4 Argentina 21 Greenland 38 Puerto Rico 5 Aruba 22 Guadeloupe 39 Paraguay 6 Barbados 23 Guatemala 40 Suriname 7 Bolivia 24 Guyana 41 El Salvador 8 Brazil 25 Honduras 42 Tu...

Page 109: ...and County 12 Eastern Standard Time Indiana most locations 13 Eastern Time 14 Eastern Time Kentucky Louisville area 15 Eastern Time Kentucky Wayne County 16 Eastern Time Michigan most locations 17 Hawaii 18 Mountain Standard Time Arizona 19 Mountain Time 20 Mountain Time Navajo 21 Mountain Time south Idaho east Oregon 22 Pacific Time Enter zone 13 In this sample script the time zone remains unchan...

Page 110: ...nter no The script displays several status messages Please wait while the wizard completes Saving configuration Done Restarting network services to apply changes Shutting down interface eth0 OK Shutting down interface eth1 OK Shutting down loopback interface OK Setting network parameters OK Bringing up loopback interface OK Bringing up interface eth0 OK Bringing up interface eth1 OK Shutting down ...

Page 111: ...er a description for this site Site Three Enter the new site description for this server The Customer Name identifies the company using this VCX system Enter the customer name 3Com Customer Some VCX applications can use European date ordering Answer Y here to enable this Use European date order Y N N In order to support ad hoc conferences with more than 3 participants the Adhoc Conference Service ...

Page 112: ...c functions IP address of the secondary Auth Dir Service 10 230 67 40 Authentication and Directory tasks are associated with the eth0 network interface Enter the IP address of eth0 on the Secondary VCX Server as it will be defined after the reconfiguration The secondary IP Messaging Service is a backup for voice mail and other messaging services In some configurations a dedicated IP Messaging Serv...

Page 113: ...tallation Enable the Call Records Service Y N N Press the Enter or Return key to accept the default answer Y The Call Records Service is enabled on only the Primary VCX Server The script displays a summary of the global parameters that you have accepted or changed Summary of Global Parameters Site Name Testthree Customer Name 3Com Customer European Date Order N Enable Adhoc Conference Service Y SI...

Page 114: ... means no change Password Password confirm Cworks account password A blank entry means no change Password Password confirm This cworks password is used to log into the local cworks account on this server You may be prompted later in this script for another cworks password which is used for authentication between replicating databases The local cworks account password and the cworks database authen...

Page 115: ...ts to power a single server if the server has redundant power supplies with separate power connections Will multiple UPS s power this server N y A single UPS can power one or more VCX systems A UPS Master communicates directly with a UPS while a Slave communicates with the Master to get UPS status Only one Master system should monitor a given UPS If this VCX system is the only one connected to the...

Page 116: ...nd UPS write community string private The string you enter here must match the SNMP write community string configured on the UPS The VCX system polls the UPS at regular intervals to get status information A shorter interval makes the system more responsive to UPS status changes but consumes more network bandwidth The default value should work for most systems Polling Frequency seconds 30 The defau...

Page 117: ... unified voicemail system Say yes here if this system participates in Global Voicemail Is Global Voicemail enabled N y In a Global Voicemail system one site s IPMSG servers are designated as the Central Servers and coordinate the feature s operation Typically the Central Servers are at one of the regional sites Is this a Central Server for Global Voicemail N y If you answer N to indicate that this...

Page 118: ...tion Directory Server is needed User name for access to Auth Dir Server cworks In addition the password for the previously provided user name is required Specify the password to use when accessing the VCX Authentication Directory Server Password for access to Auth Dir Server cworks This cworks password is used for authentication when accessing the Authentication and Directory server database This ...

Page 119: ...account password on the remote server It is not necessarily the same as the password used to log in to the local cworks account configured earlier in this script Do you wish to change any of the Auth Dir Service parameters N Press the Enter or Return key to accept the default answer N and make no further changes If you want to make additional changes enter Y Configuring additional parameters for C...

Page 120: ...tion Trap Community String public IP Address of the second additional trap destination for this system Trap Destination The Write Community String specifies the community string to be used by a management station when sending write requests to this system Write Community String private Press the Enter or Return key to accept the existing write community string or enter a new string The Read Commun...

Page 121: ...mmon Agent parameters N Press the Enter or Return key to accept the default answer N and use the data that you have accepted or modified Enter Y to make additional changes VCX reconfiguration is now complete Before the information just entered is saved you have the option of reviewing and changing parameters for each VCX service at a detailed level This is not needed in most cases and is recommend...

Page 122: ...figuring acctxml OK Configuring bssxml OK Configuring ums sh OK Configuring tomcat OK Configuring vcxcentral OK Configuring vcxprov OK Configuring callp OK Configuring adhoc OK Configuring devdnldsvr OK Configured VCX components 12 configured Stopping VCX CommonAgent OK Starting VCX CommonAgent OK Stopping VCX Firewall OK Starting VCX Firewall OK Reconfiguration of components is complete VCX servi...

Page 123: ...rruptible Power Supplies UPS in your VCX system It describes how to add UPS support to an existing VCX system and how to monitor UPS status This chapter includes the following topics UPS Overview Adding UPS Support to an Existing VCX System Monitoring UPS Status VCX Server Response to Power Events ...

Page 124: ...nch office environment a UPS supports a VCX branch system which is typically installed on a single VCX server Normally a branch office does not have support staff on hand to attend to equipment and may be unoccupied for long periods of time nights weekends holidays Consequently if the office loses power it is important that the VCX system automatically operate on UPS power shut down when UPS power...

Page 125: ...g VCX system using the vcx ups setup command See Chapter 7 for information on the vcx reconfigure command While you can use this command to configure UPS support this command is more appropriate for a large scale reconfiguration where you want to modify networking parameters services or both on the server A UPS functions as an SNMP network device The UPS and a VCX system communicate using the SNMP...

Page 126: ... master slave designation is entirely independent of any role primary secondary or branch that a VCX server may have within the VCX environment As described in VCX Software Components VCX software can be installed on VCX servers in many different configurations When selecting a VCX server to act as a master follow these guidelines Choose a server that is running the VCX Authentication and Director...

Page 127: ... slave server the IP address of the master VCX server Adding Single UPS Device Support This section describes how to configure a VCX system supported by a single UPS Depending on your VCX configuration this requires one or two general steps If your VCX system includes a single VCX server configure that system as the master If your VCX system includes multiple VCX servers configure one server as th...

Page 128: ... the VCX system The threshold charge is expressed as a percentage of remaining battery power The default is 25 The range from 25 to 75 The following example shows the syntax required to initially configure a master VCX server vcx ups setup master Y monitormultipleups N upsipaddr 10 230 63 3 community private bcharge 33 When this command is executed UPS monitoring is enabled on the current VCX serv...

Page 129: ...r monitormultipleups N Enter N you must uppercase to indicate there is a single UPS servicing the entire VCX system upsserver IP Address of the master Enter the IP address assigned to eth0 of the VCX server acting as the master UPS monitor Use dotted decimal notation but do not enter leading zeros For example enter 10 230 63 3 not 010 230 063 003 3 Repeat steps 1 and 2 for all the other VCX server...

Page 130: ...with dual power supplies see Figure 2 Each power supply receives power from a separate UPS and if possible you should connect each UPS to different mains circuits The server remains fully operational when either UPS has mains power The server shuts down automatically only when both UPS devices are on battery and at or below the low battery threshold Figure 2 Two UPS Devices Powering a Single VCX S...

Page 131: ...em as slaves When configuring the master you identify the additional UPS device by specifying its IP address If your VCX system includes multiple UPS devices the servers do not have redundant power supplies and the primary and secondary servers of any configuration type are co located then you should assign the primary and secondary servers of a given configuration type to different UPS devices se...

Page 132: ...re a VCX server as the master in a multiple UPS system 1 Log in using the root account to the VCX server you want to designate as the master 2 Enter the following command vcx ups setup configuration_parameters You must concatenate the following vcx ups setup command configuration parameters responses are shown in bold master Y Enter Y you must uppercase to designate this server as the master monit...

Page 133: ...cond UPS to enable communication between the master VCX server and the UPS Typically the community string is private to allow Read or Write access bcharge UPS battery threshold charge Enter UPS battery threshold charge allowed before starting a shutdown of the VCX system The threshold charge is expressed as a percentage of remaining battery power The default is 25 The range from 25 to 75 The follo...

Page 134: ...m Configuring a Slave VCX Server To enable and configure a VCX server as a slave in a multiple UPS system 1 Log in using the root account to the VCX server you want to designate as a slave 2 Enter the following command vcx ups setup configuration_parameters You must concatenate the following vcx ups setup command configuration parameters responses are shown in bold master N Enter N you must upperc...

Page 135: ...e that you must include all the vcx ups setup command parameters even if you are only changing a single value Disabling UPS Monitoring on a VCX Server By default when you configure UPS support on a VCX server monitoring is enabled You can disable UPS monitoring on the master VCX server or on any slave servers Disabling UPS monitoring does not remove or modify the UPS configuration parameters enter...

Page 136: ...y the UPS you want to monitor For a single UPS system enter ups0 For a dual UPS system enter either ups0 or ups1 depending on the UPS you want to monitor The parameter master ip is optional Use this parameter to specify the IP address of a remote VCX UPS master server In addition to the required parameter ups0 or ups1 you must enter one of the parameters shown in Table 10 Table 10 vcx ups status C...

Page 137: ...return output not provided by the all parameter vcx ups status ups0 isconfig isconfig Y vcx ups status ups0 ismaster ismaster Y vcx ups status ups0 listslaves 10 230 188 7 ismaster Indicates whether or not Y or N this VCX server is configured as the master listslaves Lists the IP addresses of all VCX servers configured as slaves all Displays values for the following parameters upsstatus upsload up...

Page 138: ...ted by VCX software logged through syslog and reported as an SNMP trap Power Restoration Prior to Depleted Battery If power returns while a VCX server is operating on UPS battery power the VCX server Logs the event through syslog Generates an SNMP trap indicating return of power Resumes normal operation Depleted Battery Each UPS is configured with a battery threshold The threshold charge is expres...

Page 139: ...ceives power but in a halted state until the UPS battery is exhausted and the UPS turns itself off Power Restoration When power returns each VCX server Boots and begins to provide service Generates a trap indicating system startup Power Restoration During Shutdown If power is restored after a VCX server as begun final shutdown sequence but before the shutdown has completed the server completes the...

Page 140: ...140 CHAPTER 8 MANAGING UNINTERRUPTIBLE POWER SUPPLIES ...

Page 141: ...or provides call routing as well as other call services for the VCX IP Telephony Solution This chapter includes the following topics Call Processor Overview Configuration Methods Configuring Trusted Endpoints Configuring Accounting and Directory Services ...

Page 142: ...on Methods Call Processor configuration is normally completed during the installation of VCX system software However you may need to reconfigure the Call Processor after the installation for example to add additional trusted end points if you add a branch office There are three recommended methods of configuring the Call Processor Through the Enterprise Management Suite EMS EMS is an optional mana...

Page 143: ...ete trusted endpoints for a Call Processor Trusted endpoints do not need to have a port specified An IP address if present in the trusted endpoint list is trusted independently of the port To see the current list of trusted endpoints 1 Log onto the server hosting the Call Processor 2 Enter the following commands to start the remoteCli interface cd opt 3com VCX callprocessor remoteCli bin remoteCli...

Page 144: ...want to do with a trusted endpoint such as delete or add one In order to configure a row you always need to specify the index Once Call Processor restarted 1 active 2 not in service 3 not ready 4 add 5 create and wait 6 delete 1 index This is the trusted endpoint table s key and is a unique identifier of a row Once Call Processor restarted 1 through 128 1 TrustedAddress Indicates an endpoint to tr...

Page 145: ...all Processor using the remoteCLI interface 1 Log onto the server hosting the Call Processor 2 Navigate to the opt 3com VCX callprocessor remoteCli bin 3 Start the remoteCLI interface remoteCli callprocessor 4 At the prompt enter config CcTrusted RowStatus 6 index index ID TrustedAddress IP address of endpoint See Table 12 for descriptions and values of the configurable parameters 5 To exit the re...

Page 146: ...ur VCX system Adding Primary and Secondary Accounting Servers To add a primary Accounting server using the remoteCLI interface 1 Log onto the server hosting the primary Call Processor 2 Navigate to the opt 3com VCX callprocessor remoteCli bin 3 Start the remoteCLI interface remoteCli callprocessor 4 At the remoteCli prompt enter config acctc use false config accts pri 1 IpAddress IP address of pri...

Page 147: ... to the opt 3com VCX callprocessor remoteCli bin 3 Start the remoteCLI interface remoteCli callprocessor 4 At the remoteCli prompt enter config authc use false config auths pri 1 IpAddress IP address of primary Authentication and Directory server config auths pri 1 LocalIpAddress IP address of call processor config authc use true 5 The interface lists the IP address of the new Authentication and D...

Page 148: ...ths pri 2 IpAddress IP address of secondary authentication server config auths pri 2 LocalIpAddress IP address of call processor config authc use true 5 The interface lists the IP address of the new Authentication and Directory Server 6 To exit the remoteCLI interface enter exit ...

Page 149: ...COMMAND LINE INTERFACE This chapter describes how to add modify and delete user accounts using the user MAC command This chapter includes the following topics Command Overview Using Single User Mode Using Batch Mode Files and Directories ...

Page 150: ...ble 13 User Account Attributes Attribute Description User Name Mandatory Specifies the username associated with the account The specified name must be unique1 This value is also required to change account attributes or to delete the account Password Optional Specifies the password the user enters to access the VCX User Provisioning interface If omitted uses the default password changeme Title Opti...

Page 151: ...ional Specifies the site identifier assigned to the location hosting the account This ID is specified during VCX software installation procedure Host Name Optional Specifies the IP address in dotted decimal notation of an Authentication and Directory server Phone Profile Optional Specifies the phone profile to be used by the account All phones must be assigned a phone profile If no profile is spec...

Page 152: ...in single user mode to add modify or delete one user account at a time In single user mode the user MAC command can take the parameters shown in Table 14 Table 14 user MAC Command Parameters Parameter full name abbreviation Takes Value Mode Parameter Type Description help or h No Both None Returns text describing command usage csv Yes Batch CSV file Indicates command input is a comma separated val...

Page 153: ...r s first name middle or mi Yes Single String The value specifies the user s middle name last or l Yes Single String The value specifies the user s last name email or e Yes Single String The value specifies the user s e mail address street1 Yes Single String The value specifies the user s street address street2 Yes Single String The value specifies the second part of the user s address for example...

Page 154: ...create the account with the default phone profile omit this field mac addr or mac a Yes Single String The value specifies the Media Access Control MAC address in hex format of a phone new mac addr or new m Yes Single String Used with the mod parameter to change the MAC address assigned to a phone extension to the specified value mac lock or mac l Yes Single int 0 1 When set to 1 true locks the pho...

Page 155: ...hone parameter specifying the existing phone extension and the new phone parameter specifying the new phone extension The existing extension is required because the user may have more than one assigned phone extension If you want to change the account s username you enter the user MAC command with modify plus the uname parameter and the new uname parameter You cannot use the user MAC command with ...

Page 156: ...ite id Site Id remote Host IP Addr Single User Mode Examples This section provides an example illustrating the user MAC command syntax required to add modify and delete a user account in single user mode The following example adds a user account for jjohnson and assigns the user the phone extension 2314323 The extension is locked to the phone with the specified MAC address the user cannot change t...

Page 157: ...D of a user account The site ID site id is required for a modify transaction if the account to be changed is located at a branch site If the account is located on another region the modify transaction must specify a site ID site id and remote IP address remote A CSV file can contain add transactions only Batch mode processing can run in either stop mode the default or non stop mode the user MAC co...

Page 158: ...add modify or delete user accounts 3Com Corporation recommends that an XML file contain no more than 5000 transactions While this is not a hard limit exceeding 5000 transactions may cause performance issues Use the following syntax to specify an XML file as input to the user MAC command and get the return code displayed on your console user MAC xml InputFileName xml non stop echo RET The XML suppo...

Page 159: ...A ELEMENT country PCDATA ELEMENT zip PCDATA ELEMENT site PCDATA ELEMENT remote PCDATA ELEMENT pprofile PCDATA ELEMENT macaddr PCDATA ELEMENT newmacaddr PCDATA ELEMENT maclock PCDATA Sample XML Input File Format The following sample XML input file is based on the DTD file shown in the previous section XML Input File DTD The sample shows one add transaction one modify transaction and one delete tran...

Page 160: ... transaction type mod uname value uname whatever fields are to be changed newUname value newUname newPhone value newPhone transaction transaction type delete uname value uname transaction user MAC transactions XML Default Values Default values are supplied to user MAC command processing in a default XML file user MAC defaults xml The structure of this file is specified in the following DTD file us...

Page 161: ...to user MAC command processing in a default XML file named user MAC defaults xml which specifies the following defaults xml version 1 0 encoding utf 8 DOCTYPE user_MAC_defaults user_MAC_defaults BLANK indicates that the field will be empty UNAME indicates that the field will contain the user name passed in to the transaction password changeme password phonepass 12345 phonepass title BLANK title fi...

Page 162: ...he phone profile pprofile parameter value is the name string associated with a particular phone profile When this parameter is set to blank in both the input XML and the default XML file VCX software creates a default phone profile This is not recommended Ask your VCX administrator for the name of the default phone profile You can edit user MAC defaults xml to change a default parameter value For ...

Page 163: ...lopez bcd com 231 E Main St Denver CO USA 30610 reg2 10 231 22 40 global Files and Directories Table 15 lists the files and their locations associated with the user MAC command line script Table 15 File Locations Directory File Description opt 3com VCX vcxdata bin user MAC Runs the command line user account management script opt 3com VCX vcxdata conf user MAC transactions dtd This DTD file specifi...

Page 164: ...TML to improve readability of the default XML opt 3com components vcxdata version bin log Contains various log files The log files generated by execution of the user MAC command include user MAC and a timestamp in the filename for example user MAC_Thu_May_4_ 08 45 20_2006 log Table 15 File Locations Directory File Description ...

Page 165: ... Upgrading a Multi Site System With No Branch Offices Upgrading a Multi Site VCX System with Branch Offices During a VCX system upgrade or downgrade users cannot make calls within the system However users may be able to make emergency calls or make calls to and receive calls from destinations outside of the VCX system that is the PSTN This capability depends on the availability configuration and c...

Page 166: ... by following these steps 1 Log onto the VCX system as root 2 Enter the following commands cd opt 3com ls l This command returns a list all of the installed releases and indicates the running VCX version The running VCX version is preceded by a symbolic link icon lrwxrwxrwx 1 root root 21 Apr 26 09 13 VCX opt 3com VCX 7 0 7c drwxr xr x 10 root root 4096 Mar 10 07 13 VCX 7 0 6c In this example the ...

Page 167: ...f VCX software This requirement has the following implications You cannot upgrade or downgrade one component in a VCX system and not upgrade or downgrade the other system components If you add a server to an existing VCX system for example a branch office the VCX components on the new server must be installed with the same version of the VCX software as the existing components CAUTION 3Com Corpora...

Page 168: ...L If replication errors need to be cleared Enter deleteReplicationErrors CAUTION Do not attempt an upgrade if there are replication errors that cannot be deleted CAUTION If you are upgrading a multi site VCX system you must ensure that phone extensions are unique throughout the system In a VCX v7 0 multi site system it was possible to configure duplicate extensions in different regions This includ...

Page 169: ...so configured in the phone profile to which a phone is assigned If the phone profile is modified and reapplied the profile values will override the phone settings Refer to the VCX Administration Guide for more information on phone profiles and configuration options Configuration Upgrade Options Depending on your configuration you may need to upgrade the following VCX software components and config...

Page 170: ...ftware Supported on multi site systems that include servers at regional offices with or without branch offices Call Records server software Supported on multi site systems installed on a single server for regional offices with or without branch offices Authentication and Directory server software Supported on multi site systems that include servers at regional offices with or without branch office...

Page 171: ...ns IP Telephony server software and IP Messaging server software In a four server configuration one pair of servers runs IP Telephony server software the second pair of servers runs IP Messaging server software Follow the procedure in this section to upgrade the two server configuration at a single site from VCX version 7 0 software to VCX version 7 1 software Before you begin the upgrade procedur...

Page 172: ... IP address of the Master Site This is typically the IP address of the secondary VCX server e The Do you want to continue with the above settings n y prompt appears Enter y to continue The script executes 4 Enter the following command to exit the cworks account and return to the root account exit 5 Stop IP Messaging first on the primary VCX server and then on the secondary VCX server by entering t...

Page 173: ...es The last two messages are Installation Completed Successfully VCX version 7 1 xc is now available 2 Switch to the new software version by entering the following command vcx switchversion 7 1 xc The system displays several status messages and provides prompts that allow you enable Adhoc Conferencing UPS Monitoring and Global Voicemail Integration 3 The Adhoc Conferencing prompt appears In order ...

Page 174: ... at a region and one or more branches the Global Voicemail capability allows these systems to act as a single unified voicemail system Say yes here if this system participates in Global Voicemail Is Global Voicemail enabled N a If you have installed and configured through the IP Messaging administrator configuration interface a pair of Global Voicemail Central Servers GVCS to enable global voicema...

Page 175: ...n and Directory service by entering the following commands cd opt 3com VCX scripts rc3 d S20vcxdata stop Upgrading the Secondary VCX Server Follow the steps in this section to upgrade the secondary VCX server 1 To start the upgrade process enter these commands on the secondary VCX server cd opt installtemp tar xvf vcx all 7 1 xc tar cd upgrade 7 1 xc install upgrade The system may prompt you to co...

Page 176: ...leted during a long power outage To use this feature you must have a compatible UPS installed and configured in accordance with the VCX documentation Enable UPS monitoring N 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 information on the subse...

Page 177: ... Enter the VCX Site Identification i e Site Id prompt appears Enter site ID configured for this system For single site systems the site ID is identical for both the primary VCX server and the secondary VCX server b The Enter the Number of MASTER SITEs other than the MASTER DEFINITION SITE 1 prompt appears Press Enter to accept the default c The Enter the MASTER DEFINITION SITE IP Address IP addres...

Page 178: ...omplete g You can check replication status by entering the following command checkReplication 3 When the replication is complete and status is reported as NORMAL enter the following command to exit the cworks account and return to the root account exit 4 Start the Authentication and Directory service on the primary VCX server and the secondary VCX server by entering the following commands cd opt 3...

Page 179: ...ng these commands cd opt 3com VCX vcxdata bin su cworks dropReplication The drop replication script starts Follow these steps a The Enter the VCX Site Identification i e Site Id prompt appears Enter site ID configured for this system For single site systems the site ID is identical for both the primary IP Telephony server and the secondary IP Telephony server b The Enter the Number of MASTER SITEs...

Page 180: ...e x indicates the version of VCX software for example vcx all 7 1 3c tar that will replace the current version The letter c is always appended to the version number 7 Obtain a copy of the vcx ipmsg 7 1 xc tar software upgrade file and place it in the opt installtemp directory on the primary IP Messaging server and on the secondary IP Messaging server Next execute the following steps in the order l...

Page 181: ...ges and provides prompts that allow you enable Adhoc Conferencing and UPS Monitoring 3 The Adhoc Conferencing prompt appears In order to support ad hoc conferences with more than 3 participants the Adhoc Conference Service is used This service should be enabled on this server unless another server dedicated to Adhoc Conferencing will be used instead If available a separate server typically provide...

Page 182: ...e 7 1 xc 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 before proceeding Example Output opt 3com VCX opt 3com VCX 7 1 xc 7 Stop the Authentication and Directory service by entering the following commands cd opt 3com VCX scripts rc3 d S20vcxdata stop Upgrading the Primary IP Me...

Page 183: ...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 information on the subsequent UPS configuration prompts 4 The Global Voicemail Integration prompt appears When multiple IP Messaging systems are in use for example at a region and one or more branches the Global Voicemail c...

Page 184: ...ic link VCX should point to the new version of the VCX software 7 1 xc 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 before proceeding Example Output opt 3com VCX opt 3com VCX 7 1 xc Upgrading the Secondary IP Telephony Server Follow the steps in this section to upgrade the se...

Page 185: ...an be used with VCX systems to avoid disruption due to a power outage VCX provides a UPS monitoring service which tracks the UPS s 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 installed and configured in accordance with the VCX documentation Enable UPS monitoring N If you do not have a UPS install...

Page 186: ...ting system version will be installed and indicates 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 Installation Completed Successfully VCX version 7 1 xc is now available 2 Switch to the new software version by entering the following command vcx switchversion 7 1 xc The system displays seve...

Page 187: ...ion wait a few minutes and reenter the command This could take several minutes and it is important the link pointer is correct before proceeding Example Output opt 3com VCX opt 3com VCX 7 1 xc Set Up Database Replication Follow the steps in this section to set up database replication 1 Stop the Tomcat process first on the primary IP Telephony server and then on the secondary IP Telephony server by...

Page 188: ...tinue The script executes During script execution messages appear describing the replication setup Messages also appear stating that firewall setup should allow communication between the primary IP Telephony server and the secondary IP Telephony server These messages are a reminder firewall setup was performed during VCX software installation f The Have you executed the ABOVE mentioned VCX FIREWAL...

Page 189: ...all records from each of the regional offices To upgrade the primary VCX server and the secondary VCX server follow the instructions in Upgrading a Single Site System With Two Servers earlier in this appendix To upgrade the Call Records server see the following section Upgrading the Call Records Server Upgrading the Call Records Server To upgrade the Call Records server 1 Log in to the Call Record...

Page 190: ...multi caller up to 6 callers conferencing server enter y If not enter n 7 The UPS Monitoring prompt appears 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 which tracks the UPS s status and performs a safe shutdown when the its battery is depleted during a long power outage To use this feature you must...

Page 191: ...ice runs the IP Telephony server only In this case the regional office provides messaging services for users at each branch office In version 7 1 multi site VCX systems you can configure branch and regional sites to use Global Voicemail Integration Each location must be running IP Messaging services which means that in a multi site system configured to use global messaging you cannot enable Global...

Page 192: ... multi site VCX system configuration upgrade the components in the following order If you plan to enable Global Voicemail Integration install IP Messaging software on a pair of Global Voicemail Central Servers and then set up the GVCS through the IP Messaging administrator configuration interface before enabling global voicemail integration on regional and branch office IP Messaging servers Upgrad...

Page 193: ... Region 1 b The Enter the Number of MASTER SITEs other than the MASTER DEFINITION SITE prompt appears Enter the number of Master sites To determine the number of Master sites associated with this server use the listVcxdata command See Manually Configuring Replication for an IP Telephony Server or IP Telephony and Messaging Server for more information In this example there is one Master site Region...

Page 194: ...ou to confirm that a new operating system version will be installed and indicates 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 Installation Completed Successfully VCX version 7 1 xc is now available 8 Change to the new software version by entering this command vcx switchversion 7 1 xc The...

Page 195: ...s and reenter the command This could take several minutes and it is important the link pointer is correct before proceeding Example Output opt 3com VCX opt 3com VCX 7 1 xc 11 Enter the following commands to stop the Authentication and Directory server on Region 1 cd opt 3com VCX scripts rc3 d S20vcxdata stop To upgrade the Authentication and Directory server in Region 2 1 Log in as root to the Cal...

Page 196: ...nd Directory server in Region 1 If there are more than one Master Sites this question repeats until the number of master sites specified in step b is reached e The Do you want to continue with the above settings n y prompt appears Enter y to continue The script executes 5 Enter the following command to exit the cworks account and return to the root account exit 6 Obtain a copy of the vcx dataserve...

Page 197: ...e 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 information on the subsequent UPS configuration prompts 10 After completing the UPS Monitoring prompts the server reboots When the reboot process has been completed the system starts VCX 7 1 x services After the sys...

Page 198: ...hentication and Directory server in Region 2 upgrade the replica of the Region 1 database by entering the following commands su cworks cd opt 3com VCX vcxdata bin upgradeVcxdata The Enter the VCX Site Identification i e Site Id prompt appears 4 Enter the Site ID for Region 1 5 Set up database replication on Region 1 by entering the following commands you should still be logged in to the Authentica...

Page 199: ...y to continue The script executes When the replication is complete Multi Master Replication Status is reported as NORMAL Do not continue to the next step on this server until the replication is complete Note that replication can take approximately 20 minutes to complete f You can check the replication by entering the following command checkReplication 6 Set up database replication on Region 2 by e...

Page 200: ...ion is complete Multi Master Replication Status is reported as NORMAL Do not continue to the next step on this server until the replication is complete Note that replication can take approximately 20 minutes to complete f You can check the replication by entering the following command checkReplication 7 Once replication is complete and status is NORMAL on Region 1 and Region 2 start the Authentica...

Page 201: ...branch office IP Messaging servers Refer to the IP Messaging Module Operations and System Administration Guide for more information and for configuration options This section assumes that a pair of Global Voicemail Central Servers are available IP Messaging servers are typically configured in pairs with one server acting as the primary and the other acting as the secondary The primary IP Messaging...

Page 202: ...own when the its battery is depleted during a long power outage To use this feature you must have a compatible UPS installed and configured in accordance with the VCX documentation Enable UPS monitoring N 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 Monitori...

Page 203: ...the system has completed the restart process 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 xc 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 before proceeding Example...

Page 204: ...ion Completed Successfully VCX version 7 1 xc is now available 4 Switch to the new software version by entering the following command vcx switchversion 7 1 xc The system displays several status messages and provides prompts that allow you enable Adhoc Conferencing and UPS Monitoring 5 The Adhoc Conferencing prompt appears In order to support ad hoc conferences with more than 3 participants the Adh...

Page 205: ...he 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 xc 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 before proceeding Example Output opt 3com VCX opt 3com VCX 7 1 xc 8 Upgrade the sec...

Page 206: ... a power outage VCX provides a UPS monitoring service which tracks the UPS s 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 installed and configured in accordance with the VCX documentation Enable UPS monitoring N If you do not have a UPS installed and enter n or press Enter the remaining UPS config...

Page 207: ...des IP Messaging services you can enable Global Voicemail Integration on the branch A branch that implements global messaging runs IP Telephony server software The IP Messaging server software running on a regional server provides messaging services for the branch Because this type of branch office receives its IP Messaging services from a regional IP Messaging server you cannot enable Global Voic...

Page 208: ...able Adhoc Conferencing UPS Monitoring and Global Voicemail Integration 5 The Adhoc Conferencing prompt appears In order to support ad hoc conferences with more than 3 participants the Adhoc Conference Service is used This service should be enabled on this server unless another server dedicated to Adhoc Conferencing will be used instead If available a separate server typically provides greater cap...

Page 209: ...s prompt and go to step b If not enter n and go to step 8 b The upgrade script asks if this server as a Global Voicemail Central Server In a Global Voicemail system one site s IPMSG servers are designated as the Central Servers and coordinate the 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 bee...

Page 210: ...nds cd opt installtemp tar xvf vcx softswitch 7 1 xc tar cd upgrade 7 1 xc install upgrade The system may prompt you to confirm that a new operating system version will be installed and indicates 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 Installation Completed Successfully VCX version ...

Page 211: ...information on the subsequent UPS configuration prompts 7 After completing the Adhoc Conferencing and UPS Monitoring prompts the server reboots When the reboot process has been completed the system starts VCX 7 1 x services 8 After the system has completed the restart process verify that the upgrade has occurred by entering this command ls l opt 3com VCX The symbolic link VCX should point to the n...

Page 212: ...eparate power connections Will multiple UPS s power this server N If this server has redundant power supplies each with its own UPS enter y If this server uses a single UPS enter n or press Enter 2 The upgrade script asks if you want to configure this server as the master A single UPS can power one or more VCX systems A UPS Master communicates directly with a UPS while a Slave communicates with th...

Page 213: ...ed yes in step 1 indicating multiple UPS devices the upgrade script prompts you for the IP address of the second UPS Enter the IP address assigned to the second UPS s management card or Ethernet interface Note The UPS must already be configured with this address Second UPS IP address 6 The upgrade script prompts you for the SNMP write community string assigned to the second UPS The SNMP write comm...

Page 214: ...efault 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 accept the current configuration Enter y if you want to change one or more parameter values ...

Page 215: ...rvers Upgrading a Multi Site System With No Branch Offices Upgrading a Multi Site VCX System with Branch Offices During a VCX system upgrade or downgrade users cannot make calls within the system However users may be able to make emergency calls or make calls to and receive calls from destinations outside of the VCX system that is the PSTN This capability depends on the availability configuration ...

Page 216: ...em by following these steps 1 Log onto the VCX system as root 2 Enter the following commands cd opt 3com ls l This command returns a list all of the installed releases and indicates the running VCX version The running VCX version is preceded by a symbolic link icon lrwxrwxrwx 1 root root 21 May 12 09 13 VCX opt 3com VCX 7 1 1c drwxr xr x 10 root root 4096 May 10 07 13 VCX 7 1 0c In this example th...

Page 217: ...not upgrade or downgrade one component in a VCX system and not upgrade or downgrade the other system components If you add a server to an existing VCX system for example a branch office the VCX components on the new server must be installed with the same version of the VCX software as the existing components CAUTION 3Com Corporation strongly recommends that you perform backups of your VCX system o...

Page 218: ...ion and Directory services database Log in using the cworks account Enter cd opt 3com VCX vcxdata bin Enter checkReplication The returned status should be NORMAL If replication errors need to be cleared Enter deleteReplicationErrors CAUTION Do not attempt an upgrade if there are replication errors that cannot be deleted Depending on your configuration you may need to upgrade the following VCX soft...

Page 219: ...formation and for configuration options Call server software Supported on multi site systems that include servers at regional offices with or without branch offices Call Records server software Supported on multi site systems installed on a single server for regional offices with or without branch offices Authentication and Directory server software Supported on multi site systems that include ser...

Page 220: ...70tomcat stop 3 Ensure that database replication has no errors see Preliminary Steps and then drop replication on the primary VCX server by entering these commands cd opt 3com VCX vcxdata bin su cworks dropReplication The drop replication script starts Follow these steps a The Enter the VCX Site Identification i e Site Id prompt appears Enter site ID configured for this system For single site syst...

Page 221: ...able y indicates the version of VCX software for example vcx all 7 0 3c tar that will replace the current version The letter c is always appended to the version number Next execute the following steps in the order listed Upgrade the primary VCX server See Upgrading the Primary VCX Server Upgrade the secondary VCX server See Upgrading the Secondary VCX Server Set up database replication on the prim...

Page 222: ...the VCX software 7 1 yc 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 before proceeding Example Output opt 3com VCX opt 3com VCX 7 1 yc 4 Stop the Authentication and Directory service by entering the following commands cd opt 3com VCX scripts rc3 d S20vcxdata stop Upgrading th...

Page 223: ... 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 before proceeding Example Output opt 3com VCX opt 3com VCX 7 1 yc 4 Stop the Authentication 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...

Page 224: ... to continue with the above settings n y prompt appears Enter y to continue The script executes During script execution messages appear describing the replication setup Messages also appear stating that firewall setup should allow communication between the primary VCX server and the secondary VCX server These messages are a reminder firewall setup was performed during VCX software installation f T...

Page 225: ...oftware In a four server configuration one pair of servers runs IP Telephony server software the second pair of servers runs IP Messaging server software Follow the procedures in this section to upgrade the four server configuration at a single site from one version of VCX software 7 1 x to a later version 7 1 y Before you begin the upgrade procedures on the four servers perform these steps 1 Log ...

Page 226: ...ver d The Enter the MASTER SITE 1 IP Address 0 0 0 0 prompt appears Enter the IP address of the Master Site This is typically the IP address of eth0 on the secondary VCX server e The Do you want to continue with the above settings n y prompt appears Enter y to continue The script executes 4 Enter the following command to exit the cworks account and return to the root account exit 5 Stop IP Messagi...

Page 227: ...ee Set Up Database Replication Upgrading the Primary IP Telephony Server Follow the steps in this section to upgrade the primary IP Telephony server 1 To start the upgrade process enter these commands on the primary IP Telephony server cd opt installtemp tar xvf vcx softswitch 7 1 yc tar cd upgrade 7 1 yc install upgrade The system may prompt you to confirm that a new operating system version will...

Page 228: ...ion to upgrade the primary IP Messaging server 1 To start the upgrade process enter these commands on the primary IP Messaging server cd opt installtemp tar xvf vcx ipmsg 7 1 yc tar cd upgrade 7 1 yc install upgrade The system may prompt you to confirm that a new operating system version will be installed and indicates which disk partition will be used after the upgrade If you see such a prompt an...

Page 229: ...rating system version will be installed and indicates 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 Installation Completed Successfully VCX version 7 1 yc is now available 2 Switch to the new software version by entering the following command vcx switchversion 7 1 yc The system displays se...

Page 230: ...upgrade If you see such a prompt answer y The system displays several status messages The last two messages are Installation Completed Successfully VCX version 7 1 yc is now available 2 Switch to the new software version by entering the following command vcx switchversion 7 1 yc The system displays several status messages and then reboots After the the reboot process has been completed the system ...

Page 231: ...y IP Telephony server and the secondary IP Telephony server b The Enter the Number of MASTER SITEs other than the MASTER DEFINITION SITE 1 prompt 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 Master Definition site or press Enter if the displayed address is correct This is typically the IP address o...

Page 232: ...nd Directory service on the primary IP Telephony server and the secondary IP Telephony server by entering the following commands cd opt 3com VCX scripts rc3 d S20vcxdata start 5 Start the Tomcat process on the primary IP Telephony server and the secondary IP Telephony server by entering the following command S70tomcat start Upgrading a Multi Site System With No Branch Offices Some VCX multi site s...

Page 233: ...upgrade If you see such a prompt answer y The system displays several status messages The last two messages are Installation Completed Successfully VCX version 7 1 yc is now available 5 Change to the new software version by entering this command vcx switchversion 7 1 yc The system displays several status messages and then reboots When the reboot process has been completed the system starts VCX 7 1...

Page 234: ...configured to use global messaging you cannot enable Global Voicemail Integration on a branch You can however enable Global Voicemail Integration on the region providing IP Messaging services to the branch This service is provided by a pair of Global Voicemail Central Servers GVCS to enable global voicemail integration on an entire IP Messaging system A GVCS coordinates mailbox creation and mailbo...

Page 235: ...le Global Voicemail Integration install IP Messaging software on a pair of Global Voicemail Central Servers and then set up the GVCS through the IP Messaging administrator configuration interface before enabling global voicemail integration on regional and branch office IP Messaging servers Upgrade the replicated Authentication and Directory servers in each regional office Upgrade the IP Messaging...

Page 236: ...appears Enter the number of Master sites To determine the number of Master sites associated with this server use the listVcxdata command See Manually Configuring Replication for an IP Telephony Server or IP Telephony and Messaging Server for more information In this example there is one Master site Region 2 c The Enter the MASTER DEFINITION SITE IP Address IP address prompt appears Enter the IP ad...

Page 237: ... system displays several status messages The last two messages are Installation Completed Successfully VCX version 7 1 yc is now available 8 Change to the new software version by entering this command vcx switchversion 7 1 yc The system displays several status messages and then reboots When the reboot process has been completed the system starts VCX 7 1 yc Authentication and Directory service 9 Af...

Page 238: ...appears Enter the number of Master sites To determine the number of Master sites associated with this server use the listVcxdata command See Manually Configuring Replication for an IP Telephony Server or IP Telephony and Messaging Server for more information In this example there is one Master site Region 1 c The Enter the MASTER DEFINITION SITE IP Address IP address prompt appears Enter the IP ad...

Page 239: ... The system displays several status messages The last two messages are Installation Completed Successfully VCX version 7 1 yc is now available 8 Change to the new software version by entering this command vcx switchversion 7 1 yc The system displays several status messages and then reboots When the reboot process has been completed the system starts VCX 7 1 yc Authentication and Directory service ...

Page 240: ...uthentication and Directory server in Region 2 upgrade the Region 1 database by entering the following commands su cworks cd opt 3com VCX vcxdata bin upgradeVcxdata The Enter the VCX Site Identification i e Site Id prompt appears 4 Enter the Site ID for Region 1 5 Set up database replication on Region 1 by entering the following commands you should still be logged in to the Authentication and Dire...

Page 241: ...y to continue The script executes When the replication is complete Multi Master Replication Status is reported as NORMAL Do not continue to the next step on this server until the replication is complete Note that replication can take approximately 20 minutes to complete f You can check the replication by entering the following command checkReplication 6 Set up database replication on Region 2 by e...

Page 242: ...ation is complete Multi Master Replication Status is reported as NORMAL Do not continue to the next step on this server until the replication is complete Note that replication can take approximately 20 minutes to complete f You can check the replication by entering the following command checkReplication 7 Once replication is complete and status is NORMAL on Region 1 and Region 2 start the Authenti...

Page 243: ...vers Refer to the IP Messaging Module Operations and System Administration Guide for more information and for configuration options Once you have installed and configured a GVCS you can add existing IP Messaging servers to the Global Voicemail Integration system by running the vcx reconfigure command on each server see Chapter 7 IP Messaging servers are typically configured in pairs with one serve...

Page 244: ...ssaging services c After the system has completed the restart process 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 yc 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 ...

Page 245: ...be used after the upgrade If you see such a prompt answer y The system displays several status messages The last two messages are Installation Completed Successfully VCX version 7 1 yc is now available b Switch to the new software version by entering the following command vcx switchversion 7 1 yc The system displays several status messages and then reboots After the reboot process has been complet...

Page 246: ... to confirm that a new operating system version will be installed and indicates 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 Installation Completed Successfully VCX version 7 1 yc is now available 4 Change to the new software version by entering this command vcx switchversion 7 1 yc The s...

Page 247: ... IP Messaging server software running on a regional server provides messaging services for the branch Because this type of branch office receives its IP Messaging services from a regional IP Messaging server you cannot enable Global Voicemail Integration on the branch In this case you must enable Global Voicemail Integration on the regional server You can add existing IP Messaging servers to the G...

Page 248: ...veral status messages and then reboots After the the reboot process has been completed the system starts VCX 7 1 y services 5 After the system has completed the restart process 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 yc If the link does not point to the new version wait a few minut...

Page 249: ...ully VCX version 7 1 yc is now available 4 Switch to the new software version by entering the following command vcx switchversion 7 1 yc The system displays several status messages and then reboots After the the reboot process has been completed the system starts VCX 7 1 y services 5 After the system has completed the restart process verify that the upgrade has occurred by entering this command ls...

Page 250: ...250 APPENDIX B UPGRADING VCX SERVER SOFTWARE FROM V7 1 X TO V7 1 Y ...

Page 251: ...Upgrading a Multi Site System With No Branch Offices Upgrading a Multi Site VCX System with Branch Offices During a VCX system upgrade or downgrade users cannot make calls within the system However users may be able to make emergency calls or make calls to and receive calls from destinations outside of the VCX system that is the PSTN This capability depends on the availability configuration and ca...

Page 252: ...urns a list all of the installed releases and indicates the running VCX version The running VCX version is preceded by a symbolic link icon lrwxrwxrwx 1 root root 21 Oct 13 09 13 VCX opt 3com VCX 6 0 1c drwxr xr x 10 root root 4096 Oct 10 09 13 VCX 6 0 0c In this example the link points to version 6 0 1c The other listed release 6 0 0c is installed but not running Overview of a 6 0 to 7 0 Upgrade ...

Page 253: ...saging Module Operations and System Administration Guide for information on backing up voicemail and other IP Messaging data In addition BEFORE you upgrade your VCX system to a new release perform these backups again If the upgrade fails and you must downgrade you can restore data from these backups as part of the downgrade procedure Prior to performing any upgrade you should check the following C...

Page 254: ...btain and install a license key file for each VCX server before you can upgrade from a previous release See License Keys for more information Depending on your configuration you may need to upgrade the following VCX software components and configurations IP Telephony and IP Messaging server software Supported on Single site systems with two servers Multi site systems configured on regional offices...

Page 255: ...ched console The upgrade procedure includes a reboot of each upgraded server If you perform an upgrade remotely using a secure shell client for example you will be logged out when the reboot occurs When you log back in it may not be apparent that the upgrade has completed If you enter commands before the upgrade has finished the upgrade will fail Post Upgrade Requirements After an upgrade to VCX v...

Page 256: ...se lowercase y the script will not preserve your changes 5 Repeat steps 1 through 4 on each server running the Call Processor service License Keys You must obtain and install a license key file for every server in a VCX single site or multi site system The key enables the use of the software installed on each VCX type of server CAUTION After installing a VCX server with version 7 0 software you mu...

Page 257: ...y filename would be SNAm Fro7 vrJa YKhH H8az db7Q activation key Save the license key file in the opt installtemp directory 3Com strongly recommends that you save copies of your license key files in a separate safe location If any VCX server experiences a disk or other failure that requires reinstallation of the VCX software the license key file must be available for that process Installing a Lice...

Page 258: ...le site VCX systems can have either two servers or four servers In a two server configuration each server runs IP Telephony server software and IP Messaging server software In a four server configuration one pair of servers runs IP Telephony server software the second pair of servers runs IP Messaging server software Follow the procedure in this section to upgrade the two server configuration at a...

Page 259: ...ress of the Master Definition site or press 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 0 prompt appears Enter the IP address of the Master Site This is typically the IP address of the secondary VCX server e The Do you want to continue with the above settings n y prompt appears Enter y to contin...

Page 260: ... 7 0 xc tar cd upgrade 7 0 xc install upgrade The system may prompt you to confirm that a new operating system version will be installed and indicates 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 Installation Completed Successfully VCX version 7 0 xc is now available 2 Obtain a license ke...

Page 261: ...s init d vcxums status 8 If the returned status is running stop IP Messaging by entering the following commands exit cd opt 3com VCX scripts rc3 d S60ums stop Upgrading the Secondary VCX Server Follow the steps in this section to upgrade the secondary VCX server 1 To start the upgrade process enter these commands on the secondary VCX server cd opt installtemp tar xvf vcx all 7 0 xc tar cd upgrade ...

Page 262: ...opt 3com VCX 7 0 xc 6 Stop the Authentication 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 Tomcat process first on the primary VCX server and then on the secondary VCX server by entering these commands cd opt 3com VCX scripts rc3 d S70tomc...

Page 263: ...p Messages also appear stating that firewall setup should allow communication between the primary VCX server and the secondary VCX server These messages are a reminder firewall setup was performed during VCX software installation f The Have you executed the ABOVE mentioned VCX FIREWALL steps y n prompt appears Enter y to continue The script executes When the replication is complete Multi Master Re...

Page 264: ... one pair of servers runs IP Telephony server software the second pair of servers runs IP Messaging server software Follow the procedures in this section to upgrade the four server configuration at a single site from VCX software 6 0 to version 7 0 All upgrade commands are executed locally at the console Before you begin the upgrade procedures on the four servers perform these steps 1 Log in as ro...

Page 265: ...y the IP address of the secondary IP Telephony server e The Do you want to continue with the above settings n y prompt appears Enter y to continue The script executes 4 Enter the following command to exit the cworks account and return to the root account exit 5 Stop IP Messaging first on the primary IP Messaging server and then on the secondary IP Messaging server by entering these commands cd opt...

Page 266: ...tart the upgrade process enter these commands on the primary IP Telephony server cd opt installtemp tar xvf vcx softswitch 7 0 xc tar cd upgrade 7 0 xc install upgrade The system may prompt you to confirm that a new operating system version will be installed and indicates which disk partition will be used after the upgrade If you see such a prompt answer y The system displays several status messag...

Page 267: ... Messaging server cd opt installtemp tar xvf vcx ipmsg 7 0 xc tar cd upgrade 7 0 xc install upgrade The system may prompt you to confirm that a new operating system version will be installed and indicates 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 Installation Completed Successfully VCX...

Page 268: ...following prompts appear Hostname of IPMSG client 1 Client Hostname b Enter the hostname of the first IP Messaging client system You can identify 20 IP Messaging client systems The client configuration prompts appear until you reach the maximum 20 entries or until you press Enter without entering a IP address When you finish identifying IP Messaging client systems the following prompt appears Do y...

Page 269: ...y Server Follow the steps in this section to upgrade the secondary IP Telephony server 1 To start the upgrade process enter these commands on the secondary IP Telephony server cd opt installtemp tar xvf vcx softswitch 7 0 xc tar cd upgrade 7 0 xc install upgrade The system may prompt you to confirm that a new operating system version will be installed and indicates which disk partition will be use...

Page 270: ...dary IP Messaging Server Follow the steps in this section to upgrade the secondary IP Messaging server 1 To start the upgrade process enter these commands on the secondary IP Messaging server cd opt installtemp tar xvf vcx ipmsg 7 0 xc tar cd upgrade 7 0 xc install upgrade The system may prompt you to confirm that a new operating system version will be installed and indicates which disk partition ...

Page 271: ...on the primary IP Telephony server and then on the secondary IP Telephony server by entering these commands log in as root cd opt 3com VCX scripts rc3 d S70tomcat stop 2 Set up replication on the primary IP Telephony server by entering these commands cd opt 3com VCX vcxdata bin su cworks setupReplication The replication setup script starts Follow these steps a The Enter the VCX Site Identification...

Page 272: ...nder firewall setup was performed during VCX software installation f The Have you executed the ABOVE mentioned VCX FIREWALL steps y n prompt appears Enter y to continue The script executes When the replication is complete Multi Master Replication Status is reported as NORMAL Do not continue to the next step until the replication is complete Note that replication can take approximately 20 minutes t...

Page 273: ...VCX server follow the instructions in Upgrading a Single Site System With Two Servers earlier in this appendix To upgrade the Call Records server see the following section Upgrading the Call Records Server All upgrade commands are executed locally at the console Upgrading the Call Records Server To upgrade the Call Records server 1 Log in to the Call Records server as root 2 Stop all VCX processes...

Page 274: ...pgrading a Multi Site VCX System with Branch Offices Some multi site VCX systems have regional offices and branch offices Each branch office is associated with a regional office Multi site VCX systems can be categorized by the method used to implement messaging In a multi site VCX system configured to use local messaging the IP Messaging server is co located with the IP Telephony server at each br...

Page 275: ...he components in the following order Upgrade the replicated Authentication and Directory servers in each regional office Upgrade the IP Messaging servers in each regional office Upgrade the Call servers in each regional office Upgrade the Call Records server optional Upgrade the branch offices hosted by a region Upgrading the Regional Authentication and Directory Servers This section describes how...

Page 276: ...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 1 IP Address 0 0 0 0 prompt appears Enter the IP address of the Master Site If there are more than one Master Sites this question repeats until the number of master sites specified in step b is reached e The Do you want to continue with the above ...

Page 277: ...his command vcx switchversion 7 0 xc The system displays several status messages and then reboots When the reboot process has been completed the system starts VCX 7 0 xc Authentication and Directory service 11 After the system has completed the restart process verify that the upgrade has occurred by entering the following command ls l opt 3com VCX The symbolic link VCX should point to the new vers...

Page 278: ...see such a prompt answer y The system displays several status messages The last two messages are Installation Completed Successfully VCX version 7 0 xc is now available 18 Obtain a license key for the server See Obtaining a License Key File 19 Install the license key See Installing a License Key File 20 Change to the new software version by entering this command vcx switchversion 7 0 xc The system...

Page 279: ... ID for Region 2 3 On the Authentication and Directory server in Region 2 upgrade the Region 1 database by entering the following commands su cworks cd opt 3com VCX vcxdata bin upgradeVcxdata The Enter the VCX Site Identification i e Site Id prompt appears 4 Enter the Site ID for Region 1 5 Set up database replication on Region 1 by entering the following commands you should still be logged in to ...

Page 280: ...Do not continue to the next step on this server until the replication is complete Note that replication can take approximately 20 minutes to complete f You can check the replication by entering the following command checkReplication 6 Set up database replication on Region 2 by entering the following commands you should still be logged in to the Authentication and Directory server as cworks cd opt ...

Page 281: ...pgrade the IP Messaging servers 1 Stop the primary IP Messaging server and a secondary IP Messaging server by entering the following commands as root on each server cd opt 3com VCX scripts rc3 d S60ums stop 2 Obtain a copy of the vcx ipmsg 7 0 xc tar software upgrade file and place it in the opt installtemp directory on the primary IP Messaging server and on the secondary IP Messaging server 3 Upg...

Page 282: ...imary IP Messaging server and you will be asked to identify the IP Messaging clients associated with this server The following prompts appear A list of each of the IPMSG client systems IP addresses and hostnames is required Enter a blank input to indicate that all clients have been entered IP address of IPMSG client 1 Client IP Address f Enter the IP address of the first IP Messaging client system...

Page 283: ...ents If the primary IP Messaging server was configured with the client information the secondary IP Messaging server is automatically configured with this information Upgrading the Regional Call Servers This section describes how to upgrade regional Call servers Call servers are typically installed in redundant pairs primary and secondary in a multi site VCX system You need to perform the steps in...

Page 284: ... starts VCX 7 0 x Call server e After the system has completed the restart process 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 xc 4 Upgrade the secondary Call server by following the procedure described in step 3 5 Repeat steps for the ot...

Page 285: ...ystem displays several status messages and then reboots When the reboot process has been completed the system starts VCX 7 0 xc services 7 After the system has completed the restart process verify that the upgrade has occurred by entering the following 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...

Page 286: ...cation failure To upgrade the branch offices in Region 1 local messaging 1 Stop the Tomcat process on the Call servers in Region 1 by logging in to each server as root and executing the following commands cd opt 3com VCX scripts rc3 d S70tomcat stop 2 Log in to the first branch office server as root 3 Obtain a copy of the vcx all 7 0 xc tar software upgrade file and place it in the opt installtemp...

Page 287: ... 9 Repeat steps 2 through 8 for all the other branch office servers in Region 1 10 After upgrading all the branches restart the Tomcat process on the Call servers in Region 1 by logging in to each server as root and executing the following commands cd opt 3com VCX scripts rc3 d S70tomcat start To upgrade the branch offices in Region 2 global messaging 1 Stop the Tomcat process on the Call servers ...

Page 288: ...ion by entering the following command vcx switchversion 7 0 xc The system displays several status messages and then reboots After the the reboot process has been completed the system starts VCX 7 0 x services 8 After the system has completed the restart process 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 t...

Page 289: ...Upgrading a Multi Site VCX System with Branch Offices 289 server IP Telephony server and Call Processing server See Post Upgrade Requirements ...

Page 290: ...290 APPENDIX C UPGRADING VCX SERVER SOFTWARE FROM V6 0 TO V7 0 ...

Page 291: ...grading from 7 0 to 6 0 During a VCX system upgrade or downgrade users cannot make calls within the system However users may be able to make emergency calls or make calls to and receive calls from destinations outside of the VCX system that is the PSTN This capability depends on the availability configuration and capacity of the media gateway or gateways set up in the VCX system See the VCX Instal...

Page 292: ...o the VCX system as root 2 Enter the following commands cd opt 3com ls l This command returns a list all of the installed releases and indicates the running VCX version The running VCX version is preceded by a symbolic link icon lrwxrwxrwx 1 root root 21 Jan 13 09 13 VCX opt 3com VCX 7 0 1c drwxr xr x 10 root root 4096 Jan 10 07 13 VCX 7 0 0c In this example the link points to version 7 0 1c The o...

Page 293: ...want to revert to the previous version of VCX system software If a component fails to upgrade contact your 3Com Support for assistance before proceeding To use the downgrade procedures in this section your VCX system must have previously been successfully running version 7 1 The downgrade procedure does not back port any configuration or database modifications you might have made while running ver...

Page 294: ...his procedure describes how to downgrade a pair of VCX servers running these software configurations IP Telephony and Messaging IP Telephony only IP Messaging only Switch VCX Version To switch the VCX version perform the steps in this section first on the primary server and then on the secondary server 1 Log in as root and enter this command vcx switchversion manual 7 x Example vcx switchversion m...

Page 295: ... cworks and enter these commands cd opt 3com VCX vcxdata bin dropReplication 4 When the script prompts you enter the site ID of the Master Site Restore VCX Databases Before upgrading from version 7 0 to 7 1 you must have backed up the system databases To restore the database on each server that is running the IP Telephony and Messaging or IP Telephony software configuration see Restoring the VCX A...

Page 296: ... stop 3 On the Master Definition Site the primary server log in as cworks and enter these commands cd opt 3com VCX vcxdata bin setupReplication 4 When the script prompts you enter the site ID of the Master Site Verify Database Replication 1 Wait at least 20 minutes to allow time for database replication to be completed 2 Enter these commands cd opt 3com VCX vcxdata bin checkReplication The message...

Page 297: ...a3 B active The operating system versions that you see may vary from the example shown The order of the A and B versions may be reversed depending on the upgrade history of the system When you are downgrading use the earlier of the two operating system versions in this command vcx os switch 4 2 1 To confirm that you have selected the operating system version that you want repeat the vcx os query c...

Page 298: ...lication Downgrading Regional IP Messaging Servers If a downgrade is required on a regional IP Messaging server follow the procedure described in Downgrading a Single Site System 7 1 to 7 0 Downgrading Call Servers To downgrade a pair of Call servers perform these steps first on the primary server and then on the secondary server 1 Log in as root and switch the VCX version using this command vcx s...

Page 299: ...m this command appears OS Version Partition Label Status A 4 2 1 dev hda2 A B 5 1 3 dev hda3 B active The operating system versions that you see may vary from the example shown The order of the A and B versions may be reversed depending on the upgrade history of the system When you are downgrading use the earlier of the two operating system versions in this command vcx os switch 4 2 1 To confirm t...

Page 300: ...t operate successfully 2 Update the pointer to the configuration file using this command SetConfigFile opt 3com VCX conf VCXConfiguration xml 3 If necessary switch to the previous version of the operating system The upgrade from 7 0 to 7 1 may or may not have required the installation of a new VCX operating system version This step describes how to determine if a new operating system version was i...

Page 301: ...v hda3 B active 4 Reboot the system using this command reboot When the system reboots it starts VCX 7 0 services Downgrading a Branch Office Server If you attempt to upgrade a branch office server but the upgrade is unsuccessful you must downgrade and contact 3Com Support for assistance Switch VCX Version To switch the VCX version 1 Log in as root and enter this command vcx switchversion manual 7 ...

Page 302: ...s cd opt 3com VCX vcxdata bin dropReplication 4 When the script prompts you enter the site ID of the Master Site Restore Databases Before upgrading from version 7 0 to 7 1 you must have backed up the system databases 1 Restore the database on branch office server See Restoring the VCX Authentication and Directory Server Database VCX systems require database replication between the regional and bra...

Page 303: ...ation 4 When the script prompts you enter the site ID of the Master Site Verify Database Replication 1 Wait at least 20 minutes to allow time for database replication to be completed 2 Enter these commands cd opt 3com VCX vcxdata bin checkReplication The message that appears should contain the word NORMAL If it does not wait for a few more minutes and then repeat the command Do not proceed beyond ...

Page 304: ...u see may vary from the example shown The order of the A and B versions may be reversed depending on the upgrade history of the system When you are downgrading use the earlier of the two operating system versions in this command vcx os switch 4 2 1 To confirm that you have selected the operating system version that you want repeat the vcx os query command Verify that the word selected appears in t...

Page 305: ...l state it was in prior to the upgrade occurring If an upgrade at a regional office is unsuccessful contact your 3Com Support for assistance and downgrade the regional office servers Do not upgrade any branch office servers that are associated with that regional office until the regional office upgrades are successful The database schema version on a branch office server must match the schema vers...

Page 306: ...rsion manual 7 1 0c The vcx switchversion command Stops VCX services Changes a link to point to the requested VCX version Issues a warning that databases must be restored CAUTION Do not reboot the system or restart VCX services until databases have been restored The VCX 7 1 x version has been selected but the databases still contain 7 1 y versioned data This combination will not operate successful...

Page 307: ...version 7 1 x to 7 1 y you must have backed up the system databases To restore the database on each server that is running the IP Telephony and Messaging or IP Telephony software configuration see Restoring the VCX Authentication and Directory Server Database VCX systems require database replication between these servers You must restore the database on both servers Restore IP Messaging Databases ...

Page 308: ...m VCX vcxdata bin setupReplication 4 When the script prompts you enter the site ID of the Master Site Verify Database Replication 1 Wait at least 20 minutes to allow time for database replication to be completed 2 Enter these commands cd opt 3com VCX vcxdata bin checkReplication The message that appears should contain the word NORMAL If it does not wait for a few more minutes and then repeat the c...

Page 309: ...n you are downgrading use the earlier of the two operating system versions in this command vcx os switch 4 2 0 To confirm that you have selected the operating system version that you want repeat the vcx os query command Verify that the word selected appears in the Status column for the version that you want Example OS Version Partition Label Status A 4 2 0 dev hda2 A selected B 4 2 1 dev hda3 B ac...

Page 310: ...o downgrade a pair of Call servers perform these steps first on the primary server and then on the secondary server 1 Log in as root and switch the VCX version using this command vcx switchversion manual 7 x Example vcx switchversion manual 7 1 0c The vcx switchversion command Stops VCX services Changes a link to point to the requested VCX version Issues a warning that databases must be restored C...

Page 311: ...2 1 dev hda3 B active The operating system versions that you see may vary from the example shown The order of the A and B versions may be reversed depending on the upgrade history of the system When you are downgrading use the earlier of the two operating system versions in this command vcx os switch 4 2 0 To confirm that you have selected the operating system version that you want repeat the vcx ...

Page 312: ...operate successfully 2 Update the pointer to the configuration file using this command SetConfigFile opt 3com VCX conf VCXConfiguration xml 3 If necessary switch to the previous version of the operating system The upgrade from 7 1 x to 7 1 y may or may not have required the installation of a new VCX operating system version This step describes how to determine if a new operating system version was...

Page 313: ...dev hda3 B active 4 Reboot the system using this command reboot When the system reboots it starts VCX 7 1 x services Downgrading a Branch Office Server If you attempt to upgrade a branch office server but the upgrade is unsuccessful you must downgrade and contact 3Com Support for assistance Switch VCX Version To switch the VCX version 1 Log in as root and enter this command vcx switchversion manua...

Page 314: ...ds cd opt 3com VCX vcxdata bin dropReplication 4 When the script prompts you enter the site ID of the Master Site Restore Databases Before upgrading from version 7 1 x to 7 1 y you must have backed up the system databases 1 Restore the database on branch office server See Restoring the VCX Authentication and Directory Server Database VCX systems require database replication between the regional an...

Page 315: ...ation 4 When the script prompts you enter the site ID of the Master Site Verify Database Replication 1 Wait at least 20 minutes to allow time for database replication to be completed 2 Enter these commands cd opt 3com VCX vcxdata bin checkReplication The message that appears should contain the word NORMAL If it does not wait for a few more minutes and then repeat the command Do not proceed beyond ...

Page 316: ...you see may vary from the example shown The order of the A and B versions may be reversed depending on the upgrade history of the system When you are downgrading use the earlier of the two operating system versions in this command vcx os switch 4 2 0 To confirm that you have selected the operating system version that you want repeat the vcx os query command Verify that the word selected appears in...

Page 317: ...rocedure assumes the VCX version 6 0 system databases were backed up before the upgrade to version 7 0 was performed These version 6 0 backups will be restored as part of the downgrade procedure The downgrade procedure does not back port any configuration or database modifications you might have made while running version 7 0 Following this procedure restores the VCX system to the operational stat...

Page 318: ...s must be performed on each server In a four server configuration one pair of servers runs IP Telephony server software the second pair of servers runs IP Messaging server software The downgrade steps described in the following sections must be performed on each server running IP Telephony server software For servers running IP Messaging server software the database maintenance steps are not requi...

Page 319: ...tem Versions and Reboot Stop VCX Database Replication If the server is running the IP Telephony and Messaging or the IP Telephony software configuration you must stop database replication These steps are executed on the primary server only Also ensure that you have executed the vcx switchversion command on both the primary and secondary IP Telephony and Messaging or the IP Telephony servers before...

Page 320: ...To create the version 6 0 database schema perform the following steps first on the primary server then on the secondary server 1 Log in to the server as root user 2 Enter the following commands cd opt 3com VCX scripts firstboot F20vcxdata 3 Go to the next section Restore VCX Databases Restore VCX Databases To restore the database on the primary and secondary servers that are running the IP Telepho...

Page 321: ... NORMAL If it does not wait for a few more minutes and then repeat the command Do not continue until you see the NORMAL message When replication is complete go to the next section Switch Operating System Versions and Reboot Switch Operating System Versions and Reboot The VCX system supports two operating system images If the upgrade required installation of a new VCX operating system version then ...

Page 322: ...hat you want repeat the vcx os query command Verify that the word selected appears in the Status column for the version that you want vcx os query OS Version Partition Label Status A 3 4 0 dev hda2 A selected B 4 2 1 dev hda3 B active 5 Enter the following command to reboot the system reboot When the system reboots it starts VCX 6 0 services Downgrading a Multi Site System For multi site VCX syste...

Page 323: ... is required on a regional Authentication and Directory server See Downgrading a Single Site System for detailed information for each general step If you need to downgrade a branch server downgrade the branch before downgrading the regional Authentication and Directory server hosting that branch See Downgrading a Branch Office On each Authentication and Directory server you must switch versions of...

Page 324: ...ry IP Messaging server and then the secondary IP Messaging server Downgrading Call Servers If a downgrade from version 7 0 to version 6 0 is required on a pair of regional Call servers follow the procedures described in Switch VCX Version and Switch Operating System Versions and Reboot on the primary Call server and then the secondary Call server Downgrading the Call Records Server If a downgrade ...

Page 325: ...the regional Authentication and Directory server associated with the branch still logged in as cworks enter the following commands to delete the branch schema cd opt 3com VCX vcxdata bin dropVcxdata When the script prompts you enter the site ID of the branch 5 Log in as root to the regional Authentication and Directory server associated with the branch and enter the following commands to stop the ...

Page 326: ...ample 6 0 2 c 10 Log in as root on the branch and switch to the previous operating system version Follow steps 1 through 4 in Switch Operating System Versions and Reboot Do not enter the reboot command step 5 Instead enter the following commands to run firstboot script on the branch cd opt 3com VCX scripts firstboot F20vcxdata 11 Wait at least 20 minutes to allow time for database replication to b...

Page 327: ... and enter the following commands to start the globaldir service cd opt 3com VCX scripts rc3 d S30vcxglobaldir start At this point because there is a version mismatch between the branch database and the regional database you cannot access branch data through provisioning at the region You must use the provisioning interface on the branch server ...

Page 328: ...328 APPENDIX D DOWNGRADING VCX SERVER SOFTWARE ...

Page 329: ...E VCX COMMANDS This appendix describes the VCX commands you can use to manage and view VCX components This appendix includes the following topic Command Descriptions ...

Page 330: ...e Changes IP addresses or most other first time setup parameters certain parameters cannot be reconfigured See Chapter 7 vcx config network Changes network settings Typically invoked as part of the vcx reconfigure operation However you can use this command to modify the time zone setting for a machine See Changing a Daylight Saving and Time Zone Configuration vcx config services show Changes a ser...

Page 331: ...Your Codec vcx os query Displays the installed VCX operating systems and if there are multiple systems installed indicates which one is active This command is described in the upgrade and downgrade appendixes vcx os switch Switches between installed versions of the VCX operating system This command is described in the upgrade and downgrade appendixes vcx removeversion Removes an earlier installed ...

Page 332: ... this case 3Com Corporation customer name Displays the name of the customer customer address Displays customer address information account number Displays the customer account number expiration date Displays the expiration date of the original license key update expiration date Displays the expiration date of the updated license key license capacity Displays the number of supported phones IP Messa...

Page 333: ...displays the installed components that match the specified VCX version vcx showconfigtype Displays the type of VCX configuration running on the machine Possible returned values include all Indicates the host system is running as an IP Telephony and IP Messaging Server softswitch Indicates the host system is running as an IP Telephony Server ums Indicates the host system is running as an IP Messagi...

Page 334: ...on for example host name serial number networking information and disk information vcx ups setup For VCX versions 7 1 and higher configures UPS monitoring on the machine See Adding UPS Support to an Existing VCX System vcx ups status For VCX versions 7 1 and higher displays UPS status on the machine See Monitoring UPS Status ...

Page 335: ...TERFACE COMMANDS This chapter contains a complete listing of command line interface CLI commands available for managing the call processor This chapter includes the following topics Call Processor CLI Overview CLI Command Descriptions ...

Page 336: ...ange to correct directory and start the remoteCLI application ssh root ip_address password cd opt 3com VCX callprocessor remoteCli bin remoteCli callp The application uses the same editing style as the text editor vi The CLI interface provides a complete view of all of the system configurable parameters and allows you to configure those parameters in real time The configuration are automatically w...

Page 337: ...ppId AppMibs AuthCfg AuthLogFilters AuthServer AuthServerStats AuthServiceStats CcCfg CcLogFilters CcQosCfg CcQosMonitoredEndpoints CcStats CcTrusted LogCfg SipCfg SipLogFilters CLI Command Descriptions The remote CLI application uses the following commands for administering the Call Processor Table 21 Remote CLI Command Descriptions Command Description exit Quits the Remote CLI application shutdo...

Page 338: ...h the execute command statistics Displays various types of counters for a particular plugin To display available statistics for a plugin issue the name of one of the plugins listed from the plugin CLI command along with the statistics command send Sends a message to a plugin dump Configures a plugin to display troubleshooting information messageTrace Turns on logging for all DMR messages within th...

Page 339: ...CLI Command Descriptions 339 ...

Page 340: ...ackup and restore 80 Authentication and Directory service logging 59 maintenance 56 starting 57 stopping 57 view status 57 B backing up databases 80 VCX configurations 70 batch mode user MAC command 150 besbulkload pl 87 branch offices verifying replication 96 C cache clearing for Tomcat 47 Call Detail Record See CDR Call Processor service 16 restarting 55 starting 54 stopping 55 Call Records serv...

Page 341: ...s 32 replication errors 99 disabling Accounting service groups 32 downgrade version 7 0 to version 6 0 317 multi site 322 single site 318 version 7 1 to version 7 0 293 multi site 298 single site 294 version 7 1 y to version 7 1 x 305 multi site 309 single site 306 E eml_client out monitoring 49 enabling Accounting service groups 32 message tracing 58 server logging 59 SNMP support 60 exporting al...

Page 342: ... 91 configuring for IP Telephony server 91 configuring region to region 93 manually configuring region to region 93 multi master described 90 verifying 96 replication errors checking for 96 deleting 99 restarting Call Processor service 55 Common Agent service 53 IP Messaging service 62 SIP Phone downloader service 61 restoring databases 80 VCX configurations 70 S schema exporting 85 verifying in a...

Page 343: ... 124 in regional offices 124 master server 126 monitoring status 136 multiple configuration 130 master 132 options 130 slave 134 overview 124 power event responses 138 requirements 127 set up during upgrade 171 setup guidelines 126 setup options 125 single configuration 127 master 127 slave 129 slave server 126 supported hardware 125 vcx ups setup command 125 vcx ups status command 125 syntax 136 ...

Page 344: ... vcx install command to install a codec 65 vcx licenseinstall command 257 vcx licensequery command 258 vcx listversions command 166 216 vcx os query command 297 309 vcx os switch command 297 309 vcx reconfigure command 63 102 vcx showconfigtype command 168 218 verifying number of schemas in a region 97 replication at a branch office 96 service operation 51 SNMP support 60 viewing Accounting servic...

Reviews: