19971024 AES Installation

8/4/2019 19971024 AES Installation

1/62

#

Converged Solutions Contact Center Solutions Customer Services

Application Enablement Services

3.0Overview

v4.9


2/62

#


DLG On MAPD, Co- Res DLG

CVLAN r6/8 Server on MAPD

Avaya Communication Manager

(must be 2.xto support

CVLAN 9.1)

ASAI

Software

DLG (DEFINITY LAN Gateway) Clients

CVLAN r6/r8 Clients

Avaya CT Clients

CMAPI ClientsCMAPI Server

Avaya CT Server

CVLAN r9/9.1 Server

MAPD

Med Pro

Current CMAPI/CTI Platforms Pre CM 3.0

C-LAN


3/62

#


MV 1.xand priorDEFINITY Releases

CMAPI/CTI Roadmap to Avaya AE Services

AVAYA CT 1.3

CMAPI 1.x

CVLAN r6/r8 On MAPD

DLG On MAPD

CVLAN R9Red HatLinux9.0

AE Services 3.0 Red Hat Enterprise Edition

3.0 Linux OS TSAPI Service

CVLAN Service

DLG Service

CMAPI Service

CMAPI 2.x

AVAYA CT 1.3 Continue support for CM 3.0

with existing MAPD

Co-Res DLG

CVLAN R9.1Red Hat EnterpriseLinuxv3.0

CM 2.x CM 3.0

CVLAN r6/r8 On MAPD Continue support for CM 3.0

with existing MAPD

DLG On MAPD Continue support for CM 3.0

with existing MAPD


4/62

#



AE Services provides an extensive set of protocols, APIs and web

services that enables application developers and system integrators to

develop applications that take advantage of Avayas feature rich

communication solutions.

AE Services merges DLG, CVLAN r9, Avaya CT 1.3, and CMAPI 2.1

into a single platform running on Red Hat Linux Enterprise v3.0 ES.

The AE Services platform has several key components:

Connector Services

Life Cycle and Administration Services

Communication Services Software Development Kits


5/62

#



AE Services Connectors communicate with Avayas

CommunicationMedia Servers and provide standards-based APIs

that enable:

Call Control

DeviceControlMedia Control

Administration

AE Services Connectors are CMAPI, CVLAN, DLG, JTAPI andTSAPI.

AE Services Life Cycle and Administration Services provideinfrastructure and management functions for the AE ServicesPlatform.


6/62

#



AE Services Communication Services enable functionality

through Web Services interfaces using SOAP/XML.

AE Services Communication Services are as follow

Telephony Service User Service

Systems Management Service

AE Services will offer three Software Development Kits:

IP Communications SDK (CMAPI)TSAPI/JTAPI SDK

Web Services SDK


7/62

#



AE Services Software Development Kits consists of the client API

libraries, XSDs, WSDL, Programmers Guides, sample

applications and other development tools. The APIs and protocols

provided with the SDK are as follows:

CMAPI CSTA III Device and Media Control Java API

CMAPI CSTA III Device and Media Control XML ProtocolMedia Stack API

CVLAN API

C

allvisor ASAI Protocol (DLG)TSAPI JTAPI

Web Services support for System Management, User, andTelephony Services.


8/62

#


What do you call it?

The original project name of AE Services was mvap. Because the

platform name was changed well into the development cycle, you

will find the mvap name used in rpm names, commands,

directories, and documentation.


AE Services

aesvcs

AESvcs mvap

Device and Media Control (CMAPI)

Call Control (Classic CTI)


9/62

#Converged Solutions Contact Center Solutions Customer Services

H.323

AE Services Client Application View

RTP

Proprietary CVLANprotocol

ApplicationEnablementProtocol

AE Services ServerASAI through

TCP tunnelprotocol

CSTA-1 ASN.1

DLG app

CommunicationManager IPInterface (e.g. C-LAN)TSAPI

Service

CVLANService

CVLAN app

Client lib

TSAPI / JTAPIapp

Client lib

CMAPI Javaapp

Client lib

CMAPI XMLapp

CMAPIService

CSTA-3XML

DLG

Service

Telephony, Userand Management,

Web Services

OSSI(Mgmt only)Web

Serviceclient

SOAP / WSDL


10/62



Implementation Options AE Services will be offered in two options; Software only and

Bundled server.

The Software Only option provides:

an AE Services 3.0 CD for external customers

