English

Error: Postinstallation setup: Web Server - Servlet Engine Configuration completed with errors

Error Message

During the postinstallation setup you receive the following error after configuring the Web server and servlet engine:

"Web Server - Servlet Engine Configuration completed with errors"

Cause

Automated Web server - servlet engine configuration was not successful.

The ArcIMSCfgTool_Log.log contains possible causes for this error, for example:

- Could not copy <file, directory>
- Could not back up file
- Could not find file
- Could not create virtual directory
- Could not add web app

Solution or Workaround

All postinstallation setup results are logged in the file <install_dir>\ArcIMS\Tools\tools.properties.

The file <install_dir>\ArcIMS\Tools\WebConfigAction.log lists all the parameters used by the Web server - servlet engine configuration.

Errors during the Web server - servlet engine configuration are logged in the file <install_dir>\ArcIMS\Tools\Windows\ArcIMSCfgTool_InstallLog.log.

Open the file ArcIMSCfgTool_InstallLog.log and check for errors. The most common problems can usually be solved by following these steps:

  1. Verify that the WebConfigAction.log contains the correct information. For example, the Web server host name is listed as 'myserver', but the Web server was configured to use the host's IP address, or 'myserver.domain.com'. Change this or other values using the ArcIMS configuration option in the ArcIMS postinstallation setup.

    A. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Post Installation.

    B. Select Custom and click Next.

    C. Select the ArcIMS Configuration option.

    D. Make the appropriate changes.

    E. Click Finish.

  2. Check that there is greater than 150 MB of disc space within the temporary files and on the target drive to provide enough space.

    If necessary, create space by emptying the recycling bin and Temp directory, deleting files that are no longer needed, or talk to your network administrator about creating more disk space.
  3. Check the installation guide to ensure that your Web server and servlet engine versions are supported by this ArcIMS postinstallation setup.

    If they are supported, verify that the Web server and servlet engine are running and communicating with each other. See Related Information below for this information.

    If they are not supported by automated configuration in the postinstallation setup, refer to the instructions to perform configuration manually in the installation guide, "Configure your Web server", Step 4.
  4. Check the existence of the source and target file/directory and confirm that write permissions exist to the target file/directory.

    With Microsoft IIS and Servlet Exec ISAPI on Windows, a common cause is that ServletExec does not have the necessary permissions. Make sure that read/write access to the ServletExec Data directory and all of its subdirectories and subcontents exist.

    A. Stop IIS.

    B. Navigate to the ServletExec ISAPI directory in the ServletExec installation folder. For example: \Program Files\New Atlanta.

    C. Right-click the ServletExec ISAPI directory and choose Properties.

    D. On Windows NT: Click Permissions;
    On Windows 2000/XP: Click the Security tab.

    E. Click Add.

    F. Select your computer name.
    On Windows NT: select from the 'List Names from' dropdown list;
    On Windows 2000: select from the 'Look in' dropdown list;
    On Windows XP: Click on Locations, select your computer name and click OK.

    G. Select the internet user account.
    On Windows NT/2000: Double-click IUSR_<computer name> and click OK;
    On Windows XP: Type IUSR_<computer name> and click OK.

    H. Highlight the user, Internet Guest Account: MYMACHINE\IUSR_<computer name>.

    I. Select the necessary permissions.
    On Windows NT: In the Type of Access dropdown list select Change and click OK;
    On Windows 2000/XP: For Write Permissions, choose Allow, and click OK.

    K. Restart IIS.

  5. Check if there are already virtual directories created or Web applications added for ArcIMS with your Web server and servlet engine.

    For example, if you receive this error:

    "TomCatConfig: AddWebApp esriadmin
    Status: ERROR
    C:\jakarta-tomcat-3.2.3\webapps/esriadmin/arcims/serverprop.jsp (Access is denied)",

    stop your Web server and servlet engine. Delete existing esriadmin, metadataexplorer, or manager folders in the mentioned webapps directory.
  6. Run the Web server - servlet engine configuration option again.

    A. Navigate to Start > Programs > ArcGIS > ArcIMS > ArcIMS Post Installation.

    B. Select Custom and click Next.

    C. Select the Web Server - Servlet Engine Configuration option and unselect any other options.

    D. Provide the appropriate information. Click the Help button for more information.

    E. Click Finish.

    F. Stop and restart your Web server and servlet engine. NOTE: If you are using Tomcat or Servlet Exec AS, start your servlet engine first.

Related Information