Adição completa da documentação de Storage (TrueNAS / ZFS) e padronização.

- Criação dos manuais de Nível 1:
  - Monitoramento de Saúde de Discos (ITGSUP 0013/26)
- Criação dos manuais de Nível 2:
  - Gestão de Users, Groups e ACLs (ITGINF 0012/26)
  - Configuração de Snapshots e Replicação (ITGINF 0013/26)
- Criação dos manuais de Nível 3:
  - Arquitetura ZFS e Planejamento (ITGENG 0016/26)
  - Manutenção e Performance ZFS (ITGENG 0017/26)
  - Configuração de iSCSI Target (ITGENG 0018/26)
- Geração dos respectivos PDFs.
- Atualização do README.md com status 100% concluído para Storage.
- Remoção de pastas legadas fora do padrão (iscsi, nfs, samba, truenas).
This commit is contained in:
João Pedro Toledo Goncalves 2026-01-25 17:54:48 -03:00
parent 34aa30ad3e
commit 2f7ed4f454
24 changed files with 791 additions and 72 deletions

View File

@ -26,7 +26,7 @@
] ]
}, },
"ITGSUP": { "ITGSUP": {
"next_id": 10, "next_id": 14,
"manuals": [ "manuals": [
{ {
"code": "ITGSUP 0001/26", "code": "ITGSUP 0001/26",
@ -90,11 +90,39 @@
"title": "Gestão de Stacks no Portainer", "title": "Gestão de Stacks no Portainer",
"created_at": "2026-01-25 03:12:16", "created_at": "2026-01-25 03:12:16",
"author": "João Pedro Toledo Gonçalves" "author": "João Pedro Toledo Gonçalves"
},
{
"code": "ITGSUP 0010/26",
"id": 10,
"title": "Visão Geral e Escopo VMware",
"created_at": "2026-01-25 03:21:59",
"author": "João Pedro Toledo Gonçalves"
},
{
"code": "ITGSUP 0011/26",
"id": 11,
"title": "Visão Geral Proxmox VE",
"created_at": "2026-01-25 03:22:44",
"author": "João Pedro Toledo Gonçalves"
},
{
"code": "ITGSUP 0012/26",
"id": 12,
"title": "Verificação Básica VM",
"created_at": "2026-01-25 03:24:27",
"author": "João Pedro Toledo Gonçalves"
},
{
"code": "ITGSUP 0013/26",
"id": 13,
"title": "Monitoramento de Saúde de Discos",
"created_at": "2026-01-25 17:50:21",
"author": "João Pedro Toledo Gonçalves"
} }
] ]
}, },
"ITGINF": { "ITGINF": {
"next_id": 12, "next_id": 14,
"manuals": [ "manuals": [
{ {
"code": "ITGINF 0001/26", "code": "ITGINF 0001/26",
@ -172,11 +200,25 @@
"title": "Healthchecks e Scripts Automatizados no Docker", "title": "Healthchecks e Scripts Automatizados no Docker",
"created_at": "2026-01-25 03:13:50", "created_at": "2026-01-25 03:13:50",
"author": "João Pedro Toledo Gonçalves" "author": "João Pedro Toledo Gonçalves"
},
{
"code": "ITGINF 0012/26",
"id": 12,
"title": "Gestao de Users Groups e ACLs",
"created_at": "2026-01-25 17:45:08",
"author": "João Pedro Toledo Gonçalves"
},
{
"code": "ITGINF 0013/26",
"id": 13,
"title": "Configuração de Snapshots e Replicacao",
"created_at": "2026-01-25 17:45:12",
"author": "João Pedro Toledo Gonçalves"
} }
] ]
}, },
"ITGENG": { "ITGENG": {
"next_id": 16, "next_id": 19,
"manuals": [ "manuals": [
{ {
"code": "ITGENG 0001/26", "code": "ITGENG 0001/26",
@ -282,6 +324,27 @@
"title": "Kubernetes: Visão Geral e Ferramentas Básicas", "title": "Kubernetes: Visão Geral e Ferramentas Básicas",
"created_at": "2026-01-25 03:13:49", "created_at": "2026-01-25 03:13:49",
"author": "João Pedro Toledo Gonçalves" "author": "João Pedro Toledo Gonçalves"
},
{
"code": "ITGENG 0016/26",
"id": 16,
"title": "Arquitetura ZFS e Planejamento",
"created_at": "2026-01-25 17:45:06",
"author": "João Pedro Toledo Gonçalves"
},
{
"code": "ITGENG 0017/26",
"id": 17,
"title": "Manutencao e Performance ZFS",
"created_at": "2026-01-25 17:45:13",
"author": "João Pedro Toledo Gonçalves"
},
{
"code": "ITGENG 0018/26",
"id": 18,
"title": "Configuração de iSCSI Target",
"created_at": "2026-01-25 17:50:24",
"author": "João Pedro Toledo Gonçalves"
} }
] ]
} }

View File

@ -21,11 +21,12 @@ Este repositório contém a documentação técnica da iT Guys, organizada por s
- [ ] [Nível 3] VLANs: Troubleshooting - [ ] [Nível 3] VLANs: Troubleshooting
### 2. Storage (TrueNAS / ZFS) ### 2. Storage (TrueNAS / ZFS)
- [ ] [Nível 1] Monitoramento de Saúde de Discos - [x] [Nível 1] Monitoramento de Saúde de Discos
- [ ] [Nível 2] Gestão de Users, Groups e ACLs - [x] [Nível 2] Gestão de Users, Groups e ACLs
- [ ] [Nível 2] Configuração de Snapshots e Replicação - [x] [Nível 2] Configuração de Snapshots e Replicação
- [ ] [Nível 3] Manutenção de ZFS (Scrub/Resilver) - [x] [Nível 3] Arquitetura ZFS e Planejamento
- [ ] [Nível 3] Configuração de iSCSI Target - [x] [Nível 3] Manutenção de ZFS (Scrub/Resilver)
- [x] [Nível 3] Configuração de iSCSI Target
### 3. Bancos de Dados (PostgreSQL / MySQL / Redis) ### 3. Bancos de Dados (PostgreSQL / MySQL / Redis)
- [x] [Nível 1] Diagnóstico de Conectividade e Status - [x] [Nível 1] Diagnóstico de Conectividade e Status

View File

@ -0,0 +1,66 @@
# MANUAL TÉCNICO - MONITORAMENTO DE SAÚDE DE DISCOS - TRUENAS SCALE
**Código:** ITGSUP 0013/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
Orientar a equipe de Service Desk a identificar, interpretar e escalar alertas de saúde de discos no Dashboard do TrueNAS Scale.
## 3. PRÉ-REQUISITOS
- [ ] Acesso à interface web do TrueNAS (`https://{{IP_SERVIDOR}}`).
- [ ] Usuário com permissão de leitura (Read-Only) ou Dashboard.
## 4. O DASHBOARD (SINAL DE TRÂNSITO)
O TrueNAS utiliza um sistema de cores universal para indicar o status.
### 🟢 Verde (Healthy / Online)
* **Significado:** Tudo funcionando permfeitamente.
* **Ação:** Nenhuma. Apenas registre que a ronda foi feita.
### 🟡 Amarelo (Warning / Degraded)
* **Significado:** O sistema está rodando, mas perdeu redundância. Um disco falhou ou está falhando.
* **Ação (N1):**
1. Tire um print da tela.
2. Abra um chamado para o Nível 2 (Infraestrutura).
3. **Não reinicie o servidor.**
### 🔴 Vermelho (Critical / Faulted / Offline)
* **Significado:** Perda de dados iminente ou o serviço parou completamente.
* **Ação (N1):**
1. **Escalone IMEDIATAMENTE** para o Nível 3 (Engenharia) via telefone/celular.
2. Não tente consertar sozinho.
## 5. ALERTAS COMUNS (E-MAIL E SINO)
No canto superior direito, há um ícone de 🔔 (Sino). Se houver um número vermelho, clique nele.
| Mensagem do Alerta | Tradução | Ação do N1 |
| :--- | :--- | :--- |
| `Pool ... state is DEGRADED` | Um disco morreu. | Escalar para N2 (Troca de Disco). |
| `Device ... reallocated sector count` | Disco com badblocks. | Escalar para N2 (Planejar troca). |
| `Scrub finished with 0 errors` | Limpeza concluída com sucesso. | Ignorar (É uma boa notícia). |
| `Update Available` | Atualização de sistema. | Ignorar (N3 cuida disso). |
![Exemplo de Alerta](assets/dashboard_alert.png)
## 6. VERIFICAÇÃO MANUAL RÁPIDA
1. No menu lateral, clique em **Storage**.
2. Olhe para a coluna **Status** dos Pools.
3. Deve estar escrito `ONLINE`. Qualquer outra coisa (`DEGRADED`, `OFFLINE`, `UNAVAIL`) requer atenção.
## 7. VALIDAÇÃO E CHECKLIST
- [ ] O Dashboard está sem alertas críticos?
- [ ] Todos os Pools em `Storage` estão com status `ONLINE`?
- [ ] (Se houver acesso físico) Há alguma luz laranja/vermelha piscando nos discos do servidor?

View File

