Advanced configurations

Customize your Remote Upgrader for Linux Universal Forwarders installation

If you plan to customize your Remote Upgrader for Linux Universal Forwarders configurations, do so before you install. See Download and configure your Remote Upgrader app for more information.

To install the Remote Upgrader for Linux Universal Forwarders using the deployment server:

1. Unpack the Remote Upgrader for Linux Universal Forwarders build in the installation app: ./default/splunk-upgrader.tgz.
2. Create the local_config file under the Remote Upgrader for Linux Universal Forwarders ./config directory.
3. Repack local_config to the installation app.
4. For most configurations, updates take effect after your restart the Remote Upgrader for Linux Universal Forwarders.

Customize package delivery

The universal forwarder packages must be delivered to the Remote Upgrader for Linux Universal Forwarders /tmp/SPLUNK_UPGRADER_MONITORED_DIR directory.

The package type is discovered automatically during installation. You can provide different package types for different forwarder installations. For example, you can have different universal forwarders installed by RPM, DEB, and TGZ respectively. To upgrade them you can deliver all three packages to all the universal forwarders and the Remote Upgrader installs the correct one. Note the following:.

Use only one package for each package type. For example, if two RPM packages with different versions are delivered to the Remote Upgrader for Linux Universal Forwarders at one time, and the universal forwarder is installed with an RPM package, the Remote Upgrader for Linux Universal Forwarders cannot upgrade the universal forwarder cancels the universal forwarder upgrade.

Once the Remote Upgrader for Linux Universal Forwarders picks up one package, it validates the Splunk signature or checksum if you have configured them. The universal forwarder has three different packages on Linux and you can opt-in or opt-out the signature validation for each package type in the ./config/local_config file. If signature validation is enabled, any validation failure aborts the upgrade.

If the Remote Upgrader for Linux Universal Forwarders is upgrading itself, it can also validate the upgrader package signature.

Note: Starting with version 9.0, all UF releases are signed using an x509 signature.

Specify a universal forwarder when working with multiple universal forwarders

If you are using more than one universal forwarder, choose one of those forwarders and provide it as the path to SPLUNK_HOME to be upgraded in the local_config file. For example: SPLUNK_HOME=/opt/splunkforwarder

You may want to do this, for example, if you have multiple Splunk products installed on the same instance. Note that the Splunk Remote Upgrader for Linux must run as root. If not installed with --user root or --group root, the Remote Upgrader will not be able to upgrade multiple universal forwarders.