Skip to main content
Sumo Logic

Install a Collector on Linux

Follow the steps in this topic to install or uninstall a Collector on Linux. See Installed Collectors for information on other OSs.

System Requirements 

  • Linux, major distributions, 32-bit or 64-bit, Solaris x86, or any generic Unix capable of running Java 1.8
  • Single core, 512MB RAM
  • 8GB disk space

Download 

Download the Collector in either of the following ways:

  • In Sumo Logic select Manage Data > Collection > Collection (Manage > Collection in the classic UI). Click Add Collector, click Installed Collector, and then click the link for the Collector to begin the download.
  • Open a browser and enter the static URL for your pod. If you're not sure which pod you're using, check the login page (US2, EU, or AU appears in the URL for those pods; only US1 is not included in the URL). The download begins immediately. See Download a Collector from a Static URL for a list of the URLs for your Linux version and pod.

Install a Collector on Linux

Choose one of these methods to install the Collector:

After installing Collectors, you can configure sources by using the Web Application or by providing the Source settings in a JSON file. If you are using a JSON file, you must provide the file before starting the Collector.

Install using the UI installer 

Run the installer on your server with root or Administrator privileges. If you are not logged in as root or Administrator, you might be prompted to reauthenticate to your system when you start the UI Installer.

  1. Open the downloaded installer file.
  2. If prompted, enter the root or Administrator user name and password for the system.
  3. Open the wizard to show the Welcome page. Click Next.
  4. Accept the license agreement and click Next.
  5. Browse to select a location for the Collector or accept the default and click Next to install the Collector files on your machine.
  6. The Installer displays the summary of the default settings. If you want to change any of these, click Advanced UI Installer Settings and follow the instructions. Click Next.
  7. Choose an authentication method.
  • Setup Wizard Token: If Sumo Logic has provided you with a token for the UI Installer, click Next, enter the token, and click Next.
  • Access Key: If you have a Sumo Logic access ID and key, click Next, enter the access ID and key, and click Next.
  1. Click Finish to complete the setup.
  2. In Sumo Logic select Manage Data > Collection > Collection (Manage > Collection in the classic UI) and verify that you can see the Collector. Look for the name that is listed as Collector Name in the confirmation step of this procedure (the name can be customized under Advanced Settings). If a Collector with that name already exists, a suffix is appended to uniquely identify it. If you don’t see the Collector, check the Error Codes list to help troubleshoot.

Install using the command line installer

  1. Add execution permissions to the downloaded Collector file (.sh):
    chmod +x SumoCollector.sh
  2. Run the script with the parameters that you want to configure. See Parameters for the Command Line Installer for a description of the parameters.  By default the Collector will be installed in either /opt/SumoCollector or /usr/local/SumoCollector.

Examples 

Using access ID and access key

sudo ./SumoCollector.sh -q -Vsumo.accessid=<accessId> -Vsumo.accesskey=<accessKey>

Adding proxy settings

sudo ./SumoCollector.sh -q -Vsumo.accessid=<accessId> -Vsumo.accesskey=<accessKey>
-Vproxy.host=<proxyHost> -Vproxy.port=<proxyPort>

Including SyncSources and customized Collector Name

sudo ./SumoCollector.sh -q -Vsumo.accessid=<accessId> -Vsumo.accesskey=<accessKey>
-VsyncSources=<filepath> -Vcollector.name=<name>

Install using the RPM or Debian package

You can use the RPM or Debian package to install a Collector on a Linux 64-bit system.

  1. Install the Collector using the downloaded installation package.
    For the RPM package, use the command:
    sudo rpm -i SumoCollector-19.XXX-XX.x86_64.rpm
    For the Debian package, use the command:
    sudo dpkg -i SumoCollector-19.XXX-XX.x86_64.deb
    The RPM and Debian packages install the Collector in the /opt/SumoCollector directory.  By default, the Collector is installed as a system service, but not yet started.
  2. Configure the Collector user.properties file in the /opt/SumoCollector/config/user.properties directory. The Collector uses the settings defined in user.properties to register and start up. Add entries in the following format for registration and start-up using access ID and access key for authentication.

    Example user.properties file:

name = [My Collector]
accessid = [accessId]
accesskey = [accessKey]

See user.properties for a full list of all the supported parameters.

  1. (Optional) Set the Run As User for the Collector if you want the Collector to run as a user other than root. See this FAQ topic for details.
  2. Start the Collector using the following command.
    sudo service collector start

Install using the binary package

  1. Install the version of JRE you want to use from this location. The binary installation process does not include JRE installation.
http://www.oracle.com/technetwork/java/javase/downloads/index.html
  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/wrapper directory:mv /sumocollector/tanuki/<Platform>/wrapper /sumocollector/wrapper
  3. If your platform has a libwrapper.so file (Linux) or DLL file (Windows), move the library file to <Sumo Version>/bin/native/lib/.
    mv libwrapper.so <Sumo Version>/bin/native/lib/

The following example shows the result:

├── 19.115-21
│ ├── alerts
│ ├── bin
│ │ ├── collector
│ │ ├── jvm.options
│ │ ├── native
│ │ │ |── lib
| | | | └── libwrapper.so​
  1. Make the wrapper and collector files executable:
  2. chmod ug+x wrapper
    chmod ug+x collector
  3. Create the user.properties file 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.

  1. (Optional) Provide the JSON Source information. 

    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. If you are using a JSON file, you must provide the file before starting the Collector. See Using JSON to configure Sources.

    Alternatively, you can configure sources at any time by using the Web Application. See Sources.

  2. (Optional) Set the Run As User for the Collector if you want the Collector to run as a user other than root. See this FAQ topic for details.
  3. Install the Collector as a service.
    Use the following command to install the Collector as a service that is started when the machine starts.
    sudo ./collector install
  4. Start the Collector service.
    Use the following command to start the Collector service.
    sudo service collector start
  5. To verify that the Collector is installed, go to Manage Data > Collection > Collection in the Web Application and verify that you can see the Collector.

Uninstall the Collector

Uninstalling a Collector requires the following two steps:

  1. Uninstall the Collector from the Linux system using any of these methods:
  1. Remove the Collector from the Sumo Logic Web Application

Uninstall using the UI Installer

  1. On your system, in the Applications folder, find the folder Sumo Logic Collector.
  2. Double-click the file Sumo Logic Collector Uninstaller.
  3. If prompted, select your language and click OK.
  4. Enter the user name and password for the system.
  5. When the Sumo Logic Collector Uninstall wizard is displayed, click Next to remove the Collector.
  6. When the success message is displayed, click Finish.

Uninstall using the command line

  1. In a terminal prompt, change the directory to the Collector installation directory.  By default the Collector will be installed in either /opt/SumoCollector or /usr/local/SumoCollector.
cd /usr/local/SumoCollector
  1. Run the uninstall binary with the -q option. The -q option executes the command without presenting additional prompts.
sudo ./uninstall -q

Uninstall using the RPM/Debian packages

For the RPM package, use the command:

sudo rpm -e SumoCollector

For the Debian package, use the command:

sudo dpkg -r SumoCollector

Uninstall using the binary package

  1. Uninstall the Collector service.
sudo <Collector Installation Directory>/collector remove
  1. Remove the Collector installation directory.
sudo rm -rf <Collector Installation Directory>

Remove the Collector from the Web Application 

  1. In Sumo Logic select Manage Data > Collection > Collection (Manage > Collection in the classic UI).
  2. Find the Collector you want to remove, and click Delete.
  3. When the Confirm dialog displays, click OK.

A success message is displayed and the Collector is removed from the list.