Deploying Avaya Call Management

System on Amazon Web Services

Release 19.2
Issue 1
March 2021
© 2019-2021, Avaya Inc. USES AND/OR INSTALLS AVAYA SOFTWARE, PURCHASED
All Rights Reserved. FROM AVAYA INC., ANY AVAYA AFFILIATE, OR AN AVAYA
CHANNEL PARTNER (AS APPLICABLE) UNDER A COMMERCIAL
Notice AGREEMENT WITH AVAYA OR AN AVAYA CHANNEL PARTNER.
While reasonable efforts have been made to ensure that the UNLESS OTHERWISE AGREED TO BY AVAYA IN WRITING,
information in this document is complete and accurate at the time of AVAYA DOES NOT EXTEND THIS LICENSE IF THE SOFTWARE
printing, Avaya assumes no liability for any errors. Avaya reserves WAS OBTAINED FROM ANYONE OTHER THAN AVAYA, AN AVAYA
the right to make changes and corrections to the information in this AFFILIATE OR AN AVAYA CHANNEL PARTNER; AVAYA
document without the obligation to notify any person or organization RESERVES THE RIGHT TO TAKE LEGAL ACTION AGAINST YOU
of such changes. AND ANYONE ELSE USING OR SELLING THE SOFTWARE
WITHOUT A LICENSE. BY INSTALLING, DOWNLOADING OR
Documentation disclaimer USING THE SOFTWARE, OR AUTHORIZING OTHERS TO DO SO,
“Documentation” means information published in varying mediums YOU, ON BEHALF OF YOURSELF AND THE ENTITY FOR WHOM
which may include product information, operating instructions and YOU ARE INSTALLING, DOWNLOADING OR USING THE
performance specifications that are generally made available to users SOFTWARE (HEREINAFTER REFERRED TO
of products. Documentation does not include marketing materials. INTERCHANGEABLY AS “YOU” AND “END USER”), AGREE TO
Avaya shall not be responsible for any modifications, additions, or THESE TERMS AND CONDITIONS AND CREATE A BINDING
deletions to the original published version of Documentation unless CONTRACT BETWEEN YOU AND AVAYA INC. OR THE
such modifications, additions, or deletions were performed by or on APPLICABLE AVAYA AFFILIATE (“AVAYA”).
the express behalf of Avaya. End User agrees to indemnify and hold Avaya grants You a license within the scope of the license types
harmless Avaya, Avaya's agents, servants and employees against all described below, with the exception of Heritage Nortel Software, for
claims, lawsuits, demands and judgments arising out of, or in which the scope of the license is detailed below. Where the order
connection with, subsequent modifications, additions or deletions to documentation does not expressly identify a license type, the
this documentation, to the extent made by End User. applicable license will be a Designated System License as set forth
Link disclaimer below in the Designated System(s) License (DS) section as
applicable. The applicable number of licenses and units of capacity
Avaya is not responsible for the contents or reliability of any linked for which the license is granted will be one (1), unless a different
websites referenced within this site or Documentation provided by number of licenses or units of capacity is specified in the
Avaya. Avaya is not responsible for the accuracy of any information, documentation or other materials available to You. “Software” means
statement or content provided on these sites and does not computer programs in object code, provided by Avaya or an Avaya
necessarily endorse the products, services, or information described Channel Partner, whether as stand-alone products, pre-installed on
or offered within them. Avaya does not guarantee that these links will hardware products, and any upgrades, updates, patches, bug fixes,
work all the time and has no control over the availability of the linked or modified versions thereto. “Designated Processor” means a single
pages. stand-alone computing device. “Server” means a set of Designated
Processors that hosts (physically or virtually) a software application
Warranty
to be accessed by multiple users. “Instance” means a single copy of
Avaya provides a limited warranty on Avaya hardware and software. the Software executing at a particular time: (i) on one physical
Refer to your sales agreement to establish the terms of the limited machine; or (ii) on one deployed software virtual machine (“VM”) or
warranty. In addition, Avaya’s standard warranty language, as well as similar deployment.
information regarding support for this product while under warranty is
License type(s)
available to Avaya customers and other parties through the Avaya
Support website: https://support.avaya.com/helpcenter/ Designated System(s) License (DS). End User may install and use
getGenericDetails?detailId=C20091120112456651010 under the link each copy or an Instance of the Software only: 1) on a number of
“Warranty & Product Lifecycle” or such successor site as designated Designated Processors up to the number indicated in the order; or 2)
by Avaya. Please note that if You acquired the product(s) from an up to the number of Instances of the Software as indicated in the
authorized Avaya Channel Partner outside of the United States and order, Documentation, or as authorized by Avaya in writing. Avaya
Canada, the warranty is provided to You by said Avaya Channel may require the Designated Processor(s) to be identified in the order
Partner and not by Avaya. by type, serial number, feature key, Instance, location or other
Hosted Service specific designation, or to be provided by End User to Avaya through
electronic means established by Avaya specifically for this purpose.
THE FOLLOWING APPLIES ONLY IF YOU PURCHASE AN AVAYA
HOSTED SERVICE SUBSCRIPTION FROM AVAYA OR AN AVAYA Concurrent User License (CU). End User may install and use the
CHANNEL PARTNER (AS APPLICABLE), THE TERMS OF USE Software on multiple Designated Processors or one or more Servers,
FOR HOSTED SERVICES ARE AVAILABLE ON THE AVAYA so long as only the licensed number of Units are accessing and using
WEBSITE, HTTPS://SUPPORT.AVAYA.COM/LICENSEINFO UNDER the Software at any given time as indicated in the order,
THE LINK “Avaya Terms of Use for Hosted Services” OR SUCH Documentation, or as authorized by Avaya in writing. A “Unit” means
SUCCESSOR SITE AS DESIGNATED BY AVAYA, AND ARE the unit on which Avaya, at its sole discretion, bases the pricing of its
APPLICABLE TO ANYONE WHO ACCESSES OR USES THE licenses and can be, without limitation, an agent, port or user, an e-
mail or voice mail account in the name of a person or corporate
HOSTED SERVICE. BY ACCESSING OR USING THE HOSTED
function (e.g., webmaster or helpdesk), or a directory entry in the
SERVICE, OR AUTHORIZING OTHERS TO DO SO, YOU, ON
administrative database utilized by the Software that permits one
BEHALF OF YOURSELF AND THE ENTITY FOR WHOM YOU ARE
user to interface with the Software. Units may be linked to a specific,
DOING SO (HEREINAFTER REFERRED TO INTERCHANGEABLY
identified Server or an Instance of the Software.
AS “YOU” AND “END USER”), AGREE TO THE TERMS OF USE. IF
YOU ARE ACCEPTING THE TERMS OF USE ON BEHALF A Shrinkwrap License (SR). End User may install and use the Software
COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT THAT in accordance with the terms and conditions of the applicable license
YOU HAVE THE AUTHORITY TO BIND SUCH ENTITY TO THESE agreements, such as “shrinkwrap” or “clickthrough” license
TERMS OF USE. IF YOU DO NOT HAVE SUCH AUTHORITY, OR IF accompanying or applicable to the Software (“Shrinkwrap License”)
YOU DO NOT WISH TO ACCEPT THESE TERMS OF USE, YOU as indicated in the order, Documentation, or as authorized by Avaya
MUST NOT ACCESS OR USE THE HOSTED SERVICE OR in writing.
AUTHORIZE ANYONE TO ACCESS OR USE THE HOSTED
SERVICE. Heritage Nortel Software

Licenses “Heritage Nortel Software” means the software that was acquired by
Avaya as part of its purchase of the Nortel Enterprise Solutions
THE SOFTWARE LICENSE TERMS AVAILABLE ON THE AVAYA Business in December 2009. The Heritage Nortel Software is the
WEBSITE, HTTPS://SUPPORT.AVAYA.COM/LICENSEINFO, software contained within the list of Heritage Nortel Products located
UNDER THE LINK “AVAYA SOFTWARE LICENSE TERMS (Avaya at https://support.avaya.com/LicenseInfo under the link “Heritage
Products)” OR SUCH SUCCESSOR SITE AS DESIGNATED BY Nortel Products” or such successor site as designated by Avaya. For
AVAYA, ARE APPLICABLE TO ANYONE WHO DOWNLOADS, Heritage Nortel Software, Avaya grants Customer a license to use
Heritage Nortel Software provided hereunder solely to the extent of INDEPENDENTLY OBTAIN ANY APPLICABLE LICENSE
the authorized activation or authorized usage level, solely for the AGREEMENTS, AT THE AVAYA CHANNEL PARTNER’S EXPENSE,
purpose specified in the Documentation, and solely as embedded in, DIRECTLY FROM THE APPLICABLE THIRD PARTY SUPPLIER.
for execution on, or for communication with Avaya equipment.
WITH RESPECT TO CODECS, IF THE AVAYA CHANNEL
Charges for Heritage Nortel Software may be based on extent of
PARTNER IS HOSTING ANY PRODUCTS THAT USE OR EMBED
activation or use authorized as specified in an order or invoice.
THE H.264 CODEC OR H.265 CODEC, THE AVAYA CHANNEL
Copyright PARTNER ACKNOWLEDGES AND AGREES THE AVAYA
CHANNEL PARTNER IS RESPONSIBLE FOR ANY AND ALL
Except where expressly stated otherwise, no use should be made of RELATED FEES AND/OR ROYALTIES. THE H.264 (AVC) CODEC
materials on this site, the Documentation, Software, Hosted Service, IS LICENSED UNDER THE AVC PATENT PORTFOLIO LICENSE
or hardware provided by Avaya. All content on this site, the FOR THE PERSONAL USE OF A CONSUMER OR OTHER USES
documentation, Hosted Service, and the product provided by Avaya IN WHICH IT DOES NOT RECEIVE REMUNERATION TO: (I)
including the selection, arrangement and design of the content is ENCODE VIDEO IN COMPLIANCE WITH THE AVC STANDARD
owned either by Avaya or its licensors and is protected by copyright (“AVC VIDEO”) AND/OR (II) DECODE AVC VIDEO THAT WAS
and other intellectual property laws including the sui generis rights ENCODED BY A CONSUMER ENGAGED IN A PERSONAL
relating to the protection of databases. You may not modify, copy, ACTIVITY AND/OR WAS OBTAINED FROM A VIDEO PROVIDER
reproduce, republish, upload, post, transmit or distribute in any way LICENSED TO PROVIDE AVC VIDEO. NO LICENSE IS GRANTED
any content, in whole or in part, including any code and software OR SHALL BE IMPLIED FOR ANY OTHER USE. ADDITIONAL
unless expressly authorized by Avaya. Unauthorized reproduction, INFORMATION FOR H.264 (AVC) AND H.265 (HEVC) CODECS
transmission, dissemination, storage, and or use without the express MAY BE OBTAINED FROM MPEG LA, L.L.C. SEE HTTP://
written consent of Avaya can be a criminal, as well as a civil offense WWW.MPEGLA.COM.
under the applicable law.
Compliance with Laws
Virtualization
You acknowledge and agree that it is Your responsibility for
The following applies if the product is deployed on a virtual machine. complying with any applicable laws and regulations, including, but not
Each product has its own ordering code and license types. Unless limited to laws and regulations related to call recording, data privacy,
otherwise stated, each Instance of a product must be separately intellectual property, trade secret, fraud, and music performance
licensed and ordered. For example, if the end user customer or rights, in the country or territory where the Avaya product is used.
Avaya Channel Partner would like to install two Instances of the
same type of products, then two products of that type must be Preventing Toll Fraud
ordered.
“Toll Fraud” is the unauthorized use of your telecommunications
Third Party Components system by an unauthorized party (for example, a person who is not a
corporate employee, agent, subcontractor, or is not working on your
“Third Party Components” mean certain software programs or company's behalf). Be aware that there can be a risk of Toll Fraud
portions thereof included in the Software or Hosted Service may associated with your system and that, if Toll Fraud occurs, it can
contain software (including open source software) distributed under result in substantial additional charges for your telecommunications
third party agreements (“Third Party Components”), which contain services.
terms regarding the rights to use certain portions of the Software
(“Third Party Terms”). As required, information regarding distributed Avaya Toll Fraud intervention
Linux OS source code (for those products that have distributed Linux
If You suspect that You are being victimized by Toll Fraud and You
OS source code) and identifying the copyright holders of the Third
need technical assistance or support, call Technical Service Center
Party Components and the Third Party Terms that apply is available
in the products, Documentation or on Avaya’s website at: https:// Toll Fraud Intervention Hotline at +1-800-643-2353 for the United
support.avaya.com/Copyright or such successor site as designated States and Canada. For additional support telephone numbers, see
by Avaya. The open source software license terms provided as Third the Avaya Support website: https://support.avaya.com or such
successor site as designated by Avaya.
Party Terms are consistent with the license rights granted in these
Software License Terms, and may contain additional rights benefiting Security Vulnerabilities
You, such as modification and distribution of the open source
software. The Third Party Terms shall take precedence over these Information about Avaya’s security support policies can be found in
Software License Terms, solely with respect to the applicable Third the Security Policies and Support section of https://
Party Components to the extent that these Software License Terms support.avaya.com/security.
impose greater restrictions on You than the applicable Third Party Suspected Avaya product security vulnerabilities are handled per the
Terms. Avaya Product Security Support Flow (https://
The following applies only if the H.264 (AVC) codec is distributed with support.avaya.com/css/P8/documents/100161515).
the product. THIS PRODUCT IS LICENSED UNDER THE AVC Downloading Documentation
PATENT PORTFOLIO LICENSE FOR THE PERSONAL USE OF A
CONSUMER OR OTHER USES IN WHICH IT DOES NOT RECEIVE For the most current versions of Documentation, see the Avaya
REMUNERATION TO (i) ENCODE VIDEO IN COMPLIANCE WITH Support website: https://support.avaya.com, or such successor site
THE AVC STANDARD (“AVC VIDEO”) AND/OR (ii) DECODE AVC as designated by Avaya.
VIDEO THAT WAS ENCODED BY A CONSUMER ENGAGED IN A Contact Avaya Support
PERSONAL ACTIVITY AND/OR WAS OBTAINED FROM A VIDEO
PROVIDER LICENSED TO PROVIDE AVC VIDEO. NO LICENSE IS See the Avaya Support website: https://support.avaya.com for
GRANTED OR SHALL BE IMPLIED FOR ANY OTHER USE. product or Hosted Service notices and articles, or to report a problem
ADDITIONAL INFORMATION MAY BE OBTAINED FROM MPEG LA, with your Avaya product or Hosted Service. For a list of support
L.L.C. SEE HTTP://WWW.MPEGLA.COM. telephone numbers and contact addresses, go to the Avaya Support
website: https://support.avaya.com (or such successor site as
Service Provider designated by Avaya), scroll to the bottom of the page, and select
THE FOLLOWING APPLIES TO AVAYA CHANNEL PARTNER’S Contact Avaya Support.
HOSTING OF AVAYA PRODUCTS OR SERVICES. THE PRODUCT Trademarks
OR HOSTED SERVICE MAY USE THIRD PARTY COMPONENTS
SUBJECT TO THIRD PARTY TERMS AND REQUIRE A SERVICE The trademarks, logos and service marks (“Marks”) displayed in this
PROVIDER TO BE INDEPENDENTLY LICENSED DIRECTLY FROM site, the Documentation, Hosted Service(s), and product(s) provided
THE THIRD PARTY SUPPLIER. AN AVAYA CHANNEL PARTNER’S by Avaya are the registered or unregistered Marks of Avaya, its
HOSTING OF AVAYA PRODUCTS MUST BE AUTHORIZED IN affiliates, its licensors, its suppliers, or other third parties. Users are
WRITING BY AVAYA AND IF THOSE HOSTED PRODUCTS USE not permitted to use such Marks without prior written consent from
OR EMBED CERTAIN THIRD PARTY SOFTWARE, INCLUDING Avaya or such third party which may own the Mark. Nothing
BUT NOT LIMITED TO MICROSOFT SOFTWARE OR CODECS, contained in this site, the Documentation, Hosted Service(s) and
THE AVAYA CHANNEL PARTNER IS REQUIRED TO product(s) should be construed as granting, by implication, estoppel,
or otherwise, any license or right in and to the Marks without the
express written permission of Avaya or the applicable third party.
Avaya is a registered trademark of Avaya Inc.
All non-Avaya trademarks are the property of their respective owners.
Linux® is the registered trademark of Linus Torvalds in the U.S. and
other countries.
 Contents

