3 Installing ATS for Different Network Analytics Suite Products

This section describes how to install ATS for different Network Analytics Suite Products. It includes:

3.1 Installing ATS for NWDAF

This section describes the resource requirements and ATS installation procedures for NWDAF:

3.1.1 Software Requirements

This section describes the software requirements to install ATS for NWDAF. Install the following software bearing the versions mentioned in the table below:

Table 3-1 Software Requirements

Software Version
Kubernetes 1.20.7, 1.21.7, 1.22.5
Helm 3.1.2, 3.5.0, 3.6.3, 3.8.0
Podman 2.2.1, 3.2.3, 3.3.1
Oracle Communications Cloud Native Core, Cloud Native Environment (CNE) Release 1.9.x /1.10.x/ 22.1.x, 23.1.0.0.0

To verify the CNE version, run the following command:

echo $OCCNE_VERSION

To verify the Helm and Kubernetes versions installed in the CNE, run the following commands:

Verify Kubernetes version: kubectl version

Verify Helm version: helm3 version

3.1.2 Environment Setup

This section describes steps to ensure the environment setup facilitates the correct installation of ATS for NWDAF.

Network Access

The Kubernetes cluster hosts must have network access to the following:

  • Local docker image repository, where the OCATS NWDAF images are available.

    To verify if the Kubernetes cluster hosts have network access to the local docker image repository, retrieve any image with tag name to check connectivity by running the following command:

    docker pull <docker-repo>/<image-name>:<image-tag>

    Where, docker-repo is the IP address or host name of the repository, image-name is the docker image name and image-tag is the tag the image used for the NWDAF pod.

  • Local helm repository, where the OCATS NWDAF helm charts are available.

    To verify if the Kubernetes cluster hosts have network access to the local helm repository, run the following command:

    helm repo update

Client Machine Requirement

Listed below are the Client Machine requirements for a successful ATS installation for NWDAF:

  • Network access to the Helm repository and Docker image repository.
  • Helm repository must be configured on the client.
  • Network access to the Kubernetes cluster.
  • The environment settings to run the kubectl and docker commands. The environment should have privileges to create a namespace in the Kubernetes cluster.
  • The Helm client must be installed. The environment should be configured such that the Helm install command deploys the software in the Kubernetes cluster.

3.1.3 Resource Requirements

This section describes the ATS resource requirements for NWDAF.

NWDAF Pods Resource Requirements Details

This section describes the resource requirements, which are needed to deploy NWDAF ATS successfully. The following table describes the total resource usage for:
  • NWDAF Suite
  • NWDAF Notification consumer simulator

Table 3-2 OCNWDAF Pods Resource Requirements Details

Microservice vCPUs Required per Pod Memory Required per Pod (GB) Storage PVC Required per Pod (GB) Replicas (regular deployment) Replicas (ATS deployment) CPUs Required - Total Memory Required - Total (GB) Storage PVC Required - Total (GB)
ocn-ats-nwdaf-service 4 3 0 1 1 4 4 0
ocn-ats-nwdaf-notify-service 2 1 0 1 1 2 1 0

3.1.4 Downloading the ATS Package

Locating and Downloading ATS Images

To locate and download the ATS Image from MOS:

  1. Log in to My Oracle Support using the appropriate credentials.
  2. Select the Patches & Updates tab.
  3. In the Patch Search window, click Product or Family (Advanced).
  4. Enter Oracle Communications Cloud Native Core - 5G in the Product field.
  5. Select Oracle Communications Cloud Native Core Networks Data Analytics Function <release_number> from the Release drop-down.
  6. Click Search. The Patch Advanced Search Results list appears.
  7. Select the required ATS patch from the list. The Patch Details window appears.
  8. Click Download. The File Download window appears.
  9. Click the <p********_<release_number>_Tekelec>.zip file to download the NWDAF ATS package file.
  10. Untar the zip file to access all the ATS Images. The <p********_<release_number>_Tekelec>.zip. The NWDAF directory has the following package structure:

    Figure 3-1 OCNWDAF Package Structure


    OCNWDAF Package Structure

  11. Copy the tar file to the CNE, OCI, or Kubernetes cluster where you want to deploy ATS.

