background image

318

A

PPENDIX

 D: D

OWNGRADING

 VCX S

ERVER

 S

OFTWARE

The downgrade procedure does not remove VCX version 7.0 software 
from your VCX system.

If you have configured a VCX server running version 7.0 software for 
RAID operation, you cannot downgrade that server to version 6.0 
software. VCX servers running software versions prior to the 7.0 release 
do not support RAID configuration. If a VCX server enabled for RAID 
operation must be downgraded to a software version prior to 7.0, the 
server must be rebuilt. Contact your 3Com representative.

Downgrading a

Single-Site System

This procedure describes how to downgrade VCX single-site systems. 
Single-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.

The downgrade steps described in the following sections 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 required. 

Switch VCX Version

To switch the VCX version, perform the steps in this section on each 
server in the single-site system. 

In a two-server configuration, perform the steps first on the primary 
server and then on the secondary server.

In a four-server configuration, perform the steps first on the primary IP 
Telephony server and then on the secondary IP Telephony server. Then 
perform the steps first on the primary IP Messaging server and then on 
the secondary IP Messaging server.

1

Log in to the server as 

root

 user.

2

Enter the following command:

vcx-switchversion --manual 6.x

For example, to downgrade to VCX version 6.0.2.c, enter:

vcx-switchversion --manual 6.0.2c

Содержание VCX V7000

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 10: ...10 F CALL PROCESSOR COMMAND LINE INTERFACE COMMANDS Call Processor CLI Overview 336 CLI Command Descriptions 337 INDEX ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 26: ...26 CHAPTER 1 VCX SYSTEM MAINTENANCE OVERVIEW ...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 68: ...68 CHAPTER 3 MANAGING VCX SERVERS ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 78: ...78 CHAPTER 4 BACKING UP AND RESTORING A VCX CONFIGURATION ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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 ...

Страница 88: ...88 CHAPTER 5 MANAGING AUTHENTICATION AND DIRECTORY SERVICE DATABASES ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 100: ...100 CHAPTER 6 MANUALLY CONFIGURING MULTI MASTER REPLICATION ...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 140: ...140 CHAPTER 8 MANAGING UNINTERRUPTIBLE POWER SUPPLIES ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 250: ...250 APPENDIX B UPGRADING VCX SERVER SOFTWARE FROM V7 1 X TO V7 1 Y ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 289: ...Upgrading a Multi Site VCX System with Branch Offices 289 server IP Telephony server and Call Processing server See Post Upgrade Requirements ...

Страница 290: ...290 APPENDIX C UPGRADING VCX SERVER SOFTWARE FROM V6 0 TO V7 0 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 328: ...328 APPENDIX D DOWNGRADING VCX SERVER SOFTWARE ...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 339: ...CLI Command Descriptions 339 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Отзывы: