Professional Documents
Culture Documents
Installing Avaya Control Manager: Release 9.0.2 Issue 5 February 2022
Installing Avaya Control Manager: Release 9.0.2 Issue 5 February 2022
Release 9.0.2
Issue 5
February 2022
© 2020-2022, Avaya Inc. documentation does not expressly identify a license type, the
All Rights Reserved. applicable license will be a Designated System License as set forth
below in the Designated System(s) License (DS) section as
Notice applicable. The applicable number of licenses and units of capacity
While reasonable efforts have been made to ensure that the for which the license is granted will be one (1), unless a different
information in this document is complete and accurate at the time of number of licenses or units of capacity is specified in the
printing, Avaya assumes no liability for any errors. Avaya reserves documentation or other materials available to You. “Software” means
the right to make changes and corrections to the information in this computer programs in object code, provided by Avaya or an Avaya
document without the obligation to notify any person or organization Channel Partner, whether as stand-alone products, pre-installed on
of such changes. hardware products, and any upgrades, updates, patches, bug fixes,
or modified versions thereto. “Designated Processor” means a single
Documentation disclaimer stand-alone computing device. “Server” means a set of Designated
“Documentation” means information published in varying mediums Processors that hosts (physically or virtually) a software application
which may include product information, operating instructions and to be accessed by multiple users. “Instance” means a single copy of
performance specifications that are generally made available to users the Software executing at a particular time: (i) on one physical
of products. Documentation does not include marketing materials. machine; or (ii) on one deployed software virtual machine (“VM”) or
Avaya shall not be responsible for any modifications, additions, or similar deployment.
deletions to the original published version of Documentation unless License types
such modifications, additions, or deletions were performed by or on
the express behalf of Avaya. End User agrees to indemnify and hold Designated System(s) License (DS). End User may install and use
harmless Avaya, Avaya's agents, servants and employees against all each copy or an Instance of the Software only: 1) on a number of
claims, lawsuits, demands and judgments arising out of, or in Designated Processors up to the number indicated in the order; or 2)
connection with, subsequent modifications, additions or deletions to up to the number of Instances of the Software as indicated in the
this documentation, to the extent made by End User. order, Documentation, or as authorized by Avaya in writing. Avaya
may require the Designated Processor(s) to be identified in the order
Link disclaimer by type, serial number, feature key, Instance, location or other
Avaya is not responsible for the contents or reliability of any linked specific designation, or to be provided by End User to Avaya through
websites referenced within this site or Documentation provided by electronic means established by Avaya specifically for this purpose.
Avaya. Avaya is not responsible for the accuracy of any information, Concurrent User License (CU). End User may install and use the
statement or content provided on these sites and does not Software on multiple Designated Processors or one or more Servers,
necessarily endorse the products, services, or information described so long as only the licensed number of Units are accessing and using
or offered within them. Avaya does not guarantee that these links will the Software at any given time as indicated in the order,
work all the time and has no control over the availability of the linked Documentation, or as authorized by Avaya in writing. A “Unit” means
pages. the unit on which Avaya, at its sole discretion, bases the pricing of its
Warranty 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
Avaya provides a limited warranty on Avaya hardware and software. function (e.g., webmaster or helpdesk), or a directory entry in the
Refer to your sales agreement to establish the terms of the limited administrative database utilized by the Software that permits one
warranty. In addition, Avaya’s standard warranty language, as well as user to interface with the Software. Units may be linked to a specific,
information regarding support for this product while under warranty is identified Server or an Instance of the Software.
available to Avaya customers and other parties through the Avaya
Support website: https://support.avaya.com/helpcenter/ Copyright
getGenericDetails?detailId=C20091120112456651010 under the link Except where expressly stated otherwise, no use should be made of
“Warranty & Product Lifecycle” or such successor site as designated materials on this site, the Documentation, Software, Hosted Service,
by Avaya. Please note that if You acquired the product(s) from an or hardware provided by Avaya. All content on this site, the
authorized Avaya Channel Partner outside of the United States and documentation, Hosted Service, and the product provided by Avaya
Canada, the warranty is provided to You by said Avaya Channel including the selection, arrangement and design of the content is
Partner and not by Avaya. owned either by Avaya or its licensors and is protected by copyright
Licenses and other intellectual property laws including the sui generis rights
relating to the protection of databases. You may not modify, copy,
THE SOFTWARE LICENSE TERMS AVAILABLE ON THE AVAYA reproduce, republish, upload, post, transmit or distribute in any way
WEBSITE, HTTPS://SUPPORT.AVAYA.COM/LICENSEINFO, any content, in whole or in part, including any code and software
UNDER THE LINK “AVAYA SOFTWARE LICENSE TERMS (Avaya unless expressly authorized by Avaya. Unauthorized reproduction,
Products)” OR SUCH SUCCESSOR SITE AS DESIGNATED BY transmission, dissemination, storage, and or use without the express
AVAYA, ARE APPLICABLE TO ANYONE WHO DOWNLOADS, written consent of Avaya can be a criminal, as well as a civil offense
USES AND/OR INSTALLS AVAYA SOFTWARE, PURCHASED under the applicable law.
FROM AVAYA INC., ANY AVAYA AFFILIATE, OR AN AVAYA
CHANNEL PARTNER (AS APPLICABLE) UNDER A COMMERCIAL Virtualization
AGREEMENT WITH AVAYA OR AN AVAYA CHANNEL PARTNER. The following applies if the product is deployed on a virtual machine.
UNLESS OTHERWISE AGREED TO BY AVAYA IN WRITING, Each product has its own ordering code and license types. Unless
AVAYA DOES NOT EXTEND THIS LICENSE IF THE SOFTWARE otherwise stated, each Instance of a product must be separately
WAS OBTAINED FROM ANYONE OTHER THAN AVAYA, AN AVAYA licensed and ordered. For example, if the end user customer or
AFFILIATE OR AN AVAYA CHANNEL PARTNER; AVAYA Avaya Channel Partner would like to install two Instances of the
RESERVES THE RIGHT TO TAKE LEGAL ACTION AGAINST YOU same type of products, then two products of that type must be
AND ANYONE ELSE USING OR SELLING THE SOFTWARE ordered.
WITHOUT A LICENSE. BY INSTALLING, DOWNLOADING OR
USING THE SOFTWARE, OR AUTHORIZING OTHERS TO DO SO, Third Party Components
YOU, ON BEHALF OF YOURSELF AND THE ENTITY FOR WHOM “Third Party Components” mean certain software programs or
YOU ARE INSTALLING, DOWNLOADING OR USING THE portions thereof included in the Software or Hosted Service may
SOFTWARE (HEREINAFTER REFERRED TO contain software (including open source software) distributed under
INTERCHANGEABLY AS “YOU” AND “END USER”), AGREE TO third party agreements (“Third Party Components”), which contain
THESE TERMS AND CONDITIONS AND CREATE A BINDING terms regarding the rights to use certain portions of the Software
CONTRACT BETWEEN YOU AND AVAYA INC. OR THE (“Third Party Terms”). As required, information regarding distributed
APPLICABLE AVAYA AFFILIATE (“AVAYA”). Linux OS source code (for those products that have distributed Linux
Avaya grants You a license within the scope of the license types OS source code) and identifying the copyright holders of the Third
described below, with the exception of Heritage Nortel Software, for Party Components and the Third Party Terms that apply is available
which the scope of the license is detailed below. Where the order in the products, Documentation or on Avaya’s website at: https://
support.avaya.com/Copyright or such successor site as designated
by Avaya. The open source software license terms provided as Third or otherwise, any license or right in and to the Marks without the
Party Terms are consistent with the license rights granted in these express written permission of Avaya or the applicable third party.
Software License Terms, and may contain additional rights benefiting
Avaya is a registered trademark of Avaya Inc.
You, such as modification and distribution of the open source
software. The Third Party Terms shall take precedence over these All non-Avaya trademarks are the property of their respective owners.
Software License Terms, solely with respect to the applicable Third
Party Components to the extent that these Software License Terms
impose greater restrictions on You than the applicable Third Party
Terms.
The following applies only if the H.264 (AVC) codec is distributed with
the product. THIS PRODUCT IS LICENSED UNDER THE AVC
PATENT PORTFOLIO LICENSE FOR THE PERSONAL USE OF A
CONSUMER OR OTHER USES IN WHICH IT DOES NOT RECEIVE
REMUNERATION TO (i) ENCODE VIDEO IN COMPLIANCE WITH
THE AVC STANDARD (“AVC VIDEO”) AND/OR (ii) DECODE AVC
VIDEO THAT WAS ENCODED BY A CONSUMER ENGAGED IN A
PERSONAL ACTIVITY AND/OR WAS OBTAINED FROM A VIDEO
PROVIDER LICENSED TO PROVIDE AVC VIDEO. NO LICENSE IS
GRANTED OR SHALL BE IMPLIED FOR ANY OTHER USE.
ADDITIONAL INFORMATION MAY BE OBTAINED FROM MPEG LA,
L.L.C. SEE HTTP://WWW.MPEGLA.COM.
Service Provider
THE FOLLOWING APPLIES TO AVAYA CHANNEL PARTNER’S
HOSTING OF AVAYA PRODUCTS OR SERVICES. THE PRODUCT
OR HOSTED SERVICE MAY USE THIRD PARTY COMPONENTS
SUBJECT TO THIRD PARTY TERMS AND REQUIRE A SERVICE
PROVIDER TO BE INDEPENDENTLY LICENSED DIRECTLY FROM
THE THIRD PARTY SUPPLIER. AN AVAYA CHANNEL PARTNER’S
HOSTING OF AVAYA PRODUCTS MUST BE AUTHORIZED IN
WRITING BY AVAYA AND IF THOSE HOSTED PRODUCTS USE
OR EMBED CERTAIN THIRD PARTY SOFTWARE, INCLUDING
BUT NOT LIMITED TO MICROSOFT SOFTWARE OR CODECS,
THE AVAYA CHANNEL PARTNER IS REQUIRED TO
INDEPENDENTLY OBTAIN ANY APPLICABLE LICENSE
AGREEMENTS, AT THE AVAYA CHANNEL PARTNER’S EXPENSE,
DIRECTLY FROM THE APPLICABLE THIRD PARTY SUPPLIER.
Preventing Toll Fraud
“Toll Fraud” is the unauthorized use of your telecommunications
system by an unauthorized party (for example, a person who is not a
corporate employee, agent, subcontractor, or is not working on your
company's behalf). Be aware that there can be a risk of Toll Fraud
associated with your system and that, if Toll Fraud occurs, it can
result in substantial additional charges for your telecommunications
services.
Avaya Toll Fraud intervention
If You suspect that You are being victimized by Toll Fraud and You
need technical assistance or support, call Technical Service Center
Toll Fraud Intervention Hotline at +1-800-643-2353 for the United
States and Canada. For additional support telephone numbers, see
the Avaya Support website: https://support.avaya.com or such
successor site as designated by Avaya.
Downloading Documentation
For the most current versions of Documentation, see the Avaya
Support website: https://support.avaya.com, or such successor site
as designated by Avaya.
Contact Avaya Support
See the Avaya Support website: https://support.avaya.com for
product or Hosted Service notices and articles, or to report a problem
with your Avaya product or Hosted Service. For a list of support
telephone numbers and contact addresses, go to the Avaya Support
website: https://support.avaya.com (or such successor site as
designated by Avaya), scroll to the bottom of the page, and select
Contact Avaya Support.
Trademarks
The trademarks, logos and service marks (“Marks”) displayed in this
site, the Documentation, Hosted Service(s), and product(s) provided
by Avaya are the registered or unregistered Marks of Avaya, its
affiliates, its licensors, its suppliers, or other third parties. Users are
not permitted to use such Marks without prior written consent from
Avaya or such third party which may own the Mark. Nothing
contained in this site, the Documentation, Hosted Service(s) and
product(s) should be construed as granting, by implication, estoppel,
Contents
Chapter 1: Introduction............................................................................................................ 7
Purpose.................................................................................................................................. 7
Change history........................................................................................................................ 7
Chapter 2: Overview................................................................................................................. 8
Installation process overview.................................................................................................... 8
Control Manager configurations................................................................................................ 9
Architecture overview............................................................................................................ 10
Chapter 3: Requirements....................................................................................................... 13
Hardware and virtualization requirements................................................................................ 13
Optional load balancer server configuration....................................................................... 15
Software requirements........................................................................................................... 16
Latest software updates and patch information.................................................................. 16
Supported database server software requirements............................................................. 16
Supported Microsoft Windows Server and Microsoft SQL Server combinations.................... 19
Supported client Web browser and client operating system software requirements .............. 20
Supported antivirus software............................................................................................ 20
Certificate requirements................................................................................................... 21
Java Runtime Environment requirements.......................................................................... 21
Transport Layer Security support...................................................................................... 22
Virtualization support....................................................................................................... 23
Windows hardening setting.................................................................................................... 23
Chapter 4: Installing Control Manager software.................................................................. 26
Installation Checklist.............................................................................................................. 26
Installing Control Manager on a non-HA dual-box configuration................................................. 27
Installing 2x1 Multiplex HA .................................................................................................... 27
Installing 1x2 Multiplex HA .................................................................................................... 28
Installing 2x2 Multiplex HA .................................................................................................... 29
Installing Control Manager and SQL Server in one box (All-in-One)........................................... 30
Installing Control Manager using the Installation Wizard........................................................... 31
Installing Control Manager using CLI (Silent or Headless Installation)........................................ 34
Configuring session timeout for Control Manager UI portals...................................................... 37
Chapter 5: Installing and configuring prerequisites............................................................ 38
Installing and configuring IIS on the Microsoft Windows Server................................................. 38
Installing the Microsoft SQL Server software............................................................................ 41
Enable TCP/IP after installing the Microsoft SQL software.................................................. 43
Installing the Microsoft SQL Server AlwaysOn and WSFC features........................................... 43
Installing the optional load balancer software........................................................................... 45
Configuring TLS and TDE for Avaya Control Manager Multiplex HA configurations..................... 46
Installing certificates.............................................................................................................. 49
Purpose
This document contains checklists, descriptions, and procedures for installing Avaya Control
Manager for Enterprise in Multiplex High Availability (MHA) and non-High Availability (Non-HA)
configurations.
Avaya implementation personnel and administrators who install and configure Avaya Control
Manager will use this document.
This document provides the following information:
• An overview of deployments and product architecture
• Hardware and software requirements
• Installation checklists and worksheets
• Installation procedures for the prerequisite third-party software
• Installation procedures for the Control Manager software
• Test procedures
Change history
Note:
After you complete installation of Control Manager, delete all the guest accounts that
the operating system might have created.
3. For the Control Manager database server, depending on the type of deployment, install
and configure the Microsoft Windows operating system. Then, install the Microsoft SQL
Server software, as suggested in Supported Microsoft Windows Server and Microsoft SQL
Server combinations on page 19.
4. If you want to configure a load balancer software, configure the software on an additional
virtual machine. Depending on the type of load balancer software you select, you can use
Linux, Windows, or another operating system as the virtual machine.
5. Download the Control Manager software. Avaya personnel can download the software if
you grant Avaya access to your systems.
After you complete the deployment process steps, the Avaya personnel must perform the
following steps:
1. Install and configure the Control Manager software on the prescribed number of servers.
2. Configure the optional software load balancer. For more information, see Configuring the
optional software load balancer on page 54.
3. Configure the Microsoft SQL AlwaysOn feature. For more information, see About
configuring AlwaysOn on page 60.
4. Test the installed software to confirm proper operation.
Note:
For more information about Non-standard drive installation, in the Maintaining and
Troubleshooting Avaya Control Manager guide, see Chapter 6: General troubleshooting >
Troubleshooting Control Sphere > Sphere service not starting on non-standard drive.
• All-in-One (AIO) Enterprise: Offers a single host configuration without a High Availability
(HA) support. This configuration hosts a single server for both application software and
database software. This configuration supports only the Microsoft SQL Server Express.
Note:
Not recommended for production deployment. This configuration is suitable for trial or lab
purposes.
Architecture overview
Control Manager provisioning server integrates Control Manager with multiple Avaya products and
systems through various connectors. These connectors are parts of the overall solution subject to
the type of active Control Manager connectors.
Control Manager uses the system architecture, software integrations, and software components to
provide a multi-channel contact center solution.
The following diagram and table show the key components of the Control Manager solution:
High-Level Solution Topology platforms, including all available solution connector, provide a
centralized operational management from a single web browser portal.
Layer Components
Web • Web Interface
• Interface API
Application Security Engine
• Application Server
• Provisioning Server
• Security Engine
Data layer • Database
• Third-party systems
Standard footprint
The Standard footprint, formerly known as Enterprise Standard, is the go-forward and standard
capacity offering for both Non-HA and Multiplex HA deployments. The Standard footprint option
offers two Control Manager application servers and the Microsoft SQL Server AlwaysOn cluster.
The following table lists the hardware requirement for Standard footprint:
1 Used for dual-host Non-HA configurations, this footprint is backward compatible with Control Manager 8.0 for Oceana
and Enterprise customers who do not want to add additional hardware for a standard footprint setup.
2 DR, Single-Site Campus HA, and Lab configurations are available for Oceana Co-Resident footprint. The Lab
configuration is available only for trial or PoC purposes. In this configuration, Control Manager
and Oceana Context Store database instances co-reside on the same SQL Server.
3 Oceana Context Store database disk requirements can vary randing from 400 GB to 6 TB. Refer to the Oceana
documentation for more details. Control Manager usage is 300 GB.
4 Oceana Context Store database disk requirements can vary ranging from 400 GB to 6 TB. Refer to the Oceana
documentation for more details. Control Manager usage is 300 GB.
5 This configuration does not support HA. It is not recommended for production deployment and is suitable only for trial or
lab purposes.
Note:
For the above configurations, the virtualized machine and hardware requirements are nearly
the same. However, there are a few minor changes to the specifications. For more information
about footprint requirements for the Microsoft SQL Server database, refer to the product
documentation at https://docs.microsoft.com.
Related links
Optional load balancer server configuration on page 15
Software requirements
You must install specific versions of the operating system, IIS software, and database software
before Avaya personnel installs and configures the Control Manager software. While installing
Control Manager, ensure that all of the software and certificates meet the specifications given in
the following sections.
Use a supported web browser software to access the administrative interfaces of Control
Manager.
You must install the Microsoft SQL Server software on servers that are using the Microsoft
Windows Server operating system software.
• The customer must agree to create a user login ID on the SQL database servers that is a full
administrative member of the Sysadmin server role. This user login ID is used during
installation of the Control Manager software. Create the user login ID and its password and
note these items for later use. Use this login details during installation and not when
operating the application.
• When creating database user passwords, installing the SQL software, or upgrading the
Control Manager software, the user must agree to use passwords that contain:
- 8-14 alphanumeric characters
- Upper case and lower-case letters
Do not use long and complex database passwords because of limitations with the Control
Manager installation software.
• When providing shared database software, customers must provide the database servers
that have enough computing resources to handle the required performance of the Control
Manager database software. This requirement applies to non-HA and HA configurations.
• Do not use a server configuration that is smaller than the minimum configurations listed in
Hardware and virtualization requirements on page 13.
• You must provide the sa or sysadmin roles to the Control Manager installer for user and
database creation.
Note:
Avaya services is not responsible to provide Windows or SQL Server support and
management.
Customers must :
• Provide a working environment.
6 Control Manager is tested with Microsoft SQL Server 2016 Service Pack 2
• Perform Windows and SQL Server installation, administration, maintenance, and backup.
• Get a support agreement with Microsoft and work directly with Microsoft on Windows and
Microsoft SQL Server-related issues.
Certificate requirements
The Control Manager browser interface requires that the customer install signed certificates to
provide secure access (HTTPS). A public or private Certificate Authority (CA) provides the signed
certificates. To install certificates on the Control Manager servers, ensure that the servers have
access to the CA. You cannot use a self-signed certificate in a production system.
You must install certificates on the Control Manager application server.
Important:
- Updating to an unsupported version of JRE can cause Control Manager to stop
working and can require the reinstallation of the Control Manager server.
- When upgrading Control Manager versions 9.0.1.0 and earlier to Control Manager
9.0.2.0, JRE is updated to version Zulu 11.43+56-SA. Ensure that the Java paths are
updated to point to the new JRE.
- When upgrading Control Manager versions 9.0.1.0 and earlier to Control Manager
9.0.2.0, which has an externally updated JDK version earlier than Zulu 11.43+56-SA,
you must update JRE to version Zulu 11.43+56-SA. Ensure that the Java paths are
updated to point to the new JRE.
- When upgrading from Control Manager version 9.0.1.0 or earlier to Control Manager
9.0.2.0, which has externally updated JDK version Zulu 11.43+56-SA or later, do not
update JRE. However, ensure that the Java paths are updated to point to the new
JRE.
* Not applicable for CMS19 and later releases, as there is no CLINT support.
Virtualization support
Avaya Control Manager operates on the following virtualized software platforms:
• VMware vSphere ESXi 7.0
• VMware vSphere ESXi 6.7
• VMware vSphere ESXi 6.5
Note:
VMware support includes VMware HA and vMotion. This is applicable only for Control
Manager application server. For database server, refer to Microsoft SQL Server
documentation.
Caution:
Control Manager software is not currently distributed using an Open Virtualization Archive
(OVA) file. Any older OVA files must be discarded and not used to install Control Manager
software. Verify that you have downloaded the latest version of Control Manager software,
which is provided as an ISO download.
Note:
Windows hardening settings list is not limited to the following settings. For more information
about Windows hardening settings, see Microsoft documentation.
• Install all the security patches on OS and SQL database server.
• Supported Antivirus Software. See Supported antivirus software on page 20.
• Enable the network ports mentioned in the Avaya Control Manager Port Matrix document.
Disable the remaining ports.
• Enable TLS 1.2 or higher and disable SSL1.0, SSL2.0, SSL3.0, TLS1.0 and TLS 1.1.
• Do not configure self signed certificates for Control manager server.
Additionally, you can implement the following Windows Server hardening practices:
• Windows Explorer Autoplay Not Disabled for Default User
Ensure that you define the value 255 for NoDriveTypeAutoRun in the following registry key:
HKU\DEFAULT\Software\Microsoft\Windows\CurrentVersion\Policies
\Explorer
• MS Windows Explorer Autoplay not Disabled
Go to the following registry key and change NoDriveTypeAutoRun value to 255 to disable
autoplay from any disk type:
HKLM\Software\Microsoft\Windows\CurrentVersion\Policies\Explorer
• Allowed Null Session
Go to the following registry and change RestrictNullSessAccess value to 1:
HKLM\SYSTEM\CurrentControlSet\Services\LanmanServer\Parameters
• EOL/Obsolete Software
Ensure that you do not install Adobe Flash Player.
• Network Setting
Enable the following items:
- Configure Minimize the number of simultaneous connections to the Internet or a
Windows Domain.
- Status of the Network security: Allow LocalSystem NULL session fallback setting.
- Status of the Network security: Allow PKU2U authentication requests to this
computer to use online identities setting.
- Status of the Network security: Allow Local System to use computer identity for
NTLM setting.
- Status of the Microsoft network server: Server SPN target name validation level
setting.
- Status of the Prohibit connection to non-domain networks setting.
• Enabled Cached Logon Credential
You must first locate the following Registry key, and then set or create a REG_SZ
CachedLogonsCount entry with a 0 value:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Nt\CurrentVersion
\Winlogon
• Administrator Account’s Password Does Not Expire
Configure the properties of the Administrator account, such that the password expires after a
specified duration as per the site's policy. Domain-wide policies must be set on the Domain
Controller, so that all the Windows hosts on the domain comply automatically, and each
individual host does not need to be configured.
• Default Windows Administrator Account Name Present
Change the administrator account's name to a non-default value.
• Unused Active WIndows Account Found
Remove the accounts which are not used
• Encryption
Enable the following items:
- Status of the Network access: Do not allow storage of passwords and credentials for
network authentication setting.
- Status of the Network Security: Minimum session security for NTLM SSP based
(including secure RPC) servers setting.
- Status of the Network Security: LAN Manager Authentication Level setting.
- Status of the Device authentication behavior using certificate setting.
- Status of the Set Client Connection Encryption Level setting (Terminal Services).
- Status of the Allow indexing of encrypted files setting.
Installation Checklist
Use this checklist before you begin the installation process to ensure that you have all the devices,
systems, and applications required to install Avaya Control Manager. Additionally, check the
release notes and other offer definition documents to ensure that you have the correct versions of
applications such as Microsoft SQL Server and Microsoft Windows. You can use this checklist for
non-HA and Multiplex HA installations.
Task
c. Enable TCP/IP after installing the Microsoft SQL software. See Enable TCP/IP after
installing the Microsoft SQL software on page 43.
d. Install certificates. See Installing certificates on page 50.
2. Complete Installing Control Manager on page 31 on the application server (ACM-APP-1),
pointing to the primary database server (ACM-SQL-1).
3. Complete Installing Control Manager on page 31 on the application server (ACM-APP-2),
pointing to the primary database server (ACM-SQL-1).
4. (Optional) Configure the software load balancer software. See About configuring the
optional software load balancer on page 54.
5. Test the Control Manager installation.
To verify the installation, see Testing the 2x1 Multiplex HA installation on page 69.
Procedure
1. Install all prerequisite software:
a. Install Microsoft Windows Server. For more information, on the Microsoft
Documentation website, see Install, upgrade, or migrate to Windows Server. See Link
disclaimer.
b. Install and configure IIS. See Installing and configuring IIS on the Microsoft Windows
Server on page 38.
c. Install the Microsoft SQL Server Express software. See Installing the Microsoft SQL
Server software on page 41.
d. Enable TCP/IP after installing the Microsoft SQL software. See Enable TCP/IP after
installing the Microsoft SQL software on page 43.
e. Install certificates. See Installing certificates on page 50.
2. Complete Installing Control Manager on page 31, pointing to itself as the primary
database server.
3. Test the Control Manager installation.
To verify the installation, see Testing the All-in-One installation on page 73.
• Host names of the Control Manager database servers must follow the requirements. For
more information, on the Microsoft documentation website, see Naming conventions in Active
Directory for computers, domains, sites, and OUs. See Link Disclaimer.
Procedure
1. Log on to the Control Manager server.
2. Open Windows Explorer and locate the Control Manager software you downloaded from
the Avaya support site.
3. Right-click the Control Manager executable file and select Run as Administrator.
The name of the file is similar to the following example:
ACM.ReleaseNumber.BuildNumber.exe
The Setup Wizard prepares to guide you through the installation process.
• Welcome to the Prerequisites Wizard: If the Control Manager displays this screen,
step through one or two more prerequisites screens where the software may be installed
on your Control Manager. Click Next to advance to the next screen or click Cancel to
exit the wizard.
• End User License Agreement (EULA): After you read the license agreement terms,
click I Accept to proceed further or click I Decline to exit the installation wizard. See the
full text of the Avaya Global Software License Terms for additional information about the
license agreement.
• Welcome to the Avaya Control Manager Release Number Build Number Setup
Wizard: This is the final introductory screen you see before configuring the installation
parameters.
4. Click Next.
Control Manager displays the Installation Type screen.
5. Select New Installation in the Installation Type field and then click Next.
6. On the SQL and ACM Database screen, configure the following parameters:
• In the SQL Server and SQL Port fields, enter the information in several different
formats using simple host names and TCP port numbers, IP addresses, and named
instances.
See the following examples:
Host Name in the SQL Server field and the TCP port number for the SQL database in
the SQL Port field.
Host Name\Named Instance in the SQL Server field and the TCP port number for the
SQL database in the SQL Port field.
Note:
You cannot use an FQDN in the SQL Server field.
Listener IP/DNS Name, if the installation is part of a B&R upgrade of MHA Nx2 and
expected to point to a listener IP, instead of a specific SQL instance.
• SQL Admin Username: Enter the name of a login that has Sysadmin rights on the
database server.
• SQL Admin Password: Enter the password for the user entered in the Username field.
• ACM DB Password: Enter a password for the Control Manager databases. The
password you enter here is used for all of the Control Manager databases created
during installation.
Important:
When creating database user passwords while installing the SQL software, the
customer must use passwords that are 8-14 alphanumeric characters long, with
upper case and lower-case letters. Because of limitations with the Control Manager
installation software, the customer must not use long and complex database
passwords.
7. Click Next.
Note:
The installation software uses ODBC to test the database connection using the
connection details administered in the previous dialog. If the test is successful, the
installation program continues. If the test is not successful, you must correct the
connection details.
Control Manager displays the Configure Installation Folder and System Language
screen.
8. Complete the following steps on the Configure Installation Folder and System
Language screen:
a. In the Installation folder section, click Browse to go to the location where you want
to install the Control Manager software.
Avaya recommends that you install the Control Manager software on a non-system
drive. That is, not the same drive where the OS is installed, which is typically the C:
drive.
After you select the install location, click OK.
b. In the System language section, select the preferred language from the System
Language list. By default, this is English.
Changing the language has no impact on the Control Manager installation process.
After installation, when you start using Control Manager, the content in the application
appears in the language you selected.
c. Click Next.
Control Manager displays the Ready to Install screen. You can review or change the
installation settings by clicking Back repeatedly to step through all of the screens.
Note:
Avaya recommends that you create additional user login accounts as soon as you
complete installation of Control Manager. After installation, if you log out from Control
Manager without creating alternative login accounts, you might inadvertently lock out
the default itnv and admin user accounts. In such a scenario, if you have alternative
user login account, you can use these to log in to Control Manager.
However, if you get locked out of Control Manager and do not have alternative user
login accounts, contact Avaya Support to seek assistance to resolve this issue.
Next steps
• After you complete installing Control Manager version 9.0.2 and later, you must synchronize
Avaya Oceana® Work Assignment objects into the Control Manager system. In an MHA
setup, you must perform synchronization only on one application server.
For more information, in the Using Avaya Control Manager to Administer Avaya Products
guide, see Chapter 20: Synchronizer Management > Synchronizing Avaya Oceana Work
Assignment Objects.
• Optional: Configure session timeout for IIS and services. See Configuring session timeout
for Control Manager UI portals on page 37.
• To verify the installation, see Testing the installation on page 65.
Note:
Ensure that the installer setup exe and silent_install.bat files are in the same
folder.
3. Use one of the following commands.
Use the following sample command that includes all mandatory parameters:
silent_install "FULL_VERSION=9.0.2.0.4" "DB_SERVER=10.0.1.20"
"DB_ADMIN_PASSWORD=C0nTrOlMg3rAdm1n!" "ACM_DB_PASSWORD=C0nTrOlMg3r421!"
"ACCEPT_EULA=yes"
Use the following sample command with mandatory and non-mandatory parameters:
silent_install "FULL_VERSION=9.0.2.0.013" "DB_SERVER=10.0.1.20"
"DB_ADMIN_PASSWORD=C0nTrOlMg3rAdm1n!" "ACM_DB_PASSWORD=C0nTrOlMg3r421!"
"DB_PORT=1433"
"DB_ADMIN_USERNAME=sa" "LANGUAGE=en_us" "APP_SERVER_NAME=CtrlMgr0123"
"APP_SERVER_IP=10.1.1.10" "INSTALL_PATH=C:\Program Files (x86)\Avaya\Avaya
Control Manager\" "ACCEPT_EULA=yes"
Note:
For Control Manager 9.0.2, the INSTALL_PATH for silent installation must be:
"C:\Program Files (x86)\Avaya\Avaya Control Manager\"
Next steps
• After you complete installing Control Manager version 9.0.2 and later, you must synchronize
Avaya Oceana® Work Assignment objects into the Control Manager system. In an MHA
setup, you must perform synchronization only on one application server.
For more information, in the Using Avaya Control Manager to Administer Avaya Products
guide, see Chapter 20: Synchronizer Management > Synchronizing Avaya Oceana Work
Assignment Objects.
• Configure session timeout for IIS and services. See Configuring session timeout for Control
Manager UI portals on page 37.
Note:
You must run this procedure when no users are logged in or no critical operations are
running. Before the procedure begins, Control Manager displays a confirmation
window to proceed. If you have important operations running on the system, click
Cancel and retry the procedure later. Else, click OK to proceed.
5. If this is a Multiplex HA setup, configure the same Portals Session Timeout settings on
both the application servers.
Procedure
1. On the server desktop, click Server Manager > Dashboard.
Control Manager displays the WELCOME TO SERVER MANAGER screen.
2. Click Add Roles and features.
Control Manager displays the Before you begin screen.
3. Click Next.
Control Manager displays the Select installation type screen. Confirm that the default
selection is Role-based or feature-based installation.
4. Click Next.
Control Manager displays the Select destination server screen. Confirm that the default
selection is Select a server from the server pool and that the Server Pool list has the
server where you are installing IIS.
5. Click Next.
Control Manager displays the Select server roles screen.
6. Select Web Server (IIS).
7. Click Add Features.
8. Click Next.
Control Manager displays the Select features screen.
9. Select the following features:
• .NET Framework 3.5 Features > .NET Framework 3.5 (includes .NET 2.0 and 3.0)
• If you are installing Microsoft Windows Server 2016: .NET Framework 4.6 Features (2
of 7 installed) > ASP.NET 4.6
If you are installing Microsoft Windows Server 2019: .NET Framework 4.7 Features (2
of 7 installed) > ASP.NET 4.7
10. Click Next.
Control Manager displays the Web Server Role (IIS) screen.
11. Click Next.
Control Manager displays the Web Server Type (IIS) > Role Services screen.
12. Scroll through all the available options and confirm that the following options are selected.
• Web Server
• Common HTTP Features
- Default Document
- Directory Browsing
- HTTP Errors
- Static Content
- HTTP Redirection
• Health and Diagnostics
- HTTP Logging
- Logging Tools
- Request Monitor
- Tracing
• Performance
- Static Content Compression
• Security
- Request Filtering
- Basic Authentication
- Client Certificate Mapping Authentication
- Digest Authentication
- IIS Client Certificate Mapping Authentication
- IP and Domain Restrictions
- URL Authorization
- Windows Authentication
• Application Development
- .NET Extensibility (Version 4.6 for Windows Server 2016; version 4.7 for Windows
Server 2019)
- Application Initialization
- ASP.NET (Version 4.6 for Windows Server 2016; version 4.7 for Windows Server
2019)
- CGI
- ISAPI Extensions
- ISAPI Filters
- Server Side Includes
- WebSocket Protocol
• Management Tools
- IIS Management Console
Note:
If an Add Features screen is displayed at any time, click Add Features to continue
with the feature selection process.
13. Click Install.
14. When the installation is complete, click Close.
15. Restart the server before installing any other software.
16. Repeat this procedure on any other servers that require the IIS software.
Next steps
Important:
You must install the Microsoft .NET patches for Microsoft .NET 4.8 or higher to pick up the
latest security fixes.
When installing the Microsoft Windows Server OS for a new installation or upgrading from
Microsoft Windows 2008, verify that you install the ASP.Net 3.5 role and the ASP.Net 4.8 role
using the Microsoft Windows Server OS installation software disc or a downloaded ISO image.
When installing the roles, you must specify the following alternate source path:
<Windows_Source>\sources\sxs
Use the Specify an alternate source path option and set the alternate source path.
Control Manager supports Transport Layer Security (TLS) 1.2 or newer. You can disable TLS 1.0
and 1.1, and also SSL 2.0 and 3.0, by editing the registry on the servers where you installed IIS.
To edit the registry and disable TLS 1.0 and 1.1, on the Microsoft Documentation website, see
Transport Layer Security (TLS) registry settings. See Link disclaimer.
Note:
If an error occurs when you try to configure file share for cluster quorum, ensure that
the domain user and WSFC cluster has Full Control and NTFS permissions to the
witness folder.
4. On all SQL servers (ACM-SQL-1, ACM-SQL-2), right-click on the SQL Server service,
select Properties > LogOn and modify it to log on as the domain user that has
administrative rights on all SQL servers in the cluster.
For more information, on the Microsoft Documentation website, see Transport Security -
Database Mirroring - Always On Availability.
5. Enable the AlwaysOn Availability Group feature on all SQL servers (ACM-SQL-1, ACM-
SQL-2).
For more information, on the Microsoft Documentation website, see Enable Always On
Availability Groups.
Next steps
After initial installation and configuration of the Microsoft SQL Server software, the AlwaysOn
feature, and the WSFC feature, install the Control Manager software before you complete the final
configuration of Microsoft SQL Server AlwaysOn feature. For the final configuration procedures,
see Configuring AlwaysOn.
USE MASTER
GO
BACKUP CERTIFICATE ACMTDECert
TO FILE = 'C:\ACMTDECert_File.cer'
WITH PRIVATE KEY (FILE = 'C:\ACMTDECert_Key.pvk' ,
ENCRYPTION BY PASSWORD = '[StrongPassword]' )
GO
USE [ACCCM]
GO
CREATE DATABASE ENCRYPTION KEY
WITH ALGORITHM = AES_128
ENCRYPTION BY SERVER CERTIFICATE ACMTDECert
GO
USE [ACCCMAVP]
GO
CREATE DATABASE ENCRYPTION KEY
WITH ALGORITHM = AES_128
ENCRYPTION BY SERVER CERTIFICATE ACMTDECert
GO
USE [ACCCMCMSYSLOG]
GO
CREATE DATABASE ENCRYPTION KEY
WITH ALGORITHM = AES_128
ENCRYPTION BY SERVER CERTIFICATE ACMTDECert
GO
USE [ACCCMONEXDB]
GO
CREATE DATABASE ENCRYPTION KEY
WITH ALGORITHM = AES_128
ENCRYPTION BY SERVER CERTIFICATE ACMTDECert
GO
USE [ACCCMSPHEREETL]
GO
CREATE DATABASE ENCRYPTION KEY
WITH ALGORITHM = AES_128
ENCRYPTION BY SERVER CERTIFICATE ACMTDECert
GO
USE [ACCCMSYNC]
GO
CREATE DATABASE ENCRYPTION KEY
WITH ALGORITHM = AES_128
ENCRYPTION BY SERVER CERTIFICATE ACMTDECert
GO
b. Run the following Microsoft SQL query to copy the certificate on to the secondary
database replica of AAG/BAG.
USE MASTER
GO
CREATE MASTER KEY ENCRYPTION BY PASSWORD = '[StrongPassword]'
GO
USE MASTER
GO
CREATE CERTIFICATE ACMTDECert
FROM FILE = 'C:\ACMTDECert_File.cer'
WITH PRIVATE KEY (FILE = 'C:\ACMTDECert_Key.pvk',
DECRYPTION BY PASSWORD = '[StrongPassword]' );
c. Run the following query to enable TDE on the primary database replica of AAG/BAG.
ALTER DATABASE [ACCCM]
SET ENCRYPTION ON
dm.key_algorithm,
dm.key_length
FROM sys.databases db
LEFT OUTER JOIN sys.dm_database_encryption_keys dm
ON db.database_id = dm.database_id;
2. To set up up TLS 1.2, open a text editor and create a file named tls1.2_enable.reg.
3. Enter the following code in the tls1.2_enable.reg file:
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols]
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\SSL 2.0]
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\SSL 2.0\Client]
"DisabledByDefault"=dword:00000001
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\TLS 1.0]
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\TLS 1.0\Client]
"Enabled"=dword:00000000
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\TLS 1.0\Server]
"Enabled"=dword:00000000
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\TLS 1.1]
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\TLS 1.1\Client]
"DisabledByDefault"=dword:00000001
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\TLS 1.1\Server]
"DisabledByDefault"=dword:00000001
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\TLS 1.2]
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\TLS 1.2\Client]
"DisabledByDefault"=dword:00000000
"Enabled"=dword:00000001
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL
\Protocols\TLS 1.2\Server]
"DisabledByDefault"=dword:00000000
"Enabled"=dword:00000001
4. Copy the file on to all application and database servers in the Multiplex HA configuration.
5. Right-click the file and select Merge to enable TLS 1.2 on each server where you copy this
file.
Ensure that you perform this step on both application and database servers so that you
enable TLS 1.2 on both clients and servers.
6. Install the security patch on database servers based on the SQL server version installed
on these servers, to support TLS 1.2. For more information, on the Microsoft Support
website, see TLS 1.2 support for Microsoft SQL Server. See Link disclaimer.
7. Install Wireshark on the application servers.
8. Complete the following steps and verify using Winshark whether TLS 1.2 is used for
connection with the database servers:
a. To add a location, do the following:
• Log in to the ACCCM portal.
• Navigate to the Location option.
• Enter a name and description for the location and then click Save.
b. To add a user, do the following:
• Log in to the ACCCM portal.
• Navigate to the User portal and click the + icon to add a user.
• Enter the required details for this user and then click Save.
c. To delete a user, do the following:
• Log in to the ACCCM portal.
• Navigate to the User portal and select the user that you created in the previous
step.
• Open the Expand icon options and click Delete user.
9. Verify whether the adding a location, adding a user, and deleting the user operations are
synced to both database servers within AAG.
Installing certificates
The Control Manager browser interface requires that you install signed certificates to provide
secure access (HTTPS). For signed certificates contact a public or private Certificate Authority
(CA).
Caution:
Certificates generated using System Manager works for Control Manager. However, if the
Control Manager system is hosted on a WAN, NLAN, or WLAN, Control Manager may not be
able to validate the certificate and the user may see a “Certificate not valid” warning message
when logging on to Control Manager.
Certificates must be installed whether it is a new installation or an upgrade. The certificates must
be installed before you install or upgrade the Control Manager software.
You must install certificates on all Control Manager application servers (ACM-APP1, and/or ACM-
APP2) in any of the following configuration: Dual host Non-HA, Multiplex HA, or All-in-One (AIO).
Caution:
If the name entered in the Common name field does not match the host name of the
Control Manager server, the certificate is not valid, and users cannot access the
system using their browser.
6. Click Next.
The system displays the Cryptographic Service Provider Properties page.
7. Set the Bit length option to 2048.
8. Click Next.
The system displays the Save As dialog box.
9. Specify a file name that represents the name of the Control Manager server for which you
are requesting a certificate. If you are requesting more than one certificate, make the
names unique.
10. Click Open.
11. Click Finish.
Procedure
1. Log on to a CA signing page and click Request a certificate, or other similar option.
2. Open the CSR in a text editor.
3. Click advanced certificate request.
4. Click the second option, Submit a certificate request by using.
5. Paste the your CSR details into the Saved Request.
6. Select the Web Server under the Certificate Template option or a similar option.
7. Click Submit.
8. Select the DER encoded option and click Download certificate.
9. From the same CA site Welcome screen, download the root certificate by clicking the
Download a CA certificate, certificate chain, or CRL.
10. Click Download CA Certificate.
11. Copy the signed certificate and the root certificate to the Control Manager server.
12. Repeat this procedure for all application servers.
the failed primary application server (ACM-APP-1) are redirected to the secondary application
server (ACM-APP-2). Users must log in again to the Control Manager user interface. In this case,
the system switches these independent services on the secondary application server to the
running state. When the primary application server is operational again, the system pauses these
independent services on the primary application server.
If the secondary application server (ACM-APP-2) goes down, subsequent login requests are
automatically redirected to the primary application server (ACM-APP-1). Those users that were
connected to the failed secondary application server (ACM-APP-2) are redirected to the primary
application server (ACM-APP-1). Users must log in again to the Control Manager user interface.
Since the independent services noted above are still running on the primary application server
(ACM-APP-1), the system administrator only needs to repair the secondary application server
(ACM-APP-2) to get it operational again. At that time, login requests are distributed across both
the application servers.
Note:
From this release of Control Manager, the administrator need not manually intervene in case
of fail-over and fail-back. If the primary application server (ACM-APP-1) fails, then all the
independent services running on (ACM-APP-1) automatically switches to the secondary
application servers (ACM-APP-2) and secondary application server becomes primary by
switching paused service into running state and vice versa.
For more information about recovering from this failure, see Chapter 9: Troubleshooting failover
problems in the Maintaining and Troubleshooting Avaya Control Manager guide.
Note:
If a failover occurs, it is handled by independent service component within Control Manager,
no manual intervention is required to start the independent services on the secondary server.
Caution:
You must use the FQDN in the certificate. If you do not use the FQDN, the certificate
cannot be validated.
• Email Address []:
4. Add these attributes to the certificate request:
• Challenge password []:
• An optional company name []:
5. Enter the following command to generate the output files:
Where:
• <BalancerName> is a name to represent the load balancer.
• <WebServerName> is a name to represent the Control Manager application servers that
are a part of the load balancer configuration.
4. Append the following lines to the end of the file:
backend <WebServersName>
mode http
option http-keep-alive
option forwardfor
cookie SRVNAME insert
server webserver_130 <PrimaryAppServer>:443 check cookie SA ssl verify none
server webserver_131 <SecondaryAppServer>:443 check cookie SB ssl verify none
Where:
• <BalancerName> is any name to represent the load balancer.
• <WebServerName> is any name to represent the Control Manager application servers.
• <PrimaryAppServer> is the FQDN of the primary application server (ACM-APP-1).
• <SecondaryAppServer> is the FQDN of the secondary application server (ACM-APP-2).
5. Append the following lines to the end of the file:
listen stats
bind :9000
mode http
stats enable
stats refresh 10s
stats hide-version
stats realm Haproxy\ Statistics
stats uri /haproxy_stats
stats auth <UserName>:<UserPassword>
Where:
• <UserName> is the user ID of an authorized user.
• <UserPassword> is the login password for the authorized user.
6. Save and close the file.
7. Run the following command to restart the HAProxy service:
sudo service haproxy restart
For more information, on the Microsoft Documentation website, see Specify Replicas
Page and Multi-subnet failovers.
c. Once the primary and all secondary servers are listed on the page, select Initial Role
of SQL Servers as appropriate.
d. Select Availability Mode to Synchronous Commit for the primary and the
necessary secondary servers.
•
Ensure that the ACCCM logins are not created on secondary database servers (ACM-SQL2).
You can do this by running the following SQL query on the secondary database server:
select name, sid from sys.syslogins
WHERE name in ('ACCCM', 'ACCCMAVP', 'ACCCMSPHERE', 'ACCCMSYNC', 'UserCMSyslog',
'ACCCMONEXUSER')
The system must not display any results after running the above query. If the system displays
any rows, you must fix these log-ins before proceeding.
Procedure
1. Log on to the primary database server (ACM-SQL-1) as an SA user.
2. Open Microsoft SQL Server Management Studio.
3. Run the SQLServerLoginScript.sql script on ACM-SQL-1.
This script creates the stored procedure sp_CreateRemoteLogins.
4. Run this command on ACM-SQL-1, for all secondary SQL servers using the IP address of
the respective secondary database server:
Exec sp_CreateRemoteLogins <Secondary_Database_Server_IPAddress>
Important:
The first time you log in to Control Manager, ensure that you change the default itnv
password. Remember the credentials for your user ID until you create new Control
Manager users.
You must create system administrator users. Do not use the default itnv or admin user
IDs for your day-to-day tasks. Create administrator users and assign roles to those
users. For a multi-tenant deployment, you must use tenant-specific user IDs.
5. Click Log in.
Note:
If you enter your login credentials incorrectly thrice, the system requires you to enter
your correct user name and password along with a captcha string of characters before
attempting to log on again.
If Control Manager displays any licensing related warning or error and WebLM server is
already configured then see Maintaining and Troubleshooting Avaya Control Manager.
Control Manager operates in the Grace mode for 30 days until you configure a WebLM server with
a valid license.
If you do not configure the WebLM license within 30 days grace period, then Control Manager
enters the Restricted mode, and the user cannot login. In such a case, you can configure the
WebLM server through Health Monitoring tool. For more information, see the Maintaining and
Troubleshooting Avaya Control Manager.
Before you begin
Ensure that the Control Manager license is installed on the WebLM server.
Note:
For more information on installing a license on the WebLM server, see the WebLM
documentation.
Procedure
1. On the Control Manager Web portal, navigate to Configuration > Licenses > WebLM
Server.
2. Click Add.
3. Enter the WebLM address.
For example, https://<WebLM_Server_Address>:52233/WebLM/LicenseServer.
4. To check the connectivity, click Test, if the connection is successful, then click Save.
5. Restart the License Server service.
a. In the Run window, type services.msc.
The system opens the Services window,
b. Navigate to ACCCM License Server.
c. Right-click ACCCM License Server and select Restart.
Ensure that a WebLM server with a valid control manager license is always configured with
Control Manager.
If Control Manager displays any licensing related warning or error and the WebLM server is
already configured then, see the Maintaining and Troubleshooting Avaya Control Manager
guide.
Procedure
1. On the Control Manager home page, select Configuration > Licenses > Licenses List.
2. Select localhost and click Edit.
3. Click the Licenses Info tab to view the following ACM Licensing details:
• License Duration and License Expiration Date
• Actual No of Concurrent users logged in with respect to the available limit
• Which Feature Licenses are Enabled and which are Disabled
15. Confirm that all organization hierarchy chart are available in the User Portal on ACM-APP–
1.
16. Confirm all the configured systems are present and available under their appropriate
locations on ACM-APP–1.
17. Ensure that all the configured systems are of the version supported by Control Manageron
ACM-APP–1.
18. Start ACM-SQL–2.
19. Confirm that all organization hierarchy chart are available in the User Portal on ACM-APP–
1.
20. Confirm all the configured systems are present and available under their appropriate
locations on ACM-APP–1.
21. Ensure that all the configured systems are of the version supported by Control Manager
on ACM-APP–1.
Documentation
The following table lists the documents related to this product. Download the documents from the
Avaya Support website at http://support.avaya.com.
Title Description
Overview
Avaya Control Manager Overview and This document describes the features and specifications for the
Specification Control Manager product.
Planning
Planning for an Avaya Control This document describes the planning and prerequisites that
Manager Deployment (formerly known customers must follow before deploying Control Manager.
as Avaya Control Manager Customer
Requirements)
New Installation
Installing Avaya Control Manager This document describes how to install, configure, and test the
non-HA and Multiplex HA deployments of Control Manager.
Upgrades
Upgrading Avaya Control Manager This document describes how to upgrade the Enterprise, and
non-HA Enterprise, Control Manager systems from an earlier
release to the current release. The document includes upgrade
checklist, upgrade procedures, and verification procedures for
each supported upgrade path.
Configuration
Configuring Avaya Control Manager This document describes how to configure Control Manager to
work with other Avaya products.
Avaya Control Manager Release This document contains any special release information, upgrade
Notes steps, and known issues.
Avaya Control Manager Port Matrix This document describes the port usage for Control Manager.
Administration
Using Avaya Control Manager to This document describes how to use Control Manager to
Administer Avaya Products administer features on Avaya products.
Administering Avaya one-X® Agent This document describes how to use Control Manager to
Using Avaya Control Manager administer Avaya one-X® Agent.
Table continues…
Title Description
Administering an Avaya Experience This document describes how to use Control Manager with
Portal Sample Application Using Experience Portal.
Avaya Control Manager
Administering Avaya Control Manager This document describes how to use Control Manager to
for Avaya Agent for Desktop administer Avaya Agent for Desktop.
Events and Alarms
Avaya Control Manager Events, This document describes the SNMP notifications for Control
Alarms, and Errors Reference Manager.
Using
Using Avaya Control Manager This document describes how to use Control Manager
Conversation Sphere Conversation Sphere to administer vectors, strategies, and call
flows.
Using Avaya Control Manager Central This document describes how to use Control Manager Central
License and Traffic Tracker License and Traffic Tracker.
Maintenance and Troubleshooting
Maintaining and Troubleshooting This document describes maintenance procedures and
Avaya Control Manager troubleshooting scenarios for Control Manager.
Title Description
Using the Avaya Control Manager SOAP API This document describes how to use the SOAP
version of the Control Manager API.
Using the Avaya Control Manager REST API This document describes how to use the REST
version of the Control Manager API.
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.
• Click Languages ( ) to change the display language and view localized documents.
• Publish a PDF of the current section in a document, the section and its subsections, or the
entire document.
• Add content to your collection using My Docs ( ).
Navigate to the Manage Content > My Docs menu, and do any of the following:
- Create, rename, and delete a collection.
- Add topics from various documents to a collection.
- Save a PDF of the selected content in a collection and download it to your computer.
- Share content in a collection with others through email.
- Receive collection that others have shared with you.
• Add yourself as a watcher using the Watch icon ( ).
Navigate to the Manage Content > Watchlist menu, and do the following:
- Enable Include in email notification to receive email alerts.
- Unwatch selected content, all content in a document, or all content on the Watch list page.
As a watcher, you are notified when content is updated or deleted from a document, or the
document is removed from the website.
• Share a section on social media platforms, such as Facebook, LinkedIn, and Twitter.
• Send feedback on a section and rate the content.
Note:
Some functionality is only available when you log in to the website. The available functionality
depends on your role.
Training
The following courses are available on the Avaya Learning website at www.avaya-learning.com.
After logging into the website, enter the course code or the course title in the Search field and
click Go to search for the course.
Course code Course title
Technical Design
3320W Avaya Customer Engagement Platforms Overview (includes Avaya Control
Manager Product Information Documents (PIDs))
3330W Avaya Customer Engagement Administration and Applications Overview
(includes Avaya Control Manager PIDs)
Table continues…
The following courses are also available on the Avaya Control Manager website at https://
ACM_host/ACCCMPortal. After logging into the website, go to Personal Settings > Training.
Course code Course title
24320W Administering Avaya Oceana® Basics
24310W Administering Avaya Analytics™ for Oceana® Basics
70910W Administering Avaya Control Manager for Enterprise
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.
Note:
• Avaya supports two installations of Control Manager on the same Microsoft SQL Server,
provided they are installed on different Microsoft SQL Server named instances.
• Avaya documents the SQL Server footprint for a single Control Manager deployment. If
you deploy another Control Manager instance on the same Microsoft SQL Server and
experience performance issues, you must either increase the footprint of your Microsoft
SQL Server, or revert to separate Microsoft SQL Server instances per Control Manager,
where each Microsoft SQL Server meets the minimum footprint requirement as specified
in the Hardware Requirements section of the Control Manager documentation.
• Avaya does not support two instances of Control Manager on the same Microsoft SQL
Server named (or default) instance, as the Control Manager database names are fixed.
H
C
HAProxy configuration file ................................................... 58
Certificate Signing Request ................................................. 50 headless install .................................................................... 34
certificates ......................................................................21, 49 health monitoring tool .......................................................... 37
checklist ............................................................................... 26
client operating system ........................................................ 20
collation ................................................................................18 I
collection
IIS ........................................................................................ 37
delete ............................................................................76
InSite Knowledge Base ........................................................79
edit name ......................................................................76
installation checklist ............................................................. 26
generating PDF ............................................................ 76
installation process ................................................................ 8
sharing content ............................................................. 76
installing
configuring
certificates .................................................................... 49
HAProxy configuration file ............................................ 58
IIS ................................................................................. 38
self-signed certificates .................................................. 57
load balancer software ................................................. 45
SQL logins .................................................................... 62
Microsoft SQL Server ................................................... 41
content
Microsoft SQL Server AlwaysOn software ................... 43
publishing PDF output .................................................. 76
root certificate ............................................................... 51
searching ...................................................................... 76
signed certificate ...........................................................51
sharing ..........................................................................76
installing 2x1 multiplex HA ...................................................27
sort by last updated ...................................................... 76
installing 2x1 Multiplex HA ...................................................28
watching for updates .................................................... 76
installing 2x2 Multiplex HA ...................................................29
Control Manager .................................................................. 46
installing Control Manager in a non-HA dual-box configuration
configurations ................................................................. 9
with one Control Manager and one SQL Server ..................27
CSR ..................................................................................... 50
installing Control Manager software
Cylance antivirus ................................................................. 20
MHA ..............................................................................31
non-HA ......................................................................... 31
D installing Control Manager using CLI ...................................34
installing in one box (All-in-One) ..........................................30
database
collation ........................................................................ 18
shared ...........................................................................17 J
databases ............................................................................ 87
Java Runtime Environment ..................................................21
document changes ................................................................ 7
documentation center .......................................................... 76
finding content .............................................................. 76 L
navigation ..................................................................... 76
documentation portal ........................................................... 76 latest software patches ........................................................ 16
finding content .............................................................. 76 licensing ...............................................................................66
navigation ..................................................................... 76 listener IP .............................................................................63
load balancer ....................................................................... 54