Chapter 1: Introduction............................................................................................................ 7
Purpose.................................................................................................................................. 7
Chapter 2: Avaya Call Management System on AWS overview........................................... 8
Prerequisites........................................................................................................................... 8
Software delivery..................................................................................................................... 9
Networking considerations for Avaya Call Management System deployment in AWS.................... 9
Types of network connection.................................................................................................... 9
Location of CMS in the VPC............................................................................................. 10
Number of direct connections........................................................................................... 10
Unsupported features for Avaya Call Management System AWS instances................................ 10
Functional differences when installing CMS on AWS................................................................ 11
Chapter 3: Planning................................................................................................................ 12
Planning checklist.................................................................................................................. 12
Release details of CMS application OVAs............................................................................... 12
Instance Types and capacities for an AWS deployment............................................................ 13
High Availability..................................................................................................................... 14
HA CMS and Survivable CMS.......................................................................................... 14
Chapter 4: Converting an OVA file to an AMI file................................................................. 16
Checklist for converting an OVA file to an AMI file.................................................................... 16
Creating a bucket for uploading an OVA for AMI conversion..................................................... 16
Uploading the CMS OVA to the AWS console.......................................................................... 17
Creating a Linux Amazon EC2 virtual server instance............................................................... 17
Obtaining the virtual server instance user ID............................................................................ 19
Importing the OVA for AMI conversion..................................................................................... 20
Creating a key pair................................................................................................................ 22
Launching an Amazon EC2 instance....................................................................................... 23
Creating a user access key.................................................................................................... 23
Chapter 5: Deployment process............................................................................................ 25
Deployment checklist............................................................................................................. 25
Deploying the CMS application AMI........................................................................................ 25
Configuring the CMS software................................................................................................ 27
Verifying CMS on the AWS instance....................................................................................... 28
Chapter 6: Maintenance operations...................................................................................... 29
Restoring CMS on a virtual machine....................................................................................... 29
Starting an Amazon Web Services instance............................................................................. 31
Stopping an Amazon Web Services instance........................................................................... 32
Rebooting an Amazon Web Services instance......................................................................... 32
Chapter 7: Resources............................................................................................................. 33
Documentation...................................................................................................................... 33

March 2021 Deploying Avaya Call Management System on Amazon Web Services 5
Comments on this document? [email protected]
Contents

Amazon Web Services documentation.................................................................................... 37

Finding documents on the Avaya Support website................................................................... 37
Viewing Avaya Mentor videos................................................................................................. 37
Support................................................................................................................................ 38
Using the Avaya InSite Knowledge Base........................................................................... 38

March 2021 Deploying Avaya Call Management System on Amazon Web Services 6
Comments on this document? [email protected]
Chapter 1: Introduction

Purpose
This document provides the following information:
• Deployment of Avaya Call Management System (CMS) in the Amazon Web Services (AWS)
environment
• Virtualization architecture
• Deployment planning
• Verification of CMS installation
• Configuration of CMS
• Maintenance related to the deployment in AWS
This document refers to standard CMS documents for configuring and maintaining the CMS
software.
This document is intended for people who need to install, configure, and deploy CMS on AWS.
Note:
If you are deploying CMS on standard VMware servers, you must use the procedures found in
Deploying Avaya Call Management System.
If you are upgrading an existing CMS server, you must use the procedures found in Upgrading
Avaya Call Management System.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 7
Comments on this document? [email protected]
Chapter 2: Avaya Call Management System
on AWS overview

Amazon Web Services (AWS) is a cloud services platform that enables enterprises to securely run
applications on the virtual cloud. The key components of AWS are Amazon Elastic Compute Cloud
(EC2) and Amazon Simple Storage Service (S3). Supporting the Avaya applications on the AWS
Infrastructure as a service (IaaS) platform provides the following benefits:
• Minimizes the capital expenditure (CAPEX) on infrastructure. Customers can move from
CAPEX to operational expense (OPEX).
• Reduces the maintenance cost of running the data centers.
• Provides a common platform for deploying the applications.
• Provides a flexible environment to accommodate the changing business requirements of
customers.
You can connect the following applications to the Avaya Call Management System (CMS) AWS
instances from the customer premises:
• Avaya Aura Communication Manager
• Various Avaya Professional Services offers
Customer responsibility
Before deploying an Avaya application on AWS, you must know your responsibilities as a customer.
For information about customer responsibilities, see Deploying Contact Center Applications on
Amazon Web Services.
Related links
Prerequisites on page 8
Software delivery on page 9
Networking considerations for Avaya Call Management System deployment in AWS on page 9
Types of network connection on page 9
Unsupported features for Avaya Call Management System AWS instances on page 10
Functional differences when installing CMS on AWS on page 11

Prerequisites
Before deploying the product, ensure that you have the following knowledge and skills:

March 2021 Deploying Avaya Call Management System on Amazon Web Services 8
Comments on this document? [email protected]
 Software delivery

Knowledge
• Amazon Web Services setup
• Linux® Operating System
• Avaya Aura® Communication Manager
Skills
To administer the AWS Management console and CMS applications.

Software delivery
The CMS software is delivered as one pre-packaged AWS-specific Open Virtualization Appliance
(OVA) file that is posted on the Avaya Product Licensing and Download System (PLDS). The CMS
OVA for AWS) has aws-001 or aws-‘xxx’ in the version string and only these OVAs must be
converted and deployed on AWS. You cannot correctly convert or deploy the standard CMS OVAs
on AWS.
The OVA contains the application software and operating system.

Networking considerations for Avaya Call Management

System deployment in AWS
When you deploy an Avaya application at the main location or at a branch location on Amazon
Web Services (AWS), ensure that you follow the networking requirements, such as, the WAN
network topology, bandwidth, and latency of the Avaya applications. You must adhere to the
Avaya network recommendations and AWS networking rules.
AWS has some limitations for establishing VPNs and direct connections into AWS. For more
information about Amazon VPC Limits, see the AWS documentation at http://
docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Appendix_Limits.html.
Important:
Avaya recommends the use of direct connection in combination of a private WAN connection
with Service Level Agreement (SLA) measures to ensure that the network quality is
appropriate for signaling and voice traffic.
Avaya is not responsible for network connections between AWS and customer premises.

Types of network connection

You can connect applications in a hybrid network on a Virtual Private cloud (VPC) in the following
ways:

March 2021 Deploying Avaya Call Management System on Amazon Web Services 9
Comments on this document? [email protected]
Avaya Call Management System on AWS overview

Connection type Resource

VPN Connection For information about VPN Connections, see http://
docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpn-
connections.html.
Direct Connection For information about AWS Direct Connections, see https://
aws.amazon.com/directconnect/.

Location of CMS in the VPC

The primary function of Avaya Call Management System (CMS) is to provide reporting for CC Elite
functionality on the Avaya Aura Communication Manager. Therefore, it is important to locate the
CMS Amazon Web Services (AWS) deployment in a region that is the same as, or as close to the
Communication Manager as possible. Co-location of CMS and Communication Manager in the
same AWS VPC is ideal.
The CMS and Communication Manager are not required to both be deployed in AWS. CMS can
reside in AWS with Communication Manager on the customer premise, and vice versa.
Supervisor users access CMS through the CMS Web client and the CMS PC Supervisor client. All
Supervisor users require network connection to the CMS deployment in AWS. If a VPN connection
is used to connect to the CMS in AWS, network latency may impact the performance for
Supervisor users.
Important:
Avaya recommends the use of direct connection in combination of a private WAN connection
with Service Level Agreement (SLA) measures to ensure that the network quality is
appropriate for signaling and voice traffic.
Avaya is not responsible for network connections between AWS and customer premises.

Number of direct connections

You must separate the traffic between the Supervisor users and the Avaya Call Management
System(CMS) installation from Communication Manager and CMS traffic.

Unsupported features for Avaya Call Management System

AWS instances
• LAN backup.
Only NFS-mounted file systems are supported for backups.
• Amazon Web Services (AWS) infrastructure management tools such as CHEF, Ansible, and
Puppet.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 10
Comments on this document? [email protected]
 Functional differences when installing CMS on AWS

Functional differences when installing CMS on AWS

