The Source Summary tool is used to help verify Web Content Management migrations by producing reports to allow you to compare the data repositories of both the source and target servers after migration is completed. It can be used to verify data migrated from version 5.1. to version 6.1.
Installing the Source Summary tool
Target 6.1 server: You will need to install Lotus Web Content Management Cumulative iFix (CF) 11 for WCM 6.1.0.1, 6.1.0.2 or higher to obtain the Source Summary tool.
Source 5.1 server: After installing the Cumulative iFix on your version 6.1. server. Go to the WAS Administrative Console
Administration > Enterprise Applications on your versions 5.1. server and install the wcm-sourcesummary.5.1.war file from PortalServer/wcm/prereq.wcm/wcm/migration/sourcesummary/ folder of your version 6.1 server. The context root will be used to access the servlet, and will need to be specified in the next step. (i.e. wps/wcmsummary).
Configuring the Source Summary tool
On the target 6.1 server, edit the following properties in the migration.properties located under /PortalServer/wcm/migration/config/:
summary.servlet.url: Enter the URL to the servlet installed on the 5.1 server. You need to enter the host name and default port into the supplied value.
i.e. http://[HOST]:[PORT]/context root/reporter
report.library.name: Enter the name of library on the 6.1 server to generate a summary for.
report.file.name: Enter the name of the file to contain the report. This will be located in the summary path defined by the property summary.path.
report.single.file.output=
true/false: Specify whether to include all item types in the same file or place them in separate files. It is recommend to specify false so that multiple files are created to make comparisons easier.
report.generate.row.count=
true/false: Specify whether to include summary counts. Set this to true to generate row counts. Note: this may make sorting difficult.
report.date.format.pattern = yyyy.MM.dd HH:mm:ss Running the Source Summary tool
To create a Source Summary report for your source 5.1 server, enter the following from the was_profile_root/PortalServer/wcm/migration/ directory of your 6.1 server.
- Windows: wcmmigrate.bat -u username -p password export-5.1-summary
- UNIX: ./wcmmigrate.sh -u username -p password export-5.1-summary
- i5/OS: wcmmigrate.sh -u username -p password export-5.1-summary
To create a Source Summary report for your target 6.1 server, enter the following from the was_profile_root/PortalServer/wcm/migration/ directory of your 6.1 server.
- Windows: wcmmigrate.bat -u username -p password export-6.x-summary
- UNIX: ./wcmmigrate.sh -u username -p password export-6.x-summary
- i5/OS: wcmmigrate.sh -u username -p password export-6.x-summary
The output will be in the summary path as configured in migration.properties on the 5.1 server and the 6.1 server, respectively. The filename will be the report name that you specified in migration.properties (e.g., summaryreport.csv)
Load the output files into a spreadsheet application and compare them.
Troubleshooting the Source Summary tool
- All the properties in migration.properties must be correct. Run the "validate" wcmmigrate task to confirm that the values in the migration.properties file are still correct.
- Diagnostic logging goes to the migration.log on the target system, even for the source summary report.