• Path to your private specification repository
• Traefik name space

• imagepull-secret: If the private registry or repository is password protected, create this secret.
• tls-secret: If the traefik ingress is ssl-enabled, create this secret. For more information about creating tls-secret, see "Setting Up ASAP Cloud Native for Incoming Access."

1. Update the $OB_CNTK/charts/asap/values.yaml file with the following values:

   replicaCount: 1
   image:
     repository: obcn
     pullPolicy: IfNotPresent
     tag: "7.4.0.0"
   imagePullSecrets:
     - name: asap-imagepull
   obEnv:
     envid: ob96
     port: 7501
     host: obhost
     domain: ob
   persistence:
     enabled: true
   
   nameOverride: ""
   fullnameOverride: ""
   
   serviceAccount:
     # Specifies whether a service account should be created
     create: true
     # Annotations to add to the service account
     annotations: {}
     # The name of the service account to use.
     # If not set and create is true, a name is generated using the fullname template
     name: ""
   
   podAnnotations: {}
   
   
   podSecurityContext: {}
     # fsGroup: 2000
   
   securityContext: {}
     # capabilities:
     #   drop:
     #   - ALL
     # readOnlyRootFilesystem: true
     # runAsNonRoot: true
     # runAsUser: 1000
   servicechannel:
     name: channelport
     type: ClusterIP
     port: 7502
   
   service:
     name: adminport
     type: ClusterIP
     port: 7501
   
   ingress:
     type: TRAEFIK
     enabled: true
     sslIncoming: false
     adminsslhostname: adminobhostssl.asap.org
     adminhostname: adminobhost.asap.org
   
     secretName: project-instance-obcn-tls-cert
   
     hosts:
       - host: adminobhost.asap.org
         paths: []
     tls: []
     #  - secretName: chart-example-tls
     #    hosts:
     #      - chart-example.local
   
   resources: {}
   
   autoscaling:
     enabled: false
   
   nodeSelector: {}
   
   tolerations: []
   
   # To avoid co-locating two OB replicas/pods on the same node remove {} and 
   # uncomment below lines. Replace <OB-ENV-ID> with OB Env ID
   affinity: {}
   #  podAntiAffinity:
   #    requiredDuringSchedulingIgnoredDuringExecution:
   #      - labelSelector:
   #          matchExpressions:
   #            - key: "app"
   #              operator: In
   #              values:
   #              - obEnv.envid
   #        topologyKey: "kubernetes.io/hostname"
   

   Where:

   • replicaCount is the number of Order Balancer instances to be created.
   • repository is the repository name of the configured container registry.
   • tag is the version name that is used when you create a final Docker image from the container.
   • name is the name of the imagepull-secret if it is configured. For more information about imagepull-secret, see "Creating Secrets".
   • envid is the unique environment ID of the instance. This ID should include only the lower-case alphanumeric characters. For example, asapinstance1.
   • port is the port number of the WebLogic Server where Order Balancer is deployed.
   • host is the hostname of the docker container.
   • domain is the Order Balancer WebLogic domain name as configured in ob.properties while creating image.
   • servicechannel.port is the channel port when you create a channel in the WebLogic domain.
   • service.port is the admin port of the WebLogic Server.
   • type is the ingress controller type. This type can be TRAEFIK or GENERIC or OTHER.
   • enabled is the status of the ingress controller whether it is enabled or not. The value is true or false. By default, this is set to true.
   • sslIncoming is the status of the SSL/TLS configuration on incoming connections whether it is enabled or not. The configuration value is true or false. By default, this is set to false. If you want to set the value to true, create keys, certificate, and secret by following the instructions in the "Setting Up ASAP Cloud Native for Incoming Access" section.
   • adminsslhostname is the hostname of the https access.
   • adminhostname is the hostname of the http access.
   • secretName is the secret name of the certificate created for SSL/TLS. For more information about creating keys and secret name, see "Setting Up ASAP Cloud Native for Incoming Access."
   • podAntiAffinity can be uncommented to avoid co-locating two Order Balancer pods on the same node.
   • requiredDuringSchedulingIgnoredDuringExecution tells the Kubernetes Scheduler that it should never co-locate two Pods which have app label as envid in the domain defined by the topologyKey.
   • topologyKey kubernetes.io/hostname indicates that the domain is an individual node.

   Note:

   adminsslhostname and secretName are applicable only if sslIncoming is set to true.
