home · downloads · knowledge base · changelog · restore ssh · restoring hashboards · team · pool · support · contact
asicseer logo
 
ASIC management, monitoring, and optimization system.

ASICseer is running on 12,894 ASICs and producing 15.2 megawatts of blockchain security.

Table of Contents


Quick Start Guide

ASICseer is separated into read-only and read-write. Your Panel is read-only and your Remote Config File is read-write.

  1. Go to ASICseer Downloads, a Remote Config File will automatically be generated and hosted on ConfigMaker for you.
  2. Save or bookmark your "Secret Config Editor", you will need it to manage all of your ASICs.
  3. Follow the instructions under "Simple and Easy Installation" and wait for the installation to complete.
  4. After the installation finishes, visit the "Miner Configuration" page on your ASIC.

You can use "Powerful and Advanced Installation" to quickly install ASICseer on multiple units via SSH.


Using ConfigMaker for your Remote Config File

  1. Go to ASICseer Downloads to automatically generate a Remote Config File.
  2. Save or bookmark your "Secret Config Editor", you will need it to manage all of your ASICs.
  3. Set your custompanel (optional, but recommended), and edit the Remote Config File to suit your preferences.
  4. Make changes to your ConfigMaker Remote Config File to manage your ASICs.

Setting up your own Remote Config File

If you don't want ConfigMaker to host your Remote Config File, you can host it yourself on a world-reachable remote server, vps, or shared hosting account that you control.

  1. Copy https://asicseer.com/config.txt and host it yourself on a world-reachable remote server, vps, or shared hosting account that you control.
  2. Get the link to your Remote Config File like http://your-server.com/config.txt
    NOTE: The link http://your-server.com/config.txt is an example. You must use your own link.
  3. Set your custompanel (optional, but recommended), edit the Remote Config File to suit your preferences.
  4. Make changes to your Remote Config File to manage your ASICs. See Writing your Config for documentation.
  5. Paste the link to your Remote Config File into the "Remote Config File" field on the Downloads page and click "Regenerate Downloads."

Setting up a Server for your Remote Config File

If you don't have a remote server and don't want to use ConfigMaker, you can create a remote server with DigitalOcean.

  1. Go to DigitalOcean (follow this link to get $50 credit), create an account, then click "Create -> Droplet."
  2. Click on "Marketplace" and select "LEMP on 18.04" software stack.
  3. Scroll down, click the left arrow, select "$5/month" droplet (not $40/month), your closest region, "one-time password", and click "Create."
  4. After the droplet is created, follow the SSH guide to SSH to your DigitalOcean droplet.
  5. Descend into the world-readable html directory with cd /var/www/html
  6. Copy the sample Remote Config File to your DigitalOcean Droplet with wget https://asicseer.com/config.txt
  7. Make changes to your Remote Config File on your DigitalOcean droplet with nano /var/www/html/config.txt
  8. The link to your Remote Config File is now http://digital.ocean.ip.address/config.txt
  9. Paste the link to your Remote Config File into the "Remote Config File" field on the Downloads page and click "Regenerate Downloads."

Using the multi-ASIC installer

  1. Add your vlans into your Remote Config File (example). Each vlan must be specified like: 10.8.250.0-255 (last octet is a range).
  2. Add your ASIC root password (usually "admin") into your Remote Config File as shown in the example.
  3. sudo su to become root. You must actually be root to run this installer.
  4. echo -n "" > /root/.ssh/known_hosts to clear possible re-used IP addresses.
  5. Install nmap sshpass awk sha256sum curl if your linux box doesn't have them installed.
    • ubuntu, debian example: apt-get -fy install nmap
    • ethos example: apt-get-ubuntu -fy install nmap
    • fedora, centos example: yum -y install nmap
  6. Follow the Quick Start Guide to generate your installer script.
  7. Copy/paste the line under "MULTI-ASIC INSTALLER" into your linux box and press ENTER.
  8. Wait for the installation process to start.
  9. The installer output will fill your screen. Once there is no more output (you can check by pressing ENTER), the installation is finished.

Writing your Config

Your entire farm can be controlled with a single Remote Config File. Your Remote Config File is downloaded and applied to your ASIC every 10 minutes, so any changes can take up to 10 minutes to take effect.

