Installing MobileFirst Analytics on WebSphere Application Server Liberty

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

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 Configuring 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