# MANUAL TÉCNICO - CONFIGURAÇÃO DE ISCSI TARGET - TRUENAS SCALE

**Código:** ITGENG 0018/26 | **Classificação:** RESTRITO
**Responsável:** João Pedro Toledo Gonçalves | **Data:** {{DATA_ATUAL}}

## 1. HISTÓRICO DE REVISÃO

> ⚠️ **REGRA DE OURO:**
> 1. **Autor:** João Pedro Toledo Gonçalves.
> 2. **Descrição:** Criação do documento.

| Data | Versão | Descrição | Autor |
| :--- | :--- | :--- | :--- |
| {{DATA_ATUAL}} | 1.0 | Criação Inicial | João Pedro Toledo Gonçalves |

## 2. OBJETIVO
Configurar o TrueNAS como um Storage Area Network (SAN) para prover armazenamento de bloco (Block Storage) via iSCSI para servidores de virtualização (VMware/Proxmox) ou Cluster Windows.

## 3. PRÉ-REQUISITOS
- [ ] Rede Dedicada para iSCSI (VLAN isolada).
- [ ] Jumbo Frames (MTU 9000) habilitado no Switch e na Interface de Rede.
- [ ] IPs estáticos definidos para as interfaces de Storage.

## 4. CONCEITOS
*   **Zvol:** Um "disco virtual" dentro do ZFS. É diferente de um Dataset (que é uma pasta). O iSCSI precisa de um Zvol.
*   **Portal:** O endereço IP por onde o iSCSI escuta.
*   **Initiator:** O cliente (ex: seu servidor ESXi).
*   **Extent:** O disco (Zvol) mapeado para ser compartilhado.
*   **Target:** O "ponto de conexão" que une tudo.

## 5. PASSO A PASSO (EXECUÇÃO)

### Etapa 1: Criar o Zvol
1.  Vá em **Datasets**. Selecione o Pool/Dataset pai.
2.  Clique em **Add Zvol** (Botão azul no topo direito).
3.  **Name:** `{{NOME_VM_DISK}}` (ex: `vm-datastore-01`).
4.  **Size:** Defina o tamanho (ex: `1 TiB`).
5.  **Sync:** `Standard` (Se tiver SLOG) ou `Always`. `Disabled` é perigoso.
6.  **Compression:** `LZ4` (Recomendado).
7.  Clique em **Save**.

### Etapa 2: Configurar o iSCSI Wizard
O Wizard facilita muito o processo.

1.  Vá em **Shares** > **Block (iSCSI)**.
2.  Clique em **Wizard**.
3.  **Name:** `{{BASENAME}}` (ex: `truenas-san`).
4.  **Type:** `Device`.
5.  **Device:** Selecione o Zvol criado na Etapa 1 (`/dev/zvol/...`).
6.  **Portal:**
    *   Selecione `Create New`.
    *   Escolha o IP da interface de Storage (ex: `10.10.50.10`).
7.  **Initiators:**
    *   Selecione `Create New` ou deixe em branco para "Allow All" (Não recomendado em produção, mas útil para teste).
    *   Para produção, cadastre o IQN do cliente VMware.
8.  Clique em **Save**.

### Etapa 3: Conectar no Cliente (Windows Exemplo)
1.  Abra o **iSCSI Initiator**.
2.  Aba **Discovery** > **Discover Portal**.
3.  Digite o IP do TrueNAS (`{{IP_STORAGE}}`).
4.  Aba **Targets**. O Target deve aparecer como `Inactive`.
5.  Clique em **Connect**.
6.  Agora o disco aparecerá no `Disk Management` para ser inicializado.

## 6. SOLUÇÃO DE PROBLEMAS

**Problema 1: Performance Lenta**
*   **Causa:** MTU incorreto (Fragmentação) ou falta de Sync Cache.
*   **Solução:**
    1. Verifique `ping -f -l 8900 {{IP_STORAGE}}`. Se falhar, o Jumbo Frames não está ativo fim-a-fim.
    2. Garanta que está usando `Sync=Standard` com um SLOG rápido.

## 7. DADOS TÉCNICOS

| Porta | Valor |
| :--- | :--- |
| **TCP** | 3260 (iSCSI Target) |

## 8. VALIDAÇÃO
- [ ] O Target conecta no cliente?
- [ ] É possível formatar o disco e gravar dados?
- [ ] O MPIO (Multipath) está detectando os caminhos redundantes (se houver)?
