Logging in to the IBM Watson IoT Platform - Message Gateway Web UI

Log in to the IBM® Watson IoT Platform - Message Gateway Web UI to verify the installation of IBM Watson IoT Platform - Message Gateway and to administer the IBM Watson IoT Platform - Message Gateway messaging server.

Before you begin

  • Ensure that the IBM Watson IoT Platform - Message Gateway Web UI and IBM Watson IoT Platform - Message Gateway messaging server are running.
  • You might need to amend your firewall rules to enable access to the IBM Watson IoT Platform - Message Gateway Web UI and to the IBM Watson IoT Platform - Message Gateway REST API. The default port for the IBM Watson IoT Platform - Message Gateway Web UI is 9087, and the port for the IBM Watson IoT Platform - Message Gateway REST API is usually 9089.
  • The IBM Watson IoT Platform - Message Gateway Web UI can administer the messaging server only after the license is accepted on the messaging server. Use the IBM Watson IoT Platform - Message Gateway REST API to accept the license on the messaging server. For more information about accepting the license by using the IBM Watson IoT Platform - Message Gateway REST API, see Configuring the licensed usage for IBM Watson IoT Platform - Message Gateway and accepting the license by using REST Administration APIs.

About this task

You can use the URL https://<server:Port> to connect to the IBM Watson IoT Platform - Message Gateway Web UI. This task uses https://10.10.2.149:9087/ to connect to the IBM Watson IoT Platform - Message Gateway Web UI. To use this URL, your IBM Watson IoT Platform - Message Gateway Web UI container must be running on the host with IP address 10.10.2.149.

You need to accept an IBM Watson IoT Platform - Message Gateway Web UI certificate and an IBM Watson IoT Platform - Message Gateway server certificate before you can start using the IBM Watson IoT Platform - Message Gateway Web UI. Both of these certificates must be changed if you move from a non-production to a production environment.

Procedure

  1. Open a Firefox, Chrome, or Internet Explorer 11 browser and connect to the IBM Watson IoT Platform - Message Gateway Web UI by entering the following URL:
    https://10.10.2.149:9087
  2. Accept the IBM Watson IoT Platform - Message Gateway Web UI certificate so that you can view the login page.
  3. Log in and accept the IBM Watson IoT Platform - Message Gateway server certificate in one of the following ways:
    • If you are using Firefox or Google Chrome, complete the following steps to log in and accept the IBM Watson IoT Platform - Message Gateway server certificate:
      1. At the login prompt, type the default ID and password (admin/admin ) and click Log in. The error Cannot connect to the IBM Message Gateway server is displayed.
      2. Click Click here in the message text. An error page is displayed that indicates that you need to accept the certificate.
      3. Follow the browser prompts to accept the certificate. The About IBM Watson IoT Platform - Message Gateway page is displayed in a new browser window.
      4. Return to the IBM Watson IoT Platform - Message Gateway page. If the error box is still displayed, refresh the page.
      5. If the IBM Watson IoT Platform - Message Gateway license was not accepted on the messaging server, you are prompted to accept the license. For more information, see the Before you begin section of this topic.
      6. The Get started with IBM Watson IoT Platform - Message Gateway Web UI section of the IBM Watson IoT Platform - Message Gateway page is displayed.
        1. Ensure that the values in the Admin Address and Admin Port fields are correct.
        2. Click Test connection.
        3. Click Save and Manage.
      7. The Common configuration and customization tasks section on the Home tab of the IBM Watson IoT Platform - Message Gateway page is displayed.
    • If you are using Internet Explorer 11, complete the following steps to log in and accept the IBM Watson IoT Platform - Message Gateway server certificate:
      1. At the login prompt, type the default ID and password (admin/admin ) and click Log in.
      2. After you are logged in, follow the browser prompts to accept the certificate.
      3. If the IBM Watson IoT Platform - Message Gateway license was not accepted on the messaging server, you are prompted to accept the license. For more information, see the Before you begin section of this topic.
      4. The Get started with IBM Watson IoT Platform - Message Gateway Web UI section of the IBM Watson IoT Platform - Message Gateway page is displayed.
        1. Ensure that the values in the Admin Address and Admin Port fields are correct.
        2. Click Test connection.
        3. Click Save and Manage.
      5. The Common configuration and customization tasks section on the Home tab of the IBM Watson IoT Platform - Message Gateway page is displayed.
    Note: You can replace the default certificate with your own appropriately signed certificate and then you do not have to keep accepting certificates. For information about specifying your own certificate to replace the default certificate, see Changing the IBM Watson IoT Platform - Message Gateway Web UI security certificate.

What to do next

You can use the IBM Watson IoT Platform - Message Gateway Web UI to verify your installation of IBM Watson IoT Platform - Message Gateway and to administer the IBM Watson IoT Platform - Message Gateway messaging server. For more information about verifying your installation, see Verifying the installation of IBM Watson IoT Platform - Message Gateway. For more information about using the IBM Watson IoT Platform - Message Gateway Web UI to administer the IBM Watson IoT Platform - Message Gateway messaging server, see Administering.