Migrating iPlanet Application Builder Projects

To migrate your iPlanet Application Builder projects to the Forte for Java integrated development environment, you must:
  1. Prepare a project for importation
  2. Unregister the project EAR file
  3. Import the J2EE web/EJB module

To prepare a project for importation:

  1. Open the project in the iPlanet Application Builder tool.
  2. From the Project menu, select Package as EAR.

    The Package as EAR dialog appears.

  3. Uncheck the filetring option "Do not include source code files". You need to include the source files so the project will compile and run properly in the Forte for Java interface.

To unregister the iAB project EAR file:

Use the DeployTool command line interface iasdeploy removeapp command to remove the deployed J2EE EAR file from the application server instance. The removal process deletes all associated entries from the iPlanet Application Server registry and related files from the deployment area of the application server instance.
  1. At a command tool prompt type:

    iasdeploy removeapp [-host <hostname> -port <portnumber>] [-user <username> -password <password>] <EAR file>

    For example, to remove the iAB tutorial cdx.ear file, the command would be:

    iasdeploy removeapp [-host pc54143 -port 10817] [-user admin -password iplanet] cdx.ear

    Where:
    pc54143 is the hostname
    10817 is the port number
    admin is the username
    iplanet is the password
    cdx.ear is the ear file to be removed

To import the iPlanet Application Builder J2EE web/EJB module:

  1. From the Forte Explorer mount a web module and an EJB module.
  2. Select the newly mounted web module directory.
  3. From the Tools menu select Import J2EE Modules from iAB Project...

    The Select iAB Project root directory dialog appears.

  4. Navigate to the location of the iPlanet Application Builder project.
  5. Select the iAB project directory and select Open.

    The Select root for imported web module dialog appears:

  6. Navigate to the location of the web module directory you mounted earlier.
  7. Select the web module directory and select Open.

    You may be prompted with a dialog that says the web module view is being modified.

  8. Select OK to dismiss the dialog.

    If you have an associated EJB module, you are prompted to identify the root imported EJB(s).

  9. Select the EJB module directory you mounted earlier to locate the imported EJB module.

    Notice, in the Explorer, the web module directory is populated with the imported iPlanet Application Builder web module files. Likewise, the EJB module directory is populated with the iPlanet Application Builder EJB module files.

  10. Create a new J2EE application (ear file).
  11. Right click on an application node and select Add Module... to add a web module and/or an EJB module.

    Specify the web context for a web module node inside of the application node.

  12. Right click and select Deploy to deploy the application as an .ear file to the specified default application server.
  13. From the web module, select Execute if you wish to execute your web module.
See also
Using Advanced Features

Legal Notices