Configurazione del rollout di massa dei Corporate Add-Ins

Perché il rollout di massa dei Corporate Add-Ins possa funzionare, l'amministratore di Add-In deve configurare un drive di Corporate Add-Ins e inserirvi gli Add-Ins interessati. L’Add-In Rollout Manager si occupa di rendere operativo il servizio Windows "Siemens Add-In Rollout Service" nei computer utente nei quali dovranno essere utilizzati i Corporate Add-Ins. L’Add-In Rollout Manager può avviare il servizio in un solo computer o in più computer contemporaneamente. Inoltre può arrestare il servizio in esecuzione in più computer e riavviarlo contemporaneamente.

Configurazione della directory di rete Corporate Add-Ins

Per configurare la directory di rete Corporate Add-Ins come amministratore di Add-In procedere nel seguente modo:

Creare una nuova cartella nella directory di rete desiderata.
Definire il nome della cartella "TIAP<versione>", dove "<versione>" è la versione di TIA Portal in cui verranno utilizzati gli Add-Ins. Ad esempio, per TIA Portal V21 il nome della cartella è "TIAP21".

Si noti che il servizio di rollout di massa di Windows prende in considerazione solo le directory che iniziano con "TIAP".
In questa cartella si possono salvare tutti gli Add-Ins che si vogliono distribuire all'interno della propria azienda. Il rollout di massa viene eseguito quando il servizio Windows viene avviato nei computer corrispondenti.

Opzione: configurazione del servizio Windows

Se la directory di rete Corporate Add-Ins è configurata in modo da essere accessibile a tutti, questa operazione di configurazione non è necessaria. In caso contrario si deve configurare il servizio Windows con l’account di un utente che può accedere in scrittura alla directory "C:\ProgramData\Siemens\Automation\Portal V<Numero di versione>\CorporateAddIns" e in lettura alla directory di rete.

Per configurare il servizio Windows di un utente come Add-In Rollout Manager, procedere nel seguente modo:

Avviare un prompt dei comandi di Windows (cmd) localmente sul computer dell'utente oppure sul proprio computer.
Se si accede localmente al computer dell'utente immettere il seguente comando:

sc.exe config "Siemens Add-In Rollout Service" obj= "domain\userid" password= "*****"

Sostituire il dominio, l'ID utente e la password con i valori corretti.
Se si esegue la configurazione in remoto immettere il seguente comando:

sc.exe \\[Hostname] config "Siemens Add-In Rollout Service" obj= "domain\userid" password= "*****"

Sostituire il nome dell'host, il dominio, l'ID utente e la password con i valori corretti.

Nota

Modifica della password

Se in seguito si desidera modificare la password dell'account utente configurato o se la password è scaduta e deve essere rinnovata, è innanzitutto necessario interrompere il servizio in tutti i computer che utilizzano l’account utente per l'accesso. Modificare quindi la password e riavviare il servizio in tutti i computer.

Avvio del servizio Windows in un computer utente

Per avviare il servizio Windows in un computer utente come Add-In Rollout Manager, procedere nel seguente modo:

Avviare un prompt dei comandi di Windows (cmd) localmente sul computer dell'utente oppure sul proprio computer.
Se si accede localmente al computer dell'utente immettere il seguente comando:

sc.exe start "Siemens Add-In Rollout Service" "\\[Corporate Add-Ins network directory]" "[Poll Time in minutes]"

Sostituire il percorso di rete e l'intervallo di tempo (Poll Time) con i valori corretti. L'intervallo è il tempo in cui viene effettuata la sincronizzazione tra la directory di rete Corporate Add-Ins e il computer dell'utente. Inserire un intervallo di tempo uguale o superiore a 5 minuti.
Se si esegue la configurazione in remoto immettere il seguente comando:

sc.exe \\[Hostname] start "Siemens Add-In Rollout Service" "\\[Corporate Add-Ins network directory]" "[Poll Time in minutes]"

Sostituire il nome dell'host, il percorso di rete e l'intervallo di tempo (Poll Time) con i valori corretti. L'intervallo è il tempo in cui viene effettuata la sincronizzazione tra la directory di rete Corporate Add-Ins e il computer dell'utente. Inserire un intervallo di tempo uguale o superiore a 5 minuti.

Il servizio è stato avviato sul computer dell'utente e inizia a sincronizzare gli Add-Ins del computer utente con gli Add-Ins contenuti nella directory di rete Corporate Add-Ins per l'intervallo di tempo specificato.

Avvio del servizio Windows in più computer utente contemporaneamente

Per avviare il servizio Windows contemporaneamente in più computer utente come Add-In Rollout Manager utilizzando uno script PowerShell, procedere nel seguente modo:

