From 30eeda328e38374ca6ba04eb24ece806d197de66 Mon Sep 17 00:00:00 2001 From: Thomas Schoebel-Theuer Date: Sun, 3 Oct 2021 20:57:32 +0200 Subject: [PATCH] doc: retitle architecture guide --- docu/architecture-guide-introduction.lyx | 177 +++++++++++ docu/mars-architecture-guide.lyx | 379 ++++++++++++++++++++++- 2 files changed, 548 insertions(+), 8 deletions(-) create mode 100644 docu/architecture-guide-introduction.lyx diff --git a/docu/architecture-guide-introduction.lyx b/docu/architecture-guide-introduction.lyx new file mode 100644 index 00000000..ac973dfb --- /dev/null +++ b/docu/architecture-guide-introduction.lyx @@ -0,0 +1,177 @@ +#LyX 2.3 created this file. For more info see http://www.lyx.org/ +\lyxformat 544 +\begin_document +\begin_header +\save_transient_properties true +\origin unavailable +\textclass scrreprt +\begin_preamble +\usepackage{listings} +\end_preamble +\options abstracton,dvipsnames +\use_default_options true +\begin_modules +customHeadersFooters +enumitem +fixltx2e +\end_modules +\maintain_unincluded_children false +\language english +\language_package default +\inputencoding auto +\fontencoding global +\font_roman "default" "default" +\font_sans "default" "default" +\font_typewriter "default" "default" +\font_math "auto" "auto" +\font_default_family rmdefault +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 100 +\font_tt_scale 100 100 +\use_microtype false +\use_dash_ligatures false +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize 10 +\spacing single +\use_hyperref true +\pdf_title "MARS Manual" +\pdf_author "Thomas Schöbel-Theuer" +\pdf_bookmarks true +\pdf_bookmarksnumbered false +\pdf_bookmarksopen false +\pdf_bookmarksopenlevel 1 +\pdf_breaklinks true +\pdf_pdfborder true +\pdf_colorlinks true +\pdf_backref false +\pdf_pdfusetitle true +\papersize a4paper +\use_geometry true +\use_package amsmath 1 +\use_package amssymb 1 +\use_package cancel 1 +\use_package esint 1 +\use_package mathdots 1 +\use_package mathtools 1 +\use_package mhchem 1 +\use_package stackrel 1 +\use_package stmaryrd 1 +\use_package undertilde 1 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 1 +\use_minted 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\leftmargin 3.7cm +\topmargin 2.7cm +\rightmargin 2.8cm +\bottommargin 2.3cm +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\is_math_indent 0 +\math_numbering_side default +\quotes_style english +\dynamic_quotes 0 +\papercolumns 1 +\papersides 2 +\paperpagestyle headings +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Standard +This guide explains how to select the right +\emph on +storage architecture +\emph default + for typical use cases in big enterprises. + Besides general storage architectures, solutions and pitfalls of +\series bold +geo-redundancy +\series default + / +\series bold +long-distance replication +\series default + are highlighted. +\end_layout + +\begin_layout Standard + +\series bold +Cost and risk +\series default + are treated as well, addressing some +\series bold +management needs +\series default + up to CTO level. +\end_layout + +\begin_layout Standard +Part II explains the architectural goals and methods behind the Linux-based + OpenSource solution MARS. +\end_layout + +\begin_layout Standard +MARS is a key component for achieving +\series bold +geo-redundancy +\series default + under Linux, for example Disaster Recovery (DR) at datacenter granularity, + and/or Location Transparency (LT) at VM / LV granularity. +\end_layout + +\begin_layout Standard +It can help to increase +\series bold +reliability +\series default + via Sharding, and to +\series bold +save cost +\series default + by optional support for local storage in addition to network storage. +\end_layout + +\begin_layout Standard +It eases +\series bold +load balancing +\series default + and +\series bold +background migration of data +\series default +, even over long distances. +\end_layout + +\begin_layout Standard +MARS is in enterprise-critial production since 2014, and on thousands of + Linux servers replicating petabytes of data. +\end_layout + +\end_body +\end_document diff --git a/docu/mars-architecture-guide.lyx b/docu/mars-architecture-guide.lyx index b5904f52..dce124b7 100644 --- a/docu/mars-architecture-guide.lyx +++ b/docu/mars-architecture-guide.lyx @@ -102,7 +102,289 @@ tcolorbox \begin_body -\begin_layout Standard +\begin_layout Title +Architecture Guide for Geo-Redundancy +\end_layout + +\begin_layout Subtitle +Multiversion Asynchronous Replicated Storage +\begin_inset Newline newline +\end_inset + + +\begin_inset space ~ +\end_inset + + +\begin_inset Newline newline +\end_inset + + +\begin_inset Graphics + filename images/earth-mars-transfer.fig + width 70col% + +\end_inset + + +\end_layout + +\begin_layout Author +Thomas Schöbel-Theuer ( +\family typewriter +tst@1und1.de +\family default +) +\end_layout + +\begin_layout Date +Version 0.1a-132 +\end_layout + +\begin_layout Lowertitleback +\noindent +Copyright (C) 2013-16 Thomas Schöbel-Theuer +\begin_inset Newline newline +\end_inset + +Copyright (C) 2013-16 1&1 Internet AG (see +\begin_inset Flex URL +status open + +\begin_layout Plain Layout + +http://www.1und1.de +\end_layout + +\end_inset + + shortly called 1&1 in the following). +\begin_inset Newline newline +\end_inset + + +\size footnotesize +Permission is granted to copy, distribute and/or modify this document under + the terms of the GNU Free Documentation License, Version 1.3 or any later + version published by the Free Software Foundation; with no Invariant Sections, + no Front-Cover Texts, and no Back-Cover Texts. + A copy of the license is included in the section entitled +\begin_inset Quotes eld +\end_inset + + +\begin_inset CommandInset ref +LatexCommand nameref +reference "chap:GNU-FDL" + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\begin_layout New Color Box Type + +\begin_inset Argument 2 +status open + +\begin_layout Plain Layout + +cBoxA +\end_layout + +\end_inset + + +\begin_inset Argument 3 +status open + +\begin_layout Plain Layout + +1 +\end_layout + +\end_inset + + +\begin_inset Argument 4 +status open + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Argument 1 +status open + +\begin_layout Plain Layout + +auto counter, number within=chapter +\end_layout + +\end_inset + +enhanced,breakable,colback=green!5!white,title=Example~ +\backslash +thetcbcounter : #1 +\end_layout + +\begin_layout New Color Box Type + +\begin_inset Argument 2 +status open + +\begin_layout Plain Layout + +cBoxB +\end_layout + +\end_inset + + +\begin_inset Argument 3 +status open + +\begin_layout Plain Layout + +1 +\end_layout + +\end_inset + + +\begin_inset Argument 4 +status open + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Argument 1 +status open + +\begin_layout Plain Layout + +auto counter, number within=chapter +\end_layout + +\end_inset + +enhanced,breakable,title=Details~ +\backslash +thetcbcounter : #1 +\end_layout + +\begin_layout New Color Box Type + +\begin_inset Argument 2 +status open + +\begin_layout Plain Layout + +cBoxC +\end_layout + +\end_inset + + +\begin_inset Argument 3 +status open + +\begin_layout Plain Layout + +1 +\end_layout + +\end_inset + + +\begin_inset Argument 4 +status open + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Argument 1 +status open + +\begin_layout Plain Layout + +auto counter, number within=chapter +\end_layout + +\end_inset + +enhanced,breakable,colback=yellow!25!white,title=Manager~Hint~ +\backslash +thetcbcounter : #1 +\end_layout + +\begin_layout New Color Box Type + +\begin_inset Argument 2 +status open + +\begin_layout Plain Layout + +cBoxD +\end_layout + +\end_inset + + +\begin_inset Argument 3 +status open + +\begin_layout Plain Layout + +1 +\end_layout + +\end_inset + + +\begin_inset Argument 4 +status open + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Argument 1 +status open + +\begin_layout Plain Layout + +auto counter, number within=chapter +\end_layout + +\end_inset + +enhanced,breakable,colback=blue!5!white,title=Hint~for~research~ +\backslash +thetcbcounter : #1 +\end_layout + +\begin_layout Abstract + +\family typewriter \begin_inset ERT status open @@ -110,7 +392,69 @@ status open \backslash -title{MARS Architecture Guide} +sloppy +\end_layout + +\end_inset + + +\family default + +\begin_inset CommandInset include +LatexCommand input +preview true +filename "architecture-guide-introduction.lyx" + +\end_inset + + +\end_layout + +\begin_layout Abstract +\paragraph_spacing double +\noindent +\begin_inset space ~ +\end_inset + + +\begin_inset Newline newline +\end_inset + + +\begin_inset space ~ +\end_inset + + +\begin_inset Newline newline +\end_inset + + +\begin_inset Box Frameless +position "c" +hor_pos "c" +has_inner_box 1 +inner_pos "c" +use_parbox 0 +use_makebox 1 +width "100col%" +special "none" +height "1in" +height_special "totalheight" +thickness "0.4pt" +separation "3pt" +shadowsize "4pt" +framecolor "black" +backgroundcolor "none" +status open + +\begin_layout Plain Layout +\begin_inset Graphics + filename images/earth-mars-transfer.fig + width 70col% + +\end_inset + + \end_layout \end_inset @@ -119,14 +463,33 @@ title{MARS Architecture Guide} \end_layout \begin_layout Standard -\begin_inset CommandInset include -LatexCommand input -preview true -filename "common-front-matter.lyx" +\noindent +Many thanks for constructive feedback which helped to improve this document + series and related material like presentation slides: +\end_layout -\end_inset +\begin_layout Itemize +Philipp Reisner from Linbit +\end_layout +\begin_layout Itemize +Ewen NcNeill and Simon Lyall from the Australian / New Zealand Linux community +\end_layout +\begin_layout Itemize +Jens Clever and Jörg Mann, external freelancers working at 1&1 +\end_layout + +\begin_layout Itemize +Anders Henke and Christian Albert and Kai Müller from 1&1 Ionos +\end_layout + +\begin_layout Itemize +Olof Sandström-Herrera from Arsys +\end_layout + +\begin_layout Standard +Please report any omissions in case I forgot somebody. \end_layout \begin_layout Chapter* @@ -141,7 +504,7 @@ Introduction \begin_inset CommandInset include LatexCommand input preview true -filename "common-introduction.lyx" +filename "architecture-guide-introduction.lyx" \end_inset