blob: 1a47cc4fea42bb0813e04154b6ea5c6ccc449b09 [file] [log] [blame]
How to Configure IIS Module for Axis2C
________________________________________
Use the Axis2/C VC project or makefile to build the component.
In this document it is assumed that the mod_axis2_IIS.dll is in the directory
c:\axis2c\lib\mod_axis2_IIS.dll and axis2c_home is c:\axis2c
Add the following key to the registry.
HKEY_LOCAL_MACHINE\SOFTWARE\Apache Axis2c\IIS ISAPI Redirector
Add a string value with the name axis2c_home and a value of c:\axis2c
Add a string value with the name log_file and a value of c:\axis2c\logs\axis2.log
Add a string value with the name log_level. The value can be one of trace, error, info, critical, debug, warning
You can add a string value with the name services_url_prefix. This is optional and defaults to "/services".
As an example, if you have "/web_services" as the prefix, then all the services hosted would have the endpoint prefix of :
http://localhost/axis2/web_services.
Note: don't forget the / at the begining.
If you wish, you can also change the location as well by adding a string value with the name axis2_location.
This is also optional and defaults to /axis2. If you have /myserser as the value you can access your web
services with a url like http://localhost/myserver/services.
Note: Don't forget the / at the beginning.
Now you can do all the registry editing using the JScript file axis2_iis_regedit.js
provided with the distribution. When you build axis2/C with the IIS module the file
is copied to the root directory of the binary distribution. Just double click it and
everything will be set to the defaults. The axis2c_home is taken as the current directory,
so make sure you run the file in the Axis2/C repository location (or root of the binary distribution).
If you want to change the values you can manually edit the the .js file or give it as command line arguments
to the script when running the script. To run the jscript from the command line use the command
:\cscript axis2_iis_regedit.js optional arguments.
We recomend the manual editing as it is the easiest way to specify the values
IIS 5.1 or Below
Using the IIS management console, add a new virtual directory to your IIS/PWS Web site.
The name of the virtual directory must be axis2. Its physical path should be the directory
where you placed mod_axis2_IIS.dll (in our example it is c:\axis2c\lib). When creating this new
virtual directory, assign execute access to it.
By Using the IIS management console, add mod_axis2_IIS.dll as a filter in your IIS/PWS web site and restart the IIS admin service.
IIS 6 & 7
Using the IIS management console, add the mod_axis2_IIS.dll as a Wildcard Script Map.
Executable should be the complete path to the mod_axis2_IIS.dll
You can put any name as the name of the Wildcard Script Map
Please don't add the mod_axis2_IIS.dll as a filter to IIS as in the IIS 5.1 case.
Note: If the Axis2/C failed to load, verify that Axis2/C and its dependent DLLs are in the System Path (not the user path).