Skip to main content
Sumo Logic

How do I use the binary package to install a Collector on Windows or MacOS?

Use the binary package to install a Collector on MacOS or Windows only if you need to use a particular version of JRE. See Install a Collector on Linux for instructions on using the binary package to install a Collector on Linux.

Before you begin:

Prepare the binary file

  1. Untar the downloaded binary file inside your desired destination directory to create a sumocollector directory:

    tar -xvf SumoCollector_unix_XXX.tar.gz
     
  2. Move the platform-specific wrapper file to the sumocollector directory:

    mv tanuki/<Platform>/wrapper wrapper
     
  3. (MacOS only) Make the wrapper and collector files executable:

    chmod ug+x wrapper
    chmod ug+x collector

(Optional) Configure sources

The Collector Management API allows you to pass all Source settings in a JSON file, including Source name, metadata tags, and pointer to the files you want to collect. For instructions, see Using JSON to configure Sources.

Optionally, you can configure Source using the Sumo Logic Web Application after the Collector has been installed.

(Optional) Enable FIPS

On Collector version 19.253-3+ you can enable FIPS 140-2 compliant Java Cryptography Extension (JCE) to encrypt your data. Once enabled, the Collector version cannot be downgraded below version 19.253-3.

To enable, locate and run the script configureFipsMode.sh contained in Collector's installation directory under /script:

    $ sh ./script/configureFipsMode.sh

Create the user.properties file

The Collector uses the settings defined in user.properties to register and start up. Create the user.properties file under config directory and add the settings you want to specify for the installation.

This example user.properties configures basic settings for registration and start-up using access ID and key for authentication.

name = My Collector
accessid = <accessId>
accesskey = <accessKey>
wrapper.java.command = java

See user.properties for a full list of all the parameters that you can add to the file.

Start the Collector

Use either of the following commands to start the Collector.

Mac:
sudo ./collector start

Windows:
InstallCollector-NT.bat
startCollectorService.bat

To verify that the Collector is installed, go to Manage > Collection in the Web Application and verify that you can see the Collector.