You are viewing a plain text version of this content. The canonical link for it is here.
Posted to axis-cvs@ws.apache.org by sa...@apache.org on 2003/12/24 13:58:04 UTC
cvs commit: ws-axis/c/docs/windows/cpp wininstall-guide.html
sanjaya 2003/12/24 04:58:04
Modified: c/docs/windows/cpp Tag: Release-2003_10_26-bugfixes_branch
wininstall-guide.html
Log:
added instructions to edit axiscpp.conf while installing with apache
Revision Changes Path
No revision
No revision
1.1.2.2 +529 -374 ws-axis/c/docs/windows/cpp/Attic/wininstall-guide.html
Index: wininstall-guide.html
===================================================================
RCS file: /home/cvs/ws-axis/c/docs/windows/cpp/Attic/wininstall-guide.html,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -u -r1.1.2.1 -r1.1.2.2
--- wininstall-guide.html 1 Dec 2003 10:46:08 -0000 1.1.2.1
+++ wininstall-guide.html 24 Dec 2003 12:58:04 -0000 1.1.2.2
@@ -1,404 +1,559 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
-<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<!--*** This is a generated file. Do not edit. ***-->
-<link rel="stylesheet" href="../skin/tigris.css" type="text/css">
-<link rel="stylesheet" href="../skin/mysite.css" type="text/css">
-<link rel="stylesheet" href="../skin/site.css" type="text/css">
-<link media="print" rel="stylesheet" href="../skin/print.css" type="text/css">
-<title></title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <!--*** This is a generated file. Do not edit. ***-->
+ <link rel="stylesheet" href="../skin/tigris.css" type="text/css">
+ <link rel="stylesheet" href="../skin/mysite.css" type="text/css">
+ <link rel="stylesheet" href="../skin/site.css" type="text/css">
+ <link media="print" rel="stylesheet" href="../skin/print.css"
+ type="text/css">
+ <title></title>
</head>
+
<body bgcolor="white" class="composite">
<!--================= start Banner ==================-->
+
<div id="banner">
-<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
-<tbody>
-<tr>
-<!--================= start Group Logo ==================-->
-<td align="left">
-<div class="groupLogo">
-<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../images/project-logo.jpg"></a>
-</div>
-</td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td align="right">
-<div class="projectLogo">
-<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../images/axis.jpg"></a>
-</div>
-</td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top" rowspan="2" align="right" class="search">
-<form target="_blank" action="http://www.google.com/search" method="get">
-<table summary="search" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
-</tr>
-<tr>
-<td colspan="3"><img height="8" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
-</tr>
-<tr>
-<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="GO" type="submit">
-<br>
- Search WS</td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
-</tr>
-<tr>
-<td colspan="3"><img height="7" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
-</tr>
-<tr>
-<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td>
-</tr>
-</table>
-</form>
-</td>
-<!--================= end Search ==================-->
-</tr>
-</tbody>
+
+<table width="100%" cellpadding="8" cellspacing="0" summary="banner"
+border="0">
+ <tbody>
+ <tr>
+ <!--================= start Group Logo ==================-->
+ <td align="left">
+ <div class="groupLogo">
+ <a href="http://ws.apache.org/"><img border="0" class="logoImage"
+ alt="The Apache WebServices Project"
+ src="../images/project-logo.jpg"></a></div>
+ </td>
+ <!--================= end Group Logo ==================-->
+ <!--================= start Project Logo ==================-->
+ <td align="right">
+ <div class="projectLogo">
+ <a href="http://ws.apache.org/axis/"><img border="0"
+ class="logoImage" alt="The Apache Axis Project"
+ src="../images/axis.jpg"></a></div>
+ </td>
+ <!--================= end Project Logo ==================-->
+ <!--================= start Search ==================-->
+ <td valign="top" rowspan="2" align="right" class="search">
+ <form method="get" target="_blank"
+ action="http://www.google.com/search">
+
+ <table summary="search" border="0" cellspacing="0" cellpadding="0">
+ <tbody>
+ <tr>
+ <td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1"
+ alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+ </tr>
+ <tr>
+ <td colspan="3"><img height="8" width="1" alt=""
+ src="../skin/images/spacer.gif" class="spacer"></td>
+ </tr>
+ <tr>
+ <td><img height="1" width="1" alt=""
+ src="../skin/images/spacer.gif" class="spacer"></td>
+ <td nowrap="nowrap"><input type="hidden"
+ value="ws.apache.org" name="sitesearch"><input type="text"
+ size="10" name="q" id="query"><img height="1" width="5"
+ alt="" src="../skin/images/spacer.gif" class="spacer">
+ <input type="submit" name="Search" value="GO"> <br>
+ Search WS</td>
+ <td><img height="1" width="1" alt=""
+ src="../skin/images/spacer.gif" class="spacer"></td>
+ </tr>
+ <tr>
+ <td colspan="3"><img height="7" width="1" alt=""
+ src="../skin/images/spacer.gif" class="spacer"></td>
+ </tr>
+ <tr>
+ <td class="bottom-left-thick"></td>
+ <td bgcolor="#a5b6c6"><img height="1" width="1" alt=""
+ src="../skin/images/spacer.gif" class="spacer"></td>
+ <td class="bottom-right-thick"></td>
+ </tr>
+ </tbody>
+ </table>
+ </form>
+ </td>
+ <!--================= end Search ==================-->
+ </tr>
+ </tbody>
</table>
</div>
<!--================= end Banner ==================-->
<!--================= start Main ==================-->
-<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
-<tbody>
-<!--================= start Status ==================-->
-<tr class="status">
-<td>
-<!--================= start BreadCrumb ==================--><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a>
-<!--================= end BreadCrumb ==================--></td><td id="tabs">
-<!--================= start Tabs ==================-->
-<div class="tab">
-<span class="selectedTab"><a class="base-selected" href="../index.html">WebServices-Axis</a></span>
-</div>
-<!--================= end Tabs ==================-->
-</td>
-</tr>
-</tbody>
+
+<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav"
+id="breadcrumbs">
+ <tbody>
+ <!--================= start Status ==================
+ <td></td>
+ -->
+ <tr class="status">
+ <td><!--================= start BreadCrumb ==================-->
+ <a href="http://www.apache.org/">Apache</a> | <a
+ href="http://ws.apache.org/">WS</a><a href=""></a> <!--================= end BreadCrumb ==================-->
+ </td>
+ <td id="tabs"><!--================= start Tabs ==================-->
+
+ <div class="tab">
+ <span class="selectedTab"><a class="base-selected"
+ href="../index.html">WebServices-Axis</a></span></div>
+ <!--================= end Tabs ==================-->
+ </td>
+ </tr>
+ </tbody>
</table>
<!--================= end Status ==================-->
-<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
-<tbody>
-<tr valign="top">
-<!--================= start Menu ==================-->
-<td id="leftcol">
-<div id="navcolumn">
-<div class="menuBar">
-<div class="menu">
-<span class="menuLabel">Axis</span>
-
-<div class="menuItem">
-<a href="../index.html">Introduction</a>
-</div>
-
-<div class="menuItem">
-<a href="../news.html">News</a>
-</div>
-
-<div class="menuItem">
-<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">FAQ/Wiki</a>
-</div>
-
-<div class="menu">
-<span class="menuLabel">Get Involved</span>
-
-<div class="menuItem">
-<a href="../overview.html">Overview</a>
-</div>
-
-<div class="menuItem">
-<a href="../cvs.html">CVS Repository</a>
-</div>
-
-<div class="menuItem">
-<a href="../mail.html">Mailing Lists</a>
-</div>
-
-<div class="menuItem">
-<a href="../ref.html">Reference Library</a>
-</div>
-
-<div class="menuItem">
-<a href="../bugs.html">Bugs</a>
-</div>
-
-</div>
-
-<div class="menu">
-<span class="menuLabel">Axis (Java)</span>
-
-<div class="menuItem">
-<a href="../java/index.html">Documentation</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/install.html">Installation</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/user-guide.html">User's Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/developers-guide.html">Developer's Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/integration-guide.html">Integration Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/architecture-guide.html">Architecture Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/reference.html">Reference Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/reading.html">Reading Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/requirements.html">Requirements</a>
-</div>
-
-</div>
-
-<div class="menu">
-<span class="menuLabel">Axis (C++)</span>
-
-<div class="menuItem">
-<a href="../cpp/index.html">Axis C++ alpha released!</a>
-</div>
-
-<div class="menuItem">
-<a href="../cpp/documentation.html">Documenation</a>
-</div>
-
-<div class="menuItem">
-<a href="../cpp/download.html">Download</a>
-</div>
-
-<div class="menuItem">
-<a href="../cpp/who.html">Who we are</a>
-</div>
-
-</div>
+<table id="main" width="100%" cellpadding="8" cellspacing="0" summary=""
+border="0">
+ <tbody>
+ <tr valign="top">
+ <!--================= start Menu ==================-->
+ <td id="leftcol">
+ <div id="navcolumn">
-<div class="menu">
-<span class="menuLabel">Downloads</span>
-
-<div class="menuItem">
-<a href="../releases.html">Releases</a>
-</div>
-
-<div class="menuItem">
-<a href="../interim.html">Interim Drops</a>
-</div>
-
-<div class="menuItem">
-<a href="http://cvs.apache.org/viewcvs/ws-axis/">Source Code</a>
-</div>
+ <div class="menuBar">
-</div>
+ <div class="menu">
+ <span class="menuLabel">Axis</span>
-<div class="menu">
-<span class="menuLabel">Related Projects</span>
-
-<div class="menuItem">
-<a href="http://ws.apache.org/wsif/">WSIF</a>
-</div>
-
-<div class="menuItem">
-<a href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL</a>
-</div>
-
-<div class="menuItem">
-<a href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J</a>
-</div>
-
-<div class="menuItem">
-<a href="http://www.uddi4j.org/">UDDI4J</a>
-</div>
+ <div class="menuItem">
+ <a href="../index.html">Introduction</a></div>
-</div>
+ <div class="menuItem">
+ <a href="../news.html">News</a></div>
-<div class="menu">
-<span class="menuLabel">Misc</span>
-
-<div class="menuItem">
-<a href="../site.html">Whole Site</a>
-</div>
-
-<div class="menuItem">
-<a href="../who.html">Who We Are</a>
-</div>
-
-<div class="menuItem">
-<a href="../contact.html">Contact</a>
-</div>
-
-<div class="menuItem">
-<a href="../legal.html">Legal</a>
-</div>
+ <div class="menuItem">
+ <a
+ href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">FAQ/Wiki</a></div>
-
-<div class="menuItem">
-<a href="../docs.html">Notes/Docs</a>
-</div>
+ <div class="menu">
+ <span class="menuLabel">Get Involved</span>
-</div>
+ <div class="menuItem">
+ <a href="../overview.html">Overview</a></div>
+ <div class="menuItem">
+ <a href="../cvs.html">CVS Repository</a></div>
-</div>
-</div>
-</div>
-</td>
-<!--================= end Menu ==================-->
-<!--================= start Content ==================--><td>
-<div id="bodycol">
-<div class="app">
-<div align="center">
-<h1></h1>
-</div>
-<div class="h3">
-<div class="h3">
-<h3>Windows Installation guide for Axis C++ (Alpha Release)</h3>
-</div>
-<p>This document contains how to use the binary distribution of Axis C++. These binaries have been tested on following Microsoft platforms,<br>Windows 2000 Professional<br>Windows XP 2002 Professional</p>
-<div class="h3">
-<h3>Contents</h3>
-</div>
-<a href="#dist">What binary distribution contains</a>
-<br>
-<a href="#apache">Installation with Apache 1.3.x/2.x web servers</a>
-<br>
-<a href="#simpleaxis">Installation with Simple Axis Server</a>
-<br>
-<a href="#samples">Running provided samples</a>
-<br>
-<a href="#playsamples">Using Visual C++ to play with provided samples.</a>
-<br>
-<a href="#writews">Writing your web services and client applications using Axis C++.</a>
-<br>
-<p>
-<a name="dist"></a>
-</p>
-<div class="h3">
-<h3>What binary distribution contains</h3>
-</div>
-<p>1. There is a folder called "binary".<br>
-<br>2. In side this there are several folders named as follows,<br>-> bin<br>-> deploy<br>-> docs<br>-> include<br>-> lib<br>-> samples<br>
-<br>3. The folder "bin" contains following executables and dll's<br>Executables<br>-> AdminClient.exe (soap client to Deploy or Undeploy a web service)<br>-> base.exe (soap client for Interop base tests)<br>-> groupB.exe (soap client for Interop groupB tests)<br>-> wcg.exe (wrapper class generation tool)<br>-> SimpleAxisServer.exe (axis with a simple http server)<br>
-<br>DLL's<br>-> mod_axis.dll (axis module for apache 1.3.x http server)<br>-> mod_axis2.dll (axis module for apache 2.X http server)<br>
-<br>4. In side the "deploy" folder follwing sub folders are exists<br>-> conf - This includes the server.wsdd, which contains service names and methods.<br>-> handlers - This includes following DLL's,<br>- loghandler.dll(sample handler for logging number of requests)<br>- testhandler1.dll(sample global handler)<br>- testhandler2.dll(sample transport handler)<br>
-<br>-> libs - Contains following dll which are needed by axis.<br>- xerces-c_2_2_0.dll<br>
-<br>-> logs - Log file used by loghandler handler<br>- LogAccessCountFile<br>
-<br>-> webservices -<br>- interopbase.dll (interop base test web service)<br>- interopGroupB.dll (interop groupb test web service)<br>- webservicedeployer.dll (web service for deploying web services in axis)<br>
-<br>-> wsdl - Contains the wsdl files used for interop testing.<br>- InteropBase<br>- InteropGroupB<br>5. The "include" folder contains all the include files which are necessary for this binary to work.<br>6. "lib" folder contains all the lib files for xercess-c and axisjava.<br>7. "samples" folder contains all the server and client samples for interop tests.</p>
-<p>
-<a name="apache"></a>
-</p>
-<div class="h3">
-<h3>Installation with Apache 1.3.X/2.X web server</h3>
-</div>
-<p>STEPS:</p>
-<p>1. Install the apache web server and locate the installation folder.<br>(For the defalt installation this is "C:\Program Files\Apache Group\Apache" for apache 1.3.X and "C:\Program Files\Apache Group\Apache2" for apache 2.X). Let say this folder to be APACHE_FOLDER.</p>
-<p>2. Unzip axis-c-alpha-win32.zip to a folder of your choice. Say this folder AXIS_EXTRACT.</p>
-<p>3. Inside the extracted folder AXIS_EXTRACT you have a sub folder called deploy. Copy whole deploy folder to APACHE_FOLDER.</p>
-<p>4. Rename copied "deploy" folder to "Axis". Lets say this folder to be AXIS_FOLDER.</p>
-<p>5. Set environment variable AXIS_HOME to point to above folder.</p>
-<p>6. Add AXIS_FOLDER/libs to the PATH environment variable.</p>
-<p>7. Edit Apache configuration file httpd.conf located in APACHE_FOLDER/conf and add following lines at the end.<br>
-<br>LoadModule axis_module modules/AXISMODULE<br><Location /axis><br>SetHandler axis<br></Location><br>
-<br>Where AXISMODULE is either mod_axis.dll for apache 1.3.X or mod_axis2.dll for apache 2.X.<br>
-<br>8. Copy AXISMODULE from the AXIS_EXTRACT/bin folder to APACHE_FOLDER/modules folder.</p>
-<p>9. Restart apache web server. If you have done correctly apache server should start without giving any error.</p>
-<p>apache 1.3.X :<br>It is recommended that apache 1.3.X be started as "apache -k start" on the command line<br>apache 2.X<br>While testing the apache 2 module a problem was noted with the apache 2 web server, in that the webserver takes up about 98% of CPU time and the server does not even serve the startup page. The workaround for this is to start the apache web server as "apache -X" to make it run single threaded. While this is sufficient to test the apache 2 module this problem needs to be investigated further.</p>
-<p>10. Open a internet browser and check http://localhost/axis. If the module has loaded properly then you should get the axis welcome page with a listing of deployed web services.</p>
-<p>
-<a name="simpleaxis"></a>
-</p>
-<div class="h3">
-<h3>Installation with Simple Axis Server</h3>
-</div>
-<p>
-<strong>(For the Alpha release we recommend installing Axis with the Apache web server. The simple Axis Server is still under development and presented here for testing purposes.)</strong>
-</p>
-<br>
-<p>STEPS:</p>
-<p>1. Create a folder of your choice. We will call this folder as SIMPLE_AXIS_SERVER_FOLDER.</p>
-<p>2. Unzip axis-c-alpha-win32.zip to a folder of your choice. Say this folder AXIS_EXTRACT.</p>
-<p>3. Inside the extracted folder AXIS_EXTRACT you have a sub folder called deploy. Copy whole deploy folder to SIMPLE_AXIS_SERVER_FOLDER.</p>
-<p>4. Rename copied "deploy" folder to "Axis". Lets say this folder to be AXIS_FOLDER.</p>
-<p>5. Set environment variable AXIS_HOME to point to above folder.</p>
-<p>6. Copy the exe SimpleAxisServer.exe from AXIS_EXTRACT/bin to the SIMPLE_AXIS_SERVER_FOLDER.</p>
-<p>7. Copy the content of AXIS_FOLDER/libs to the SIMPLE_AXIS_SERVER_FOLDER.</p>
-<p>8. Start the SimpleAxisServer by providing the port to which operate. (eg: c:\SimpleAxisServer>SimpleAxisServer 80)</p>
-<p>
-<a name="samples"></a>
-</p>
-<div class="h3">
-<h3>Running provided samples</h3>
-</div>
-<p>If Axis installation is a complete success, following sample web services and handlers have already been installed successfully.</p>
-<p>1. InteropBase service</p>
-<p> 2. InteropGroupB service</p>
-<p>You can run the provided client programs to confirm whether they are working fine. The two corresponding client applications are located in your AXIS_EXTRACT/bin as base.exe and groupB.exe. To run this sample client applications you need to have the path to xerces-c_2_2_0.dll in the "DLLPATH" environment variable or xerces-c_2_2_0.dll should be placed where the apache.exe is. Note: These sample clients are compiled with assumption that server is running at localhost port 80.</p>
-<p>
-<a name="playsamples"></a>
-</p>
-<div class="h3">
-<h3>Using Visual C++ to play with provided samples.</h3>
-</div>
-<p>In your AXIS_EXTRACT/samples folder you have the samples. If you are using Visual C++ you can open the workspace file AXIS_EXTRACT/samples/projects/vc6/interoptests/interoptests.dsw. There are four projects in the workspace. Out of them "base" and "GroupB" are client applications and other two are web services.</p>
-<p>
-<a name="writews"></a>
-</p>
-<div class="h3">
-<h3>Writing your web services and client applications using Axis C++.</h3>
-</div>
-<p>For writing your own web services and client applications see the <a href="winuser-guide.html">windows user guide</a>.</p>
-<div id="pdf" align="right">
-<a href="wininstall-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
- PDF</a>
-</div>
-</div>
-</div>
-</div>
-</td>
-<!--================= end Content ==================-->
-</tr>
-</tbody>
+ <div class="menuItem">
+ <a href="../mail.html">Mailing Lists</a></div>
+
+ <div class="menuItem">
+ <a href="../ref.html">Reference Library</a></div>
+
+ <div class="menuItem">
+ <a href="../bugs.html">Bugs</a></div>
+ </div>
+
+ <div class="menu">
+ <span class="menuLabel">Axis (Java)</span>
+
+ <div class="menuItem">
+ <a href="../java/index.html">Documentation</a></div>
+
+ <div class="menuItem">
+ <a href="../java/install.html">Installation</a></div>
+
+ <div class="menuItem">
+ <a href="../java/user-guide.html">User's Guide</a></div>
+
+ <div class="menuItem">
+ <a href="../java/developers-guide.html">Developer's Guide</a></div>
+
+ <div class="menuItem">
+ <a href="../java/integration-guide.html">Integration Guide</a></div>
+
+ <div class="menuItem">
+ <a href="../java/architecture-guide.html">Architecture Guide</a></div>
+
+ <div class="menuItem">
+ <a href="../java/reference.html">Reference Guide</a></div>
+
+ <div class="menuItem">
+ <a href="../java/reading.html">Reading Guide</a></div>
+
+ <div class="menuItem">
+ <a href="../java/requirements.html">Requirements</a></div>
+ </div>
+
+ <div class="menu">
+ <span class="menuLabel">Axis (C++)</span>
+
+ <div class="menuItem">
+ <a href="../cpp/index.html">Axis C++ alpha released!</a></div>
+
+ <div class="menuItem">
+ <a href="../cpp/documentation.html">Documenation</a></div>
+
+ <div class="menuItem">
+ <a href="../cpp/download.html">Download</a></div>
+
+ <div class="menuItem">
+ <a href="../cpp/who.html">Who we are</a></div>
+ </div>
+
+ <div class="menu">
+ <span class="menuLabel">Downloads</span>
+
+ <div class="menuItem">
+ <a href="../releases.html">Releases</a></div>
+
+ <div class="menuItem">
+ <a href="../interim.html">Interim Drops</a></div>
+
+ <div class="menuItem">
+ <a href="http://cvs.apache.org/viewcvs/ws-axis/">Source Code</a></div>
+ </div>
+
+ <div class="menu">
+ <span class="menuLabel">Related Projects</span>
+
+ <div class="menuItem">
+ <a href="http://ws.apache.org/wsif/">WSIF</a></div>
+
+ <div class="menuItem">
+ <a
+ href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL</a></div>
+
+ <div class="menuItem">
+ <a
+ href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J</a></div>
+
+ <div class="menuItem">
+ <a href="http://www.uddi4j.org/">UDDI4J</a></div>
+ </div>
+
+ <div class="menu">
+ <span class="menuLabel">Misc</span>
+
+ <div class="menuItem">
+ <a href="../site.html">Whole Site</a></div>
+
+ <div class="menuItem">
+ <a href="../who.html">Who We Are</a></div>
+
+ <div class="menuItem">
+ <a href="../contact.html">Contact</a></div>
+
+ <div class="menuItem">
+ <a href="../legal.html">Legal</a></div>
+
+ <div class="menuItem">
+ <a href="../docs.html">Notes/Docs</a></div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <!--================= end Menu ==================-->
+ <!--================= start Content ==================-->
+ <td>
+ <div id="bodycol">
+
+ <div class="app">
+
+ <div align="center">
+ <h1></h1>
+ </div>
+
+ <div class="h3">
+
+ <div class="h3">
+ <h3>Windows Installation guide for Axis C++ (Alpha Release)</h3>
+ </div>
+
+ <p>This document contains how to use the binary distribution of Axis
+ C++. These binaries have been tested on following Microsoft
+ platforms,<br>
+ Windows 2000 Professional<br>
+ Windows XP 2002 Professional</p>
+
+ <div class="h3">
+ <h3>Contents</h3>
+ </div>
+ <a href="#dist">What binary distribution contains</a> <br>
+ <a href="#apache">Installation with Apache 1.3.x/2.x web servers</a>
+ <br>
+ <a href="#simpleaxis">Installation with Simple Axis Server</a> <br>
+ <a href="#samples">Running provided samples</a> <br>
+ <a href="#playsamples">Using Visual C++ to play with provided
+ samples.</a> <br>
+ <a href="#writews">Writing your web services and client applications
+ using Axis C++.</a> <br>
+
+
+ <p><a name="dist"></a></p>
+
+ <div class="h3">
+ <h3>What binary distribution contains</h3>
+ </div>
+
+ <p>1. There is a folder called "binary".<br>
+ <br>
+ 2. In side this there are several folders named as follows,<br>
+ -> bin<br>
+ -> deploy<br>
+ -> docs<br>
+ -> include<br>
+ -> lib<br>
+ -> samples<br>
+ <br>
+ 3. The folder "bin" contains following executables and dll's<br>
+ Executables<br>
+ -> AdminClient.exe (soap client to Deploy or Undeploy a web
+ service)<br>
+ -> base.exe (soap client for Interop base tests)<br>
+ -> groupB.exe (soap client for Interop groupB tests)<br>
+ -> wcg.exe (wrapper class generation tool)<br>
+ -> SimpleAxisServer.exe (axis with a simple http server)<br>
+ <br>
+ DLL's<br>
+ -> mod_axis.dll (axis module for apache 1.3.x http server)<br>
+ -> mod_axis2.dll (axis module for apache 2.X http server)<br>
+ <br>
+ 4. In side the "deploy" folder follwing sub folders are exists<br>
+ -> conf - This includes the server.wsdd, which contains service
+ names and methods.<br>
+ -> handlers - This includes following DLL's,<br>
+ - loghandler.dll(sample handler for logging number of requests)<br>
+ - testhandler1.dll(sample global handler)<br>
+ - testhandler2.dll(sample transport handler)<br>
+ <br>
+ -> libs - Contains following dll which are needed by axis.<br>
+ - xerces-c_2_2_0.dll<br>
+ <br>
+ -> logs - Log file used by loghandler handler<br>
+ - LogAccessCountFile<br>
+ <br>
+ -> webservices -<br>
+ - interopbase.dll (interop base test web service)<br>
+ - interopGroupB.dll (interop groupb test web service)<br>
+ - webservicedeployer.dll (web service for deploying web services in
+ axis)<br>
+ <br>
+ -> wsdl - Contains the wsdl files used for interop testing.<br>
+ - InteropBase<br>
+ - InteropGroupB<br>
+ 5. The "include" folder contains all the include files which are
+ necessary for this binary to work.<br>
+ 6. "lib" folder contains all the lib files for xercess-c and
+ axisjava.<br>
+ 7. "samples" folder contains all the server and client samples for
+ interop tests.</p>
+
+ <p><a name="apache"></a></p>
+
+ <div class="h3">
+ <h3>Installation with Apache 1.3.X/2.X web server</h3>
+ </div>
+
+ <p>STEPS:</p>
+
+ <p>1. Install the apache web server and locate the installation
+ folder.<br>
+ (For the defalt installation this is "C:\Program Files\Apache
+ Group\Apache" for apache 1.3.X and "C:\Program Files\Apache
+ Group\Apache2" for apache 2.X). Let say this folder to be
+ APACHE_FOLDER.</p>
+
+ <p>2. Unzip axis-c-alpha-win32.zip to a folder of your choice. Say
+ this folder AXIS_EXTRACT.</p>
+
+ <p>3. Inside the extracted folder AXIS_EXTRACT you have a sub folder
+ called deploy. Copy whole deploy folder to APACHE_FOLDER.</p>
+
+ <p>4. Rename copied "deploy" folder to "Axis". Lets say this folder
+ to be AXIS_FOLDER.</p>
+
+ <p>5. Set environment variable AXIS_HOME to point to above folder.</p>
+
+ <p>6. Add AXIS_FOLDER/libs to the PATH environment variable.</p>
+
+ <p>7. Edit Apache configuration file httpd.conf located in
+ APACHE_FOLDER/conf and add following lines at the end.<br>
+ <br>
+ LoadModule axis_module modules/AXISMODULE<br>
+ <Location /axis><br>
+ SetHandler axis<br>
+ </Location><br>
+ <br>
+ Where AXISMODULE is either mod_axis.dll for apache 1.3.X or
+ mod_axis2.dll for apache 2.X.<br>
+ <br>
+ 8. Copy AXISMODULE from the AXIS_EXTRACT/bin folder to
+ APACHE_FOLDER/modules folder.<br>
+ </p>
+
+ <p>9. Open the AXIS_FOLDER/axiscpp.conf for editing. The contents of
+ the file will look as follows.</p>
+
+ <p><br>
+ AXISLOGPATH:XXXX</p>
+
+ <p>WSDDFILEPATH:YYYY</p>
+
+ <p>Where XXXX will be the path to a file named AxisLog (The log
+ file)and YYYY will be the path to the server.wsdd file. Give the
+ appropriate values for XXXX and YYYY as follows.</p>
+
+ <p>i.e.</p>
+
+ <p>AXISLOGPATH: [APACHE_HOME]\Axis\logs\AxisLog</p>
+
+ <p>WSDDFILEPATH: [APACHE_HOME]\Axis\conf\server.wsdd</p>
+
+ <p>10. Restart apache web server. If you have done correctly apache
+ server should start without giving any error.</p>
+
+ <p>apache 1.3.X :<br>
+ It is recommended that apache 1.3.X be started as "apache -k start"
+ on the command line<br>
+ apache 2.X<br>
+ While testing the apache 2 module a problem was noted with the apache
+ 2 web server, in that the webserver takes up about 98% of CPU time
+ and the server does not even serve the startup page. The workaround
+ for this is to start the apache web server as "apache -X" to make it
+ run single threaded. While this is sufficient to test the apache 2
+ module this problem needs to be investigated further.</p>
+
+ <p>10. Open a internet browser and check http://localhost/axis. If
+ the module has loaded properly then you should get the axis welcome
+ page with a listing of deployed web services.</p>
+
+ <p><a name="simpleaxis"></a></p>
+
+ <div class="h3">
+ <h3>Installation with Simple Axis Server</h3>
+ </div>
+
+ <p><strong>(For the Alpha release we recommend installing Axis with
+ the Apache web server. The simple Axis Server is still under
+ development and presented here for testing purposes.)</strong></p>
+ <br>
+
+
+ <p>STEPS:</p>
+
+ <p>1. Create a folder of your choice. We will call this folder as
+ SIMPLE_AXIS_SERVER_FOLDER.</p>
+
+ <p>2. Unzip axis-c-alpha-win32.zip to a folder of your choice. Say
+ this folder AXIS_EXTRACT.</p>
+
+ <p>3. Inside the extracted folder AXIS_EXTRACT you have a sub folder
+ called deploy. Copy whole deploy folder to
+ SIMPLE_AXIS_SERVER_FOLDER.</p>
+
+ <p>4. Rename copied "deploy" folder to "Axis". Lets say this folder
+ to be AXIS_FOLDER.</p>
+
+ <p>5. Set environment variable AXIS_HOME to point to above folder.</p>
+
+ <p>6. Copy the exe SimpleAxisServer.exe from AXIS_EXTRACT/bin to the
+ SIMPLE_AXIS_SERVER_FOLDER.</p>
+
+ <p>7. Copy the content of AXIS_FOLDER/libs to the
+ SIMPLE_AXIS_SERVER_FOLDER.</p>
+
+ <p>8. Start the SimpleAxisServer by providing the port to which
+ operate. (eg: c:\SimpleAxisServer>SimpleAxisServer 80)</p>
+
+ <p><a name="samples"></a></p>
+
+ <div class="h3">
+ <h3>Running provided samples</h3>
+ </div>
+
+ <p>If Axis installation is a complete success, following sample web
+ services and handlers have already been installed successfully.</p>
+
+ <p>1. InteropBase service</p>
+
+ <p> 2. InteropGroupB service</p>
+
+ <p>You can run the provided client programs to confirm whether they
+ are working fine. The two corresponding client applications are
+ located in your AXIS_EXTRACT/bin as base.exe and groupB.exe. To run
+ this sample client applications you need to have the path to
+ xerces-c_2_2_0.dll in the "DLLPATH" environment variable or
+ xerces-c_2_2_0.dll should be placed where the apache.exe is. Note:
+ These sample clients are compiled with assumption that server is
+ running at localhost port 80.</p>
+
+ <p><a name="playsamples"></a></p>
+
+ <div class="h3">
+ <h3>Using Visual C++ to play with provided samples.</h3>
+ </div>
+
+ <p>In your AXIS_EXTRACT/samples folder you have the samples. If you
+ are using Visual C++ you can open the workspace file
+ AXIS_EXTRACT/samples/projects/vc6/interoptests/interoptests.dsw.
+ There are four projects in the workspace. Out of them "base" and
+ "GroupB" are client applications and other two are web services.</p>
+
+ <p><a name="writews"></a></p>
+
+ <div class="h3">
+ <h3>Writing your web services and client applications using Axis
+ C++.</h3>
+ </div>
+
+ <p>For writing your own web services and client applications see the
+ <a href="winuser-guide.html">windows user guide</a>.</p>
+
+ <div id="pdf" align="right">
+ <a href="wininstall-guide.pdf"><img alt="PDF"
+ src="../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a></div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <!--================= end Content ==================-->
+ </tr>
+ </tbody>
</table>
<!--================= end Main ==================-->
<!--================= start Footer ==================-->
+
<div id="footer">
-<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
-<tbody>
-<tr>
-<!--================= start Copyright ==================-->
-<td colspan="2">
-<div align="center">
-<div class="copyright">
- Copyright © 2000-2003 The Apache Software Foundation. All rights reserved.
- </div>
-</div>
-</td>
-<!--================= end Copyright ==================-->
-</tr>
-<tr>
-<td align="left">
-<!--================= start Host ==================-->
-<!--================= end Host ==================--></td><td align="right">
-<!--================= start Credits ==================-->
-<div align="right">
-<div class="credit"></div>
-</div>
-<!--================= end Credits ==================-->
-</td>
-</tr>
-</tbody>
+
+<table summary="footer" cellspacing="0" cellpadding="4" width="100%"
+border="0">
+ <tbody>
+ <tr>
+ <!--================= start Copyright ==================-->
+ <td colspan="2">
+ <div align="center">
+
+ <div class="copyright">
+ Copyright © 2000-2003 The Apache Software Foundation. All
+ rights reserved. </div>
+ </div>
+ </td>
+ <!--================= end Copyright ==================-->
+ </tr>
+ <tr>
+ <td align="left"><!--================= start Host ==================-->
+ <!--================= end Host ==================-->
+ </td>
+ <td align="right"><!--================= start Credits ==================-->
+
+ <div align="right">
+
+ <div class="credit">
+ </div>
+ </div>
+ <!--================= end Credits ==================-->
+ </td>
+ </tr>
+ </tbody>
</table>
</div>
<!--================= end Footer ==================-->