This documentation is for WSO2 IoT Server 3.0.0. View the documentation for the latest release.
Due to a known issue do not use JDK1.8.0_151 with WSO2 products. Use JDK 1.8.0_144 until JDK 1.8.0_162-ea is released.
Page Comparison - Configuring WSO2 IoT Server with the IP (v.10 vs v.11) - IoT Server 3.0.0 - WSO2 Documentation

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

WSO2 IoT Server is configured via localhost as the product has SSO enabled by default. When in a production environment or if you wish to make WSO2 IoT Server IP based instead of localhost, you need to configure it accordingly. Let's take a look at the steps you need to follow to configure WSO2 IoT Server with the IP:

  1. Open the <IOT_HOME>/core/conf/carbon.xml file and configure the <HostName> and <MgtHostName> attributes with the {IoT_SERVER_HOSTNAME}.

    Code Block
  2. Open the <IOT_HOME>/core/conf/identity/sso-idp-config.xml file, and find and replace localhost with the <IoT_SERVER_IP>.
  3. Open the <IOT_HOME>/core/conf/app-manager.xml  file, and configure the <IdentityProviderUrl> attribute that is under <SSOConfiguration> by replacing localhost with the IoT Server IP.

    Code Block
    <!-- URL of the IDP use for SSO -->
  4. Open the <IOT_HOME>/core/repository/deployment/server/jaggeryapps/devicemgt/app/conf/app-conf.json file, and configure the following attributes:
    • identityProviderUrl: Replace with the IoT Server IP and host, which is 9443.

      Code Block
      "identityProviderUrl" : "https://<IoT_SERVER_IP>:9443/samlsso",
    • acs: Replace with the IoT Server IP and host, which is 9443.

      Code Block
      "acs": "https://<IoT_SERVER_IP>:9443/devicemgt/uuf/sso/acs",
  5. Open the <IOT_HOME>/core/repository/deployment/server/jaggeryapps/api-store/site/conf/site.json file, and configure the identityProviderUrl attribute by replacing localhost with the IoT Server IP.

    Code Block
    "identityProviderURL" : "https://<IoT_SERVER_IP>:9443/samlsso",
  6. Open the <IOT_HOME>/wso2/analytics/repository/deployment/server/jaggeryapps/portal/configs/designer.json file, and configure the identityProviderUrl and acs attributes by replacing localhost with the IoT Server IP and the respective profiles port.

    Code Block
    "identityProviderURL": "https://<IoT_SERVER_IP>:9443/samlsso",
    "acs": "https://<IoT_SERVER_IP>:9445/portal/acs",

    The default port of the WSO2 IoT Server profiles are as follows:

    WSO2 IoT Server core profile9443
    WSO2 IoT Server analytics profile9445
    WSO2 IoT Server broker profile9446

    Therefore, the analytics portal needs to be assigned the 9445 port.

  7. Once you are done with the above steps, restart or start the message broker, IoT Server core, and the analytics profiles in the given order. For more information, see Starting the Server.