Registrare manualmente un Agente Robot on-premise

Agente Robot deve essere registrato utilizzando un file chiave (registration.key). In genere, la registrazione di Agente Robot avviene durante il processo di installazione. Tuttavia, in alcune situazioni è necessario registrare manualmente l'agente separatamente dall'installazione oppure registrarlo nuovamente.

La registrazione manuale di un Agente Robot richiede due passaggi distinti:

1. Generare e scaricare il file chiave di registrazione.
2. Installare manualmente il file chiave di registrazione nella struttura di directory di Agente Robot e avviare o riavviare il Servizio di Agente Robot.

Registrazione manuale obbligatoria

La registrazione manuale o la nuova registrazione di Agente Robot è obbligatoria nelle seguenti situazioni:

• Cambiare l'account di servizio dopo l'installazioneDurante l'installazione di Agente Robot, lascia deselezionato Copia file di registrazione. Una volta completata l'installazione, è necessario aggiornare immediatamente l'account utilizzato per eseguire il Servizio di Agente Robot.
• IP del server modificatoL'indirizzo IP del server Windows che ospita Agente Robot cambia.
• Problema con un file chiaveSi verifica un problema con il file chiave di registrazione esistente.

Registrazione manuale non obbligatoria

Non si dovrebbe registrare manualmente di nuovo un Agente Robot esistente o generare un nuovo file chiave di registrazione nelle seguenti situazioni:

• Cambiare l'account di servizio di produzioneÈ necessario cambiare l'account di servizio che ha eseguito Agente Robot installato. Per ulteriori informazioni, consulta Modificare l'account del Servizio di Agente Robot.
• Aggiornare l'Agente RobotIl file chiave di registrazione non è coinvolto nell'aggiornamento di Agente Robot.

In queste situazioni, la generazione di un nuovo file chiave di registrazione non è necessaria e può compromettere la configurazione dell'istanza Robot dell'organizzazione (come spiegato di seguito).

Implicazioni della rigenerazione di una chiave di registrazione

La rigenerazione di una chiave di registrazione per un Agente Robot già in uso ha i seguenti effetti:

• Tutte le password salvate nelle attività del robot vengono eliminate e devono essere reinserite.
• Tutti gli agenti vengono rimossi dall'elenco degli agenti nella schermata Gestione degli agenti.
• È necessario registrare nuovamente tutti gli agenti, inclusa la migrazione della chiave RSA dell'Agente Robot tra i server per le installazioni multi-agente.

Generare il file chiave di registrazione dell'Agente 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, fai clic su Impostazioni.

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

4. Se la tua istanza di Robot utilizza attualmente un Agente Robot basato su cloud, esegui le seguenti operazioni:

   1. Fare clic su Sostituisci agente cloud.

   2. Fare clic su Registra agente e genera chiave.

5. Se la tua istanza di Robot utilizza attualmente un Agente Robot basato on-premise, o non ha un Agente Robot specificato, esegui le seguenti operazioni:

   1. Fare clic su Genera una nuova chiave di registrazione.

      La finestra di dialogo di avviso si applica a te se hai uno o più agenti on-premise esistenti già installati.

   2. Fare clic su Genera una nuova chiave di registrazione.

6. Fai clic su Scarica file chiave e chiudi.

   Attenzione

   Non chiudere la finestra del browser fino a quando non hai scaricato il file chiave.

7. Salva il file chiave scaricato in un luogo sicuro sul server di Windows che ospiterà l'Agente Robot.

   Nota

   La generazione di un file chiave è la prima parte della registrazione di un Agente Robot. Il processo di registrazione è completo quando si posiziona il file chiave nel luogo corretto nella struttura di directory di Agente Robot, si avvia o riavvia il servizio Agente Robot e ci si connette correttamente all'applicazione Robot.

Installare manualmente il file chiave di registrazione

1. Sul server Windows che esegue Agente Robot, copia il file della chiave di registrazione dalla posizione in cui è stato 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.

3. Nel Gestore dei servizi Windows, riavviare il servizio Agente Robot.

   Nota

   Se non si riavvia il servizio, gli script di analisi non verranno eseguiti.

4. 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

5. 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.