axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From din...@apache.org
Subject svn commit: r452399 - in /webservices/axis2/trunk/c: INSTALL NEWS xdocs/docs/installationguide.html
Date Tue, 03 Oct 2006 10:15:50 GMT
Author: dinesh
Date: Tue Oct  3 03:15:46 2006
New Revision: 452399

URL: http://svn.apache.org/viewvc?view=rev&rev=452399
Log:
0.94 documantation update patch sent by dumindu

Modified:
    webservices/axis2/trunk/c/INSTALL
    webservices/axis2/trunk/c/NEWS
    webservices/axis2/trunk/c/xdocs/docs/installationguide.html

Modified: webservices/axis2/trunk/c/INSTALL
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/c/INSTALL?view=diff&rev=452399&r1=452398&r2=452399
==============================================================================
--- webservices/axis2/trunk/c/INSTALL (original)
+++ webservices/axis2/trunk/c/INSTALL Tue Oct  3 03:15:46 2006
@@ -1,7 +1,10 @@
 The release comes in two forms, source and binary. 
 
-To get both the binary and source distribution, you need libxml2 from http://xmlsoft.org/downloads.html
-(NOTE: most Linux systems have libxml2 by default. On Windows you need to download and install
libxml2)
+To get both the binary and source distributions working, you need libxml2 from
+http://xmlsoft.org/downloads.html
+
+NOTE: Most Linux systems have libxml2 installed by default. On Windows you need
+      to download and install libxml2.
 
 Table of Contents
 =================
@@ -9,38 +12,43 @@
 1. Getting Axis2C working with the binary release on Linux
 2. Getting Axis2C working with the source release on Linux
 3. Getting Axis2C working with the binary release on Windows (win32)
-	3.1 Requirements
-	3.2 Binaries in the release
-	3.3 Running the binaries
-4. Getting Axis2c working with the source release on Windows (win32)
-	4.1 Requirements
-	4.2 Editing Configure.in file
-	4.3 Compiling the source
-	4.4 Running the binaries
+    3.1 Requirements
+    3.2 Binaries in the release
+    3.3 Running the binaries
+4. Getting Axis2C working with the source release on Windows (win32)
+    4.1 Requirements
+    4.2 Editing Configure.in file
+    4.3 Compiling the source
+    4.4 Running the binaries
 5. Installing Apache2 Web Server integration module (mod_axis2)
-	
+    
 
 1. Getting Axis2C working with the binary release on Linux.
 ==========================================================
 
-1. Extract the binary tar package to a folder. 
-   Set AXIS2C_HOME environment variable pointing to the location where you have extracted
Axis2C
+1. Extract the binary tar package to a directory.
+
+2. Set AXIS2C_HOME environment variable pointing to the location where you have
+   extracted Axis2C
         AXIS2C_HOME='/your_path_to_axis2c'
         export AXIS2C_HOME
-   Note: You will need to set AXIS2C_HOME only if you need to run axis2c samples or tests.
The
-   reason is that the samples and test codes use AXIS2C_HOME to get the path to axis2c. To
write
-   your own services or clients this is not a requirement.
 
-2. Run the simple axis server:
+   NOTE: You will need to set AXIS2C_HOME only if you need to run Axis2C samples
+         or tests. The reason is that the samples and test codes use AXIS2C_HOME
+         to get the path to Axis2C. To write your own services or clients this is
+         not a requirement.
+
+3. Run the simple axis server:
         cd /your_path_to_axis2c/bin
         ./axis2_http_server
-   This will start the simple axis server on port 9090. To see the possible command line
options run
+   This will start the simple axis server on port 9090. To see the possible
+   command line options run
         ./axis2_http_server -h
 
    NOTE: If you run into shared lib problems, set the LD_LIBRARY_PATH
         export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib
 
-3. Run the sample clients in a new shell
+4. Run the sample clients in a new shell
         cd /your_path_to_axis2c/bin/samples
         ./echo
    This will invoke the echo service.
@@ -48,7 +56,8 @@
         ./math
    This will invoke the math service.
 
-   To see the possible command line options for sample clients run them with '-h' option
+   To see the possible command line options for sample clients run them with
+   '-h' option
 
    NOTE: If you run into shared lib problems, set the LD_LIBRARY_PATH
         export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib
@@ -57,67 +66,88 @@
 2. Getting Axis2C working with the source release on Linux.
 ==========================================================
 
-1. Extract the source tar package to a folder. 
+1. Extract the source tar package to a directory
 
-2. Set AXIS2C_HOME environment variable pointing to the location where you want to install
Axis2C.
+2. Set AXIS2C_HOME environment variable pointing to the location where you want
+   to install Axis2C.
         AXIS2C_HOME='/your_desired_path_to_axis2c_installation'
         export AXIS2C_HOME
 
