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 deployer-tech-support.sh is included with the Fabric Services System, provided you deployed the system using the standard deployer virtual machine (VM). You execute the script from the installer (deployer) VM. For details about the deployer 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 is useful if an error arises during installation of the Fabric Services System. Execute the deployer-tech-support.sh script from the deployer VM.
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.
Enter the following sample commands from the deployer node:
bash deployer-tech-support.sh minimal
bash deployer-tech-support.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 deployer-tech-support.sh encrypt Mon-Jul-26-18-08-31-IST- 2021.tar.gz
This command 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.