Configure Servers dialog box

To display the Configure Servers dialog box, choose Tools|Configure Servers. You can also display it by selecting the ... buttons next to the server names on the Server page of the Project|Project Properties dialog box.

Use this dialog box to configure the settings for the servers you want to develop your web and EJB applications.

Left pane

The pane on the left side of the dialog box lists all the servers for which JBuilder finds a registered OpenTool when it starts up.

Servers that appear in dark type are those that already configured. Servers that appear in lighter gray type are those that have not yet been configured. Those that appear in red indicate an error; usually it means the server's library has been read, but the server plugin itself can't be found. (Each server that JBuilder supports has its own plugin that "plugs in" to the JBuilder architecture.)

To begin configuring a server, select the server you want to configure in this pane.

Delete button

To remove a listed server from the left pane, select it and then click the Delete button. You will only be able to delete servers that appear in red and are therefore not valid.

Enable Server

Check the Enable Server check box to enable the server selected in the left pane. You must check Enable Server to make changes to the server settings. When this option is checked, the fields on the General and Custom pages become editable. Disabling a server is useful if you don't want to see it in the various selection lists. Only enabled servers appear on the Server page of the Project|Project Properties dialog box.

When you edit server settings and then click OK to close the dialog box, JBuilder attempts to validate the settings. If the validation fails, a message box appears informing you of the problem. You can prevent the validation attempt from occurring after you've made your edits if you uncheck Enable Server before clicking the OK button. You must check the Enable Server check box, however, before you can select the server your are configuring for use in a project.



General page

The General page contains fields that are common to all servers.

Home directory

The directory where the application server you are configuring is installed.

Main class

The class that is executed when the server is run. For servers that use a non-Java executable, this field won't appear.

Native Executable Launcher

The native executable used to run this server.

VM Parameters

The parameters you want to pass to the virtual machine.

Server Parameters

The parameters you want to pass to the server.

Working Directory

The name and location of a working directory.

Class page

The Class page lists the class files required by the server.

Source page

The Source page lists source files.

Documentation page

The Documentation page lists documentation files.

Required Libraries page

The Required Libraries page lists the libraries the server requires.

Add button

To add a directory to a Class, Source, or Documentation page, click the tab of the page to select it and click Add and the Select One Or More Directories dialog box appears.

When the Required Libraries page is selected, the Add button displays the Select One Or More Libraries dialog box.

Edit button

Use the Edit button to edit a selected directory on the Class, Source, or Documentation page.

Remove button

Use the Remove button to delete the selected item on the Class, Source, Documentation, or Required Libraries page.

Move Up button

Moves a selected item on the Class, Source, Documentation, or Required Libraries page up in the list of items.

Move Down button

Moves a selected item on the Class, Source, Documentation, or Required Libraries page down in the list of items.

Reset To Defaults

Resets the settings in the dialog box to the original settings that are available when JBuilder is installed. JBuilder fills in the fields with default settings. To return to these settings any time, click the Reset To Defaults button. Clicking this button unchecks the Enable Server check box.



Custom page

The Custom page contains fields that are unique to each server, although most servers require that you specify a JDK for the server to use.

Borland Enterprise Server AppServer Edition 5.0.2+

JDK Installation Directory

The directory where the JDK the server uses is installed. Usually this is in the jdk directory in the directory where you installed the server.

Server Name

The name of the server.

Partition Name

The name of the partition.

Add A Management Item Name To The Tools Menu

If you want the Borland Management Agent to appear as an item on the Tools menu in JBuilder, check this option.

Add SonicMQ Broker Item To The Tools Menu

If you want the SonicMQ Broker to appear as an item on the Tools menu in JBuilder, check this option.

Server Realm

The realm of the server.

User Name

The user name to log in to the server.

User Password

The password to log in to the server.

For more information about these fields and the type of information you should enter, see the Borland Enterprise Server documentation.

Borland AppServer 4.5

JDK Installation Directory

The directory where the JDK the Borland AppServer 4.5 uses is installed. For more information about the JDK used, see the Borland AppServer documentation.

WebLogic Application Server 5.1

JDK Installation Directory

The directory where the JDK the WebLogic Server 5.1 uses is installed. For more information about the JDK used, see your WebLogic documentation.

Java Compiler For EJBC Usage

Use External Compiler

Check this check box if you want to use an external compiler to generate stub files instead of the EJBC compiler.

Path

Specify the fully-qualified name of the compiler you want to use. You use the ... button to navigate to the compiler location.

For more information about these options, see your WebLogic documentation.

WebLogic Application Server 6.x+

JDK Installation Directory

The directory where the JDK the server uses is installed. The default JDK directory for WebLogic 6.0 is <bea home>jdk130. For WebLogic 6.x, the default JDK directory is <bea home>jdk131. For WebLogic 7.0, the default JDK directory is <bea home>jdk131_02.

BEA Home Directory

The BEA home directory used by the server.

Domain Directory

The domain directory used by the server. This field is required for WebLogic Server 7.0 and is disabled for all other versions of WebLogic Server

User Name

The user name to log in to the server.

Password

The password to log in to the server.

Domain Name

The name of the domain.

Server Name

The name of the server.

Version

The WebLogic 6.x+ version you are configuring. Use the drop-down list to select the version. This drop-down list is automatically filled in what you enter a valid BEA home directory.

Java Compiler For EJBC Usage

Use External Compiler

Check this check box if you want to use an external compiler to generate stub files instead of the EJBC compiler.

Path

Specify the fully-qualified name of the compiler you want to use. You use the ... button to navigate to the compiler location.

For more specific information about the type of information these fields require, see your WebLogic documentation.

WebSphere Application Server 3.5

IBM JDK Installation Directory

The directory where the IBM JDK used by the server is installed.

DB2 Installation Directory

The directory where the files for DB2 are installed.

WebSphere Application Server Single Server 4.0

IBM JDK Installation Directory

The directory where the IBM JDK used by the server is installed.

DB2 Installation Directory

The directory where the files for DB2 are installed.

WebSphere Application Server Advanced Edition 4.0

IBM JDK Installation Directory

The directory where the IBM JDK used by the server is installed.

DB2 Installation Directory

The directory where the files for DB2 are installed.

iPlanet Application Server 6.x+

Add iPlanet Tools To Tools Menu

Check this option if you want to add iPlanet tools to JBuilder's Tools menu.

JDK Installation Directory

The directory where the JDK used by the iPlanet server is installed. For more information about the JDK required, see your iPlanet documentation.