ITEM: AZ2465L

NeedsAppvl: Sharing modem between Service Director and System Guard


ENV:  RS/6000 SMP machine (G30/40, J30/40 and R30/40), Service Director
      version 2.1.
.DESC:  What is the difference between Service Director and SystemGuard?
       Can both of them use the same modem?  How is the modem set up
       so Service Director and System Guard can both use it?
.ACTION:  Put very simply, Service Director is an application that runs
         on top of AIX that monitors the AIX error log for hardware 
         failures, and calls IBM when they are detected.
.         The SMP's SystemGuard function is a service processor; a combi-
         nation of hardware and firmware that test and monitor the basic
         hardware of the computer, e.g., the processor, the memory, and
         the system buses.
.         SystemGuard is in control of the SMP system from the time power
         is applied to the system until AIX is booted (299 on the LED),
         at which time control is handed over to the operating system.
.         Service Director monitors the system while AIX is active; 
         SystemGuard monitors the system when AIX is not running, 
         whether because the machine has crashed, is not booting, or
         is simply powered off.
.ACTION:  There are instructions for setting up Service Director in the
         User's Guide, which is included with the Service Director
         software as UG.ASCII or UG.PS (ASCII and PostScript versions).
.         We also have a fax, "Service Director Registration Return Code
         101", which details how to set up the modem configuration in
         Service Director.
.         There are two functions of the SystemGuard Service Processor
         with regard to modems:  dialing out when the system fails to
         boot in Normal mode, and allowing a remote service center to
         dial in to the system.
.         The prerequisites for the dial-out feature are:
          > Remote Service Support flag enabled (=1).
          > Valid Service Contract 0 to 32767 days
          > Remote authorization enabled (=1).
          > Dial-out authorization enabled (=1).
         The dial-out feature uses the dial-out phone numbers listed in
         SystemGuard configuration.  To add or change phone numbers, do
         the following:
          1. Enter the SystemGuard Maintenance Menu
          2. Enter 8 from this menu to select the Set Parameters menu.
          3. Enter 3 from the Set Parameters menu to select the Phone
             Numbers menu.
          4. Select your option, and enter the dial-out number or
             numbers.  There are two service center and customer hub
             numbers.  These relate to primary (1) and secondary (2)
             numbers.
.         You can set up dial-in to the system by enabling console 
         mirroring through SystemGuard:
.   Console mirroring and dial-in support are available during the System
Guard Stand-By, Init and Run-Time phases.  When mirroring is active, the
Service Console (S2 line) and the BUMP Console (S1 line) are logically
identical.  If AIX is running, both are tty0 (tty1 is disabled when
mirroring starts).  The Remote Console connection must be established 
by dial-in when mirroring is active; the BUMP will not dial out.
.   To enable console mirroring during the Standby and Init phases, the
following conditions must be met:
   1) The Remote Authorization and Dial-Out Authorization flags must be
      enabled.  These flags can be set through the 'Set Flags' option in
      the Stand-By Menu, or in AIX by entering mpcfg -cf 1 1 as the root
      user.  The Remote Authorization flag can also be enabled with the
      'Enable Service Console' option in the Maintenance Menu.
   2) Remote Service Support must be enabled and the Service Contract
      Validity flag must be greater than or equal to 0.  These flags
      can be verified through AIX using the command mpcfg -dS as the
      root user.
   3) The Service Line Speed must be set correctly.  This can be set
      through the 'Miscellaneous Parameters' option in the Maintenance
      Menu, or with the command mpcfg -dm 2 \.  The baud rate
      chosen for the Service Line Speed should match the rates set in
      the AIX tty1 definition, the Service Director 6000 forwarding host
      configuration, and in the AIX file /etc/uucp/Devices.
   4) Phone numbers must be set correctly.  The phone numbers that must
      be set are the Service Center Dial-Out (1), System Dial-In and the
      System Operator Voice numbers.  The Service Center Dial-Out number
      is the same number that is used for Service Director (1-800-830-
      1041).  These can be set using the 'Set Parameters' and 'Phone 
      Numbers' options in the Maintenance Menu, or by using the command
      mpcfg -dp to display the indexes for the phone numbers and then
      mpcfg -cp \ \ to set the values for the phone number
      fields.  These commands must be issued by a root user.  
