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. Right click and select Tools -> 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. Select the EJB module node.
  11. Right click to display the context menu and select Properties.

    The EJB Properties dialog appears.

  12. Select the Application Servers field to display the button and select it.

    The Property Editor appears:

  13. Select the iPlanet Application Server checkbox and select OK.

You are now ready to deploy the EJB module to the iPlanet Application Server. You must deploy the EJB module before you execute the Web module in order to enable the web module to call the EJB. See the online help for more detailed instructions on debugging, deploying, and executing an EJB module.

You can also deploy and execute the web module. But, first you must select "Switch Web Execution to iPlanet Application Server" from the Tools menu. This ensures the web module execution is against the iPlanet Server. You can then execute the web module by selecting Execute from the Build menu. See the online help for more detailed instructions on debugging, deploying, and executing a web module.

See also
  Using Advanced Features
Debugging a Web Module
Debugging an EJB Module

Legal Notices