When deploying CMS in an AWS virtualized environment, it operates almost identically as a CMS
deployed on a traditional hardware server provided by Avaya using the Linux operating system.
After the AWS-specific CMS OVA file is converted to AMI and deployed within AWS, use the
standard CMS documents to complete the installation.
This section describes a few of the functional areas that are different when deploying CMS in
AWS.
CMS encryption passphrase auto-unlock implemented on AWS deployments
Starting with Release 19.1, CMS provides encryption for personal data at rest. The encryption
occurs at the LInux operating system level and is implemented using Linux Unified Key Setup
(LUKS) during deployment of the OVA on the CMS server.
The use of the encryption passpharase is disabled for AWS deployments. On a standard CMS
deployment, the encryption feature requires users enter an encryption “passphrase” on the local
system console during deployment and, optionally, every time you reboot the system. For an AWS
deployment, a console is not presented to the user, thus use of the passphrase is not possible.
Due to the lack of console access for AWS deployments, the following is implemented:
• By default, the CMS encryption passphrase auto-unlock is enabled. A CMS passphrase is
not used during boot-up for AWS deployments.
• You can never disable the CMS auto-unlock feature since an AWS deployment does not
present a console to the user to enter the passphrase.
• An AWS deployment offers its own version of disk encryption as a choice during installation
and you are free to choose the AWS disk encryption. AWS disk encryption has no impact on
the operation of CMS.
• If you decide to use AWS disk encryption, AWS manages the use of an AWS passphrase
during deployment and boot of the CMS application.
Software media
You must download an AWS-specific OVA file to deploy CMS in AWS. You cannot use the
standard CMS OVA file.
The OVA file contains the operating system and a specific CMS load. You must make a backup
copy of the OVA file in the event you must restore the system. Store the backup copy of the OVA
file in a safe location so that you can get the backup quickly if you want to restore your system.
Base Load upgrade media
CMS on AWS uses an ISO image to accomplish a CMS software upgrades. You must make a
backup copy of the ISO image. Store the backup copy of the ISO image in a safe location to
perform a Base Load upgrade.
Backup options
Avaya supports backups to a network mount NFS point for CMS in AWS. Avaya does not support
LAN Backup for CMS in AWS.
For more information about backup options, see Maintaining and Troubleshooting Avaya Call
Management System.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 11
Comments on this document? [email protected]
Chapter 3: Planning

Planning checklist
Ensure that you complete the following before deploying the virtual applications on the AWS
Management console:
No. Task References Notes

1 Download the AWS-specific See Deploying Contact Center

CMS OVA file. Applications on Amazon Web
Services.
2 Upload the OVA file to AWS See Deploying Contact Center
and convert the OVA to the Applications on Amazon Web
AMI format. Services.
3 Deploy the CMS AMI file into You must separately license
the required AWS each CMS instance, that is,
configuration. each installation of an OVA.
To install multiple instances
of CMS, customers or
business partners must
order a separate CMS
license for each instance.
4 Complete the installation by See Deploying Avaya Call
configuring required and Management System for the
optional CMS features. required features and
Maintaining and
Troubleshooting Avaya Call
Management System for the
optional features.

Release details of CMS application OVAs

You can download the AWS-specific CMS OVA from the Avaya PLDS website at:
http://plds.avaya.com/
Avaya packages the CMS software as an OVA file ready for conversion and deployment on AWS.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 12
Comments on this document? [email protected]
 Instance Types and capacities for an AWS deployment

Instance Types and capacities for an AWS deployment

Instance Types
The following table provides the minimum resources consumed by CMS for each size of
deployment. These resources do not exactly match the Instance Types provided by Amazon, but It
is expected that CMS on AWS will be deployed in an Instance Type that has the minimum
resource requirements or better.
When selecting the Instance Type for a CMS deployment, care should be taken to allocate at least
the minimum resources. The resources listed in the table are necessary to support the capacities
listed in the table following the Instance Types.
Important:
Downsizing the resource reservation can put the performance of CMS at risk. CMS is a read/
write intensive application. Avaya recommends the use of the EBS Optimized storage from
Amazon.
Server type AWS Instance AWS vCPU AWS RAM Hard Disk Drive NICs
Type (GB) (GB)
Small m4.large 2 8 800 3
m5.large
Medium m4.2xlarge 8 32 1,200 4
m5.2xlarge
Large m4.4xlarge 16 64 1,800 4
m5.4xlarge

The m4.large and m5.large Instance Types have only ‘moderate’ network performance. Choosing
the m4.2xlarge or m5.2xlarge Instance Type is mandatory for high network performance. Reliable
network performance is necessary to ensure fast refresh rates for reporting. The m4.2xlarge,
m5.2xlarge, m4.4xlarge, and m5.4xlarge Instance Types have more CPU and memory allocated
than is necessary for a small configuration. Customers will have to make the decisions on trade-
offs of between network performance and cost of the instance.
Capacities
The AWS Instance Types listed above will support the capacities detailed in the following table.
Important:
Use this table to determine the configuration you must use for a deployment. You must select
the size that provides the capacities you require. If any capacity requires a larger
configuration, you must go to that larger configuration. For example, if you only need 100,000
agent skill pairs but your peak busy-hour call volume is 200,000, you must select the medium
configuration.
Parameter Small Medium Large
Peak busy-hour call 30,000 200,000 400,000
volume
Table continues…

March 2021 Deploying Avaya Call Management System on Amazon Web Services 13
Comments on this document? [email protected]
Planning

Parameter Small Medium Large

Concurrent CMS 50 200 1,6002
Supervisor sessions1
Concurrent agents 500 5,000 10,000
Third-party software 3 5 7
Agent skill pairs 100,000 200,000 800,0003
Reports per CMS 3 5 10
Supervisor session
Report elements 5 5 12
Percentage of 10% 50% 100%
supervisors that can run
reports with a three-
second refresh rate
Active agent traces 250 1,000 5,000
Internal Call History 4,000 per 20 minutes 4,000 per 20 minutes 4,000 per 20 minutes
(ICH) records
External Call History 10,000 per 20 minutes 60,000 per 20 minutes 300,000 per 20 minutes
(ECH) records

High Availability
High Availability (HA) Avaya Call Management System (CMS) and Survivable CMS are Avaya
product offers that are different from Amazon Web Services (AWS) duplication or redundancy
features. Contact your account team to discuss deployment options for HA CMS and Survivable
CMS.

HA CMS and Survivable CMS

Avaya offers a High Availability (HA) Avaya Call Management System (CMS) package and a
Survivable CMS package. With HA CMS, you deploy two CMS systems and provision the systems
to both receive the same call data from the same Communication Manager system. The
deployment of two CMS systems provides reliability and duplication of ACD call data across both
CMS systems for better reliability if the network fails or a server fails.
The Survivable CMS option expands reliability by providing data collection from the
Communication Manager Survivable Core and Survivable Remote technology. Survivable CMS
has a Dual Role CMS option where the HA CMS supports a connection from the Communication
Manager system and the Survivable Core or Survivable Remote, and a separate Survivable CMS

1 This value is the total number of active CMS Supervisor PC Client and Web Client sessions.
2 Of the 1600 sessions supported, only 800 can be CMS Supervisor Web Client sessions
3 Supporting 800,000 agent skill pairs requires greatly increased disk space for interval data. Customers should create up
to 8 additional disk volumes.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 14
Comments on this document? [email protected]
 High Availability

where only the Survivable Core or Survivable Remote connects to a Survivable CMS. The
deployment of a Survivable CMS allows users to continue working if the main site is not
operational because of network failures or server failures.
To have multiple CMS systems in an HA CMS, Survivable CMS, or an HA CMS and Survivable
CMS combination deployment when Amazon Web Services (AWS), you must deploy separate
CMS OVA files for each CMS. The reason you need separate OVA files is because all CMS virtual
machines must be provisioned as active, licensed systems.
In addition to redundancy of ACD data provided by HA CMS or the resiliency of data provided by
Survivable CMS, Avaya requires a feature that synchronizes the administrative data from a
primary CMS to the HA CMS or Survivable CMS deployment. This feature allows all systems to
remain synchronized with up-to-date administrative data.
Contact your account team for more information about HA CMS and Survivable CMS.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 15
Comments on this document? [email protected]
Chapter 4: Converting an OVA file to an AMI
file

Checklist for converting an OVA file to an AMI file

Use this checklist to guide you through the procedure of converting the AWS-specific CMS OVA
file to an Amazon Machine Image (AMI) file.
Task Link/Notes

Create a bucket for uploading the OVAs. Creating a bucket for uploading an OVA for AMI
conversion on page 16
Upload the AWS-specific CMS OVA file. Uploading the CMS OVA to the AWS console on
page 17
Create an Amazon EC2 virtual server Creating a Linux Amazon EC2 virtual server
instance. instance on page 17
Create an access key. Creating a user access key on page 23
Obtain the virtual server instance user Obtaining the virtual server instance user ID on
ID. page 19
Import the OVA for AMI conversion. Importing the OVA for AMI conversion on page 20

Creating a bucket for uploading an OVA for AMI

