Skip to main content
NetApp Console setup and administration
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.

Implementa manualmente el agente de NetApp Console en modo restringido

Colaboradores netapp-tonias
PDF

Si quieres usar NetApp Console con conectividad saliente limitada, debes implementar manualmente el agente de NetApp Console en modo restringido.

Si no quieres usar una suscripción de marketplace o estás implementando Google Cloud, tendrás que instalar manualmente el agente de NetApp Console.

Paso 1: preparar los permisos en la nube

Antes de instalar el agente de NetApp Console, configura los permisos del proveedor de nube que necesita para gestionar recursos.

"Aprenda a preparar los permisos en la nube" .

Paso 2: habilita las API de Google Cloud (solo Google Cloud)

Si vas a instalar el agente de NetApp Console en Google Cloud, habilita las API necesarias en tu proyecto antes de la instalación. Estas API son necesarias para determinadas funciones de Cloud Volumes ONTAP.

Pasos

  1. "Activa las APIs en tu proyecto de Google Cloud"

    • Cloud Build API (necesaria para implementaciones de Cloud Volumes ONTAP en modo privado usando Infrastructure Manager)

    • API de Cloud Deployment Manager V2

    • API de Cloud Infrastructure Manager

    • API de registro en la nube

    • API del administrador de recursos en la nube

    • API de Compute Engine

    • API de gestión de identidad y acceso (IAM)

    • API del servicio de gestión de claves en la nube (KMS) (necesaria solo si planeas usar NetApp Backup and Recovery con claves de cifrado gestionadas por el cliente (CMEK))

    • API de Cloud Quotas (necesaria para implementaciones de Cloud Volumes ONTAP usando Infrastructure Manager)

Paso 3: preparar el acceso a la red

Permite los endpoints de salida necesarios para el proveedor de nube en el que instales el agente de NetApp Console.

Puntos de conexión de los proveedores de nube

Entornos AWS

Permite que estos puntos de conexión de los servicios de AWS gestionen los recursos de AWS, incluidos FSx for ONTAP.

Puntos finales Objetivo

Servicios de AWS (amazonaws.com):

  • Formación de nubes

  • Nube de cómputo elástica (EC2)

  • Gestión de identidad y acceso (IAM)

  • Servicio de gestión de claves (KMS)

  • Servicio de token de seguridad (STS)

  • Servicio de almacenamiento simple (S3)

Para administrar los recursos de AWS. El punto final depende de su región de AWS. "Consulte la documentación de AWS para obtener más detalles."

Amazon FSx for NetApp ONTAP:

  • api.workloads.netapp.com

La consola basada en web se comunica con este punto final para interactuar con las API de Workload Factory para administrar y operar cargas de trabajo basadas en FSx para ONTAP.

Entornos de Azure

Permite los endpoints que correspondan a tu región de Azure: pública, Government o China.

Puntos finales Objetivo

  • https://management.azure.com

  • https://login.microsoftonline.com

  • https://blob.core.windows.net

  • https://core.windows.net

Para administrar recursos en regiones públicas de Azure.

  • https://management.usgovcloudapi.net

  • https://login.microsoftonline.us

  • https://*.blob.core.usgovcloudapi.net

  • https://core.usgovcloudapi.net

Para administrar recursos en regiones de Azure Government.

  • https://management.chinacloudapi.cn

  • https://login.chinacloudapi.cn

  • https://blob.core.chinacloudapi.cn

  • https://core.chinacloudapi.cn

Para administrar recursos en las regiones de Azure China.

Entornos de Google Cloud

Permite que estos endpoints de API de Google Cloud gestionen recursos en tu proyecto.

Puntos finales Objetivo

  • https://www.googleapis.com/compute/v1/

  • https://compute.googleapis.com/compute/v1

  • https://cloudresourcemanager.googleapis.com/v1/projects

  • https://www.googleapis.com/compute/beta

  • https://storage.googleapis.com/storage/v1

  • https://www.googleapis.com/storage/v1

  • https://iam.googleapis.com/v1

  • https://cloudkms.googleapis.com/v1

  • https://config.googleapis.com/v1/projects

Para administrar recursos en Google Cloud.

Endpoints de NetApp Console

Permite los endpoints compartidos para el soporte de NetApp, las funciones de NetApp Console y la implementación y las actualizaciones del agente de NetApp Console.

