Chapter 7. Using the Stream Control Transmission Protocol (SCTP) on a bare metal cluster

Procedure

1. Create a file named load-sctp-module.yaml that contains the following YAML definition:

   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     labels:
       machineconfiguration.openshift.io/role: worker
     name: load-sctp-module
   spec:
     config:
       ignition:
         version: 2.2.0
       storage:
         files:
           - contents:
               source: data:,
               verification: {}
             filesystem: root
             mode: 420
             path: /etc/modprobe.d/sctp-blacklist.conf
           - contents:
               source: data:text/plain;charset=utf-8,sctp
             filesystem: root
             mode: 420
             path: /etc/modules-load.d/sctp-load.conf

2. To create the MachineConfig object, enter the following command:

   $ oc create -f load-sctp-module.yaml

3. Optional: To watch the status of the nodes while the MachineConfig Operator applies the configuration change, enter the following command. When the status of a node transitions to Ready, the configuration update is applied.

   $ oc get nodes

Procedure

1. Create a pod starts an SCTP listener:

   1. Create a file named sctp-server.yaml that defines a pod with the following YAML:

      apiVersion: v1
      kind: Pod
      metadata:
        name: sctpserver
        labels:
          app: sctpserver
      spec:
        containers:
          - name: sctpserver
            image: registry.access.redhat.com/ubi8/ubi
            command: ["/bin/sh", "-c"]
            args:
              ["dnf install -y nc && sleep inf"]
            ports:
              - containerPort: 30102
                name: sctpserver
                protocol: SCTP

   2. Create the pod by entering the following command:

      $ oc create -f sctp-server.yaml

2. Create a service for the SCTP listener pod.

   1. Create a file named sctp-service.yaml that defines a service with the following YAML:

      apiVersion: v1
      kind: Service
      metadata:
        name: sctpservice
        labels:
          app: sctpserver
      spec:
        type: NodePort
        selector:
          app: sctpserver
        ports:
          - name: sctpserver
            protocol: SCTP
            port: 30102
            targetPort: 30102

   2. To create the service, enter the following command:

      $ oc create -f sctp-service.yaml

3. Create a pod for the SCTP client.

   1. Create a file named sctp-client.yaml with the following YAML:

      apiVersion: v1
      kind: Pod
      metadata:
        name: sctpclient
        labels:
          app: sctpclient
      spec:
        containers:
          - name: sctpclient
            image: registry.access.redhat.com/ubi8/ubi
            command: ["/bin/sh", "-c"]
            args:
              ["dnf install -y nc && sleep inf"]

   2. To create the Pod object, enter the following command:

      $ oc apply -f sctp-client.yaml

4. Run an SCTP listener on the server.

   1. To connect to the server pod, enter the following command:

      $ oc rsh sctpserver

   2. To start the SCTP listener, enter the following command:

      $ nc -l 30102 --sctp

5. Connect to the SCTP listener on the server.

   1. Open a new terminal window or tab in your terminal program.

   2. Obtain the IP address of the sctpservice service. Enter the following command:

      $ oc get services sctpservice -o go-template='{{.spec.clusterIP}}{{"\n"}}'

   3. To connect to the client pod, enter the following command:

      $ oc rsh sctpclient

   4. To start the SCTP client, enter the following command. Replace <cluster_IP> with the cluster IP address of the sctpservice service.

      # nc <cluster_IP> 30102 --sctp