Skip to main content
Data Infrastructure Insights
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Instalación manual del agente y recopilador de seguridad de carga de trabajo

Colaboradores netapp-alavoie

De forma predeterminada, cuando hay una nueva versión de un agente o recopilador de Workload Security disponible, se envía una notificación previa a la actualización y los agentes y recopiladores se actualizan automáticamente en su inquilino. Sin embargo, en un entorno controlado y seguro, es posible que no se deseen las actualizaciones automáticas. En tales casos, Workload Security se puede configurar para la instalación/actualización manual de agentes y recopiladores, lo que proporciona más control sobre el software instalado en sus sistemas.

Antes de empezar

  1. Verifique en swagger que las categorías de API denominadas “cloudsecure_installers.agent” y “cloudsecure_installers.collector” estén disponibles. De lo contrario, no se habilita la compatibilidad con la instalación manual del agente. Comuníquese con el soporte de NetApp para habilitar la función.

    API de instalación manual

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

Instalación de un nuevo agente

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

    1. Vaya a Admin > Acceso API. Seleccione la pestaña “Tokens de seguridad de carga de trabajo” y haga clic en “+ Token de acceso a API”.

      1. Establezca un nombre y una descripción que sean fáciles de identificar.

      2. En el menú desplegable “¿Qué tipo de API se usarán con este token para llamar?”, seleccione Administración de recopiladores e Instalación de agentes y recopiladores.

      3. Seleccione la duración de vencimiento deseada.

    2. Haga clic en Guardar.

  1. Copiar el token de acceso API generado. Tenga en cuenta que una vez cerrada la ventana ya no se podrá recuperar el token. En ese caso necesitarías generar un nuevo token.

    Crear y guardar token de API

    Confirmar la creación del token

    1. Vaya a Admin > Acceso API > Documentación API (arriba a la derecha de la página) y seleccione el ícono Seguridad de carga de trabajo. Esto abre la documentación de Swagger para las API de seguridad de carga de trabajo.

      Documentación de Swagger para la seguridad de la carga de trabajo

    2. Autorizar el acceso a las API de Seguridad de carga de trabajo.

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

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

  4. Haga clic en Autorizar y cierre la ventana.

    Autorizar la API

    1. Descargue el instalador del agente.

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

  6. En el campo plataforma, ingrese linux. Haga clic en Ejecutar.

    Swagger para la API de instalación del agente - superior API de instalación de Swagger para agentes: respuesta

  7. Haga clic en «Descargar archivo» para descargar el instalador.

  8. Si el archivo de instalación se descarga externamente en una máquina diferente del sistema donde se instalará el agente, copie el archivo de instalación a ese sistema.

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

    • Agregue el argumento “-o {{file_name}}” al comando curl para guardar el archivo de instalación con el nombre deseado. El nombre real del archivo de instalación se puede encontrar en la sección de encabezados de respuesta de swagger. También se puede utilizar ese nombre.

      Cómo elegir el agente más reciente a través de la API - Swagger

    • Aunque el archivo se puede descargar a cualquier ubicación, se recomienda descargarlo a una carpeta vacía en la que se pueda extraer el instalador .zip.

      1. Crea una nueva carpeta (recomendado), copia el archivo de instalación en esta carpeta y descomprímelo:

        [root@demo-agent /]# mkdir agent_installers
        [root@demo-agent /]# cd agent_installers/
        [root@demo-agent agent_installers]# pwd
        /agent_installers
        [root@demo-agent agent_installers]# ll
        total 0
        [root@demo-agent agent_installers]# curl -X GET "https://netapp-demo.dev.cloudsecure.netapp.com/rest/v1/cloudsecure/agents/installers/linux/latest" -H "accept: application/octet-stream" -H "X-CloudInsights-ApiKey: <<API Access Token>>" -o cloudsecure-linux-agent-installer-1.617.0.zip
        [root@demo-agent agent_installers]# ll
        total 76012
        -rw------- 1 root root 77834705 Apr 26 14:34 cloudsecure-linux-agent-installer-1.617.0.zip
        [root@demo-agent agent_installers]# unzip cloudsecure-linux-agent-installer-1.617.0.zip
        Archive:  cloudsecure-linux-agent-installer-1.617.0.zip
          inflating: cloudsecure-agent-image.zip
          inflating: cloudsecure-agent-install.sh
          inflating: cloudsecure-agent-upgrade.sh
      2. Establezca el permiso execute para el archivo “cloudsecure-agent-install.sh”.

        [root@demo-agent agent_installers]# chmod +x cloudsecure-agent-install.sh
        [root@demo-agent agent_installers]# ll
        total 153344
        -rw------- 1 root root 79154250 Apr 26 06:37 cloudsecure-agent-image.zip
        -rwx------ 1 root root    16574 Apr 26 06:25 cloudsecure-agent-install.sh
        -rw------- 1 root root     8586 Apr 26 06:25 cloudsecure-agent-upgrade.sh
        -rw------- 1 root root 77834705 Apr 26 14:34 cloudsecure-linux-agent-installer-1.617.0.zip
      3. Genere un token único para la instalación de un nuevo agente.

        Nota: El token de un solo uso generado en este paso es diferente del token de acceso a la API generado enPaso 1c .

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

    1. Exporte el token de un solo uso como una variable de entorno.

      [root@demo-agent ~]# export TOKEN=<<one time token generated in step 7>>
    2. Si se utiliza un servidor proxy, exporte https_proxy como una variable de entorno en el formato mencionado a continuación.

      [root@demo-agent ~]# export HTTPS_PROXY='USER:PASSWORD@PROXY_SERVER:PORT'
    3. Opcional: de forma predeterminada, el agente y los recopiladores se instalarán en la ruta “/opt/netapp”. Para instalar en una ruta diferente, configure la siguiente variable de entorno"

      [root@demo-agent ~]# export AGENT_INSTALL_PATH=/test_user/apps

      Nota: Si se instala en una ruta personalizada, los recopiladores de datos y todos los demás artefactos, como los registros del agente, se crearán únicamente dentro de la ruta personalizada. Los registros de instalación seguirán presentes en - /var/log/netapp/cloudsecure/install.

    4. Regrese al directorio donde se descargó el instalador del agente y ejecute “cloudsecure-agent-install.sh”

      [root@demo-agent agent_installers]# ./ cloudsecure-agent-install.sh

      Nota: Si el usuario no se está ejecutando en un shell “bash”, el comando de exportación podría no funcionar. En ese caso, los pasos 8 a 11 se pueden combinar y ejecutar como se indica a continuación. HTTPS_PROXY y AGENT_INSTALL_PATH son opcionales y pueden ignorarse si no son necesarios.

    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"

    +
    En este punto, el agente debería estar instalado correctamente.

    1. Comprobación de cordura para la instalación del agente:

  11. Ejecute “systemctl status cloudsecure-agent.service” y verifique que el servicio del agente esté en estado en ejecución.

    [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 -...
  12. El agente debe estar visible en la página “Agentes” y debe estar en estado “conectado”.

    Interfaz de usuario que muestra agentes conectados

    1. Limpieza posterior a la instalación.

  13. Si la instalación del agente es exitosa, se pueden eliminar los archivos de instalación del agente descargados.

Instalación de un nuevo recopilador de datos.

Nota: Este documento contiene instrucciones para instalar el “recolector de datos ONTAP SVM”. Los mismos pasos se aplican al “recopilador de datos de Cloud Volumes ONTAP ” y al “recopilador de datos de Amazon FSx for NetApp ONTAP ”.

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

    Nota: si el agente está instalado en /opt/netapp, navegue a /opt/netapp/cloudsecure.

    [root@demo-agent ~]# cd {agent-install-path}/cloudsecure
    [root@demo-agent ~]# mkdir -p ./tmp/collectors
  2. 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
  3. Ahora necesitamos obtener la versión del recopilador y el UUID del recopilador. Navegue a la API “cloudsecure_config.collector-types”.

  4. Vaya a Swagger, API “cloudsecure_config.collector-types > /v1/cloudsecure/collector-types” (GET). En el menú desplegable “CollectorCategory”, seleccione el tipo de recopilador como “DATOS”. Seleccione “TODOS” para obtener todos los detalles del tipo de recopilador.

  5. Copie el UUID del tipo de recopilador requerido.

    Respuesta de la API del recopilador que muestra UUID

  6. Descargar instalador del recopilador.

    1. Vaya a la API “cloudsecure_installers.collector > /v1/cloudsecure/collector-types/installers/{collectorTypeUUID}” (GET). Ingrese el UUID copiado del paso anterior y descargue el archivo de instalación.

      API para descargar recopilador por UUID

    2. Si el archivo de instalación se descarga externamente en una máquina diferente, copie el archivo de instalación al sistema donde se ejecuta el agente y colóquelo en el directorio /{agent-install-path}/cloudsecure/tmp/collectors.

    3. Alternativamente, puede copiar el comando curl de la misma API y ejecutarlo directamente en el sistema donde se instalará el recopilador.

      Tenga en cuenta que el nombre del archivo debe ser el mismo que el presente en los encabezados de respuesta de la API del recopilador de descargas. Vea la captura de pantalla a continuación.

      Nota: si el agente está instalado en /opt/netapp, navegue a /opt/netapp/cloudsecure/tmp/collectors.

      Ejemplo de comando Curl que muestra un token ofuscado

    [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
  7. 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
  8. Vaya a Seguridad de carga de trabajo > Recopiladores y seleccione +Recopilador. Seleccione el recopilador ONTAP SVM.

  9. Configure los detalles del recopilador y Guarde el recopilador.

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

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

    1. Vaya a “cloudsecure_config.collectors” > “/v1/cloudsecure/collectors” (POST) API.

    2. En el menú desplegable de ejemplo, seleccione “Muestra JSON del recopilador de datos ONTAP SVM”, actualice los detalles de configuración del recopilador y Ejecutar.

      API para agregar recopilador

  12. El recopilador ahora debería estar visible en la sección "Recopiladores de datos".

    Página de lista de IU que muestra los recolectores

  13. Limpieza posterior a la instalación.

    1. Si la instalación del recopilador es exitosa, se pueden eliminar todos los archivos en el directorio /{agent-install-path}/cloudsecure/tmp/collectors.

Instalación de un nuevo recopilador de directorios de usuarios

Nota: En este documento hemos mencionado los pasos para instalar un recopilador LDAP. Los mismos pasos se aplican para instalar un recopilador AD.

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

    Nota: si el agente está instalado en /opt/netapp, navegue a /opt/netapp/cloudsecure.

    [root@demo-agent ~]# cd {agent-install-path}/cloudsecure
    [root@demo-agent ~]# mkdir -p ./tmp/collectors
    1. Cambie la propiedad del directorio collectors a 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
  2. Ahora necesitamos obtener la versión y el UUID del recopilador. Navegue a la API “cloudsecure_config.collector-types”. En el menú desplegable CollectorCategory, seleccione el tipo de recopilador como “USUARIO”. Seleccione “TODOS” para obtener todos los detalles del tipo de recopilador en una sola solicitud.

    API para obtener todos los coleccionistas

  3. Copiar el UUID del recopilador LDAP.

    Respuesta de la API que muestra el UUID del recopilador LDAP

  4. Descargue el instalador del recopilador.

    1. Vaya a la API “cloudsecure_installers.collector” > “/v1/cloudsecure/collector-types/installers/{collectorTypeUUID}” (GET). Ingrese el UUID copiado del paso anterior y descargue el archivo de instalación.

      API y respuesta al recopilador de descargas

    2. Si el archivo de instalación se descarga externamente en una máquina diferente, copie el archivo de instalación al sistema donde se ejecuta el agente y en el directorio /{agent-installation-path}/cloudsecure/tmp/collectors.

    3. Alternativamente, puede copiar el comando curl desde la misma API y ejecutarlo directamente en el sistema donde debe instalarse el recopilador.

      Tenga en cuenta que el nombre del archivo debe ser el mismo que el presente en los encabezados de respuesta de la API del recopilador de descargas. Vea la captura de pantalla a continuación.

      Tenga en cuenta también que si el agente está instalado en /opt/netapp, navegue a /opt/netapp/cloudsecure/tmp/collectors.

      API de comando curl

    [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
  5. Cambiar 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
  6. Vaya a la página 'Recopiladores de directorios de usuarios' y haga clic en '+ Recopilador de directorios de usuarios'.

    Agregar un recopilador de directorios de usuarios

  7. Seleccione 'Servidor de directorio LDAP'.

    Ventana de interfaz de usuario para seleccionar un usuario LDAP

  8. Ingrese los detalles del servidor de directorio LDAP y haga clic en "Guardar"

    Interfaz de usuario que muestra los detalles del usuario LDAP

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

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

    1. Vaya a “cloudsecure_config.collectors” > “/v1/cloudsecure/collectors” (POST) API.

    2. En el menú desplegable de ejemplo, seleccione “Muestra JSON del recopilador de usuarios del servidor de directorio LDAP”, actualice los detalles de configuración del recopilador y haga clic en “Ejecutar”.

      API para el recopilador LDAP

  11. El recopilador ahora debería estar visible en la sección “Recopiladores del directorio de usuarios”.

    Lista de recopiladores LDAP en la interfaz de usuario

  12. Limpieza posterior a la instalación.

    1. Si la instalación del recopilador es exitosa, se pueden eliminar todos los archivos en el directorio /{agent-install-path}/cloudsecure/tmp/collectors.

Actualizar un agente

Se enviará una notificación por correo electrónico cuando esté disponible una nueva versión del agente/recopilador.

  1. Descargue el último instalador del agente.

    1. Los pasos para descargar el instalador más reciente son similares a los de “Instalación de un nuevo agente”. En Swagger, seleccione “cloudsecure_installers.agent” > “/v1/cloudsecure/agents/installers/{platform}/latest” API, ingrese la plataforma como “linux” y descargue el archivo zip del instalador. Alternativamente, también se puede utilizar un comando curl. Descomprima el archivo de instalación.

  2. Establezca 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
  3. Ejecute el script “cloudsecure-agent-upgrade.sh”. Si el script se ejecutó correctamente, imprimirá el mensaje “El agente de Cloudsecure se actualizó correctamente” en la salida.

  4. Ejecute el siguiente comando 'systemctl daemon-reload'

    [root@demo-agent ~]# systemctl daemon-reload
  5. Reinicie el servicio del agente.

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

    En este punto, el agente debería haberse actualizado correctamente.

  6. Comprobación de cordura después de la actualización del agente.

    1. Navegue hasta la ruta donde está instalado el agente (por ejemplo, “/opt/netapp/cloudsecure/”). El enlace simbólico “agente” debe apuntar a la nueva versión del agente.

      [root@demo-agent cloudsecure]# pwd
      /opt/netapp/cloudsecure
      [root@demo-agent cloudsecure]# ll
      total 40
      lrwxrwxrwx  1 cssys cssys  114 Apr 26 17:38 agent -> /test_user/apps/cloudsecure/cloudsecure-agent-1.618.0
      drwxr-xr-x  4 cssys cssys 4096 Apr 25 10:45 agent-certs
      drwx------  2 cssys cssys 4096 Apr 25 16:18 agent-logs
      drwx------ 11 cssys cssys 4096 Apr 26 02:50 cloudsecure-agent-1.617.0
      drwx------ 11 cssys cssys 4096 Apr 26 17:42 cloudsecure-agent-1.618.0
      drwxr-xr-x  3 cssys cssys 4096 Apr 26 02:45 collector-image
      drwx------  2 cssys cssys 4096 Apr 25 10:45 conf
      drwx------  3 cssys cssys 4096 Apr 26 16:39 data-collectors
      -rw-r--r--  1 root  root    66 Apr 25 10:45 sysctl.conf.bkp
      drwx------  2 root  root  4096 Apr 26 17:38 tmp
    2. El agente debe estar visible en la página “Agentes” y debe estar en estado “conectado”.

      Interfaz de usuario que muestra los agentes conectados

  7. Limpieza posterior a la instalación.

    1. Si la instalación del agente es exitosa, se pueden eliminar los archivos de instalación del agente descargados.

Actualización de coleccionistas

Nota: Los pasos de actualización son los mismos para todos los tipos de coleccionistas. En este documento demostraremos la actualización del recopilador “ONTAP SVM”.

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

    Nota: si el agente está instalado en /opt/netapp, navegue al directorio /opt/netapp/cloudsecure.

    [root@demo-agent ~]# cd {agent-install-path}/cloudsecure
    [root@demo-agent ~]# mkdir -p ./tmp/collectors
  2. Asegúrese de que el directorio “collectors” sea 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
  3. En Swagger, navegue a la API GET “cloudsecure_config.collector-types”. En el menú desplegable “collectorCategory”, seleccione “DATOS” (seleccione “USUARIO” para el recopilador del directorio de usuarios o “TODOS”).

    Copiar UUID y versión del cuerpo de la respuesta.

    Respuesta de la API que muestra el UUID del recopilador y la versión resaltados

  4. Descargue el último archivo de instalación del recopilador.

    1. Vaya a cloudsecure_installers.collector > /v1/cloudsecure/collector-types/installers/{collectorTypeUUID} API. Ingrese collectorTypeUUID copiado del paso anterior. Descargue el instalador en el directorio /{agent-install-path}/cloudsecure/tmp/collectors.

    2. Alternativamente, también se puede utilizar el comando curl de la misma API.

      Ejemplo de comando curl

    Nota: el nombre del archivo debe ser el mismo que aparece en los encabezados de respuesta de la API del recopilador de descargas.

  5. Cambiar 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
  6. Activar la API del recopilador de actualizaciones.

    1. En Swagger, navegue a “cloudsecure_installers.collector” > “/v1/cloudsecure/collector-types/upgrade” (PUT) API.

    2. En el menú desplegable “Ejemplos”, seleccione “Ejemplo de JSON de actualización del recopilador de datos ONTAP SVM” para completar la carga útil de muestra.

    3. Reemplazar la versión con la versión copiada dePaso 3 y haga clic en "Ejecutar".

      Ejemplo de actualización de SVM en la interfaz de usuario de Swagger

    Espere unos segundos. Los coleccionistas se actualizarán automáticamente.

  7. Comprobación de cordura.

    Los recolectores deben estar en estado de ejecución en la interfaz de usuario.

  8. Limpieza posterior a la actualización:

    1. Si la actualización del recopilador es exitosa, se pueden eliminar todos los archivos en el directorio /{agent-install-path}/cloudsecure/tmp/collectors.

Repita los pasos anteriores para actualizar otros tipos de recolectores también.

Problemas comunes y soluciones.

  1. Error AGENT014

    Este error aparecerá si el archivo de instalación del recopilador no está presente en el directorio /{agent-install-path}/cloudsecure/tmp/collectors o no es accesible. Asegúrese de que el archivo de instalación esté descargado y que la estructura de directorio completa de collectors y el archivo zip del instalador sean propiedad de cssys:cssys, luego reinicie el servicio del agente: systemctl restart cloudsecure-agent.service.

    Pantalla de IU que muestra el mensaje de error "agente 014" al pasar el mouse

  2. Error no autorizado

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

    Este error se mostrará si se genera el token de acceso a la API sin seleccionar todas las categorías de API requeridas. Genere un nuevo token de acceso a API seleccionando todas las categorías de API requeridas.