Red Hat Training

A Red Hat training course is available for Red Hat Fuse

Chapter 19. Managing servers

Important
The functionality described in this chapter requires installation of the JBoss Fuse Server Extensions feature.
The Servers panel enables you to run and manage servers in your Eclipse environment. The supported servers are:
  • Red Hat JBoss Fuse 6.x Server
  • Apache Karaf 2.x Server
  • Apache ServiceMix 4.x Server
Note
For instructions on how to deploy a camel project to Red Hat JBoss Fuse, see Red Hat JBoss Fuse Tooling for Eclipse Tutorials on the Red Hat Customer Portal.

19.1. Adding a Server

Overview

To make it possible for the tooling 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.
Selecting a server in either Project Explorer or Package Explorer displays its details in Properties 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 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 tooling 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 browse button 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