## Adding a Server

Revision History

### Overview

To make it possible for the developer tools to manage a server, it needs to be added to the Servers list. Once added, the server will appear in the Servers view and in the Servers tree in both Project Explorer and Package Explorer.

You can add multiple servers of the same type, as long as each uses a separate installation directory.

| Note
If adding a Red Hat JBoss Fuse server, it's recommended that you edit its `installDir``/etc/users.properties` file and add user information, in the form of `user=password,role`, to enable the developer tools to establish an ssh connection to the server.

### Procedure

To add a new server to the Servers list:

1. From the main menu, select File > New > Other to open the New wizard.

2. Select Server > Server from the list.

3. Click Next>.

4. In the Define a New Server dialog, select the type of server you want to create from the list.

5. In Server's host name, accept the default (`localhost`) or enter the name of the host on which the server runs.

   | Note
   Currently the debugger does not support servers running on remote machines.

6. In Server name, accept the default, or enter a different name for the server.

7. If the Server runtime environment drop-down list is present (when `Red Hat JBoss Fuse 6.x` is selected), accept the default or select another runtime environment from the list.

8. Click Next>.

9. If you have not defined a server of this type before, you must do so now in the New `ServerType` Runtime dialog.

   1. In Installation directory, enter the full path to the server's installation folder.

      The button opens a file browser.

   2. Click Next>.

   Host Name defaults to the address of the machine running the server. For `localhost`, the address is `0.0.0.0`.

10. In Port Name, accept the default (`8101`), or enter the port number that the debugger will use to connect to the server.

11. In User Name, enter the user name that the debugger will use to connect to the server.

    For a Red Hat JBoss Fuse server, this is a user name that is stored in the `installDir``/jboss-fuse-6.0.0.redhat-xxx/etc/users.properties` file.

    If one has not been set, you can either add one to that file using the format `user=password,role` (for example, `admin=admin,admin`), or you can set one using the karaf `jaas` command set:

    - `jaas:realms`—to list the realms

    - `jaas:manage --index 1`—to edit the first (server) realm

    - `jaas:useradd <username> <password>`—to add a user and associated password

    - `jaas:roleadd <username> admin`—to specify the new user's role

    - `jaas:update`—to update the realm with the new user information

    If a jaas realm has already been selected for the server, you can discover the user name by issuing the command `JBossFuse:karaf@root>jaas:users`.

12. In Password, enter the password associated with the user name that the debugger will use to connect to the server.

    For a Red Hat JBoss Fuse server, this is the password set either in the `installDir``/jboss-fuse-6.0.0.redhat-xxx/etc/users.properties` file or by the karaf `jaas` comands.

13. Click Next>.

    The New `ServerType` Add and Remove page opens.

14. Move the resources you want the server to use from the Available column to the Configured column.

15. Click Finish.

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

### Related topics

Define a New Server
New Server Configuration
Add and Remove