Skip to content

Latest commit

 

History

History
198 lines (159 loc) · 9.52 KB

HELP.md

File metadata and controls

198 lines (159 loc) · 9.52 KB
Raw

HOW TOs :

Setup Monitoring Server using VerusBox

📝Note

  • VerusBox monitoring service works in combination with the VerusMiner app
  • Each app should be installed in a separate devices to work
  • VerusMiner is more stable and optimized than the VerusBox's mining version
  • Monitoring is designed to work in a check-it-when-you-need-it basis so it doesn't have to be up all the time
  • You may use a dedicated phone or tablet but it's not required
  • Monitoring works within your local network

Requirements

📲 Download the following apps

  1. VerusBox
  2. VerusMiner

🥓 Part 1 of 2 [ VerusBox Installation ]

  1. Install VerusBox
  2. Open VerusBox then go to Tools > Monitoring
  3. Go to setting ⚙️ and setup the IP ADDRESS and PORT then save
    • make sure you are connected to your Wifi.
    • the IP address should be the same as the IP address of your device connected to the network
    • it is recommended to set the IP address as a static IP to avoid changing all client settings when your local network changes (see Qs)
  4. If everything is setup correctly, no error message should appear
  5. An error will appear if the IP address you set and your device's IP is different.
    • check your connection setting and get the current IP and use it
    • PORT number can be anything. You can leave it as it is
  6. From the Monitoring main screen, find the slider. Slide it to start the server.
  7. Leave it open to wait for any incoming connections

🧀 Part 2 of 2 [ VerusMiner Installation ]

  1. Install VerusMiner
  2. Open VerusMiner and go to More > Monitoring then add by clicking + (plus sign) at the bottom
  3. Add a setting by using the IP ADDRESS and PORT number you set from the VerusBox
    • the IP ADDRESS and PORT number should be the same as the one you used in VerusBox
    • save it or check the connection by pressing the CHECK CONNECTION button.
    • a popup message should appear with a success message when the connection is established
  4. Go to More > Setting > Mining and then add a setting by clicking + (plus sign) floating action button
    • This assumes you already know how to setup a miner but if you're not yet familiar, you can check the links below
  5. From the bottom part, you'll see the MONITORING switch, enable it
  6. Choose the MONITORING SERVER you just created from the dropdown listbox.
    • the IP ADDRESS and PORT number should appear correctly and then save
  7. From the main screen, go to Mining then click START to run the miner.
    • the mining status will now be sent to the VerusBox's monitoring server
  8. You can now start monitoring your app remotely. Enjoy!

Sample Setup

Monitoring Server Sample

Setup VerusMiner to start mining on boot

📝Note

  • If you have an existing Macrodroid setup, please backup your scripts
  • The script requires 2 mobile setting to work properly
  • Some device setting might have a different setting name as described here but you should find an equivalent one based on your brand and model

Requirements

📲 Download the following

  1. Macrodroid App
  2. Macrodroid Script → verusminer_start_on_boot.v2.mdr

🥓 Part 1 of 2 [ Device Setting Update ]

Checkout the following links to get the idea how to setup per brand
  1. Hide the device's bottom navigation bar.
  1. Disable the lock screen. Your goal here is to remove the lock screen so that when you turn on your screen(pressing the power button), you should see the Home screen right away.

🧀 Part 2 of 2 [ Macrodroid Installation ]

  1. Install Macrodroid
  2. Open Macrodroid and go to Home > Export/Import > Import
  • Note that this import will overwrite all the existing scripts you have so make sure to back it all up to save your existing work.
  1. Go to the path where you downloaded the Macrodroid Script and then select.
  2. A couple of prompts will appear requesting for permissions. Just enable it then continue.(most important part)
  3. Go to Macros. From there you should see the Restart Miner on Boot item
  4. Restart your phone to test if it works.
  • During restart, there is a bit of a delay but once the macrodroid icon is active, the script should run within 20 seconds as expected
  1. Should you encounter any problem, drop a message in the discord group.

Sample Script Setup

Macrodroid Script Setup

Questions

⛏ MINING

❔ Why does the miner connection indicator showing it's disconnected but in the monitoring it's still active?

💬 Answer

Sometimes when the miner got disconnected from the network, it usually fails to send the appropriate closing message to the server. As a result, the connection is left open leaving the monitoring server thinks that the client is still active refelecting it in the connection indicator.

❔ How long does it takes for the client to connect to the monitoring server when it got disconnected?

💬 Answer

The main priority of the miner is always the mining. Connection to the monitoring server comes next. When a miner got disconnected, the mining operation would still continue to run. The only time it will care about reconnecting is when the mining status data is collected and ready for publishing. Reconnecting the the server might or might not succeed during the reconnection period but it will retry on the next window time.

So to answer you question, there is no specific timing but the miner will reconnect given the right conditions.

❔ Why is it when I trigger the "Pause Mining" action for some period, some miners did not reconnect instantly?

💬 Answer

It's due to the device's battery and power optimization setting. Sometimes the countdown timer in the mining device would not work due to this thus failing to restart the miners on time. Try to test it and adjust the settings as necessary.

It's recommended to setup you device with setting optimized for mining. This means removing unncessary apps and services to concentrate all the resources for mining operations only.

📺 MONITORING

❔ What are conditions to consider the client as idle

💬 Answer

It's only when the monitoring service detected the client failing to send mining status data for more than 3 minutes.

❔ Can I turn ON and OFF the monitoring server anytime?

💬 Answer

YES. The monitoring server is designed to be used this way.

❔ Can I still run the monitoring even if the IP ADDRESS I use is not a static IP?

💬 Answer

Yes you can but it's recommended to use a static IP ADDRESS. When connected to your network(Wifi), the default IP setting is dynamic. This means,
you can get a new IP ADDRESS different from the one your device used to have at any moment without you knowing it.

For whatever reasons you don't want to set your IP ADDRESS as static, you'll need to update all the client's(VerusMiner) settings to use the new IP ADDRESS you got. That's tedious and beats the purposes of automation.

This setup may vary for each phone brands and models but this will give you an idea how to achieve it.
https://support.honeywellaidc.com/s/article/Android-How-to-set-up-a-static-IP-address

❔ Why can't I see the device in the device selection list?

💬 Answer

Only active devices are visible from the selection.

If for some reasons the available device becomes idle or inactive while in the middle of performing an operation(update setting, pause mining etc.,), it will still proceed but will likely fail.

❔ Can I run mulitple monitoring operations one after another without waiting for the previous operations to complete?

💬 Answer

Yes you can. However, keep in mind that each client is designed to receive and execute a single command at a time. Running multiple operations in a single client without considering the ongoing operation is allowed but is very likely to fail as it will not be handled anymore by the receiving clients.

Other References

  1. VerusBox Mining
  2. VerusBox Setup
  3. Mining Pool Server