As your mining operation grows beyond a few dozen miners, keeping track of physical locations becomes essential for efficient troubleshooting, maintenance planning, and capacity management. Foreman's Site Map feature provides a visual representation of your mining infrastructure, allowing you to see exactly where each miner is located and quickly identify issues by physical location.

Why Use Site Map?

Site Map helps you visualize where your miners are physically located. Instead of searching for "miner 192.168.1.45," you can see it's in Building A, Row 3, Rack 12, Shelf 2.

Key Benefits:

• Find offline miners instantly by location
• Identify patterns (e.g., "all miners in Rack 7 are running hot")
• Direct technicians to exact locations
• Plan maintenance efficiently
• Visualize capacity and available rack space

Planning Your Layout

Before building your Site Map, decide on your structure:

Common hierarchy:

Site → Building → Row → Rack → Position

Use only the levels you need. Small operations might use: Site → Rack → Position

Naming Tips:

• Be consistent: R01, R02, R03 (not R1, R02, Rack 3)
• Use zero-padding for better sorting
• Keep names concise but clear
• Document your naming convention

Examples:

• Simple: R01, R02, R03 with positions R01-1, R01-2
• Multi-building: TX-A-R01, TX-B-R01
• Container: C01-L1-P03 (Container-Level-Position)

Creating Your Site Map

1. Navigate to Site Map in the left menu.
2. Add Site - Create your top-level location.
3. Add Buildings/Rows (if needed) - Build your hierarchy.
4. Add Racks - Define rack dimensions (height × width creates a grid).
5. Review - Check naming consistency before proceeding.

Adding Miners to the Map

Option 1: Manual Assignment

• Click an empty position on the rack grid.
• Select the miner that belongs there.
• Save the assignment.

Option 2: Interactive Add (with Pickaxe)

• Create a rack profile in Pickaxe.
• Press IP Report button on each physical miner in sequence.
• Pickaxe automatically maps them to positions.

Option 3: Bulk Import

• Export miner list from Foreman.
• Add location columns (Site, Building, Row, Rack, Position).
• Upload the completed file.

Using Site Map Daily

Visual Monitoring:

• Color indicators show miner status at a glance.
• Click through Site → Building → Row → Rack to drill down.
• Click individual miners for detailed diagnostics.

Troubleshooting:

• Spot patterns: "All of Rack 5 is offline" = check power/network to that rack.
• Hot spots: Multiple warnings in one area = cooling issue.
• Quick location: Search by IP to find the exact physical position.

Directing Teams:

• "Building A, Row 3, Rack 12, Shelf 2, Position 3".
• Plan efficient maintenance routes.
• Group work orders by proximity.

Keeping It Accurate

• Assign locations when deploying new miners.
• Update Site Map when moving miners.
• Audit quarterly to verify physical layout matches the map.
• Label physical racks to match Site Map names.

Common Issues

Miner in wrong location: Reassign from miner details or Site Map Can't find a miner: Check unassigned miners and assign a location Multiple miners in same spot: Remove duplicate assignments Slow loading: Filter to specific buildings or areas

With Site Map configured, you can troubleshoot faster, maintain efficiently, and plan capacity with confidence.