download site for DevConnectMembers. The AE Services Bundled Server option provides:

an IBM x306 Server (same as the S8500B) with Red HatLinux Enterprise v3.0 ES and AE Services 3.0 software.

In addition, Avaya will install and maintain the AE Services

Bundled Server.


11/62


12/62



Bu

ndled Server System Requ

irements

Specifications IBM x306 (S8500B)Processor 3.06 GHz

Standard Memory 512MB

AdditionalMemory (required) 512MB

Hard Drives 80 GB SATA disk drive

Drives DVD read only drive

Floppy disk for BIOS updates

Modems One USB

Network Interface 2* internal 10/100 Ethernet Network Interface

(Ports)

Maintenance Card Augmentix SAMP

Chassis 1U high

1.75 x 17 x 17


13/62


All Avaya CTI and CMAPI offerings morph to AvayaApplication Enablement (AE) Services to be delivered via a single

platform.

AE Services provides a more consistent and scalable licensingstrategy.

AE Services transport links are secure, encrypted, load-balanced,and redundant with transparent link fail over.

AE Services protects Communication Manager by providing atrusted source between CommunicationManager andapplications.

AE Services will be a going forward platform. AE Services Bundled Server provides a single platform to install,

maintain, and support.


Benefits


14/62


Avaya CommunicationManager3.0 or later

ASAI

Software

CMAPI Clients

CVLAN r6/8 Clients

Avaya CT Clients

DLG

Clients


Application Enablement Server

AE Services:

CMAPI

CVLAN

DLG

TSAPI (JTAPI)

Telephony Service

User Service

System Management Service

Med Pro

CLAN(s)


15/62


AE

ServicesBundled Server Installation


16/62


AE Services Bundled Server Installation:

InstallationT

asks

Verify Bundled Server hardware (IBM x306)

Administer laptop IP address (headless install)

Boot to AE Services DVD and install and configure the software

Upgrade/Administer SAMP

Install the AE Services license

Verify Communication Manager requirements

Verify TN799DP C-LAN board installation and admin on CM Enable AE Services on Communication Manager

Administer the AE Services server name and password on CM

Status the AE Services interface on Communication Manager


17/62



Installation Tasks

Administer Switch Connection (CTI CMAPI Call

Information) Status AE Services Link on Communication Manager

Status AE Services Switch Connection

AdministerCTI Links (CTI Only)

Administer H.323 Gatekeeper (CMAPI only if required)


18/62


AE Services Bundled Server Installation Notes:

AE Services Bundled Server will be offered on an IBM x306 Server. The sameserverused by the S8500B Media Server.

The IBM x306 used by S8500B Media Server does not come with enoughmemory to support AE Services. The IBM x306(S8500B) comes with only512MB RAM. An additional 512MB RAM SIM will need to be ordered and

installed in order to support AE Services. The AE Services Bundled Server will use the Augmentix Server AvailabilityManagement Processor (SAMP ) Board for remote maintenance.

The AE Services Bundled Server installation is a headless (no monitor orkeyboard) installation.

A Laptop and crossover cable will be required to install the AE Services

Bundled Server (headless install). If the site has access to a monitor and keyboard, the AE Services Bundled

Server installation can also be done with a monitor and keyboard as well.


19/62


AE Services Bundled Server Installation Notes:AE Services Bundled Server Installation Notes:Default Services LoginsDefault Services Logins

Note: The default services logins (except sroot)will be provided in a "mvap-services" rpm for

Software only solution. This rpm will be optional forthe Softwre Only solution i.e.will be

only needed ifa customer buys a Services Contract. Ifthe customer requires root

access, Services will provide a root level account.

Login Password Usage

cust custpw Customer Login

craft crftpw - Administrative belonging to Group Avaya

- For Avaya

- Cannot be directly accessed through ssh

sroot sroot01 Root - For Avaya

rasaccess rasaccess01 For inbound modem access


20/62


AE Services Bundled Server Install Wizard

Notes: The Bundled Server Install Wizard will perform the following

tasks:

Partition the drive

Install the OS (Red Hat Linux Enterprise v3.0)

Install Third Party RPMs

Configure the IP Tables and install Security RPMs

Install Services Default Logins

Configure the Server based on the interactive information

provided.

Install AE Services


21/62



IBM x306 Hardware

Specifications IBM x306 (S8500B)Processor 3.06 GHz

Standard Memory 512MB

AdditionalMemory (required) 512MB

