English

How To: Install IIS with ServletExec AS 6 and J2SDK 6 Update 16 for ArcIMS 10 on Windows

Summary

Instructions provided are for the installation and configuration of Internet Information Services (IIS) with ServletExec AS 6.0 using J2SE Development Kit 6 Update 18 for ArcIMS 10 on Windows.

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

This installation requires the following:

A user account that has Administrator rights on the ArcIMS machine is required. 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. These two steps ensure that the system meets the minimum requirements and assist in planning the ArcIMS site configuration.

Previous versions of ArcIMS must be uninstalled before proceeding. The setup program for ArcIMS on Windows prompts for the removal of previously installed versions.

If ArcIMS components are distributed among several computers, before continuing with the installation, remove the components on each computer by going to Add/Remove Programs and selecting Remove for ArcIMS.

Procedure

Previous versions of ArcIMS must be uninstalled before proceeding. The setup program for ArcIMS on Windows prompts for the removal of previously installed versions.

If ArcIMS components were distributed among several computers, it is recommended to first remove the components on each computer before continuing by going to Add/Remove Programs and selecting Remove for ArcIMS.

Warning:
A supported Web server and Servlet Engine must be properly installed and configured before running the setup program for ArcIMS.
Note:
For ServletExec AS 6.0 there is not an option for Web Server and Servlet Engine configuration at this screen select the option for manual configuration.
  1. Uninstall any unsupported versions of Java, Web Server, and Servlet Engine. Please refer to: How To: Uninstall ArcIMS-related third-party software on Windows.
  2. Install Java 2 Standard Edition Development Kit version 6 Update 16:
    1. Click J2SE Development Kit (JDK) 6 Update 16 to download Sun Java 2 SDK, Standard Edition, version 6 Update 16.
    2. Click Download JDK.
    3. Select a platform, and accept the license agreement.
    4. Click the download link for Java SE Development Kit 6u16. The file jdk-6u16-windows-i586.exe is downloaded.
    5. Run the installer after it has finished downloading.
    6. Accept all of the default installation options, unless changes are required. This installs both the Java Runtime Environment (JRE) and the Development Kit.
      Note:
      Registration of Java is optional.
    7. Navigate to Start > Settings > Control Panel > Java. On 64-bit machines, from the Control Panel select the View x86 Control Panel Icons folder.
    8. Click the Update tab, and uncheck Check for Updates Automatically.
    9. Click Apply, and close the Java Control Panel.  
      Note:
      If working on a 64-bit Windows OS, select the Windows x64 platform (the x64 version of the JDK is required by ServletExec on a 64-bit platform). If using the ArcIMS Java Viewers or ArcExplorer Java, also install a 32-bit JRE, as these require it.
  3. Install IIS
  4. Enable directory browsing if not already enabled.
    • Windows 2008
      1. Click Start > Administrative Tools > Internet Information Services (IIS) Manager.
      2. Click on machine name. In the center panel double-click on Directory Browsing.
      3. In the right panel, click Enable.
      4. In the left panel, click on machine name. In the right panel under Actions > Manage Server, click Restart.
    • Windows 2003
      1. Click Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager.
      2. Expand machine name (click on + beside machine name). Expand Web Sites. Right-click on Default Web Site and select Properties. Click Home Directory tab. Check box beside Directory browsing to enable directory browsing. Click OK.
      3. Select Default Web Site. Click the Stop item button (or right-click and select Stop). Click the Start item button (or right-click and select Start).
  5. Install ServletExec AS 6.0.
    1. Download ServletExec from the New Atlanta Web page: ServletExec 6.0 Windows AS for Microsoft IIS. An account to access the download must be created. Once access is granted, click ServletExec/AS 6.0 for Windows to download.
      Important::   
      For IIS 7 (on Win 2008/Vista/7) the “ISAPI Extensions” and “ISAPI Filters” Features must be installed. 
      Otherwise, IIS 7 will never load the installed ServletExec DLL and servlet requests will result in 404 responses. 
      This is true for both SE ISAPI and SE AS.
      Those two Windows Features may be enabled as follows:
      Control Panel > Programs > Programs & Features > Turn Windows features on or off.
      From there, navigate as follows:
      + Internet Information Services
      + World Wide Web Services
      + Application Development Features
      # ISAPI Extensions
      # ISAPI Filters
      Check the check boxes to enable ISAPI Extensions and ISAPI Filters. 
      Then the IIS Admin Service must be restarted, and Windows may need to be rebooted.
    2. Click Yes to stop IIS.
    3. Click Next at the ServletExec 6.0 Application Server Setup window.
    4. Select 'Install ServletExec AS instance' and click Next.
    5. Read the license agreement. Click Yes.
    6. Read the ServletExec Information window. Click Next.
    7. Accept the default location or click Browse to select a different location. Click OK to select a directory. Click Next.
    8. Enter a name for the ServletExec instance and click Next.
    9. Select Microsoft IIS, click Next. A pop-up appears, stating IIS must be stopped. Select Yes.
    10. Accept the default location for the ServletExec_Adaptor.dll.
    11. Accept the default or change the port which ServletExec AS instance uses to communicate with the Web server adaptor, click Next.
    12. Verify that the information in the following screen is correct and select Next.
    13. Enter a username and password to access the ServletExec Admin Pages. Click Next. If a pop-up comes up regarding the webadapter.properties file click OK.
    14. Click Yes to allow the installer to start the World Wide Web Publishing Service.
    15. Click Finish to complete the installation.
      For additional information regarding the ServletExec AS 6.0 installation click here.
  6. Verify Read/Write access for ServletExec has been applied.
    1. Navigate to the ServletExec AS directory in the ServletExec installation folder. For example, <drive:>\Program Files\New Atlanta\ServletExec AS
    2. Right-click on the ServletExec AS directory and select Properties.
    3. Click the Security tab.
    4. Click Add.
    5. In the drop-down list, select the computer name as location.
      • On Windows 2003: Click Advanced > Find Now. Select the user accounts IUSR_<machine_name> and Network Services to add them.
      • On Windows XP: Click Advanced > Find Now. Select the user account IUSR_<machine_name>.
      • On Windows 2008/7: Click Add.
    6. Click on Locations and select the computer name as location. Enter Users in the ‘Enter the objects name to select’ text box. Click OK.
    7. Select Allow for Write access to grant Read and Write permissions.
    8. Click OK to close the dialog box.
  7. Stop and start the IIS Admin and World Wide Web Publishing services by going to Start > Control Panel > Administrative Tools > Services and restart.
  8. Verify that IIS and ServletExec were installed successfully.
    1. Open a Web browser and type the following (case sensitive) URL into the browser, substituting the Web server name for <machine_name>:
      http://<machine_name>/servlet/TestServlet
      If the TestServlet Output screen displays, the install was successful. If this screen does not appear, there is a problem. Repeat the ServletExec installation steps.
    2. License ServletExec for production use (this requires the purchase of a license from New Atlanta). From the Start Menu navigate to [All] Programs > New Atlanta > ServletExec (Version) AS > ServletExec Admin.
    3. Under General on the left, click License. In the license key box, type the license number and click Enter License Key.
    4. Close ServletExec Admin.
  9. Install ArcIMS from the installation DVD/download. Refer to the ArcIMS Installation Guide Step 3a.
  10. Review the instructions for configuring ArcIMS and ServletExec AS 6.0.
    1. A. Locate the file arcimsservletconnector.war in the <ArcIMS install directory>\ArcIMS\Connectors\Servlet directory. This is the WAR file that will be deployed.
    2. Click Start > [All] Programs > New Atlanta > ServletExec 6.0 AS > ServletExec Admin to open ServletExec Admin.
    3. In the left sidebar under Web Applications, click Manage.
    4. Click Add Web Application.
    5. For Application Name, type: servlet
    6. For URL Context Path, type: /servlet
    7. For Location, type or Browse to: <ArcIMS install directory>\ArcIMS\Connectors\Servlet\arcimsservletconnector.war. Click Ok.
    8. Click Submit and close ServletExec Admin
    9. Navigate to the Esrimap_prop file located under the deployed servlet folder (for ex., <drive>:\Program Files\New Atlanta\ServletExec AS\se-<instance_name>\ServletExecData\default\servlet\WAR\WEB-INF\classes\).
    10. Edit the Esrimap_prop file, replacing APPSMACHINE (value of appServerMachine property) with name of machine ArcIMS Application Server is installed on. Save the file.
    11. Restart IIS
      • On Windows 2008, click Start > Administrative Tools > Internet Information Services (IIS) Manager. Click on the machine name. On the right side under Actions > Manage Server, click Restart.
      • On Windows 2003, navigate to Start > Control Panel > Administrative Tools > Services and stop and start the IIS Admin and World Wide Web Publishing services.
  11. To complete the configuration and authorize ArcIMS run the Post Installation, see the ArcIMS Installation Guide Step 3b.
  12. Create Output and Web site virtual directories.
    1. For IIS 7.0 (Windows Server 2008), click Start > Administrative Tools > Internet Information Services (IIS) Manager. Expand machine name and Sites. For IIS 7.0 (Windows Vista/7), click Start > Control Panel > [System and Maintenance] > Administrative Tools > Internet Information Services (IIS) Manager. Expand machine name and Sites.
    2. For IIS 6.0 (Windows Server 2003), click Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager. Expand machine name and Web Sites.
    3. For IIS 5.1 (Windows XP), click Start > Administrative Tools > Internet Information Services. Expand localhost folder and Web Sites.
    4. All Windows Operating Systems: Click Default Web Site to highlight it.
      • Windows Server 2008, Vista and Windows 7: Right-click and select Add Virtual Directory.
      • Windows Server 2003 and Windows XP: Right-click > New > Virtual Directory.
      • Windows 2003 and Windows XP only (Windows Server 2008, Vista, and Windows 7 skip this step): the Virtual Directory Creation Wizard displays. Click Next.
    5. Windows Server 2008, Vista and Windows 7: In the Alias text box, type 'output'.
    6. Windows 2003 and Windows XP: Type the following for the Alias: output and Click Next.
    7. Windows Server 2008, Vista, and Windows 7: Click the Browse button next to the Physical path text box. Browse to location of ArcIMS Output directory chosen during installation (for example, C:\ArcIMS\Output). Click OK. Click OK. 'output' appears in the virtual directory list.
      Windows 2003 and Windows XP: Click Browse and browse to location of ArcIMS Output directory chosen during installation (for example, C:\ArcIMS\Output). Click OK. Click Next.
    8. Windows Server 2008, Vista and Windows 7: Expand Default Web Site if unexpanded. Click on Output directory to highlight. In the right panel (Actions), click Edit Permissions. Click Security tab > Edit > Add > Locations and select the computer name as location. Click OK. Enter Users in the ‘Enter the objects name to select’ text box. Click OK. Under Group or user names, click on Users. Under Permissions for Users, grant the user the following permissions: Read & execute, List folder contents, and Read. Click OK. Click OK.
      Windows 2003 and Windows XP: Enable the following Access Permissions: Read, Run Scripts (such as ASP), and Browse by checking the box next to each one, if not enabled. Click Next, and click Finish. 'output' appears in the virtual directory list.
    9. For IIS 7.0 (Windows Server 2008), click Start > Administrative Tools > Internet Information Services (IIS) Manager. Expand machine name and Sites. For IIS 7.0 (Windows Vista/7), click Start > Control Panel > [System and Maintenance] > Administrative Tools > Internet Information Services (IIS) Manager. Expand machine name and Sites.
      For IIS 6.0 (Windows Server 2003), click Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager. Expand machine name and Web Sites.
      For IIS 5.1 (Windows XP), click Start > Administrative Tools > Internet Information Services. Expand localhost folder and Web Sites.
    10. All Windows Operating Systems: Click Default Web Site to highlight it.
    11. Windows Server 2008, Vista, and Windows 7: Right-click and select Add Virtual Directory.
      Windows Server 3003 and Windows XP: Right-click > New > Virtual Directory.
    12. Windows 2003 and Windows XP only (Windows Server 2008, Vista and Windows 7 skip this step): the Virtual Directory Creation Wizard displays. Click Next.
    13. Windows Server 2008, Vista, and Windows 7: In the Alias text box, type 'website'.
      Windows 2003 and Windows XP: Type the following for the Alias: 'website'. Click Next.
    14. Windows Server 2008, Vista, and Windows 7: Click the Browse button next to the Physical path text box. Browse to location of ArcIMS Website directory chosen during installation (for example, C:\ArcIMS\Website). Click OK. Click OK. 'website' appears in the virtual directory list.
      Windows 2003 and Windows XP: Click Browse and browse to location of ArcIMS Web site directory chosen during installation (for example, C:\ArcIMS\Website). Click OK. Click Next.
    15. Windows Server 2008, Vista, and Windows 7: Expand Default Web Site if unexpanded. Click on Output directory to highlight. In right panel (Actions) click Edit Permissions. Click Security tab. Click Edit. Click Add. Click on Locations and select the computer name as location. Click OK. Enter Users in the ‘Enter the objects name to select’ text box. Click OK. Under Group or user names, click on Users. Under Permissions for Users, grant the user the following permissions: Read & execute, List folder contents, and Read. Click OK, and click OK again.
      Windows 2003 and Windows XP: Enable the following Access Permissions: Read, Run Scripts (such as ASP), and Browse by checking the box next to each one, if not enabled. Click Next, and click Finish. 'website' appears in the virtual directory list.

      Virtual directories for Output and Website are created.
  13. Verify that the ArcIMS installation was successful. See How To: Run Diagnostics for ArcIMS 9.3 or 10 for more information.