Description
This tool is used as a starting point for estimating the effort required to migrate a group of J2EE applications from an Oracle/BEA WebLogic environment to a JBOSS AS environment.
The tool produces reports, in HTML format, on the following information:
Class Dependencies:
for each codebase defined in the configuration, reports on the libraries that the codebase depends on (down to the package, class, and method levels)
for each dependency, and for each classpath location defined in the configuration, the tool attempts to load those classes and reports on where those class
files are located and the Manifest information associated with those jar files.
a typical use case for the class dependencies tool is to set up 2 classpath configurations: 1) the WebLogic runtime classspath that the application is currently running against; 2)the target JBoss classpath that the application will be migrated to. From this setup, the tool gives an overview of what libraries will be missing in the target JBoss environment, and also what standard libraries in JBoss that may potentially conflict with standard libraries from WebLogic
WebLogic Server Configuration:
for each of the servers defined in the configuration, gives a complete and searchable listing of all the MBeans currently deployed
the tools queries the server live to obtain this information, so the server must be running and accessible
Applications deployment configuration
for each application defined in the configuration, gives an overview of the numbers of specific resources are present (eg. JSP's, HTML files, Servlets, and EJB's), as well as a pointer to the application descriptors for further inspection.
From here on, we refer to the base directory for this installation as $DIST.
Configuration:
1) Set JAVA_HOME to a JRE of 1.5 or later. The dependency analysis tools require this.
2) Set WL_HOME to your weblogic server home, for example /opt/bea81/weblogic81
3) Run the setup scripts in the bin folder - this is $DIST/bin/setup.sh (or $DIST/bin/setup.cmd on Windows).
The tool uses WLST to examine the application run time environment. WLST became officially available as of WebLogic release 9.0. If you are using a version of WebLogic prior to 9.x (such as 8.1 and earlier) uncomment the following line before running the script:
#java $VMARGS -cp $CP -Dredhatlogdir=$LOGDIR -Dconfig.xml=$CONFIG_XML WLShellDownloadScript
This will download the WLShell tool and install it into the tools directory. The tool will then use WLShell to do the run time analysis.
4) Go to $DIST/conf
Edit the config.xml file, setting up your server configuration and applications' codebase. The sample config.xml provides more details and examples of a typical configuration.
By default, the tool runs with the configuration defined in this file. You can run it against other configurations by editing your $DIST/bin/run.sh (or $DIST/bin/run.cmd on Windows) and editing the following line in 2 places:
CONFIG_XML=$CONFDIR/config.xml.
That is all that is necessary. Also in the conf directory you will find stylesheets, javascript files, and other resources required by the tool to run and generate its report. It is not necessary to edit these files.
Running the tool:
After setting up your configuration, go to $DIST/bin
Execute run.sh (*NIX Operating systems) or run.cmd (Windows)
Output
Reports will be generated in the $DIST/reports/ folder.
Open $DIST/reports/index.html in a browser to view the reports.
Comments