Hard Drives 80 GB SATA disk drive

Drives DVD read only drive

Floppy disk for BIOS updates

Modems One USB

Network Interface 2* internal 10/100 Ethernet Network Interface

(Ports)

Maintenance Card Augmentix SAMP

Chassis 1U high

1.75 x 17 x 17


22/62


AE Services Bundled Server: Front

Picture


23/62


AE Services Bundled Server: Rear

Picture

Power

Supply

eth0 (port1)

Customer LAN/WAN

eth1 (port 2)

Private Isolated LAN(VLAN)

Note:

Initial Services Laptop Port

2-USB Ports

Reserved for future use

Services Laptop Port

SAMP Card

SAMP USB

Modem Port

SAMP

Power Supply


24/62


eth1

eth2

eth0

AE Services Bundled Server

Network Interfaces

AE Services Bundled Server (x306)

Internal NIC interfaces

eth2

eth1 Reserved

Services NIC

IP: 192.11.13.6

Interface to ProductionLAN/WAN

Interface to Communication Managervia C-LAN/s: Private Isolated LAN/VLAN(Pre-Install Services Laptop NIC: IP 192.11.13.6)

acm0

ModemINADS (PPP)

IP: 10.1.1.1

eth0

SAMP

IP 192.11.13.2IP 192.11.13.1


25/62



IBM x306 TCP/IP Networking Notes

All NICs on the AE Services Bundled Server must be static IPaddresses.

Dynamic Host Control Protocol (DHCP) is not supported.

eth0 and eth1 are configured as 100BaseT, full-duplex bydefault.

The MAC address of the first NIC on the Bundled Serveris the MAC address required for the AE Services License.

The link between the second NIC on the Bundled Server andCommunication Manager requires an Ethernet switch or networkhub.

Crossover cable is not supported between the AE Services BundledServer and Communication Manager.

eth1eth0

eth0


26/62


Augmentix Server Availability Management Processor (SAMP ) Board

Half card PCI.

Externally powered SAMP functions if

the X306 power fails.

SAMP is a host independent entity OS,power, memory, storage, etc.

Provides Services Access.

USB modem.

Provides dial-in/dial-out access to

SAMP and x306 server.

No serial modem required.

Note: AE Services 3.0 will not support all

SAMP functions.

SAMP


27/62


SAMP Board Default LoginsSAMP Board Default Logins

Login Password Usage

craft craft -System

-Usable on the SAMP only via SSH/HTTPSrasaccess rasaccess For inbound modem access

Note: *After the SAMP Board is upgraded the craft password will change to craft01


28/62


Services Access to AE Server Local On-Site Access:

Preferred: Connect laptop to SAMP Ethernet 2 (after installation) IP Address: 192.11.13.6 SSH, HTTPS Note: onlyCLI access to SAMP from Host

Services Access via the Network Corporate LANPort on the HOST, if so configured SSH, HTTPS

Remote Access:

USB Modem connected to the SAMP Card Establish a PPP session to the SAMP using remote login SSH(port 22) or HTTPS(port 80) to the HOSTusing services logins.

eth2

ACM

Modem


29/62


SAMP Access using PuTTY

Connection to the Bundled Server and SAMP requires Secure Shell(SSH).

Avaya has tested an open source SSH Windows client called PuTTY

forMicrosoft Windows based PCs.

Downloading PuTTY. Avaya personnel should download PuTTY from

http://ctisupport.usae.avaya.com/ps/aeservices/downloads/tools/i

ndex.html Non-Avaya personnel should download PuTTY from

http://www.chiark.greenend.org.uk/~sgtatham/putty/download.ht

ml


30/62


Putty Screens

Connection screen.

Enter the IP addressof the Bundled Server

or the SAMP board

then click the Open

button.


31/62


Putty Screens

ssh-rsa key screen.

Click yes


32/62


Putty Screens

Log In screen. Use one of the default Services Logins such as craft.

Do not use sroot Login since it is not allowed to Log in.


33/62


Putty Screens

Once logged in, su to sroot


34/62


SAMP File Transferusing WinSCP

File transfer to and from the Bundled Server and SAMP boardrequires SCP or SFTP.

WinSCP is an open source SFTP client for Windows. Its mainfunction is the secure file transfer between a local and a remotecomputer.

WinSCP offers basic file manager functionality. It uses Secure Shell(SSH) and supports, in addition to Secure FTP, also legacy SCP

