Chapter 1. Accessing the Management Console

Abstract

The management console runs in a browser and can be connected to using its Web address. You will need a user name and password to connect to the fabric and use the console.

Overview

The management console runs in most modern browsers. The management console is accessed through a port on the server to which the management console server is deployed. The console will provide a view of the fabric to which the management console server is connected.
Once connected to the console, you will need credentials to log-in and view the fabric being managed.

Deploy and launch the management console

Since JBoss Fuse 6.0, the management console is provided as a standard component of the JBoss Fuse product. There is no need to download it separately. It can be enabled at any time by installing the fabric-webui Karaf feature.
To deploy and launch the management console:
  1. If you have not already created a Fabric server ensemble, create it now, as follows:
    1. If you have not already done so, define one or more user accounts by editing the etc/users.properties file, following the instructions in that file to create one or more entries.
    2. Start up the JBoss Fuse container, by opening a new command prompt and entering the following command: 
      ./bin/fuse
    3. Create a new Fuse fabric (which consists of a single Fabric Server, by default). Enter the following command in the JBoss Fuse container console: 
      JBossFuse:karaf@root> fabric:create
      Note
      If you did not define any user accounts in etc/users.properties prior to running this command, you will now be prompted to create one new account by providing a username and a password.
  2. Install the fabric-webui feature by adding it to the fabric profile. Enter the following console command: 
    JBossFuse:karaf@root> profile-edit --features fabric-webui fabric
  3. Because you have just modified the profile installed on the current container, the fabric agent automatically restarts the container with the new profile configuration. You should see some output like the following at the console window: 
    JBossFuse:karaf@root> profile-edit --features fabric-webui fabric
log4j:WARN No appenders could be found for logger (org.ops4j.pax.web.pax-web-runtime).
log4j:WARN Please initialize the log4j system properly.
log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.
^M
      _ ____                  ______
     | |  _ \                |  ____|             
     | | |_) | ___  ___ ___  | |__ _   _ ___  ___
 _   | |  _ < / _ \/ __/ __| |  __| | | / __|/ _ \
| |__| | |_) | (_) \__ \__ \ | |  | |_| \__ \  __/
 \____/|____/ \___/|___/___/ |_|   \__,_|___/\___|

  JBoss Fuse (6.0.0.redhat-024)
  http://www.redhat.com/products/jbossenterprisemiddleware/fuse/

Hit '<tab>' for a list of available commands
and '[cmd] --help' for help on a specific command.
Hit '<ctrl-d>' or 'osgi:shutdown' to shutdown JBoss Fuse.

JBossFuse:karaf@root>
  4. The management console is now installed and running in the current container.

Access the management console from your browser

To access the management console:
  1. Enter the management console's Web address into your browser's address field.
    The address uses the syntax shown in Example 1.1, “Console Address”.

    Example 1.1. Console Address

    http://hostName:8181
    The default port value is 8181, as shown, but it can optionally be customized by editing the management console's configuration.
  2. In the Username field, enter your user name.
  3. In the Password field, enter your password.
  4. Click Log In.
    You will be logged into the management console and placed on the Containers page.