Installing the Fix Pack 3 on Kubernetes

Use this information if you are installing Telco Network Cloud Manager - Performance for the first time or if you are updating from 1.4.6.

You can install the Telco Network Cloud Manager - Performance software with the install.sh script. The install.sh script can detect if Telco Network Cloud Manager - Performance 1.4.6 is already installed and updates it to Fix Pack3 level. If not, it installs Telco Network Cloud Manager - Performance Fix Pack3.

Steps to install the Fix Pack 3

Follow these steps to apply and use the dashboards and configuration pages from the Fix Pack:
  1. Download the Fix Pack 3 package
  2. Follow the steps in Applying the Fix Pack 3 on your existing cloud environment.
  3. Install the Advanced bundle.
  4. Install the needed Technology Packs. See Installing Technology Packs.
    Important: All the dashboards that are available in the Technology Packs are published automatically and the aligned with the correct menus for navigation. After the Technology Pack is installed, NiFi flows are created, start the processors manually. Discoveries are run, and the metrics are collected. You can start seeing the metrics in the dashboards.
  5. Manually, publish the menus if needed. See Optional: Publishing Telco Network Cloud Manager - Performance Dashboards menus.

Download and extract the Fix Pack 3 package

Licensed customers can download the Telco Network Cloud Manager - Performance Fix Pack 3 electronic image from IBM® Fix Central.

  1. Download the Telco Network Cloud Manager - Performance Fix Pack 3 software from IBM Fix Central.

    1.4.6-TIV-TNCP-FP003.tar.gz

  2. Copy the image to any location on the master node in your cluster.

    For example, /installers/core. It is referred to as <DIST_DIR>.

  3. Use the following command to extract the media:
    tar -zxvf 1.4.6-TIV-TNCP-FP003.tar.gz
    Or use the following command:
    gunzip -c 1.4.6-TIV-TNCP-FP003.tar.gz | tar -xvf -
    Following files are available:

    • ibm-tncp-case-1.4.6-fp003.tgz is the CASE bundle for OpenShift® Container Platform.

    • tncp-1.4.6-fp003.tar.gz is the installation package for Kubernetes cloud platform.

    • tncp-1.4.6-advanced-fp003.tar.gz is the advanced bundle that contains the remote collectors, script for integration with Tivoli® Netcool®/OMNIbus, and script to enable and disable metrics.

    • README
  4. Extract the tncp-1.4.6-fp003.tar.gz file with the following command:
    tar -zxvf tncp-1.4.6-fp003.tar.gz
    You can find the following folders and files of significance:
    • etc
      • tools
        • backup.sh

          This script helps to back up NFS data.

        • encrypt.sh

          This script helps to create an encrypted password from a text that can be used in the system anywhere.

        • offline.sh and offline.bat

          These scripts can be used to download all Telco Network Cloud Manager - Performance Docker images from the Docker hub without access to the internet.

        • prerequisites.sh

          This script checks if your environment has all the requirements.

        • restore.sh

          This script helps to restore the backup NFS data.

      • integrations
        • dash

          Contains the dash-integration.tar.gz file that is used for integrating Telco Network Cloud Manager - Performance with Jazz® for Service Management.

        Note: To integrate Telco Network Cloud Manager - Performance with Jazz for Service Management and Tivoli Netcool/OMNIbus, use the advanced bundle. See Advanced installation media.
    • license
    • services

      A folder that contains all the microservices that are available in Telco Network Cloud Manager - Performance.

      Every service has a yaml configuration file. The following subfolders for each microservices are available:
      • analytics
      • app
      • cassandra
      • ceph
      • dashboard
      • diamond-db
      • dns-collector
      • file-collector
      • flow-analytics
      • flow-collector
      • inventory
      • kafka
      • nfs
      • nifi
      • operator
      • pack-service
      • ping-collector
      • postgres
      • postgres-threshold
      • security
      • snmp-collector
      • snmp-discovery
      • threshold
      • timeseries
      • ui
      • zookeeper
    • install.sh

      Script to run the Telco Network Cloud Manager - Performance installer.

    • tncp-cr-template.yaml

      A template that contains the custom resource definition to use with the installation script.

    • uninstall.sh

      Script to uninstall Telco Network Cloud Manager - Performance software.

Install the Fix Pack 3

Important: Before you install the Fix Pack 3, change the annotation manager value back to the original value. Then, install the Fix Pack2. Then, configure the parameters and rename the manager value.
You can install the Telco Network Cloud Manager - Performance software with the install.sh script in two ways:
  • Install with default settings.
  • Install with a custom resource definition.

    A custom resource is an extension of the Kubernetes API that is not available in a default Kubernetes installation. It represents a customization of a particular Kubernetes installation. You create a custom resource file by editing the tncp-cr-template.yaml file that is provided in the core installation bundle.

Follow the instructions that are available in Installing Telco Network Cloud Manager - Performance to install and update Telco Network Cloud Manager - Performance to the latest fix level.

Important: If you had an updated annotation manager value for any specific configuration changes, configure the parameters again and rename the manager value. It is applicable only if you are updating from Telco Network Cloud Manager - Performance 1.4.6 to the latest fix level.

Install the Advanced bundle

  1. Copy the tncp-1.4.6-advanced-fp003.tar.gz file to any location in the master node in your cluster.
  2. Use the following command to extract the media:
    tar -zxvf tncp-1.4.6-advanced-fp003.tar.gz
    Or use the following command:
    gunzip -c tncp-1.4.6-advanced-fp003.tar.gz | tar -xvf -
    You can see the following files and folders of significance:
    • tncp-1.4.6-advanced-fp003
      • basecamp-remote-snmp-collector-2.4.6.2.tar.gz
      • basecamp-remote-snmp-discovery-2.4.6.2.tar.gz
    Important: For the other remote collectors and scripts, use the M0HSWEN.tar.gz that contains all the files.
  3. Use the remote collectors as needed.

    For more information, see Remote monitoring.

Install Technology Packs

After Telco Network Cloud Manager - Performance application is installed, follow the steps in Installing Technology Packs to install the needed Technology Packs.