Upgrade Changes
This page lists only changes to the product that should be actioned during an upgrade.
Falcon LogScale 1.149.0 Preview (2024-07-30)
Installation and Deployment
The bundled JDK is upgraded to 22.0.2.
Falcon LogScale 1.143.0 Preview (2024-06-18)
Installation and Deployment
The minimum version of Java compatible with LogScale is now 21. Docker users, and users installing the release artifacts that bundle the JDK, are not affected.
It is recommended to switch to the release artifacts that bundle a JDK, because LogScale no longer supports bringing your own JDK as of release 1.138, see Falcon LogScale 1.138.0 Preview (2024-05-14)
Falcon LogScale 1.142.3 Stable (2024-08-23)
Installation and Deployment
The bundled JDK is upgraded to 22.0.2.
Falcon LogScale 1.142.1 Stable (2024-07-03)
Installation and Deployment
The Kafka client has been upgraded to 3.7.0. The Kafka server version in the deprecated humio/kafka Docker image is also upgraded to 3.7.0.
Other
Bundled JDK upgraded to 22.0.1.
Falcon LogScale 1.141.0 Preview (2024-06-04)
Other
Bundled JDK upgraded to 22.0.1.
Falcon LogScale 1.138.0 Preview (2024-05-14)
Installation and Deployment
The Kafka client has been upgraded to 3.7.0. The Kafka server version in the deprecated humio/kafka Docker image is also upgraded to 3.7.0.
Falcon LogScale 1.136.1 Stable (2024-05-29)
Storage
Docker images have been upgraded to Java 22.
Added new deployment artifacts. The published tarballs (e.g.
server.tar.gz
) are now available with a bundled JDK. The platforms currently supported are linux_x64 for 64-bit Linux, and alpine_x64 for 64-bit Alpine Linux and other musl-based Linuxes. The Docker images have been updated to use this bundled JDK internally. We encourage users to migrate to using the tarballs with bundled JDKs.
Falcon LogScale 1.135.0 Preview (2024-04-23)
Storage
Docker images have been upgraded to Java 22.
Added new deployment artifacts. The published tarballs (e.g.
server.tar.gz
) are now available with a bundled JDK. The platforms currently supported are linux_x64 for 64-bit Linux, and alpine_x64 for 64-bit Alpine Linux and other musl-based Linuxes. The Docker images have been updated to use this bundled JDK internally. We encourage users to migrate to using the tarballs with bundled JDKs.
Falcon LogScale 1.124.1 Stable (2024-02-29)
Other
Kafka client library has been upgraded to 3.6.1. Some minor changes have been made to serializers used by LogScale to reduce memory copying.
Falcon LogScale 1.120.0 Preview (2024-01-09)
Other
Kafka client library has been upgraded to 3.6.1. Some minor changes have been made to serializers used by LogScale to reduce memory copying.
Falcon LogScale 1.118.2 Stable (2024-01-17)
Configuration
We've migrated from Akka dependency component to Apache Pekko. This means that all internal logs referencing Akka will be substituted with the Pekko counterpart. Users will need to update any triggers or dashboards that rely on such logs.
On Prem only: be aware that the Akka to Pekko migration also affects configuration field names in
application.conf
. Clusters that are using a customapplication.conf
will need to update their configuration to use the Pekko configuration names instead of the Akka configuration names.
Falcon LogScale 1.116.0 Preview (2023-11-28)
Configuration
We've migrated from Akka dependency component to Apache Pekko. This means that all internal logs referencing Akka will be substituted with the Pekko counterpart. Users will need to update any triggers or dashboards that rely on such logs.
On Prem only: be aware that the Akka to Pekko migration also affects configuration field names in
application.conf
. Clusters that are using a customapplication.conf
will need to update their configuration to use the Pekko configuration names instead of the Akka configuration names.
Falcon LogScale 1.112.1 Stable (2023-11-15)
Security
xmlsec has been upgraded to 2.3.4 to address CVE-2023-44483 issue.
Configuration
Docker containers have been upgraded to Java 21.
Falcon LogScale 1.112.0 Preview (2023-10-24)
Upgrades
This release introduces a change to the internal storage format use for sharing globsl data. Once upgraded to v1.112 or higher it will not be possible to downgrade to a version lower than 1.112.
Falcon LogScale 1.109.0 Preview (2023-09-26)
Configuration
Docker containers have been upgraded to Java 21.
Falcon LogScale 1.106.5 Stable (2023-11-15)
Security
xmlsec has been upgraded to 2.3.4 to address CVE-2023-44483 issue.
Falcon LogScale 1.100.2 Stable (2023-11-15)
Security
xmlsec has been upgraded to 2.3.4 to address CVE-2023-44483 issue.
Falcon LogScale 1.100.0 Stable (2023-08-16)
Installation and Deployment
Permit running LogScale on Java 20. Docker containers have been upgraded to be based on Java 20.
Other
The Kafka client has been upgraded to 3.4.1. The Kafka broker has been upgraded to 3.4.1 in the Kafka container.
Falcon LogScale 1.96.0 Preview (2023-06-27)
Other
The Kafka client has been upgraded to 3.4.1. The Kafka broker has been upgraded to 3.4.1 in the Kafka container.
Falcon LogScale 1.95.0 Preview (2023-06-20)
Installation and Deployment
Permit running LogScale on Java 20. Docker containers have been upgraded to be based on Java 20.
Falcon LogScale 1.94.2 Stable (2023-11-15)
Security
xmlsec has been upgraded to 2.3.4 to address CVE-2023-44483 issue.
Falcon LogScale 1.88.0 Stable (2023-05-24)
Other
Docker images have been upgraded to Java 19.0.2. to address CVE-2022-45688 issue.
Snakeyamls has been upgraded to 2.0 to address CVE-2022-1471 issue.
Falcon LogScale 1.85.0 Preview (2023-04-13)
Other
Snakeyamls has been upgraded to 2.0 to address CVE-2022-1471 issue.
Falcon LogScale 1.81.0 Preview (2023-03-14)
Other
OpenSSL in Docker images has been upgraded to address CVE-2023-0286 issue.
Falcon LogScale 1.80.0 Preview (2023-03-07)
Other
Kafka client has been upgraded to 3.4.0.
Kafka broker has been upgraded to 3.4.0 in the Kafka container.
The container upgrade is performed for security reasons to resolve CVE-2022-36944 issue, which Kafka should however not be affected by. If you wish to do a rolling upgrade of your Kafka containers, please always refer to Kafka upgrade guide.
Falcon LogScale 1.76.2 Stable (2023-03-06)
Other
Kafka client has been upgraded to 3.4.0.
Kafka broker has been upgraded to 3.4.0 in the Kafka container.
The container upgrade is performed for security reasons to resolve CVE-2022-36944 issue, which Kafka should however not be affected by. If you wish to do a rolling upgrade of your Kafka containers, please always refer to Kafka upgrade guide.
Falcon LogScale 1.76.1 Stable (2023-02-27)
Other
Java upgraded to 17.0.6 in Docker containers
Kafka upgraded to 3.3.2 for KAFKA-14379
Kafka client upgraded to 3.3.2
Kafka Docker container upgraded to 3.3.2
Packages
Optimizations in package handling require migration of data during upgrade. This migration is performed automatically. Please notice:
While the upgrade of cluster nodes are ongoing, we recommend you do not install or update any packages, as they may end up in an inconsistent state.
If a package ends up in a bad state during migration, it can be fixed simply by reinstalling the package.
You will potentially experience that accessing the list of installed packages will fail, and creating new dashboards, alerts, parsers, etc. based on package templates will not work as intended.
This should only happen during the cluster upgrade, and should resolve itself once the cluster is fully upgraded.
If the cluster nodes are downgraded, any packages installed or updated while running the new version will not work, and we therefore recommend uninstalling or downgrading those packages prior to downgrading the cluster nodes.
Falcon LogScale 1.75.0 Preview (2023-01-31)
Other
Java upgraded to 17.0.6 in Docker containers
Kafka upgraded to 3.3.2 for KAFKA-14379
Kafka client upgraded to 3.3.2
Kafka Docker container upgraded to 3.3.2
Falcon LogScale 1.71.0 Preview (2023-01-03)
Packages
Optimizations in package handling require migration of data during upgrade. This migration is performed automatically. Please notice:
While the upgrade of cluster nodes are ongoing, we recommend you do not install or update any packages, as they may end up in an inconsistent state.
If a package ends up in a bad state during migration, it can be fixed simply by reinstalling the package.
You will potentially experience that accessing the list of installed packages will fail, and creating new dashboards, alerts, parsers, etc. based on package templates will not work as intended.
This should only happen during the cluster upgrade, and should resolve itself once the cluster is fully upgraded.
If the cluster nodes are downgraded, any packages installed or updated while running the new version will not work, and we therefore recommend uninstalling or downgrading those packages prior to downgrading the cluster nodes.
Falcon LogScale 1.70.2 Stable (2023-03-06)
Other
Kafka client has been upgraded to 3.4.0.
Kafka broker has been upgraded to 3.4.0 in the Kafka container.
The container upgrade is performed for security reasons to resolve CVE-2022-36944 issue, which Kafka should however not be affected by. If you wish to do a rolling upgrade of your Kafka containers, please always refer to Kafka upgrade guide.
Falcon LogScale 1.70.0 Stable (2023-01-16)
Installation and Deployment
We have enabled a new vhost selection method by default. The way hosts select their vhost number when joining the cluster has changed, the new logic is described at Node Identifiers documentation page.
The new logic does not depend on Zookeeper, even for clusters where nodes occasionally lose disk contents, such as Kubernetes. In order to smooth migration for clusters using Zookeeper, the new logic will still interact with Zookeeper to avoid nodes using a mix of new and old vhost code from fighting over the vhost numbers. This is only necessary while migrating.
The recommended steps for migrating off of Zookeeper are as follows:
Deploy the new LogScale version to all nodes.
Remove
ZOOKEEPER_URL_FOR_NODE_UUID
,ZOOKEEPER_URL
,ZOOKEEPER_PREFIX_FOR_NODE_UUID
,ZOOKEEPER_SESSIONTIMEOUT_FOR_NODE_UUID
from the configuration for all nodes.Reboot
Once rebooted, LogScale will no longer need Zookeeper directly, except as an indirect dependency of Kafka. Due to this, the 4 Zookeeper-related variables are deprecated as of this release and will be removed in a future version.
Since vhost numbers now change when a disk is wiped, cluster administrators for clusters using nodes where
USING_EPHEMERAL_DISKS
is set totrue
will need to ensure that the storage and digest partitioning tables are up to date as hosts join and leave the cluster. Updating the tables is handled automatically if using the Logscale Kubernetes operator, but for clusters that do not use this operator, cluster administrators should run scripts periodically to keep the storage and digest tables up to date. This is not a new requirement for ephemeral clusters, but we're providing a reminder here since it may be needed more frequently now.The cluster GraphQL query can provide updated tables (the
suggestedIngestPartitions
andsuggestedStoragePartitions
fields), which can then be applied via the updateIngestPartitionScheme and updateStoragePartitionScheme GraphQL mutations.Should you experience any issue in using this feature, you may opt out by setting
NEW_VHOST_SELECTION_ENABLED=false
. If you do this, please reach out to support with feedback, as we otherwise intend to remove the old vhost selection logic in the coming months.Note
When using Operator and Kubernetes deployments, you must upgrade to 0.17.0 of operator to support migration away from the Zookeeper requirement. See Operator Version 0.17.0.
Falcon LogScale 1.63.5 Stable (2023-03-06)
Other
Kafka client has been upgraded to 3.4.0.
Kafka broker has been upgraded to 3.4.0 in the Kafka container.
The container upgrade is performed for security reasons to resolve CVE-2022-36944 issue, which Kafka should however not be affected by. If you wish to do a rolling upgrade of your Kafka containers, please always refer to Kafka upgrade guide.
Upgrade Matrix
The table below shows the list of LogScale versions and the minimum version from which you can upgrade.
Target Version | Upgrade From |
---|---|
1.135.0-1.154.0 | 1.112 |
1.129.0-1.134.0 | 1.106 |
1.103.0-1.128.0 | 1.70.0 |
1.68.0-1.102.0 | 1.44.0 |
1.40.0-1.67.0 | 1.30.0 |
1.33.0-1.38.2 | 1.26.0 |
1.17.0-1.32.8 | 1.16.0 |
1.13.0-1.16.4 | 1.12.0 |
1.10.8-1.12.7 | 1.10.0 |
1.9.0-1.10.7 | 1.8.5 |
1.7.0-1.8.9 | 1.6.10 |
1.6.0-1.6.11 | 1.5.19 |
1.5.9-1.5.23 | 1.5.8 |
1.5.0-1.5.8 | 1.4.x |
1.4.0-1.4.9 | 1.3.2 |
1.3.1-1.3.2 | 1.3.0 |
1.2.0-1.3.0 | 1.2.0 |
1.0.6-1.1.37 | 1.1.0 |