Monitoring Memory Usage of a Non-Responsive Server

If your Spectrum server stops responding, you can follow the steps below to monitor its performance and resource consumption. This monitoring provides information you can use to adjust memory and threading usage.

  1. Check whether a service other than the Mapping Service is working. For example, start the Feature Service on the demo page: http://<servername>:<port>/Spatial/FeatureService//DemoPage.html. This determines whether the whole server is down or just the Mapping Service.
  2. Verify you have enough disk space for both Mapping and MapTiling images to be stored by inspecting the configuration files:
    • Mapping: http://<server>:<port>/RepositoryService/repository/default/Configuration/MappingConfiguration under "<Directory> C:\Program Files\Pitney Bowes\Spectrum/server/modules/spatial/images </Directory>"
    • MapTiling: "http://<server>:<port>/RepositoryService/repository/default/Configuration/MapTilingConfiguration" under "<Property name="diskPath" value="C:/Program Files/Pitney Bowes/Spectrum/server/modules/spatial/TileCache"/>"
  3. Stop the Spectrum server.
  4. In a text editor, open the java.vmargs files from <Installed>\Pitney Bowes\Spectrum\server\modules\spatial\java.vmargs.
  5. Change the vmargs default of 2GB (2048MB). For example, to increase the memory of the remote component to 4GB, change the vmargs from the default of -Xmx2048m to -Xmx4096m. Do not exceed the maximum memory available to your operating system and leave a suitable space for the operating system to do its work.
  6. Save the java.vmargs file.
  7. Start the server wrapper:
    1. Open a command prompt as Administrator.
    2. Go to <Installed>\Pitney Bowes\Spectrum\server\bin\wrapper directory and type wrapper.exe -c.
    This Spectrum server will start in a few minutes.
  8. When the server is started, run the following requests from the demo pages:
    1. Open http://<servername>:<port>/Spatial/MappingService/DemoPage.html and run the List Named Maps request.
    2. Open http://<servername>:<port>/Spatial/FeatureService/DemoPage.html and run the List Table Names request.
  9. Go to <Installed>\Pitney Bowes\Spectrum\java64\bin and run jconsole.exe.
  10. Under Local Process, select the wrapper process.
  11. In Jconsole, add a new session and select the Feature Service process.
  12. In Jconsole, add a new session and select the Mapping Service process.
  13. Leave Jconsole running to monitor the memory, CPU, threads, and so on for the Spectrum Platform wrapper for Feature Service and Mapping Service.