PCONSOLE(1) General Commands Manual PCONSOLE(1)NAME
pconsole - parallel console shell for administering clusters.
SYNOPSIS
pconsole
DESCRIPTION
pconsole allows you to connect to each node of your cluster simultaneously, and you can type your administrative commands in a specialized
window that 'multiplies' the input to each of the connections you have opened. pconsole is best run from within X Windows, although it is
possible to employ it without X (in console mode) as well.
You need to install pconsole on only 1 machine in the cluster, this would usually be your central administrative node.
OPTIONS
pconsole need to be executed with superuser permissions, and enters in interactive mode let you attach other devices so that all the com-
mands sent to the console mode of pconsole are sent to the devices. This allows you to parallelize the execution of the same command in
various machines at a time.
pconsole has two working modes:
command mode
From this mode pconsole can attach and dettach devices, list the attached devices at a time, connect to sending mode where you can
send commands to the attached devices, and quit. To enter in command mode, use CTRL-A from sending mode.
sending mode
The mode where the commands sent to it are sent to the devices attached. To enter this mode use CTRL-D or use the console command.
SEE ALSO
/usr/share/doc/pconsole/README.gz xterm(1)AUTHOR
This manual page was written by Jesus Climent <jesus.climent@hispalinux.es>, for the Debian GNU/Linux system (but may be used by others).
PCONSOLE(1)
Check Out this Related Man Page
consadm(1m) System Administration Commands consadm(1m)NAME
consadm - select or display devices used as auxiliary console devices
SYNOPSIS
/usr/sbin/consadm
/usr/sbin/consadm [-a device...] [-p]
/usr/sbin/consadm [-d device...] [-p]
/usr/sbin/consadm [-p]
DESCRIPTION
consadm selects the hardware device or devices to be used as auxiliary console devices, or displays the current device. Only superusers are
allowed to make or display auxiliary console device selections.
Auxiliary console devices receive copies of console messages, and can be used as the console during single user mode. In particular, they
receive kernel messages and messages directed to /dev/sysmsg. On Solaris x86 based systems they can also be used for interaction with the
bootstrap.
By default, selecting a display device to be used as an auxiliary console device selects that device for the duration the system remains
up. If the administrator needs the selection to persist across reboots the -p option can be specified.
consadm runs a daemon in the background, monitoring auxiliary console devices. Any devices that are disconnected (hang up, lose carrier)
are removed from the auxiliary console device list, though not from the persistent list. While auxiliary console devices may have been
removed from the device list receiving copies of console messages, those messages will always continue to be displayed by the default con-
sole device.
The daemon will not run if it finds there are not any auxiliary devices configured to monitor. Likewise, after the last auxiliary console
is removed, the daemon will shut itself down. Therefore the daemon persists for only as long as auxiliary console devices remain active.
See eeprom(1M) for instructions on assigning an auxiliary console device as the system console.
OPTIONS
The following options are supported:
-a device Adds device to the list of auxiliary console devices. Specify device as the path name to the device or devices to be added to
the auxiliary console device list.
-d device Removes device from the list of auxiliary console devices. Specify device as the path name to the device or devices to be
removed from the auxiliary console device list.
-p Prints the list of auxiliary consoles that will be auxiliary across reboots.
When invoked with the -a or -d options , tells the application to make the change persist across reboot.
EXAMPLES
Example 1 Adding to the list of devices that will receive console messages
The following command adds /dev/term/a to the list of devices that will receive console messages.
example# consadm -a /dev/term/a
Example 2 Removing from the list of devices that will receive console messages
The following command removes /dev/term/a from the list of devices that will receive console messages. This includes removal from the per-
sistent list.
example# consadm -d -p /dev/term/a
Example 3 Printing the list of devices selected as auxiliary console devices
The following command prints the name or names of the device or devices currently selected as auxiliary console devices.
example# consadm
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables that affect the execution of consadm: LC_CTYPE, LC_MESSAGES, and
NLSPATH.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWcsu |
+-----------------------------+-----------------------------+
|Stability Level |Evolving |
+-----------------------------+-----------------------------+
SEE ALSO svcs(1), eeprom(1M), svcadm(1M), syslogd(1M), kadb(1M), environ(5), attributes(5), smf(5), sysmsg(7d), console(7d)NOTES
Auxiliary console devices are not usable for kadb or firmware I/O, do not receive panic messages, and do not receive output directed to
/dev/console.
The consadm service is managed by the service management facility, smf(5), under the service identifier:
svc:/system/consadm
Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using svcadm(1M). The ser-
vice's status can be queried using the svcs(1) command.
SunOS 5.11 27 Oct 2004 consadm(1m)