Installing MobileFirst Operational Analytics with Ant tasks

Learn how to use Ant tasks to deploy MobileFirst Operational Analytics to your application server.

Before you begin

You must run the Ant task on the computer where the application server is installed, or the Network Deployment Manager for WebSphere® Application Server Network Deployment. If you want to start the Ant task from a computer on which MobileFirst Server is not installed, you must copy the file mf_server_install_dir/WorklightServer/worklight-ant-deployer.jar to that computer.
Note: The mf_server_install_dir placeholder is the directory where you installed MobileFirst Server.

For more information, see Production deployment and clustering.

Procedure

  1. Edit the Ant script that you use later to deploy MobileFirst Operational Analytics WAR files.
    1. Review the sample configuration files in Sample configuration files for MobileFirst Operational Analytics.
    2. Replace the placeholder values with the properties at the beginning of the file.
      Note: The following special characters must be escaped when they are used in the values of the Ant XML scripts:
      • The dollar sign ($ ) must be written as $$, unless you explicitly want to reference an Ant variable through the syntax ${variable}, as described in Properties section of the Apache Ant Manual.
      • The ampersand character (& ) must be written as &, unless you explicitly want to reference an XML entity.
      • Double quotation marks (") must be written as ", except when it is inside a string that is enclosed in single quotation marks.
  2. If you install a cluster of nodes on several servers:
    1. You must uncomment the property wl.analytics.masters.list, and set its value to the list of host name and transport port of the master nodes. For example:
      node1.mycompany.com:96000,node2.mycompany.com:96000
    2. Add the attribute mastersList to the elasticsearch elements in the tasks installanalytics, updateanalytics, and uninstallanalytics.
      Note: If you install on a cluster on WebSphere Application Server Network Deployment, and you do not set the property, the Ant task computes the data end points for all the members of the cluster at the time of installation, and set the masternodes JNDI property to that value.

      Alternatively, you can configure the cluster after installation. For more information, see Properties and configurations.

  3. To deploy the WAR files, run the following command: 
    ant -f configure-appServer-analytics.xml install
    You can find the Ant command in mf_server_install_dir/shortcuts. This installs a node of MobileFirst Operational Analytics, with the default type master and data, on the server, or on each member of a cluster if you install on WebSphere Application Server Network Deployment.
  4. Save the Ant file. You might need it later to apply a fix pack or perform an upgrade. For more information, see Applying a fix pack to IBM MobileFirst™ Platform Operational Analytics.

    If you do not want to save the passwords, you can replace them by "************" (12 stars) for interactive prompting.

    Note: If you add a node to a cluster of MobileFirst Operational Analytics, you must update the analytics/masternodes JNDI property, so that it contains the ports of all the master nodes of the cluster.

What to do next

See also :
Parent topic: Installing the IBM MobileFirst Platform Operational Analytics