# OneAgent installation has failed. Installer returned error code: 1

**URL:** <https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828>\
**Category:** Open Q&A\
**Tags:** installation, oneagent\
**Created:** [March 21, 2025, 9:36am UTC](https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828 "2025-03-21T09:36:36Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![vishnu\_kumar](https://avatars.discourse-cdn.com/v4/letter/v/df705f/32.png) [@vishnu\_kumar](https://community.dynatrace.com/u/vishnu_kumar)\
**Post date:** [March 21, 2025, 9:36am UTC](https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828/1 "2025-03-21T09:36:36Z")

</div>

Hi All,

Am getting this error when upgrading Oneagents of the 1.281 versions.

OneAgent installation has failed.  
Installer returned error code: 1 If the problem persists, please contact support&nbsp;.

There is no documentation on what this error means.  
We retried the upgrade post oneagent restart, still same error.

Has anyone faced this error?

---

<div class="post-metadata">

**Author:** ![Peter\_Youssef](https://dub1.discourse-cdn.com/dynatrace/user_avatar/community.dynatrace.com/peter_youssef/32/14668_2.png) [@Peter\_Youssef](https://community.dynatrace.com/u/Peter_Youssef)\
**Post date:** [March 21, 2025, 9:50am UTC](https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828/2 "2025-03-21T09:50:03Z")

</div>

Hi&nbsp;[@vishnu\_kumar](https://community.dynatrace.com/user/66503)

- You can try updating to the most stable version.
- Share the support archive with Dynatrace support team for further investigation and sooner resolution.
- Uninstall the current version, remove all related previous version files according to the OS&nbsp; [Linux](https://docs.dynatrace.com/docs/ingest-from/dynatrace-oneagent/installation-and-operation/linux/operation/uninstall-oneagent-on-linux) or&nbsp; &nbsp;[Win](https://docs.dynatrace.com/docs/ingest-from/dynatrace-oneagent/installation-and-operation/windows/operation/uninstall-oneagent-on-windows)

Check the related troubleshooting reference:

- [OneAgent troubleshooting — Dynatrace Docs](https://docs.dynatrace.com/docs/ingest-from/dynatrace-oneagent/oneagent-troubleshooting)

Hoping it helps.

BR,

Peter

---

<div class="post-metadata">

**Author:** ![Peter\_Youssef](https://dub1.discourse-cdn.com/dynatrace/user_avatar/community.dynatrace.com/peter_youssef/32/14668_2.png) [@Peter\_Youssef](https://community.dynatrace.com/u/Peter_Youssef)\
**Post date:** [March 21, 2025, 9:50am UTC](https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828/3 "2025-03-21T09:50:57Z")

</div>

Hello&nbsp;[@vishnu\_kumar](https://community.dynatrace.com/user/66503)

If it possible to share log sample for more details.

BR,

Peter

---

<div class="post-metadata">

**Author:** ![vishnu\_kumar](https://avatars.discourse-cdn.com/v4/letter/v/df705f/32.png) [@vishnu\_kumar](https://community.dynatrace.com/u/vishnu_kumar)\
**Post date:** [March 21, 2025, 12:12pm UTC](https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828/4 "2025-03-21T12:12:08Z")

</div>

Which log is required&nbsp;[@Peter\_Youssef](https://community.dynatrace.com/user/51369)&nbsp;?

---

<div class="post-metadata">

**Author:** ![Sajarra](https://avatars.discourse-cdn.com/v4/letter/s/e19adc/32.png) [@Sajarra](https://community.dynatrace.com/u/Sajarra)\
**Post date:** [March 21, 2025, 12:45pm UTC](https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828/5 "2025-03-21T12:45:27Z")

</div>

Hello Vishnu,

You can either collect the ‘OneAgent Diagnostics’ from GUI or from command mode.

GUI - Go to host settings and you can find it over there. Hope, your server is still communicating to Dynatrace.

Command Line -&nbsp;[OneAgent configuration via command-line interface — Dynatrace Docs](https://docs.dynatrace.com/docs/shortlink/oneagentctl#create-support-archive)

Once collected, please share the logs to Dynatrace support team for further investigation.

---

<div class="post-metadata">

**Author:** ![Peter\_Youssef](https://dub1.discourse-cdn.com/dynatrace/user_avatar/community.dynatrace.com/peter_youssef/32/14668_2.png) [@Peter\_Youssef](https://community.dynatrace.com/u/Peter_Youssef)\
**Post date:** [March 21, 2025, 6:23pm UTC](https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828/6 "2025-03-21T18:23:21Z")

</div>

Hi&nbsp;[@vishnu\_kumar](https://community.dynatrace.com/user/66503)

PFA resources:

 ![2025-03-21_22h20_25.png](https://global.discourse-cdn.com/dynatrace/original/3X/0/6/0677912dde2a470f0b9969a759fb8c51b4264785.png)

> **[OneAgent files and disk space requirements on Windows](https://docs.dynatrace.com/docs/ingest-from/dynatrace-oneagent/installation-and-operation/windows/installation/disk-space-requirements-for-oneagent-installation-and-update-on-windows)**
>
> Learn the OneAgent directory structure and disk space requirements for OneAgent installation on Windows.

BR,

Peter

---

<div class="post-metadata">

**Author:** ![Peter\_Youssef](https://dub1.discourse-cdn.com/dynatrace/user_avatar/community.dynatrace.com/peter_youssef/32/14668_2.png) [@Peter\_Youssef](https://community.dynatrace.com/u/Peter_Youssef)\
**Post date:** [March 21, 2025, 6:26pm UTC](https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828/7 "2025-03-21T18:26:28Z")

</div>

Hi&nbsp;[@vishnu\_kumar](https://community.dynatrace.com/user/66503)

You can also follow the provided approach by&nbsp;[@Sajarra](https://community.dynatrace.com/user/83648)&nbsp;as an alternative method for collecting logs either to download it locally, or share it with Dynatrace for further analysis.

KR,

Peter

---

<div class="post-metadata">

**Author:** ![vishnu\_kumar](https://avatars.discourse-cdn.com/v4/letter/v/df705f/32.png) [@vishnu\_kumar](https://community.dynatrace.com/u/vishnu_kumar)\
**Post date:** [April 11, 2025, 12:47pm UTC](https://community.dynatrace.com/t/oneagent-installation-has-failed-installer-returned-error-code-1/50828/8 "2025-04-11T12:47:40Z")

</div>

Thanks Everyone for the replies, I used “uninstall” script in the agent files and launched the update.

Worked like charm
