DotGNU Execution Environment - RPM Packages
Right now only RPM packages for GNU/Linux on i386-based CPUs are available.
Downloads
RPMS
With the dependencies ..
Getting started after installing the binary packages
Quickstart and Installing Webservices
-------------------------------------
1. Setup your environment
The DGEE needs some environment variables set for it to find its resources,
and to help this an env script is provided that should be sourced as required.
If you use the DGEE supplied commands (dgadmin, dgeestart, csdgmx, dginstallws,
dgremovews etc) to administer the system then the environment will not need
setting manually. However if you need to change the runtime configuration
file at any time then the environment will need setting. See the FAQ for
further details.
If you want to sent the environment perminantly for a user then the env script
should be sourced by the .profile of the dgee 'user'.
By default the DGEE runs as the nobody user which does not have a home
directory, starting the dgee as root will see it switching to the configured
user (nobody unless otherwise configured).
So before running as root, execute the command:
shell> . /usr/local/share/dgee/dgeeenv.sh
If you're running the DGEE as another user, then edit that users
~/.bash_profile or ~/.profile depending on which you use and add the following
line:
. /usr/local/share/dgee/dgeeenv.sh
(You'll have to log out and back in again as this user for the change to take
effect)
2. Checking the System Configuration is correct
Run the command dgeediagnose.
This will check and report on may configuration issues that may affect the
running of the DGEE.
3. Starting DGEE
Run the command dgeestart
(See the README for further information)
4. Configure Apache
Add the following to your apache httpd.conf at the appropriate locations (the
apache src directory contains an example httpd.conf):
LoadModule dgee_module /usr/local/libexec/mod_dgee.so
AddModule mod_dgee.c
include /usr/local/etc/mod_dgee.conf
# Optional 'directory' based DGEE association
# allows http://url/dgee/test in addition to the default
# http://url/test.dgmx
#
<Location /dgee>
include /usr/local/etc/mod_dgee.conf
</Location>
Apache needs to run as either the user who started the DGEE or the DGEE needs
to run as the Apache user.
The following settings in httpd.conf file are suggested:
User nobody
Group nobody
or, if these are not appropriate and you are building the DGEE yourself, then
you may use the --with-username and --with-usergroup configure options (see
./configure --help for details).
If you did not build mod_dgee.so yourself then you will need to copy the
precompiled version from src/apache/precompiled/mod_dgee.so to
/usr/local/libexec/mod_dgee.so
(See INSTALL for details on Apache2).
5. Start Apache
Start apache in the usual way
6. You may now install a webservice
cd examples
make
This will create wstest.dll, state.dll and math.dll
Generate a dgmx files for each of these webservices:
csdgmx wstest.dll
csdgmx state.dll
csdgmx math.dll
Now install the webservice into the dgee by running dgeeinstallws script:
dgeeinstallws wstest
dgeeinstallws state
dgeeinstallws math
(Or you can copy the dll files directly into /usr/local/var/dgee/data and the
dgmx files into /usr/local/var/dgee/index - make sure the ownership on the
directory and files is correct).
You can now view the web service documentation for this webservice by pointing
your browser at:
http://my.local.apache.webserver/wstest.dgmx
http://my.local.apache.webserver/state.dgmx
http://my.local.apache.webserver/math.dgmx
If you want to see the documentation in XML form, use the following:
http://my.local.apache.webserver/wstest.dgmx?xml
XML-RPC access to the webservice is enabled by POSTing your XML-RPC request
to http://my.local.apache.webserver/wstest.dgmx
The perl directory contains a simple XMLRPC test client.
It requires XMLRPC::Lite which is part of SOAP::Lite.
Notes:
------
Shutting down the DGEE before Apache will leave Apache hanging onto system
IPC resources. This can be cleaned up by stopping Apache and running
dgeestop again.
Please see the README and INSTALL files and examples/readme for further
information.
Use examples/wstest.cs as a guide to writing your own webservices.
If you're really Interested...
------------------------------
Investigate the following administrative commands:
dgadmin pl # DGEE Process List
dgadmin sl # DGEE Service List
You can enter these commands interactively by typeing dgadmin directly.
Type help to get a full list of commands available.
(dgadmin is an alias for goldwater, using 'goldwater' will produce the same
results).
Chris Smith - 26/03/2003