In this section: |
The App Studio installation provided the option to install and configure Apache Tomcat for you. If you chose this option and the verification tool ran successfully, you do not need to manually configure Tomcat. However, if you are not familiar with Tomcat, you may wish to review this section to understand the configuration process.
Note:
To configure Tomcat, you tell Tomcat where App Studio files are located and the contexts in which to use them. For example, the WebFOCUS web application is installed with App Studio in:
drive:\ibi\AppStudio81\webapps\webfocus
Tomcat must know to serve files from the web application when it receives a request for the ibi_apps context path. For example:
http://localhost:8080/ibi_apps
Tomcat can be used as both a web server and application server, so Tomcat can also serve files outside of a web application after it knows their location and context. On a traditional web server, you create aliases. With Tomcat, an alias is treated like a context root, even when serving files outside of a web application.
Context (path) | Directory (DocumentBase) |
---|---|
/ibi_apps | drive:\ibi\AppStudio81\webapps\webfocus |
/ibi_apphelp | drive:\ibi\AppStudio81\webapps\ibi_apphelp |
/approot | drive:\ibi\apps |
Context (path) | Directory (DocumentBase) |
---|---|
/ibi_apps | drive:\ibi\AppStudio81\webapps\webfocus |
/ibi_apphelp | drive:\ibi\AppStudio81\webapps\ibi_apphelp |
The ibi_apphelp and approot contexts are then created as aliases (Virtual Directories) on IIS and IIS is configured to send requests for ibi_apps to Tomcat.
How to: |
There are many ways to configure Tomcat. Information Builders recommends creating XML files under
<catalina_home>\conf\Catalina\localhost
where:
Is the actual location of your Tomcat installation directory. For example:
drive:\ibi\tomcat
or
C:\Program Files\Apache Software Foundation\tomcat x.x.
Context roots can be created as specified in the following steps.
<catalina_home>\conf\Catalina\localhost
This directory can contain XML files that define contexts. If the App Studio installation installed and configured Tomcat for you, the following files should appear to define the ibi_apps context that deploys the webfocus directory:
approot.xml
ibi_apps.xml
If you are using stand-alone Tomcat, the following file should appear as well:
ibi_apphelp.xml
The XML files are named for the context root you would use to access the web application and should have the following syntax:
<?xml version='1.0' encoding='utf-8'?> <Context docBase="path_To_WebApplication" path="/contextRoot"> </Context>
where:
Is the absolute path to the WAR file or directory you are deploying.
Is the context root.
Note: They can optionally contain additional information, as explained in Tomcat documentation.
<?xml version='1.0' encoding='utf-8'?> <Context docBase="C:\ibi\AppStudio81\webapps\webfocus" path="/ibi_apps"> </Context>
Be sure to specify the correct directory on your machine and change the context root if you are not using the default (ibi_apps).
<?xml version='1.0' encoding='utf-8'?> <Context docBase="C:\ibi\apps" path="/approot"> </Context>
Be sure to specify the correct directory on your machine.
<?xml version='1.0' encoding='utf-8'?> <Context docBase="C:\ibi\AppStudio80\webapps\ibi_apphelp" path="/ibi_apphelp"> </Context>
Be sure to specify the correct directory on your machine.
http://localhost:8080/ibi_apps/
The WebFOCUS home page should appear. If you receive an error, see Troubleshooting App Studio.
Reference: |
You should be aware of how to secure the Tomcat Manager Web Tool, Tomcat TCP ports, and how to reload web applications.
By default, Tomcat uses the three TCP ports listed below:
Default Port |
Name |
Use |
---|---|---|
8080 |
HTTP Listener Port |
You access Tomcat in a web browser using this port. For example: http://localhost:8080 |
8009 |
Connector Port |
Web servers can route servlet requests to Tomcat on this port. The Tomcat connector (plug-in) for IIS uses this port. Tomcat listens on this port even if no web server is connecting. |
8005 |
Shutdown Port |
Tomcat uses this port for internal operations and for shutting down. |
If these ports are not available or you wish to change them, do the following:
<catalina_home>\conf\server.xml
If you change defaults, substitute accordingly in procedures and examples. You also need to update the App Studio connection settings so it knows the correct Tomcat HTTP port if you change the default.
This is not a consideration if you just installed Tomcat with App Studio for the first time, only when installing a service pack or new release. When you upgrade App Studio or install a service pack, Tomcat must use the new web application rather than cached copies of the old version.
<catalina_home>\work\Catalina\localhost\ibi_apps
For a stand-alone Tomcat configuration, also remove the approot and ibi_apphelp directories.
<catalina_home>\webapps\ibi_apps
<catalina_home>\work\Catalina\localhost\ibi_apps
<catalina_home>\conf\Catalina\localhost\ibi_apps.xml
For a stand-alone Tomcat configuration, remove the approot.xml file as well.
To set up a Unicode environment, follow these steps:
This section is required if you are deploying the App Studio Help system on a remote application server. The App Studio Help web application must be deployed to an application server.
If Tomcat is your remote application server, you can do one of the following:
<catalina_home>\webapps
or
<catalina_home>\conf\Catalina\localhost\
The xml should include the following syntax:
<?xml version='1.0' encoding='utf-8'?> <Context docBase="drive:\ibi\AppStudio81\webapps\ibi_apphelp" path="/ibi_apphelp"> </Context>
To configure the App Studio Help on a remote application server other than Tomcat, you must deploy the ibi_apphelp.xml web application to the server.
WebFOCUS |