IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Upgrading with the Persistent Queue Enablededit
The following applies only if you are upgrading Logstash and have the persistent queue enabled.
Drain the Persistent Queueedit
If you use the persistent queue, we strongly recommend that you drain or delete it before you upgrade.
To drain the queue:
-
In the logstash.yml file, set
queue.drain:true. - Restart Logstash for this setting to take effect.
- Shutdown Logstash (using CTRL+C or SIGTERM), and wait for the queue to empty.
When the queue is empty:
- Complete the upgrade.
- Restart Logstash.
We are working to resolve issues with data incompatibilities so that these steps won’t be required for future upgrades.