Installare o aggiornare un Agente Robot on-premise

Scaricare il programma di installazione e avviare l'installazione

1. Scarica il pacchetto di installazione dell'Agente Robot (RobotsAgent19.exe) dalla home page della piattaforma:

   1. Accedi a Diligent One (www.diligentoneplatform.com).

   2. Nella sezione Audit e analisi di Launchpad, seleziona il riquadro Analytics per accedere ai download.

   3. Nel menu in alto, seleziona Agente Robot.

   4. Seleziona Scarica versione 19.

      Il pacchetto di installazione viene scaricato nel computer in uso. Se necessario, copia il pacchetto di installazione sul server in cui desideri installare l'Agente Robot.

2. Chiudi tutte le altre applicazioni Windows.

3. Fai doppio clic sul pacchetto di installazione.

4. Se viene visualizza una finestra di dialogo con un avviso di sicurezza, verifica le informazioni riportate, quindi seleziona Sì.

   Consiglio

   La finestra di dialogo dell'avviso di sicurezza potrebbe essere nascosta dietro una qualsiasi delle finestre aperte.

5. Seleziona la lingua che desideri utilizzare per l'installazione, quindi seleziona OK.

Estrarre i file di installazione

Nella pagina Percorso di estrazione dell'installazione, specifica la cartella in cui devono essere estratti i file di installazione, quindi seleziona Estrai.

Puoi selezionare Sfoglia per selezionare una cartella o accettare la posizione predefinita:

C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent19

I file di installazione vengono estratti nella cartella di destinazione specificata. Dopo l'estrazione dei file, il programma di installazione si avvia automaticamente.

Installare i prerequisiti, se necessario

Se ti viene proposto di installare i prerequisiti, seleziona Installa. Dopo aver installato i prerequisiti, il programma di installazione procede automaticamente.

Per un elenco dei prerequisiti, consulta Requisiti di sistema per Agente Robot on-premise.

Configurare le proprietà di installazione

1. Nella pagina di benvenuto, seleziona Avanti.

2. Nella pagina Contratto di licenza, seleziona Accetto i termini sopra indicati, quindi Avanti.

3. Nella pagina Selezione edizione di Agente Robot, seleziona l'edizione che desideri installare, quindi seleziona Avanti:

   • non Unicode

   • Unicode

   Attenzione

   Assicurarsi che l'edizione installata sia quella corretta per l'azienda. Per aprire le tabelle di Agente Robot in Analytics, le edizioni devono corrispondere.

   Se si sta configurando un cluster multi-agente, tutti gli agenti nel cluster devono avere la stessa edizione. Tutti non Unicode o tutti Unicode.

   Per maggiori informazioni, consultare Prodotti Unicode Diligent.

4. Nella pagina Abilita machine learning lascia selezionata l'opzione Abilita, a meno che tu non abbia un valido motivo per non installare il motore Python, quindi seleziona Avanti.

   Nota

   Se si sceglie di non installare il motore Python e in seguito si desidera utilizzarlo per eseguire comandi di apprendimento automatico, è necessario disinstallare e reinstallare l'Agente Robot.

5. Nella pagina Impostazioni dei servizi dell'Agente Robot, completa le seguenti impostazioni dell'account di servizio, quindi seleziona Avanti:

   • Numero di porta del Servizio di Dati RobotSpecifica una porta per il servizio dati, oppure utilizza il valore predefinito di 10000.

     È possibile specificare qualsiasi porta disponibile compresa tra 0 e 65536.

   • Account di servizio di Agente RobotSpecifica un account di dominio esistente per eseguire il servizio Agente Robot e fornisci la password.

     L'account deve essere un account di dominio, specificato nella forma Domain\service_account_name. L'account richiede l'autorizzazione per eseguire i servizi sul sistema operativo Windows Server, nonché l'accesso completo alla cartella dati specificata durante l'installazione. Per maggiori informazioni, consultare Sicurezza di Agente Robot on-premise.

     Nota

     Se necessario, è possibile modificare l'account del servizio di Agente Robot dopo l'installazione.

