1IPMCTL-DUMP-GOAL(1)                 ipmctl                 IPMCTL-DUMP-GOAL(1)
2
3
4

NAME

6       ipmctl-dump-goal - Stores the current system configuration in a file
7

SYNOPSIS

9       ipmctl dump [OPTIONS] -destination (path) -system -config
10

DESCRIPTION

12       Store the currently configured memory allocation settings for all
13       DCPMMs in the system to a file in order to replicate the configuration
14       elsewhere. Apply the stored memory allocation settings using the
15       command Section [Load Memory Allocation Goal].
16

OPTIONS

18       -h, -help
19           Displays help for the command.
20
21       -o (text|nvmxml), -output (text|nvmxml)
22           Changes the output format. One of: "text" (default) or "nvmxml".
23

EXAMPLES

25       Stores the memory allocation settings from all the DCPMMs into the file
26       "config.txt".
27
28       ipmctl dump -destination config.txt -system -config
29

LIMITATIONS

31       Only memory allocation settings for manageable DCPMMs that have been
32       successfully applied by the BIOS are stored in the file. Unconfigured
33       DCPMMs are not included, nor are memory allocation goals that have not
34       been applied.
35

RETURN DATA

37       The CLI will indicate the overall status of the operation when
38       complete. If a failure occurs when dumping the memory allocation from
39       multiple DCPMMs, the process will stop and the output file will be
40       removed.
41
42       The output file is formatted as an ASCII file with one row per DCPMM
43       containing the following comma-separated values.
44
45       SocketID
46           unsigned short int Identifier for the socket the DCPMM is
47           associated with.
48
49       DimmHandle
50           unsigned int DCPMM device handle.
51
52       Capacity
53           unsigned long long int Total capacity of the DCPMM in GiB.
54
55       MemorySize
56           unsigned long long int Capacity of the DCPMM allocated as Memory
57           Mode in GiB.
58
59       AppDirect1Size
60           unsigned long long int Capacity of the DCPMM allocated for the
61           first App Direct interleave set in GiB.
62
63       AppDirect1Format
64           unsigned short int Bit mask representing the interleave format of
65           the first App Direct interleave set.
66
67       AppDirect1Mirrored
68           unsigned char 1 if the first App Direct interleave set is mirrored,
69           0 otherwise.
70
71       AppDirect1Index
72           unsigned short int Unique index of the first App Direct interleave
73           set.
74
75       AppDirect2Size
76           unsigned long long int Capacity of the DCPMM allocated for the
77           second App Direct interleave set in GiB.
78
79       AppDirect2Format
80           unsigned short int Bit mask representing the interleave format of
81           the second App Direct interleave set.
82
83       AppDirect2Mirrored
84           unsigned char 1 if the second App Direct interleave set is
85           mirrored, 0 otherwise.
86
87       AppDirect2Index
88           unsigned short int Unique index of the second App Direct interleave
89           set.
90

SAMPLE OUTPUT

92       Successfully dumped system configuration to file: config.csv
93
94       config.csv contents:
95
96       #SocketID,DimmHandle,Capacity,MemorySize,AppDirect1Size,AppDirect
97       1Format,AppDirect
98       1Mirrored,AppDirect1Index,AppDirect2Size,AppDirect2Format,AppDire
99       ct2Mirrored,AppDirect2Index
100       1,4385,64,64,0,0,0,0,0,0,0,0
101       1,4401,64,64,0,0,0,0,0,0,0,0
102       1,4417,64,64,0,0,0,0,0,0,0,0
103       1,4433,64,64,0,0,0,0,0,0,0,0
104       1,4449,64,64,0,0,0,0,0,0,0,0
105
106
107
108ipmctl                            2019-10-23               IPMCTL-DUMP-GOAL(1)
Impressum