2. Create PV and PVC for the Order Balancer instance. It is a mandatory step for Order Balancer instance. The pv path is used to store the wallet and logs of the ASAP instance added to the Order Balancer. The sample files are available in the ob_cntk.zip at $OB_CNTK/samples/nfs/ file.

   # This is pv.yaml
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: <project>-<obEnv.envid>-nfs-pv
     labels:
       type: local
   spec:
     storageClassName: wallet
     capacity:
       storage: 10Gi
     accessModes:    
       - ReadWriteMany  
   # Valid values are Retain, Delete or Recycle  
   persistentVolumeReclaimPolicy: Retain  
   # hostPath:      
     nfs:
       server: <server>
       path: <path>
   # This is pvc.yaml
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: <obEnv.envid>-pvc
     namespace: <project>
   spec:
     storageClassName: wallet
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 10Gi

   Where:

   • <project> is the namespace. In the above example, value is sr.
   • <obEnv.envid> is the environment ID provided in the $OB_CNTK/samples/charts/traefik/values.yaml file. In the above example, value is ob96.

   The below paths from both Order Balancer pods are mounted on to the PV path as:

   For wallet files: /u01/oracle/user_projects/domains/<domainName>/oracle_communications/asap to PV_mount_path/asap

   For log files of each Order Balancer pod: /u01/oracle/user_projects/domains/<domainName>/oracle_communications/logs to PV_mount_path/OB_pod_name/logs

   For example, /mnt/OB99-1/logs and /mnt/OB99-0/logs

3. Run the following command to create pv and pvc:

   Kubectl apply -f pv.yaml
   Kubectl apply -f pvc.yaml -n sr

4. Verify that whether pv and pvc are created successfully or not by running the following command:

   kubectl get pv
   kubectl get pvc -n sr

5. Run the following command to create the Order Balancer instance:

   $OB_CNTK/scripts/create-instance.sh -p sr -i quick

   The create-instance.sh script uses the Helm chart located in the charts/ob directory to deploy the Order Balancer docker image, service, and ingress controller for your instance. If the script fails, see "Troubleshooting Issues with the Scripts" before you make additional attempts.

6. Validate the important input details such as Image name and tag, specification files used (Values Applied), hostname, and port for ingress routing:

   $OB_CNTK/scripts/create-instance.sh -p sr -i quick
   
   Calling helm lint
   ==> Linting ../charts/ob
   [INFO] Chart.yaml: icon is recommended
    
   1 chart(s) linted, 0 chart(s) failed
   Project Namespace : sr
   Instance Fullname : sr-quick
   NAME              : sr-quick
   LB_PORT           : 30305
   LAST DEPLOYED     : Timestamp
   NAMESPACE         : sr
   STATUS            : deployed
   REVISION          : 1
   TEST SUITE        : n/a

   If PV/PVC is not configured before, the Pod will be in the pending state as shown below:

   Kubectl describe pod <pod-name> -n sr
   Events:
     Type     Reason            Age    From               Message
     ----     ------            ----   ----               -------
     Warning  FailedScheduling  2m31s  default-scheduler  persistentvolumeclaim "sr-pvc" not found
     Warning  FailedScheduling  2m31s  default-scheduler  persistentvolumeclaim "sr-pvc" not found

7. When the Pod state shows READY 1/1, your Order Balancer instance is up and running.

http://adminhostnonssl.asap.org:30305/console

https://adminhostssl.asap.org:30443/console

ip_address adminhostnonssl.asap.org

$OB_CNTK/scripts/delete-instance.sh -p sr -i quick

$OB_CNTK/scripts/create-instance.sh -p sr -i quick

1. Delete the instance:

   $OB_CNTK/scripts/delete-instance.sh -p sr -i quick

2. Delete the name space, which in turn deletes the Kubernetes name space and the secrets:

   $OB_CNTK/scripts/unregister-namespace.sh -p sr -d -t target

   Note:

   traefik is the name of the target for registration of the name space. The script uses TRAEFIK_NS to find this target. Do not provide the "traefik" target if you are not using Traefik.
3. Delete the Order Balancer database users.
4. Delete pv and pvc using the following commands:

   Kubectl delete pv <pv-name>
   Kubectl delete pvc <pvc-name> -n sr

$OB_CNTK/scripts/create-instance.sh -p sr -i quick