Vérifiez dans Swagger que les catégories d’API nommées « cloudsecure_installers.agent » et « cloudsecure_installers.collector » sont disponibles. Dans le cas contraire, la prise en charge de l’installation manuelle de l’agent n’est pas activée. Veuillez contacter le support NetApp pour activer la fonctionnalité.

Exécutez toutes les commandes mentionnées dans ce document en tant qu'utilisateur « root » ou, si vous exécutez avec un utilisateur différent, exécutez les commandes avec « sudo ».

Créez un nouveau jeton d’accès à l’API Workload Security.

Copiez le jeton d’accès API généré. Veuillez noter qu'une fois la fenêtre fermée, le jeton ne peut plus être récupéré. Dans ce cas, vous devrez générer un nouveau jeton.

Cliquez sur le bouton Autoriser en haut à droite de la page.

Dans le champ de texte Customer ApiKey (apiKey), collez le jeton API précédemment copié à partir deÉtape 1c .

Cliquez sur Autoriser et fermez la fenêtre.

Dans Swagger, sélectionnez cloudsecure_installers.agent > /v1/cloudsecure/agents/installers/{platform}/latest (GET) API. Cliquez sur Essayer.

Dans le champ plateforme, entrez linux. Cliquez sur Exécuter.

Cliquez sur « Télécharger le fichier » pour télécharger le programme d'installation.

Si le fichier d'installation est téléchargé en externe sur une machine différente du système sur lequel l'agent doit être installé, copiez le fichier d'installation sur ce système.

Alternativement, vous pouvez copier la commande curl et l'exécuter directement sur le système sur lequel l'agent doit être installé.

Dans Swagger, exécutez cloudsecure_installers.agent > /v1/cloudsecure/agent/oneTimeToken API et copiez le jeton de la réponse.

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"

Exécutez « systemctl status cloudsecure-agent.service » et vérifiez que le service de l’agent est en état 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'agent doit être visible dans la page « Agents » et doit être dans l'état « connecté ».

Si l’installation de l’agent réussit, les fichiers d’installation de l’agent téléchargés peuvent être supprimés.

Accédez au système sur lequel le collecteur doit être installé et créez un répertoire nommé ./tmp/collectors sous le répertoire agent installation path.

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

Modifiez de manière récursive la propriété du répertoire tmp en cssys:cssys (l'utilisateur et le groupe cssys seront créés lors de l'installation de l'agent).

[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

Nous devons maintenant récupérer la version du collecteur et l'UUID du collecteur. Accédez à l’API « cloudsecure_config.collector-types ».

Accédez à Swagger, API « cloudsecure_config.collector-types > /v1/cloudsecure/collector-types » (GET). Dans la liste déroulante « collectorCategory », sélectionnez le type de collecteur « DATA ». Sélectionnez « TOUS » pour récupérer tous les détails du type de collecteur.

Copiez l'UUID du type de collecteur requis.

Téléchargez le programme d'installation du collecteur.

[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

Changer la propriété du fichier zip d'installation du collecteur en 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

Accédez à Sécurité de la charge de travail > Collecteurs et sélectionnez +Collecteur. Choisissez le collecteur ONTAP SVM.

Configurez les détails du collecteur et Enregistrez le collecteur.

Après avoir cliqué sur Enregistrer, le processus de l'agent localisera le programme d'installation du collecteur dans le répertoire /{agent-install-path}/cloudsecure/tmp/collectors/ et installera le collecteur.

En guise d'alternative, au lieu d'ajouter le collecteur via l'interface utilisateur, il peut également être ajouté via l'API.

Le collecteur devrait maintenant être visible dans la section « Collecteurs de données ».

Nettoyage après installation.

1. Accédez au système sur lequel le collecteur doit être installé et créez un répertoire nommé ./tmp/collectors sous le répertoire agent installation path.

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

Nous devons maintenant récupérer la version et l’UUID du collecteur. Accédez à l’API « cloudsecure_config.collector-types ». Dans la liste déroulante collectorCategory, sélectionnez le type de collecteur comme « UTILISATEUR ». Sélectionnez « TOUS » pour récupérer tous les détails du type de collecteur en une seule requête.

Copiez l'UUID du collecteur LDAP.

Téléchargez le programme d'installation du collecteur.

[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

Changer la propriété du fichier zip d'installation du collecteur en 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

Accédez à la page « Collecteurs d’annuaires utilisateurs » et cliquez sur « + Collecteur d’annuaires utilisateurs ».

Sélectionnez « Serveur d'annuaire LDAP ».

Saisissez les détails du serveur d'annuaire LDAP et cliquez sur « Enregistrer »

Après avoir cliqué sur Enregistrer, le service de l'agent localisera le programme d'installation du collecteur dans le répertoire /{agent-install-path}/cloudsecure/tmp/collectors/ et installera le collecteur.

En guise d'option alternative, au lieu d'ajouter un collecteur via l'interface utilisateur, il peut également être ajouté via l'API.

Le collecteur devrait maintenant être visible dans la section « Collecteurs d’annuaires utilisateurs ».

Nettoyage après installation.

Téléchargez le dernier programme d'installation de l'agent.

Définissez l'autorisation d'exécution pour le fichier « 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

Exécutez le script « cloudsecure-agent-upgrade.sh ». Si le script s'est exécuté avec succès, il affichera le message « L'agent Cloudsecure a été mis à niveau avec succès. » dans la sortie.

Exécutez la commande suivante :

sudo chown -R cssys:cssys {agent-install-path}/cloudsecure

 sudo chown -R cssys:cssys /test_user/apps/cloudsecure
. Exécutez la commande suivante « systemctl daemon-reload »

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

Redémarrez le service de l'agent.

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

Vérification de santé mentale après la mise à niveau de l'agent.

Nettoyage après installation.

Accédez au système dans lequel les collecteurs doivent être mis à niveau et créez le répertoire ./tmp/collectors sous le répertoire agent installation path, s'il n'est pas déjà présent.

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

Assurez-vous que le répertoire « collectors » appartient à 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

Dans Swagger, accédez à l'API GET « cloudsecure_config.collector-types ». Dans la liste déroulante « collectorCategory », sélectionnez « DATA » (sélectionnez « USER » pour le collecteur de répertoires d'utilisateurs ou « TOUS »).

Téléchargez le dernier fichier d'installation du collecteur.

Changer la propriété du fichier zip d'installation du collecteur en 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

Déclencher l'API du collecteur de mise à niveau.

Vérification de santé mentale.

Nettoyage après la mise à niveau :

Erreur AGENT014

Erreur non autorisée

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