The following instruction lets you collect information about Deskzilla / JIRA Client performance (performance profile) and send it to ALM Works for analysis.
The instruction is written for Deskzilla for convenience; the same applies to JIRA Client.
- Download profiling agent and scripts: (bundle for windows, if Deskzilla won't run, please try alternative bundle for x64 Java), (for linux).
- Unpack that file into "bin" directory under Deskzilla installation directory (on Windows default is C:\Program Files\Deskzilla\bin).
- Quit Deskzilla if it is running. Please use Bug | Exit (Issue | Exit in JIRA Client); if you click the window button, the client may stay resident if you have enabled Tools | Use System Tray.
- Change your current directory to "bin" and start Deskzilla with deskzilla_profile.bat (deskzilla_profile.sh on Linux) - it should launch Deskzilla in verbose mode with profiling enabled.
About file permissions for the snapshots: on Windows, if you are collecting performance profile for "out of memory" problem, please start deskzilla_profile.bat from a command-line prompt that is run as Administrator. This is required because memory profile, unlike CPU profile, will be written to the directory where Deskzilla is installed, which usually requires Administrator privileges. To do that:
- Click on "Start" and type "cmd"
- Right-click on cmd.exe and select Run as Administrator
- In the command-line window, change current directory to where deskzilla_profile.bat is located: cd C:\Program Files (x86)\Deskzilla\bin
- Take a look at Help | About and record application's build number.
- Reproduce performance problems.
- Quit Deskzilla.
- Performance profile should be saved under "Snapshots" directory in your home directory (C:\Users\\_username_\Snapshots or C:\Documents and Settings\\_username_\Snapshots on Windows, ~/Snapshots on Unix).
- If you reproduced "Out of Memory" problems, a different type of snapshot should be saved in the current directory (C:\Program Files (x86)\Deskzilla\bin), where you have started Deskzilla from (see also the note about permissions above). The file should be named java_pidNNNNN.hprof
- Create a ZIP archive from the snapshots and send it to email@example.com. Please make sure you mention build number.
If ZIP archive is too large for e-mail (10MB or more), please contact firstname.lastname@example.org for FTP upload instructions.