Puntos finales Objetivo

Para obtener información sobre licencias y enviar mensajes de AutoSupport al soporte de NetApp.

Para actualizar las credenciales del sitio de soporte de NetApp (NSS) o para agregar nuevas credenciales de NSS a la NetApp Console.

Para obtener información sobre licencias y enviar mensajes de AutoSupport al soporte de NetApp, así como para recibir actualizaciones de software para Cloud Volumes ONTAP.

Proporcionar funciones y servicios dentro de la NetApp Console.

Para las regiones no gubernamentales, utiliza los siguientes endpoints:

Para las regiones gubernamentales, usa el siguiente endpoint en su lugar:

Para obtener imágenes para la implementación y las actualizaciones del agente de NetApp Console.

Para obtener información sobre el acceso desde el navegador y otros requisitos de red, consulta "Prepara el acceso a la red para el modo restringido".

Paso 4: Instalar Podman o Docker Engine

Dependiendo de su sistema operativo, se requiere Podman o Docker Engine antes de instalar el agente.

Ejemplo 1. Pasos
Podman

Siga estos pasos para instalar y configurar Podman:

  • Habilitar e iniciar el servicio podman.socket

  • Instalar Python3

  • Instala el paquete podman-compose (varía según la versión de Red Hat)

  • Agregue podman-compose a la variable de entorno PATH

  • Si usa Red Hat Enterprise Linux, verifique que su versión de Podman esté usando Netavark Aardvark DNS en lugar de CNI

Nota Ajuste el puerto aardvark-dns (predeterminado: 53) después de instalar el agente para evitar conflictos en el puerto DNS. Siga las instrucciones para configurar el puerto.
Pasos

  1. Elimine el paquete podman-docker si está instalado en el host.

    dnf remove podman-docker
rm /var/run/docker.sock

  2. Instalar Podman.

    Puede obtener Podman desde los repositorios oficiales de Red Hat Enterprise Linux.

    1. Para Red Hat Enterprise Linux 9,6:

      sudo dnf install podman-5:<version>

      Donde <versión> es la versión compatible de Podman que estás instalando. Ver las versiones compatibles de Podman .

    2. Para Red Hat Enterprise Linux 9.1 a 9.4:

      sudo dnf install podman-4:<version>

      Donde <versión> es la versión compatible de Podman que estás instalando. Ver las versiones compatibles de Podman .

    3. Para Red Hat Enterprise Linux 8:

      sudo dnf install podman-4:<version>

      Donde <versión> es la versión compatible de Podman que estás instalando. Ver las versiones compatibles de Podman .

  3. Habilite e inicie el servicio podman.socket.

    sudo systemctl enable --now podman.socket

  4. Instalar python3.

    sudo dnf install python3

  5. Instale el paquete del repositorio EPEL si aún no está disponible en su sistema.

    Este paso es necesario porque podman-compose está disponible en el repositorio de Paquetes adicionales para Enterprise Linux (EPEL).

  6. Si utiliza Red Hat Enterprise 9:

    1. Instalar el paquete del repositorio EPEL.

    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

    +

    1. Instalar el paquete podman-compose 1.5.0.

      sudo dnf install podman-compose-1.5.0

  7. Si utiliza Red Hat Enterprise Linux 8:

    1. Instalar el paquete del repositorio EPEL.

      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

    2. Instalar el paquete podman-compose 1.0.6.

      sudo dnf install podman-compose-1.0.6
      Nota Usando el dnf install El comando cumple con el requisito de agregar podman-compose a la variable de entorno PATH. El comando de instalación agrega podman-compose a /usr/bin, que ya está incluido en el secure_path opción en el host.

    3. Si usa Red Hat Enterprise Linux 8, verifique que su versión de Podman esté usando NetAvark con Aardvark DNS en lugar de CNI.

      1. Verifique si su networkBackend está configurado en CNI ejecutando el siguiente comando:

        podman info | grep networkBackend

      2. Si la red Backend está configurada en CNI , tendrás que cambiarlo a netavark .

      3. Instalar netavark y aardvark-dns utilizando el siguiente comando:

        dnf install aardvark-dns netavark

      4. Abrir el /etc/containers/containers.conf archivo y modificar la opción network_backend para usar "netavark" en lugar de "cni".

        Si /etc/containers/containers.conf no existe, realice los cambios de configuración a /usr/share/containers/containers.conf .

      5. Reiniciar podman.

        systemctl restart podman

      6. Confirme que networkBackend ahora se cambió a "netavark" usando el siguiente comando:

        podman info | grep networkBackend

  8. Si vas a asociar este agente a un sistema Cloud Volumes ONTAP, considera aumentar el número de subprocesos asociados al agente para mejorar el rendimiento. "Infórmate sobre cómo aumentar el límite de subprocesos del contenedor del agente".

