Single Server Install

Overview

A single server install is normally used as a test server or for proof of concepts. Single server installs should not be used for prolonged network monitoring.

Dependencies

Steps

  1. Get the collection file and place it in the /opt/install/ directory on the server. (Create the directory, if it does not already exist.)

  2. Extract the contents of the collection to the /opt/install/ directory:

    unzip -d /opt/install/ Oracle-Communications-Unified-Assurance-6.W.X.Y.Z.zip

  3. Install the RPM on the server using the following syntax. By default, this will install Unified Assurance into the /opt/assure1/ directory:

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

    Note:

    Unified Assurance can be installed to a different directory by using the "rpm" installation command with the "prefix" flag.

    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.

    An example is shown below which will place the files in the "/opt/a1/" directory:

    rpm -ivh --prefix /opt/a1 /opt/install/Assure1-6.V.W.X.Y-ZZZ.x86_64.rpm

  4. Do one of the following before running SetupWizard.

    • Export the LD_LIBRARY_PATH:

      export LD_LIBRARY_PATH=$A1BASEDIR/lib

    • or source the .bashrc file:

      source $A1BASEDIR/.bashrc

  5. The SetupWizard for installing Unified Assurance 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 preparation step.

  6. Run the SetupWizard to begin the installation. The SetupWizard command must be run as root and must include the --Depot flag:

    ./SetupWizard --Depot /opt/install/:a1-local

  7. When prompted Is this your Primary Presentation Server?, enter y and press Enter.

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

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

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

  11. The files needed for the installation will then be downloaded and installed.

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

    • $A1BASEDIR/logs/SetupWizard.log

    • $A1BASEDIR/logs/Package.log

  13. The AnalyticsWizard for installing analytics is located in the $A1BASEDIR/bin/historical/ directory. Go to the directory:

    cd $A1BASEDIR/bin/historical/

  14. Run the AnalyticsWizard to begin the installation. The AnalyticsWizard command must be run as root:

    ./AnalyticsWizard

  15. When prompted Allow this script to configure for analytics? [n]:, enter y and press Enter.

  16. When prompted What heap size should Elasticsearch use? [<value>]:, make a change if needed, then press Enter.

    Note:

    The <value> will be set to half of the total system memory, rounded down. This can be changed for different environments, with a minimum recommended value of 512 megabytes (512m).

  17. When prompted What maximum machine learning size should Elasticsearch use (percent of system memory)? [60]:, make a change if needed, then press Enter.

  18. When provided information about analytics components and a list of servers, then prompted Are these servers correct? [n]:, enter y and press Enter.

  19. Analytics will then be installed, along with a variety of sub-services needed for proper functionality.

  20. Enter the web-FQDN of the server into your browser to open up the UI login page. Login with:

    • Username: admin

    • Password: admin

  21. Navigate to the Users UI and select the admin user account.

    Configuration -> AAA -> Users

    Note:

    As a best practice, it is advised to update/change the administrator password to a password of your choosing.

Post Installation

After the above steps are done, the base installation is now completed. Please review the additional documentation available in the other books which are available in the navigation on the left, about how to use the Unified Assurance platform.