Represents a logical entity for managing a group of server instances. Multiple server instances can run simultaneously on a single physical machine, or can be deployed on separate machines. A virtual server is composed of multiple server instances logically operating together to provide a service or services. Clients of the Content Engine interact with a VirtualServer, rather than interacting with a specific ServerInstance. If a VirtualServer consists of a single ServerInstance, then the two are functionally equivalent. If a VirtualServer consists of multiple server instances, then client requests are distributed between each individual ServerInstance, providing scalability and high availability. Clients are not aware of which ServerInstance actually fulfilled their request.

When multiple server instances are configured to run as a VirtualServer, a third-party (non-FileNet) load balancing mechanism must exist if you want to distribute incoming requests among the server instances. This could be a Java™ Platform Enterprise Edition (Java EE) application server's clustering implementation, or it could be an external hardware or software load balancing product. In either case, an administrator, using the third-party's load balancing configuration tools, is responsible for configuring the load balancing for a VirtualServer.

VirtualServer objects are created dynamically during system initialization and startup based on the configured topology of the application server or via specific system properties. They cannot be created via the API. You can retrieve a persisted VirtualServer object by calling GetInstance or FetchInstance on the Factory.VirtualServer class.

Namespace:  FileNet.Api.Admin
Assembly:  FileNet.Api (in FileNet.Api.dll)

ToggleSyntax

Visual Basic (Declaration)
Public Interface IVirtualServer _
	Implements IIndependentlyPersistableObject, IIndependentObject, IEngineObject, ICloneable
C#
public interface IVirtualServer : IIndependentlyPersistableObject, 
	IIndependentObject, IEngineObject, ICloneable
Visual C++
public interface class IVirtualServer : IIndependentlyPersistableObject, 
	IIndependentObject, IEngineObject, ICloneable
JavaScript
FileNet.Api.Admin.IVirtualServer = function();
FileNet.Api.Admin.IVirtualServer.createInterface('FileNet.Api.Admin.IVirtualServer');

ToggleRemarks

Metadata

Auditable: false
AllowsInstances: false
AllowsSubClasses: false
ClassDefinitionName: None
IsDependent: false
IsHidden: false
Searchable: false
StorageType: Domain
SuperclassName: GenericObject

ToggleSee Also