How to create a memory dump

Pyramid Support may request thread and heap dumps to investigate memory usage or performance issues. Follow the steps below to create these files.

1) Log in to the Pyramid server and open Task Manager. Select the Details tab, right-click a column heading, choose Select columns, and enable the "PID" and "Command line" columns.

2) Open Command Prompt as administrator and run the following two commands. Replace 10432 in both commands with the PID of the Pyramid Java process requested by Support. If Pyramid is installed in a different location, adjust the path to jcmd.exe.

Create a thread dump:

"C:\Program Files\Pyramid\java\bin\jcmd.exe" 10432 Thread.print > threadDump.txt

Create a heap dump:

"C:\Program Files\Pyramid\java\bin\jcmd.exe" 10432 GC.heap_dump C:\heapDump.hprof

The first command creates "threadDump.txt" in the directory from which the command was run. The second command creates "C:\heapDump.hprof". Ensure the Pyramid service account has permission to write to the heap dump location.

Collecting a heap dump may pause the affected service and generate a large file. Ensure sufficient free disk space before running the command, and wait for it to report successful completion. Use a different filename for each additional heap dump.

3) Place both files in a folder and compress them into a ZIP file. Include the server name, Pyramid service name, PID, and date and time of collection.

To identify the Pyramid service, look near the beginning of the "Command line" column for the -Dsvc= parameter, immediately after the Java executable path. Examples include:

• -Dsvc=fs = Pyramid File Server
• -Dsvc=agent = Pyramid Agent
• -Dsvc=te = Pyramid Task Engine
• -Dsvc=rte = Pyramid Runtime Engine
• -Dsvc=rtr = Pyramid Router Server
• -Dsvc=ww = Pyramid Web Server
• -Dsvc=ai = Augmented Analytics Server (AI / DS / ML)
• -Dsvc=nlp = Pyramid NLP (Natural Language Query)

Note the service name and its PID so that Support can identify which process each thread and heap dump belongs to.

Repeat these steps for each process requested by Support, using separate filenames or folders for each process. Send the ZIP files using the upload method provided by Pyramid Support.