protocol

Downloading WinSCP.

Avaya personnel should download WinSCP fromhttp://ctisupport.usae.avaya.com/ps/aeservices/downloads/tools/index.html

Non-Avaya personnel should download WinSCP from

http://winscp.net/eng/index.php


35/62


WinSCP Screens

Login screen.

Enter the IP address of the Bundled Server

Enter the Use Name and password

Click the Login button.


36/62


WinSCP Screens

ssh-rsa key screen.

Click yes


37/62


WinSCP Screens

One panel is the local machine; the other is the remote machine.

Both WinSCP interfaces provide basic file manager functionality

between a Windows PC and a Linux Server

WinSCP allows you to drag and drop files from the Windows PC to the

Bundled Server.


38/62


WinSCP Screens


39/62


WinSCP Screens

WinSCP allows you to

change the Linux file

permission by either right

clicking on the Linux file

and selecting properties or

selecting file properties inthe menu.


40/62



Install Wizard Notes:

The Bundled Server Install Wizard will prompt you to make choices to

navigate and select from the screens: Use the arrow keys to navigate from screen to screen.

Use the Tab key to move from option to option.

Use the Spacebar to select an option.


41/62



On the Laptop, configure the TCP/IP settings on the Laptop to the

following:

IP Address = 192.11.13.5

Net mask = 255.255.255.252

Gateway = 192.11.13.4

After configuring the TCP/IP settings on the Laptop, plug in the

cross-over network cable from the Laptop to the temporary

Services port. The temporary Services port is the port that islabeled 2 on the back of the IBM x306.eth1


42/62



Insert the AE Services Bundled Server Installation DVD into the

IBM x306 DVD drive then reboot .

After the Bundled Server boots to the AE Services 3.0 DVD,

verify connectivity by pinging IP address 192.11.13.6 using theMS/DOS command prompt from the Laptop.

From the Laptop, telnet to IP address 192.11.13.6 on the Bundled

Server (port 2)


43/62



Installation:

The telnet session will be connected to the What do you wantto do screen.

Select Install (Install or Upgrade Software)

Select OK and press enter


44/62



Select Release Version Screen: Select AE Services 3.0 Build

Select OK and press enter

Note:AE Services requires at least 913 MB of RAM. If the IBM x306 has less than 1 GB of RAM, a WARNING

page with that information appears. It asks if you want to continue with the installation .-


45/62


AE Services Bundled Server Installation :

Co-Residency Warning

AE Services must be installed as a stand alone applicationServer.

AE Services does not support co-residency with otherapplications.


46/62



Set Date and Time Screen:

Select Yes


47/62



Date/Time Initialization Screen:

Enter: Date

Enter: Time

Select: Timezone

Enter: NTP Server IP Address or Hostname if known and required.


48/62



Set IP Address for NICs Screen:

Select Yes


49/62



Configure Network Information Screen:

Enter: Hostname

Enter: DNS domain Enter: DNS Server(IP Address)

Enter: IP address &Netmask for eth0 then enable it.

Note: If eth1 is automatically enabled, do not change.

Enter: Default Gateway (IP Address).


50/62



Configure Network Information Screen (example):

Select OK and press enter.

This completes the AE Services Bundled Server installation.


51/62



Installation:

The Install Wizard will display progress of the installation .

The Install Wizard will reboot the server once the installation is

completed.


52/62



Upgrading the SAMP Board Firmware and

Configuration

The SAMP board firmware must be upgraded on new

factory installations.

The SAMP Board will not be fully functional until the

firmware is upgraded.

After the Bundled Server reboots, remain connected to

eth1.

Connecting to the Bundled Server, at this point, requires

an ssh client like PuTTY.


53/62



Upgrading the SAM

P Board Firmware andC

onfigu

ration From the laptop, using PuTTY" , ssh into the x306 host ssh to 192.11.13.6. You will be prompted for a login and password. Login as craft then su to sroot . Check the current firmware version of the SAMP board by running the command:

sampinfo

If this command fails, the SAMP firmware must be upgraded.

cd /tmp and using sftp download the SAMP firmware (xxx.tbz) file and the SAMPXML file (avaya.xml).

Use the command from the /tmp directory where you downloaded those two files:sampfixer

You will be prompted for the SAMP board craft password three times: The first time, enter the original Augmentix craft password: craft The second and third time, enter the new Augmentix craft password: craft01

