Installing the AEN gateway (AEN 4.2.1)
======================================

.. raw:: html

    <div class="contents local topic" id="contents">
    <ul class="simple">
    <li><a class="reference internal" href="#setting-variables-and-changing-permissions" id="id1">Setting variables and changing permissions</a></li>
    <li><a class="reference internal" href="#running-the-aen-gateway-installer" id="id2">Running the AEN gateway installer</a></li>
    <li><a class="reference internal" href="#registering-your-gateway" id="id3">Registering your gateway</a></li>
    <li><a class="reference internal" href="#what-s-next" id="id4">What&#8217;s next</a></li>
    </ul>
    </div>
    <p>The gateway is a reverse proxy that authenticates users and automatically
    directs them to the proper AEN compute node for their project. Users will not
    notice this node as it automatically routes them.</p>
    <p>Gateway is installed in the <code class="docutils literal"><span class="pre">/opt/wakari/wakari-gateway</span></code> directory.</p>
    <div class="section" id="setting-variables-and-changing-permissions">
    <h2><a class="toc-backref" href="#id1">Setting variables and changing permissions</a><a class="headerlink" href="#setting-variables-and-changing-permissions" title="Permalink to this headline">¶</a></h2>
    <p>Run:</p>
    <div class="highlight-bash"><div class="highlight"><pre><span></span><span class="nb">export</span> <span class="nv">AEN_SERVER</span><span class="o">=</span>&lt;FQDN HOSTNAME OR IP ADDRESS&gt; <span class="c1"># Use the real FQDN</span>
    <span class="nb">export</span> <span class="nv">AEN_GATEWAY_PORT</span><span class="o">=</span><span class="m">8089</span>
    <span class="nb">export</span> <span class="nv">AEN_GATEWAY</span><span class="o">=</span>&lt;FQDN HOSTNAME OR IP ADDRESS&gt;  <span class="c1"># will be needed shortly</span>
    chmod a+x aen-*.sh                <span class="c1"># Set installer to be executable</span>
    </pre></div>
    </div>
    <p>NOTE: Change &lt;FQDN HOSTNAME OR IP ADDRESS&gt; to the actual fully qualified domain
    hostname or IP address.</p>
    <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="running-the-aen-gateway-installer">
    <h2><a class="toc-backref" href="#id2">Running the AEN gateway installer</a><a class="headerlink" href="#running-the-aen-gateway-installer" title="Permalink to this headline">¶</a></h2>
    <p>Run:</p>
    <div class="highlight-bash"><div class="highlight"><pre><span></span>sudo -E ./aen-gateway-4.2.1-Linux-x86_64.sh -w <span class="nv">$AEN_SERVER</span>
    &lt;license text&gt;
    ...
    ...

    <span class="nv">PREFIX</span><span class="o">=</span>/opt/wakari/wakari-gateway
    Logging to /tmp/wakari_gateway.log
    ...
    ...
    Checking server name
    Please restart the Gateway after running the following <span class="nb">command</span>
    to connect this Gateway to the AEN Server
    ...
    </pre></div>
    </div>
    </div>
    <div class="section" id="registering-your-gateway">
    <h2><a class="toc-backref" href="#id3">Registering your gateway</a><a class="headerlink" href="#registering-your-gateway" title="Permalink to this headline">¶</a></h2>
    <p>The gateway needs to register with the AEN server.</p>
    <p>This needs to be authenticated, so the NFI user&#8217;s credentials created during
    the AEN server install must be used.</p>
    <p>To write the configuration file
    <code class="docutils literal"><span class="pre">/opt/wakari/wakari-gateway/etc/wakari/wk-gateway-config.json</span></code>,
    run the following as sudo or root:</p>
    <div class="highlight-bash"><div class="highlight"><pre><span></span>sudo /opt/wakari/wakari-gateway/bin/wk-gateway-configure <span class="se">\</span>
    --server http://<span class="nv">$AEN_SERVER</span> --host <span class="nv">$AEN_GATEWAY</span> <span class="se">\</span>
    --port <span class="nv">$AEN_GATEWAY_PORT</span> --name Gateway --protocol http <span class="se">\</span>
    --summary Gateway --username <span class="nv">$AEN_SRVC_ACCT</span> <span class="se">\</span>
    --password <span class="s1">&#39;&lt;NFI USER PASSWORD&gt;&#39;</span>
    </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 <a class="reference internal" href="install-server-node.html"><span class="doc">server installation</span></a>.</p>
    <div class="section" id="setting-permissions">
    <h3>Setting permissions<a class="headerlink" href="#setting-permissions" title="Permalink to this headline">¶</a></h3>
    <p>Run:</p>
    <div class="highlight-bash"><div class="highlight"><pre><span></span>sudo chown <span class="nv">$AEN_SRVC_ACCT</span> /opt/wakari/wakari-gateway/etc/wakari/wk-gateway-config.json
    </pre></div>
    </div>
    </div>
    <div class="section" id="starting-the-gateway">
    <h3>Starting the gateway<a class="headerlink" href="#starting-the-gateway" title="Permalink to this headline">¶</a></h3>
    <p>Run:</p>
    <div class="highlight-bash"><div class="highlight"><pre><span></span>sudo service wakari-gateway start
    </pre></div>
    </div>
    </div>
    <div class="section" id="verifying-your-gateway-registration">
    <h3>Verifying your gateway registration<a class="headerlink" href="#verifying-your-gateway-registration" title="Permalink to this headline">¶</a></h3>
    <ol class="arabic">
    <li><p class="first">Log into the AEN server using the Chrome or Firefox browser
    and the AEN_SRVC_ACCT user.</p>
    </li>
    <li><p class="first">In the AEN navigation bar, click Admin to open the Admin
    Settings page.</p>
    </li>
    <li><p class="first">In the <strong>Site Admin</strong> menu, select Data Centers:</p>
    <div class="figure">
    <a class="reference internal image-reference" href="../../../../_images/ae-notebooks/4.2.1/aen-admin-admin_datacenter1.png"><img alt="../../../../_images/ae-notebooks/4.2.1/aen-admin-admin_datacenter1.png" src="../../../../_images/ae-notebooks/4.2.1/aen-admin-admin_datacenter1.png" style="width: 50%;" /></a>
    </div>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    </li>
    <li><p class="first">Click your data center:</p>
    <div class="figure">
    <a class="reference internal image-reference" href="../../../../_images/ae-notebooks/4.2.1/aen-install-datacenter-leftnav.png"><img alt="../../../../_images/ae-notebooks/4.2.1/aen-install-datacenter-leftnav.png" src="../../../../_images/ae-notebooks/4.2.1/aen-install-datacenter-leftnav.png" style="width: 682.4px; height: 423.2px;" /></a>
    </div>
    </li>
    <li><p class="first">Verify that your data center is registered and the 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>
    <div class="figure">
    <a class="reference internal image-reference" href="../../../../_images/ae-notebooks/4.2.1/aen-install-datacenter.png"><img alt="../../../../_images/ae-notebooks/4.2.1/aen-install-datacenter.png" src="../../../../_images/ae-notebooks/4.2.1/aen-install-datacenter.png" style="width: 764.0px; height: 481.6px;" /></a>
    </div>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    </li>
    </ol>
    </div>
    </div>
    <div class="section" id="what-s-next">
    <h2><a class="toc-backref" href="#id4">What&#8217;s next</a><a class="headerlink" href="#what-s-next" title="Permalink to this headline">¶</a></h2>
    <p><a class="reference internal" href="install-compute-node.html"><span class="doc">Install the AEN compute node(s)</span></a>.</p>
    </div>
