This topic is marked as Legacy as it isn't applicable for most modern ASIC miners. The miners where this feature is relevant and supported are for example Antminer S9 and Antminer L3.
Introduction
In order to monitor a miner like Bitmain Antminer, Awesome Miner is connecting to the Cgminer API running on the miner to request information. By default, Antminer has the API enabled, but the API is running in Restricted mode. In Restricted mode it's possible to view statistics and information about the mining, but no changes like pool operations or restart can be performed.
To get full access to the API, Privileged mode instead of Restricted mode, the Antminer must be configured to allow this. Awesome Miner can connect to Bitmain Antminer using SSH to enable Privileged API access. This operation can be performed on multiple Antminer's at the same time, to make the management of a large number of miners efficient.
Antminers with disabled SSH access
Recent Antminers like S15, T15, S17 and Z11 doesn't have SSH enabled. Bitmain has disabled the SSH access on this miners, making it impossible to configure them for Privileged API access. The latest firmware releases for Antminer S9/L3 in April/May 2019 and later also introduces this SSH restriction. These miners will always run in Restricted API access mode. See the guide Control Antminer without SSH access for more details.
Set Privileged API access
Follow these steps to enable Privileged API access for one or many Bitmain Antminers in a single operation. This feature is available on all modern Antminers.
- Select the Antminers you want to configure API access for in the main window of Awesome Miner
- Select the menu option Main -> ASIC Tools -> Configure API access
- Enter SSH username and password. The default username is root and the default password is admin
- Awesome Miner will automatically detect which Antminer you are using, so leave the Auto detect feature enabled
- There are two options for specifying from which IP addresses the API should be enabled. Please note that it is not the IP address of the Antminer that should be specified. It's the IP address of the computer or network where Awesome Miner is running.
- Any IP address: The Antminer will allow API connections from any IP address. This option should only be selected if the Antminers are in a secure network.
- Specified IP rule: The Antminer will only allow API connections from the IP addresses specified by the rule. All Privileged rules must use W: in front of the IP address. Learn more about API access rules.
The Antminer itself requires API access from localhost (127.0.0.1) for internal use. A rule for this will automatically be appended if not already specified.
- Click OK to apply changes to all selected Antminers
- The Antminers will be restarted after the changes have been applied, and will for that reason appear as Disconnected in Awesome Miner for a short period of time.
Note: If you run into any issues with connecting to the Antminer after specifying an IP address rule, or if you are unsure how to configure it, always use the Any IP address settings.
Information about Antminer API access settings
Antminers can revert back to Restricted API access by themselves in some scenarios. Two common scenarios are:
- If the mining pools of the Antminers are set via the Antminer web interface, the Antminer will revert the API access mode to Restricted when the settings are applied.
- In some reboot scenarios, the Antminer may revert the API access mode back to Restricted.
Automatic detection and configuration of Antminers with Restricted API access
Awesome Miner can be configured to automatically detect Antminers with Restricted API access and configure them to get Privileged API access. This feature can be enabled in the Options dialog, Antminer API access section. This can be useful when adding new miners that needs the configuration for Privileged API access for the first time, but also to detect miners that for some reason has reverted back to Restricted API mode.
Please note the importance of defining a correct IP rule, otherwise the Antminer will be running in Restricted API mode even after the configuration, and Awesome Miner will a few minutes later try to reconfigure it and reboot it again. The best practice is to try the configuration described in the first part of this guide before using the same settings for the automatic detection feature.