[Webfunds-commits] html/guide/faq index.html

Tue, 20 Mar 2001 15:06:43 -0400 (AST)

iang        01/03/20 15:06:42

  Modified:    guide/faq index.html
  Log:
  added backup comment

Revision  Changes    Path
1.2       +133 -4    html/guide/faq/index.html

Index: index.html
===================================================================
RCS file: /home/webfunds/cvsroot/html/guide/faq/index.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2

--- index.html	2001/03/19 15:50:44	1.1
+++ index.html	2001/03/20 19:06:42	1.2
@@ -15,9 +15,11 @@
         > 
         > WebFunds won't work on our development machines.
         > 
-        > Because we're on a 10.0.0.0 network hidden from the world.
+        > Because we're on a 10.0.0.0 network hidden from
+        > the world.
         > 
-        > ah. how tough is it going to be to stick a proxy support in there?
+        > ah. how tough is it going to be to stick a proxy
+        > support in there?
 
 </i></pre>
 
@@ -25,11 +27,17 @@
 There are several answers to this, none are necessarily comprehensive...
 </p>
 
-<h3>Transparent Proxies</h3>
+<h3>System Adminstration Methods</h3>
 
 <p>
-Ask your sysadm to install a transparent proxy...
+Ask your sysadm to
 </p>
+<ul><li>
+    install a transparent proxy, or
+  </li><li>
+    install Network Address Translation (NAT, or masquerading) and use 
+    port aliasing.
+</li></ul>
 
 <h3>JVM proxy</h3>
 
@@ -73,4 +81,125 @@
 However the properties are currently ignored by the socket
 code.
 </p>
+
+<h2>Disaster Recovery</h2>
+
+<p>
+One of the attributes of the WebFunds value system is that
+the assets are the owners are the accounts.  That means that
+if you lose your machine, you lose the value.
+</p>
+
+<p>
+To solve this, take backups.
+</p>
+
+<h3>Backups</h3>
+
+<h4>File/Backup</h4>
+
+<p>
+Click on the <code>File</code> menu option at the top,
+and then click on <code>Backup</code>.  This will pop
+up an Explorer style dialog, which asks where to store
+the backup.
+</p>
+
+<p>
+Select a directory name somewhere (must exist), for example
+a different disk or removable media.  Then click on
+<code>Select Dir for Backup</code>
+and the backup routine will make a copy of your user directory
+into the selected directory, under a name starting with <code>WF_</code>.
+</p>
+
+<h4>Recovering from a Backup</h4>
+
+<p>
+Click on the <code>File</code> menu option at the top,
+and then click on <code>Recover Backup</code>.
+This will guide you through the selection of the location
+of a backup to recover from.
+</p>
+
+<p>
+Once the recovery is complete, it will cause WebFunds
+to stop, and you will have to restart it.
+</p>
+
+<p>
+Alternatively, take a new copy of WebFunds and start
+it up.  Then, it will offer you a choice of recovery
+or new user.  If you then recover from a backup, you
+can proceed to use that recovered user.
+</p>
+
+<h4>How it works</h4>
+
+<p>
+The above backup routine copies the entire WebFunds directory into
+a directory that is named like <code>WF_1234567890</code>, all
+within the directory you selected.  The coded name is then recognised
+by WebFunds when a recovery is done.
+</p>
+
+<p>
+The backup will include all the JARs and scripts
+and anything else in the WebFunds directory.  This way, the
+entire program is also backed up, so that there is no problem
+with reading the data at a later time.
+</p>
+
+<p>
+When the recovery is done, only the <i>user</i> data is recovered,
+being the data within the <code>user</code> directory.  This is
+possible because it is assumed that you already have a running
+WebFunds program in order to do the recovery.
+</p>
+
+<p>
+You could just
+as well run the entire program within the backup directory, and
+in this case, there would be no recovery needed.
+</p>
+
+<h4>Manual Backups</h4>
+
+<p>
+The following steps are suggested for the advanced user only.
+</p>
+
+<p>
+If a manual backup is desired, to save space for example,
+simply take a copy of the contents of the <code>user</code>
+directory.  Recovery can be done by selecting that directory,
+but WebFunds will check before proceeding, as it will not
+recognise the parent directory.
+</p>
+
+<h4>Only for the Very Brave</h4>
+
+<p>
+If you require a very small backup, then you might consider
+copying the account key files.  These are named as:
+</p>
+
+<pre>
+     user/data2/WalletManager/<i>Wallet</i>/Accounts/<i>abc123...</i>
+</pre>
+
+<p>
+where the <i>Wallet</i> component will be
+<code>SOX</code> or <code>Trader</code>,
+and the account name at the end is the hash
+of the public key.
+</p>
+
+<p>
+But, bear in mind that such a procedure is a developer procedure only,
+and you will require expert help in order to recover afterwards,
+if it is possible at all.  You should practice this before
+ever relying upon it.
+</p>
+
 






