English

How To: Install WebLogic 8.1 with J2SDK 1.4.2 for ArcIMS 9.0 on Windows

Summary

Instructions provided are for the installation and configuration of WebLogic 8.1 Server Platform using J2SDK 1.4.2 for ArcIMS on Windows.

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

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

These instructions are for the WebLogic Platform Net Installer. Configuration steps outlined for ArcIMS, directory structures and dialog boxes vary from those for the WebLogic Server Package Installer.
This installation requires the following software: 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 or 4.0.1 must be uninstalled to install ArcIMS 9.0. The setup program for ArcIMS 9.0 on Windows will prompt for the removal of previously installed versions.

If ArcIMS components were 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.0.
  1. Uninstall any unsupported versions of J2SDK/JRE, Web Server and Servlet Engine. Refer to the following technical article for further details:
    How To: Uninstall ArcIMS-related third-party software on Windows.
  2. Install Java 2 SDK, Standard Edition Version 1.4.2.
    1. Click J2SDK 1.4.2 to download Sun Java 2 SDK, Standard Edition, version 1.4.2.
    2. Click 'Download' in the SDK column for the Windows version.
    3. Accept the license agreement.
    4. Click Windows Offline Installation, the first option, to download j2sdk-1_4_2-windows-i586.exe.
    5. Run the program after it has finished downloading.
    6. Accept all of the installation program defaults, unless changes are required.
  3. Install WebLogic 8.1 Server.
    1. Run the BEA setup program to install WebLogic 8.1
    2. Click Next at the 'Welcome' dialog
    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 the Typical installation type to install WebLogic Server, click Next.
    6. Accept the default directory, C:\bea\weblogic81, or select a different directory at the 'Choose Product Directory' dialog, and click Next.
    7. At the Installation Complete dialog, verify that the 'Install XML Spy' box is not checked. Then click Done to close the installer.
  4. Configure WebLogic 8.1 Server.
    • CREATE A WEBLOGIC DOMAIN
      1. Launch the Configuration Wizard under Start > Programs > BEA WebLogic Platform 8.1.
      2. Click 'Create a new WebLogic configuration'.
      3. Select the 'Basic WebLogic Server Domain' option at the 'Select a Configuration Template' dialog. Click Next.
      4. Select the Custom configuration. Click Next.
      5. Change the Name * parameter to reflect the current server name at the 'Administration Server Configuration' dialog.
      6. Change the Server Listen Port to 80. Click Next.
      7. Select the Skip option for each dialog screen until the 'Configure Username and Password' dialog appears.
      8. Type a username and password for the administrator account. Click Next.
      9. Select Yes to Install the Administrative Server as a Windows service on the 'Windows Options' dialog. Click Next.
      10. Click Next until the 'Create WebLogic Configuration' dialog appears.
      11. Change the configuration name from 'mydomain' to 'esridomain'.
      12. Click Create and then Done.
      13. Click Run Again.
    • CREATE THE DEFAULT WEB APPLICATION
      1. Click 'Add to an existing WebLogic configuration'.
      2. Select the WebLogic configuration directory just created to extend it. For example, C:\bea\user_projects\esridomain. Click Next.
      3. Check the box next to 'DefaultWebApp' at the 'Select a Configuration Extension' dialog and click Next.
      4. Select the Skip option for each dialog screen until the 'Creating WebLogic Configuration' dialog appears.
      5. Click Update.
      6. Click Done and then Exit.
  5. Install ArcIMS 9.0 from the installation CD. Refer to the ArcIMS 9.0 Installation Guide, Step 3a.
  6. Run the ArcIMS Post Installation to configure ArcIMS 9.0. See also the ArcIMS 9.0 Installation Guide, Step 3b.
    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 8.1 for ArcIMS.
    • CONFIGURE THE DOMAIN
      1. Navigate to <drive>:\bea\user_projects\esridomain\apps\DefaultWebApp\WEB-INF and create a folder called 'classes'.
      2. In a text editor, open the file web.xml, located in the WEB-INF directory. Add the following lines 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>
        
        In the <welcome-file-list> tag, insert:
        <welcome-file>default.htm</welcome-file>
        
      3. Save and close the file.
    • CONFIGURE THE SERVLET CONNECTOR
      1. Copy the contents, except for the aimsservletconnector.war file, from the directory: <drive>:\Program Files\ArcGIS\ArcIMS\Connectors\Servlet to the newly created classes folder at: <drive>:\bea\user_projects\esridomain\apps\DefaultWebApp\WEB-INF\classes.
      2. In a text editor, from the classes folder, open the file Esrimap_prop.
      3. Edit the variable appservermachine=APPSMACHINE to reflect the machine name of the computer where the ArcIMS Application Server is installed.
      4. Save and close the file.
      5. Start the Web server by going to Start > Programs > BEA Weblogic Platform 8.1 > User Projects > esridomain > Start Server.
      6. In a Web browser, launch the WebLogic console by browsing to http://<localhost>/console.
      7. Enter the username and password when prompted.
      8. Expand 'Deployments' and then 'Web Application Modules' in the left panel.
      9. Click 'DefaultWebApp'.
      10. Click the Targets tab
      11. Check the box next to the server name and click Apply
      12. Click the Deploy tab
      13. Click the Deploy button under the Actions column.
        Note:
        The Module Status column is listed as Active and the Status column is listed as Success
        
      14. Click the 'Configure Tab' then the 'Descriptor' tab below it.
      15. Check the 'Index Directory Enabled' box, then click Apply.
      16. Logout and close the console.
      17. Restart WebLogic in the Windows Services panel.
  8. Verify that the ArcIMS installation was successful.
    1. Click Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics. The ArcIMS Diagnostics page displays.
    2. Verify the Web server protocol and Web server name are correct, including the domain and port number. The default is port 80.
    3. Test both components. The result for test 1 should be:

      IMS v9.0.0
      Build_Number=871.1714
      Version=9.0.0
      Test successful

      The result for test 2 should be:

      Version=9.0
      Build_Number=871.1957
      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 in the drop-down list and click View. The error number and a description displays. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.
      
  9. See the ArcIMS 9.0 Installation Guide, Step 5: 'Configure ArcIMS' to finish setting up ArcIMS.

Related Information