diff --git a/apps/desktopgui/bundle-messages.sh b/apps/desktopgui/bundle-messages.sh index 29713209e..420fb5945 100644 --- a/apps/desktopgui/bundle-messages.sh +++ b/apps/desktopgui/bundle-messages.sh @@ -25,10 +25,7 @@ if which find|grep -q -i windows ; then export PATH=.:/bin:/usr/local/bin:$PATH fi # Fast mode - update ondemond -echo Placing a file named messages_{LangCode}.only in locale folder, -echo will limit .po file update to the language specified by {LangCode}. -LG2=$(find locale -iname messages_*.only|tail -1) -[ LG2 ] && LG2=${LG2#locale/messages_} && LG2=${LG2%.only} +# set LG2 to the language you need in envrionment varibales to enable this # add ../java/ so the refs will work in the po file JPATHS="src" diff --git a/apps/i2psnark/java/bundle-messages.sh b/apps/i2psnark/java/bundle-messages.sh index 2a6a82470..64fc69f83 100755 --- a/apps/i2psnark/java/bundle-messages.sh +++ b/apps/i2psnark/java/bundle-messages.sh @@ -24,10 +24,7 @@ if which find|grep -q -i windows ; then export PATH=.:/bin:/usr/local/bin:$PATH fi # Fast mode - update ondemond -echo Placing a file named messages_{LangCode}.only in locale folder, -echo will limit .po file update to the language specified by {LangCode}. -LG2=$(find ../locale -iname messages_*.only|tail -1) -[ LG2 ] && LG2=${LG2#../locale/messages_} && LG2=${LG2%.only} +# set LG2 to the language you need in envrionment varibales to enable this # add ../java/ so the refs will work in the po file JPATHS="../java/src" diff --git a/apps/i2ptunnel/java/bundle-messages.sh b/apps/i2ptunnel/java/bundle-messages.sh index 2ee9eba7b..74bbc573e 100755 --- a/apps/i2ptunnel/java/bundle-messages.sh +++ b/apps/i2ptunnel/java/bundle-messages.sh @@ -24,10 +24,7 @@ if which find|grep -q -i windows ; then export PATH=.:/bin:/usr/local/bin:$PATH fi # Fast mode - update ondemond -echo Placing a file named messages_{LangCode}.only in locale folder, -echo will limit .po file update to the language specified by {LangCode}. -LG2=$(find ../locale -iname messages_*.only|tail -1) -[ LG2 ] && LG2=${LG2#../locale/messages_} && LG2=${LG2%.only} +# set LG2 to the language you need in envrionment varibales to enable this # add ../java/ so the refs will work in the po file JPATHS="../java/src ../jsp/WEB-INF" diff --git a/apps/routerconsole/java/bundle-messages.sh b/apps/routerconsole/java/bundle-messages.sh index 7bc06577c..f37ca27cf 100755 --- a/apps/routerconsole/java/bundle-messages.sh +++ b/apps/routerconsole/java/bundle-messages.sh @@ -24,10 +24,7 @@ if which find|grep -q -i windows ; then export PATH=.:/bin:/usr/local/bin:$PATH fi # Fast mode - update ondemond -echo Placing a file named messages_{LangCode}.only in locale folder, -echo will limit .po file update to the language specified by {LangCode}. -LG2=$(find ../locale -iname messages_*.only|tail -1) -[ LG2 ] && LG2=${LG2#../locale/messages_} && LG2=${LG2%.only} +# set LG2 to the language you need in envrionment varibales to enable this # # generate strings/Countries.java from ../../../installer/resources/countries.txt diff --git a/apps/susidns/src/bundle-messages.sh b/apps/susidns/src/bundle-messages.sh index 1e6d7db19..349eb3f1d 100755 --- a/apps/susidns/src/bundle-messages.sh +++ b/apps/susidns/src/bundle-messages.sh @@ -24,10 +24,7 @@ if which find|grep -q -i windows ; then export PATH=.:/bin:/usr/local/bin:$PATH fi # Fast mode - update ondemond -echo Placing a file named messages_{LangCode}.only in locale folder, -echo will limit .po file update to the language specified by {LangCode}. -LG2=$(find ../locale -iname messages_*.only|tail -1) -[ LG2 ] && LG2=${LG2#../locale/messages_} && LG2=${LG2%.only} +# set LG2 to the language you need in envrionment varibales to enable this # add ../src/ so the refs will work in the po file JPATHS="../src/java/ ../src/tmp/" diff --git a/build.xml b/build.xml index 25ed6e7d6..396c4909f 100644 --- a/build.xml +++ b/build.xml @@ -217,6 +217,8 @@ + + diff --git a/installer/resources/readme/readme.html b/installer/resources/readme/readme.html index f9865e672..8aa1d9577 100644 --- a/installer/resources/readme/readme.html +++ b/installer/resources/readme/readme.html @@ -76,38 +76,53 @@ your eepsite will be visible (but not discoverable) to others. Detailed instruct

