1NVME-VIRTIUM-SAVE()                                        NVME-VIRTIUM-SAVE()
2
3
4

NAME

6       nvme-virtium-save-smart-to-vtview-log - Periodically save smart
7       attributes into a log file (csv format).
8

SYNOPSIS

10       nvme virtium save-smart-to-vtview-log <device> [--run-time=<NUM> | -r <NUM>]
11                               [--freq=<NUM> | -f <NUM>]
12                               [--output-file=<FILE> | -o <FILE>]
13                               [--test-name=<NAME> | -n <NAME>]
14

DESCRIPTION

16       This command automates the process of collecting SMART data
17       periodically and saving the data in a ready-to-analyze format. Each
18       entry is saved with timestamp and in csv format. Users can use excel to
19       analyze the data. Some examples of use cases are collecting SMART data
20       for temperature characterization, collecting data to calculate
21       endurance, or collecting SMART data during a test or during normal
22       operation.
23
24       The <device> parameter is mandatory and may be either the NVMe
25       character device (ex: /dev/nvme0), or a namespace block device (ex:
26       /dev/nvme0n1).
27
28       On success, the command generates a log file, which contains an entry
29       for identify device (current features & settings) and periodic entries
30       of SMART data.
31
32       This command runs for the time specified by the option <run-time>, and
33       collects SMART data at the frequency specified by the option <freq>. If
34       the output file name is not specified, this command will generate a
35       file name that include model string and serial number of the device.
36
37       If the test-name option is specified, it will be recorded in the log
38       file and be used as part of the log file name.
39

OPTIONS

41       -r <NUM>, --run-time=<NUM>
42           (optional) Number of hours to log data (default = 20 hours)
43
44       -f <NUM>, --freq=<NUM>
45           (optional) How often you want to log SMART data (0.25 = 15' , 0.5 =
46           30' , 1 = 1 hour, 2 = 2 hours, etc.). Default = 10 hours.
47
48       -o <FILE>, --output-file=<FILE>
49           (optional) Name of the log file (give it a name that easy for you
50           to remember what the test is). You can leave it blank too, the file
51           name will be generated as <model string>-<serial number>-<test
52           name>.txt.
53
54       -n <NAME>, --test-name=<NAME>
55           (optional) Name of the test you are doing. We use this string as
56           part of the name of the log file.
57

EXAMPLES

59       •   Temperature characterization:
60
61               # nvme virtium save-smart-to-vtview-log /dev/yourDevice --run-time=100 --record-frequency=0.25 --test-name=burn-in-at-(-40)
62
63       •   Endurance testing:
64
65               # nvme virtium save-smart-to-vtview-log /dev/yourDevice --run-time=100 --record-frequency=1 --test-name=Endurance-test-JEDEG-219-workload
66
67       •   Just logging: Default logging is run for 20 hours and log every 10
68           hours.
69
70               # nvme virtium save-smart-to-vtview-log /dev/yourDevice
71

NVME

73       Part of the nvme-user suite
74
75
76
77                                                           NVME-VIRTIUM-SAVE()
Impressum