Copiare il seguente script di PowerShell in un editor di testo o in Windows PowerShell ISE.
Sostituire “<Hostnames text file path>” con il percorso di un file di testo che contiene i computer utente per cui si vuole avviare il servizio.
Sostituire "<Corporate Add-Ins network directory>" con il percorso della directory di rete in cui vengono gestiti i Corporate Add-Ins.
Se necessario modificare l'intervallo di tempo. Nell'esempio riportato di seguito è impostato a 5 minuti.
Se è necessario eseguire l’operazione opzionale sopra descritta per la configurazione del servizio Windows, sostituire "TestUser" e "TestPassword" con i dati utente corretti. In caso contrario, eliminare l'intera riga "Invoke-Command { sc.exe \\$name config "Siemens Add-In Rollout Service" obj= "domain\TestUser" password="TestPassword" }".
Eseguire lo script.

Esempio: Script PowerShell per l'avvio del servizio Windows in più computer contemporaneamente
$targetHostname = Get-Content -Path '<Hostnames text file path>' ; foreach ($name in $targetHostname) { $MassRollOutService = Get-Service -name "Siemens Add-In Rollout Service" -ComputerName $name; Invoke-Command { sc.exe \\$name config "Siemens Add-In Rollout Service" obj= "domain\TestUser" password="TestPassword" } $MassRollOutService.Start(@('<Corporate Add-Ins network directory>','[Poll Time in minutes]')) $MassRollOutService.WaitForStatus('Running', '00:00:30') if($MassRollOutService.status -eq "Running") { Write-Output "Service started running on" $name; } else { Write-Output "Service did not start on" $name; } }

Esempio: Script PowerShell per l'avvio del servizio Windows in più computer contemporaneamente

$targetHostname = Get-Content -Path '<Hostnames text file path>' ;
foreach ($name in $targetHostname)
{
$MassRollOutService = Get-Service -name "Siemens Add-In Rollout Service" -ComputerName $name;

Invoke-Command { sc.exe \\$name config "Siemens Add-In Rollout Service" obj= "domain\TestUser" password="TestPassword" }

$MassRollOutService.Start(@('<Corporate Add-Ins network directory>','[Poll Time in minutes]'))
$MassRollOutService.WaitForStatus('Running', '00:00:30')

if($MassRollOutService.status -eq "Running")
{
Write-Output "Service started running on" $name;
}
else
{
Write-Output "Service did not start on" $name;
}

}

Risoluzione dei problemi relativi all'avvio del servizio Windows

Se il servizio Windows è stato configurato con un account utente, è necessario che nel computer in cui verrà eseguito sia impostato il criterio locale "Accedi come servizio". Se il criterio locale è stato sovrascritto dal criterio di gruppo non è possibile avviare il servizio e viene scritta una voce nei file di protocollo in "C:\ProgramData\Siemens\Automation\AddInRollout". In questo caso, l’amministratore degli Add-In deve aggiornare i criteri di gruppo del dominio e reimpostare il diritto "Accedi come servizio" per gli utenti del servizio.

Arresto del servizio Windows in più computer utente contemporaneamente

Per arrestare il servizio Windows contemporaneamente in più computer utente come Add-In Rollout Manager utilizzando uno script PowerShell, procedere nel seguente modo:

Copiare il seguente script di PowerShell in un editor di testo o in Windows PowerShell ISE.
Sostituire “<Hostnames text file path>” con il percorso di un file di testo che contiene i computer utente per cui si vuole arrestare il servizio.
Eseguire lo script.

Esempio: Script PowerShell per l'arresto del servizio Windows in più computer contemporaneamente
$targetHostname = Get-Content -Path '<Hostnames text file path>' ; foreach ($name in $targetHostname) { $MassRollOutService = Get-Service -name "Siemens Add-In Rollout Service" -ComputerName $name; $MassRollOutService.Stop() $MassRollOutService.WaitForStatus('Stopped', '00:00:30') if($MassRollOutService.status -eq "Stopped") { Write-Output "Service successfully stopped on " $name; } else { Write-Output "Service did not stop on" $name; } }

Esempio: Script PowerShell per l'arresto del servizio Windows in più computer contemporaneamente

$targetHostname = Get-Content -Path '<Hostnames text file path>' ;
foreach ($name in $targetHostname)
{
$MassRollOutService = Get-Service -name "Siemens Add-In Rollout Service" -ComputerName $name;
$MassRollOutService.Stop()

$MassRollOutService.WaitForStatus('Stopped', '00:00:30')

if($MassRollOutService.status -eq "Stopped")
{
Write-Output "Service successfully stopped on " $name;
}
else
{
Write-Output "Service did not stop on" $name;
}
}

Riavvio del servizio Windows in più computer utente contemporaneamente

Per avviare il servizio Windows contemporaneamente in più computer utente come Add-In Rollout Manager, procedere nel seguente modo:

