84 lines
3.2 KiB
Markdown
84 lines
3.2 KiB
Markdown
# 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)?
|