IBM STG Lab Services - IBM Systems Director Migration Toolkit

Debugging

2009 IBM Corporation 1
IBM Systems Director
Migration Toolkit Debugging Notes
IBM STG Lab Services for System x

IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 2
There are three main folders that contain
the source code: 5.20, 6.1, common.
Setup
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 3
Download the required tools and copy to usmi_tool directory.
Setup, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 4
Download and install Rational Application Developer
Setup, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 5
Use the RAD/Eclipse wizard to
create a new Java project.
Setup, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 6
Create a project for each of the
folders.
Setup, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 7
Right click on build.xml Debug as
(3) ant build
Setup, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 8
Optionally choose the order of operation (clean, build)
Setup, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 9
Set the following environment variables:
ANT_HOME C:\Program Files\IBM\SDP70Shared\plugins\org.apache.ant_1.6.5
FPDNAME <path of migration source code>
TOOLPATH <path of usmi_tools>
Setup, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 10
To begin debugging 5.20, create a file called twgjava.properties with the
contents above, and save the file in the directory <director
installation>/data
Debugging 5.20
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 11
Select the plugin of interest, and add a breakpoint at the desired location.
Debugging 5.20, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 12
Start the export process by issuing smexport a
Note: The executable is found in the directory \5.20\target\staging\bin

Debugging 5.20, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 13
On RAD menu, choose Run Debug remote java application
Debugging 5.20, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 14
Select the project to debug (5.20), update the Host (IP address of director server),
and update the Port (same value as in twgjava.properties). Press Debug
Debugging 5.20, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 15
Wait for the breakpoint to be hit, and then continue stepping through the code
Debugging 5.20, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 16
Debugging 6.1
To begin debugging 6.1, go to the directory <director
installation>\lwi\bin and edit the file launchlwi.bat
Find the line highlighted above, and uncomment the line (i.e. delete rem).
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 17
Select the plugin of interest, and add a breakpoint at the desired location.
Debugging 6.1, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 18
Start the import process by issuing smimport a
Note: The executable is found in the directory \6.1\target\staging\bin

Debugging 6.1, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 19
Select the project to debug (6.1), update the Host (IP address of director server),
and update the Port (same value as in launchlwi.bat). Press Debug
Debugging 6.1, contd
IBM STG Lab Services - IBM Systems Director Migration Toolkit
Debugging

2009 IBM Corporation 20
Wait for the breakpoint to be hit, and then continue stepping through the code
Debugging 6.1, contd