Migrating from Workshop for WebLogic 9.2

Workspaces and projects created with version 9.2 must be migrated to version 10.0 in order for you to use version 10.0 to continue developing and testing projects in the workspace. After migration, migrated projects will no longer run in versions prior to 10.0.

During migration, the IDE updates project metadata, moves your facets to version 10.0, and requires a version 10.0 server.

Note: For information on upgrading from version 8.1 to version 10.0, see Upgrading WebLogic Workshop 8.1 Applications.

How to Migrate to Version 10.0

When you open a workspace created with Workshop for WebLogic version 9.2, the IDE will prompt you to migrate projects in the workspace. In addition, you will need to make any changes needed to support the version 10.0 domain, such as updating the wl_home value in the domain start scripts.

To Do in Version 9.2 Before Opening in Version 10.0

To avoid errors in version 10.0, you should be sure to do the following with your workspace in version 9.2 before migrating the workspace:

• Close the version 9.2 Workshop perspective if it's open. For details, see Workbench Layout Error Due to Absence of Workshop Perspective.
• Ensure that all projects are open. It's possible to "close" a project in the IDE while leaving it in the workspace. Closed projects might create errors when you open the workspace in version 10.0.

  If you want to migrate only certain projects, you can do so by removing the other projects (the ones you'd have closed) from the workspace before migrating (note that you can do so without deleting the removed projects from disk). You can later migrate the removed projects by importing them from the existing workspace.

• Check out all source artifacts from source control. For more information, see Check Out Source Artifacts from Source Control Before Migration.
• All applications must be undeployed before upgrading 9.2 domains in order for the migrated applications to be succesfully redeployed. You may use the WebLogic console to list and remove existing applications.

Changes Related to Migration

Check Out Source Artifacts from Source Control Before Migration

As a best practice, be sure to check out version 9.2 sources before migrating to version 10.0. While source control integration from the IDE will, in most cases, work to check out files that must be writable, in some cases this is not done.

Workbench Layout Error Due to Absence of Workshop Perspective

If you open a workspace in version 10.0 that was closed in version 9.2 while the Workshop perspective was open, you will see an error such as "Problems occurred restoring workbench." The Workshop perspective has been removed in version 10.0 in favor of the standard J2EE perspective (the two perspectives were very similar). To work around this error, do one of the following:

• Before opening the version 9.2 workspace in version 10.0, be sure the Workshop perspective is closed. To do this, in version 9.2 right-click the Workshop perspective button, then click Close. After closing the Workshop perspective, you can close the IDE and safely open the workspace in version 10.0.

  

• If you have already started to open the 9.2 workspace in version 10.0 and receive the error message, dismiss the error dialog and open the J2EE perspective (which is the version 10.0 default).

JSP and HTML Validation Is More Strict

A stricter validation of JSP and HTML markup might cause errors in source view in cases where version 9.2 was more permissive. For example, in version 10.0 the following code will display errors because it mixes <p> and <center> blocks:

<p>
<center>
</p>
</center>

Note that this code will still run on WebLogic Server.

Complete Workspace "Clean" Might Be Required

After migration, you might see errors in your version 10.0 workspace. In some cases, you can remove these by performing a complete clean of all projects in the workspace. To do this, click Project > Clean, then in the Clean dialog, select the Clean all projects option and click OK.

Renamed or Moved Libraries are Not Supported for Migration

If you have renamed or moved BEA-provided library JAR files in your version 9.2 workspace, migration of those libraries might fail. This includes libraries that were provided to support project facets.

Related Topics

None.