Plasma GitLab Archive
Projects Blog Knowledge

Class type Netplex_types.controller

class type controller = object .. end

The controller is the object in the Netplex master process/thread that manages the containers, logging, and service definitions


method ptype : parallelization_type

The actually effective parallelization type

method sys_id : thread_sys_id

The thread running the controller

method controller_config : controller_config
method services : (socket_service * socket_controller *
workload_manager)
list

The list of controlled services

method add_service : socket_service -> workload_manager -> unit

Adds a new service. Containers for these services will be started soon. It is allowed to add several services with the same name (but it will be hard to distinguish them later).

method add_message_receiver : ctrl_message_receiver -> unit

Adds a message receiver. This receiver runs in the context of the controller and receives all messages sent to it. The name method must return the name.

method add_plugin : plugin -> unit

Adds a plugin. If the plugin object has already been added, this is a no-op.

Plugins must have been added before the first container is started. This is not checked, however. You are on the safe side when the plugin is added in the create_processor factory method, or in the post_add_hook of the processor.

method add_admin : (Rpc_server.t -> unit) -> unit

add_admin setup: Allows to bind another RPC program to the admin socket. The function setup will be called whenever a connection to the admin socket is established, and this function can call Rpc_server.bind to bind another RPC program. By default, only the Admin interface is available as described in netplex_ctrl.x.

Note that this RPC server runs in the scope of the controller! No additional process or thread is created.

method logger : logger

The logger

method event_system : Unixqueue.unix_event_system

The event system used by the controller. It must not be used from a container.

method restart : unit -> unit

Initiates a restart of all containers: All threads/processes are terminated and replaced by newly initialized ones.

method shutdown : unit -> unit

Initiates a shutdown of all containers. It is no longer possible to add new services. When the shutdown has been completed, the controller will terminate itself. Note that the shutdown is performed asynchronously, i.e. this method returns immediately, and the messaging required to do the shutdown is done in the background.

method send_message : string -> string -> string array -> unit

send_message destination msgname msgargs: Sends a message to destination. When this method returns, it is only ensured that the receivers registered in the controller have been notified about the message (so it can be made sure that any newly forked containers know about the message). It is not guaranteed that the existing containers are notified when this method returns. This can (and usually will) happen at any time in the future.

method send_admin_message : string -> string -> string array -> unit

send_message destination msgname msgargs: Sends an admin message to destination.

See send_message for the notification guarantees.

method register_lever : (controller -> encap -> encap) ->
int

let id = register_lever f: It is possible to register a function f in the controller, and run it over the internal RPC interface from any container. These functions are called levers. See activate_lever below. See also Netplex_cenv.Make_lever for a convenient way to create and use levers.

method activate_lever : int -> encap -> encap

Runs the registered lever directly

method containers : container_id list

Lists the containers

method containers_for : string -> container_id list

Lists the containers for a certain socket service name

method container_count : string -> int

The number of containers for a certain socket service name

method free_resources : unit -> unit

Should be called when the controller is finished, in order to free resources again. E.g. plugins are unplugged, and the master sockets are closed.

method startup_directory : string

The current directory at startup time

This web site is published by Informatikbüro Gerd Stolpmann
Powered by Caml