Used by administrative clients to view, update, and receive observer updates from the IceGrid registry. Admin sessions are created either with the IceGrid::Registry object or the registry admin Glacier2::SessionManager object.
keepAlive — Keep the session alive.
getAdmin — Get the admin interface.
getAdminCallbackTemplate — Get a "template" proxy for admin callback objects.
setObservers — Set the observer proxies that receive notifications when the state of the registry or nodes changes.
setObserversByIdentity — Set the observer identities that receive notifications the state of the registry or nodes changes.
startUpdate — Acquires an exclusive lock to start updating the registry applications.
finishUpdate — Finish updating the registry and release the exclusive lock.
getReplicaName — Get the name of the registry replica hosting this session.
openServerLog — Open the given server log file for reading.
openServerStdErr — Open the given server stderr file for reading.
openServerStdOut — Open the given server stdout file for reading.
openNodeStdErr — Open the given node stderr file for reading.
openNodeStdOut — Open the given node stdout file for reading.
openRegistryStdErr — Open the given registry stderr file for reading.
openRegistryStdOut — Open the given registry stdout file for reading.
Keep the session alive. Clients should call this operation regularly to prevent the server from reaping the session.
Get the admin interface. The admin object returned by this operation can only be accessed by the session.
The admin interface proxy.
Get a "template" proxy for admin callback objects. An Admin client uses this proxy to set the category of its callback objects, and the published endpoints of the object adapter hosting the admin callback objects.
A template proxy. The returned proxy is null when the Admin session was established using Glacier2.
Set the observer proxies that receive notifications when the state of the registry or nodes changes.
registryObs
— The registry observer.
nodeObs
— The node observer.
appObs
— The application observer.
adptObs
— The adapter observer.
objObs
— The object observer.
IceGrid::ObserverAlreadyRegisteredException — Raised if an observer is already registered with this registry.
Set the observer identities that receive notifications the state of the registry or nodes changes. This operation should be used by clients that are using a bidirectional connection to communicate with the session.
registryObs
— The registry observer identity.
nodeObs
— The node observer identity.
appObs
— The application observer.
adptObs
— The adapter observer.
objObs
— The object observer.
IceGrid::ObserverAlreadyRegisteredException — Raised if an observer is already registered with this registry.
Acquires an exclusive lock to start updating the registry applications.
The current serial.
IceGrid::AccessDeniedException — Raised if the exclusive lock can't be acquired. This might happen if the lock is currently acquired by another session.
Finish updating the registry and release the exclusive lock.
IceGrid::AccessDeniedException — Raised if the session doesn't hold the exclusive lock.
Get the name of the registry replica hosting this session.
The replica name of the registry.
Open the given server log file for reading. The file can be read with the returned file iterator.
id
— The server id.
path
— The path of the log file. A log file can be opened only if it's declared in the server or service deployment descriptor.
count
— Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last count
lines.
An iterator to read the file.
IceGrid::FileNotAvailableException — Raised if the file can't be read.
IceGrid::ServerNotExistException — Raised if the server doesn't exist.
IceGrid::NodeUnreachableException — Raised if the node could not be reached.
IceGrid::DeploymentException — Raised if the server couldn't be deployed on the node.
Open the given server stderr file for reading. The file can be read with the returned file iterator.
id
— The server id.
count
— Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last count
lines.
An iterator to read the file.
IceGrid::FileNotAvailableException — Raised if the file can't be read.
IceGrid::ServerNotExistException — Raised if the server doesn't exist.
IceGrid::NodeUnreachableException — Raised if the node could not be reached.
IceGrid::DeploymentException — Raised if the server couldn't be deployed on the node.
Open the given server stdout file for reading. The file can be read with the returned file iterator.
id
— The server id.
count
— Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last count
lines.
An iterator to read the file.
IceGrid::FileNotAvailableException — Raised if the file can't be read.
IceGrid::ServerNotExistException — Raised if the server doesn't exist.
IceGrid::NodeUnreachableException — Raised if the node could not be reached.
IceGrid::DeploymentException — Raised if the server couldn't be deployed on the node.
Open the given node stderr file for reading. The file can be read with the returned file iterator.
name
— The node name.
count
— Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last count
lines.
An iterator to read the file.
IceGrid::FileNotAvailableException — Raised if the file can't be read.
IceGrid::NodeNotExistException — Raised if the node doesn't exist.
IceGrid::NodeUnreachableException — Raised if the node could not be reached.
Open the given node stdout file for reading. The file can be read with the returned file iterator.
name
— The node name.
count
— Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last count
lines.
An iterator to read the file.
IceGrid::FileNotAvailableException — Raised if the file can't be read.
IceGrid::NodeNotExistException — Raised if the node doesn't exist.
IceGrid::NodeUnreachableException — Raised if the node could not be reached.
Open the given registry stderr file for reading. The file can be read with the returned file iterator.
name
— The registry name.
count
— Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last count
lines.
An iterator to read the file.
IceGrid::FileNotAvailableException — Raised if the file can't be read.
IceGrid::RegistryNotExistException — Raised if the registry doesn't exist.
IceGrid::RegistryUnreachableException — Raised if the registry could not be reached.
Open the given registry stdout file for reading. The file can be read with the returned file iterator.
name
— The registry name.
count
— Specifies where to start reading the file. If negative, the file is read from the begining. If 0 or positive, the file is read from the last count
lines.
An iterator to read the file.
IceGrid::FileNotAvailableException — Raised if the file can't be read.
IceGrid::RegistryNotExistException — Raised if the registry doesn't exist.
IceGrid::RegistryUnreachableException — Raised if the registry could not be reached.