Installing Unified Assurance on a Single Server

You can install all Oracle Communications Unified Assurance components on a single server. You can use a single server installation as a test server or for proof of concepts. Oracle does not recommend single server installations for prolonged network monitoring.

Single Server Installation Prerequisites and Directories

Before starting an installation, ensure that you have completed all tasks described Linux Prerequisites.

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

Installing Unified Assurance on a Single Server

To install Unified Assurance on a single server:

  1. Download the latest Unified Assurance software, including the release package and the latest available patch, and extract the contents of the collection files to an installation directory. This is typically /opt/install, and is referred to as <installation_directory> in the documentation.

    See Downloading the Latest Unified Assurance Software for more information about where to get the software and how to extract the collection file.

  2. Install the Unified Assurance RPM on the server by running one of the following commands:

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

      dnf install <installation_directory>/Assure1-6.V.W.X.Y-ZZZ.el8.x86_64.rpm

      where 6.V.W.X.Y-ZZZ is the version number you are installing. For example, 6.1.0.2.0-584.

      If you are installing a patch, use the patch RPM rather than the release 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

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

  4. Run the following command as root:

    source <UA_home>/.bashrc

    Note:

    By default, <UA_home> is /opt/assure1/. If you used a custom home directory, this will be different.

  5. 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 y and press Enter.

    4. When prompted What is this install's Web FQDN? [FQDN]:, make a change if needed and press Enter.

    5. When prompted Comma-delimited list of roles to install (numeric):, enter the numerical value for the All role and press Enter.

    6. When prompted Do you accept all the license agreements? Must type "AGREE":, enter AGREE and press Enter.

      Setup Wizard installs Unified Assurance.

    7. Check the following log files for installation errors:

      • $A1BASEDIR/logs/SetupWizard.log

      • $A1BASEDIR/logs/Package.log

  6. Install analytics by running AnalyticsWizard:

    1. Go to the following directory:

      cd $A1BASEDIR/bin/historical/

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

      ./AnalyticsWizard

    3. When prompted Allow this script to configure for analytics?, enter y and press Enter.

    4. When prompted to enter the heap size, make a change if needed and press Enter.

      Note:

      By default, the heap size is set to thirty percent of the total system memory, rounded down. You can change this for different environments, with a minimum recommended value of 512 megabytes (512m).

    5. When prompted Are these servers correct?, review the list to verify that all components specify the same server, enter y, and then press Enter.

    6. When prompted to enter a name for the OpenSearch cluster, make a change if needed, and press Enter.

      AnalyticsWizard installs analytics and other related services.

  7. Change the default password:

    1. In a browser, enter the web FQDN of the server.

    2. Log in using admin as the username and password.

    3. From the Configuration menu, select AAA, then Users.

    4. Select the admin user account.

    5. In the Password and Repeat Password fields, enter a new secure password of your choice and click Submit.

      See Users in Unified Assurance User's Guide for information about the fields in this interface.

The installation process is complete.