z/OS Tomcat Distro Initial experiences

tlongfellow · Post by **tlongfellow** » Fri Apr 10, 2009 2:27 pm

I have just finished going through an initial install of the new Distro. This was done without the final documentation (because it has not been posted yet). At the end I did not end up with a working Tomcat server.

The zip file downloaded fine. The README.TXT in the zip file suffers from the usual problem with data created under Unix and read under Windows. One long runon data line because of CRLF issues.

The receive of the XMIT file went just the same as for any other product distributed by XMIT. The PDS file created had a well lablelled INSTALL member. I took a side trip to create a unique zFS file mount at /usr/local/tomcat.

The second PDS (created by INSTALL) was modified as follows.
(TCENV) - Had a little trouble with the DB2 install path sample provided. I usually use standard path names straight from a serverpac. The sample had an extra level (/db2910) that my file system did not have.
I had a similar problem later in SERVVARS
There is a comment that says to uncomment a line for the JZOS_HOME varialbe. The line is already uncommented.

(TCPROC) - the provided JZOSLIB of SYS1.SIEALINKE does not match the IBM DDDEF name of SIEALNKE. This dataset would usually be named HLQ.SIEALNKE during standard z/OS installs
I uncommented the DB2 lines and filled them with local values

(SERVVARS) - Easily changed the httpPort, sslPort, db2Loc and db2url values.

(SERVXML) - I made no changes.

(TCUSERS) - added a local id in the manager role

(TCJOB) - Jobcard changed and run.

-------
The entire process took about 45 minutes or so
-------

Now the trouble starts. Tomcat does not start and gives a NoSuchMethodError error. I have tried the JZOS 2.0.0 and 2.2.1 versions.
Here is the STDERR with LOGLVL=+D activated. (just the first few records)

java.lang.reflect.InvocationTargetException
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:79)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:618)
at org.apache.catalina.startup.Bootstrap.load(Bootstrap.java:260)
at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:412)
Caused by: java.lang.NoSuchMethodError: com/ibm/jzos/ZFile.getSlashSlashQuotedDSN(Ljava/lang/String;Z)Ljava/lang/String;
at com.dovetail.jzos.url.zfile.ZFileURLConnection.connect(ZFileURLConnection.java:85)
at com.dovetail.jzos.url.zfile.Handler.openConnection(Handler.java:18)
at java.net.URL.openConnection(URL.java:978)
at org.apache.xerces.impl.XMLEntityManager.setupCurrentEntity(Unknown Source)
at org.apache.xerces.impl.XMLEntityManager.startEntity(Unknown Source)

And here is the JZOS log

