Deploying Jaggery Applications

WSO2 AppServer supports Apache tomcat based Jaggery application deployment as a latest feature. Now you can Deploy your custom Jaggery application under WSO2 AppServer. All you need to do is to bundle your Jaggery application as a '.war' archive with all your Jaggery application-related resources and all third party libraries needed, and then deploy the archive.

To deploy the Jaggery application, all you have to do is locate the archive file and upload it.

Uploading Jaggery Archive Files

To upload your Jaggery archive file, you first need to have all the class files and the service.xml files in the archive directory. Thereafter, you can create the archive file.

The folder structure of the Jaggery archive file will be as follows.

        HellowWorld.war
            index.html
            *.jss
            images/
    

Figure 1: Uploading a Jaggery archive file

  1. In the navigator, under Manage/Jaggery Applications, click Add .
  2. Click Browse to locate the file you want to upload. If you want to add multiple services at the same time, click on the '+' sign at the right side, and new additional entry to upload a service archive will appear each time you click. So you can select all the services you want and deploy them at the same time.
  3. Click Upload. The Running Jaggery Applications page appears. Subsequently, if the Jaggery application is successful, it will appear in list. If the Jaggery application is faulty, a Faulty Jaggery Application Groups link will appear. You can click the link to view the errors.

Testing the Jaggery Application

A successful Jaggery application can be easily tested through the user interface.Several options are available to control your Jaggery application.

  1. In the navigator, under Manage/Jaggery Applications, click List. The Running Jaggery Applications page appears.
  2. Figure 2: Jaggery Applications List.

  3. Click on the Jaggery application name you want to test. The Jaggery Application Dashboard page appears.
  4. Figure 3: Jaggery Application Dashboard.

  5. A page with your Jaggery application name appears. It contains the operations available for your Jaggery application.
  6. Clicking the 'url' you will be directed the Jaggery application's index.html page

Note: Instead of using this user interface, you can also manually place the .war containing all the required files into CARBON_HOME/epository/deployment/jaggeryapps. These archive files can be deployed as Jaggery applications.