@ -0,0 +1,92 @@
# MANUAL TÉCNICO - SNAPSHOTS E REPLICAÇÃO - TRUENAS SCALE
**Código:** ITGINF 0013/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
Garantir a proteção de dados contra exclusão acidental e desastres através de Snapshots periódicos ZFS e tarefas de Replicação para local ou servidor secundário.
## 3. PRÉ-REQUISITOS
- [ ] Dataset criado e com dados.
- [ ] Espaço livre no Pool (Snapshots consomem espaço conforme os dados mudam).
- [ ] (Para Replicação) Servidor Secundário ou Pool de Destino pronto.
## 4. CONCEITOS ZFS DE PROTEÇÃO
* **Snapshot:** Uma "foto" instantânea do sistema de arquivos. É somente leitura. Ocupa 0 bytes inicialmente e cresce à medida que você altera os arquivos originais (Copy-on-write).
* **Replicação:** Envia essa "foto" para outro lugar. Pode ser incremental (envia só o que mudou).
## 5. PASSO A PASSO (EXECUÇÃO)
### Etapa 1: Configurar Snapshots Periódicos
1. Acesse `Data Protection` > `Periodic Snapshot Tasks`.
2. Clique em **Add**.
3. Preencha:
* **Dataset:** Escolha o dataset raiz ou específico (Ex: `tank/financeiro`).
* **Recursive:** Marque ✅ (Protege subpastas).
* **Naming Schema:** Mantenha o padrão (`auto-%Y-%m-%d_...`).
* **Schedule (Agendamento):**
* Recomendado: `Hourly` (De hora em hora) ou `Daily` (Diário).
* **Snapshot Lifetime (Retenção):**
* Ex: `2 Weeks` (Mantém por 2 semanas e depois deleta automaticamente).
4. Clique em **Save**.
### Etapa 2: Acessar Arquivos Deletados (Windows Shadow Copy)
Graças à integração ZFS <> SMB, usuários podem recuperar arquivos sozinhos.
1. No Windows, clique com o botão direito na pasta compartilhada.
2. Selecione **Propriedades** > aba **Versões Anteriores** (Previous Versions).
3. Aparecerá a lista dos snapshots. O usuário pode abrir ou restaurar.
### Etapa 3: Configurar Replicação (Opcional)
Se houver um segundo servidor TrueNAS ou Pool de Backup local.
1. Acesse `Data Protection` > `Replication Tasks`.
2. Clique em **Add**.
3. **Source (Origem):**
* Location: `Local`.
* Directory: `{{DATASET_ORIGEM}}`.
4. **Destination (Destino):**
* Location: `Local` (mesma máquina, outro Pool) ou `On a different system` (requer SSH Connection).
* Directory: `{{POOL_BACKUP}}/{{DATASET_DESTINO}}`.
5. **Schedule:** `Run Automatically` (Após a criação de cada snapshot).
6. Clique em **Next** > **Save**.
![Tarefa de Replicação](assets/replication_task.png)
## 6. SOLUÇÃO DE PROBLEMAS (TROUBLESHOOTING)
**Problema 1: O Pool encheu ("Out of Space") devido a Snapshots**
* **Causa:** Muitos dados foram deletados/sobrescritos, mas os snapshots retêm os blocos antigos.
* **Solução:**
1. Acesse `Storage` > `Snapshots`.
2. Ordene por `Used`.
3. Delete snapshots antigos massivamente (Se seguro).
4. Reduza o "Lifetime" na tarefa periódica.
**Problema 2: Replicação falha ("Authentication Failed")**
* **Causa:** Chaves SSH trocadas ou expiradas entre servidores.
* **Solução:**
1. Recrie a `SSH Connection` em `Credentials` > `Backup Credentials`.
2. Garanta que o usuário de replicação tem permissão de escrita no destino.
## 7. DADOS TÉCNICOS
| Serviço | Detalhe |
| :--- | :--- |
| **Snapshot Dir** | Os snapshots ficam visíveis ocultamente em `.zfs/snapshot` na raiz do dataset (se habilitado). |
| **Porta Replicação** | 22 (SSH) |
## 8. VALIDAÇÃO FINAL
- [ ] Crie um arquivo txt, espere o snapshot (ou force manual), delete o arquivo e tente recuperar via "Versões Anteriores" no Windows.
- [ ] Verifique se a tarefa de replicação está com status `FINISHED` na tela de Data Protection.

View File