JVMJZBL2004N Log level has been set to: D
JVMJZBL1001N JZOS batch Launcher Version: 2.2.1 Alphaworks 2007-11-19
JVMJZBL1002N Copyright (C) IBM Corp. 2005. All rights reserved.
JVMJZBL1029I Region requested = 0K, Actual below/above limit = 8M / 1785M
JVMJZBL1053I OS Release R19.00 Machine 2086
JVMJZBL1036D Spawned child shell process with PID: 67109497
JVMJZBL1005I Output from DD:STDENV config shell script:
JVMJZBL1006I MAIL = /usr/mail/
JVMJZBL1006I PHPRC = /usr/lpp/php/php.ini
JVMJZBL1006I JAVA_PROPAGATE = NO
JVMJZBL1006I PATH = /bin:/usr/lpp/java/J5.0/bin:
JVMJZBL1006I IBM_JAVA_ZOS_TDUMP = NO
JVMJZBL1006I IBM_JAVA_OPTIONS = -Xms64m -Xmx128m -Dfile.encoding=ISO8859-1 -Dcatalina.base=/usr/local/tomcat
-Dcatalina.home=/usr/local/tomcat -Djava.io.tmpdir=/usr/local/tomcat/temp -Djava.protocol.handler.pkgs=com.dovetail.jzos
.url|com.ibm.crypto.provid
er -Ddb2.jcc.ssid=DSNT
JVMJZBL1006I JZOS_JVM_OPTIONS = -Djava.ext.dirs=/usr/lpp/jzos:/usr/lpp/java/J5.0/lib/ext -Djzos.jdfsort.dir=/usr/lpp/jz
os
JVMJZBL1006I _BPX_SPAWN_SCRIPT = YES
JVMJZBL1006I _ = /bin/env
JVMJZBL1006I CLASSPATH = /usr/lpp/java/J5.0/lib/tools.jar:/usr/local/tomcat/bin/bootstrap.jar:/usr/local/tomcat/bin/zos-
url.jar:/usr/lpp/db2910_jdbc/classes/db2jcc.jar:/usr/lpp/db2910_jdbc/classes/db2jcc_javax.jar:/usr/lpp/db2910_jdbc/class
es/db2jcc_licen
se_cisuz.jar:/usr/lpp/db2910_jdbc/classes/sqlj.zip:
JVMJZBL1006I LANG = C
JVMJZBL1006I LIBPATH = /lib:/usr/lib:/usr/lpp/java/J5.0/bin:/usr/lpp/java/J5.0/lib/s390:/usr/lpp/java/J5.0/lib/s390/j9vm
:/usr/lpp/java/J5.0/bin/classic:/usr/lpp/db2910_jdbc/lib:
JVMJZBL1006I _BPX_SHAREAS = YES
JVMJZBL1006I XERCESROOT = /usr/lpp/ixm/IBM/xml4c-5_6
JVMJZBL1006I DSNAOINI = /etc/odbc.ini
JVMJZBL1006I JAVA_DUMP_HEAP = false
JVMJZBL1006I JAVA_HOME = /usr/lpp/java/J5.0
JVMJZBL1006I TZ = GMT0EDT
JVMJZBL1006I MANPATH = /usr/lpp/Printsrv/man/%L:/usr/man/%L
JVMJZBL1006I NLSPATH = /usr/lib/nls/msg/%L/%N:/usr/lpp/Printsrv/%L/%N
JVMJZBL1006I PWD = /u/tech905
JVMJZBL1008D ___JZOS_ENV_STOP___
JVMJZBL1012I Java Virtual Machine created. Version information follows:
java version "1.5.0"
Java(TM) 2 Runtime Environment, Standard Edition (build pmz31dev-20080315 (SR7))
IBM J9 VM (build 2.3, J2RE 1.5.0 IBM J9 2.3 z/OS s390-31 j9vmmz3123-20080315 (JIT enabled)
J9VM - 20080314_17962_bHdSMr
JIT - 20080130_0718ifx2_r8
GC - 200802_08)
JVMJZBL1027I Using output encoding: IBM-1047
JVMJZBL1016I MVS commands are ENABLED
JVMJZBL1023N Invoking org.apache.catalina.startup.Bootstrap.main()...
JVMJZBL1024N org.apache.catalina.startup.Bootstrap.main() completed.
JVMJZBL1014I Waiting for non-deamon Java threads to finish before exiting...
JVMJZBL2999I JZOS batch launcher elapsed time=4.903186 seconds, cpu time=2.2778581 seconds
JVMJZBL1021N JZOS batch launcher completed, return code=0

It looks like I am either missing the zFile classes or have not configured them for use.

Post by **dovetail** » Fri Apr 10, 2009 2:59 pm

Thomas,

Thanks for the detailed feedback.

- We will fixup the text files in the zip to have CRLFs

- DB2 default install path - we'll fix this per your suggestion

- What was your issue with SERVVARS? Is the default SSID different?

- The JZOS_HOME paragraph should not have been uncommented by default. This is only necessary if you use an alphaWorks JZOS rather than the SDK included version

- Thanks for pointing out the typo on SYS1.SIEALNKE

- The problem that you are having is this: the new ZFile URL handler
that we wrote uses a newer JZOS method than the version that you
have. We are going to change this code so that older versions of
JZOS will work fine. SDK 5.0 SR7 has JZOS 2.0.0 included, so after
my change you could use that rather than alphaWorks if you wanted.
(FWIW: SDK 5.0 SR9 has JZOS 2.3.0)

We'll put together another package that should hopefully resolve all of these issues and let you know when it is available. Thanks again for your feedback.

Kirk Wolf
Dovetailed Technologies

tlongfellow · Post by **tlongfellow** » Fri Apr 10, 2009 8:01 pm

I had no problem with the SERVVARS. I was just posting the changes that I had made. Just a list of things that I did in case it helps improve any other documentation.

I have seen the new posting and should get a chance to try it on Monday.

tlongfellow · Post by **tlongfellow** » Mon Apr 13, 2009 9:09 am

I just finished with the 0.1.1 distro in about 20 minutes.
I have it up and running but now I have to dust off my three year old manager/administrator skills

I had Tomcat 5.5 running and this release of 6.0 seems a little lighter. The first noticeable difference is no tomcat-docs or administrator applications. As a ''just above novice" with app servers the docs might have come in handy.

I am now faced with the task of reinstalling or migrating my jspWiki from 5.5 to 6.0.

Post by **dovetail** » Mon Apr 13, 2009 9:16 am

Thanks for the feedback.

The Tomcat folks dropped the Administrator app in Tomcat 6, which is why is it missing. The direction seems to be use JMX. The Manager app is still available.

I omitted the Tomcat-docs app since it just duplicates the information available on the Tomcat website. I did update the ROOT application so that the docs links point to the Tomcat site.

Please let us know how your jspWiki migration goes - I was thinking of trying to figure out how to streamline packaging of jspWiki since it is popular on z/OS.