English

How To: Install Weblogic 7.0 with J2SDK 1.4.2_06 for ArcIMS 9.1 on Windows

Summary

Instructions provided are for the installation and configuration of WebLogic 7.0 Advanced Server using J2SDK 1.4.2_06 for ArcIMS on Windows.

Specific information for the installation of ArcIMS is included with the product's Install Guide.

WebLogic possesses its own native servlet engine and does not require other third-party servlet engines.

This installation will require the following software:

  • A Windows based server
  • Java 2 SDK Standard Edition Version 1.4.2_06
  • WebLogic 7.0 Advanced Server
  • ArcIMS 9.1 Installation CD
A user account that has administrative privileges on the ArcIMS machine is required.

Before Beginning:

  • Familiarity with certain Windows tasks is required to install and configure ArcIMS. For details, see Common Windows tasks when installing ArcIMS.
  • For more information on the acronyms and terms used in this document, see the Glossary of terms used in ArcIMS Installation articles.
  • Review and follow steps 1 and 2 from the ArcIMS Installation Guide on the DVD. These two steps ensure that the system meets the minimum requirements and assist in planning the ArcIMS site configuration. To open the ArcIMS Installation Guide, launch the DVD menu and click 'ArcIMS Installation Guide'.

Procedure

ArcIMS 3.1, 4.0, 4.0.1 or 9.0 must be uninstalled to install ArcIMS 9.1. The setup program for ArcIMS 9.1 on Windows prompts for the removal of previously installed versions.

If ArcIMS components are distributed among several computers, it is recommended the uninstall program be manually run on each computer.