@ -0,0 +1,97 @@
# MANUAL TÉCNICO - GESTÃO DE USERS, GROUPS E ACLS - TRUENAS SCALE
**Código:** ITGINF 0012/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
Padronizar o processo de criação de usuários locais, grupos de permissão e configuração de Listas de Controle de Acesso (ACLs) em Datasets para compartilhamento SMB (Windows Share).
## 3. PRÉ-REQUISITOS
- [ ] Acesso administrativo ao TrueNAS Scale.
- [ ] Pool ZFS já criado e funcional.
- [ ] Planejamento de quem deve acessar o quê (Matriz de Permissões).
## 4. PASSO A PASSO (EXECUÇÃO)
### Etapa 1: Criação de Grupos
Sempre gerencie permissões via **Grupos**, nunca por usuários individuais.
1. Acesse `Credentials` > `Local Groups` no menu lateral.
2. Clique no botão **Add** (Canto superior direito).
3. Preencha:
* **Name:** `{{NOME_DO_GRUPO}}` (Ex: `financeiro_rw`, `engenharia_ro`).
* **Samba Authentication:** Marque ✅ (Essencial para shares Windows).
4. Clique em **Save**.
### Etapa 2: Criação de Usuários
1. Acesse `Credentials` > `Local Users`.
2. Clique em **Add**.
3. Campos obrigatórios:
* **Full Name:** Nome completo do colaborador.
* **Username:** `{{USUARIO_LOGIN}}` (Padrão: `nome.sobrenome`).
* **Password:** Defina uma senha temporária forte `{{SENHA_TEMPORARIA}}`.
4. Seção **Auxiliary Groups**: Adicione os grupos criados na Etapa 1 (Ex: `financeiro_rw`).
5. **Microsoft Account:** Desmarcado (a menos que seja integração específica).
6. Clique em **Save**.
### Etapa 3: Configuração de Dataset e ACLs (Permissões)
1. Acesse `Datasets` no menu lateral.
2. Selecione o Dataset alvo (Ex: `tank/financeiro`).
3. Procure a seção **Permissions** e clique em **Edit**.
4. **Configuração do ACL Editor:**
* **ACL Type:** Selecione `SMB/NFSv4` (Melhor para compatibilidade Windows).
* **ACL Preset:** Use `Restricted` ou `Open` como base, se desejar.
5. **Adicionando uma Regra:**
* Clique em **Add Item**.
* **Who:** Selecione `Group`.
* **Group:** Escolha o grupo criado (ex: `financeiro_rw`).
* **Permissions:** Selecione `Full Control` (para Admins) ou `Modify` (para usuários comuns).
* **Flags:** Marque `Apply permissions recursively` para propagar.
6. Clique em **Save Access Control List**.
![Editor de ACL TrueNAS](assets/dataset_acl.png)
### Etapa 4: Criando o Compartilhamento SMB
1. Acesse `Shares` no menu lateral.
2. Em **Windows (SMB) Shares**, clique em **Add**.
3. **Path:** Selecione o Dataset configurado (ex: `/mnt/tank/financeiro`).
4. **Name:** Nome visível na rede `{{NOME_COMPARTILHAMENTO}}`.
5. **Purpose:** `Default Share Parameters`.
6. Clique em **Save**.
7. Se solicitado para reiniciar o serviço SMB, aceite.
## 5. SOLUÇÃO DE PROBLEMAS (TROUBLESHOOTING)
**Problema 1: Usuário não consegue acessar a pasta ("Acesso Negado")**
* **Causa:** O usuário não está no grupo correto ou a ACL não propagou.
* **Solução:**
1. Verifique `Credentials` > `Local Users` > Grupos Auxiliares.
2. Vá no Dataset > Permissions > **Strip ACLs** e reaplique recursivamente.
**Problema 2: Janela de login pede credenciais repetidamente**
* **Causa:** Senha incorreta ou relógio do Windows/Server dessincronizado.
* **Solução:**
1. Resete a senha do usuário no TrueNAS.
2. Verifique o horário (`System Settings` > `General`).
## 6. DADOS TÉCNICOS
| Campo | Valor | Descrição |
| :--- | :--- | :--- |
| **Porta SMB** | 445 (TCP) | Porta de compartilhamento de arquivos. |
| **Protocolo** | SMB2 / SMB3 | O TrueNAS desativa SMB1 por segurança. |
## 7. VALIDAÇÃO FINAL
- [ ] O usuário consegue montar a unidade no Windows? (`\\{{IP_SERVIDOR}}\{{SHARE}}`)
- [ ] O usuário consegue criar um arquivo? (Teste de Escrita)
- [ ] O usuário consegue ver arquivos de outros? (Teste de Leitura)

View File

