Skip to main content
NetApp Console setup and administration
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Implante manualmente o agente do NetApp Console no modo restrito

Colaboradores netapp-tonias
PDFs

Se você quiser usar o NetApp Console com conectividade de saída limitada, precisará implantar manualmente o agente do Console no modo restrito.

Se você não quiser usar uma assinatura do marketplace ou estiver implementando o Google Cloud, precisará instalar o agente do Console manualmente.

Etapa 1: preparar permissões na nuvem

Antes de instalar o agente do Console, prepare as permissões do provedor de nuvem necessárias para que ele possa gerenciar os recursos.

"Aprenda a preparar permissões de nuvem" .

Etapa 2: ativar as APIs do Google Cloud (somente para o Google Cloud)

Se você estiver instalando o agente do Console no Google Cloud, habilite as APIs necessárias em seu projeto antes da instalação. Essas APIs são necessárias para recursos específicos do Cloud Volumes ONTAP.

Passos

  1. "Habilite as APIs no seu projeto do Google Cloud"

    • API Cloud Build (necessária para implantações do Cloud Volumes ONTAP em modo privado usando o Infrastructure Manager)

    • API do Gerenciador de Implantação em Nuvem V2

    • API do Cloud Infrastructure Manager

    • API de registro em nuvem

    • API do Gerenciador de Recursos de Nuvem

    • API do mecanismo de computação

    • API de gerenciamento de identidade e acesso (IAM)

    • Cloud Key Management Service (KMS) API (necessária apenas se você planeja usar NetApp Backup and Recovery com chaves de criptografia gerenciadas pelo cliente (CMEK))

    • API de Cotas na Nuvem (necessária para implantações do Cloud Volumes ONTAP usando o Infrastructure Manager)

Etapa 3: preparar acesso à rede

Permita os endpoints de saída necessários para o provedor de nuvem em que você instala o agente do Console.

Endpoints do provedor de nuvem

Ambientes da AWS

Permita que esses endpoints de serviço da AWS gerenciem recursos da AWS, incluindo o FSx for ONTAP.

Pontos finais Propósito

Serviços da AWS (amazonaws.com):

  • CloudFormation

  • Nuvem de Computação Elástica (EC2)

  • Gerenciamento de Identidade e Acesso (IAM)

  • Serviço de Gerenciamento de Chaves (KMS)

  • Serviço de Token de Segurança (STS)

  • Serviço de Armazenamento Simples (S3)

Para gerenciar recursos da AWS. O ponto de extremidade depende da sua região da AWS. "Consulte a documentação da AWS para obter detalhes"

Amazon FSx for NetApp ONTAP:

  • api.workloads.netapp.com

O console baseado na web contata este endpoint para interagir com as APIs do Workload Factory, a fim de gerenciar e operar cargas de trabalho baseadas no FSx para ONTAP.

Ambientes do Azure

Permita os endpoints que se aplicam à sua região do Azure: pública, governamental ou da China.

Pontos finais Propósito

  • https://management.azure.com

  • https://login.microsoftonline.com

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

  • https://core.windows.net

Para gerenciar recursos em regiões públicas do Azure.

  • https://management.usgovcloudapi.net

  • https://login.microsoftonline.us

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

  • https://core.usgovcloudapi.net

Para gerenciar recursos em regiões governamentais do Azure.

  • https://management.chinacloudapi.cn

  • https://login.chinacloudapi.cn

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

  • https://core.chinacloudapi.cn

Para gerenciar recursos nas regiões do Azure China.

Ambientes do Google Cloud

Permita que esses endpoints da API do Google Cloud gerenciem recursos em seu projeto.

Pontos finais Propósito

  • 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 gerenciar recursos no Google Cloud.

Endpoints do NetApp Console

Permita os endpoints compartilhados para o Suporte da NetApp, os recursos do Console e a implantação e atualizações do agente do Console.

Pontos finais Propósito

