1. Please first do the following:

   ln -s ~yijun/software .
   

   This command will create a symbolic link to the software installed on the instructor's account.
2. If you are using TCSH, try to enable these environment variables in your .tcshrc:

   setenv JAVA_HOME /usr/local/packages/j2sdk1.4.2_04
   setenv AXISCPP_HOME $HOME/software/axis-c-1-2-linux
   setenv AXIS_HOME $AXISCPP_HOME/deploy
   setenv EXPAT_HOME $HOME/software
   setenv XERCESCROOT $HOME/software/xerces-c-src_2_5_0
   setenv XERCESC_HOME $HOME/software
   setenv LD_LIBRARY_PATH "/local/lib/eclipse:/usr/lib/gcc-lib/2.95.4:$XERCESC_HOME/lib:$EXPAT_HOME/lib:$AXISCPP_HOME/bin:$AXIS_HOME/libs"
   setenv CATALINA_BASE $HOME/software/jakarta-tomcat-4.1.31
   setenv CATALINA_HOME $CATALINA_BASE
   setenv AXIS_LIB /u/yijun/software/axis-1_1/lib
   setenv AXISCLASSPATH $AXIS_LIB/axis.jar:$AXIS_LIB/commons-discovery.jar:$AXIS_LIB/commons-logging.jar:$AXIS_LIB/jaxrpc.jar:$AXIS_LIB/saaj.jar:$AXIS_LIB/log4j-1.2.8.jar:$AXIS_LIB/xml-apis.jar:$AXIS_LIB/xercesImpl.jar:$AXIS_LIB/wsdl4j.jar:$HOME/software/junit3.8.1/junit.jar:$CATALINA_HOME/common/lib/activation.jar:$CATALINA_HOME/common/lib/mail.jar:.
   set path=($path $HOME/software/xerces-c-src_2_5_0/bin)
   set path=($HOME/software/apache/bin $path)
   set path=($path $HOME/software/bin)
   set path=($JAVA_HOME/bin $path)
   setenv CVSROOT ~/cvsroot
   setenv CVS_RSH rsh
   

Resources

• SOAP implementations and Editors
  Comparing performance of SOAP implementations [pdf]
  • for Java. On software measurements. A Java profile analysis tool: "java -jar software/HPjmeter.jar".
    • Tomcat
    • Axis
    • Eclipse
  • for C/C++
    • Apache
    • Axis-C
    • gSOAP
    • VIM
  • for C#
    • mono
• Bugzilla
• CVS
• Unit test tools
• OpenOME, a requirements engineering tool
• UDDI server

1. For setting up Tomcat, see the Tomcat HowTo
2. The Axis 1.1 is installed at:

   cd ~/software/axis-1_1
   

   Now a web serivce can be deployed, for example

   ./deploy.sh
   

   After running this command, two example web services StockQuote and StockInfo are deployed. The deployment script is

   	cat samples/stock/deploy.wsdd
   

   You can deploy the web serive to a TOMCAT server, see the option:

       -lhttp://seawolf.cdf.toronto.edu:8081/axis/services/AdminService
   

3. After deployment, you can call the webservice through

   ./client.sh
   

   The feedback is

   IBM: Armonk, NY
   

4. To undeploy the web service, type

   ./undeploy.sh
   

5. You can test your web service locally, using the SimpleAxisServer:

   ./stock2.sh
   

6. After your own web service is developed, it can be deployed under the following directory:

   ~/software/jakarta-tomcat-4.1.31/webapps/axis/WEB-INF/classes/c408h0xx
   

   where xx is your group number.
7. The documentation of your web service should be put under the following directory:

   ~/software/jakarta-tomcat-4.1.31/webapps/axis/c408h0xx
   

References

• download Axis 1.1

References

• download source of Axis C++ 1.2
• download expat 1.95.8
• download xerces-c src 2.5.0
• download libtool 1.5.8
• download autoconf 2.59
• download m4 1.4.2
• download automake 1.9

1. Please see the Tutorial 2 on how to use VIM to communicate with other tools through the Netbeans protocol.

References

1. Note each team should do the following just once! Configure your apache server by modifying the file under your own directory:

   cp $HOME/software/conf/httpd.conf $HOME
   

   In order to avoid conflicting with other team's work, edit the file $HOME/httpd.conf, change the port number to the 8080 + 2 * team_number . For example, if you are from team 20, your port number will be 8080 + 2 * 20 = 8120.
