Skip to main content

user.properties

For collector versions 19.137 and later, the user.properties file lets you pass configuration parameters during the installation of a new unregistered Collector. Once the collector is registered, to see if a parameter can be changed with a collector restart, check the Can be changed after installation? column of the table in user.properties parameters below.

When using the shell script (command line) installer, you must pass configuration parameters via command-line arguments or a varfile, and the installer will create a user.properties file during installation. See Parameters for the Command Line Installer for more information.

note

Starting with collector 19.170+, the installation directory is secured to users belonging to the sumologic_collector group. Modifying user.properties may require sudo privileges. For more information, see Enhanced File System Security for Installed Collectors.

Creating user.properties

After downloading the collector binary package (e.g., tarball), create the user.properties file in a specific directory.

To create user.properties manually:

  1. Use a text editor (or any similar program) to create a new file.
  2. Add required parameters and any desired optional parameters listed in user.properties parameters below. Parameters are case sensitive.
  3. Save the file to CollectorInstallationDirectory/config/user.properties.
info

Be sure to save the user.properties file in UTF-8 format. If you use a script to create a user.properties file, note that some scripting utilities, such as PowerShell, default to ANSI—if you use such a tool, make sure that the file is saved in UTF-8 format.

Default Collector installation location

The default collector installation locations are:

Linux:

  • /opt/SumoCollector/
  • /usr/local/SumoCollector

Windows:

  • :\Program Files (x86)\Sumo Logic Collector
  • :\Program Files\Sumo Logic Collector

user.properties examples

The example below sets the Access ID and Access Key. When installing a binary package, you must specify the command to run the JRE, or the JRE path if it does not exist on your $PATH:

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

The example below sets the Access ID and Access Key, proxy settings, and a custom JRE.

name = My Collector
accessid = accessId
accesskey = accessKey
proxyHost = 10.0.0.8
proxyPort = 3128
wrapper.java.command = /opt/java_1.7/bin/java
wrapper.java.maxmemory = 2048

user.properties parameters

The following table lists all of the parameters available in the user.properties file.

note

Parameters are case sensitive.

ParameterDescriptionExamples
wrapper.java.command=JRE Bin LocationSets the JRE binary to use when starting the collector.Use the default system Java version:
wrapper.java.command=java
Use a specific JRE installation (Linux):
wrapper.java.command=/opt/java_1.7/bin/java
Use a specific JRE installation (Windows):
wrapper.java.command=C:\\Program Files (x86)\\Java\\jre7\\bin

Key-value parameters (key=value). Add as needed.