conversion
About this task
For more details about creating a bucket, selecting a region, and administering other options, see
the following website:
https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-bucket.html
Procedure
1. Sign in to the Amazon Web Services Management console.
2. Under AWS services, navigate to All services > Storage > S3.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 16
Comments on this document? [email protected]
 Uploading the CMS OVA to the AWS console

The system displays the S3 Management Console page.

3. Click Create bucket.
The system displays the Create bucket dialog box.
4. In Bucket name, type a unique bucket name.
Only use lowercase letters for the name.
5. In the Region field, click a region for your bucket.
6. Click Create bucket.

Uploading the CMS OVA to the AWS console

Procedure
1. Sign in to the Amazon Web Services Management console.
2. Under AWS services, navigate to All services > Storage > S3.
The system displays the S3 Management Console page.
3. In the All Buckets, click a bucket name.
4. Click Upload.
The system displays the Upload - Select Files and Folders dialog box.
5. Click Add Files.
6. In the Choose File to Upload dialog box, select the AWS-specific CMS OVA file from your
local system, and click Open.
7. Click Upload.

Creating a Linux Amazon EC2 virtual server instance

About this task
If you use the AWS CLI, this procedure is not required.
Procedure
1. Sign in to the Amazon Web Services Management console.
2. Under AWS services, navigate to All services > Compute > EC2.
The system displays the EC2 Management Console page.
3. Click Launch Instance.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 17
Comments on this document? [email protected]
Converting an OVA file to an AMI file

4. On the Choose an Amazon Machine Image (AMI) page, search for a Linux AMI, and click
Select.
You must select an image that includes the AWS command line tools.
5. On the Choose an Instance Type page, select an instance type, and click Next: Configure
Instance Details.
6. On the Configure Instance Details page, do the following:
a. In the Network field, click a VPC network.
b. In the Network interfaces section, assign an IP address.
7. Click Next: Add Storage.
8. On the Add Storage page, leave the default settings, and click Next: Add Tags.
9. On the Add Tags page, add a tag, and click Next: Configure Security Group.
10. On the Configure Security Group page, create a new security group or select an existing
security group, and click Review and Launch.
11. On the Review Instance Launch page, review the details of each configuration, and then
click Launch.
The system displays the following screen:

March 2021 Deploying Avaya Call Management System on Amazon Web Services 18
Comments on this document? [email protected]
 Obtaining the virtual server instance user ID

12. On the Select an existing key pair or create a new key pair dialog box, select one of the
following options:
• Choose an existing key pair: If you select this option, perform the following:
- From the Select a key pair drop-down list, select a key pair.
- Select the I acknowledge that I have access to the selected private key file
(<example.pem>), and that without this file, I won't be able to log into my
instance check box.
• Create a new key pair: If you select this option, perform the following:
- In the Key pair name field, type a name for the private key file. The extension of the
private key file is .pem.
- Click Download Key Pair.
- Save the file in a secure and accessible location.
Note:
You will not be able to download the file again.
• Proceed without a key pair: If you select this option, select the I acknowledge that I
will not be able to connect to this instance unless I already know the password
built into this AMI check box.
13. Click Launch Instances.
The system creates the virtual server instance.
14. Click Launch Status, and click View instance.
When the system creates an instance, the Status Checks column displays the message:
2/2 checks passed.

Obtaining the virtual server instance user ID

Procedure
1. Sign in to the Amazon Web Services Management console.
2. Under AWS services, navigate to All services > Compute > EC2.
The system displays the EC2 Management Console page.
3. In the left navigation pane, click Instances.
4. Select a server instance, and click Connect.
5. On the Connect To your Instance page, view the user ID.
Example:
ssh -i "example.pem" ec2-user@<IP address>

March 2021 Deploying Avaya Call Management System on Amazon Web Services 19
Comments on this document? [email protected]
Converting an OVA file to an AMI file

The user name is ec2-user. Use this user ID to connect to the Linux server.

Importing the OVA for AMI conversion

Before you begin
• Create an access key. For more information, see “Creating an access key”.
• Obtain the user id. For more information, see “Obtaining the virtual server instance user id”.
• Converting the *.pem file to the *.ppk format and configure PuTTY for establishing an SSH
connection. For more information, see “Configuring PuTTY”.
Procedure
1. Open an SSH session.
2. In Host Name (or IP address), type the IP Address of the virtual server instance, and click
Open.
3. Log in to the Linux server, and run the command: aws.
4. To configure the AWS details, run the command: aws configure, and do the following:
a. In AWS Access Key ID, type the AWS access key ID.
b. In AWS Secret Access Key, type the AWS secret access key ID.
c. In Default region name, type the region name.
For example: us-west-2.
d. In Default output format, type text or json.
5. To check whether the EC2 instance is ready to use, run the command: aws s3 ls.
The system displays the S3 bucket that you created.
6. To view the content of the S3 bucket, run the command: aws s3 ls s3://
<nameofbucket>.

Note:
If DNS resolution for the VPC is disabled, the execution of the aws s3 ls s3://
<nameofbucket> command fails.
7. To allow importing files into the EC2 instance, create a vmimport role, and attach policies
as mentioned in the following sub-steps:
a. Create a file named trust-policy.json with the following policy:
{ "Version":"2012-10-17", "Statement":[ { "Sid":"", "Effect":"Allow",
"Principal":{ "Service":"vmie.amazonaws.com" }, "Action":"sts:AssumeRole",
"Condition":{ "StringEquals":{ "sts:ExternalId":"vmimport" } } } ] }
b. Use the create-role command to create a role named vmimport and give VM
Import/Export access to it.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 20
Comments on this document? [email protected]
 Importing the OVA for AMI conversion

Ensure that you specify the full path to the location of the trust-policy.json file,
and prefix file:// to it:
aws iam create-role --role-name vmimport --assume-role-policy-document
file://trust-policy.json

c. Create a file named role-policy.json with the following policy:

Where <your_bucket_name> is the bucket where the OVA is stored:
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"s3:ListBucket",
"s3:GetBucketLocation"
],
"Resource":[
"arn:aws:s3:::<your_bucket_name>"
]
},
{
"Effect":"Allow",
"Action":[
"s3:GetObject"
],
"Resource":[
"arn:aws:s3:::<your_bucket_name>/*"
]
},
{
"Effect":"Allow",
"Action":[
"ec2:ModifySnapshotAttribute",
"ec2:CopySnapshot",
"ec2:RegisterImage",
"ec2:Describe*"
],
"Resource":"*"
}
]
}

d. Use the following put-role-policy command to attach the policy to the role
created above.
Ensure that you specify the full path to the location of the role-policy.json file.
aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-
document file://role-policy.json

8. To import the OVA for conversion, type the following command:

aws ec2 import-image --cli-input-json "{ \"Description\": \"<Server OVA>\",
\"DiskContainers\": [ { \"Description\": \"<text description of task>\",
\"UserBucket\": { \"S3Bucket\": \"<your_bucket_name>\", \"S3Key\" : \"<server.ova>
\" } } ]}"

Ensure to replace appropriate values wherever brackets <> are present in above
command.
The system displays the Status and the ImportTaskId parameters.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 21
Comments on this document? [email protected]
Converting an OVA file to an AMI file

9. To check the status of the import image, run the command: aws ec2 describe-
import-image-tasks --cli-input-json "{ \"ImportTaskIds\":
[\"<Your_ImportTaskId>\"], \"NextToken\": \"abc\", \"MaxResults\":
10 } "
Where, ImportTaskId is the one from the output of the Step 8. For example: import-
ami-ffmanv5x.
The conversion process takes up to 30 minutes. You can run the above command
repeatedly. When the AMI conversion is successful, the system displays the Status as
completed and also displays ImageId.
In the following example, the process is at the update stage and is 30% complete.
[ec2-user@ip-10-143-10-81 ~]$ aws ec2 describe-import-image-tasks --cli-input-
json "{ \"ImportTaskIds\": [\"import-ami-ffgji45r\"], \"NextToken\": \"abc\",
\"MaxResults\": 10 } " IMPORTIMAGETASKS <Avaya application>-07.1.0.0.xxx-
aws-001.ova import-ami-ffgji45r 30 active updating

In the following example, the process is preparing the AMI and is 76% complete.
IMPORTIMAGETASKS x86_64 <Avaya application>-07.1.0.0.xxx-aws-001.ova import-ami-
ffgji45r BYOL Linux 76 active preparing ami

