Creating a Web Module and Inserting a Java Server Page

Part 3: Creating a Web Module and Inserting a Java Server Page

From the Forte File menu, select New.
The Template Chooser dialog appears.
Expand the JSP & Servlet node.
Select WebModule.
Select the Next button.
The New... Web Module dialog appears.
Select the button.
A File chooser dialog appears.
Navigate to the directory you wish to use and select Add.
You can create a new directory from within this New Web Module dialog.
Select Finish.
A new Web Module is now created and mounted as a Filesystem. You can view it from the Explorer window Filesystems tab.
To verify that the new web module you just mounted is indeed a web module, select it and right click to display the context menu. Select the Tools menu item to display a submenu. If you see the submenu item "Package WAR File..." then your module is indeed a web module.
Select the newly created web module node.
Right click and select Tools -> Switch Web Execution to iPlanet Application Server.

The Switch Web Execution menu item toggles between web execution to the iPlanet Application Server and the TOMCAT server.
Select the web module once more.
Right click and select New -> JSP & Servlet -> JSP (HTML).
Enter "Hello" as the name and don't add an extension.
The Hello.jsp is created and opened.
In the source editor, enter "Hello There!" into the Hello.jsp file in a new line after the <body> tag.
From the Explorer window, select the Hello JSP node.
Right click and select Execute.

Forte switches to the Running view and displays an Output window and an Execution window.
A WAR file is created and deployed to the iPlanet Application Server default instance. You can view the deployment messages in the iPlanet Deployment tab of the Output Window.

If you execute on a local server instance, the currently running KJS engine of the iPlanet Application Server is shut down and restarted by Forte. The first time you execute it can take a long time (one minute) to perform the KJS engine shutdown and restart, but after this initial execution, its much faster.
You can see the KJS output information in the iPlanet kjs - I/O tab of the Output Window.

The iPlanet KJS is also displayed in the Execution window.

When deployment is completed. The Forte browser launches and points to the proper URL to view the page. For example, http://<server>:80/NASApp/<webmodule>/Hello.

To execute an entire web module:

Select the web module node and expand the tree view.
Expand the WEB-INF node and select the ias-web node.
Remember, the web descriptors always reside inside the WEB-INF directory.
Right click to display the context menu and select Open using the iPlanet App Server Customizer.
In the General tab, add a welcome file to launch the browser with an initial introductory page.
You can add the JSP (HTML) file you just created, or any servlet or HTML file you wish.
Select OK.
You may encounter an error message prompting you to validate the information. This is a known error message.
Select No to dismiss the dialog.
From the Explorer, select the web module node.
Right click to display the context menu.
Select Tools -> Execute in Web Server.
You can also select Execute in Web Server (Restart Server). In this release, both menu options function the same. They both restart the server.

Forte switches to the Running view and displays an Output window and an Execution window.
When deployment is completed. The Forte browser launches and points to the proper URL to view the welcome page you added. For example, http://<server>/NASApp/<webmodule>.
Note: If the file does not exist, a "cannot connect to <moduleURL> message is displayed in the browser and a "File not found." exception is encountered.

Congratulations, you have successfully created and executed a Java Server Page.