Para obter informações sobre licenciamento e enviar mensagens AutoSupport para o suporte da NetApp.

Para atualizar as credenciais do NetApp Support Site (NSS) ou adicionar novas credenciais do NSS ao NetApp Console.

Para obter informações sobre licenciamento e enviar mensagens do AutoSupport ao suporte da NetApp, assim como receber atualizações de software para Cloud Volumes ONTAP.

Para fornecer recursos e serviços no NetApp Console.

Para regiões não governamentais, use os seguintes pontos de extremidade:

Para regiões governamentais, utilize o seguinte ponto de extremidade:

Para obter imagens para implantação e atualizações do agente do Console.

Para acesso via navegador e outros requisitos de rede, consulte "Prepare o acesso à rede para o modo restrito".

Etapa 4: instalar o Podman ou o Docker Engine

Dependendo do seu sistema operacional, o Podman ou o Docker Engine é necessário antes de instalar o agente.

Exemplo 1. Passos
Podman

Siga estas etapas para instalar e configurar o Podman:

  • Habilite e inicie o serviço podman.socket

  • Instalar python3

  • Instale o pacote podman-compose (varia conforme a versão do Red Hat)

  • Adicione podman-compose à variável de ambiente PATH

  • Se estiver usando o Red Hat Enterprise Linux, verifique se sua versão do Podman está usando o DNS Netavark Aardvark em vez do CNI

Observação Ajuste a porta aardvark-dns (padrão: 53) após instalar o agente para evitar conflitos de porta DNS. Siga as instruções para configurar a porta.
Passos

  1. Remova o pacote podman-docker se ele estiver instalado no host.

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

  2. Instale o Podman.

    Você pode obter o Podman nos repositórios oficiais do Red Hat Enterprise Linux.

    1. Para Red Hat Enterprise Linux 9,6:

      sudo dnf install podman-5:<version>

      Onde <versão> é a versão suportada do Podman que você está instalando. Veja as versões do Podman suportadas .

    2. Para Red Hat Enterprise Linux 9.1 a 9.4:

      sudo dnf install podman-4:<version>

      Onde <versão> é a versão suportada do Podman que você está instalando. Veja as versões do Podman suportadas .

    3. Para Red Hat Enterprise Linux 8:

      sudo dnf install podman-4:<version>

      Onde <versão> é a versão suportada do Podman que você está instalando. Veja as versões do Podman suportadas .

  3. Habilite e inicie o serviço podman.socket.

    sudo systemctl enable --now podman.socket

  4. Instale python3.

    sudo dnf install python3

  5. Instale o pacote do repositório EPEL se ele ainda não estiver disponível no seu sistema.

    Esta etapa é necessária porque o podman-compose está disponível no repositório Extra Packages for Enterprise Linux (EPEL).

  6. Se estiver usando o Red Hat Enterprise 9:

    1. Instale o pacote do repositório EPEL.

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

    +

    1. Instale o pacote podman-compose 1.5.0.

      sudo dnf install podman-compose-1.5.0

  7. Se estiver usando o Red Hat Enterprise Linux 8:

    1. Instale o pacote do repositório EPEL.

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

    2. Instale o pacote podman-compose 1.0.6.

      sudo dnf install podman-compose-1.0.6
      Observação Usando o dnf install O comando atende ao requisito de adicionar podman-compose à variável de ambiente PATH. O comando de instalação adiciona podman-compose a /usr/bin, que já está incluído no secure_path opção no host.

    3. Se estiver usando o Red Hat Enterprise Linux 8, verifique se sua versão do Podman está usando o NetAvark com o DNS Aardvark em vez do CNI.

      1. Verifique se o seu networkBackend está definido como CNI executando o seguinte comando:

        podman info | grep networkBackend

      2. Se o networkBackend estiver definido como CNI , você precisará alterá-lo para netavark .

      3. Instalar netavark e aardvark-dns usando o seguinte comando:

        dnf install aardvark-dns netavark

      4. Abra o /etc/containers/containers.conf arquivo e modifique a opção network_backend para usar "netavark" em vez de "cni".

        Se /etc/containers/containers.conf não existe, faça as alterações de configuração para /usr/share/containers/containers.conf .

      5. Reinicie o podman.

        systemctl restart podman

      6. Confirme se networkBackend foi alterado para "netavark" usando o seguinte comando:

        podman info | grep networkBackend

  8. Se você associar este agente a um Cloud Volumes ONTAP, considere aumentar o número de threads associadas ao agente para melhorar o desempenho. "Saiba mais sobre como aumentar o limite de threads do contêiner do agente".

