Skip to content

Latest commit

 

History

History
 
 

installation-and-configuration


<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  <title>Nauta Installation, Configuration, and Administration Guide &mdash; Nauta 1.1 documentation</title>
  

  
  
  
  

  
  <script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
  
    
      <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
        <script type="text/javascript" src="../_static/jquery.js"></script>
        <script type="text/javascript" src="../_static/underscore.js"></script>
        <script type="text/javascript" src="../_static/doctools.js"></script>
        <script type="text/javascript" src="../_static/language_data.js"></script>
    
    <script type="text/javascript" src="../_static/js/theme.js"></script>

    

  
  <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
  <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="prev" title="Product Overview" href="../user-guide/README.html" /> 
</head>

<body class="wy-body-for-nav">

   
  <div class="wy-grid-for-nav">
    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search" >
          

          
            <a href="../index.html" class="icon icon-home"> Nauta
          

          
          </a>

          
            
            
          

          
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>

          
        </div>

        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
            
              
            
            
              <p class="caption"><span class="caption-text">Contents:</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../user-guide/README.html">Product Overview</a></li>
<li class="toctree-l1"><a class="reference internal" href="../user-guide/README.html#nauta-user-guide">Nauta User Guide</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Nauta Installation, Configuration, and Administration Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="#nauta-hardware-requirement-overview">Nauta Hardware Requirement Overview</a></li>
<li class="toctree-l1"><a class="reference internal" href="#nauta-installation-procedures">Nauta Installation Procedures</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#removing-nauta">Removing Nauta</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="#installation-details">Installation details</a></li>
</ul>

            
          
        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" aria-label="top navigation">
        
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../index.html">Nauta</a>
        
      </nav>


      <div class="wy-nav-content">
        
        <div class="rst-content">
        
          















