-------------------------------------------------------------------------
HOW TO INSTALL DeleGate (Yutaka Sato, Aug18-2003)
-------------------------------------------------------------------------
1. Getting the latest source codes of DeleGate
Download the latest version DeleGate/X.Y.Z in the file:
<URL:ftp://ftp.delegate.org/pub/DeleGate/delegateX.Y.Z.tar.gz>
- DeleGate in development status is placed at "alpha/" directory:
<URL:ftp://ftp.delegate.org/pub/DeleGate/alpha/delegateX.Y.Z.tar.gz>
- Alternative download sites are shown at:
<URL:http://www.delegate.org/delegate/download/>
- Read "README" and the following page about changes in each version:
<URL:http://www.delegate.org/delegate/updates/>
2. Creating an executable of DeleGate
Expand, extract and and make as follows:
% gzip -d < delegateX.Y.Z.tar.gz | tar xfv -
% cd delegateX.Y.Z
% make
Your E-mail address will be asked at the beginning of the make.
After the make finished, the executable is left as "src/delegated"
3. Setting up the run-time files of DeleGate (OPTIONAL)
Install optional subsidiary components if necessary.
You can postpone this until you encounter the necessity.
(All of run-time files of DeleGate are placed under the directory referred
as "DGROOT". The default location of DGROOT is $HOME/delegate/ for
normal users on Unix, while it is "\Program Files\DeleGate" on MS-Windows.
The DGROOT directory is created automatically if it does not exist.)
- DGROOT/lib/{sslway, server.pem, ...} -- to enable SSL encoding/decoding
<URL:http://www.delegate.org/delegate/sslway/>
- DGROOT/lib/gzip -- to enable gzip encoding/decoding on HTTP
- DGROOT/lib/lib*.so.* -- to enable chroot
- DGROOT/subin/{dgpam, dgchroot, dgbind} -- to achieve privileged operation
by DeleGate of normal users <subin/README_SUBIN>
4. Setting up a DeleGate server
Start the executable with necessary parameters.
For example to use DeleGate as a HTTP proxy server in debugging mode:
% delegated -v -P8080 SERVER=http
- Read the short tutorial "doc/tutor-en.htm" first.
<URL:http://www.delegate.org/delegate/tutorial/tutor-en.htm>
- Read the "doc/Manual.htm" for details.
<URL:http://www.delegate.org/delegate/Manual.htm>
- Examples (protocol specific examples):
<URL:http://www.delegate.org/delegate/Manual.htm#ProtoSpec>
- Platform specific issues (how to start as a daemon or a service):
<URL:http://www.delegate.org/delegate/Manual.htm#Platforms>
5. Asking your questions
To share efforts of questions and answers among users and the author,
your question is expected to be sent to the open forum.
- in English:
<URL:mailto:feedback@delegate.org>
<URL:http://www.delegate.org/feedback/>
- in Japanese:
<URL:mailto:goiken@delegate.org>
<URL:http://www.delegate.org/delegate/goiken/>
-------------------------------------------------------------------------