Installing Unified Assurance on an External Presentation Server

Learn how to install Oracle Communications Unified Assurance on an external presentation server. You can use an external presentation server when you need to have a presentation server in a locked down demilitarized zone.

External Presentation Server Installation Prerequisites and Directories

Before installing an external presentation server, ensure that the following prerequisites have been met:

• Linux Prerequisites

• A primary Unified Assurance system is installed.

• The new external presentation server has a different web FQDN than the web FQDN for the primary and secondary presentation servers.

• The new external presentation servers has bidirectional access to the primary and secondary presentation servers on ports 443, 3306, and 5671.

By default, Unified Assurance uses the following directories, though you can choose to use different ones:

• /opt: The Unified Assurance parent directory.

• /opt/install: The Unified Assurance installation directory.

• /opt/assure1: The Unified Assurance home directory created by the RPM installation and set as $A1BASEDIR.

Installing Unified Assurance on an External Presentation Server

1. If there is not an /install subdirectory under the home directory, create it. The default directory structure is:

   /opt/install

   The documentation refers to this directory as <installation_directory>.

2. Upload the extracted RPM file from <installation_directory> on any other server in the Unified Assurance environment to <installation_directory> on the external presentation server. The version of the RPM must be the same on all servers in the environment.

3. Install the RPM by running one of the following commands:

   • To install Unified Assurance into the default /opt/assure1/ home directory:

     yum install /opt/install/Assure1-6.V.W.X.Y-ZZZ.el8.x86_64.rpm
     

   • To install Unified Assurance into a custom home directory:

     Caution:

     The following rpm command does not automatically install the required dependencies, and some dependency errors may occur. To resolve them, install the missing dependencies, then rerun the command.

     rpm -ivh --prefix <custom_home_directory> <installation_directory>/Assure1-6.V.W.X.Y-ZZZ.el8.x86_64.rpm
     

4. If SELinux is enabled, confirm that the assure1 directory has the correct permissions, ownerships, and security context:

   1. From the Unified Assurance home directory's parent directory (typically the opt directory), run the following command:

      ls -l
      

   2. In the response, confirm that the permissions and ownership for the Unified Assurance home directory (typically assure1) match the following:

      drwx------. 11 assure1 assure1 4096 <date_time> <UA_home>
      

   3. Change to the Unified Assurance home directory (typically assure1) and run the following command:

      ls -lZ
      

   4. In the response, confirm that the permissions, ownership, and security contexts match the following:

      drwxr-xr-x.  3 assure1 assure1 system_u:object_r:bin_t:s0 4096 <date_time> bin
      drwxr-xr-x. 12 assure1 assure1 system_u:object_r:etc_t:s0  149 <date_time> distrib
      drwxr-xr-x.  3 assure1 assure1 system_u:object_r:etc_t:s0   57 <date_time> etc
      drwxr-xr-x.  2 assure1 assure1 system_u:object_r:etc_t:s0  102 <date_time> legal
      drwxr-xr-x.  3 assure1 assure1 system_u:object_r:lib_t:s0  106 <date_time> lib
      drwxr-xr-x.  3 assure1 assure1 system_u:object_r:etc_t:s0   67 <date_time> logs
      drwxr-xr-x.  2 assure1 assure1 system_u:object_r:etc_t:s0   33 <date_time> tmp
      drwxr-xr-x.  3 assure1 assure1 system_u:object_r:etc_t:s0   17 <date_time> var
      drwxr-xr-x.  3 assure1 assure1 system_u:object_r:etc_t:s0   18 <date_time> vendor
      

   If any permissions, ownership, and security contexts do not match, consult with your local system administrator.

5. Run one of the following commands as root:

   • Export LD_LIBRARY_PATH:

     export LD_LIBRARY_PATH=$A1BASEDIR/lib:$A1BASEDIR/lib/private
     

   • Source the .bashrc file:

     source $A1BASEDIR/.bashrc
     

   Note:

   By default, $A1BASEDIR is set to /opt/assure1/. If you used a custom home directory, this will be different.

6. Enable temporary files to run by redirecting the root tmp directory to the Unified Assurance tmp directory with the following command:

   export TMP=$A1BASEDIR/tmp
   

   This is required to run the SetupWizard application that installs Unified Assurance.

7. Install Unified Assurance by running SetupWizard:

   1. Go to the following directory:

      cd $A1BASEDIR/bin/
      

   2. Start SetupWizard by running the following command as root:

      ./SetupWizard --Depot <installation_directory>/:a1-local
      

   3. When prompted Is this your Primary Presentation Server?, enter n, then press Enter.

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

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

   6. When prompted Set Web FQDN for this server?, enter y, then press Enter.

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

   8. When prompted Is this a redundant server?, enter n, then press Enter.

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

      The files needed for the installation are downloaded from the presentation server and installed.

   10. Check the following log files for installation errors::

       • $A1BASEDIR/logs/SetupWizard.log

       • $A1BASEDIR/logs/Package.log

The external presentation server installation is complete.