x

1. Navigate to the following location:

   <Tomcat_Home>\tomcat\bin

   where:

   <Tomcat_Home>

   Is the path where Tomcat is installed (for example, C:\ibi\apps).

   

2. Right-click on the tomcat7WFw.exe file and select Run as Administrator.

   A new property window appears.

3. Navigate to the Java tab as shown in the following image.

   

4. Replace the Java Virtual Machine value to the jvm.dll location where the local JRE 7 is installed, as shown in the following image.

   

5. Click Apply and then click OK, and restart Tomcat.

   Note: You can skip this step if you are using an existing Tomcat.

x

1. Navigate to the following directory:

   <Tomcat_Home>/conf/Catalina/localhost

2. Create a new XML file called idpweb.xml.
3. Enter the following syntax:

   <?xml version='1.0' encoding='utf-8'?> 
   <Context docBase="<dphome>\idpweb" path="/idpweb">
   </Context>

   where:

   <dphome>

   Is the path where iDP is installed.

4. Restart Apache Tomcat.

   Note:

   • If you have already installed iDP, navigate to the following directory and delete the idpweb folder:

     <Tomcat_Home>/work/Catalina/localhost

   • If more than one iDP is installed to coexist with an earlier version of iDP, then repeat this procedure and provide a unique name for the XML file that is created.

x

1. Open a Command Prompt window, as shown in the following image.

   

2. At the command prompt, type the path to the idpweb folder. For example:

   cd <dphome>\idpweb

3. Type the following command to create a .war file:

   jar -cvf idpweb.war *

   Note: Ensure that Java is properly configured on the system.

   The idpweb.war file is created in the idpweb folder location.

x

This procedure assumes that Apache Tomcat is installed in CATALINA_HOME, running on a local machine on the standard port 8080.

Before deploying applications on Apache Tomcat, the context name (for example, the relative URL of the application) must be defined. If the context name is idpweb, then iDP will be accessible from the following URL:

http://localhost:8080/idpweb/

The basic methods to deploy the iDP Web Archive (WAR) are:

• Using the Apache Tomcat Web Application Manager.
• Deploying to a remote server.
• Using the Auto Deploy feature of Apache Tomcat.

x

1. Enter the following URL in your web browser:

   http://localhost:8080/manager/html. 

2. Provide the user ID and password of the Apache Tomcat admin user.

   Note: If the user ID and password are not available, then check the Apache Tomcat documentation and ensure that the manager role and admin user are defined in CATALINA_HOME/conf/tomcat-users.xml as follows:

   <role rolename="manager"/>
   <user username="admin" password="password" roles="manager"/>

   Note that the default content of CATALINA_HOME/conf/tomcat-users.xml is slightly different across all Apache Tomcat versions. Regardless of the version used, ensure that the manager role and the admin user are defined as described above.

3. In the Context Path field, located at the bottom of the page in the Deploy directory or WAR file located on server section, enter the context name preceded by the forward-slash (/) symbol (for example, /idpweb).
4. In the WAR or Directory URL field, locate the idpweb WAR file and enter its absolute name (for example, /absolute/path/idpweb.war), as shown in the following image.

   

5. Click Deploy to reload the page.

   The following success message is displayed at the top of the page.

   OK - Deployed application at context path /idpweb

   In the Applications section, check that there is a row with the new idpweb application, as shown in the following image.

   

   The application is now ready and available at the specified URL.

x

The technique described in the previous section will work if you can copy the idpweb.war file to the file system of the server. If you cannot, it is still possible to deploy the file using a remote deployment.

1. Locate the WAR file on the local machine and rename it to the context name with a .war extension (for example, idpweb.war).
2. Access the Apache Tomcat Web Application Manager and scroll down to the WAR file to deploy section.
3. Click Browse and select the idpweb.war file on the local machine.
4. Click Deploy.

   The browser uploads the idpweb.war file to the server and Apache Tomcat will deploy the file.

x

Many Apache Tomcat installations do not offer the Apache Tomcat Web Application Manager for security reasons. Apache Tomcat has a useful auto-deploy feature that you can use.

1. Check if the auto-deploy feature is enabled by opening the server.xml file, which is located in the CATALINA_HOME/conf directory. The Host section in this file should be similar to the following syntax:

   <Host name="localhost" appBase="webapps"
       unpackWARs="true" autoDeploy="true"
       xmlValidation="false" xmlNamespaceAware="false">

   Note the values of the autoDeploy and unpackWARs attributes. If they are both true, then proceed to the next step.

2. Locate the idpweb WAR file and rename it to the context name with the .war extension (for example, idpweb.war), then copy this file to the CATALINA_HOME/webapps directory.

   Apache Tomcat will automatically detect the new WAR file, open it, and deploy the application.

x

Deploying iDP as a Web Archive (WAR) file in Apache Tomcat will change the location of the idpweb folder, which should be reflected in the dpcontext.properties file as a result.

1. After the idpweb.war file is deployed, navigate to the deployed idpweb folder in Apache Tomcat. The dpcontext.properties file is located as follows:

   <TOMCAT_INSTALL_DIR>\<webapps>\<deployed idpweb folder>\WEB-INF\classes\dpcontext.properties

2. Change the path of the idppath parameter to the current location of the idpweb folder.

   For example:

   idppath=<TOMCAT_INSTALL_DIR>/<webapps>/<deployed idpweb folder>

3. Save the modified dpcontext.properties file and restart Apache Tomcat.