Nec Expresscluster X R3 Lan & Wan With Microsoft SQL Server Installation Guide
Nec Expresscluster X R3 Lan & Wan With Microsoft SQL Server Installation Guide
Nec Expresscluster X R3 Lan & Wan With Microsoft SQL Server Installation Guide
CHAPTER 1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Conventions Used in this Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Other Referenced User Guides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Network Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
LAN Initial Setup Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
WAN Deployment Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Network Pre-Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Network Configuration Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Starting Cluster Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Rebooting the Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Firewall Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 3
Table of Contents
Install ExpressCluster X R3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Configure the Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Appendices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
4 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Table of Contents
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 5
Table of Contents
6 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 1 Prerequisites
Installation Guide. A comprehensive guide that includes instructions for installing the OnGuard
software. This guide also includes information on all supported SQL Server database systems and the
browser-based client applications.
Visitor Administration User Guide. When installing or upgrading OnGuard, if you install the LS
Platform Services to use browser-based applications, refer to this document to Update the URL. For
more information, refer to Chapter 7: Configure the LS Platform Services on page 87.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 1
Prerequisites
Visitor Management Host User Guide. When installing or upgrading OnGuard, if you install the
LS Platform Services to use browser-based applications, refer to this document to Update the URL.
For more information, refer to Chapter 7: Configure the LS Platform Services on page 87.
In addition to this user guide, the following guides provide advanced installation and configuration
information for your NEC ExpressCluster X R3 system. These guides are included on the NEC
ExpressCluster X R3 installation disc:
ExpressCluster X R3 for Windows Getting Started Guide. This guide is intended for all users.
The guide covers topics such as product overview, system requirements, and known problems.
ExpressCluster X R3 WAN Edition for Windows Installation and Configuration Guide. This
guide is intended for system engineers and administrators who want to build, operate, and maintain a
cluster system. Instructions for designing, installing, and configuring a cluster system with
ExpressCluster are covered in this guide.
ExpressCluster X R3 for Windows Reference Guide. This guide is intended for system
administrators. The guide covers topics such as how to operate ExpressCluster, function of each
module, maintenance-related information, and troubleshooting. The guide is supplement to the
Installation and Configuration Guide.
The vocabulary used:
Clean install
A completely new installation of an operating system or application on a computer. In a clean
install of an operating system, the hard disk is formatted and completely erased. In a clean
install of an application, the older version is uninstalled first. Installing an operating system on
a new computer, or installing an application for the first time, is considered a clean install.
Client
Refers to the computer(s) that connect to the server.
Cluster
A logical collection of servers that have clustering software installed. Clustered servers share a
virtual identity.
Cluster partition
A small (non-user) partition used by ExpressCluster to store metadata that keeps track of the
mirror disk status.
Data partition
Disk partition used to store regular user/application data.
Database system
Refers to the database program that you are using. This document assumes that you are using
Microsoft SQL Server as your database system.
Disk resource
A shared disk volume used to resolve Network Partition situations.
ExpressCluster Builder
The software component used to build, configure, and modify NEC clusters.
2 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Other Referenced User Guides
ExpressCluster Manager
The software component that is used to monitor and manipulate the cluster.
Failover
The planned or unplanned movement of a cluster group from one server to another. A failover
can occur if a failure threshold has been exceeded (unplanned).
Floating IP address
The most common type of shared IP address for a cluster group. Floating IP addresses can
only be on the same sub-net as the cluster servers, as opposed to Virtual IP Addresses.
Group
A logical collection of shared resources between clustered servers. Group resources often
include Virtual Computer Name, Mirror disk, Floating/Virtual IP Address, etc.
Group resource
Any item in a cluster group (Virtual Computer Name, Mirror/Switch Disk, Floating/Virtual IP
Address, etc.).
GUID
Refers to Globally Unique Identifier. A unique 128-bit number produced by the Windows
operating system or by some Windows applications to identify a particular component,
application, file, database entry, or user. GUIDs can be created in a number of ways, but
usually they are a combination of a few unique settings based on a specific point in time (e.g.
an IP address, network MAC address, and clock date/time.).
Hardware Key
Commonly referred to as a “dongle.” It is used on the server as part of the OnGuard license.
Alternatively, you may have a software license. For more information, refer to Software
license on page 5.
Heartbeat
A periodic transmission sent between clustered servers. The heartbeat signal is used to inform
partner servers of system status.
High Availability
High-availability clusters (also known as HA clusters or failover clusters) are computer
clusters that are implemented primarily for the purpose of providing high availability of the
services which the cluster provides. They operate by having redundant computers or nodes
which are then used to provide service when system components fail. Normally, if a server
with a particular application crashes, the application will be unavailable until someone fixes
the crashed server. HA clustering remedies this situation by detecting hardware and software
faults, and immediately restarting the application on another system without requiring
administrative intervention, a process known as failover. As part of this process, clustering
software may configure the node before starting the application on it. For example,
appropriate file systems may need to be imported and mounted, network hardware may have
to be configured, and some supporting applications may need to be running as well.
HA clusters are often used for critical databases, file sharing on a network, business
applications, and customer services such as electronic commerce Web sites. HA cluster
implementations are intended to build redundancy into a cluster to eliminate single points of
failure.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 3
Prerequisites
HA clusters send heartbeat traffic across the Public and Private network subnets so that the
servers can maintain awareness of each other. A serious condition every clustering software
system must be able to handle is “split-brain.” Split-brain occurs when the servers lose
connectivity to each other on both the Public and Private network subnets. If this happens,
each node in the cluster may mistakenly decide that every other node has gone down and
attempt to start services that the other nodes are still running. Having duplicate instances of
services may cause data corruption on the shared storage.
Interconnect network
Also referred to as the “Private” network. A dedicated network segment used for heartbeat
signal communication and sometimes disk mirroring. Both the Private and Public network
interfaces serve as “interconnects” because ExpressCluster uses both for heartbeat
communication.
LAN
Refers to Local Area Network. A logical network that does not contain segments separated by
routers. LANs typically span small regions.
Management IP address
An IP address used to access the browser-based ExpressCluster Manager. This IP address is
necessary in order to access the cluster when there are no Floating/Virtual IP addresses online.
Metadata
Data written to the Cluster Partition of mirrored/switch disks - used by ExpressCluster to
maintain these resources.
Mirror disk
A group resource that consists of two logical disk partitions on two separate servers. These
logical disks will only be accessible from one server at a time.
Node
A member server of a cluster. Also refers to any addressable endpoint on a network (server,
router, etc.).
OnGuard services
OnGuard services include all those services with names beginning with “LS”, “Lps”, and
“Lnr.”
Ping resource
A method of resolving the Network Partition (known as “split brain”). This method makes a
determination of whether or not to shutdown a server based on if it can communicate with a
pre-defined reliable remote network node (router, etc.).
Primary Server
The server that a cluster group starts up on, by default.
4 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Other Referenced User Guides
Secondary Server
The non-active server in the cluster - the server that does not currently have control of the
group. Alternative terms for the Secondary Server include Standby Server and Backup Server.
Servers
The computers that run NEC ExpressCluster server services and OnGuard server services.
Typically, these computers also host the database system however it is possible to utilize a
separate database server that is not part of the clustered server environment.
Service Release
Service release refers in general to updates made to OnGuard in the forms of service packs or
hot fixes.
A service pack is a cumulative package with guided installation that resolves customer issues.
A service pack may also include support for a technology refresh and new features.
A hot fix is a cumulative package with guided installation that resolves critical customer
issues. A hot fix may contain more than one fix.
Software license
OnGuard offers a software license that works without the need for a hardware dongle. With a
software-based license you are able to use License Administration to activate, return, or repair
your license.
Software licenses can only be used on a physical computer or in a VMware ESX virtual
environment. In a VMware ESX virtual environment, only the License Server is supported.
The License Server must be used with a software-based license and not with a dongle-based
license.
Start.bat
An NEC ExpressCluster script that is run when a group starts. The Start.bat file contains
instructions for starting up applications and services controlled by ExpressCluster.
Stop.bat
An NEC ExpressCluster script that is run when a group stops. The Stop.bat file contains
instructions for stopping applications and services controlled by ExpressCluster.
URI
Refers to Uniform Resource Identifier; a generic term for all types of names and addresses that
refer to objects on the World Wide Web. A Uniform Resource Locator (URL) is one type of
URI.
Virtual IP Address
A type of shared IP address for a cluster group. Virtual IP addresses can be on a different sub-
net than the cluster servers, as opposed to Floating IP Addresses.
WAN
Refers to Wide Area Network. A logical network that contains segments separated by routers.
WANs typically span large geographical regions.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 5
Prerequisites
Workstation
Any computer where OnGuard software is installed.
Introduction
NEC offers integrated high availability and disaster recovery software solutions that provide
continuous data mirroring and fast application recovery to maintain the continuity of critical systems
against hardware, software, and site failures. OnGuard supports
• High Availability Systems support includes:
– NEC ExpressCluster X R3 32-bit LAN
– NEC ExpressCluster X R3 32-bit WAN
– NEC ExpressCluster X R3 64-bit LAN
– NEC ExpressCluster X R3 64-bit WAN
Note: For the latest patch sets and service packs supported, refer to the Third Party
Compatibility Chart on the Lenel web site for current NEC ExpressCluster support.
Note: Lenel provides instructions for upgrading the OnGuard software only when the NEC
ExpressCluster X version, operating system, and database version remain constant. For
any other upgrade scenario, we recommend a database backup, the cleansing of both
servers in the cluster, clean installs, database restoration, and then database setup. There
might be operating system and database system upgrade scenarios where very
knowledgeable administrators could avoid erasing the entire configuration, but we
cannot guarantee their support.
NEC ExpressCluster X R3 with OnGuard supports Standard and Enterprise editions of common
database server applications and the following operating systems:
• Database Server: Microsoft SQL Server 2012 SP1 (32-bit and 64-bit)
• Web Server: Microsoft Internet Information Services
• Operating System: Windows Server 2012 R2 64-bit
Notes: For the latest patch sets and service packs supported, refer to the Third Party
Application Compatibility Chart on the Lenel Web site at https://partner.lenel.com/
downloads/onguard/compatibility-charts. (You will need your Lenel login to gain access
to this site.)
When accessing the Downloads section at https://partner.lenel.com, make sure to select
the version of OnGuard that is currently installed.
In addition, NEC provides flexible data protection including full data protection across geographic
locations through its real-time synchronous data mirroring technology.
From a single integrated management console administrators can easily view and monitor current
application and data availability status and events, configure appropriate cluster policies, and
manually activate/deactivate clustered server resources across geographic locations.
6 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Network Requirements
Network Requirements
This guide describes the required installation and configuration to build a disaster tolerant computing
solution for OnGuard in a clustered environment. The installation and configuration procedures
consist of two (2) major stages: the initial setup in a LAN environment, and the (optional) final
deployment in a WAN environment.
For more information about LAN network requirements, refer to Chapter 3: Verifying Deployment
Environment Requirements in the ExpressCluster X R3 for Windows Installation and Configuration
Guide.
Note: For WAN network requirements, this document describes using the same subnet. If you
use a different subnet, please contact PES. For more information about WAN network
requirements, refer to Appendix B: WAN Network Requirements on page 117.
The first stage is performed with all hardware components at a single site where as the WAN
connection is replaced with a temporary, direct LAN connection.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 7
Prerequisites
For WAN customers, only: The second stage (WAN deployment) is performed last to deploy a
previously built cluster to two geographically dispersed locations. For more information, refer to
WAN Deployment Overview on page 8 and WAN Network Requirements on page 117.
8 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Network Pre-Installation
Network Pre-Installation
Note: If the Database Name is not ACCESSCONTROL, you must run the Configuration
Editor to modify the Initial Catalog entry of the ConnectionString and also modify the
default database of your ODBC. With Windows Server 2012 R2, on the Start screen,
begin typing “Configuration Editor,” and then press <Enter> when the program is
located.
• (Optional) Archival Database Name: ACCESSCONTROL_ARCHIVAL
• Lenel Database User Password:
• Primary Server Hostname:
• Primary Public IP Address:
• Primary Public Subnet Mask:
• Primary Public Default Gateway:
• Primary Private IP Address:
• Primary Private Subnet Mask:
• Secondary Server Hostname:
• Secondary Public IP Address:
• Secondary Public Subnet Mask:
• Secondary Public Default Gateway:
• Secondary Private IP Address:
• Secondary Private Subnet Mask:
• Floating IP Address (Cluster Floating IP Address):
• Management IP Address (Management Floating IP Address):
• Virtual Computer Name (Virtual Hostname):
• Failover Group:
• Management Group (By default, the name automatically assigned to Management Group is
“ManagementGroup.”)
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 9
Prerequisites
• The only time the cluster should ever be stopped (as far as this document is concerned) is during
the initial configuration. In this case, start Cluster Manager using http://localhost:29003. In
addition, use localhost to start Cluster Manager when the cluster is already stopped.
• After the cluster is configured, and subsequently started, you should always start Cluster
Manager using http://<Management IP Address>:29003.
Firewall Settings
NEC ExpressCluster X R3 uses several TCP and UDP port numbers. If your Windows firewall is on,
you will need to configure your firewall to enable access to the ExpressCluster X R3 port numbers. A
list of the port numbers used by default in ExpressCluster X R3 is provided in the ExpressCluster X
R3 for Windows Getting Started Guide. Refer to section Before installing ExpressCluster >
Communication port number.
Note: Adobe Reader is required to view the PDF guides. It can be installed from the
Supplemental Materials disc >Prerequisite Software section.
10 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 2 Pre-Installation Setup
Disk Setup
The following procedure must be performed to set up the cluster partition and the data partition
(mirror disk).
Instructions are provided for a Windows Server 2012 R2 64-bit system.
On the Primary Server, complete the following steps:
1. Start the Windows Computer Management Utility using one of the following methods.
• Press the Windows key + <R>, type diskmgmt.msc in the Run dialog, and then click
[OK].
• Press the Windows key + <X> to bring up the advanced context menu, and then select Disk
Management.
• On Windows Server 2012 R2 systems, hover the mouse over the lower left corner of the
Desktop to activate the Start screen icon. Right-click on the icon to bring up the advanced
context menu, and then select Disk Management.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 11
Pre-Installation Setup
2. There will be two disks displayed in the Disk Management tool. The second disk should contain
no partitions. Right-click on the second disk, and then select New Simple Volume.
4. A default volume/partition size is automatically set up; this is, by default, the remaining
unallocated space on the disk. The size of the mirror disk can be set to any size based on the
12 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Disk Setup
overall disk size and user preference, but the size of the mirror disk MUST match on both the
Primary and Secondary Servers.
Specify a volume size of 50 MB, and then click [Next].
5. Assign a drive letter to the drive. We will use “X.” It is not recommended to assign drive “Y”
because it will be used for the data partition. (This is also the drive assignment we use on a non-
clustered system). Click [Next].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 13
Pre-Installation Setup
7. Click [Finish].
14 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Disk Setup
8. After clicking [Finish] you will be returned to the Disk Management tool. The cluster partition of
50 MB is now present. Click on the remaining unallocated space, and then create another New
Simple Volume. This will be the data (mirror) partition.
9. Click [Next].
10. A default partition size is automatically set up; this is, by default, the remaining unallocated
space on the disk. The size of the mirror disk can be set to any size based on the overall disk size
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 15
Pre-Installation Setup
and user preference, but the size of the mirror disk MUST match on both the Primary and
Secondary Servers. Click [Next].
Note: If you use a drive letter other than “Y”, then you may need to modify the start.bat script
if utilizing the ShareDrive example for a shared folder on the mirror drive for archiving
or other purposes.
16 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Disk Setup
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 17
Pre-Installation Setup
IMPORTANT: You must assign the same drive letters on the Secondary Server as were
assigned on the Primary Server.
Network Setup
On the Primary Server:
1. Open Network Connections.
For Windows Server 2012 R2, press the Windows key + <R>, type ncpa.cpl in the Run
dialog, and then click [OK].
2. Depending on your server configuration, you may see different connections. To set up a cluster,
there must be a minimum of two (2) connections. One connection is referred to as Public the
other connection is referred to as Private.
18 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Network Setup
b. Select your Internet Protocol Version (TCP/IP), and then click [Properties].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 19
Pre-Installation Setup
20 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Network Setup
b. Deselect all connections except for Internet Protocol Version (TCP/IP), and then click
[Properties].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 21
Pre-Installation Setup
7. Examine the list to ensure that “Public” is at the top of the list and “Private” follows it directly.
Re-order the connections if necessary.
8. With Windows Server 2012 R2, non-domain-based, network connections, there is a Location
type option for Public or Private. This should not be confused with the names used in this
document for the network connections “Public” and “Private” (interconnect). The Location type
for the interconnect network must be set to “Private.” With WAN configurations, the Private
network is typically a domain type, and therefore cannot be modified.
a. For Windows Server 2012 R2, open the Start screen, and then click the Administrative Tools
icon. In the Administration Tools folder, double-click Local Security Policy.
b. Select Network List Manager Policies, and then double-click the Unidentified Networks
policy in the right panel.
c. Ensure the Location type is Private, and then click [OK].
9. If the Private network is set to the Private Location type AND Inbound connections that do not
match a rule are blocked by default, then set an Inbound Rule to allow connections from the
Remote IP addresses within the Local Subnet. This applies to both servers in the cluster.
10. Repeat steps 1- 9 on the Secondary Server.
IMPORTANT: The network connections must have a different IP address set or else the cluster
will not work. Use the Secondary Public IP Address and the Secondary Private
IP Address, and so on. For more information, refer to Network Configuration
Checklist on page 13.
22 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 3 Configure Windows Settings
• WARNING! • Modifying the registry may cause irreversible damage to your Windows
operating system; make sure to back up the registry before making any
changes. Follow the instructions located at: http://support.microsoft.com/kb/
322756.
Run the Lenel Utility for Express Cluster to automatically configure the Windows settings. The Lenel
Utility for ExpressCluster.exe file is available on the Supplemental Materials disc. For more
information, refer to Running the Lenel Utility for ExpressCluster on page 27.
Prerequisite: You must install .NET Framework 3.5 (includes .NET 2.0 and 3.0) before running the
Lenel Utility for Express Cluster.
In order for the utility to execute specific registry or file modifications (actions), the application must
have knowledge of key pieces of information. This is why some actions are disabled until you use the
application to detect the required information from the system. For more information, refer to
Dependencies: Information Required to Enable an Action on page 24.
Miscellaneous Information
• If you have multiple versions of the Java Runtime installed, you will be prompted to select the
appropriate one.
• If you have detected the Java Runtime Version, and you instruct the application to modify the
Java Policy, you will be prompted to specify which Java Policy File to modify (either the one for
your current Windows login, or the global policy for the Java Runtime Version specified).
• The application will prompt you for the network adapter in your system which is the Private NIC.
This is the one where you would modify the TcpAckFrequency.
• Private NIC GUID refers to the Interconnect. GUID is the same connection setup as the
Interconnect. When using the utility, <Primary Private IP Address> and <Secondary Private IP
Address> are the values that allow you to determine which of the GUIDs are presented when the
Private NIC GUID is detected by matching the IP address listed in the Multiple Resources
window
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 23
Configure Windows Settings
java.policy file Policy for ExpressCluster Builder With only the Management Port
Number detected, entries can be
made to the policy files for
“localhost.” However, if the
Management IP Address is also
detected, an additional entry will
be made to the policy files for it as
well. This is the recommended
course of action.
If you have the Java Runtime
Version detected, you can either
modify the user's java.policy file
or the global java.policy file.
Registry Modifications
24 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Miscellaneous Information
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 25
Configure Windows Settings
File Modifications
26 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Miscellaneous Information
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 27
Configure Windows Settings
b. If you Detect Java Runtime Version, the system prompts you to select the Java Runtime
Version in order to modify the global Java policy file:
28 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Miscellaneous Information
IMPORTANT: For the Java Policy to take effect, all open instances of your browser must be
closed.
6. (Optional) Rather than executing each action individually, use either or both of the following
options:
a. Click [Do All Registry Changes] to execute all registry actions currently enabled.
b. Click [Do All File Changes] to execute all file updates currently enabled. The utility uses the
INCORRECT setting for DB Connection (the application.config file); you need to specify
the <Virtual Computer Name>.
Note: Most registry modifications (except Login Driver Location Settings and Vinca
Setting), require a cluster reboot to make the registry settings take effect.
7. Reboot the cluster. From the Cluster Manager, right-click on <Cluster Name> in the tree view,
and then select Reboot. If necessary, start the cluster before rebooting it.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 29
Configure Windows Settings
30 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Miscellaneous Information
Note: Executing these actions now allows you to log into SQL via the <Virtual Computer
Name> using Windows Authentication. This is important for the OnGuard
configuration.
e. (Optional) Detect Management Port Number, Detect Management IP Address, and
Detect Java Runtime Version. Execute Java Policy File, and ExpressCluster Manager
Internet Favorite.
Notes: The Java Policy File may have been manually configured by the user at this point,
since minimal configuration would have been required to build the cluster.
ExpressCluster Manager Internet Favorite is not required and is included for
convenience only.
Note: If this is a fresh installation, and everything was done properly, modifying the ACS.INI
and application.config files should not be necessary. These functions are provided
primarily for upgrade scenarios and for situations where the user may not have provided
the correct values for the License Server and Database Server locations when installing
the OnGuard software.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 31
Configure Windows Settings
32 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 4 Cluster Setup
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 33
Cluster Setup
3. On the welcome window, click [View License Agreement] to read the agreement, and then click
[Install] to accept the agreement and continue installing the JRE.
34 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Install ExpressCluster X R3
Install ExpressCluster X R3
1. Starting on the Primary Server, insert the ExpressCluster X R3 installation disc into the disc drive
to start the installation procedure. Click [Next].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 35
Cluster Setup
36 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Install ExpressCluster X R3
5. Click [Next].
6. Select the I accept the terms of the license agreement radio button, and then click [Next].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 37
Cluster Setup
8. Click [Next].
38 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Install ExpressCluster X R3
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 39
Cluster Setup
11. The system must be restarted to become functional. Select the Restart System check box, and
then click [Finish].
12. After the installation, open the License Manager to register the licenses.
a. Start License Manager. For more information, refer to “Locating Operating System
Applications in Windows” in the OnGuard Installation Guide.
b. Click [Register] to register the EXPRESSCLUSTER X 3.1 for Windows license.
40 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Install ExpressCluster X R3
13. Click [Register with License Information] and then enter the information for the license you are
registering as prompted. This information is included with your installation package.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 41
Cluster Setup
16. Enter the Serial No. and License Key information as provided on the NEC license sheets, and
then click [Next].
42 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Install ExpressCluster X R3
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 43
Cluster Setup
20. Click [Register with License Information], and then enter the information for the license you are
registering as prompted. This information is included with your installation package.
21. Select “EXPRESSCLUSTER X Replicator 3.1” from the Product information list, and then click
[Next].
44 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Install ExpressCluster X R3
22. Enter the Serial No. and License Key information as provided on the NEC license sheets, and
then click [Next].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 45
Cluster Setup
26. Repeat the installation and license registration instructions on the Secondary Server.
IMPORTANT: After the cluster is configured (and subsequently started), the cluster is
accessed using http://<Management IP Address>:29003. For more
information, refer to Starting Cluster Manager on page 9.
46 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
3. You will be prompted to edit the Java security file. Select the code provided in the lower section
of the window, and the press <Ctrl> + <C> to copy the code.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 47
Cluster Setup
6. Paste the copied code into the java.policy file, and then save the file. Close the text editor.
7. (Optional) You can also add code to the Java security file for each of the following items:
• If the java.policy file is on the clustered server:
– - localhost by IP address (127.0.0.1)
– - localhost by name
• Primary Server Hostname
• Secondary Server Hostname
• Management IP Address (This is the most important item in addition to the localhost!)
• Floating IP Address
48 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
IMPORTANT: step 4 - step 6 describe how to modify the global Java policy file which affects
all users that log into the server. Although this is the recommended method, it
may be considered a security risk. This is why NEC ExpressCluster X instructs
you to modify the user’s Java policy file. Use the method that best suits your
requirements.
8. Close all open browser windows. Start your browser again, and then navigate to http://
localhost:29003.
9. The Confirm dialog is opened. Click [Start cluster generation wizard]. Alternatively, you can
perform this operation from the File menu by selecting Cluster Generation Wizard.
10. Start the Cluster Generation Wizard for the standard edition.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 49
Cluster Setup
11. The Cluster Generation Wizard is opened. It is now time to build your cluster.
12. In the Cluster Name field, type the <Cluster Name>. In the Management IP Address field,
type the <Management IP Address>. Once assigned, the cluster name cannot be changed. Click
[Next].
50 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
13. The Server Definition List is automatically populated with the <Primary Server Hostname>. In
this example, the hostname used for our Primary Server is “qa-nec1.”
From here, other servers are added to the cluster. Click [Add].
Note: Before performing step 14, make sure the NEC ExpressCluster firewall ports are open.
14. When the Add Server dialog is opened, type the <Secondary Server Hostname> in the Server
Name or IP Address field, and then click [OK].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 51
Cluster Setup
15. Configure the Interconnect for the servers in the cluster. Click [Next].
16. The <Primary Private IP Address>, <Primary Public IP Address>, <Secondary Private IP
Address>, and <Secondary Public IP Address> are automatically added.
Note: <Primary Private IP Address> is the Primary Interconnect and <Primary Public IP
Address> is the Secondary Interconnect. The Private IP Address is used for disk
mirroring.
52 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
17. Select the mirror disk connect (MDC column) name to be allocated to the data communication
route, and move “mdc1” [Up] to configure it as Priority “1”. Click [Next].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 53
Cluster Setup
20. The Group Definition window is opened. Ensure that “failover” is the group Type, and then enter
the failover group Name. “OnGuard” is used for our system. Click [Next].
54 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
21. In the this window, because Failover is possible on all servers is enabled, it is not necessary to
select the group that can run the group or configure the priority of the servers. Click [Next].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 55
Cluster Setup
24. The Group Resource Definitions window is opened. Select “floating ip resource” as the Type.
Click [Next].
56 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 57
Cluster Setup
27. Type the <Floating IP Address> in the IP Address field. This value will be used for any
programs, services, etc. that need to access the cluster. Click [Finish].
28. The floating IP address resource is set up. Click [Add] to add another resource.
58 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
29. From the Type drop-down, select “mirror disk resource” and enter the Name of this resource.
Click [Next].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 59
Cluster Setup
32. On the next window, click [<Add] with the Primary Server selected.
60 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
34. The connection information is displayed for the Primary Server partitions.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 61
Cluster Setup
62 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
36. The Selection of partition window is opened. Click [Connect] for the Secondary Server.
37. The connection information is displayed for the Secondary Server partitions.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 63
Cluster Setup
38. The data and cluster partitions are now configured for both servers that will run the group. Click
[Finish].
64 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
39. Configuration of the mirror disk resource is complete. Click [Add] to add another resource.
40. From the Type drop-down, select “virtual computer name resource” and enter the Name of this
resource. Click [Next].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 65
Cluster Setup
66 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
43. In the Virtual Computer Name field, enter the <Virtual Computer Name>, and then select the
Target FIP Resource Name. Click [OK].
44. That completes configuring the virtual computer name resource. Click [Finish].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 67
Cluster Setup
68 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
49. From the File menu, select Apply the Configuration File.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 69
Cluster Setup
50. You will be prompted to confirm the configuration change operations. If you want to use an IP
address other than the one currently being connected to, click [Select IP]. Otherwise, click [OK]
to continue.
51. After the configuration is successfully applied, another prompt is displayed to confirm restarting
the WebManager. Click [OK] to restart the manager service. WebManager refers to the NEC
ExpressCluster X web management console. You may also know it as the “Cluster Manager.”
70 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
53. Start the cluster. From the Service menu, select Start Cluster.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 71
Cluster Setup
72 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure the Cluster
56. Before moving the Failover Group, verify that the Failover Group (OnGuard) can be moved
between the two servers by completing the following steps:
a. Make sure the mirror disk is synchronized. Expand the Failover Group, and then right-click
on the “md” resource, and then select Details.
b. The Mirror Disk Help(md) dialog is opened. The status text “Mirror disk is in the normal
status now” is displayed when the mirror disk is synchronized.
c. Click [Close].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 73
Cluster Setup
• WARNING! • After verifying the failover group can be moved successfully to the Secondary
Server, be sure to failover over to the Primary Server before continuing.
74 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 5 Install Microsoft SQL Server
OnGuard with NEC ExpressCluster X R3 supports Microsoft SQL Server 2012 Standard and
Enterprise Editions.
This section provides instructions for installing SQL Server 2012 Standard Edition.
The latest approved SQL Server 2012 SP1 service packs should also be installed. For specific
information, refer to the Third Party Compatibility Chart on the Lenel Web site at: https://
partner.lenel.com/downloads/onguard/compatibility-charts.
Notes: When accessing the Downloads section at https://partner.lenel.com, make sure to select
the version of OnGuard that is currently installed.
Do NOT restart your computer after the cluster is set up. Whenever prompted to restart
your computer, use the Cluster Manager to reboot the cluster instead.
SQL Server and OnGuard is installed on both servers, starting on the Primary Server.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 75
Install Microsoft SQL Server
76 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure SQL Server on the Primary Server
Create a Login
1. In the Object Explorer pane, expand the Security folder.
2. Right-click the Logins folder, then select New Login.
3. In the General page of the Login window:
a. In the Login name field, type LENEL.
b. Select the SQL Server authentication radio button.
• For Password, type the Lenel Database User Password Secur1ty# (OnGuard 7.0 and
later) or MULTIMEDIA (OnGuard 6.6 and earlier).
• For Confirm password, type the Lenel Database User Password Secur1ty#
(OnGuard 7.0 and later) or MULTIMEDIA (OnGuard 6.6 and earlier).
IMPORTANT: If you select the Enforce password expiration check box, you will be
required by SQL Server to select a new login password at regular intervals.
When the login password is changed by SQL Server, it must also be updated
with the LS Login Driver. Failure to update the Login Driver will cause
OnGuard not to function properly.
4. In the Server Roles page of the Login window, we recommend that you select the following
check boxes:
• Most users should select dbcreator, serveradmin, and public.
• Advanced users should only select the public check box.
5. In the User Mapping page of the Login window:
a. Select the following databases from the Users mapped to this login list:
• master
• tempdb
b. Make sure the Database role membership for each has Public selected.
c. Click [OK].
6. (Optional) For advanced users who do not want the database owned by lenel, complete the
following steps:
a. In the Object Explorer pane of SQL Server Management Studio, right-click on the OnGuard
database you just created and select New Query. A query tab is shown.
b. In the text window, type:
• CREATE ROLE db_executor
• GRANT EXECUTE TO db_executor
c. Press <F5> to execute the command.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 77
Install Microsoft SQL Server
Note: At this point the lenel user provides OnGuard functionality only. Any database level
administration, such as backups and restores, must be performed by a different user with
the appropriate permissions.
78 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure SQL Server on the Primary Server
Note: This procedure requires that the Recovery Model is set to “Full” on the Database
Properties > Options page.
1. In the Object Explorer pane of SQL Server Management Studio, right-click on the
ACCESSCONTROL database, and then select Tasks > Shrink > Files.
2. The Shrink File window is opened.
a. In the File type drop-down, select “Log.”
b. Ensure the Release unused space radio button is selected.
c. Click [OK].
• WARNING! • Now that SQL Server is configured on the Primary Server, make sure your
next step is to install OnGuard on the Primary Server. For more information,
refer to Install OnGuard on the NEC Server on page 83.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 79
Install Microsoft SQL Server
• WARNING! • Ensure SQL Server and OnGuard are installed and configured on the Primary
Server before completing the following steps on the Secondary Server.
1. Make sure the Secondary Server is active and the SQL Server services are started.
2. Open SQL Server Management Studio.
• For more information, refer to “Using OnGuard on Supported Operating Systems” in
the Installation Guide.
• When the Connect to Server window is displayed, enter the <Virtual Computer Name>
in the Server name field, and then click [Connect].
3. In the Object Explorer pane, right-click on the <Virtual Computer Name> server, and then select
New Query.
a. Add the “Lenel” login using the previously saved SID by typing the following commands in
the query editor:
create login Lenel with password='Secur1ty#',
check_policy=off, check_expiration=off, sid=<SID obtained
from Primary Server>;
Exec sp_addsrvrolemember 'Lenel', 'dbcreator';
Exec sp_addsrvrolemember 'Lenel', 'serveradmin';
Notes: This statement creates the user and automatically disables the “Enforce Password
Policy” and “Enforce Password Expiration” options in the properties of the newly
created SQL user. This should be done because the default Lenel user password is often
invalid on many systems that enforce more complicated password policies. In addition,
the password expiration policy is NOT enforced because OnGuard would stop working
if the password expires and no one logs into SQL to update and then re-synchronize the
Login Driver.
The default Lenel user password is “Secur1ty#” for OnGuard 7.0 and later, and is
“MULTIMEDIA” for OnGuard 6.6 and earlier.
The SID obtained from Primary Server is the same as the SID obtained for user Lenel
on the Primary Server.
80 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure SQL Server on the Secondary Server
Note: This procedure requires that the Recovery Model is set to “Full” on the Database
Properties > Options page.
1. In the Object Explorer pane of SQL Server Management Studio, right-click on the
ACCESSCONTROL database, and then select Tasks > Shrink > Files.
2. The Shrink File window is displayed.
a. In the File type drop-down, select “Log.”
b. Select the Release unused space radio button.
c. Click [OK].
3. Repeat steps 1 and 2 for the ACCESSCONTROL_ARCHIVAL database.
• WARNING! • Now that SQL Server is configured on the Secondary Server, make sure your
next step is to install OnGuard on the Secondary Server. For more information,
refer to Install OnGuard on the NEC Server on page 83.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 81
Install Microsoft SQL Server
82 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 6 Install OnGuard on the NEC Server
This section takes you through the installation process for the OnGuard software. Read all of the
instructions carefully, and then proceed in the order presented.
Overview
IMPORTANT: The OnGuard software and OnGuard license must be installed on the Primary
Server and Secondary Server.
To install OnGuard, perform the following instructions:
1. Before you install OnGuard, you must install the third-party requirements from the Supplemental
Materials disc onto the active server. Windows service packs are also required but are not
provided on the Supplemental Materials disc. Refer to the Third Party Compatibility Chart on the
Lenel Web site to determine which service packs are required for your operating system. Adobe
Reader is not required but highly recommended as you need it to read the OnGuard
documentation.
2. Complete steps 1 and 2 in “OnGuard 7.1 Installation Prerequisites” in the Installation Guide.
3. Complete the steps in “Configure a USB Hardware Key” in the Installation Guide but do NOT
“Restart your computer” if prompted to do so.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 83
Install OnGuard on the NEC Server
Install OnGuard
1. Complete the steps in “Install the OnGuard 7.1 Software” in the Installation Guide.
Note: On the System Location Information window, do NOT accept the default locations for
your database and License Server. Instead, enter your <Virtual Computer Name> in the
Provide the location of your License Server and Provide the location of your
database fields.
2. After OnGuard is installed, when prompted, do NOT “Restart your computer.”
3. If Setup Assistant launches, click [Close].
4. Reboot the cluster from Cluster Manager.
5. If you installed OnGuard on the Primary Server:
a. Log into Windows. The Setup Assistant will launch automatically.
b. Cancel the Setup Assistant, and then restart the SQL Server (MSSQLSERVER) service.
c. Manually run the Setup Assistant.
6. If you installed OnGuard on the Secondary Server:
a. On the Primary Server, log into Windows, and then failover to the Secondary Server.
b. On the Secondary Server, log into Windows. The Setup Assistant will launch automatically.
c. Cancel the Setup Assistant, and then restart the SQL Server (MSSQLSERVER) service.
Click [Yes] to confirm, and then click [Close].
d. Manually run the Setup Assistant.
7. If you selected the LS Platform Services as a custom installation, then configure its settings. For
more information, refer to Configure the LS Platform Services on page 87. Do NOT run Form
Translator.
8. If using Integrated Security = SSPI (an application.config setting), you must complete the
“Configure Windows Authentication with SQL Server” steps in the Installation Guide.
9. Depending on the components you chose to install, you may need to restart the cluster. If you are
prompted to do so, use the Cluster Manager to reboot the cluster.
10. After SQL Server and OnGuard are installed, stop their services and set them to “Manual”
startup. SQL Server service names generally begin with “SQL Server.” OnGuard service names
begin with “LS”, “Lps”, or “Lnr.”
11. If you installed OnGuard with Enterprise or Open Access, update the MessageBroker.config file
to use the <Virtual Computer Name> for SSL. For more information, refer to Update the
MessageBroker.config File for SSL on page 85.
12. Run the Lenel Utility for ExpressCluster using the steps in After OnGuard Setup on page 31.
13. If you installed OnGuard on the Primary Server, failover to the Secondary Server, and then set up
the OnGuard environment on the Secondary Server. For more information, refer to Set Up the
OnGuard Environment on the Secondary Server on page 76.
14. (Optional) If you installed OnGuard on the Secondary Server, and chose to create an archival
database, configure the archival database. For more information, refer to Configure the Archival
Database in OnGuard on page 84.
84 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Install OnGuard
Note: This is not required if you will be using your own self-signed certificates.
1. In the command prompt, execute the following command:
lnl_app_server_certificate_installer.exe -
key=DRIVE:\\PATH\\TO\\nginxConfFile\\og_cert_key.pem -
cert=DRIVE:\\PATH\\TO\\nginxConfFile\\og_cert.pem -store="LS
Certificate Store" -cn=<virtual computer name>
Note: The default file location of the .exe file is C:\program files
(x86)\OnGuard\LSP\Certificates\ and the default location of the nginx.conf file is
C:\ProgramData\Lnl\nginx\conf\.
2. Navigate to and open the MessageBroker.config file is located by default at
C:\ProgramData\Lnl\.
3. Edit the following line and uncomment the line by removing the "#" character from the
beginning.
ssl-cert-name=<virtual computer name>
4. Save the file, and then restart the services.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 85
Install OnGuard on the NEC Server
86 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 7 Configure the LS Platform Services
Complete the steps for Configuring the LS Platform Services in the Installation Guide except for the
following:
• Wherever the physical server name is referenced, use the <Virtual Computer Name> instead.
However, in “Database Authentication for Web Applications (Add the Windows user to SQL
Server)” it specifies to add the server-name\username login to SQL Server. In this case, use either
the actual server name or a domain name.
• For the Area Access Manager and VideoViewer browser-based applications:
Use the <Virtual Computer Name> as the URL rather than the name of the physical server which
is the default setting. Modify the C:\inetpub\wwwroot\lnl.og.web\Preferences.js
g_lnl_pfx_webservice_serverAddress to use the Virtual Computer Name.
• In the Web Visitor Management AdminApp for the clustered servers, modify the default physical
server name in the SilverlightApplicationConfiguration.xml file in
C:\inetpub\wwwroot\AdminApp\ to the fully qualified <Virtual Computer Name>. For more
information, refer to “Update the URL” in the Visitor Administration User Guide.
• If the Visitor Management Host is being served, modify the default physical server name in the
FlexApplicationConfiguration.xml file in C:\inetpub\wwwroot\Lnl.OG.ServicesWebHost\
to the fully qualified <Virtual Computer Name>. For more information, refer to “Update the
URL” in the Visitor Management Host User Guide.
• If the Visitor Management - Front Desk is being served, modify the default physical server name
in the serviceModelClient.config.deploy file in C:\inetpub\wwwroot\<ClickOnce
directory>\config to the fully qualified <Virtual Computer Name> twice. For more information,
refer to “Server Name” in the Visitor Management Front Desk User Guide.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 87
Configure the LS Platform Services
Note: In an NEC cluster environment, because <Virtual Computer Name> is used as the host
name, IIS version 7.0 does not allow the host name to be set for HTTPS bindings by
default. To workaround this, you need to set a “friendly name” for the SSL certificate
that begins with an asterisk “*” such as “*ynec2.qalab.lenel.com.”
Set the friendly name for the SSL certificate:
1. Start Microsoft Management Console by typing mmc at the command prompt or in the Run
dialog.
2. Add the Certificates snap-in for the computer account and the local computer.
a. From the File menu, select Add/Remove Snap-in.
b. On the Standalone tab, click [Add]. The Add Standalone Snap-in window is opened.
c. Select “Certificates” from the available snap-ins, and then click [Add].
d. Select the Computer account radio button, and then click [Next].
e. Select the Local computer radio button, click [Finish], and then [Close].
3. In the tree, expand Certificates, and then select Personal > Certificates.
4. Right-click on the SSL certificate, and then select Properties.
5. Add a “*” to the beginning of the Friendly name, and then click [OK].
88 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Configure Host Header Value
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 89
Configure the LS Platform Services
90 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 8 Script Setup
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 91
Script Setup
92 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Add a Script Resource
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 93
Script Setup
94 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Add a Script Resource
6. Click [Next].
7. Click [Next].
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 95
Script Setup
8. From the Scripts list, select “Start script” and then click [Replace].
9. Navigate to the scripts folder and select start.bat, then click [Open]. This file is located on the
Supplemental Materials disc in: High Availability\NEC\ExpressClusterScripts\.
96 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Add a Script Resource
13. Navigate to the scripts folder and select the stop.bat file, and then click [Open]. This file is
located on the Supplemental Materials disc in: High Availability\NEC\ExpressClusterScripts\.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 97
Script Setup
17. From the File menu, select Apply the Configuration File.
98 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Add a Script Resource
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 99
Script Setup
23. After the cluster finishes refreshing, start the cluster. From the Service menu, select Start Cluster.
25. After the cluster starts, the group script should be green indicating that it is started and running
correctly.
100 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Add a Script Resource
26. Move the Failover Group to the other server to verify the services start successfully there as well.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 101
Script Setup
102 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 9 WAN Deployment
Notes: Professional Engineering Services (PES) are required for NEC ExpressCluster X R3
LAN and WAN systems.
For WAN deployment, this document describes using the same subnet. If you use a
different subnet, please contact PES. For more information, refer to Appendix B: WAN
Network Requirements on page 117.
After a cluster has been properly installed and configured in the LAN environment, then the
following steps are performed to prepare the cluster for deployment in the WAN environment:
1. From the Cluster Manager, stop the cluster from Cluster Manager:
a. Right-click on <Virtual Computer Name> in the tree view, and then select Service > Stop
Cluster.
b. Click [Yes] when prompted to confirm.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 103
WAN Deployment
2. Ship the Secondary Server and the other Secondary system elements, including the storage and
WAN routers, to the final Secondary site.
3. (Optional) The Primary Server can be shut down from Cluster Manager and shipped along with
the other Primary system elements to the final Primary site. Then it can be restarted.
4. If the Primary Server is fully operational at the final Primary site, and the Secondary Server has
arrived at the final Secondary site, then the Secondary Server can be restarted from NEC
ExpressCluster.
5. Return the Secondary Server to the cluster from the Cluster Manager. Data differences between
the Primary Server and Secondary Server will be resolved and synchronized in this process.
Assuming little or no data differences exist between the servers, the process should only take a
few minutes. When the process completes, the cluster will be in a fully functional state.
104 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
CHAPTER 10 Upgrading OnGuard on NEC Systems
This section provides instructions for upgrading OnGuard software only when the NEC
ExpressCluster edition, the operating system, and the database version remain constant. For any other
upgrade scenario, we recommend a database backup, the cleansing of both servers in the cluster, clean
installs, database restoration, and then database setup. There may be operating system and database
system upgrade scenarios where very knowledgeable administrators could avoid erasing the entire
configuration, but we cannot guarantee their support.
IMPORTANT: Only individuals who are highly knowledgeable about NEC ExpressCluster X
R3 systems should perform the upgrade procedures.
Upgrading OnGuard consists of upgrading the software, the licenses (if a major upgrade), and
potentially the NEC start and stop scripts.
For more information, refer to the Introduction in the Upgrade Guide for a list of processes that must
be completed before beginning an upgrade of the OnGuard software.
IMPORTANT: Make sure to backup the OnGuard database. It is CRITICAL you have an up-
to-date backup of the database before beginning the upgrade or service release
process.
Prerequisites:
• OnGuard no longer supports Apollo hardware. Therefore, you must decommission any Apollo
hardware in the field and delete them from System Administration before upgrading or else the
upgrade will not work.
• If you are using any custom .dll files, you must back these up prior to upgrading the OnGuard
software.
• Before installing a service release:
– Make sure you can open the OnGuard applications on the Secondary Server without any
problems while the Primary Server is active.
– Verify the prerequisites found in the Upgrade Guide and, if part of an Enterprise
configuration, the Upgrading to OnGuard 7.1 Enterprise chapter in the Enterprise Setup &
Configuration User Guide have been met.
1. Start Cluster Manager.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 105
Upgrading OnGuard on NEC Systems
2. Verify the <Failover Group> is located on the Primary Server and both nodes are ONLINE
(green).
3. A new license must be installed on the Primary Server and Secondary Server. Install the new
licenses by completing the following steps:
a. On the Primary Server, start and log onto the OnGuard License Administration application.
b. Install the new license for the Primary server. After you have added this license, the old
license and the new license will both be listed in the Installed Licenses drop-down. Leave
the old license installed and log out of License Administration.
c. Move the <Failover Group> to the Secondary Server. The Secondary Server becomes
active.
d. Repeat steps a and b on the Secondary Server to install the new Secondary Server license.
e. Move the <Failover Group> back to the Primary Server.
4. On the Secondary Server:
a. In Cluster Manager, right-click on the Secondary Server, and then select Service > Stop.
b. Verify that all OnGuard services are stopped.
c. Install the upgrade or the service release. The system may prompt you to install applications
required for this version of the OnGuard software. After each application is installed, a
reboot will be required causing the Secondary Server to automatically rejoin the cluster.
Each time the Secondary Server rejoins the cluster, stop it before continuing.
d. Verify the Secondary Server has returned to the cluster. If it has not started, from Cluster
Manager, right-click on the Secondary Server, and then select Service > Start.
e. Use the Configuration Editor to verify that the ConnectionString setting in the
application.config file specifies the <Virtual Computer Name> rather than the <Secondary
Server Hostname> for the Data Source. For more information, refer to the Configuration
Editor appendix in the OnGuard Installation Guide.
f. If using Windows authentication, reconfigure the method used for authenticating with the
database. Examine the authentication settings for SQL Server to reconcile any differences
from earlier versions to the current software. For more information, refer to “Database
Authentication for Web Applications” in the Installation Guide.
g. If this is part of an Enterprise configuration or you are using Open Access, update the
MessageBroker.config file to use the <Virtual Computer Name> for SSL. For more
information, refer to Update the MessageBroker.config File for SSL on page 85.
h. When the installation of the upgrade or service release is completed, because the upgrade or
service release may start the OnGuard services, ensure the OnGuard services are set to
“Manual” and stopped.
i. Run Database Setup from the Secondary Server while the Primary Server is still active.
5. Stop the Primary Server. Right-click on the Primary Server, and then select Service > Stop. This
action should have the additional affect of moving the <Failover Group> and <Management
Group> to the Secondary Server.
6. On the Primary Server:
a. Verify all OnGuard and SQL Server services are stopped.
b. Install the upgrade or the service release. The system may prompt you to install applications
required for this version of the OnGuard software. After each application is installed, a
reboot may be required causing the Primary Server to automatically rejoin the cluster. Each
time the Primary Server rejoins the cluster, stop it before continuing.
c. Use the Configuration Editor to verify that the ConnectionString setting in the
application.config file specifies the <Virtual Computer Name> rather than the <Primary
106 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Server Hostname> for the Data Source. For more information, refer to the Configuration
Editor appendix in the Installation Guide.
d. If using Windows authentication, reconfigure the method used for authenticating with the
database. Examine the authentication settings for SQL Server to reconcile any differences
from earlier versions to the current software.
e. If this is part of an Enterprise configuration or you are using Open Access, update the
MessageBroker.config file to use the <Virtual Computer Name> for SSL. For more
information, refer to Update the MessageBroker.config File for SSL on page 85.
f. When the upgrade or service release is completed, because the upgrade or service release
may start some of the OnGuard services, ensure all OnGuard services are set to “Manual”
startup and stopped.
7. Reboot the Primary Server. This action will also rejoin the Primary Server to the cluster.
8. On the Secondary Server:
a. At this point, you should note any NEC start and stop script customizations you may have.
b. Replace the existing start and start script files with the latest versions from the Supplemental
Materials disc and re-apply the customizations. This is also where you should be cognizant
of potential service name changes such as changing “LS OpenIT” to “LS DataConduIT.”
c. Upload the Configuration File.
d. Restart Cluster Manager. Wait approximately 15 seconds until it refreshes.
e. From the Service menu, select Stop Cluster.
f. From the Service menu, select Start Cluster. Specify the Secondary Server if given a choice
to do so.
g. Verify that you can successfully log onto the OnGuard applications on the Secondary Server.
h. Failover to the Primary Server:
• Right-click on the <Failover Group>, and then select Move.
• In the Move window, select the Primary Server.
9. Verify you can successfully log onto the OnGuard applications on the Primary Server.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 107
Upgrading OnGuard on NEC Systems
108 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Appendices
APPENDIX A Ping Resource Configuration
ExpressCluster X R3 has an additional resource available that helps to prevent a split-brain scenario
where both servers in a cluster start their services because they lose communication with each other.
This resource works by pinging a shared resource to determine whether there has been a site or
network outage and determines whether or not the other server should start based on it's ping results.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 111
2. Click [OK] to confirm.
112 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
3. Change to Config Mode, and then open the cluster properties. Right-click on the Cluster Name
cluster, and then select Properties.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 113
4. After the properties open for the cluster, select the NP Resolution tab, and then add the ping
resource as follows:
a. Select “Ping” as the Type.
b. Enter an IP address for the Ping Target. This IP address should be an address that can be
seen from both systems and is always up. A good example of an address to use is that of a
router.
c. Specify which of the servers will monitor the ping resource by selecting “Use” for that
server, and then click [OK].
5. When you are returned to Cluster Manager, from the File menu, select Apply the Configuration
File.
6. When you are prompted to confirm the operation, click [Yes] to continue.
114 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
8. Click [Yes] to enable the recovery action.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 115
116 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
APPENDIX B WAN Network Requirements
Note: Professional Engineering Services (PES) are required for NEC ExpressCluster X R3
LAN and WAN systems.
NEC ExpressCluster X R3 WAN has the following basic network requirements for each cluster of
two (2) servers (Primary and Secondary) that must be met in order to enable full DR (disaster
recovery) functionality and ensure the proper operation of the NEC ExpressCluster X R3 WAN
system:
• Requirement 1 on page 118
A logical IP protocol network that spans two sites (Primary and Secondary) must be available to
be used as the Public network to enable transparent migration of virtual server identity between
the Primary and Secondary systems.
• Requirement 2 on page 119
Proper IP protocol network routing between the client systems and the Public network must be
configured to enable network communications between client and server systems.
• Requirement 3 on page 120
Proper IP protocol network routing between the server systems and the Private (Interconnect)
network must be configured to enable cluster specific network communication between the
Primary and Secondary Servers.
• Requirement 4 on page 120
For synchronous data mirroring: Private network round trip time (RTT) for 1500-byte PING
packets must be 70 milliseconds or less to ensure proper operation of ExpressCluster X WAN
and the target application. For asynchronous data mirroring: Private network RTT for 1500-byte
PING packets should be low enough to meet sustained target application transaction performance
requirements to minimize risk of excessive data loss in case of system failure.
• Requirement 5 on page 121
For synchronous data mirroring: Private network bandwidth must be 1.5 Mbps or greater to meet
sustained target application transaction performance requirements. For asynchronous data
mirroring: Private network bandwidth must be high enough to meet sustained target application
transaction performance requirements to minimize the risk of excessive data loss in case of
system failure.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 117
Implications and Recommendations
In general, if a customer network infrastructure does not meet the network requirements, then
professional network consulting services would be required to analyze the existing network
infrastructure, design the necessary network infrastructure changes, and implement the designed
network changes using specific network equipment.
The following sections provide some of the implications and recommended methods to meet the
network requirements in a generic context that may or may not be appropriate for a specific
deployment.
Requirement 1
Figure 1 on page 118 shows a basic LAN configuration within the same data center that meets this
requirement. Figure 2 on page 118 shows an example of a basic WAN configuration that also meets
this requirement. In a typical WAN environment, this requirement usually means that a dedicated
virtual network (for example, VLAN or VPN) has to be in place between the Primary and Secondary
sites. Generally, dedicated routers or switches are required to implement the virtual network using
layer 2 or layer 3 network protocols.
FIGURE 1. NEC ExpressCluster X R3 LAN network configuration within the same data center
FIGURE 2. NEC ExpressCluster X R3 WAN network configuration for sites sharing common subnets
118 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Implications and Recommendations
Examples of commercial routers that could be used to implement the virtual network include Cisco
routers running Cisco IOS v12.0 and later (for example, Cisco 1711) which can support layer 3 VPN
(for example, IPSec) or layer 2 VPN (for example, L2TPv3). A more advanced configuration
example using VPN routers is shown in Figure 3 on page 119.
FIGURE 3. Recommended NEC ExpressCluster X R3 WAN network configuration for sites with separate local
subnets
In general, customer organizations may have multiple groups managing the IT infrastructure so
approval to implement virtual networks using specific network equipment and protocols may require
explicit authorization from multiple groups besides the group purchasing ExpressCluster X WAN.
Understanding and coordination of customer organization groups and processes is critical to
successful deployment.
Requirement 2
This requirement is meant to ensure proper network communication can occur between client systems
residing on separate logical networks from the logical networks of the servers. It is a general
requirement and fundamental to all IP network communication as well as being a technically simple
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 119
objective to accomplish. However, depending on the customer organization, approval from multiple
groups may be required to implement changes to customer network routers to enable the necessary
network communication.
If for some reason the necessary routing is not obtainable then a possible workaround is to connect all
relevant client systems directly to the same logical network as the servers and assign the addresses to
the client systems from the same logical network as the servers. An example is shown in Figure 4 on
page 120.
FIGURE 4. Workaround for NEC ExpressCluster X R3 WAN network configuration for sites with separate local
subnets
Requirement 3
This requirement is intended to ensure that proper network communication can occur between the
Primary and Secondary Server for the cluster health check and data mirroring. It is a general
requirement and fundamental to all IP network communication as well as being a technically simple
objective to accomplish. However, depending on the customer organization, approval from multiple
groups may be required to implement changes to customer network routers to enable the necessary
network communication.
Requirement 4
For synchronous data mirroring usage, ExpressCluster X WAN requires the Private (Interconnect)
network round trip latency (RTT) to be 70 ms or less for reliable operation. Furthermore, lower RTT
may be required in order to meet target applications transaction performance requirement.
For asynchronous data mirroring usage, ExpressCluster X WAN does not have a strict Private
network RTT requirement, but significant data loss risk will increase if the RTT becomes much larger
than the typical target application transaction time as more data will be queued on the local server.
120 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Implications and Recommendations
Requirement 5
For synchronous mirroring usage, ExpressCluster X WAN requires an available Private network
bandwidth of 1.5 Mbps or greater. Furthermore, higher available network bandwidth may be required
to meet the target application transaction performance requirement.
For asynchronous data mirroring usage, ExpressCluster X WAN does not have a strict Private
network available bandwidth requirement, but significant data loss risk will increase if the available
network bandwidth becomes much lower than the typical target application transaction data rate as
more data will be queued on the local server.
A general rule of thumb for available network bandwidth is that the raw available network bandwidth
should be at least three (3) times the required average application data rates. For example, if target
application expects to process 10 2 KBytes transactions per second, then the required network
bandwidth would be 40 KBytes (-2*10*2KBytes) per second which in turn means (assuming a 10x
conversion from raw data bytes to network packet bits) 400 KBits per second of available network
bandwidth would be required.
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 121
122 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Index
A N
Add a script resource ...................................... 93 Network requirements .................................. 117
Network setup ................................................. 18
C
Clean installs ................................................. 105 R
Configure Run database query ........................................ 78
host header value ................................... 87
Lenel Utility for ExpressCluster ......... 23 S
LS Platform Services ............................ 87 Script setup
Windows settings .................................. 23 add a script resource ............................. 93
Create a login ................................................... 77 stop the group ........................................ 91
Create the Lenel user ...................................... 77 stop the services .................................... 91
Set memory usage .................................... 79, 81
D SQL Server
Disk setup ......................................................... 11 attach the archival database ................. 81
attach the OnGuard database ............... 80
I create a login .......................................... 77
Install create an archival database .................. 79
OnGuard on a server ............................. 83 create the Lenel user ............................. 77
overview ................................................. 83 create the OnGuard database ............... 76
SQL Server ............................................. 75 install ....................................................... 75
SQL Server (new installations) obtain the SID ........................................ 78
create a login ................................ 77 run a new query ..................................... 78
run SQL queries ........................... 78 set database ownership ......................... 78
set memory usage ........................... 79, 81
Install a service release on NEC systems . 105
L U
Update the MessageBroker.config file ........ 85
LAN initial setup overview ............................. 7
Upgrade OnGuard on NEC systems .......... 105
Lenel Utility for ExpressCluster .................. 23
Login for SQL Server .................................... 77
LS Platform Services W
configuring ............................................. 87 WAN deployment overview ............................ 8
WAN network requirements ....................... 117
Windows settings ............................................ 23
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 123
Index
124 NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide
Index
NEC ExpressCluster X R3 LAN & WAN with Microsoft SQL Server Installation Guide 125
Lenel Systems International, Inc.
1212 Pittsford-Victor Road
Pittsford, New York 14534 USA
Tel 866.788.5095 Fax 585.248.9185
www.lenel.com
docfeedback@lenel.com