PCF ATS Installation Procedure

The PCF ATS installation procedure covers two steps:

  1. Locating and downloading the ATS images.
  2. Deploying ATS images.
This includes installation of three UDR, one CHF, one NRF and one SMF stubs in ocats namespace and ATS in PCF's namespace. This means PCF and ATS are deployed in same namespace. The release of ATS supports in-cluster deployment of PCF and ATS with TLS disabled for PCF.

Note:

For PCF to discover UDR and CHF, the nrf-clientservice pod of PCF is restarted as part of each test case.

Locating and Downloading ATS Images

The steps to locate and download ATS Images are as follows:

  1. The ATS Images are available on the OHC server. To download the ATS Images from OHC:
    1. Go to the URL, https://docs.oracle.com
    2. Navigate to Industries > Communications > Cloud Native Core.
    3. Click the Automated Testing Suite (ATS) Images link to download the zip file.
    4. Unzip the Images folder to access all the ATS Images.
  2. The ocats-pcf directory has a following file:

    ocats-pcf-tools-1.0.0.0.0.tgz

  3. The ocats-pcf-tools-1.0.0.0.0.tgz file has following images and charts packaged as tar files:
    ocats-pcf-tools-1.0.0.0.0.tgz
    
          |
    
          |_ _ _ocats-pcf-pkg-1.0.0.0.0.tgz
    
          |        |_ _ _ _ _ _ ocats-pcf-1.0.0.tgz (Helm Charts)
    
          |        |_ _ _ _ _ _ ocats-pcf-images-1.0.0.tar (Docker Images)
    
          |
    
          |_ _ _ocstub-pkg-1.0.0.0.0.tgz
    
                   |_ _ _ _ _ _ ocstub-go-1.0.0.tgz(Helm Charts)
    
                   |_ _ _ _ _ _ ocstub-go-image-1.0.0.tar (Docker Images)
    
  4. The user can copy the tar file from here to their K8s cluster where, they want to deploy ATS.

Deploying ATS in K8s Cluster

The steps to deploy ATS in K8s Cluster are as follows:
  1. Execute the command given below to extract the tar file content.

    tar -xvf ocats-pcf-tools-1.0.0.0.0.tgz

    The output of this command is:

    ocats-pcf-pkg-1.0.0.0.0.tgz

    ocstub-pkg-1.0.0.0.0.tgz

  2. Go to the ocats-pcf-tools-1.0.0.0.0 folder and execute the command given below to extract the final helm charts and docker images of ATS.

    tar -xvf ocats-pcf-pkg-1.0.0.0.0.tgz

    The output of this command is:

    ocats-pcf-1.0.0.tgz

    ocats-pcf-image-1.0.0.tar

  3. Execute the command given below to load the ATS image in your cluster and then, push it to your registry.

    docker load --input ocats-pcf-image-1.0.0.tar

    docker tag registry-bastion-1:5000/ocats-pcf:1.0.0 <CUSTOMER_REPO>/ocats-pcf:1.0.0

    docker push <CUSTOMER_REPO>/ocats-pcf:1.0.0

  4. Execute the command given below to untar the helm charts, ocats-pcf-1.0.0.tgz

    tar -xvf ocats-pcf-1.0.0.tgz

  5. Execute the command given below to update the image name and tag in the ocats-pcf/values.yaml file as required.

    For this, you need to open the values.yaml file and update the values of image.repository and image.tag

  6. Execute the command given below to deploy ATS using the updated helm charts after performing step 5.

    helm install <chart_directory> --name <release_name> --namespace <namespace_name> -f <custom_values_filename>

    For example: helm install ocats-pcf --name ocats --namespace ocpcf -f ocats-pcf/values.yaml

  7. Execute the command given below to verify ATS deployment .
    helm status <release_name>

    Figure 3-4 Helm Status Image



  8. Execute the command given below to view ATS and PCF in same namespace.

    kubectl get po -n <ats-namespace>

    Figure 3-5 Sample Screen: ATS and PCF Deployed in Same Namespace

Deploying Stub Pod in K8s Cluster

Sample Screen: Stubs After Deployment

The steps to deploy Stub Pod in K8s cluster are as follows:

  1. Go to the ocats-pcf-tools-1.0.0.0.0 folder and execute the command given below to extract the ocstub tar file content.

    tar -xvf ocstub-pkg-1.0.0.0.0.tgz

    The output of this command is:

    ocstub-1.0.0.tgz

    ocstub-go-images-1.0.0.tar

  2. Execute the command given below to load the STUB image in your cluster and then, push it to your registry.

    docker load --input ocstub-go-image-1.0.0.tar

    docker tag registry-bastion-1:5000/ocstub-go:1.0.0 <CUSTOMER_REPO>/ocstub-go:1.0.0

    docker push <CUSTOMER_REPO>/ocstub-go:1.0.0

  3. Execute the command given below to untar the helm charts, ocstub-go-1.0.0.tgz.

    tar -xvf ocstub-go-1.0.0.tgz

  4. Execute the command given below to update the image name and tag in the ocstub/values.yaml file as required.

    Open the values.yaml file and update the image.repository and image.tag

  5. Execute the command given below to deploy Stub.

    helm install <chart_directory> --set service.name=<service_name> --name <release_name> --namespace <namespace_name> -f <custom_values_filename>

    For example:helm install ocstub-go --set service.name=udr1svc --name udr1svc --namespace ocats -f ocstub-go/values.yaml

  6. Similarly, execute the commands given below to install all the stubs.

    helm install ocstub-go --set service.name =udr2svc --name udr2svc --namespace ocats -f ocstub-go/values.yaml

    helm install ocstub-go --set service.name= udr3svc --name udr3svc --namespace ocats -f ocstub-go/values.yaml

    helm install ocstub-go --set service.name=nrf1svc --name nrf1svc --namespace ocats -f ocstub-go/values.yaml

    helm install ocstub-go --set service.name=chf1svc --name chf1svc --namespace ocats -f ocstub-go/values.yaml

    helm install ocstub-go --set service.name=smf1svc --name smf1svc --namespace ocats -f ocstub-go/values.yaml

  7. Execute the command given below to check the Stub deployment.

    helm status <release_name>

A sample screen showing stubs deployment is given below: