Verificare in Swagger che le categorie API denominate "cloudsecure_installers.agent" e "cloudsecure_installers.collector" siano disponibili. In caso contrario, il supporto per l'installazione manuale dell'agente non è abilitato. Contattare l'assistenza NetApp per abilitare la funzionalità.

Eseguire tutti i comandi menzionati in questo documento come utente 'root' oppure, se si esegue con un utente diverso, eseguire i comandi con 'sudo'.

Crea un nuovo token di accesso all'API Workload Security.

Copia il token di accesso API generato. Si prega di notare che una volta chiusa la finestra, il token non potrà più essere recuperato. In tal caso sarà necessario generare un nuovo token.

Fare clic sul pulsante Autorizza in alto a destra della pagina.

Nel campo di testo Customer ApiKey (apiKey), incolla il token API precedentemente copiato daFase 1c .

Fare clic su Autorizza e chiudere la finestra.

In Swagger, seleziona cloudsecure_installers.agent > API /v1/cloudsecure/agents/installers/{platform}/latest (GET). Fai clic su Provalo.

Nel campo piattaforma, immettere linux. Fare clic su Esegui.

Fare clic su "Scarica file" per scaricare il programma di installazione.

Se il file di installazione viene scaricato esternamente su una macchina diversa dal sistema in cui deve essere installato l'agente, copiare il file di installazione su tale sistema.

In alternativa, è possibile copiare il comando curl ed eseguirlo direttamente nel sistema in cui deve essere installato l'agente.

In Swagger, esegui cloudsecure_installers.agent > /v1/cloudsecure/agent/oneTimeToken API e copia il token dalla risposta.

sudo /bin/bash -c "TOKEN=<<one time token generated in step 7>> HTTPS_PROXY=<<proxy details in the format mentioned in step 9>> AGENT_INSTALL_PATH=<<custom_path_to_install_agent>> ./cloudsecure-agent-install.sh"

Eseguire “systemctl status cloudsecure-agent.service” e verificare che il servizio agente sia in stato running.

[root@demo-agent ~]# systemctl status cloudsecure-agent.service
 cloudsecure-agent.service - Cloud Secure Agent Daemon Service
   Loaded: loaded (/usr/lib/systemd/system/cloudsecure-agent.service; enabled; vendor preset: disabled)
   Active: active (running) since Fri 2024-04-26 02:50:37 EDT; 12h ago
 Main PID: 15887 (java)
    Tasks: 72
   CGroup: /system.slice/cloudsecure-agent.service
           ├─15887 java -Dconfig.file=/test_user/apps/cloudsecure/agent/conf/application.conf -Dagent.proxy.host= -Dagent.proxy.port= -Dagent.proxy.user= -Dagent.proxy.password= -Dagent.env=prod -Dagent.base.path=/test_user/apps/cloudsecure/agent -...

L'agente dovrebbe essere visibile nella pagina "Agenti" e dovrebbe essere nello stato "connesso".

Se l'installazione dell'agente ha esito positivo, è possibile eliminare i file di installazione dell'agente scaricati.

Accedere al sistema in cui deve essere installato Collector e creare una directory denominata ./tmp/collectors nella directory percorso di installazione dell'agente.

[root@demo-agent ~]# cd {agent-install-path}/cloudsecure
[root@demo-agent ~]# mkdir -p ./tmp/collectors

