In rare cases, users may experience a crash in the Wave Server application or Wave Desktop client. Typically, these are isolated incidents. However, if you are facing a recurring problem take these steps:
Step 1: Find your current crash dump files
Windows
For Wave Server
C:\Windows\System32\config\systemprofile\AppData\Local\*.dmp
For Wave Desktop Client (see below note of hidden folders)
C:\Users\%USERNAME%\AppData\Local\.*dmp
Note: The AppData folder is hidden in Windows, you will need to change the below setting to make this folder visible.
Note: Make sure that these dumps have the same version and build number as the software you are currently using. File names might contain words and phrases "Wisenet_WAVE.exe" or "mediaserver.exe".
Ubuntu
For Wave Server
- (GDB backtrace)
/root/*hanwha*.gdb-bt
or
/opt/hanwha/mediaserver/var/crash/*mediaserver*.gdb-bt - (System kernel dmp)
/opt/hanwha/mediaserver/bin/core
For Wave desktop client
/home/$USER/desktop_client*.gdb-bt
NOTE: Make sure that these dumps have the same version and build number as the Wisenet Wave you are currently using.
Step 2: Enable & produce full crash dump files
This step is optional. Skip it unless the Support Team directs you to complete this step.
Crash Dump files are automatically generated memory stack files that help our developers debug situations that may be causing crashes. Simple crash dumps are generated each time the Wave Desktop Client or Wave Server application crashes for any reason. However, to fully diagnose the cause of a crash, the developers need the full, more detailed crash dump files. Follow the steps below to enable and produce detailed crash dump files.
Windows
- Open the Windows registry editor (Open Windows Command Prompt > type in "regedit")
- Add a new string value (Edit > New) with the name createFullCrashDump and value true in the following locations:
-
For Wave Server
HKEY_LOCAL_MACHINE\SOFTWARE\Hanwha\Hanwha Media Server
-
For Wave Desktop Client
HKEY_CURRENT_USER\Software\Hanwha\Hanwha Wisenet WAVE Client
-
For Wave Server
- Restart both the Wave desktop client and Wave Server application.
- Reproduce the crash if possible by going through the original process that caused the crash a few times.
- Look for new crash dumps after reproducing the crash. Crash dump sizes should be in the hundreds of megabytes.
Ubuntu
- Launch Terminal in Ubuntu (Ctrl+Alt+T)
- Use a text editor (vi, vim or nano) to open the configuration file and add a new parameter called createFullCrashDump and set its value to true.
-
For Wave Server
/opt/hanwha/mediaserver/etc/mediaserver.conf
-
For Wave Desktop Client
/home/$USER/.config/'hanwha'/'Hanwha Wisenet WAVE Client.conf'
-
For Wave Server
- Save the file and close the text editor.
- Restart Wave desktop client and Wave Server.
- Reproduce the issue or crash.
- You shall be able to have a crash dump file in the folder presented in Step 1.
NOTE: The file size of the crash dump could be large. (i.e., several hundreds of MB.)
Step 3: Upload crash dumps & open a support ticket
- Upload the crash dumps to a file-sharing app (e.g. Google Drive, Dropbox, Sharefile).
- Submit a new support ticket and include the link to the uploaded crash dumps - and make sure we are able to access them!
- We recommend that you return the configuration back to normal after full memory dumps have been collected. Otherwise, full dumps might occupy a lot of storage space. Also, enabling createFullCrashDump will increase the load on the CPU and RAM.
What to do if the required dumps cannot be found on Windows
Sometimes the Wave desktop client may be unable to produce full crash dump files. In this case, additional configuration is required with the Windows Error Reporting Service enable and configure the feature (according to this post):
- Open Registry Editor and navigate to
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting\
- Right-click anywhere on the right pane and click New > Key. Type LocalDumps and press enter.
- Left-click it on the newly created LocalDumps on the left pane.
- Right-click anywhere on the right pane and click New > Expandable String Value. Type DumpFolder and press enter.
- Right-click DumpFolder > Modify. Enter any path into the Value data field (e.g. C:\dumps) and press OK.
- Right-click anywhere on the right pane and click New > DWORD. Type DumpCount and press enter.
- Right-click DumpCount > Modify. Enter the dumps count into the Value data field (we recommend typing number 2) and press OK.
- Right-click anywhere on the right pane and click New > DWORD. Type DumpType and press enter.
- Right-click DumpType > Modify. Enter the dumps type (we recommend typing number 2) into the Value data field and press OK.
- After the application has crashed, dumps will be generated in the DumpFolder. After at least 2 crashes upload 2 dump files to the file sharing service and share it with our support staff.
- Send us the generated dumps along with your software version information.
- Remove the registry changes from your system.