1. Stop Tomcat from the Windows Services window by right-clicking Apache Tomcat and choosing Stop.
2. Navigate to the following directory in Windows Explorer or My Computer:

   <catalina_home>\conf\Catalina\localhost

   This directory can contain XML files that define contexts. If the Developer Studio installation installed and configured Tomcat for you, the following file should appear to define the ibi_apps context that deploys the webfocus directory:

   ibi_apps.xml

   If you are using stand-alone Tomcat, the following files should appear as well:

   approot.xml
   ibi_html.xml
   ibi_help.xml

   Note: The installation program silently creates the ibi_html.xml file. This file is installed to run applications that were created using an earlier version of Developer Studio that may have references to the ibi_html alias.

   If a custom alias was used for ibi_html, see How to Configure the ibi_html Alias.

   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:

   path_To_WebApplication

   Is the absolute path to the WAR file or directory you are deploying.

   contextRoot

   Is the context root.

   Note: They can optionally contain additional information, as explained in Tomcat documentation.

3. If the ibi_apps.xml file does not exist, create it using Notepad. For example:

   <?xml version='1.0' encoding='utf-8'?>
   <Context docBase="C:\ibi\DevStudio81\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).

4. If you are using stand-alone Tomcat and approot.xml does not exist, create it using Notepad. For example:

   <?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.

5. If you are using stand-alone Tomcat and ibi_help.xml does not exist, create it using Notepad. For example:

   <?xml version='1.0' encoding='utf-8'?>
   <Context docBase="C:\ibi\DevStudio81\webapps\ibi_help" path="/ibi_help">
   </Context>

   Be sure to specify the correct directory on your machine.

6. Restart Tomcat from the Services window.

The following procedure only applies to users who have installed earlier versions of Developer Studio and need to configure the ibi_html alias. As of Developer Studio 8, the ibi_html alias is no longer required. All content that was previously accessed through this alias can now be accessed through the ibi_apps alias.

If you select the option to configure Tomcat during the Developer Studio installation process, the ibi_html alias (ibi_html.xml) is created to ensure that older applications with hard coded references to the ibi_html alias will continue to run. The ibi_html.xml file is located in the following directory:

<tomcat_home>\conf\Catalina\localhost\ 

where:

<tomcat_home>

Is the root location where Apache Tomcat is installed.

Note:

• If you were using a web application, deployed as ibi_html, that is used by a WebFOCUS installation on the same machine, or used by an another Developer Studio installation, ensure it is backed up to avoid overwriting during the installation and configuration of Developer Studio.
• If you are upgrading to Developer Studio 8, and were using a custom ibi_html alias, you can change the ibi_html.xml to a custom alias such as, ibi_html8.xml. Do not edit the ibi_html.xml file, and change the path="/ibi_html" to indicate the custom alias.

1. Stop Apache Tomcat.
2. Make a copy of the ibi_apps.xml file, which is located in the following directory:

   <tomcat_home>\conf\Catalina\localhost\ 

3. Rename the copy of ibi_apps.xml to ibi_html.xml, or a to your custom alias.
4. Open the copied file in a text editor.

   The following code displays when you open the file.

   <?xml version='1.0' encoding='utf-8'?>
   <Context docBase="C:\ibi\DevStudio81\webapps\ibi_apps" path="/ibi_apps">
   </Context>

5. Update the Context docBase path to include the full path of the ibi_html.war file.
6. Update the path from /ibi_apps to /ibi_html.

   An example of the updated code is shown below.

   <?xml version='1.0' encoding='utf-8'?>
   <Context docBase="C:\ibi\DevStudio81\webapps\ibi_html.war" path="/ibi_html">
   </Context>

7. Save your changes and close the file.
8. Start Apache Tomcat.

   You can now use your ibi_html alias.

1. Ensure that Tomcat has been restarted.
2. Test the ibi_apps context by going to the following URL in a web browser:

   http://localhost:8080/ibi_apps/

   The WebFOCUS home page should appear. If you receive an error, see Troubleshooting Developer Studio.

By default, Tomcat uses the three TCP ports listed below:

8080

http://localhost:8080

8009

8005

If these ports are not available or you wish to change them, do the following:

1. Open the following file in a text editor:

   <catalina_home>\conf\server.xml

2. Search for the port numbers you wish to replace (8080, 8009, 8005) and replace them with the ports you wish to use.
3. Save and exit the file.
4. Restart Tomcat.

If you change defaults, substitute accordingly in procedures and examples. You also need to update the Developer 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 Developer Studio for the first time, only when installing a service pack or new release. When you upgrade Developer Studio or install a service pack, Tomcat must use the new web application rather than cached copies of the old version.

• If the expanded webfocus directory was deployed, the new web applications should be used automatically, but you should remove the following directory and restart Tomcat.

  <catalina_home>\work\Catalina\localhost\ibi_apps

  For a stand-alone Tomcat configuration, also remove the approot and ibi_html directories.

• If you deploy the webfocus.war file or your new release is located in a different directory from the old release, remove the following, recreate the context, and restart Tomcat:

  <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 and ibi_html.xml files as well.

• If you are using Tomcat as both a web and application server, proceed to Configuring the Local Reporting Server Security.
• If you are using Tomcat as the application server and IIS as the web server, configure IIS, as explained in the next section.