1

SAM & OLAR

2

Upon completion of this module, you will be able to:• List significant changes to system administration

tasks in HP-UX 11i• Determine system readiness for OLA/R activity• Interpret the results of a Critical Resource Analysis• Replace or add a PCI I/O card using SAM and rad

Module Objectives

4

• System Administration Overview• Online Addition and Replacement (OLA/R)• New SAM Features

Module Agenda

6

SuperDome Partitions:Administration

161

HP-UX 11i

HP-UX 11x

HP-UX 11i

HP-UX 11i

8

Online Addition and Replacement (OLA/R)

• Introduction to OLA/R for PCI I/O Cards• SAM OLA/R Procedure for PCI I/O Cards• Preparing for OLA/R• Online Replacement• Online Addition• Advanced Considerations

10

System Administration Manager (SAM)

12

New In SAM

• Access SAM thru Guardian Service Processor (GSP)– Local Console Port– Remote Session Port– Local Session Port– Internal Console Port– USB Port

14

Changes to SAM

HP-UX 11i supports new devices and features in the following SAM functional areas:• Disks & File Systems• Kernel Configuration• Network File Systems & Interface Cards• Peripheral Devices• Printers & Plotters• Terminals & Modems• Partition Manager

16

Disk & File System Additions

• HP SureStore Disk Arrays

– FC60

– XP 256• Support of VERITAS Volume Manager (VxVM)

– Recognition of disks being used by VxVM– Recognition of disk groups and volumes– Launching of Veritas Manager Storage Administrator (VMSA)

18

Kernel Configuration Additions

• Support for dynamic tunables

– Immediate results (no reboot required) if changing the value of a dynamic tunable or a tunable set which contains ONLY dynamic tunables

20

Network File System Additions

• Export a file system using TCP/IP (in addition to UDP).

22

Network Interface Cards Additions

• Configure, modify, and unconfigure– Gigabit Ethernet:

(1000Base-T and 1000Base-SX)– 100Base-T cards– Independent Hardware Vendor:

cards manufactured by third party vendors that conform to the exported SAM Networking interface

24

Peripheral Devices Enhancements

• On-line Addition and Replacement (OLA/R) PCI I/O card support– Systems must have OLA/R-capable hardware– SD-Class (SuperDome), N-Class, and L-Class

platforms• Hierarchical layout

– Displays devices controlled by a particular card• Added Analyze Critical Resource

26

Peripheral Devices (cont.)

• Recognition and configuration support for DLT device tape densities– DLT_42500_24 – DLT_42500_56– DLT_62500_64– DLT_81633_64

• PCI multiplexer• HP SureStore disk arrays

– Described under Disks and File Systems Enhancements

28

Printers and Plotters Enhancements

• Recognition of Super I/O Parallel Interface and configuration of printers using this interface

• Updated software products that configure a network printer which contains a JetDirect interface card

– Removed obsolete JetDirect printer configuration SW

– Added support for new printer configuration software, HP JetDirect Printer Installer

– HP JetAdmin still supported, too

30

Terminals and Modems Enhancements

• PCI multiplexer cards• Modem support for hardware flow control

32

SAM: Last Call

• Last release for the following areas:– (HP-IB) Instruments sub-area under Peripheral Devices– Run SAM on Remote Systems– Process Control sub-area under Process Management– Routine Tasks– Performance Monitors

• Disk and Terminal Activity• Inter-Process Communication Facility Status• Process with the Highest CPU Usage• System Activity• Virtual Memory Activity

34

Documentation Changes

• SAM manpage sam(1M)• On-line help

36

Module Summary

• SAM enhancements in HP-UX 11i• List of areas for future obsolescence• References

38

Planning for OLA/R

• Slot Compatibility• Driver Compatibility• System Impact• Preparatory Actions

40

OLA/R Infrastructure

SAM rad

libolar.sl

User Space

Kernel

OLA/R DriverSecurity

OLA/R PSM

PCI CDIO Firmware

Device Driver

PCI Card

Slots

/dev/olar

SCSI

42

Interfaces to OLAR

• System Administration Manager, SAM

– Graphical user interface (GUI)– The primary interface

• rad– Command line interface– Developed for single-user mode when SAM not yet available– Not generally recommended

44

