Print

Optional: Installing the EPM software on auxiliary EPM server

The Avaya Experience Portal system may include one or more auxiliary EPM servers running the Experience Portal Manager software. The auxiliary EPM server handles Application Interface web service requests, shares Application Logging web service requests when the Primary EPM is in service, and handles all requests when the Primary EPM is down.

Before you begin

Procedure

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

    noteNote:

    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.
    tipTip:

    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.

        noteNote:

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

      • Run the mount -o ro /dev/cdrom /media/cdrom command.

      warningWarning:

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

  8. 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.
  9. From the installation options, enter 2 to select Auxiliary EPM and confirm.
  10. Verify that the Primary EPM is online as the next step requires Primary EPM to be contactable.
  11. On the Primary EPM Server Location section, specify the server name or IP address of the EPM server.
  12. On the Database Login Check for Auxiliary EPM section, enter the password for the auxiliary EPM database account created during the installation of the primary EPM.
    noteNote:

    During the auxiliary EPM software upgrade, if the auxiliary EPM sever does not have an EASG state, it will set the EASG state as the same EASG state of the Primary EPM. If the auxiliary EPM server is set to disable EASG, make sure you have access to the system without the Avaya Service Logins, and make sure you can get root access without using sroot.

  13. To confirm this password, re-enter the same password.
  14. On the Database Logins section, you can create a PostgreSQL database user account that can read the report data in the Auxiliary 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.
    noteNote:

    This user account can only read those tables in the Experience Portal database that store report data. Speech application developers can use this account to log in to the database to create custom reports using any SQL-enabled report generation tool.

  15. On the Database Logins section, you can create a 'QL database user account on the Auxiliary EPM server that can allow external systems to write report data into the Experience Portal database on this server. Select y or n.

    If you select y, then do the following:

    1. Enter the account name or press Enter to use the default account [reportwriter].
    2. Type a password for the account and press Enter.
    3. Confirm the password by typing the password again and press Enter.
    noteNote:

    This user account can only change the data in the tables that store report data in the Experience Portal database on the Auxiliary EPM server.

  16. Press Enter to end the installation script.

    During the installation process, Experience Portal creates several log files that you can use to verify what happened during installation. When the installation process is complete, Experience Portal moves these logs to the standard log directory and displays the exact path on the screen. You can view the detailed logs at $AVAYA_HOME/logs/install_<date>.

  17. 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.
  18. Load the environment variables created during the installation by logging out of Linux and then logging back in.
    1. Log out of the Linux system.
    2. Log back in to the Linux system.

      • 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 enter the su - root command.

  19. Check the status of the vpms service and all other services by running the following command:

    systemctl is-active vpms tomcat sl activemq

    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

Related tasks
Comments on this document?
August 2025
© 2022-2025, Avaya LLC All Rights Reserved.