@zeroc/ice
    Preparing search index...

    Class AdminSessionPrx

    Represents an administrative session between an admin tool and an IceGrid registry.

    The Slice compiler generated this proxy class from Slice interface ::IceGrid::AdminSession.

    Hierarchy (View Summary)

    Implements

    Index

    Constructors

    • Constructs a new AdminSessionPrx proxy.

      Parameters

      • communicator: Communicator

        The communicator for the new proxy.

      • proxyString: string

        The string representation of the proxy.

      Returns AdminSessionPrx

      The new AdminSessionPrx proxy.

      ParseException - Thrown if the proxyString is not a valid proxy string.

    Methods

    • Destroys this session.

      Parameters

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<void>

      An Ice.AsyncResult object representing the result of the invocation.

    • Checks whether the specified object is equal to this object.

      Parameters

      Returns boolean

      true if the specified object is equal to this object, false otherwise.

    • Finishes updating the registry and releases the exclusive lock.

      Parameters

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<void>

      An Ice.AsyncResult object representing the result of the invocation.

      IceGrid.AccessDeniedException Thrown when the session doesn't hold the exclusive lock.

    • Gets a proxy to the IceGrid admin object. The admin object returned by this operation can only be accessed by the session.

      Parameters

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<AdminPrx>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • IceGrid.AdminPrx | null : A proxy to the IceGrid admin object. This proxy is never null.
    • Gets 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.

      Parameters

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<ObjectPrx>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • Ice.ObjectPrx | null : A template proxy. The returned proxy is null when the Admin session was established using Glacier2.
    • Gets the name of the registry replica hosting this session.

      Parameters

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<string>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • string : The replica name of the registry.
    • Creates a proxy that is identical to this proxy, except for the adapter ID.

      Parameters

      • id: string

        The adapter ID for the new proxy.

      Returns this

      A proxy with the new adapter ID.

    • Creates a proxy that is identical to this proxy, but uses batch oneway invocations.

      Returns this

      A proxy that uses batch oneway invocations.

    • Creates a proxy that is identical to this proxy, except for connection caching.

      Parameters

      • cache: boolean

        true if the new proxy should cache connections, false otherwise.

      Returns this

      A proxy with the specified caching policy.

    • Creates a proxy that is identical to this proxy, except for its connection ID.

      Parameters

      • connectionId: string

        The connection ID for the new proxy. An empty string removes the connection ID.

      Returns this

      A proxy with the specified connection ID.

    • Creates a proxy that is identical to this proxy, except for the per-proxy context.

      Parameters

      • context: Map<string, string>

        The context for the new proxy.

      Returns this

      A proxy with the new per-proxy context.

    • Creates a proxy that is identical to this proxy, except for the endpoints.

      Parameters

      • endpoints: Endpoint[]

        The endpoints for the new proxy.

      Returns this

      A proxy with the new endpoints.

    • Creates a proxy that is identical to this proxy, except for the facet.

      Parameters

      • facet: string

        The facet for the new proxy.

      Returns this

      A proxy with the new facet.

    • Creates a proxy that is identical to this proxy, except it's a fixed proxy bound to the given connection.

      Parameters

      • connection: Connection

        The fixed proxy connection.

      Returns this

      A fixed proxy bound to the given connection.

    • Gets the adapter ID for this proxy.

      Returns string

      The adapter ID. If the proxy does not have an adapter ID, the return value is the empty string.

    • Gets the facet for this proxy.

      Returns string

      The facet for this proxy. If the proxy uses the default facet, the return value is the empty string.

    • Gets the type ID of the most-derived Slice interface supported by this object.

      Parameters

      • Optionalcontext: Map<string, string>

        The request context.

      Returns AsyncResult<string>

      An asynchronous result that resolves to the Slice type ID of the most-derived interface.

    • Gets the Slice interfaces supported by this object as a list of Slice type IDs.

      Parameters

      • Optionalcontext: Map<string, string>

        The request context.

      Returns AsyncResult<string[]>

      An asynchronous result that resolves to an array of the Slice type IDs of the interfaces supported by this object, in alphabetical order

    • Creates a proxy that is identical to this proxy, except for the invocation timeout.

      Parameters

      • timeout: number

        The new invocation timeout (in milliseconds).

      Returns this

      A proxy with the new timeout.

    • Tests whether this object supports a specific Slice interface.

      Parameters

      • typeId: string

        The type ID of the Slice interface to test against.

      • Optionalcontext: Map<string, string>

        The request context.

      Returns AsyncResult<boolean>

      An asynchronous result that resolves to true if the target object implements the Slice interface specified by typeId or implements a derived interface, false otherwise.

    • Determines whether this proxy is a fixed proxy.

      Returns boolean

      true if this proxy is a fixed proxy, false otherwise.

    • Determines whether this proxy uses oneway invocations.

      Returns boolean

      true if this proxy uses oneway invocations, false otherwise.

    • Determines whether this proxy uses twoway invocations.

      Returns boolean

      true if this proxy uses twoway invocations, false otherwise.

    • Creates a proxy that is identical to this proxy, except for the locator cache timeout.

      Parameters

      • timeout: number

        The new locator cache timeout (in seconds).

      Returns this

      A proxy with the new timeout.

    • Creates a proxy that is identical to this proxy, but uses oneway invocations.

      Returns this

      A proxy that uses oneway invocations.

    • Tests whether the target object of this proxy can be reached.

      Parameters

      • Optionalcontext: Map<string, string>

        The request context.

      Returns AsyncResult<void>

      An asynchronous result that resolves when the ping operation completes.

    • Creates a proxy that is identical to this proxy, but uses twoway invocations.

      Returns this

      A proxy that uses twoway invocations.

    • Keeps the session alive.

      Parameters

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<void>

      An Ice.AsyncResult object representing the result of the invocation.

      As of Ice 3.8, there is no need to call this operation, and its implementation does nothing.

    • Opens a node stderr file for reading.

      Parameters

      • name: string

        The node name.

      • count: number

        Specifies where to start reading the file. If negative, the file is read from the beginning. Otherwise, the file is read from the last count lines.

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<FileIteratorPrx>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • IceGrid.FileIteratorPrx | null : An iterator to read the file. This proxy is never null.

      IceGrid.FileNotAvailableException Thrown when the file can't be read.

      IceGrid.NodeNotExistException Thrown when the node doesn't exist.

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

    • Opens a node stdout file for reading.

      Parameters

      • name: string

        The node name.

      • count: number

        Specifies where to start reading the file. If negative, the file is read from the beginning. Otherwise, the file is read from the last count lines.

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<FileIteratorPrx>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • IceGrid.FileIteratorPrx | null : An iterator to read the file. This proxy is never null.

      IceGrid.FileNotAvailableException Thrown when the file can't be read.

      IceGrid.NodeNotExistException Thrown when the node doesn't exist.

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

    • Opens a registry stderr file for reading.

      Parameters

      • name: string

        The registry name.

      • count: number

        Specifies where to start reading the file. If negative, the file is read from the beginning. Otherwise, the file is read from the last count lines.

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<FileIteratorPrx>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • IceGrid.FileIteratorPrx | null : An iterator to read the file. This proxy is never null.

      IceGrid.FileNotAvailableException Thrown when the file can't be read.

      IceGrid.RegistryNotExistException Thrown when the registry doesn't exist.

      IceGrid.RegistryUnreachableException Thrown when the registry is unreachable.

    • Opens a registry stdout file for reading.

      Parameters

      • name: string

        The registry name.

      • count: number

        Specifies where to start reading the file. If negative, the file is read from the beginning. Otherwise, the file is read from the last count lines.

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<FileIteratorPrx>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • IceGrid.FileIteratorPrx | null : An iterator to read the file. This proxy is never null.

      IceGrid.FileNotAvailableException Thrown when the file can't be read.

      IceGrid.RegistryNotExistException Thrown when the registry doesn't exist.

      IceGrid.RegistryUnreachableException Thrown when the registry is unreachable.

    • Opens a server log file for reading.

      Parameters

      • id: string

        The server ID.

      • path: string

        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: number

        Specifies where to start reading the file. If negative, the file is read from the beginning. Otherwise, the file is read from the last count lines.

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<FileIteratorPrx>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • IceGrid.FileIteratorPrx | null : An iterator to read the file. This proxy is never null.

      IceGrid.DeploymentException Thrown when the server couldn't be deployed on the node.

      IceGrid.FileNotAvailableException Thrown when the file can't be read.

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

      IceGrid.ServerNotExistException Thrown when the server doesn't exist.

    • Opens a server stderr file for reading.

      Parameters

      • id: string

        The server ID.

      • count: number

        Specifies where to start reading the file. If negative, the file is read from the beginning. Otherwise, the file is read from the last count lines.

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<FileIteratorPrx>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • IceGrid.FileIteratorPrx | null : An iterator to read the file. This proxy is never null.

      IceGrid.DeploymentException Thrown when the server couldn't be deployed on the node.

      IceGrid.FileNotAvailableException Thrown when the file can't be read.

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

      IceGrid.ServerNotExistException Thrown when the server doesn't exist.

    • Opens a server stdout file for reading.

      Parameters

      • id: string

        The server id.

      • count: number

        Specifies where to start reading the file. If negative, the file is read from the beginning. Otherwise, the file is read from the last count lines.

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<FileIteratorPrx>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • IceGrid.FileIteratorPrx | null : An iterator to read the file. This proxy is never null.

      IceGrid.DeploymentException Thrown when the server couldn't be deployed on the node.

      IceGrid.FileNotAvailableException Thrown when the file can't be read.

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

      IceGrid.ServerNotExistException Thrown when the server doesn't exist.

    • Sets the observer identities that receive notifications when 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: Identity

        The registry observer identity.

      • nodeObs: Identity

        The node observer identity.

      • appObs: Identity

        The application observer.

      • adptObs: Identity

        The adapter observer.

      • objObs: Identity

        The object observer.

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<void>

      An Ice.AsyncResult object representing the result of the invocation.

      IceGrid.ObserverAlreadyRegisteredException Thrown when an observer is already registered with this registry.

    • Acquires an exclusive lock to start updating the registry applications.

      Parameters

      • Optionalcontext: Map<string, string>

        The Context map to send with the invocation.

      Returns AsyncResult<number>

      An Ice.AsyncResult object representing the result of the invocation, which resolves to:

      • number : The current serial.

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

    • Creates a new proxy from an existing proxy after confirming the target object's type via a remote invocation.

      Parameters

      • prx: ObjectPrx

        The source proxy.

      • Optionalfacet: string

        An optional facet name.

      • Optionalcontext: Map<string, string>

        The request context.

      Returns AsyncResult<AdminSessionPrx>

      A proxy with the requested type and facet, or null if the target object does not support the requested type.

    • Returns the Slice type ID associated with this type.

      Returns string

      The Slice type ID.