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
, a third-party (non-FileNet) load balancing mechanism must exist to distribute incoming requests to the server instances. This may be a Java 2 Platform Enterprise Edition (J2EE) 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
.
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
object by calling
or
on the
class.
The following tables list the members exposed by IVirtualServer.
Public Properties
Name | Description | |
---|---|---|
![]() | Creator | Indicates the name of the user assigned as the creator of the object. Settability of this property is read-only for most users. For users who have been granted privileged write access ( |
![]() | DateCreated | Indicates the date and time the object was created. The Content Engine stores dates and times using Coordinated Universal Time (UTC). Settability of this property is read-only for most users. For users who have been granted privileged write access ( |
![]() | DateLastModified | Indicates the date and time the object was last modified. The Content Engine stores dates and times using Coordinated Universal Time (UTC). Settability of this property is read-only for most users. For users who have been granted privileged write access ( |
![]() | EJBForwardingEndpoint | Holds the EJB forwarding URI endpoint for a . This property must specify a valid URI in order for the virtual servers within a site to receive forwarded requests. A The following are URI examples for the specified application server environments (host name can be specified as the name or IP address):
The maximum length of the URI string is 2083 characters. |
![]() | Id | A representation of the Globally Unique Identifier (GUID), a unique 128-bit number, that is assigned to this Content Engine object when the object is created. When converted to a string, the Id property is typically depicted as 32 hexadecimal characters enclosed by brackets in the following format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}. For example, {3F2504E0-4F89-11D3-9A0C-0305E82C3301}. For For a given property representation, the Id property has the following characteristics:
For a newly created document object, you can override the Id property of its associated |
![]() | LastModifier | Indicates the name of the user who last modified the object. Settability of this property is read-only for most users. For users who have been granted privileged write access ( |
![]() | Name | The name for this object. For most classes, this property is read-only and returns the value of the designated name property for the object, or its ID if there is no name property. If For a |
![]() | ServerInstances | Represents a collection of objects for a given virtual server. |
![]() | Site | Identifies the site associated with a given object. A site represents a geographical area in the FileNet P8 domain. If you do not specify a site when creating the associated object, the value of that object's property defaults to the value of . |
![]() | SubsystemConfigurations | A list of subsystem configuration objects that reflect parameters of the configured subsystems. |