\memowiki	contains the ReadMe and simple .bat files for starting MemoWiki
\memowiki\_server	contains the MemoWiki software (no data are held here)
\memowiki\MemoWiki	contains a static snapshot of the MemoWiki User’s Guide and Help files (unlike normal projects, you cannot edit these pages)

The memowiki directory will contain all the projects for a given MemoWiki installation, each in its own directory.

Unzip the distribution file (perhaps at C:\, or at D:\ if you have multiple partitions), and then to run MemoWiki:

1. Install Object Rexx if not already installed (ooRexx 3.0.1 », or later, is recommended).

2. Start the server by running StartMemoWiki.bat (in the memowiki top directory).

   (This should start it minimised, with a ‘tree’ icon showing in the System tray – you can click on the icon to restore the server’s main window to view server activity.)

3. Run MemoWiki.bat to browse the wiki using Internet Explorer. (Or use the address 127.0.0.1:8087 in any browser.)

You should first see a list of current projects; it’s suggested that you first browse the User’s Guide (click on the MemoWiki project name). Then you’ll probably want to use the ‘Add Project’ button to add a project, perhaps called Test, to experiment with.

If it all works, you might want to put a shortcut to StartMemoWiki.bat in your startup folder, and a shortcut to MemoWiki.bat on your desktop.

Running MemoWiki on the Internet

To run MemoWiki on the Internet you need a server with a permanent connection to the Internet and a fixed IP (Internet Protocol) address. This can usually be achieved using a broadband connection (fixed IP addresses usually cost more than dynamically-allocated ones, however).

It is strongly recommended that you:

• Install a firewall on your server (or use the firewall in Windows XP SP 2)
• Do not run MemoWiki without users being defined (with the default, anonymous, user, anyone on the Internet can access and vandalize the projects on your server).

Running MemoWiki from within a home LAN

If you are connected to the Internet using a broadband router (or equivalent), the server will have a different local address than its ‘real’ address as seen on the internet, because the Router carries out Network Address Translation (this makes all the computers on the home LAN appear to be just one computer to the Internet).

In this situation you will normally need to take the following steps for the MemoWiki server to be visible on the internet:

1. Assign the server running MemoWiki a static address on the home LAN.

   On Windows XP, this is done using Control Panel → Network connections → LAN Ethernet properties → TCP/IP properties. Set the TCP/IP address to (for example) 192.168.1.11, the Subnet Mask to 255.255.255.0, and the default gateway and DNS addresses to (for example) 192.168.1.1, where the latter is the address of the router.

2. Set up the router to pass the connection through to the server.

   The procedure for this will vary with the router. For example, set up a ‘Virtual Server’ with parameters:
     Name: MemoWiki
     Private IP address: 192.168.1.11
     Port: 8087 (x2)
     Available: always
   Some routers may need to be reset or restarted after this change.

3. Change the MemoWiki startup to include the ‘real name’ of the server.

   The server’s address when running normally will be (for example) 192.168.1.11, however its name on the Internet will appear to be your ‘external’ address. MemoWiki needs to know that external address, and it cannot easily be determined automatically. To tell MemoWiki what that name is, add the parameter alias followed by the external name to the GoServeG startup command (usually in StartMemoWiki.bat). This might then read (all on one line):

    start /MIN "GoServeG" goserveg.exe http %1 %2
      filter memowiki.rex datadir "%~d0%~p0"
      port 8087 reuse  alias  myuserid.myisp.com
   

   (Incidentally, you can also change the port from 8087 to something else in that same command.)