Emergency Notification Server: Installation Manual
Emergency Notification Server: Installation Manual
Index Table
Entries below are hyperlinked. Click on the required entry, to move to the page where it is dealt
with.
Contents
1 Document history 4
2 Scope 5
2.1 Overview ............................................................................................... 5
2.1.1 The Application – What it means to the User ....................................................... 5
2.1.2 Purpose of this guide ................................................................................... 5
3 Glossary 6
4 Introduction 7
4.1 Intended Readership ................................................................................. 7
4.2 Applicability Statement ............................................................................. 7
4.3 Overview of this manual ............................................................................ 7
4.4 Licensing ................................................................................................ 7
4.5 Technical Support .................................................................................... 8
6 Connectivity - Illustrated 11
6.1 Standalone PBX and single ENS ...................................................................12
6.2 Standalone duplicated PBX and single ENS .....................................................13
6.3 Standalone duplicated PBX and duplicated ENS ...............................................14
6.4 PBX Network and duplicated ENS.................................................................15
7 Installation 16
7.1 Red Hat Enterprise Linux 6U5 64 bits installation ............................................16
7.2 ENS installation .......................................................................................16
8 Upgrade procedure 17
9 High Availability 20
9.1 Trunk configuration on PBX with HA installation .............................................21
9.1.1 ENS HA with one trunk on one PBX .................................................................. 21
9.1.2 ENS HA with 2 trunks on one PBX .................................................................... 22
9.1.3 ENS HA with 2 trunks on 2 different PBXs .......................................................... 22
9.2 High Availability installation .......................................................................24
9.2.1 New ENS HA installation .............................................................................. 24
9.2.2 HA installation on an existing ENS ................................................................... 27
10 Appendixes 39
10.1 Appendix – I : Table of Diagrams .......................................................39
10.2 Appendix – II : Table of Screenshots ..................................................40
Legal notice
Alcatel, Lucent, Alcatel-Lucent and the Alcatel-Lucent logo are trademarks of Alcatel-Lucent. All
other trademarks are the property of their respective owners. The information presented is
subject to change without notice. Alcatel-Lucent assumes no responsibility for inaccuracies
contained herein.
1 Document history
Edition Date Changes / Comments / Details
01 28-03-2011 Creation
Document refined to improve information provided to the user with screenshots
02 18-05-2011
from latest version
03 24-05-2011 Document updated with comments addressed
04 27-06-2011 Document updated with comments addressed
05 13-07-2011 Connectivity diagrams explained
06 10-08-2011 High Availability section introduced
07 27-04-2012 Writing style changed
08 10-05-2014 High Availability section updated
09 5-21-2014 Licensing details updated
10 5-22-2014 Restore and upgrade processes added
11 1-27-2015 Incorporated updates, brought up to date with the 2.0 version.
12 3-18-2015 ENS installation process changes.
13 10-23-2015 ENS installation process changes.
14 02-17-2016 ENS installation process changes.
15 12-07-2016 ENS installation process changes.
2 Scope
2.1 Overview
2.1.1 The Application – What it means to the User
o Mobile phones,
o Fixed lines,
o IP phones,
o PCs, and
o Emails
assigned to designated personnel, when someone dials emergency number. These alerts
provide details of location, etc, of a caller to designated personnel. In the case of a 9-1-1
call, it helps PSAP find the caller’s accurate location. Other facilities available to
designated personnel include: call recording and participation, silent monitoring,
conferencing, and visual display of caller’s location. Many of these are optional and can be
customized. Besides, a broken call will be automatically reconnected. The recorded calls
can be played back at a future time and followed up.
This guide explains the installation of the application: ENS Appliance Server. This also
explains the environment that is required to do this installation. This includes the various
hardware and their connectivity. This enables the Telecom Engineer to get the whole setup
ready for configuration.
This guide targets at the Telecom Engineer. This guide does not explain the configuration
part or the method of using it. They are explained in respective manuals.
3 Glossary
ACRONYM EXPANSION
DB Data Base
IP Internet Protocol
4 Introduction
4.1 Intended Readership
This manual targets at the Telecom Engineer, who deals with installation activities of the
application: ENS Appliance Server.
This manual specifies the Hardware requirements. It does specify only RHEL6U5 64 bits
basic as Operating System requirements because it does not need other software. All
needed third party software is contained in the DVD itself.
4.4 Licensing
This application has a base package with a wide range of functionalities. For this, a
separate license is provided.
To use the license, the appropriate hostname of the server must be in the license file
before uploading it.
If you do not wish to associate a Fully Qualified Domain Name (FQDN) to the IP address of
the ENS server, you will use the short name “localhost” (from the default value,
“localhost.localdomain”) as the hostname in the license file. This value is already included
in the license by default.
Customers who wish to associate an FQDN to the ENS server IP address will use the short
form of the FQDN as the hostname in the license file. For example, a customer with the
FQDN “customerhostname.customerdomain” will use “customerhostname” as the hostname
in the license file.
To get more functionalities added to the base package, licenses will have to be obtained
separately for each additional package. Below are the functionalities of base package, and
those of each add-on.
BASE PACKAGE:
Memory 4 GB
If HA license is obtained, there should be one more server with the above specified
configuration
Platform 64 bits
This requirement applies also to both servers in case High Availability option is enabled.
5.3 Prerequisite
The Telecom Engineer will have to submit the MAC address of the server to Alcatel-Lucent
to obtain the License file. If High Availability is desired, then it requires 2 servers. For this
the Engineer will have to submit the MAC address of both the servers. An ISO image file will
be provided for installation. After completion of installation, the License file is uploaded
to the system via the ENS System Configuration.
6 Connectivity - Illustrated
The first step in installing this application is to establish connectivity among different
components of the setup. Below is a general connectivity diagram:
Below is the list of ports that are to be enabled in various systems and enterprise firewalls
as required. This is with reference to the markings in the above diagram:
Once the environment is setup to suit the purposes, then ENS Appliance Server can be
installed.
The above diagram is of a general kind. This will have to be translated to suit the current
environment. As samples, below are the topologies under the following four environments:
The above diagram illustrates how the 9-1-1 calls are catered to, in the absence of ENS, and
the significant role that ENS plays in this process.
When a person makes a call to 9-1-1, it reaches the OXE (PABX). In the absence of ENS, the
call passes through PSTN, and reaches the PSAP via Local Exchange. This is marked in the
above diagram by way of red arrows. In this situation, the PSAP personnel will have to
obtain information about the caller’s location from the caller only. This is because they
will have location details of PABX at the most. They will not have the extension details
from where the person is calling.
If ENS is installed, then the call is taken up by the ENS server and passed on to PSAP. This
is marked by black arrows. ENS updates the ALI DB with callers’ accurate location
information using DASH. This enables PSAP personnel to obtain details of the caller from
the ALI DB. They need not depend on the caller for information. In a situation where the
caller is unable to provide details of his location, this facility comes as a lifesaver.
The above situation is similar to the one in section 6.1 Standalone PBX and single ENS
above. But the difference is that, here, a backup Call Server is used to guarantee
continuity of service despite technical snags.
This is like the previous diagram, but a backup is used for ENS also. This backup ENS will
take over at the instance of failure of main ENS. For this kind of a setup, HA (High
Availability) package license should have been obtained.
This is like the previous diagram, but covers different locations. OXE (PABX) is placed in
different locations, catering to different sets of callers. Calls from all of them are routed
through the same ENS server. In the absence of ENS, they are routed through the
respective Local Exchange.
7 Installation
7.1 Red Hat Enterprise Linux 6U5 64 bits installation
It is the responsibility of the customer or business partner to provide a server with RHEL6U5 64
bits installed.
3. The network (IP address, DNS, Gateway) has to be configured and the server
has to be reachable (ping, ssh).
4. The NTP servers can be configured during RHEL installation or later on in the
ENS webapp.
1. Create the directory /tmp/ENS on the server and copy the file ens-
<version>.zip into it.
# chmod +rx *
# ./installEns.sh
# reboot
6. Please, refer to the administration guide for the configuration of the system.
8 Upgrade procedure
To perform an upgrade, you must first create a backup file. Then, as ENS R2.* runs on a RHEL 6U5
64 bits, an Operating System reinstallation is required.
While backing up, the system sends out emails to all. The system properties will be saved
as a .zip file. The default name is: dbBackup.zip. Using this dialog box, save the file with
the desired name. Backing up the system can be done when there is a need to migrate
between servers. This would be needed if the system holds the required previous call logs,
call recordings and log entries.
Note: the trunk connection to the Main server must be disabled at this step
2. In the System Config tab, do a backup of the system and download it as soon as
you get the link.
Note: The administrator receives the email with the link after a time which
depends on the size of the ENS database (for instance: around 30min for 10GB as
the database is exported in a file and then this file is compressed in a zip file). If
you don’t have access to the administrator’s email address, you can download this
file using the following URL as soon as it is available:
http://<ENSAddress>:8080/E911WebAccess/E911Configuration/exportedData/dbBackup.zip
This is the reverse of the backup process. This gets the information from an existing
database file into the system. The system properties can be restored only by using the .zip
file in the storage that is in correct format.
1. Install ENS 2.* from scratch on a new RHEL6U5 64 bits and reboot at the end of
the installation process.
4. Configure the PBX link depending on the customer configuration and save it.
7. In the System Config tab, do a restore of the system with the previous backup.
At the end of the restore process, a pop-up window will invite you to accept to
restart.
Warning: When Restore System is used, the entire system is configured, and will be
working from the .zip file selected. Previous database, logs, configurations
will not be available anymore. Hence exercise caution while performing
Restore System.
1. Create the directory /tmp/ENS on the server and copy the file ens-
<version>.zip into it.
# chmod +rx *
# ./installEns.sh
-------------------------------------------------------------------
[INFO] ENS solution Installer
-------------------------------------------------------------------
Warning: Another ENS version is already installed. Verify that it is an ENS R2.*
before upgrading. Do you want to upgrade it ? (y or n) y
# reboot
9 High Availability
This refers to provision of a standby server that is similar to the primary server. The
purpose of this server is to take over the functionality of the Primary server, when it fails.
When the Primary server starts functioning again, the Standby server transfers back the
functionality to the Primary server. This ensures continuous service from Servers even
during times of inevitable failure of a server.
To setup this environment, two Servers are needed, with identical configuration. In each of
them, install the application as explained in the previous section, and load the license.
Further, decide which Server is to act as the Primary Server and which one as Secondary
Server. Accordingly, do the configuration. This also should be identical in both the
Servers.
Please read carefully the following sections to figure out how to install or upgrade an ENS
with High Availability.
- Without upgrade
- With upgrade
For all these HA installations, there is a corresponding procedure in the next pages.
If license is obtained for HA package, then, the ENS System configuration page will have
additional fields. Into these fields, details of HA will have to be keyed in. Below are the
additional fields:
Entries into all the boxes are mandatory. Below, these fields are explained:
HA Checkbox: Even if entries are made in all fields, HA will work, only if this box is ticked.
Main Physical IP: This is the IP address of the main ENS server that was provided earlier.
Stby_physical_ip: Here, key in the IP address of the server that is to takeover, if and
when the main server fails.
First, it is important to know the PBX configuration that will be associated to the HA installation.
There are mainly 3 different ones:
Trunk 1
PBX
In this case, the “Main PBX” configured on ENS System webapp is the same for both servers:
In this case, the trunk has to be configured as below in “mgr > Trunk groups>Go down
Hierarchy > Trunk Group > Go down hierarchy > Virtual Access For IP”:
Trunk 1 Trunk 2
PBX
In this case, the “Main PBX” configured on ENS System webapp is the same for both servers:
Trunk 1 Trunk 2
PBX PBX
In this specific case, the ENS Main won’t have the same PBX configuration than on the
Standby. To configure it, log on ENS System webapp and modify the “Main PABX” value:
In addition to that, the Standby server must be able to receive the calls in case there is a
failover. That’s why there is a connection between both PBXs on the above diagram.
Important note: ENS provides with PBX Spatial redundancy support. The Standby PABX IP
address has to be configured in the below “Standby PABX” field.
A maintenance window is required for some of these installations. The estimated time may vary
depending on the size of the ENS database and the network.
Note: the trunk connections to the Main and the Standby server must be disabled until the end of
this procedure
4. Configure the PBX link depending on the customer configuration and save it.
Note: At this step, if you do any configurations on the main server you will have to generate a
backup. Then, you will restore it on the future Standby server before enabling the HA on both
servers. Otherwise, none of the data created before enabling HA will be replicated on the
Standby.
9. Configure the PBX link depending on the customer configuration and save it.
On both servers:
Note: For instance in the above screenshot, the main IP address is 192.168.0.188, the Standby IP
address is 192.168.0.189 and HA is enabled. The configuration has to be exactly the same on both
servers.
13. After you save the configuration, you will get a pop up reminding you that you have to
check the configuration on both servers.
14. Then, you can restart by clicking on the “Restart HA servers” button of one of the 2
servers.
Note: At this step, you must wait few minutes that ENS updates both servers. During the HA
installation process, both servers are restarted automatically once.
On the PBX:
15. Finally, the trunk connections to the Main and the Standby servers can be enabled on the
PBX
Note: The HA section will be displayed as below in the ENS System webapp at the end of the
installation process.
Note: The restore button is disabled after the HA installation. Indeed, it is only allowed to do
backups on an HA ENS. If the customer wants to restore a backup for any reasons, please ask the
ENS team.
ENS Standby
ENS Main RX
After RX (New ENS server
HA installation (Single with HA enabled) installation with backup of
ENS Single restored on it.
Then, HA is enabled)
Note: the trunk connection to the Standby server must be disabled until the end of this
procedure
1. Install same ENS release than on Main server and reboot at the end of the installation
process.
On both servers:
4. Configure the PBX link depending on the customer configuration and save it.
Note: the trunk connection to the Main server must be disabled at this step
7. In the System Config tab, do a backup of the system and download it as soon as you get
the link.
Note: The administrator receives the email with the link after a time which depends on the size
of the ENS database (for instance: around 30min for 10GB as the database is exported in a file
and then this file is compressed in a zip file). In the case you don’t have access to the
administrator’s email, you can download this file using the following URL as soon as it is
available:
http://<ENSAddress>:8080/E911WebAccess/E911Configuration/exportedData/dbBackup.zip
9. In the System Config tab, do a restore of the system with the previous backup. At the end
of the restore process, a pop-up window will invite you to accept to restart.
Note: After the restart, both servers are ready for HA installation.
On both servers:
Note: For instance in the above screenshot, the main IP address is 192.168.0.188, the Standby IP
address is 192.168.0.189 and HA is enabled. The configuration has to be exactly the same on both
servers.
12. After you save the configuration, you will get a pop up reminding you that you have to
check the configuration on both servers.
13. Then, you can restart by clicking on the “Restart HA servers” button of one of the 2
servers.
Note: At this step, you must wait few minutes that ENS updates both servers. During the HA
installation process, both servers are restarted automatically once.
On the PBX:
14. Finally, the trunk connections to the Main and the Standby servers can be enabled on the
PBX
Note: The HA section will be displayed as below in the ENS System webapp at the end of the
installation process.
Note: The restore button is disabled after the HA installation. Indeed, it is only allowed to do
backups on an HA ENS. If the customer wants to restore a backup for any reasons, please ask the
ENS team.
4. Configure the PBX link depending on the customer configuration and save it.
Note: the trunk connection to the Main server must be disabled at this step
6. Upgrade the main server following procedure detailed in Chapter “Upgrade procedure”
8. In the System Config tab, do a backup of the system and download it as soon as you get
the link.
Note: The administrator receives the email with the link after a time which depends on the size
of the ENS database (for instance: around 30min for 10GB as the database is exported in a file
and then this file is compressed in a zip file). In the case you don’t have access to the
administrator’s email, you can download this file using the following URL as soon as it is
available:
http://<ENSAddress>:8080/E911WebAccess/E911Configuration/exportedData/dbBackup.zip
10. In the System Config tab, do a restore of the system with the previous backup. At the end
of the restore process, a pop-up window will invite you to accept to restart.
Note: After the restart, you have to check that the data are the same on both servers in order to
confirm that the backup/restore worked.
On both servers:
Note: For instance in the above screenshot, the main IP address is 192.168.0.188, the Standby IP
address is 192.168.0.189 and HA is enabled. The configuration has to be exactly the same on both
servers.
17. After you save the configuration, you will get a pop up reminding you that you have to
check the configuration on both servers.
18. Then, you can restart by clicking on the “Restart HA servers” button of one of the 2
servers.
Note: At this step, you must wait few minutes that ENS updates both servers. During the HA
installation process, both servers are restarted automatically once.
On the PBX:
19. Finally, the trunk connections to the Main and the Standby servers can be enabled on the
PBX
Note: The HA section will be displayed as below in ENSSystem at the end of the installation
process.
Note: The restore button is disabled after the HA installation. Indeed, it is only allowed to do
backups on an HA ENS. If for any reasons the customer wants to restore a backup, please ask the
ENS team.
Note: the trunk connection to the Main and Standby servers must be disabled
On both servers:
2. In the System Config tab, do a backup of the system and download it as soon as you get
the link
Note: The administrator receives the email with the link after a time which depends on the size
of the ENS database (for instance: around 30min for 10GB as the database is exported in a file
and then this file is compressed in a zip file). In the case you don’t have access to the
administrator’s email, you can download this file using the following URL as soon as it is
available:
http://<ENSAddress>:8080/E911WebAccess/E911Configuration/exportedData/dbBackup.zip
On both servers:
On the PBX:
4. Finally, the trunk connections to the Main and the Standby servers can be enabled on the
PBX
Note: The HA section will be displayed as below in ENSSystem at the end of the installation
process.
Note: The restore button is disabled after the HA installation. Indeed, it is only allowed to do
backups on an HA ENS. If the customer wants to restore a backup for any reasons, please ask the
ENS team.
10 Appendixes
Entries below are hyperlinked. Click on the required entry, to move to that screenshot.
www.alcatel-lucent.com/enterprise/services