Running the Application Projects' Migration Wizard

To support you in your efforts to migrate the sources of applications which you developed on SAP NetWeaver 7.0 to a higher SAP NetWeaver version, SAP NetWeaver Developer Studio provides a migration wizard. It automates the migration of the old projects' nature to the one used in the new version of the Developer Studio, and also adapts important artifacts of the applications to enable them so they can be built successfully and be deployable in the new environment.

You have configured the new version of the Developer Studio you are using after the upgrade to connect to the development track where the application projects developed on SAP NetWeaver 7.0 reside. Note that this is the Developer Studio in which you trigger the application project migration wizard.

Running the Wizard by Importing the Application Projects

1. Import the application projects to be migrated into your new workspace in the Developer Studio:
   • If you work with the development infrastructure:
     1. Open the Component Browser view of the Development Infrastructure perspective.
     2. From the development configuration you have imported, select the development components that need to be migrated and choose Sync/Create Project  → Create Project to download the source files to your workspace.
   • If you work with local projects
     1. Start the project import wizard by choosing File → Import… from the main menu.
     2. From the list of options, choose General  → Existing Projects into Workspace and then choose Next.
     3. Browse to the folder where your application projects reside and select all projects you need to migrate.
     4. Choose Finish.

   After completing this step, the Developer Studio automatically detects that the projects need to be migrated and starts the corresponding migration wizard.

2. In the Migrate projects window that appears, select the projects you need to migrate and choose Next.

   All projects are selected by default, so you only need to deselect the ones you do not want to migrate at this point in time.

   After completing this step, the migration wizard attempts to migrate the artifacts of all selected projects.

3. Analyze the status after migration of your application projects using the information displayed on the Migration report screen:
   1. The Migration summary tab displays statistics about the project's state based on the following migration statuses:

      Status	Semantic
      Successfully migrated	The project was successfully migrated to the new project's nature of Developer Studio and can be built with no errors.
      Migrated with warnings	The project is migrated in a way that it can be built successfully in Developer Studio. However, some artifacts of the application have not been migrated automatically and might require manual adaptation.
      Failed to migrate	Unexpected error(s) occurred and as a result, the project cannot be built in Developer Studio. The application must be manually adapted so that it can be built and deployed to the new version of SAP NetWeaver.

   2. To investigate further what caused your project's migration to fail or be executed with warnings, open the Migration details tab and locate the message pertaining to it.

We recommend that you save the migration report as an HTML file for offline viewing of the status of all projects that you tried to migrate. It contains important information about all steps that are successfully performed during migration, as well as all generated warnings and/or error messages.

To do that, keep the Save report checkbox selected and adjust the location where the file should be created using the text field below. Upon completing the wizard, this file is automatically created.

1. Choose Finish to complete the wizard.

Running the Wizard from the Problems View

You can trigger the migration wizard for a particular project at any time using a Quick Fix action from the Problems view in Developer Studio. You can use this method, for example, if you have omitted to migrate a project during the import phase described above.

1. Open the Problems view by choosing Window  → Show View  → Problems from the main menu of Developer Studio.
2. Browse the error messages reported. There should be an error message for your project that reads Project has to be migrated. Quick fix action is available.
3. Right-click the message and choose Quick Fix.
4. In the Quick Fix window that appears, select Migrate project as the fix action to be applied to the project.

   This triggers the migration wizard for the selected project. At the end, you get a report with the status of the project after migration.

After completing the migration wizard for your projects, you might have projects that generated warnings during migration, or that failed to migrate completely. Using the information from the migration report, you need to manually adapt these applications and projects so you can build and deploy them.