Defining the installed server runtime environments preferences

Using the Preferences page, you can direct the workbench to use a specific runtime environment of an application server for compiling your application. You can complete this by defining the installation directory of the server:
  1. From the Window menu, select Preferences.
  2. In the Preferences window, expand the Server folder and then select Installed Runtimes. The Installed Server Runtime Environments section of the Preferences dialog is displayed.
  3. Optional: Click the Search button. This searches your local directory for installed server runtime environments. Searching on a remote host is not supported.
    1. The Search for Runtimes dialog box opens. In the Folder field, browse or type the directory where you would like the workbench to start searching for installed server runtime environments. Click OK.
    2. If a list of installations is displayed, select the desired target server and click OK in the displayed dialog; then click OK in the Preferences dialog. If no installations of any application servers are found, continue completing the steps for this task.
  4. Click Add. The New Server Runtime wizard opens.
    1. Select the target server runtime and click Next. The product_name Runtime panel is displayed.
    2. For Installation directory or Location field, type or browse to the location of the target server.
      Tip: If you specify a false location for the target server, use the workbench to assemble modules and then use the application server to deploy the modules.
      If you selected the target server as J2EE Runtime Library (a generic J2EE container), specify a directory that contains .jar files such a \bin\lib directory for a Java™ development kit installation.
    3. Click Finish. The target server name and type is added to the table in the Installed Server Runtime Environment section.
    4. In the Preferences dialog, click OK.

To change the list of available target servers, click Window > Preferences > Server > Installed Runtimes to go to the Installed Server Runtime Environments section of the Preferences dialog. Use the Add, Edit, Remove or Search options to change the list of target servers as needed.

To change the target server for a module:
  1. Right-click on the module in the Project Explorer view and click Properties > Project Facets. The Project Facets page opens.
  2. Select the Add/Remove Project Facets button. The Add/Remove Project Facets dialog box opens.
  3. Select the Show Runtimes button.
  4. Under the Runtimes table, select the target servers for the module.
Important: If you change the target server for an EJB project, regenerate the deployment code. Right-click the EJB project, and select Prepare for Deployment. If you attempt to run an application on a server target that is different from its generated deployment code, the application fails to run.

Feedback