IBM Worklight v5.0.5 > Develop IBM Worklight applications > Transport Worklight applications to test and production environments

Transport an application from development to another environment


Overview

You have built an application in Worklight Studio, with a set of .wlapp files in the bin folder of the project. You now want to deploy the applications to a test or production environment.


Transport an application from development to another environment

  1. For each application in the project, configure application-descriptor.xml to match new environment.

  2. Change the settings in worklight.properties to match the new environment.

    Specify the database by setting...

      wl.db.type

    ...to either...

    • MYSQL
    • DB2
    • DERBY
    • ORACLE

    ...depending on the database.

    Set wl.db.jndi.name to the JNDI name for the database as follows:

    Specify the settings for the report database by setting...

      wl.reports.db.type

    ...to...

    • MYSQL
    • DB2
    • DERBY
    • ORACLE

    Set wl.reports.db.jndi.name to the JNDI name for the database...

    Specify the properties that describe public WL server access by setting...

    • publicWorkLightProtocol
    • publicWorkLightPort
    • context

    You might want to look at worklight.properties that was created during installation. Extract

      installation_directory/WorklightServer/worklight.war

    ...and examine...

      WEB-INF/classes/conf/worklight.properties

  3. Build each application in either of two ways:

    This creates a projectName.war file in the \bin folder. This file contains the project configuration that was done in steps 1 and 2 and any classes built from Java code in the server/java folder.

  4. Rename the .war file to context_root.war, where context_root is as set in application-descriptor.xml.

  5. Deploy the .war file to the remote server

  6. Open the IBM Worklight Console of the target environment...

      http://your-remote-server:server-port/context_root/console

  7. From the IBM Worklight Console, deploy the relevant .wlapp files from the bin folder of your IBM Worklight project.

    You can also deploy the app to the target environment using an Ant task that is provided by IBM Worklight.

  8. Obtain the adapters from the development environment.

    1. Navigate to the bin folder in your project.

    2. Copy the .adapter file or files.

  9. From the IBM Worklight Console, deploy the .adapter files from the bin folder of your project.

    You can also deploy the adapter to the target environment using an Ant task provided with IBM Worklight.


Parent Transport Worklight applications to test and production environments