@zeroc/ice
    Preparing search index...

    Class AdminAbstract

    Provides administrative access to an IceGrid deployment.

    The Slice compiler generated this skeleton class from Slice interface ::IceGrid::Admin.

    Hierarchy (View Summary)

    Index

    Constructors

    Methods

    • Adds an application to IceGrid.

      Parameters

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.AccessDeniedException Thrown when the session doesn't hold the exclusive lock or when another session is holding the lock.

      IceGrid.DeploymentException Thrown when the application deployment failed.

    • Adds an object to the object registry. IceGrid gets the object type by calling ice_id on obj. The object must be reachable.

      Parameters

      • obj: ObjectPrx

        A proxy to the object. This proxy is never null.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.DeploymentException Thrown when the object can't be added.

      IceGrid.ObjectExistsException Thrown when the object is already registered.

    • Adds an object to the object registry and explicitly specifies its type.

      Parameters

      • obj: ObjectPrx

        The object to be added to the registry. The proxy is never null.

      • type: string

        The type name.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.DeploymentException Thrown when the application deployment failed.

      IceGrid.ObjectExistsException Thrown when the object is already registered.

    • Dispatches an incoming request to one of the methods of this generated class, based on the operation name carried by the request.

      Parameters

      Returns OutgoingResponse | PromiseLike<OutgoingResponse>

      The outgoing response (when the selected method returns a value), or a promise with the outgoing response (when the selected method returns a promise).

      Ice marshals any exception thrown by this method into the response.

    • Enables or disables a server. A disabled server can't be started on demand or administratively. The enable state of the server is not persistent: if the node is shut down and restarted, the server will be enabled by default.

      Parameters

      • id: string

        The server ID.

      • enabled: boolean

        true to enable the server, false to disable it.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.DeploymentException Thrown when the deployment of the server failed.

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

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

    • Gets adapter information for the replica group or adapter with the given ID.

      Parameters

      • id: string

        The adapter or replica group ID.

      • current: Current

        The Current object for the dispatch.

      Returns AdapterInfo[] | PromiseLike<AdapterInfo[]>

      A promise like object representing the result of the dispatch, which resolves to:

      • IceGrid.AdapterInfo[] : A sequence of AdapterInfo. If id refers to an adapter, this sequence contains a single element. If id refers to a replica group, this sequence contains adapter information for each member of the replica group.

      IceGrid.AdapterNotExistException Thrown when the adapter or replica group doesn't exist.

    • Gets the IDs of all adapters registered with IceGrid.

      Parameters

      • current: Current

        The Current object for the dispatch.

      Returns string[] | PromiseLike<string[]>

      A promise like object representing the result of the dispatch, which resolves to:

      • string[] : The adapter IDs.
    • Gets all the IceGrid applications currently registered.

      Parameters

      • current: Current

        The Current object for the dispatch.

      Returns string[] | PromiseLike<string[]>

      A promise like object representing the result of the dispatch, which resolves to:

      • string[] : The application names.
    • Gets the names of all IceGrid nodes currently registered.

      Parameters

      • current: Current

        The Current object for the dispatch.

      Returns string[] | PromiseLike<string[]>

      A promise like object representing the result of the dispatch, which resolves to:

      • string[] : The node names.
    • Gets the object info of all the registered objects whose stringified identities match the given expression.

      Parameters

      • expr: string

        The expression to match against the stringified identities of registered objects. The expression may contain a trailing wildcard (*) character.

      • current: Current

        The Current object for the dispatch.

      Returns ObjectInfo[] | PromiseLike<ObjectInfo[]>

      A promise like object representing the result of the dispatch, which resolves to:

      • IceGrid.ObjectInfo[] : All the object infos with a stringified identity matching the given expression.
    • Gets the names of all the IceGrid registries currently registered.

      Parameters

      • current: Current

        The Current object for the dispatch.

      Returns string[] | PromiseLike<string[]>

      A promise like object representing the result of the dispatch, which resolves to:

      • string[] : The registry names.
    • Gets the IDs of all the servers registered with IceGrid.

      Parameters

      • current: Current

        The Current object for the dispatch.

      Returns string[] | PromiseLike<string[]>

      A promise like object representing the result of the dispatch, which resolves to:

      • string[] : The server IDs.
    • Gets a proxy to the admin object of an IceGrid node.

      Parameters

      • name: string

        The IceGrid node name.

      • current: Current

        The Current object for the dispatch.

      Returns ObjectPrx | PromiseLike<ObjectPrx>

      A promise like object representing the result of the dispatch, which resolves to:

      • Ice.ObjectPrx | null : A proxy to the IceGrid node's admin object. This proxy is never null.

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

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

    • Get the hostname of a node.

      Parameters

      • name: string

        The node name.

      • current: Current

        The Current object for the dispatch.

      Returns string | PromiseLike<string>

      A promise like object representing the result of the dispatch, which resolves to:

      • string : The node hostname.

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

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

    • Gets the number of physical processor sockets in the computer where an IceGrid node is deployed. Note that this operation returns 1 on operating systems where this can't be automatically determined and where the IceGrid.Node.ProcessorSocketCount property for the node is not set.

      Parameters

      • name: string

        The node name.

      • current: Current

        The Current object for the dispatch.

      Returns number | PromiseLike<number>

      A promise like object representing the result of the dispatch, which resolves to:

      • number : The number of processor sockets or 1 if the number of sockets can't be determined.

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

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

    • Gets the object info of all the registered objects with a given type.

      Parameters

      • type: string

        The type name.

      • current: Current

        The Current object for the dispatch.

      Returns ObjectInfo[] | PromiseLike<ObjectInfo[]>

      A promise like object representing the result of the dispatch, which resolves to:

      • IceGrid.ObjectInfo[] : The object infos.
    • Gets a proxy to the admin object of an IceGrid registry.

      Parameters

      • name: string

        The registry name.

      • current: Current

        The Current object for the dispatch.

      Returns ObjectPrx | PromiseLike<ObjectPrx>

      A promise like object representing the result of the dispatch, which resolves to:

      • Ice.ObjectPrx | null : A proxy to the admin object of an IceGrid registry. This proxy is never null.

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

    • Gets the category for server admin objects. You can manufacture a server admin proxy from the admin proxy by changing its identity: use the server ID as name and the returned category as category.

      Parameters

      • current: Current

        The Current object for the dispatch.

      Returns string | PromiseLike<string>

      A promise like object representing the result of the dispatch, which resolves to:

      • string : The category for server admin objects.
    • Gets information about a server.

      Parameters

      • id: string

        The server ID.

      • current: Current

        The Current object for the dispatch.

      Returns ServerInfo | PromiseLike<ServerInfo>

      A promise like object representing the result of the dispatch, which resolves to:

      • IceGrid.ServerInfo : The server information.

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

    • Gets the system process ID of a server. The process ID is operating system dependent.

      Parameters

      • id: string

        The server ID.

      • current: Current

        The Current object for the dispatch.

      Returns number | PromiseLike<number>

      A promise like object representing the result of the dispatch, which resolves to:

      • number : The process ID.

      IceGrid.DeploymentException Thrown when the deployment of the server failed.

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

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

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

      Parameters

      • current: Current

        The Current object for the invocation.

      Returns string | PromiseLike<string>

      The Slice type ID of the most-derived interface.

    • Returns the Slice type IDs of the interfaces supported by this object.

      Parameters

      • current: Current

        The Current object for the invocation.

      Returns string[] | PromiseLike<string[]>

      The Slice type IDs of the interfaces supported by this object, in alphabetical order.

    • Tests whether this object supports a specific Slice interface.

      Parameters

      • typeID: string

        The type ID of the Slice interface to test against.

      • current: Current

        The Current object for the invocation.

      Returns boolean | PromiseLike<boolean>

      True if this object has the interface specified by typeID or derives from the interface specified by typeID.

    • Tests whether this object can be reached.

      Parameters

      • current: Current

        The Current object for the invocation.

      Returns void | PromiseLike<void>

    • Instantiates a server template.

      Parameters

      • application: string

        The application name.

      • node: string

        The name of the node where the server will be deployed.

      • desc: ServerInstanceDescriptor

        The descriptor of the server instance to deploy.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.AccessDeniedException Thrown when the session doesn't hold the exclusive lock or when another session is holding the lock.

      IceGrid.ApplicationNotExistException Thrown when the application doesn't exist.

      IceGrid.DeploymentException Thrown when the application deployment failed.

    • Checks if the server is enabled or disabled.

      Parameters

      • id: string

        The server ID.

      • current: Current

        The Current object for the dispatch.

      Returns boolean | PromiseLike<boolean>

      A promise like object representing the result of the dispatch, which resolves to:

      • boolean : true if the server is enabled, false otherwise.

      IceGrid.DeploymentException Thrown when the deployment of the server failed.

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

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

    • Pings an IceGrid node to see if it is active.

      Parameters

      • name: string

        The node name.

      • current: Current

        The Current object for the dispatch.

      Returns boolean | PromiseLike<boolean>

      A promise like object representing the result of the dispatch, which resolves to:

      • boolean : true if the node ping succeeded, false otherwise.

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

    • Pings an IceGrid registry to see if it is active.

      Parameters

      • name: string

        The registry name.

      • current: Current

        The Current object for the dispatch.

      Returns boolean | PromiseLike<boolean>

      A promise like object representing the result of the dispatch, which resolves to:

      • boolean : true if the registry ping succeeded, false otherwise.

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

    • Removes the adapter with the given ID.

      Parameters

      • id: string

        The adapter ID.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.AdapterNotExistException Thrown when the adapter doesn't exist.

      IceGrid.DeploymentException Thrown when the application deployment failed.

    • Removes an application from IceGrid.

      Parameters

      • name: string

        The application name.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.AccessDeniedException Thrown when the session doesn't hold the exclusive lock or when another session is holding the lock.

      IceGrid.ApplicationNotExistException Thrown when the application doesn't exist.

      IceGrid.DeploymentException Thrown when the application deployment failed.

    • Removes an object from the object registry. Only objects added with this interface can be removed with this operation. Objects added with deployment descriptors should be removed with the deployment mechanism.

      Parameters

      • id: Identity

        The identity of the object to remove.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.DeploymentException Thrown when the object can't be removed.

      IceGrid.ObjectNotRegisteredException Thrown when the object isn't registered with the registry.

    • Sends a signal to a server.

      Parameters

      • id: string

        The server ID.

      • signal: string

        The signal, for example SIGTERM or 15.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.BadSignalException Thrown when the signal is not recognized by the target server.

      IceGrid.DeploymentException Thrown when the deployment of the server failed.

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

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

    • Shuts down the IceGrid registry.

      Parameters

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

    • Shuts down an IceGrid node.

      Parameters

      • name: string

        The node name.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

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

      IceGrid.NodeUnreachableException Thrown when the node is unreachable.

    • Shuts down an IceGrid registry.

      Parameters

      • name: string

        The registry name.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

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

      IceGrid.RegistryUnreachableException Thrown when the registry is unreachable.

    • Synchronizes a deployed application. This operation replaces the current descriptor with a new descriptor.

      Parameters

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.AccessDeniedException Thrown when the session doesn't hold the exclusive lock or when another session is holding the lock.

      IceGrid.ApplicationNotExistException Thrown when the application doesn't exist.

      IceGrid.DeploymentException Thrown when the application deployment failed.

    • Synchronizes a deployed application. This operation replaces the current descriptor with a new descriptor only if no server restarts are necessary for the update of the application. If some servers need to be restarted, the synchronization is rejected with a DeploymentException.

      Parameters

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.AccessDeniedException Thrown when the session doesn't hold the exclusive lock or when another session is holding the lock.

      IceGrid.ApplicationNotExistException Thrown when the application doesn't exist.

      IceGrid.DeploymentException Thrown when the application deployment failed.

    • Updates a deployed application. This operation succeeds only when no server restarts are necessary for the update of the application. If some servers need to be restarted, the synchronization is rejected with a DeploymentException.

      Parameters

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.AccessDeniedException Thrown when the session doesn't hold the exclusive lock or when another session is holding the lock.

      IceGrid.ApplicationNotExistException Thrown when the application doesn't exist.

      IceGrid.DeploymentException Thrown when the application deployment failed.

    • Updates an object in the object registry. Only objects added with this interface can be updated with this operation. Objects added with deployment descriptors should be updated with the deployment mechanism.

      Parameters

      • obj: ObjectPrx

        A proxy to the object. This proxy is never null.

      • current: Current

        The Current object for the dispatch.

      Returns void | PromiseLike<void>

      A promise like object representing the result of the dispatch.

      IceGrid.DeploymentException Thrown when the object can't be updated.

      IceGrid.ObjectNotRegisteredException Thrown when the object isn't registered with the registry.

    • Obtains the Slice type ID of this type.

      Returns string

      The return value is always "::IceGrid::Admin".