Guida all'installazione dell'app Alteryx One dalla riga di comando
Il programma di installazione di Alteryx One supporta le opzioni della riga di comando che consentono di eseguire installazioni silent, deployment enterprise e distribuzioni automatiche del software. Questa guida fornisce informazioni dettagliate sulle opzioni disponibili, sulle considerazioni da tenere presenti durante il deployment e sui codici di uscita del programma di installazione.
Nota
Tutti i flag della riga di comando del programma di installazione rilevano la distinzione fra maiuscole e minuscole. In caso di flag non validi, errori di ortografia o combinazione scorretta di maiuscole e minuscole, tali comandi vengono ignorati senza generare alcun messaggio di errore.
Installazione predefinita (A livello di utente): se non vengono specificati flag della riga di comando, il programma di installazione esegue un'installazione A livello di utente nel percorso predefinito:
%LOCALAPPDATA%\Alteryx\AlteryxOneEsempio:
AlteryxOne-1.0.352-US-setup.exe/ALLUSERS: questo flag consente di installare l'app Alteryx One per tutti gli utenti del computer (installazione A livello di computer).Percorso di installazione predefinito:
C:\Program Files\Alteryx\AlteryxOneEsempio:
AlteryxOne-1.0.352-US-setup.exe /ALLUSERS
/S: questo flag consente di eseguire il programma di installazione in modalità Silent. Quando viene utilizzato, il programma di installazione viene eseguito in modalità non interattiva e accetta tutte le impostazioni predefinite, a meno che tale comportamento non venga modificato impostando ulteriori flag supportati. Esempi:AlteryxOne-1.0.352-US-setup.exe /SAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS
/NOAUTOLAUNCH: questo flag consente di impedire l'avvio automatico dell'app Alteryx One dopo l'installazione. Questa opzione è supportata solo per le installazioni silent (/S).Esempi:
AlteryxOne-1.0.352-US-setup.exe /S /NOAUTOLAUNCHAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH
/D=<path>: questo flag consente di specificare una directory di installazione personalizzata.Requisiti e limitazioni:
È supportato solo per le installazioni silent A livello di computer.
Supporta solo installazioni A livello di computer. Le installazione A livello di utente non supportano i percorsi personalizzati.
Il programma di installazione aggiunge automaticamente la sottocartella "AlteryxOne" al percorso specificato.
/D=C:\temp\Alteryxesegue l'installazione inC:\temp\Alteryx\AlteryxOne./D=C:\temp\AlteryxOneesegue l'installazione inC:\temp\AlteryxOne\AlteryxOne.Esempio:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\path\to\installLocationEsegue l'installazione in:
C:\InstallLocation\AlteryxOneEsempio con spazi:
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\Program Files\CustomLocationEsegue l'installazione in:
C:\Program Files\CustomLocation\AlteryxOne
Considerazioni importanti per il flag
/D=:Il parametro
/D=<path>deve essere l'ultimo argomento del comando. Qualsiasi testo inserito dopo/D=viene interpretato come parte del percorso di installazione, anziché come flag aggiuntivo del programma di installazione.Ad esempio, il comando:
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D=C:\temp\Alteryx /S /NOAUTOLAUNCHesegue l'installazione inC:\temp\Alteryx S NOAUTOLAUNCH.Per evitare percorsi di installazione imprevisti, inserisci sempre
/D=come ultimo argomento:AlteryxOne-1.0.359-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH /D=C:\temp\Alteryx.Il percorso specificato con
/D=non deve essere racchiuso fra virgolette. Se utilizzi le virgolette, il programma di installazione ignora il parametro/D=ed esegue l'installazione nel percorso predefinito per il tipo di installazione selezionato.Esempio:
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D="C:\temp\Alteryx"Risultato: il parametro
/D=viene ignorato e l'applicazione viene installata in:C:\Program Files\Alteryx\AlteryxOne
Nota
Per i flag non supportati o non combinati correttamente, non viene generato alcun messaggio di errore. A seconda del flag, il programma di installazione potrebbe ignorare l'opzione non supportata o interpretare il comando in modo diverso dal previsto. Per i percorsi di installazione personalizzati, assicurati sempre che /D= sia l'ultimo argomento. Inoltre, non racchiudere fra virgolette il percorso specificato con /D=.
Acquisizione dei codici di errore durante un'installazione silent di Alteryx One
Le installazioni silent restituiscono codici di uscita che gli Amministratori IT possono utilizzare per verificare l'esito dell'installazione.
Nel caso delle installazioni silent, questo vale sia per le installazioni A livello di utente, sia per quelle A livello di computer. Nel caso delle installazioni interattive, gli errori vengono indicati nelle finestra di dialogo dei messaggi visualizzati.
Opzione A: utilizzo del prompt dei comandi di Windows
Nel prompt dei comandi di Windows, utilizza start /wait per mantenere aperto il terminale fino alla fine del programma di installazione. Quindi, utilizza %ERRORLEVEL% per visualizzare il codice di uscita del programma di installazione.
Esempio: start /wait "" "AlteryxOne-1.0.359-US-setup.exe" /S /ALLUSERS echo Installer Exit Code: %ERRORLEVEL%
Opzione B: utilizzo di PowerShell
In PowerShell, utilizza Start-Process con i parametri -Wait e -PassThru per attendere la fine del programma di installazione e acquisire il codice di uscita.
Esempio:
$process = Start-Process -FilePath "AlteryxOne-1.0.359-US-setup.exe" ` -ArgumentList "/S", "/ALLUSERS" ` -Wait ` -PassThru
$exitCode = $process.ExitCode
Write-Host "Installer Exit Code: $exitCode"
if ($exitCode -ne 0) { throw "Installation failed with exit code $exitCode" }
Codici di uscita del programma di installazione di Alteryx One
Codice di uscita | Classificazione | Significato e causa | Azione necessaria |
|---|---|---|---|
0 | Operazione completata | L'installazione o la disinstallazione è stata completata correttamente. | Nessuno |
1 | Interruzione da parte dell'utente | L'installazione è stata annullata manualmente dall'utente, facendo clic su Annulla nell'interfaccia utente. | Riavvia l'installazione. |
2 | Esecuzione già in corso | Nel sistema è già in esecuzione un'altra istanza del programma di installazione di Alteryx One. | Chiudi tutte le altre istanze del programma di installazione, quindi riprova. |
3 | Architettura non corrispondente | Il sistema operativo è diverso da Windows a 64 bit. | Esegui l'installazione in un sistema operativo Windows a 64 bit supportato. |
4 | Conflitto di installazione | È stato rilevato un conflitto fra le modalità di installazione. Ad esempio, viene eseguita un'installazione A livello di computer in presenza di un'istanza A livello di utente o viceversa. | Disinstalla completamente il tipo di installazione in conflitto prima di continuare. |
5 | File bloccati o processi attivi | È attualmente attivo uno dei processi critici dell'applicazione, ovvero | Chiudi Alteryx One e arrestare il servizio di aggiornamento, quindi esegui nuovamente il programma di installazione. |
6 | Necessari privilegi superiori | La modalità di installazione richiede diritti amministrativi, mentre l'utente o la shell non dispone attualmente di privilegi elevati. In genere, questa situazione si presenta per le installazioni A livello di computer eseguite con il parametro | Avvia il prompt dei comandi, PowerShell o lo script di deployment con privilegi di Amministratore. |
Nota
Per i deployment silent che utilizzano /S, devi monitorare i codici di uscita 4, 5 e 6. Tali codici sono tipici degli scenari di errore del deployment automatico, come il push di un'installazione A livello di computer in presenza di un'istanza A livello di utente, o l'esecuzione del programma di installazione mentre è attivo Alteryx One.