Verifique no swagger se as categorias de API denominadas “cloudsecure_installers.agent” e “cloudsecure_installers.collector” estão disponíveis. Caso contrário, o suporte para instalação manual do agente não será habilitado. Entre em contato com o suporte da NetApp para habilitar o recurso.

Execute todos os comandos mencionados neste documento como usuário 'root' ou, se estiver executando com um usuário diferente, execute os comandos com 'sudo'.

Crie um novo token de acesso à API de segurança de carga de trabalho.

Copie o token de acesso da API gerado. Observe que, depois que a janela for fechada, o token não poderá mais ser recuperado. Nesse caso, você precisará gerar um novo token.

Clique no botão Autorizar no canto superior direito da página.

No campo de texto Customer ApiKey (apiKey), cole o token de API copiado anteriormente deEtapa 1c .

Clique em Autorizar e feche a janela.

No Swagger, selecione cloudsecure_installers.agent > /v1/cloudsecure/agents/installers/{platform}/latest (GET) API. Clique em Experimentar.

No campo plataforma, digite linux. Clique em Executar.

Clique em "Baixar arquivo" para baixar o instalador.

Se o arquivo do instalador for baixado externamente em uma máquina diferente do sistema onde o agente será instalado, copie o arquivo do instalador para esse sistema.

Como alternativa, você pode copiar o comando curl e executá-lo diretamente no sistema onde o agente deve ser instalado.

No Swagger, execute cloudsecure_installers.agent > /v1/cloudsecure/agent/oneTimeToken API e copie o token da resposta.

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"

Execute “systemctl status cloudsecure-agent.service” e verifique se o serviço do agente está no estado em execução.

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

O agente deve estar visível na página “Agentes” e deve estar no estado “conectado”.

Se a instalação do agente for bem-sucedida, os arquivos do instalador do agente baixados poderão ser excluídos.

Vá para o sistema no qual o coletor precisa ser instalado e crie um diretório chamado ./tmp/collectors no diretório caminho de instalação do agente.

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

Altere recursivamente a propriedade do diretório tmp para cssys:cssys (o usuário e o grupo cssys serão criados durante a instalação do 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

Agora precisamos buscar a versão do coletor e o UUID do coletor. Navegue até a API “cloudsecure_config.collector-types”.

Acesse o Swagger, API “cloudsecure_config.collector-types > /v1/cloudsecure/collector-types” (GET). No menu suspenso “collectorCategory”, selecione o tipo de coletor como “DATA”. Selecione “TODOS” para buscar todos os detalhes do tipo de coletor.

Copie o UUID do tipo de coletor necessário.

Baixe o instalador do coletor.

[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

Alterar a propriedade do arquivo zip do instalador do coletor para 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 até Segurança de carga de trabalho > Coletores e selecione +Coletor. Escolha o coletor ONTAP SVM.

Configure os detalhes do coletor e Salve o coletor.

Ao clicar em Salvar, o processo do agente localizará o instalador do coletor no diretório /{agent-install-path}/cloudsecure/tmp/collectors/ e instalará o coletor.

Como opção alternativa, em vez de adicionar o coletor via interface do usuário, ele também pode ser adicionado via API.

O coletor agora deve estar visível na seção "Coletores de dados".

Limpeza pós-instalação.

1. Vá para o sistema no qual o coletor precisa ser instalado e crie um diretório chamado ./tmp/collectors no diretório caminho de instalação do agente.

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

Agora precisamos buscar a versão e o UUID do coletor. Navegue até a API “cloudsecure_config.collector-types”. No menu suspenso collectorCategory, selecione o tipo de coletor como “USUÁRIO”. Selecione “TODOS” para buscar todos os detalhes do tipo de coletor em uma única solicitação.

Copie o UUID do coletor LDAP.

Baixe o instalador do coletor.

[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

Alterar a propriedade do arquivo zip do instalador do coletor para 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

Navegue até a página 'Coletores de diretório de usuários' e clique em '+ Coletor de diretório de usuários'.

Selecione 'Servidor de diretório LDAP'.

Insira os detalhes do servidor de diretório LDAP e clique em "Salvar"

Ao clicar em Salvar, o serviço do agente localizará o instalador do coletor no diretório /{agent-install-path}/cloudsecure/tmp/collectors/ e instalará o coletor.

Como opção alternativa, em vez de adicionar o coletor via interface do usuário, ele também pode ser adicionado via API.

O coletor agora deve estar visível na seção “Coletores de diretório do usuário”.

Limpeza pós-instalação.

Baixe o instalador do agente mais recente.

Defina permissão de execução para o arquivo “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

Execute o script “cloudsecure-agent-upgrade.sh”. Se o script tiver sido executado com sucesso, ele imprimirá a mensagem “O agente Cloudsecure foi atualizado com sucesso” na saída.

Execute o seguinte comando 'systemctl daemon-reload'

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

Reinicie o serviço do agente.

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

Verificação de integridade após atualização do agente.

Limpeza pós-instalação.

Vá para o sistema no qual os coletores precisam ser atualizados e crie o diretório ./tmp/collectors no diretório caminho de instalação do agente, se ele ainda não estiver presente.

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

Certifique-se de que o diretório “coletores” seja de propriedade 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

No swagger, navegue até “cloudsecure_config.collector-types” GET API. No menu suspenso “collectorCategory”, selecione “DATA” (selecione “USER” para o coletor de diretório de usuário ou “ALL”).

Baixe o arquivo mais recente do instalador do coletor.

Alterar a propriedade do arquivo zip do instalador do coletor para 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

Acionar a API do coletor de atualização.

Verificação de sanidade.

Limpeza pós-atualização:

Erro AGENT014

Erro não autorizado

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