The output format varies depending on the selection of the text or JSON format on the aws
CLI configuration.
For more details, see “AWS Import your VM as an image” on the AWS website at http://
docs.aws.amazon.com/vm-import/latest/userguide/import-vm-image.html.
10. Sign in to the Amazon Web Services Management console.
11. Under AWS services, navigate to All services > Compute > EC2.
The system displays the EC2 Management Console page.
12. In the left navigation pane, click IMAGES > AMIs.
You can search the converted AMI with ImageId. The system displays the newly converted
AMI ImageId in the AMI ID column.
You can give an appropriate name for the AMI ImageId.

Creating a key pair

About this task
A key pair is a set of public and private keys. The public key is used to encrypt data, such as the
login password. The private key is used to decrypt the encrypted data. You provide this key pair
when you create a CloudFormation stack, and use it for SSH access to the Amazon Machine
Instances.
For more information, see the following website:
https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html

March 2021 Deploying Avaya Call Management System on Amazon Web Services 22
Comments on this document? [email protected]
 Launching an Amazon EC2 instance

Procedure
1. Sign in to the Amazon Web Services Management console.
2. In the left navigation pane, go to NETWORK & SECURITY, and click Key Pairs.
3. Click Create Key Pair.
4. In the Create Key Pair dialog box, in the Key pair name field, type a name for the key pair.
5. Click Create.
The system generates a *.pem file and prompts you to save the file on your computer. You
can also view the created key pair name in the Key pair name column.
6. Save the *.pem file.

Important:
When you create a key pair, save it. If you lose the key, you cannot retrieve it and you
will not be able to access the instance.

Launching an Amazon EC2 instance

Procedure
1. Sign in to the Amazon Web Services Management console.
2. Under AWS services, navigate to All services > Compute > EC2.
The system displays the EC2 Management Console page.
3. In the navigation pane, click IMAGES > AMIs.
4. Select the Avaya Call Management System(CMS) AMI, and click Launch.

Creating a user access key

Procedure
1. Sign in to the Amazon Web Services Management console.
2. Under AWS services, navigate to Services > Security, Identity, & Compliance > IAM.
The system displays the Welcome to Identity and Access Management page.
3. In the left navigation pane, click Users.
4. Click on a user name.
5. On the Summary page, click the Security Credentials tab.
6. In the Access Keys section, click Create Access Key.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 23
Comments on this document? [email protected]
Converting an OVA file to an AMI file

The system displays the message: Your access key has been created
successfully.

Important:
When you create a security access key, you must save it. If you lose the security
access key, you cannot retrieve it.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 24
Comments on this document? [email protected]
Chapter 5: Deployment process

Deployment checklist
Task Notes

Complete all the planning and For information about planning and configuring, see the
configuration requirements. chapter “Planning”.
Deploy the AMI that has been converted Deploying the CMS application AMI on page 25
from the AWS-specific CMS OVA.
For information about AWS) virtual instances and virtual
servers, and launching applications, see Deploying
Contact Center Applications on Amazon Web Services.
Configure the AWS deployment for a Instance Types and capacities for an AWS
small, medium, or large configuration. deployment on page 13
Complete the deployment by following Configuring the CMS software on page 27
the standard CMS deployment process.

Important:
You must license each CMS instance, that is, each deployment of an AMI. To deploy multiple
instances of a CMS AMI, customers or business partners must order a separate CMS license
for each AMI deployment.

Deploying the CMS application AMI

Before you begin
Convert the AWS-specific CMS OVA to AMI. For more information, see Checklist for converting an
OVA file to an AMI file on page 16.
Procedure
1. Sign in to the Amazon Web Services Management console.
2. Under AWS services, navigate to All services > Compute > EC2.
The system displays the EC2 Management Console page.
3. In the navigation pane, click IMAGES > AMIs.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 25
Comments on this document? [email protected]
Deployment process

The system displays the list of AMIs.

4. Select the Contact Center application AMI, and click Launch.
5. On the Choose an Instance Type page, select an instance type, and click Next: Configure
Instance Details.
You must select the correct instance type for deploying the AMI. Selecting an incorrect
instance type might affect the usability of the system . For information about the instance
type, see chapter Supported footprints for the Contact Center applications on AWS in
Deploying Contact Center Applications on Amazon Web Services.
6. On the Configure Instance Details page, do the following:
a. In the Network field, click a VPC network.
b. In the Network interfaces section, assign an IP address.
On the Configure Instance page, configuration is different for different products. For
information about application specific configuration, see the product-specific AWS
deployment guide on the Avaya Support website at:
http://support.avaya.com
7. Click Next: Add Storage.
8. On the Add Storage page, leave the default settings, and click Next: Add Tags.
9. On the Add Tags page, add a tag, and click Next: Configure Security Group.
10. On the Configure Security Group page, create a new security group or select an existing
security group, and click Review and Launch.
You must select the security group that has the required ports enabled. For information
about ports, see port matrix on the Avaya Support website at:
http://support.avaya.com/
11. On the Select an existing key pair or create a new key pair dialog box, select one of the
following options:
• Choose an existing key pair: If you select this option, perform the following:
- From the Select a key pair drop-down list, select a key pair.
- Select the I acknowledge that I have access to the selected private key file
(<example.pem>), and that without this file, I won't be able to log into my
instance check box.
• Create a new key pair: If you select this option, perform the following:
- In the Key pair name field, type a name for the private key file. The extension of the
private key file is .pem.
- Click Download Key Pair.
- Save the file in a secure and accessible location.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 26
Comments on this document? [email protected]
 Configuring the CMS software

Note:
You will not be able to download the file again.
• Proceed without a key pair: If you select this option, select the I acknowledge that I
will not be able to connect to this instance unless I already know the password
built into this AMI check box.
12. Click Launch Instances.
The system creates the instance and displays it on the Instances page.
When the system creates an instance, the Status Checks column displays the message:
2/2 checks passed.

Configuring the CMS software

About this task
Use the procedures referenced in this section to configure required and optional features on a
newly-deployed CMS.
Before you begin
Get the following documents:
• Deploying Avaya Call Management System
• Maintaining and Troubleshooting Avaya Call Management System
Procedure
1. Do the procedures found in the “Configuring system features” chapter in Deploying Avaya
Call Management System.
2. Do the procedures found in the “Configuring CMS features” chapter in Deploying Avaya
Call Management System.
3. Set up CMS as described in the chapter “Setting up CMS” in Deploying Avaya Call
Management System.
4. Install and set up any optional CMS features as shown in the chapter “Installing and
configuring optional software” in Maintaining and Troubleshooting Avaya Call Management
System.
5. Set the correct time and date on the system as shown in Maintaining and Troubleshooting
Avaya Call Management System
6. Follow the procedures in the chapter “Turning the system over to the customer” in
Deploying Avaya Call Management System.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 27
Comments on this document? [email protected]
Deployment process

Verifying CMS on the AWS instance

Procedure
1. Log on to the AWS console.
2. Click EC2.
3. On the left pane, click Instances.
4. From the drop-down list, click Instances.
5. Click on the instance you have created.
6. Click Actions.
7. From the drop-down list, click Instance State and click Start.
The system creates the instance and displays it on the Instances page.
When the system creates an instance, the Status Checks column displays the message:
2/2 .
8. SSH to CMS server IP address.
9. Log on as cms using the initial password of avayaaws318.
The system displays a console terminal window.
10. Log on as root using the following command:
su - root
To change the System Name, you can use the netconfig command. For information on
the instructions to run the netconfig command, see Maintaining and Troubleshooting
Avaya Call Management System.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 28
Comments on this document? [email protected]
Chapter 6: Maintenance operations

Backing up CMS on a virtual machine

For information about backing up Avaya Call Management System (CMS) on a virtual machine, see
Maintaining and Troubleshooting Avaya Call Management System.
Support for AWS instance
The standard process is outlined in the CMS Product Offer Definition on https://sales.avaya.com/
documents/1399588510048.

Restoring CMS on a virtual machine

About this task
If a failure occurs on your AWS deployment or the CMS software becomes corrupted, use this
procedure to restore your system.
Procedure
1. Deploy the AMI as if this was a new installation.
2. Set up networking as shown in the “Configuring the system network” section in Deploying
Avaya Call Management System.
3. Do a CMSADM restore as shown in “Restore CMS setup using a CMSADM backup” in
Maintaining and Troubleshooting Avaya Call Management System.
4. To access the CMSADM backup from a NFS mount point, enter:
mkdir NFSMountPoint
mount NFSServer:NFSDirectory NFSMountPoint

5. Verify that the backup files are on the NFS mounted folder. Enter:
ls —al NFSMountPoint

6. Change to the /tmp folder. Enter:

cd /tmp

7. Enter the following command on a single line:

