Skip to content

Enabling Community debug in Kubernetes

The Sametime Community pod supports a variety of debug parameters as documented in Common debug parameters for Sametime Community Server article.

Note: In Sametime versions prior to version 12, the Community services debug was handled in the sametime.ini file.  Beginning with Sametime 12, the parameters used for Community debug are in defined in a ConfigMap in Kubernetes.

The changes in this task affect the following pods:

  • community

  • Change directories to where helm is located.;

  • Open the values.yaml file for editing.

    In theglobal section, add the following line:

    enableCommunityDebug: true
    

    Note: Confirm the indentation matches the other settings (two spaces).

    When finished, save and close the file.

  • Apply the changes.

    Upgrade the deployment by following the instructions in Applying configuration changes in Kubernetes or Openshift.

  • Run the following command to open the ConfigMap.

    kubectl edit cm sametime-community-logging
    
  • Press i to switch to edit mode.

  • Configure any custom debug parameters. If you know the parameter, configured with the following format.

    • The first characters are STI__DEBUG.

      Note: Enter two underscores to separate.

    • If your debug parameters belong in the [Debug] section of the sametime.ini originally, add two underscores and then your parameter, followed by a colon and its value in quotes. For example, if setting VP_LDAP_TRACE=1 at the [Debug] section of the sametime.ini file, then the configuration setting is:

      STI__DEBUG__VP_LDAP_TRACE: “1”
      

      Note: In the example, there are two underscores between STI and DEBUG and then two more underscores before the parameter.

      If your debug setting is a component level debug such as [Debug-StUsers], then the parameter must have the same beginning STI__DEBUG, followed by a single underscore and the component name, and then two underscores and the parameter. For example, if you are setting component level debug for VP_TRACE_ALL=1 for the [Debug-StUsers] component, then the configuration setting is like the following:

      STI__Debug_StUsers__VP_TRACE_ALL: "1"
      
  • Save and close the ConfigMap.

  • Restart the pods with the changes. Use the kubectl scale command to scale the pods to zero and then to one that have been changed. You must run the commands for each pod that the change affects.

    1. Run the following command to scale the pod to zero.

      Scale the pod to zero, where pod_deployment_name is the pod name.

      kubectl scale deploy pod\_deployment\_name --replicas=0
      
    2. Run the following command to scale the pod to one.

      kubectl scale deploy pod\_deployment\_name --replicas=1
      

Parent Topic: Troubleshooting Sametime on Kubernetes