Upgrading Projects from Workshop Studio Version 3.0

Because the current version of the Workshop group of products integrates the Web Tools Platform (WTP) plugin for project creation, projects created in version 3.0 of the Workshop Studio group of products will not open.

Note: before you upgrade you should close the Workshop perspective if it's open. For details, see Workbench Layout Error Due to Absence of Workshop Perspective.

To convert projects from version 3.0, use the File > Switch Workspace to open the workspace containing version 3.0 projects. When the workbench opens, the AppXplorer view shows no projects.

Click Enable AppXRay on an Existing Project.

Click on the name of the project to convert it. Click OK to proceed. The project will be enabled for later versions of the product.

If there are several projects in the workspace, you can enable the other projects from the Project Explorer view, by right clicking on the project name and choosing Enable AppXRay.

Adding a Dynamic Web Project to an EAR After Importing from Workshop Studio 3.0 Converts the Dynamic Web Project to a Java Utility Project

When a Dynamic Web project imported from Workshop Studio 3.0 is added to an EAR project the Dynamic Web project may be mistakenly converted to a Java Utility Project.

To avoid this conversion, follow the instructions below:

1. Import the project from Workshop Studio 3.0
2. Make sure that there are no read-only files in the project.
3. AppXRay enable the Workshop Studio 3.0 project. (See above for details.)
4. Add the project to a new or an existing EAR project.
   

Workbench Layout Error Due to Absence of Workshop Perspective

If you open a workspace in version 10.x that was closed in Studio version 3.0 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.x 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 Studio version 3.0 workspace in version 10.x, be sure the Workshop perspective is closed. To do this, in Studio version 3.0 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.x.

  

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

Projects with web module earlier than version 2.4 require creation of new projects to use Beehive facets

If you have a web project with a web module before version 2.4, you must create a new project and import your files from the old project in order to enable Beehive facets. (You have to create a new project because Workshop does not allow a project to change its web module version number and because Beehive facets are not supported in projects with web module versions before 2.4.)

To create a new web project, follow the instructions at New Dynamic Web Project Wizard. After you have created a new web project, import your project artifacts from the old project.