Chapter 5. Setting Up the Server

To make it possible for the tooling to manage a server, you need to add it to the Servers list. You can set up target runtime server using the Servers view. Once added, the server is displayed in the Servers view. Selecting a server in Servers view, enables you to start it, to stop it, or to delete its configuration. You can add multiple servers of the same type, as long as each uses a separate installation directory.

Note

If you have added a default runtime server when installing JBoss Developer Studio, you can see it in the Servers view.

5.1. Add JBoss EAP Server

  1. In JBoss Developer Studio, click the Servers view. If the Servers view is not visible, click WindowShow ViewServers.
  2. If no servers have been previously created then the Servers view displays a new server hyperlink. Click this link to create a new server.
    If there are one or more existing servers, right-click an existing server and click NewServer.
  3. In the Define a New Server dialog, select a JBoss Enterprise Application Platform server from the Select the server type list.
  4. The Server's host name and Server name fields are completed by default. In the Server name field, you can type a custom name by which to identify the server in the Servers view.
  5. From the Server runtime environment list, select an existing server runtime environment for the application server type. Alternatively, to create a new runtime environment click Add and complete the fields and options as appropriate.

    Note

    If the Server runtime environment field is not shown, no server runtime environments exist for the selected application server type. To create a new server runtime environment without canceling the wizard, click Next and complete the fields and options as appropriate.
  6. Click Next.
  7. The server behavior options displayed vary depending on the selected application server type. To specify that the server life-cycle is to be managed from outside the IDE, select the Server is externally managed check box.
    To specify that the server should be launched to respond to requests on all hostnames, select the Listen on all interfaces to allow remote web connections check box.
    From the location list, select Local. Click Next.

    Note

    The Expose your management port as the server's hostname option, which enables management commands sent by the IDE to be successfully received by the server, is bypassed for local servers regardless of whether the check box is selected.
  8. To select applications to deploy with this server, from the Available list select the applications and click Add. Applications to be deployed are detailed in the Configured list.
  9. Click Finish to create the server.
Result

The new server appears in the list of servers in the Servers panel.

Important

You can create multiple servers that use the same application server. But a warning is displayed if you try to simultaneously run more than one server on the same host. This is because multiple running servers on the same host can result in port conflicts.