Chapter 22 Creating Web Applications

Importing and exporting Web applications

You can export Web applications from Jaguar Manager to deploy them on another server. Jaguar supports two archive formats for Web applications:

• J2EE Web archive (WAR) The WAR format is the standard for servers that support J2EE. This format allows portability to other vendor's J2EE servers, but container-specific information is not included in the archive. In particular, these items must be configured manually after importing a WAR file:
  • Security access role mappings, described in Chapter 25, "Configuring Web Application Security".
  • Resource references, described in "Resource references".
  • EJB references, described in "EJB references".
  • Environment properties, described in "Environment properties".
• Jaguar JAR For exporting between Jaguar 3.6 or later servers. This format, while proprietary, preserves all information in the Web application. When importing, EJB references, resource references, and role mappings are preserved. You must ensure that the referenced items are in place before running the imported Web application.

   Consider the synchronize feature instead of using archives If you are deploying between Jaguar servers, you may find the synchronize feature easier than exporting and importing archives. Synchronization replicates a Web application directly between servers. See Chapter 3, "Jaguar Clusters and Synchronization" in the Jaguar CTS System Administration Guide for more information.

To export a Web application:

1. Expand the Web Applications folder, then highlight the icon that represents your application.
   
   
2. If exporting in WAR format, choose File | Export | J2EE WAR. If exporting in Jaguar JAR format, choose File | Export | Jaguar JAR.
   
   
3. Enter a path and file name for the file to be created, including the .war or .ear extension.
   
   
4. Click Next. The Export wizard creates an archive of your Web application, displaying status information in the window.
   
   
5. When the export is complete, click Close.
   
   

To import a Web application:

1. Highlight the top-level Web Applications folder. If importing a WAR file, choose File | Deploy | J2EE WAR. If importing a Jaguar JAR, choose File | Deploy | Jaguar JAR.
   
   
2. Enter the path to the WAR or JAR file and click Next.
   
   
3. The Deploy wizard reads the file and creates the Web application. Any errors are displayed in the status window. Review the status information, then click Close.
   
   

   Use the status dialog as a to-do list In the deployment status dialog box, Jaguar Manager display warnings for each setting that requires further attention before you can run the Web application. You can copy and paste this text to a text editor to use as a to-do list.

What is created during import

When importing a Jaguar JAR, the Deploy wizard creates a Web application that is identical to the original.

When importing a WAR, the Deploy wizard creates a Web application with the same name as the display name in the WAR file's XML descriptor. If there is no display name, the new Web application has the same name as the WAR file. For each servlet defined in the WAR, the Deploy wizard creates a Web component with the same name as the as the servlet-name element in the Web application deployment descriptor.

Before running servlets or JSPs in the Web application, you may need to configure the following settings in the Web Application Properties dialog box:

• Role mappings
• Resource references
• EJB references
• Environment properties

Copyright © 2000 Sybase, Inc. All rights reserved.