-   NOTE: If you run into shared lib problems, set the LD_LIBRARY_PATH
-        export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib
+   NOTE: You will need to set AXIS2C_HOME only if you need to run Axis2C samples
+         or tests. The reason is that the samples and test codes use AXIS2C_HOME
+         to get the path to Axis2C. To write your own services or clients this is
+         not a requirement.
 
-3. Then go to the folder where you extracted the source
+3. Go to the directory where you extracted the source
         cd /your_path_to_axis2c_source
 
 4. Build the source
-   This can be done by running the 'configure; make; make install' command sequence in the

-   AXIS2C_HOME directory 
+   This can be done by running the following command sequence in the directory
+   where you have extracted the source.
 
-    ./configure
-     make
-     make install
-        	
-   Please run './configure --help' in respective sub folders for more information on
-   these configure options. 
+        ./configure --prefix=${AXIS2C_HOME}
+        make
+        sudo make install
 
-   You may also need to set LD_LIBRARY_PATH to include the install locations.
+   Please run './configure --help' in respective sub folders for more information 
+   on these configure options. 
 
-   NOTE: If you don't provide a --prefix configure option, it will by default install into
-   ====  /usr/local/axis2c folder.
+   NOTE: If you don't provide the --prefix configure option, it will by default
+         be installed into "/usr/local/axis2c" directory.
 
+   You may need to try Axis2C with guththila xml parser. You can do it by giving
+   "--enable-guththila=yes" as a configure option.
+    
+        ./configure --enable-guththila=yes [other configuration options]
+        make
+        sudo make install
 
-    You may need to try Axis2c with guththila xml parser. You can do it by giving --enable-guththila=yes
-      ./configure --enable-guththila=yes [other configuration options]
+   If you need to build with rampart (axis2c security module), 
+	./configure --enable-rampart=yes [other configuration options]
 	make
-        make install
+	make install
+
+   NOTE : rampart has a dependancy with libssl-dev and openssl
 
    If you need to get the samples working, you also need to build the samples.
-   Please run './configure --help' in samples folder for more information on
-   configure options.
+   
    To build the samples:
+
+        export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/axis2c/lib/
         cd samples
-        ./configure --prefix=${AXIS2C_HOME}
+        ./configure --prefix=${AXIS2C_HOME} --with-axis2_util=${AXIS2C_HOME}/include 
+            --with-axiom=${AXIS2C_HOME}/include
         make
-        make install
+        sudo make install
+
+   Please run "./configure --help" in samples folder for more information on
+   configure options.
 
-5. Go to the folder where you installed axis2c.
+   NOTE: If you don't provide a --prefix configure option, samples will by default
+         be installed into "/usr/local/axis2c/samples" directory.
+
+5. Go to the folder where you installed Axis2C.
 
 6. Start simple axis server
-        cd axis2c/bin
+        cd ${AXIS2C_HOME}/bin
         ./axis2_http_server
 
-   This will start the simple axis server on port 9090. To see the possible command line
options run:
+   This will start the simple axis server on port 9090. To see the possible command
+   line options run:
         ./axis2_http_server -h
 
+   NOTE: You may need to be login as superuser to run the simple axis server.
+
 8. Run the sample clients in a new shell
-        cd bin/samples
+        cd ${AXIS2C_HOME}/bin/samples
         ./echo
    This will invoke the echo service.
 
         ./math
    This will invoke the math service.
 
-   To see the possible command line options for sample clients, run them with '-h' option.
+   To see the possible command line options for sample clients, run them with
+   '-h' option.
 
 
 3. Getting Axis2C working with the binary release on Windows.
@@ -126,30 +156,34 @@
 3.1 Requirements
 ----------------
 
-    * The binaries shipped with this version are compiled with Microsoft Visual Studio compiler
(cl) 
-    (Note: you can download Microsoft VS Express2005 Edition from Microsoft website and install
it to run these binaries)
+    * The binaries shipped with this version are compiled with Microsoft Visual
+      Studio compiler (cl) 
+
+    Note: You can download Microsoft VS Express2005 Edition from Microsoft 
+          website and install it to run these binaries
 
     * You also need the following dlls