6. Se ti viene richiesto di concedere il diritto di accesso come servizio all'account di servizio dell'Agente Robot, seleziona Sì e quindi OK.

7. Nella pagina Cartelle di destinazione, completa le seguenti impostazioni di destinazione e connessione, quindi seleziona Avanti:

   • Cartelle di destinazione dell'Agente Robot

     • Selezionare una cartella di destinazione per l'installazione di Agente Robot oppure utilizzare il percorso predefinito.

       Predefinito: C:\Program Files (x86)\ACL Software\Robots Agent\

     • Selezionare un percorso per la cartella dati oppure utilizzare il percorso predefinito.

       Predefinito: C:\acl\robots\

       Nota

       Non posizionare la cartella dati all'interno della cartella di destinazione dell'installazione, né viceversa. Ciò potrebbe causare la perdita di dati durante la disinstallazione di Agente Robot.

   • Percorso del file di registrazione dell'Agente Robot

     • Seleziona Copia file di registrazione e poi naviga nella posizione in cui hai salvato il file registration.key, oppure inserisci il percorso del file manualmente.

       Quando il programma di installazione viene eseguito, copiare automaticamente il file chiave nella posizione corretta nella struttura della directory di Agente Robot.

       Nota

       Se si prevede di modificare l'account del servizio di Agente Robot dopo aver installato Agente Robot, lasciare deselezionata l'opzione Copia file di registrazione e non specificare un file di registrazione.

Completare l'installazione

1. Nella pagina Pronto per l'installazione del programma, seleziona Installa.

   Agente Robot è stato installato.

2. Al termine del processo di installazione, seleziona Fine.

Confermare che il servizio di Agente Robot è in esecuzione

Per consentire la connessione all'applicazione Robot, il servizio di Agente Robot deve essere in esecuzione. Senza una connessione, Agente Robot non può elaborare le attività e gli script del robot.

Se necessario, è possibile modificare l'account del servizio di Agente Robot mentre si conferma che il servizio di Agente Robot è in esecuzione.

Utilizzare l'account di servizio di Agente Robot specificato durante l'installazione

1. Aprire Gestione servizi di Windows.

2. Verificare che entrambi i servizi Windows di Agente Robot siano in esecuzione:

   • Agente Robot

   • Servizio di Dati Robot

   Se necessario, avviare uno o entrambi i servizi.

   Nota

   Se viene visualizzato un messaggio di errore che indica che il servizio di Agente Robot è stato avviato e poi arrestato, è possibile che la registrazione di Agente Robot non sia andata a buon fine.

   Controlla che il file chiave di registrazione (registration.key) sia presente nella directory di installazione di Agente Robot. Se il file chiave di registrazione non è presente, copiarlo manualmente dal percorso in cui è stato salvato alla directory di installazione. Riprovare ad avviare il servizio Agente Robot.

   La directory di installazione predefinita è: C:\Program Files (x86)\ACL Software\Robots Agent\agent

3. Controllare il file di log dell'applicazione per confermare che l'Agente Robot sia connesso correttamente all'applicazione Robot.

   Andare alla fine del file di log e cercare una voce INFO|Connesso con una data e un'ora che corrispondano al riavvio del Servizio di Agente Robot.

   La posizione predefinita del file di log è: C:\acl\robots\logs\application.log

4. Nell'applicazione Robot, andare alla schermata Gestione degli agenti e premere F5 per ricaricare la pagina.

   Se Agente Robot viene visualizzato con uno stato Online, allora è stato registrato correttamente.

Modificare l'account del Servizio di Agente Robot

Seguire questa procedura se durante l'installazione di Agente Robot si è deselezionata l'opzione Copia file di registrazione e si desidera modificare l'account di servizio di Agente Robot.

Installare manualmente il file chiave di registrazione

1. Copia il file chiave di registrazione (registration.key) dalla posizione in cui l'hai salvato.

2. Naviga nella directory di installazione di Agente Robot e incolla il file chiave di registrazione nella sottocartella agent.

   La directory di installazione predefinita è: C:\Program File (x86)\ACL Software\Robots Agent\agent

   Se necessario, cancellare o sovrascrivere una chiave esistente.

