English

How To: Activate recycling for ArcIMS

Summary

These instructions are for ArcIMS 4.0 users only. Users with ArcIMS 4.0.1 should refer to the ArcIMS help topic "Enabling server recycling" for information.

Recycling is an automated method of refreshing system resources by planned restarts of the Spatial Servers. A number of properties related to reycling determine the method, scheduled or periodic; the starting time; and time delay when recycling multiple servers.

When a Spatial Server is recycled, all services associated with that Spatial Server will be unavailable during the recycling process. This includes any Virtual Servers (FeatureServer, MetadataServer, ImageServer´┐Ż) associated with the Spatial Server.

The delay parameter allows one Spatial Server to remain active while another is recycling (provided that more than 1 Spatial Server is available).

It is recommended that at least 1 additional Spatial Server is used when activating recycling. See the link in Related Information below for details on adding additional Spatial Servers.

Procedure

In this example, recycling will be set to occur once every 12 hours with a 15 minute delay. The actual recycle and delay times that you use are dependent on how much traffic your site experiences and how long it takes for your services to reload.

  1. Stop the ArcIMS services.
  2. In a text editor, open the Monitor.properties file.

    On Windows, this file is located in <ArcIMS Installation Directory>\ArcIMS\Server\Monitor.
    [O-Image] MinotorPropLoc
    On Linux/UNIX, this file is located in <ArcIMS Installation Directory>/ArcIMS/Monitor.
  3. Find the following section:

    Code:
    ### If recycling is enabled, then the recycleSpatialServer.delay
    ### parameter must also be set.
    recycleSpatialServer.scheme=none
    #recycleSpatialServer.scheme=periodic
    #recycleSpatialServer.scheme=scheduled

  4. Set the recycling scheme to periodic by adding a comment mark (#) in front of recycleSpatialServer.scheme=none and removing the # in front of recycleSpatialServer.scheme=periodic as shown below.

    Code:
    ### If recycling is enabled, then the recycleSpatialServer.delay
    ### parameter must also be set.
    #recycleSpatialServer.scheme=none
    recycleSpatialServer.scheme=periodic
    #recycleSpatialServer.scheme=scheduled


    The Monitor is now set for periodic recycling. Next, the times for beginning recycling and delay values must be set.
  5. Find the following section:

    Code:
    ### The interval in minutes for ArcIMS Monitor to recycle the ArcIMS
    ### Spatial Servers. The recycleSpatialServer.period parameter is required
    ### to be set if the recycleSpatialServer.scheme parameter is set to periodic.
    ### Example: If the value is set to 720 and the ArcIMS Monitor was started
    ### at 3 P.M., the first recycling will take place at 3 A.M. the next day.
    ### Subsequent recycling will be done every 12 hours until the ArcIMS Monitor
    ### is stopped.
    #recycleSpatialServer.period=720

  6. Remove the # from recycleSpatialServer.period=720 in order to establish a recycling period. Since the default setting is to recycle once every 12 hours (720 minutes) no other changes to this parameter are necessary. However, as an example, if recycling every 6 hours was desired, the parameter's value should be changed to 360.
  7. Find the following section:

    Code:
    ### If there are more than one ArcIMS Spatial Servers running on
    ### the ArcIMS Monitor, the ArcIMS Monitor will wait for the set time
    ### in minutes between recycling of the ArcIMS Spatial Servers.
    ### The recycleSpatialServer.delay parameter is required to be set
    ### if recycling of the ArcIMS Spatial Server is enabled.
    #recycleSpatialServer.delay=5

  8. Remove the # from recycleSpatialServer.delay=5 and change the value to 15.

    Code:
    ### If there are more than one ArcIMS Spatial Servers running on
    ### the ArcIMS Monitor, the ArcIMS Monitor will wait for the set time
    ### in minutes between recycling of the ArcIMS Spatial Servers.
    ### The recycleSpatialServer.delay parameter is required to be set
    ### if recycling of the ArcIMS Spatial Server is enabled.
    recycleSpatialServer.delay=15

  9. Save and close the file.
  10. Restart the ArcIMS services.

    Note:
    Additional information on recycling is available in ArcIMS Help. Open Help from any ArcIMS application.

Related Information