HP 3PAR StoreServ 7200 2-node HP 3PAR CIM API Programming Reference (OS 3.1.2 - Page 60

UpdateDeltaSnapshotSpace() Method, Pool.TotalManagedSpace

Page 60 highlights

SpaceLimit and SpaceLimitThresholdWarning for the TPD_AllocatedFromStoragePool association between the snapshot volume and the parent TPD_DeltaReplicaStoragePool are not used, and hence is not populated, since the InformOS does not support specification of allocation limit on a per snapshot volume basis. Calculation for TotalManagedSpace of the TPD_DeltaReplicaStoragePool of a CPVV is the similar to that for a non-CPVV, except that the parent pool is now a DSP and not a concrete pool. Space used by SA is not included in TotalManagedSpace, but is included in the TPD_AllocatedFromStoragePool.SpaceConsumed value, so to deduce the raw SA space, one can deduct Pool.TotalManagedSpace from SpaceConsumed. The UpdateDeltaSnapshotSpace() method should be called to prevent the value of RemainingManagedSpace from getting too stale. Pool.TotalManagedSpace = raw SD size Pool.RemainingManagedSpace = raw SD size - SUM(space used by snapshots) SpaceConsumed of the TPD_AllocatedFromStoragePool between the parent DSP and TPD_DeltaReplicaStoragePool equals to the sum of the raw admin and raw snap user size. SpaceConsumed by Replica Pool from DSP = raw SD size + raw SA size SpaceConsumed of the TPD_AllocatedFromStoragePool between TPD_DeltaReplicaStoragePool and a snapshot volume equals the space consumed by the snapshot. This value should be updated via the UpdateDeltaSnapshotSpace() method to prevent it from getting too stale. SpaceConsumed by Snapshot Vol from Replica Pool = space used by a snapshot UpdateDeltaSnapshotSpace() Method It is important to note that calculation of space consumed by a snapshot volume can potentially be a long process, and it is not updated real-time by sysmgr. One has to issue the command "updatesnapspace" from CLI (from which a task is generated) to start the calculation of SA/SD space used by a snapshot. Hence, when a CIM client retrieves the RemainingManagedSpace value for a SA/SD pool or the SpaceConsumed value for a snapshot volume, it can potentially be stale if updatesnapspace has not been done for a while. As a result, a new extrinsic method is defined in TPD_StorageConfigurationService class called UpdateDeltaSnapshotSpace() which mirrors the CLI updatesnapspace command. A client wishing to obtain a more accurate picture of the aforementioned capacity values must first call this method, monitor the returned job for its completion, then finally get at the properties. uint32 UpdateDeltaSnapshotSpace( [In] TPD_StorageVolume ref SnapshotVolume[], [Out] TPD_ConcreteJob ref Job); • SnapshotVolume: Array of references to the snapshot volume to update. If NULL, then all snapshots are updated. • Job: A Job is created as a side-effect of the execution of the method, and a reference to that Job is returned through this parameter. 60 CIM API SMI-S Support

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309

SpaceLimit
and
SpaceLimitThresholdWarning
for the
TPD_AllocatedFromStoragePool
association between the snapshot volume and the parent
TPD_DeltaReplicaStoragePool
are not used, and hence is not populated, since the InformOS
does not support specification of allocation limit on a per snapshot volume basis.
Calculation for
TotalManagedSpace
of the
TPD_DeltaReplicaStoragePool
of a CPVV is
the similar to that for a non-CPVV, except that the parent pool is now a DSP and not a concrete
pool. Space used by SA is not included in
TotalManagedSpace
, but is included in the
TPD_AllocatedFromStoragePool.SpaceConsumed
value, so to deduce the raw SA space,
one can deduct
Pool.TotalManagedSpace
from
SpaceConsumed
. The
UpdateDeltaSnapshotSpace()
method should be called to prevent the value of
RemainingManagedSpace
from getting too stale.
Pool.TotalManagedSpace = raw SD size
Pool.RemainingManagedSpace = raw SD size
SUM(space used by snapshots)
SpaceConsumed
of the
TPD_AllocatedFromStoragePool
between the parent DSP and
TPD_DeltaReplicaStoragePool
equals to the sum of the raw admin and raw snap user size.
SpaceConsumed by Replica Pool from DSP = raw SD size + raw SA size
SpaceConsumed
of the
TPD_AllocatedFromStoragePool
between
TPD_DeltaReplicaStoragePool
and a snapshot volume equals the space consumed by the
snapshot. This value should be updated via the
UpdateDeltaSnapshotSpace()
method to
prevent it from getting too stale.
SpaceConsumed by Snapshot Vol from Replica Pool = space used by a snapshot
UpdateDeltaSnapshotSpace() Method
It is important to note that calculation of space consumed by a snapshot volume can potentially be
a long process, and it is not updated real-time by sysmgr. One has to issue the command
updatesnapspace<snapshot vol name>
” from CLI (from which a task is generated) to start
the calculation of SA/SD space used by a snapshot. Hence, when a CIM client retrieves the
RemainingManagedSpace
value for a SA/SD pool or the
SpaceConsumed
value for a snapshot
volume, it can potentially be stale if
updatesnapspace
has not been done for a while. As a
result, a new extrinsic method is defined in
TPD_StorageConfigurationService
class called
UpdateDeltaSnapshotSpace()
which mirrors the CLI
updatesnapspace
command.
A client wishing to obtain a more accurate picture of the aforementioned capacity values must first
call this method, monitor the returned job for its completion, then finally get at the properties.
uint32 UpdateDeltaSnapshotSpace(
[In] TPD_StorageVolume ref SnapshotVolume[],
[Out] TPD_ConcreteJob ref Job);
SnapshotVolume
: Array of references to the snapshot volume to update. If NULL, then all
snapshots are updated.
Job
: A Job is created as a side-effect of the execution of the method, and a reference to that
Job is returned through this parameter.
60
CIM API SMI-S Support