Migration to VE 1.1: Design Notes


These are some design notes for migration of code from VE 1.0.0 to VE 1.1.0. These are not complete. They are the important migrations issues that have so far been documented.

com.ibm.wtp Renames
The com.ibm.wtp plugins and features have been renamed into org.eclipse.jem plugins. They are now in one plugin called org.eclipse.jem.utilitiy. This is a link to the actual renames required.
Palette XMI restructured (as of VE 1.1 driver N20050621)
The Palette XMI has been restructured to match the GEF palette. The old palette XMI classes will still work but have been deprecated. We want to actually pull out the old XMI classes for VE 1.3. We do have a conversion utility available to perform the conversion. It is quick and easy.

It is important that you do not use any of the new palette structures before conversion. The conversion utility doesn't expect that and may not convert completely because of that.

Here are the instructions:
  1. Create a target Eclipse installation with Eclipse SDK 3.1, GEF 3.1, EMF 2.1, and VE 1.1
  2. Download the conversion utility.
  3. The cleanest thing is to bring up a new workspace, and point the PDE target to the configuration created in (1) above.
  4. Checkout your projects that contain the palette xmi that need to be converted. It doesn't matter if there are compile errors. We won't be running any of the code. We just need access to the xmi files.
  5. Do File->Import...->Existing Projects into Workspace->Select Archive File (radio button)->Browse and select the conversion utility zip file from (2) avove.
  6. Import the ve.migrate.palette.1.1 project into your workspace.
  7. Now make sure no editors are open in your workspace. That seems to work best.
  8. From the Navigator select the palette xmi to convert, bring up the popup menu, select Run As->Run...
  9. From there select the launch configuration called Migrate Palette to 1.1 format. And then hit Run button.
  10. The console should tell you if it worked or not.
  11. Hit Refresh on the folder that contains you xmi file. That will bring in the changes. There will be a backup file that contains the old version before conversion.
  12. Check the changes back in.
  13. After converting them all, and testing using your regular test process, you can get rid of this workspace. You are done.