Steve Traugott > IS-Init > IS::Init

Download:
IS-Init-0.93.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.93   Source  

NAME ^

IS::Init - Clusterwide "init", spawn cluster applications

SYNOPSIS ^

  use IS::Init;

  my $init = new IS::Init;

  # spawn all apps for resource group "foo", runlevel "run"
  $init->tell("foo","run");

  # spawn all apps for resource group "foo", runlevel "runmore"
  # (this stops everything started by runlevel "run")
  $init->tell("foo","runmore");

DESCRIPTION ^

This module provides basic "init" functionality, giving you a single inittab-like file to manage initialization and daemon startup across a cluster or collection of machines.

USAGE ^

This module's package includes a script 'isinit', which is intended to be a bolt-in cluster init tool, calling IS::Init. The script is called like 'init', with the addition of a new "resource group" argument.

This module is intended to be used like 'init' and 'telinit' -- the first execution runs as a daemon, spawning and managing processes. Later executions talk to the first, requesting it to switch to different runlevels.

The module references a configuration file, /etc/isinittab by default, which is identical in format to /etc/inittab, with a new "resource group" column added. This file must be replicated across all hosts in the cluster by some means.

A "resource group" is a collection of applications and physical resources which together make up a coherent function. For example, sendmail, /etc/sendmail.cf, and the /var/spool/mqueue directory might make up a resource group. From /etc/isinittab you could spawn the scripts which update sendmail.cf, mount mqueue, and then start sendmail itself.

PUBLIC METHODS ^

new

The constructor accepts an optional hash containing the paths to the configuration file and to the socket, like this:

  my $init = new IS::Init (
      'config' => '/etc/isinittab',
      'socket' => '/var/run/is/init.s'
      'initstat' => '/var/run/is/initstat'
                          );

The first time this method is executed on a machine, it opens a UNIX domain socket, /var/run/is/init.s by default. Subsequent executions communicate with the first via this socket.

tell($resource_group,$runlevel)

This method talks to a running IS::Init daemon, telling it to switch the given resource group to the given runlevel.

All processes listed in the configuration file (normally /etc/isinittab) which belong to the new runlevel will be started if they aren't already running.

All processes in the resource group which do not belong to the new runlevel will be killed.

Other resource groups will not be affected.

BUGS ^

AUTHOR ^

        Steve Traugott
        CPAN ID: STEVEGT
        stevegt@TerraLuna.Org
        http://www.stevegt.com

COPYRIGHT ^

Copyright (c) 2001 Steve Traugott. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.

SEE ALSO ^

perl(1).

syntax highlighting: