Agent Rollout via EXE

Die aktuelle Installationsdatei im EXE-Format kann unter folgender URL heruntergeladen werden:

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

Alternativ gibt es dieses Setupfile auch in einer ZIP-Datei:

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

Installationsparameter

Folgende Parameter können dem Setup mitgegeben werden und kommen in dieser Anleitung vor:

• /KEY - Lizenzschlüssel für Agenten (aus unserer Plattform go.lywand.com)

• /PROXY_URI - URI zur Angabe eines Proxy Servers (http://username:password@host:port)

• /skipNetworkTest - Überspringt optionale Überprüfungen, bei denen eine Internetverbindung notwenig ist

• /VERYSILENT - Deaktiviert die Grafische Oberfläche des Setup

• /SUPPRESSMSGBOXES - Deaktiviert die grafische Anzeige von Fehler/Pop-ups

• /forceInstall - Ermöglicht die Installation auf nicht unterstützten Betriebssystemen. Es gibt jedoch keine Garantie für die Funktionalität

Prinzipiell ist die Angabe dieser Parameter optional, mit Ausnahme des /KEY Parameters.

Konfigurationsdatei (config.ini)

Manche Installationsparameter können mithilfe einer Konfigurationsdatei angegeben werden. Dazu muss lediglich eine config.ini Datei im selben Ordner wie die lywand_setup.exe abgelegt werden.

Beispiel einer config.ini mit Lizenzschlüssel und ohne Proxy-URI:

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

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

Eine config.ini kann grundsätzlich in allen Varianten mit den /KEY, /PROXY_URI, /skipNetworkTest und /forceInstall Parametern verwendet werden.

Proxy: Die config.ini ersetzt nicht die Proxy-Einstellungen, welche beim Herunterladen des Setups via Skript potentiell notwenig sind.

Variante 1: Befehle für die Windows CMD und Powershell

Die bevorzugte Variante ist es, den Agent mithilfe eines vorhandenen Softwareverteilungstools auszurollen. Es steht ein EXE-Paket zur Verfügung, das mit den folgenden Parametern installiert werden kann:

CMD Befehl ohne Proxy

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

Powershell Befehl ohne Proxy

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

CMD Befehl mit Proxy

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

Powershell Befehl mit Proxy

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

Bitte beachten Sie, dass für den Rollout des Agents Administrationsberechtigungen auf dem Endgerät erforderlich sind, da der Agent als Systemdienst ausgeführt wird.

Variante 2: Powershell Skript

Folgendes Powershell-Skript kann als Hilfe herangezogen werden, um die Installation des Agenten über ein Softwareverteilungstool zu vereinfachen:

Skript ohne 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

Skript mit 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

Dabei ist zu beachten, dass der Agent einmalig heruntergeladen und auf einem eigenen Fileserver platziert werden muss. Das Powershell Skript sollte anschließend dementsprechend abgeändert werden. Beim finalen Befehl wird letztendlich der Lizenzschlüssel des jeweiligen Kunden als Parameter über das Softwareverteilungstool übergeben.