Troubleshooting & Further Assistance

-
    -
  • Be Patient!
    I2P may be slow to integrate into network the first time you run it as it bootstraps into the network and learns of additional peers. The longer your I2P router is running, the better it will perform, so try and keep your router on as long as you can, 24/7 if possible! If, after 30 minutes, your Active: [connected/recent] count still has less than 10 peers, or your total number of Integrated peers is less than 5, there are several things you can do to check for problems: + +
      + +
    • Be Patient!
      I2P may be slow to integrate into network the first time you run it as it bootstraps into the network and learns of additional peers. The longer your I2P router is running, the better it will perform, so try and keep your router on as long as you can, 24/7 if possible! If, after 30 minutes, your Active: [connected/recent] count still has less than 10 peers, or your total number of Integrated peers is less than 5, there are several things you can do to check for problems:
      • -
    • Check your Configuration & Bandwidth Allocation
      I2P functions best when you can accurately reflect the speed of your network connection in the bandwidth configuration section. By default I2P is configured with some fairly conservative values that will not suit many use cases, so please take time to review these settings and correct where necessary. The more bandwidth you allocate, specifically upstream bandwidth, the more you will benefit from the network. +
    • Check your Configuration & Bandwidth Allocation
      I2P functions best when you can accurately reflect the speed of your network connection in the bandwidth configuration section. By default I2P is configured with some fairly conservative values that will not suit many use cases, so please take time to review these settings and correct where necessary. The more bandwidth you allocate, specifically upstream bandwidth, the more you will benefit from the network.
      • -
    • Firewalls, Modems & Routers
      Where possible, please ensure I2P/Java is allowed bi-directional port access from the internet by configuring your modem/router/pc firewall accordingly. -If you're behind a prohibitive firewall but have unrestricted outbound access, I2P can still function; you can turn off inbound access and rely on SSU IP Address Detection (firewall hole punching) to connect you to the network, and your network status in the side panel will indicate "Network: Firewalled". For optimal performance, where possible please ensure I2P's external port is visible from the internet (see below for more information).
      • +
    • Firewalls, Modems & Routers
      Where possible, please ensure I2P/Java is allowed bi-directional port access from the internet by configuring your modem/router/pc firewall accordingly. + If you're behind a prohibitive firewall but have unrestricted outbound access, I2P can still function; you can turn off inbound access and rely on SSU IP Address Detection (firewall hole punching) to connect you to the network, and your network status in the side panel will indicate "Network: Firewalled". For optimal performance, where possible please ensure I2P's external port is visible from the internet (see below for more information). +
      • -
    • Check Your Proxy Setttings
      If +
    • Check Your Proxy Setttings
      If you cannot see any eepsites at all (not even www.i2p2.i2p), - make sure your browser's proxy is set to access http traffic (not https, not socks) via 127.0.0.1 port 4444. If you need some help, there's a guide to configuring your browser for I2P use, also available on the normal web.
      • + make sure your browser's proxy is set to access http traffic (not https, not socks) via 127.0.0.1 port 4444. If you need some help, there's a guide to configuring your browser for I2P use, also available on the normal web. + -
    • Check Your Logs
      Logs may help resolve a problem. You may wish to paste excerpts in a forum for help, or perhaps paste it instead and reference the link on IRC for help.
      • -
    • Verify Java is Up to Date
      Ensure your Java is up to date [version 1.6 recommended and required for some features]. If you don't have Java installed, you probably want some implementation of the JRE (Java Runtime Engine); if you're a developer, the SDK may also be of interest, and possibly Apache Ant which we use to build the I2P Java binaries. +
    • Check Your Logs
      Logs may help resolve a problem. You may wish to paste excerpts in a forum for help, or perhaps paste it instead and reference the link on IRC for help. +
      • + +
    • Verify Java is Up to Date
      Ensure your Java is up to date [version 1.6 recommended and required for some features]. If you don't have Java installed, you probably want some implementation of the JRE (Java Runtime Engine); if you're a developer, the SDK may also be of interest, and possibly Apache Ant which we use to build the I2P Java binaries.
      • -
    • Problems running on Legacy Hardware
      [Linux/Unix/Solaris] If you can't start the router with i2p/i2prouter start try the runplain.sh script in the same directory. Root privileges are usually not required to run I2P. If you need to compile the jBigi library (which is necessary in rare cases), consult appropriate documentation, visit the forums, or come pay a visit to our IRC developer channel. +
    • Problems running on Legacy Hardware
      [Linux/Unix/Solaris] If you can't start the router with i2p/i2prouter start try the runplain.sh script in the same directory. Root privileges are usually not required to run I2P. If you need to compile the jBigi library (which is necessary in rare cases), consult appropriate documentation, visit the forums, or come pay a visit to our IRC developer channel. +
      • -
    • Enable Universal Plug and Play (UPnP)
      Your modem or router may support Universal Plug & Play (UPnP), which permits automatic port forwarding. Ensure UPnP support for I2P is enabled on the config page, then try to activate UPnP on your modem/router and possibly your computer also. Now try restarting the I2P router. If successful, I2P should report "Network: OK" in the side panel once the I2P router completes initial connectivity tests. -
      • -
    • Port Forwarding
      Open I2P's port on your modem, router and/or firewall(s) for better connectivity (ideally both UDP and TCP). More information on how to go about port forwarding can be found at portforward.com, in addition to our forums and IRC channels listed below. Note that I2P does not support connecting to the internet via an http or socks proxy [patches welcome!], though you can connect to proxies via I2P itself once connected to the network. -
      • -
    • Getting Support Online
      You may also want +
    • Enable Universal Plug and Play (UPnP)
      Your modem or router may support Universal Plug & Play (UPnP), which permits automatic port forwarding. Ensure UPnP support for I2P is enabled on the config page, then try to activate UPnP on your modem/router and possibly your computer also. Now try restarting the I2P router. If successful, I2P should report "Network: OK" in the side panel once the I2P router completes initial connectivity tests. +
      • + +
    • Port Forwarding
      Open I2P's port on your modem, router and/or firewall(s) for better connectivity (ideally both UDP and TCP). More information on how to go about port forwarding can be found at portforward.com, in addition to our forums and IRC channels listed below. Note that I2P does not support connecting to the internet via an http or socks proxy [patches welcome!], though you can connect to proxies via I2P itself once connected to the network. +
      • + +
    • Getting Support Online
      You may also want to review the information on the I2P website, post messages to the I2P discussion forum, or swing by - #i2p-help, #i2p or #i2p-chat on I2P's internal IRC network (irc.postman.i2p or irc.freshcoffee.i2p). These channels are also available outside of I2P's encrypted, anonymous network via Freenode IRC.
      • + #i2p-help, #i2p or #i2p-chat on I2P's internal IRC network (irc.postman.i2p or irc.freshcoffee.i2p). These channels are also available outside of I2P's encrypted, anonymous network via Freenode IRC. + -
    • Reporting Bugs
      If you'd like to report a bug, please file a ticket on trac.i2p2.i2p. For developer-related discussions, please visit zzz's developer forums or come and visit the developer channel on I2P's IRC network. Developers can browse source at zzz's mtn repository viewer, Sponge's instance, or via trac.i2p2.i2p. We primarily use monotone to manage our source code.
      • +
    • Reporting Bugs
      If you'd like to report a bug, please file a ticket on trac.i2p2.i2p. For developer-related discussions, please visit zzz's developer forums or come and visit the developer channel on I2P's IRC network. Developers can browse source at zzz's mtn repository viewer, Sponge's instance, or via trac.i2p2.i2p. We primarily use monotone to manage our source code. +
      • -
    • Get Involved!
      I2P is developed and maintained mostly through unfunded, voluntary participation by community members. We're happy to accept donations, which go into essential hosting and administrative costs. We have cash bounties for aspects of I2P for developers looking for incentives to participate, and we're always looking for more Java coders, translators, promoters and users to help I2P grow. The bigger the I2P network, the more everyone benefits, so simply telling all your friends about I2P (and lending a hand with the installation and setup where needed) is a big help. For further info on how you can participate, visit the volunteers page on the website.
      • -
    [Return to Top]
    +
  • Get Involved!
    I2P is developed and maintained mostly through unfunded, voluntary participation by community members. We're happy to accept donations, which go into essential hosting and administrative costs. We have cash bounties for aspects of I2P for developers looking for incentives to participate, and we're always looking for more Java coders, translators, promoters and users to help I2P grow. The bigger the I2P network, the more everyone benefits, so simply telling all your friends about I2P (and lending a hand with the installation and setup where needed) is a big help. For further info on how you can participate, visit the volunteers page on the website. +
    • + +
+ +
[Return to Top]
Document updated: December 2010.