Copiare il seguente script di PowerShell in un editor di testo o in Windows PowerShell ISE.
Sostituire “<Hostnames text file path>“ con il percorso di un file di testo che contiene i computer utente per cui si vuole riavviare il servizio.
Eseguire lo script.

Esempio: Script PowerShell per il riavvio del servizio Windows in più computer
$targetHostname = Get-Content -Path '<Hostnames text file path>' ; foreach ($name in $targetHostname) { $MassRollOutService = Get-Service -name "Siemens Add-In Rollout Service" -ComputerName $name; $MassRollOutService.Stop() $MassRollOutService.Start() $MassRollOutService.WaitForStatus('Running', '00:00:30') if($MassRollOutService.status -eq "Running") { Write-Output "Service started running on" $name; } else { Write-Output "Service did not start on" $name; } }

Esempio: Script PowerShell per il riavvio del servizio Windows in più computer

$targetHostname = Get-Content -Path '<Hostnames text file path>' ;
foreach ($name in $targetHostname)
{
$MassRollOutService = Get-Service -name "Siemens Add-In Rollout Service" -ComputerName $name;
$MassRollOutService.Stop()
$MassRollOutService.Start()

$MassRollOutService.WaitForStatus('Running', '00:00:30')

if($MassRollOutService.status -eq "Running")
{
Write-Output "Service started running on" $name;
}
else
{
Write-Output "Service did not start on" $name;
}

}

Risultato

È stato configurato il rollout di massa dei Corporate Add-Ins. Se si verificano errori durante l'avvio del servizio Windows o la sincronizzazione, consultare i file di protocollo in "C:\ProgramData\Siemens\Automation\AddInRollout".

La seguente tabella indica i possibili errori durante l'avvio del servizio Windows "Siemens Add-In Rollout Service" con suggerimenti per la risoluzione dei problemi da parte dell'amministratore degli Add-In:

Stato attuale del servizio	Momento in cui si è verificato l'errore	Stato del servizio	Messaggio di errore registrate nel log	Risoluzione suggerita
Il servizio Windows è in esecuzione	Durante la sincronizzazione non è stato possibile eseguire la copia degli Add-Ins dalla directory di rete Corporate Add-Ins a causa di uno degli Add-Ins utilizzati.	In corso	Add-In : SampleAddIn.addin is currently being executed. Update of this Add-In will happen in the next scheduled sync.	Guida alla risoluzione dell'errore per l'amministratore degli Add-In: Se l'utente nota che questa eccezione si verifica nonostante l'Add-In non sia in uso, l'eccezione potrebbe essere causata dalla presenza di file ".inuse" dell'Add-In danneggiati. In questo caso l'amministratore può assicurarsi che nessun Add-Ins sia attivo e poi eliminare manualmente tutti i file '*.inuse' dalla cartella C:\ProgramData\Siemens\Automation\AddInRollout.
Il servizio Windows è in esecuzione	Durante la sincronizzazione il servizio è stato arrestato.	Arrestato	-	Nella cartella "Corporate Add-Ins" della task card Add-Ins di TIA Portal viene visualizzato un simbolo di mancata sincronizzazione. Riferire all'amministratore il problema di sincronizzazione.

Stato attuale del servizio

Momento in cui si è verificato l'errore

Stato del servizio

Messaggio di errore registrate nel log

Risoluzione suggerita

Il servizio Windows è in esecuzione

Durante la sincronizzazione non è stato possibile eseguire la copia degli Add-Ins dalla directory di rete Corporate Add-Ins a causa di uno degli Add-Ins utilizzati.

In corso

Add-In : SampleAddIn.addin is currently being executed. Update of this Add-In will happen in the next scheduled sync.

Guida alla risoluzione dell'errore per l'amministratore degli Add-In:

Se l'utente nota che questa eccezione si verifica nonostante l'Add-In non sia in uso, l'eccezione potrebbe essere causata dalla presenza di file ".inuse" dell'Add-In danneggiati.

In questo caso l'amministratore può assicurarsi che nessun Add-Ins sia attivo e poi eliminare manualmente tutti i file '*.inuse' dalla cartella C:\ProgramData\Siemens\Automation\AddInRollout.

Il servizio Windows è in esecuzione

Durante la sincronizzazione il servizio è stato arrestato.

Arrestato

Nella cartella "Corporate Add-Ins" della task card Add-Ins di TIA Portal viene visualizzato un simbolo di mancata sincronizzazione. Riferire all'amministratore il problema di sincronizzazione.

Vedere anche

Nozioni di base sul rollout di massa dei Corporate Add-In
Attivazione e disattivazione della finestra di dialogo per il rollout di massa

Configurazione del rollout di massa dei Corporate Add-Ins - TIA Portal

Introduzione al TIA Portal