SupportConsoleDevelopersStart a trialContact

Chapter 27. Managing servers

The Servers panel enables you to run and manage servers in your Red Hat Developer Studio environment. The supported servers are:
  • Red Hat JBoss Fuse Server—versions 6.x
  • Apache Karaf Server—versions 2.x, 3.0
  • Apache ServiceMix Server—versions 4.5, 5.x
Note
For step by step instructions on how to publish a Camel project to Red Hat JBoss Fuse, see Red Hat JBoss Fuse Tooling Tutorials, To Publish a Fuse Project to Red Hat JBoss Fuse.

27.1. Adding a Server

Overview

For the tooling to manage a server, you need to add the server to the Servers list. Once added, the server appears in Servers panel, where you can connect to it and publish your Fuse projects.
Note
If adding a Red Hat JBoss Fuse 6.0 or 6.1 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

You can add a new server to the Servers panel in three ways:
  • In Servers panel, click the link No servers are available. Click this link to create a new server....
    Note
    This link appears in Servers panel only when no server has been defined.
  • Right-click in Servers panel to open the context menu, then select New Server.
  • On the menu bar, select File New Other Server Server.
  1. In the Define a New Server dialog, expand the JBoss Fuse node to expose the list of available server options:
  2. Click the server you want to add.
  3. In Server's host name, accept the default (localhost).
    Note
    The address of localhost is 0.0.0.0.
  4. In Server name, accept the default, or enter a different name for the runtime server.
  5. Click Next > to open the server's Runtime definition page:
    Note
    If the server is not already installed on your machine, you can install it now by clicking the link Download and install runtime... and following the site's download instructions. Depending on the site, you may be required to provide valid credentials before you can continue the download process.
  6. Accept the default for Name.
  7. In Home Directory, enter the path where the server runtime is installed, or click Browse to find and select it.
  8. Select the runtime JRE from the drop-down menu next to Execution Environment.
    If the version you want does not appear on the list, click the Environments button and select the version from that list. The JRE version you select must be installed on your machine.
    Note
    JBoss Fuse 6.2 requires either JRE versions 1.7 or 1.8.
  9. Leave the Alternate JRE option as is.
  10. Click Next > to save the server's runtime definition and open its Configuration details page:
  11. Accept the default for SSH Port (8101).
    The runtime uses the SSH port to connect to the server's Karaf shell. If this default is incorrect for your setup, you can discover the correct port number by looking in the server's installDir/etc/org.apache.karaf.shell.cfg file.
  12. In User Name, enter the name used to log into the server.
    In the case of Red Hat JBoss Fuse, this is a user name stored in the Red Hat JBoss Fuse installDir/etc/users.properties file.
    Note
    If the default user has been activated (uncommented) in the /etc/users.properties file, the tooling autofills User Name and Password with the default user's name and password, as shown in Step 10. The default user is already activated in JBoss Fuse 6.2, but not in JBoss Fuse 6.0 or 6.1.
    If one has not been set, you can either add one to that file using the format user=password,role (for example, joe=secret,Administrator), 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> Administrator—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.
  13. In Password, enter the password required for User Name to log into the server.
  14. Click Finish.
    The server runtime will appear in Servers panel. For example:
    Expanding the server node exposes the server's JMX node:

Related topics

Define a New Server
New Server Configuration
Add and Remove
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.