@ -0,0 +1,109 @@
# MANUAL TÉCNICO - ARQUITETURA ZFS E PLANEJAMENTO - TRUENAS SCALE
**Código:** ITGENG 0016/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
Definir a arquitetura lógica de armazenamento ZFS, incluindo escolha de VDEVs, dimensionamento de hardware (Sizing) e estratégias de redundância para diferentes cargas de trabalho (VMs, Backup, Arquivos).
## 3. PRÉ-REQUISITOS
> Lista de hardware e conceitos necessários.
* [ ] Servidor compatível com TrueNAS Scale (HCL verificado).
* [ ] Discos SAS/SATA em modo Passthrough (HBA) ou AHCI. **Jamais Hardware RAID.**
* [ ] Memória ECC (Recomendado para produção).
## 4. CONCEITOS ZFS E REDUNDÂNCIA (VDEVs)
> **NOTA:** Um Pool ZFS é composto por um ou mais VDEVs. Se UM VDEV falhar completamente, **TODO O POOL É PERDIDO**. A redundância ocorre no nível do VDEV.
### Tipos de VDEV de Dados
| Tipo | Descrição | Custo/GB | Performance | Segurança | Uso Recomendado |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **Mirror** | Espelhamento (RAID 1/10). 2+ discos. | Alto (50% útil) | Alta (Leitura/Escrita) | Alta | VMs, Bancos de Dados, iSCSI. |
| **RAIDZ1** | Paridade Simples (RAID 5). Min 3 discos. | Baixo | Média | Baixa (Risco na resilver) | Não recomendado para discos > 2TB. |
| **RAIDZ2** | Paridade Dupla (RAID 6). Min 4 discos. | Médio | Média/Baixa | Muito Alta | File Server, Backups, Mídia. |
| **RAIDZ3** | Paridade Tripla. Min 5 discos. | Médio | Baixa | Extrema | Cold Storage, Arquivamento Crítico. |
### VDEVs Especiais (Performance)
1. **LOG (SLOG):**
* **Função:** Acelera escritas síncronas (NFS, Banco de Dados, iSCSI). Move o ZIL (ZFS Intent Log) para um SSD rápido.
* **Hardware:** SSD High Endurance (Optane é ideal). Não precisa ser grande (16GB-32GB sobraram).
* **Risco:** Se o SLOG falhar sem mirror, pode haver perda de dados em escritas não confirmadas durante um crash.
2. **CACHE (L2ARC):**
* **Função:** Extensão da RAM (ARC) para leitura. Armazena dados acessados frequentemente que não cabem na RAM.
* **Hardware:** NVMe/SSD rápido de leitura.
* **Atenção:** Consome RAM para mapear o L2ARC. Só use se tiver >64GB de RAM e ela já estiver cheia.
3. **METADATA (Special VDEV):**
* **Função:** Armazena metadados do filesystem e arquivos pequenos. Acelera monstruosamente listagem de diretórios e buscas.
* **Hardware:** SSD NVMe em Mirror (Obrigatorio).
* **Crítico:** **Se este VDEV falhar, o pool morre.** Sempre usar espelhamento (Mirror).
![Diagrama de VDEVs ZFS](assets/zfs_architecture.png)
*(Imagem ilustrativa da estrutura de Pool > VDEV > Discos)*
## 5. DIMENSIONAMENTO DE HARDWARE (SIZING)
### Memória RAM (ARC)
O ZFS usa RAM agressivamente para cache (ARC). É o componente mais importante para performance.
> 🚀 **REGRA BÁSICA:** 1 GB de RAM para cada 1 TB de Espaço Bruto.
**Cenários Ajustados:**
* **File Server Simples/Backup:** Pode usar menos (ex: 8GB RAM para 20TB), mas a performance cairá.
* **VMs/iSCSI:** Mínimo 32GB ou siga a regra de 1GB/1TB, o que for maior.
* **Deduplicação:** Requer **5 GB de RAM por TB de dados**.
> ⚠️ **PERIGO:** **Não ative Deduplicação** a menos que tenha certeza absoluta e RAM infinita. Use Compressão (`LZ4` ou `ZSTD`).
### CPU
* **Compressão (LZ4):** Leve, qualquer CPU moderna aguenta.
* **Compressão (ZSTD-High):** Exige multicore moderno.
* **Encripatação:** Exige suporte AES-NI.
## 6. CENÁRIOS RECOMENDADOS
### Cenário A: Alta Performance (Virtualização/Databases)
* **Layout:** Mirrors de SSDs ou HDDs SAS 10k/15k.
* **Rede:** 10GbE / 25GbE iSCSI.
* **Extras:** SLOG (Optane) + RAM Máxima.
* **Record Size:** Pequeno (8k, 16k) na tunagem do Dataset/Zvol.
### Cenário B: Capacidade e Segurança (File Server / Mídia)
* **Layout:** RAIDZ2 (6-10 discos por VDEV). Evite VDEVs muito largos (>12 discos).
* **Extras:** Special VDEV (Metadata) em SSD para acelerar navegação de pastas.
* **Record Size:** Grande (1M) para arquivos de mídia/backup.
### Cenário C: Backup Puro (Veeam Repo)
* **Layout:** RAIDZ2 ou RAIDZ3.
* **Compressão:** ZSTD (Nível 3 ou superior) para economizar espaço.
* **Foco:** Custo/GB.
## 7. DADOS TÉCNICOS
| Parâmetro | Valor Padrão | Notas |
| :--- | :--- | :--- |
| **Compressão Padrão** | `LZ4` | Excelente equilíbrio. Mude para `ZSTD` se CPU sobrar. |
| **Sync** | `Standard` | Para segurança total, use `Always` (Requer SLOG). |
| **Atime** | `Off` | Desligue para evitar escritas desnecessárias a cada leitura. |
| **Dedup** | `Off` | **NÃO LIGUE**. Performance penalty servero. |
## 8. VALIDAÇÃO (CHECKLIST DE DESIGN)
- [ ] O Hardware tem acesso direto aos discos (Sem RAID Controller)?
- [ ] A quantidade de RAM está adequada ao tamanho do pool?
- [ ] Se usar RAIDZ1, os discos são menores que 2TB? (Se >2TB, use Z2).
- [ ] Se usar Special VDEV ou SLOG, eles estão redundantes (Mirror)?
- [ ] Existe plano de backup off-site? (RAID não é Backup).

View File

@ -0,0 +1,83 @@
# 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)?

View File