Motor Docker

Siga a documentação do Docker para instalar o Docker Engine.

Passos

  1. "Ver instruções de instalação do Docker"

    Siga as etapas para instalar uma versão compatível do Docker Engine. Não instale a versão mais recente, pois ela não é suportada pelo Console.

  2. Verifique se o Docker está habilitado e em execução.

    sudo systemctl enable docker && sudo systemctl start docker

Etapa 5: instale manualmente o modo restrito do NetApp Console em seu ambiente de nuvem (deve ser usado para o Google Cloud)

Você pode instalar o agente do Console manualmente em seu próprio host Linux em execução na AWS, Azure ou Google Cloud.

Antes de começar

Você deve ter o seguinte:

  • Privilégios de root para instalar o agente do Console.

  • Detalhes sobre um servidor proxy, caso um proxy seja necessário para acesso à Internet a partir do agente do Console.

    Você tem a opção de configurar um servidor proxy após a instalação, mas isso requer a reinicialização do agente do Console.

  • Um certificado assinado pela CA, se o servidor proxy usar HTTPS ou se o proxy for um proxy de interceptação.

Observação Não é possível definir um certificado para um servidor proxy transparente ao instalar manualmente o agente do Console. Se precisar definir um certificado para um servidor proxy transparente, você deverá usar o Console de Manutenção após a instalação. Saiba mais sobre o"Console de manutenção do agente" .
Sobre esta tarefa

Após a instalação, o agente do Console se atualiza automaticamente se uma nova versão estiver disponível.

Passos

  1. Se as variáveis de sistema http_proxy ou https_proxy estiverem definidas no host, remova-as:

    unset http_proxy
