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:
parent
34aa30ad3e
commit
2f7ed4f454
|
|
@ -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"
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|
|
||||||
11
README.md
11
README.md
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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). |
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## 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?
|
||||||
Binary file not shown.
|
|
@ -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**.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## 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.
|
||||||
Binary file not shown.
|
|
@ -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**.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### 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)
|
||||||
Binary file not shown.
|
|
@ -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).
|
||||||
|
|
||||||
|

|
||||||
|
*(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).
|
||||||
Binary file not shown.
|
|
@ -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)?
|
||||||
Binary file not shown.
|
|
@ -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%)?
|
||||||
Binary file not shown.
|
|
@ -1,3 +0,0 @@
|
||||||
# Documentação Iscsi
|
|
||||||
|
|
||||||
Local para manuais e procedimentos referentes ao **Iscsi**.
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
# Documentação Nfs
|
|
||||||
|
|
||||||
Local para manuais e procedimentos referentes ao **Nfs**.
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
# Documentação Samba
|
|
||||||
|
|
||||||
Local para manuais e procedimentos referentes ao **Samba**.
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
# Documentação Truenas
|
|
||||||
|
|
||||||
Local para manuais e procedimentos referentes ao **Truenas**.
|
|
||||||
|
|
@ -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.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
> ℹ️ **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?
|
||||||
Binary file not shown.
|
|
@ -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.
|

|
||||||
- **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"?
|
||||||
|
|
|
||||||
Binary file not shown.
|
|
@ -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
|

|
||||||
|
|
||||||
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?
|
||||||
|
|
|
||||||
Binary file not shown.
Loading…
Reference in New Issue