cpio -icumdv -C 10240 -I NFSMountPoint/CMSADMFilename "cms/install/bin/restore"

March 2021 Deploying Avaya Call Management System on Amazon Web Services 29
Comments on this document? [email protected]
Maintenance operations

where CMSADMFilename is the CMSADM system backup file. Enter the CMSADM file
name to match the path on the media device, for example:
cpio -icmudv -C 10240 -I /a/CMSADM-rNNxx.y-121116151708-trex "cms/
install/bin/restore"

The name of the CMSADM backup file identifies the following, for example:
• Type of backup: CMSADM
• CMS version at the time of the backup: rNNxx.y
• Date of the backup: 121116 (yymmdd)
• Unique identifier of the backup: 151708
• CMS hostname: trex
8. Press Ctrl+C.
The system stops searching the CMSADM backup media device.
Note:
If you do not press Ctrl+C, the system continues to search the entire backup media
device. This search might take several hours to complete.
9. Verify that the restore script has the correct permissions. Enter:
chmod +x cms/install/bin/restore

The system sets the correct permissions to run the script. If the permissions for the script
are not correct, the restore fails.
10. Restore the system from the media device. Enter:
cms/install/bin/restore NFSMountPoint/CMSADMFilename

The system restores the files on the backup media. The system automatically reboots after
transferring the files on the media device.
Note:
If a problem occurs during the restore process, the system displays prompts indicating
a problem. Follow the instructions displayed by the system.
11. Log on with a CMS user ID, for example, cms.
12. Log on as root using the following command:
su - root
13. The restore process continues. The process might fail when the system detects that the
CMS hardware configuration has changed.
The system displays the following messages:
<timestamp> ERR:CMS Setup has failed 3 times.
<timestamp> ERR:View the admin.log file for details on status.
<timestamp> ERR:You will need to manually resolve the problem.
<timestamp> ERR:The most likely cause is an error in or problem
<timestamp> ERR:with the CMS Setup flat file.
<timestamp> ERR:CMS Restore failed to complete.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 30
Comments on this document? [email protected]
 Starting an Amazon Web Services instance

14. Verify that the CMS hardware feature is authorized by the license file. Enter: cmssvc.
15. Enter the number for the auth_display option.
The system displays the current authorizations.
16. Review the list of authorizations and verify authorization of the CMS hardware feature.
17. Turn off IDS. Enter: cmssvc.
18. Enter the number of the run_ids option.
19. Enter the number of the Turn off IDS option.
20. Set up CMS. Enter: /cms/install/bin/restore database.
21. To verify that the installation completed successfully, enter: tail /cms/install/
logdir/admin.log.
The system logs all failure messages in this file. The CMS software setup is a success
when the system displays: Setup completed successfully <date/time>.

Note:
If CMS setup fails, verify that the flat file is correct and rerun Step 21. If CMS setup
fails again, escalate through normal channels.
22. Do a maintenance restore as shown in the “Restore CMS data using a CMS Maintenance
restore” in Maintaining and Troubleshooting Avaya Call Management System.

Starting an Amazon Web Services instance

Procedure
1. Log on to the Amazon Web Services Management console.
2. Go to Services > Compute, and click EC2.
The system displays the EC2 Management Console page.
3. In the navigation pane, click Instances.
4. Select one or more instance, and then click Actions > Instance State > Start.
The system displays a message to start the instances.
5. Click Yes,Start.
When the system starts the instance, the Instance State column displays the state as
Running.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 31
Comments on this document? [email protected]
Maintenance operations

Stopping an Amazon Web Services instance

Procedure
1. Log on to the Amazon Web Services console.
2. Go to Services > Compute, and click EC2.
The system displays the EC2 Management Console page.
3. In the navigation pane, click Instances.
4. Select one or more instance, and then click Actions > Instance State > Stop.
The system displays a message to stop the instances.
5. Click Yes, Stop.
When the system stops the instance, the Instance State column displays the state as
Stopped.

Rebooting an Amazon Web Services instance

Procedure
1. Log on to the Amazon Web Services Management console.
2. Go to Services > Compute, and click EC2.
The system displays the EC2 Management Console page.
3. In the navigation pane, click Instances.
4. Select one or more instance, and then click Actions > Instance State > Reboot.
The system displays a message to reboot the instances.
5. Click Yes, Reboot.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 32
Comments on this document? [email protected]
Chapter 7: Resources

Documentation
CMS and CMS Supervisor Documents
Title Description Audience
Overview
Avaya Call Management Describes tested product characteristics and Sales engineers,
System Overview and product capabilities including feature Administrators
Specification descriptions, interoperability, performance
specifications, security, and licensing
requirements.
Product Privacy Statement for Describes how personal data is stored and Administrators
Avaya Call Management processed by CMS.
System
Design
Avaya Customer Experience Describes the AvayaCustomer Experience Sales engineers
Virtualized Environment Virtualized Environment market solution from a
Solution Description holistic perspective that focuses on the
functional view of the solution architecture.
Installation, upgrades, maintenance, and troubleshooting
Deploying Avaya Call Describes how to plan, deploy, and configure Avaya support
Management System CMS on new VMware-based installations. personnel
Deploying Avaya Call Describes how to plan, deploy, and configure Avaya support
Management System on CMS on new Amazon Web Services personnel
Amazon Web Services installations.
Avaya Call Management Describes how to install, maintain, and Avaya support
System Dell® PowerEdge™ troubleshoot Dell® servers used with CMS. personnel
R630 and R730 Hardware
Installation, Maintenance and
Troubleshooting
Avaya Call Management Describes how to install, maintain, and Avaya support
System HPE DL20 G9 and troubleshoot HPE servers used with CMS. personnel
DL380 G9 Hardware
Installation, Maintenance, and
Troubleshooting
Table continues…

March 2021 Deploying Avaya Call Management System on Amazon Web Services 33
Comments on this document? [email protected]
Resources

Title Description Audience

Planning for Avaya Call Describes the procedures customers must plan Administrators
Management System Upgrades for before and after upgrading to a new CMS
release.
Upgrading Avaya Call Describes the procedures required to upgrade to Avaya support
Management System a new CMS release. personnel
Maintaining and Describes how to configure, maintain, and Avaya support
Troubleshooting Avaya Call troubleshoot CMS. personnel,
Management System Administrators
Avaya Call Management Describes how to connect and administer the Avaya support
System and Communication Communication Manager systems used by personnel,
Manager Connections, CMS. Administrators
Administration, and
Troubleshooting
Avaya Call Management Describes the procedures to upgrade from one Administrators
System Base Load Upgrade base load (for example, 19.1.0.0) to another
base load (for example, 19.1.0.1). Not all
releases support base load upgrades.
Using Avaya Call Management Describes how to install and maintain a CMS HA Avaya support
System High Availability system. personnel,
Administrators
Using Avaya Call Management Describes how to back up your CMS data using Administrators
System LAN Backup a LAN connection to a remote server.
Avaya Call Management Describes how to connect to HA servers and Avaya support
System High Availability upgrade to HA. personnel,
Connectivity, Upgrade and Administrators
Administration
Using Avaya Call Management Describes how to install and maintain your CMS Avaya support
System High Availability High Availability (HA) system. personnel,
Administrators
Administration
Administering Avaya Call Provides instructions on administering a call Avaya support
Management System center using CMS Supervisor. personnel,
Administrators
Avaya Call Management Describes the format of the Call History data Administrators
System Call History Interface files and how to transfer these files to another
computer.
Using ODBC and JDBC with Describes how to use Open Database Administrators
Avaya Call Management Connectivity (ODBC) and Java Database
System Connectivity (JDBC) with CMS.
Avaya Call Management Describes each database item and calculation Administrators,
System Database Items and that CMS tracks and how CMS calculates the Report designers
Calculations values displayed on CMS reports and CMS
Supervisor reports.
Table continues…

March 2021 Deploying Avaya Call Management System on Amazon Web Services 34
Comments on this document? [email protected]
 Documentation

Title Description Audience

Avaya Call Management Describes how to design and create custom Administrators,
System Custom Reports reports in CMS. Operations
personnel, Report
designers
Avaya Call Management Describes how to implement security features in Avaya support
System Security CMS. personnel,
Administrators
CMS Supervisor
Avaya CMS Supervisor Clients Describes how to install and configure CMS Avaya support
Installation and Getting Started Supervisor. personnel,
Administrators
Avaya CMS Supervisor Reports Describes how to use CMS Supervisor reports. Administrators,
Operations
personnel
Avaya CMS Supervisor Report Describes how to create new reports and to edit Administrators,
Designer existing reports through Report Designer and Operations
Report Wizard. personnel, Report
designers

