English

How To: Install and configure ArcIMS 3.1 with WebLogic on Windows

Summary

Instructions provided are for the installation of WebLogic 6.0sp1 on IIS 4.0 or 5.0 Web server with ArcIMS 3.1 on Windows.

Note:
Check that the version of ArcIMS shown in 'Software' in the title bar above, matches the version you are using. Do not continue if these do not match. Refer to Related Information, below, for an article providing the installation on a more recent version of ArcIMS, or return to the ESRI Online Support Site to locate the instructions you require.

Procedure

  1. Install WebLogic:
    A. At the opening screen, select English and click OK.
    B. At the Welcome screen, click Next.
    C. At the License Agreement screen, select Yes and click Next.
    D. At the Choose Install Set, select server only and click Next.
    E. At the Choose BEA Home Directory screen, type the drive you want the install to or accept the default and click Next.
    F. At the Choose Product Directory screen, click Next.
    G. At the Default Server Configuration screen, type weblogic for Server Name, type 80 for the Listen Port, accept the other values, and click Next.
    H. At the Install Weblogic Server Service screen, choose No and click Next. (Install as a service later.)
    I. At the Create System Password screen, type the password to be used and click Install.
    J. At the Install Complete screen, click Done.
  2. Configure WebLogic:
    A. Click Start > Programs > BEA WebLogic > WebLogic Server 6.0 > Start Default Server and start WebLogic.
    B. A DOS window should display. At the prompt, type the password established in step 1I above.
    C. Open Windows Explorer and navigate to <drive>:\bea\wlserver6.0\config\mydomain\applications\DefaultWebApp_weblogic\WEB-INF.
    D. Create a directory called classes.
    E. In a text editor, open <drive>:\bea\wlserver6.0\config\mydomain\applications\DefaultWebApp_weblogic\WEB-INF\web.xml.
    F. Under the line <web-app>, add:
    Code:
    <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>
    <welcome-file-list>
    	<welcome-file>default.htm</welcome-file>
    </welcome-file-list>
    Save the file and close the text editor.
    G. Click Start > Programs > BEA Weblogic > WebLogic Server 6.0 > Start Default Console.
    H. Type the password established in step 1I.
    I. In the left sidebar, click Web Applications.
    J. Click DefaultWebApp_weblogic.
    K. On the right, under the Files tab, check the box to enable Index Directories and click Apply.
    L. Close the Default Console and the DOS window.
  3. Install ArcIMS 3.1:
    A. Run ArcIMS setup.exe.
    B. At the Welcome screen, click View Readme to read about last-minute changes to the ArcIMS installation instructions. Close the window when done. Click Next. At the License Agreement screen, click I Agree.
    C. At the Installation Type screen, click Typical and click Next.
    D. At the Installation Directory screen, click Browse to change the installation directory, if desired, and click OK. Click Next.
    E. If JRE 1.3.0_02 is not installed or not detected, a Java Runtime Environment Installation screen displays. You must have JRE installed to install and run ArcIMS Manager and the Java Viewers.
    Note:
    The setup program looks for a specific registry entry to determine if JRE is installed on your computer. JDK 1.3 does not create the registry entry even though it contains a valid JRE.
    Click OK to begin JRE installation or Browse to an existing JDK location. After JRE installation, click Next to continue ArcIMS installation.
    F. At the Host Name and Working Directories screen, select a protocol and change the Web Server Host Name, if necessary.
    If you are setting up an Internet Web site or a multiple ArcIMS Spatial Server configuration, include the domain name; for example: esri.esri.com. If the web server has a port number other than the default HTTP port (80), it should have the syntax webservername:port number; for example: esri.esri.com:81.
    G. For the Web Site Working Directory, accept the default location to store Web pages and ArcIMS output, or click Browse to change the directory.
    Note:
    If choosing the default, after installation, create virtual directories for output and website. See Step 13 below for instructions.
    If you browse to the location of your web server root directory, then you don’t need to create virtual directories for output and website.
    H. For the User’s Working Directory, accept the default location or click Browse to navigate to another location. Click Next.
    I. At the Application Server Information screen, change the Registry Port and Connector Port, if desired.
    The ArcIMS Spatial Server, Monitor, and Tasker communicate with the ArcIMS Application Server via the Registry port.
    The Servlet Connector and ArcIMS Application Server communicate via the Connector port. Click Next.
    J. At the Servlet Connector Directory screen, Browse to the location of the Servlet directory, for example, <drive>:\bea\wlserver6.0sp1\config\mydomain\applications\DefaultWebApp_myserver\WEB-INF\classes.
    If you don’t know this location, click Help for a list of the most common Servlet directory locations.
    If unsure, use this location: <ArcIMS Installation Directory>\Connectors\Servlet and contact the system administrator. In this case, the servlet connector (com directory and associated files) must be moved from <ArcIMS Installation Directory>\Connectors\Servlet to the appropriate web server directory before using ArcIMS. Click Next.
    K. At the Windows Services Authorization screen, change the Domain\User Name, if necessary. The User Name and Password must be for the installation account and must have administrator privileges.
    This information gives ArcIMS the ability to start Windows services: ArcIMS Application Server, Monitor, and Tasker, and gives the ArcIMS Spatial Server the necessary privileges to access resources on the local computer and/or network.
    L. Type the Password for the selected User Name and type it again to confirm it. Click Next.
    M. At the Summary of Installation Information screen, verify that the information displayed is correct. After installation, it is written to a log file located at
    <ArcIMS Installation Directory>\Common\InstallSummary.log.
    Click Next to begin installation.
    Note:
    Microsoft’s Java VM 3186 or later is required for the ArcIMS Windows Services. The installation prompts you to update your system if Microsoft Java VM is not detected or if there is an older version.
    N. At the Installation Successful screen, click Finish to restart the computer.
    Note:
    You must restart the computer to complete ArcIMS installation.
    O. After ArcIMS installation, updating the Services file is recommended. This file contains a record of the ports in use. It is typically located at <drive>:\WINNT\system32\drivers\etc.
    Open the Services file in a text editor, scroll to the place where the port numbers fit, and add the Connector and Registry port numbers to the file; for example:
    Code:
    esri_conn    5300/tcp    #ArcIMS connector port
    esri_reg     5353/tcp    #ArcIMS registry port
    Save the file.

    This tells the system administrator the ports in use, so they will not be duplicated. The port numbers are listed on the ArcIMS Summary screen; this information is written to a summary log file located at <ArcIMS Installation Directory>\Common.
  4. Configure WebLogic to work with ArcIMS:
    A. Open Windows Explorer and navigate to
    <drive>:\bea\wlserver6.0\config\mydomain.
    B. In a text editor, open the installNtService.cmd file.
    C. Append the following to the set CLASSPATH= line:
    Code:
    <drive>:\bea\wlserver6.0\config\mydomain\applications\DefaultWebApp_weblogic\WEB-INF\classes\jaxp.jar;
    <drive>:\bea\wlserver6.0\config\mydomain\applications\DefaultWebApp_weblogic|WEB-INF\classes\parser.jar
    D. Add the password established in step 1i to the “Install the Service” command line. For example:
    Code:
    -install  -svcname:weblogic  -password:”your_password” �.
    E. Save the file and close the text editor.
    F. Execute the installNtService.cmd file.
  5. Use the diagnostics tool to test the ArcIMS installation:
    A. Click Start > Programs > Esri > ArcIMS 3.1 > ArcIMS Diagnostics. The ArcIMS Diagnostics displays.
    B. Select the web server protocol, type the web server name including domain, and type the port number. The default is 80.
    C. Click Test to test the ArcIMS Servlet Connector and ArcIMS Application Server.
    If this test is successful, the ArcIMS Application Server and ArcIMS Servlet Connector are configured correctly.
    If you receive an error message, select the error number in the dropdown list and click View. The error number and a description display. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.
  6. Optional Steps to deploy ArcIMS Manager:
    A. On Windows NT, choose Start > Settings > Control Panel > Services; on Windows 2000, choose Start > Settings > Control Panel > Administrative Tools > Component Services. Stop all three ArcIMS services.
    See: How To: Stop and start the ArcIMS services or processes
    B. Paste the entire Manager directory from:
  7. <drive>:\Program Files\Esri\ArcIMS3.1\Manager
    to
    <drive>:\bea\wlserver6.0\config\mydomain\applications\DefaultWebApp_weblogic
    C. Start all three ArcIMS services.
  8. for the final step to run ArcIMS refer to the ArcIMS 3.1 Installation Guide, "Step 5: Configure ArcIMS".

Related Information