3.1.5 Pushing the Images to Customer Docker Registry

Follow the procedure described below to push the NWDAF ATS docker images to the docker repository:

Pre-requisites

  • Oracle Linux 8 environment
  • NWDAF 23.1.0.0.0 package

Note:

The NWDAF deployment package includes:
  • Ready to use docker images in the images tar or zip file.
  • Helm charts to help orchestrate containers in Kubernetes.

The communication between NWDAF service pods are pre-configured in the Helm charts. The following services are used for NWDAF ATS:

Table 3-3 NWDAF ATS Services

Service Name Docker Image Name Image Tag
ocn-ats-nwdaf-notify-service ocats-nwdaf-notify-api 23.1.0.0.0
ocn-ats-nwdaf-service ocats-nwdaf-subs 23.1.0.0.0
  1. Verify the checksums of tarballs mentioned in file Readme.txt.
  2. Run the following command to extract the contents of the tar file:
    tar -xvf nwdaf-pkg-<marketing-release-number>.tgz

    The nwdaf-pkg-<marketing-release-number>.tar file contains the following NWDAF ATS Images:

    • ocats-nwdaf-notify-api
    • ocats-nwdaf-subs
  3. Run the following command to push the docker images to the docker repository:
    docker load --input <image_file_name.tar>

    Example:

    docker load --input images
  4. Run the following command to push the NWDAF ATS docker files to the docker registry:
    docker tag <image-name>:<image-tag> <docker-repo>/<image-name>:<image-tag>
docker push <docker_repo>/<image_name>:<image-tag>

    Where, <docker-repo> indicates the repository where the downloaded images can be pushed.

  5. Run the following command to verify if the images are loaded:
    docker images
  6. Run the following command to push the helm charts to the helm repository:
    helm cm-push --force <chart name>.tgz <helm repo>

3.1.6 Configuring ATS

This section describes how to configure ATS for NWDAF.

3.1.7 Deploying NWDAF ATS in the Kubernetes Cluster

To deploy ATS, perform the following steps:

  1. The values.yaml file is located inside ocn-ats-nwdaf-chart directory. The namespace, docker image or tag can be updated in the values.yaml file.
  2. Run the following command to deploy NWDAF ATS and its consumers:
    helm install  --name<release_name> <chart name>.tgz --namespace <namespace_name> -f <values-yaml-file>
  3. Run the following command to verify the ATS deployment status:
    kubectl get deployments -n <namespace_name>

    Example:

    Figure 3-2 Sample Image


    Sample Image

3.1.8 Verifying ATS Deployment

Run the following command to verify ATS deployment.

helm status <release_name>

Once ATS is deployed, run the following commands to check the pod and service deployment:

To check pod deployment, run the command:

kubectl get pod –n <namespace_name>

To check service deployment, run the command:

kubectl get service -n <namespace_name>

3.1.9 Creating and Verifying NWDAF Console Namespaces

This section explains how to create a new namespace or verify an existing namespace in the system.

Run the following command to verify if the required namespace exists in the system:

$ kubectl get namespaces

If the namespace exists, continue with the NWDAF ATS installation. If the required namespace is not available, create a namespace using the following command:

$ kubectl create namespace <required namespace>

For example:

$ kubectl create namespace ocats-nwdaf

Naming convention for Namespaces:

  • Starts and ends with an alphanumeric character.
  • Contains a maximum of "63" characters.
  • Contains only alphanumeric characters or '-'.

3.2 Installing ATS for OCNADD

Following are the ATS installation procedures for Oracle Communications Network Analytics Data Director (OCNADD):
  1. Downloading the ATS Package
  2. Pushing the Images to Customer Docker Registry
  3. Configuring ATS
  4. Deploying ATS and Stub in Kubernetes Cluster
  5. Verifying ATS Deployment

