view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME
    cssh - Cluster administration tool

VERSION
    This documentation is for version: 4.13.2

SYNOPSIS
    cssh [-a '<command>'] [-K <seconds>] [-q] [-c '<filename>'] [-x <cols>]
    [-C '<filename>'] [--debug [[...] || <INTEGER>]] [-d] [-e
    '<[user@]<host>[:port]>'] [--fillscreen] [-f '<font>'] [-h] [-L '[tag]']
    [-H] [-o '<STRING>'] [-p <port>] [-Q] [-y <rows>] [-s] [-r '<filename>']
    [-t '<STRING>'] [-g] [-T '<title>'] [-u] [-?] [-A] [-l '<username>']
    [-v]

DESCRIPTION
    The command opens an administration console and an xterm to all
    specified hosts. Any text typed into the administration console is
    replicated to all windows. All windows may also be typed into directly.

    This tool is intended for (but not limited to) cluster administration
    where the same configuration or commands must be run on each node within
    the cluster. Performing these commands all at once via this tool ensures
    all nodes are kept in sync.

    Connections are opened using ssh which must be correctly installed and
    configured.

    Extra caution should be taken when editing files as lines may not
    necessarily be in the same order; assuming line 5 is the same across all
    servers and modifying that is dangerous. It's better to search for the
    specific line to be changed and double-check all terminals are as
    expected before changes are committed.

  Further Notes
    Please also see "KNOWN BUGS".

    *   The dotted line on any sub-menu is a tear-off, i.e. click on it and
        the sub-menu is turned into its own window.

    *   Unchecking a hostname on the Hosts sub-menu will unplug the host
        from the cluster control window, so any text typed into the console
        is not sent to that host. Re-selecting it will plug it back in.

    *   If your window manager menu bars are obscured by terminal windows
        see the "screen_reserve_XXXXX" options in the
        $HOME/.clusterssh/config file (see "FILES").

    *   If the terminals overlap too much see the "terminal_reserve_XXXXX"
        options in the $HOME/.clusterssh/config file (see "FILES").

    *   When using ClusterSSH on a large number of systems to connect to a
        single system using an SSH utility (e.g. you issue a command to to
        copy a file using scp from the remote computers to a single host)
        and when these connections require authentication (i.e. you are
        going to authenticate with a password), the sshd daemon at that
        location may refuse connections after the number "MaxStartups" limit
        in sshd_config is exceeded. (If this value is not set, it defaults
        to 10). This is expected behavior; sshd uses this mechanism to
        prevent DoS attacks from unauthenticated sources. Please tune
        sshd_config and reload the SSH daemon, or consider using the
        ~/.ssh/authorized_keys mechanism for authentication if you encounter
        this problem.

    *   If client windows fail to open, try running:

        "cssh -e {single host name}"

        This will test the mechanisms used to open windows to hosts. This
        could be due to either the "-xrm" terminal option which enables
        "AllowSendEvents" (some terminals do not require this option, other
        terminals have another method for enabling it - see your terminal
        documentation) or the configuration of "ssh".

OPTIONS
    Some of these options may also be defined within the configuration file.
    Default options are shown as appropriate.

    --action '<command>', -a '<command>'
        Run the command in each session, e.g. "-a 'vi /etc/hosts'" to drop
        straight into a vi session.

    --autoclose <seconds>, -K <seconds>
        Number of seconds to wait before closing finished terminal windows.

    --autoquit, -q
        Toggle automatically quiting after the last client window has closed
        (overriding the config file).

    --cluster-file '<filename>', -c '<filename>'
        Use supplied file as additional cluster file (see also "FILES").

    --cols <cols>, -x <cols>
        Number of columns

    --config-file '<filename>', -C '<filename>'
        Use supplied file as additional configuration file (see also
        "FILES").

    --debug [[...] || <INTEGER>]
        Enable debugging. Either a level can be provided or the option can
        be repeated multiple times. Maximum level is 9.

    --dump-config, -d
        Dump the current configuration in the same format used by the
        $HOME/.clusterssh/config file.

    --evaluate '<[user@]<host>[:port]>', -e '<[user@]<host>[:port]>'
        Display and evaluate the terminal and connection arguments to
        display any potential errors. The <hostname> is required to aid the
        evaluation.

    --fillscreen
        Resize terminal windows to fill the whole available screen

    --font '<font>', -f '<font>'