Downloading The Java Agent

Downloading The Latest Version

Agent Files

There are two agent files

• Build Scanner - sl-build-scanner.jar

• Test Listener - sl-test-listener.jar

Download them from: https://agents.sealights.co/sealights-java/sealights-java-latest.zip

If you want to query the latest version you can do so with the following sample command: curl https://agents.sealights.co/sealights-java/sealights-java-version.txt

If you have a limitation accessing the endpoint agents.sealights.co and are limited to your specific servers DNS, then you can also get the agent from https://{company}.sealights.co/agents/sealights-java/sealights-java-latest.zip Replace {company} with your company dns prefix

Sample commands for download

Unix (Shell)

wget -nv https://agents.sealights.co/sealights-java/sealights-java-latest.zip
unzip -oq sealights-java-latest.zip

#curl tool can also be used
#curl -L "https://agents.sealights.co/sealights-java/sealights-java-latest.zip" --output sealights-java-latest.zip

Windows (Powershell 5+)

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
iwr https://agents.sealights.co/sealights-java/sealights-java-latest.zip  -OutFile sealights-java-latest.zip -ErrorAction Continue
if (Test-Path -Path sealights-java-latest.zip -PathType Leaf) {
  Expand-Archive .\sealights-java-latest.zip
}

Downloading the Specific Version Defined in Customer Settings

Existing Customers can also download agents using the API below, which requires the use of an Agent or API token from the customer's Sealights dashboard. For Customers that need to set a specific recommended agent version other than the default latest, the API will download the recommended agent that has been set on the dashboard.

In the following examples, replace $DOMAIN with your domain and $SL_TOKEN with your SeaLights agent token

wget -nv -O sealights-java-agents.zip --header "accept: application/json" --header "Authorization: Bearer $SL_TOKEN" https://$DOMAIN/api/v2/agents/sealights-java/recommended/download 
#curl tool can also be used
#curl -X GET "https://$DOMAIN/api/v2/agents/sealights-java/recommended/download" -H "accept: application/json" -H "Authorization: Bearer $SL_TOKEN" -L --output sealights-java-agents.zip

unzip -oq sealights-java-agents.zip

Downloading a single agent from a local repo

In certain cases where you want to download just a single agent, or even if you want to download both from a local repo, you can use the sealights API to get the recommended version and then download the file directly.

In the example below, replace $DOMAIN with your domain and $SL_TOKEN with your SeaLights agent token and the repo URL to your internal one. Currently, the lines below download the Java agents (scanner and listener) from Maven Central.

#!/bin/bash
AGENT_VERSION=$(curl -s -X GET "https://$DOMAIN/sl-api/v1/agent-apis/agents/types/sealights-java/default-version"  -H "accept: application/json" -H "Authorization: Bearer $SL_TOKEN" | jq -r .version)
# Loop over the two agent artifact names and download each
for artifact in sl-build-scanner sl-test-listener; do
    wget -O "${artifact}.jar" "https://oss.sonatype.org/service/local/repositories/releases/content/io/sealights/on-premise/agents/${artifact}/${AGENT_VERSION}/${artifact}-${AGENT_VERSION}.jar"
done
#curl tool can also be used
#curl -L -o "${artifact}.jar" "https://oss.sonatype.org/service/local/repositories/releases/content/io/sealights/on-premise/agents/${artifact}/${AGENT_VERSION}/${artifact}-${AGENT_VERSION}.jar"

Managing the recommended agent version

The agent version can be managed via the dashboard under the Settings > Cockpit & Onboarding > Agent Versions section below.

Please refer to the following troubleshooting page to manage/update agents versions deployed locally: Keeping Your Agent Updated.