Agent Rollout via EXE

The current installation file in EXE format can be downloaded from the following URL:

• https://agent.lywand.com/lywand-setup/latest/lywand_setup.exe

Alternatively, this setup file is also available in a ZIP file:

• https://agent.lywand.com/lywand-setup/latest/lywand_setup.exe.zip

Installation Parameters

The following parameters can be added to the setup and are used in these instructions:

• /KEY - License key for agents (from our platform go.lywand.com)

• /PROXY_URI - URI for specifying a proxy server (http://username:password@host:port)

• /skipNetworkTest - Skips optional checks that require an internet connection

• /VERYSILENT - Deactivates the graphical user interface of the setup

• /SUPPRESSMSGBOXES - Deactivates the graphical display of errors/pop-ups

• /forceInstall - Enables installation on unsupported operating systems. However, there is no guarantee of functionality

These parameters are optional, with the exception of the /KEY parameter.

Configuration File (config.ini)

Some installation parameters can be specified using a configuration file. To do this, a config.ini file simply needs to be stored in the same folder as the lywand_setup.exe.

Example of a config.ini with license key and without proxy URI:

[General]
KEY=YOUR_LYWAND_AGENT_LICENSE_KEY
skipNetworkTest=false
forceInstall=false

[Proxy]
; e.g. http://username:password@host:port
PROXY_URI=

A config.ini can generally be used in all variants of the /KEY, /PROXY_URI, /skipNetworkTest and /forceInstall parameters.

Proxy: The config.ini does not replace the proxy settings, which are potentially necessary when downloading the setup via script.

Option 1: Commands for the Windows CMD and Powershell

The preferred option is to roll out the agent using an existing software distribution tool. An EXE package is available that can be installed with the following parameters:

CMD Command without Proxy

start /wait lywand_setup.exe /VERYSILENT /SUPPRESSMSGBOXES /KEY=YOUR_LICENSE_KEY

Powershell Command without Proxy

Start-Process -FilePath "lywand_setup.exe" -ArgumentList "/KEY=YOUR_LICENSE_KEY /VERYSILENT /SUPPRESSMSGBOX"

CMD Command with Proxy

start /wait lywand_setup.exe /VERYSILENT /SUPPRESSMSGBOXES /KEY=YOUR_LICENSE_KEY /skipNetworkTest=true /PROXY_URI=http://USERNAME:PASSWORD@IP:PORT

Powershell Command with Proxy

Start-Process -FilePath "lywand_setup.exe" -ArgumentList "/KEY=YOUR_LICENSE_KEY /VERYSILENT /SUPPRESSMSGBOX /skipNetworkTest=true /PROXY_URI=http://USERNAME:PASSWORD@IP:PORT"

Please note that administration authorizations are required on the end device for the rollout of the agent, as the agent is executed as a system service.

Option 2: Powershell Script

The following Powershell script can be used as an aid to simplify the installation of the agent via a software distribution tool:

Script without Proxy

$key = ""
$lywandDirectory = "c:\lywand"
$lywandSetupUrl = "https://agent.lywand.com/lywand-setup/latest/lywand_setup.exe"

if (!(Test-Path -Path $lywandDirectory -PathType Container)) {
    New-Item -ItemType Directory -Path $lywandDirectory | Out-Null
}

if (!(Test-Path -Path "$lywandDirectory\lywand_setup.exe")) {
    $wc = New-Object System.Net.WebClient
    $wc.DownloadFile($lywandSetupUrl, "$lywandDirectory\lywand_setup.exe")
}

$lywandSetupParams = "/KEY=$key /VERYSILENT /SUPPRESSMSGBOX"
Start-Process -FilePath "$lywandDirectory\lywand_setup.exe" -ArgumentList $lywandSetupParams

Script with Proxy

$key = ""
$proxy_username = ""
$proxy_password = ""
$proxy_ip = ""
$proxy_port = ""
$lywandDirectory = "c:\lywand"
$lywandSetupUrl = "https://agent.lywand.com/lywand-setup/latest/lywand_setup.exe"

if (!(Test-Path -Path $lywandDirectory -PathType Container)) { 
    New-Item -ItemType Directory -Path $lywandDirectory | Out-Null 
}

if (!(Test-Path -Path "$lywandDirectory\lywand_setup.exe")) { 
    $wc = New-Object System.Net.WebClient 
    $WebProxy = New-Object System.Net.WebProxy("http://${proxy_ip}:${proxy_port}") 
    $Credentials = New-Object System.Net.NetworkCredential(${proxy_username}, ${proxy_password}) 
    $WebProxy.Credentials = $Credentials 
    $wc.Proxy = $WebProxy 
    $wc.DownloadFile($lywandSetupUrl, "$lywandDirectory\lywand_setup.exe") 
}

$lywandSetupParams = "/KEY=$key /VERYSILENT /SUPPRESSMSGBOX /skipNetworkTest=true /PROXY_URI=http://${proxy_username}:${proxy_password}@${proxy_ip}:${proxy_port}" 
Start-Process -FilePath "$lywandDirectory\lywand_setup.exe" -ArgumentList $lywandSetupParams

Please note that the agent must be downloaded once and placed on a separate file server. The Powershell script should then be modified accordingly. In the final command, the license key of the respective customer is ultimately transferred as a parameter via the software distribution tool.