IBM AIX Continuous Availability Features - IBM Redbooks

More documents

Recommendations

Info

A Vue script or Vue program is a program written in Vue. You can use a Vue script to: ► Identify the probe points where a probe is to be dynamically enabled. ► Identify the conditions, if any, which must be satisfied for the actions to be executed when a probe fires. ► Identify the actions to be executed, including what trace data to capture. ► Associate the same set of actions for multiple probe points. In short, a Vue script tells ProbeVue where to trace, when to trace, and what to trace. It is recommended that Vue scripts have a file suffix of .e to distinguish them from other file types, although this is not a requirement. 3.8.3 The probevue command The probevue command is used to start a dynamic tracing session or a ProbeVue session. The probevue command takes a Vue script as input, reading from a file or from the command line, and activates a ProbeVue session. Any trace data that is captured by the ProbeVue session can be printed to the terminal or saved to a user-specified file as per options passed in the command line. The ProbeVue session stays active until a is typed on the terminal or an exit action is executed from within the Vue script. Each invocation of the probevue command activates a separate dynamic tracing session. Multiple tracing sessions may be active at one time, but each session presents only the trace data that is captured in that session. Running the probevue command is considered a privileged operation, and privileges are required for non-root users who wish to initiate a dynamic tracing session. For a detailed description of the probevue command, refer to AIX Version 6.1 Commands Reference, Volume 4, SC23-5246. 3.8.4 The probevctrl command 3.8.5 Vue overview The probevctrl command changes and displays the ProbeVue dynamic tracing parameters, the per-processor trace buffer size, the consumed pinned memory, the user owning the session, the identifier of the process that started the session, and the information on whether the session has kernel probes for the ProbeVue sessions. For a detailed description of the probevctrl command, refer to AIX Version 6.1 Commands Reference, Volume 4, SC23-5246. Vue is both a programming and a script language. It is not an extension of C language, nor a simple mix of C and awk. It has been specifically designed as a dedicated dynamic tracing language. Vue supports a subset of C and scripting syntax that is most beneficial for dynamic tracing purposes. This section describes the structure of a Vue script. 114 IBM AIX Continuous Availability Features
Structure of a Vue script A Vue script consists of one or more clauses. The clauses in a Vue script can be specified in any order. Figure 3-3 is a typical layout of a Vue script. Figure 3-3 Structure of a Vue script Following are two Vue script examples. ► This canonical “Hello World” program prints "Hello World" into the trace buffer and exits. #!/usr/bin/probevue /* Hello World in probevue */ /* Program name: hello.e */ @@BEGIN { printf("Hello World\n"); exit(); } ► This “Hello World” program prints "Hello World" when is typed on the keyboard. #!/usr/bin/probevue /* Hello World 2 in probevue */ /* Program name: hello2.e */ @@END { printf("Hello World\n"); } Each clause of a Vue script consists of the following three elements: ► Probe point specification The probe point specification identifies the probe points to be dynamically enabled. ► Action block The action block is used to identify the set of probe actions to be performed when the probe fires. Chapter 3. AIX advanced continuous availability tools and features 115
Page 1:
Front cover IBM AIX Continuous Avai
Page 4 and 5:
Note: Before using this information
Page 6 and 7:
2.3.7 Minidump . . . . . . . . . .
Page 8 and 9:
vi IBM AIX Continuous Availability
Page 10 and 11:
Trademarks The following terms are
Page 12 and 13:
Engineering degree in Computer Scie
Page 14 and 15:
Find out more about the residency p
Page 16 and 17:
1.1 Overview In May 2007, IBM intro
Page 18 and 19:
1.5 Continuous operations Continuou
Page 20 and 21:
1.6.2 Availability 1.6.3 Serviceabi
Page 22 and 23:
IBM has tried to enhance FFDC featu
Page 24 and 25:
10 IBM AIX Continuous Availability
Page 26 and 27:
2.1 System availability AIX is buil
Page 28 and 29:
On AIX 5.3, the only way to persist
Page 30 and 31:
When used on a standalone server (s
Page 32 and 33:
mirrored volume group on the client
Page 34 and 35:
2.2.1 Error checking Run-Time Error
Page 36 and 37:
The PowerPC hardware gives software
Page 38 and 39:
System dumps can also be user-initi
Page 40 and 41:
Live dumps are small dumps that do
Page 42 and 43:
Trace is a valuable tool for observ
Page 44 and 45:
Component Trace uses mechanisms sim
Page 46 and 47:
2.3.14 syslog To display the boot l
Page 48 and 49:
Logging can be added to many of the
Page 50 and 51:
compression: on path specification:
Page 52 and 53:
2.4.4 EtherChannel network traffic
Page 54 and 55:
2.4.6 2-Port Adapter-based Ethernet
Page 56 and 57:
operations) without affecting produ
Page 58 and 59:
Quorum A quorum is a vote of the nu
Page 60 and 61:
2.5.8 Journaled File System-related
Page 62 and 63:
Fast I/O failure is controlled by a
Page 64 and 65:
display its output in a format suit
Page 66 and 67:
For more detailed information about
Page 68 and 69:
54 IBM AIX Continuous Availability
Page 70 and 71:
3.1 AIX Reliability, Availability,
Page 72 and 73:
This means that traditional AIX sys
Page 74 and 75:
used by IBM service personnel, so t
Page 76 and 77:
also be used to obtain a snapshot o
Page 78 and 79: 3.5 Live dump and component dump Li
Page 80 and 81: lfs filesystem ._0 | NO | ON/3 | OF
Page 82 and 83: .vmker | YES | ON/3 | OFF/3 .vmpool
Page 84 and 85: The output of Start a Live Dump is
Page 86 and 87: Table 3-3 Concurrent update termino
Page 88 and 89: We tested the installation of an ef
Page 90 and 91: Setting efix state to: STABLE +----
Page 92 and 93: mode, storage keys are called user
Page 94 and 95: Example 3-19 shows the SMIT menu fo
Page 96 and 97: might share a given hardware key. M
Page 98 and 99: KKEY_UPUBLIC, KKEY_FILE_DATA KKEY_U
Page 100 and 101: Note: Kernel keys and keysets, whic
Page 102 and 103: extension key-aware is determining
Page 104 and 105: added a protection gate for the int
Page 106 and 107: } printf("hardware keyset after KER
Page 108 and 109: } param=atoi(*(argv+1)); printf("Te
Page 110 and 111: Load the kernel extension so that a
Page 112 and 113: 3 : 000000000000000A r4 : F10006C00
Page 114 and 115: 3.7.7 User mode protection keys Use
Page 116 and 117: ► The APIs provided by the system
Page 118 and 119: if (!strcmp(*(argv+1),"read")){ if
Page 120 and 121: strlen() at 0xd010da00 _doprnt(??,
Page 122 and 123: int pthread_attr_setukeyset_np (pth
Page 124 and 125: Machine State Save Area iar : 00000
Page 126 and 127: As a consequence, determining the r
Page 130 and 131: ► An optional predicate The predi
Page 132 and 133: 3. Interval probe manager The inter
Page 134 and 135: { int count; count = count +1; prin
Page 136 and 137: ► Errno names ► Signal names
Page 138 and 139: * will result in error out of read(
Page 140 and 141: This places a large part of the bur
Page 142 and 143: Note: The frequency of checks made
Page 144 and 145: Non-fragments 00000066 Promotions 0
Page 146 and 147: immediately after the returned stor
Page 148 and 149: This option should be used with car
Page 150 and 151: 3.9.6 KDB commands for XMDBG ► xm
Page 152 and 153: 138 IBM AIX Continuous Availability
Page 154 and 155: Name AIX version Hardware required
Page 160 and 161: Online resources These Web sites ar
Page 162 and 163: sysdumpdev 27 tprof 28 trace 28 trc
Page 164: subsequent reboot 71, 133 SUE 18 Sy
show all

IBM AIX Continuous Availability Features - IBM Redbooks

Create successful ePaper yourself

Delete template?

Save as template?