Installing the Avaya Experience Portal software

Before you begin

Complete the Single server configuration worksheet and have it available to help answer the questions raised during the installation.
Before you install the software, read the Avaya Experience Portal Release notes on the Avaya Support site. These release notes contain information about the product that is not included in the formal documentation set.
Download any patches for Avaya Experience Portal Release 8.1 from the Avaya Support website at http://support.avaya.com.
Make sure you have completed the software prerequisites described in Prerequisites checklist for installing Avaya Experience Portal software on a single server.
Ensure that you download the Avaya Experience Portal ISO file from the Avaya Support website and burn it to a DVD.
Ensure that you configure a yum repository if you have installed Red Hat Enterprise Linux Server on a single server.
Check if default umask is set to 027. If it is not set to 027, the installer asks if you want to set it to 027. If you select 'yes', the installer applies this setting to the OS. If you select 'no', the installer exits.

	Note:
	You can run the prerequisite installer before installing Experience Portal. For more details, see Platform Vendor Independent Check

Procedure

Log into the server on which you want to install the Experience Portal software.

Log on to the local Linux console as root.
Or log on remotely as a non-root user and then change the user to root by entering the su - root command.

	Note:
	By default, the craft and sroot users are disabled in Avaya Experience Portal 8.1 Avaya Enterprise Linux fresh installations. Avaya Service Login accounts can only access the Avaya Experience Portal system if they are EASG protected.

Insert the Avaya Experience Portal 8.1 software installation DVD into the DVD drive of the server.

Tip:

These instructions assume that you are going to access the Experience Portal installation DVD by mounting the appropriate DVD drive on the target system. If you want to access the installation DVD files from a shared network directory or a local directory, you can copy the Experience Portal installation ISO image to that directory. However, that directory must be readable by all users on the system. If the directory is only readable for root users, the installation script will encounter errors and will not complete successfully.

Mount the Avaya Experience Portal 8.1 software installation DVD. The mount command depends on the server's hardware and operating system.

If you are working with Avaya Enterprise Linux, mount the DVD by entering the mount /mnt/cdrom command, where /mnt/cdrom is the mount point typically associated with the DVD drive in the fstab file.

If you are working with a supported version of Red Hat Enterprise Linux Server, to mount the DVD:

Run the mkdir -p /media/cdrom command.

Note:

This command is required only if the /media/cdrom mount point does not exist.
Run the mount -o ro /dev/cdrom /media/cdrom command.

	Warning:
	When Red Hat Enterprise Linux Server automatically mounts the DVD, the files on the DVD are not executable. You must manually mount the Experience Portal installation DVD using the commands shown above.

Change to the mount point directory.
Enter the bash aepinstall.sh command and press Enter to start the installation script.

The bash aepinstall.sh script checks to make sure the calling user has root privileges.
Press Enter to continue.
Read through the end user license agreement and select Y to accept the terms of the license agreement.
Experience Portal automatically starts the PVI checker, which analyzes your system’s hardware and operating system configuration. The PVI checker does the following:
- Checks to ensure that a non-root user account has been created.
- Asks the user to confirm that one of these accounts is the non-root account the user has configured, and to set the password.
- Checks for any missing pre-requisite RPMs and installs any if missing.
- Creates a log file in /opt/Avaya/InstallLogs/pvicheck.log.
- Checks if default umask is set to 027. If it is not set to 027, the installer asks if you want to set it to 027. If you select 'yes', the installer applies this setting to the OS. If you select 'no', the installer exits.
After the configuration analysis is complete, the PVI checker displays a message stating whether all prerequisite checks passed followed by the first Prerequisite Status page.
From the installation options, enter 4 to select Single server - Primary EPM and MPP and confirm.

On the EPM Administrator section, do the following

Type the name you want to use for the EPM user account that will have access to all Experience Portal management functions and press Enter.

