Configuring your first Eclipse Amlen server to manage by using the Amlen WebUI

The first time that you log into the Amlen WebUI, you are prompted to submit information about the first Eclipse Amlen server that you would like to manage.

You can use the Get started with IBM Watson IoT Platform - Message Gateway Web UI page to enter configuration details for connecting to the Eclipse Amlen server that you want to manage. If you are the first user to start the Web UI application, this page appears after you accept the license by using a REST Administration API. Otherwise, this page appears the first time a new Web UI administrator logs in. For more information about accepting the license by using a REST Administration API, see Configuring the licensed usage for Eclipse Amlen and accepting the license by using REST Administration APIs.

If you want to manage more than one Eclipse Amlen server, you can configure the Amlen WebUI to manage additional Eclipse Amlen servers by using the Server ID menu after you log into the Web UI.

  1. Log on to the Amlen WebUI page. If this is the first time that the Amlen WebUI application has been used, complete the following steps:
    1. Log in by using the default user ID, admin and default password, admin.
  2. On the Get started with IBM Watson IoT Platform - Message Gateway Web UI page, specify the connection configuration details for the first server that you want to manage. If your web browser application, the Eclipse Amlen server that you want to manage, and the Eclipse Amlen Web UI are running on your local host, and the Eclipse Amlen administration endpoint is listening on port 9089, you can go to step 3.
    1. Enter the administration address. This value is the IP address or hostname that the administration endpoint of the Eclipse Amlen server is listening on.
    2. Enter the administration port. This value is the port that the administration endpoint of the Eclipse Amlen server is listening on.
      The number must be in the range 1 to 65535 inclusive.
    3. Optional. Select Send Web UI credentials. If you select this option, the Amlen WebUI sends the Eclipse Amlen user ID and password to the administration endpoint.
  3. Optional. Test your connection by clicking Test Connection.
    Note:

    The Eclipse Amlen server that you want to manage must be running for the test connection to succeed.

    If the administration endpoint for the Eclipse Amlen server is using the default configuration, you might need to allow the administration endpoint certificate in order to successfully complete the test connection. To allow the administration endpoint certificate, choose one of the following options:
    • If you are using Firefox or Chrome, expand the error box that appears on screen and click the Click here link. A new tab opens and prompts you to allow the certificate. After you allow the certificate, return to the Amlen WebUI tab and click the Test Connection button again. The connection should succeed.
    • If you are using Internet Explorer, accept the prompts to allow the certificate. The connection should succeed.
    If the test connection fails, check that the Eclipse Amlen server is running and that the server host can be reached from the host where the Web UI is running.
  4. Save your server configuration by clicking Save and Manage. You must complete this step to access the Amlen WebUI function.
    A message is displayed to confirm that the server is saved successfully.
  5. Click Close.
    The address and port of the Eclipse Amlen server that you saved appears next to the Server menu in the Amlen WebUI.
    You can now start managing and monitoring this Eclipse Amlen server.

Use the Amlen WebUI to begin configuring and monitoring the Eclipse Amlen server that you specified.