.   Enabling console mirroring for the Run-Time phase is more involved,
since AIX is active.  In addition to the above conditions, the following
additional conditions must be met:
   5) The Software Error Logging Facility and Dump Service Aids packages
      must be installed.
   6) tty0 and tty1 should be defined according to the tables below.
   7) The Modem Parameters Filename option must be set to /usr/share/
      modems/mir_modem.  This can be set through the 'Miscellaneous
      Parameters' option in the Maintenance Menu, or in AIX by entering
      mpcfg -cm 1 /usr/share/modems/mir_modem as the root user.
   8) The /usr/share/modems/mir_modem must exist, and be formatted in
      the manner shown below.
      NOTE: /usr/share/modems/mir_modem CANNOT be used as the Service
            Director 6000 modem file
.   In order to start console mirroring, the System Key must be set to
Service (Physical Key in Service, or Physical Key in Normal and Electro-
nic Key in Service).  You will see this message:
   mirrord: Wait connection
When remote support dials in, you will see this message:
   mirrord: Remote user connected, mirroring active
Mirroring will stop when the System Key is set to Normal.  You will see
this message:
   mirrord: mirroring is stopped.
.TTY0 CONFIGURATION FOR THE S1 PORT:
-----------------------------------
[TOP]                                         [Entry Fields]
  TTY                                          tty0
  TTY type                                     tty
  TTY interface                                rs232
  Description                                  Asynchronous Terminal
  Status                                       Available
  Location                                     00-00-S1-00
  Parent Adapter                               sa0
  PORT number                                 [s1]
  Enable LOGIN                                 disable
  BAUD rate                                   [9600]
  PARITY                                      [none]
  BITS per character                          [8]
  Number of STOP BITS                         [1]
  TIME before advancing to next port setting  [0]
  TERMINAL type                               [dumb]
  FLOW CONTROL to be used                     [xon]
  OPEN DISCIPLINE to be used                  [dtropen]
  STTY attributes for RUN time                [hupcl,cread,brkint,icrnl,
                                               opost,tab3,onlcr,isig,
                                               icanon,echo,echoe,echok,
                                               echoctl,echoke,imaxbel,
                                               iexten]
  STTY attributes for LOGIN                   [hupcl,cread,echoe,cs8,
                                               ixon,ixoff]
  LOGGER name                                 []
  STATUS of device at BOOT time               [available]
  TRANSMIT buffer count                       [16]
  RECEIVE trigger level                       [3]
  STREAMS modules to be pushed at OPEN time   [ldterm,tioc]
  INPUT map file                              [none]
  OUTPUT map file                             [none]
  CODESET map file                            [sbcs]
.TTY1 CONFIGURATION FOR THE S2 PORT:
-----------------------------------
[TOP]                                         [Entry Fields]
  TTY                                          tty1
  TTY type                                     tty
  TTY interface                                rs232
  Description                                  Asynchronous Terminal
  Status                                       Available
  Location                                     00-00-S2-00
  Parent adapter                               sa1
  PORT number                                 [s2]
  Enable LOGIN                                 disable
  BAUD rate                                   [9600]
  PARITY                                      [none]
  BITS per character                          [8]
  Number of STOP BITS                         [1]
  TIME before advancing to next port setting  [0]
  TERMINAL type                               [dumb]
  FLOW CONTROL to be used                     [rts]
  OPEN DISCIPLINE to be used                  [dtropen]
  STTY attributes for RUN time                [hupcl,cread,brkint,icrnl,
                                               opost,tab3,onlcr,isig,
                                               icanon,echo,echoe,echok,
                                               echoctl,echoke,imaxbel,
                                               iexten]
  STTY attributes for LOGIN                   [hupcl,cread,echoe,cs8,
                                               ixon,ixoff]
  LOGGER name                                 []
  STATUS of device at BOOT time               [available]
  TRANSMIT buffer count                       [16]
  RECEIVE trigger level                       [3]
  STREAMS modules to be pushed at OPEN time   [ldterm,tioc]
  INPUT map file                              [none]
  OUTPUT map file                             [none]
  CODESET map file                            [sbcs]
