Launcher Script
The tarball distributions of LogScale include a Launcher Script that can be used to configure and start LogScale when deployed within single node, cluster, and Docker configurations.
The launcher script is the recommended method for starting LogScale and provides methods for setting configuration, performance and monitoring settings.
Starting LogScale
The launcher script can be found in the tarball in the
bin
directory.
To start LogScale using the launcher script:
Download the tarball from the LogScale Repo. Files are located within version specific directories.
Extract the contents:
shell$
tar zxf server-1.137.0.tar.gz
Change to the extracted directory:
shell$
cd humio
Execute the launcher script,
humio-server-start.sh
, that is located in thebin
directory.shell$
./bin/humio-server-start.sh
The script sets some essential Java parameters and performance settings suitable for LogScale automatically, taking account of the CPU and memory configuration of the environment. These can be customized by setting environment variables. See Configuration for more information.
Configuration
The script is configured via environment variables. Setting a variable manually will disable the defaults set by the script. The following variables can be used to set the configuration and are set by the script:
General options
JAVA_HOME
— The path to the Java binary. If not set, the Java on thePATH
will be used.HUMIO_MEMORY_OPTS
— Heap space and other memory-related options. If not set, the launcher will attempt to calculate a reasonable default. Can be overwritten directly, or customized with the following variables:HUMIO_HEAP_SIZE_MB
— can be customized. It is used to configure the heap size for the JVM, i.e. it is used to set-Xmx
and-Xms
.HUMIO_MAX_DIRECT_MEMORY_SIZE_MB
— can be customized. It is used to configure the limit on off-heap memory for the JVM, i.e. it is used to set-XX:MaxDirectMemorySize
.Note
The memory settings are tunable. When tuning, the goal is to leave enough memory free for the OS, other processes and the page cache, while assigning as much memory to LogScale as possible. The launcher's default settings provide a decent starting point for tuning for most environments.
HUMIO_JVM_PERFORMANCE_OPTS
— Options related to the Java JIT compiler and other performance tuning. We do not recommend deviating from the defaults for this option.HUMIO_GC_OPTS
— Options for configuring the garbage collector.Deprecated:
HUMIO_JVM_ARGS
v1.148.0The variable existed for migration from older deployments where the launcher script was not available. The launcher script replaces the need for manually setting parameters in this variable, so the using this variable is no longer required. The Launcher Script is the recommended method for deployment, use of this variable is no longer required.
HUMIO_JVM_ARGS
— Setting this option will disable the launcher script defaults entirely, except the minimal required flags. If set, only the flags listed in this option will be used when booting LogScale. We do not recommend using this, it is available for users that want to replace all of the launcher script's recommendations.
Debugging/monitoring options
HUMIO_JMX_OPTS
— JMX configuration options, excluding the setting configuring the JMX portJMX_PORT
— The port to open for JMX access. Not set by default.HUMIO_OPTS
— Any settings that don't fit into the other variables. Blank by default.HUMIO_DEBUG
— If set, enables JVM debugging with default options. If not set (the default), debugging is disabled. Can be customized using the following variables:JAVA_DEBUG_PORT
— The port to open for debugger accessDEBUG_SUSPEND_FLAG
— y to suspend the JVM on boot until a debugger attaches, n to not suspend.JAVA_DEBUG_OPTS
— The flags used for enabling debugging.
HUMIO_JVM_LOG_OPTS
— Options for configuring JVM logging. Can be customized by with the following variables:JVM_LOG_DIR
— The directory to write JVM logs to. Defaults to the logs directory inside the LogScale directory.
DRY_RUN
— 'true' to skip launching LogScale. The script will instead print the command line it would have used for launching LogScale.
The configuration can be overridden by setting the corresponding environment variable before running the script. For example:
$ export JAVA_HOME=/opt/java
$ ./bin/humio-server-start.sh
Configuring available CPUs
To configure the number of CPUs available to LogScale, use the
HUMIO_OPTS
to configure the JVM directly:
$ export HUMIO_OPTS="-XX:ActiveProcessorCount=96"
$ ./bin/humio-server-start.sh
You should change the CPU count in the HUMIO_OPTS
configuration only if you need to override the autodetected number of
CPUs. Otherwise, leave this variable setting as it is.
Migrating Docker Deployments
LogScale Docker distributions automatically use the launcher script.
It is recommended that HUMIO_JVM_ARGS
is only used
while migrating from an older container version. The launcher script
variables should be used to take advantage of the launcher script
configuration.