Modificare il Servizio di Agente Robot in un account diverso

1. Aprire Gestione servizi di Windows.

2. Fare clic con il pulsante destro del mouse sul servizio Agente Robot e selezionare Proprietà.

3. Nella scheda Accedi, seleziona Sfoglia.

4. Nella finestra di dialogo Seleziona utente, nel campo Immetti il nome dell'oggetto da selezionare, inserisci il nome del nuovo account di servizio che desideri utilizzare, quindi seleziona Controlla nomi.

   L'account del servizio dovrebbe essere precompilato nel campo.

5. Selezionare OK.

6. Nella scheda Accedi, inserisci e conferma la password per il nuovo account di servizio, quindi seleziona OK.

7. Nel Gestore dei servizi Windows, riavviare (o avviare) il servizio Agente Robot.

8. Se necessario, avviare Servizio di Dati Robot.

Confermare che l'Agente Robot è stato registrato correttamente

1. Controllare il file di log dell'applicazione per confermare che l'Agente Robot sia connesso correttamente all'applicazione Robot.

   Andare alla fine del file di log e cercare una voce INFO|Connesso con una data e un'ora che corrispondano al riavvio del Servizio di Agente Robot.

   La posizione predefinita del file di log è: C:\acl\robots\logs\application.log

2. Nell'applicazione Robot, andare alla schermata Gestione degli agenti e premere F5 per ricaricare la pagina.

   Se Agente Robot viene visualizzato con uno stato Online, allora è stato registrato correttamente.

Configurare le impostazioni di Agente Robot nell'applicazione Robot

Se appropriato per l' organizzazione, nell'applicazione Robot aggiornare i valori predefiniti per due impostazioni di configurazione di Agente Robot:

• Caricamenti di file consentiticontrolla se i risultati dell'output vengono caricati da Agente Robot all'applicazione Robot nel cloud

• Configurazione dei percorsispecifica le directory del server Windows o della rete per le tabelle di dati e le tabelle dei risultati di Analytics

Per ulteriori informazioni, consulta Configurare un Agente Robot on-premise.

Creare un progetto Analytics e scaricare il file di test

1. Crea un nuovo progetto di Analytics chiamato Robots Agent test.acl.

2. Fare clic con il pulsante destro del mouse sul link sottostante e salvare il file nella stessa cartella del progetto appena creato:

   Robots_Agent_test_file.txt

Copiare lo script di prova

1. Nel progetto Analytics, creare un nuovo script denominato Robots_Agent_test_script.

2. Seleziona il collegamento sottostante per aprire lo script di prova in un browser:

   Robots_Agent_test_script.txt

3. Premere Ctrl+A per selezionare l'intero script e Ctrl+C per copiarlo negli appunti.

4. Incolla lo script in Robots_Agent_test_script, quindi seleziona Salva il progetto aperto .

Confermare lo script a Robots e creare un robot in tempo reale

1. Nel menu principale di Analytics, selezionare File > Conferma e invio degli script.

2. Se necessario, nella finestra di dialogo Seleziona destinazione, fare doppio clic sull'istanza Diligent One appropriata.

   Viene visualizzata la Raccolta robot con l'elenco dei robot esistenti, se ne esistono già. Un robot è un contenitore per script, dati e attività automatizzate.

3. Digita Test Robot nel campo Nuovo robot, quindi seleziona Crea.

   Viene creato il robot e viene generato automaticamente un ID del robot.

4. Nella finestra di dialogo Conferma e invio degli script, inserisci un messaggio di conferma, ad esempio "Carica script di prova", quindi seleziona OK.

   Lo script viene inviato a Robot e si trova nel robot appena creato.

5. Nella finestra di dialogo Conferma e invio degli script riusciti, seleziona il secondo collegamento.

   RisultatoL'applicazione Robot si apre in una finestra del browser, con la scheda Versioni script selezionata. Potrebbe essere necessario accedere a Diligent One. Si dovrebbe visualizzare la versione dello script che è stata appena eseguita.

6. In Analytics, seleziona OK per uscire dalla finestra di dialogo Conferma e invio degli script riusciti.

