Sun Remote System Control (RSC) User's Guide

RSC Configuration Variables

RSC has non-volatile configuration variables you can use to change RSC behavior. The installer sets most configuration variables during installation. After installation, you can use the GUI, RSC shell, or the rscadm set command to set or change configuration variables.

You must have A level user permission to set configuration variables from the GUI or RSC shell; you must log in to the server as root to use the rscadm set command.

Use the show command to show configuration variables, and use the set command to set a variable. Changes to variables take effect immediately except as noted.

You can use the null string ("") to set a variable to null. To set a variable to a string that includes spaces, enclose the string in double quotes.

Serial Port Variables

`serial_baud`

This variable sets the RSC serial port baud rate. Valid values are:

9600
19200
38400
57600
115200

The default setting is 9600. Changes to this variable take effect on the next login connection over the RSC serial port.

If you change the serial baud rate after configuring the serial port modem, you must reconfigure the modem; see "Modem Reconfiguration Required After Changing RSC Serial Port Settings".

`serial_parity`

This variable sets the RSC serial port parity; valid values are none, odd, or even. The default setting is none. Changes to this variable take effect on the next login connection over the RSC serial port.

If you change the serial parity setting after configuring the serial port modem, you must reconfigure the modem; see "Modem Reconfiguration Required After Changing RSC Serial Port Settings".

`serial_stop`

This variable sets the number of RSC stop bits; valid values are 1 or 2. The default setting is 1. Changes to this variable take effect on the next login connection over the RSC serial port.

If you change the serial stop bits setting after configuring the serial port modem, you must reconfigure the modem; see "Modem Reconfiguration Required After Changing RSC Serial Port Settings".

`serial_data`

This variable sets the number of RSC data bits; valid values are 7 and 8. The default setting is 8. Changes to this variable take effect on the next login connection over the RSC serial port.

If you change the serial data bits setting after configuring the serial port modem, you must reconfigure the modem; see "Modem Reconfiguration Required After Changing RSC Serial Port Settings".

`serial_hw_handshake`

This variable controls whether RSC uses hardware handshaking on the serial port. Valid values are true and false; the default setting is true. If set to true, hardware flow control and modem control are enabled. If set to false, RSC disconnects a session connected to the serial port after 10 minutes of inactivity.

`ppp_local_ip_addr`

Use this variable to specify the Internet protocol (IP) address for RSC to use during a PPP session; use standard dot notation. If this variable is empty, RSC expects the remote node to set the Internet address dynamically. The default setting is 0.0.0.0 (empty). Changes to this variable take effect on the next PPP connection over the RSC serial port.

`ppp_remote_ip_addr`

Use this variable to specify the IP address for the remote node during a PPP session; use standard dot notation. If this variable is empty, RSC expects that the remote node already has an Internet address assigned for the PPP session. The default setting is 0.0.0.0 (empty). Changes to this variable take effect on the next PPP connection over the RSC serial port.

`ppp_enabled`

Use this variable to specify whether PPP is the default protocol on the RSC serial port. Valid values are true or false; the default is false. Changes to this variable take effect on the next login connection over the RSC serial port.

Alert Variables

`page_enabled`

Use this variable to specify whether paging is enabled for RSC alerts. Valid values are true or false; the default is false.

`mail_enabled`

Use this variable to specify whether an email message is enabled for RSC alerts. Valid values are true or false; the default is false.

`page_info1`

This variable contains the phone number and associated pager ID number for sending a TAP alert to a pager. Use the character @ to separate the telephone number and ID. Valid characters are:

digits (0-9)
* (asterisk)
# (pound sign
, (comma)

If both the page_info1 and page_info2 variables are empty, or if the page_enabled variable is set false, no paging will occur. The default setting for page_info1 is empty. For example:

rsc> set page_info1 18004420500@1234332

`page_init1`

This variable specifies a string consisting of attention (AT) commands used for configuring the RSC modem prior to sending an alert to pager 1.

`page_password1`

This variable contains the pager service password used to send an alert to pager 1. The password must be an alphanumeric string of six characters or fewer.

`page_baud1`

This variable specifies the serial port baud rate to use when sending an alert to pager 1. Valid values are 300, 1200, 2400, 4800, and 9600. After RSC sends the page alert, the baud setting reverts to the setting specified in the serial_baud variable.

`page_data1`

This variable specifies the number of RSC serial port data bits for sending an alert to pager 1. Valid values are 7 and 8. After RSC sends the page alert, the data bits revert to the setting specified in the serial_data variable.

`page_parity1`

This variable specifies the RSC serial parity for sending an alert to pager 1. Valid values are none, odd, and even. After RSC sends the page alert, the parity reverts to the setting specified in the serial_parity variable.

