Changing the Host Name and Context Path of EI Analytics Dashboard
com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links' is unknown.

Changing the Host Name and Context Path of EI Analytics Dashboard

When you start the WSO2 EI Analytics Dashboard server, the URL to access the dashboard is displayed in the start up logs as follows.

INFO {org.wso2.carbon.uiserver.internal.deployment.listener.AppTransportBinder} - Web app 'portal' is available at 'https://<IP_ADDRESS>:9643/portal'

You can change this URL to display a host name instead of the IP address and/or to display a different name for the web UI application instead of portal. To do this, follow the topics below:

Changing the IP address to a host name

To display a host name instead of the IP addess in the URL to access the EI Analytics Dashboard, follow the steps below:

  1. Open the <EI_HOME>/wso2/analytics/conf/dashboard/deployment.yaml file.

  2. In the wso2.transport.http: → listenerConfigurations: section, change the value for the host parameter to the required hostname (e.g., dashboard-server).

    Note that in this example, you are specifying a host name for the http URLs. If the web UI application you are accessing has an https URL, you need to make this change for the listener configuration with the https scheme.

    wso2.transport.http:
    transportProperties:

    listenerConfigurations:
    - id: "default-https"
    host: "dashboard-server"
    port: 9643
    scheme: https
    keyStoreFile: "${carbon.home}/resources/security/wso2carbon.jks"
    keyStorePassword: wso2carbon
    certPass: wso2carbon

If you make the change shown in the above example, the URL to access the EI Analytics Dashboard is displayed in the start up logs as follows:

INFO {org.wso2.carbon.uiserver.internal.deployment.listener.AppTransportBinder} - Web app 'portal' is available at 'https://dashboard-server/portal'.

Changing the web UI application name

To change the web UI application name displayed in the URL to access the EI Analytics Dashboard, add a new section as follows in the <EI_HOME>/wso2/analytics/conf/dashboard/deployment.yaml file.

wso2.carbon-ui-server:
apps:
# configurations for the Portal app
"portal":
contextPath: "/ei-dashboard"


 In this example, the context path for the portal web UI application is specified as ei-dashboard. Therefore, when you start the EI Analytics Dashboard server, the URL to access the EI Analytics Dashboard is displayed in the start up logs as follows:

INFO {org.wso2.carbon.uiserver.internal.deployment.listener.AppTransportBinder} - Web app 'portal' is available at 'https://<HOST_NAME>:9643/ei-dashboard'.



com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.