Caricare il file di prova

1. In Robot, selezionare la scheda Input/Output.

2. Seleziona Scegli dal computer e accedi alla posizione in cui hai salvato Robots_Agent_test_file.txt.

3. Seleziona il file, quindi Apri.

   RisultatoIl file viene caricato e appare sotto la voce File nella scheda Input/Output.

Creare un'attività ed eseguire lo script di prova

1. Vai alla scheda Attività e seleziona Crea attività.

2. Digita il nome Test Task per l'attività, quindi seleziona Salva.

3. Seleziona lo script di prova dell'Agente Robot , quindi seleziona Salta alla fine > Conferma e crea attività.

4. Nella scheda Attività, in Attività di prova seleziona > Esegui ora.

   RisultatoL'attività con lo script di test viene eseguita.

   Se l'attività viene completata con lo stato Riuscito, l'Agente Robot on-premise installato funziona correttamente.

   Nota

   Se l'attività non va a buon fine, verificare che il servizio di Agente Robot sia in esecuzione sul server in cui è installato Agente Robot. Avviare il servizio se non è in esecuzione e provare a eseguire nuovamente Attività di prova.

   Se l'attività continua a non andare a buon fine, contattare il team di supporto Diligent per ricevere assistenza.

Verificare l'output dello script

Controllare i seguenti percorsi in Robot per assicurarsi che lo script di prova generi in output i file corretti.

Interrompere i servizi di Agente Robot

1. Sul server Windows in cui si trova Agente Robot, aprire Gestione servizi Windows.

2. Interrompere entrambi i servizi Windows di Agente Robot:

   • Agente Robot

   • Servizio di Dati Robot

Scaricare il programma di installazione e avviare l'upgrade

1. Scarica il pacchetto di installazione dell'Agente Robot (RobotsAgent19.exe) dalla home page della piattaforma:

   1. Accedi a Diligent One (www.diligentoneplatform.com).

   2. Nella sezione Audit e analisi di Launchpad, seleziona il riquadro Analytics per accedere ai download.

   3. Nel menu in alto, seleziona Agente Robot.

   4. Seleziona Scarica versione 19.

      Il pacchetto di installazione viene scaricato nel computer in uso. Se necessario, copia il pacchetto di installazione sul server in cui desideri aggiornare l'Agente Robot.

2. Chiudi tutte le altre applicazioni Windows.

3. Fai doppio clic sul pacchetto di installazione.

4. Se viene visualizza una finestra di dialogo con un avviso di sicurezza, verifica le informazioni riportate, quindi seleziona Sì.

   Consiglio

   La finestra di dialogo dell'avviso di sicurezza potrebbe essere nascosta dietro una qualsiasi delle finestre aperte.

5. Seleziona la lingua che desideri utilizzare per l'installazione, quindi seleziona OK.

Estrarre i file di installazione e confermare l'upgrade

1. Nella pagina Percorso di estrazione dell'installazione, specifica la cartella in cui devono essere estratti i file di installazione, quindi seleziona Estrai.

   Puoi selezionare Sfoglia per selezionare una cartella o accettare la posizione predefinita:

   C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent19

   I file di installazione vengono estratti nella cartella di destinazione specificata. Dopo l'estrazione dei file, il programma di installazione si avvia automaticamente.

   Nota

   Se il programma di installazione non si avvia automaticamente per qualsiasi motivo, puoi utilizzare Windows Explorer per navigare nella cartella in cui sono stati estratti i file di setup e fare doppio clic su setup.exe.

2. Quando ti viene richiesto se desideri effettuare l'upgrade, seleziona Sì.

3. Nella finestra di dialogo Informazioni sul programma di installazione di Agente Robot, seleziona OK solo se i requisiti elencati risultano soddisfatti.

   Se non sono stati ancora soddisfatti i requisiti, rispettarli ora prima di procedere con l'aggiornamento. Se necessario, disattivare temporaneamente qualsiasi attività del robot programmata per essere eseguita a breve.

Installare i prerequisiti, se necessario

Se ti viene proposto di installare i prerequisiti, seleziona Installa. Dopo aver installato i prerequisiti, il programma di installazione procede automaticamente.

