Welcome To The Foreman Knowledge Base

How To: Link an Asset To A Miner

Foreman allows users to link an asset to a miner through an Asset ID, providing better tracking and lifecycle management. You can use either the miner's default serial number or a custom identifier for this link. Below are step-by-step instructions to configure and complete this process.

 

Step 1: Choose Your Linking Method

By default, Foreman uses the miner's serial number for linking. However, if you prefer to use a custom field (like an internal Asset Tag), you must first create it.

To use a custom field:

  1. Click the person icon in the upper-right corner and select Settings from the drop-down menu.
  2. Navigate to the Custom Miner Fields tab.
  3. Click Add Field
     
  4. Choose Text as the field type and enter a descriptive name like "Asset Tag". Then click Save to add the custom miner field.

     

Step 2: Configure Linking Method in Inventory Settings

  1. Navigate to the Assets tab within Settings, and scroll down to the Link On section.

     

  2. Choose one of the following:
    • Miner Serial - if you want to link using the miner's serial number.
    • Miner Mac - if you want to link using the miner's Mac.
    • Miner Custom Field Name -  if using a custom field.
       
  3. If using a custom field, select the custom name you created earlier (e.g., "Asset Tag").

     

  4. Then click Save at the bottom of the page to keep your update.

 

Step 3: Add the Identifier to the Miner

  1. Go to the Miners page
     
  2. Find the miner to link, and click Actions > Settings.
     
  3. Depending on your method:
    • If using Miner Serial, enter the serial number in the Serial field.
    • If using Miner Mac, enter the MAC address for the miner.
    • If using Miner Custom Field, enter the corresponding value in the custom field (e.g., "Asset Tag").
       
  4. Click Save
     

Step 4: Link the Asset to the Miner

  1. Navigate to the Assets page

     

  2. Find the asset to link, and click Actions > Edit.
     
  3. In the Edit Asset modal:
     
    • Enter the correct Asset ID to match the value on the miner (either the serial number or custom field value).
    • In Linked Item, select the name of the corresponding miner.
       
  4. Click Save.
     

Note: If the Asset ID and the selected miner's field do not match, you will see a "Mismatched link" error.

 

 

Alternate Method: Linking During Asset Creation

You can also set up the linkage while creating a new asset:

  1. Click the Add Asset button on the Assets page.
  2. In the Asset ID field, enter the value matching the miner's serial number, miner MAC, or custom field.
  3. In Linked Item, choose the corresponding miner.
  4. Complete other fields as needed and click Save.
     

Once saved, your asset will be successfully linked to the designated miner, providing structured tracking and operational alignment in Foreman.

 

 

Have more questions? Submit a request below or reach out to the customer success team directly. We'd be happy to help!

 

 

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.