axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dami...@apache.org
Subject cvs commit: ws-axis/c INSTALL
Date Thu, 10 Jun 2004 04:37:29 GMT
damitha     2004/06/09 21:37:29

  Modified:    c        INSTALL
  Log:
  
  
  Revision  Changes    Path
  1.4       +57 -56    ws-axis/c/INSTALL
  
  Index: INSTALL
  ===================================================================
  RCS file: /home/cvs/ws-axis/c/INSTALL,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- INSTALL	10 Jun 2004 03:37:46 -0000	1.3
  +++ INSTALL	10 Jun 2004 04:37:29 -0000	1.4
  @@ -1,21 +1,33 @@
  -How to build and use Axis C++ from cvs source.
  -=============================================
  +Introduction
  +============
   
   This guide will help you to start with Axis C++. I'll explain the minimum
   steps needed to build and run Axis C++, and warn you about the common 
   pitfalls.
  -The environment I'm using
  +
  +What you need
  +=============
   RedHat 9(2.4.20-8)
  -expat-1.95.7
  +expat-1.95.7(source)
   xerces-c-src2_2_0(I build xerces from source)
  -httpd-2.0.48
  -apache_1.3.27
  +httpd-2.0.48(source)
  +apache_1.3.27(source)
  +
  +Note: In my environment I have
  +autoconf 2.57, automake 1.6.3, libtool 1.4.3,  gcc 3.2.2 
  +
  +You can download the Axis C++ source or binary from one of the apache mirror sites 
  +    http://ws.apache.org/axis/cpp/download.html
  +
  +You can get expat from the uri http://sourceforge.net/projects/expat/
  +
  +You can get xercesc from the uri http://www.xml.apache.org/xerces-c/download.cgi
   
   You must define some environment variables in order to build.
   AXISCPP_HOME is where you checkout Axis C++
   
   ------------------------------------------------------------
  -AXISCPP_HOME="/home/damitha/projects/cvshead"
  +AXISCPP_HOME="/home/damitha/projects/axiscpp"
   AXIS_HOME="/home/damitha/Axis"
   EXPAT_HOME="/usr/local/expat1957"
   XERCESC_HOME="/usr/local/xerces-c"
  @@ -31,16 +43,6 @@
   EXPAT_HOME points to where you installed expat
   XERCESC_HOME points to where you installed xereces-c
   
  -In $AXIS_HOME/axiscpp.conf file you can give paths to
  -your log files, configuration files libraries etc.
  --------------------------------------------------------------
  -AXISLOGPATH:/usr/local/Axis/logs/AxisLog    #Server side log file
  -WSDDFILEPATH:/usr/local/Axis/conf/server.wsdd    #Server side service deployment descriptor
  -AXISCLIENTLOGPATH:/usr/local/Axis/logs/AxisClientLog    #Client log file
  -AXISXMLPARSER:/usr/local/Axis/libs/libaxis_xmlparser.so    #Path to xml parser library
  -AXISTRANSPORT_HTTP:/usr/local/Axis/libs/libaxis_transport.so    #Path to transport library
  -------------------------------------------------------------
  -
   Axis C++ core is independant of the parser layer and transport layer.
   You can write your own transport or parser library according to the APIs provided. Currently
Axis C++
   provides API implementations for Xerces-c and Expat. It also provides it's own client side
