Run/Debug Configuration: WebLogic

If the run/debug configuration is intended for working with a remote server, the same server version should be configured locally and associated with the run/debug configuration.

Click Configure to create a new server configuration or edit an existing one. (The Application Servers dialog will open.)

If you need more room to type, click next to the field to open the VM Options dialog where the text entry area is larger.

When specifying the options, follow these rules:

• Use spaces to separate individual options, for example, -client -ea -Xmx1024m.
• If an option includes spaces, enclose the spaces or the argument that contains the spaces in double quotes, for example, some" "arg or "some arg".
• If an option includes double quotes (e.g. as part of the argument), escape the double quotes by means of the backslashes, for example, -Dmy.prop=\"quoted_value\".

The Update <application name> dialog is used to view and change the current update option prior to actually updating the application.

Also specify which of the server instances in your WebLogic domain should be started and provide the associated settings. Note that the server instance that is started is also the one to which your project artifacts are deployed.

The available options depend on the domain structure:

• The domain contains only one WebLogic Server instance, the Administration Server:
  • Admin Server. Select the name of the Administration Server from the list.
• The domain contains the Administration Server and one or more Managed Servers:
  • Server to launch. Select the type of the server instance that should be started and specify the associated settings:
    • Admin. The Administration Server.
      • Admin Server. Select the name of the Administration Server from the list.
    • Managed. One of the Managed Servers.
      • Managed server. Select the name of the desired Managed Server from the list.
      • Admin server host. Specify the name or the IP address of the Administration Server host. If the Administration Server is installed on your local computer, this may be localhost or 127.0.0.1.
      • Admin server port. Specify the Administration Server port.

      Note

      By the time you execute the run/debug configuration which starts a Managed Server, the Administration Server in the corresponding domain must be already up and running.

• To add an artifact, select Artifact and choose the desired artifact in the dialog that opens.
• To add an external resource, select External Source and choose the location of the desired resource in the Select Path dialog.

In the field underneath the check box, specify the absolute path to the file. Alternatively, use  (Shift+EnterShift Enter) and select the necessary file in the Select Path dialog.

Use Add Class or Add Package to add classes or packages to the list.

To remove the classes or packages from the list, select the corresponding list items and click Remove.

Use default:

• If this check box is selected, the default script is used.

   in this case opens the Default Shutdown Script dialog which shows the contents of the Shutdown script field (readonly).

• Clear this check box to change the parameters passed to the script or to specify a different script:
  • To specify the script, click and select the desired script in the Select Path dialog.
  • To specify the parameters, click and specify the script parameters and VM options in the Configure VM and Program Parameters dialog.

    When specifying the parameters and options, follow these rules:

    • Use spaces to separate individual parameters and options, for example, -client -ea -Xmx1024m.
    • If a parameter or an option includes spaces, enclose the spaces or the argument that contains the spaces in double quotes, for example, some" "arg or "some arg".
    • If a parameter or an option includes double quotes (e.g. as part of the argument), escape the double quotes by means of the backslashes, for example, -Dmy.prop=\"quoted_value\".

• Socket. Specify the debugger port in the Port field. The combination of these two settings translates into
  -Xrunjdwp:transport=dt_socket,address=<port>,suspend=n,server=y
• Shared memory. Specify the shared memory address in the corresponding field. The combination of these two settings translates into
  -Xrunjdwp:transport=dt_shmem,address=<address>,suspend=n,server=y

Note that as you change the transport settings, what follows transport= within -Xrunjdwp in the area above also changes. In this way you control the corresponding command-line debugger parameters which you cannot edit directly.

• Make. If this check box is selected, the project is compiled automatically prior to running or debugging. This option helps you ensure that all changes are included and compiled.
• Build Artifacts. If this check box is selected, the specified artifacts will be built prior to running or debugging. To define the artifacts to be built, click and select the desired artifacts.
• Run Ant target. If this check box is selected, the specified Ant target will be built prior to running or debugging. To define the Ant target, click and select the desired target.

  To learn more about Ant support, refer to the Ant Support section.

• Run Maven goal. If this check box is selected, the specified Maven goal will be executed prior to running or debugging. To define the Maven goal to be executed, click and select the desired goal.

  To learn more about Maven support, refer to the Maven Support section.

• Show settings. Select this check box if you want the Run/Debug Configurations dialog to be shown every time you launch this run/debug configuration.

The order of configurations in the list defines the order in which the configurations appear in the corresponding list on the main toolbar.