Per un elenco dei prerequisiti, consulta Requisiti di sistema per Agente Robot on-premise.

Configurare le proprietà di installazione

1. Nella pagina di benvenuto, seleziona Avanti.

2. Nella pagina Contratto di licenza, seleziona Accetto i termini sopra indicati, quindi Avanti.

3. Nella pagina Selezione edizione di Agente Robot, seleziona Avanti.

   Il programma di installazione applica l'edizione di Agente Robot attualmente installata (non Unicode o Unicode).

   Nota

   Non è possibile modificare l'edizione durante un aggiornamento. Per cambiare edizione, è necessario disinstallare la versione attuale dell'Agente Robot e quindi installare la versione 19.0.

4. Nella pagina Abilita machine learning lascia selezionata l'opzione Abilita, a meno che tu non abbia un valido motivo per non installare il motore Python, quindi seleziona Avanti.

   Nota

   Se si sceglie di non installare il motore Python e in seguito si desidera utilizzarlo per eseguire comandi di apprendimento automatico, è necessario disinstallare e reinstallare l'Agente Robot.

5. Nella pagina Impostazioni dei servizi dell'Agente Robot, completa le seguenti impostazioni dell'account di servizio, quindi seleziona Avanti:

   • Numero di porta del Servizio di Dati RobotMantieni la porta esistente specificata per il servizio dati, oppure specifica una porta diversa.

     È possibile specificare qualsiasi porta disponibile compresa tra 0 e 65536.

   • Account di servizio di Agente RobotMantieni l'account di dominio esistente che gestisce il servizio Agente Robot, oppure specifica un account diverso. Fornire la password per l'account.

     L'account deve essere un account di dominio, specificato nella forma Domain\service_account_name. L'account richiede l'autorizzazione per eseguire i servizi sul sistema operativo Windows Server, nonché l'accesso completo alla cartella dati di Agente Robot esistente. Per maggiori informazioni, consultare Sicurezza di Agente Robot on-premise.

     Nota

     Se è necessario modificare l'account del Servizio di Agente Robot, la soluzione migliore è modificarlo dopo l'aggiornamento.

     Se durante l'aggiornamento si modifica l'account nel programma di installazione, è necessario registrare nuovamente Agente Robot. La nuova registrazione di un agente installato può compromettere la configurazione dell'istanza Robot dell'organizzazione.

     Per ulteriori informazioni, consulta Modificare l'account del Servizio di Agente Robot.

6. Rivedi le informazioni di configurazione nella schermata successiva, quindi seleziona Avanti.

Completare l'aggiornamento

1. Nella pagina Pronto per l'installazione del programma, seleziona Installa.

   Agente Robot è stato aggiornato.

2. Al termine del processo di upgrade, seleziona Fine.

3. Seleziona Sì per riavviare il server e completare l'upgrade.

4. Nel gestore di Servizi di Windows, verifica che entrambi i servizi Windows di Agente Robot siano in esecuzione:

   • Agente Robot

   • Servizio di Dati Robot

   Se necessario, avviare uno o entrambi i servizi.

Queste istruzioni si riferiscono al Server N. 1 e al Server N. 2:

• Server N. 1Il server Windows su cui è stata installata la prima istanza di Agente Robot

• Server N. 2Un server Windows aggiuntivo su cui installare un'istanza aggiuntiva di Agente Robot

  Nota

  È possibile ripetere il processo per tutti gli agenti e i server aggiuntivi di cui si ha bisogno.

Installare l'Agente Robot sul Server N. 2

1. Sul server N. 2, eseguire lo stesso processo di installazione utilizzato per installare Agente Robot sul Server N. 1.

2. Nella pagina Cartelle di destinazione del programma di installazione, non selezionare Copia file di registrazione e lasciare vuoto il campo Percorso del file di registrazione di Agente Robot.

Per le fasi di installazione, consulta .

Recuperare il nome della chiave RSA dall'applicazione Robot

1. Dalla home page della piattaforma (www.diligentoneplatform.com), seleziona l'applicazione Robot per aprirla.

   Se si è già in Diligent One, è possibile utilizzare il menu di navigazione a sinistra per passare all'applicazione Robot.

