How-To: Migrating from server.jar to Launcher Startup

LogScale's previous deployment and startup model required starting the server.jar directly with the required options. This model has been updated and there is now a launcher script, humio-server-start.sh that automatically configures reasonable defaults for memory, as a starting point for tuning for your specific environment.

Verifying if a migration is required:

In a LogScale/Humio terminal, open the service file: /etc/systemd/system/humio.service and see if your ExecStart section contains humio-server-start.sh.

If it exists, you can skip reading this KB article further.
If it contains server.jar, use the steps below to switch.
If you have deployed a multi node setup, follow the below steps in every single node.

Migration Guide

Find the version of LogScale that is running on the node and download the respective version in tarball format from the Maven repository
Extract the file under /opt/humio directory (the same directory where you have your current server.jar).
The name used for the package depends on the version:
- Up to 1.137.0, the file name used was server-1.181.0.tar.gz
- From 1.138.0, use either server-linux_x64-1.181.0.tar.gz (for glibc based Linux distributions) or server-alpine_x64-1.181.0.tar.gz (for musl libc distributions).
shell
```
$ cd /opt/humio/
$ wget https://repo.humio.com/repository/maven-releases/com/humio/server/1.181.0/server-1.181.0.tar.gz
$ tar xzf /opt/humio/server-1.181.0.tar.gz
```
Change the permission of this humio directory to the humio user and group.
shell
```
$ chown -R humio:humio /opt/humio/humio
```

Open /etc/systemd/system/humio.serviceand identify the following line

Current old value that uses server.jar to start

shell

ExecStart=/usr/bin/java -server \
     -XX:+UseParallelOldGC -Xms4G -Xmx32G
     -XX:MaxDirectMemorySize=8G -Xss2M \
     --add-exports java.base/jdk.internal.util=ALL-UNNAMED \
     -XX:CompileCommand=dontinline,com/humio/util/HotspotUtilsJ.dontInline \
     -Xlog:gc*,gc+jni=debug:file=/var/log/humio/gc_humio.log:time,tags:filecount=5,filesize=102400 \
     -Dhumio.auditlog.dir=/var/log/humio \
     -Dhumio.debuglog.dir=/var/log/humio -jar /opt/humio/server.jar

Note

The above may be on one line, or may be spread over multiple lines.

Replace it with the below line as detailed in Configuring LogScale as a Service

New value that uses startup script will look like this

shell

ExecStart=/opt/humio/humio/bin/humio-server-start.sh

If you have configured custom JVM flags in humio service, it is not necessary to set most of the old flags anymore. This is because the launcher script will figure out reasonable defaults for most of it. In order to check what flags the launcher script suggests for a given host environment, you may run the below command or add DRY_RUN=true as an environment variable as detailed in LogScale Launcher Script.
shell
```
$ DRY_RUN=true /opt/humio/humio/bin/humio-server-start.sh
```
However, you may add them explicitly in /etc/humio/server.conf. A few of the old flags should not be set by users, so they are not moved to this file.
ini
```
HUMIO_OPTS=-Dhumio.auditlog.dir=/var/log/humio -Dhumio.debuglog.dir=/var/log/humio
```
Important
Once you confirm that everything is working as expected, it is recommended to remove /opt/humio/server.jar and /opt/humio/server-1.181.0.jar to avoid any confusion in future as they are no longer necessary.

Knowledge Base