./ETC/UUCP/DEVICES ENTRY:
------------------------
Direct tty1 - 9600 direct
./USR/SHARE/MODEMS/MIR_MODEM FORMAT:
-----------------------------------
> \# This is a modified version of /usr/share/modems/mir_modem.7851 shipped
> \# with AIX 4.1.4 
> \# COMPONENT_NAME: (CMDMIRROR) Console Mirroring
> \#
> \# FUNCTIONS: modem configuration file for the IBM 7851 modem
> \#
> \# ORIGINS: 27
> \#
> \# (C) COPYRIGHT International Business Machines Corp. 1995
> \# All Rights Reserved
> \# Licensed Materials - Property of IBM
> \#
> \# US Government Users Restricted Rights - Use, duplication or
> \# disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
> \#
> 
> \# Configuration file for IBM 7851-002 modem running at 9600bps.
> 
> ICDelay 5
> DefaultTO 10
> CallDelay 120
> \#  AT  Attention Code           Q0    Enable result codes to screen
> \# &F1  Set factory profile 1    Q1    Disable result codes to screen 
> \#  E0  Turn echo off            S0=0  Automatic answer inhibit
> \#  V0  Use numeric responses    S0=2  Answer on second ring  
> \# +++  Escape to command mode  &W0    Save configuration to profile 0
> \#  H0  Hang-up 
> \# 17=38.4bps; 16=19.2bps; 12=9600bps; 11=4800bps; 10=2400bps; 7=busy
> condout:    send "AT&F1\\r"
>             expect "0\\r" or "OK\\r"
>             send "ATE0V0Q0"
>             expect "0\\r" or "OK\\r"
>             send "ATS0=0\\r"
>             expect "0\\r" or "OK\\r"
>             done
> 
> connect:    send "ATDT%N\\r"  \# Tone dialing command
>  expect "17\\r" or "16\\r" or "12\\r" or "11\\r" or "10\\r" busy "7\\r"
>  timeout 60
>             done
> 
> retry:      send "A/"        \# Redo command
>  expect "17\\r" or "16\\r" or "12\\r" or "11\\r" or "10\\r" busy "7\\r"
>  timeout 60
>             done
> 
> disconnect: delay 2
>             send "+++" 
>             delay 2 
>             send "ATH0\\r"
>             ignore "0\\r" or "OK\\r"
>             send "ATE0Q1V0\\r"
>             delay 2
>             done
> 
> condin:           send "AT&F1\\r"
>             ignore "0\\r" or "OK\\r"
>             send "ATE0V0Q0\\r"
>             expect "0\\r" or "OK\\r\\n"
>             send "ATS0=2\\r"
>             expect "0\\r" or "OK\\r\\n"
>             send "ATQ1&W0\\r"    \# (there can be no reply)
>             done
> 
> condwait:   send "AT&F1\\r"
>             expect "0\\r" or "OK\\r"
>             send "ATV0E0Q0\\r"
>             expect "0\\r" or "OK\\r"
>             send "ATS0=2&W0\\r"
>             expect "0\\r" or "OK\\r\\n"
>             done
> 
> waitcall:   ignore "2\\r" timeout none
>             expect "2\\r" timeout 10
>  expect "17\\r" or "16\\r" or "12\\r" or "11\\r" or "10\\r" busy "7\\r"
>  timeout 60
>             done
> 
> page:       send "ATDT%N;\\r"  \# ; = go back to command mode
>             expect "0\\r" or "OK\\r\\n" timeout 60
>             delay 2
>             send "ATH0\\r"
>             expect "0\\r" or "OK\\r\\n"
>             done
.SERVICE DIRECTOR/6000 FORWARDING HOST CONFIGURATION:
----------------------------------------------------
\<\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^>
\< BUILD LIST OF MACHINES FOR REGISTRATION                     (BUILD2) >
\<                                                                      >
\< 1. uname -m                           xxxxyyyyzzzz                   >
\< 2. Type:                              70xx                           >
\< 3. Serial:                            0012345                        >
\<                                       *** don't use leading '26' *** 
\ 4. Hostname:                          GUMBY                          
\ 5. Is this a Reporting Server? (y/n): y                              
\                                       *** This field should always  *
\                                       * be set to yes if you want   *
\                                       * this machine's errors to be *>
\<                                       * reported to IBM.          ***>
\<                                                                      >
\< 6 through 14. Contact Data                                           >
\<                                                                      >
\< o. CHANGE configuration data, for this machine                       >
\< s. SAVE this machine's data, move to next machine                    
\ c. CANCEL this entry, do not save it, return to calling menu         
\                                                                      
\ Please enter menu selection: o                                       
\______________________________________________________________________
.\\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^
\ BUILD LIST OF MACHINES FOR REGISTRATION                     (BUILD3) 
\                                                                      
\ For Machine with Type: 70xx Serial: xxxxyyyyzzzz Hostname: GUMBY     
\                                                                      
\ 1.  Host reports problems? (N/Y)    Y                                
\ 2.  Host forwards problems? (N/Y)   Y                                
\ 3.  Comm. method (RPC or TTY)       TTY                              
\ 4.  File containing RPC target:     /usr/lib/ras/callhomehost        
\ 5.  TTY device:                     tty1 *** name of modem device ***
\                                                                      
\ Fields 6 through 12 are not implemented at this time and may be left 
\ blank                                                                
\                                                                      
\ d. SCROLL DOWN, for other values                                     
\ s. SAVE these values (may replace default configuration, too)        
\ c. CANCEL, discard any changed values                                
\ h. SHOW explanations for data fields (uses pg command)               
\                                                                      
\ Please enter menu selection: d                                       
\______________________________________________________________________
.\\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^
\ BUILD LIST OF MACHINES FOR REGISTRATION                     (BUILD4) 
\                                                                      
\ For Machine with Type: 70xx Serial: xxxxyyyyzzzz Hostname: GUMBY     
\                                                                      
\ 13. File containing RPC clients:    /usr/lib/ras/probrephosts        
\ 14. Modem file name:            /usr/lpp/servdir/modem.setup.hayes288
\     *** use the absolute pathname for the modem file name ***        
\ 15. Remote latency delay:           0                                
\ 16. Remote timeout:                 300                              
\ 17. Retry count:                    2                                
\ 18. Response timeout:               600                              
\ 19. TTY retry timeout:              86400                            
\ 20. BAUD rate:                      9600  *** same value as SMIT  ***
\                                           *** tty definition and  ***
\                                           *** uucp devices direct ***
\                                           *** line baud rate!     ***
\ 21. Dial out phone number:          9-1-800-830-1041                 
\                                     *** Use dashes, not commas.   ***
\ 22. Phone number to call back to:   000-000-0000                     
\ 23. Local operator voice phone:     000-000-0000                     
\ 24. Hub phone:                                                       
\ 25. Duplicate problem timeout:      86400                            
\ 26. Dial tone, P(ulse), T(one):     T                                       
\                                                                      
\ u. SCROLL UP, for other values                                       
\ s. SAVE these values (may replace default configuration, too)        
\ c. CANCEL, discard any changed values                                
\ h. SHOW explanations for data fields (uses pg command)               
\                                                                      
\ Please enter menu selection:  s                                      
\______________________________________________________________________
.      This goes to another screen that asks if you want to override the
      default configuration data.  The default configuration data is
      used for other clients in the configuration.  The only time that 
      you would want to say Yes to this option would be if you had other
      machines in the Service Director configuration that would be using
      the same data in these fields.
