[Webfunds-commits] html/download zip_README.html

Ian Grigg iang@cypherpunks.ai
Mon, 11 Sep 2000 10:22:46 -0400 (AST)


iang        00/09/11 10:22:46

  Modified:    download zip_README.html
  Log:
  added comment about firewalls

Revision  Changes    Path
1.28      +102 -75   html/download/zip_README.html

Index: zip_README.html
===================================================================
RCS file: /home/webfunds/cvsroot/html/download/zip_README.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- zip_README.html	2000/09/11 13:37:55	1.27
+++ zip_README.html	2000/09/11 14:22:45	1.28
@@ -17,10 +17,11 @@
     <a href="#going">Getting it Going</a>
     <br><small>
         .. <a href="#general">General</a>
-        .. <a href="#bugs">Bugs</a>
         .. <a href="#macos">MacOS</a>
         .. <a href="#unix">Unix</a>
         .. <a href="#DOS">DOS</a>
+        .. <a href="#jars">Jars List</a>
+        .. <a href="#bugs">Bugs</a>
     </small>
   </li><li>
     <a href="#other">Other Components</a>
@@ -30,6 +31,11 @@
     </small>
   </li><li>
     <a href="#quick">Quick Intro</a>
+    <br><small>
+        .. <a href="#setup">Setting Up</a>
+        .. <a href="#transactions">Unlimited Transactions</a>
+        .. <a href="#trouble">Troubleshooting</a>
+    </small>
   </li><li>
     <a href="#mail">Join the MailGroup</a>
     <br><small>
@@ -266,80 +272,6 @@
 for more help on Java.
 </p><p>
 
-These JARs need to be available (1.2)
-</p>
-
-<ol><li>
-       cryptix-jce-compat.jar
-       <b><i>JDK 1.1 ONLY</i></b>
-       (before other Cryptix jars)
-      </li><li>
-       cryptix-jce-api.jar
-      </li><li>
-       cryptix-jce-provider.jar
-      </li><li>
-       cryptix-openpgp.jar
-      </li><li>
-       SOX.jar
-      </li><li>
-       WebFunds.jar
-      </li><li>
-       swingall.jar
-       <b><i>JDK 1.1 ONLY</i></b>
-       (last one)
-</li></ol>
-
-<p>
-The order above is known to work, other orders may not.
-Check the <code>run*</code> scripts for further hints.
-Note that <code>Cryptix.jar</code> is now no longer
-required for releases 1.7 and after.
-</p>
-
-<p>
-If you are adding other third-party Jars
-such as the Trader Jar from Systemics,
-then it should probably go after the
-<code>WebFunds.jar</code>
-and before the
-<code>swingall.jar</code>
-(if present).
-</p>
-
-
-<h4><a name="bugs">Bugs</a></h4>
-
-<P>
-When reporting difficulties, bear in mind:
-</P>
-<ul><li>
-        Join the
-        <a href="#mail">MailGroup</a>
-        and report it there!
-      </li></p><p><li>
-        Try and provide the complete error log which is saved
-        in the file <code>stderr</code> during every run.
-        (Save that file before restarting WebFunds...)
-      </li></p><p><li>
-        You should provide the WebFunds version number,
-        which is located at the top of this file, or
-        as part of the download file name.
-      </li></p><p><li>
-        Supply the JVM type (JDK, JRE, Kaffe, etc) and the
-        version number of that JVM (by running the JVM with
-        the <code>-version</code> option).
-      </li></p><p><li>
-        If you can reproduce the error, make sure that
-        you turn *off* any JIT that is running for the
-        stack traces.  When the JIT is running, stack traces
-        either hide the bug or reveal the wrong bug, so
-        generally reduce any possibility of finding the
-        bug dramatically.
-      </li></p><p><li>
-        Remember, this release is primarily for developers,
-        platform issues and user support are generally handled 
-        by 3rd party distributors.
-</li></ul>
 
 
 <h4><a name="MacOS">MacOS</a></h4>
@@ -525,6 +457,82 @@
 
 </tr></table>
 
+<h4><a name="jars">Jars List</a></h4>
+
+These JARs need to be available (1.2)
+</p>
+
+<ol><li>
+       cryptix-jce-compat.jar
+       <b><i>JDK 1.1 ONLY</i></b>
+       (before other Cryptix jars)
+      </li><li>
+       cryptix-jce-api.jar
+      </li><li>
+       cryptix-jce-provider.jar
+      </li><li>
+       cryptix-openpgp.jar
+      </li><li>
+       SOX.jar
+      </li><li>
+       WebFunds.jar
+      </li><li>
+       swingall.jar
+       <b><i>JDK 1.1 ONLY</i></b>
+       (last one)
+</li></ol>
+
+<p>
+The order above is known to work, other orders may not.
+Check the <code>run*</code> scripts for further hints.
+Note that <code>Cryptix.jar</code> is now no longer
+required for releases 1.7 and after.
+</p>
+
+<p>
+If you are adding other third-party Jars
+such as the Trader Jar from Systemics,
+then it should probably go after the
+<code>WebFunds.jar</code>
+and before the
+<code>swingall.jar</code>
+(if present).
+</p>
+
+
+<h4><a name="bugs">Bugs</a></h4>
+
+<P>
+When reporting difficulties, bear in mind:
+</P>
+<ul><li>
+        Join the
+        <a href="#mail">MailGroup</a>
+        and report it there!
+      </li></p><p><li>
+        Try and provide the complete error log which is saved
+        in the file <code>stderr</code> during every run.
+        (Save that file before restarting WebFunds...)
+      </li></p><p><li>
+        You should provide the WebFunds version number,
+        which is located at the top of this file, or
+        as part of the download file name.
+      </li></p><p><li>
+        Supply the JVM type (JDK, JRE, Kaffe, etc) and the
+        version number of that JVM (by running the JVM with
+        the <code>-version</code> option).
+      </li></p><p><li>
+        If you can reproduce the error, make sure that
+        you turn *off* any JIT that is running for the
+        stack traces.  When the JIT is running, stack traces
+        either hide the bug or reveal the wrong bug, so
+        generally reduce any possibility of finding the
+        bug dramatically.
+      </li></p><p><li>
+        Remember, this release is primarily for developers,
+        platform issues and user support are generally handled 
+        by 3rd party distributors.
+</li></ul>
 
 <h3><a name="other">Other Components</a></h3>
 
@@ -606,6 +614,8 @@
 
 <h3><a name="quick">Quick Intro</a></h3>
 
+<h4><a name="setup">Setting Up</a></h4>
+
 The distribution includes some contracts, but these are
 not installed.
 <p>
@@ -628,6 +638,7 @@
 Select <b>[add account]</b>.
 Select the SOX wallet (the only one there currently).
 
+<h4><a name="transactions">Unlimited Transactions</a></h4>
 <p>
 With no money, you can always do two things to test WebFunds:
 
@@ -639,6 +650,22 @@
 
 Try it<b><big><i>!</i></big></b>
 
+<h4><a name="trouble">Troubleshooting</a></h4>
+
+<p>
+If WebFunds reports that it cannot get through to the
+servers, it may be that your firewall is blocking outward
+connections.  WebFunds uses HTTP protocols, but is
+directed to non-HTTP ports by the servers.  This is
+the "correct" thing to do, but will in future also
+attempt to communicate on the HTTP port 25 in order
+to bypass firewall checks.
+</p>
+
+<p>
+Check with your administrator to see if outward
+connections get blocked to higher-number ports.
+</p>
 
 <h3><a name="mail">Join the MailGroup</a></h3>