Performing diagnostics on Linux/Solaris

The diagnostics tool provides valuable information on the state of ArcGIS Server. It is a tool to

You can run this tool to determine whether ArcGIS Server was successfully configured for your system. This tool can be run in ArcGIS Server Manager or through the command line on your Linux/Solaris machine.

Run Diagnostics tool in ArcGIS Server Manager

In ArcGIS Server Manager, click the GIS Server > Diagnostics link on the left side of the page.

The tool lists the SOM machine and all the SOC machines. Select the machine that you would like to diagnose and click Run Diagnostics. See Interpret ArcGIS Server Diagnostics test results for the result.

メモメモ:

The server diagnostics tool assumes that ArcGIS Server Monitor is running on the hosts you want to run the diagnostics tool against. To start the Monitor, execute the following script on each of those hosts: <ArcGIS Server Installation directory>/scripts/startmonitor. See How the diagnostics tool works: the Monitor framework to learn more about the Monitor Framework.

Running the diagnostics tool from the command line on your Linux/Solaris system

You can also run this diagnostics tool from the command line. This allows you to run the tool on local or remote machines (for example, SOC-only installation machines) and run it on a scheduled basis.

The script is installed under <ArcGIS Server Installation Directory>/scripts/Server_diag_tool. You need to run this script as the ArcGIS Server Install owner, the user who owns the ArcGIS Server installation directory. You can run it in three modes.

  1. Interactive mode (default)
    % ./Server_diag_tool
    Runs diagnostic checks on ArcGIS Server hosts specified in the ArcGIS Server configuration file. This command provides a command line interface where you can select a particular host or a group of hosts on which to run diagnostic checks.
  2. Silent Mode
    % ./Server_diag_tool --silent
    Runs the diagnostic tool only on the local host from a terminal console.
  3. Custom Mode
    % ./Server_diag_tool --remote <HOSTNAME-1> <HOSTNAME-2>...<HOSTNAME-N>
    Runs diagnostic checks on ArcGIS Server hosts specified in the command line.

Interpret ArcGIS Server Diagnostics test results

The following is the information and explanation about all the checks performed by the diagnostics tool. Each diagnostics check is grouped with a code formatted DGXXX according to the part of ArcGIS Server it checks.

How the diagnostics tool works: the Monitor framework

The diagnostics tool is supported by the Monitor framework. The Monitor is a stand-alone program that runs on all ArcGIS Server machines as a background process. It must be running for diagnostic tools to function. The scripts to start and stop the Monitor are installed under the <ArcGIS Server Installation directory>/scripts folder and are called startmonitor/stopmonitor.

Monitor can be started or stopped by running

% <ArcGIS Server Installation directory>/scripts/startmonitor
% <ArcGIS Server Installation directory>/scripts/stopmonitor

When ArcGIS Server is started by running the startserver script, it will check if the monitor is already running. If not, this script will start the monitor. Running the stopserver script will NOT stop monitor process.

By default, Monitor runs on port 2422. This port number and other properties are set in the file <ArcGIS Server Installation directory>/java/tools/monitor/monitor.xml. The following properties can be modified in this file:


3/6/2012