Warning:   
A supported Web server and Servlet Engine must be properly installed and configured before running the setup program for ArcIMS 9.1.
  1. Uninstall any unsupported versions of JDK/JRE, web server and Servlet Engine. See How To: Uninstall ArcIMS-related third-party software on Windows for a full list of documentation.
  2. Install J2SDK 1.4.2_06.
    1. Click J2SDK 1.4.2_06 to download Sun Java 2 SDK, Standard Edition, version 1.4.2_06.
    2. Click 'Download J2SDK'.
    3. Accept the license agreement.
    4. Click the download link for the Windows Offline Installation Multi-Language. The file j2sdk-1_4_2_06-windows-i586-p.exe is downloaded.
    5. Run the program after it has finished downloading.
    6. Accept all of the default installation options, unless changes are required.
  3. Install Weblogic 7.0 Advanced Server.
    1. Run the BEA setup program to install WebLogic 7.0.
    2. At the 'Welcome' screen, click Next.
    3. Accept the License Agreement and click Next.
    4. Specify an existing or create a new BEA home directory; for example, C:\bea.
    5. Specify a Typical installation, click Next.
    6. Specify an existing or create a new storage directory for download archives; for example, C:\WeblogicStorage.

      Specify if a proxy server will be used to access the Internet. Click Next.
    7. After downloading the archives, specify an existing or create a new default product installation directory; for example, C:\bea\weblogic700. Click Next.
    8. At the end of the installation, ensure that the 'Quick Start' box is selected then close the installer window by clicking 'Done'. This will load the Quickstart program.
    9. On the Quickstart page, click on the 'Configure a New Server' link.
    10. At the 'Choose Domain Type and Name' screen, select 'WLS Domain' template and enter the name for the domain; for example, esri. Click Next.
    11. At the 'Choose Server Type' screen, select 'Single Server (Standalone Server)' and click Next.
    12. Accept the default for the domain directory. Click Next.
    13. From the 'Configure Standalone/Administrative Server' screen, enter the server name and change the Server Listen Port to 80.
    14. From the 'Create Administrator User' screen, enter a username and password for the administrator account and click Next. This information will be used later.
    15. Click Yes to the question 'Do you want to install this server as a Windows service?'. Click Next.
    16. Click No to the question 'Do you want to install this server in the Windows Start Menu?'. Click Next.
    17. Verify that the configuration parameters have been set correctly. If satisfied, click Create.
    18. On the 'Configuration Wizard Complete' panel, click Done.
  4. Configure Weblogic 7.0.
    1. Navigate to the C:\bea\user_projects\esri directory and double-click the StartWebLogic.cmd file.
      Note:
      This will get the server up and running. Enter the administrative username and password that you set in the installation here. It may take a few minutes for the server to boot itself up completely.
    2. Navigate to the C:\bea\user_projects\esri\applications\DefaultWebApp\WEB-INF directory and create a folder called classes.
    3. In the WEB-INF directory, open web.xml in a text editor. Add the following text under <web-app>:
      <servlet>
      <servlet-name>Esrimap</servlet-name>
      <servlet-class>com.esri.esrimap.Esrimap</servlet-class>
      </servlet>
      <servlet-mapping>
      <servlet-name>Esrimap</servlet-name>
      <url-pattern>/servlet/com.esri.esrimap.Esrimap/*</url-pattern>
      </servlet-mapping>
      
      Under the <welcome-file-list> tag, add:
      <welcome-file>default.htm</welcome-file>
    4. Save and close this file.
    5. Open a Web browser and navigate to http://<localhost>/console.
      Note:
      This will load the administration console. Log in with the administrator username and password again.
    6. In the left-hand panel, click Deployments, then Web Applications to expand it.
    7. Click DefaultWebApp.
    8. In the right-hand panel, click the Files tab and check the box labled Index Directories. Click Apply when finished.
    9. In the left-hand panel, click Servers to expand it.
    10. Click the name of the server; for example, esriweblogic.
    11. In the right-hand panel, click the Compilers tab under the Configuration tab.
    12. Set the Java Compiler field to point to the javac.exe file located in your JDK home directory, for example, <drive>:\j2sdk1.4.2\bin\javac.exe.
    13. Set the Append to Classpath field to point to the rt.jar file located in the JRE folder that, by default, is installed in the Program Files directory, for example, <drive>:\Program Files\Java\j2re1.4.2\lib\rt.jar.
    14. Click Apply when finished.
      Note:
      WebLogic installs with JDK 1.3.1_03, but that version of Java is not recommended for use with ArcIMS.
    15. Close the window and begin installing ArcIMS.
  5. Install ArcIMS 9.1 from the installation CD. Refer to the ArcIMS Installation Guide, Step 3a.
  6. To configure ArcIMS 9.1 with Weblogic 7.0 Advanced Server, run the ArcIMS Post Installation.
    1. Select Typical as the Post Installation option.
    2. On the dialog to select the Web site and Output directories, navigate to the following path: <Bea WebLogic Installation Directory>\user_projects\esridomain\apps\DefaultWebApp
    3. On the Web Server-Servlet Engine Configuration panel, select 'I will manually configure my Web server / servlet engine'.
    4. Click Finish.
  7. Configure Weblogic 7.0 for ArcIMS.
    1. Copy the following items for the <ArcIMS Installation Directory>/Connectors/Servlet to <WebLogic Installation Directory>/user_projects/esri/applications/DefaultWebApp/WEB-INF/classes:

      -com directory
      -Esrimap_prop
      -ServletConnector_Res.properties
      -ServletConnector_Res_en_US.properties
    2. Open the Esrimap_prop file in a text editor.
      Note:
      Make sure to open the Esrimap_prop file that was copied into the <WebLogic Installation Directory>/user_projects/esri/applications/DefaultWebApp/WEB-INF/classes directory.
    3. Change the value of appServerMachine to the name of the Application Server computer. For example:
      appServerMachine=<server name>.esri.com
      
    4. Save and close the Esrimap_prop file.
    5. Restart WebLogic 7.0.
  8. Verify that the ArcIMS installation was successful.
    1. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.
    2. Verify the Web server protocol and Web server name are correct, including the domain and port number. The default is port 80.
      Note:
      On Windows XP/2003 machines, Internet Explorer sometimes does not show the hostname and port number. If this is the case, right-click near the top of the window and select 'Allow Blocked Content'.
    3. Test both components. The result for Test 1 should be:

      IMS v9.1.0
      Build_Number=1084.1931
      Version=9.1.0
      Test successful

      The result for Test 2 should be:

      Version=9.1.0
      Build_Number=1084.2174
      Test successful
      Note:
      If these tests are successful, the ArcIMS Application Server and ArcIMS Servlet Connector are configured correctly. If an error message is received, select the error number from the dropdown list and click View. The error number and a description displays. Follow the instructions in the description to fix the problem and then try the Diagnostics tool again.
  9. See the ArcIMS 9.1 Installation Guide, Step 5; 'Configure ArcIMS' to finish setting up ArcIMS.