Modificare ricorsivamente la proprietà della directory tmp in cssys:cssys (l'utente e il gruppo cssys verranno creati durante l'installazione dell'agente).

[root@demo-agent /]# chown -R cssys:cssys tmp/
[root@demo-agent /]# cd ./tmp
[root@demo-agent tmp]# ll | grep collectors
drwx------ 2 cssys         cssys 4096 Apr 26 15:56 collectors

Ora dobbiamo recuperare la versione del collector e l'UUID del collector. Passare all'API "cloudsecure_config.collector-types".

Vai su swagger, “cloudsecure_config.collector-types > /v1/cloudsecure/collector-types” (GET) API. Nel menu a discesa "collectorCategory", seleziona il tipo di collettore come "DATI". Selezionare "TUTTI" per recuperare tutti i dettagli del tipo di collettore.

Copiare l'UUID del tipo di collettore richiesto.

Scarica il programma di installazione del collettore.

[root@demo-agent collectors]# cd {agent-install-path}/cloudsecure/tmp/collectors
[root@demo-agent collectors]# pwd
/opt/netapp/cloudsecure/tmp/collectors

[root@demo-agent collectors]# curl -X GET "https://netapp-demo.dev.cloudsecure.netapp.com/rest/v1/cloudsecure/collector-types/installers/1829df8a-c16d-45b1-b72a-ed5707129870" -H "accept: application/octet-stream" -H "X-CloudInsights-ApiKey: <<API Access Token>>" -o cs-ontap-dsc_1.286.0.zip

Cambia la proprietà del file zip di installazione del collector in cssys:cssys.

-rw------- 1 root root 50906252 Apr 26 16:11 cs-ontap-dsc_1.286.0.zip
[root@demo-agent collectors]# chown cssys:cssys cs-ontap-dsc_1.286.0.zip
[root@demo-agent collectors]# ll
total 49716
-rw------- 1 cssys cssys 50906252 Apr 26 16:11 cs-ontap-dsc_1.286.0.zip

Passare a Sicurezza del carico di lavoro > Collettori e selezionare +Collettore. Selezionare il raccoglitore ONTAP SVM.

Configurare i dettagli del collettore e Salvare il collettore.

Facendo clic su Salva, il processo dell'agente individuerà il programma di installazione del collettore dalla directory /{agent-install-path}/cloudsecure/tmp/collectors/ e installerà il collettore.

In alternativa, anziché aggiungere il collettore tramite l'interfaccia utente, è possibile aggiungerlo anche tramite API.

Il collettore dovrebbe ora essere visibile nella sezione "Collettori dati".

Pulizia post-installazione.

1. Accedere al sistema in cui deve essere installato Collector e creare una directory denominata ./tmp/collectors nella directory percorso di installazione dell'agente.

[root@demo-agent ~]# cd {agent-install-path}/cloudsecure
[root@demo-agent ~]# mkdir -p ./tmp/collectors

Ora dobbiamo recuperare la versione e l'UUID del collector. Passare all'API "cloudsecure_config.collector-types". Nel menu a discesa collectorCategory, seleziona il tipo di collettore come "USER". Selezionare "TUTTI" per recuperare tutti i dettagli del tipo di collettore in un'unica richiesta.

Copia l'UUID del raccoglitore LDAP.

Scarica il programma di installazione del collettore.

[root@demo-agent collectors]# cd {agent-install-path}/cloudsecure/tmp/collectors
[root@demo-agent collectors]# pwd
/opt/netapp/cloudsecure/tmp/collectors

[root@demo-agent collectors]# curl -X GET "https://netapp-demo.dev.cloudsecure.netapp.com/rest/v1/cloudsecure/collector-types/installers/37fb37bd-6078-4c75-a64f-2b14cb1a1eb1" -H "accept: application/octet-stream" -H "X-CloudInsights-ApiKey: <<API Access Token>>" -o cs-ldap-dsc_1.322.0.zip

Cambia la proprietà del file zip del programma di installazione del collettore in cssys:cssys.

[root@demo-agent collectors]# ll
total 37156
-rw------- 1 root root 38045966 Apr 29 10:02 cs-ldap-dsc_1.322.0.zip
[root@demo-agent collectors]# chown cssys:cssys cs-ldap-dsc_1.322.0.zip
[root@demo-agent collectors]# ll
total 37156
-rw------- 1 cssys cssys 38045966 Apr 29 10:02 cs-ldap-dsc_1.322.0.zip

Vai alla pagina "Collezionisti directory utente" e clicca su "+ Collezionista directory utente".

Selezionare 'Server directory LDAP'.

Inserisci i dettagli del server directory LDAP e fai clic su "Salva"

Facendo clic su Salva, il servizio agente individuerà il programma di installazione del collettore dalla directory /{agent-install-path}/cloudsecure/tmp/collectors/ e installerà il collettore.

In alternativa, anziché aggiungere il collettore tramite l'interfaccia utente, è possibile aggiungerlo anche tramite API.

Il raccoglitore dovrebbe ora essere visibile nella sezione "Raccoglitori directory utente".

Pulizia post-installazione.

Scarica l'ultimo programma di installazione dell'agente.

Imposta l'autorizzazione di esecuzione per il file "cloudsecure-agent-upgrade.sh".

[root@demo-agent agent_installers]# unzip cloudsecure-linux-agent-installer-1.618.0.zip
Archive:  cloudsecure-linux-agent-installer-1.618.0.zip
  inflating: cloudsecure-agent-image.zip
  inflating: cloudsecure-agent-install.sh
  inflating: cloudsecure-agent-upgrade.sh
[root@demo-agent agent_installers]# ll
total 153344
-rw------- 1 root root 79154230 Apr 26  2024 cloudsecure-agent-image.zip
-rw------- 1 root root    16574 Apr 26  2024 cloudsecure-agent-install.sh
-rw------- 1 root root     8586 Apr 26  2024 cloudsecure-agent-upgrade.sh
-rw------- 1 root root 77834660 Apr 26 17:35 cloudsecure-linux-agent-installer-1.618.0.zip
[root@demo-agent agent_installers]# chmod +x cloudsecure-agent-upgrade.sh
[root@demo-agent agent_installers]# ll
total 153344
-rw------- 1 root root 79154230 Apr 26  2024 cloudsecure-agent-image.zip
-rw------- 1 root root    16574 Apr 26  2024 cloudsecure-agent-install.sh
-rwx------ 1 root root     8586 Apr 26  2024 cloudsecure-agent-upgrade.sh
-rw------- 1 root root 77834660 Apr 26 17:35 cloudsecure-linux-agent-installer-1.618.0.zip

Eseguire lo script “cloudsecure-agent-upgrade.sh”. Se lo script è stato eseguito correttamente, nell'output verrà visualizzato il messaggio "L'agente Cloudsecure è stato aggiornato correttamente".

Eseguire il seguente comando 'systemctl daemon-reload'

[root@demo-agent ~]# systemctl daemon-reload

Riavviare il servizio agente.

[root@demo-agent ~]# systemctl restart cloudsecure-agent.service

Controllo di integrità dopo l'aggiornamento dell'agente.

Pulizia post-installazione.

Accedere al sistema in cui è necessario aggiornare i collettori e creare la directory ./tmp/collectors nella directory percorso di installazione dell'agente, se non è già presente.

[root@demo-agent ~]# cd {agent-install-path}/cloudsecure
[root@demo-agent ~]# mkdir -p ./tmp/collectors

Assicurarsi che la directory “collectors” sia di proprietà di cssys:cssys.

[root@demo-agent /]# chown -R cssys:cssys tmp/
[root@demo-agent /]# cd ./tmp
[root@demo-agent tmp]# ll | grep collectors
drwx------ 2 cssys         cssys 4096 Apr 26 15:56 collectors

In Swagger, vai all'API GET "cloudsecure_config.collector-types". Nel menu a discesa "collectorCategory", seleziona "DATI" (seleziona "UTENTE" per il raccoglitore di directory utente o "TUTTI").

Scarica l'ultimo file di installazione del collettore.

Cambia la proprietà del file zip del programma di installazione del collettore in cssys:cssys.

[root@demo-agent collectors]# ll
total 55024
-rw------- 1 root root 56343750 Apr 26 19:00 cs-ontap-dsc_1.287.0.zip
[root@demo-agent collectors]# chown cssys:cssys cs-ontap-dsc_1.287.0.zip
[root@demo-agent collectors]# ll
total 55024
-rw------- 1 cssys cssys 56343750 Apr 26 19:00 cs-ontap-dsc_1.287.0.zip

Attiva l'API di raccolta degli aggiornamenti.

Controllo di sanità mentale.

Pulizia post-aggiornamento:

Errore AGENT014

Errore non autorizzato

{
  "errorMessage": "Requested public API is not allowed to be accessed by input API access token.",
  "errorCode": "NOT_AUTHORIZED"
}