.      No, do not override default configuration.
.\\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^
\ BUILD LIST OF MACHINES FOR REGISTRATION                     (BUILD2) 
\                                                                      
\ 1. uname -m:                        xxxxyyyyzzzz                     
\ 2. Type:                            70xx                             
\ 3. Serial:                          0012345                          
\ 4. Hostname:                        GUMBY                            
\ 5. Is this a Reporting Server? (y/n): y                              
\ 6. through 14. (Customer Contact Information)                        
\                                                                      
\ o. CHANGE configuration data, for this machine                       
\ s. SAVE this machine's data, move to next machine                    >
\< c. CANCEL this entry, do not save it, return to calling menu         >
\<                                                                      >
\< Please enter menu selection: s                                       >
\<______________________________________________________________________>
.       **************************************************************
       * PLEASE NOTE THAT THE 'SAVE' OPTION HAS TO BE CHOSEN TWICE! *
       **************************************************************
.
         Informed customer that the most difficult part of setting 
         this up for both Service Director and SystemGuard would be
         the configuration files for the modems.  Service Director
         and SystemGuard will require different modem files, and I
         highly recommend creating a modem file for Service Director,
         even if the default initialization string has worked for this
         modem in the past.
.NEXT:  Call documented for Library
.TEST:  None required.


Support Line: NeedsAppvl: Sharing modem between Service Director and System Guard ITEM: AZ2465L
Dated: October 1998 Category: N/A
This HTML file was generated 99/06/24~13:30:24
Comments or suggestions? Contact us