Vision Installation Overview

Learn about installing Oracle Communications Unified Assurance Vision.

About Installing Vision

You install Vision by deploying the following Vision microservices to Kubernetes using Helm charts:

• Vision: Provides the Vision API. Must be deployed to a presentation server.

• Vision Web: Provides the Vision UI. Must be deployed to a presentation server.

• Vision Event: Provides the integration between Unified Assurance events and Vision. Can be deployed to any server.

You can deploy the microservices by using the command line or by using the UI. Both options let you update default configuration settings during deployment. This document describes how to use the command line to deploy the Vision microservices. See Deploying a Microservice by Using the UI for information about using the UI.

You can install the vision microservices in the following configurations:

• A single-server installation where all the Vision microservices are installed on a single server. See Installing Vision on a Single Server.

• A multiple-server installation, in either a redundant or non-redundant configuration, where the Vision and Vision Web microservices are installed on a presentation server and the Vision Event microservice is installed on a separate server. See Installing Vision on Multiple Servers.

Minimum Hardware Requirements for Vision

The hardware requirements for Vision may mean that the presentation servers require additional resources.

• 4 core Xeon E5 2GHz or better processors (4 cores)

• 16GB RAM

• 100GB drive space

Vision Installation Prerequisites

Before installing Vision, ensure that the following prerequisites have been met:

• A microservice cluster has been set up. See Microservice Cluster Setup in Unified Assurance Implementation Guide for information. To join two clusters for redundant pairing, see Creating Redundant Clusters.

  Note:

  If you set up a cluster to use exclusively for Vision on the presentations servers, use the --no-zone option when setting up the cluster. See Creating Clusters in Unified Assurance Implementation Guide for information about options when creating clusters.

• For the Vision Event microservice, the following microservices have been deployed to the cluster:

  • Pulsar: Apache Pulsar provides the messaging framework between microservices. See Pulsar in Unified Assurance Implementation Guide for information about deploying this microservice.

  • Event Canal: The Event Canal microservice reads events from the Event database and publishes them to a Pulsar topic. The Vision microservice subscribes to this topic to populate events on the map. See Event Canal in Unified Assurance Implementation Guide for information about deploying this microservice.

  If you are installing Vision on multiple servers, with the Vision and Vision Web microservices on the presentation server and the Vision Event microservice on a collection server (or other type of server), deploy the Pulsar and Event Canal microservices to the same server as the Vision Event microservice. You do not need to deploy Pulsar to the presentation server, unless you need if for microservices in the cluster other than Vision.

• If you are in a closed proxy enabled environment, configure the proxy in the Vision properties:

  1. Open the /opt/assure1/etc/vision/vision-io/application.properties file.

  2. In the Outbound Proxy Configuration section, set values for the following properties:

     • proxy.host

     • proxy.port

     • proxy.username

     • proxy.password

  3. Change the value of proxy.enabled to true.

  4. Save and close the file.

  Note:

  Because changes to the application.properties file are overwritten with the latest default settings when you perform package updates, you will need to reconfigure the proxy settings after performing a package update.

Related Topics

See the following topics for more information about Vision:

• What is Vision? in Unified Assurance Concepts

• Navigation Vision in Unified Assurance User's Guide

See the following topics for more information about microservices:

• Understanding Microservices in Unified Assurance Concepts

• Microservice Cluster Setup in Unified Assurance Implementation Guide

• Managing Microservices in Unified Assurance Implementation Guide