This document is archived and information here might be outdated.  Recommended version.

IServerMachine2 Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Server > ESRI.ArcGIS.Server > Interfaces > IS > IServerMachine2 Interface
ArcGIS Developer Help

IServerMachine2 Interface

Provides access to properties of a server host machine for administrators.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.


Name Description
Read/write property Capacity The number of desired concurrently available configurations (the capacity) of the ArcGIS Server.
Read/write property Description The description of the host machine.
Read/write property Name The name of the machine that can host server objects for the GIS server.

Inherited Interfaces

Interfaces Description
IServerMachine Provides access to properties of a server host machine for administrators.

Classes that implement IServerMachine2

Classes Description
ServerMachine The ServerMachine object which provides information about the ServerMachine.


ArcGIS for Server is a distributed system. Server objects managed by the ArcGIS server can run on one or more host machines. A machine that can host server objects must have the Server Object Container (SOC) installed on it, and the machine must be added to the list of host machines managed by the Server Object Manager (SOM).

The IServerMachine2 interface allows you to configure the Capacity property of a machine to be added to the ArcGIS Server. The Capacity property defines the number configuration instances on an SOC machine that are allowed to run concurrently before the pool-shrinking algorithm engages. The pool-shrinking algorithm removes the least recently used configuration instances and replaces them with new instances. Capacity is dependent on system memory and CPU resources and should be tuned for each machine in the ArcGIS Server.

Use the AddMachine method of the IServerObjectAdmin interface to add new host machines to the ArcGIS Server. All server objects configured in the ArcGIS Server can run on any of the host machines, so all host machines must have access to the necessary data and output directories used by all the server objects.