After this command is executed, the SAMP board will be upgraded to the latestfirmware and configuration file.

Validate the firmware upgrade by running the command: sampinfo

1. Note: The SAMP craft password is different from the x306 Host processor craftpassword.


54/62



Administering the second Network Interface (Host eth1)

Once the SAMP board has been upgraded and the xml configuration

file applied, the second network interface can be administered.

Logged in as sroot, run the netconfig utility.

Change the IP address of eth1


55/62


56/62


Login into the Host (x306) as craft and thensu to sroot

Use the following command to configure PPP:

samp_ppp xxx.xxx.xxx.xxx yyy.yyy.yyy.yyywhere xxx.xxx.xxx.xxx is the Local PPP ip-address of

the SAMP and yyy.yyy.yyy.yyy is the Remote PPP ip-address of the client connecting to the SAMP through

the modem (INADS IP Address)

Example:

samp_ppp 192.168.25.10 198.168.25.20


Configuring PPP on the SAMP Board


57/62


Accessing the SAMP Board from the Host (x306)

Login into the Host(x306) as craft and then su to

sroot

ssh into the SAMP eitherusing the root login and

password :

ssh -p 10022 root@my-samp

Password is augmentix

orssh into the SAMP using the craft login and password:ssh -p 10022 craft@my-samp

Password is craft01


58/62


Troubleshooting the Bundled Server Installation

All installation and upgrade failures are reported to the error log

located in /var/disk/logs/update.out-timestamp

The SAMP logs are located in /var/disk/logs.

A copy of rpms for each release that is installed (upto two installs) is

kept in /var/disk/Releases/r3-xxx where r3-xxx is the Release

number.


59/62



Hostname Issues

The hostname of the AE Services server must not be associated with the loopback IP address, 127.0.0.1.

The hostname of the AE Services server should be associated with the IPaddress of eth0.

The hostname of the AE Services server must be 15 characters or less. To determine what is the hostname associated with an AE Services server, run

the following Linux command from the command line:uname n

The internal connection between the Bundled Server (IBM x306) and theSAMP board must be administered on the /etc/hosts file as follows:

my-host 192.11.13.1my-samp 192.11.13.2

The Bundled Installation Wizard configures the /etc/hosts file. If the IP addresses are reserved or different, the communication between

the Bundled Server and the SAMP board will not work.


60/62



AE Services 3.0 Installed RPMs

mvap-cusldap-1.0-20 mvap-sms-3.0.0-25 mvap-DLG-3.0-176 mvap-callcontrol-3.0-176 mvap-common-utils-3.0.0-9 mvap-userservice-1.1-43 mvap-security-3.0.0-6 mvap-linuxconfig-3.0.0-14 mvap-platform-3.0.1415-1 mvap-transport-3.0-176 mvap-cmapi-3.0.1415-1

mvap-install-scripts-hooks-3.0.0-36 mvap-services-3.0.0-7 mvap-telephonysvc-3.0.1415-1 mvap-samp-3.0.0-12


61/62


Bundled Server Disk Partioning Scheme

The Bundled Server has a SATA Hard Disk with 80GB of disk

space. Once AE Services is installed on the Bundled server, it has

three disk partitions.

/ -the active partition - with approximately 18GB of space

/root2 - the inactive or offline partition - with approximately

18GB of space

/var - the common partition - with approximately 37GB of space

The remaining space is allocated for cache and otheruses.


62/62

Bundled Server Disk Notes:

T

he AE Services software is installed on the/

activepartition during a freshinstallation. When an upgrade of AE Services software is performed, the upgrade

script installs the new version of AE Services software on the /root2 inactivepartition first. The upgrade script then reboots the Bundled server. Upon rebootthe / and /root2partitions are switched. So, the new version of AE Servicessoftware is now on / active partition and the old version is on the /root2partition.

If you want to create directories or files on AE Server, it is strongly recommendedthat you create in the/varcommon partition. Otherwise any directory or filecreated in the/ active partition will be moved to the/root2partition upon anupgrade of AE Services software. One exception is that any directory or filecreated in the/home directory under any of the logins such as sroot, craft, andso on, are always copied over during an upgrade. Because copying large files suchas media files or databases, is time consuming, it can delay the upgrade process if

these files are stored in the/home directory of any login. Place a copy of the AE Services License in the /var common partition.

/varpersist across updates and upgrades but not fresh installations.

Documents

19971024 AES Installation