> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/engines/troubleshoot-cortex-xsoar-engines/troubleshoot-engine-upgrades.md).

# Troubleshoot Engine Upgrades

During an upgrade, the upgrade file is sent to the engine server. A cron job running on the engine server checks if that file exists. The most common upgrade error is that the job is not running so the new installer does not run.

1. SSH to the machine.
2. Check the d1 service status on the engine server. It is possible that it stopped or doesn't exist.

   **`sudo systemctl status d1`**
3. Access the installer log on the engine server and review the error.

   **`sudo vi /tmp/demisto_install.log`**
4. Rerun the installer on the engine server using one of the following options. You can open a second window and run **`watch df -h`**. If the problem seems to be disk space, you should resolve the disk space issue and then rerun the installer.
   1. Option 1
      1. Download the installer from the user interface and copy it to the engine server.
      2. sudo chmod +x installer.sh
      3. sudo ./installer.sh -- -y
   2. Option 2
      1. Verify that `/usr/local/demisto/d1_upgrade.sh` exists.

         If the file exists, run the following on the engine server:

         **`sudo chmod +x /usr/local/demisto/d1_upgrade.sh`**

         **`sudo /usr/local/demisto/d1_upgrade.sh`**
      2. If **`d1_upgrade.sh`** does not exist, check if `/usr/local/demisto/archived_d1_upgrade.sh` exists and that it was created at the time of the attempted upgrade.

         If the file exists and was created at the time of the attempted upgrade, run the following on the engine server:

         **`sudo chmod +x /usr/local/demisto/archived_d1_upgrade.sh`**

         **`sudo /usr/local/demisto/archived_d1_upgrade.sh`**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/onboarding-in-cortex-xsoar/engines/troubleshoot-cortex-xsoar-engines/troubleshoot-engine-upgrades.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.