ServerConductor/Blade Server Manager Description and Reference

### 3.6.1 Using the environment setting command

The command start format is as follows:

    /usr/sbin/smhedit [-slevel-count] [-g[width][xheight]] [-agent|-misc]
    /usr/sbin/smhedit -h

The following describes the start options:

-s level-count
  Specifies the number of menu levels to be displayed. When this option is omitted, the number of menu levels is determined by the window size. The permitted values are 1 and 2.

-g[width][x height]
  Specifies the window size in characters. The permitted value for the width (-g) is from 10 to 160 and for the height (x) is from 10 to 72. The default is -g80x24.

-agent, -misc
  Specifies which environment settings menu to be displayed.
  To edit agent settings, specify -agent, in which case the agent settings menu is displayed.
  To edit agent environment settings, specify -misc, in which case the agent environment settings menu is displayed.
  If neither option is specified, the main menu is displayed, enabling the user to select one of the settings.
  These two options are mutually exclusive.

-h
  Displays information about how to use the environment setting command.

Organization of this subsection
  (1) Selections for menus
  (2) Main menu
  (3) Agent settings menu and agent environment settings menu

#### (1) Selections for menus

Selections for menus include numeric values (1 to n) and character strings. At the menu prompt, the permitted value range or character strings are displayed. For character string selections, you can select upper case or lower case. You can also select only the upper-case letters in the displayed character string. The following shows an example:

       Quit

This selection can be entered as any of the following: QUIT, quit, Q, or q.

#### (2) Main menu

When the smhedit command is started with neither the -agent nor the -misc option specified, the following main menu is displayed:

       #### Configuration Main Menu ####
        1.Agent Configuration
        2.Agent Environment Configuration

       Command(1-2/Quit)>

The three permissible selections are 1, 2, and Quit.

When 1 is selected, the agent settings menu is displayed for editing the agent settings.

When 2 is selected, the agent environment settings menu is displayed for editing the agent environment settings.

When Quit is selected, the smhedit command is terminated.

#### (3) Agent settings menu and agent environment settings menu

The agent settings menu is displayed when the smhedit is started with the -agent option specified or when 1 is selected from the main menu.

The following shows an example of the agent settings menu:

       #### Agent Configuration ####
        1.CommandTimeout     [90]
        2.Keepalive   [False]
       .............omitted.............

       Command(1-11/Menu/Quit)>

The agent environment settings menu is displayed when the smhedit is started with the -misc option specified or when 2 is selected from the main menu.

The following shows an example of the agent environment settings menu:

       #### Agent Environment Configuration  ####
        1.ManagerAddress ->      18.AdministratorID    [KANRI-ID]
        2.SendTimeout    [80]    19. AdministratorInfo [KANRISH...]
       .............omitted.............

       Command(1-23/Menu/Quit)>

Permissible selections include item setting numbers, Menu, and Quit. The number of items that can be set depends on the agent service and OS version.

When Menu is chosen, the agent settings menu or agent environment settings menu is displayed.

When Quit is chosen, the main menu is displayed again or the smhedit command is terminated. If you have changed the value of a setting item and then you choose Quit, the command asks whether the new value is to be applied.

When you choose the number of a setting item, the command enables the corresponding item to be set. The four types of setting entries are integers, logical values, IP addresses, and character strings. The following rules apply to these types of entries:

Integer
  The entered value is regarded as being in octal if it begins with 0 and in hexadecimal if it begins with 0x. If only a linefeed is entered, the setting remains unchanged.

Logical value
  The value must be either True or False. A value must be set for such an item. The entered value is not case sensitive. If only a linefeed is entered, the setting remains unchanged.

IP address
  The value must be entered in decimal in the format xxx.yyy.zzz.aaa. If only a linefeed is entered, the setting remains unchanged.

Character string
  An entered character string cannot contain a double quotation mark ("). If only a linefeed is entered, the setting remains unchanged. If only the Ctrl + D keys are pressed, the null character string is set.

Site information
  Site information cannot contain a double quotation mark (") or a slash (/). You can define a maximum of eight classes of site information and enter a value for each class. To skip all subsequent classes, press the Ctrl + D keys. If only a linefeed is entered, the existing setting is used as is. If there is no existing value for a class, entering the linefeed terminates the entry for that class.

Target machine information
  In the case of target machine information, the command displays a list of the available target machines, the currently selected target machine, and a prompt. The list of target machines consists of 20 machines per window.
  At the prompt, enter a numeric value (1 to n) or a character string. Available character string selections are Previous, Next, and Quit. To select the target machine, select the corresponding number from the list.
  To display the previous window, choose Previous. To display the next window, choose Next. Note that when the beginning of the list is displayed, Previous cannot be chosen. Similarly, when the end of the list is displayed, Next cannot be chosen. When Quit is chosen, the command displays the settings menu again without changing the settings.

Multiple settings
  For some items, you can set multiple values. When you select an item that accepts multiple values, the command displays a list of the existing values and a prompt. To change an existing value, select it from the list. To delete an existing value, select it from the list, and then press the Ctrl + D keys only. To add a value, choose New. If the number of existing values has already reached the maximum, New cannot be chosen. Choosing Quit displays the settings menu again.

All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.