Skip to content
12 changes: 12 additions & 0 deletions blog-collector/2025-09-30-installed.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: JAVA Upgrade (Installed Collector)
hide_table_of_contents: true
image: https://assets-www.sumologic.com/company-logos/_800x418_crop_center-center_82_none/SumoLogic_Preview_600x600.jpg?mtime=1617040082
---

import useBaseUrl from '@docusaurus/useBaseUrl';

Sumo Logic has used Java 8 for Installed Collectors until now. Since Java 8 reached end of public updates in January 2019 and newer versions offer better performance and security, we are upgrading Installed Collectors to use Java 17.

If you're using a custom bundled JRE, ensure it's newer than Java 8. If not, upgrade to Java 17 or a more recent version.
[Learn more](/docs/send-data/collection/upgrade-collectors/#upgradecollectors-to-the-latest-build).
33 changes: 23 additions & 10 deletions docs/send-data/collection/upgrade-collectors.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ sidebar_label: Upgrade a Collector
description: When you upgrade a Collector, the upgrade file is automatically downloaded and executed from Sumo Logic. You can also download the latest Collector version and upgrade your installed Collector using operating system commands.
---

import useBaseUrl from '@docusaurus/useBaseUrl';

Deploying an upgrade to one or more collectors can be done through Sumo Logic. When you initiate a collector upgrade, the installed collector downloads the upgrade package directly from the Sumo Logic service. We recommend you follow our [best practices](#collector-upgrade-best-practices) when you upgrade your Collectors.

You can also downgrade a collector to a previous version, as described in this topic.
Expand Down Expand Up @@ -35,16 +37,27 @@ To install an upgrade on one or more collectors:

1. [**New UI**](/docs/get-started/sumo-logic-ui). In the Sumo Logic main menu select **Data Management**, and then under **Data Collection** select **Collection**. You can also click the **Go To...** menu at the top of the screen and select **Collection**. <br/>[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Collection > Collection**.
1. Click the **Upgrade Collectors** link.
1. Determine if you'd like to install the upgrade on individual collectors or on all collectors simultaneously. Then, choose one of the following:
* Click **Update** next to the name of a collector to install the upgrade just on that specific collector. This option can be used if a policy prevents you from upgrading every collector at the same time of day, or if you cannot deploy the upgrade all at once. Any collectors you choose not to upgrade will remain available in the upgrade dialog box so you can install the upgrade at a later time.
* If you can safely upgrade all collectors, click **Update All.**
:::note
We strongly advise you to validate collector upgrades on non-production hosts before upgrading production collectors.
:::

![Upgrade collectors](/img/collector/upgrade-collectors-1.png)

The upgrade process begins immediately after you click **Update** or **Update All**; the file is automatically downloaded and installed. You'll be notified when the upgrade has completed successfully.
1. Determine your collector's JRE version and then choose one of the following:
- **If your collector is already on the latest JRE version**:

For collectors running on the latest JRE version, you have two ways to proceed with the upgrade:
- **Upgrade individual collectors**. Click **Upgrade** next to the name of a collector to install the upgrade just on that specific collector. This option can be used if a policy prevents you from upgrading every collector at the same time of day, or if you cannot deploy the upgrade all at once. Any collectors you choose not to upgrade will remain available in the upgrade dialog box so you can install the upgrade at a later time.
- **Upgrade all collectors at once**. If you can safely upgrade all collectors, click **Upgrade All.**
:::note
We strongly advise you to validate collector upgrades on non-production hosts before upgrading production collectors.
:::
<img src={useBaseUrl('')} alt="icon" width="40"/>

- **If your collector is on the deprecated JRE version**:

This section lists all collectors currently using a deprecated JRE version. To proceed with upgrading these collectors, you must first update their JRE to the latest version. Once that is done, you'll be able to upgrade the collectors themselves.
JRE upgrade options:
- **Upgrade individual collectors**. Click **Upgrade** next to the collector's name to update its JRE to the latest version.
- **Upgrade all collectors at once**. If you can safely upgrade all collectors, click **Upgrade All.**

After the JRE is upgraded, the collectors will automatically move to the list of collectors running the latest JRE. From there, you can proceed to upgrade the collector itself.

The upgrade process begins immediately after you click **Upgrade** or **Upgrade All**; the file is automatically downloaded and installed. You'll be notified when the upgrade has completed successfully.

Collectors that are offline or that have already been upgraded aren't eligible for upgrade and won't be included in the list of available collectors in the upgrade collectors dialog box.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ This procedure is for Collector version 19.137 and later. If you have Collecto

Before you begin:

* Install the version of JRE you want to use. The binary installation process does not include JRE installation. Download the JRE here: https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.htm
* Install the version of JRE you want to use. The binary installation process does not include JRE installation. Download the JRE here: https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/what-is-corretto-17.html
* Download the binary file from either of these locations:

* Binary package
Expand Down
4 changes: 2 additions & 2 deletions docs/send-data/installed-collectors/linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,8 +148,8 @@ You can use the RPM or Debian package to install a Collector on a Linux 64-bit

### Using the binary package

1. Install the version of JRE you want to use from the following location. (The collector requires Java 8 or higher). The binary installation process does not include JRE installation. See the [downloads list](https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html).
1. Check the version of Java is 8 or higher:
1. Install the version of JRE you want to use from the following location. (The collector requires Java 17 or higher). The binary installation process does not include JRE installation. See the [downloads list](https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/what-is-corretto-17.html).
1. Check the version of Java is 17 or higher:
```bash
java -version
```
Expand Down