Enabling automatic dump capture from non-responsive Web Players
To capture diagnostic information from Spotfire Web Players that stop responding, set up the automatic dump capture.
Procedure
- On each computer that is running a node manager with the Spotfire Web Player service, download and install the Microsoft Debugging Tools for Windows (WinDbg). This toolkit is available from the following website: https://developer.microsoft.com/en-us/windows/hardware/windows-driver-kit.
- On the server computer, export the active configuration by using the export-config command. (For details on using the Spotfire command line, see Executing commands on the command line.)
-
Using the
set-config-prop command, set the
nodemanager.memorydump-after-failures
property to an integer greater than 0. This sets the interval after which the memory dump will occur.
The values continue to increase in the same way.Table 1. Values for the Web Player auto-dump feature Value Description -1 The Spotfire Web Player automatic dump feature is turned off. 1 The memory dump occurs one interval after the Spotfire Server determines that a service is unreachable. The server performs ten verification steps, so this would cause the dump to occur after 11 failures to communicate with the service. 2 The memory dump occurs two intervals after the Spotfire Server determines that a service is unreachable. This would cause the dump to occur after 12 failures to communicate with the service. Note: For a large system, you may want to set a high value because the process may be unresponsive for some time due to blocking garbage collection.Example:config set-config-prop --name nodemanager.memorydump-after-failures --value 5
- Import the configuration back into the database by using the import-config command.
-
Do the following on the server computer that you accessed in step 2 above:
- Export and open the Spotfire.Dxp.Worker.Web.config file for editing; for instructions, see Manually editing the service configuration files.
- In
Spotfire.Dxp.Worker.Web.config, locate the following section:
<errorReporting emailAddress="" maxMailLength="1000" includeDetailedErrorInformation="false" enabledMiniDumpCreationOnError="true" miniDumpPath="" miniDumpSizeLarge="false" dumpToolPath ="C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe" dumpToolFlagsSmall="-c ".dump /mhtpFidcu {0};q" -p {1}" dumpToolFlagsLarge="-c ".dump /ma {0};q" -p {1}"/>
- Set the
dumpToolPath
to match the location of the cdb.exe file that you installed in step 1. - (Optional) To configure flags, see the descriptions of the following settings in
Spotfire.Dxp.Worker.Web.config:
dumpToolFlagsSmall
,dumpToolFlagsLarge
, andminiDumpSizeLarge
. - Save the file and then import it back to the server by using the import-service-config command.
- Assign the updated configuration to the services by using the set-service-config command.
- Restart the server.
Results
Parent topic: Services monitoring