1 |
In order to install the DGEE you also need the following software: |
Suggested steps for building the dgee are: |
|
|
|
|
o phlib http://www.nfluid.com |
|
|
o Goldwater http://www.nfluid.com |
|
|
|
|
|
------------------------------------------------------------------------------ |
|
|
|
|
|
The steps for building the dgee are: |
|
2 |
|
|
3 |
1. Configure and install phlib under /usr/local |
1. Configure and install phlib under /usr/local |
4 |
2. Configure and install goldwater under /usr/local |
2. Configure and install goldwater under /usr/local |
8 |
4. Configure and install DGEE somewhere like your HOME directory |
4. Configure and install DGEE somewhere like your HOME directory |
9 |
(it has a release tree dgee/*) |
(it has a release tree dgee/*) |
10 |
|
|
11 |
5. Configure Apache as described below |
5. Configure Apache as described below. |
12 |
|
|
13 |
6. Setup your environment and boot the DGEE (see the README file) |
6. Setup your environment and boot the DGEE (see the README file). |
14 |
|
|
15 |
7. Follow the instruction in the examples dgee src directory for compiling |
7. Follow the instruction in the examples dgee src directory for compiling |
16 |
and installing a test webservice and getting the documentation generated for |
and installing a test webservice and getting the documentation generated for |
41 |
|
|
42 |
(./configure --help gives the full list) |
(./configure --help gives the full list) |
43 |
|
|
44 |
|
Apache 1 Notes: |
45 |
|
--------------- |
46 |
If apache apxs is not available on the build machine, there is a pre-built |
If apache apxs is not available on the build machine, there is a pre-built |
47 |
apache/precompiled/mod_dgee.so that may be copied into the DGEE libdir |
apache/precompiled/mod_dgee.so that may be copied into the DGEE libdir |
48 |
[dgee_install_base]/libexec/dgee/mod_dgee.so |
[dgee_install_base]/libexec/dgee/mod_dgee.so |
62 |
ie add the line: |
ie add the line: |
63 |
. [dgee_install_base]/share/dgee/dgeeenv.sh |
. [dgee_install_base]/share/dgee/dgeeenv.sh |
64 |
|
|
65 |
to the users .profile |
to the users .profile (or .bash_profile) |
66 |
|
|
67 |
|
|
68 |
|
|
119 |
|
|
120 |
shell> echo 128 > /proc/sys/kernel/msgmni |
shell> echo 128 > /proc/sys/kernel/msgmni |
121 |
|
|
122 |
or to make the increment persist across reboots, edit /etc/sysctl.conf and |
or to make the increment persist across reboots (This example taken from a |
123 |
add : |
RedHat system), edit /etc/sysctl.conf and add : |
124 |
|
|
125 |
# Increase Max Message Queues to 128 |
# Increase Max Message Queues to 128 |
126 |
kernel.msgmni = 128 |
kernel.msgmni = 128 |
127 |
|
|
128 |
(changes take effect on next reboot). |
Now load the new settings: |
129 |
|
|
130 |
|
shell> sysctl -p |
131 |
|
|
132 |
Follow this by a check to see if the change has been accepted: |
Follow this by a check to see if the change has been accepted: |
133 |
shell> ipcs -l |
shell> ipcs -l |
135 |
|
|
136 |
Configuring Apache |
Configuring Apache |
137 |
------------------ |
------------------ |
138 |
Add the following to your apache httpd.conf at the appropriate locations (the |
Add the following to your apache httpd.conf at the appropriate location (the |
139 |
apache src directory contains an example httpd.conf): |
apache src directory contains an example httpd.conf) to load and install the |
140 |
|
apache dgee module: |
141 |
|
|
142 |
LoadModule dgee_module [dgee_install_base]/libexec/dgee/mod_dgee.so |
LoadModule dgee_module [dgee_install_base]/libexec/dgee/mod_dgee.so |
143 |
AddModule mod_dgee.c |
AddModule mod_dgee.c |
144 |
|
|
145 |
AddHandler dgee-handler .dgmx |
|
146 |
DGEEConfig [dgee_install_base]/etc/dgeeconf.bin |
And add the following to invoke the dgee for suitable requests: |
147 |
|
|
148 |
|
include [dgee_install_base]/etc/mod_dgee.conf |
149 |
|
|
150 |
<!-- Optional 'directory' based DGEE association --> |
<!-- Optional 'directory' based DGEE association --> |
151 |
<Location /dgee> |
<Location /dgee> |
152 |
SetHandler dgee-handler |
include [dgee_install_base]/etc/mod_dgee.conf |
|
DGEEConfig [dgee_install_base]/etc/dgeeconf.bin |
|
153 |
</Location> |
</Location> |
154 |
|
|
155 |
Where dgee_install_base is the path to the installation base of the DGEE |
Where dgee_install_base is the path to the installation base of the DGEE |
156 |
application, /usr/local by default. |
application, /usr/local by default. |
157 |
|
|
158 |
|
|
159 |
Summary |
Summary |
160 |
------- |
------- |
161 |
1. Make sure Apache runs as the same userid as the DGEE application. |
1. Make sure Apache runs as the same userid as the DGEE application. |