Midnight Code Documentation Saturn Installation and Operations Manual An Instructional Guide and Handbook for v2 (Daphnis) Classified: PUBLIC Project Code: “Saturn” Status: RELEASE Version: 2.0 Issue Date: June 30, 2020 Document Type: CONTROLLED This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License PUBLIC Saturn Installation and Operations Manual Table of Contents 1 How to use this manual ...................................................................................................................... 3 2 About Saturn ....................................................................................................................................... 5 2.1 Objectives of Project Saturn ........................................................................................................... 5 2.1.1 Drivers .................................................................................................................................... 5 2.1.2 Target Infrastructure Features ................................................................................................ 6 2.1.3 Content Use and Test Cases .................................................................................................. 7 2.1.4 Abandoned Objectives ............................................................................................................ 8 2.1.5 Key Limitations ....................................................................................................................... 8 2.2 History of the Project ...................................................................................................................... 9 2.2.1 Pan (2006 – 2019) .................................................................................................................. 9 2.2.2 Daphnis (2019 – ) ................................................................................................................. 15 2.3 With Many Thanks ........................................................................................................................ 19 2.4 About Midnight Code .................................................................................................................... 19 3 Installation ........................................................................................................................................ 20 3.1 Considerations, before you begin ................................................................................................. 20 3.2 Hardware ...................................................................................................................................... 21 3.2.1 Single Board Computer (SBC) ............................................................................................. 21 3.2.2 Enclosure and Thermal Considerations ............................................................................... 22 3.2.3 Power ................................................................................................................................... 23 3.2.4 Boot and Root Storage (Micro SD Card) .............................................................................. 23 3.2.5 Data Storage (Hard Disk Drive) ............................................................................................ 24 3.2.6 Rack Mounting ...................................................................................................................... 25 3.2.7 Final Assembly ..................................................................................................................... 26 3.2.8 Hardware Security Token (Optional) .................................................................................... 29 3.2.9 Bill of Materials and Cost Benchmarks ................................................................................. 30 3.3 Software ....................................................................................................................................... 34 3.3.1 Key Concepts ....................................................................................................................... 34 3.3.2 Activity 1: Image the Boot Media .......................................................................................... 37 3.3.3 Activity 2: Boot and Login ..................................................................................................... 43 3.3.4 Activity 3: Install and Configure the Software ....................................................................... 44 3.3.5 Activity 4: Initialise the Drive ................................................................................................. 78 4 Operation .......................................................................................................................................... 83 4.1 Administratively Accessing Saturn ................................................................................................ 83 4.2 Device Operations & Maintenance ............................................................................................... 85 4.2.1 Encryption and Key Management ........................................................................................ 85 4.2.2 Performance Management ................................................................................................... 88 4.2.3 Thermal Management .......................................................................................................... 92 4.3 Storage Operations & Maintenance ............................................................................................. 95 4.3.1 Storage Tiers and Storage Policy ......................................................................................... 95 4.3.2 Adding / Removing a Disk (Scaling) ..................................................................................... 96 4.4 Booting and Rebooting ................................................................................................................. 98 4.5 Clients ......................................................................................................................................... 101 4.5.1 Installing the Client ............................................................................................................. 101 4.5.2 Mounting the File-system ................................................................................................... 102 4.5.3 Content Management Scripts ............................................................................................. 103 5 Licensing ........................................................................................................................................ 105 5.1 Midnight Code Trademark .......................................................................................................... 105 5.2 The Midnight Code Applications and libMidnightCode Library ................................................... 105 5.3 This Document ........................................................................................................................... 105 Controlled document stored electronically by Midnight Code - Printed copies are uncontrolled Saturn Manual - v2.0 - Daphnis.odt Page 2 of 105 PUBLIC Saturn Installation and Operations Manual 1 How to use this manual This manual is a guide to assist people with the assembly, configuration and operation of a generation two, Midnight Code Saturn storage appliance, known as Daphnis. The manual has been designed so that it can be read from start to finish to build a capability from infrastructure to service, or it can be used as a ready reference to seek out targeted information, by concept. Where to find .. This manual consists of five sections: Chapter 1 – How to use this manual This chapter (the one you're reading now) provides detail on the structure of the manual, how each section should be used and what standard mnemonics have been applied. Chapter 2 – About Saturn Understand Saturn: Learn about what Saturn is, what it is intended to be, how it came about and where it is going. Chapter 2 is a good chapter to read if you just want to know if Saturn is going to fit your storage needs. Chapter 3 – Installation From hardware to software installation, chapter 3 takes you through a build process from the ground up (including pictures), and calls out things that you should consider before building your own. If you already have hardware then treat chapter 3 like a ready-reference for finding the software solution best suited to your build. Chapter 4 – Operation Once you have your Saturn device ready, you need to know how to configure it. Learn how to configure the Saturn device, establish a storage resource and serve it to the network. Then read on to understand what maintenance and diagnostic options are available to you and what common problems can be quickly remediated. Chapter 5 – Licensing All of the licensing information about Saturn has been published in chapter 5. This includes the licensing of the distribution itself, the copyright of the Midnight Code software, and the licensing of the constituent software packages that make up the distribution. You will find concepts in each section are also grouped into subsections that further reflect the relationships of that material. Conventions This manual uses a set of common notations to improve its readability and reference-ability. • Box Information found in a grey box like