Changeset 46ac0087 for apps


Ignore:
Timestamp:
Sep 19, 2018 10:37:37 AM (22 months ago)
Author:
slumlord <slumlord@…>
Branches:
master
Children:
4369b7d
Parents:
281c5f57
Message:

#2298 - Improve formatting to make translation-related activity easier; More details on trac

Location:
apps/routerconsole/jsp
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • apps/routerconsole/jsp/help-advancedsettings.jsi

    r281c5f57 r46ac0087  
    11<h2>Advanced Router Configuration</h2>
    22
    3 <p class="infohelp">The router configuration options listed below are not available in the user interface, usually because they are rarely used or provide access to advanced settings that most users will not need. This is not a comprehensive list. Some settings will require a restart of the router to take effect. Note that all settings are case sensitive. You will need to edit your <code>router.config</code> file to add options, or, once you have added <code>routerconsole.advanced=true</code> to the router.config file, you may edit settings within the console on the <a href="/configadvanced">Advanced Configuration page</a>.</p>
     3<p class="infohelp">The router configuration options listed below are not available in the user interface, usually because they are rarely used or provide access to advanced settings that most users will not need.
     4This is not a comprehensive list.
     5Some settings will require a restart of the router to take effect.
     6Note that all settings are case sensitive.
     7You will need to edit your <code>router.config</code> file to add options, or, once you have added <code>routerconsole.advanced=true</code> to the router.config file, you may edit settings within the console on the <a href="/configadvanced">Advanced Configuration page</a>.</p>
    48
    59<table id="configinfo"> <!-- sections separated for legibility -->
     
    1014<tr><th>routerconsole.advanced={true|false}</th></tr>
    1115<tr><td class="infowarn">Only set this to true if you know what you are doing!</td></tr>
    12 <tr><td>When set to true, additional functionality will be enabled in the console and the user will be able to edit settings directly on the <a href="/configadvanced">Advanced Configuration page</a>. Extra display options are provided in the <a href="/netdb">Network Database section</a>, including the <a href="/netdb?f=3">Sybil Analysis tool</a>, and there are additional configuration options on the <a href="/configclients">Clients Configuration page</a>. This will also enable the installation of unsigned updates, manual configuration of the news URL, and the installation of plugins. You may also wish to enable the "Advanced" sidebar section on the <a href="/configsidebar">Summary Bar Configuration page</a>.</td></tr>
     16<tr><td>When set to true, additional functionality will be enabled in the console and the user will be able to edit settings directly on the <a href="/configadvanced">Advanced Configuration page</a>.
     17Extra display options are provided in the <a href="/netdb">Network Database section</a>, including the <a href="/netdb?f=3">Sybil Analysis tool</a>, and there are additional configuration options on the <a href="/configclients">Clients Configuration page</a>.
     18This will also enable the installation of unsigned updates, manual configuration of the news URL, and the installation of plugins.
     19You may also wish to enable the "Advanced" sidebar section on the <a href="/configsidebar">Summary Bar Configuration page</a>.</td></tr>
    1320
    1421<tr><th>routerconsole.browser={/path/to/browser}</th></tr>
     
    1926
    2027<tr><th>router.updateUnsignedURL={url}</th></tr>
    21 <tr><td>This setting allows you to configure the update url for the unsigned update feature, if enabled. The url should end with <code>/i2pupdate.zip</code>. Note: do not install unsigned updates unless you trust the source of the update!</td></tr>
     28<tr><td>This setting allows you to configure the update url for the unsigned update feature, if enabled.
     29The url should end with <code>/i2pupdate.zip</code>.
     30Note: do not install unsigned updates unless you trust the source of the update!</td></tr>
    2231
    2332<tr><th>routerconsole.enablePluginInstall={true|false}</th></tr>
    24 <tr><td>When set to true, this enables plugin installation on the <a href="/configplugins">Plugin Configuration page</a>. Setting <code>routerconsole.advanced=true</code> will also enable this feature. [Enabled by default]</td></tr>
     33<tr><td>When set to true, this enables plugin installation on the <a href="/configplugins">Plugin Configuration page</a>.
     34Setting <code>routerconsole.advanced=true</code> will also enable this feature.
     35[Enabled by default]</td></tr>
    2536
    2637<tr><th>routerconsole.allowUntrustedPlugins={true|false}</th></tr>
    27 <tr><td>Plugins signed with the cryptographic key of the developer are the recommended format, but if you wish to install unsigned plugins you can set this to true. Note that you may still encounter issues attempting to install an unsigned plugin if the developer has included additional checks in the plugin build process.</td></tr>
     38<tr><td>Plugins signed with the cryptographic key of the developer are the recommended format, but if you wish to install unsigned plugins you can set this to true.
     39Note that you may still encounter issues attempting to install an unsigned plugin if the developer has included additional checks in the plugin build process.</td></tr>
    2840
    2941<tr><th>routerconsole.showSearch={true|false}</th></tr>
    30 <tr><td>When set to true, a configurable search bar will appear on the <a href="/home">console homepage</a>. Additional searches may then be added on the <a href="/confighome">home configuration page</a>.</td></tr>
     42<tr><td>When set to true, a configurable search bar will appear on the <a href="/home">console homepage</a>.
     43Additional searches may then be added on the <a href="/confighome">home configuration page</a>.</td></tr>
    3144
    3245<tr><th>router.buildHandlerThreads={n}</th></tr>
    33 <tr><td>Allocate number of processor threads for building tunnels. If your processor supports hyperthreading or simultaneous multithreading, you may multiply the number of processor cores by 2 to get the maximum number of threads to allocate, otherwise number of processor cores = maximum number of threads available. Note that you may wish to allocate less than the theoretical maximum to ensure you have headroom for other tasks.</td></tr>
     46<tr><td>Allocate number of processor threads for building tunnels.
     47If your processor supports hyperthreading or simultaneous multithreading, you may multiply the number of processor cores by 2 to get the maximum number of threads to allocate, otherwise number of processor cores = maximum number of threads available.
     48Note that you may wish to allocate less than the theoretical maximum to ensure you have headroom for other tasks.</td></tr>
    3449
    3550<tr><th>router.hideFloodfillParticipant={true|false}</th></tr>
     
    3752
    3853<tr><th>router.maxParticipatingTunnels={n}</th></tr>
    39 <tr><td>Determines the maximum number of participating tunnels the router can build. To disable participation completely, set to 0.</td></tr>
     54<tr><td>Determines the maximum number of participating tunnels the router can build.
     55To disable participation completely, set to 0.</td></tr>
    4056
    4157<tr><th>router.networkDatabase.flat={true|false}</th></tr>
  • apps/routerconsole/jsp/help-faq.jsi

    r281c5f57 r46ac0087  
    11<h2>Abridged I2P FAQ</h2>
    22
    3 <p class="infohelp">This is a shortened version of the official FAQ. For the full version, please visit <a href="https://geti2p.net/faq" target="_blank">https://geti2p.net/faq</a> or <a href="http://i2p-projekt.i2p/faq" target="_blank">http://i2p-projekt.i2p/faq</a>.
     3<p class="infohelp">This is a shortened version of the official FAQ.
     4For the full version, please visit <a href="https://geti2p.net/faq" target="_blank">https://geti2p.net/faq</a> or <a href="http://i2p-projekt.i2p/faq" target="_blank">http://i2p-projekt.i2p/faq</a>.
    45
    56<h3>My router has been up for several minutes and has zero or very few connections</h3>
    67
    7 <p>If after a few minutes of uptime your router is indicating 0 Active Peers and 0 Known Peers, with a notification in the sidebar that you need to check your network connection, verify that you can access the internet. If your internet connection is functional, you may need to unblock Java in your firewall. Otherwise, you may need to reseed your I2P router. Visit the <a href="/configreseed#reseedconfig">Reseed Configuration page</a> and click the <i>Save Changes and Reseed Now</i> button.</p>
     8<p>If after a few minutes of uptime your router is indicating 0 Active Peers and 0 Known Peers, with a notification in the sidebar that you need to check your network connection, verify that you can access the internet.
     9If your internet connection is functional, you may need to unblock Java in your firewall.
     10Otherwise, you may need to reseed your I2P router. Visit the <a href="/configreseed#reseedconfig">Reseed Configuration page</a> and click the "Save Changes and Reseed Now" button.</p>
    811
    912<h3>My router has very few active peers, is this OK?</h3>
    1013
    11 <p>If your router has 10 or more active peers, everything is fine. The router should maintain connections to a few peers at all times. The best way to stay "better-connected" to the network is to <a href="/config">share more bandwidth</a>.</p>
     14<p>If your router has 10 or more active peers, everything is fine.
     15The router should maintain connections to a few peers at all times.
     16The best way to stay "better-connected" to the network is to <a href="/config">share more bandwidth</a>.</p>
    1217
    1318<h3 id="addressbooksubs">I'm missing lots of hosts in my addressbook. What are some good subscription links?</h3>
    1419
    15 <p>The default subscription is to <code>http://i2p-projekt.i2p/hosts.txt</code> which is seldom updated. If you don't have another subscription, you may often have to use "jump" links which is much slower but ensures that your addressbook is only populated by sites you use (in addition to the default subscription addresses). To speed up browsing on I2P, it's a good idea to add some addressbook subscriptions.</p>
     20<p>The default subscription is to <code>http://i2p-projekt.i2p/hosts.txt</code> which is seldom updated.
     21If you don't have another subscription, you may often have to use "jump" links which is much slower but ensures that your addressbook is only populated by sites you use (in addition to the default subscription addresses).
     22To speed up browsing on I2P, it's a good idea to add some addressbook subscriptions.</p>
    1623
    17 <p>Here are some other public addressbook subscription links. You may wish to add one or two to your <a href="/susidns/subscriptions">susidns subscription list</a>. In the event that addresses conflict in the subscriptions, the lists placed at the top of your susidns configuration will take precedence over those placed further down.</p>
     24<p>Here are some other public addressbook subscription links.
     25You may wish to add one or two to your <a href="/susidns/subscriptions">susidns subscription list</a>.
     26In the event that addresses conflict in the subscriptions, the lists placed at the top of your susidns configuration will take precedence over those placed further down.</p>
    1827
    1928<ul>
     
    2332</ul>
    2433
    25 <p>Note that subscribing to a hosts.txt service is an act of trust, as a malicious subscription could give you incorrect addresses, so be careful subscribing to lists from unknown sources. The operators of these services may have various policies for listing hosts. Presence on this list does not imply endorsement.</p>
     34<p>Note that subscribing to a hosts.txt service is an act of trust, as a malicious subscription could give you incorrect addresses, so be careful subscribing to lists from unknown sources.
     35The operators of these services may have various policies for listing hosts.
     36Presence on this list does not imply endorsement.</p>
    2637
    2738<h3>How do I access IRC, BitTorrent, or other services on the regular Internet?</h3>
    2839
    29 <p>Unless an outproxy has been set up for the service you want to connect to, this is not possible. There are only three types of outproxies running right now: HTTP, HTTPS, and email. Note that there is currently no publicly listed SOCKS outproxy. If this type of service is required, try <a href="https://torproject.org/" target="_blank">Tor</a>.</p>
     40<p>Unless an outproxy has been set up for the service you want to connect to, this is not possible.
     41There are only three types of outproxies running right now: HTTP, HTTPS, and email.
     42Note that there is currently no publicly listed SOCKS outproxy.
     43If this type of service is required, try <a href="https://torproject.org/" target="_blank">Tor</a>.</p>
    3044
    3145<h3>How do I configure my browser to access .i2p websites?</h3>
    32 <p>You will need to configure your browser to use the HTTP proxy server (by default on host: <code>127.0.0.1</code> port: <code>4444</code>). See the <a href="https://geti2p.net/en/about/browser-config" target="_blank">Browser Proxy Configuration Guide</a> for a more detailed explanation.</p>
     46<p>You will need to configure your browser to use the HTTP proxy server (by default on host: <code>127.0.0.1</code> port: <code>4444</code>).
     47See the <a href="https://geti2p.net/en/about/browser-config" target="_blank">Browser Proxy Configuration Guide</a> for a more detailed explanation.</p>
    3348
    3449<h3>What is an eepsite?</h3>
    3550
    36 <p>An eepsite is a website that is hosted anonymously on the I2P network - you can access it by configuring your web browser to use I2P's HTTP proxy (see above) and browsing to the <code>.i2p</code> suffixed website (e.g. <a href="http://i2p-projekt.i2p" target="_blank">http://i2p-projekt.i2p</a>). Also ensure your browser is configured to resolve DNS remotely when using the proxy to avoid DNS leaks.</p>
     51<p>An eepsite is a website that is hosted anonymously on the I2P network - you can access it by configuring your web browser to use I2P's HTTP proxy (see above) and browsing to the <code>.i2p</code> suffixed website (e.g. <a href="http://i2p-projekt.i2p" target="_blank">http://i2p-projekt.i2p</a>).
     52Also ensure your browser is configured to resolve DNS remotely when using the proxy to avoid DNS leaks.</p>
    3753
    3854<h3>Most of the eepsites are down?</h3>
    3955
    40 <p>If you consider every eepsite that has ever been created, yes, most of them are down. People and eepsites come and go. A good way to get started in I2P is check out a list of eepsites that are currently up. <a href="http://identiguy.i2p" target="_blank">http://identiguy.i2p</a> tracks active eepsites.</p>
     56<p>If you consider every eepsite that has ever been created, yes, most of them are down.
     57People and eepsites come and go.
     58A good way to get started in I2P is check out a list of eepsites that are currently up.
     59<a href="http://identiguy.i2p" target="_blank">http://identiguy.i2p</a> tracks active eepsites.</p>
    4160
    4261<h3>How do I connect to IRC within I2P?</h3>
    4362
    44 <p>A tunnel to the main IRC server network within I2P, Irc2P, is created when I2P is installed (see the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>), and is automatically started when the I2P router starts. To connect to it, tell your IRC client to connect to server: <code>127.0.0.1</code> port: <code>6668</code>.</p>
     63<p>A tunnel to the main IRC server network within I2P, Irc2P, is created when I2P is installed (see the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>), and is automatically started when the I2P router starts.
     64To connect to it, tell your IRC client to connect to server: <code>127.0.0.1</code> port: <code>6668</code>.</p>
    4565
    46 <p>XChat-like client users can create a new network with the server <code>127.0.0.1/6668</code> (remember to tick <i>Bypass proxy server</i> if you have a proxy server configured), or you can connect with the command <code>/server 127.0.0.1 6668</code>. Different IRC clients may vary the syntax.</p>
     66<p>HexChat-like client users can create a new network with the server <code>127.0.0.1/6668</code> (remember to tick "Bypass proxy server" if you have a proxy server configured), or you can connect with the command <code>/server 127.0.0.1 6668</code>.
     67Different IRC clients may require a different command, consult your IRC client's manual for more information.</p>
    4768
    4869<h3>What ports does I2P use?</h3>
     
    5071<table id="portfaq">
    5172<tr><th colspan="3">LOCAL PORTS</th></tr>
    52 <tr><td colspan="3" class="infohelp">These are the local I2P port mappings, listening only to local connections by default, except where noted. Unless you require access from other machines, they should only be accessible from localhost.</td></tr>
     73<tr><td colspan="3" class="infohelp">These are the local I2P port mappings, listening only to local connections by default, except where noted.
     74Unless you require access from other machines, they should only be accessible from localhost.</td></tr>
    5375<tr><th>Port</th><th>Function</th><th>Notes</th></tr>
    54 <tr><td>1900</td><td>UPnP SSDP UDP multicast listener</td><td>Cannot be changed. Binds to all interfaces. Can be disabled on the <a href="/confignet">Network Configuration page</a>.</td></tr>
    55 <tr><td>2827</td><td>BOB bridge</td><td>A higher level socket API for clients. Can be enabled/disabled on the <a href="/configclients">Client Configuration page</a>. Can be changed in the <code>bob.config</code> file. [Disabled by default]</td></tr>
    56 <tr><td>4444</td><td>HTTP proxy</td><td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>. Can also be configured to bind to a specific interface or all interfaces.</td></tr>
    57 <tr><td>4445</td><td>HTTPS proxy</td><td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>. Can also be configured to bind to a specific interface or all interfaces.</td></tr>
    58 <tr><td>6668</td><td>IRC proxy</td><td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>. Can also be configured to bind to a specific interface or all interfaces.</td></tr>
    59 <tr><td>7652</td><td>UPnP HTTP TCP event listener</td><td>Binds to the LAN address. Can be changed with advanced config <code>i2np.upnp.HTTPPort=nnnn</code>. Can be disabled on the <a href="/confignet">Network Configuration page</a>.</td></tr>
    60 <tr><td>7653</td><td>UPnP SSDP UDP search response listener</td><td>Binds to all interfaces. Can be changed with advanced config <code>i2np.upnp.SSDPPort=nnnn</code>. Can be disabled on the <a href="/configclients">Client Configuration page</a>.</td></tr>
    61 <tr><td>7654</td><td>I2P Client Protocol port</td><td>Used by client apps. Can be changed to a different port on the <a href="/configclients">Client Configuration page</a> but this is not recommended. Can be bound to a different interface or all interfaces, or disabled, on the <a href="/configclients">Client Configuration page</a>.</td></tr>
    62 <tr><td>7655</td><td>UDP for SAM bridge</td><td>A higher level socket API for clients. Only opened when a SAM V3 client requests a UDP session. Can be enabled/disabled on the <a href="/configclients"> Client Configuration page</a>. Can be changed in the <code>clients.config</code> file with the SAM command line option <code>sam.udp.port=nnnn</code>.</td></tr>
    63 <tr><td>7656</td><td>SAM bridge</td><td>A higher level socket API for clients. Can be enabled/disabled on the <a href="/configclients">Client Configuration page</a>. Can be changed in the <code>clients.config</code> file. [Disabled by default]</td></tr>
    64 <tr><td>7657</td><td>I2P Router Console (Web interface)</td><td>Can be disabled in the <code>clients.config</code> file. Can also be configured to bind to a specific interface or all interfaces in that file. If you make the Router Console available over the network, you might wish to <a href="/configui#passwordheading">enforce an access password</a> to prevent unauthorized access.</td></tr>
    65 <tr><td>7658</td><td>I2P Web Server</td><td>Can be disabled in the <code>clients.config</code> file. Can also be configured to bind to a specific interface or all interfaces in the <code>jetty.xml</code> file.</td>
     76<tr><td>1900</td>
     77<td>UPnP SSDP UDP multicast listener</td>
     78<td>Cannot be changed.
     79Binds to all interfaces.
     80Can be disabled on the <a href="/confignet">Network Configuration page</a>.</td></tr>
     81<tr><td>2827</td>
     82<td>BOB bridge</td>
     83<td>A higher level socket API for clients.
     84Can be enabled/disabled on the <a href="/configclients">Client Configuration page</a>.
     85Can be changed in the <code>bob.config</code> file. [Disabled by default]</td></tr>
     86<tr><td>4444</td>
     87<td>HTTP proxy</td>
     88<td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>.
     89Can also be configured to bind to a specific interface or all interfaces.</td></tr>
     90<tr><td>4445</td>
     91<td>HTTPS proxy</td>
     92<td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>.
     93Can also be configured to bind to a specific interface or all interfaces.</td></tr>
     94<tr><td>6668</td>
     95<td>IRC proxy</td>
     96<td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>.
     97Can also be configured to bind to a specific interface or all interfaces.</td></tr>
     98<tr><td>7652</td>
     99<td>UPnP HTTP TCP event listener</td>
     100<td>Binds to the LAN address. Can be changed with advanced config <code>i2np.upnp.HTTPPort=nnnn</code>.
     101Can be disabled on the <a href="/confignet">Network Configuration page</a>.</td></tr>
     102<tr><td>7653</td>
     103<td>UPnP SSDP UDP search response listener</td>
     104<td>Binds to all interfaces.
     105Can be changed with advanced config <code>i2np.upnp.SSDPPort=nnnn</code>.
     106Can be disabled on the <a href="/configclients">Client Configuration page</a>.</td></tr>
     107<tr><td>7654</td>
     108<td>I2P Client Protocol port</td>
     109<td>Used by client apps. Can be changed to a different port on the <a href="/configclients">Client Configuration page</a> but this is not recommended.
     110Can be bound to a different interface or all interfaces, or disabled, on the <a href="/configclients">Client Configuration page</a>.</td></tr>
     111<tr><td>7655</td>
     112<td>UDP for SAM bridge</td>
     113<td>A higher level socket API for clients.
     114Only opened when a SAM V3 client requests a UDP session.
     115Can be enabled/disabled on the <a href="/configclients"> Client Configuration page</a>.
     116Can be changed in the <code>clients.config</code> file with the SAM command line option <code>sam.udp.port=nnnn</code>.</td></tr>
     117<tr><td>7656</td>
     118<td>SAM bridge</td>
     119<td>A higher level socket API for clients.
     120Can be enabled/disabled on the <a href="/configclients">Client Configuration page</a>.
     121Can be changed in the <code>clients.config</code> file. [Disabled by default]</td></tr>
     122<tr><td>7657</td>
     123<td>I2P Router Console (Web interface)</td>
     124<td>Can be disabled in the <code>clients.config</code> file.
     125Can also be configured to bind to a specific interface or all interfaces in that file.
     126If you make the Router Console available over the network, you might wish to <a href="/configui#passwordheading">enforce an access password</a> to prevent unauthorized access.</td></tr>
     127<tr><td>7658</td>
     128<td>I2P Web Server</td>
     129<td>Can be disabled in the <code>clients.config</code> file.
     130Can also be configured to bind to a specific interface or all interfaces in the <code>jetty.xml</code> file.</td>
    66131</tr>
    67 <tr><td>7659</td><td>Outgoing mail to smtp.postman.i2p</td><td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>. Can also be configured to bind to a specific interface or all interfaces.</td></tr>
    68 <tr><td>7660</td><td>Incoming mail from pop.postman.i2p</td><td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>. Can also be configured to bind to a specific interface or all interfaces.</td></tr>
    69 <tr><td>8998</td><td>mtn.i2p2.i2p (I2P's Monotone DVCS)</td><td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>. Can also be configured to bind to a specific interface or all interfaces. [Disabled by default]</td></tr>
    70 <tr><td>31000</td><td>Local connection to wrapper control channel port</td><td>Outbound to 32000 only, does not listen on this port. Starts at 31000 and will increment until 31999 looking for a free port. To change, see the <a href="http://wrapper.tanukisoftware.com/doc/english/prop-port.html" target="_blank">wrapper documentation</a>.</td></tr>
    71 <tr><td>32000</td><td>Local control channel for the service wrapper</td><td>To change, see the <a href="http://wrapper.tanukisoftware.com/doc/english/prop-port.html" target="_blank">wrapper documentation</a>.</td></tr>
     132<tr><td>7659</td>
     133<td>Outgoing mail to smtp.postman.i2p</td>
     134<td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>.
     135Can also be configured to bind to a specific interface or all interfaces.</td></tr>
     136<tr><td>7660</td>
     137<td>Incoming mail from pop.postman.i2p</td>
     138<td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>.
     139Can also be configured to bind to a specific interface or all interfaces.</td></tr>
     140<tr><td>8998</td>
     141<td>mtn.i2p2.i2p (I2P's Monotone DVCS)</td>
     142<td>Can be disabled or changed in the <a href="/i2ptunnelmgr">I2P Tunnel Manager</a>.
     143Can also be configured to bind to a specific interface or all interfaces. [Disabled by default]</td></tr>
     144<tr><td>31000</td>
     145<td>Local connection to wrapper control channel port</td>
     146<td>Outbound to 32000 only, does not listen on this port.
     147Starts at 31000 and will increment until 31999 looking for a free port.
     148To change, see the <a href="http://wrapper.tanukisoftware.com/doc/english/prop-port.html" target="_blank">wrapper documentation</a>.</td></tr>
     149<tr><td>32000</td>
     150<td>Local control channel for the service wrapper</td>
     151<td>To change, see the <a href="http://wrapper.tanukisoftware.com/doc/english/prop-port.html" target="_blank">wrapper documentation</a>.</td></tr>
    72152<tr><th colspan="3">INTERNET FACING PORTS</th></tr>
    73 <tr><td colspan="3" class="infohelp">I2P selects a random port between 9000 and 31000 to communicate with other routers when the program is run for the first time, or when your external IP address changes when running in <a href="/confignet#ipchange">Laptop Mode</a>. The <a href="/confignet#udpconfig">selected port</a> is shown on the <a href="/confignet">Network Configuration page</a>.</td></tr>
     153<tr><td colspan="3" class="infohelp">I2P selects a random port between 9000 and 31000 to communicate with other routers when the program is run for the first time, or when your external IP address changes when running in <a href="/confignet#ipchange">Laptop Mode</a>.
     154The <a href="/confignet#udpconfig">selected port</a> is shown on the <a href="/confignet">Network Configuration page</a>.</td></tr>
    74155<tr><td colspan="3">Outbound UDP from the <a href="/confignet#udpconfig">random port</a> noted on the Network Configuration page to arbitrary remote UDP ports, allowing replies.</td></tr>
    75156<tr><td colspan="3">Outbound TCP from random high ports to arbitrary remote TCP ports.</td></tr>
    76157<tr><td colspan="3">Inbound UDP to the <a href="/confignet#udpconfig">port</a> noted on the Network Configuration page from arbitrary locations (optional, but recommended).</td></tr>
    77 <tr><td colspan="3">Inbound TCP to the <a href="/confignet#externaltcp">port</a> noted on the Network Configuration page from arbitrary locations (optional, but recommended). <a href="/confignet#tcpconfig">Inbound TCP</a> may be disabled on the Network Configuration page.</td></tr>
     158<tr><td colspan="3">Inbound TCP to the <a href="/confignet#externaltcp">port</a> noted on the Network Configuration page from arbitrary locations (optional, but recommended).
     159<a href="/confignet#tcpconfig">Inbound TCP</a> may be disabled on the Network Configuration page.</td></tr>
    78160<tr><td colspan="3">Outbound UDP on port 123, allowing replies: this is necessary for I2P's internal time sync (via SNTP - querying a random SNTP host in <code>pool.ntp.org</code> or another server you specify).</td></tr>
    79161</table>
  • apps/routerconsole/jsp/help-legal.jsi

    r281c5f57 r46ac0087  
    1313
    1414<ul>
    15 <li><a href="http://i2p-projekt.i2p/i2ptunnel" target="_blank">I2PTunnel</a> - a GPL'ed application written by mihi
    16 that lets you tunnel normal TCP/IP traffic over I2P (such as the http proxy and the irc proxy), with a <a href="/i2ptunnelmgr">browser-based front end.</a></li>
     15<li><a href="http://i2p-projekt.i2p/i2ptunnel" target="_blank">I2PTunnel</a> - a GPL'ed application written by mihi that lets you tunnel normal TCP/IP traffic over I2P (such as the http proxy and the irc proxy), with a <a href="/i2ptunnelmgr">browser-based front end.</a></li>
    1716<li><a href="/webmail">Susimail</a>, a GPL'ed browser based mail client written by susi23.</li>
    18 <li>The <a href="http://i2p-projekt.i2p/en/docs/naming#addressbook" target="_blank">addressbook application</a>,
    19 written by Ragnarok helps maintain your hosts.txt files, with a <a href="/dns">front end</a> written by susi23.</li>
    20 <li>The <a href="http://i2p-projekt.i2p/en/docs/api/samv3" target="_blank">SAM</a> bridge by human (public domain), an API
    21 which other client applications (such the <a href="http://i2pwiki.i2p/index.php?title=Tahoe-LAFS" target="_blank">I2P Tahoe-LAFS cloud filesystem</a>) can use to interface with I2P.</li>
    22 <li><a href="http://i2p-projekt.i2p/en/misc/jbigi" target="_blank">jbigi</a> - an optimized library for doing large number calculations which uses the
    23 LGPL licensed <a href="http://swox.com/gmp/" target="_blank">GMP</a> library, tuned for various PC architectures.</li>
    24 <li>Launchers for windows users are built with <a href="http://launch4j.sourceforge.net/" target="_blank">Launch4J</a>,
    25 and the installer is built with  <a href="http://www.izforge.com/izpack/" target="_blank">IzPack</a>.</li>
    26 <li>The <a href="/">I2P Router Console</a>, built from a streamlined <a href="http://jetty.mortbay.com/jetty/index.html" target="_blank">Jetty Web Server</a> instance
    27 which allows you to deploy standard JSP/Servlet web applications in your router.</li>
    28 <li>Jetty makes use of Apache's <a href="https://docs.oracle.com/javaee/7/api/javax/servlet/package-summary.html" target="_blank">javax.servlet</a>
    29 (javax.servlet.jar) implementation. This product includes software developed by the <a href="http://www.apache.org/" target="_blank">Apache Software Foundation</a>.</li>
     17<li>The <a href="http://i2p-projekt.i2p/en/docs/naming#addressbook" target="_blank">addressbook application</a>, written by Ragnarok helps maintain your hosts.txt files, with a <a href="/dns">front end</a> written by susi23.</li>
     18<li>The <a href="http://i2p-projekt.i2p/en/docs/api/samv3" target="_blank">SAM</a> bridge by human (public domain), an API which other client applications (such the <a href="http://i2pwiki.i2p/index.php?title=Tahoe-LAFS" target="_blank">I2P Tahoe-LAFS cloud filesystem</a>) can use to interface with I2P.</li>
     19<li><a href="http://i2p-projekt.i2p/en/misc/jbigi" target="_blank">jbigi</a> - an optimized library for doing large number calculations which uses the LGPL licensed <a href="http://swox.com/gmp/" target="_blank">GMP</a> library, tuned for various PC architectures.</li>
     20<li>Launchers for windows users are built with <a href="http://launch4j.sourceforge.net/" target="_blank">Launch4J</a>, and the installer is built with  <a href="http://www.izforge.com/izpack/" target="_blank">IzPack</a>.</li>
     21<li>The <a href="/">I2P Router Console</a>, built from a streamlined <a href="http://jetty.mortbay.com/jetty/index.html" target="_blank">Jetty Web Server</a> instance which allows you to deploy standard JSP/Servlet web applications in your router.</li>
     22<li>Jetty makes use of Apache's <a href="https://docs.oracle.com/javaee/7/api/javax/servlet/package-summary.html" target="_blank">javax.servlet</a> (javax.servlet.jar) implementation.
     23This product includes software developed by the <a href="http://www.apache.org/" target="_blank">Apache Software Foundation</a>.</li>
    3024<li>Source for the I2P code and most bundled client applications can be found on our <a href="http://i2p-projekt.i2p/download" target="_blank">download page</a>.</li>
    3125</ul>
    3226
    33 <p>For details on other applications available, as well as their licenses, please see the <a href="http://i2p-projekt.i2p/licenses" target="_blank">
    34 license policy</a>. Additional licenses can be found in the <code>licenses</code> sub-directory of your I2P installation.</p>
     27<p>For details on other applications available, as well as their licenses, please see the <a href="http://i2p-projekt.i2p/licenses" target="_blank"> license policy</a>.
     28Additional licenses can be found in the <code>licenses</code> sub-directory of your I2P installation.</p>
  • apps/routerconsole/jsp/help-sidebar.jsi

    r281c5f57 r46ac0087  
    11<h2>Summary Bar Information</h2>
    22
    3 <p>Many of the stats on the summary bar may be <a href="configstats">configured</a> to be <a href="graphs">graphed</a> for further analysis. You may also customize the sections that appear on the Summary Bar and their positioning on the <a href="configsidebar">Summary Bar Configuration page</a>.
     3<p>Many of the stats on the summary bar may be <a href="configstats">configured</a> to be <a href="graphs">graphed</a> for further analysis.
     4You may also customize the sections that appear on the Summary Bar and their positioning on the <a href="configsidebar">Summary Bar Configuration page</a>.
    45</p>
    56
     
    910<li>
    1011<b>Local Identity:</b>
    11 If you hover over the <i>Router Info</i> heading, your truncated router identity will be shown (the first four characters (24 bits) of your 44-character (256-bit) Base64 router hash). The full hash is shown on your <a href="netdb?r=.">Network Database entry</a>. Never reveal this to anyone, as your router identity is uniquely linked to your IP address in the network database.</li>
     12If you hover over the "Router Info" heading, your truncated router identity will be shown (the first four characters (24 bits) of your 44-character (256-bit) Base64 router hash).
     13The full hash is shown on your <a href="netdb?r=.">Network Database entry</a>.
     14Never reveal this to anyone, as your router identity is uniquely linked to your IP address in the network database.</li>
    1215<li>
    1316<b>Version:</b>
    14 The version of the I2P software you are running. If a new version is available, you will be notified in the Summary Bar. It is recommended to keep your router up to date to ensure optimal performance and security. Router updates are usually made available on average every 2-3 months.
     17The version of the I2P software you are running.
     18If a new version is available, you will be notified in the Summary Bar.
     19It is recommended to keep your router up to date to ensure optimal performance and security.
     20Router updates are usually made available on average every 2-3 months.
    1521</li>
    1622
    1723<li>
    1824<b>Clock Skew:</b>
    19 The skew (offset) of your computer's clock relative to the network-synced time (if known). I2P requires your computer's time be accurate. If the skew is more than a few seconds, please correct the problem by adjusting your computer's time. If I2P cannot connect to the internet, a reading of 0ms may be indicated. <b>Note:</b> This is only displayed in the <i>Router Information (advanced)</i> section. You may add this section to your Summary Bar on the <a href="configsidebar">Summary Bar Configuration page</a>.
     25The skew (offset) of your computer's clock relative to the network-synced time (if known).
     26I2P requires your computer's time be accurate.
     27If the skew is more than a few seconds, please correct the problem by adjusting your computer's time.
     28If I2P cannot connect to the internet, a reading of 0ms may be indicated.
     29<b>Note:</b> This is only displayed in the "Router Information (advanced)" section.
     30You may add this section to your Summary Bar on the <a href="configsidebar">Summary Bar Configuration page</a>.
    2031</li>
    2132
    2233<li>
    2334<b>Memory:</b>
    24 This indicates the amount of RAM I2P is using, and the total amount available, allocated by Java. The usage will likely vary considerably within a short timeframe, but if the usage is consistently high relative to the available RAM, this may indicate that you need to increase the ram allocated to the JVM. You can allocate more RAM by editing your <code>wrapper.config</code> file which is normally located in the I2P application directory. You will need to edit the <code>wrapper.java.maxmemory</code> parameter, which by default is set to 128(MB). <b>Note:</b> Memory usage is only displayed in the <i>Router Information (advanced)</i> section or on the <i>Memory Usage Bar</i>, both of which may be added to your Summary Bar on the <a href="configsidebar">Summary Bar Configuration page</a>.
     35This indicates the amount of RAM I2P is using, and the total amount available, allocated by Java.
     36The usage will likely vary considerably within a short timeframe, but if the usage is consistently high relative to the available RAM, this may indicate that you need to increase the ram allocated to the JVM.
     37You can allocate more RAM by editing your <code>wrapper.config</code> file which is normally located in the I2P application directory.
     38You will need to edit the <code>wrapper.java.maxmemory</code> parameter, which by default is set to 128(MB).
     39<b>Note:</b> Memory usage is only displayed in the "Router Information (advanced)" section or on the "Memory Usage Bar", both of which may be added to your Summary Bar on the <a href="configsidebar">Summary Bar Configuration page</a>.
    2540</li>
    2641
     
    3954<ul>
    4055<li>
    41 <b>Active:</b> The first number is the number of peers your router has sent or received a message from in the last few minutes. This may range from 8-10 to several hundred, depending on your total bandwidth, shared bandwidth, and locally-generated traffic. The second number is the number of peers seen in the last hour or so. Do not be concerned if these numbers vary widely. <a href="configstats#router.activePeers">[Enable graphing]</a>.
     56<b>Active:</b> The first number is the number of peers your router has sent or received a message from in the last few minutes.
     57This may range from 8-10 to several hundred, depending on your total bandwidth, shared bandwidth, and locally-generated traffic.
     58The second number is the number of peers seen in the last hour or so.
     59Do not be concerned if these numbers vary widely.
     60<a href="configstats#router.activePeers">[Enable graphing]</a>.
    4261</li>
    4362<li>
    44 <b>Fast:</b> This is the number of peers your router has available for building client tunnels. It is generally in the range 8-30. Your fast peers are shown on the <a href="profiles">Profiles page</a>. <a href="configstats#router.fastPeers">[Enable graphing]</a>
     63<b>Fast:</b> This is the number of peers your router has available for building client tunnels.
     64It is generally in the range 8-30. Your fast peers are shown on the <a href="profiles">Profiles page</a>.
     65<a href="configstats#router.fastPeers">[Enable graphing]</a>
    4566</li>
    4667<li><b>High Capacity:</b>
    47 This is the number of peers your router has available for building your exploratory tunnels which are used to determine network performance. It is generally in the range 8-75. The fast peers are included in the high capacity tier.Your high capacity peers are shown on the <a href="profiles">Profiles page</a>. <a href="configstats#router.highCapacityPeers">[Enable graphing]</a>
     68This is the number of peers your router has available for building your exploratory tunnels which are used to determine network performance.
     69It is generally in the range 8-75.
     70The fast peers are included in the high capacity tier.
     71Your high capacity peers are shown on the <a href="profiles">Profiles page</a>.
     72<a href="configstats#router.highCapacityPeers">[Enable graphing]</a>
    4873</li>
    4974<li>
    50 <b>Integrated:</b> This is the number of peers your router will use for network database inquiries. These are usually the "floodfill" routers which are responsible for maintaining network integrity. Your well integrated peers are shown on the bottom of the <a href="profiles">Profiles page</a>.
     75<b>Integrated:</b> This is the number of peers your router will use for network database inquiries.
     76These are usually the "floodfill" routers which are responsible for maintaining network integrity.
     77Your well integrated peers are shown on the bottom of the <a href="profiles">Profiles page</a>.
    5178</li>
    5279<li>
    53 <b>Known:</b> This is the total number of peers that are known by your router. They are listed on the <a href="netdb">Network Database page</a>. This may range from under 100 to 1000 or more. This number is not the total size of the network; it may vary widely depending on your total bandwidth, shared bandwidth, and locally-generated traffic. I2P does not require a router to know every other router in the network.
     80<b>Known:</b> This is the total number of peers that are known by your router.
     81They are listed on the <a href="netdb">Network Database page</a>.
     82This may range from under 100 to 1000 or more.
     83This number is not the total size of the network; it may vary widely depending on your total bandwidth, shared bandwidth, and locally-generated traffic.
     84I2P does not require a router to know every other router in the network.
    5485</li>
    5586</ul>
     
    5788<h3>Bandwidth In/Out</h3>
    5889
    59 <p> This section indicates your average bandwidth speeds and total usage for the session. All values are in bytes per second, not bits per second. You may change your bandwidth limits on the <a href="config">Bandwidth Configuration page</a>. The more bandwidth you make available, the more you help the network and improve your own anonymity, so please take the time to review the settings. If you are unsure of your network's speed, using a service such as <a href="http://speedtest.net/">SpeedTest</a> or similar will give you a good indication of your bandwidth capability. Your upstream share amount (KBps Out) will determine your overall contribution to the network. Bandwidth is <a href="graphs">graphed</a> by default.</p>
     90<p> This section indicates your average bandwidth speeds and total usage for the session.
     91All values are in bytes per second, not bits per second.
     92You may change your bandwidth limits on the <a href="config">Bandwidth Configuration page</a>.
     93The more bandwidth you make available, the more you help the network and improve your own anonymity, so please take the time to review the settings.
     94If you are unsure of your network's speed, using a service such as <a href="https://speedtest.net/">SpeedTest</a> or similar will give you a good indication of your bandwidth capability.
     95Your upstream share amount (KBps Out) will determine your overall contribution to the network.
     96Bandwidth is <a href="graphs">graphed</a> by default.</p>
    6097
    6198<h3>Local Destinations</h3>
    6299
    63 <p>These are the local services provided by your router. They may be clients started through the <a href="i2ptunnelmgr">Tunnel Manager</a> or external programs connecting through SAM, BOB, or directly to I2CP. By default, most of your client services (mail, http proxy, IRC) will share the same set of tunnels (for performance reasons) and be listed as <i>Shared Clients</i> and <i>Shared Clients(DSA)</i>. However, if you experience a tunnel failure, all your services will go offline at the same time, so in some scenarios you may wish to configure client services to use their own set of tunnels. This can be done by unchecking the <i>Share tunnels with other clients&hellip;</i> option listed under <i>Shared Clients</i> on the configuration page of the relevant client service in the Tunnel Manager, after which you will need to restart the client service from the <a href="i2ptunnelmgr">main Tunnel Manager page</a>.</p>
     100<p>These are the local services provided by your router.
     101They may be clients started through the <a href="i2ptunnelmgr">Tunnel Manager</a> or external programs connecting through SAM, BOB, or directly to I2CP.
     102By default, most of your client services (mail, http proxy, IRC) will share the same set of tunnels (for performance reasons) and be listed as "Shared Clients" and "Shared Clients(DSA)".
     103However, if you experience a tunnel failure, all your services will go offline at the same time, so in some scenarios you may wish to configure client services to use their own set of tunnels.
     104This can be done by unchecking the "Share tunnels with other clients&hellip;" option listed under "Shared Clients" on the configuration page of the relevant client service in the Tunnel Manager, after which you will need to restart the client service from the <a href="i2ptunnelmgr">main Tunnel Manager page</a>.</p>
    64105
    65106<h3>Tunnels</h3>
     
    75116</li>
    76117<li>
    77 <b>Participating:</b> Tunnels built by other routers through your router. This may vary widely depending on network demand, your shared bandwidth, and amount of locally-generated traffic. The recommended method for limiting participating tunnels is to change your share percentage on the <a  href="config">Bandwidth Configuration page</a>. You may also limit the total number by setting <code>router.maxParticipatingTunnels=nnn</code> on the <a href="configadvanced">Advanced configuration page</a>. <a href="configstats#tunnel.participatingTunnels">[Enable graphing]</a>.
     118<b>Participating:</b> Tunnels built by other routers through your router.
     119This may vary widely depending on network demand, your shared bandwidth, and amount of locally-generated traffic.
     120The recommended method for limiting participating tunnels is to change your share percentage on the <a  href="config">Bandwidth Configuration page</a>.
     121You may also limit the total number by setting <code>router.maxParticipatingTunnels=nnn</code> on the <a href="configadvanced">Advanced configuration page</a>.
     122<a href="configstats#tunnel.participatingTunnels">[Enable graphing]</a>.
    78123</li>
    79124<li>
    80 <b>Share Ratio:</b> The number of participating tunnels you route for others, divided by the total number of hops in all your exploratory and client tunnels. A number greater than 1.00 means you are contributing more tunnels to the network than you are using.
     125<b>Share Ratio:</b> The number of participating tunnels you route for others, divided by the total number of hops in all your exploratory and client tunnels.
     126A number greater than 1.00 means you are contributing more tunnels to the network than you are using.
    81127</li>
    82128</ul>
    83129
    84130<h3>Congestion</h3>
    85 <p><b>Note:</b> This section is not enabled by default. You may enable it on the <a href="configsidebar">Summary Bar Configuration page</a>.</p>
     131<p><b>Note:</b> This section is not enabled by default.
     132You may enable it on the <a href="configsidebar">Summary Bar Configuration page</a>.</p>
    86133<p>Some basic indications of router overload:</p>
    87134
    88135<ul>
    89136<li>
    90 <b>Job Lag:</b> How long jobs are waiting before execution. The job queue is listed on the <a href="jobs">Jobs page</a>. Unfortunately, there are several other job queues in the router that may be congested, and their status is not available in the router console. The job lag should generally be zero. If it is consistently higher than 500ms, your computer is very slow, your network is experiencing connectivity issues, or the router has serious problems. <a href="configstats#jobQueue.jobLag">[Enable graphing]</a>.
     137<b>Job Lag:</b> How long jobs are waiting before execution.
     138The job queue is listed on the <a href="jobs">Jobs page</a>.
     139Unfortunately, there are several other job queues in the router that may be congested, and their status is not available in the router console.
     140The job lag should generally be zero.
     141If it is consistently higher than 500ms, your computer is very slow, your network is experiencing connectivity issues, or the router has serious problems.
     142<a href="configstats#jobQueue.jobLag">[Enable graphing]</a>.
    91143</li>
    92144<li>
    93 <b>Message Delay:</b> How long an outbound message waits in the queue. This should generally be a few hundred milliseconds or less. If it is consistently higher than 1000ms, your computer is very slow, or you should adjust your bandwidth limits, or your (Bittorrent?) clients may be sending too much data and should have their transmit bandwidth limit reduced. <a href="configstats#transport.sendProcessingTime">[Enable graphing]</a> (transport.sendProcessingTime).
     145<b>Message Delay:</b> How long an outbound message waits in the queue.
     146This should generally be a few hundred milliseconds or less.
     147If it is consistently higher than 1000ms, your computer is very slow, or you should adjust your bandwidth limits, or your (Bittorrent?) clients may be sending too much data and should have their transmit bandwidth limit reduced.
     148<a href="configstats#transport.sendProcessingTime">[Enable graphing]</a> (transport.sendProcessingTime).
    94149</li>
    95150
     
    106161
    107162<li>
    108 <b>Accepting/Rejecting:</b> Your router's status on accepting or rejecting requests from other routers to build a participating tunnel through your router. Your router may accept all requests, accept or reject a percentage of requests, or reject all requests for a number of reasons, to control the bandwidth and CPU demands and maintain capacity for local clients. <b>Note:</b> It will take at least 10 minutes from your router starting for it to accept building participating tunnels in order to ensure your router is stable and successfully bootstrapped to the network.
     163<b>Accepting/Rejecting:</b> Your router's status on accepting or rejecting requests from other routers to build a participating tunnel through your router.
     164Your router may accept all requests, accept or reject a percentage of requests, or reject all requests for a number of reasons, to control the bandwidth and CPU demands and maintain capacity for local clients.
     165<b>Note:</b> It will take at least 10 minutes from your router starting for it to accept building participating tunnels in order to ensure your router is stable and successfully bootstrapped to the network.
    109166</li>
    110167</ul>
Note: See TracChangeset for help on using the changeset viewer.