Install AEN Gateway (AEN 4.1.2)
===============================

.. raw:: html

    <p>The <em>Gateway</em> is a reverse proxy server that authenticates users and
    automatically directs them to the proper AEN Compute Node for
    their project. Users will not notice the Gateway as it
    automatically routes them.</p>
    <p>These procedures assume that you have already performed the <a class="reference internal" href="install-prep.html"><span class="doc">Installation preparation</span></a>
    and <a class="reference internal" href="install-server.html"><span class="doc">Install AEN Server</span></a> procedures.</p>
    <div class="section" id="set-variables-and-change-permissions">
    <h2>Set variables and change permissions<a class="headerlink" href="#set-variables-and-change-permissions" title="Permalink to this headline">¶</a></h2>
    <p>In the script below, change <code class="docutils literal"><span class="pre">&lt;FQDN</span> <span class="pre">HOSTNAME</span> <span class="pre">OR</span> <span class="pre">IP</span> <span class="pre">ADDRESS&gt;</span></code> to the actual
    fully qualified domain hostname or IP address.</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">export</span> <span class="n">AEN_SERVER</span><span class="o">=&lt;</span><span class="n">FQDN</span> <span class="n">HOSTNAME</span> <span class="n">OR</span> <span class="n">IP</span> <span class="n">ADDRESS</span><span class="o">&gt;</span> <span class="c1"># Use the real FQDN</span>
    <span class="n">export</span> <span class="n">AEN_GATEWAY_PORT</span><span class="o">=</span><span class="mi">8089</span>
    <span class="n">export</span> <span class="n">AEN_GATEWAY</span><span class="o">=&lt;</span><span class="n">FQDN</span> <span class="n">HOSTNAME</span> <span class="n">OR</span> <span class="n">IP</span> <span class="n">ADDRESS</span><span class="o">&gt;</span> <span class="c1"># will be needed shortly</span>
    <span class="n">chmod</span> <span class="n">a</span><span class="o">+</span><span class="n">x</span> <span class="n">aen</span><span class="o">-*.</span><span class="n">sh</span>                <span class="c1"># Set installer to be executable</span>
    </pre></div>
    </div>
    <p>NOTE: You must perform the entire procedure before closing the terminal
    to ensure the variable export persists. If the terminal is closed before
    successful installation, export the variables to continue with the installation.</p>
    </div>
    <div class="section" id="run-gateway-installer">
    <h2>Run Gateway installer<a class="headerlink" href="#run-gateway-installer" title="Permalink to this headline">¶</a></h2>
    <div class="highlight-default"><div class="highlight"><pre><span></span>sudo -E ./aen-gateway-4.1.2-Linux-x86_64.sh -w $AEN_SERVER
    &lt;license text&gt;
    ...
    ...

    PREFIX=/opt/wakari/wakari-gateway
    Logging to /tmp/wakari_gateway.log
    ...
    ...
    Checking server name
    Please restart the Gateway after running the following command
    to connect this Gateway to the AEN Server
    ...
    </pre></div>
    </div>
    </div>
    <div class="section" id="register-the-aen-gateway">
    <h2>Register the AEN Gateway<a class="headerlink" href="#register-the-aen-gateway" title="Permalink to this headline">¶</a></h2>
    <p>The AEN Gateway needs to register with the AEN Server. This needs
    to be authenticated, so the <code class="docutils literal"><span class="pre">AEN_SRVC_ACCT</span></code> user&#8217;s credentials created during the
    AEN Server install need to be used. <strong>This needs to be run as sudo or root</strong>
    to write the configuration file:
    <code class="docutils literal"><span class="pre">/opt/wakari/wakari-gateway/etc/wakari/wk-gateway-config.json</span></code></p>
    <div class="highlight-default"><div class="highlight"><pre><span></span>sudo /opt/wakari/wakari-gateway/bin/wk-gateway-configure \
    --server http://$AEN_SERVER --host $AEN_GATEWAY \
    --port $AEN_GATEWAY_PORT --name Gateway --protocol http \
    --summary Gateway --username $AEN_SRVC_ACCT \
    --password &#39;&lt;NFI USER PASSWORD&gt;&#39;
    </pre></div>
    </div>
    <p>Note: replace <code class="docutils literal"><span class="pre">&lt;NFI</span> <span class="pre">USER</span> <span class="pre">PASSWORD&gt;</span></code> with the password of the NFI user that was generated during server installation above.</p>
    <div class="section" id="ensure-proper-permissions">
    <h3>Ensure proper permissions<a class="headerlink" href="#ensure-proper-permissions" title="Permalink to this headline">¶</a></h3>
    <div class="highlight-default"><div class="highlight"><pre><span></span>sudo chown $AEN_SRVC_ACCT /opt/wakari/wakari-gateway/etc/wakari/wk-gateway-config.json
    </pre></div>
    </div>
    </div>
    <div class="section" id="start-the-gateway">
    <h3>Start the Gateway<a class="headerlink" href="#start-the-gateway" title="Permalink to this headline">¶</a></h3>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">service</span> <span class="n">wakari</span><span class="o">-</span><span class="n">gateway</span> <span class="n">start</span>
    </pre></div>
    </div>
    </div>
    <div class="section" id="verify-the-aen-gateway-registration">
    <h3>Verify the AEN Gateway registration<a class="headerlink" href="#verify-the-aen-gateway-registration" title="Permalink to this headline">¶</a></h3>
    <ol class="arabic">
    <li><p class="first">Login to the AEN Server using Chrome or Firefox browser using the
    <code class="docutils literal"><span class="pre">AEN_SRVC_ACCT</span></code> user.</p>
    </li>
    <li><p class="first">Click the Admin link in the toolbar</p>
    <a class="reference internal image-reference" href="../../../_images/ae-notebooks/4.1.2/install/admin-menu.png"><img alt="../../../_images/ae-notebooks/4.1.2/install/admin-menu.png" src="../../../_images/ae-notebooks/4.1.2/install/admin-menu.png" style="width: 279.2px; height: 143.2px;" /></a>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    </li>
    <li><p class="first">Click the Data Centers subsection, then click your Data Center:</p>
    <a class="reference internal image-reference" href="../../../_images/ae-notebooks/4.1.2/install/datacenter-leftnav.png"><img alt="../../../_images/ae-notebooks/4.1.2/install/datacenter-leftnav.png" src="../../../_images/ae-notebooks/4.1.2/install/datacenter-leftnav.png" style="width: 682.4px; height: 423.2px;" /></a>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    </li>
    <li><p class="first">Verify that your Data Center is registered and status is
    <code class="docutils literal"><span class="pre">{&quot;status&quot;:</span> <span class="pre">&quot;ok&quot;,</span> <span class="pre">&quot;messages&quot;:</span> <span class="pre">[]}</span></code></p>
    <a class="reference internal image-reference" href="../../../_images/ae-notebooks/4.1.2/install/datacenter.png"><img alt="../../../_images/ae-notebooks/4.1.2/install/datacenter.png" src="../../../_images/ae-notebooks/4.1.2/install/datacenter.png" style="width: 1048.8px; height: 496.8px;" /></a>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    </li>
    </ol>
    </div>
    </div>
    <div class="section" id="next-steps">
    <h2>Next steps<a class="headerlink" href="#next-steps" title="Permalink to this headline">¶</a></h2>
    <p>See the next step needed for full AEN install below:</p>
    <ul class="simple">
    <li><a class="reference internal" href="install-compute.html"><span class="doc">Install AEN Compute</span></a></li>
    </ul>
    <p>The following optional install procedures may need to be performed,
    depending on how you set up your data center:</p>
    <ul class="simple">
    <li><a class="reference internal" href="option-config.html"><span class="doc">Optional configuration</span></a></li>
    <li><a class="reference internal" href="customization.html"><span class="doc">Sudo configuration</span></a></li>
    <li><a class="reference internal" href="ldap.html"><span class="doc">LDAP configuration</span></a></li>
    <li><a class="reference internal" href="ssl.html"><span class="doc">SSL</span></a></li>
    <li><a class="reference internal" href="sso.html"><span class="doc">Single sign on</span></a></li>
    </ul>
    <p>Additional post-install information:</p>
    <ul class="simple">
    <li><a class="reference internal" href="installation_update.html"><span class="doc">Upgrading Anaconda Enterprise Notebooks</span></a></li>
    <li><a class="reference internal" href="uninstall.html"><span class="doc">Uninstall</span></a></li>
    <li><a class="reference internal" href="release.html"><span class="doc">Release notes</span></a></li>
    </ul>
    </div>
