JSP Web Target wizard
Like the PowerDynamo Web Site
wizard, the JSP Web Target wizard creates a target with Source and
Build folders and a deployment configuration. JSP pages are deployed
as a Web application in a Web Archive (WAR) file.
Many of the pages in the JSP Web Page wizard are similar to
those in the PowerDynamo Web Site wizard. The wizard includes a
server-specific deployment page with properties that depend on the
selection you make in the JSP server page of the wizard. Any properties
you specify in the wizard, except for the deployment configuration
name, can be modified after target creation in the Deployment Configuration
Properties dialog box for the JSP target.
Specifying a server type
When you select a server type,
the wizard presents a page where you specify how to connect to the
server.
| JSP server | Server-specific selections |
|---|---|
| EAServer | The EAServer profile and the HTTP port you want to use |
| Tomcat | The deployment folder (typically, the webapps folder under the Tomcat installation directory), the HTTP server and port name, and a login name and password |
| Command Line | Command lines you can use to deploy your Web application to any JSP 1.2 compatible server |
Custom command line deployment
Custom deployment configuration properties
You can use the custom
command line deployment configuration to set commands for Java command
line build tools, such as Apache Ant, or to deploy a target to JSP
1.2 servers other than EAServer and Tomcat, such as IBM WebSphere
or BEA WebLogic. The configuration screen for custom command line
deployment includes the following fields and check boxes:
| Property | Field type | Use this field to |
|---|---|---|
| Description | Text box | Set a description for your deployment configuration. |
| Command | Column | Add one or more command lines in a defined sequence of execution. You can move each command lines up or down in the command sequence by using the arrow controls. You can enter macros. |
| Start-up directory | Column | (Optional) Change the current directory to the location you want before executing the command you entered for the same row in the Command column. This is equivalent to a cd command to change directories. |
| Show messages in output window | Check box | Display messages from the command line tool in the PowerBuilder Output window (Selected by default). |
| Automatically generate WAR file | Check box | Generate the target WAR file when you deploy the target (Selected by default). You should clear this check box if you generate the WAR file from a command you enter in the Command column. |
| Abort execution on error | Check box | Halt the execution of command lines once an error is detected (Selected by default). |
| Command time-out | Text box | (Optional) Enter a time out value in seconds that applies to all the command lines you enter. |
Command line macros for custom deployment
You can use macros
on any of the command lines you enter in the list of commands for
your custom deployment configuration. There are five macros available
for use on the command lines you enter in the JSP Target wizard
(or in the Deployment Configuration wizard):
| Macro text | Pasted text | Value added by macro |
|---|---|---|
| Configuration Directory | $(ConfigDir) | Location of the local copy directory that you specify in a subsequent page of the wizard. |
| Display Name | $(DisplayName) | Display name from web.xml for the target. You also specify this in the wizard. |
| WAR Filename | $(WARFile) | File name, but not the full path. If you do not use a command line to build the WAR file, the value is specified in a subsequent page of the wizard. |
| Build Directory | $(BuildDir) | Full path to the build directory for the target that you specified in the JSP Target wizard. |
| Source Directory | $(SourceDir) | Full path to the source directory for the target that you specified in the JSP Target wizard. |