2. Look for "8080" and replace the line with:

   Listen seawolf.cdf.toronto.edu:8120
   

   Next, run the following command:

   /usr/local/packages/apache-2.0/bin/httpd -f $HOME/httpd.conf
   

   You Apache web server will be up and running. Try the following URLs:

   http://seawolf.cdf.toronto.edu:8120
   http://seawolf.cdf.toronto.edu:8120/axis
   http://seawolf.cdf.toronto.edu:8120/axis/Calculator?wsdl
   

   The first one is the apache server, the second one is the axis-c server and the third one is the WSDL for a calculator service.

References

• download apache Web server 2.0.51

References

• download bugzilla 2.16.6

References

1. Don't forget to add the following line to your startup script:

   setenv LD_LIBRARY_PATH /local/lib/eclipse
   

2. If you want to use your own plugin, to avoid contention with other's work, this is a better way to create a symbolic link to the common plugins:

           mkdir ~/eclipse
           cd ~/eclipse
           ln -s /local/lib/eclipse/* .
           rm plugins
           mkdir plugins
           cd plugins
           ln -s /local/lib/eclipse/plugins/* .
   

   Now you can replace the symbolic link to your modified plugin, or add a new plugin on your own directory.
3. After that, you can save your plugin to the

           ~/eclipse/plugins directory
   

   In addition, you need now to run eclipse from

           ~/eclipse/eclipse
   

4. You may take a look at the org.eclipse.ui.editors plugin to learn how Eclipse editor works. The CVS repository locates at:

   	-d:pserver:anonymous@dev.eclipse.org:/home/eclipse
   

   In Eclipse, open "Versions", "org.eclipse.ui.editors", and "org.eclipse.ui.editors R3_0" consequently. You shall be able to "Checkout" the source code as your project.

References

1. To try out the Stock Quote web service in the tutorial, please run the following commands:

   cd $HOME/software/gsoap-2.7/soapcpp2/samples/quote
   quote IBM
   

2. You may view the following files to understand how it works:

   quote.h			The C/C++ interface to the web service 
   quote.cpp		The Client program to invoke the web service
   Makefile		How the following files are generated
   quote.wsdl		The WSDL description of the web service
   quote.getQuote.req.xml	The request SOAP message
   quote.getQuote.res.xml	The response SOAP message
   

3. A simple gSOAP web server. Suppose you are in team 20 and thus use 8120 as the port number for your team's web service. If you are alreadying running apache server , try first to kill the process:

   killall httpd
   

   Then do the following:

   cd $HOME/software/gsoap-2.7/soapcpp2/samples/webserver
   webserver 8120 &
   

   A server will be running at the background and listening to your port number 8120. Now one can call it through the following URL:

   http://seawolf:8120
   http://seawolf:8120/calc.html
   

   The first URL is not very useful, just shows that the web server is running. The second URL shows an Javascript interface to the Calculator web service. You can use any web browser as a client to call the web service remotely and display the result to your web browser. You may also exercise to create a web service client to try it.
4. You may kill the web service (and all running web services) through

   killall webserver
   

References

• download gSOAP implementation 2.7
• download gSOAP for Apache module 0.0.5

1. Note: to find a unused port number, you may try

   netstat -na
   

2. When you changed some shell script file into DOS format, please make sure it is revert to Unix format. In VIM, you can do it by:

   set ff=unix
   :wq
   

3. Why Eclipse often core-dump on Linux? The major reason is that the environment LD_LIBRARY_PATH points to Lesstif widgets if not otherwise defined (e.g. /local/lib/eclipse).

References

1. Currently, we have set up the Tomcat web server 4.1.31, at $CATALINA_HOME, because it is the recommended web server by the stable version Axis 1.1.
2. We assume that each team that uses the Java/Axis would host their webapps on the same server, thus we provide 8081 as the common socket port number for all teams.
3. The tomcatv server is running:

   	http://seawolf.cdf.toronto.edu:8081/
   

4. The hosted web services are actually web applications. You can verify that the Axis is up and running:

   	http://seawolf.cdf.toronto.edu:8081/axis/happyaxis.jsp
   

5. For deploying your own Axis web services, see the Axis HowTo.

References

• download Tomcat 4.1.31

References

1. See Tutorial 4 for details. We may do this tutorial next week.

References