Installing the Lineai Java Agent (Windows)

The agents send metadata to Lineai, they are installed on the servers upon which the applications or databases are running. The applications and databases to be scanned are specified in the agent configuration files.

Install a Certificate

Important

If you are using an internal Certificate Authority, ensure that the necessary root certificates are added to your system.

See Trusted Root Certification Authorities Certificate Store - Windows drivers.

If you are not using HTTPS skip to Download the Windows Java Agent.

Importing root/intermediate certificate to JDK

& 'C:\Program Files (x86)\Lineai\java\AdoptOpenJDK\bin\keytool.exe' -keystore "C:\Program Files (x86)\Lineai\java\AdoptOpenJDK\lib\security\cacerts" -storepass changeit-alias lineai -file path\to\yourCertificate.cer

Download the Windows Java Agent

Download the installer from your Lineai server package repository. In PowerShell:

Invoke-WebRequest -Uri "http://your_server/lineai/server/packages/lineai-java.msi" -OutFile "lineai-java.msi"

Alternatively, from Command Prompt or PowerShell:

curl.exe -O "http://your_server/lineai/server/packages/lineai-java.msi"

Replace your_server with your Lineai server hostname. You can also open that URL in a browser to download the file.

Run the Installer

1. Double-click the downloaded lineai-java.msi icon to begin installation.
2. Read and Accept the License Agreement and click Next.
3. Enter the your Lineai URL and click Next.
4. Optionally, enter a descriptive name for the agent.
5. Complete the installation.

Execute or Start the Agent

The LineaiJava Agent (Windows) can be executed through a Command-Line Interface (CLI) or started through the Graphical User Interface (GUI).

CLI

The Windows CLI is in C:\Program Files (x86)\Lineai\java\run_agent.bat.

Note

:::|:::note[Note] The agent must not be running for an interactive session to start.

The examples assume that java is Java 11.

A list of commands executed while in the shell is saved in a text file of the current working directory.

You may be required to start a cmd terminal as an Administrator.

Commands

cd "C:\Program Files (x86)\Lineai\java"
SET JAVA_HOME="%CD%\AdoptOpenJDK"
%JAVA_HOME%\bin\java -Dspring.profiles.active=interactive -jar "%CD%\cc-java-agent-main.jar"

Alternatively, the run_agent.bat script is used to run the agent interactively.

Commands

"C:\Program Files (x86)\Lineai\java\run_agent.bat"

GUI

Double-click the Java Agent CLI shortcut on the desktop or from the Start menu below Lineai.

The agent starts in interactive mode. See Executing Agents Interactively via the CLI.

Important

:::|:::caution[Important] If the application.yml file is not configured, the agent will not start.

Authorize the Agent

For security, agents must be authorized before they will send metadata to Lineai.

Obtain AGENT_UUID and AGENT_PASSWORD from your Lineai administrator, or set these environment variables before starting the agent. If credentials are not pre-provisioned, the agent may register with the server and await administrator approval before scans are accepted.

Next Steps To run a scan, see Binary Scanning via Command Line (Java).