System Management Services 1.4 man pages


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

System Administration

smsconnectsc(1m)

DESCRIPTION
OPTIONS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

NAME

smsconnectsc - accesses a remote SC console

SYNOPSIS

smsconnectsc [-y|n]

smsconnectsc -h

DESCRIPTION

smsconnectsc creates a remote tip console session from a local SC in order to reach a hung remote SC console.

smsconnectsc enables the bit that connects the local SC's port B to the remote SC's RS-232 port A when you are logged in to the local SC. The remote SC is the SC that is hanging. Once the tty connection is enabled, smsconnectsc invokes a tip console session to the remote SC. Using the tip console session, you can do whatever needs to be done to the remote SC.

smsconnectsc works in the absence of an external connection to the remote SC. If the remote SC has an active external connection to port A, then smsconnectsc fails and the session usually hangs. To exit, type:

After you finish, there are several ways to end the session, depending on whether you logged in to the local SC using telnet or rlogin. See the EXTENDED DESCRIPTION section.

OPTIONS

The following options are supported.

-h: Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.
-n: Automatically answers "no" to all prompts.
-y: Automatically answers "yes" to all prompts.

EXTENDED DESCRIPTION

Usage

In the tip console window established by smsconnectsc, a tilde (~) that appears as the first character of a line is interpreted as an escape signal that directs the tip console to perform the following action:

~.

Disconnect the tip session.

If you have established a telnet session to the local SC this disconnects the tip session and you remain logged in to the local SC.

If you have established an rlogin session in to the local SC, this disconnects the tip session and also disconnects your rlogin session.

Note – The tilde does not appear on the display until after you have pressed the period.

~~.

Disconnect tip session.

~~. Works only with rlogin. If you have established a telnet session in to the local SC, you receive the following error message:

~.: Command not found

If you have established an rlogin session in to the local SC, this disconnects the tip session and you remain logged in to the local SC.

Note – The first tilde does not appear on the display screen. The second tilde does not appear until after you have pressed the period.

rlogin also processes tilde-escape sequences whenever a tilde is displayed at the beginning of a new line. If you need to send tilde sequence at the beginning of a line and you are using rlogin, use two tildes (the first escapes the second for rlogin). Alternatively, do not enter a tilde at the beginning of a line when running inside of rlogin. If you use a kill -9 command to terminate a console session, the window or terminal in which the smsconnectsc command was executed goes into raw mode, and appears hung. To escape this condition, type:

sc#:sms-user:> CTRL-j
sc#:sms-user:> stty sane
sc#:sms-user:> CTRL-j

Group Privileges Required

You must have platform administrator privileges to run this command.

Refer to Chapter 2, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4 Administrator Guide for more information.

EXAMPLES

Example 1. Creating a Remote Connection From the Local SC to the Hung Remote SC

In the following example the local SC is shown as sc1 and the remote SC is shown as sc0. Log in to the local SC as a platform administrator.

sc1:sms-user:> smsconnectsc
TTY connection is OFF. About to connect to other SC. 
Do you want to continue (yes/no)? y
connected 
sc0:sms-user:>

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 Types	Attribute Values
Availability	SUNWSMSop