Avaya Solutions Platform Documents

Title Description Audience
Avaya Solutions Platform Describes the key features of IT Management, sales and
Overview and Specification Avaya Solutions Platform server deployment engineers, solution
architects, support personnel
Installing the Avaya Solutions Describes how to install Avaya Sales and deployment engineers,
Platform 130 Appliance Solutions Platform 130 Series solution architects, support
servers. personnel
Maintaining and Troubleshooting Describes procedures to maintain Sales and deployment engineers,
Avaya Solutions Platform 130 and troubleshoot Avaya Solutions solution architects, support
Appliance Platform 130 Series servers. personnel
Avaya Solutions Platform 130 Describes procedures to use the Sales and deployment engineers,
Series iDRAC9 Best Practices iDRAC9 tools on the Avaya solution architects, support
Solutions Platform 130 Series personnel
servers.

WebLM Documents
Title Description Audience
Deploying standalone Avaya Deploy the application in virtual appliance Implementation
WebLM in Virtual Appliance environment by using Solution Deployment personnel
Manager
Table continues…

March 2021 Deploying Avaya Call Management System on Amazon Web Services 35
Comments on this document? [email protected]
Resources

Title Description Audience

Deploying standalone Avaya Deploy the application in virtualized environment. Implementation
WebLM in Virtualized personnel
Environment
Deploying standalone Avaya Deploy the application on cloud services. Implementation
WebLM in Infrastructure as a personnel
Service Environment
Deploying standalone Avaya Deploy the application in software-only Implementation
WebLM in Software-Only environment. personnel
Environment
Upgrading standalone Avaya Upgrade the application. Implementation
WebLM personnel
Administering standalone Avaya Do administration tasks System
WebLM administrators

VMware Documents
VMware component or Document description Document URL
operation
vSphere Virtual Machine Provides information on https://docs.vmware.com/en/
Administration managing virtual machines in the VMware-vSphere/6.5/
VMware vSphere Web Client for com.vmware.vsphere.vm_admin.
vSphere 6.0 or later. This doc/GUID-55238059-912E-411F-
document also provides A0E9-A7A536972A91.html
information of the following:
• Deploying OVF templates
• Configuring virtual machine
hardware and options
• Managing Virtual Machines
vSphere Web Client Provides information on how https://docs.vmware.com/en/
through a browser vSphere Web VMware-vSphere/6.5/
Client connects to a vCenter com.vmware.vsphere.vcenterhost
server or directly to an ESXi host .doc/GUID-
if a vCenter Server is not used. A618EF76-638A-49DA-991D-
B93C5AC0E2B1.html

Note:
If the document description (link) are no longer active, consult VMware for documents
associated with the component or operation.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 36
Comments on this document? [email protected]
 Amazon Web Services documentation

Amazon Web Services documentation

For information about the Amazon Web Services documentation, go to the AWS documentation
website at https://aws.amazon.com/documentation/.

Finding documents on the Avaya Support website

Procedure
1. Go to https://support.avaya.com.
2. At the top of the screen, type your username and password and click Login.
3. Click Support by Product > Documents.
4. In Enter your Product Here, type the product name and then select the product from the
list.
5. In Choose Release, select the appropriate release number.
The Choose Release field is not available if there is only one release for the product.
6. In the Content Type filter, click a document type, or click Select All to see a list of all
available documents.
For example, for user guides, click User Guides in the Content Type filter. The list only
displays the documents for the selected category.
7. Click Enter.

Viewing Avaya Mentor videos

Avaya Mentor videos provide technical content on how to install, configure, and troubleshoot
Avaya products.
About this task
Videos are available on the Avaya Support website, listed under the video document type, and on
the Avaya-run channel on YouTube.
• To find videos on the Avaya Support website, go to https://support.avaya.com/ and do one of
the following:
- In Search, type Avaya Mentor Videos, click Clear All and select Video in the Content
Type.
- In Search, type the product name. On the Search Results page, click Clear All and select
Video in the Content Type.
The Video content type is displayed only when videos are available for that product.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 37
Comments on this document? [email protected]
Resources

In the right pane, the page displays a list of available videos.

• To find the Avaya Mentor videos on YouTube, go to www.youtube.com/AvayaMentor and do
one of the following:
- Enter a key word or key words in the Search Channel to search for a specific product or
topic.
- Scroll down Playlists, and click a topic name to see the list of videos available for the topic.
For example, Contact Centers.
Note:
Videos are not available for all products.

Support
Go to the Avaya Support website at https://support.avaya.com for the most up-to-date
documentation, product notices, and knowledge articles. You can also search for release notes,
downloads, and resolutions to issues. Use the online service request system to create a service
request. Chat with live agents to get answers to questions, or request an agent to connect you to a
support team if an issue requires additional expertise.

Using the Avaya InSite Knowledge Base

The Avaya InSite Knowledge Base is a web-based search engine that provides:
• Up-to-date troubleshooting procedures and technical tips
• Information about service packs
• Access to customer and technical documentation
• Information about training and certification programs
• Links to other pertinent information
If you are an authorized Avaya Partner or a current Avaya customer with a support contract, you
can access the Knowledge Base without extra cost. You must have a login account and a valid
Sold-To number.
Use the Avaya InSite Knowledge Base for any potential solutions to problems.
1. Go to http://www.avaya.com/support.
2. Log on to the Avaya website with a valid Avaya user ID and password.
The system displays the Avaya Support page.
3. Click Support by Product > Product-specific Support.
4. In Enter Product Name, enter the product, and press Enter.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 38
Comments on this document? [email protected]
 Support

5. Select the product from the list, and select a release.

6. Click the Technical Solutions tab to see articles.
7. Select relevant articles.

March 2021 Deploying Avaya Call Management System on Amazon Web Services 39
Comments on this document? [email protected]
Index
A H
Amazon EC2 virtual server instance hybrid network connection
create ............................................................................17 Direct Connection ........................................................... 9
AMI installation .................................................................... 25 VPN Connections ........................................................... 9
application software ............................................................... 9
Avaya PLDS
OVA file .........................................................................12
I
Avaya support website .........................................................38 importing OVA for conversion .............................................. 20
AWS console ....................................................................... 28 InSite Knowledge Base ........................................................38
AWS instance ...................................................................... 13 instance state .................................................................31, 32
AWS management .................................................................8 Instance state ...................................................................... 28
AWS virtual instances .......................................................... 25

K
B
key pair
backing up ........................................................................... 29 creating .........................................................................22
backup options ..................................................................... 11
baseload upgrade media ......................................................11
L
C Lanbackup ........................................................................... 10
launching
capacities .............................................................................13 Amazon EC2 instance .................................................. 23
CAPEX ...................................................................................8 Linux ...................................................................................... 8
checklist
converting OVA to AMI ................................................. 16
OVA to Amazon Machine Image ...................................16 N
CMS AMI
network topology ....................................................................9
deploy ........................................................................... 25
NFS ......................................................................................10
CMS installation ...................................................................10
CMS software
configuring .................................................................... 27 O
CMS version ........................................................................ 29
CMS web client ....................................................................10 obtaining
Communication manager .....................................................14 virtual server instance user id .......................................19
configuring OVA
CMS software ............................................................... 27 upload to the AWS console .......................................... 17
creating OVA file ............................................................................ 9, 14
bucket ........................................................................... 16 AWS ..............................................................................12
user access key ............................................................23 OVA to AMI conversion ........................................................20
creating a key pair ............................................................... 22 overview .................................................................................8

D R
deploy reboot ...................................................................................32
CMS AMI ...................................................................... 25 redundancy .......................................................................... 14
documentation ..................................................................... 33 related documentation ......................................................... 33
Amazon Web Services ................................................. 37
AWS ..............................................................................37
E restoring ...............................................................................29
restoring CMS ......................................................................29
EC2 ......................................................................................32
EC2 management ................................................................32

March 2021 Deploying Avaya Call Management System on Amazon Web Services 40
Comments on this document? [email protected]
 Index

S
services ................................................................................31
software media .....................................................................11
supervisor users .................................................................. 10
support .................................................................................38
Survivable CMS ................................................................... 14

U
unique identifier ................................................................... 29

V
videos .................................................................................. 37
VPN ....................................................................................... 9

W
WAN connection .................................................................. 10

March 2021 Deploying Avaya Call Management System on Amazon Web Services 41
Comments on this document? [email protected]