The technical support script

If the Fabric Services System application suffers a failure that you would like to report to Nokia technical support, you can use the technical support script that is bundled with the system to generate information about the Fabric Services System application status. You can then share this information with Nokia support teams to assist in troubleshooting the problem.

The technical support script is included with the Fabric Services System, provided you deployed the system using the standard deployer virtual machine (VM).

You can execute the script from the installer VM or from any Kubernetes (K8s) master node (that is, the compute node that is marked as master explicitly, or the first node in the input configuration file). For details about the installer VM and the nodes participating in the Fabric Services System cluster, see the Fabric Services System Software Installation Guide.

The script creates a file containing status information about the Fabric Services System microservices and CPU statistics that can be useful when troubleshooting issues.

How to run the technical support script

The technical support script can be found on the installer VM or any K8s master node, and is named one of the following:

  • on the installer VM: deployer-tech-support.sh

    Running the script on the installer VM is particularly useful if an error arises during installation of the Fabric Services System.

  • on the K8s master node: techsupport.sh

For the current release, the script supports the following options:

help
displays a list of supported option and their descriptions
minimal
generates a .tar file containing basic system status output.
complete
generates a .tar file containing comprehensive system status output.
db mongo
generates a folder containing a backup of the mongo database.
filter-criteria
provides a sub-string to select pod names (for example, entering "fss-da" causes the script to gather data only for those pods whose name includes "fss-da").
encryption
encrypts the file so that the information is secure until accessed by Nokia technical support using its key.

For example, when running the script from the k8s master node:

bash techsupport.sh minimal

bash techsupport.sh db mongo

The script also creates a folder named debug-dump, into which it places each of the files generated by the data collection process.

When the script is complete, it generates a .tar file in the debug-dump folder whose name is the current date and time. For example: Mon-Jul-26-18-08-31-IST-2021.tar.gz.

You can optionally encrypt the file so that only the Nokia technical support team can unlock it with their key. For example:

bash tech-support.sh encrypt Mon-Jul-26-18-08-31-IST- 2021.tar.gz

This generates a file named Mon-Jul-26-18-08-31-IST- 2021.tar.gz.enc, which you can then share with the Nokia support team.