Planning and Preparation Issues

• Slot compatibility• Driver compatibility• Impact on the system

– To the OS– To SAM– To other applications

46

Considerations for Critical Resources

• Critical resource: a resource that, if lost, would cause the system to crash, or the OLA/R operation to fail

• Examples:– Swap partition– /, /usr, /etc, and /var filesystems– Network card carrying connection for SAM displayed on a

remote machine

48

Considerations for Power Domains

• Does not affect SuperDome

Every slot is an individual power domain

Other Systems• Power domain:

A grouping of 2 or more interface card slots that are powered on or off as a unit.

• In many cases, there exist dependencies between other interface cards, slots, and power domains within the system.

50

Considerations for Multi-Function I/O Cards

• All functions on the same power source• Must suspend all functions to remove the card• Must resume all functions to bring the card back• Must account for multiple affected cards in the critical

resource analysis

52

Failover

• Failover means that the system will use an alternate resource if the primary resource is unavailable

• Critical resource analysis will prevent suspension of resources that do not have an alternate

• The system may operate with a single point of failure for a short time

54

Online Card Replacement

• Replacement card must be identical type of card• Must use same driver• Must have same number of functions or ports• Must have compatible power and frequency requirements• Single point of failure may result when card is suspended and

its backup takes over

56

Card Replacement with SAM

• Start SAM• Select Peripheral Devices--> Cards• From the Sys Admin view of active I/O adapters, choose the

adapter to be replaced• Select PCI slot, then Replace action

– SAM analyzes critical resources• Physically remove old card and insert new card• SAM finishes replacement by restarting card

58

Online Replacement with SAMSteps 1 and 2

# sam

60

Online Replacement with SAMStep 3

62

Online Replacement with SAMSteps 4, 5, and 6

64

Online Replacement with SAMStep 7

66

Online Replacement with SAMSteps 8, 9, 10, 11, and 12

68

Online Replacement with SAMSteps 13 - 17

70

Overview of Online Replacement with rad

• Determine slot, path and drivers capable fields• Set the selected cards attention state to flash• Critical Resource Analysis (manually)

– Power Domain– Multi-function card– Driver time-out value for card

• Execute /etc/olard.d scripts for the selected card• Power off slot• Replace the card• Power on slot• Run /etc/oldard.d/post_replace scripts• Run ioscan and rad to verify correct function of card• Turn the selected card’s attention LED off

72

Online Replacement with /sbin/rad Step 1

74

Online Replacement with /sbin/rad Step 2

# rad -q

76

Online Replacement with /sbin/radSteps 3 – 6

3. Turn the LED to attention– # rad -f <slot id>

4. Check for other slots in the power domain that are affected by this card– # rad -a <slot id>

5. Check to see if the target card is a Multifunction card– # rad -h <slot id>

6. Determine the time-out value of the driver– # rad -V <hw_path>

78

Online Replacement with /sbin/radSteps 7 – 9

7. Execute any OLA/R script for this card– # sh /usr/sbin/olrad.d/drivername prep_replace

hw_path

8. Suspend the drivers– # rad -s <slot id>

9. Turn off the power to the target slot– # rad -o <slot id>

80

Online Replacement with /sbin/rad Step 10

82

Online Replacement with /sbin/radSteps 11 – 15

11. Turn on power to slot– # rad -i <slot id>

12. Run post_replace script– # sh /usr/sbin/olard.d/drivername post_replace

hw_patch13. Restart drivers for target and affected cards

– # rad -r <slot id>14. Verify that the new card functions properly

– # ioscan– # rad -q – # rad -c <slot id>

15. Turn card slot’s attention LED off– # rad -f off <slot id>

84

Online Addition with SAM

• Check that the driver exists in the kernel• Check that an available slot exists on the system in

an appropriate location• Check that the new card is compatible

86

Online Addition with/sbin/rad

• Check that the driver exists in the kernel• Check that an available slot exists on the system in

an appropriate location• Check that the new card is compatible

88

Possible Errors

• The card is in a slot that is not managed by the correct partition

• The driver is not loaded in the kernel• The power domain is shared with a critical resource

90

parmgr Thru SAM

92

Module Summary

The purpose of this module was to:• Changes to SAM in HP-UX 11i • OLA/R with SAM and rad