Sankofa/docs/proxmox/reference/RESOURCE_INVENTORY.md

# Proxmox Resource Inventory

## Overview

This document tracks the actual Proxmox resources available across all instances. This information should be gathered from the actual Proxmox clusters and updated as resources change.

## Instance Mapping

| Site | Hostname | IP Address | Instance | Status |
|------|----------|------------|----------|--------|
| us-sfvalley | ml110-01.sankofa.nexus | 192.168.11.10 | Instance 1 | Active |
| us-sfvalley-2 | r630-01.sankofa.nexus | 192.168.11.11 | Instance 2 | Active |

## Storage Pools

### Instance 1 (192.168.11.10)

| Name | Type | Size | Used | Available | Status |
|------|------|------|------|----------|--------|
| local | Directory | TBD | TBD | TBD | Active |
| local-lvm | LVM-Thin | TBD | TBD | TBD | Active |

### Instance 2 (192.168.11.11)

| Name | Type | Size | Used | Available | Status |
|------|------|------|------|----------|--------|
| local | Directory | TBD | TBD | TBD | Active |
| local-lvm | LVM-Thin | TBD | TBD | TBD | Active |

**Note**: Run the following command to discover actual storage pools:
```bash
pvesh get /storage
```

## Network Bridges

### Instance 1 (192.168.11.10)

| Name | Type | VLAN Aware | Bridge Ports | Status |
|------|------|------------|--------------|--------|
| vmbr0 | Linux Bridge | No | eth0 | Active |

### Instance 2 (192.168.11.11)

| Name | Type | VLAN Aware | Bridge Ports | Status |
|------|------|------------|--------------|--------|
| vmbr0 | Linux Bridge | No | eth0 | Active |

**Note**: Run the following command to discover actual network bridges:
```bash
pvesh get /nodes/{node}/network
```

## OS Templates / Images

### Instance 1 (192.168.11.10)

| Name | Type | Size | Description |
|------|------|------|-------------|
| ubuntu-22.04-cloud | VMA | TBD | Ubuntu 22.04 Cloud Image |
| ubuntu-20.04-cloud | VMA | TBD | Ubuntu 20.04 Cloud Image |
| debian-11-standard | VMA | TBD | Debian 11 Standard Template |

### Instance 2 (192.168.11.11)

| Name | Type | Size | Description |
|------|------|------|-------------|
| ubuntu-22.04-cloud | VMA | TBD | Ubuntu 22.04 Cloud Image |
| ubuntu-20.04-cloud | VMA | TBD | Ubuntu 20.04 Cloud Image |
| debian-11-standard | VMA | TBD | Debian 11 Standard Template |

**Note**: Run the following command to discover actual templates:
```bash
pvesh get /nodes/{node}/storage/{storage}/content
```

## Cluster Nodes

### Instance 1 Cluster

| Node Name | IP Address | Status | CPU Cores | Memory | Storage |
|-----------|------------|--------|-----------|---------|---------|
| ML110-01 | 192.168.11.10 | Active | TBD | TBD | TBD |

### Instance 2 Cluster

| Node Name | IP Address | Status | CPU Cores | Memory | Storage |
|-----------|------------|--------|-----------|---------|---------|
| R630-01 | 192.168.11.11 | Active | TBD | TBD | TBD |

**Note**: Run the following command to discover cluster nodes:
```bash
pvesh get /nodes
```

## Resource Discovery Script

Use the following script to automatically discover and update this inventory:

```bash
#!/bin/bash
# scripts/discover-proxmox-resources.sh

INSTANCE1="https://192.168.11.10:8006"
INSTANCE2="https://192.168.11.11:8006"

echo "Discovering Proxmox Instance 1 resources..."
# Add discovery commands here

echo "Discovering Proxmox Instance 2 resources..."
# Add discovery commands here
```

## Update Procedure

1. **Connect to Proxmox Instance**
   ```bash
   ssh root@192.168.11.10
   # or use pvesh CLI
   ```

2. **Gather Storage Information**
   ```bash
   pvesh get /storage --output-format json
   ```

3. **Gather Network Information**
   ```bash
   pvesh get /nodes/{node}/network --output-format json
   ```

4. **Gather Template Information**
   ```bash
   pvesh get /nodes/{node}/storage/{storage}/content --output-format json
   ```

5. **Gather Node Information**
   ```bash
   pvesh get /nodes --output-format json
   pvesh get /nodes/{node}/status --output-format json
   ```

6. **Update This Document**
   - Replace TBD values with actual data
   - Add any additional resources discovered
   - Update timestamps

## Last Updated

- **Date**: TBD
- **Updated By**: TBD
- **Method**: Manual / Script

## Notes

- All TBD values should be filled in after connecting to actual Proxmox instances
- This document should be updated whenever resources change
- Consider automating resource discovery and updates
- Store sensitive information (IPs, credentials) securely, not in this document