-	    - libxml2.dll [http://www.xmlsoft.org - download the version >=  libxml2-2.6.20.win32]
-	    - iconv.dll [http://www.xmlsoft.org - download the version >= iconv-1.9.1.win32]
-	    - zlib1.dll [http://www.xmlsoft.org - download the version >= zlib-1.2.3.win32]
+        - libxml2.dll [http://www.xmlsoft.org - version >= libxml2-2.6.20.win32]
+        - iconv.dll [http://www.xmlsoft.org - version >= iconv-1.9.1.win32]
+        - zlib1.dll [http://www.xmlsoft.org - version >= zlib-1.2.3.win32]
 
 3.2 Binaries in the release
 ---------------------------
 
-    Extract the binary distribution to a folder of your choice. (example: C:\axis2c-M0.4)
+    Extract the binary distribution to a folder of your choice. 
+    (example: C:\axis2c-0.94)
 
-    The c:\axis2c-M0.4 folder structure is as follows.
+    The c:\axis2c-0.94 folder structure is as follows.
 
     axis2c-0.94
       |
-	  +- bin         - server and other executables
+      +- bin         - server and other executables
       |   |
       |   +- samples - samples go here
       |         |
       |         +...
       |
-      +- lib	     - library modules
+      +- lib         - library modules
       |
       +- services    - deployed services 
       |
@@ -160,12 +194,13 @@
       +- logs        - system and client logs are written to this folder
 
 
-    Copy the downloaded libxml2.dll, iconv.dll and zlib1.dll to C:\axis2c-M0.4\lib
+    Copy the downloaded libxml2.dll, iconv.dll and zlib1.dll to C:\axis2c-0.94\lib
 
 3.3 Running the binaries
 ------------------------
 
-    You need to set a couple of environment variables before you can run the server and samples.
+    You need to set a couple of environment variables before you can run the
+    server and samples.
 
     Set the variable AXIS2C_HOME to the deploy folder (C:\axis2c-0.94)
     Add the path to lib directory to the PATH variable (%AXIS2C_HOME%\lib)
@@ -177,12 +212,15 @@
     You should see the message:
         Started Simple Axis2 HTTP Server...
 
-    By default the log is created under %AXIS2C_HOME%\logs folder with the name axis2.log.
-    (Note: You may provide command line options to change the default behaviour. Type "axis2_http_server.exe
-h" to learn about the usage)
+    By default the log is created under %AXIS2C_HOME%\logs folder with the name
+    axis2.log.
+
+    NOTE: You may provide command line options to change the default behaviour.
+    Type "axis2_http_server.exe -h" to learn about the usage)
 
     Now you can run any sample client deployed under %AXIS2C_HOME%\bin\samples\
     Example:
-    C:\axis2c-M0.4\bin\samples>echo.exe
+    C:\axis2c-0.94\bin\samples>echo.exe
 
 
 4. Getting Axis2C working with the source release on Windows.
@@ -191,14 +229,17 @@
 4.1 Requirements
 ----------------
 
-    * The makefile shipped with this version needs Microsoft Visual Studio compiler (cl)
and nmake build tool 
-    (Note: You can download Microsoft VS Express2005 Edition and Platform SDK from Microsoft
website. You will
-    need to add the path to Platform SDK Include and Lib folders to the makefile)
+    * The makefile shipped with this version needs Microsoft Visual Studio 
+      compiler (cl) and nmake build tool 
+    
+    NOTE: You can download Microsoft VS Express2005 Edition and Platform SDK from
+          Microsoft website. You will need to add the path to Platform SDK Include
+          and Lib folders to the makefile.
 
     * You also need 
-	    - libxml2 [http://www.xmlsoft.org - download the version >=  libxml2-2.6.20.win32]
-	    - iconv [http://www.xmlsoft.org - download the version >= iconv-1.9.1.win32]
-	    - zlib [http://www.xmlsoft.org - download the version >= zlib-1.2.3.win32]
+        - libxml2 [http://www.xmlsoft.org - download the version >=  libxml2-2.6.20.win32]
+        - iconv [http://www.xmlsoft.org - download the version >= iconv-1.9.1.win32]
+        - zlib [http://www.xmlsoft.org - download the version >= zlib-1.2.3.win32]
 
 4.2 Editing configure.in file
 -----------------------------
@@ -207,16 +248,17 @@
 
     Example:
     Default location for libxml2 is C:\libxml2
-	    You can either extract libxml2 to this folder. Folder structure should look like the
following.
-	    C:\libxml2
+        You can either extract libxml2 to this folder. Folder structure should 
+        look like the following.
+        C:\libxml2
             |
-		    +- include
+            +- include
             |
-		    +- bin
+            +- bin
             |
-		    +- lib
+            +- lib
 
-	Or extract to whatever place of your choice and edit the configure.in accordingly.
+    Or extract to whatever place of your choice and edit the configure.in accordingly.
 
     You need to have zlib1.dll in a library path. You may copy this dll to libxml2/lib.
 
@@ -226,25 +268,27 @@
     Extract the source distribution to a folder of your choice. (Example: C:\axis2c)
     Open a DOS shell and type:
         cd C:\axis2c\build\win32
-        C:\axis2c\build\win32>vcvars32.bat      to access .Net tools
-                                                (Note: You may need to set the environment
-                                                PATH variable to  vcvars32.bat if Windows
-                                                complains that it cannot find this bat)
+        C:\axis2c\build\win32>vcvars32.bat
+                       to access .Net tools
+                       (Note: You may need to set the PATH environment
+                       variable to  vcvars32.bat if Windows complains 
+                       that it cannot find this bat)
         C:\axis2c\build\win32>nmake install
 
-    That's it! This will build the system and create a directory named 'deploy' under the
build directory.
+    That's it! This will build the system and create a directory named 'deploy'
+    under the build directory.
 
     The deploy folder structure is as follows.
 
     deploy
       |
-	  +- bin         - server and other executables
+      +- bin         - server and other executables
       |   |
       |   +- samples - samples go here
       |         |
       |         +...
       |
-      +- lib	     - library modules
+      +- lib         - library modules
       |
       +- services    - deployed services 
       |
@@ -257,12 +301,14 @@
 4.4 Running the binaries
 ------------------------
 
-    You need to set a couple of environment variables before you can run the server and samples.
+    You need to set a couple of environment variables before you can run the 
+    server and samples.
 
     Set the variable AXIS2C_HOME to the deploy folder (C:\axis2c\build\deploy)
     Add the path to lib directory to the PATH variable (%AXIS2C_HOME%\lib)
 
-    Copy libxml2.dll, iconv.dll and zlib1.dll to the axis2c lib folder (%AXIS2C_HOME%\lib)
+    Copy libxml2.dll, iconv.dll, and zlib1.dll to the Axis2C lib folder
+    (%AXIS2C_HOME%\lib)
 
     Now everything is set to run the server!
 
@@ -271,8 +317,10 @@
     You should see the message
         Started Simple Axis2 HTTP Server...
 
-    By default, the log is created under %AXIS2C_HOME%\logs folder with the name axis2.log.
-    (Note: You may provide command line options to change the default behaviour. Type "axis2_http_server.exe
-h" to learn about the usage)
+    By default, the log is created under %AXIS2C_HOME%\logs folder with the 
+    name axis2.log.
+    (Note: You may provide command line options to change the default behaviour.
+    Type "axis2_http_server.exe -h" to learn about the usage)
 
     Now you can run any sample client deployed under %AXIS2C_HOME%\bin\samples\
     Example:
@@ -289,9 +337,11 @@
     Provide the Apache2 include file location as a configure option
         ./configure --with-apache2="<apache2 directory>" [other configure options]
 
-    NOTE: Some apache2 distributions install APR (Apache Portable Run-time) include files
in a
-    separate location which is required to build mod_axis2. In that case use:
-        ./configure --with-apache2="<apache2 directory>" --with-apr="<apr include
files location>" [other configure options]
+    NOTE: Some apache2 distributions install APR (Apache Portable Run-time) 
+    include files in a separate location which is required to build mod_axis2.
+    In that case use:
+        ./configure --with-apache2="<apache2 directory>" 
+            --with-apr="<apr include files location>" [other configure options]
 
     Then build the source tree
         make
@@ -305,21 +355,28 @@
     Example:
     APACHE_INSTALL_DIR = E:\Apache
 
-    After compiling the sources (as described in section 4.3) build the mod_axis2.dll by
issuing the command "nmake axis2_apache_module".
+    After compiling the sources (as described in section 4.3) build the
+    mod_axis2.dll by issuing the command "nmake axis2_apache_module".
     This will build the mod_axis2.dll and copy it to %AXIS2C_HOME%\lib directory.
     Example:
     C:\axis2c\build\deploy\lib 
 
 5.2 Deploying in Apache2 Web Server
 
-    NOTE: To do the following tasks, you might need super user privileges in your machine.
+    NOTE: To do the following tasks, you might need super user privileges in your 
+          machine.
 
-    Copy the mod_axis2 (libmod_axis2.so.0.0.0 on Linux and mod_axis2.dll in Windows) to "<apache2
modules directory>" as mod_axis2.so 
+    Copy the mod_axis2 (libmod_axis2.so.0.0.0 on Linux and mod_axis2.dll in Windows)
+    to "<apache2 modules directory>" as mod_axis2.so 
     Example:
-    cp $AXIS2C_HOME/lib/libmod_axis2.so.0.0.0 /usr/lib/apache2/modules/mod_axis2.so    in
Linux or
-    copy C:\axis2c\build\deploy\lib\mod_axis2.dll C:\Apache2\modules\mod_axis2.so      in
Windows
+    cp $AXIS2C_HOME/lib/libmod_axis2.so.0.0.0 /usr/lib/apache2/modules/mod_axis2.so
+        in Linux or
+
+    copy C:\axis2c\build\deploy\lib\mod_axis2.dll C:\Apache2\modules\mod_axis2.so
+        in Windows
 
-    Edit the Apache2's configuration file (generally httpd.conf) and add the following directives
+    Edit the Apache2's configuration file (generally httpd.conf) and add the
+    following directives
 
     LoadModule axis2_module <apache2 modules directory>/mod_axis2.so
     <Location /axis2>
@@ -329,7 +386,8 @@
         Axis2LogLevel LOG_LEVEL
     </Location>
 
-    NOTE: Axis2 log file path should have write access to all users because by default Apache
Web Server runs as nobody.
+    NOTE: Axis2 log file path should have write access to all users because by
+          default Apache Web Server runs as nobody.
 
     LOG_LEVEL can be one of following
         AXIS2_LOG_LEVEL_CRITICAL - Log critical errors only
@@ -339,7 +397,8 @@
         AXIS2_LOG_LEVEL_DEBUG - Log debug and above (default)
         AXIS2_LOG_LEVEL_TRACE - Log trace messages
 
-    NOTE: Use forward slashes "/" for path separators in <apache2 modules directory>,
<axis2 repository path> and <axis2 log file path>
+    NOTE: Use forward slashes "/" for path separators in <apache2 modules directory>,

+          <axis2 repository path> and <axis2 log file path>
 
     Make sure that the apache2 user has the correct permissions to above paths
         - Read permission to the repository
@@ -357,63 +416,66 @@
 FAQ
 =======
 
-1. Although I was able to get simple axis server up, unable to run samples ?
+1. Although I was able to get simple axis server up, unable to run samples.
 
-        This could happen because of wrong location of AXIS2C_HOME 
+        This could happen because the AXIS2C_HOME environment variable is not 
+        set to the correct axis2 installation path.
 
 
-2. What are the other dependencies Axis2c has ?
+2. What are the other dependencies Axis2C has?
      
-        Basically if you are willing to use libxml2 as your parser, you need to have it installed
on your system.
-and rampart (security module of axis2c) has dependency on openssl.
+        Basically if you are willing to use libxml2 as your parser, you need to
+        have it installed on your system. and rampart (security module of Axis2C)
+        has dependency on openssl.
 
         libxml2 - http://xmlsoft.org/downloads.html
 
-3. I installed libxml2 installed in my system, but ./configure fails saying "libxml2 not
found"
+3. I installed libxml2 installed in my system, but ./configure fails saying
+   "libxml2 not found"
 
         Yes, you need to install libxml2-dev packages. 
-		
-		1. If you are using debian based system
-    			apt-get install libxml2-dev
-                2. If you are using redhat based system.
-                        yum install libxml2-dev
-		3. If you compile libxml2 from source this you will not get this error.
+        
+        1. If you are using a debian based system
+                apt-get install libxml2-dev
+        2. If you are using redhat/fedora based system.
+                yum install libxml2-dev
+        3. If you compile libxml2 from source you will not get this error.
 
-4. I installed openssl in my system but , I'm getting an error while configuring rampart
?
+4. I installed openssl in my system but, I'm getting an error while configuring
+   rampart?
     
-         You might need to get installed "libssl-dev"
+         You might need to get "libssl-dev" package installed.
 
-5. Is there any recommended packages ,that I need to installed in my system ?
+5. Is there any recommended packages, that I need to instal in my system?
 
-                1. automake, autoconf , libtool, aclocal
-                2. libxml2 and libxml2-dev
-		3. openssl
-                4. libssl-dev
-		5. pkg-config
-  		
-6. I tried several methods, browse through axis-c-dev and axis-c-user mail archives but I'
was unable solve it ?
+        1. automake, autoconf, libtool, aclocal
+        2. libxml2 and libxml2-dev
+        5. pkg-config
+          
+6. I tried several methods, browse through axis-c-dev and axis-c-user mail 
+   archives but I was not able solve it.
 
-    Then you can ask from axis2c users or Axis2c developers about it by sending your question
to 
-         user 	   = axis-c-user@ws.apache.org    
-         developer = axis-c-dev@ws.apache.org 
+        Then you can ask from Axis2C users or Axis2C developers about it by
+        sending your question to 
+            user      = axis-c-user@ws.apache.org    
+            developer = axis-c-dev@ws.apache.org 
 
-      You can get subscribe to 
+        You can get subscribe to
 
-                 axis-c-user list by sending request to  "axis-c-user-subscribe@ws.apache.org"
+            axis-c-user list by sending request to  
+                <axis-c-user-subscribe@ws.apache.org>
 
-                 axis-c-dev  list by sending request to  "axis-c-dev-subscribe@ws.apache.org"
+            axis-c-dev  list by sending request to  
+                <axis-c-dev-subscribe@ws.apache.org>
 
-       subject of the request should be "subscribe"
+            subject of the request should be "subscribe"
 
 
-7. This FAQ is not enough ?
+7. This FAQ is not enough...
        
-       You can help us by reporting your suggestions, complaints, problems and bugs ...
-
-
-
- Thank you for using Axis2c ...
+       You can help us by reporting your suggestions, complaints, problems and bugs
 
 
 
 
+Thank you for using Axis2C ...

Modified: webservices/axis2/trunk/c/NEWS
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/c/NEWS?view=diff&rev=452399&r1=452398&r2=452399
==============================================================================
--- webservices/axis2/trunk/c/NEWS (original)
+++ webservices/axis2/trunk/c/NEWS Tue Oct  3 03:15:46 2006
@@ -23,11 +23,11 @@
   15. Code generation tool for stub and skeleton generation for a given WSDL (based on Java
tool)
         o Axis Data Binding (ADB) support
   16. Security module with UsernameToken support
-  17. REST support (HTTP GET case) - New
-  18. Dynamic invocation support (based on XML schema and WSDL implementations) - New
-  19. Guththila pull parser support
-  20. WSDL2C code generation tool- with schema code generation (experimental)
-  21. TCP Monitor - C implementation (experimental)
+  17. REST support (HTTP GET case)
+  18. Dynamic invocation support (based on XML schema and WSDL implementations)
+  19. Guththila pull parser support - New
+  20. WSDL2C code generation tool- with schema code generation (experimental) - New
+  21. TCP Monitor - C implementation (experimental) - New
 
 Major Changes Since Last Release
    1. Guththila pull parser support

Modified: webservices/axis2/trunk/c/xdocs/docs/installationguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/c/xdocs/docs/installationguide.html?view=diff&rev=452399&r1=452398&r2=452399
==============================================================================
--- webservices/axis2/trunk/c/xdocs/docs/installationguide.html (original)
+++ webservices/axis2/trunk/c/xdocs/docs/installationguide.html Tue Oct  3 03:15:46 2006
@@ -6,13 +6,12 @@
   <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
   <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
   <title>Axis2-C Installation Guide</title>
-  <meta name="generator" content="amaya 9.4, see http://www.w3.org/Amaya/" />
+  <meta name="generator" content="amaya 9.51, see http://www.w3.org/Amaya/" />
 </head>
 
 <body xml:lang="en">
 <h1>Axis2/C Installation Guide</h1>
 
-
 <p>This document will guide you on how to install Axis2/C and run the server
 and client samples on Linux and Microsoft Windows operating systems.</p>
 
@@ -51,18 +50,19 @@
       </li>
     </ul>
   </li>
-  <li><a href="#installing-apache2">Installing Apache2 Web Server integration
module
-    (mod_axis2)</a>
+  <li><a href="#installing-apache2">Installing Apache2 Web Server integration
+    module (mod_axis2)</a>
     <ul>
-      <li><a href="#building-apache2">Building mod_axis2 from source tree</a></li>
-      <li><a href="#deploying-apache2">Deploying in Apache2 Web Server</a></li>
+      <li><a href="#building-apache2">Building mod_axis2 from source
+      tree</a></li>
+      <li><a href="#deploying-apache2">Deploying in Apache2 Web
+      Server</a></li>
     </ul>
   </li>
 </ul>
 
-<p><a></a></p>
-
-<h2>Installing and running on Linux</h2>
+<a id="linux"></a>
+<h2>1. Installing and running on Linux</h2>
 
 <p>This can be done using binary or source distributions</p>
 
@@ -70,29 +70,30 @@
 which can be downloaded from <a
 href="http://xmlsoft.org/downloads.html">here</a>.</p>
 
-<p>(NOTE: most Linux systems has libxml2 by default.)</p>
-<a></a>
+<p><b>NOTE:</b> Most Linux systems have libxml2 installed by default. On
+Windows you need to download and install libxml2.</p>
 
-<h3>1. Using binary release</h3>
+<a id="linux_binary"></a>
+<h3>1.1. Using binary release</h3>
 
 <p>The following steps need to be taken to install and run Axis2/C using
 binary distribution on Linux</p>
-
-<h4>1. Extract the binary tar package to a folder.</h4>
+<ol>
+<li>Extract the binary tar package to a folder.</li>
+<li>Set AXIS2C_HOME environment variable pointing to the location where you
+  have extracted Axis2C</li>
 <ul>
-  <li>Set AXIS2C_HOME environment variable pointing to the location where you
-    have extracted Axis2C</li>
   <li>AXIS2C_HOME='/your_path_to_axis2c'</li>
-  <li>export AXIS2C_HOME
-    <p>Note: You will need to set AXIS2C_HOME only if you need to run axis2c
-    samples or tests. The reason is</p>
-    <p>that the samples and tests use the AXIS2C_HOME envioronment variable
-    to locate the repository path. To write your own</p>
-    <p>services or clients this would not be neccessary.</p>
-  </li>
+  <li>export AXIS2C_HOME</li>
+  <br />
+
+  <li><strong>NOTE:</strong> You will need to set AXIS2C_HOME only if you
+    need to run Axis2C samples or tests. The reason is that the samples and
+    test codes use AXIS2C_HOME to get the path to Axis2C. To write your own
+    services or clients this is not a requirement.</li>
 </ul>
 
-<h4>2. Run the simple axis server:</h4>
+<li>Run the simple axis server:</li>
 <ul>
   <li>To start the simple axis server on default port 9090, run the following
     commands.
@@ -102,8 +103,10 @@
     </ul>
   </li>
   <li>To see the possible command line options run ./axis2_http_server -h</li>
-  <li>NOTE: If you run into shared lib problems, try setting the
-    LD_LIBRARY_PATH
+  <br />
+
+  <li><strong>NOTE:</strong> If you run into shared lib problems, try setting
+    the LD_LIBRARY_PATH
     <ul>
       <li>export
       LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib</li>
@@ -111,7 +114,7 @@
   </li>
 </ul>
 
-<h4>3. Run the sample clients in a new shell</h4>
+<li>Run the sample clients in a new shell</li>
 <ul>
   <li>cd /your_path_to_axis2c/bin/samples</li>
   <li>to run client for echo service
@@ -126,15 +129,18 @@
   </li>
   <li>To see the possible command line options for sample clients run them
     with '-h' option</li>
-  <li>NOTE: If you run into shared lib problems, try setting the
-    LD_LIBRARY_PATH
+  <br />
+
+  <li><strong>NOTE:</strong> If you run into shared lib problems, try setting
+    the LD_LIBRARY_PATH
     <ul>
       <li>export
       LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib</li>
     </ul>
   </li>
 </ul>
-<a></a>
+</ol>
+<ai id="linux_source"></a>
 
 <h3>2. Using source release</h3>
 
@@ -147,6 +153,12 @@
     <ul>
       <li>AXIS2C_HOME='/your_desired_path_to_axis2c_installation'</li>
       <li>export AXIS2C_HOME</li>
+      <br />
+
+      <li><strong>NOTE:</strong> You will need to set AXIS2C_HOME only
if you
+        need to run Axis2C samples or tests. The reason is that the samples
+        and test codes use AXIS2C_HOME to get the path to Axis2C. To write
+        your own services or clients this is not a requirement.</li>
     </ul>
   </li>
   <li>Then go to the folder where you extracted the source
@@ -156,35 +168,54 @@
   </li>
   <li>Build the source
     <ul>
-      <li>This can be done using the following command sequence:
+      <li>This can be done using the following command sequence in the
+        directory where you have extracted the source:
         <ul>
-          <li>./configure</li>
+          <li>./configure --prefix=${AXIS2C_HOME}</li>
           <li>make</li>
           <li>make install</li>
         </ul>
       </li>
       <li>use './configure --help' for possible command line options.</li>
-      <li>NOTE: If you don't provide a --prefix configure option, it will by
-        defaul install into /usr/local/axis2c folder.</li>
-      <li>You may also need to set LD_LIBRARY_PATH to include the
-      install locations.</li>
-     <li>    You may need to try axis2c with guththila xml parser. You
-     can do it by giving --enable-guththila=yes</li>
-           <ul> 
-	   <li> ./configure --enable-guththila=yes [other configuration options]</li>
-	   <li>make</li>
-	   <li> make install</li>
-	   </ul>
+      <li><strong>NOTE:</strong> If you don't provide a --prefix configure
+        option, it will by defaul be installed into /usr/local/axis2c
+        directory.</li>
+      <li>You may need to try axis2c with guththila xml parser. You can do it
+        by giving --enable-guththila=yes
+        <ul>
+          <li>./configure --enable-guththila=yes [other configuration
+          options]</li>
+          <li>make</li>
+          <li>make install</li>
+        </ul>
+      </li>
+      <li>In order to build rampart (axis2c security module)
+        <ul>
+          <li>./configure --enable-rampart=yes [other configuration
+          options]</li>
+          <li>make</li>
+          <li>make install</li>
+        </ul>
+      </li>
       <li>If you need to get the samples working, you also need to build the
         samples.
-        <p>To build samples:</p>
+        <br />To build the samples:
         <ul>
+          <li>export
+          LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/axis2c/lib/</li>
           <li>cd samples</li>
           <li>./configure --prefix=${AXIS2C_HOME}</li>
+          <li>--with-axis2_util=${AXIS2C_HOME}/include</li>
+          <li>--with-axiom=${AXIS2C_HOME}/include</li>
           <li>make</li>
-          <li>make install</li>
+          <li>sudo make install</li>
         </ul>
       </li>
+      <li>Please run "./configure --help" in samples folder for more
+        information on configure options.</li>
+      <li><strong>NOTE:</strong> If you don't provide a --prefix configure
+        option, samples will by default be installed into
+        "/usr/local/axis2c/samples" directory.</li>
     </ul>
   </li>
   <li>Go to where you installed axis2c.</li>
@@ -193,17 +224,19 @@
       <li>To start the simple axis server on port 9090 run the following
         command lines
         <ul>
-          <li>cd axis2c/bin</li>
+          <li>cd ${AXIS2C_HOME}/bin</li>
           <li>./axis2_http_server</li>
         </ul>
       </li>
       <li>To see the possible command line options run ./axis2_http_server
       -h</li>
+      <li> <strong>NOTE:</strong> You may need to be login as superuser
to
+        run the simple axis server.</li>
     </ul>
   </li>
   <li>Run the sample clients in a new shell using the following command lines
     <ul>
-      <li>cd bin/samples</li>
+      <li>cd ${AXIS2C_HOME}/bin/samples</li>
       <li>to run client for echo service
         <ul>
           <li>./echo</li>
@@ -219,8 +252,8 @@
     </ul>
   </li>
 </ol>
-<a></a>
 
+<a id="win"></a>
 <h2>Installing and running on Microsoft Windows (win32)</h2>
 
 <p>This too can be done using either binary or source distributions</p>
@@ -230,10 +263,10 @@
 
 <p>(NOTE: most Linux systems has libxml2 by default. On Windows you need to
 download and install libxml2)</p>
-<a></a>
+<a id="win_binary"></a>
 
 <h3>1. Using binary release</h3>
-<a></a>
+<a id="bin_req"></a>
 
 <h4>Requirements</h4>
 <ul>
@@ -253,7 +286,7 @@
     </ul>
   </li>
 </ul>
-<a></a>
+<a id="bin_binaries"></a>
 
 <h4>Binaries in the release</h4>
 <ul>
@@ -277,7 +310,7 @@
   <li>Copy libxml2.dll, iconv.dll and zlib1.dll downloaded to
   C:\axis2c\lib</li>
 </ul>
-<a></a>
+<a id="bin_run"></a>
 
 <h4>Running the binaries</h4>
 <ul>
@@ -304,10 +337,10 @@
     </ul>
   </li>
 </ul>
-<a></a>
+<a id="win_source"></a>
 
 <h3>2. Using the source release.</h3>
-<a></a>
+<a id="src_req"></a>
 
 <h4>Requirements</h4>
 <ul>
@@ -328,7 +361,7 @@
     </ul>
   </li>
 </ul>
-<a></a>
+<a id="edit"></a>
 
 <h4>Editing configure.in file</h4>
 <ul>
@@ -348,7 +381,7 @@
   <li>You need to have zlib1.dll in a library path. You may copy this dll to
     libxml2/lib.</li>
 </ul>
-<a></a>
+<a id="src_compile"></a>
 
 <h4>Compiling the source.</h4>
 
@@ -387,7 +420,7 @@
     <li>logs - system and client logs are written to this folder</li>
   </ul>
 </ul>
-<a></a>
+<a id="src_run"></a>
 
 <h4>Running the binaries</h4>
 <ul>
@@ -418,9 +451,10 @@
     </ul>
   </li>
 </ul>
-<a id="installing-apache2"/>
-<h3> 3. Installing Apache2 Web Server integration module (mod_axis2).</h3>
+<a id="installing-apache2"></a>
 
+<h3>3. Installing Apache2 Web Server integration module (mod_axis2).</h3>
+<a id="building-apache2"></a>
 <h4>3.1 Building mod_axis2 from source tree</h4>
 
 <h4>3.1.1 On Linux Platform</h4>
@@ -452,7 +486,7 @@
     directory.<br />
     eg: C:\axis2c\build\deploy\lib</li>
 </ul>
-
+<a id="deploying-apache2"></a>
 <h4>3.2 Deploying in Apache2 Web Server</h4>
 
 <p><b>Note: To do the following tasks you might need super user privileges in



---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org


Mime
View raw message