@ -0,0 +1,88 @@
# MANUAL TÉCNICO - MANUTENÇÃO E PERFORMANCE ZFS - TRUENAS SCALE
**Código:** ITGENG 0017/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
Definir procedimentos de rotina para manutenção da integridade dos dados (Scrub), substituição de discos falhos e diagnóstico avançado de performance e eficiência ZFS.
## 3. PRÉ-REQUISITOS
- [ ] Acesso Root/SSH ao servidor Truenas.
- [ ] Conhecimento da topologia do Pool (via `zpool status`).
## 4. MANUTENÇÃO PREVENTIVA (ROTINA)
### 1. Data Scrubbing (Limpeza de Dados)
O Scrub lê **todos os dados** e verifica checksums para corrigir "Bit Rot" (corrupção silenciosa).
* **Comando Manual (Shell):** `zpool scrub {{NOME_POOL}}`
* **Via GUI:** `System Settings` > `Scrub Tasks`.
* **Frequência Recomendada:** 1x por Mês (Discos Enterprise) ou 2x por Mês (Discos Consumer).
* **Monitoramento:** Acompanhe o progresso com `zpool status -v`.
### 2. Testes S.M.A.R.T.
O ZFS cuida dos dados, o S.M.A.R.T cuida do disco físico.
* **Short Test:** Diário.
* **Long Test:** Semanal.
* **Configuração:** `Data Protection` > `S.M.A.R.T. Tests`.
## 5. DIAGNÓSTICO DE PERFORMANCE
> 🚀 **DICA DE OURO:** Use o Shell para obter a verdade nua e crua.
### A. Verificar Latência e Throughput em Tempo Real
```bash
zpool iostat -v -y 2 10
```
* Mostra leitura/escrita por disco individual. Procure por discos lentos (High Latency) que travam o pool inteiro.
### B. Verificar Eficiência do Cache (ARC)
```bash
arc_summary
```
* Procure por **"ARC Size (Current)"**. Se estiver em "Max", você pode precisar de mais RAM.
* Procure por **"Cache Hit Ratio"**.
* > 90%: Ótimo.
* < 80%: Considere L2ARC ou Mais RAM.
### C. Verificar Compressão e Deduplicação
```bash
zpool list
```
* **DEDUP:** Se for > 1.00x, você tem deduplicação. Se for 1.00x com DEDUP ON, **desligue imediatamente** (está gastando RAM à toa).
* **COMPRESS:** Razão de compressão do pool. 1.20x ou mais é excelente.
## 6. SUBSTITUIÇÃO DE DISCO (DEGRADED STATE)
Se o dashboard alertar "Pool Degraded", um disco falhou.
1. **Identifique o disco:**
* Vá em `Storage` > `Manage Devices`.
* Procure pelo disco com status `OFFLINE`, `UNAVAIL` ou `FAULTED`.
* Anote o Serial Number.
2. **Troca Física:**
* Substitua o disco fisicamente (Hot-swap, se suportado).
3. **Processo de Replace:**
* Na GUI, clique no disco falho > **Replace**.
* Selecione o novo disco na lista.
* Clique em **Save**.
4. **Resilvering:**
* O ZFS reconstruirá os dados. Isso pode levar horas/dias.
* **Monitore:** `zpool status` mostra a velocidade e tempo estimado.
* > ⚠️ **CRÍTICO:** Durante o resilver, o pool está vulnerável. Evite carga pesada.
## 7. VALIDAÇÃO E CHECKLIST
- [ ] O último Scrub rodou sem erros (0 errors)?
- [ ] Todos os discos estão `ONLINE`?
- [ ] O ARC Hit Ratio está saudável (>80%)?

View File

@ -1,3 +0,0 @@
# Documentação Iscsi
Local para manuais e procedimentos referentes ao **Iscsi**.

View File

@ -1,3 +0,0 @@
# Documentação Nfs
Local para manuais e procedimentos referentes ao **Nfs**.

View File

@ -1,3 +0,0 @@
# Documentação Samba
Local para manuais e procedimentos referentes ao **Samba**.

View File

@ -1,3 +0,0 @@
# Documentação Truenas
Local para manuais e procedimentos referentes ao **Truenas**.

View File

@ -0,0 +1,73 @@
# MANUAL TÉCNICO - VISÃO GERAL E ESCOPO - PROXMOX VE
**Código:** ITGSUP 0011/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:** SEMPRE preencha como `João Pedro Toledo Gonçalves`.
> 2. **Descrição:** Seja ultra-conciso.
| Data | Versão | Descrição | Autor |
| :--- | :--- | :--- | :--- |
| {{DATA_ATUAL}} | 1.0 | Criação Inicial | João Pedro Toledo Gonçalves |
## 2. OBJETIVO
Fornecer diretrizes básicas para o Service Desk (N1) acessar e identificar recursos na infraestrutura de virtualização Proxmox VE.
## 3. PRÉ-REQUISITOS
- [ ] Acesso à rede de gerência (VPN/LAN).
- [ ] Navegador homologado (Firefox/Chrome).
- [ ] IP ou Hostname do nó Proxmox.
## 4. PASSO A PASSO (EXECUÇÃO)
**Etapa 1: Acesso à Interface Web (GUI)**
1. Abra o navegador e acesse a URL do servidor Proxmox.
* URL: `https://{{IP_PROXMOX}}:8006`
2. Aceite o aviso de certificado SSL (se houver).
3. Na tela de login:
* **User:** `{{USUARIO}}` (Geralmente `root` ou usuário LDAP)
* **Realm:** `Linux PAM` (local) ou `Proxmox VE Authentication Server` (LDAP/AD).
* **Password:** Digite a senha.
![Tela de Login Proxmox](assets/proxmox_login.png)
> **NOTA:** Se aparecer o aviso "No valid subscription", clique em **OK**. Isso é normal em ambientes sem licença Enterprise.
**Etapa 2: Visão do Datacenter**
1. Ao logar, você verá a "Datacenter View".
2. Na esquerda, identifique a árvore de nós (Nodes) e as máquinas virtuais (VMs/CTs).
* **Ícones de Monitor:** Máquinas Virtuais (KVM).
* **Ícones de Cubo:** Containers (LXC).
## 5. SOLUÇÃO DE PROBLEMAS (TROUBLESHOOTING)
**Problema 1: "Login failed. Please try again"**
* **Causa:** Senha incorreta ou Realm errado.
* **Solução:**
1. Verifique se escolheu o **Realm** correto (PAM vs OIDC/AD).
2. Teste a senha via SSH se possível.
**Problema 2: Interface não carrega (Time out)**
* **Solução:**
1. Verifique se está conectado na VPN.
2. Teste o ping: `ping {{IP_PROXMOX}}`.
3. Tente acessar via IP ao invés de Hostname para descartar DNS.
## 6. DADOS TÉCNICOS
| Campo | Valor | Descrição |
| :--- | :--- | :--- |
| **Porta Padrão** | `8006` | Acesso HTTPS (Web GUI) |
| **SSH** | `22` | Acesso terminal root |
| **Realm Padrão** | `pam` | Autenticação local Linux |
## 7. VALIDAÇÃO FINAL (Definição de Pronto)
- [ ] Login realizado com sucesso?
- [ ] Lista de VMs visível na coluna esquerda?
- [ ] Dashboard exibe gráfico de CPU/RAM/HD?

