# Nutanix

## Versão

* Linux Control Center 2.10.X ou superior
* Nutanix Prism Central e/ou Element pc.2022.6.0.10 ou superior
* AOS Version 6.5.2 LTS ou superior

## Requisitos

* NGT Agent
* Usuário com permissão para listagem de informações de VMs
* Usuário com permissão para criação de Recovery point
* Hosts na base de dados do LCC previamente configurados

## Overview

Este guia provê informações e passo a passo para realizar a integração do Linux Control Center com o Nutanix Prism e/ou Element.

A integração com o Nutanix Prism está classificada como um Rollback Item no escopo do Linux Control Center. Um Rollback Item de uma maneira geral, tem como objetivo iniciar uma tarefa de backup, criar um snapshot, recovery point ou item similar dentro do cenário da integração, com o intuito de garantir o rollback de um sistema caso uma modificação gere algum comportamento inesperado no seu parque tecnológico.

{% hint style="warning" %}
Informamos que todas as soluções de terceiros que interagem com o LCC devem estar configuradas corretamente. Dados inconsistentes provenientes dessas soluções não poderão ser processados ou apresentados de forma confiável pelo LCC.
{% endhint %}

## Objetivo

Criar um Recovery Point de um servidor gerenciado pelo Linux Control Center, que foi devidamente identificado no Nutanix Prism.

## Fluxo de integração

