Verifique en Swagger que las categorías API denominadas «cloudsecure_installers.agent» y «cloudsecure_installers.collector» están disponibles. Si no es así, el soporte para la instalación manual del agente no está activado. Póngase en contacto con el servicio de soporte de NetApp para que la función esté habilitada.

Ejecute todos los comandos mencionados en este documento como usuario 'root', o, si se ejecuta con un usuario diferente, ejecute los comandos con 'sudo'.

Cree un nuevo token de acceso a la API de seguridad de carga de trabajo.

Copie el token de acceso a API generado. Tenga en cuenta que una vez cerrada la ventana, el token ya no se puede recuperar. En ese caso, deberá generar un nuevo token.

Haga clic en el botón Autorizar en la parte superior derecha de la página.

En el campo de texto Customer ApiKey (apiKey), pegue el token API copiado previamente de Paso 1c.

Haga clic en Autorizar y cierre la ventana.

En Swagger, seleccione cloudsecure_installers.agent > /v1/cloudsecure/agents/installers/{platform}/latest (GET) API. Haga clic en Pruébelo.

En el campo platform, introduzca linux. Haga clic en Execute.

Haga clic en “Descargar archivo” para descargar el instalador.

Si el archivo de instalación se descarga externamente en un equipo distinto del sistema en el que se va a instalar el agente, copie el archivo de instalación en ese sistema.

Alternativamente, puede copiar el comando curl y ejecutarlo directamente en el sistema donde se debe instalar el agente.

En Swagger, ejecute la API cloudsecure_installers.agent > /v1/cloudsecure/agent/oneTimeToken y copie el token de la respuesta.

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"

Ejecute “systemctl status cloudsecure-agent.service” y verifique que el servicio del agente está en estado 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 -...

El agente debe ser visible en la página “Agentes” y debe estar en estado “Conectado”.

Si la instalación del agente se realiza correctamente, se pueden eliminar los archivos descargados del instalador del agente.

Vaya al sistema en el que se debe instalar el recopilador y cree un directorio llamado ./tmp/collectors en el directorio agent install path.

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

Cambie recursivamente la propiedad del directorio tmp a cssys:cssys (el usuario y el grupo cssys se crearán durante la instalación del 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

Ahora necesitamos recuperar la versión del recopilador y el UUID del recopilador. Navegue a la API «cloudsecure_config.collector-types».

Vaya a Swagger, «cloudsecure_config.collector-types > /v1/cloudsecure/collector-types» (GET). En el menú desplegable “collectorCategory”, selecciona el tipo de recopilador como “DATA”. Seleccione “ALL” para obtener todos los detalles del tipo de recopilador.

Copie el UUID del tipo de recopilador necesario.

Descargar el instalador del recopilador.

[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

Cambiar la propiedad del archivo zip del instalador del recopilador a 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

Navegue hasta Workload Security > Collectors y seleccione +Collector. Seleccione el recopilador ONTAP SVM.

Configure los detalles del recopilador y Save el recopilador.

Al hacer clic en Guardar, el proceso del agente ubicará el instalador del recopilador en el directorio /{agent-install-path}/cloudsecure/tmp/collectors/ e instalará el recopilador.

Como opción alternativa, en lugar de agregar el recopilador a través de la interfaz de usuario, también se puede agregar a través de la API.

El recopilador debería ser ahora visible en la sección “Recopiladores de datos”.

Limpieza posterior a la instalación.

1. Vaya al sistema en el que se debe instalar el recopilador y cree un directorio llamado ./tmp/collectors en el directorio agent install path.

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

Ahora necesitamos recuperar la versión y UUID del recopilador. Navegue a la API «cloudsecure_config.collector-types». En la lista desplegable collectorCategory, selecciona el tipo de recopilador como “USUARIO”. Seleccione “TODOS” para obtener todos los detalles del tipo de recopilador en una sola solicitud.

Copie el UUID del recopilador LDAP.

Descargue el instalador del recopilador.

[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

Cambie la propiedad del archivo zip del instalador del recopilador a 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

Navega a la página 'User Directory Collectors' y haz clic en '+ User Directory Collector'.

Selecciona 'LDAP Directory Server'.

Ingrese los detalles del servidor de directorios LDAP y haga clic en “Guardar”

Al hacer clic en Guardar, el servicio del agente ubicará el instalador del recopilador en el directorio /{agent-install-path}/cloudsecure/tmp/collectors/ e instalará el recopilador.

Como opción alternativa, en lugar de agregar recopilador a través de la interfaz de usuario, también se puede agregar a través de la API.

El recopilador debe ser ahora visible en la sección “Colectores de directorios de usuarios”.

Limpieza posterior a la instalación.

Descargue el instalador del agente más reciente.

Establezca el permiso de ejecución para el archivo «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

Ejecute el script «cloudsecure-agent-upgrade.sh». Si el script se ha ejecutado correctamente, imprimirá el mensaje “Cloudsecure agent has updated successfully.” en la salida.

Ejecute el siguiente comando 'systemctl daemon-reload'

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

Reinicie el servicio de agente.

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

Comprobación de estado tras actualización de agente.

Limpieza posterior a la instalación.

Vaya al sistema en el que se deben actualizar los recolectores y cree el directorio ./tmp/collectors en el directorio agent install path, si aún no está presente.

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

Asegúrese de que el directorio “recopiladores” es propiedad de 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

En Swagger, desplácese hasta «cloudsecure_config.collector-types» GET API. En el menú desplegable “collectorCategory”, seleccione “DATA” (seleccione “USER” para el recopilador de directorios de usuario o “ALL”).

Descargue el archivo del instalador del recopilador más reciente.

Cambie la propiedad del archivo zip del instalador del recopilador a 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

Active la API del recopilador de actualizaciones.

Comprobación de estado.

Limpieza posterior a la actualización:

AGENT014 Error

Error no autorizado

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