Motor Docker

Siga la documentación de Docker para instalar Docker Engine.

Pasos

  1. "Ver instrucciones de instalación desde Docker"

    Siga los pasos para instalar una versión compatible de Docker Engine. No instale la última versión, ya que la consola no es compatible.

  2. Verifique que Docker esté habilitado y ejecutándose.

    sudo systemctl enable docker && sudo systemctl start docker

Paso 5: instala manualmente el modo restringido de NetApp Console en tu entorno de nube (debes usarlo para Google Cloud)

Puede instalar el agente de consola manualmente en su propio host Linux que se ejecuta en AWS, Azure o Google Cloud.

Antes de empezar

Debes tener lo siguiente:

  • Privilegios de root para instalar el agente de consola.

  • Detalles sobre un servidor proxy, si se requiere un proxy para el acceso a Internet desde el agente de la consola.

    Tienes la opción de configurar un servidor proxy después de la instalación, pero hacerlo requiere reiniciar el agente de la NetApp Console.

  • Un certificado firmado por una CA, si el servidor proxy usa HTTPS o si el proxy es un proxy interceptor.

Nota No es posible configurar un certificado para un servidor proxy transparente al instalar manualmente el agente de consola. Si necesita configurar un certificado para un servidor proxy transparente, debe utilizar la Consola de mantenimiento después de la instalación. Obtén más información sobre "Consola de mantenimiento del agente".
Acerca de esta tarea

Después de la instalación, el agente de consola se actualiza automáticamente si hay una nueva versión disponible.

Pasos

  1. Si las variables del sistema http_proxy o https_proxy están configuradas en el host, elimínelas:

    unset http_proxy
unset https_proxy

    Si no elimina estas variables del sistema, la instalación fallará.

  2. Descargue el software del agente de consola y luego cópielo al host Linux. Puede descargarlo desde la NetApp Console o desde el sitio de soporte de NetApp .

    • NetApp Console: Ve a Agentes > Gestión > Desplegar agente > On-prem > Instalación manual.

      Elige descargar los archivos de instalación del agente o una URL a los archivos.

    • "Sitio de soporte de NetApp" (necesario si aún no tienes acceso a la NetApp Console).

      Nota Descarga el instalador del agente "online" que está pensado para usar en tu red o en la cloud. Hay un instalador "offline" independiente para el agente de la Console, pero solo es compatible con implementaciones en modo privado.

    • NetApp Support Site (necesario si aún no tienes acceso a la consola) "Sitio de soporte de NetApp".

  3. Asignar permisos para ejecutar el script.

    chmod +x NetApp_Console_Agent_Cloud_<version>

    Donde <versión> es la versión del agente de consola que descargó.

  4. Si realiza la instalación en un entorno de nube gubernamental, desactive las comprobaciones de configuración."Aprenda cómo deshabilitar las comprobaciones de configuración para instalaciones manuales."

  5. Ejecute el script de instalación.

    ./NetApp_Console_Agent_Cloud_<version> --proxy <HTTP or HTTPS proxy server> --cacert <path and file name of a CA-signed certificate>

    Tendrás que añadir información del proxy si tu red requiere un proxy para acceder a internet. Puedes añadir un proxy explícito durante la instalación. Los parámetros --proxy y --cacert son opcionales y no se te pedirá que los añadas. Si tienes un servidor proxy explícito, tendrás que ingresar los parámetros como se muestra.

    Nota Si quieres configurar un proxy transparente, puedes hacerlo después de instalar. "Obtenga información sobre la consola de mantenimiento del agente.".

    He aquí un ejemplo de configuración de un servidor proxy explícito con un certificado firmado por una CA:

    ./NetApp_Console_Agent_Cloud_v4.0.0 --proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer
./NetApp_Console_Agent_Cloud_v4.0.0 --proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer

    --proxy configura el agente de Console para usar un servidor proxy HTTP o HTTPS usando uno de los siguientes formatos:

    • http://dirección:puerto

    • http://nombre-de-usuario:contraseña@dirección:puerto

    • http://nombre-de-dominio%92nombre-de-usuario:contraseña@dirección:puerto

    • https://dirección:puerto

    • https://nombre-de-usuario:contraseña@dirección:puerto

    • https://nombre-de-dominio%92nombre-de-usuario:contraseña@dirección:puerto

      Tenga en cuenta lo siguiente:

      • El usuario puede ser un usuario local o un usuario de dominio.

      • Para un usuario de dominio, debe utilizar el código ASCII para un \ como se muestra arriba.

      • El agente de la Console no admite nombres de usuario o contraseñas que incluyan el carácter @.

      • Si la contraseña incluye alguno de los siguientes caracteres especiales, debe escapar ese carácter especial anteponiéndolo con una barra invertida: & o !

        Por ejemplo:

    http://bxpproxyuser:netapp1\!@dirección:3128

  6. Si utilizó Podman, necesitará ajustar el puerto aardvark-dns.

    1. SSH a la máquina virtual del agente de consola.

    2. Abra el archivo podman /usr/share/containers/containers.conf y modifique el puerto elegido para el servicio DNS de Aardvark. Por ejemplo, cámbielo a 54.

      vi /usr/share/containers/containers.conf

      Por ejemplo:

    # Port to use for dns forwarding daemon with netavark in rootful bridge
# mode and dns enabled.
# Using an alternate port might be useful if other DNS services should
# run on the machine.
#
dns_bind_port = 54

    1. Reinicie la máquina virtual del agente de consola.

Resultado

El agente de consola ahora está instalado. Al final de la instalación, el servicio del agente de consola (occm) se reinicia dos veces si especificó un servidor proxy.

¿Que sigue?

Configurar la NetApp Console.

Paso 6: configura NetApp Console

Cuando accede a la consola por primera vez, se le solicita que elija una organización para el agente de la consola y debe habilitar el modo restringido.

Antes de empezar

La persona que configura el agente de la consola debe iniciar sesión en la consola utilizando un inicio de sesión que no pertenezca a una organización de la consola.

Si su inicio de sesión está asociado con otra organización, deberá registrarse con un nuevo inicio de sesión. De lo contrario, no verá la opción para habilitar el modo restringido en la pantalla de configuración.

Pasos

  1. Abra un navegador web desde un host que tenga una conexión a la instancia del agente de consola e ingrese la siguiente URL del agente de consola que instaló.

  2. Regístrese o inicie sesión en la NetApp Console.

  3. Después de iniciar sesión, configure la consola:

    1. Introduzca un nombre para el agente de consola.

    2. Introduzca un nombre para una nueva organización de la consola.

    3. Seleccione ¿Está ejecutando en un entorno seguro?

    4. Seleccione Habilitar modo restringido en esta cuenta.

      Tenga en cuenta que no puede cambiar esta configuración una vez creada la cuenta. No puedes habilitar el modo restringido más tarde ni puedes deshabilitarlo más tarde.

    Si implementó el agente de consola en una región gubernamental, la casilla de verificación ya está habilitada y no se puede cambiar. Esto se debe a que el modo restringido es el único modo compatible en las regiones gubernamentales.

    1. Seleccione Comencemos.

Resultado

El agente de consola ahora está instalado y configurado con su organización de consola. Todos los usuarios deben acceder a la consola utilizando la dirección IP de la instancia del agente de la consola.

¿Que sigue?

Proporcione a la consola los permisos que configuró previamente.

Paso 7: conceder permisos al agente de NetApp Console

Si has instalado manualmente el agente de NetApp Console, debes conceder los permisos que configuraste antes.

"Aprenda a preparar los permisos en la nube" .

Rol de AWS IAM

Adjunte la función IAM que creó previamente a la instancia EC2 donde instaló el agente de consola.

Estos pasos se aplican solo si instaló manualmente el agente de consola en AWS. Para las implementaciones de AWS Marketplace, ya asoció la instancia del agente de consola con un rol de IAM que incluye los permisos necesarios.

