====!!! UNDER CONSTRUCTION AND UPDATING CONTENT !!!====

**Welcome to the Limulus Systems Manual**

[[https://www.limulus-computing.com|Limulus Cluster Computing systems]] are available in either four- or eight-node desk-side cases or in a 4-node rack-mount unit. Multiple systems can be connected together to work as a larger cluster. There are two software stacks available: High Performance Computing (HPC) or scalable data analytics (Hadoop, Spark, Kafka, etc.).

=====Important:=====

   - Certain portions of this manual are **restricted** to Limulus Computing Support Customers. Contact [[ https://www.limulus-computing.com/contact/uncategorised/basement-supercomputing| Limulus Computing]] for further information or to purchase a support contract.
  - Unless otherwise noted, all content, diagrams, images, etc. are available under the [[https://creativecommons.org/licenses/by-nc-sa/4.0/deed.en|Creative Commons Attribution-Noncommercial-Share Alike 4.0 International]] license. This license offers the maximum amount of "informational freedom" and restricts any commercial use of this content (or any derivative thereof). 

The following guide will aid in navigating and maintaining Limulus Computing cluster appliances. The content is constantly updated to address new hardware, software, and user needs.  
 
=====First Steps=====
  * [[Unpacking and Startup]]
  * [[Essential Quick Start (HPC Systems)]]
  * [[Essential Quick Start (Data Analytics Systems)]]
  * [[Getting Help]]

=====User Guide=====
  * [[Logging In]]
  * [[User Software]]
===HPC Systems===
  * [[Using Software Modules]]
  * [[Submitting Jobs to the Slurm Workload Manager]]
  * [[Running Interactive Jobs on the Cluster Nodes]]
  * [[Compiling and Running an MPI Application]]
===Data Analytics Systems===
  * [[Running Hive and Spark from the Command line]]
  * [[Using the Zeppelin Web Notebook]]
 


===== Administrator Guide =====

  * [[Becoming the Administrative User]]
  * [[Adding Users]]
  * [[Powering Up/Down Nodes]]
  * [[Adaptive Cooling]]
  * [[Monitoring System Resources]] 
  * [[RAID Storage Management]]
  * [[Setting Node Governors/Turbo Mode]]
  * [[System-wide Administration Commands (pdsh)]]
  * [[Software Management]]
  * [[Firewall Configuration]]
===HPC Systems===
  * [[Open HPC Components]]
  * [[HPC Logs and Log Management]]
  * [[Slurm Workload Manager]]
  * [[Warewulf Worker Node Images]]
===Data Analytics Systems===
  * [[Using the Apache Ambari Cluster Manager]]
  * [[HDFS Management]]
  * [[Apache Logs and Log Management]]

===== System Operation Guide =====
  * [[Limulus Design Philosophy]]
  * [[Functional Diagram]]
  * [[Desk-side Case]]
  * [[Rack-mount Case]]
  * [[Limulus Compute Blades]]
  * [[Node Power Control]]
  * [[Internal Networks]]
  * [[Fan Control]]
  * [[Limulus Services]]
  * [[Hadoop HDFS Drive Assignments]]

===== Frequently Asked Questions =====
  * [[General Questions]]
  * [[User Questions and Procedures]]
  * [[Administrative Questions and Procedures]]
  * [[ Sandbox ]]