Home Previous Up Next Index

IceGrid::AdminSession

Overview

interface AdminSession extends ::Glacier2::Session

Used by administrative clients to view, update, and receive observer updates from the IceGrid registry. Admin sessions are created either with the Registry object or the registry admin ::Glacier2::SessionManager object.

See Also

Registry
::Glacier2::SessionManager

Operation Index

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.

Operations

void keepAlive()

Keep the session alive. Clients should call this operation regularly to prevent the server from reaping the session.

See Also

Registry::getSessionTimeout

Admin* getAdmin()

Get the admin interface. The admin object returned by this operation can only be accessed by the session.

Return Value

The admin interface proxy.

Object* getAdminCallbackTemplate()

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.

Return Value

A template proxy. The returned proxy is null when the Admin session was established using Glacier2.

void setObservers(RegistryObserver* registryObs, NodeObserver* nodeObs, ApplicationObserver* appObs, AdapterObserver* adptObs, ObjectObserver* objObs) throws ObserverAlreadyRegisteredException

Set the observer proxies that receive notifications when the state of the registry or nodes changes.

Parameters

registryObs
The registry observer.
nodeObs
The node observer.
appObs
The application observer.
adptObs
The adapter observer.
objObs
The object observer.

Exceptions

ObserverAlreadyRegisteredException
Raised if an observer is already registered with this registry.

void setObserversByIdentity(::Ice::Identity registryObs, ::Ice::Identity nodeObs, ::Ice::Identity appObs, ::Ice::Identity adptObs, ::Ice::Identity objObs) throws ObserverAlreadyRegisteredException

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.

Parameters

registryObs
The registry observer identity.
nodeObs
The node observer identity.
appObs
The application observer.
adptObs
The adapter observer.
objObs
The object observer.

Exceptions

ObserverAlreadyRegisteredException
Raised if an observer is already registered with this registry.

int startUpdate() throws AccessDeniedException

Acquires an exclusive lock to start updating the registry applications.

Return Value

The current serial.

Exceptions

AccessDeniedException
Raised if the exclusive lock can't be acquired. This might happen if the lock is currently acquired by another session.

void finishUpdate() throws AccessDeniedException

Finish updating the registry and release the exclusive lock.

Exceptions

AccessDeniedException
Raised if the session doesn't hold the exclusive lock.

string getReplicaName()

Get the name of the registry replica hosting this session.

Return Value

The replica name of the registry.

FileIterator* openServerLog(string id, string path, int count) throws FileNotAvailableException, ServerNotExistException, NodeUnreachableException, DeploymentException

Open the given server log file for reading. The file can be read with the returned file iterator.

Parameters

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.

Return Value

An iterator to read the file.

Exceptions

FileNotAvailableException
Raised if the file can't be read.
ServerNotExistException
Raised if the server doesn't exist.
NodeUnreachableException
Raised if the node could not be reached.
DeploymentException
Raised if the server couldn't be deployed on the node.

FileIterator* openServerStdErr(string id, int count) throws FileNotAvailableException, ServerNotExistException, NodeUnreachableException, DeploymentException

Open the given server stderr file for reading. The file can be read with the returned file iterator.

Parameters

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.

Return Value

An iterator to read the file.

Exceptions

FileNotAvailableException
Raised if the file can't be read.
ServerNotExistException
Raised if the server doesn't exist.
NodeUnreachableException
Raised if the node could not be reached.
DeploymentException
Raised if the server couldn't be deployed on the node.

FileIterator* openServerStdOut(string id, int count) throws FileNotAvailableException, ServerNotExistException, NodeUnreachableException, DeploymentException

Open the given server stdout file for reading. The file can be read with the returned file iterator.

Parameters

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.

Return Value

An iterator to read the file.

Exceptions

FileNotAvailableException
Raised if the file can't be read.
ServerNotExistException
Raised if the server doesn't exist.
NodeUnreachableException
Raised if the node could not be reached.
DeploymentException
Raised if the server couldn't be deployed on the node.

FileIterator* openNodeStdErr(string name, int count) throws FileNotAvailableException, NodeNotExistException, NodeUnreachableException

Open the given node stderr file for reading. The file can be read with the returned file iterator.

Parameters

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.

Return Value

An iterator to read the file.

Exceptions

FileNotAvailableException
Raised if the file can't be read.
NodeNotExistException
Raised if the node doesn't exist.
NodeUnreachableException
Raised if the node could not be reached.

FileIterator* openNodeStdOut(string name, int count) throws FileNotAvailableException, NodeNotExistException, NodeUnreachableException

Open the given node stdout file for reading. The file can be read with the returned file iterator.

Parameters

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.

Return Value

An iterator to read the file.

Exceptions

FileNotAvailableException
Raised if the file can't be read.
NodeNotExistException
Raised if the node doesn't exist.
NodeUnreachableException
Raised if the node could not be reached.

FileIterator* openRegistryStdErr(string name, int count) throws FileNotAvailableException, RegistryNotExistException, RegistryUnreachableException

Open the given registry stderr file for reading. The file can be read with the returned file iterator.

Parameters

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.

Return Value

An iterator to read the file.

Exceptions

FileNotAvailableException
Raised if the file can't be read.
RegistryNotExistException
Raised if the registry doesn't exist.
RegistryUnreachableException
Raised if the registry could not be reached.

FileIterator* openRegistryStdOut(string name, int count) throws FileNotAvailableException, RegistryNotExistException, RegistryUnreachableException

Open the given registry stdout file for reading. The file can be read with the returned file iterator.

Parameters

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.

Return Value

An iterator to read the file.

Exceptions

FileNotAvailableException
Raised if the file can't be read.
RegistryNotExistException
Raised if the registry doesn't exist.
RegistryUnreachableException
Raised if the registry could not be reached.

Home Previous Up Next Index