/* --------------------------------------------------------------------------*/
README
(C) Copyright IBM Corp. 2006
THIS FILE IS PROVIDED UNDER THE TERMS OF THE ECLIPSE PUBLIC LICENSE
("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THIS FILE
CONSTITUTES RECIPIENTS ACCEPTANCE OF THE AGREEMENT.
You can obtain a current copy of the Eclipse Public License from
http://www.opensource.org/licenses/eclipse-1.0.php
Author: Michael Bauschert <michael.bauschert(at)de.ibm.com>
Date : 07/20/2006
Contributors: Marius Kreis <marius(at)nulldevice.org>
Wolfgang Taphorn <taphorn(at)de.ibm.com>
Bert Lange <langeb(at)de.ibm.com>
/* --------------------------------------------------------------------------*/
SBLIM WBEMSMT commons README
----------------------------------------
Introduction
------------
The wbemsmt-commons package provides the wbemsmt client sided tasks common/utility classes.
Source Package Contents
-----------------------
./README This file
./build.xml Apache Ant build file
./java/* Contains the java(tm) source files
./commons/* The web application files
General Requirements
--------------------
In order to build, install and operate this package you will need a Java
SDK or Run Time Environment depending on whether you build binaries from
sources or use the pre-built binaries (JAR file). The following Java JDKs
are supported:
Sun Java SDK/JRE: version 1.6.0 or higher
IBM Java SDK/JRE: version 1.6.0 or higher
Build-time Prerequisites
------------------------
Third-Party Libraries (and their dependent jar-Files):
- sblim-cim-client 2.1.1 or later from http://www.sblim.org/
- MyFaces 1.2.6 and Tomahawk 1.1.3 or later from http://myfaces.apache.org/
- XMLBeans 2.4.0 from http://xmlbeans.apache.org/
- Jakarta-Commons Lang 2.4 from http://jakarta.apache.org/commons/lang/
- Jakarta-Commons Cli 1.1 from http://jakarta.apache.org/commons/cli/
- tomcat-6.0.18 servlet-api from http://www.apache.org/
- tomcat-6.0.18 jsp-api from http://www.apache.org/
- apache-log4j 1.2.15 from http://www.apache.org/
Run-time Prerequisites
----------------------
- the above build-time preqrequisites
- Apache Tomcat 6.0.18 or later from http://tomcat.apache.org/ and all its prerequisites
- xerces-j2 >= 2.7.1
- xalan-j2 >= 2.7.1
- jakarta-commons-beanutils >= 1.8.0
- jakarta-commons-cli >= 1.1
- jakarta-commons-codec >= 1.3
- jakarta-commons-digester >= 1.8
- jakarta-commons-el >= 1.0
- jakarta-commons-fileupload >= 1.2.1
- jakarta-commons-lang >= 2.4
- jakarta-commons-logging >= 1.1.1
- tomcat6 >= 6.0.18
Building this package
------------------------------------------------------------------------------
The build process is based on Apache Ant (http://ant.apache.org). It contains
a build.xml that allows very easy to perform a compile, produce JAR files and
build TAR balls for a binary or a source distribution.
Additionally, an RPM spec file is in place that allows to build RPM packages.
The output of the RPM build process are RPM packages that are based on the
JPackage (http://www.jpackage.org) approach.
To be able to perform the build, set the CLASSPATH to include the JAR files
of the packages described in the 'Build-time Prerequisites. This can be
accomplished with the build-jar-repository command as well. Afterwards a
Source and a Binary TAR ball can easily be built by performing the following
command:
> ant build-release
The output will be placed in the './target/release' directory.
The Source TAR ball can also be created without setting the CLASSPATH by
simply performing:
> ant package-src-tar
With the Source TAR ball, RPM packages can be built. Since the TAR ball already
includes the RPM spec file the execution of
> rpmbuild -ta sblim-wbemsmt-commons-<version>.src.tar.bz2
will directly build the RPM package. Be sure to resolve the build requirements
before the build of the RPM package can take place. This is done when the
dependent packages explained in the 'Build-time Prerequisites' have been
installed as RPM packages.
Installation
------------------------------------------------------------------------------
The installation can be processed in three ways.
The preferred installation method is to run the wbemsmt setup script available
from sourceforge.
The second possible installation method would be to use the RPM package.
Simply put the RPM package onto your system, resolve the 'Run-time Dependencies'
and then perform the following command:
> rpm -i sblim-wbemsmt-commons-<version>.1jpp.noarch.rpm
The third way is a manual installation. This means the Binary TAR ball should
be taken and extracted. Copy the JAR files into the 'WEB-INF/lib' directory of
the 'sblim-wbemsmt-commons' in your tomcat installation directory and
additionally copy the content of the 'etc' directory into the '/etc' directory.
If you like to run the Command Line Interface script, then you should copy
the script to a location which is included into your '$PATH' environment
variable.
Contacting the WBEMSMT Project
------------------------------
To report weird behavior and bugs or suggestions and help contact the sblim
project by sending email to the sblim-devel mailing list at
sblim-devel@lists.sourceforge.net.