Updating Anaconda Enterprise Notebooks (AEN 4.1.1)
==================================================

.. raw:: html

    <div class="section" id="summary">
    <h2>Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
    <p>IMPORTANT: These instructions are for upgrading Anaconda Enterprise Notebooks (AEN) to the
    current version 4.1.1 from 4.1.0 ONLY. Each version must be upgraded separately, do not
    skip versions.</p>
    <p>Upgrade instructions to previous versions:</p>
    <ul class="simple">
    <li><a class="reference internal" href="../../4.1.0/install/installation_update.html"><span class="doc">AEN 4.1.0 upgrade instructions</span></a></li>
    <li><a class="reference internal" href="../../4.0/install/installation_update.html"><span class="doc">AEN 4.0.0 upgrade instructions</span></a></li>
    </ul>
    <p>For upgrades from versions before the listed ones, please contact your
    enterprise support representative for help.</p>
    <p>NOTE: Named Service Account functionality is available with Anaconda Enterprise
    Notebooks 4.0.0+ for new installations only. It is not available for
    upgraded installations. Contact your enterprise support rep for more information.</p>
    <p>An upgrade to the Anaconda Enterprise Notebooks Platform requires all
    instances of the three service categories to be upgraded individually:</p>
    <ul class="simple">
    <li><em>AEN Server</em></li>
    <li><em>AEN Gateway</em></li>
    <li><em>AEN Compute</em></li>
    </ul>
    <p>An installation of Anaconda Enterprise Notebooks typically consists
    of several <em>Compute</em> instances running on independent <em>Compute Nodes</em>,
    and multiple <em>Gateways</em> if there is more than one <em>Data Center</em>
    tied into AEN. More details can be found in the <a class="reference internal" href="index.html"><span class="doc">Overview</span></a>.</p>
    <p>The upgrade process requires that all AEN service instances be stopped,
    upgraded, and then restarted. These instructions describe how to perform
    this process.</p>
    <p>Note: Any commands that call for the <code class="docutils literal"><span class="pre">root</span></code> user can also be done
    using <code class="docutils literal"><span class="pre">sudo</span></code>.</p>
    <p>If you encounter any difficulty during the process, please refer to the
    <a class="reference internal" href="../admin/troubleshooting.html"><span class="doc">Troubleshooting Guide</span></a> which
    provides guidance on:</p>
    <ul class="simple">
    <li>processes</li>
    <li>configuration files</li>
    <li>log files</li>
    <li>ports</li>
    </ul>
    <p>In the event you are unable to resolve an installation or upgrade
    problem please contact your enterprise support representative.</p>
    </div>
    <div class="section" id="pre-flight-check">
    <span id="aen-installation-update-preflight"></span><h2>Pre-Flight Check<a class="headerlink" href="#pre-flight-check" title="Permalink to this headline">¶</a></h2>
    <p>CAUTION: Make a tested backup of your installation before starting the upgrade.
    Upgrading to a higher version of AEN is not reversible. Any errors during the
    upgrade procedure may result in partial or complete data loss and require
    restoring data from backups.</p>
    <p>IMPORTANT: TERMINATE ALL AEN APPS AND STOP ALL PROJECTS before starting
    the upgrade process.</p>
    <p>Before upgrading each service on each host, perform the following operation:</p>
    <ol class="arabic">
    <li><p class="first">Suspend the services on each of the nodes with the following commands:</p>
    <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">server</span> <span class="n">stop</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">stop</span>
    <span class="n">sudo</span> <span class="n">service</span> <span class="n">wakari</span><span class="o">-</span><span class="n">compute</span> <span class="n">stop</span>
    </pre></div>
    </div>
    </li>
    <li><p class="first">Set the AEN Functional ID (NFI) and AEN Functional Group (NFG), which are
    described in <a class="reference internal" href="installation.html"><span class="doc">the installation instructions</span></a>.</p>
    <p>The NFI is the username of the AEN Service Account which is used to run all
    AEN services and is also the username of the AEN Admin account.</p>
    <p>The NFG is the Linux group that includes the AEN Service Account, so all
    files and directories that have the owner NFI also have the group NFG.</p>
    <p>When upgrading AEN, set the NFI and NFG to the NFI and NFG of the current
    installation.</p>
    <p>The default NFI is &#8220;wakari&#8221;, and &#8220;aen_admin&#8221; or any other name may be used
    instead.</p>
    <p>Set the NFI and NFG with these commands, replacing &#8220;wakari&#8221; if you are
    using another name:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">export</span> <span class="n">AEN_SRVC_ACCT</span><span class="o">=</span><span class="s2">&quot;wakari&quot;</span>
    <span class="n">export</span> <span class="n">AEN_SRVC_GRP</span><span class="o">=</span><span class="s2">&quot;wakari&quot;</span>
    </pre></div>
    </div>
    </li>
    </ol>
    </div>
    <div class="section" id="aen-server">
    <h2>AEN Server<a class="headerlink" href="#aen-server" title="Permalink to this headline">¶</a></h2>
    <p>NOTE: If you are using LDAP-based authentication, back up the configuration file:</p>
    <p><code class="docutils literal"><span class="pre">/opt/wakari/wakari-server/etc/wakari/wk-server-config.json</span></code></p>
    <p>After the <em>Server</em> has been upgraded, copy that file back into the same location
    as before the upgrade.</p>
    <p>The following operations are all done on the <em>Server</em> host:</p>
    <ol class="arabic">
    <li><p class="first">If you are using the search capabilities provided by
    ElasticSearch and a Java Runtime Environment (JRE 8):</p>
    <p>Stop the ElasticSearch service:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">service</span> <span class="n">elasticsearch</span> <span class="n">stop</span>
    </pre></div>
    </div>
    <p>Remove any previous index:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">rm</span> <span class="o">-</span><span class="n">rf</span> <span class="o">/</span><span class="n">var</span><span class="o">/</span><span class="n">lib</span><span class="o">/</span><span class="n">elasticsearch</span><span class="o">/*</span>
    </pre></div>
    </div>
    </li>
    </ol>
    <p>NOTE: You can choose to keep the old index but if you detect any issues with
    the search capabilities after the upgrade, you will need to perform the following
    steps to start with a clean index:</p>
    <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">server</span> <span class="n">stop</span>
    <span class="n">sudo</span> <span class="n">service</span> <span class="n">elasticsearch</span> <span class="n">stop</span>
    <span class="n">sudo</span> <span class="n">rm</span> <span class="o">-</span><span class="n">rf</span> <span class="o">/</span><span class="n">var</span><span class="o">/</span><span class="n">lib</span><span class="o">/</span><span class="n">elasticsearch</span><span class="o">/*</span>
    <span class="n">sudo</span> <span class="n">service</span> <span class="n">elasticsearch</span> <span class="n">start</span>
    <span class="n">sudo</span> <span class="n">service</span> <span class="n">wakari</span><span class="o">-</span><span class="n">server</span> <span class="n">start</span>
    </pre></div>
    </div>
    <ol class="arabic">
    <li><p class="first">Upgrade the <em>Server</em>:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span>pushd /tmp
    wget http://j.mp/aen-server-update-4_1_1

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \
                     -p /opt/wakari/wakari-server          \
                     --file aen-server-update-4_1_1

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \
                     -p /opt/wakari/wakari-server          \
                     --no-deps                             \
                     wakari-enterprise-server-conf-update=2.0.2
    popd
    </pre></div>
    </div>
    <p>NOTE: When you upgrade to the new wakari-server package, conda may ask to
    &#8220;downgrade&#8221; the package, because this version switches to a different
    version number schema. Approve the change and continue with the installation.</p>
    </li>
    <li><p class="first">Start ElasticSearch:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">service</span> <span class="n">elasticsearch</span> <span class="n">start</span>
    </pre></div>
    </div>
    <p>Or, if you do <em>not</em> want to use the search features, edit your
    server&#8217;s <code class="docutils literal"><span class="pre">config.json</span></code>:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">wakari</span><span class="o">/</span><span class="n">wakari</span><span class="o">-</span><span class="n">server</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">wakari</span><span class="o">/</span><span class="n">config</span><span class="o">.</span><span class="n">json</span>
    </pre></div>
    </div>
    <p>adding the line item: <code class="docutils literal"><span class="pre">&quot;SEARCH_ENABLED&quot;:</span> <span class="pre">false</span></code>.</p>
    </li>
    <li><p class="first">Start the <em>Server</em>:</p>
    <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">server</span> <span class="n">start</span>
    </pre></div>
    </div>
    </li>
    <li><p class="first">Check that the <em>Server</em> is running properly:</p>
    <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">server</span> <span class="n">status</span>
    </pre></div>
    </div>
    </li>
    <li><p class="first">Finally, use your web browser to connect to AEN Server, using the
    correct protocol (<em>http</em> or <em>https</em>), hostname, and port number.</p>
    </li>
    </ol>
    </div>
    <div class="section" id="aen-gateway">
    <h2>AEN Gateway<a class="headerlink" href="#aen-gateway" title="Permalink to this headline">¶</a></h2>
    <p>Repeat the following operations on each <em>Gateway</em> host.</p>
    <ol class="arabic">
    <li><p class="first">Upgrade the <em>Gateway</em>:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span>pushd /tmp
    wget http://j.mp/aen-gateway-update-4_1_1

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \
                     -p /opt/wakari/wakari-gateway         \
                     --file aen-gateway-update-4_1_1

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \
                     -p /opt/wakari/wakari-gateway         \
                     --no-deps                             \
                     wakari-enterprise-gateway-conf-update=2.0.2
    popd
    </pre></div>
    </div>
    </li>
    <li><p class="first">Start the <em>Gateway</em>:</p>
    <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>
    </li>
    <li><p class="first">Check that the <em>Gateway</em> is running properly:</p>
    <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">status</span>
    </pre></div>
    </div>
    </li>
    <li><p class="first">Finally, use your web browser to connect to the <em>Gateway</em>, using the
    correct protocol (<em>http</em> or <em>https</em>), hostname, and port number.</p>
    </li>
    </ol>
    </div>
    <div class="section" id="aen-compute">
    <h2>AEN Compute<a class="headerlink" href="#aen-compute" title="Permalink to this headline">¶</a></h2>
    <p>Repeat the following operations on each host where an AEN
    Compute service is running.</p>
    <p>The processes killed with <code class="docutils literal"><span class="pre">killall</span></code> are run by the <code class="docutils literal"><span class="pre">$AEN_SRVC_ACCT</span></code> user, so
    they can be killed as root with <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">killall</span></code> or killed as the
    <code class="docutils literal"><span class="pre">$AEN_SRVC_ACCT</span></code> user with <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">-u</span> <span class="pre">$AEN_SRVC_ACCT</span> <span class="pre">killall</span></code>. These example
    commands show the <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">killall</span></code> option.</p>
    <ol class="arabic">
    <li><p class="first">Check for any <code class="docutils literal"><span class="pre">wakari-indexer</span></code> processes running:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">ps</span> <span class="n">aux</span> <span class="o">|</span> <span class="n">grep</span> <span class="n">wakari</span><span class="o">-</span><span class="n">indexer</span>
    </pre></div>
    </div>
    <p>NOTE: If you stopped all the projects, you will not see any wakari-indexer
    processes running.</p>
    <p>Terminate any remaining <code class="docutils literal"><span class="pre">wakari-indexer</span></code> processes:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">killall</span> <span class="n">wakari</span><span class="o">-</span><span class="n">indexer</span>
    </pre></div>
    </div>
    </li>
    <li><p class="first">Check for any AEN apps (gateone, workbench, viewer, terminal, notebook)
    processes running:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">ps</span> <span class="n">aux</span> <span class="o">|</span> <span class="n">grep</span> <span class="n">wk</span><span class="o">-</span><span class="n">app</span><span class="o">-</span><span class="n">gateone</span>
    <span class="n">ps</span> <span class="n">aux</span> <span class="o">|</span> <span class="n">grep</span> <span class="n">wk</span><span class="o">-</span><span class="n">app</span><span class="o">-</span><span class="n">workbench</span>
    <span class="n">ps</span> <span class="n">aux</span> <span class="o">|</span> <span class="n">grep</span> <span class="n">wk</span><span class="o">-</span><span class="n">app</span><span class="o">-</span><span class="n">viewer</span>
    <span class="n">ps</span> <span class="n">aux</span> <span class="o">|</span> <span class="n">grep</span> <span class="n">wk</span><span class="o">-</span><span class="n">app</span><span class="o">-</span><span class="n">terminal</span>
    <span class="n">ps</span> <span class="n">aux</span> <span class="o">|</span> <span class="n">grep</span> <span class="n">notebookwrapper</span>
    <span class="n">ps</span> <span class="n">aux</span> <span class="o">|</span> <span class="n">grep</span> <span class="n">jupyter</span><span class="o">-</span><span class="n">notebook</span>
    </pre></div>
    </div>
    <p>NOTE: If you stopped all the projects, you will not see any AEN app
    processes running.</p>
    <p>Terminate any remaining AEN apps processes that you find:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">killall</span> <span class="n">wk</span><span class="o">-</span><span class="n">app</span><span class="o">-</span><span class="n">gateone</span>
    <span class="n">sudo</span> <span class="n">killall</span> <span class="n">wk</span><span class="o">-</span><span class="n">app</span><span class="o">-</span><span class="n">workbench</span>
    <span class="n">sudo</span> <span class="n">killall</span> <span class="n">wk</span><span class="o">-</span><span class="n">app</span><span class="o">-</span><span class="n">viewer</span>
    <span class="n">sudo</span> <span class="n">killall</span> <span class="n">wk</span><span class="o">-</span><span class="n">app</span><span class="o">-</span><span class="n">terminal</span>
    <span class="n">sudo</span> <span class="n">killall</span> <span class="n">notebookwrapper</span><span class="o">.</span><span class="n">py</span>
    <span class="n">sudo</span> <span class="n">killall</span> <span class="n">jupyter</span><span class="o">-</span><span class="n">notebook</span>
    </pre></div>
    </div>
    </li>
    <li><p class="first">Verify the contents of <code class="docutils literal"><span class="pre">/opt/wakari/anaconda/.condarc</span></code>. Modify it properly
    to contain the following entries (and possibly others if you customized the .condarc file).</p>
    <p>NOTE: Modify the file as the AEN_SRVC_ACCT user (or be sure to keep the same ownership).</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">channels</span><span class="p">:</span>
      <span class="o">-</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">conda</span><span class="o">.</span><span class="n">anaconda</span><span class="o">.</span><span class="n">org</span><span class="o">/</span><span class="n">t</span><span class="o">/&lt;</span><span class="n">TOKEN</span><span class="o">&gt;/</span><span class="n">anaconda</span><span class="o">-</span><span class="n">nb</span><span class="o">-</span><span class="n">extensions</span>
      <span class="o">-</span> <span class="n">r</span>
      <span class="o">-</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">conda</span><span class="o">.</span><span class="n">anaconda</span><span class="o">.</span><span class="n">org</span><span class="o">/</span><span class="n">wakari</span>
      <span class="o">-</span> <span class="n">defaults</span>

    <span class="n">create_default_packages</span><span class="p">:</span>
      <span class="o">-</span> <span class="n">anaconda</span><span class="o">-</span><span class="n">client</span>
      <span class="o">-</span> <span class="n">ipykernel</span>
    <span class="n">auto_update_conda</span><span class="p">:</span> <span class="n">false</span>
    </pre></div>
    </div>
    <p>NOTE: Contact your enterprise support representative to get your <code class="docutils literal"><span class="pre">&lt;TOKEN&gt;</span></code> for
    the Anaconda channel referenced above.</p>
    <p>NOTE: Replace &lt;TOKEN&gt; with the actual token from your
    enterprise support representative.</p>
    </li>
    <li><p class="first">Install necessary dependencies:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">yum</span> <span class="n">groupinstall</span> <span class="s2">&quot;X Window System&quot;</span> <span class="o">-</span><span class="n">y</span>
    <span class="n">sudo</span> <span class="n">yum</span> <span class="n">install</span> <span class="n">git</span> <span class="o">-</span><span class="n">y</span>
    </pre></div>
    </div>
    <p>Note: If you don&#8217;t want to install the whole X Window System, you need to
    install, at least, the following packages to have R plotting support:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">yum</span> <span class="n">install</span> <span class="o">-</span><span class="n">y</span> <span class="n">libXrender</span> <span class="n">libXext</span> <span class="n">libXdmcp</span> <span class="n">libSM</span> <span class="n">libICE</span> <span class="n">libXt</span> \
    <span class="n">dejavu</span><span class="o">-</span><span class="n">sans</span><span class="o">-</span><span class="n">fonts</span> <span class="n">dejavu</span><span class="o">-</span><span class="n">serif</span><span class="o">-</span><span class="n">fonts</span> <span class="n">dejavu</span><span class="o">-</span><span class="n">fonts</span><span class="o">-</span><span class="n">common</span> \
    <span class="n">fontpackages</span><span class="o">-</span><span class="n">filesystem</span>
    </pre></div>
    </div>
    </li>
    <li><p class="first">Upgrade the <em>Compute</em> service:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span>pushd /tmp
    wget http://j.mp/aen-compute-update-4_1_1

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda install \
                     -p /opt/wakari/wakari-compute        \
                     --file aen-compute-update-4_1_1

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda install \
                     --no-deps                            \
                     -p /opt/wakari/wakari-compute        \
                     wakari-enterprise-compute-conf-update=2.0.2
    popd
    </pre></div>
    </div>
    <p>NOTE: From AEN 4.1.0 and above, <cite>wakari-app-gateone</cite> is deprecated and no
    longer supported.</p>
    <p>NOTE: When upgrading the wakari-compute environment you may see <cite>ImportError</cite>
    warnings with some nbextensions. As long as the <cite>Validating</cite> message is
    <cite>OK</cite>, the <cite>ImportError</cite> warnings are harmless (just a consequence of the
    post-link presence on those packages).</p>
    </li>
    <li><p class="first">Upgrade <em>Anaconda</em> in the root environment.</p>
    <p>NOTE: The Anaconda root environment is the same in 4.1.0 and 4.1.1, so you
    don&#8217;t need to take any additional steps here.</p>
    </li>
    <li><p class="first">Initialize the root environment to prime the package cache:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span>sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda create \
                     -p /opt/wakari/testenv \
                     --clone root
    </pre></div>
    </div>
    <p>and test the offline cloning step with:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span>sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda create \
                     -p /opt/wakari/testenvoffline \
                     --clone root --offline
    </pre></div>
    </div>
    <p>finally remove those test environments with:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">sudo</span> <span class="n">rm</span> <span class="o">-</span><span class="n">rf</span> <span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">wakari</span><span class="o">/</span><span class="n">testenv</span>
    <span class="n">sudo</span> <span class="n">rm</span> <span class="o">-</span><span class="n">rf</span> <span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">wakari</span><span class="o">/</span><span class="n">testenvoffline</span>
    </pre></div>
    </div>
    </li>
    <li><p class="first">Start the <em>Compute</em> service:</p>
    <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">compute</span> <span class="n">start</span>
    </pre></div>
    </div>
    </li>
    <li><p class="first">Verify the <em>Compute</em> service is running properly:</p>
    <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">compute</span> <span class="n">status</span>
    </pre></div>
    </div>
    </li>
    </ol>
    </div>
    <div class="section" id="post-flight-check">
    <h2>Post-Flight Check<a class="headerlink" href="#post-flight-check" title="Permalink to this headline">¶</a></h2>
    <ol class="arabic simple">
    <li>You can now start the projects and start using the AEN apps.</li>
    <li>If you have a <a class="reference internal" href="installation.html#aen-default-project-env"><span class="std std-ref">customized default
    environment</span></a>, you may choose to upgrade it
    depending on the needs of your users.</li>
    </ol>
    <p>NOTE: Upgrading the <code class="docutils literal"><span class="pre">default</span></code> environment at
    <code class="docutils literal"><span class="pre">/opt/wakari/anaconda/envs/default</span></code> does NOT automatically upgrade the
    <code class="docutils literal"><span class="pre">default</span></code> environment in the users <strong>pre-existing</strong> projects. For
    pre-existing projects, the upgrade (if it is requested) should be done on a
    per-user basis.</p>
    <ol class="arabic simple">
    <li>If you did not stop all your projects before upgrading, then the first time
    you start an app you will see an error page requesting you to restart the app.
    Restart the app to complete the upgrade and use it again.</li>
    <li>If you still see old apps or the old IPython logo in the notebook app, reload
    the page to reset the browser cache.</li>
    </ol>
    <div class="toctree-wrapper compound">
    </div>
    </div>
