Deploying a web application to an isolated environment

To deploy a web application, you must first add the web application to the Web Applications folder and configure the Manual deploy option for the application. Then you must connect the web application to the application domains to be accessed from the web application. Finally, you must manually copy the deployed WAR files and the related folders to the Java application server.

Adding a web application

Prerequisites

The management gateway that will deploy the WAR files must have read access to the installation folder containing the WAR files.

Name requirements

The web application name must:

•	Only include ASCII characters (a-z, A-Z, 0-9).

•	Not include any white spaces.

•	Be unique within the application domain.

•	Be unique if you deploy several web applications to the same Java application server.

•	Not be the word applications.

To add a web application

1	Right-click the Web Applications folder and select New Web Application.

2	In the New Web Application dialog box, select the type of web application.

3	Enter a name for the web application. See Name requirements above.

4	Select the host for the management gateway that will deploy the WAR files.

5	Select Manual deploy.

6	Click OK. The management gateway copies the WAR files to the following manual deploy path:

<Base Directory>\<Version>\root\etc\unmanagedportals

Connecting the web application to an application domain

Prerequisites

•	One web application can be connected to several application domains.

•	One application domain can be connected to one web application of each type.

To connect a web application to an application domain

1	In the Web Applications folder, right-click the web application and select Link Application Domain.

2	In the Available Application Domains area, select the application domain to which you want to connect the web application.

3	Click the arrow button to connect the web application to the application domain.

4	Repeat for each application domain to connect.

5

Click OK.

Copying WAR files and related folders to the portal root

This section applies when deploying a StreamServe web application to Apache Tomcat.

To ensure that the WAR files are properly unpacked by the Java application server, you must copy the WAR files to the portal root and make sure that the files are unpacked before you copy the related folders to the portal root.

To copy the WAR files to the portal root

1	Copy the WAR files from the manual deploy path:

<Base Directory>\<Version>\root\etc\unmanagedportals

Where <Base directory> is the path specified for Design Center Projects during the Framework and StreamServer installation. For example: C:\ManagementGateway

2	Paste the files into the portal root on the Java application server. For example, for Apache Tomcat:

<TOMCAT_HOME>\webapps\

3	Make sure that all the WAR files in the portal root are unpacked by the Java application server, resulting in a separate folder for each WAR file. We recommend that you check the log files for the Java application server to verify that the files are properly unpacked.

For information about how to unpack WAR files, see the user documentation for the Java application server. For Apache Tomcat, the files may be unpacked automatically if you restart the Apache Tomcat service.

Note:

Unpacking WAR files might be time consuming.

To copy the related folders to the portal root

1	Copy the related folders from the manual deploy path on the Framework and StreamServer computer.

2	Paste the folders into the portal root on the Java application server.