The Experience Portal administrator uses this account to log in to the EPM web interface to administer the Experience Portal system. The account is assigned the Administration user role as well as the Auditor and User Manager user roles. For details about User Roles, see Administering Avaya Experience Portal on http://support.avaya.com.

Type the password for this account and press Enter.

Note:

All passwords you enter during the installation must:

Be at least eight characters in length.
Contain at least one alphabetic character and one digit.
Not contain user name.

To confirm the password, type the password again and press Enter.

On the Database Logins section, you can create a PostgreSQL database user account that can read the report data in the Experience Portal database. Select y or n.

If you select y, do the following:
1. Enter the account name or press Enter to use the default account [report].
2. Type a password for the account and press Enter.
3. Confirm the password by typing the password again and press Enter.
The system displays the EASG (Enhanced Access Security Gateway) Acceptance of Terms.
Read through the EASG Acceptance of Terms.
- To enable EASG, Type y and press Enter.
- To disable EASG, type n and press Enter.
On the Database Login for Auxiliary EPM section, you can specify whether you want to create a PostgreSQL user account for the optional Auxiliary EPM server.

This account allows each Auxiliary EPM server limited access to the main Experience Portal database, and it is required if you plan to configure an Auxiliary EPM server.

Answer y or n when the system prompts if you would like to configure this Primary EPM to support one or more Auxiliary EPM server.

If you select y, then do the following:
1. Type the password for this account and press Enter.
2. Confirm the password by typing the password again and press Enter.
On the Product ID section, type the Product ID created with the Automatic Registration Tool (ART) for this Experience Portal system and press Enter.

The notification feature uses the Product ID to generate SNMP traps. SNMP traps are unsolicited notifications of significant events from an SNMP agent to an SNMP manager. The SNMP agent resides on a managed network device.
On the Select Backup Scheduler configuration section, enable or disable the backup scheduler to perform system backups.
You can select the frequency to run the the backup scheduler. The options are:
- None
- Daily at 00:00
- Weekly on Sunday at 00:00
- Monthly on the 1st of every month at 00:00
Experience Portal uses the ssl protocol to establish a secure connection between its servers. This connection requires a security certificate that can be created by Experience Portal or purchased from a third-party company.

By default, the installer generates and installs a SHA256 2048 bit server certificate. The installer also generates and installs a SHA256 2048 bit EPM Root certificate. External certificates (CAs) or third party certificates can be installed after the AEP installer is completed.
When the system displays a summary of all of the inputs entered, do the following:
- Press y to continue with these settings
- Press n to re-enter the settings.
Experience Portal begins installing the software. During the install, it displays messages indicating its progress.
The installation process can appear completed or stopped even though it is still processing and installing the software.

Please wait until the aepinstall.sh script completes installing and displays the message:
```
20210402-17:15:15 Finished Installation
```
The aepinstall.sh script creates a log file at /opt/Avaya/InstallLogs/ aepinstall.log
To unmount and eject the DVD:
1. Change the directory to a location that is outside the mount point. For example, enter the cd / command to change to the root directory.
2. Unmount the DVD as described in the server documentation.
3. To eject the Experience Portal installation DVD, press the button on the DVD drive or enter the eject command.
Check the status of the vpms service and all other services by running the following command:

systemctl is-active vpms tomcat sl activemq httpd postgresql epmcompmgr

A list appears for each service. If the vpms service is running properly, the command displays active for all the services in the list.

Next Steps

To verify if the installation or upgrade was successful, go to http://EPM-Server/VoicePortal and log into the Experience Portal web interface.

Where, EPM-server is the hostname or the IP address of the system where the primary EPM logon using EPM Administrator account.
Install any required patches that you download from the Avaya online support website, http://support.avaya.com.
Add the MPP Server using EP web admin.
For security reasons, change the password of the EPM user account created during the installation.. The Experience Portal administrator uses this account to log in to the EPM web interface to administer the Experience Portal system.

	Note:
	This command is required only if the /media/cdrom mount point does not exist.