Registrare manualmente un Agente Robot on-premise

Agente Robot deve essere registrato tramite 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:

• Modifica dell'account di servizio dopo l'installazione Durante l'installazione di Agente Robot, lasciare deselezionata l'opzione 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 modificato: l'indirizzo IP del server Windows che ospita Agente Robot cambia.
• Problema con un file chiave: si è verificato 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:

• Modifica di un account di servizio di produzione È necessario modificare l'account di servizio che ha eseguito un Agente Robot installato. Per maggiori informazioni, consultare Modificare l'account del Servizio di Agente Robot.
• Aggiornamento di Agente Robot: il 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 di Launchpad (www.highbond.com), selezionare 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. Accedere alla directory di installazione di Agente Robot e incollare il file chiave di registrazione nella sottocartella agente.

   La directory di installazione predefinita è: C:\Program Files (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.