ParameterDescriptionCan be changed after installation?
accessid=accessIdSets Access ID used when logging in with Access ID and Key.No
accesskey=accessKeySets Access Key used when logging in with Access ID and Key.
Note that, as of Collector v19.182-17, accesskey is automatically removed from user.properties following successful installation. (This behavior can be disabled with the skipAccessKeyRemoval property, described below.)
If you configure a collector to be ephemeral, in the event that the collector is de-registered after 12 hours offline, you will need to re-add the accesskey to user.properties.
No
category=category
Available on Collector version 19.182+.
Source category to use when a source does not specify a category.No, use the Collector Management API to modify.
clobber=true/falseWhen true, if there is any existing collector with the same name, that collector will be deleted (clobbered). See Forcing a Collector's Name with Clobber for more information.No, use the Collector Management API to modify.
description=description
Available on Collector version 19.182+.
Description for the collector to appear in Sumo Logic.No, use the Collector Management API to modify.
disableActionSource=true/false
Deprecated on Collector version 19.245-4. Use enableActionSource instead.
If your organization's internal policies restrict the use of Script Actions, you can disable them by setting this parameter to true.Yes, with Collector restart.
disableScriptSource=true/false
Deprecated on Collector version 19.245-4. Use enableScriptSource instead.
If your organization's internal policies restrict the use of Script Sources, you can disable them by setting this parameter to true.Yes, with Collector restart
disableUpgrade=true/falseIf true, the collector rejects upgrade requests from Sumo.Yes, with Collector restart.
enableActionSource=true/false
Available on Collector version 19.245-4+.
Script Action Sources are disabled by default. You can enable them by setting this parameter to true.Yes, with Collector restart.
enableScriptSource=true/false
Available on Collector version 19.245-4+.
Script Sources are disabled by default. You can enable them by setting this parameter to true.Yes, with Collector restart.
ephemeral=true/falseWhen true, the collector will be deleted after 12 hours of inactivity. For more information, see Setting a Collector as Ephemeral.
Note that after the collector is de-registered after 12 hours of inactivity, you must update user.properties to add the accesskey property. As noted above, in the accesskey row, Sumo removes accesskey from user.properties when the Collector successfully registers with Sumo (unless that behavior has been disabled with the skipAccessKeyRemoval property, described below).
No, use the Collector Management API to modify.
fields=[list of fields]Comma-separated list of key=value fields (metadata) to apply to the Collector.
To assign an Ingest Budget to the Collector use the field _budget with the Field Value of the Ingest Budget to assign. For example, if you have a budget with a Field Value of Dev_20GB, you would add:
fields=_budget=Dev_20GB
No, use the Collector Management API to modify.
fipsJce=true/false
Available on Collector version 19.253-3+
Informs you if FIPS 140-2 compliant Java Cryptography Extension (JCE) is enabled. This option is only supported in specific deployments, ask your Sumo account representative for details.No, requires a new installation.
hostName=hostname
Available on Collector version 19.182+.
The host name of the machine on which the collector is running. The host name can be a maximum of 128 characters.No, use the Collector Management API to modify.
name=nameSets the name of collector used on Sumo Logic. The name can be a maximum of 128 characters.
If no name is provided and the hostname is unresolved the default name is Collector.
If you are installing a collector that would have the same name as an existing collector, the system automatically appends a 13-digit unix timestamp to the collector name.
No, use Edit the Collector or the Collector Management API to modify
proxyHost=hostSets proxy host when a proxy server is used.Yes, with Collector restart.
proxyNtlmDomain=NTLM domainSets proxy NTLM domain when a proxy server is used with NTLM authentication.Yes, with Collector restart.
proxyPassword=passwordSets proxy password when a proxy server is used with authentication.Yes, with Collector restart.
proxyPort=portSets proxy port when a proxy server is used.Yes, with Collector restart.
proxyUser=usernameSets proxy user when a proxy server is used with authentication.Yes, with Collector restart.
skipAccessKeyRemoval=true/falseIf true, it will skip the access key removal from the user.properties file.No
sources=absolute filepath or folderpathSpecifies a single UTF-8 encoded JSON file, or a folder containing UTF-8 encoded JSON files, that defines the Sources to configure upon Collector registration. The contents of the file or files are read upon Collector registration only, it is not synchronized with the Collector's configuration on an on-going basis.
The file must have a .json extension.
On Windows, the path value must be specified with double slashes, \, for example:
sources=c:\\sumo\\sources.json
No
syncSources=absolute filepath or folderpathSpecifies either a single UTF-8 encoded JSON file, or a folder containing UTF-8 encoded JSON files, that define the Sources to configure upon Collector registration. The Source definitions will be continuously monitored and synchronized with the Collector's configuration.
On Windows, the path value must be specified with double slashes, \.
The file must have a .json extension.
For more information, see Local Configuration File Management.
Yes, with Collector restart.
targetCPU=target
Available on Collector version 19.182+.
You can choose to set a CPU target to limit the amount of CPU processing a collector uses. The value must be expressed as a whole number percentage. For example:
targetCPU=20
The collector will adjust resources to attempt to limit the CPU usage to at most 20%. For more information, see Set the Collector CPU Usage Target.
No, use the Collector Management API to modify.
timeZone=timezone
Available on Collector version 19.182+.
The time zone to use when it is not extracted from the log timestamp. For example:
timeZone=America/Los_Angeles
For a list of possible values, refer to the "TZ" column in this Wikipedia article.
No, use the Collector Management API to modify.
token=tokenEither an Installation Token or Setup Wizard Token.
This is not the encoded Token+URL. It is the decoded token only. See how to decode the token.
No
url=collection endpointSets the collection endpoint URL used to register the Collector. For example, if your account is in the US2 deployment:
url=https://collectors.us2.sumologic.com
Yes, with Collector restart.

(Optional) JVM or wrapper configuration parameters

To set JVM or wrapper configuration parameters, collectors installed prior to version 19.137 must add the following line to wrapper.conf, located in the collector's config folder.

#include ./config/user.properties
info

Collector versions 19.253-26+ support wrapper configuration parameters with command line installations.

ParameterDescriptionCan be changed after installation?
wrapper.java.command=JRE Bin LocationSets the JRE binary to use when starting the collector. Examples:
Use the default system Java version:
wrapper.java.command=java
Use a specific JRE installation (Linux):
wrapper.java.command=/opt/java_1.7/bin/java
Use a specific JRE installation (Windows):
wrapper.java.command=C:\\Program Files (x86)\\Java\\jre7\\bin
Yes, with Collector restart.
wrapper.java.initmemory=sizeSets the initial java heap size, in MB.
Default: 64
Yes, with Collector restart.
wrapper.java.maxmemory=sizeSets the maximum java heap size, in MB.
Default: 128
Yes, with Collector restart.
Legal
Privacy Statement
Terms of Use

Copyright © 2023 by Sumo Logic, Inc.