Installing the EPM software on the primary EPM server

All Avaya Experience Portal systems require a primary EPM server running the Experience Portal Manager (EPM) software.

Before you begin

• Complete the Primary EPM server installation 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.

• Ensure that you download the Avaya Experience Portal ISO file from the Avaya Support web site and burn it to a DVD if required.

• 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

1. Log into the server on which you want to install the primary EPM 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.

2. 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.

3. 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.

4. Change to the mount point directory.
5. 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.

6. Press Enter to continue.
7. On the EPM Administrator section, do the following
   1. 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.

   2. 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.

   3. To confirm the password, type the password again and press Enter.
8. 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.

9. Read through the EASG Acceptance of Terms.

   • To enable EASG, Type y and press Enter.

   • To disable EASG, type n and press Enter.

10. 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.
11. 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.

12. 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.

13. 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.

14. 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

15. 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

16. 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.
17. 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.