{% extends "global/layout.html" %}
{% block title %}Ticket 919/920 fix{% endblock %}
{% block content %}

<p>The issue described on this page only affects Windows systems that originally installed I2P
with version 0.9.5. Other operating systems are not affected.
</p>
<p>This issue has been corrected as of the <a href="{{ get_url('downloads_select', version='0.9.5-win1', file='i2pinstall_0.9.5-win1_windows.exe') }}">0.9.5-win1 release</a>.</p>



<h2>Background</h2>
<p>A change was introduced during the 0.9.5 cycle to allow I2P's configuration files to be edited with the standard
   Windows text editor, <code>Notepad</code>.  This change had the unfortunate side-effect of causing our I2P Site migration code to
   fail to run on Windows systems, leading to I2P Sites being served from the installation directory. Consequently:
</p>
<ul>
   <li>depending upon how I2P is started, the I2P Site may not be accessible; and</li>
   <li>confusion ensues&mdash;all documentation states that I2P Sites are served from the profile path; and</li>
   <li>the update to Jetty 7, included in the 0.9.6 release, will fail.</li>
</ul>
<p>While no action is required for users that are not hosting an I2P Site (or are not using the included Jetty to host an I2P Site), it is
recommended to follow this procedure to avoid issues in case you decide to run a Jetty-hosted I2P Site in the future. If you are running an
I2P Site it is important to follow this procedure prior to upgrading to 0.9.6.
</p>

<p>
   Tickets <a href="https://trac.i2p2.de/ticket/919">919</a> &amp; <a href="https://trac.i2p2.de/ticket/920">920</a> correspond to this issue.
</p>

<h2>Fixing the configuration</h2>
<p>Because this issue causes the migration code to not run, the path in <code>%APPDATA%\I2P\clients.config</code> isn't
   updated to use an absolute path for the Jetty config file, requiring the path to be set manually. Experienced users
   can set the correct path in <code>clients.config</code> directly and restart I2P, but this page will explain how to
   correct the problem from within the router console.
</p>

<ol>
   <li>From the Home page of the I2P Router Console, click the I2P logo in the upper-left corner.
       <a href="{{ url_for('static', filename='images/ticket919/home.png') }}">
       <img alt="" style="padding:10px;margin-left:auto;margin-right:auto;display:block" src="{{ url_for('static', filename='images/ticket919/home.png') }}" /></a>
   </li>
   <li>Click the <a href="http://127.0.0.1:7657/configclient">I2P Services</a> link.
       <a href="{{ url_for('static', filename='images/ticket919/i2p-services.png') }}">
       <img alt="" style="padding:10px;margin-left:auto;margin-right:auto;display:block" src="{{ url_for('static', filename='images/ticket919/i2p-services.png') }}" /></a>
       You should see something like the following:
       <a href="{{ url_for('static', filename='images/ticket919/paths.png') }}">
       <img alt="" style="padding:10px;margin-left:auto;margin-right:auto;display:block" src="{{ url_for('static', filename='images/ticket919/paths.png') }}" /></a>
       If the path at number 1 in the image above is set to <code>I2P Site/jetty.xml</code>, the path needs to be updated.
   </li>
   <li>Click the <code>Edit</code> button next to <em>I2P webserver (I2P Site)</em>. The page will reload to allow the path to be edited as shown below:
       <a href="{{ url_for('static', filename='images/ticket919/edit.png') }}">
       <img alt="" style="padding:10px;margin-left:auto;margin-right:auto;display:block" src="{{ url_for('static', filename='images/ticket919/edit.png') }}" /></a>
       Insert the full path to your I2P configuration directory <em>before</em> the text "I2P Site/jetty.xml" as shown above,
       then click Click the <code>Save Client Configuration</code> button.
   </li>
   <li> If you're hosting an I2P Site, move its contents to its proper home at <code>%APPDATA%\I2P\I2P Site\docroot</code>.
   </li>
   <li>At this point you should restart your I2P router.</li>
</ol>

<p>After following the steps outlined above, your I2P Site will be served from <code>%APPDATA%\I2P\I2P Site\docroot</code>
   and should be accessible at <a href="http://127.0.0.1:7658">http://127.0.0.1:7658</a>.
</p>
{% endblock %}