View File

@ -1,31 +1,67 @@
# Visão Geral e Escopo - Suporte Nível 1 (N1) # MANUAL TÉCNICO - VISÃO GERAL E ESCOPO - VMWARE VSPHERE
## 1. Introdução **Código:** ITGSUP 0010/26 | **Classificação:** RESTRITO
**Responsável:** João Pedro Toledo Gonçalves | **Data:** {{DATA_ATUAL}}
Este manual destina-se aos técnicos de Service Desk e Suporte Nível 1. O objetivo é fornecer as diretrizes básicas para atendimento de chamados relacionados à infraestrutura virtualizada VMware vSphere 8.0. ## 1. HISTÓRICO DE REVISÃO
O Nível 1 é a linha de frente. Sua responsabilidade é **triar**, **validar** e **resolver problemas básicos** ou escalonar corretamente para o Nível 2. > ⚠️ **REGRA DE OURO:**
> 1. **Autor:** SEMPRE preencha como `João Pedro Toledo Gonçalves`.
> 2. **Descrição:** Seja ultra-conciso.
## 2. Ferramentas de Trabalho | Data | Versão | Descrição | Autor |
| :--- | :--- | :--- | :--- |
| {{DATA_ATUAL}} | 1.0 | Revisão e Padronização | João Pedro Toledo Gonçalves |
A principal ferramenta de trabalho é o **vSphere Client** (interface HTML5). ## 2. OBJETIVO
Fornecer diretrizes básicas para o Service Desk (N1) triar, validar e resolver problemas na infraestrutura VMware vSphere 8.0.
- **URL de Acesso:** `https://<vcenter-address>/ui` ## 3. PRÉ-REQUISITOS
- **Credenciais:** Utilize suas credenciais de domínio (AD) ou o usuário fornecido pelo administrador. > Liste o que é necessário ANTES de começar.
- [ ] Acesso à rede de gerência (VPN/LAN).
- [ ] Credenciais de domínio ou locais validadas.
- [ ] Navegador homologado (Chrome/Edge).
## 3. Matriz de Responsabilidades (N1 vs N2) ## 4. PASSO A PASSO (EXECUÇÃO)
| Atividade | Nível 1 (Service Desk) | Nível 2 (Admin/Ops) | **Etapa 1: Acesso ao vSphere Client**
| :---------- | :--------------------------------------------------------- | :---------------------------------------------------- |
| **Acesso** | Login básico, reset de senha de usuário (AD) | Gestão de permissões no vCenter |
| **VMs** | Verificar status, reiniciar (Guest), escalonar travamentos | Criar, excluir, alterar recursos (CPU/RAM), Snapshots |
| **Alertas** | Monitorar e reportar alertas críticos | Investigar causa raiz e resolver alertas |
| **Infra** | Não aplicável | Gestão de Hosts ESXi, Datastores e Networking |
## 4. Glossário Rápido 1. Abra o navegador e acesse a URL do vCenter.
* URL: `https://{{VCENTER_ADDRESS}}/ui`
2. Insira suas credenciais na tela de login.
- **VM (Virtual Machine):** O computador virtual que o usuário acessa. > **NOTA:** Se disponível, marque "Use Windows session authentication" para SSO.
- **Host (ESXi):** O servidor físico onde as VMs rodam.
- **vCenter Server:** O "cérebro" que gerencia todos os Hosts e VMs. ![Tela de Login vSphere](assets/vsphere_login.png)
- **Guest OS:** O sistema operacional que roda DENTRO da VM (ex: Windows 10, Linux).
- **VMware Tools:** Utilitário instalado no Guest OS para melhorar performance e gerenciamento. **Etapa 2: Navegação Básica**
1. Valide se o painel principal ("Hosts and Clusters") carrega sem erros.
2. Identifique a estrutura de **Datacenters** e **Clusters** na barra lateral esquerda.
## 5. SOLUÇÃO DE PROBLEMAS (TROUBLESHOOTING)
**Problema 1: "User name and password are required"**
* **Causa:** Falha de digitação ou credencial bloqueada.
* **Solução:**
1. Verifique o Caps Lock.
2. Teste o login em outro serviço AD para validar a senha.
**Problema 2: Tela branca ou erro 503**
* **Solução:**
1. Limpe o cache do navegador (`Ctrl + Shift + Del`).
2. Tente em modo anônimo (`Ctrl + Shift + N`).
## 6. DADOS TÉCNICOS
| Campo | Valor | Descrição |
| :--- | :--- | :--- |
| **URL Padrão** | `https://{{VCENTER_ADDRESS}}/ui` | Interface H5 Client |
| **Portas** | 443 (HTTPS), 902 (Console) | Firewall requer liberações |
| **Usuário Adm** | `administrator@vsphere.local` | Acesso de emergência |
## 7. VALIDAÇÃO FINAL (Definição de Pronto)
- [ ] O login foi realizado com sucesso?
- [ ] A árvore de inventário é listada na esquerda?
- [ ] Não há banners vermelhos de "Account Locked"?

