Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Install Contrail Analytics and the CN2 Web UI

Use this procedure to install Contrail Analytics and the CN2 Web UI.

Contrail Analytics integrates Contrail's telemetry exporters in the OpenShift monitoring framework to provide a unified way for you to monitor and analyze your network and network infrastructure. Information collected includes logs, metrics, status' of various components, and flows.

Packaged with Contrail Analytics is the CN2 Web UI, which you can use to monitor and configure CN2 components.

When you install Contrail Analytics, all analytics components are preconfigured to work with each other.

Note:

We use Helm charts to install Contrail Analytics. Install Helm 3.0 or later on the host that you're using to install Contrail Analytics.

  1. Install OpenShift Logging.

    Contrail Analytics requires OpenShift Logging to be installed. For information on how to install OpenShift Logging, see https://docs.openshift.com/container-platform/4.12/logging/cluster-logging-deploying.html for your release.

  2. Locate the Contrail Analytics package that you downloaded. See Manifests.
  3. Create the project and namespace for the Contrail Analytics pods.
  4. Extract the openshift-values.yaml file from the Contrail Analytics package. This file contains values that override some OpenShift defaults.
  5. Configure how you want to manage CN2 Web UI users.
    • You can manage CN2 users from the CN2 Web UI, which means that your CN2 users are authenticated with the local database that CN2 administers. This is the default option. Use the openshift-values.yaml file as is.

    • You can manage CN2 users from OCP, which means that your OCP users and your CN2 users are one and the same. You add users through OCP, and those same user credentials can be used to log in to the CN2 Web UI.

      To configure CN2 for this option, enable the Dex OpenShift connector in openshift-values.yaml by uncommenting the following lines and specifying the external IP address.

      where <external-ip> is the node IP address (for example, 172.16.0.11, if you follow the examples in this document).
  6. Install the Contrail Analytics package.

    Contrail Analytics is installed as a NodePort service. You can reach the service by specifying the IP address of any node running Contrail Analytics. By default, the port to use is 30443.

  7. Verify that the analytics components are installed and running.
  8. After you install Contrail Analytics, you can access Grafana or the CN2 Web UI through the node IP address (for example, 172.16.0.11, if you follow the examples in this document).
    To access Grafana, point your browser to https://<node-IP-address>:30443/grafana/. Be sure to include the trailing /. The default Grafana administrator username/password is admin/prom-operator.
    To access the CN2 Web UI, point your browser to https://<node-IP-address>:30443. The default CN2 Web UI username/password is super/c0ntrail123.
    Note:

    The CN2 Web UI is classified as a Juniper CN2 Technology Preview feature. These features are "as is" and are for voluntary use. Juniper Support will attempt to resolve any issues that customers experience when using these features and create bug reports on behalf of support cases. However, Juniper may not provide comprehensive support services to Tech Preview features.

    For additional information, refer to Juniper CN2 Technology Previews (Tech Previews) or contact Juniper Support.

  9. To uninstall Contrail Analytics:
  10. To upgrade Contrail Analytics: