Distribuzione dell'agente tramite EXE

Il file di installazione attuale in formato EXE può essere scaricato dal seguente URL:

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

In alternativa, questo file di configurazione è disponibile anche in un file ZIP:

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

Parametri di installazione

Questi parametri possono essere aggiunti al setup e vengono menzionati in questa guida:

• /KEY - Chiave di licenza per agenti (dalla piattaforma go.lywand.com)

• /PROXY_URI - URI per specificare un server proxy (http://username:password@host:port)

• /skipNetworkTest - Salta controlli opzionali che richiedono la connessione a Internet

• /VERYSILENT - Disattiva l'interfaccia grafica del setup

• /SUPPRESSMSGBOXES - Disattiva la visualizzazione grafica degli errori/pop-up

• /forceInstall - Permette l'installazione su sistemi operativi non supportati. Ma non c'è alcuna garanzia che funzioni

In generale l'inserimento di questi parametri è opzionale, tranne per il parametro /KEY.

File di configurazione (config.ini)

Alcuni parametri di installazione possono essere specificati tramite un file di configurazione. Per farlo basta aggiungere un file config.ini nella stessa cartella di lywand_setup.exe.

Esempio di una config.ini con chiave di licenza e senza Proxy-URI:

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

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

Una config.ini può essere usata in tutte le varianti con i parametri /KEY, /PROXY_URI, /skipNetworkTest e /forceInstall.

Proxy: La config.ini non sostituisce le impostazioni proxy che potrebbero servire quando scarichi il setup tramite script.

Variante 1: Comandi per Windows CMD e Powershell

La variante preferita è quella di distribuire l’Agent usando uno strumento di distribuzione software già presente. C’è un pacchetto EXE a disposizione che può essere installato con i seguenti parametri:

Comando CMD senza proxy

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

Comando Powershell senza proxy

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

Comando CMD con proxy

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

Comando Powershell con proxy

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

Ricorda che per installare l'agente servono i permessi di amministratore sul dispositivo, perché l'agente gira come servizio di sistema.

Variante 2: Script Powershell

Puoi usare questo script Powershell per semplificare l’installazione dell’agente tramite uno strumento di distribuzione software:

Script senza 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 con 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

Tieni presente che l'agente deve essere scaricato una sola volta e posizionato su un file server dedicato. Lo script Powershell poi va modificato di conseguenza. Nel comando finale, la chiave di licenza del cliente viene infine passata come parametro tramite lo strumento di distribuzione del software.