WebSphere Configuration Comparison Tool (CCT)

Home > Search

IBMs Configuration Comparison Tool (CCT) is a script that will create an HTML report comparing the configurations components in a cell, such as comparing JVM configurations or comparing resources (eg JDBC providers).



Download the Configuration Comparison Tool here.This will download a gzip compressed tar archive named cct-yyyymmdd.tar.gz. If you only have one cell, and your organization will never have a second cell, then you can place the gzip compressed tar archive on your WebSphere dmgr server. If your organization has two or more cells, then it makes sense to place the gzip compressed tar archive on one server that has WebSphere installed. 

Once you've placed the gzip compressed tar archive on a server, unzip and extract the archive.

gunzip cct-yyyymmdd.tar.gz
tar -xf cct-yyyymmdd.tar /path/to/directory


The directory that contains the extracted archive should now contain the following files.

  • WAS_Configuration_Comparison_Tool.ppt
  • ConfigDump.py
  • ConfigReportAttributes.properties
  • ConfigReport.properties
  • ConfigReport.py
  • ConfigUtils.py
  • WAuJ.py
  • WAuJ_utilities.py


Create a dump

You will first need to create a dump of the configuration using wsadmin. If you extracted the archive on your dmgr, then you would issue this command.

${WAS_INSTALL_ROOT}/profiles/your_profile/bin/wsadmin.sh -conntype NONE -f /path/to/ConfigDump.py


If you are making a remote connection to your dmgrs, use this command.

${WAS_INSTALL_ROOT}/profiles/your_profile/bin/wsadmin.sh -host DLCSWAS001 -port 40480 -username xwassystemid -password your_password -f /path/to/ConfigDump.py


Upon completion of this script, a file named ${CELL_NAME}-yy-mm-dd-hh-mm-ss.cfg file will be created in the present working directory.


Specify output file and directory

If you want to specify the name and location of the configuration file that is created by the ConfigDump.py script, simply include the name and locate of the configuraiton file.

${WAS_INSTALL_ROOT}/profiles/your_profile/bin/wsadmin.sh -conntype NONE -f /usr/local/scripts/cct/ConfigDump.py /path/to/example.cfg


Create HTML files

At the bear minimum, the following command is used to create the HTML files for a cell. You must have version 2.7 or higher of Python installed on your system. In this example, the ConfigReport.properties files determine which configuration files will be used, which HTML files will be created, and where the HTML files will be stored.

python /path/to/ConfigReport.py /path/to/ConfigReport.properties


Define the configuration file(s) you want to use

By default, the ConfigReport.properties will be configured to look for files matching *.cfg in the present working directory. If you want to specify the configuration file(s) that will be used, you can add ConfigurationDumpFiles on the command line. Or, you can update the ConfigReport.properties file with the path.

python /path/to/ConfigReport.py /path/to/ConfigReport.properties ConfigurationDumpFiles=/path/to/example1.cfg,/path/to/example2.cfg


Define the reports you want to create

By default, the ConfigReport.properties will be configured to create the following reports. You can update the ConfigReport.properties file if you want to only create some of these reports.

  • AllServers
  • Applications
  • EJBTimerDataSources
  • NodeAgent
  • Resources
  • ResourcesNotMatched
  • Summary


Directory for HTML files

By default, the ConfigReport.properties file is configured to create a directory named output in your present working directory, and to store the HTML files in the "output" directory. If you want the HTML files to reside in some other directory, you can add ConfigurationReportOutputPath on the command line. Or, you can update the ConfigReport.properties file with the path.

python /path/to/ConfigReport.py /path/to/ConfigReport.properties ConfigurationReportOutputPath=/path/to/where/you/want/to/store/the/html/files


The HTML files created can be placed on a web server. For example, in the All Servers report, you can quickly see if the JVMs in the cell have different configurations.

Add a Comment

We will never share your name or email with anyone. Enter your email if you would like to be notified when we respond to your comment.

Please enter in the box below so that we can be sure you are a human.