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

Installing with Ant Tasks

Use Ant tasks to install the MobileFirst Server components to your application server.

You can find the sample configuration files for installing MobileFirst Server in the mfp_install_dir/MobileFirstServer/configuration-samples directory.

You can also create a configuration with the Server Configuration Tool and export the Ant files by using File > Export Configuration as Ant Files.... The sample Ant files have the same limitations as the Server Configuration Tool:
  • All components (MobileFirst Operations Console, MobileFirst Server administration service, MobileFirst Server live update service, the MobileFirst Server artifacts, and MobileFirst runtime) are in the same application server. However, on WebSphere® Application Server Network Deployment when you install on a cluster, you can specify a different cluster for the administration and live update services, and for the runtime.
  • If the MobileFirst Server push service is installed, it is also installed on the same server. However, on WebSphere Application Server Network Deployment when you install on a cluster, you can specify a different cluster for the push service.
  • All the components use the same database system and the user. For DB2®, all the components also use the same schema.
  • The Server Configuration Tool installs the components for a single server. For an installation on multiple servers, a farm must be configured after the tool is run. The server farm configuration is not supported on WebSphere Application Server Network Deployment.

You can configure the MobileFirst Server services to run in server farm with Ant tasks. To include your server in a farm, you need to specify some specific attributes that configure your application server accordingly. For more information about configuring a server farm with Ant tasks, see Installing a server farm with Ant tasks.

For other topologies that are supported in Topologies and network flows, you can modify the sample Ant files.

For an overview of installing with the sample configuration file and tasks, see Installing MobileFirst Server in command line mode.

You can run an Ant file with the Ant distribution that is part of the product installation. For example, if you have WebSphere Application Server Network Deployment cluster and your database is IBM DB2, you can use the mfp_install_dir/MobileFirstServer/configuration-samples/configure-wasnd-cluster-db2.xml Ant file. After you edit the file and enter all the required properties, you can run the following commands from mfp_install_dir/MobileFirstServer/configuration-samples directory:
  • mfp_install_dir/shortcuts/ant -f configure-wasnd-cluster-db2.xml help - This command displays the list of all the possible targets of the Ant file, to install, uninstall, or update some components.
  • mfp_install_dir/shortcuts/ant -f configure-wasnd-cluster-db2.xml install - This command installs MobileFirst Server on the WebSphere Application Server Network Deployment cluster, with DB2 as a data source by using the parameters that you entered in the properties of the Ant file.

After the installation, make a copy of the Ant file so that you can reuse it to apply a fix pack. For more information, see Applying a fix pack by using the Ant files.