3.2.1 Resource Requirements

This section describes the ATS resource requirements for OCNADD.

Overview - Total Number of Resources

The following table describes the overall resource usage in terms of CPUs and memory for the following:
  • OCNADD SUT
  • ATS

Table 3-4 OCNADD - Total Number of Resources

Resource Name CPU Memory (GB)
OCNADD SUT Totals 37 49
ATS Totals 10 14
Grand Total OCNADD ATS 47 63

OCNADD Pods Resource Requirements Details

This section describes the resource requirements, which are needed to deploy OCNADD ATS successfully.

Table 3-5 OCNADD Pods Resource Requirements Details

OCNADD Service CPUs Required per Pod Memory Required per Pod (GB) # Replicas (regular deployment) # Replicas (ATS deployment) CPUs Required - Total Memory Required - Total (GB)
ocnaddconfiguration 1 1 1 1 1 1
ocnaddalarm 1 1 1 1 1 1
ocnaddadmin 1 1 1 1 1 1
ocnaddhealthmonitoring 1 1 1 1 1 1
ocnaddbackendrouter 1 1 1 1 1 1
ocnaddscpaggregation 3 2 2 1 3 2
ocnaddnrfaggregation 3 2 1 1 3 2
ocnaddseppaggregation 3 2 1 1 3 2
ocnaddadapter 3 4 8 1 3 4
ocnaddkafka 5 10 3 3 15 30
zookeeper 1 1 3 3 3 3
ocnaddgui 2 1 1 1 2 1
OCNADD SUT Totals 37 CPU 49 GB

For more information about OCNADD Pods Resource Requirements, see the "Resource Requirements" section in Oracle Communications Network Analytics Data Director Installation, Upgrade, and Fault Recovery Guide.

ATS Resource Requirements details for OCNADD

This section describes the ATS resource requirements, which are needed to deploy OCNADD ATS successfully.

Table 3-6 ATS Resource Requirements Details

Microservice CPUs Required per Pod Memory Required per Pod (GB) # Replicas (regular deployment) # Replicas (ATS deployment) CPUs Required - Total Memory Required - Total (GB)
ATS Behave 2 1 1 1 2 1
OCNADD Producer Stub (SCP,NRF,SEPP) 6 12 1 1 6 12
OCNADD Consumer Stub 2 1 1 1 2 1
ATS Totals 10 14

3.2.2 Downloading the ATS Package

Locating and Downloading ATS Images

To locate and download the ATS Image from MOS:

  1. Log in to My Oracle Support using the appropriate credentials.
  2. Select the Patches & Updates tab.
  3. In the Patch Search window, click Product or Family (Advanced).
  4. Enter Oracle Communications Cloud Native Core - 5G in the Product field.
  5. Select Oracle Communications Network Analytics Data Director <release_number> from the Release drop-down.
  6. Click Search. The Patch Advanced Search Results list appears.
  7. Select the required ATS patch from the list. The Patch Details window appears.
  8. Click Download. The File Download window appears.
  9. Click the <p********_<release_number>_Tekelec>.zip file to download the OCNADD ATS package file.
  10. Untar the zip file to access all the ATS Images. The <p********_<release_number>_Tekelec>.zip directory has following files: 
    ocats-ocnadd-tools-pkg-23.1.0.tgz
ocats-ocnadd-tools-pkg-23.1.0-README.txt
ocats-ocnadd-tools-pkg-23.1.0.tgz.sha256
ocats-ocnadd-custom-configtemplates-23.1.0.zip
ocats-ocnadd-custom-configtemplates-23.1.0-README.txt
    The ocats-ocnadd-tools-pkg-23.1.0-README.txt file has all the information required for the package.The ocats-ocnadd-tools-pkg-23.1.0.tgz file has the following images and charts packaged as tar files:
    ocats-ocnadd-tools-pkg-23.1.0.tgz

|

|_ _ _ocats-ocnadd-pkg-23.1.0.tgz

|       |_ _ _ _ _ _ ocats-ocnadd-23.1.0.tgz (Helm Charts)

