3Com V7300 Voice Applications Suite ® Unified Messaging Suite Intelligent Mirroring Guide VCX™ V7000 IP Telephony Solution System Release 5.0 Part Number 900-0153-01 AA Published August 2004 http://www.3com.
3Com Corporation 350 Campus Drive Marlborough, MA 01752-3064 Copyright © 2004, 3Com Corporation. All rights reserved. No part of this documentation may be reproduced in any form or by any means or used to make any derivative work (such as translation, transformation, or adaptation) without written permission from 3Com Corporation.
CONTENTS ABOUT THIS GUIDE Assumptions 5 Conventions 5 Notices 5 Text 6 Related Documentation Your Comments 7 6 INITIAL CONFIGURATION Overview 9 Hardware Prerequisites 9 IP Configuration 10 Single Network Configuration 10 Dual Network Configuration 11 Domain Name System (DNS) Configuration 13 Sample DNS Names and Files 14 Enabling Secure Copy (SCP) and Secure Shell (SSH) Commands Network Time Protocol (NTP) Configuration 16 Configuration 16 Verification 17 INSTALLATION Overview 19 Primary Server Insta
Balanced Intelligent Mirroring Policy 22 Switching Between Active and Standby States OPERATION Verifying Intelligent Mirroring Operation Manual Switchover 26 Verifying Server Synchronization 26 Database 26 File System 27 INDEX 25 22
ABOUT THIS GUIDE This chapter contains an overview of this guide, lists guide conventions, related documentation, and product compatibility. Assumptions This guide is intended for system administrators and assumes you have basic skills such as: ■ Basic UNIX command line usage ■ Knowledge of Solaris operating system utilities If the information in the release notes differs from the information in this guide, follow the instructions in the release notes.
ABOUT THIS GUIDE Text Table 2 lists text conventions that are used in this guide. Table 2 Text Convention Descriptions Convention Description Text represented as a screen display This typeface represents displays that appear on your terminal screen, for example: Netlogin: Text represented as user entry.
Your Comments Your Comments 7 Your suggestions are important to us because we want to make our documentation more useful to you. Please send e-mail comments about this guide or any of the 3Com Voice Products documentation and Help systems to: VOICE_Techpubs_comments@3com.
ABOUT THIS GUIDE
1 INITIAL CONFIGURATION This chapter provides an overview of how to configure Intelligent Mirroring on a Primary and Secondary server for the V7300 Voice Applications Suite. Intelligent Mirroring is the mirroring of application data on two independently running servers. The mirrored application data is composed of table data and message component files.
CHAPTER 1: INITIAL CONFIGURATION IP Configuration 3Com recommends that you define the IP configuration using the /etc/hosts files on the two systems. The /etc/hosts file on each server must contain identical information about the Intelligent Mirroring configuration. Other information in the file may vary. The examples in this document contain the information that must be identical.
IP Configuration 11 CAUTION: IP addresses 192.168.126.3 and 192.168.126.4 are the dynamic alias IP addresses. Do not associate them with any network interface. Sample /etc/hosts File Entries for a Single Network Configuration This section describes entries that you would add to the /etc/hosts file if your configuration was identical to the configuration examples listed earlier in this section. # # Internet host table # 192.168.126.1 voipbox1 voipbox1a voipbox1b voipbox1c voipbox1d 192.168.126.
CHAPTER 1: INITIAL CONFIGURATION Figure 1 Dual Network Configuration Primary Server Secondary Server Network A Network B System 1 (Primary Server) ■ System Name — voipbox1 ■ IP Address (subnetwork 126) — 192.168.126.1 (associated with the primary network interface on the Primary Server) ■ IP Address (subnetwork 127) — 192.168.127.
Domain Name System (DNS) Configuration 13 Sample /etc/hosts File Entries for a Dual Network Configuration This section describes entries that you would add to the /etc/hosts file if your configuration was identical to the configuration examples listed earlier in this section. # # Internet host table # 192.168.126.1 voipbox1 voipbox1a voipbox1c 192.168.126.2 voipbox2 voipbox2a voipbox2c 192.168.126.3 active activea activec 192.168.126.4 standby standbya standbyc 192.168.127.1 voipbox1b voipbox1d 192.168.
CHAPTER 1: INITIAL CONFIGURATION 3 Restart the named service on the DNS server to update the server settings with the new configuration information. For any PC on which you intend to run an e-mail client program, configure the PC so that it uses, as its primary DNS server , the DNS server that you have just configured. Sample DNS Names and Files Modify these sample host and file names to conform to your network configuration. ■ E-mail Server Host Name — umsemail ■ DNS Suffix — vcx.wan.3com.
Domain Name System (DNS) Configuration 15 Sample file "vcx.wan.3com.com" $TTL 86400 @ IN SOA vcx.wan.3com.com. root.vcx.wan.3com.com. ( 200210210; serial, todays date + todays serial # 8H; refresh, seconds 2H; retry, seconds 1W; expire, seconds 1D ); minimum, seconds NS galaxy High light this MX record entry MX10 umsemail TXT "Voice Core eXchange, 3Com Corporation" localhost -A 127.0.0.1 umsemail A 192.168.126.1 A 192.168.126.2 voipbox1 -A 192.168.126.1 voipbox2 -A 191.168.126.
CHAPTER 1: INITIAL CONFIGURATION Enabling Secure Copy (SCP) and Secure Shell (SSH) Commands UMS uses shell scripts to synchronize the two servers. These scripts use the SCP and SSH commands. For these commands to work properly in this environment, you must configure each UMS server so that the commands do not prompt for a password.
Network Time Protocol (NTP) Configuration 17 oscillator to stratum 8 in order to allow the two systems to use a lower stratum server (7 or lower) if one is available. By default, the system uses this drift file: /etc/ntp/drift. 3 On the voipbox2 system, create the /etc/ntp.conf file. 4 Edit the file and add these lines: server 127.127.1.1 peer voipbox1 5 On the voipbox1 server, su to root and execute these commands: /etc/init.d/ntpd stop /etc/init.
CHAPTER 1: INITIAL CONFIGURATION
INSTALLATION 2 This chapter describes how to install Intelligent Mirroring on the Primary Server and the Secondary Server. Overview Follow these instructions, in the order that they are given, when you install and configure the servers. 1 Completely install the Primary Server before you begin to install the Secondary Server. See the instructions in Primary Server Installation, next. After you have installed the Primary Server, the system reboots itself.
CHAPTER 2: INSTALLATION Sample Installation Script (for voipbox1) When you first start a VCX V7000 server, a firstboot script is run. The script asks you questions and configures the software based on your answers. This section shows the portion of the firstboot script that deals with configuring Intelligent Mirroring between two VCX UMS servers. Bold text indicates values that you must type. Press Enter after each entry.
Intelligent Mirroring Active/Standby Policy 21 The example answers in this script assume that you are using voipbox2, that voipbox2 will be the secondary server, and that voipbox1 will be the primary server.
CHAPTER 2: INSTALLATION For new installations, the policy is set to Primary by default. To configure the primary policy: 1 Edit this file on the Primary Server: /usr/app/app.dir/config.app 2 Find the line that begins with: IM_policy= 3 Modify the line, if necessary, so that it reads: IM_policy=primary 4 Restart Call Builder on the Primary Server. When Call Builder restarts on the Primary Server, it is in the standby state. After 5 minutes, it switches to active state.
Intelligent Mirroring Active/Standby Policy 23 When the Primary Server is in the standby state, it periodically checks the value of IM_policy and, depending on the value, the Primary Server may switch from the standby state to the active state. ■ If IM_policy is set to primary, a 5-minute timer is activated. When the timer value expires, the Primary Server switches from standby to the active state and negotiates with the Secondary Server so that the Secondary Server switches to the standby state.
CHAPTER 2: INSTALLATION
3 OPERATION This chapter describes how to verify the proper operation of Intelligent Mirroring and synchronization between the servers. It also describes how to manually switch server states and how to resynchronize the databases and file systems on the two servers if that becomes necessary.
CHAPTER 3: OPERATION Manual Switchover You can manually switch either server to the active or standby state, provided that you have root privileges. 1 In a command window, enter this command: xattach app 2 In the screen that appears, click one of these two items to command the system to switch state: ■ Scripts/Spawn vssu_active ■ Scripts/Spawn vssu_stanby 3 In the Intelligent Mirroring Status window, verify that the state changes appear immediately.
Verifying Server Synchronization 27 If the databases are not synchronized, you see a list of the records that are different. The synchronization of the Primary and Secondary servers is a real-time activity. The tblcmp utility gives accurate results only on an idle system (one that is not processing telephone calls). To re-synchronize the databases: 1 On the active server, at the command line enter this command: xattach app 2 In the screen that appears, click Scripts/Spawn vssu_sync.
CHAPTER 3: OPERATION This command creates a shell script (/usr/app/app.dir/diffmsg.rcp) that you can run from the command line to copy the missing files from the other server.
INDEX B balanced mirroring, policy 22 C comments on documentation configuration dual network 11 hardware 9 IP addresses 10 overview 9 single network 10 conventions text 5 7 installation preparation hardware 9 IP addresses 10 overview 9 installation script sample for primary server 20 sample for secondary server 20 M mirroring operation, verifying 25 mirroring policies 21 balanced 22 primary 21 switching between balanced and primary D N database synchronization 27 documentation related 6 documentati
INDEX synchronizing databases 27 file systems 27 servers 26 time 16 with scp and ssh commands 16 T time synchronization 16 U users, intended 5 V verifying database synchronization 27 file system synchronization 27 proper mirroring operation 25 server synchronization 26
