All Products
Search

This Product

    Elastic Compute Service:Enable or disable kernel crash dump

    Document Center

    Elastic Compute Service:Enable or disable kernel crash dump

    Last Updated:Apr 27, 2026

    Enable or disable the kernel crash dump service on an ECS instance with Cloud Assistant to capture kernel errors and memory snapshots for crash analysis.

    Background

    When an ECS instance crashes, collect kernel error logs and memory snapshots from the crash dump service to identify the root cause.

    Enable or disable the kernel crash dump service

    Cloud Assistant provides plug-ins to enable and disable the kernel crash dump service.

    Warning

    Before enabling the kernel crash dump service, create snapshots for the instance to ensure data security.

    Linux instance

    In Linux instances, the kernel crash dump mechanism uses the kdump service. Use Cloud Assistant to enable or disable kdump:

    1. Log on to a Linux instance using Workbench.

    2. Enable kdump.

      acs-plugin-manager --exec --plugin ecs_dump_config --params --enable

      Expected output when the service is enabled:

      Important

      kdump takes effect after the instance restarts.

      [INFO] start enable kdump
[INFO] Detected kdump service installed in your system
[INFO] to enable  kdump service
[INFO] execute command: systemctl enable kdump-tools
Synchronizing state of kdump-tools.service with SysV service script with /usr/lib/systemd/systemd-sysv-install.
Executing: /usr/lib/systemd/systemd-sysv-install enable kdump-tools
Created symlink /etc/systemd/system/basic.target.wants/kdump-tools.service → /usr/lib/systemd/system/kdump-tools.service.
[INFO] execute command: systemctl start kdump-tools
[INFO] now kdump-tools service's status is: active
[INFO] kdump status is: current state   : ready to kdump
[INFO] successful enable kdump

    3. Check the kdump status.

      acs-plugin-manager --exec --plugin ecs_dump_config --params --status

      Expected output when kdump is enabled:

      [INFO] query kdump status
[INFO] Detected kdump service installed in your system
[INFO] now kdump-tools service's status is: active
[INFO] kdump status is: current state   : ready to kdump

    4. (Optional) Disable kdump.

      acs-plugin-manager --exec --plugin ecs_dump_config --params  --disable

      Expected output when kdump is disabled:

      [INFO] disable kdump
[INFO] Detected kdump service installed in your system
[INFO] execute command: systemctl stop kdump-tools
[INFO] execute command: systemctl disable kdump-tools
Synchronizing state of kdump-tools.service with SysV service script with /usr/lib/systemd/systemd-sysv-install.
Executing: /usr/lib/systemd/systemd-sysv-install disable kdump-tools
Removed "/etc/systemd/system/basic.target.wants/kdump-tools.service".
[INFO] disable kdump finished

    Windows Server instance

    1. Log on to a Windows instance using Workbench.

    2. Click the Start icon, enter Windows PowerShell in the search box, and press Enter.

    3. Go to the Cloud Assistant installation directory and list its contents.

      cd C:\ProgramData\aliyun\assist\ ; dir

      Based on the output, switch to the folder named after the Cloud Assistant version number, such as 2.1.3.857. Replace the folder name with the actual value.

      cd 2.1.3.857

    4. Enable kernel crash dump.

      .\acs-plugin-manager.exe --exec --plugin ecs_dump_config_win --params --enable

      Expected output when the service is enabled:

      Important

      kdump starts after the instance restarts.

      [03/19/2025 10:38:03] [info] Set crash dump success.

    5. Check the kernel crash dump status.

      .\acs-plugin-manager.exe --exec --plugin ecs_dump_config_win --params --status

      Expected output when the service is enabled:

      [03/19/2025 10:36:11] [info] Crash status is ON.

    6. (Optional) Disable kernel crash dump.

      .\acs-plugin-manager.exe --exec --plugin ecs_dump_config_win --params  --disable

      Expected output when the service is disabled:

      [03/19/2025 10:36:25] [info] Set crash dump success.

    References