|       |_ _ _ _ _ _ ocats-ocnadd-image-23.1.0.tar (Docker Images)

|       |_ _ _ _ _ _ OCATS-ocnadd-Readme.txt

|       |_ _ _ _ _ _ ocats-ocnadd-23.1.0.tgz.sha256

|       |_ _ _ _ _ _ ocats-ocnadd-image-23.1.0.tar.sha256

|       |_ _ _ _ _ _ ocats-ocnadd-data-23.1.0.tgz (ATS test scripts and Jenkins data)

|       |_ _ _ _ _ _ ocats-ocnadd-data-23.1.0.tgz.sha256

|

|

|_ _ _ocstub-ocnadd-pkg-23.1.0.tgz

       |_ _ _ _ _ _ ocstub-ocnadd-23.1.0.tgz (Helm Charts)

       |_ _ _ _ _ _ ocstub-ocnadd-image-23.1.0.tar (Docker Images)

       |_ _ _ _ _ _ OCSTUB-ocnadd-Readme.txt

       |_ _ _ _ _ _ ocstub-ocnadd-23.1.0.tgz.sha256

       |_ _ _ _ _ _ ocstub-ocnadd-image-23.1.0.tar.sha256
    In addition to the above images and charts, there is an ocats-ocnadd-custom-configtemplates-23.1.0.tgz file in the package file. 
    ocats-ocnadd-custom-configtemplates-23.1.0.tgz

      |

      |_ _ _ocats-ocnadd-custom-values_23.1.0.yaml (Custom values file for installation)    
          
      |

      |_ _ _ocats_ocnadd_custom_serviceaccount_23.1.0.yaml (Template to create custom service account)
  11. Copy the tar file to the OCCNE, OCI, or Kubernetes cluster where you want to deploy ATS.

3.2.3 Pushing the Images to Customer Docker Registry

Preparing to deploy ATS and Stub Pod in Kubernetes Cluster

To deploy ATS and Stub Pod in Kubernetes Cluster:

  1. Run the following command to extract tar file content.

    tar -xvf ocats-ocnadd-tools-pkg-23.1.0.tgz

    The output of this command is:
    ocats-ocnadd-pkg-23.1.0.tgz
ocstub-ocnadd-pkg-23.1.0.tgz
ocats-ocnadd-custom-configtemplates-23.1.0.tgz
  2. Run the following command to extract the helm charts and docker images of ATS.

    tar -xvf ocats-ocnadd-pkg-23.1.0.tgz

    The output of this command is:
    ocats-ocnadd-23.1.0.tgz
ocats-ocnadd-23.1.0.tgz.sha256
ocats-ocnadd-data-23.1.0.tgz
ocats-ocnadd-data-23.1.0.tgz.sha256
ocats-ocnadd-image-23.1.0.tar
ocats-ocnadd-image-23.1.0.tar.sha256
OCATS-ocnadd-Readme.txt

    Note:

    The ocats-ocnadd-Readme.txt file has all the information required for the package.
  3. Run the following command to untar the ocstub package.

    tar -xvf ocstub-ocnadd-pkg-23.1.0.tgz

    The output of this command is:
    ocstub-ocnadd-image-23.1.0.tar
ocstub-ocnadd-23.1.0.tgz.sha256
ocstub-ocnadd-image-23.1.0.tar.sha256
ocstub-ocnadd-23.1.0.tgz
OCSTUB-ocnadd-Readme.txt
OCSTUB_OCNADD_Installation_Readme.txt
  4. Run the following command to extract the content of the custom configuration templates:

    tar -xvf ocats-ocnadd-custom-configtemplates-23.1.0.tgz

    The output of this command is:
    ocats-ocnadd-custom-values_23.1.0.yaml (Custom yaml file for deployment of OCATS-OCNADD)
