Chapter 5. Installing and Securing the Management Console


Abstract

The management console an be installed directly into any Apache Karaf container using the feature mechanism.
The management console can be installed into any Apache Karaf container. Standalone containers install it using the feature mechanism. Fabric containers install it by applying the management console's standard profile to one of the containers in the fabric.
In a standalone container, you will need to either create a new fabric for the console to manage or have the server join an existing fabric.
When the management console is installed into a Fabric container, the console is automatically configured to manage the fabric to which the container belongs.

5.1. Installing into a Standalone Container

Procedure

To install the management console into a standalone container:
  1. Open the container's command console.
  2. Check if the prerequisites are installed using the features:list command.
  3. If any of the prerequisites are not installed, install them using the features:install command.
  4. Install the management console using the features:install command shown in Example 5.1, “Installing the Management Console”.

    Example 5.1. Installing the Management Console

    >features:install fabric-webui
  5. In your Web browser, open the management console.
    The management console will be hosted at the container's HTTP service port as specified by the org.ops4j.pax.web PID's org.osgi.service.http.port property. The default HTTP port for an Apache Karaf container is 8181.
  6. Connect the console to a Fabric.
    • Join an existing fabric.
      1. Click Join.
        A form opens where you enter a fabric server's connection information.
      2. In the Hostname field, enter the name of the machine hosting fabric server for the fabric the console will manage.
      3. In the Port field, enter the port number used to connect to the fabric server for the fabric the console will manage.
      4. In the ZooKeeper Password field, enter the password used to access the registry data for the fabric the console will manage.
      5. Click Join.
        The management connects to the fabric and the login page appears.
    • Create a new fabric.
      1. Click Create.
        A form opens where you enter the information needed to create a new fabric.
      2. In the Username field, enter the name of the user for accessing the console and be used to connect to all of the container's in the fabric.
      3. In the Password field, enter the password for the administrative user.
      4. In the ZooKeeper Password field, enter the password that will be used to secure access to the fabric's registry data.
      5. In the Global Resolver field, select the default policy governing how containers in the fabric report their address to other containers.
      6. In the Local Resolver field, select the policy governing how the container being created reports its address to other containers.
      7. Enter a range of ports over which the fabric can be contacted.
      8. Click Create.
        The console's server creates the fabric and the login page appears.
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.