The Logstash plugin manager provides support for preparing offline plugin packs that you canuse to install Logstash plugins on systems that don’t have Internet access.
This procedure requires a staging machine running Logstash that has access to a public orprivate Rubygems server. The staging machine downloads and packages all the files and dependenciesrequired for offline installation.
An offline plugin pack is a compressed file that contains all the plugins your offline Logstash installation requires,along with the dependencies for those plugins.
To build an offline plugin pack:
Run the bin/logstash-plugin prepare-offline-pack
subcommand to package the plugins and dependencies:
bin/logstash-plugin prepare-offline-pack --output OUTPUT [PLUGINS] --overwrite
where:
OUTPUT
specifies the zip file where the compressed plugin pack will be written. The default file is/LOGSTASH_HOME/logstash-offline-plugins-7.0.1.zip
. If you are using 5.2.x and 5.3.0, this location should be a zip file whose contents will be overwritten.[PLUGINS]
specifies one or more plugins that you want to include in the pack.--overwrite
specifies if you want to override an existing file at the locationExamples:
bin/logstash-plugin prepare-offline-pack logstash-input-beats bin/logstash-plugin prepare-offline-pack logstash-filter-* bin/logstash-plugin prepare-offline-pack logstash-filter-* logstash-input-beats
Packages the Beats input plugin and any dependencies. |
|
Uses a wildcard to package all filter plugins and any dependencies. |
|
Packages all filter plugins, the Beats input plugin, and any dependencies. |
Downloading all dependencies for the specified plugins may take some time, depending on the plugins listed.
To install an offline plugin pack:
Run the bin/logstash-plugin install
subcommand and pass in the file URI ofthe offline plugin pack.
Windows example:
bin/logstash-plugin install file:///c:/path/to/logstash-offline-plugins-7.0.1.zip
Linux example:
bin/logstash-plugin install file:///path/to/logstash-offline-plugins-7.0.1.zip
This command expects a file URI, so make sure you use forward slashes andspecify the full path to the pack.
To update offline plugins, you update the plugins on the staging server and then use the same process that you followed tobuild and install the plugin pack:
bin/logstash-plugin update
subcommand to update the plugins. See Updating plugins.