2. Nell'angolo in alto a destra della dashboard, selezionare Impostazioni.

3. Nel pannello di sinistra, assicurati che Gestione degli agenti sia selezionato.

4. Seleziona Come aggiungere altri agenti.

5. Seleziona per copiare il nome della chiave RSA negli Appunti.

6. Incollare il nome della chiave RSA in un file di testo per l'archiviazione temporanea.

Raggruppare la chiave RSA dell'Agente Robot in un file

Usa l'utility EncryptionKeyCLI.exe sul Server N. 1 per raggruppare la chiave RSA di Agente Robot in un file.

1. Sul Server N. 1, apri il prompt dei comandi di Windows come amministratore.

2. Eseguire il seguente comando per passare alla directory di installazione di Agente Robot:

   cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

   Specificare il percorso appropriato se l'Agente Robot non è installato nella directory predefinita.

3. Eseguire il seguente comando per raggruppare la chiave RSA dell'Agente Robot in un file zip:

   EncryptionKeyCLI.exe export RSAKeyfile ACL_XXXXXXXX

   Per ACL_XXXXXXXX , sostituire il nome dell'attuale chiave RSA copiato dalla schermata Gestione degli agenti in Robot.

   RSAKeyfile può essere qualsiasi nome del file, senza spazi, che si desidera specificare. Facoltativamente, si può specificare un percorso del file per una cartella esistente sul server. Se il percorso contiene spazi, racchiudere l'intero percorso e il nome file tra virgolette doppie.

4. Se necessario, immettere Y per sovrascrivere un file esistente.

   RisultatoLa chiave RSA è racchiusa in un file zip e salvata nella posizione predefinita (C:\ProgramData\robots\RSAKeyfile.zip) o nella posizione che hai specificato.

   Nota

   Se non vedi la cartella ProgramData, è possibile che sia nascosta. Per rendere visibile la cartella, in Esplora File di Windows seleziona Elementi nascosti nella directory principale di C:\ (scheda Visualizza > Elementi nascosti).

Migrare il file chiave RSA al Server N. 2

Usa l'utility EncryptionKeyCLI.exe sul Server N. 2 per estrarre la chiave RSA di Agente Robot dal file zip e importarla nel keystore Microsoft.

1. Copia RSAKeyfile.zip dal Server N. 1 alla directory di installazione di Agente Robot sul Server N. 2.

   La directory di installazione predefinita è: C:\Program Files (x86)\ACL Software\Robots Agent\agent

2. Nel Server N. 2, aprire il prompt dei comandi di Windows come amministratore.

3. Eseguire il seguente comando per passare alla directory di installazione di Agente Robot:

   cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

   Specificare il percorso appropriato se l'Agente Robot non è installato nella directory predefinita.

4. Eseguire il seguente comando per estrarre la chiave RSA dell'Agente Robot dal file zip e importarla nel keystore Microsoft sul Server N. 2:

   EncryptionKeyCLI.exe import RSAKeyfile

   Se non è stato utilizzato RSAKeyfile come nome del file zip, sostituire il nome utilizzato.

Copiare il file chiave di registrazione sul Server N. 2

Copia il file chiave di registrazione (registration.key) dalla directory di installazione di Agente Robot sul Server N. 1 alla directory di installazione di Agente Robot sul Server N. 2.

La directory di installazione predefinita è: C:\Program Files (x86)\ACL Software\Robots Agent\agent

Riavviare il servizio di Agente Robot sul Server N. 2

Nel Server N.2, aprire il Gestore dei servizi Windows e riavviare (o avviare) il servizio Agente Robot.

Verificare che l'agente aggiuntivo sia stato registrato correttamente

Nell'applicazione Robot, andare alla schermata Gestione degli agenti e premere F5 per ricaricare la pagina. Se l'Agente Robot aggiuntivo viene visualizzato con uno stato Online, allora è stato registrato correttamente. L'agente fa ora parte del cluster di agenti utilizzato per l'elaborazione analitica e il bilanciamento del carico.