transport
  @@ -135,18 +137,7 @@
   cd $AXISCPP_HOME
   sh build.sh
   
  -ls $AXISCPP_HOME/bin
  -adminclient               libaxiscpp_client.so.0.0.0  libaxis_expat.a             libaxis_xercesc.la
  -CVS                       libaxiscpp_mod2.a           libaxis_expat.la            libaxis_xercesc.so
  -libAdminService.a         libaxiscpp_mod2.la          libaxis_expat.so            libaxis_xercesc.so.0
  -libAdminService.la        libaxiscpp_mod2.so          libaxis_expat.so.0          libaxis_xercesc.so.0.0.0
  -libAdminService.so        libaxiscpp_mod2.so.0        libaxis_expat.so.0.0.0      libserver_engine.a
  -libAdminService.so.0      libaxiscpp_mod2.so.0.0.0    libaxis_transport.a         libserver_engine.la
  -libAdminService.so.0.0.0  libaxiscpp_mod.a            libaxis_transport.la        libserver_engine.so
  -libaxiscpp_client.a       libaxiscpp_mod.la           libaxis_transport.so        libserver_engine.so.0
  -libaxiscpp_client.la      libaxiscpp_mod.so           libaxis_transport.so.0      libserver_engine.so.0.0.0
  -libaxiscpp_client.so      libaxiscpp_mod.so.0         libaxis_transport.so.0.0.0  README.TXT
  -libaxiscpp_client.so.0    libaxiscpp_mod.so.0.0.0     libaxis_xercesc.a
  +You can see the folder $AXISCPP_HOME/bin to see what are created
   
   libaxis_mod.so is apache module which is loaded when apache loads
   libaxis_mod2.so is apache2 module which is loaded when apache2 loads
  @@ -158,43 +149,53 @@
   
   Also $AXISCPP_HOME/sampels/server samples are built and installed in
   $AXIS_HOME/web_services
  -ls $AXIS_HOME/
  -
  -libcalculator.so        libcgroupB.so           libdoclitgroupB.so         libgroupB.so
  -libAdminService.so    libcalculator.so.0      libcgroupB.so.0         libdoclitgroupB.so.0
      libgroupB.so.0
  -libAdminService.so.0  libcalculator.so.0.0.0  libcgroupB.so.0.0.0     libdoclitgroupB.so.0.0.0
  libgroupB.so.0.0.0
  -libbase.a             libcbase.a              libdoclitbase.a         libdoclitmathops.a
        libmathops.a
  -libbase.la            libcbase.la             libdoclitbase.la        libdoclitmathops.la
       libmathops.la
  -libbase.so            libcbase.so             libdoclitbase.so        libdoclitmathops.so
       libmathops.so
  -libbase.so.0          libcbase.so.0           libdoclitbase.so.0      libdoclitmathops.so.0
     libmathops.so.0
  -libbase.so.0.0.0      libcbase.so.0.0.0       libdoclitbase.so.0.0.0  libdoclitmathops.so.0.0.0
 libmathops.so.0.0.0
  -libcalculator.a       libcgroupB.a            libdoclitgroupB.a       libgroupB.a     
          README.txt
  -libcalculator.la      libcgroupB.la           libdoclitgroupB.la      libgroupB.la
   
   $AXISCPP_HOME/samples/client samples are built and executable are in $AXISCPP_HOME/samples/client
   
   parser and transport layer both is loaded in to axis engine when it is
   loaded by apache.
   
  -So when you run the following script from $AXIS_HOME(eg:/usr/local/Axis)
  +Now you need to add to $<apache install directory>/conf/httpd.conf
  +$ vi <apache install directory>/conf/httpd.conf
  +
  +At the bottom of the file you have to include following lines and save it.
  +-------------------------------------------------
  +LoadModule axis_module modules/libaxiscpp_mod2.so (in apache1.3 replace modules with libexec
and libaxiscpp_mod2.so with libaxiscpp_mod.so)
  +
  +<Location /axis>
  +
  +SetHandler axis
  +
  +</Location> 
  +---------------------------------------------------
  +
  +Now you need the deployment descripter to deploy server samples you built
  +
  +cd $AXIS_HOME/conf
  +mv server.wsdd_linux server.wsdd
  +
  +In $AXIS_HOME/axiscpp.conf file you can give paths to
  +your log files, configuration files libraries etc.
  +------------------------------------------------------------------------------------------
  +AXISLOGPATH:/usr/local/Axis/logs/AxisLog    #Server side log file
  +WSDDFILEPATH:/usr/local/Axis/conf/server.wsdd    #Server side service deployment descriptor
  +AXISCLIENTLOGPATH:/usr/local/Axis/logs/AxisClientLog    #Client log file
  +AXISXMLPARSER:/usr/local/Axis/libs/libaxis_xmlparser.so    #Path to xml parser library
  +AXISTRANSPORT_HTTP:/usr/local/Axis/libs/libaxis_transport.so    #Path to transport library
  +-----------------------------------------------------------------------------------------
  +Now we need to copy neccessary libraries to the correct places and start apache. To
  +do that you can find scripts written in $AXIS_HOME.
  +cd $AXIS_HOME
  +
  +To deploy on apache2
  +sh deploy_apache2.sh
   
  -rm /usr/local/apache/libexec/libaxiscpp_mod.so
  -rm webservices/libAdminService.so
  -rm libs/libserver_engine.so
  -rm libs/libaxis_transport.so
  -rm libs/libaxis_xmlparser.so
  -cp -f $AXISCPP_HOME/bin/libAdminService.so webservices/
  -cp -f $AXISCPP_HOME/bin/libserver_engine.so libs/
  -cp -f $AXISCPP_HOME/bin/libaxiscpp_mod.so /usr/local/apache/libexec/ cp -f
  -$AXISCPP_HOME/bin/libaxis_transport.so libs/
  -cp -f $AXISCPP_HOME/bin/libaxis_expat.so libs/libaxis_xmlparser.so
  -/usr/local/apache/bin/apachectl stop
  -sleep 2
  -/usr/local/apache/bin/apachectl start
  +To deploy on apache
  +sh deploy_apache.sh
   
   all the libraries are loaded.
   
  -Note that in the line no. 10 of the script above we change
  +Note that in the line no. 12 of the script above we change
   the name libaxis_expat.so to libaxis_xmlparser.so.
   If we use xerces we need to change
   libaxis_xercesc.so to libaxis_xmlparser.so.
  
  
  

Mime
View raw message