English

How To: Configure WebSphere 3.5 and IIS5 for ArcIMS 3.1

Summary

Instructions for using WebSphere for IIS on Windows and ArcIMS 3.1.

Procedure

  1. Install IIS and Websphere 3.5. See the IISwithWS35 link in Related Information for details.
  2. 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. Java Development Kit (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, choose a protocol and change the Web Server Host Name, if needed.

    If you are setting up an Internet web site or a multiple ArcIMS Spatial Server configuration, you must include your domain name, for example, esri.esri.com.

    If your web server has a port number other than the default HTTP port (80), then 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 you choose the default, after installation you must create virtual directories for output and website.

    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 <drive>:\WebSphere\AppServer\servlets. Click Next.

    k) At the Windows Services Authorization screen, change your 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 your 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. 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 you have an older version.

    n) At the Installation Successful screen, click Finish to restart your computer. You MUST restart your computer.

    o) After ArcIMS installation, it is recommended that you update your Services file. This file contains a record of what ports are in use. It is typically located at <drive>:\WINNT\system32\drivers\etc.

    Open the Services file in a text editor, and add the Registry and Connector port numbers, for example,
    esri_reg 5353/tcp #ArcIMS registry port
    esri_conn 5300/tcp #ArcIMS connector port

    Save the file.

    This tells your system administrator which ports are 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.
  3. Configure WebSphere:
    a) Verify that the com directory, Esrimap_prop, WMSEsrimap_prop, jaxp.jar, parser.jar, ServletConnector_Res.properties, and ServletConnector_Res_en_US.properties files are at
    \WebSphere\AppServer\servlets.

    If not, on Windows NT, choose Start | Settings | Control Panel | Services; on Windows 2000, choose Start | Settings | Control Panel | Administrative Tools | Component Services.

    Stop your web server; then navigate to
    <ArcIMS Installation Directory>\Connectors\Servlet;
    and copy the com directory, Esrimap_prop, WMSEsrimap_prop, jaxp.jar, parser.jar, ServletConnector_Res.properties, and ServletConnector_Res_en_US.properties files to the appropriate location.

    Then Start your web server.

    b) Open \WebSphere\AppServer\bin\admin.config.

    Find the line
    com.ibm.ejs.sm.adminserver.classpath=

    and add the following at the end of the line:
    ;<drive>\:/WebSphere/AppServer/servlets/jaxp.jar;<drive>\:/WebSphere/AppServer/servlets/parser.jar

    Save the file. Then Stop and Start your web server and close the Services window.

    c) Choose Start | Programs | Esri | ArcIMS 3.1 | ArcIMS Diagnostics. The ArcIMS Diagnostics displays.

    d) Select your web server protocol, type your web server name including domain, and type your port number. The default is 80.

    e) Click Test to test the ArcIMS Servlet Connector and ArcIMS Application Server.

    If this test is successful, your 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.
  4. Create Virtual Directories for IIS:
    a) For IIS 4.0, choose Start | Programs | Windows NT Option Pack | Microsoft Internet Information Server | Internet Service Manager.

    For IIS 5.0, choose Start | Settings | Control Panel | Administrative Tools | Internet Services Manager.

    b) Under your localhost name, find Default Web Site. Click to highlight it.

    c) Click Action in the toolbar.

    d) From the dropdown menu, point to New and click Virtual Directory.

    The New Virtual Directory Wizard displays.

    e) Type “Manager” for the alias and click Next.

    f) Click Browse to select the ArcIMS Manager directory at
    <drive>:\Program Files\Esri\ArcIMS3.1\Manager or the alternate location you selected during Step 3e and click Next.

    g) For IIS 4.0, check Allow Directory Browsing and click Finish. For IIS 5.0, check Browse and click Next.

    Manager appears in the virtual directory list.

    Now create virtual directories for output and website.

    NOTE: If you browsed to the location of your web server root directory to create directories for output and website during ArcIMS installation, skip to step 4r.

    h) Click Default Web Site to highlight it.

    i) Click Action, point to New, and click Virtual Directory.

    j) Type “output” for the alias and click Next.

    k) Click Browse to select the ArcIMS output directory located where you placed it during installation, for example, C:\ArcIMS\output. Click Next.

    l) Check Allow Directory Browsing and click Finish.

    Output appears in the virtual directory list.

    m) Click Default Web Site to highlight it.

    n) Click Action, point to New, and click Virtual Directory.

    o) Type “website” for the alias and click Next.

    p) Click Browse to select the ArcIMS website directory located where you placed it during installation, for example, C:\ArcIMS\website. Click Next.

    q) Check Allow Directory Browsing and click Finish.

    Website appears in the virtual directory list.

    r) In the left panel, click sePlugins.

    s) In the right panel, right-click iis20.dll and choose Properties.

    t) Click the File Security tab and click Edit to change the Anonymous access and authentication control.

    u) Make sure Anonymous access is checked. For IIS 4.0, uncheck Windows NT Challenge/Response and click OK; for IIS 5.0, uncheck Integrated Windows Authentication and click OK.

    v) Close the console window.
  5. Configure ArcIMS:

    a) Increasing memory parameters for Java VM: ESRI recommends that you increase the Java VM memory parameters to support ArcIMS Manager and the Java Viewers.

    1) Choose Start | Settings | Control Panel | Java Plug-in.

    2) On the Basic tab, set the required memory parameters in the field named Java Run Time Parameters:
    javaw.exe -Xms<initial memory>m -Xmx<maximum memory>m
    For example: javaw.exe -Xms10m -Xmx256m

    3) Click Apply and close the window.

    b) Setting your PATH variable: In order to use the JAI libraries from Sun, you need to edit your PATH variable.

    Setting your Windows NT PATH variable
    1) Choose Start | Settings | Control Panel and double-click System.

    2) Click the Environment tab.

    3) In the System Variables window, click PATH (or create it if it doesn’t already exist) and add: ;<drive>:\Program Files\Javasoft\Jre\1.3.0_02\bin

    4) Click OK and close the Control Panel window.

    Setting your Windows 2000 PATH variable
    1) Choose Start | Settings | Control Panel and double-click System.

    2) Click the Advanced tab.

    3) Click Environment Variables.

    4) In the System Variable window:
    a) Click your system variable PATH.
    b) Click Edit and add: ;<drive>:\Program Files\javasoft\jre\1.3.0_02\bin

    5) Click OK and close the Control Panel window.

    c) Using ArcIMS with a proxy server: Use the Proxy Server properties to specify whether your local area network (LAN) uses a proxy server to connect to the Internet. A proxy server is a computer on your LAN that connects to the Internet without compromising the security of your internal network. If you are not sure how your LAN connects to the Internet, contact your system administrator.

    If you use proxy servers, then set the appropriate properties in the aimsproxy.properties file, which is located in your user profiles directory.

    If your LAN uses a proxy server to connect to the Internet for HTTP protocol requests:
    1) Find and open the aimsproxy.properties file in a text editor.

    2) Set the HostName and Port of the proxy server to use. For example:
    httpproxyhost=proxy.esri.com
    httpproxyport=5000

    If your LAN connects to the Internet via a proxy server using a secure HTTP protocol (HTTPS):
    1) Find and open the aimsproxy.properties file in a text editor.
    2) Set the HostName and Port of the https proxy server to use. For example:
    httpsproxyhost=httpsproxy.esri.com
    httpsproxyport=5010

    If your LAN doesn’t use a proxy server and is directly connected to the Internet, do not set these properties. By default, they are not set.

    You are ready to use ArcIMS.

Related Information