404
+ +Page not found
+ + +'+ escapeHtml(title) + '
' + escapeHtml(summary) +'
+
+
+
+ Page not found
+ + +This manual provides comprehensive documentation for setting up, operating, and maintaining your bitcoin mining facility.
+' + escapeHtml(summary) +'
' + noResultsText + '
'); + } +} + +function doSearch () { + var query = document.getElementById('mkdocs-search-query').value; + if (query.length > min_search_length) { + if (!window.Worker) { + displayResults(search(query)); + } else { + searchWorker.postMessage({query: query}); + } + } else { + // Clear results for short queries + displayResults([]); + } +} + +function initSearch () { + var search_input = document.getElementById('mkdocs-search-query'); + if (search_input) { + search_input.addEventListener("keyup", doSearch); + } + var term = getSearchTermFromLocation(); + if (term) { + search_input.value = term; + doSearch(); + } +} + +function onWorkerMessage (e) { + if (e.data.allowSearch) { + initSearch(); + } else if (e.data.results) { + var results = e.data.results; + displayResults(results); + } else if (e.data.config) { + min_search_length = e.data.config.min_search_length-1; + } +} + +if (!window.Worker) { + console.log('Web Worker API not supported'); + // load index in main thread + $.getScript(joinUrl(base_url, "search/worker.js")).done(function () { + console.log('Loaded worker'); + init(); + window.postMessage = function (msg) { + onWorkerMessage({data: msg}); + }; + }).fail(function (jqxhr, settings, exception) { + console.error('Could not load worker.js'); + }); +} else { + // Wrap search in a web worker + var searchWorker = new Worker(joinUrl(base_url, "search/worker.js")); + searchWorker.postMessage({init: true}); + searchWorker.onmessage = onWorkerMessage; +} diff --git a/site/search/search_index.json b/site/search/search_index.json new file mode 100644 index 0000000..13722cf --- /dev/null +++ b/site/search/search_index.json @@ -0,0 +1 @@ +{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"Welcome to the Megawatt Mining Manual This manual provides comprehensive documentation for setting up, operating, and maintaining your bitcoin mining facility. Contents Setup Hardware Software Network Operations Monitoring Troubleshooting Maintenance Cleaning Repairs FAQ Glossary Contacts Versioning","title":"Home"},{"location":"#welcome-to-the-megawatt-mining-manual","text":"This manual provides comprehensive documentation for setting up, operating, and maintaining your bitcoin mining facility.","title":"Welcome to the Megawatt Mining Manual"},{"location":"#contents","text":"Setup Hardware Software Network Operations Monitoring Troubleshooting Maintenance Cleaning Repairs FAQ Glossary Contacts Versioning","title":"Contents"},{"location":"contacts/","text":"Contacts Key Contacts Operations Manager Name: John Doe Email: john.doe@example.com Phone: (123) 456-7890 Technical Support Name: Jane Smith Email: jane.smith@example.com Phone: (987) 654-3210 Maintenance Supervisor Name: Bob Johnson Email: bob.johnson@example.com Phone: (555) 555-5555","title":"Contacts"},{"location":"contacts/#contacts","text":"","title":"Contacts"},{"location":"contacts/#key-contacts","text":"","title":"Key Contacts"},{"location":"contacts/#operations-manager","text":"Name: John Doe Email: john.doe@example.com Phone: (123) 456-7890","title":"Operations Manager"},{"location":"contacts/#technical-support","text":"Name: Jane Smith Email: jane.smith@example.com Phone: (987) 654-3210","title":"Technical Support"},{"location":"contacts/#maintenance-supervisor","text":"Name: Bob Johnson Email: bob.johnson@example.com Phone: (555) 555-5555","title":"Maintenance Supervisor"},{"location":"faq/","text":"Frequently Asked Questions (FAQ) General What is the capacity of our mining facility? Our facility has 10 tanks containing varying numbers of Antminer S19s. How do we monitor the mining operations? We use Foreman (foreman.mn) to monitor all mining operations. What communication tool do we use? We use Slack for all team communications and alerts. Technical How often should we clean the miners? Cleaning should be performed every three months or as needed based on environmental conditions. What should I do if I get trapped in tank 5? Call another technician to come let you out or derack a row of miners from the hot aisle and climb through to the cold aisle. What should I do if a miner stops working? Refer to the Troubleshooting Operations section for common issues and solutions.","title":"FAQ"},{"location":"faq/#frequently-asked-questions-faq","text":"","title":"Frequently Asked Questions (FAQ)"},{"location":"faq/#general","text":"","title":"General"},{"location":"faq/#what-is-the-capacity-of-our-mining-facility","text":"Our facility has 10 tanks containing varying numbers of Antminer S19s.","title":"What is the capacity of our mining facility?"},{"location":"faq/#how-do-we-monitor-the-mining-operations","text":"We use Foreman (foreman.mn) to monitor all mining operations.","title":"How do we monitor the mining operations?"},{"location":"faq/#what-communication-tool-do-we-use","text":"We use Slack for all team communications and alerts.","title":"What communication tool do we use?"},{"location":"faq/#technical","text":"","title":"Technical"},{"location":"faq/#how-often-should-we-clean-the-miners","text":"Cleaning should be performed every three months or as needed based on environmental conditions.","title":"How often should we clean the miners?"},{"location":"faq/#what-should-i-do-if-i-get-trapped-in-tank-5","text":"Call another technician to come let you out or derack a row of miners from the hot aisle and climb through to the cold aisle.","title":"What should I do if I get trapped in tank 5?"},{"location":"faq/#what-should-i-do-if-a-miner-stops-working","text":"Refer to the Troubleshooting Operations section for common issues and solutions.","title":"What should I do if a miner stops working?"},{"location":"glossary/","text":"Glossary Terms ASIC Miner Definition: Application-Specific Integrated Circuit miner, a device used for mining cryptocurrencies. Foreman Definition: A monitoring tool used to oversee and manage mining operations. PSU Definition: Power Supply Unit, provides power to the miners. Slack Definition: A communication platform used for team collaboration and alerts. eeprom Definition: Electrically erasable programmable read-only memory","title":"Glossary"},{"location":"glossary/#glossary","text":"","title":"Glossary"},{"location":"glossary/#terms","text":"","title":"Terms"},{"location":"glossary/#asic-miner","text":"Definition: Application-Specific Integrated Circuit miner, a device used for mining cryptocurrencies.","title":"ASIC Miner"},{"location":"glossary/#foreman","text":"Definition: A monitoring tool used to oversee and manage mining operations.","title":"Foreman"},{"location":"glossary/#psu","text":"Definition: Power Supply Unit, provides power to the miners.","title":"PSU"},{"location":"glossary/#slack","text":"Definition: A communication platform used for team collaboration and alerts.","title":"Slack"},{"location":"glossary/#eeprom","text":"Definition: Electrically erasable programmable read-only memory","title":"eeprom"},{"location":"versioning/","text":"Versioning Version Control Current Version Version: 0.1 Release Date: June 20, 2024 Version History Version 0.1 Release Date: June 20, 2024 Changes: Initial alpha foundation build with setup, operations, maintenance, FAQ, and contacts sections.","title":"Versioning"},{"location":"versioning/#versioning","text":"","title":"Versioning"},{"location":"versioning/#version-control","text":"","title":"Version Control"},{"location":"versioning/#current-version","text":"Version: 0.1 Release Date: June 20, 2024","title":"Current Version"},{"location":"versioning/#version-history","text":"","title":"Version History"},{"location":"versioning/#version-01","text":"Release Date: June 20, 2024 Changes: Initial alpha foundation build with setup, operations, maintenance, FAQ, and contacts sections.","title":"Version 0.1"},{"location":"maintenance/cleaning/","text":"Cleaning Procedures Cleaning Equipment Compressed Air Soft Brushes Cleaning Cloths Cleaning Steps Power Down the Miner: Ensure the miner is powered down and unplugged. Remove Dust: Use compressed air to blow out dust from the miner. Clean Fans and Heat Sinks: Use soft brushes and cleaning cloths to clean the fans and heat sinks. Inspect for Damage: Check for any visible damage or wear and tear. Frequency Perform cleaning every three months or as needed based on environmental conditions.","title":"Cleaning"},{"location":"maintenance/cleaning/#cleaning-procedures","text":"","title":"Cleaning Procedures"},{"location":"maintenance/cleaning/#cleaning-equipment","text":"Compressed Air Soft Brushes Cleaning Cloths","title":"Cleaning Equipment"},{"location":"maintenance/cleaning/#cleaning-steps","text":"Power Down the Miner: Ensure the miner is powered down and unplugged. Remove Dust: Use compressed air to blow out dust from the miner. Clean Fans and Heat Sinks: Use soft brushes and cleaning cloths to clean the fans and heat sinks. Inspect for Damage: Check for any visible damage or wear and tear.","title":"Cleaning Steps"},{"location":"maintenance/cleaning/#frequency","text":"Perform cleaning every three months or as needed based on environmental conditions.","title":"Frequency"},{"location":"maintenance/repairs/","text":"Repair Procedures Common Repairs Fan Replacements Steps: Power down the miner and unplug it. Remove the faulty fan. Install the new fan. Power up the miner and verify operation. Chip Swaps Steps: Power down the miner and unplug it. Remove the damaged chip. Install the new chip. Power up the miner and verify operation. Merges Steps: Power down the miner and unplug it. Connect the miners as per the merge instructions. Power up the miners and verify operation. Repair Facility All major repairs should be conducted at the primary facility designated for repairs. LuxOS Specific \"Too many frequency read errors; the entire ramping step will be aborted.\" This seemes to equate to a \"no chip bin\" error on stock firmware. Not sure if it's a good fix, but uninstalling LuxOS and reinstalling it seems to fix this problem - at least temporarily.","title":"Repairs"},{"location":"maintenance/repairs/#repair-procedures","text":"","title":"Repair Procedures"},{"location":"maintenance/repairs/#common-repairs","text":"","title":"Common Repairs"},{"location":"maintenance/repairs/#fan-replacements","text":"Steps: Power down the miner and unplug it. Remove the faulty fan. Install the new fan. Power up the miner and verify operation.","title":"Fan Replacements"},{"location":"maintenance/repairs/#chip-swaps","text":"Steps: Power down the miner and unplug it. Remove the damaged chip. Install the new chip. Power up the miner and verify operation.","title":"Chip Swaps"},{"location":"maintenance/repairs/#merges","text":"Steps: Power down the miner and unplug it. Connect the miners as per the merge instructions. Power up the miners and verify operation.","title":"Merges"},{"location":"maintenance/repairs/#repair-facility","text":"All major repairs should be conducted at the primary facility designated for repairs.","title":"Repair Facility"},{"location":"maintenance/repairs/#luxos-specific","text":"","title":"LuxOS Specific"},{"location":"maintenance/repairs/#too-many-frequency-read-errors-the-entire-ramping-step-will-be-aborted","text":"This seemes to equate to a \"no chip bin\" error on stock firmware. Not sure if it's a good fix, but uninstalling LuxOS and reinstalling it seems to fix this problem - at least temporarily.","title":"\"Too many frequency read errors; the entire ramping step will be aborted.\""},{"location":"operations/monitoring/","text":"Monitoring Operations Monitoring Tools Foreman (foreman.mn) Monitoring Steps Set Up Foreman: Ensure that all Antminer S19 units are registered and configured in Foreman. Real-Time Monitoring: Use Foreman to monitor real-time performance and status of each miner. Alerts and Notifications: Configure alerts in Foreman for any issues or irregularities. Use Slack for team notifications.","title":"Monitoring"},{"location":"operations/monitoring/#monitoring-operations","text":"","title":"Monitoring Operations"},{"location":"operations/monitoring/#monitoring-tools","text":"Foreman (foreman.mn)","title":"Monitoring Tools"},{"location":"operations/monitoring/#monitoring-steps","text":"Set Up Foreman: Ensure that all Antminer S19 units are registered and configured in Foreman. Real-Time Monitoring: Use Foreman to monitor real-time performance and status of each miner. Alerts and Notifications: Configure alerts in Foreman for any issues or irregularities. Use Slack for team notifications.","title":"Monitoring Steps"},{"location":"operations/troubleshooting/","text":"Troubleshooting Operations Common Issues and Solutions Power Issues Symptom: No power to the miner. Solution: Check PSU connections and verify that the PSU is operational. Network Issues Symptom: Miner not connecting to the network. Solution: Verify Ethernet cable connections, IP address assignment, and network settings. Performance Issues Symptom: Miner underperforming. Solution: Check cooling systems, firmware updates, and miner configurations. Foreman Alerts Symptom: Alerts from Foreman. Solution: Investigate the alert details in Foreman and take appropriate action.","title":"Troubleshooting"},{"location":"operations/troubleshooting/#troubleshooting-operations","text":"","title":"Troubleshooting Operations"},{"location":"operations/troubleshooting/#common-issues-and-solutions","text":"","title":"Common Issues and Solutions"},{"location":"operations/troubleshooting/#power-issues","text":"Symptom: No power to the miner. Solution: Check PSU connections and verify that the PSU is operational.","title":"Power Issues"},{"location":"operations/troubleshooting/#network-issues","text":"Symptom: Miner not connecting to the network. Solution: Verify Ethernet cable connections, IP address assignment, and network settings.","title":"Network Issues"},{"location":"operations/troubleshooting/#performance-issues","text":"Symptom: Miner underperforming. Solution: Check cooling systems, firmware updates, and miner configurations.","title":"Performance Issues"},{"location":"operations/troubleshooting/#foreman-alerts","text":"Symptom: Alerts from Foreman. Solution: Investigate the alert details in Foreman and take appropriate action.","title":"Foreman Alerts"},{"location":"setup/hardware/","text":"Hardware Setup Required Equipment Antminer S19 (k pro, j pro xp, j models) Power Supply Units (PSUs) Ethernet Cables Cooling Systems (fans, AC units) Setup Steps Unpack the Hardware: Carefully remove the Antminer S19 units and PSUs from their packaging. Connect Power Supplies: Attach the PSU to each miner using the provided cables. Network Configuration: Connect the miners to your network using Ethernet cables. Cooling Setup: Ensure that all cooling systems are properly installed and functional. Troubleshooting No Power: Check the PSU connections and ensure that they are securely attached. Network Issues: Verify that the Ethernet cables are properly connected and check your network settings.","title":"Hardware"},{"location":"setup/hardware/#hardware-setup","text":"","title":"Hardware Setup"},{"location":"setup/hardware/#required-equipment","text":"Antminer S19 (k pro, j pro xp, j models) Power Supply Units (PSUs) Ethernet Cables Cooling Systems (fans, AC units)","title":"Required Equipment"},{"location":"setup/hardware/#setup-steps","text":"Unpack the Hardware: Carefully remove the Antminer S19 units and PSUs from their packaging. Connect Power Supplies: Attach the PSU to each miner using the provided cables. Network Configuration: Connect the miners to your network using Ethernet cables. Cooling Setup: Ensure that all cooling systems are properly installed and functional.","title":"Setup Steps"},{"location":"setup/hardware/#troubleshooting","text":"No Power: Check the PSU connections and ensure that they are securely attached. Network Issues: Verify that the Ethernet cables are properly connected and check your network settings.","title":"Troubleshooting"},{"location":"setup/network/","text":"Network Setup Required Network Equipment Routers Switches Ethernet Cables Network Configuration Steps Connect Routers and Switches: Set up the network infrastructure by connecting routers and switches. Assign IP Addresses: Ensure that each Antminer S19 is assigned a unique IP address. Configure Network Settings: Set up the necessary network settings on each miner for optimal performance. Monitor Network Activity: Use Foreman to monitor network activity and miner performance.","title":"Network"},{"location":"setup/network/#network-setup","text":"","title":"Network Setup"},{"location":"setup/network/#required-network-equipment","text":"Routers Switches Ethernet Cables","title":"Required Network Equipment"},{"location":"setup/network/#network-configuration-steps","text":"Connect Routers and Switches: Set up the network infrastructure by connecting routers and switches. Assign IP Addresses: Ensure that each Antminer S19 is assigned a unique IP address. Configure Network Settings: Set up the necessary network settings on each miner for optimal performance. Monitor Network Activity: Use Foreman to monitor network activity and miner performance.","title":"Network Configuration Steps"},{"location":"setup/software/","text":"Software Setup Required Software Foreman (foreman.mn) used for monitoring Slack for communication Firmware updates IP reporting software Installation Steps Download Software: Obtain the latest version of your preferred mining software. Install Software: Follow the installation instructions specific to your operating system. Configure Software: Edit the configuration files to include your mining pool information and other relevant settings. Set Up Foreman: Configure Foreman (foreman.mn) to monitor your mining activity. Set Up Slack: Integrate Slack for team communication and alerts. Firmware used Stock Bitmain firmware Braiins OS LuxOS LuxOS Settings: NOTE: USER MUST ENTER VALUES IN BLANK FIELDS Power: power mode: active autotuner: enabled. Profile tab empty General settings: minimum fan: 4 overtemp: enabled NoPIC: enabled ATM: ATM:ON Hot Board Buffer: 5 min profile -4 steps Max profile: default Startup time: 1 post ramping time: 1 Pool Configuration: No changes made here Firmware: Update Firmware: stable To add: Information on firmware settings, tuning, etc","title":"Software"},{"location":"setup/software/#software-setup","text":"","title":"Software Setup"},{"location":"setup/software/#required-software","text":"Foreman (foreman.mn) used for monitoring Slack for communication Firmware updates IP reporting software","title":"Required Software"},{"location":"setup/software/#installation-steps","text":"Download Software: Obtain the latest version of your preferred mining software. Install Software: Follow the installation instructions specific to your operating system. Configure Software: Edit the configuration files to include your mining pool information and other relevant settings. Set Up Foreman: Configure Foreman (foreman.mn) to monitor your mining activity. Set Up Slack: Integrate Slack for team communication and alerts.","title":"Installation Steps"},{"location":"setup/software/#firmware-used","text":"Stock Bitmain firmware Braiins OS LuxOS","title":"Firmware used"},{"location":"setup/software/#luxos-settings","text":"","title":"LuxOS Settings:"},{"location":"setup/software/#note-user-must-enter-values-in-blank-fields","text":"Power: power mode: active autotuner: enabled. Profile tab empty General settings: minimum fan: 4 overtemp: enabled NoPIC: enabled ATM: ATM:ON Hot Board Buffer: 5 min profile -4 steps Max profile: default Startup time: 1 post ramping time: 1 Pool Configuration: No changes made here Firmware: Update Firmware: stable","title":"NOTE: USER MUST ENTER VALUES IN BLANK FIELDS"},{"location":"setup/software/#to-add","text":"Information on firmware settings, tuning, etc","title":"To add:"}]} \ No newline at end of file diff --git a/site/search/worker.js b/site/search/worker.js new file mode 100644 index 0000000..8628dbc --- /dev/null +++ b/site/search/worker.js @@ -0,0 +1,133 @@ +var base_path = 'function' === typeof importScripts ? '.' : '/search/'; +var allowSearch = false; +var index; +var documents = {}; +var lang = ['en']; +var data; + +function getScript(script, callback) { + console.log('Loading script: ' + script); + $.getScript(base_path + script).done(function () { + callback(); + }).fail(function (jqxhr, settings, exception) { + console.log('Error: ' + exception); + }); +} + +function getScriptsInOrder(scripts, callback) { + if (scripts.length === 0) { + callback(); + return; + } + getScript(scripts[0], function() { + getScriptsInOrder(scripts.slice(1), callback); + }); +} + +function loadScripts(urls, callback) { + if( 'function' === typeof importScripts ) { + importScripts.apply(null, urls); + callback(); + } else { + getScriptsInOrder(urls, callback); + } +} + +function onJSONLoaded () { + data = JSON.parse(this.responseText); + var scriptsToLoad = ['lunr.js']; + if (data.config && data.config.lang && data.config.lang.length) { + lang = data.config.lang; + } + if (lang.length > 1 || lang[0] !== "en") { + scriptsToLoad.push('lunr.stemmer.support.js'); + if (lang.length > 1) { + scriptsToLoad.push('lunr.multi.js'); + } + if (lang.includes("ja") || lang.includes("jp")) { + scriptsToLoad.push('tinyseg.js'); + } + for (var i=0; i < lang.length; i++) { + if (lang[i] != 'en') { + scriptsToLoad.push(['lunr', lang[i], 'js'].join('.')); + } + } + } + loadScripts(scriptsToLoad, onScriptsLoaded); +} + +function onScriptsLoaded () { + console.log('All search scripts loaded, building Lunr index...'); + if (data.config && data.config.separator && data.config.separator.length) { + lunr.tokenizer.separator = new RegExp(data.config.separator); + } + + if (data.index) { + index = lunr.Index.load(data.index); + data.docs.forEach(function (doc) { + documents[doc.location] = doc; + }); + console.log('Lunr pre-built index loaded, search ready'); + } else { + index = lunr(function () { + if (lang.length === 1 && lang[0] !== "en" && lunr[lang[0]]) { + this.use(lunr[lang[0]]); + } else if (lang.length > 1) { + this.use(lunr.multiLanguage.apply(null, lang)); // spread operator not supported in all browsers: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_operator#Browser_compatibility + } + this.field('title'); + this.field('text'); + this.ref('location'); + + for (var i=0; i < data.docs.length; i++) { + var doc = data.docs[i]; + this.add(doc); + documents[doc.location] = doc; + } + }); + console.log('Lunr index built, search ready'); + } + allowSearch = true; + postMessage({config: data.config}); + postMessage({allowSearch: allowSearch}); +} + +function init () { + var oReq = new XMLHttpRequest(); + oReq.addEventListener("load", onJSONLoaded); + var index_path = base_path + '/search_index.json'; + if( 'function' === typeof importScripts ){ + index_path = 'search_index.json'; + } + oReq.open("GET", index_path); + oReq.send(); +} + +function search (query) { + if (!allowSearch) { + console.error('Assets for search still loading'); + return; + } + + var resultDocuments = []; + var results = index.search(query); + for (var i=0; i < results.length; i++){ + var result = results[i]; + doc = documents[result.ref]; + doc.summary = doc.text.substring(0, 200); + resultDocuments.push(doc); + } + return resultDocuments; +} + +if( 'function' === typeof importScripts ) { + onmessage = function (e) { + if (e.data.init) { + init(); + } else if (e.data.query) { + postMessage({ results: search(e.data.query) }); + } else { + console.error("Worker - Unrecognized message: " + e); + } + }; +} diff --git a/site/setup/hardware/index.html b/site/setup/hardware/index.html new file mode 100644 index 0000000..d424e73 --- /dev/null +++ b/site/setup/hardware/index.html @@ -0,0 +1,184 @@ + + + + + + + +Information on firmware settings, tuning, etc
+ +