Run/Debug Configuration: JSR45 Compatible Server
Use this dialog to create or edit run/debug configurations for JSR45-compatible application servers.
Generally, you may want to use this type of run/debug configuration under the following conditions:
- The server you are going to work with supports JSR-45.
- IntelliJ IDEA doesn't provide a dedicated plugin for integration with this server.
On this page:
Server tab
Item | Local/Remote | Description |
---|---|---|
Application Server | Both |
Select the server configuration to be used.
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.) |
Start browser | Both | Select this check box to run the default Web browser to study your application output there. |
With JavaScript debugger | Both |
If this check box is selected, the Web browser is started with the JavaScript debugger enabled.
JavaScript debugging is available for Firefox only. Note that when you debug your JavaScript in Firefox for the first time, the JetBrains Firefox extension will be installed. |
Startup page | Both | In this field, specify the URL the browser should go to when started. In most typical cases, this URL will correspond to the root of your Web application or its starting page. |
VM options | Local | If necessary, specify the command-line options to be passed to the server JVM at the server start.
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:
|
On 'Update' action | Local | Select the action to be performed when the application is updated in the Run or the Debug tool window (). |
Show dialog | Local |
Select this check box if you want to see the Update <application name>
dialog every time you perform the Update action.
The Update <application name> dialog is used to view and change the current update option (for example, Restart server) prior to actually updating the application. |
JSP's package | Both | Specify the Java package prefix to be used for jsp-to-servlet translation. |
VM options variable | Local | If there is a variable which stores the command-line JVM options, you can specify the name of this variable in this field. In this way, you can pass the corresponding options to the server JVM at the server start. |
Port | Both | Specify the HTTP server port. |
Use JSP's line mapping model specific for WebSphere 5.1 | Both | If the run/debug configuration is intended for working with WebSphere Server 5.1,
select this check box to be able to debug your JSPs.
(To be able to debug JSPs, itβs necessary to maintain relationships between the lines of the source files and the corresponding positions in the compiled code. All the servers except WebSphere 5.1 form such relationships similarly.) |
Host | Remote | The DNS name or the IP address of the server host (for example, localhost ,
127.0.0.1 , etc.). |
Logs tab
Use this tab to specify which log files generated while running or debugging should be displayed in the console, that is, on the dedicated tabs of the Run or Debug tool window.
Item | Description |
---|---|
Is Active | Select check boxes in this column to have the log entries displayed in the corresponding tabs in the Run tool window or Debug tool window. |
Log File Entry | The read-only fields in this column list the log files to show. The list can contain:
|
Skip Content | Select this check box to have the previous content of the selected log skipped. |
Save console output to file | Select this check box to save the console output to the specified location. Type the path manually, or click the browse button and point to the desired location in the dialog that opens. |
Show console when a message is printed to standard output stream | Select this check box to activate the output console and bring it forward if an associated process writes to Standard.out. |
Show console when a message is printed to standard error stream | Select this check box to activate the output console and bring it forward if an associated process writes to Standard.err. |
Click this button to open the Edit Log Files Aliases dialog where you can select a new log entry and specify an alias for it. | |
Click this button to edit the properties of the selected log file entry in the Edit Log Files Aliases dialog. | |
Click this button to remove the selected log entry from the list. | |
Click this button to edit the select log file entry. The button is available only when an entry is selected. |
Code Coverage tab
Use this tab to configure code coverage monitoring options.
Note that this tab is not available for remote servers.
Startup/Connection tab
Item | Local/Remote | Description |
---|---|---|
Run Debug | Both | Select Run or Debug to show settings either for the run or the debug mode. |
Run with Coverage | Local | Select Run with Coverage to show settings for run with coverage mode. |
Startup script | Local |
Specify the script to be used to start the server.
If necessary, you can also specify the script parameters and the options to be passed to the server JVM.
You can provide all the necessary information right in the field, by typing. As an alternative:
|
Shutdown script | Local |
Specify the script to be used to stop the server.
If necessary, you can also specify the script parameters and the options to be passed to the server JVM.
You can provide all the necessary information right in the field, by typing. As an alternative:
|
Pass environment variables | Local | To pass specific variables to the server environment, select this check box and specify the variables: |
Port | Local | Use this field to change the debugger port (if necessary). |
Debugger Settings | Local | Click this button to edit the debugger options on the Debugger page of the Settings dialog. |
Transport | Remote |
Specify the "transport" settings for the connection with the debugger. In technical terms,
these are the parameters for the -Xrunjdwp command-line option:
Note that as you change the transport settings,
what follows |
Before Launch options
Specify which tasks should be carried out before starting the run/debug configuration.
Item | Shortcut | Description |
---|---|---|
Alt+Insert |
Click this icon to add a task to the list. Select the task to be added:
| |
Alt+Delete | Click this icon to remove the selected task from the list. | |
Enter | Click this icon to edit the selected task. Make the necessary changes in the dialog that opens. | |
Alt+Up/Alt+Down | Click these icons to move the selected task one line up or down in the list. (The tasks are performed in the order that they appear in the list.) | |
Show this page | Select this check box to show the run/debug configuration settings prior to actually starting the run/debug configuration. | |
Activate tool window |
If this check box is selected,
the Run or the Debug tool window opens
when you start the run/debug configuration.
Otherwise, the tool window isn't shown. However, when the configuration is running, you can open the corresponding tool window for it yourself if necessary. |
Toolbar
Item | Shortcut | Description |
---|---|---|
Alt+Insert | Create a run/debug configuration. | |
Alt+Delete | Delete the selected run/debug configuration. | |
Ctrl+D | Create a copy of the selected run/debug configuration. | |
View and edit the default settings for the selected run/debug configuration. | ||
Alt+Up/Alt+Down | Move the selected run/debug configuration up and down in the list.
The order of configurations in the list defines the order in which the configurations appear in the corresponding list on the main toolbar. | |
You can group run/debug configurations by placing them into folders.
To create a folder, select the configurations to be grouped and click . Specify the name of the folder. Then, to move a configuration into a folder, between the folders or out of a folder, use and . You can also drag a configuration into a folder. To remove grouping, select a folder and click . See also, Creating Folders and Grouping Run/Debug Configurations. |