+

Search Tips | Advanced Search

For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.


Install MobileFirst Analytics on WebSphere Application Server Liberty

We can install MobileFirst Analytics on WebSphere® Application Server Liberty.


Before you begin

Ensure that you already have the MobileFirst Analytics EAR file. For more information on the installation artifacts, see Install MobileFirst Server to an application server. The analytics.ear file is found in the <mf_server_install_dir>\analytics folder. For more information about how to download and install WebSphere Application Server Liberty, see the About WebSphere Liberty article on IBM® developerWorks®.


Procedure

  1. Create a server by running the following command in your ./wlp/bin folder.

      ./server create <serverName>

  2. Install the following features by running the following command in your ./bin folder.

      ./featureManager install jsp-2.2 ssl-1.0 appSecurity-1.0 localConnector-1.0

  3. Add the analytics.ear file to the ./usr/servers/<serverName>/apps folder of your Liberty Server.
  4. Replace the contents of the <featureManager> tag of the ./usr/servers/<serverName>/server.xml file with the following content.

      <featureManager>
        <feature>jsp-2.2</feature>
        <feature>ssl-1.0</feature>
        <feature>appSecurity-1.0</feature>
        <feature>localConnector-1.0</feature>
      </featureManager>

  5. Configure analytics.ear as an application with role-based security in the server.xml file. The following example creates a basic hardcoded user registry, and assigns a user to each of the different analytics roles.

      <application location="analytics.ear" name="analytics-ear" type="ear">
        <application-bnd>
          <security-role name="analytics_administrator">
            <user name="admin"/>
          </security-role>
          <security-role name="analytics_infrastructure">
            <user name="infrastructure"/>
          </security-role>
          <security-role name="analytics_support">
            <user name="support"/>
          </security-role>
          <security-role name="analytics_developer">
            <user name="developer"/>
          </security-role>
          <security-role name="analytics_business">
            <user name="business"/>
          </security-role>
        </application-bnd>
      </application>
      
      <basicRegistry id="worklight" realm="worklightRealm">
        <user name="business" password="demo"/>
        <user name="developer" password="demo"/>
        <user name="support" password="demo"/>
        <user name="infrastructure" password="demo"/>
        <user name="admin" password="admin"/>
      </basicRegistry>

    For more information about how to configure other user registry types, such as LDAP, see the Configure a user registry for Liberty topic in the WebSphere Application Server product documentation.

  6. Start the Liberty Server by running the following command inside your bin folder.

      ./server start <serverName>

  7. Go to the MobileFirst Analytics Console.

      http://localhost:9080/analytics/console


What to do next

For more information about administering WebSphere Application Server Liberty, see the Administering Liberty from the command line topic in the WebSphere Application Server product documentation.

Parent topic: MobileFirst Analytics Server installation guide