1. Configuração do Nutanix Prism;
2. Definição de quais ações irão gerar um Recovery Point;
3. Busca de informações das máquinas virtuais;
4. Identificação dos servidores gerenciados pelo Linux Control Center que estão presentes no Nutanix Prism;
5. Solicitação de ação;
6. Geração de Recovery Point;
7. Login via SSH no servidor;
8. Execução de comandos;

   ![](https://gitlab.com/7dev-doc/linux-control-center/-/blob/main/pt-br/images/nutanix/nutanix_recovery_point.png)

{% hint style="danger" %}
É importante ressaltar que o Linux Control Center opera com o mínimo de permissões necessárias em sistemas de terceiros, logo não é feita a gestão de Recovery Points no Nutanix Prism, sendo necessário que o time seja responsável pela gestão dos recursos, como espaço disponível de armazenamento para os Recovery Points e demais operações do ciclo de vida de um Recovery Point dentro de sua corporação.
{% endhint %}

## Permissões mínimas para integração

Estas são as permissões mínimas necessárias que o usuário do Nutanix Prism deve ter para realizar a integração com o Linux Control Center.

1. Para criar o perfil corretamente, deve atribuir um usuário local do Nutanix Prism ou de um **Active Directory** à uma **Role** do Nutanix de acordo com a documentação oficial do link abaixo;

* Caso escolha utilizar um usuário do AD em vez do usuário local do Nutanix Prism, é necessário que o mesmo possua permissão de Domain Admin.

  <https://portal.nutanix.com/page/documents/details?targetId=Nutanix-Security-Guide-v6_8:mul-security-authentication-pc-t.html>

1. Após ingressar o Nutanix Prism no Active Directory, clique em **Config**

   ![](/files/zFHaB1eXYpAyeZSBshAU)
2. Clique em **Local User Management** e clique em **New User**

   ![](/files/gZAsns97LtwZ6TliQWvq)
3. Crie um usuário com perfil de **Viewer** no Nutanix com as seguintes configurações;

   * **User Admin:** Desativado
   * **Prism Central Admin:** Desativado

   ![](/files/zC43U0xbCNI16faD2qEx)
4. Clique no botão lateral esquerdo para abrir o menu e clique em **Administration** e depois em **Roles**

   ![](/files/PNVyInR0LfrEkp7aUPGg)
5. Clique em **Create Role**

* Sugerimos o nome **Linux Control Center** para melhor identificação.

  ![](/files/BK5DDNgfHBjJr4W5zgmA)

1. Habilite as permissões conforme abaixo; **App**: Access Console VM, View VM **VM Recovery Point**: Snapshot VM, View VM Recovery Point, Allow VM Recovery Point Creation **VM**: Access Console VM, View VM

   ![](/files/Uq3wIOmroCyvAqazjVn4)
2. Este será o resultado da **Role Assignment** quando estiver finalizado.

   ![](/files/12W53joAt699BipTXmlm)
3. Em seguida, volte em configurações e clique em **Role Mapping** e clique em **New Mapping**

   ![](/files/gUqB090gmpfCnHEtoEqM)
4. Crie a **Role Mapping** com as seguintes configurações;

   * Especifique o usuário criado anteriormente e utilize-o nos próximos passos para configurar a integração com o Linux Control Center.

   ![](/files/QDHtOFZmP7bgu6rGQq2C)

## Integração do Nutanix Prism com o LCC

### Realizando a integração

1. Clique em **Config** No menu lateral esquerdo do LCC

   ![](/files/Mra2gJYGy0r3ftQcvMBV)
2. Clique em **Nutanix**

   ![](/files/GHbgDM9myCmziB0j23gL)
3. Na página de configuração do Nutanix, clique em **Add**.

   ![](/files/VHkvDrPbISqsiZucFGY3)
4. Forneça todas as configurações necessárias para realizar a autenticação no Nutanix Prism.
5. Insira a Url do Nutanix no campo **URL**.
6. Insira o usuário do Nutanix no campo **Username**.
7. Insira a senha do Nutanix no campo **Password**.
8. Defina se a integração será com o **Nutanix Prism Central** ou com o **Nutanix Prism Element** no botão **Integration**
9. Caso a solução Nutanix Prism Central e/ou Element não utilize um certificado digital válido, habilite a opção **Ignorar SSL**.
10. Clique em **Salvar**.

    ![](/files/Wjh4YzmdoWSVlrFQpEtm)
11. Após salvar, clique em **Test Connection** para realizar a autenticação com o Nutanix Prism

    ![](/files/Y1L55hpl93azemuO4CpI)

### Sincronização de Hosts do Nutanix Prism

1. Após salvar a configuração anterior e o ícone confirmar o **Status** da conexão, clique no item da integração.

   ![](/files/m7K20laulO26ABKleTfT)
2. Dentro da tela de integração com o Nutanix Prism, clique na aba **Hosts** e clique em **Sync** para sincronizar com os hosts do Nutanix Prism.

   ![](/files/4XvBRpoxsw0zjtlpVJA2)
3. A ação de sincronização autenticará na API do Nutanix e tentará obter o Endereço IP e Hostame das Máquinas Virtuais existentes.
4. A lista de Máquinas Virtuais retornada fará uma correspondência com os Hosts já existentes no Linux Control Center e, se bem-sucedida, o Host será marcado com a integração do Nutanix e o Linux Control Center poderá executar o recurso de Rollback.
5. No final da Sincronização, você poderá ver os Hosts na mesma aba **Hosts** na configuração da integração do Nutanix Prism.
6. Clique na aba **Actions** e defina quais ações acionarão a criação de Recovery Point nas máquinas previamente selecionadas e depois clique em **Salvar**.

   ![](/files/FhkCkpVXa8k4tQz0ZVbx)

## Validando o ponto de recuperação

1. Clique em **Hosts** no painel esquerdo do Linux Control Center

   ![](/files/e3lYQmEr9vY60T5LE9Zp)
2. Clique no **Host** que foi previamente configurado/habilitado na tela de configuração da integração com a solução Nutanix Prism.

   ![](/files/oS4kQS56WE36cjDvcO1B)
3. Após selecionar o **Host**, execute uma da(s) ação(ões) que foi habilitada na tela de configuração da integração com a solução Nutanix Prism.

{% hint style="warning" %}
Ao executar uma ação que foi previamente configurada na integração, a criação de um Recovery Point para aquela maquina virtual será solicitada ao Nutanix Prism, a ação solicitada somente será executada após a criação do Recovery Point, em caso de erro na criação do Recovery Point, a execução da ação será interrompida e seu status será de "erro".
{% endhint %}

1. Clique no **host** selecionado e em seguida clique na aba **Rollback**, será possível observar a listagem dos Recovery Points em **Rollback Items**.

   ![](/files/gImFQXqin2jxttACbqS7)
2. No Nutanix Prism, se o Recovery Point for bem-sucedido, um evento será criado como "Criar ponto de recuperação da VM".

   ![](/files/oyl0x76BOeH1WUJWAZwa)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.linuxcontrolcenter.com.br/conf-integrations/integrations/nutanix.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.