How To
Summary
New command for SSP configuration information. Run this on your Power Systems Virtual I/O Server.
Objective
New Shared Storage Pool (SSP) code and command to output all the details of a SSP that can be found via the VIOS libperfstat library.
Steps
I have been testing out the AIX libperfstat libraries new functions and got to the SSP ones.
So I knock up this command to dump the config details that can be extracted.
So with 128 lines of C code we have the new command - I have not seen a new VIOS SSP command that outputs this data yet so this is new details that I think would help you rebuild a SSP if you had an accident or disaster.
Command line interface
# ./nsspconf -h
Hint: [-v] [-h]
List Shared Storage Pool info: global, disk including tier & failure group, LU including maps to client LPARs
Seem to ignore LU's that are not mapped to a client LPAR
-v include VIOS details. Warning: This can add 2 seconds per VIOS
-h This help info and stop
Data
- SSP
- cluster name
- pool name
- total space
- Total used
- Disk
- hdisk
- capacity
- free
- tier name
- failure group name
- LU
- LU name
- type = THIN or THICK
- size in MB
- free in MB
- usage in MB
- client LPAR id
- machine type model and serial number
- udid unique LU name
- VIOS (optional)
- VIOS name
- IP address
- MTMS
- VIOS LPAR id
- oslevel output
- ssp status
- pool status
Sample Output
# ./nsspconf -v
Global ClusterName=spiral PoolName=spiral TotalSpace=523776 Tota
DiskName=hdisk5 capacity=131072 free=131008 tier=SYSTEM fg=cocoa
DiskName=hdisk6 capacity=131072 free=131008 tier=SYSTEM fg=cocoa
DiskName=hdisk7 capacity=131072 free=131008 tier=SYSTEM fg=cocoa
DiskName=hdisk8 capacity=131072 free=131008 tier=SYSTEM fg=cocoa
DiskName=hdisk10 capacity=131072 free=131008 tier=SYSTEM fg=coffee
DiskName=hdisk11 capacity=131072 free=131008 tier=SYSTEM fg=coffee
DiskName=hdisk12 capacity=131072 free=131008 tier=SYSTEM fg=coffee
DiskName=hdisk13 capacity=131072 free=131008 tier=SYSTEM fg=coffee
LU=testing type=THIN_LU size=32768 free=32770 usage=0 client_id=5 mtm=
08b00ccb
LU=v
8E.21D494V-V4-C2 udid
LU=vm59a type=THIN_LU size=65536 free=59590 usage=5949 client_id=4 mtm=
827ca422
LU=vm59a type=THIN_LU size=65536 free=59590 usage=5949 client_id=4 mtm=
827ca422
LU=vm60_SLES12 type=THIN_LU size=65536 free=57199 usage=8340 client_id=5 mtm=
656af2bc8d48ef
LU=vm60_SLES12 type=THIN_LU size=65536 free=57199 usage=8340 client_id=5 mtm=
656af2bc8d48ef
LU=v
8E.21D494V-V3-C2 udid
LU=brass175a type=THIN_LU size=32768 free=30466 usage=2303 client_id=12 mtm=
1643055a08e6f8f
LU=testtwo type=THICK_LU size=101376 free=0 usage=101382 client_id=12 mtm=
50a095e290b18
LU=v
8.E8E.21D494V-V4-C8 udid
LU=v
8.E8E.21D494V-V3-C6 udid
LU=v
0.M9
LU=silver2 type=THIN_LU size=32768 free=22972 usage=9797 client_id=4 mtm=
83639157b6
LU=silver2 type=THIN_LU size=32768 free=22972 usage=9797 client_id=4 mtm=
83639157b6
LU=v
0.M9
LU=v
8.E8E.21D494V-V3-C8 udid
LU=v
.MR9.13601FX-V1-C9 udid
LU=v
8.E8E.21D494V-V3-C8 udid
LU=v
.MR9.13601FX-V1-C9 udid
LU=silver5 type=THIN_LU size=32768 free=29702 usage=3067 client_id=7 mtm=
e4af26787f
LU=v
8.E8
LU=v
8.E8
LU=v
MR9.13601FX-V1-C10 udid
LU=v
.MR9.13601FX-V2-C10 udid
LU=v
8.E8E.21D494V-V3-C9 udid
LU=v
MR9.13601FX-V2-C11 udid
LU=v
=U90
LU=brass3a type=THIN_LU size=32768 free=32466 usage=303 client_id=11 mtm=
f504c4ee46c
LU=v
=U90
LU=brass175a type=THIN_LU size=32768 free=30466 usage=2303 client_id=12 mtm=
643055a08e6f8f
LU=brass3a type=THIN_LU size=32768 free=32466 usage=303 client_id=11 mtm=
f504c4ee46c
VIOS
VIOS
VIOS
VIOS
VIOS
VIOS
VIOS
VIOS
Comments:
- I could change this to a comma separated values format for simpler scripting the results. But I intend to add this to njmon in JSON format first.
- One thing missing is that it states the Server (machine type model and serial number (MTMS)) and the Client LPAR id - but not the Client LPAR name or hostname (if different). The LU name might include a reference to the LPAR using it or you will need a list of the LPAR names and the client LPAR id from the HMC to match that up.
- As this is simple code using the libperfstat to do all the heavy lifting I will release this as a code example.
- Comments, below, please, on:
- the code
- the usefulness
- the output format
- Compile the code with: cc -o nsspconf -O nsspconf.c -lperfstat
Downloads
- nsspconf - binary file of the command. Compiled on AIX 6 for VIOS 2.2.6.+ not tested on earlier versions of VIOS.
- nsspconf.c - the C source code. On earlier version of AIX/VIOS you may have to comment out some fields that only appear it later VIOS version.
Here is the same source code in case you want a quick look:
#include<stdio.h>
#include<stdlib.h>
#include<libperfstat.h>
perfstat_ssp_t *ssp_global;
perfstat_ssp_t *ssp_disk;
perfstat_ssp_t *ssp_lu;
perfstat_ssp_t *ssp_node;
int global_count;
int disk_count;
int lu_count;
int node_count;
int vios = 0;
error(char* where)
{
perror(where);
exit(-7);
}
int main(int argc, char* argv[])
{
int i;
int rc;
int c;
while((c = getopt(argc, argv, "hv"))!= EOF){
switch(c){
default:
case 'h':
printf("Hint: %s [-v] [-h]\n");
printf("\tList Shared Storage Pool info: global, disk including tier & "
"failure group, LU including maps to client LPARs\n",argv[0]);
printf("\tSeem to ignore LU's that are not mapped to a client LPAR\n");
printf("\t -v \tinclude VIOS details. Warning: This can add 2 seconds per VIOS\n");
printf("\t -h \tThis help info and stop\n");
exit(0);
case 'v':
vios = 1;
break;
}
}
/* Phase 1: Enable the cluster statistics */
if( perfstat_config(PERFSTAT_ENABLE|PERFSTAT_CLUSTER_STATS, NULL) < 0)
error("perfstat_config SSP is not available. Only run this on a VIOS 2.2.6+ with a Shared Storeage Pool");
/* Phase 2: Enable the cluster statistics using perfstat_config */
if( (global_count = perfstat_ssp(NULL, NULL, sizeof(perfstat_ssp_t),0,SSPGLOBAL) ) < 0)
perror("perfstat_ssp(global init)");
if( (disk_count = perfstat_ssp(NULL, NULL, sizeof(perfstat_ssp_t),0,SSPDISK) ) < 0)
error("perfstat_ssp(disk init)");
if( (lu_count = perfstat_ssp(NULL, NULL, sizeof(perfstat_ssp_t),0,SSPVTD) ) < 0)
error("perfstat_ssp(lu init)");
/* printf("Global=%d Disk=%d lu=%d\n",global_count,disk_count,lu_count); */
/* Phase 3: Prepare memory buffers */
ssp_global = (perfstat_ssp_t *) malloc(sizeof(perfstat_ssp_t) * global_count);
ssp_disk = (perfstat_ssp_t *) malloc(sizeof(perfstat_ssp_t) * disk_count);
ssp_lu = (perfstat_ssp_t *) malloc(sizeof(perfstat_ssp_t) * lu_count);
if(ssp_global == (perfstat_ssp_t *)NULL ||
ssp_disk == (perfstat_ssp_t *)NULL ||
ssp_lu == (perfstat_ssp_t *)NULL )
error("malloc failure requesting space to store perfstat data");
/* Phase 4: Collect the data and display it */
if( (rc = perfstat_ssp(NULL, ssp_global, sizeof(perfstat_ssp_t),global_count,SSPGLOBAL) ) <0)
error("perfstat_ssp(SSPGLOBAL)");
printf("Global ");
printf("ClusterName=%s ", ssp_global->cluster_name);
printf("PoolName=%s ", ssp_global->spool_name);
printf("TotalSpace=%lld ", ssp_global->u.global.total_space);
printf("TotalUsedSpace=%lld\n", ssp_global->u.global.total_used_space);
if( (rc = perfstat_ssp(NULL, ssp_disk, sizeof(perfstat_ssp_t),disk_count,SSPDISK) ) < 0)
error("perfstat_ssp(SSPDISK)");
for(i=0; i<rc; i++){
printf("DiskName=%s ", ssp_disk[i].u.disk.diskname);
printf("capacity=%lld free=%lld tier=%s fg=%s\n",
ssp_disk[i].u.disk.capacity,
ssp_disk[i].u.disk.free,
ssp_disk[i].u.disk.tiername,
ssp_disk[i].u.disk.fgname);
}
if( (rc = perfstat_ssp(NULL, ssp_lu, sizeof(perfstat_ssp_t),lu_count,SSPVTD) ) < 0)
error("perfstat_ssp(SSPLU)");
for(i=0; i<rc; i++){
printf("LU=%s type=%s size=%lld free=%lld usage=%lld client_id=%d mtm=%s VTD=%s DRC=%s udid=%s\n",
ssp_lu[i].u.vtd.lu_name,
ssp_lu[i].u.vtd.lu_type,
ssp_lu[i].u.vtd.lu_size,
ssp_lu[i].u.vtd.lu_free,
ssp_lu[i].u.vtd.lu_usage,
ssp_lu[i].u.vtd.client_id,
ssp_lu[i].u.vtd.mtm,
ssp_lu[i].u.vtd.vtd_name,
ssp_lu[i].u.vtd.drcname,
ssp_lu[i].u.vtd.lu_udid);
}
/* Phase 5: output VIOS details - warning this can take 2 seconds per VIOS and
if VIOS(s) are shutdown or they have network or pool issues then libperfstat will
output annoying vague errors */
if(vios) {
if( (node_count = perfstat_ssp(NULL, NULL, sizeof(perfstat_ssp_t),0,SSPNODE) ) < 0)
error("perfstat_ssp(node init)");
if( (ssp_node = (perfstat_ssp_t *) malloc(sizeof(perfstat_ssp_t) * node_count)) == (perfstat_ssp_t *)NULL )
error("malloc failure");
if( (rc = perfstat_ssp(NULL, ssp_node, sizeof(perfstat_ssp_t),node_count,SSPNODE) ) < 0)
error("perfstat_ssp(SSPNODE)");
for(i=0; i<rc; i++){
printf("VIOS=%s ", ssp_node[i].u.node.hostname);
printf("IP=%s ", ssp_node[i].u.node.ip);
printf("MTMS=%s ", ssp_node[i].u.node.mtms);
printf("lparid=%d ", ssp_node[i].u.node.lparid);
printf("ioslevel=%s ", ssp_node[i].u.node.ioslevel);
printf("status=%s ", (ssp_node[i].u.node.status==1?"OK":"-"));
printf("poolstatus=%s\n", (ssp_node[i].u.node.poolstatus==1?"OK":"-"));
}
}
/* Phase 6: disable cluster statistics */
perfstat_config(PERFSTAT_DISABLE|PERFSTAT_CLUSTER_STATS, NULL);
return 0;
}
Additional Information
Other places to find Nigel Griffiths IBM (retired)
Document Location
Worldwide
Was this topic helpful?
Document Information
Modified date:
13 June 2023
UID
ibm11114839