Table of Contents

OIL2 Class Standard.CreateReplicasOnServers


class Standard . CreateReplicasOnServers {
        int32   activeReplicas;
        oid     activeThread;
        array   proxyObj;
        array   replica;
        int32   replicaTotal;
        array   stateVar;
        int32   waitForCount;
inherits from Object;

DESCRIPTION

The process of creating Byzantine fault-tolerant session across a pool pf participating processors is complex. The CreateReplicasOnServers class implements the necessary logic.

METHODS


Standard.CreateReplicasOnServers:create

CreateReplicasOnServers:create()

Method Description

See initialize.


Standard.CreateReplicasOnServers:initialize

CreateReplicasOnServers:initialize(string serverPoolName, int32 faultsToTolerate, string stateClassName, string stateObjectName, any additionalStateVarArgs, string proxyClassName, string proxyObjectName, any additionalProxyArgs)

Method Description

The initialize method takes a large number of arguments, which is an unfortunate consequence of the complexity of the underlying task.

serverPoolName
identifies the potential pool of servers which should be used to support the Byzantine fault-tolerant transaction
faultsToTolerate
indicates how many simultaneous faults must be tolerated; the total number of servers required is dependents on this value and is calculated as 3 * faultsTolerates + 1.
stateClassName
identifies the name of the class that implements the server-side implementation of the state variable.
stateObjectName
specifies the service name which will be an alias for the individual state variables.
additionalStateVarArgs
any arguments that need to be provided to the create method of the class denoted by stateClassName.
proxyClassName
identifies the name of the class that implements the proxy.
proxyObjectName
specifies the service name which will be an alias for the individual proxy variables.
additionalProxyArgs
any arguments that need to be provided to the create method of the class denoted by proxyClassName.


Standard.CreateReplicasOnServers:getNeededReplicaCount

CreateReplicasOnServers:getNeededReplicaCount()

Method Description

Returns the count of the number of replicas that could not be activated. A value of 0 corresponds to success and a value of -1 indicates no initialization has yet been attempted.


Standard.CreateReplicasOnServers:getReplicaList

CreateReplicasOnServers:getReplicaList()

Method Description

Returns an array of object Ids identifying each of the replicas.