ocats_ocnadd_custom_serviceaccount_23.1.0.yaml (Custom yaml file for service account creation to help the customer if required)
  5. Run the following commands in your cluster to load the ATS docker image, 'ocats-ocnadd-image-23.1.0.tar', and push it to your registry.
    $ docker load -i ocats-ocnadd-image-23.1.0.tar

$ docker tag docker.io/ocnaddats.repo/ocats-ocnadd:23.1.0 <local_registry>/ocnaddats.repo/ocats-ocnadd:23.1.0

$ docker push <local_registry>/ocnaddats.repo/ocats-ocnadd:23.1.0
  6. Run the following commands in your cluster to load the Stub docker images ocstub-ocnadd-image-23.1.0.tar and push it to your registry..
    $ docker load -i ocstub-ocnadd-image-23.1.0.tar

$ docker tag docker.io/simulator.repo/ocddconsumer:1.0.20 <local_registry>/simulator.repo/ocddconsumer:1.0.20
$ docker tag docker.io/simulator.repo/oraclenfproducer:1.0.14 <local_registry>/simulator.repo/oraclenfproducer:1.0.14
$ docker tag docker.io/utils.repo/jdk17-openssl:1.0.6 <local_registry>/utils.repo/jdk17-openssl:1.0.6

$ docker push <local_registry>/simulator.repo/ocddconsumer:1.0.20
$ docker push <local_registry>/simulator.repo/oraclenfproducer:1.0.14
$ docker push <local_registry>/utils.repo/jdk17-openssl:1.0.6
  7. Update the image name and tag in the ocats-ocnadd-custom-values.yaml and ocnaddsimulator/values.yaml files of simulator helm as required. For ocats-ocnadd-custom-values.yaml update the 'image.repository' with respective local_registry.

    For ocnaddsimulator/values.yaml update the 'repo.REPO_HOST_PORT' and 'initContainers.repo.REPO_HOST_PORT' with respective local_registry.

3.2.4 Configuring ATS

3.2.4.1 Enabling Static Port
  1. To enable static port:
    • In the ocats-ocnadd-custom-values.yaml file under service section, set the staticNodePortEnabled parameter value to 'true' and staticNodePort parameter value with valid nodePort.
      service:
  customExtension:
    labels: {}
    annotations: {}
  type: LoadBalancer
  port: "8080"
  staticNodePortEnabled: true
  staticNodePort: "32385"

    Note:

    ATS supports static port. By default, this feature is not available.

3.2.5 Deploying ATS and Stub in Kubernetes Cluster

Note:

  • It is important to ensure that all the three components; ATS, Stub and OCNADD are in the same namespace.
  • For the ATS use case, the minimum replica set of OCNADD Adapter deployment must be updated to 1

ATS and Stub support Helm deployment.

If the namespace does not exist, run the following command to create a namespace:
kubectl create namespace <namespace_name>

Note:

  • It is recommended to use the <release_name> as ocnadd-sim while installing stubs.
  • The ATS deployment with OCNADD does not support the Persistent Volume (PV) feature. Therefore, the default value of the deployment.PVEnabled parameter in ocats-ocnadd-custom-values.yaml must not be changed. By default, the parameter value is set to false.

Deploying ATS:

helm install -name <release_name> ocats-ocnadd-23.1.0.tgz --namespace <namespace_name> -f <values-yaml-file>
Example:

helm install -name ocats ocats-ocnadd-23.1.0.tgz --namespace ocnadd -f ocats-ocnadd-custom-values.yaml
Deploying Stubs:
helm install -name <release_name> <ocstub-ocnadd-chart> --namespace <namespace_name>

Note:

For more details about installing the stub, refer the OCSTUB_OCNADD_Installation_Readme.txt file.
Example:
helm install -name ocnadd-sim ocnaddsimulator --namespace ocnadd

3.2.6 Verifying ATS Deployment

Run the following command to verify ATS deployment.

helm status <release_name> -n <namespace>

Once ATS and Stub are deployed, run the following commands to check the pod and service deployment:

To check pod deployment:


kubectl get pod -n ocnadd

To check service deployment:

kubectl get service -n ocnadd