English

How To: Install ArcIMS Manager Applications: Author, Administrator, and Designer, on a machine other than the ArcIMS Host

Summary

Instructions provided are alternative steps to installing the ArcIMS Manager Applications on a machine on your network other than your ArcIMS host.
The documented method for installing the ArcIMS Manager applications (Author, Administrator, Designer) on a machine other than the ArcIMS host describes how to install these applications by accessing the ArcIMS Manager URL over an HTTP connection. This conventional method, which is documented in the ArcIMS help, has one caveat. When accessing ArcIMS Manager from a machine that doesn't have a Java Runtime Environment (JRE) installed, the browser is redirected to Sun's JRE download page. The problem is that the newest version of the JRE is downloaded. This version of JRE isn't supported with ArcIMS Manager; only versions 1.3.1_02 and 1.4.0 (with ArcIMS 4.0.1) and 1.4.2 (with ArcIMS 9.0) are supported.
 

Note:
ArcIMS also must be installed and configured successfully on your ArcIMS server prior to the below steps.

This installation will require the following:
  • ArcIMS Installation CD
  • A user account that has administrator rights on the machine
Certain Windows skills are required to install and configure ArcIMS. For details on these skills please see: Common Windows tasks when installing ArcIMS. 
For more information on the acronyms and terms used in this document, please see the glossary of terms used in installation documents.

Procedure

  1. Remove any existing ArcIMS-related software from the machine on which you want to install the Manager applications.
    Warning:
    To ensure success for this installation, it is best to start with a 'clean' machine. Therefore, uninstall previous versions of ArcIMS, ArcIMS Manager, ArcExplorer, JREs, and JDKs.
    1. To uninstall ArcIMS, navigate to Add/Remove Programs. Select ESRI ArcIMS 3.x or 4.0 and click Remove. Accept the default to remove all components and click Uninstall. If a dialog box appears asking to confirm removal of all shared components, click Yes-to-all.
    2. If a Java SDK is listed in Add/Remove Programs, uninstall it. If a Java Runtime Environment is listed, uninstall it.

      Some parts of ArcIMS may not function properly if there is more than one version of JDK/JRE installed. The correct versions to use with ArcIMS 4.0.1 are J2SDK 1.3.1_02 or 1.4.0.
    3. Open Windows Explorer and confirm that your JDK and/or JavaSoft/JRE folders were removed by the uninstall procedure. If not, delete them.
    4. Select and uninstall any other related ArcIMS software (ArcExplorer, ArcExplorer--Java Edition, Java Viewers) from the Add/Remove Programs window.
    5. Navigate to your temporary directory, such as <drive>:\temp or <drive>:\WINNT\temp, and delete any files with *.jar or *.tlb extensions.
    6. Navigate to <drive>:\WINNT and delete all *.tmp files and empty the Recycle Bin.
    7. Delete Temporary Internet files from your Web browser: in Internet Explorer, select Tools > Internet Options, then click Delete Files. Check the 'Delete all offline content' option and click OK.
    8. Reboot the computer.
  2. Share folders on your server where ArcIMS was originally installed and configured.
    1. Open Windows Explorer.
    2. Navigate to <drive>:\ArcIMS or wherever the folder was specified during installation.
    3. Right-click the folder and select Properties.
    4. Click the Sharing tab.
    5. Click Share this folder.
    6. Set required permissions and ask the Systems Administrator for assistance if uncertain about the permissions to be set.
    7. Click Apply and click OK.
  3. Install ArcIMS Manager Applications: Author, Administrator, Designer.
    1. Run Setup.exe from your ArcIMS installation CD.
    2. At the Select Features dialog box, choose only Manager.
    3. Click the dropdown arrow next to Manager. From the list, select 'Will be installed on local hard drive' to install Manager.
       
      Note:
      Installing Manager installs Manager and the Manager Applications (Author, Designer, and Administrator).
    4. Follow the directions on the screen to complete the install.
  4. Run the ArcIMS Post Installation.
    1. If the post installation did not start automatically, navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Post Installation.
    2. In the Post Installation Setup dialog box, click Typical. Click Next.
    3. Specify a UNC pathname to the shared ArcIMS directory on your Web server machine. Click Next.
    4. For the Working Directory, specify a UNC pathname to the shared ArcIMS directory on your Web server machine.

      For the Web server host name, enter the name of the Web server machine or the URL to the Web site, depending on how your server is set up. Click Next.
    5. For Application Server Host Name, enter the name of the machine where the ArcIMS application server is installed. The connector port should match what it was in your original installation. Click Next.
    6. Click Finish to exit.
  5. Test to see if the configuration works. Create an AXL file in Author.
    1. Start the ArcIMS Author Program: Start > Programs > ArcGIS > ArcIMS > Author.
    2. Add data to the map and symbolize as needed.
    3. Save the AXL file.
      Note:
      By default, the AXL file should be saved to the ArcIMS server machine under \\webserver_machine\ArcIMS\AXL.
      Warning:
      The data referenced in the AXL file should be from the Spatial Server's Perspective
    4. There are three options for referencing data in an AXL file: Local data, Mapped Drives, and UNC paths.
    5. Navigate to the AXL file in windows, and open in a text editor.
    6. Edit the IMAGEWORKSPACE and SHAPEWORKSPACE tags to reflect where the data is located from the server's perspective. If the data is currently referenced using a mapped drive, you will need to change it to one of the following: (See screenshots below)
      • Data can be copied and referenced by a local drive on the server (for example c:\data\cities\ )
      • Data may be referenced by a UNC pathname visible to the server (for example: \\data_machinename\data\ )

        [O-Image] Test to see if configuration works
  6. Run ArcIMS Administrator.
    1. Start the ArcIMS Administrator Program: Start > Programs > ArcGIS > ArcIMS > Administrator.
    2. Type the User Name and Password that were created on the ArcIMS server.
      Note:
      If you do not know the User Name and Password, ask the person who set up ArcIMS on the server.
    3. Click Services and create a new service for your AXL file.
    4. Click the Save Configuration button on the toolbar.
    5. Exit Administrator.
  7. Run ArcIMS Designer.
    1. Start the ArcIMS Designer Program: Start > Programs > ArcGIS > ArcIMS > Designer.
    2. Type a name for the Web site directory.
      Note:
      This will get created on the server machine under the ArcIMS\Website directory.
    3. Click Next.
    4. Select the service created with Administrator from the left panel and move it to the right panel. Click Next.
    5. Select the properties for the Web site to be used throughout the design process.
    6. When viewing the Web site Location Screen, make sure the Web server is specified in the path using UNC. For example: \\webserver_machine\ArcIMS\Website.
    7. Click Create Website.
    8. Click Exit to close Designer.
  8. Test your Web site in a browser.
    1. Open a Web browser.
    2. In the Address bar type: http://webserver_machine/website/
    3. Click the link to the Web site created in Designer.
    4. The ArcIMS Web site should appear in the browser.
Warning:
If this produces an error or if data is not found, recheck the installation steps detailed previously. Check to make sure all UNC path names are correct. Check to make sure the directories on the server are shared. Check to make sure that ArcIMS is running on the server.