Upgrading the Experience Portal software interactively on a single server

Before you begin

Ensure that you upgrade the operating system on the server as described in Operating system upgrade overview.

Important:

Ensure that you copy and restore the backup data to the Primary EPM. For more information, see Copying and restoring the backup files.
Complete the Single EPM server upgrade worksheet and have it available to help answer the questions raised during the installation.
Before you upgrade the software, read the Avaya Experience Portal release notes on the support site at https://support.avaya.com/css/P8/documents/101041248. These release notes contain information about the product that is not included in the formal documentation set.
If upgrading from Avaya Experience Portal 6.x or 7.x, ensure that you have staged the required files as mentioned in Staging the Experience Portal 6.x or 7.x backup files on the Primary EPM before upgrading Experience Portal.
Download any patches for Avaya Experience Portal Release 8.1 from the Avaya Support website at http://support.avaya.com.
Ensure that you have completed the software upgrade prerequisites described in Prerequisites checklist for upgrading Experience Portal.
For disk space related information, see Space requirement for upgrading primary EPM on Red Hat Enterprise Linux and Space requirements for upgrading primary EPM on Avaya Enterprise Linux.
If you have installed a managed application, contact the provider of the managed application to check if you need to perform any additional steps as part of the Experience Portal upgrade.

Procedure

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

If you are an Avaya Services representative, and use Avaya Enterprise Linux, the Avaya Service accounts will not be available after the Avaya Enterprise Linux upgrade. The Avaya Service accounts will be available through EASG configuration during the Experience Portal upgrade.

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:

Ensure that you upgrade using the same Linux account that was used during the prior installation. If you upgrade an Experience Portal system by using a Linux account that is different than the account used during the previous install or upgrade, the upgrade might fail.

This applies to RHEL (software-only) customers. It does not apply to the root and sroot users in Avaya Linux.

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.
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.
If you are configuring Experience Portal with externally signed server identity certificates, see Administering Avaya Experience Portal on the Avaya Support site.
Install any required patches that you download from the Avaya online support website, http://support.avaya.com.
Reestablish the link between the MPP and the EPM as described in Reestablishing the link between the EPM and the MPP.

If you wish to change the postgres database password specified by the auto upgrade utility, run the SetDbPassword.sh script.

Important:

If Proactive Outreach Manager is installed on this system, then you must run the script SetDbPassword.sh to change the password for the database user postgres. The Experience Portal upgrade program automatically generates a new password for the database user postgres. However, Proactive Outreach Manager is already configured to use the old password. To keep Proactive Outreach Manager working, you must change the password for the database user postgres back to the value that you have configured in Proactive Outreach Manager. For more information about configuring the PostgreSQL database user accounts, see Administering Avaya Experience Portal.

Install the Avaya Service Account authentication file. For more information about installing the Avaya Service Account authentication file, see Troubleshooting Avaya Experience Portal.
Upgrade the co-resident application server. For more information, see Optional: Updating the co-resident application server.

The EPM upgrade must include reinstalling the license file for the local WebLM.

	Note:
	Due to the WebLM update, the system does not retain the license file on upgrade. You are required to configure the appropriate license for Avaya Experience Portal 8.1.

	Important:
	Ensure that you copy and restore the backup data to the Primary EPM. For more information, see Copying and restoring the backup files.

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