Apache | WS |
Axis C++ Installation GuideAxis C++ Installation and Configuration GuideIntroductionThis guide will help you to start with Axis C++. This guide will explain the minimum steps needed to install Axis C++ in both a client and a server environment. ContentsPre-requisitesClient and server
Xerces C++ (2.2.0) XML parser Server only
Apache web server (2.0.x or 1.3.x) - If you are going to deploy services to Apache web server (and not simple_axis_server ) then you need to have Apache built with module .so support. Installing and Configuring Axis C++Client Installation and Configuration1. Download Axis C++Download Axis C++ binary distribution and extract the package into a directory of your choice. 2. Install Xerces C++ (2.2.0)See the Xerces parser's documentation for installation instructions. 3. Configure environment variablesAXISCPP_DEPLOY="/usr/local/axiscpp_deploy"set LIBRARY_PATHS The library path needs to have the xml parser libraries and the axis libraries included. Linux: 4. Set Engine Wide Settings in Configuration FileAxis C++ uses a configuration file to let the user specify preferences such as log file locations, transport and parser libs to be used and location of deployment descriptor files. The comment character is '#' A sample axiscpp.conf file for a client (linux) Transport_http:/usr/local/axiscpp_deploy/lib/libhttp_transport.so Channel_HTTP:/usr/local/axiscpp_deploy/lib/libhttp_channel.so XMLParser:/usr/local/axiscpp_deploy/lib/libaxis_xerces.so ClientWSDDFilePath:/usr/local/axiscpp_deploy/etc/client.wsdd ClientLogPath:/usr/local/axiscpp_deploy/log/AxisClientLog
Server Installation and Configuration1. Download Axis C++Download Axis C++ binary distribution and extract the package into a directory of your choice. 2. Install Apache Web ServerIf you are going to deploy services to Apache and not use the simple_axis_server then you need to install apache webserver. In case you have already installed Apache , make sure that 'so modules' are enabled. 3. Install Xerces C++ (2.2.0)See the Xerces parser's documentation for installation instructions. 4. Configure environment variablesThe Axis server runtime requires the same variables to be set as the Axis client engine does.
set AXISCPP_DEPLOYAXISCPP_DEPLOY="Path to the folder where you installed Axis C++" The library path needs to have the xml parser libraries and the axis libraries included. Windows:PATH=<xerces installation path>/bin;%AXISCPP_DEPLOY/bin%;%PATH% Linux:LD_LIBRARY_PATH="<xerces installation path>/lib:$AXISCPP_DEPLOY/lib:$LD_LIBRARY_PATH" 5. Configure Engine Wide Settings in Configuration File
As with the client-side the Axis C++ server-side engine uses a configuration file to let the user specify preferences such as log file locations, transport and parser libs to be used and location of deployment descriptor files.
The comment character is '#' A sample server axiscpp.conf file (Linux): WSDDFilePath:/usr/local/axiscpp_deploy/etc/server.wsdd LogPath:/usr/local/axiscpp_deploy/log/AxisLog XMLParser:/usr/local/axiscpp_deploy/lib/libaxis_xercesc.so Transport_http:/usr/local/axiscpp_deploy/lib/libaxis3_transport.so Channel_HTTP:/usr/local/axiscpp_deploy/lib/libaxis3_transport_channel.so 6. Setting Axis files to be executableOn non-windows platforms you need to ensure global access rights to the Axis C++ deploy folder to make sure that Axis C++ works properly. 7. Configure Apache Module
Note: to execute the following steps, you may need to have administrator rights on your machine. 8. Deploying Axis Module to Apache Web ServerNow we need to copy Apache module (libaxiscpp_mod2.so - linux names- for Apache 2.0.x and libaxiscpp_mod.so for Apache 1.3.x) to the correct places and start Apache web server. The steps to follow are:
To do the same you can you can use scripts in $AXISCPP_DEPLOY/bin. cd $AXISCPP_DEPLOY/binTo deploy with Apache 2.0.x sh deploy_apache2.shTo deploy with Apache 1.3.x sh deploy_apache.sh9. See Axis C++ in actionNow the installation is complete. You can verify that the server side is working by accessing the URL http://localhost/axis using your web browser. You should get the Axis C++ welcome page and this page will show you a list of deployed services as specified by the <Axis Installation directory>/conf/server.wsdd file. Although at this stage you won't have any services deployed yet. Now you can run a client sample and see if it works. Simple Axis Server installation and configuration1. Make sure that you have set the AXISCPP_DEPLOY environment variable to point to your deployment folder as mentioned above 2. Create your axiscpp.conf file as above for the Apache server-side making sure that the contents of that file match your system settings 3. Run simple axis server in $AXISCPP_DEPLOY/bin
For Example (linux): cd $AXISCPP_DEPLOY/bin ./simple_axis_server 9090 5. Run clients in $AXISCPP_DEPLOY/bin On a different shell: cd $AXISCPP_DEPLOY/bin ./base http://localhost:9090/axis/base Similarly you could run the other samples. |