NEC ExpressCluster SRE Version 7.
NEC ExpressCluster SRE 7.0 Installation and Configuration Guide (Windows edition) Document Number EC-SRE-001-SR, Version 1.0, January 2005 Part Number 456-01699-001 Copyright © 2007 NEC Corporation of America. Information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of NEC Corporation of America.
Contents About this guide ________________________________________________________ 5 Using this guide ______________________________________________________ 5 Chapter 1: Installation Prerequisites _______________________________________ 7 Hardware Prerequisites _______________________________________________ 7 Server Model_______________________________________________________ 7 Minimum Hard disk and Memory Capacity _______________________________ 7 Software Prerequisites ___________________________________
Prerequisites _______________________________________________________ 94 Customization Steps _________________________________________________ 94 Chapter 8: General Customization Process ________________________________ 109 Command Reference _______________________________________________ 109 ARMLOAD _____________________________________________________ 109 ARMKILL ______________________________________________________ 111 Prerequisites ______________________________________________________ 112 Customizatio
About this guide NEC ExpressCluster SRE is an integrated software solution designed for monitoring and automatically restarting applications on a single server. Using this guide This document includes step-by-step instructions to help you install NEC ExpressCluster SRE 7.0 and configure it to monitor the processes of Microsoft SQL Server 2000 and Microsoft Exchange Server 2000.
For installation and configuration on Windows 2000, please read the following chapters in sequence: • Prerequisites (Chapter 1) • Installation (Chapter 4) • Configuration (Chapter 5) • Customization (Chapter 6, Chapter 7, or Chapter 8) Please note that only installation (Chapter 1) should be performed at the factory since configuration and customization are dependent on customer site-specific environment.
Chapter 1: Installation Prerequisites This chapter describes the hardware and software prerequisites that must be satisfied before installing NEC ExpressCluster SRE. Hardware Prerequisites Server Model The NEC Express5800/ft series of servers. Minimum Hard disk and Memory Capacity Hard Disk: 77MB, Memory: 512 MB.
Chapter 2: Installation (Windows 2003) Please follow the steps below to install the NEC ExpressCluster SRE Server, NEC ExpressCluster SRE Manager and a Microsoft Loopback Adapter: Step 1 Start the command prompt using Start-> Command Prompt and execute auto_install.exe from following directory on the installation CD: \auto_install.exe The automatic installation process will take a few minutes and you may encounter a popup dialog box as shown below.
Chapter 3: Configuration (Windows 2003) This chapter describes the one-time initial configuration procedure for NEC ExpressCluster SRE in the final deployment environment. Computer Name Configuration The computer name MUST be finalized before starting configuration of NEC ExpressCluster SRE.
Step 2: Click the [Registration] button.
Step 3: Click the [License item is inputted] button.
Step 4: Select Windows for the OS information, product version for the Product Classification, NEC ExpressCluster SE for Windows Ver7.
Step 5: Select the Node unit radio button, type in 1 as the Node licenses number and click Next: 13
Step 6: Locate the ExpressCluster SRE License Key at the back of the server along the edge as indicated in following figure: 14
Key: DFJ4J4J4-JD398VJH-D389NHYW-3DJ9888J S/N: AA000001 ExpressCluster SRE License Key 405-01718-000 Step 7: Type in the Serial number (as indicated by S/N: AA000001 above) and the Key (as indicated by Key: DFJ4J4J4-JD398VJH-D389NHYW-3DJ9888J above) and click Next: 15
Step 8: Confirm the license information and click Next on the following screen: 16
Step 9: Check to see that the message “The license was registered.” appears. Now you have finished license registration.
Starting the NEC ExpressCluster Server Service Please execute the following step to start the NEC ExpressCluster Server service: Step 1: The default value by the installation for the “NEC EXPRESSCLUSTER Server” service is [Manual] startup. Change it to [Automatic] startup using Start-> Administrative Tools-> Services and Start the service.
Step 2: Click the Create cluster(C) button on the following screen: 19
Step 3: Select NEC ExpressCluster Standard/SE/SX (S) and click Next on the following screen: 20
Step 4: Type in a cluster name (e.g. SRE-VCC), the computer name of the server (e.g. SRE-SRV) and first IP address (e.g. 10.123.187.1).
Note: Up to 15 characters are allowed for the cluster name. Please do not use a cluster name which is same as the computer name.
Click Next: Step 5: On the following screen click the Add (A) button: 23
Step 6: Select the second IP address which would be used as Primary Interconnect first (DO NOT SELECT THE IP ADDRESS AS IN STEP 4 ABOVE). In this case select 192.168.93.
Click OK. Then click on Add (A) again and add first IP address as in Step 4 above.
Step 8: Click Next on the screen below: 26
Step 9: Select No NP resolution mode(O) and click Next on the screen below: 27
Step 10: Click Next on the screen below: 28
Step 11 Click Next on the screen below: 29
Step 12 Click Next on the screen below: 30
Step 13 Click Finish on the screen below: 31
Step 14 Click OK on the screen below: You should see a screen with the cluster and server similar to the one below: 32
Configuring the Cluster Properties Step 1: Right click on the cluster icon (SRE-VCC) and select the Property(P) menu item: 33
Step 2: Click Yes below: Step 3: Select Detailed set up(D) and click OK 34
Step 4: Select the Return mode tab, and select Auto return(N) as below: 35
Step 5: Select the Heartbeat Interval tab and select the Show STOP error (panic)(P) radio button and click OK as in the following screen: Step 6: Click Yes below: Step 7: 36
Select Restart the Computer?(R) and click Yes: Step 8: Click Yes: Step 9: After the server reboots, start the command prompt (using Start-> Programs>Accessories-> Command Prompt) and type in the following command and hit enter: armem /M reboot You see the following text: Command succeeded. Note: This command configures the server for automatic reboot incase a process terminates more than x times in y hours. These threshold values are specified using the armload command.
Creating the Failover Group Step 1: Start the NEC ExpressCluster Manager using Start->Programs->NEC ExpressCluster Manager Step 2 Right click on the cluster icon and select Create Group(U) as below: 38
Step 3: Enter the failover group name as say SRE-GRP and click OK: Step 4: Select the Setup tab, select the Yes(B) radio button for Auto failback and click OK 39
Step 5: Select the server from the Server list(S) and click the <
Step 6: Click OK on the following screen: 41
Step 7: Right click on the failover group and start the group on the server by following the screen shots below: 42
Click OK: The Failover Group icon should be Green and all the resources should be Online as below: 43
Chapter 4: Installation (Windows 2000) Please follow the steps below to install the NEC ExpressCluster SRE Server and NEC ExpressCluster SRE Manager: Step 1 Start the command prompt using Start->Programs->Accessories->Command Prompt and execute auto_install.exe from following directory on the installation CD: \auto_install.exe The automatic installation process will take a few minutes and you may encounter a couple popup dialog boxes.
Chapter 5: Configuration (Windows 2000) This chapter describes the one-time initial configuration procedure for NEC ExpressCluster SRE in the final deployment environment. Computer Name Configuration The computer name MUST be finalized before starting configuration of NEC ExpressCluster SRE.
Step 2: Click the [Registration] button.
Step 3: Click the [License item is inputted] button. Step 4: Select Windows for the OS information, product version for the Product Classification, NEC ExpressCluster SE for Windows Ver7.
Step 5: Select the Node unit radio button, type in 1 as the Node licenses number and click Next: 49
Step 6: Locate the ExpressCluster SRE License Key at the back of the server along the edge as indicated in following figure: 50
Key: DFJ4J4J4-JD398VJH-D389NHYW-3DJ9888J S/N: AA000001 ExpressCluster SRE License Key 405-01718-000 Step 7: Type in the Serial number (as indicated by S/N: AA000001 above) and the Key (as indicated by Key: DFJ4J4J4-JD398VJH-D389NHYW-3DJ9888J above) and click Next: 51
Step 8: Confirm the license information and click Next on the following screen: 52
Step 9: Check to see that the message “The license was registered.” appears. Now you have finished license registration.
Starting the NEC ExpressCluster Server Service Please execute the following step to start the NEC ExpressCluster Server service: Step 1: The default value by the installation for the “NEC EXPRESSCLUSTER Server” service is [Manual] startup. Change it to [Automatic] startup using Start-> Settings-> Control Panel-> Administrative Tools-> Services and Start the service.
Step 2: Click the Create cluster(C) button on the following screen: Step 3: Select NEC ExpressCluster Standard/SE/SX (S) and click Next on the following screen: 55
Step 4: Type in a cluster name (e.g. SRE-VCC), the computer name of the server (e.g. SRE-SRV) and first IP address (e.g. 10.123.187.1).
Note: Up to 15 characters are allowed for the cluster name. Please do not use a cluster name which is same as the computer name.
Click Next: Step 5: On the following screen click the Add (A) button: 58
Step 6: Select the second IP address which would be used as Primary Interconnect first (DO NOT SELECT THE IP ADDRESS AS IN STEP 4 ABOVE). In this case select 192.168.93.
Click OK. Then click on Add (A) again and add first IP address as in Step 4 above.
Step 8: Click Next on the screen below: 61
Step 9: Select No NP resolution mode(O) and click Next on the screen below: 62
Step 10: Click Next on the screen below: 63
Step 11 Click Next on the screen below: 64
Step 12 Click Next on the screen below: 65
Step 13 Click Finish on the screen below: 66
Step 14 Click OK on the screen below: You should see a screen with the cluster and server similar to the one below: 67
Configuring the Cluster Properties Step 1: Right click on the cluster icon (SRE-VCC) and select the Property(P) menu item: 68
Step 2: Click Yes below: Step 3: Select Detailed set up(D) and click OK 69
Step 4: Select the Return mode tab, and select Auto return(N) as below: 70
Step 5: Select the Heartbeat Interval tab and select the Show STOP error (panic)(P) radio button and click OK as in the following screen: Step 6: Click Yes below: Step 7: 71
Select Restart the Computer?(R) and click Yes: Step 8: Click Yes: Step 9: After the server reboots, start the command prompt (using Start-> Programs>Accessories-> Command Prompt) and type in the following command and hit enter: armem /M reboot You see the following text: Command succeeded. Note: This command configures the server for automatic reboot incase a process terminates more than x times in y hours. These threshold values are specified using the armload command.
Creating the Failover Group Step 1: Start the NEC ExpressCluster Manager using Start->Programs->NEC ExpressCluster Manager Step 2 Right click on the cluster icon and select Create Group(U) as below: 73
Step 3: Enter the failover group name as say SRE-GRP and click OK: Step 4: Select the Setup tab, select the Yes(B) radio button for Auto failback and click OK 74
Step 5: Select the server from the Server list(S) and click the <
Step 6: Click OK on the following screen: 76
Step 7: Right click on the failover group and start the group on the server by following the screen shots below: 77
Click OK: The Failover Group icon should be Green and all the resources should be Online as below: 78
Chapter 6: Microsoft SQL Server 2000 Customization Prerequisites Please verify that the following services start and stop normally using Start -> Settings -> Control Panel -> Administrative tools -> Services: 1. MSSQLSERVER 2. SQLSERVERAGENT If these services are running, please stop these services using Control Panel -> Services Customization Steps Step 1: Right Click on the Fail over Group in the ExpressCluster Manager UI and select the Property(P) menu item.
Step 2: Select the Reference and Change (C) radio button. Also check the Stop the group(S) check box and Click OK. The screenshot is as below: Step 3: Select the Scripts tab and highlight the start.bat script.
Step 4: Click on the Replace button.
Click on the Import(G) button on the screen above. Step 5: Navigate to C:\Program Files\NEC ExpressCluster\templates\scripts\MS-SQLServer, select the start.
Step 7: Click OK on the following confirmation dialog: Step 8: This opens the start.bat file in notepad.
Please read the following Notes for the explanation of these commands and parameters. Notes: “SQLSERVER” is an ID used for monitoring MSSQLSERVER service. This ID is used for terminating the service using the armkill command. This ID must be a unique name within a cluster. It is case insensitive and can be at most 255 single byte alphanumeric characters.
Step 11: Click on the Replace button.
Click on the Import(G) button on the screen above. Step 12: Navigate to C:\Program Files\NEC ExpressCluster\templates\scripts\MS-SQLServer, select the stop.
Step 14: Click OK on the following confirmation dialog: Step 15: This opens the stop.bat file in notepad.
Step 16: Close the file and click OK on the following screen: 89
Step 17: Click OK again on the following screen: 90
Step 18: Start the group on the server. Right click on the Failover Group and select “Start Group (E)” to start the group on the server.
Click OK on the screen below: The Failover Group icon should be Green and all the resources should be Online as below: 92
Please verify that the following services configured in the cluster start successfully on the server: 1. MSSQLSERVER 2. SQLSERVERAGENT In case either or both of the above processes terminate, they are automatically restarted after 5 seconds. In case they terminate more than 3 times in 1 hour, the server is rebooted automatically. This completes the configuration for monitoring the Microsoft SQL Server 2000 processes.
Chapter 7: Microsoft Exchange Server 2000 Customization Prerequisites Please verify that the following services start and stop normally using Start -> Settings -> Control Panel -> Administrative tools -> Services: 1. 2. 3. 4. 5. 6. 7.
Step 2: Select the Reference and Change (C) radio button. Also check the Stop the group(S) check box and Click OK.
Step 3: Select the Scripts tab and highlight the start.bat script.
Step 4: Click on the Replace button.
Click on the Import(G) button on the screen above. Step 5: Navigate to C:\Program Files\NEC ExpressCluster\templates\scripts\MSExchange, select the start.
Step 7: Click OK on the following confirmation dialog: Step 8: This opens the start.bat file in notepad.
Please read the following Notes for the explanation of these commands and parameters. Notes: “MSIMAP” is an ID used for monitoring IMAP4SVC service. This ID is used for terminating the service using the armkill command. This ID must be a unique name within a cluster. It is case insensitive and can be at most 255 single byte alphanumeric characters.
Step 11: Click on the Replace button.
Click on the Import(G) button on the screen above. Step 12: Navigate to C:\Program Files\NEC ExpressCluster\templates\scripts\MSExchange, select the stop.
Step 14: Click OK on the following confirmation dialog: Step 15: This opens the stop.bat file in notepad..
Step 16: Close the file and click OK.
Step 17: Click OK again on the following screen: 105
Step 18: Start the group on the server. Right click on the Failover Group and select Start Group (E) to start the group on the server.
Click OK on the screen below: The Failover Group icon should be Green and all the resources should be Online as below: 107
Please verify that the following services configured in the cluster start successfully on the server: 1. IMAP4Svc 2. MSExchangeIS 3. MSExchangeMGMT 4. MSExchangeMTA 5. POP3svc 6. RESvc 7. MSExchangeSA In case either or all of the above processes terminate, they are automatically restarted after 5 seconds. In case they terminate more than 3 times in 1 hour, the server is rebooted automatically. This completes the configuration for monitoring the Microsoft Exchange 2000 Server processes.
Chapter 8: General Customization Process This chapter explains the general process to customize NEC ExpressCluster SRE to monitor and restart arbitrary application services. Command Reference The following section explains the functionality and usage of the ARMLOAD and ARMKILL commands (used in start.bat and stop.bat scripts respectively) to monitor and restart arbitrary services. ARMLOAD Starts up a service. If a fault occurs in the started service, the service is restarted.
/S Specifies that the entity to be started up is a service. This parameter is mandatory. /A Indicates that ExpressCluster will not identify it as an error if the service has already started and is running. Please specify this parameter in case the start up type of the service is [AUTOMATIC] (in Settings-> Control Panel -> Administrative Tools -> Services) /WAIT time Used to specify the time in seconds required for waiting for the completion of service startup.
ARMKILL Terminates the service that was started up by using the ARMLOAD command. Usage: ARMKILL watchID [/C | /T time] Parameters: watchID This is the monitoring ID of the service to be terminated. For this ID, use the one that was specified when the service was started up by the ARMLOAD command. /C Cancels the monitoring of the service but does not terminate the service. This parameter can be omitted. If it is omitted, the service is terminated.
Sets the wait time for waiting until the service stops completely. The range that can be specified is from 0 to 3600 seconds. If 0 is specified, the wait time is unlimited. This parameter can be omitted. If it is omitted, the wait time is 40 seconds. Also, this parameter cannot be specified at the same time as the /C parameter. As an example, the following section explains the steps required to customize the scripts for monitoring an arbitrary service (e.g. Telnet service).
Step 2: Select the Reference and Change (C) radio button. Also check the Stop the group(S) check box and Click OK.
Step 3: Select the Scripts tab and highlight the start.bat script.
Step 4: Click on the Edit button. This opens the start.bat file in notepad. Edit the start.
Step 5: Save the file and click OK. Step 6: Highlight the stop.bat script similar to Step 3 above. Step 7: Click on the Edit button. This opens the stop.bat file in notepad. Edit the stop.
Step 8: Save the file and click OK.
Step 9: Start the group on the server. Right click on the Failover Group and select Start Group (E) to start the group on the server.
Click OK on the screen below: The Failover Group icon should be Green and all the resources should be Online as below: 119
Please verify that the Telnet service starts successfully on the server. In case the Telnet service terminates, it is automatically restarted after 5 seconds. If it terminates more than 2 times in 1 hour, the server is rebooted automatically.
Appendix A: Modifying IP Addresses You could either change the default IP addresses assigned to the Loopback Adapter of the server. Please ensure that you identify two static IP addresses in different network segments that are unique on the network. This requirement is mandatory. The first IP address is used to register the Cluster Server with the Manager and the second IP address is used as the Primary Interconnect IP address. The steps below change the default IP address 10.123.187.1/255.255.255.0 to 20.
Use Start-> Settings-> Control Panel-> Network and Dial up Connections.
Step 2: Select Internet Protocol (TCP/IP) and click the Properties button: 123
Select Internet Protocol (TCP/IP) and click the Properties button: 124
Step 3: Change the IP Address to it: IP: 20.20.20.
Step 4: Click on the Advanced button, select 192.168.93.
Step 5: Change the second IP Address to IP: 131.241.74.
Step 7: Click OK on the following screen: 128
This completes the steps to change the default IP addresses.