Setting up Admin Center

Admin Center is a web user interface that runs on Liberty V8.5.5.2 and later servers. After installing Liberty and creating a server, configure the server.xml file.

Before you begin

Install WebSphere Application Server Liberty with Liberty Administrative Center ("Admin Center"). The Installing Liberty Repository assets topic lists the ways to install assets such as Admin Center. The quickest way to install Admin Center is to run the installUtility command or the featureManager command:

  1. If you have not done so already, install WebSphere Application Server Liberty V8.5.5.2 or later.
    Restriction: Ensure that you use a Java virtual machine (JVM) that supports Liberty products and Secure Sockets Layer (SSL). Do not use an IBM JVM available with a WebSphere® Application Server traditional product, such as Network Deployment, for your Liberty installation with Admin Center. By default, the IBM JVM available with a traditional product points to security classes that are available only with a traditional product, and not to security classes needed by Admin Center. Using an IBM JVM available with a traditional product can cause Admin Center to not display in a browser.
  2. Open a command window at the main directory of the Liberty installation. For example, open a command window at c:\wlp.
  3. Run a command to install the adminCenter-1.0 feature.
    For Version 8.5.5.6 or later, run the installUtility command:
    bin/installUtility install adminCenter-1.0
    For Version 8.5.5.5 or earlier, run the featureManager command:
    bin/featureManager install adminCenter-1.0 --when-file-exists=ignore

For more information, go to the WASdev website, select the Downloads tab, and search the Liberty repository for the Admin Center asset.

To install Admin Center on hosts that cannot access the internet-based Liberty repository, first install Liberty and the Admin Center feature on a host that can access the internet. Then transfer the installation to the target hosts. For information about packaging Liberty servers and runtimes for deployment to other hosts, see Packaging a Liberty server by using developer tools and Packaging a Liberty server from the command line.

About this task

You can set up Admin Center on stand-alone servers and on collective controllers. This topic focuses on setting up a stand-alone Liberty server.

To enable Admin Center on a collective controller, see Configuring a Liberty collective. Ensure the server.xml file of the collective controller includes <feature>adminCenter-1.0</feature> in the feature manager configuration and sets a host value in the httpEndpoint element, such as host="*" so all hosts can access the collective controller.

Procedure

  1. If your Liberty installation does not have a server, create a Liberty server.

    For example, in a command window at the wlp/bin directory, create a server named myServer.

    server create myServer

    The example command adds server files to the wlp/usr/servers/myServer directory.

  2. Open an editor on the server.xml file of the Liberty server, and configure the server for Admin Center.
    1. Add the adminCenter-1.0 feature to the feature manager.
      <featureManager>
         <feature>adminCenter-1.0</feature>
      </featureManager>
    2. Add one or more users to configure a secure login. For example:
      <quickStartSecurity userName="admin" userPassword="adminpwd" />
      If user names or passwords include non-English characters, create the jvm.options file for the server and define the default client encoding as UTF-8:
      -Ddefault.client.encoding=UTF-8
      For information about the jvm.options file, see Customizing the Liberty environment.
    3. To protect keystore files that have server authentication credentials, define a keystore and assign it a password.
      <keyStore id="defaultKeyStore" password="Liberty" />

      For an example server.xml file that defines an Administrator and a non-Administrator and that defines a keystore, see the Example in this topic. For information about defining multiple administrative users, see Setting up BasicRegistry and role mapping on Liberty.

    4. To access Admin Center from a smartphone, tablet, or remote computer, ensure that the server.xml file sets the host attribute of the httpEndpoint element to * (asterisk) or to a defined host name. By default, the host attribute is set to localhost.
      <httpEndpoint id="defaultHttpEndpoint"
                    host="*"
                    httpPort="9080"
                    httpsPort="9443" />
    5. Save your changes to the server.xml file.

      If you defined the default client encoding as UTF-8 for non-English characters in the jvm.options file and the user registry is in quickStartSecurity or basicRegistry elements, which store user names and passwords in the server.xml file, then save the server.xml file in UTF-8 encoding.

  3. If the server is not running, start the server.

    For example, in a command window at the wlp/bin directory, enter a run or start command.

    server run myServer

    Look for server messages that show the adminCenter web application is running. After Admin Center is running, you can point a web browser at the application and log in. See Logging in to Admin Center.

    Multimedia Watch: The Setting up Admin Center video demonstrates the procedure. [Transcript]

Example: server.xml file that defines two authorized users

<server description="new server">

   <!-- Enable features -->
   <featureManager>
      <feature>adminCenter-1.0</feature>
   </featureManager>

   <!-- Define the host name for use by the collective.
        If the host name needs to be changed, the server should be
        removed from the collective and re-joined. -->
   <variable name="defaultHostName" value="localhost" />

    <!-- Define an Administrator and non-Administrator -->
   <basicRegistry id="basic">
      <user name="admin" password="adminpwd" />
      <user name="nonadmin" password="nonadminpwd" />
   </basicRegistry>

   <!-- Assign 'admin' to Administrator -->
   <administrator-role>
      <user>admin</user>
   </administrator-role>

   <keyStore id="defaultKeyStore" password="Liberty" />

   <httpEndpoint id="defaultHttpEndpoint"
                 host="*"
                 httpPort="9080"
                 httpsPort="9443" />

</server>

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: Saturday, 3 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_ui_setup
File name: twlp_ui_setup.html