This topic alphabetically lists the properties that apply to the VirtualServer class.
ClassDescription
object containing the fixed description (immutable metadata) of
the class from which this object is instantiated.
Settability of this property is read-only for most users. For users who have been
granted privileged write access (AccessRight.PRIVILEGED_WRITE
), this property is
settable only on create. After initial object creation, this property is read-only for all users.
Settability of this property is read-only for most users. For users who have been
granted privileged write access (AccessRight.PRIVILEGED_WRITE
), this property is
settable only on create. After initial object creation, this property is read-only for all users.
Settability of this property is read-only for most users. For users who have been granted privileged
write access (AccessRight.PRIVILEGED_WRITE
), this property is read/write. (The read/write access for those
users can only change if a change is made to the ACL on the object store that controls who has privileged write access to objects in that
object store).
VirtualServer
. This property must specify a valid URI in order
for the virtual servers within a site to receive forwarded requests.
A VirtualServer
is the only addressable unit for forwarded requests. A VirtualServer
must
provide connection strings so that a remote server can connect to it. You supply this connection information
in the EJBForwardingEndpoint property. If this property is empty, it is assumed that the administrator does not want the VirtualServer
to accept forwarded requests.
Request forwarding will not occur even if the Site
is configured to accept forwarded requests via its CanAcceptForwardedRequests property.
The following are URI examples for the specified application server environments (host name can be specified as the name or IP address):
"t3://Server1:7001/FileNet/Engine"
"iiop://Server1:2809/FileNet/Engine"
"jnp://Server1:1099/FileNet/Engine"
The maximum length of the URI string is 2083 characters.
For User
and Group
classes, the Id property takes the value of the
Security Identifier (SID) rather than the 128-bit GUID. The string representation of the
SID is in this example format: S-1-5-21-1559522492-2815155736-3711640725-55269
.
When Active Directory is used as the directory service for IBM FileNet P8, calls to
User.get_Id()
and Group.get_Id()
always return the current SID for the
principal, even if this user or group has only historical SIDs populating the Active
Directory server.
For a given property representation, the Id property has the following characteristics:
PropertyDescription.get_Id()
is equal to PropertyTemplate.get_Id()
, which is equal to PropertyDefinition.get_PrimaryId()
.PropertyDefinition.get_Id()
is not equal to PropertyDefinition.get_PrimaryId()
.PropertyDefinition.get_Id()
is not equal to PropertyDescription.get_Id()
.
For a newly created document object, you can override the Id property of its associated VersionSeries
object
before you save or check in the document for the first time.
Settability of this property is read-only for most users. For users who have been granted privileged
write access (AccessRight.PRIVILEGED_WRITE
), this property is read/write. (The read/write access for those
users could only change if a change is made to the ACL on the object store that controls who has privileged write access to objects in that
object store).
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 ClassDescription.NamePropertyIndex
has a value,
this property contains the value of the designated name property. If there is no designated name property value, and
the object has an Id property, this property contains the string value of the Id property. If neither of these conditions
is satisfied, this property contains an empty string.
For a ComponentRelationship
object, this property is read/write and specifies the name of the object.
Host name validation verifies that the host name of the destination virtual server matches what is recorded in its certificate. Certificate chain validation verifies the authenticity of the destination virtual server’s certificate using a valid certificate chain. This either requires the certificate to have been signed by a Certificate Authority, or the destination server's certificate to have been imported into the JRE of the source server.
If enabled for Content Platform Engine server communications, the endpoint specified by the ServerCommunicationURL property must have a SSL server certificate deployed on it. This certificate would then need to be deployed to all Content Platform Engine servers that communicate with this endpoint.
Use the following URL format:
protocol://host:port/wsi/FNCEWS40MTOM
.
Use the http or https protocol.
It is recommended that you reference a load balancer for the CPE servers in this site. Alternatively, you can use a comma-separated list of web service endpoint URLs for the server instances running under this virtual server.
ServerInstance
objects for a given virtual server.
Site
property defaults to the value of Domain.DefaultSite
.
Note that you cannot change the site directly on an ObjectStore
object.
To move an object store to a different site, you must change this property on the CmDatabaseConnection
object
that is referenced by the ObjectStore
object.
For IsolatedRegion
, this property is deprecated.