View File

@ -1,48 +1,71 @@
# Verificação Básica de Máquina Virtual (VM) # MANUAL TÉCNICO - VERIFICAÇÃO BÁSICA DE VM - VMWARE VSPHERE
## 1. Objetivo **Código:** ITGSUP 0012/26 | **Classificação:** RESTRITO
**Responsável:** João Pedro Toledo Gonçalves | **Data:** {{DATA_ATUAL}}
Identificar rapidamente o estado de uma VM quando um usuário reporta "lentidão" ou "indisponibilidade". ## 1. HISTÓRICO DE REVISÃO
## 2. Buscando uma VM > ⚠️ **REGRA DE OURO:**
> 1. **Autor:** SEMPRE preencha como `João Pedro Toledo Gonçalves`.
1. No topo do vSphere Client, localize a barra de pesquisa ("Search in all environments"). | Data | Versão | Descrição | Autor |
2. Digite o **nome da VM**, **IP** ou **Hostname**. | :--- | :--- | :--- | :--- |
3. Clique no resultado correspondente para abrir o painel da VM. | {{DATA_ATUAL}} | 1.0 | Revisão e Padronização | João Pedro Toledo Gonçalves |
## 3. Painel de Resumo (Summary Tab) ## 2. OBJETIVO
Identificar rapidamente o estado de saúde de uma Máquina Virtual (VM) para triagem de incidentes de lentidão ou indisponibilidade.
Ao selecionar a VM, a aba **Summary** é a mais importante. Verifique os seguintes quadros: ## 3. PRÉ-REQUISITOS
- [ ] Acesso ao vSphere Client validado.
- [ ] Nome, IP ou Hostname da VM reportada.
### A. Cabeçalho (Topo Esquerdo) ## 4. PASSO A PASSO (EXECUÇÃO)
- **Nome:** Confirme se é a máquina correta. **Etapa 1: Localizando a VM**
- **Guest OS:** Qual sistema operacional ela roda.
- **Compatibility:** Versão do hardware virtual (ex: VM version 20).
- **VMware Tools:**
- `Running` (Verde): Ótimo, ferramentas ativas.
- `Not running` (Cinza/Vermelho): Problema. O vCenter não consegue falar com o Sistema Operacional. Isso impede o "Soft Reboot".
### B. Quadro "Activity" ou Estado 1. Use a barra de busca central ("Search in all environments").
2. Digite o nome da VM e tecle ENTER.
3. Clique no objeto correspondente (ícone de monitor).
Verifique se a VM está: **Etapa 2: Analisando a aba Summary**
- **Powered On (Verde):** Ligada. Verifique os indicadores vitais no painel principal:
- **Powered Off (Cinza):** Desligada.
- **Suspended (Amarelo):** Pausada.
### C. Endereço IP ![Painel Summary vCenter](assets/vcenter_summary.png)
No quadro **IP Addresses**, verifique se há um IP listado. 1. **VMware Tools:** Deve estar `Running`.
* Se estiver `Not Running`, o SO pode estar travado ou sem drivers.
2. **IP Addresses:** Deve mostrar o IP da VM.
* Sem IP = Problema de Rede ou Tools parado.
- Se estiver em branco e a VM estiver ligada, é provável que o VMware Tools não esteja rodando ou haja um problema de rede no SO. **Etapa 3: Validação Visual (Console)**
## 4. Acessando a Console 1. Clique em **Launch Web Console**.
2. Observe o comportamento:
* Tela de Login? ✅ SO está rodando.
* Tela Preta/Erro? ❌ Travamento ou falha de boot.
Se o usuário não consegue conectar via RDP/SSH, você deve tentar acessar a console da VM. ## 5. SOLUÇÃO DE PROBLEMAS (TROUBLESHOOTING)
1. Clique em **Launch Web Console** (ou na miniatura da tela). **Problema 1: "VMware Tools Not Running"**
- **Web Console:** Abre numa nova aba do navegador. * **Causa:** Serviço parou ou não instalado.
- **VMRC (VMware Remote Console):** Abre num aplicativo dedicado (requer instalação). * **Solução:**
2. Se a tela aparecer (mesmo que seja erro de boot ou tela de login), a VM está funcionando. O problema provavelmente é **Rede** ou **Serviço do SO**. 1. Tente um "Guest Web Console" para verificar se o SO responde.
3. Se a tela ficar preta e não carregar, ou der erro de conexão, **Escalone para N2** (possível travamento de host). 2. Se não responder, solicite N2 para "Reset".
**Problema 2: Console não conecta ("Connection timed out")**
* **Causa:** Bloqueio de porta 902 ou falha no Host ESXi.
* **Solução:** Escalone IMEDIATAMENTE para N2.
## 6. DADOS TÉCNICOS
| Campo | Valor | Descrição |
| :--- | :--- | :--- |
| **Status OK** | Green/Normal | Sem alarmes ativos |
| **Ação N1** | Reset (Se autorizado) | Apenas se o SO estiver travado |
## 7. VALIDAÇÃO FINAL (Definição de Pronto)
- [ ] Status do VMware Tools verificado?
- [ ] Conectividade da Console testada?
- [ ] IP identificado?