manuais-e-documentacao-itguys/documentacao storage/[Nível 3] Configuração de i...

3.2 KiB

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)?