4 WorkGroup with MkHelp
The aim of this functionnality is to share a part of all MkHelp generated documents in a developpers team.
This could be done, first by generating documents you want to share ( html files, and database
(-g option)) on each local machine.
Then you start your local server (when you want), and navigate on all shared documents available on server machines.
How does that work ?
Each server knows only its near neighbours. These neighbours should be specified in the
'server.ini' file. When a request is emited by a user, doc agents navigate on each doc server to collect informations.
MkHelp server uses a Multi-DataBase site, but doesn't manage HTML pages. On SUN and WIN NT systems you have to mount a
ftp or http server. You could find a lot of ftp and http shareware servers for WIN 95.
Before starting a large net of documents, try on your local machine, with only your local server.
WARNING : this functionnality uses Sun JDK 1.0.2 package on each server.
4.1 Setup
first see install, and run your corresponding setup file.
You have to edit 'server.ini' file in the \bin directory
this file contains :
mkhelp.server.type=1
mkhelp.server.neighbourhood=koala;myserver.mycomp.com
Mkhelp.server.searchidx.path=c:\\mkhelp\\example\\dico.dat
mkhelp.server.docroot.url=file:///c:\\mkhelp\\example\\html\\
- mkhelp.server.type
type 0 : server doesn't serve any document, it's only a gateway
type 1 : server have local sharable documents
- mkhelp.server.neighbourhood
list of direct neighbours known by this server. Server names are separated by ';'
ex : koala;myserver.mycomp.com
- mkhelp.server.searchidx.path
put the path of your search index file (dico.dat) generated by MkHelp -g
WARNING : as you could see for WIN95/NT all '\' must be translated into \\ (for Solaris, it's /)
- mkhelp.server.docroot.url
put the URL of your doc root directory (typically 'index.html' location) ;
you can set ftp or http protocol in URL, only if your local host has ftpd or httpd deamon.
4.2 Start the server
Win95/NT Open a DOS box and run gosrv command.
Solaris 2.4 Open a cmdtool and run gosrv.csh command.
4.3 Start a client
First, generate doc with (-g) option, then load index.html with your favorite java browser, you will see
the finder button.
If your browser reports : class Afb.class not found error then you must previously add .\mkhelp\setup.bat (or setup.csh) in
your autoexec.bat (or .cshrc) and reboot.
The groupware fonctionnality include the great HORB package, Copyright 1995, 1996 HIRANO Satoshi (see horb Copyright)