- Print
- PDF
Diagnostic interrupt
- Print
- PDF
Available in VPC
This document describes diagnostic interrupts on NAVER Cloud Platform that can collect memory dumps according to the OS settings. Diagnostic interrupts can be performed through the user CLI and API. The conditions for using the diagnostic interrupt are as follows:
- Server-related services using the Windows-based OS
- When you can use API and CLI of NAVER Cloud Platform from outside the server
Diagnostic interrupt is a function that forces a server to generate the blue screen of death (BSOD). Data may be lost, so take precautions when using the function.
- Bare Metal Server does not support the diagnostic interrupt function.
- Analysis of the generated memory dump is not supported.
- Linux-related OS is to be supported later.
Required situations
Diagnostic interrupts are required in the following situations:
- When a user application requires a memory dump analysis
- When other OS issues require analysis
Windows full memory dump presets
The default setting is "automatic memory dump," which makes it difficult to check the application memory because the full memory dump is missing. Therefore, you must enable dumping of a full memory in the event of a BSOD in Windows and set it for the page file.
Enabling a full memory dump should not have a significant impact on operating system performance, but it can be reverted if the issue is resolved. However, if you revert it, a full memory dump is not collected when a diagnostic interrupt (or BSOD) occurs.
Set Windows memory dump
The following describes how to enable a full memory dump when a BSOD occurs in Windows.
- Click
>
> System > Advanced system settings > [Advanced], in that order.
- Click to select the Automatically restart check box under System failure.
- Click [Settings] in Startup and Recovery and select Complete memory dump from the drop-down menu in Write debugging information.
- Click the [OK] button in the pop-up window.
- Click to select the Overwrite any existing file check box in the Write debugging information.
- Click the [OK] button.
Set paging file
The following describes how to set a paging file.
%SystemRoot%
partition is where the boot system files is located, and the paging file must exist on that partition. If Windows was installed by default, it will be C:.
Click
>
> System > Advanced system settings > [Advanced], in that order.
Click the [Settings] button for Performance, click the [Advanced] tab, and then click the [Change] button for Virtual memory.
Click to deselect the Automatically manage paging file size for all drives check box.
Click to select Custom size and set the paging file size to be under C:\, larger than RAM.
The following image shows an example setting with 8 GB of physical memory.
The size of the paging file must be at least 257 MB larger than the physical memory.
Amount of RAM on the server Recommended paging file size 4 GB 4353 MB or above 8 GB 8449 MB or above 16 GB 16,641 MB or above 32 GB 33,025 MB or above 64 GB 65,793 MB or above
Click the [Set] > [OK] buttons, in that order.
- Memory dumps are stored in C:\ Windows. There must be more capacity than the memory capacity in C:\ volume. Make sure there is enough free space. For servers with a large memory capacity, use the D:\ volume (additional disk) to edit the location of the dump file in step 2.
- For servers with a large memory capacity, memory dump collection may take longer.
Apply
The settings will not apply until Windows is rebooted. When the settings are applied, a BSOD is generated when a diagnostic interrupt occurs, at which point a dump of the entire memory is collected.
If you need technical assistance with Windows, see the following:
- Search and see the Knowledge Base
- Contact the Community
- If you are a Visual Studio subscriber (formerly MSDN subscription), you can get official support from MS in the following ways:
- Call center (080-986-1000)
- Contact the Subscriber portal
How to use the API/CLI
You can use diagnostic interrupts through API and CLI as follows:
- Check if you are in a required situation to run diagnostic interrupts.
- See the following guides and run API and CLI.
- Click the Services > Compute > Server menu in NAVER Cloud Platform's console and check the Configuring status of the server.
- Check the Restart status of the server.
- Try to access when the server status changes to Running.
- Running API and CLI will immediately cause a forced interrupt to the server.
- You can check the progress after the current interrupt occurrence through the [Managing server and changing server settings] > Server console screenshot function.
- When a diagnostic interrupt occurs, the [Force stop] button is activated if a normal reboot is not possible. For more information on the [Force stop] function, see Force stop and terminate.