MemoWiki comprises a web server (a Linux or Windows version of GoServe)
and a collection of Rexx programs which effect the various actions
that the client can ask for (view a page, edit a page, show the page
). Please note that these programs are only available
within IBM at present – sorry.
The MemoWiki package is distributed as a Zip file which contains
the following directories:
||contains the ReadMe and simple .bat files for starting MemoWiki
||contains the MemoWiki software (no data are held here)
||contains a static snapshot of the MemoWiki User’s Guide and Help files (unlike normal topics, you cannot edit these pages)
The memowiki directory will contain all the topics 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:
- Install Object Rexx if not already installed (ooRexx 4.0.1 », or later, is recommended).
- Start the server by running StartMemoWiki.bat (in the memowiki
top directory). If requested (under Windows) unblock the server.
(This should start the server 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.)
- 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 topics; it’s suggested that
you first browse the User’s Guide (click on the MemoWiki documentation
snapshot link). Then you’ll probably want to use the ‘Add Topic’
button to add a topic, perhaps called Test, to experiment with.
If it all works, in Windows you might want to put a shortcut to StartMemoWiki.bat
in your startup folder, and a shortcut to MemoWiki.bat on your
desktop. There’s a MemoWiki.ico in the memowiki directory
to use to decorate the latter; use Run Minimized to prevent a command
line window showing briefly when the shortcut is used.
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 or later)
- Do not run MemoWiki without users being defined (with the default,
anonymous, user, anyone on the Internet can access and vandalize
the topics on your server).
Running MemoWiki on the Internet 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:
- Assign the server running MemoWiki a static address on the home
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.
- 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:
Private IP address: 192.168.1.11
Port: 8087 (x2)
Some routers may need to be reset or restarted after this change.
- 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.)