============================================================
Anaconda repository requirements and verification (AER 2.29)
============================================================

.. raw:: html

    <p>See also the <a class="reference internal" href="../../../anaconda-enterprise/system-requirements.html"><em>System Requirements</em></a> page for all of Anaconda Enterprise.</p>
    <div class="section" id="hardware-requirements">
    <h2>Hardware requirements<a class="headerlink" href="#hardware-requirements" title="Permalink to this headline">¶</a></h2>
    <ul class="simple">
    <li>Physical server or virtual machine</li>
    <li>CPU: 2 x 64-bit 2 2.8GHz 8.00GT/s CPUs or better. <a class="reference internal" href="#directive-1"><span>Verify architecture</span></a></li>
    <li>Memory: minimum RAM size of 32GB (or 16GB RAM with 1600 MHz DDR3 installed) and minimum of 2 2.8GHz 8.00GT/s CPUs for a typical installation with 50 regular users.  <a class="reference internal" href="#directive-6"><span>Verify memory</span></a></li>
    <li>Storage: Recommended minimum of 100GB, or 300GB if you are planning to mirror both the Anaconda repository (approx. 90GB) and/or the PyPI repository (approx. 100GB), or at least 1TB for an air gapped environment; additional space is recommended if the repository  will be used to store packages built by the customer. <a class="reference internal" href="#directive-2"><span>Verify storage</span></a></li>
    <li>Internet access to download the files from Anaconda Cloud or a USB drive containing all of the files you need with alternate instructions for air gapped installations.</li>
    </ul>
    </div>
    <div class="section" id="software-requirements">
    <h2>Software requirements<a class="headerlink" href="#software-requirements" title="Permalink to this headline">¶</a></h2>
    <ul class="simple">
    <li>Linux environment (installations have been tested on Redhat, CentOS 6.7, and Ubuntu 12.04+). <a class="reference internal" href="#directive-7"><span>Verify Linux version</span></a></li>
    <li>Client environment may be Linux, Windows, or macOS.</li>
    <li>Ubuntu users may need to install cURL. <a class="reference internal" href="#directive-3"><span>Verify cURL access</span></a></li>
    <li>MongoDB version 2.6+ installed as root and running. Versions through 3.4 are supported. <a class="reference internal" href="#directive-4"><span>Verify MongoDB installation</span></a></li>
    <li>bzip2. <a class="reference internal" href="#repo-verify-bzip2"><span>Verify bzip2</span></a></li>
    </ul>
    </div>
    <div class="section" id="security-requirements">
    <h2>Security requirements<a class="headerlink" href="#security-requirements" title="Permalink to this headline">¶</a></h2>
    <ul class="simple">
    <li>Root access or sudo capabilities. <a class="reference internal" href="#directive-5"><span>Verify root access and sudo privileges</span></a></li>
    <li>Ability to make (optional) iptables modifications</li>
    <li>SELinux policy edit privileges. (note that SELinux does not have to be disabled for Anaconda repository operation)</li>
    </ul>
    </div>
    <div class="section" id="network-requirements-tcp-ports">
    <h2>Network requirements (TCP ports)<a class="headerlink" href="#network-requirements-tcp-ports" title="Permalink to this headline">¶</a></h2>
    <ul class="simple">
    <li>Inbound TCP 8080 (Anaconda repository)</li>
    <li>Inbound TCP 22 (SSH)</li>
    <li>Outbound TCP 443 (Anaconda Cloud)</li>
    <li>Outbound TCP 25 (SMTP)</li>
    <li>Outbound TCP 389/636 (LDAP(s))</li>
    <li>Your <a class="reference external" href="https://anaconda.org/">Anaconda.org</a> (Anaconda repository in the cloud) account username, password and installation token provided to you by Continuum at the time of purchase. If you did not receive your token, please contact your sales representative or <cite>Enterprise Support team</cite>.</li>
    </ul>
    </div>
    <div class="section" id="hardware-verification">
    <h2>Hardware verification<a class="headerlink" href="#hardware-verification" title="Permalink to this headline">¶</a></h2>
    <div class="section" id="machine-architecture">
    <span id="directive-1"></span><h3>Machine architecture<a class="headerlink" href="#machine-architecture" title="Permalink to this headline">¶</a></h3>
    <p>Anaconda repository is built to operate only on 64-bit computers. To verify that you have a 64-bit or x86_64 computer, in your terminal window print the machine architecture with this command:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">arch</span>
    </pre></div>
    </div>
    <p>This command prints to the screen whether your system is 32-bit (&#8220;i686&#8221;) or 64-bit (&#8220;x86_64&#8221;).</p>
    </div>
    <div class="section" id="memory-requirements">
    <span id="directive-6"></span><h3>Memory requirements<a class="headerlink" href="#memory-requirements" title="Permalink to this headline">¶</a></h3>
    <p>You need a minimum RAM size of 32GB (or 16GB RAM with 1600 MHz DDR3 istalled).</p>
    <p>On the command line type:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">free</span> <span class="o">-</span><span class="n">m</span>
    </pre></div>
    </div>
    <p>This will return the free memory size in MB.</p>
    </div>
    <div class="section" id="storage-requirements-minimum-hard-drive-or-virtual-environment-size">
    <span id="directive-2"></span><h3>Storage requirements: minimum hard drive or virtual environment size<a class="headerlink" href="#storage-requirements-minimum-hard-drive-or-virtual-environment-size" title="Permalink to this headline">¶</a></h3>
    <p>Check your available disk space with the built-in Linux utility df, with the -h parameter for human readable format:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">df</span> <span class="o">-</span><span class="n">h</span>
    </pre></div>
    </div>
    </div>
    </div>
    <div class="section" id="software-verification">
    <span id="directive-7"></span><h2>Software verification<a class="headerlink" href="#software-verification" title="Permalink to this headline">¶</a></h2>
    <div class="section" id="other-versions-of-the-linux-environment">
    <h3>Other versions of the Linux environment<a class="headerlink" href="#other-versions-of-the-linux-environment" title="Permalink to this headline">¶</a></h3>
    <p>Please <a class="reference external" href="https://github.com/Anaconda-Platform/support/issues">contact us by filing a GitHub issue</a> if you have problems with a version other than Redhat, CentOS, or Ubuntu. Prompts may vary slightly depending on your version.</p>
    </div>
    <div class="section" id="curl-access-for-ubuntu-users">
    <span id="directive-3"></span><h3>cURL access for Ubuntu users<a class="headerlink" href="#curl-access-for-ubuntu-users" title="Permalink to this headline">¶</a></h3>
    <p>RedHat Linux and CentOS have cURL pre-installed, but Ubuntu does not.</p>
    <p>Verify cURL access  in your terminal window:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">curl</span> <span class="o">--</span><span class="n">version</span>
    </pre></div>
    </div>
    <p>If cURL is not found, Ubuntu users can use the Advanced Packaging Tool (APT) to get and install cURL:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>sudo apt-get install curl
    </pre></div>
    </div>
    <p>TIP: If you already have Miniconda or Anaconda installed, in all versions of Linux you can use the conda command:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>conda install curl
    </pre></div>
    </div>
    </div>
    <div class="section" id="mongodb-version-2-4-installed-as-root-and-running">
    <span id="directive-4"></span><h3>MongoDB version 2.4+ installed as root and running<a class="headerlink" href="#mongodb-version-2-4-installed-as-root-and-running" title="Permalink to this headline">¶</a></h3>
    <p>MongoDB version 2.4 or higher is required. Versions through 3.4 are supported. Check for existence of MongoDB and its version number:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">mongod</span> <span class="o">--</span><span class="n">version</span>
    </pre></div>
    </div>
    <p>If you get a &#8220;not found&#8221; message or if the MongoDB version is 2.3 or earlier, then install MongoDB 2.4 or higher using the <a class="reference external" href="http://docs.mongodb.org/manual/administration/install-on-linux/">official installation instructions</a>. Remember to install as root with the sudo command.</p>
    <p>MongoDB must always be running before Anaconda repository can be started. Start MongoDB:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>sudo service mongod start
    </pre></div>
    </div>
    <p>Verify that MongoDB is running:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>mongo --eval &#39;db.serverStatus().ok&#39;
    </pre></div>
    </div>
    </div>
    <div class="section" id="bzip2-is-installed">
    <span id="repo-verify-bzip2"></span><h3>bzip2 is installed<a class="headerlink" href="#bzip2-is-installed" title="Permalink to this headline">¶</a></h3>
    <p>Check for existence of bzip2 and its version number:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">bzip2</span> <span class="o">--</span><span class="n">version</span>
    </pre></div>
    </div>
    </div>
    </div>
    <div class="section" id="security-verification">
    <span id="directive-5"></span><h2>Security verification<a class="headerlink" href="#security-verification" title="Permalink to this headline">¶</a></h2>
    <div class="section" id="root-access-and-sudo-privileges">
    <h3>Root access and sudo privileges<a class="headerlink" href="#root-access-and-sudo-privileges" title="Permalink to this headline">¶</a></h3>
    <p>The Anaconda repository installation process cannot be completed without root access. Test to verify that you have sudo privileges:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="o">-</span><span class="n">v</span>
    </pre></div>
    </div>
    <p>Enter your root password when prompted and click ENTER.</p>
    <p>If you receive a message like the following, contact your system administrator for root access:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>Sorry, user [username] may not run sudo on [hostname].
    </pre></div>
    </div>
    </div>
    </div>
    <div class="section" id="did-you-find-what-you-needed-on-this-page">
    <h2>Did you find what you needed on this page?<a class="headerlink" href="#did-you-find-what-you-needed-on-this-page" title="Permalink to this headline">¶</a></h2>
    <p>Please <a class="reference external" href="https://github.com/Anaconda-Platform/support/issues">let us know</a>.</p>
    </div>