<div role="navigation" aria-label="breadcrumbs navigation">

  <ul class="wy-breadcrumbs">
    
      <li><a href="../index.html">Docs</a> &raquo;</li>
        
      <li>Nauta Installation, Configuration, and Administration Guide</li>
    
    
      <li class="wy-breadcrumbs-aside">
        
            
            <a href="../_sources/installation-and-configuration/README.md.txt" rel="nofollow"> View page source</a>
          
        
      </li>
    
  </ul>

  
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <div class="section" id="nauta-installation-configuration-and-administration-guide">
<h1>Nauta Installation, Configuration, and Administration Guide<a class="headerlink" href="#nauta-installation-configuration-and-administration-guide" title="Permalink to this headline">¶</a></h1>
<p>This Nauta Installation, Configuration, and Administration guide provides step-by-step instructions for installing,   configuring, upgrading, and removing Nauta. This guide also provides an overview of Nauta requirements, configuration options, and administration tasks.</p>
<p>This section discusses the following main topics:</p>
<ul class="simple">
<li><p><a class="reference external" href="#nauta-hardware-requirement-overview">Nauta Hardware Requirement Overview</a>: Provides an overview of Nauta Hardware requirements.</p></li>
<li><p><a class="reference external" href="#nauta-installation-procedures">Nauta Installation Procedures</a>: Provides the Installation Instructions.</p></li>
<li><p><a class="reference external" href="#document-flow">Document Flow</a>: This is your gateway to the Nauta installation documentation instructions; start here.</p></li>
</ul>
<p><strong>Note:</strong> For instructions on configuring the Nauta client, refer to the <a class="reference external" href="../user-guide/">Nauta User Guide</a>.</p>
<p>Nauta is a software suite that provides a multi-user, distributed computing environment for running deep learning model training experiments. Results of experiments can be viewed and monitored using a Command Line Interface (CLI), Web UI and/or TensorBoard. You can use existing data sets, your own data, or downloaded data from online sources, as well as create public or private folders to make collaboration among teams easier.</p>
<p>Nauta runs on Kubernetes and Docker for scalability and ease of management. Nauta uses customizable templates to remove the complexities of creating and running single and multi-node deep learning training experiments without all the system’s complexity and scripting needed with standard container environments.</p>
</div>
<div class="section" id="nauta-hardware-requirement-overview">
<h1>Nauta Hardware Requirement Overview<a class="headerlink" href="#nauta-hardware-requirement-overview" title="Permalink to this headline">¶</a></h1>
<p>Nauta is intended to run on a multi-server Kubernetes cluster. To run Nauta, you will need at least one Master node, and one or more Worker nodes. Nauta is a platform for performing Deep Learning training, and requires robust hardware specifications to run with optimal performance.</p>
</div>
<div class="section" id="nauta-installation-procedures">
<h1>Nauta Installation Procedures<a class="headerlink" href="#nauta-installation-procedures" title="Permalink to this headline">¶</a></h1>
<p>To install Nauta in a ‘bare metal’ (for example, non-cloud) server environment, you will need to:</p>
<ol class="simple">
<li><p>Execute the following commands from the command line:</p></li>
</ol>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">clone</span> <span class="pre">--recursive</span> <span class="pre">https://github.com/IntelAI/nauta.git</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">cd</span> <span class="pre">nauta</span></code></p></li>
</ul>
<ol class="simple">
<li><p>Build the base package (a makefile will automate the bulk of the process, but there are some minimum packages needed for Nauta).</p></li>
</ol>
<ul class="simple">
<li><p><strong>Note:</strong> To see the list of installed components and their versions, refer to: <a class="reference internal" href="System_Software_Components_Requisites/SSCR.html"><span class="doc">List of Software Components</span></a> and for Package information, refer to: <a class="reference internal" href="Installation_Package_Requirements/IPR.html"><span class="doc">Installation Package Requirements</span></a>.</p></li>
</ul>
<ol class="simple">
<li><p>Populate or create Nauta’s inventory file to define where your master and worker nodes are, and how to access them. To create the Inventory file:</p>
<ul class="simple">
<li><p>Copy the Inventory file example information: <a class="reference internal" href="Inventory_Tasks/IT.html"><span class="doc">Inventory File Information</span></a>.</p></li>
<li><p>Modify the newly created Inventory file to suit your needs.</p></li>
</ul>
</li>
<li><p>Modify Nauta’s configuration file to define your proxy, network quirks and filesystem preferences. To create the configuration file:</p>
<ul class="simple">
<li><p>Copy the Configuration file example infomation: <a class="reference internal" href="Configuration_Tasks_Variables/CTV.html"><span class="doc">Configuration File Information</span></a>.</p></li>
<li><p>Modify the newly created Configuration file to suit your needs.</p></li>
</ul>
</li>
<li><p>Run the installation script (see <a class="reference internal" href="Installation_Process/IP.html"><span class="doc">Installation Process</span></a> for more information).</p></li>
</ol>
<p>This process does the following:</p>
<ul class="simple">
<li><p>Creates a Kubernetes cluster, all the Docker files you need to run Tensorflow, Jupyter, Tensorboard, and Horovod.</p></li>
<li><p>Installs the Nauta server-side application on your new Kubernetes cluster, and starts the system running.</p></li>
</ul>
<p>Completing all of the above takes some time. We are working on streamlining the process.</p>
<div class="section" id="removing-nauta">
<h2>Removing Nauta<a class="headerlink" href="#removing-nauta" title="Permalink to this headline">¶</a></h2>
<p>Should you ever need to delete/remove Nauta, refer to: <a class="reference external" href="../Installation_Process/IP">Installation Process</a> page for more details.</p>
</div>
</div>
<div class="section" id="installation-details">
<h1>Installation details<a class="headerlink" href="#installation-details" title="Permalink to this headline">¶</a></h1>
<p>This guide consists of the following main topics, in order. Start here to move through the correct sequence of events.</p>
<ul class="simple">
<li><p><a class="reference internal" href="System_Software_Components_Requisites/SSCR.html"><span class="doc">System Software Components Requisites</span></a></p></li>
<li><p><a class="reference internal" href="How_to_Build_Nauta/HBN.html"><span class="doc">Building Nauta</span></a></p>
<ul>
<li><p><a class="reference internal" href="Installer_System_Requirements/ISR.html"><span class="doc">Installer System Requirements</span></a></p></li>
<li><p><a class="reference internal" href="Target_Host_Requirements/THR.html"><span class="doc">Target Host Requirements</span></a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="Inventory_Tasks/IT.html"><span class="doc">Inventory Configuration</span></a></p></li>
<li><p><a class="reference internal" href="Configuration_Tasks_Variables/CTV.html"><span class="doc">Nauta Configuration (Variables)</span></a></p>
<ul>
<li><p><a class="reference internal" href="Installation_Package_Requirements/IPR.html"><span class="doc">Installation Package Requirements</span></a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="Installation_Process/IP.html"><span class="doc">Installating and Starting Nauta</span></a></p></li>
<li><p><a class="reference internal" href="User_Management/UM.html"><span class="doc">User Management</span></a></p></li>
<li><p><a class="reference internal" href="Troubleshooting/T.html"><span class="doc">Troubleshooting</span></a></p></li>
</ul>
<p>Terms and Conditions</p>
<p>To read Intel Terms and Conditions check <a class="reference internal" href="TaC.html"><span class="doc">this</span></a> document.</p>
<p>This user guide is subject to <a class="reference external" href="https://creativecommons.org/licenses/by-nd/4.0/">CC-BY-ND 4.0</a>.</p>
</div>


           </div>
           
          </div>
          <footer>
  
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
      
      
        <a href="../user-guide/README.html" class="btn btn-neutral float-left" title="Product Overview" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
      
    </div>
  

  <hr/>

  <div role="contentinfo">
    <p>
        &copy; Copyright 2019, Intel Corporation

    </p>
  </div>
  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 

</footer>

        </div>
      </div>

    </section>

  </div>
  


  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script>

  
  
    
   

</body>
</html>