Skip to content

External Presentation Server Install Guide

Overview

This section will guide you through adding an external presentation server to an Assure1 installation. An external presentation server is used in circumstances where customers need to have a presentation server in a locked down DMZ.

Dependencies

  • See the Prerequisites for CentOS7 or RHEL7 documentation before starting an installation.

  • This guide assumes the installation of the Primary Assure1 system has been completed.

    Note

    The external presentation server WebFQDN cannot be the same as the primary presentation server (or the redundant, if running in a redundant setup).

  • The new external presentation server(s) must have access to the primary (and redundant, if applicable) presentation server(s) on ports 443, 3306, and 5671.

Steps

  1. Get the RPM file and place it in the "/opt/install/" directory on the server. (Create the directory, if it does not already exist.) The RPM is available in the "packages" directory on any server in the installation. This can be copied to the server that will become the external presentation server:

    Note

    The version of the RPM must be the same as the rest of the servers in the environment.

    $A1BASEDIR/distrib/packages/
    
  2. Install the RPM on the server using one of the following examples.

    • This will install Assure1 into the /opt/assure1/ directory:

      yum install /opt/install/Assure1-5.X.Y-ZZZ.x86_64.rpm
      
    • Assure1 can be installed to a different directory by using the "rpm" installation command with the "prefix" flag. An example is shown below which will place the files in the "/opt/a1/" directory:

      Warning

      Using the "rpm" command will not automatically install the required dependencies, and some dependency errors may come up if using this method. Install the missing dependencies, then install again using the "rpm" command.

      rpm -ivh --prefix /opt/a1 /opt/install/Assure1-5.X.Y-ZZZ.x86_64.rpm
      
  3. The SetupWizard for installing Assure1 is located in the $A1BASEDIR/bin/ directory. Go to the directory:

    cd $A1BASEDIR/bin/
    

    Note

    The default $A1BASEDIR is /opt/assure1/. This may be different if a custom path was used in the previous step.

  4. Run the SetupWizard to begin the installation. The SetupWizard command must be run as root:

    ./SetupWizard
    
  5. When prompted Is this your Primary Presentation Server?, enter n and press Enter.

  6. When prompted Enter the Host FQDN of your Primary Presentation Server:, enter the host FQDN of the server, then press Enter.

  7. When prompted Enter the Web FQDN of your Primary Presentation Server:, enter the web FQDN of the server, then press Enter.

  8. When prompted Set Web FQDN for this server?, enter y and press Enter.

  9. When prompted What is this install's Web FQDN?, make a change if needed, then press Enter.

  10. When prompted Is this a redundant server?, enter n and press Enter.

  11. When prompted Comma-delimited list of roles to install (numeric):, enter the numerical value for the "Presentation.External" role, and then press Enter.

  12. The files needed for the installation will then be downloaded from the primary presentation server and installed.

  13. The following log files can be checked for errors that may have occurred during the install:

    • $A1BASEDIR/logs/SetupWizard.log

    • $A1BASEDIR/logs/Package.log

Post Installation

After the above steps are done, the external presentation server installation is now completed.