Web application deployment for WebSphere

To use IBM WebSphere, alter the web.xml file in the arcgis.war file, then use the IBM WebSphere Administration Console to create a new application for web application deployment.

Altering the web.xml file

You must add an element to the web.xml file for your data source. This file is in the WEB-INF directory of the arcgis.war file that was installed with ArcGIS Spatial Data Server for Java. Then follow these steps to add a <resource-ref> element to the web.xml file.

Steps:

1. Make a backup copy of your arcgis.war file.
2. Extract (unpackage) the arcgis.war file.
3. Navigate to the WEB-INF directory in the unpackaged arcgis.war file.
4. Open the web.xml file in a text editor.
5. Add the following <resource-ref> element, changing the <res-ref-name> parameter to match the JNDI Name parameter in your JDBC Connection Pool:

   <resource-ref>
    <res-ref-name>jdbc/spdb_db2user1</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
    <res-sharing-scope>Shareable</res-sharing-scope>
   </resource-ref>
   

6. Save and close the web.xml file.
7. Repackage the arcgis.war file.

   Do not rename the file; it must be named arcgis.war.

Deploying the web application

Create a new application to deploy from the WebSphere Administration Console.

Steps:

1. Log in to the IBM WebSphere Administration Console as the administrative user.
2. Expand Applications under Views and click New Application.

   The New Application page opens.

3. Click New Enterprise Application.
4. Click Local file system and browse to the location of your altered arcgis.war file.
5. Click Next.
6. Click Fast Path and click Next.
7. Be sure Distribute application is checked on the Select installation options page.
8. You can accept the default value for Application name or type a new one.
9. Click Next.
10. Accept the defaults on the Map modules to servers page and click Next.
11. On the Map resource references to resources page, click Browse under Target Resource JNDI Name, then choose the resource you defined in the web.xml file to the data source you configured in the WebSphere application server.
12. Click Apply to create the mapping and click Next.
13. Accept the defaults on the Map virtual hosts for Web modules page and click Next.
14. Type the context for your ArcGIS Spatial Data Server application in the Context Root text box.

    If you deployed the default, the context name is /arcgis.

15. Click Next.
16. Review the Summary page for accuracy and click Finish.
17. Click Save to save your application deployment to the master configuration.

    Your ArcGIS Spatial Data Server application is listed in the WebSphere enterprise applications list.

18. Choose your application from the list and click Start.