Not sure if this is
the right way to submit this but hopefully it will suffice.
Here are some
comments on the axis Installation page
Step 6 Classpath
setup
set
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%\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
should
be
set
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%\wsdl4j-1.5.1.jar;%AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar
%AXIS_LIB%\commons-logging.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;
%AXIS_LIB%\log4j-1.2.8.jar;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar
"%AXIS_LIB%\wsdl4j-1.5.1.jar" is missing and the samples won't work without
it.
One other issue is
that when running the deployment and client steps in the instructions I get the
following warnings:
log4j:WARN No
appenders could be found for logger
(org.apache.axis.i18n.ProjectResourceBundle).
log4j:WARN Please initialize the log4j system properly.
log4j:WARN Please initialize the log4j system properly.
These warnings
appear harmless but I was not able to fix them despite my best efforts playing
around with log4j.properties. In case it matters I am using ant 1.6.5,
forrest 0.6, axis 1.2, j2sdk 1.4.2_07 and tomcat
4.1.31
Some general
comments.
I found the
Installation guide fine up to Step 5. After that I found it a bit
confusing since it starts of talking about deploying your own web services
but actually presents a test using a sample. I think it would be clearer
to present the set up for the sample first, then build on this
for "your own" web service. In short, move the current step 5 to the
end and re-title the current Step 6 as "Deploying a Sample Web Service". I
realize the original intent was probably not a short tutorial on deploying a
sample, but for newcomers installing for the first time that is essentially what
step 6 and 7 are. I think they are very useful from that
perspective.
It would be good if
the current Step 7 mentioned that you are now going to run a client to call the
deployed web service. While it is obvious in hindsight, it took some
discussion with a colleague before I finally understood what I was doing
here. Step 7 also refers to the "distribution directory for xml-axis" which I
found unclear. It might be better to refer to this as "the root directory
of your axis install (eg. c:\axis )". Again its fairly obvious
once you know what it means. I found it confusing since prior
instructions have you copy the webapps from the axis install to the Tomcat
install which seemed like "deploying" to me.
Anyhow thanks for all the good work.
Hope this is of some assistance.
Regards,
Tim
**********************************************************************
This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. Any unauthorized review, use, disclosure or distribution is prohibited. If you are not the intended recipient, please contact the sender by reply e-mail and destroy all copies of the original message.