`page_stop1`

This variable specifies the number of RSC serial port stop bits for sending an alert to pager 1. Valid values are 1 and 2. After RSC sends the page alert, the stop bits revert to the setting specified in the serial_stop variable.

`page_info2`

This variable contains the phone number and associated pager ID number for sending a TAP alert to another pager. Use the character @ to separate the telephone number and ID. Valid characters are:

digits (0-9)
* (asterisk)
# (pound sign
, (comma)

If both the page_info1 and page_info2 variables are empty, or if the page_enabled variable is set false, no paging will occur. The default setting for page_info2 is empty. For example:

rsc> set page_info2 18004420596@4433444

`page_init2`

This variable specifies a string consisting of attention (AT) commands used for configuring the RSC modem prior to sending an alert to pager 2.

`page_password2`

This variable contains the pager service password used to send an alert to pager 2. The password must be an alphanumeric string of six characters or fewer.

`page_baud2`

This variable specifies the serial port baud rate to use when sending an alert to pager 2. Valid values are 300, 1200, 2400, 4800, and 9600. After RSC sends the page alert, the baud setting reverts to the setting specified in the serial_baud variable.

`page_data2`

This variable specifies the number of RSC serial port data bits for sending an alert to pager 2. Valid values are 7 and 8. After RSC sends the page alert, the data bits revert to the setting specified in the serial_data variable.

`page_parity2`

This variable specifies the RSC serial parity for sending an alert to pager 2. Valid values are none, odd, and even. After RSC sends the page alert, the parity reverts to the setting specified in the serial_parity variable.

`page_stop2`

This variable specifies the number of RSC serial port stop bits for sending an alert to pager 2. Valid values are 1 and 2. After RSC sends the page alert, the stop bits revert to the setting specified in the serial_stop variable.

`customerinfo`

This variable contains customer information used in the message generated for a pager or email alert, for instance, one of the following:

Server service contract number (recommended)

Server location

Name or telephone extension of the server's system administrator

Name of the department that owns the server

This string can be up to eight characters, including alphanumeric characters and hyphen (-). The default setting is empty.

`hostname`

This variable contains the name of the server connected directly to RSC; RSC includes this name in alert messages. This string can be up to eight characters, including alphanumeric characters and hyphen (-). The default setting is empty.

`mailuser`

This variable contains the address used for email alerts. The string has a 40-character limit; the default setting is empty. Although only a single mail address is permitted, you can notify several people that a problem has occurred by using an email alias.

`mailhost`

This variable contains a colon-separated list of Internet addresses to which RSC sends SMTP mail alerts. Each address is tried until the SMTP alert is successfully transmitted. Specify addresses using standard dot notation. For example:

rsc> set mailhost 139.143.4.2:139.142.4.15

You can specify a maximum of two addresses. If this variable is empty, or if the mail_enabled variable is set to false, no email is sent. The default setting is empty.

Ethernet Port Variables

`ip_mode`

Use this variable to control how RSC configures the IP address for its local Ethernet port. Choose the ip_mode value according to the services available on the network to which RSC is connected. The following list describes the available values.

none - Ethernet port is disabled and is not accessible.

dhcp - Use the dhcp protocol to obtain the IP address.

config - Use the ip_addr configuration variable to obtain the IP address.

The default setting is dhcp. Changes to this variable take effect after the next RSC reset.

`ip_addr`

This variable is only used if the ip_mode variable is set to config. Specify the IP address in standard Internet dot notation; the default setting is 0.0.0.0 (empty). Changes to this variable take effect after the next RSC reset.

`ip_netmask`

This variable is only used if the ip_mode variable is set to config. Specify the subnet mask in standard Internet dot notation; the default setting is 0.0.0.0 (empty). Changes to this variable take effect after the next RSC reset.

`ip_gateway`

This variable is only used if the ip_mode variable is set to config. This is the default gateway to which RSC will send IP packets when the destination is not on the same subnet as RSC. Specify the IP address in standard Internet dot notation; the default setting is 0.0.0.0 (empty). Changes to this variable take effect after the next RSC reset.

Console Session Variable

`escape_char`

This variable sets the escape sequence character for ending a console session and returning to the RSC shell. The escape sequence applies to all RSC users for the server. The escape sequence consists of the escape character followed by a period. The default escape character is ~ (tilde).

The escape sequence character can be a single alphanumeric character. It can also be a control character. To enter a control character as the escape character, type "^" (Shift-6) to represent the Control key, followed by another character. If the second character is a question mark (?), the Delete key is selected; otherwise the second character is converted to a control character and used as the escape character. For example, if you enter ^y to set the escape character, users will use Control-y to end a console session.