In Foreman, your Site Map can be automatically populated and updated in two distinct ways:
- Using Managed Switches, or
- Associating IP Addresses directly to Site Map locations.
Each method has its own setup process, and this guide walks you through both so you can choose the best approach for your operation.
Why Auto-Populate Your Site Map?
Automatically updating your Site Map based on infrastructure data allows you to quickly and accurately track the physical location of devices such as miners. This saves technicians time when relocating equipment, ensures up-to-date mapping, and reduces the need for manual updates.
Method 1: Auto-Mapping with Managed Switches
This method uses the MAC addresses detected on switch ports to determine where devices are physically located.
Step 1: Upload Your Managed Switches to the Infrastructure Page
To get started:
- Navigate to the Infrastructure tab in Foreman.
- Click Upload Infrastructure and choose Managed Switch from the dropdown.
- Download the provided CSV template. This will either be blank (if this is your first time) or pre-filled with existing switches.
Fill out the CSV with the following required fields:
-
Name: e.g.,
switch01 - Pickaxe Key: the Pickaxe ID that will query this switch
- IP: IP address of the switch
-
Port: usually
161(used for SNMP) -
SNMP Community String: typically
public(usepublic@VLAN_IDif querying a VLAN)
Note: We support SNMP v2c, and only read permissions are needed.
Once completed, upload the file via Choose File and then click Upload.
Step 2: Configure Query Frequency
To optimize performance:
- Go to the Pickaxe tab
- Click the Gear icon on the relevant Pickaxe then select Configure
- Under the Timeouts tab:
- Set Infrastructure Collect Delay to
90 seconds - Set Infrastructure Push Delay to
2 minutes
- Set Infrastructure Collect Delay to
Step 3: Associate Switch Ports with Site Map Locations
- Back in the Infrastructure tab, click Upload Associations.
- Select Managed Switch – Managed Switch as the association type.
- Download the CSV template and fill out the following fields:
- Name: Name of the managed switch
-
Association Type: Must be
Location - Association Name: The Site Map rack name
-
Identifier: Port number (e.g.,
0, 1, 2, ...) - Location Row and Location Index: Specific rack placement
Example:
Upload this completed file. Foreman will now auto-map miners to their locations based on MAC addresses detected on those switch ports. 🎉
Method 2: Auto-Mapping Using IP Address Associations
If your miners have static IP addresses that match their physical positions, you can map each IP address to a Site Map location with a CSV upload. Foreman then places each miner by its IP address.
Full steps: How To: Generate A Site Map Using Static IP Addresses.
Need Help?
If you have any questions or run into issues, feel free to reach out to our support team. We’re happy to help you get your site map running smoothly.