MVisConfig

Configuring Mining Visualizer

To configure Mining Visualizer, click on Tools / Preferences. This can also be accessed from the system tray menu.

Miners

• Use the buttons on the right to add, delete, or edit miners. You can rearrange the list using the up/down buttons.
• UDP Listen - This is the UDP port MVis will listen on when communicating with the miners
• UDP Password - MVis will attempt to establish a connect with the miners using this password. If used, this needs to match the UdpPassword setting in ethminer.ini

Miner Edit

• Listening Port - the UDP port the miner will be listening on. This needs to match the UdpListen setting in ethminer.ini.
• GPU's - the number of GPU's installed in this miner
• Expected Hash Rate - the total hash rate this miner can normally achieve. This will be compared with the actual hash rate to determine if an alert should be displayed.
• Inactive - If you plan to take this miner offline for some reason (ie. maintenance), place a check mark here to prevent alerts from being raised.
• Temp Range Hi - the high end of the normal operating temperature range for GPUs in this mining rig. If the temperature of any individual GPU exceeds this value, an alert will be raised. It is best to avoid placing different GPUs in one mining rig that have significantly different operating temperatures.
• Never Exceed - Temperature at which GPU throttling will be activated. Throttling is accomplished by placing pauses into the hashing algorithm to reduce the heat output.
• Safety Shutdown - The number of seconds the GPU temperature will be allowed to remain at or above Never Exceed before the entire mining rig shuts down.
• Hash Faults Alert - the number of hash faults from any single GPU, in a 4 hour period, that will trigger an alert.
• Test Connection - perform a simple ping test to verify network communication with the miner. The miner needs to be running for this to succeed.

Desktop Widget

• Hash Rates Display - how to display hash rates on the desktop widget, taking into consideration the number of mining rigs and GPUs you have, and the amount of room to display information on the desktop widget.
• Temperature Display - if you only have 1 mining rig with no more than 3 or 4 GPUs, you can specify Individual GPUs to see the temperature of each GPU on the desktop widget. If you have more than that, you should select Farm Status. In this mode, the widget will display Ok if all GPUs are in their normal operating range. If any of them are above the Temp Range Hi setting, the widget will display Alert.
• Hash Rate Deviation Alert - if the total reported hash rate for all mining rigs differs from the expected hash rate by more than this amount, an alert will be displayed.

For general information on the information presented in the widgets, please visit the Desktop Widets page.

Web App

MVis contains an embedded HTTP web server which implements a 3 page web app to display information pertaining to your mining operation. SECURITY ALERT : The code for this server has not been audited for security. Make absolutely certain that you only use this behind a properly configured firewall / router. If you choose to open up the necessary ports in your firewall so you can access this web app remotely, and thereby expose this server to the entire internet, you take full responsibility for any adverse incursions that may occur.

• HTTP Port - the port number the embedded server will be listening on. Assuming the default value, you would access the web app at http://localhost:8018. For extra security, consider using a non-standard 5 digit port number, in the range of 10000 - 65535.
• Require Login - if enabled, only authenticated users will be able to access the web app. SECURITY ALERT - the password is transmitted from the browser to the server unencrypted. You can (and should!) mitigate this by using SSL encryption.
• Use SSL - this causes the communication link between the browser and the server to be encrypted. You need to supply 3 certificate files, which are provided for you in the SSL-Certs subfolder. (Mac users: right-click on the .app file and select Show Package Contents to find the subfolder). You can also create your own if you want. If you enable this option, the web app address changes to https://localhost:8018. You'll need to install the root CA certificate into your browser. See the Readme file in the SSL-Certs subfolder for more information.

Close Hits

MVis-ethminer keeps track of hashes computed that were within a certain range of the Target value, and reports them as Close Hits. These Close Hits are displayed graphically on the desktop widget and in the web app.

There is a second type of computed hash that the miner reports, called Work Units. They are exactly the same as Close Hits except the difficulty level for Work Units is much lower than that of Close Hits (the target is higher). Work Units are only displayed in the Web App. Unlike Close Hits, which are graphed individually, Work Units are aggregated into 4 hour time periods and displayed as a histogram.

• Close Hit Frequency - you can specify the average time period between Close Hits. The difficulty level is then adjusted to try to achieve this rate.
• Graph Scaling - determines how the Close Hit hash values are scaled for display. Logarithmic scaling tends to de-emphasize the higher hash values.
• Work Unit Frequency - you can specify the average time period between Work Units, which defaults to 10 minutes. The difficulty level is then adjusted to try to achieve this rate.
• Miner Label Template - when Close Hits are displayed on the desktop widget, the hash value (upper 64 bits only) is displayed on the right. The left hand part of the display can be a combination of the time & date the Close Hit was found, and the mining rig and GPU that found the hash. For instance, you could enter #MINER# - #GPU# to cause the mining rig name and the GPU# to be displayed.

Alerts

Alerts are triggered by the following conditions:

• discrepancies in the number of miners/GPUs currently online and reporting work
• hash rate abnormalities
• GPU temperature deviations
• Excessive hash faults

• You can specify what action should be taken when an alert occurs. Possible options are an executable program, a batch / script file, or a URL to be pinged using GET. URLs need to be fully specified, including the proper http:// or https:// prefix.

• Of course for this to be effective, Mining Visualizer needs to be running 24/7.