Pasos

  1. Vaya a la consola de Amazon EC2.

  2. Seleccionar Instancias.

  3. Seleccione la instancia del agente de consola.

  4. Seleccione Acciones > Seguridad > Modificar rol de IAM.

  5. Seleccione el rol de IAM y seleccione Actualizar rol de IAM.

Clave de acceso de AWS

Proporcione a la NetApp Console la clave de acceso de AWS para un usuario de IAM que tenga los permisos necesarios.

Pasos

  1. Seleccione Administración > Credenciales.

  2. Seleccione Credenciales de la organización.

  3. Seleccione Agregar credenciales y siga los pasos del asistente.

    1. Ubicación de credenciales: seleccione Amazon Web Services > Agente.

    2. Definir credenciales: ingrese una clave de acceso de AWS y una clave secreta.

    3. Suscripción al Marketplace: asocie una suscripción al Marketplace con estas credenciales suscribiéndose ahora o seleccionando una suscripción existente.

    4. Revisar: Confirme los detalles sobre las nuevas credenciales y seleccione Agregar.

Rol de Azure

Vaya al portal de Azure y asigne el rol personalizado de Azure a la máquina virtual del agente de consola para una o más suscripciones.

Pasos

  1. Desde el Portal de Azure, abra el servicio Suscripciones y seleccione su suscripción.

    Es importante asignar el rol desde el servicio Suscripciones porque esto especifica el alcance de la asignación del rol a nivel de suscripción. El scope define el conjunto de recursos al que se aplica el acceso. Si especifica un alcance en un nivel diferente (por ejemplo, en el nivel de máquina virtual), su capacidad para completar acciones desde la NetApp Console se verá afectada.

    "Documentación de Microsoft Azure: Comprender el alcance de Azure RBAC"

  2. Seleccione Control de acceso (IAM) > Agregar > Agregar asignación de rol.

  3. En la pestaña Rol, seleccione el rol Operador de consola y seleccione Siguiente.

    Nota Operador de consola es el nombre predeterminado proporcionado en la política. Si eligió un nombre diferente para el rol, seleccione ese nombre en su lugar.

  4. En la pestaña Miembros, complete los siguientes pasos:

    1. Asignar acceso a una Identidad administrada.

    2. Seleccione Seleccionar miembros, seleccione la suscripción en la que se creó la máquina virtual del agente de consola, en Identidad administrada, elija Máquina virtual y, luego, seleccione la máquina virtual del agente de consola.

    3. Seleccionar Seleccionar.

    4. Seleccione Siguiente.

    5. Seleccione Revisar + asignar.

    6. Si desea administrar recursos en suscripciones de Azure adicionales, cambie a esa suscripción y repita estos pasos.

entidad de servicio de Azure

Proporciona a la consola NetApp las credenciales de la entidad de servicio principal de Azure que configuraste anteriormente.

Pasos

  1. Seleccione Administración > Credenciales.

  2. Seleccione Agregar credenciales y siga los pasos del asistente.

    1. Ubicación de credenciales: seleccione Microsoft Azure > Agente.

    2. Definir credenciales: ingrese información sobre la entidad de servicio de Microsoft Entra que otorga los permisos necesarios:

      • ID de la aplicación (cliente)

      • ID de directorio (inquilino)

      • Secreto del cliente

    3. Suscripción al Marketplace: asocie una suscripción al Marketplace con estas credenciales suscribiéndose ahora o seleccionando una suscripción existente.

    4. Revisar: Confirme los detalles sobre las nuevas credenciales y seleccione Agregar.

Resultado

La NetApp Console ahora tiene los permisos que necesita para realizar acciones en Azure en tu nombre.

Cuenta de servicio de Google Cloud

Asocie la cuenta de servicio con la máquina virtual del agente de consola.

Pasos

  1. Vaya al portal de Google Cloud y asigne la cuenta de servicio a la instancia de VM del agente de consola.

    "Documentación de Google Cloud: Cómo cambiar la cuenta de servicio y los ámbitos de acceso de una instancia"

  2. Si desea administrar recursos en otros proyectos, otorgue acceso agregando la cuenta de servicio con el rol de agente de consola a ese proyecto. Necesitarás repetir este paso para cada proyecto.