unset https_proxy

    Se você não remover essas variáveis do sistema, a instalação falhará.

  2. Baixe o software do agente do Console e copie-o para o host Linux. Você pode baixá-lo tanto do NetApp Console quanto do site de suporte da NetApp .

    • NetApp Console: Acesse Agentes > Gerenciamento > Implantar agente > Local > Instalação manual.

      Escolha baixar os arquivos de instalação do agente ou um URL para os arquivos.

    • "Site de suporte da NetApp" (necessário caso você ainda não tenha acesso ao Console).

      Observação Baixe o instalador do agente "online" destinado ao uso em sua rede ou na nuvem. Um instalador "offline" separado está disponível para o agente do Console, mas é compatível apenas com implantações em modo privado.

    • NetApp site de suporte da NetApp (necessário caso você ainda não tenha acesso ao Console) "Site de suporte da NetApp".

  3. Atribua permissões para executar o script.

    chmod +x NetApp_Console_Agent_Cloud_<version>

    Onde <versão> é a versão do agente do Console que você baixou.

  4. Se estiver instalando em um ambiente de nuvem governamental, desative as verificações de configuração."Aprenda como desabilitar verificações de configuração para instalações manuais."

  5. Execute o script de instalação.

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

    Você precisará adicionar informações de proxy se sua rede exigir um proxy para acesso à internet. Você pode adicionar um proxy explícito durante a instalação. Os parâmetros --proxy e --cacert são opcionais e você não será solicitado a adicioná-los. Se você tiver um servidor proxy explícito, precisará inserir os parâmetros conforme mostrado.

    Observação Se você deseja configurar um proxy transparente, poderá fazê-lo após a instalação. "Saiba mais sobre o console de manutenção do agente.".

    Aqui está um exemplo de como configurar explicitamente um servidor proxy com um certificado assinado por uma Autoridade Certificadora (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 o agente do Console para usar um servidor proxy HTTP ou HTTPS usando um dos seguintes formatos:

    • http://endereço:porta

    • http://nome-de-usuário:senha@endereço:porta

    • http://nome-de-domínio%92nome-de-usuário:senha@endereço:porta

    • https://endereço:porta

    • https://nome-de-usuário:senha@endereço:porta

    • https://nome-de-domínio%92nome-de-usuário:senha@endereço:porta

      Observe o seguinte:

      • O usuário pode ser um usuário local ou de domínio.

      • Para um usuário de domínio, você deve usar o código ASCII para um \, conforme mostrado acima.

      • O agente do Console não suporta nomes de usuário ou senhas que incluam o caractere @.

      • Se a senha incluir qualquer um dos seguintes caracteres especiais, você deverá escapar esse caractere especial colocando uma barra invertida antes dele: & ou !

        Por exemplo:

    http://bxpproxyuser:netapp1\!@endereço:3128

  6. Se você usou o Podman, precisará ajustar a porta aardvark-dns.

    1. SSH para a máquina virtual do agente do Console.

    2. Abra o arquivo podman /usr/share/containers/containers.conf e modifique a porta escolhida para o serviço DNS do Aardvark. Por exemplo, altere para 54.

      vi /usr/share/containers/containers.conf

      Por exemplo:

    # 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 a máquina virtual do agente do Console.

Resultado

O agente do Console agora está instalado. No final da instalação, o serviço do agente do Console (occm) será reiniciado duas vezes se você tiver especificado um servidor proxy.

O que vem a seguir?

Configurar o NetApp Console.

Etapa 6: configurar o NetApp Console

Ao acessar o console pela primeira vez, você será solicitado a escolher uma organização para o agente do Console e precisará habilitar o modo restrito.

Antes de começar

A pessoa que configura o agente do Console deve fazer login no Console usando um login que ainda não pertença a uma organização do Console.

Se o seu login estiver associado a outra organização, você precisará se cadastrar com um novo login. Caso contrário, você não verá a opção para ativar o modo restrito na tela de configuração.

Passos

  1. Abra um navegador da Web em um host que tenha uma conexão com a instância do agente do Console e insira a seguinte URL do agente do Console que você instalou.

  2. Inscreva-se ou faça login no NetApp Console.

  3. Após efetuar login, configure o Console:

    1. Digite um nome para o agente do Console.

    2. Insira um nome para uma nova organização do Console.

    3. Selecione Você está executando em um ambiente seguro?

    4. Selecione Ativar modo restrito nesta conta.

      Observe que você não pode alterar essa configuração depois que a conta for criada. Você não poderá ativar o modo restrito mais tarde, nem desativá-lo mais tarde.

    Se você implantou o agente do Console em uma região governamental, a caixa de seleção já estará habilitada e não poderá ser alterada. Isso ocorre porque o modo restrito é o único modo suportado nas regiões governamentais.

    1. Selecione Vamos começar.

Resultado

O agente do Console agora está instalado e configurado com sua organização do Console. Todos os usuários precisam acessar o Console usando o endereço IP da instância do agente do Console.

O que vem a seguir?

Forneça ao Console as permissões que você configurou anteriormente.

Etapa 7: conceda permissões ao agente do Console

Se você instalou o agente do Console manualmente, precisará conceder as permissões que configurou anteriormente.

"Aprenda a preparar permissões de nuvem" .

Função do AWS IAM

Anexe a função do IAM que você criou anteriormente à instância do EC2 onde instalou o agente do Console.

Estas etapas se aplicam somente se você instalou manualmente o agente do Console na AWS. Para implantações do AWS Marketplace, você já associou a instância do agente do Console a uma função do IAM que inclui as permissões necessárias.

Passos

  1. Acesse o console do Amazon EC2.

  2. Selecione Instâncias.

  3. Selecione a instância do agente do Console.

  4. Selecione Ações > Segurança > Modificar função do IAM.

  5. Selecione a função do IAM e selecione Atualizar função do IAM.

Chave de acesso AWS

Forneça ao NetApp Console a chave de acesso da AWS para um usuário do IAM que tenha as permissões necessárias.

Passos

  1. Selecione Administração > Credenciais.

  2. Selecione Credenciais da organização.

  3. Selecione Adicionar credenciais e siga as etapas do assistente.

    1. Localização das credenciais: Selecione Amazon Web Services > Agente.

    2. Definir credenciais: insira uma chave de acesso e uma chave secreta da AWS.

    3. Assinatura do Marketplace: Associe uma assinatura do Marketplace a essas credenciais assinando agora ou selecionando uma assinatura existente.

    4. Revisar: Confirme os detalhes sobre as novas credenciais e selecione Adicionar.

Função do Azure

Acesse o portal do Azure e atribua a função personalizada do Azure à máquina virtual do agente do Console para uma ou mais assinaturas.

Passos

  1. No Portal do Azure, abra o serviço Assinaturas e selecione sua assinatura.

    É importante atribuir a função do serviço Assinaturas porque isso especifica o escopo da atribuição de função no nível da assinatura. O escopo define o conjunto de recursos aos quais o acesso se aplica. Se você especificar um escopo em um nível diferente (por exemplo, no nível da máquina virtual), sua capacidade de concluir ações no NetApp Console será afetada.

    "Documentação do Microsoft Azure: Entenda o escopo do RBAC do Azure"

  2. Selecione Controle de acesso (IAM) > Adicionar > Adicionar atribuição de função.

  3. Na guia Função, selecione a função Operador de console e selecione Avançar.

    Observação Operador do console é o nome padrão fornecido na política. Se você escolheu um nome diferente para a função, selecione esse nome.

  4. Na aba Membros, complete os seguintes passos:

    1. Atribuir acesso a uma Identidade gerenciada.

    2. Selecione Selecionar membros, selecione a assinatura na qual a máquina virtual do agente do Console foi criada, em Identidade gerenciada, escolha Máquina virtual e selecione a máquina virtual do agente do Console.

    3. Selecione Selecionar.

    4. Selecione Avançar.

    5. Selecione Revisar + atribuir.

    6. Se você quiser gerenciar recursos em assinaturas adicionais do Azure, alterne para essa assinatura e repita essas etapas.

Principal de serviço do Azure

Forneça ao NetApp Console as credenciais da entidade de serviço do Azure que você configurou anteriormente.

Passos

  1. Selecione Administração > Credenciais.

  2. Selecione Adicionar credenciais e siga as etapas do assistente.

    1. Localização das credenciais: Selecione Microsoft Azure > Agente.

    2. Definir credenciais: insira informações sobre a entidade de serviço do Microsoft Entra que concede as permissões necessárias:

      • ID do aplicativo (cliente)

      • ID do diretório (inquilino)

      • Segredo do cliente

    3. Assinatura do Marketplace: Associe uma assinatura do Marketplace a essas credenciais assinando agora ou selecionando uma assinatura existente.

    4. Revisar: Confirme os detalhes sobre as novas credenciais e selecione Adicionar.

Resultado

O NetApp Console agora possui as permissões necessárias para executar ações no Azure em seu nome.

Conta de serviço do Google Cloud

Associe a conta de serviço à VM do agente do Console.

Passos

  1. Acesse o portal do Google Cloud e atribua a conta de serviço à instância de VM do agente do Console.

    "Documentação do Google Cloud: Alterando a conta de serviço e os escopos de acesso de uma instância"

  2. Se você quiser gerenciar recursos em outros projetos, conceda acesso adicionando a conta de serviço com a função de agente do Console a esse projeto. Você precisará repetir esta etapa para cada projeto.