C H A P T E R 8 |
Using ALOM CMT Configuration Variables |
This chapter contains information on ALOM CMT configuration variables and consists of:
ALOM CMT has nonvolatile configuration variables that you can use to change ALOM CMT behavior. The default values for these variables are preinstalled. You customize the variables for the first time using the setupsc interactive script command. You can change settings for individual variables using the ALOM CMT shell. See setupsc for more information.
To Use Configuration Variables in the ALOM CMT Command Shell |
Note - You must have a level user permission to set configuration variables from the ALOM CMT shell. Refer to userperm for more information about setting user permissions. |
From the ALOM CMT command shell:
To specify a value (or values) for a settable variable, use the setupsc command.
See setupsc.
To show the configuration variables and their settings, use the showsc command.
See showsc.
To set a value for a configuration variable, use the setsc command.
See setsc.
To reset all variables to their factory defaults, use the setdefaults command.
See setdefaults.
The host system sets the serial management port variables when it starts up, so these variables are read-only. ALOM CMT uses the serial management port variables to report the serial management (SER MGT) settings on the host server. To view the settings for these variables, use the showsc command. See showsc.
You can view settings for the following serial port variables, but you cannot set or adjust them:
Use the network interface variables to specify the network settings that ALOM CMT uses across its Ethernet connection at the NET MGT port on the host server.
ALOM CMT uses the following network interface variables:
From the ALOM CMT command shell:
To specify values for this variable, use the setupsc command.
See setupsc.
To show the configuration variables and their settings, use the showsc command.
See showsc.
To set a value for a configuration variable, use the setsc command.
See setsc.
To reset all variables to their factory defaults, use the setdefaults command.
See setdefaults.
Use the network management and notification variables to specify how ALOM CMT manages the host system and sends alerts.
ALOM CMT supports the following network management and notification variables:
From the sc> prompt at the ALOM CMT command shell:
To set up these variables, use the setupsc command.
See setupsc.
To view the current settings, use the showsc command.
See showsc.
To change a value for a variable, use the setsc command.
See setsc.
The system user variables enable you to customize the way ALOM CMT identifies and interacts with the host server. When you use the setupsc script to customize ALOM CMT, you can reach these variables by responding y when setupsc prompts you. See setupsc for more information.
From the ALOM CMT command shell:
To specify a value (or values) for a settable variable, use the setupsc command.
See setupsc.
To show the configuration variables and their settings, use the showsc command.
See showsc.
To set a value for a settable variable, use the setsc command.
See setsc.
To reset all variables to their factory defaults, use the setdefaults command.
See setdefaults.
Use the diagnostic control variables to specify how ALOM CMT behaves when it encounters an error on the host server.
ALOM CMT uses the following diagnostic system interface variables:
ALOM CMT Configuration Variables Overview.
This section lists the descriptions of ALOM CMT configuration variables in alphabetical order.
Use this variable to specify the level of diagnostic testing to be executed when diagnostics are enabled.
At the sc> prompt, type the following command:
where value is one of the following values:
To Use the setupsc Command to Change the diag_level Variable |
While running the setupsc command, answer the following questions:
When the setupsc script asks the following questions, type y in reply to the first question to enable you to set the value specified by the second question:
Do you wish to configure the platform diagnostic parameters [y]? y [...] Enter the test coverage level of the system diagnostic [min]? max |
Use this variable to control whether diagnostics are enabled and to specify which diagnostic mode is enabled.
At the sc> prompt, type the following command:
Where value is one of the following:
While running the setupsc command, answer the following questions:
When the setupsc script asks the following questions, type y in reply to the first question to enable you to set the value specified by the second question:
Do you wish to configure the platform diagnostic parameters [y]? y [...] Enter the automatic system diagnostic mode [normal]? normal |
Use this variable to control the conditions under which POST runs if diagnostics are enabled.
To Use the setsc Command to Change the diag_trigger Variable |
At the sc> prompt, type the following command:
Where value is one (or a combination) of the following:
The default value is the combination of power-on-reset error-reset.
To Use the setupsc Command to Change the diag_trigger Variable |
While running the setupsc command, answer the following questions:
When the setupsc script asks the following questions, type y in reply to the first question to enable you to set the value specified by the second question:
Do you wish to configure the platform diagnostic parameters [y]? y [...] Enter the type of reset which will initiate system diagnostic [power-on-reset error-reset]? power-on-reset error-reset |
Use this variable to specify the verbosity level of the output from POST diagnostics, if diagnostics are enabled.
To Use the setsc Command to Change the diag_verbosity Variable |
At the sc> prompt, type the following command:
Where value is one of the following:
To Use the setupsc Command to Change the diag_verbosity Variable |
While running the setupsc command, answer the following questions:
When the setupsc script asks the following questions, type y in reply to the first question to enable you to set the value specified by the second question:
Do you wish to configure the platform diagnostic parameters [y]? y [...] Enter the verbosity level of diagnostic output [normal]? normal |
Use this variable with the setsc command to specify the remote connection type to the SC. if_connection Options
Specifies a Secure Shell connection. Default for secure out-of-the-box configuration. |
|
You can specify if_connection as an option to the showsc command, which shows you the remote connection type that is currently specified.
To Use the setsc Command to Set the if-connection Variable |
At the sc> prompt, type the following command:
where value is none, ssh, or telnet. The default is ssh. See Default DHCP Connection.
You can choose only one of the three options. SSH and Telnet servers will not be enabled at the same time.
Note - After you change a connection type, you must reboot the SC for it to take effect. |
Use this variable to enable email alerts. When this variable is set to true (enabled), you can set values for the ALOM CMT network management and notification variables. See Network Management and Notification Variables. The network management and notification variables, mgt_mailhost and mgt_mailalert, specify how to manage and enable email alerts. See mgt_mailhost, and mgt_mailalert.
Note - The if_network variable must be enabled before you can enable if_emailalerts. Refer to if_network. |
From the ALOM CMT command shell:
To specify a value for this variable, use the setupsc command.
See setupsc.
To set or change the value, use the setsc command.
See setsc.
To view the current value for this variable, use the showsc command.
See showsc.
To Use the setupsc Command to Set the if_emailalerts Variable |
1. At the sc> prompt, type the following command:
The setupsc script prompts you as follows:
2. Type y to configure the interfaces; that is, to set the value to true.
The default value for this variable is true (enabled).
To Use the setsc Command to Change the if_emailalerts Variable |
At the sc> prompt, type the following command:
where value is true to enable email alerts, or false to disable them.
Use this variable to enable the ALOM CMT network interface. When this variable is set to true (enabled), you are able to use the ALOM CMT network interface variables. Refer to Network Interface Variables.
1. At the sc> prompt, type the following command:
The setupsc script prompts you as follows:
2. Type y to configure the interfaces.
The default value for this variable is true (enabled).
At the sc> prompt, type the following command:
where value is true to enable the network interface or false to disable it.
Use this variable to enable the ALOM CMT SNMP interface. When this variable is set to true (enabled), you are able to use the ALOM CMT SNMP interface variables. The network management and notification variables, mgt_snmptraps and mgt_traphost, specify how to manage and enable traps. See mgt_snmptraps, and mgt_traphost.
Note - The if_network variable must be enabled before you can enable if_snmp. Refer to if_network. |
1. At the sc> prompt, type the following command:
The setupsc script prompts you as follows:
2. Type y to configure the interfaces.
The default value for this variable is false (disabled).
At the sc> prompt, type the following command:
where value is true to enable the SNMP interface or false to disable it.
Use this variable to configure email alerts. The procedure for setting up email alerts varies slightly, depending on which method you use. You can specify up to eight email addresses.
To Use the setupsc Command to Set the mgt_mailalert Variable |
1. At the sc> prompt, type the following command:
The setupsc script prompts you as follows:
2. Type the number of email recipients.
The default value, 0, appears in brackets after the prompt.
For each recipient you specify, the script asks the following question, substituting n for the number of the recipient it is currently configuring. For example, if you enter 2 as in the above example, you are prompted to configure email alerts for address 1, and then for address 2.
3. Type the email address of the recipient, as shown in the preceding example.
ALOM CMT accepts email addresses of up to 30 characters. The script then asks:
Enter the level of events to send to recipient <n> where valid settings are 1 (critical), 2 (critical and major) and 3 (critical, major and minor) [2]? |
4. Type the response that corresponds to the levels of alerts you want sent to the recipient.
To Use the setsc Command to Change the mgt_mailalert Variable |
To send an email alert, type the following command at the sc> prompt:
where email is the email address to which you want the alert sent, and level is the level of alerts (critical, major, or minor) you want sent.
To remove a mgt_mailalert entry, specify the values for this variable again, omitting the alert level.
For example, to remove the entry for the previous example, type the following:
Use this variable to specify the Internet Protocol (IP) addresses of one or two mail servers to which ALOM CMT delivers email alerts.
If you are running the setupsc script, setupsc asks the following question:
Enter the number of mail servers to configure [0]? 1 Enter the IP address for mail server 1 [100.100.100.100]? 100.100.100.100 |
Enter the correct number of mail servers and the IP address for each server.
To Use the setsc Command to Change the mgt_mailhost Variable |
At the sc> prompt, type the following command:
where ipaddr1 and ipaddr2 are the IP addresses of the mail hosts you want to specify.
For example, to specify one mail server using setsc, type the following command at the sc> prompt, substituting the IP address of your mail server for xxx.xxx.xxx.xxx:
The default IP address is no address.
Note - You must enter a valid IP address for this command. |
To specify two mail servers, type the following command. Use a single space to separate the IP address of the first mail server from the IP address of the second server.
Use this variable to control the SNMP protocol version used for traps. Values are v1, v2c, or none. The default is none, which is to not send traps..
To Use the setupsc Command to Set the mgt_snmptraps Variable |
If you are running the setupsc script, setupsc asks the following question:
Do you wish to configure the network management interfaces [y]? What SNMP protocol version should be used to send trap notifications: none, v1, or v2c. ('none' will disable SNMP traps) [none]? |
If you choose to configure the network management interfaces, Enter y, then specify the SNMP protocol version that should be used.
To Use the setsc Command to Change the mgt_snmptraps Variable |
At the sc> prompt, type the following command:
where value is the protocol version (v1, v2c, or none) you want to specify.
Use this variable to specify as many as two IP addresses and port numbers of hosts to send SNMP traps to. The default is empty. The format of this variable is dotted decimal notation followed by a colon and portnumber, for example:
If you are running the setupsc script, if the SC SNMP interface has been enabled and an SNMP protocol version of v1 or v2c has been selected, setupsc asks the following question:
Answer 1 or 2 to be promped for the trap host IP address and port number.
Enter the IP address for trap receiver 1 [100.100.100.100]? 123.145.167.189 Enter the port number for trap receiver 1 [162]? 162 |
If you chose to configure trap receivers, specify the IP address and port number that should be used for each trap receiver.
To Use the setsc Command to Change the mgt_traphost Variable |
At the sc> prompt, type the following command:
Where value is the traphost IP address and port number you want to specify. If entering multiple traphosts using setsc, the format should be the following:
The two values are separated by a space, and the format of each is the same. A maximum of two traphosts are allowed.
Use this variable to specify whether you want to use Dynamic Host Configuration Protocol (DHCP) to obtain your network configuration. The available values are true and false. The default value is true.
If you are running the setupsc script, setupsc asks the following question:
Use this variable to display the MAC address for the system controller in the standard six-byte format (for example, 0a:2c:3f:1a:4c:4d). This variable is set at the factory. You cannot set or change this variable.
To view this current value for this variable rom the ALOM CMT command shell, use the showsc command. See showsc.
Use this variable to specify the system controller's IP address.
The default IP address supplied by this variable is 0.0.0.0.
Note - If you are using DHCP to obtain your system controller's network configuration, you do not need to set this variable. If netsc_dhcp is set to true, then the setupsc script does not ask you to set netsc_ipaddr. See netsc_dhcp and setupsc for further information. |
A typical IP address contains four sets of numbers between 0 and 255, separated by decimal points. This is referred to as standard dot notation.
If you are running the setupsc script, setupsc asks the following questions:
Enter the SC IP address [100.100.100.100]? 100.100.100.100 Enter the SC IP netmask [255.255.255.0]? 255.255.255.0 |
If the IP address you specify does not work with the subnet mask and gateway addresses you specify, ALOM CMT returns warning messages. For example:
WARNING: Subnet mask must have all ones for natural network ID. WARNING: The ip_netmask is not compatible with the specified IP address. Choose another ip_netmask to fix this problem. |
Check that all the values you entered are correct. See netsc_ipgateway, and netsc_ipnetmask for more information. If you need help obtaining the correct IP address, ask your network administrator.
Use this variable to specify the IP address for the default IP gateway (also called a router). This gateway enables ALOM CMT to access different subnetworks, other than the one to which it is connected.
The default IP address supplied by this variable is 0.0.0.0.
Note - If you are using DHCP to obtain your system controller's network configuration, you do not need to set this variable. If netsc_dhcp is set to true, then the setupsc script does not ask you to set netsc_ipgateway. See netsc_dhcp and setupsc for further information. |
A typical IP address contains four sets of numbers between 0 and 255, separated by decimal points. This is referred to as standard dot notation.
If you are running the setupsc script, setupsc asks the following question:
If the IP address you specify does not work with the subnet mask and IP addresses you specify, ALOM CMT returns the following error message, substituting the values for netsc_ipnetmask and netsc_ipaddr:
Check that all the values you entered are correct. See netsc_ipgateway and netsc_ipaddr for further information on these commands. If you need help obtaining the correct IP address, ask your network administrator.
Use this variable to specify the system controller's IP netmask.
The default IP address supplied by this variable is 255.255.255.0 (Class C network).
Note - If you are using DHCP to obtain your system controller's network configuration, you do not need to set this variable. If netsc_dhcp is set to true, then the setupsc script does not ask you to set netsc_ipnetmask. See netsc_dhcp and setupsc for further information. |
A typical IP address contains four sets of numbers between 0 and 255, separated by decimal points. This is referred to as standard dot notation.
If you are running the setupsc script, setupsc asks the following question:
If the IP address you specify does not work with the subnet mask and IP addresses you specify, ALOM CMT returns the following error message, substituting the values for netsc_ipnetmask and netsc_ipadddr:
Check that all the values you entered are correct. See netsc_ipgateway and netsc_ipaddr for further information on these command. If you need help obtaining the correct IP address, ask your network administrator.
This variable specifies whether the local user database on ALOM CMT (that is, user, password, and permission information) should be backed up. When this variable is set to true, this data is backed up on the removable system configuration card (SCC PROM) on the system.
The values for this variable are as follows.
To Use the setsc Command to Change the sc_backupuserdata Variable |
At the sc> prompt, type the following command:
For example, if you want the local user database on ALOM CMT to be backed up, type the following command:
Use this variable to specify the level of events that you want ALOM CMT to display in the ALOM CMT shell during an ALOM CMT session. There are four levels of events:
The default value for this variable is 2 (Major).
If you are running the setupsc script, setupsc asks the following question:
Enter level of events to be displayed over the CLI where valid settings are 0 (none), 1 (critical), 2 (critical and major) and 3 (critical, major and minor) [2]? 2 |
Use this variable to change the ALOM CMT shell prompt. The default prompt is sc>.
You can specify any string of characters for the prompt, up to a maximum of 16 characters. The characters permitted in the string are alphanumeric, hyphen, and underscore.
To Use the setsc Command to Change the sc_cliprompt Variable |
At the sc> prompt, type the following command:
where prompt is the desired ALOM CMT command prompt.
For example, if your host name is ernie and your host's ALOM CMT name is ernie-sc, type the following command to specify ernie-sc as your ALOM CMT shell prompt:
In addition, you can set this variable through the setupsc command. See setupsc. The setupsc command prompts you for the following:
To use the default prompt of sc>, press Return.
Use this variable to specify the number of seconds that an ALOM CMT shell session can be idle before an automatic logout occurs. You can specify values from 0 to 10,000 seconds. If you specify a value between 1 and 59 seconds, the variable will automatically be set to the minimum value of 60 seconds. The default value is
0 seconds (timeout disabled). If you specify a value that has more than five digits in it, the timeout will be set to 0.
Note - If the ALOM CMT session is in console mode, automatic logout will not occur, even when this variable is set. Refer to console. |
For example, to set the automatic logout interval to 60 seconds, type the following command at the ALOM CMT shell prompt:
You can specify a value for the timeout using the setupsc command. Refer to setupsc. The setupsc script prompts you to enter a value as follows:
Use this variable to turn password echo on and off. When password echo is on, each character that a user types when logging in to ALOM CMT is echoed to the screen with an asterisk (*). Note that the actual password is never echoed to the screen.
The default value for this variable is y (echo asterisks to screen).
For example, to change the value of this variable to n (no echo) type the following command at the ALOM CMT shell prompt:
You can specify a value for this variable using the setupsc command. The setupsc script prompts you to enter a value as follows:
Use this variable to store information about the host server, or any other information you want to enter that identifies the host server to ALOM CMT. This information is included in any email alerts.
If you answer y when the setupsc utility asks Do you wish to configure the SC parameters [y]?, then the setupsc utility returns the following prompt:
Enter any customer data for this platform (maximum of 40 characters) []? This is the test lab server. |
See setupsc for more information about this command.
Use the escape character sequence to switch from a system console session back to ALOM CMT. The sequence is limited to two characters. The second character is always . (Period). The default value is #. (Hash-Period). The sequence can be customized.
You can specify a value for this variable using the setupsc command. The setupsc script prompts you to enter a value as follows:
See setupsc for more information about that command.
Use this variable to cause the server to wait for a short time before powering on automatically. The delay is a random interval of one to five seconds. Delaying the server power-on helps minimize current surges on the main power source. This is important when multiple servers in racks power on after a power outage.
This variable takes effect only if sc_powerstatememory is set to true.
You can set the power-on delay using the setupsc command if you have already answered yes to the setupsc command's sc_powerstatememory question (see sc_powerstatememory). When the setupsc script asks the following question, type y to enable the delay or n to disable it:
See setupsc for more information about that command.
From the ALOM CMT command shell the values for this variable are true and false.
ALOM CMT runs as soon as power is applied to the host server, even if the server is powered off. When you first apply power to the host server, ALOM CMT starts to run, but the server does not start up until you power it on.
The sc_powerstatememory variable enables you to specify the state of the host server as false (keep the host server off) or true (return the server to the state it was in when the power was removed). This is useful in the event of a power failure, or if you physically move the server to a different location.
For example, if the host server is running when power is lost and the sc_powerstatememory variable is set to false, the host server remains off when power is restored. If the sc_powerstatememory variable is set to true, the host server restarts when the power is restored.
The values for this variable are as follows.
When the setupsc script asks the following question, type y to enable the state or n to disable it:
If you answer yes to this question, the setupsc script prompts you to configure sc_powerondelay as well (see sc_powerondelay).
This variable sets the serial management port (SER MGT) baud rate. Its value is preset and cannot be changed.
To view the current setting for this variable, use the showsc command.
See showsc for more information about this command.
This variable sets the number of serial management port (SER MGT) data bits. Its value is preset and cannot be changed.
To view the current value for this variable, use the showsc command.
See showsc for more information about this command.
This variable sets the serial management port (SER MGT) parity. Its value is preset and cannot be changed.
To view the current setting for this variable, use the showsc command.
See showsc for more information about this command.
This variable sets the number of serial management port (SER MGT) stop bits. Its value is preset and cannot be changed.
To view the current setting for this variable, use the showsc command.
See showsc for more information about this command.
Use this variable to specify how ALOM should handle expiration of the Solaris watchdog timer. The valid values are none, reset, and dumpcore (default value: reset).
When the setupsc script asks the following questions, type y in reply to the first question to then set the value specified by the second question.
Note - The default option (reset) supports the Solaris watchdog timer. |
Use this variable to specify whether the host should continue to boot after system diagnostics have discovered an error. The default value is false.
When the setupsc script asks the following questions, type y in reply to the first question to then set the value specified by the second question, to which you can reply y to enable the continued boot or n to disable it:
Do you wish to configure the platform diagnostic parameters [y]? y [...] Should the host continue to boot after error is encountered [n]? |
To view the current setting for this variable, use the showsc command.
See showsc for more information about this command.
Use this variable to specify the level of ALOM events that you want ALOM to send to the host server. There are four levels of events:
The default value for this variable is 2 (Major).
To view the current setting for this variable, use the showsc command.
See showsc for more information about this command.
This variable is automatically configured by the system software, so you cannot set it or change it. The value is read and determined from the server's MAC address and then stored as a variable in ALOM CMT.
sys_enetaddr is the MAC address for the net0 port. The MAC addresses for each additional port increments from the sys_enetaddr. For example, net1 is sys_enetaddr+1.
To view the current setting for this variable, use the showsc command.
See showsc for more information about this command.
Copyright © 2007, Sun Microsystems, Inc. All Rights Reserved.