For faster responsiveness (every 2 minutes instead of 10 minutes), host your own Remote Config and add RESPONSIVE to its URL (example: http://your-server.com/configRESPONSIVE.txt)

See https://asicseer.com/config.txt for an example Remote Config File. Everything with a hashtag/poundsign is a comment, and is ignored by all scripts. All settings, except for usernames, wallets, and passwords, are always lowercase.

The format for editing your Remote Config File is asicid setting value where:

Use global for the asicid to apply a setting to all ASICs on which you have installed the same Remote Config File.

poolname2,username2,poolpass2,sendworker2andpoolname3,username3,poolpass3,sendworker3 are the 2nd/3rd pools.

Grouping

group searches the beginning of your location for a string and applies your setting to any ASIC location that has a match.

The location must start with the string to match. The below example will reboot ASICs with a location starting with rowc, and will stop mining on ASICs with a location that has rowd in it.

You must have locations defined for grouping to work.

If you use multiple groups, note that only the first line will match, all other lines will be ignored. Therefore, users of multiple groups must define more precise names (longer string like group=r1a) above less precise names (shorter strings like group=r1).

# group=rowc rebootasic 1
# group=rowd allowed no

Customizing your Worker Name / Location

You can use one Remote Config File for all ASICs. Even if you want to specify multiple workers, you don't need a different Remote Config File per ASIC. To switch your worker name and assign a location, follow the below guide.

  1. Do not add a newname to your wallet like wallet.newname, this will not work.
  2. Set asicid location newname (asicid is your original 6-digit worker name and newname is your new worker name).
    example: ab34ef location rowc2 as shown in the Sample Remote Config File.
  3. Do not use very long newname. The maximum length is 12 characters.
  4. Do not use the same newname for multiple ASICs.

After this procedure, your pool will see your new worker name, and your ASIC will have a new location assigned on your Panel.


Assigning Worker Names / Locations with the IP Report Button

If you use hostnames to manage your worker names and ASIC locations, ASICseer will use them to set Worker Names / Locations during installation. If you have a big farm and don't know where any of your ASICs are located, you can order them with the IP Report button located on your ASICs.

NOTE: It is important to do the below steps when your Internet is stable, and your ASICs are online and reporting.

  1. After installing ASICseer, go to your Panel. Then, physically go to your first Rack ("Rack A") and decide on an order for them.
  2. Press the IP Report button on the "Rack A" ASICs in order, one by one (wait at least 3 seconds between presses).
  3. Wait at least 3 minutes.
  4. Your Panel will show a number in the "ipr" column (seconds ago that the IP report button was pressed).
  5. Select "assign workers" from the dropdown menu and click the "submit" button.
  6. Set your worker names like: a1,a2,a3...
  7. Continue this process for all rows/racks. If you press the IP report button on all ASICs in your preferred order, they will be ordered correctly.

Assigning Worker Names / Locations with REGEX

If you use static IPs for your ASICs, you can use regex to assign IP octets for your worker name and location.

  1. After installing ASICseer, go to your Panel.
  2. Select "config template" from the dropdown menu and click the "submit" button.
  3. Copy and Paste the config template into the "TEST STRING" field of regex101.com's regex editor.
  4. Copy and Paste the resulting "SUBSTITUTION" result into your Remote Config File and save it.

After 10 minutes, all your ASICs will have downloaded and applied the new settings, the new locations will be set on your Panel, and the new worker names will be sent to your pool.


Remotely Rebooting ASICs

If your ASICs are reachable (i.e. they don't have a ❌ icon), you can reboot them remotely using your Remote Config File.

  1. Go to your Panel.
  2. Select the checkboxes to the left of the conditions affecting your ASICs, select "reduce overheats" and click the submit button.
  3. Your Panel will generate settings for your Remote Config File to reboot your affected ASICs
  4. Copy-paste the entire output into your Remote Config File.
  5. Within 10 minutes, all affected ASICs will reboot.

Reducing Facility Overheats

Due to environmental conditions (fan health, physical location, airflow, etc) not all ASICs can operate at the same maxwatts setting. You can maximize hashrate by tuning your entire facility to each ASIC's individual highest possible maxwatts with the below guide:

global maxwatts 1480
global maxtemp 90 6
global throttle 80

Add the above stanza to your Remote Config File, which means:

  1. Start mining/tuning at 1480 watts.
  2. If any hashboard reaches 90C, trigger an overheat and stop mining.
  3. Restart mining automatically after 6 hours passes.
  4. If mining is restarted after an overheat, throttle maxwatts by 80 watts (i.e. 1400, then 1320, etc).
    NOTE: The minimum and maximum settings for throttle are 25-200 watts.
  5. Each ASIC will automatically tune to its highest possible maxwatts setting, with as much granularity as you prefer.

To remove tuning data, add the below to your Remote Config File:

global resetasic 1566195829 (use the asicid instead of global)

Managing Temperature

If the hashboard temperature exceeds maxtemp, the miner will turn off until you reboot or reset the ASIC.

Follow the below steps to reduce the chances of your ASICs overheating:

Then, reboot or reset your ovearheated ASIC.


Setting a Custom Panel

ASICseer assigns a 6-character Panel based on a hash of your external IP. This way, all ASICs on one network can report to the same Panel.

If your public IP changes, your Panel will change.

You can set your own Custom Panel with the custompanel parameter.

NOTE! After any changes to custompanel wait 15 minutes for it to update, or run putconf; sleep 2; update; on the ASIC.


Deleting/Removing ASICs from your Panel

ASICseer is separated into read-only and read-write. Your Panel is read-only and your Remote Config File is read-write.

You cannot request the Panel to delete data if your ASIC is down. There are only two options for removing ASICs from your Panel:


Forcing Remote Config and Panel Sync

Sometimes, you may need to sync your Remote Config File to your ASICs.

For Single ASICs

Navigate to your Miner Configuration page and click the sync config and panel button.

For Multiple ASICs

Run the below script on a linux box local to your ASIC network:
curl -s -k https://asicseer.com/netsync/a/http://your-server.com/config.txt | sh

NOTE: This is an intensive script and is not meant to be run regularly.


Updating to the Latest ASICseer Version

It is highly recommended that you keep global autoupdate yes in your Remote Config File. The ASICseer team drops support for all previous ASICseer versions as soon as a new update is released, in line with an aggressive development schedule. If any issues occur with previous versions, no support will be provided until you update.

NOTE: There is no difference between updating and installing ASICseer. You can always update by reinstalling ASICseer.

If some ASICs miss their update, update them by either reinstalling ASICseer or by using the below methods:

Example of autoupdating only ASICs that need the latest version:
curl -s -k https://asicseer.com/netdeploy/a/autoupdate/admin/10.8.250-252.0-255 | sh

Example of forcing autoupdate for all ASICs regardless of version:
curl -s -k https://asicseer.com/netdeploy/a,force/autoupdate/admin/10.8.250-252.0-255 | sh

For faster scanning: edit only the last two VLAN octets.


Using JSON API to load per-panel or per-ASIC Data

The following API endpoints can load historical monthly per-Panel and per-asic data, useful for enterprise-class customer billing purposes.

https://asicseer.com/api/type-call/panel/month

examples using 07 (the last month):

How to load ASICseer API data in Google Docs:

  1. Open Google Docs and go to Tools -> Script Editor
  2. Paste the below function into the Script Editor for Code.gs
    function readJSON2(inV) {
    var jsonStringResponse = UrlFetchApp.fetch(inV);
    eval("object ="+jsonStringResponse.getContentText());
    var outA = new Array(); var h = 0;
    for ( var j in object ) { outA[h] = object[j];h++;}
    return outA }
  3. Save your changes.
  4. Add, for example, =readJSON2("https://asicseer.com/api/panel-kwh/asdemo/07") to any cell.

Using Nicehash for Mining without a Pool Account

If you don't want to set up any pool accounts, you can use Nicehash.

  1. Replace the pools in your config with the below stanza.
  2. Replace the predefined stratum server locations if necessary.
  3. Your username is your wallet address, replace it with your own wallet address.
global poolname1 sha256.usa.nicehash.com:3334
global username1 15tXyQAYyiD4q1FUVcsdMgG78fFZG6J9zD
global poolpass1 x
global sendworker1 yes
global poolname2 sha256.eu.nicehash.com:3334
global username2 15tXyQAYyiD4q1FUVcsdMgG78fFZG6J9zD
global poolpass2 x
global sendworker2 yes
global poolname3 sha256.hk.nicehash.com:3334
global username3 15tXyQAYyiD4q1FUVcsdMgG78fFZG6J9zD
global poolpass3 x
global sendworker3 yes

Securing your ASIC with Passwordless Login and Public Key

To secure your ASIC and to prevent unauthorized logins, you should use passwordless public key authentication.

WARNING: This procedure disables your password login, so be absolutely sure that your key pair works. Test this procedure with a new Remote Config File on a SINGLE ASIC before using your existing Remote Config File. Keep the SSH session running while you test.

  1. Generate an SSH key pair (instructions for linux and windows).
  2. Add your public key to your Remote Config File like pubkey ssh-rsa AAAAB3gZk1XXXXXX...XXX (only one pubkey per Remote Config File).
  3. Install (or re-install) ASICseer. NOTE: As a security precaution, public key installation occurs only during ASICseer installation.

Using SSH to Login to ASICs from Windows

  1. Connect your computer to the same network as your ASICs.
  2. Download Putty from http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe.
    Putty is an executable that can be run without installing.
  3. Find the IP of your ASIC.
    You can find your ASIC IP on your asicseer.com Panel or on your router's DHCP client table.
  4. Open Putty and input ASIC Information.
    Type the ASIC's IP into Host Name. Port should be 22. Click Open.
  5. Login to ASICseer terminal.
    When the terminal window shows up, login with username root, password admin.
  6. A list of available commands will appear.

Pasting Text: In Windows, CTRL+C to copy text. In putty, SHIFT+INSERT to paste it.
To SSH remotely: Connect to a dedicated VPN box on your ASIC network using your favorite vpn software.


List of Common ASICseer Terminal Commands

---------------------------------------------------------------
ASICseer | available commands:

dmesg		show kernel log
helpme          show this list of commands
gethelp         generate a diagnostics file for getting support
df | p          send output of piped (ex: df) to paste server
update          force a stats update to the panel server
putconf         redownload the contents of your remote config
rawstats        display non-formatted system info / miner stats
jsonstats	display json-formatted system info / miner stats
pool		display recommended pool statistics
----------------------------------------------------------------

Clearing your ASIC's MAC address to Prevent Conficts

In large farms, there are sometimes conflicting MAC address that result in multiple ASICs appearing as if they are one. This results in arp conflicts, incorrect reporting, etc.

If you see multiple ASICs with the same MAC address, you should regenerate the MAC address on your ASIC and then reboot it:

rm /config/mac && sync && sleep 1 && reboot


Identifying Faulty Hashboards

Many people who install ASICseer are surprised to see faulty hashboards. These faulty hashboards existed before you installed ASICseer, you just did not know about them. You can verify this by checking your pool-side hashrate for any individual worker.

If your ASIC has identified a faulty hashboard, it will show a 🔗 or 🔘. You can identify the faulty hashboard using the Panel and the [ | ] hashboard detection symbols.

The below symbols identify which hashboard is detected and working fine from the exhaust side.

If your ASIC shows a 🔗, it indicates a high chain xtime.

If your ASIC shows a 🔘, it indicates a broken hashboard.


Uninstalling ASICseer and/or Restoring to Factory Settings

Using the IP Report Button

Use the "Restore via IP Report Button" functionality as described on Point 3 of the Bitmain© factory restore guide.

Using the WebUI firmware Upgrade Page

  1. Download the correct Bitmain© firmware for your ASIC.
    NOTE: Be careful, any Bitmain© firmware described as having a "security" or "secure" firmware actually prevents SSH to your ASIC.
  2. Navigate to your ASIC's firmware upgrade page and upload the Bitmain© firmware to your ASIC.

Powerful and Advanced Uninstallation

Re-complete the /flash/ or /netflash/ installation procedure with the uninstall flag, example:
      curl -s -k https://asicseer.com/flash/a/uninstall | ash

NOTE: This will restore all settings and pools to factory settings.


Get Immediate 24/7 Support via Telegram

Free 24/7 support: Free lifetime support 24/7 via the ASICseer Telegram channel.

https://t.me/ASICseer


Contacting the ASICseer Team

Please direct all Media and Business inquiries to info@asicseer.com

Emails requesting technical support will be treated as spam. Get Immediate 24/7 Support via Telegram.






















































© 2019       ASICshack logo       All rights reserved.