Configuring the Worklight Server

You must configure the IBM® Worklight® Server before you can run the process steps to deploy mobile application artifacts.

About this task

For each Worklight project, you must configure the Worklight Server. The one time Worklight Server setup and configuration options for the Worklight project WAR file are described in the Worklight Information Center.

You can use any of the following methods to configure the Worklight Server:
  • Use Ant tasks to configure the server:
    • Use the command line to run the Ant script.
    • Use the Ant process step within IBM UrbanCode Deploy to run the Ant script with the Worklight Ant tasks. To use the Ant process step, you must download and install the Ant plug-in for IBM UrbanCode Deploy.
  • Use the Server Configuration Tool to configure the server.
  • Manually configure the server.
Tips:
  • Sample scripts are available for configuring the server and are in Worklight installation directory/Worklight/WorklightServer/configuration-samples. The sample script combines the two steps in the following procedure by creating a database and deploying the project WAR file.
  • For information about configuring a secure Worklight Console for IBM WebSphere Application Server Liberty Profile and required values, see Testing the Worklight Console login screen.

Procedure

To configure the Worklight Server for a Worklight project:

  1. Create and configure a database for your server:
    Option Documentation
    Use Ant tasks to create and configure the databases Creating and configuring the databases with Ant tasks
    Use the Server Configuration Tool to create and configure the databases Deploying, updating, and undeploying a Worklight Server by using the Server Configuration Tool
    Manually create and configure the databases Creating and configuring the databases manually
  2. Deploy the project WAR file to the application server:
    Option Documentation
    Use Ant tasks to install the Worklight project Deploy a project WAR file and configuring the application server with Ant tasks
    Use the Server Configuration Tool to install the Worklight project Deploying, updating, and undeploying a Worklight Server by using the Server Configuration Tool
    Manually install the Worklight project Deploy a project WAR file and configuring the application server manually
    Important: If you are configuring multiple projects on a single server, then see the Worklight topic Configuring multiple IBM Worklight projects. If you run multiple projects on a single server, install the .war files from multiple Worklight projects in the same application server, and then have them operate in parallel and independently.
    Note: The Worklight project WAR file deployment that is described in this step is a one time configuration. When you deploy your mobile application, update the WAR file on the application server by using the plug-in process steps.

Feedback