Hpe 3Par/Primera Peak/Boss S3Mft S3 "Multi-Function Tool" User's Guide

HPE 3PAR/PRIMERA
PEAK/BOSS
S3MFT
S3 “Multi-Function Tool”
User’s Guide
Version 5.0087
12-Apr-2021
By: [email protected]
1
12-Apr--2021
2
12-Apr--2021
Contents
1. READ ME FIRST ........................................................................................................................................... 5
2. Introduction ..................................................................................................................................................... 6
3. Performance .................................................................................................................................................... 7
4. Installation....................................................................................................................................................... 8
Additional notes for macOS users .................................................................................................................. 9
5. Usage Considerations.................................................................................................................................... 10
Usage Warning.................................................................................................................................................. 11
Downloading ..................................................................................................................................................... 11
Time Zone Considerations ................................................................................................................................ 11
Super, Really Important Time Zone Reminder! ........................................................................................... 11
6. Command Line Options ................................................................................................................................ 12
7. Examples ....................................................................................................................................................... 22
s3mft -n 1642005 -s showpd.-c ..................................................................................................................... 22
s3mft -a -n 1642005 -s statpd.-rw.-d.-iter .................................................................................................... 23
s3mft -n 1301946 -m –a ................................................................................................................................ 24
s3mft -n 1642005 -T 200811 -p config -s showvv ....................................................................................... 28
s3mft -n 1642005 -sfdt 7-aug -efdt 11-aug -p config -s showvv .................................................................. 29
s3mft -n 1642005 -sfdt 7-aug -efdt 11-aug -p config -s showvv -G 2 .......................................................... 30
s3mft -n 1642005 -sfdt 7-aug -efdt 11-aug -p config -s showvv -D 2 .......................................................... 31
s3mft -n 1642005 -stlatest ............................................................................................................................. 34
s3mft -n 1642005 -stlatest -filetype alert,config ........................................................................................... 34
s3mft -n 1642005 -filetype staus,config -sfdt="-7d" .................................................................................... 35
s3mft -product SP -sfdt="-7d" ...................................................................................................................... 36
s3mft -class 9000 -stlatest -filetype config ................................................................................................... 37
s3mft -n CZ3813VV23 -filetype evtlog -sfdt="24-aug" -text "hw_ps" ........................................................ 38
s3mft -filetype crashtxt,apptxt -sfdt="-1d" ................................................................................................... 41
s3mft -filename "stats-2020-08|3PAR.INSERV/CZ20040GRB/crashtxt/crashtxt.200827.084017.4463" -
regex "DATE|NODE|PANIC" -h .................................................................................................................. 41
s3mft -filename "stats-2020-08|3PAR.INSERV/CZ20040GRB/crashtxt/crashtxt.200827.084017.4463" -so
....................................................................................................................................................................... 41
s3mft -vp="3PAR:SP;HP:STOREONCE" -sfdt="-15s".............................................................................. 42
s3mft -n SGH837WTNL -filet config -s "showport(\s*\-?[dsf]+\w*\s*\-?\w*)?" ....................................... 43
8. Usage Comparisons ...................................................................................................................................... 52
STLATEST vs S3MFT ..................................................................................................................................... 52
STALL vs S3MFT ............................................................................................................................................ 53
9. User Initialization File .................................................................................................................................. 55
“defaults” .......................................................................................................................................................... 56
"arraydetails"................................................................................................................................................. 56
"arrayfeatures" .............................................................................................................................................. 56
"filebanner" ................................................................................................................................................... 56
"pullupdate" .................................................................................................................................................. 56
"sntranslation" ............................................................................................................................................... 56
"sort" ............................................................................................................................................................. 56
"vendorproducts": ......................................................................................................................................... 56
"widesearch" ................................................................................................................................................. 56
“dlworker”......................................................................................................................................................... 56
“mqworker”....................................................................................................................................................... 57
3
12-Apr--2021
“httptuning”....................................................................................................................................................... 58
"DialerTimeout" ............................................................................................................................................ 58
"DialerKeepAlive" ........................................................................................................................................ 58
"ExpectContinueTimeout" ............................................................................................................................ 58
"IdleConnTimeout" ....................................................................................................................................... 58
"MaxAllIdleConns" ...................................................................................................................................... 58
"MaxHostIdleConns" .................................................................................................................................... 58
"ResponseHeaderTimeout" ........................................................................................................................... 58
"TLSHandshakeTimeout" ............................................................................................................................. 59
10. Fixes and New Features ............................................................................................................................. 60
V3.0180............................................................................................................................................................. 60
V3.0185............................................................................................................................................................. 61
V3.0190............................................................................................................................................................. 62
V3.0194............................................................................................................................................................. 63
V3.0196............................................................................................................................................................. 64
V4.0230............................................................................................................................................................. 65
V4.0240............................................................................................................................................................. 66
V4.0245............................................................................................................................................................. 67
V4.0248............................................................................................................................................................. 68
V4.0294............................................................................................................................................................. 69
V4.0300............................................................................................................................................................. 70
V4.0304............................................................................................................................................................. 71
V5.0044............................................................................................................................................................. 72
V5.0048............................................................................................................................................................. 73
V5.0053............................................................................................................................................................. 74
V5.0055............................................................................................................................................................. 75
V5.0087............................................................................................................................................................. 76
4
12-Apr--2021
1. READ ME FIRST
V5.0081 has some enhancements that users of S3MFT should be aware of:
1. Specifying vendors and products has changed.

a. The “-vendor” and “-product” switches are being deprecated. While these two (2) switches are
still present and function in this release, V5.0081, they will be removed in the next release.
b. The replacement to “-vendor” and “-product” is going to “-vp”. The “-vp” switch is available in
V5.0081 and users should begin using this new switch. The “-vp” switch will represent a
vendor and its products. S3MFT will enforce that the appropriate products are matched up to
their proper vendor. Refer to the COMMAND LINE OPTIONS section and “-vp”.
c. The current default for vendor and products is “3PAR” and “INSERV,SP”, respectively. These
default values are based on the fact that S3MFT was designed and built from a 3PAR/PRIMERA
use perspective. In the next release, these default values will be removed. Users of S3MFT
should then implement default values using the initialization file or be forced to use the switch
“-vp”.
2. User specific initialization (.ini) files has now been implemented.
a. Several of the recent, prior versions of S3MFT did support the use of initialization files, but
they were somewhat narrowly focused on specific functionalities within S3MFT.
b. V5.0081 now supports a single user initialization file that supports several functionalities,
including the “specific functionalities” just mentioned.
c. The user initialization file uses a JSON format and thus modified using a text editor.
3. Serial Number Translation enhancements.
a. S3MFT has always attempted to take ensure that searches are executed using the correct
serial number. To accomplish this task, S3MFT had to perform an additional database look up
to determine whether the serial number provided was the actual serial number or the HPE
defined/provided serial number. If the serial number provided was the HPE defined/provided
serial number then S3MFT would use the translation to the actual serial number. In most cases
this may be generalized as translating the HPE ten (10) character alphanumeric serial number
to the seven (7) digit numeric serial number (actual). The file objects in S3 are stored under the
actual serial number.
b. S3MFT now will allow users to disable this serial number translation and therefore avoid
accessing the database. Foregoing the serial number lookup in the database has the potential
of improving search times. However, there is a caveat to not performing the serial number
translation, the search may not return results! The user must be sure of the serial numbers
they are providing to S3MFT.
c. Executing searches using the following switches will return the correct serial numbers directly
from the database and thus a user may safely skip serial number translations
i. “-base” for base version searches
ii. “-class” for searches based on array class
iii. “-model” for searches based on array model
d. Serial number translations will remain the default. To disable serial number translations, you
must explicitly specify the command line switch “-noxn”.
.
5
12-Apr--2021
2. Introduction
The HPE 3PAR/PRIMERA Infrastructure team has been monitoring the influx of 3PAR/PRIMERA telemetry data for some
time and realized that there was no cost effective way to continue utilizing NFS shares to share this telemetry data out
to us, the end users. There is just too much data being sent back to HPE.
To address the problem the HPE 3PAR/PRIMERA Infrastructure team settled on in house AWS S3 solution.
As a result of this decision, a “tool”, S3MFT, was necessary to aid us, the end users, in finding the data we need, display
it and begin searching the data.
S3MFT will run on both WINDOWS and Linux. The only real requirement is a network connection to the HPE internal
network.
Given that S3MFT will run on both Linux and WINDOWS, you will not necessarily have to leverage both WINDOWS and
Linux to find, retrieve, and/or search the data. As long as you have a network connection to the HPE Intranet, you will
be able to access the AWS S3 solution from either OS!
This is a big change for WINDOWS users who used to have to log onto a Linux server to access the data!
At the time of this writing, there is only a command line interface available.
I would also like to thank the following co-workers for their time, patience, assistance, feedback and work on this
tool…
Paul Carlson
Shan Choudhury
Steven Fong
Kelly Graham
Mike Grigg
Dan Kortenhoeven
Preston Mitchell
Jeremy Nguyen
Thank you,
Gary Sachs
3PAR/PRIMERA BOSS
21-Aug-2020
6
12-Apr--2021
3. Performance
S3MFT V4.0230 underwent a performance enhancement. S3MFT has been updated to take advantage of
additional multithreaded processing. While the downloader routine used by S3MFT was taking advantage of
multithreading, it was discovered that further multithreading was possible in other aspects of processing in
S3MFT.
S3MFT has established defaults for the worker queues based on the three (3) supported OS’s. These defaults
are a best effort, they may not address every situation. These defaults may be adjusted in the future.
Before describing how to make adjustments to the worker queues, users need to be aware of several details
that will impact performance of S3MFT when deciding on how much adjustment is to be made…
 A system’s performance varies and these variations will continue to impact S3MFT worker queues.
 Focus on the overall completion time, not the individual file operations.
 If activities involve the local filesystem be mindful of that aspect because it has the potential to be a
bottleneck.
 “File” size and/or count do play a role due to possible buffering depending on the activities.
 Since S3MFT does utilize the network, the network has the potential of impacting performance.
 Do not try to make adjustments for every situation.
 You may need to make several attempts to find the optimal setting for your needs.
 Be patient.
There are two (2) attributes that S3MFT uses to configure the worker queues:
1. The number of workers, this represents the number of threads that will be created to perform the
work.
2. The queue length, this represents the number of entries that will be allowed on the work queue from
which the worker threads read.
The goal being to keep the workers busy and not idle while the length of the queue is minimal.
Modifications to worker queue settings may be made at the command line or via a user initialization file.
Refer to the “User Initialization File” chapter below regarding how to create a user initialization file,
information pertaining to the contents, format and how to edit.
7
12-Apr--2021
4. Installation
The S3MFT software is a standalone executable with an executable available for WINDOWS, Linux or macOS.
There is a zip file, s3mft_Vn.nnnn.zip, containing the executable for each of the three (3) aforementioned operating
systems. This zip file is available from the following locations:
- /share/common-scripts/ERT/ - accessible via the CXO servers

- \\fusion2.cxo.storage.hpecorp.net\Public\tools
- The S3 YAMMER group:
o https://www.yammer.com/hpe.com/#/groups/42532782080/files
- The S3 sharepoint:
o https://hpe.sharepoint.com/teams/EngLab/UserPortal/SitePages/S3-Object-Storage.aspx
Always select the zip file with the highest version, please.
The executables will be available within the respective folder named for the operating system.
As stated, the executable is standalone, extract and/or copy it to a directory of your choice.
Make sure your OS can find it and you are ready to go!
macOS Users please see below for further details…
8
12-Apr--2021
Additional notes for macOS users
Once you copy the macOS version of the executable to the desired directory you will need to ensure that the
permission is set to 755 on the executable.
Should you encounter the following exception when executing s3mft...
Use the following workaround:
1. In Finder on your Mac, locate the app you want to open, s3mft.
2. Control-click the app icon, then choose Open from the shortcut menu.
3. Click Open.
4. The app is saved as an exception to your security settings, and you can open it in the future by double-
clicking it or executing from cli, just as you can with any authorized app.
Ref: https://github.com/hashicorp/terraform/issues/23033
Thank you Naveena Kedlaya for providing these macOS instructions.
9
12-Apr--2021
5. Usage Considerations
S3MFT, as has been stated, a tool to assist in accessing, displaying, searching and locating STaTS telemetry data with
the AWS S3 solution. Essentially the filesystem directories and NFS shares for STaTS telemetry data will no longer be
updated starting around the February 2021, the HPE Infrastructure team will be updating all of us regarding this as
they finalize the details. They are making great efforts to ease this transition.
Please be aware that STaTS telemetry data that exists on the NFS share will remain there for some time after the
cessation of updates.
As of the writing of this document the HPE AWS S3 solution is receiving live updates of the STaTS telemetry data! The
HPE AWS S3 solution is available for use… NOW!
The HPE AWS S3 has full production STaTS telemetry data going back to May 2020.
With our AWS S3 solution the concept of directories no longer exists, you cannot CD to a location and access the data. A
true file does not exist, AWS S3 will provide file objects that exist in buckets.
A bucket simply put is just that a bucket where file objects are organized. You can think of a bucket as a database table.
In the HPE AWS S3 scheme of things, the buckets are organized by year and month, somewhat similar to the NFS
shares. The bucket names employed for the STaTS telemetry data have the following convention for naming: “stats-
YYYY-MM”, where “YYYY’ represents the four (4) digit year and “MM” is the two (2) digit month, right justified and zero
filled. File objects are assigned to a bucket based on their creation date in HPE AWS S3.
It should be pointed out that there is an aberration with regards to buckets and the creation time of the file object. The
aberration occurs on the last day of a month rolling over into the first day of the next month, some file objects for the
last day of the month will be assigned to the bucket of the new month. This aberration is due to the fact that the
creation time is based on GMT time.
Within the buckets the file objects are given a “key” name that looks similar to the file system path that we are all used
to: vendor.product/serialnumber/filetype/filename. So, for the serial number CZ3813VV23 you would see the following
describing an evtlog file object:
3PAR.INSERV/CZ3813VV23/evtlog/evtlog.200824.144426.debug
Breaking this down…
Vendor: 3PAR
Product: INSERV
Serial#: CZ3813VV23
File Type: evtlog
File Name: evtlog.200824.144426.debug
The vendor, product, file type and serial number fields are four of six data items used to search for data in HPE AWS S3.
The other two data items are file date-time and the creation date-time.
The file date-time data is the date-time part of the filename, so in the example above, the file date-time would be
“200824.144426” and it is this field that is referenced when the switches “-sfdt” and/or “-efdt” are utilized in a search
or by default when neither of these switches are present. By default, in the absence of “-sfdt/-efdt”, the start file date-
time is twenty-one (21) days prior to the current day and the default end file date-time is set to 24 hours in the future
from the current system time at the execution of the command.
10
12-Apr--2021
The creation date-time is primarily foreseen to be used by processes and/or procedures that will be ingesting the HPE
AWS S3 data into other databases and/or repositories, therefore its usage is currently undocumented.
As was pointed out above and discussed in the command line switches below, there are other vendors” and products
present in the HPE AWS S3 solution, as an example the 3PAR (vendor) SP (product) data. By default, S3MFT uses 3PAR
as the default vendor and both INSERV and SP as the default products.
Usage Warning
Many efforts were made to try and prevent search requests from running amok.
However, not every conceivable combination is addressed.
So, please be mindful of your requests… depending on what you specify your search request may take some time to
process and may return a lot of data!
Downloading
As of V3.0180, when actually downloading the contents of a file object to your system into a file, if you do not use –
outdir to specify a directory location, the contents will be written to a file in your current working directory. So, please
be mindful of your disk space usage and clean up after yourself. If disk space utilization becomes an issue due to a lack
of respect, the pre-V3.0180 behavior will be re-implemented.
Time Zone Considerations

Since S3MFT does not look at “time” related data in the contents, it is only concerned with “time” when searching for
file objects. Several users have reported a minor problem when conducting searches using “-sfdt” and not specifying “-
efdt”. The problem relates to how the default value for “-efdt” is calculated, which nothing more than default to the
current date and time that S3MFT is executed on your current system. The problem observed when executing the same
command on two (2) different systems that are in two (2) different time zones, two different times are calculated for “-
efdt”, if “-efdt” is not provided. The differing “-efdt” times will result in generating almost identical lists, the problem is
one list may display more files than the other due to the different end times specified for the search. To avoid this issue
between machines please specify “-efdt” with a value large enough to cover the time zones differences between the
machines, usually “-efdt=tomorrow” or “-efdt=”+24h”” should work.
IMPORTANT NOTE:
Super, Really Important Time Zone Reminder!
As mentioned above, please keep in mind how buckets are populated… file objects are assigned to buckets based on
the time that the file objected is ingested into S3, again this ingestion time is UTC based. The ingestion time is also
referred to as the creation time.
As a result of having the creation time UTC based and the file object’s file name containing a date time based on the
array’s local time zone, some files are going to end up in a bucket not associated with the date time in the file object’s
file name. This is only problematic at the end of the month rolling over into the next month.
Therefore, if searching for data and/or files where the start and/or end date time may involve the last day or first day
of a month, please ensure your search request extends the start and/or end date time of the search, add an extra day,
accordingly!
11
12-Apr--2021
6. Command Line Options
S3MFT has a myriad of command line options that should address most of our needs.
The goal of this tool is to help you navigate AWS S3 and find the telemetry data you are searching for. Not only will
S3MFT help you find the data you seek, it will download the data and for data which is ASCII, S3MFT will display it to
your screen and provides the ability to search that data as well.
-a
Specifying -a, S3MFTwill search for the following file types:
alert, config, event, environ, fabric, hostconf, hwinvent, memlog,

perform, status
By default S3MFTwill search the following file types if no file types have been specified:
config, environ, hostconf, hwinvent
-ad | -noad
Controls the display of array details. -ad requires a serial number, thus will only work with -base, -n, -class or -model.
-af | -noaf
-af requires that -ad be specified and will provide additional information regarding "Cage Count" and "Features In Use".
-append[=]"<file-specification>"
Using -append requires the use of the -so switch. The append option
will take data from the buffer and append the data to the end of the specified file. -append and
-bdump are mutually exclusive.
-base "<tpd-version>"
Use -base_version to select arrays with the specified base version.
-bdump
The use of –bdump is restricted to processing a single file. Use –
bdump when processing binary data to STDOUT when redirecting and/or piping the data.
–bdump forces S3MFT to display all messages, error or otherwise to STDERR to prevent contamination of the binary
data being displayed to STDOUT.
-bucket "<bucket-name>"
To select a specific S3 bucket you will need to use -bucket. The bucket name has the format "stats-YYYY-MM"
-class|N "<class>"
Use -N or -class to look for data relating to a specific array class. Valid classes names are:
20000
9000
8000
7000
F
S
T
V
PRIMERA-MERLIN
PRIMERA-MINOTAUR
12
12-Apr--2021
-csv[=]["[d:<delimiter-string>][,[S|F|SF|FL|SFL]]
Using -csv is similar to -h, which is mutually exclusive, when searching data for strings via -text or -regex.
-csv formats the the output as "comma separated values", thus making the output better suited for
programmatic manipulations and/or database ingestions.
By default when -csv is specified with no options the prefix will have the format:
<serial-number>|<file-name>|<line-number>
Example:
s3mft -n 1234567 -filet config -csv -text "- showdate -" -stlatest
1234567|config.210304.231239.0001|294| ----- showdate -----
-csv will accept optional parameters as follows:
d:<delimiter-string>
allows the change of the default delimiter (vertical bar (|)) to an
ASCII string which does not contain letters, numbers or
non-printable characters.
s
the prefix will contain only the serial number
f
the prefix will contain only the "file" name
sf
the prefix will be composed of the serial number followed by the
"file" name
fl
the prefix will be composed of the "file" name followed by the
line number of the matching text
sfl
the prefix will be composed of the serial number then the "file"
name and lastly the line number of the matching text
-D <numeric-value>
-D is used to indicate how many of the most recent files to search through based on the time range provided.
"-D" is to be used with either the "-T" switch or the switches "-sfdt" and/or "-efdt".
NOTE: -D is only applicable for use with the “-m” or “-s” switches.
-dbg[=]<numeric-value>
-dbg is used to specify increased levels of logging. The larger the numeric value, the greater the verbosity.
Legal values for –dbg are zero (0) through two (2).
-dlmaxsize <numeric-value>
Use -dlmaxsize to control the files sizes being processed when using buffer operations like displaying data to STDOUT.
By default the dlmaxsize 1GB, the maximum allowed is 4GB.
13
12-Apr--2021
-dlqlen[=]<numeric-value>
-dlqlen represents the number of entries that will be allowed on the download worker queue from which the download
worker threads read.
-dlthreads[=]<numeric-value>
-dlthreads is used to specify the number of download workers, this represents the number of threads that will be
created to perform the retrieval of “file” data to be displayed, downloaded to disk, decompressed and searched.
-dx
-dx is to be used when you wish to have S3MFT decompress and/or extract data from various files that are sent
home as gzip, bzip2 and/or tar balls. Use –dx in conjunction with the –so or –fo switches.
When using –dx with –fo, the original file object will be downloaded to disk. S3MFT will then determine if the
file downloaded is in the gzip or bzip2 formats, if so S3MFT will then decompress the file to a possible
temporary file on disk. If the original file is a gzip file containing a file, then the “temporary” file will be that file and S3
MFT will not process the “temporary” file any further. Should the “temporary” file contain data indicating a tar ball, S3
MFT will then process the “temporary” file and extract the tar ball contents. If the original file is a tar ball, then S3MFT
will extract the contents of the tar ball. Should the original file not be a gzip, bzip2 or tar ball, S3MFT will do nothing
more with the file.
It is important to note that S3MFT will not decompress those files extracted from a tar ball that may be compressed
data.
When –dx and –

so are indicated, S3MFT does its work in memory rather than with temporary files. The same rules for decompression a
nd/or extraction still apply. The major difference being that should the final buffer be a file that is ASCII or binary, it will
be displayed to STDOUT. S3MFT will not display those files extracted from a tar ball to STDOUT.
When using –dx with –so, be mindful of the file object size and your memory.
-efdt "<datetime>"
Use -efdt to select files based on on the specified "end" date. S3MFT uses an inclusive compare between
the file's date the end date specified, the file's date must be less than or equal to the specified "end" date.
The file date is the file date specified in the file name, I.E -
If the file object is
3PAR.INSERV/SGH623YH3P/config/config.200617.051351.0001
then the file date is "200617.051351" and will be used in date comparison.
See below about date-time formats.
-fh
The -fh flag is to be used with the -filename switch when "file" header information is to be displayed prior to
"fetching" the file object.
-fhb
The -fhb flag is to be used with the -filename switch when brief "file" header information is to be displayed prior to
"fetching" the file object. Brief file header information consists of the bucket name, file name and the size of the file.
-fhbo
The -fhbo flag provides the same information as the –fhb switch, the difference being that the file will not be fetched!
14
12-Apr--2021
-fho
The -fho flag is to be used with the -filename switch when "file" header information is to be displayed only!
The file object will not be "fetched"!
-filename "<s3-filename>|@<filename>"
Use -filename to display the contents of a particular file. Use the filename that S3MFThas displayed. Enclose
<s3-filename> in quotation marks (").
Valid formats:
stats-2020-04|3PAR.INSERV/1202222/evtlog/evtstdErr.200401.031028.debug
3PAR.INSERV/1202222/evtlog/evtstdErr.200401.031028.debug (1)
evtstdErr.200401.031028.debug (1,2)
1 - -bucket is required to perform the data retrieval

2 - -n is required to perform the data retrieval
-filename will also accept as input a text file listing filenames, where each individual filename must appear as a
separate line in the text file. On the command line when specifying a text file as input, the file name must be preceded
by the at-sign (@) and the designation needs to be enclosed in quotation marks (“).
WARNING: S3MFTwill output file object less than 1MB to STDOUT regardless
of the file contents. This means you could output binary data to STDOUT!
Be very, very careful!
-filetype|p "<filetype[,filetype...]>"
Use -filetype to display specific file types, I.E. - config, insplore, etc. A list of file types may also be provided in a
comma separated list which needs to be enclosed in quotation marks(").
-fnp
Enable prefixing filenames with the string “array_<serial#>_” when downloading “files” to disk. The
serial number, “<serial#>” will be populated automatically.
-fo
Forces S3MFTto write fetched file contents to a file when -filename is specified. The filename used will
be that of the being fetched.
If -fo is used with various other switches that would display a list of files, S3MFTwill make an effort
to download those files it lists.
-G <numeric-value>
-G is used to indicate how many of the most recent files to search through based on the filetype or filetypes provided.
NOTE: -G is only applicable for use with the “-m” or “-s” switches.
-H
Use this flag to force the display of the standard showfield headers. Using the "-text" or "-regex" switches by
default will cause the standard showfield headers to not be displayed.
-h
This flag should be used to display a prefix which contains the serial number, the file name and line
number of the record that satisfyies the search via the "-text" or "-regex" switches.
15
12-Apr--2021
-i
This flag should be used when a case insensitive match is desired when using the "-text" or "-regex" switches.
-itgexclusive
Use –itgexclusive to restrict searches to the ITG bucket only.
-itginclusive
Use –itginclusive to include the ITG bucket in the list of buckets to search.
-jsoninit
Use –jsoninit to generate a new s3mft_init.json file in your home directory. The generated file will contain S3MFT
default values for the various options that users may define. Whenever –jsoninit is used any existing s3mft_init.json
file will be overwritten.
-listbuckets
The -listbuckets switch will display the available buckets within the HPE S3 environment.
-listfiletypes
The -listfiletypes switch will display the available file types within the HPE S3 environment.
-lstar
If using –dx, use –lstar to list the contents of any tar ball that may be present without extracting the
contents of that tar ball.
-m
list all the metric reported by the selected file type. –m requires either a serial number (-n) or a filename (-filename).
Note: -m and -s are mutually exclusive.
-model "<model>"
Use -model to select arrays of a specific model.
-mqqlen[=]<numeric-value>
-mqqlen represents the number of entries that will be allowed on the MONGODB Query (MQ) worker queue from which
the MQ worker threads read.
-mqthreads[=]<numeric-value>
-mqthreads is used to specify the number of MONGODB Query (MQ) workers, this represents the number of threads
that will be created to perform the database queries that will generate a list of “files” to be passed to the download
workers for processing.
-n "<array serial number| SP name>|@<filename>"

The -n switch is used to indicate an array serial number or SP name on which to search. -n will also accept as input
a text file listing filenames, where each individual filename must appear as a separate line in the text file. On the
command line when specifying a text file as input, the file name must be preceded by the at-sign (@) and the
designation needs to be enclosed in quotation marks (“).
-O
Use –O to disable the displaying of the “showfield” related headers when used in conjunction with –m, -s, -regex
or –text.
-outdir
By default S3MFTwill write any file content output files to the Current Working Directory. Use "-outdir" to specify
an alternate output directory.
16
12-Apr--2021
-psgenerate
Use -psgen when you need to generate a pre-signed URL to a document.
-psgexpire
By default a pre-signed URL has a time limit of 15 minutes, use –psgexpire to specify a different time limit
from 1 second to 7 days. You can use the following values:
daysend
tomorrow
+|-x[smhd] - Specify a delta of plus(+) or minus(-) X seconds(s) or minutes(m) or hours(h) or days(d)
-product[=]”<product>” (Being deprecated, unavailable after V5.0087)

By default, all searches will be made using the product of "INSERV". Valid product names (vendor):
INSERV (3PAR)
SP (3PAR)
SSC (3PAR)
RMCVSA (HP)
STOREALL (HP)
STOREONCE (HP)
STOREONCEVSA (HP)
STOREVIRTUAL (HP)
STANALYZE (ST)
-pullupdate
S3MFT will automatically check for newer versions of itself, however it will not automatically download the
zip file containing the newer version of S3MFT. Specify -pullupdate to have S3MFT download the zip file
containing the newer version of S3MFT should one exist. The zip file containing the newer version of
S3MFT will be downloaded and written to the user's home directory.
-quiet
Use -quiet to suppress the array/SP information output when a serial number has been specified with the -n switch.
-regex="<regex-expression>"
Will use regular expression pattern matching to search the records of the data indicated for a match,
if a match is found the record will be displayed. "-text" and "-regex" are mutually exclusive.
-S
Print site name if avaiable
-s "<metric-heading>"
Use -s to specify the search filter. Do not include spaces, use a period(.) to indicate a space,
I.E - If you are looking for "showpd -c", use showpd.-c for your search to workaround shell expansion
getting in the way. -s requires either a serial number (-n) or a filename (-filename).
Note: -s and -m are mutually exclusive.
17
12-Apr--2021
-sfdt "<datetime>"
Use -sfdt to select files based on on the specified "start" date. S3MFT uses an inclusive compare between
the file's date the start date specified, the file's date must be greater than or equal to the specified "start" date.
The file date is the file date specified in the file name, I.E -
If the file object is
3PAR.INSERV/SGH623YH3P/config/config.200617.051351.0001
then the file date is "200617.051351" and will be used in

date comparison.
See below about date-time formats.
-so
Forces S3MFTto write fetch file contents to STDOUT.
-sort[=][<sort-options>] | -unsort | -nosort

Use -sort when there is a need to have listings and/or output from s3mft to be ordered.
Use –unsort/-nosort when the order of the output is not a concern. -unsort will provide listings and/or
output faster than using -sort.
-sort cannot be used with –bdump or -dx.
-sort and –unsort/-nosort are mutually exclusive.
Listing and/or output will be displayed in sorted order by default if neither -sort or –unsort/-nosort is specified using
the default sort order.
By default -sort when specified without any options will sort output and/or listing in ascending serial number order
followed by ascending "file" name order.
The options that -sort accepts are as follows:
ascending
sort the listings/output with ascending serial
number order followed by ascending "file" name order.
descending
reverse
sort the listings/output with descending serial
number order followed by descending "file" name order.
[[ascending|descending|reverse]:serial[,[[ascending|descending|reverse]:file]]]
This option allows for the specification of different orders of the
serial number and "file" name.
If an order is not provided when serial and/or file are specified,

ascending is the default.
If you do not specify a "key" (file/serial) that omitted key will be

listed/outputted in random order.
18
12-Apr--2021
NOTE: depending on the query the serial number key may not apply.
This situation may occur when -base, -class, -model or -n are not
specified, in this situation only the file key is used.
-stall
Use –stall to locate the buckets that contain data for the serial number supplied. –stall requires a serial number and
does not allow any other switches other than –n. -stall is an attempt to emulate the “STALL” utility.
-stearliest
Use -stearliest to find the earliest version of a file type. The –stearliest switch may be combined with -class, -model, -
base_version, -filetype or -n (serial number).
-stlatest
Use -stlatest to find the latest version of a file type. The –stlatest switch may be combined with -class, -model, -
base_version, -filetype or -n (serial number).
-T "<YYMMDD>"
Use -T to search for files with the specified date in their name.
I.E. - 110404 look for the data recorded as of 2011.04.04
-text="<test-string>"
Will standard string pattern matching to search the records of the data indicated for a match, if a match is
found the record will be displayed. "-text" and "-regex" are mutually exclusive.
-tsubsearch=”<file-pattern-matching-string>”
-tsubsearch is very similar to the Linux tar command’s “—wildcards” search.
The purpose of –tsubsearch is to provide a means to search files from within a tar ball utilizing –text, -regex, -i, -v, -h.
–tsubsearch is the means to limit that search to specific files and not the contents of the entire tar ball.
-tsubsearch only works when using the –so and –dx switches.
A secondary benefit of –tsubsearch is, that if no pattern search criteria has been specified, the contents of those
files matching the –tsubsearch pattern will be displayed to STDOUT.
-v
Use this flag to display the non-matching records based on a search performed with either the
"-text" or "-regex" switches.
-vendor="<vendor>" (Being deprecated, unavailable after V5.0087)

By default, all searches will be made using the vendor "3PAR" and “HP”.
Valid vendor names:
3PAR
HP
ST
-version | V
Use -version to display the current version of S3MFT.
19
12-Apr--2021
-vp[=]”<vendor>:<product[,product…][;<vendor>:<product[,product…]…]>”
-vp replaces –vendor and –product in V5.0081 and forward.
With the –vp, S3MFT enforces that the correct products are associated with the correct vendor and visa-versa.
The current valid associations are as follows:
3PAR:INSERV,SP,SSC
HP: RMCVSA,STOREALL,STOREONCE,STOREONCEVSA,STOREVIRTUAL
ST:STANALYZE
-vp does allow for specifying multiple vendor/product combinations. –vp also allows for just specifying a
vendor and a single product.
-wide | -nowide
-wide broadens searching based on the filedatetime tag to include non-standard formatted filedatetime tags.
-wide may prove useful when searching for a "file" that has a file name that is non-standard.
-xn | -noxn
The –xn and –noxn, enable and disable, serial number translation respectively. S3MFT by default translates serial
numbers. The serial number translation is performed to ensure that if a HPE 10 character alphanumeric serial number
is provided, it is translated into its 7 digit array serial number so that data is retrieved correctly.
By default, -base, -class and –model will disable serial number translation, since these three (3) switches already
perform the database look ups and thus use the correct serial number.
If the user has confidence in the serial numbers they are specifying, they may disable serial number translations
(-noxn) and gain a potential performance boost.
20
12-Apr--2021
NOTES:
S3MFTrequires that one of the following be specified on the command line:
-base
-class or -N
-model
-n
and a search option:
-m
-s
-regex
-text
DATE-TIME FORMATS:
S3MFTallows for the following specifications to be used with the

-start and -end switches:
+|-x[smhd] - Specify a delta of plus(+) or minus(-) X seconds(s) or

minutes(m) or hours(h) or days(d)
+|-[dd-]hh:mm[:ss] - Specify a plus(+) or minus(-) delta time comprised

of days(optional), hours, minutes and/or seconds.
bigbang - 1-Jan-1970 00:00:00

daysend - use the current date at 23:59:59
eosd - use the date from the start date-time specified and use 23:59:59
instead of the start time provided.
now - use the current date time
today - today's date at midnight (00:00:00)
tomorrow - tomorrow's date at midnight (00:00:00)
yesterday - yesterday's date at midnight (00:00:00)
hh:mm:ss - The specified time using the current date.
dd-mmm[-yy[yy]][-| ][hh:mm[:ss]]
ddMMMyy[yy][-| ][hh:mm:ss|hhmm[ss]]
YYYY-mm-dd [hh:mm:ss]
YYYYmmdd[-| ][hhmmss]
21
12-Apr--2021
7. Examples
s3mft -n 1642005 -s showpd.-c

2020/08/27 08:36:23 Defaulting "-G" to 1
Customer Info for 1642005 (windows)

Customer : Frigo Glass India Private Limited
Array Name : IDGUR3PAR
System Model : HP_3PAR 7200c (2 nodes)
Cage Count : 2
System Serial Number : 1642005
HPE 10 Digit SN : 7CE626P214
SysID : 42005
Build Number : 3.2.2.709
TPD Kernel Code : 3.2.2.709 (MU6)
Patches Installed : P99,P119,P131,P135,P137,P139,P149,P160,P162
Features In Use :
System: 1642005 Information as of: 08/26/20 17:52:12

Source: config.200826.175212.0001
----- showpd -c -----

-------- Normal Chunklets -------- ---- Spare Chunklets ----
- Used -- -------- Unused -------- - Used - ---- Unused ----
Id CagePos Type State Total OK Fail Free Uninit Unavail Fail OK Fail Free Uninit Fail
0 0:0:0 FC normal 546 340 0 115 0 0 0 0 0 91 0 0
1 0:1:0 FC normal 546 341 0 114 0 0 0 0 0 91 0 0
2 0:2:0 FC normal 546 342 0 113 0 0 0 0 0 91 0 0
3 0:3:0 FC normal 546 342 0 113 0 0 0 0 0 91 0 0
4 0:4:0 FC normal 546 339 0 116 0 0 0 0 0 91 0 0
5 0:5:0 FC normal 546 340 0 115 0 0 0 0 0 91 0 0
6 1:0:0 FC normal 546 340 0 115 0 0 0 0 0 91 0 0
7 1:1:0 FC normal 546 340 0 115 0 0 0 0 0 91 0 0
8 1:2:0 FC normal 546 342 0 113 0 0 0 0 0 91 0 0
9 1:3:0 FC normal 546 342 0 113 0 0 0 0 0 91 0 0
10 1:4:0 FC normal 546 339 0 116 0 0 0 0 0 91 0 0
11 1:5:0 FC normal 546 340 0 115 0 0 0 0 0 91 0 0
-----------------------------------------------------------------------------------------
12 total 6552 4087 0 1373 0 0 0 0 0 1092 0 0

Source: environ.200826.095042.0001

Source: hostconf.200826.095048.0001

Source: HWINVENT.200826.095050.0001
This example demonstrates a simple “showfield” request to display the output of “showpd –c” that resides in a
config telemetry data file for array 1642005. This example also demonstrates show to specify “commands” that
utilize switches, use a period (.) to indicate spaces.
22
12-Apr--2021
s3mft -a -n 1642005 -s statpd.-rw.-d.-iter
2020/08/27 08:38:35 Defaulting "-G" to 1

Cage Count : 2
SysID : 42005
Features In Use :

Source: alert.200817.025039.0001

Source: config.200826.175212.0001

Source: environ.200826.095042.0001

Source: event.200826.235456.1+405385


Source: perform.200826.222424.0001

Source: status.200826.175100.lite
This example demonstrates another “showfield” type request where “all” of the standard “showfield” file types are
searched per the –a switch. In this example there was no output found associated with the
command “statpd -rw -d -iter”.
23
12-Apr--2021
s3mft -n 1301946 -m –a
2020/08/27 08:50:09 Defaulting "-G" to 1

Cage Count : 2
SysID : 42005
Features In Use :

Source: alert.200817.025039.0001
Metric collected for: alert.200817.025039.0001

showdate
showalert -oneline
showalert -d new
showalert -d ack'd
showalert -d fixed

Source: config.200826.175212.0001
Metric collected for: config.200826.175212.0001

controlencryption status
controlrecoveryauth status
servicenode status
showauthparam
showbattery
showcim
showdate
showdomain -d
showflashcache
showhost -chap
showhost -d
showiscsisession
showlicense
shownet
shownet -d
shownode -d
shownode -i
shownode -verbose
showpeer
showport
showport -c
showport -i
showport -iscsi
showport -iscsiname
showport -par
showport -rc
showport -rcip
showport -sfp
showport -sfp -d
showport -sfp -ddm
showportarp
showportisns
showrcopy -d
showrcopy -qw targets
showsched -all
24
12-Apr--2021
showsnmpmgr
showsr
showsralertcrit
showsys -d
showsys -param
showsys -space
showsysmgr
showsysmgr -l
showtask -t 4
showtoc
showversion -b -a
showwsapi
showportdev for target ports
showportdev all 0:1:1
showportdev ns 0:1:1
showcage -d
showcage -sfp
showcage -sfp -d
showcage -sfp -ddm
showpd
showpd -c
showpd -i
showpd -s
showcpg
showcpg -r
showcpg -sag
showcpg -sdg
showcpg -space
showdomainset
showfed
showflashcache -vvset *
showhostset
showld
showld -d
showinventory -svc
showqos
showspace
showspace -cpg *
showspace -p -devtype NL
showtemplate
showvasa
showvlun
showvv
showvv -allkeys
showvv -d
showvv -p -prov dds
showvv -pol
showvv -r
showvv -s
showvv -showcols Name,Comment
showvvcpg
showvvolsc
showvvset

Source: environ.200826.095042.0001
Metric collected for: environ.200826.095042.0001

showdate
showversion
showbattery
showbattery -d
25
12-Apr--2021
showbattery -log
showfirmwaredb
shownodeenv

Source: event.200826.235456.1+405385
Metric collected for: event.200826.235456.1+405385

ANALYSIS RESULTS

Metric collected for: hostconf.200826.095048.0001

showdate
showversion
showhost -agent
showhost -agent -d
showhost -pathsum
showvlun -pathsum
showhost -agent
showhost -agent -d
showhost -pathsum
showvlun -pathsum
Send FTP request

Source: perform.200826.222424.0001
Metric collected for: perform.200826.222424.0001

showdate
showversion
showsys
statcpu -t -d -iter
statcmp -d -iter
statcmp -shared -d -iter
statcache -d -iter
statpd -rw -devinfo -d -iter
statport -rw -d -iter
statport -host -rw -d -iter
statport -disk -rw -d -iter
statport -rcip -rw -d -iter
statport -rcfc -rw -d -iter
statrcopy -d -iter
statvlun -rw -d -iter -vvsum
statvlun -ni -hostsum -iter
statvv -rw -d -iter
statrcvv -d -iter -vvsum
histpd -begin -ni -devinfo -rw -metric size -sizecols 0 15
histpd -begin -ni -devinfo -rw -metric time -timecols 3 23
histport -begin -ni -rw -metric size -sizecols 0 15
histport -begin -ni -rw -metric time -timecols 3 23
histport -ctl -metric time -timecols 3 23 -begin -iter 1
histvlun -begin -ni -rw -metric size -sizecols 0 15 -vvsum
histvlun -begin -ni -rw -metric time -timecols 3 23 -vvsum
histld -begin -ni -rw -metric size -sizecols 0 15
histld -begin -ni -rw -metric time -timecols 3 23
srrgiodensity -cmult 2 -btsecs -14400 -rw -cpg AOCFG
srrgiodensity -cmult 2 -btsecs -86400 -rw -cpg AOCFG

Source: status.200826.175100.lite
Metric collected for: status.200826.175100.lite
Another “showfield” style example that displays all of the “metric” headings available within each of the “showfield”
file types as a result of the –a switch.
26
12-Apr--2021
27
12-Apr--2021
s3mft -n 1642005 -T 200811 -p config -s showvv
2020/08/27 08:55:14 Defaulting "-G" to 1

Cage Count : 2
SysID : 42005
Features In Use :

Source: config.200811.161529.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
Id Name Domain Prov Type CopyOf BsId Rd -Detailed_State- Adm Snp Usr VSize
1 .srdata - full base --- 1 RW normal 0 0 61440 61440
0 admin - full base --- 0 RW normal 0 0 10240 10240
3 ERPLN-8G-ORAREDO - tpvv base --- 3 RW normal 256 0 1536 8192
4 ERPLN-8G-ORAREDO1 - tpvv base --- 4 RW normal 256 0 1536 8192
5 ERPLN-50G-KIT - tpvv base --- 5 RW normal 256 0 36352 51200
6 ERPLN-50G-ORACLE - tpvv base --- 6 RW normal 256 0 15872 51200
2 ERPLN-100G-ORAARCH - tpvv base --- 2 RW normal 256 0 102912 102400
7 ERPLN-140G-ERPLN - tpvv base --- 7 RW normal 384 0 143872 143360
8 ERPLN-1500G-ORADATA - tpvv base --- 8 RW normal 1152 0 1448448 1536000
9 ERPLN-1500G-ORAINDEXES - tpvv base --- 9 RW normal 1152 0 1449344 1536000
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224
This “showfield” style example demonstrates the ability to specify a single, particular file type to select and to
select that file such that it is from 11-Aug-2020.
28
12-Apr--2021
s3mft -n 1642005 -sfdt 7-aug -efdt 11-aug -p config -s showvv
2020/08/27 09:02:01 Defaulting "-G" to 1
2020/08/27 09:02:01 Start Time: 07-Aug-2020 00:00:00
2020/08/27 09:02:01 End Time: 11-Aug-2020 00:00:00

Cage Count : 2
SysID : 42005
Features In Use :

Source: config.200810.161531.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224
This example demonstrates the use of date selections of a particular file type to display “showvv” data pertaining to a
particular time frame.
29
12-Apr--2021
s3mft -n 1642005 -sfdt 7-aug -efdt 11-aug -p config -s showvv -G 2
2020/08/27 09:06:32 Start Time: 07-Aug-2020 00:00:00
2020/08/27 09:06:32 End Time: 11-Aug-2020 00:00:00

Cage Count : 2
SysID : 42005
Features In Use :

Source: config.200810.081530.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224

Source: config.200810.161531.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224
This is a continuation of the previous example to demonstrate the use of the –G switch which is used to group files
based on file types and provide the latest number of files as dictated by the value of –G.
30
12-Apr--2021
s3mft -n 1642005 -sfdt 7-aug -efdt 11-aug -p config -s showvv -D 2
2020/08/27 09:12:40 Start Time: 07-Aug-2020 00:00:00
2020/08/27 09:12:40 End Time: 11-Aug-2020 00:00:00

Cage Count : 2
SysID : 42005
Features In Use :

Source: config.200807.081531.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224

Source: config.200807.161527.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224

Source: config.200808.081529.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
31
12-Apr--2021
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224

Source: config.200808.161530.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224

Source: config.200809.081529.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224

Source: config.200809.161531.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224

Source: config.200810.081530.0001
32
12-Apr--2021
----- showvv -----
----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224

Source: config.200810.161531.0001
----- showvv -----

----Rsvd(MB)---- -(MB)--
---------------------------------------------------------------------------------------------------
10 total 3968 0 3271552 3508224
The –D switch groups the files based on date, not date-time just date, compared to the –G switch which groups of file
types.
33
12-Apr--2021
s3mft -n 1642005 -stlatest
stats-2020-08|3PAR.INSERV/1642005/alert/alert.200817.025039.0001
stats-2020-08|3PAR.INSERV/1642005/biosmsg/biosmsg.200823.095046.0001
stats-2020-08|3PAR.INSERV/1642005/chkupg/CHKUPG.200826.095037.0001
stats-2020-08|3PAR.INSERV/1642005/config/config.200826.175212.0001
stats-2020-05|3PAR.INSERV/1642005/crashdmp/crashdmp.200517.190944.80057547
stats-2020-05|3PAR.INSERV/1642005/crashtxt/crashtxt.200517.190250.96979063
stats-2020-08|3PAR.INSERV/1642005/eeprom/eeprom.200823.095044.0001
stats-2020-08|3PAR.INSERV/1642005/environ/environ.200826.095042.0001
stats-2020-08|3PAR.INSERV/1642005/event/event.200827.075406.1+418222
stats-2020-08|3PAR.INSERV/1642005/evtlog/evtlog.200827.075040.debug
stats-2020-08|3PAR.INSERV/1642005/hostconf/hostconf.200826.095048.0001
stats-2020-08|3PAR.INSERV/1642005/hwinvent/HWINVENT.200826.095050.0001
stats-2020-08|3PAR.INSERV/1642005/memdata/memdata.200826.095040.0001
stats-2020-08|3PAR.INSERV/1642005/perform/perform.200827.022423.0001
stats-2020-08|3PAR.INSERV/1642005/srhires/srhires.200827.075406.1-000258
stats-2020-08|3PAR.INSERV/1642005/status/status.200827.075055.lite
stats-2020-08|3PAR.INSERV/1642005/vmcollec/vmcollec.200826.095039.74284850
This example diplays the latest available version of each file type.
s3mft -n 1642005 -stlatest -filetype alert,config

This example is very similar to the previous example except it demonstrates using –filetype to limit the search to the
listed specific file types.
34
12-Apr--2021
s3mft -n 1642005 -filetype staus,config -sfdt="-7d"
2020/08/27 09:31:48 Start Time: 20-Aug-2020 09:31:48
2020/08/27 09:31:48 End Time: 27-Aug-2020 09:31:48
Displays the status and config files for the array 1642005 that cover the last seven (7) days.
35
12-Apr--2021
s3mft -product SP -sfdt="-7d"
This example will produce a very large amount of data!

S3MFT will produce a list of files that represent every SP that is sending back telemetry data. Furthermore, this list will
contain every file type from that SP that has been created in the last seven (7) days.
This is the beginning snippet of that data:
2020/08/27 09:39:56 Start Time: 20-Aug-2020 09:39:56

2020/08/27 09:39:56 End Time: 27-Aug-2020 09:39:56
stats-2020-08|3PAR.SP/SP0001685438/spwdlog/SPWDLOG.200820.093957.10020999
stats-2020-08|3PAR.SP/SP0001649784/splog/SPLOG.200820.093958.2363
stats-2020-08|3PAR.SP/SP2MK8330038/notify/notify.200820.093959.s-000012
stats-2020-08|3PAR.SP/SP2MK8330038/notify/notify.200820.093959.s-000011
stats-2020-08|3PAR.SP/SPSGH615W9V0/spwdlog/SPWDLOG.200820.093959.19936286
stats-2020-08|3PAR.SP/SP0001637321/props/PROPS.200820.094001.20206886
stats-2020-08|3PAR.SP/SP5PUM0-5MUSH-330JG-3BB0J-THD7K/notify/notify.200820.094001.s-000015
stats-2020-08|3PAR.SP/SP0001639589/notify/NOTIFY.200820.094001.10296519
stats-2020-08|3PAR.SP/SPMXN71539MV/props/PROPS.200820.094002.14391285
stats-2020-08|3PAR.SP/SP6QJUF-8GEKM-B8LES-JSKJB-PD4FX/splor/splor.200820.094003.73153132
stats-2020-08|3PAR.SP/SP5PUM0-5MUSH-330JG-3BB0J-THD7K/spconfig/spconfig.200820.094003.0001
stats-2020-08|3PAR.SP/SP5EVHU-AMWFQ-V9WU5-7DK4R-EL2S2/splor/splor.200820.094003.11326182
stats-2020-08|3PAR.SP/SPMXN7173AL0/spconfig/spconfig.200820.094004.0001
stats-2020-08|3PAR.SP/SPCZ37202NAW/spconfig/spconfig.200820.094004.0001
stats-2020-08|3PAR.SP/SP0001635690/spconfig/spconfig.200820.094005.0001
stats-2020-08|3PAR.SP/SP2M264500KW/spconfig/spconfig.200820.094005.0001
stats-2020-08|3PAR.SP/SP0SV4O-CXS2O-TYE9J-90TGB-CRAUD/notify/notify.200820.094006.s-002650
stats-2020-08|3PAR.SP/SP40PG0-T8VGM-S01HA-Q4OPW-Q60L7/splor/splor.200820.094009.59775650
stats-2020-08|3PAR.SP/SP2MS919A0HT/spconfig/spconfig.200820.094010.0001
stats-2020-08|3PAR.SP/SP0001645729/splor/splor.200820.094010.43112293
stats-2020-08|3PAR.SP/SPSGH636WX02/splor/splor.200820.094017.2766986
stats-2020-08|3PAR.SP/SP0001639589/spchkhlth/SPCHKHLTH.200820.094021.19413904
stats-2020-08|3PAR.SP/SPCZ38298N0B/spconfig/spconfig.200820.094022.0001
stats-2020-08|3PAR.SP/SPMXN60529LX/splor/splor.200820.094023.34273146
stats-2020-08|3PAR.SP/SP8SDDS-6N99L-0I9V8-VSERI-IX4RG/spconfig/spconfig.200820.094027.0001
stats-2020-08|3PAR.SP/SP9ZVOB-3SJ4V-E11MO-X042R-8GFRP/spconfig/spconfig.200820.094030.0001
stats-2020-08|3PAR.SP/SPBQ22I-01ZRB-09SJW-KKQRG-PZ96J/spconfig/spconfig.200820.094032.0001
stats-2020-08|3PAR.SP/SPCZ36177PTJ/spconfig/spconfig.200820.094033.0001
stats-2020-08|3PAR.SP/SPMXN6112CCR/notify/NOTIFY.200820.094034.20396639
stats-2020-08|3PAR.SP/SPSGH613XSKE/splog/SPLOG.200820.094037.24105
stats-2020-08|3PAR.SP/SP1X0QV-BV8HO-4MUNK-IQY5T-UPSR1/spconfig/spconfig.200820.094038.0001
stats-2020-08|3PAR.SP/SP0001625234/notify/notify.200820.094040.s-000530
stats-2020-08|3PAR.SP/SPSGH708YBY6/notify/notify.200820.094042.s-000766
.
.
.
36
12-Apr--2021
s3mft -class 9000 -stlatest -filetype config
stats-2020-08|3PAR.INSERV/2M20010LNW/config/config.200827.084350.0001
stats-2020-08|3PAR.INSERV/2M2002032L/config/config.200827.083310.0001
stats-2020-08|3PAR.INSERV/2M2002032P/config/config.200827.070846.0001
stats-2020-08|3PAR.INSERV/2M200609GM/config/config.200827.093624.0001
stats-2020-08|3PAR.INSERV/2M2007035K/config/config.200827.110548.0001
stats-2020-08|3PAR.INSERV/2M200709BG/config/config.200827.080541.0001
stats-2020-08|3PAR.INSERV/SGH920XV0D/config/config.200827.191335.0001
.
.
.
stats-2020-08|3PAR.INSERV/SGH921YXS2/config/config.200827.154001.0001
stats-2020-08|3PAR.INSERV/SGH922SLC5/config/config.200827.180337.0001
stats-2020-08|3PAR.INSERV/SGH924TXWJ/config/config.200827.085400.0001
stats-2020-08|3PAR.INSERV/SGH925VFWT/config/config.200827.183508.0001
stats-2020-08|3PAR.INSERV/SGH927X7N0/config/config.200827.201556.0001
stats-2020-08|3PAR.INSERV/SGH929YHR2/config/config.200827.231114.0001
stats-2020-08|3PAR.INSERV/SGH932TWMP/config/config.200827.160121.0001
stats-2020-08|3PAR.INSERV/SGH932TWMQ/config/config.200827.072435.0001
stats-2020-08|3PAR.INSERV/SGH938SKY6/config/config.200827.224749.0001
stats-2020-08|3PAR.INSERV/SGH938STD5/config/config.200827.203457.0001
stats-2020-08|3PAR.INSERV/SGH941W6S7/config/config.200827.180404.0001
stats-2020-08|3PAR.INSERV/SGH943XQQG/config/config.200827.142932.0001
stats-2020-08|3PAR.INSERV/SGH946T1C6/config/config.200827.175215.0001
stats-2020-08|3PAR.INSERV/SGH949WFRW/config/config.200827.210250.0001
stats-2020-08|3PAR.INSERV/SGH949WG3C/config/config.200827.164434.0001
stats-2020-08|3PAR.INSERV/SGH949WG3D/config/config.200827.173901.0001
stats-2020-07|3PAR.INSERV/USE733DACJ/config/config.200710.200232.0001
This example demonstrates looking for the latest config file types for all arrays that are 9000 class arrays.
Be aware that this example and the previous SP example have the potential and do produce a large volume of data.
These types of searches also have the potential of taking some time longer to process compared to other searches.
37
12-Apr--2021
s3mft -n CZ3813VV23 -filetype evtlog -sfdt="24-aug" -text "hw_ps"
2020/08/27 09:53:58 Start Time: 24-Aug-2020 00:00:00

2020/08/27 09:53:58 End Time: 27-Aug-2020 09:53:58
Customer Info for CZ3813VV23 (windows)

Customer : UniversitÃ¤re Psychiatrische
Array Name : STO3PAR03
System Model : HPE_3PAR 8200 (2 nodes)
Cage Count : 6
System Serial Number : CZ3813VV23
HPE 10 Digit SN : CZ3813VV23
SysID : 0x20BA9
Patches Installed : P32,P36,P39,P40,P45,P51,P52,P76,P90,P93,P96,P111,P113,P115,P127
Features In Use : Dedupe, Deco, RC-Sync
2020-08-24 05:15:09.69 CEST 0 1695641127 Internal Communication Degraded Power Supply AC Status
hw_node:0,hw_ps:0 General Node 0 Power Supply 0 AC FAIL.
2020-08-24 05:15:09.69 CEST 0 1695641128 Internal Communication Degraded Power Supply AC Status
hw_node:0,hw_ps:1 General Node 0 Power Supply 1 AC FAIL.
2020-08-24 05:15:09.69 CEST 0 1695641129 Alert,Status change Major Component state change
hw_node:0,hw_ps:0 Hardware check Node 0, Power Supply 0 Failed (AC Failed {0x2})
2020-08-24 05:15:09.69 CEST 0 1695641133 Alert,Status change Major Component state change
hw_node:0,hw_ps:1 Hardware check Node 0, Power Supply 1 Failed (AC Failed {0x2})
2020-08-24 07:30:08.82 CEST 0 17 Notification Informational Power Supply Oscillating AC Failure clear
hw_ps:0 General Node 0 PS 0: Oscillating AC Failure errors have been cleared
2020-08-24 07:30:57.68 CEST 0 1546 Notification Minor Power Supply FW Revision hw_node:0,hw_ps:0
General Auto-resolve NEMOE event by Sysmgr at INIT
2020-08-24 07:30:57.68 CEST 0 1548 Notification Minor Power Supply Fan Fail Status
hw_node:0,hw_ps:0 General Auto-resolve NEMOE event by Sysmgr at INIT
2020-08-24 07:30:57.68 CEST 0 1550 Notification Minor Power Supply Removed hw_node:0,hw_ps:0
2020-08-24 07:30:57.68 CEST 0 1552 Notification Minor Power Supply Status hw_node:0,hw_ps:0
2020-08-24 07:30:57.68 CEST 0 1554 Notification Minor Power Supply Switched Off
2020-08-24 07:30:57.68 CEST 0 1556 Notification Minor Power Supply DC Status hw_node:0,hw_ps:0
2020-08-24 07:30:57.68 CEST 0 1558 Notification Minor Power Supply AC Status hw_node:0,hw_ps:0
2020-08-24 07:30:57.68 CEST 0 1560 Notification Minor Power Supply Overvoltage hw_node:0,hw_ps:0
2020-08-24 07:30:57.68 CEST 0 1562 Notification Minor Power Supply Undervoltage
2020-08-24 07:30:57.68 CEST 0 1564 Notification Minor Power Supply Overcurrent hw_node:0,hw_ps:0
38
12-Apr--2021
2020-08-24 07:30:57.68 CEST 0 1566 Notification Minor Power Supply Overtemp hw_node:0,hw_ps:0
2020-08-24 07:30:57.68 CEST 0 1568 Notification Minor Power Supply Disabled by MCU
2020-08-24 07:30:57.68 CEST 0 1570 Notification Minor Power Supply Asserted Alert
2020-08-24 07:30:57.68 CEST 0 1572 Notification Minor Power Supply I2C Failed hw_node:0,hw_ps:0
2020-08-24 07:31:15.96 CEST 0 4021 Status change Informational Component state change hw_node:0,hw_ps:0
General Node 0, Power Supply 0 Normal
39
12-Apr--2021
Here we demonstrate looking for specific file type starting on a particular date and then searching these files for a
particular string. Should that string be found, the record is displayed.
40
12-Apr--2021
s3mft -filetype crashtxt,apptxt -sfdt="-1d"
2020/08/27 10:01:06 Start Time: 26-Aug-2020 10:01:06
2020/08/27 10:01:06 End Time: 27-Aug-2020 10:01:06
stats-2020-08|3PAR.INSERV/CZ29500FSX/apptxt/apptxt.200826.133756.0630
stats-2020-08|3PAR.INSERV/4UW0002942/apptxt/apptxt.200827.013152.2522
stats-2020-08|3PAR.INSERV/CZ3629F6F5/crashtxt/crashtxt.200827.055219.47857009
stats-2020-08|3PAR.INSERV/CZ20040GRB/crashtxt/crashtxt.200827.084017.4463
s3mft -filename "stats-2020-08|3PAR.INSERV/CZ20040GRB/crashtxt/crashtxt.200827.084017.4463" -

regex "DATE|NODE|PANIC" -h
Customer Info for CZ20040GRB (windows)

Customer : Hutchison Drei Austria GmbH
Array Name : av1x071p
System Model : HPE_3PAR A670 (4 nodes)
Cage Count : 4
System Serial Number : CZ20040GRB
HPE 10 Digit SN : CZ20040GRB
SysID : 0x256B3
TPD Kernel Code : 4.0.1.3
Patches Installed : 3,2
Features In Use : Deco
CZ20040GRB->crashtxt.200827.084017.4463@31: DATE: Wed Aug 26 16:46:13 2020

CZ20040GRB->crashtxt.200827.084017.4463@35: NODENAME: CZ20040GRB-3
CZ20040GRB->crashtxt.200827.084017.4463@40: PANIC: "Fatal exception"
s3mft -filename "stats-2020-08|3PAR.INSERV/CZ20040GRB/crashtxt/crashtxt.200827.084017.4463" -so
The first example on this page is very similar to previous examples where one is looking for specific file types within a
specific time range. We use the list of files to locate a specific file of interest. The second example on this page
demonstrates the ability of S3MFT to look at a single specific file and perform an “egrep” type search on the data within
the file. The –h switch tells S3MFT to prefix the matching record with the array serial number, the name of the file and
the line number of the matching record. The last command, will display the specified files content to the screen and if
there was a need to download it onto the system from whence the command was issued, change –so to –fo.
41
12-Apr--2021
s3mft -vp="3PAR:SP;HP:STOREONCE" -sfdt="-15s"
stats-2021-04|3PAR.SP/22720/props/PROPS.210408.093501.14492796
stats-2021-04|3PAR.SP/2MT850A5LSSP/spconfig/spconfig.210408.081549.0001
stats-2021-04|3PAR.SP/CZ3627D1BE/props/PROPS.210408.142202.77798507
stats-2021-04|3PAR.SP/SEGI3PAR01SP/spconfig/spconfig.210408.123729.0001
stats-2021-04|3PAR.SP/SEGI3PAR02SP/spconfig/spconfig.210408.141705.0001
stats-2021-04|3PAR.SP/SP0001408519/spchkhlth/SPCHKHLTH.210408.141441.21467148
.
.
.
stats-2021-04|HP.STOREONCE/USE705CX01/config/config.210408.082644.0704.tarbz2
stats-2021-04|HP.STOREONCE/USE7099601/config/config.210408.081904.0007.tarbz2
stats-2021-04|HP.STOREONCE/USE7099801/config/config.210408.081742.0007.tarbz2
stats-2021-04|HP.STOREONCE/USE710B801/event/event.210408.082729.1446
stats-2021-04|HP.STOREONCE/USE710B801/event/event.210408.082846.1447
stats-2021-04|HP.STOREONCE/USE710B801/eventlog/Eventlog.210408.083445.0943.tar
stats-2021-04|HP.STOREONCE/USE712DJ01/config/config.210408.100916.1890.tarbz2
stats-2021-04|HP.STOREONCE/USE712DL01/config/config.210408.085719.0105.tarbz2
stats-2021-04|HP.STOREONCE/USE712DN01/config/config.210408.084111.0105.tarbz2
stats-2021-04|HP.STOREONCE/USE713C401/config/config.210408.082853.0711.tarbz2
stats-2021-04|HP.STOREONCE/USE713DW01/config/config.210408.092548.0742.tarbz2
stats-2021-04|HP.STOREONCE/USE714CG01/event/event.210408.080058.0007
stats-2021-04|HP.STOREONCE/USE714CG01/eventlog/Eventlog.210408.080459.0007.tar
stats-2021-04|HP.STOREONCE/USE715D701/config/config.210408.114708.1009.tarbz2
stats-2021-04|HP.STOREONCE/USE716DB01/config/config.210408.084007.0444.tarbz2
stats-2021-04|HP.STOREONCE/USE716DV01/config/config.210408.092530.0565.tarbz2
stats-2021-04|HP.STOREONCE/USE717C001/config/config.210408.084637.0270.tarbz2
stats-2021-04|HP.STOREONCE/USE717CA01/config/config.210408.110857.0822.tarbz2
stats-2021-04|HP.STOREONCE/USE717DY01/config/config.210408.135403.0385.tarbz2
stats-2021-04|HP.STOREONCE/USE717FD01/config/config.210408.092033.0129.tarbz2
.
.
.
This example demonstrates the use of the new, as of V5.0081, “-vp” switch. In this example the request was made to
look for any file objects with a file date-time tag since 15 minutes ago and had the vendor-product tags of 3PAR and SP
or HP and STOREONCE.
42
12-Apr--2021
s3mft -n SGH837WTNL -filet config -s "showport(\s*\-?[dsf]+\w*\s*\-?\w*)?"
System: SGH837WTNL Information as of: 04/08/21 23:06:15 CST
Source: config.210408.230615.0001
----- showport -----

N:S:P Mode State ----Node_WWN---- -Port_WWN/HW_Addr- Type Protocol Label Partner FailoverState
0:1:1 initiator ready 50002ACFF702203A 50002AC01102203A disk SAS DP-1 - -
0:1:2 initiator loss_sync 50002ACFF702203A 50002AC01202203A free SAS DP-2 - -
0:4:1 target ready 2FF70002AC02203A 20410002AC02203A host FC - 1:4:1 none
0:4:3 target loss_sync 2FF70002AC02203A 20430002AC02203A free FC - 1:4:3 none
0:9:1 peer offline - 480FCFA2C619 free IP IP0 - -
1:9:1 peer offline - 480FCFA2C459 free IP IP1 - -
-------------------------------------------------------------------------------------------------------
34
----- showport -sfp -----

N:S:P -State- -Manufacturer-- MaxSpeed(Gbps) TXDisable TXFault RXLoss DDM
0:1:1 OK HEWLETT-PACKARD 0.0 No No No No
0:4:1 OK HP-F 14.0 No No No Yes
0:4:3 OK HP-F 14.0 No No Yes Yes
0:9:1 OK FINISAR CORP. 10.3 No No No Yes
1:9:1 OK FINISAR CORP. 10.3 No No No Yes
-------------------------------------------------------------------------
26
----- showport -sfp -d -----

43
12-Apr--2021
------------Port 0:1:1------------
N:S:P : 0:1:1
State : OK
Manufacturer : HEWLETT-PACKARD
Part Number : 691970-003
Serial Number : APF18280035V81
Revision : G
MaxSpeed(Gbps) : 0.0
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : No
------------Port 0:1:3------------
N:S:P : 0:1:3
State : OK
Serial Number : APF18290036U1F
Revision : G
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : No
------------Port 0:2:1------------
N:S:P : 0:2:1
State : OK
Serial Number : APF18290036TT1
Revision : G
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : No
------------Port 0:2:3------------
N:S:P : 0:2:3
State : OK
Serial Number : APF18280035RD7
Revision : G
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : No
---------Port 0:4:1----------
N:S:P : 0:4:1
State : OK
Manufacturer : HP-F
Part Number : E7Y10A
Serial Number : MY8817026J
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
---------Port 0:4:2----------
N:S:P : 0:4:2
44
12-Apr--2021
State : OK
Manufacturer : HP-F
Serial Number : MY8817026G
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
---------Port 0:4:3----------
N:S:P : 0:4:3
State : OK
Manufacturer : HP-F
Serial Number : MY8817026K
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : Yes
RX Power Low : No
DDM Support : Yes
---------Port 0:4:4----------
N:S:P : 0:4:4
State : OK
Manufacturer : HP-F
Serial Number : MY8817026B
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : Yes
RX Power Low : No
DDM Support : Yes
---------Port 0:5:1----------
N:S:P : 0:5:1
State : OK
Manufacturer : HP-F
Serial Number : MY881706TA
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
---------Port 0:5:2----------
N:S:P : 0:5:2
State : OK
Manufacturer : HP-F
Serial Number : MY881706T0
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
---------Port 0:5:3----------
N:S:P : 0:5:3
State : OK
Manufacturer : HP-F
45
12-Apr--2021
Serial Number : MY881706SH
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : Yes
RX Power Low : No
DDM Support : Yes
---------Port 0:5:4----------
N:S:P : 0:5:4
State : OK
Manufacturer : HP-F
Serial Number : MY881706UW
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : Yes
RX Power Low : No
DDM Support : Yes
------------Port 0:9:1-------------
N:S:P : 0:9:1
State : OK
Manufacturer : FINISAR CORP.
Part Number : FTLX8574D3BCL-HP
Serial Number : MY881603UM
Revision : B
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
------------Port 1:1:1------------
N:S:P : 1:1:1
State : OK
Serial Number : APF18290036U9M
Revision : G
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : No
------------Port 1:1:3------------
N:S:P : 1:1:3
State : OK
Serial Number : APF18290036U8A
Revision : G
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : No
------------Port 1:2:1------------
N:S:P : 1:2:1
State : OK
Serial Number : APF18290036U6F
46
12-Apr--2021
Revision : G
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : No
------------Port 1:2:3------------
N:S:P : 1:2:3
State : OK
Serial Number : APF18290036UH8
Revision : G
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : No
---------Port 1:4:1----------
N:S:P : 1:4:1
State : OK
Manufacturer : HP-F
Serial Number : MY881700Z3
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
---------Port 1:4:2----------
N:S:P : 1:4:2
State : OK
Manufacturer : HP-F
Serial Number : MY881700Z4
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
---------Port 1:4:3----------
N:S:P : 1:4:3
State : OK
Manufacturer : HP-F
Serial Number : MY881700ZL
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : Yes
RX Power Low : No
DDM Support : Yes
---------Port 1:4:4----------
N:S:P : 1:4:4
State : OK
Manufacturer : HP-F
Serial Number : MY881700YY
Revision : A
47
12-Apr--2021
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : Yes
RX Power Low : No
DDM Support : Yes
---------Port 1:5:1----------
N:S:P : 1:5:1
State : OK
Manufacturer : HP-F
Serial Number : MY881700ZW
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
---------Port 1:5:2----------
N:S:P : 1:5:2
State : OK
Manufacturer : HP-F
Serial Number : MY881700ZZ
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
---------Port 1:5:3----------
N:S:P : 1:5:3
State : OK
Manufacturer : HP-F
Serial Number : MY88170102
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : Yes
RX Power Low : No
DDM Support : Yes
---------Port 1:5:4----------
N:S:P : 1:5:4
State : OK
Manufacturer : HP-F
Serial Number : MY881700ZN
Revision : A
Qualified : Yes
TX Disable : No
TX Fault : No
RX Loss : Yes
RX Power Low : No
DDM Support : Yes
------------Port 1:9:1-------------
N:S:P : 1:9:1
State : OK
Manufacturer : FINISAR CORP.
Part Number : FTLX8574D3BCL-HP
Serial Number : MY88160160
Revision : B
Qualified : Yes
TX Disable : No
48
12-Apr--2021
TX Fault : No
RX Loss : No
RX Power Low : No
DDM Support : Yes
----- showport -sfp -ddm -----

--------------Port 0:4:1 DDM--------------
-Warning- --Alarm--
--Type-- Units Reading Low High Low High
Temp C 36 0 70 -5 75
Voltage mV 3367 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 484 158 794 125 1000
RX Power uW 524 15 1000 10 1258
--------------Port 0:4:2 DDM--------------

-Warning- --Alarm--
Temp C 39 0 70 -5 75
Voltage mV 3367 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 518 158 794 125 1000
RX Power uW 554 15 1000 10 1258
--------------Port 0:4:3 DDM--------------

-Warning- --Alarm--
Temp C 36 0 70 -5 75
Voltage mV 3339 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 494 158 794 125 1000
RX Power uW 2 15* 1000 10* 1258
--------------Port 0:4:4 DDM--------------

-Warning- --Alarm--
Temp C 35 0 70 -5 75
Voltage mV 3348 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 479 158 794 125 1000
RX Power uW 2 15* 1000 10* 1258
--------------Port 0:5:1 DDM--------------

-Warning- --Alarm--
Temp C 37 0 70 -5 75
Voltage mV 3383 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 504 158 794 125 1000
RX Power uW 680 15 1000 10 1258
--------------Port 0:5:2 DDM--------------

-Warning- --Alarm--
Temp C 37 0 70 -5 75
Voltage mV 3382 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 445 158 794 125 1000
RX Power uW 527 15 1000 10 1258
--------------Port 0:5:3 DDM--------------

-Warning- --Alarm--
Temp C 37 0 70 -5 75
Voltage mV 3346 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 472 158 794 125 1000
RX Power uW 2 15* 1000 10* 1258
--------------Port 0:5:4 DDM--------------

-Warning- --Alarm--
Temp C 39 0 70 -5 75
Voltage mV 3334 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 505 158 794 125 1000
RX Power uW 2 15* 1000 10* 1258
49
12-Apr--2021
-------------Port 0:9:1 DDM--------------
-Warning- -Alarm--
Temp C 26 -8 73 -13 78
Voltage mV 3 3 3 2 3
TX Bias mA 13 5 12 4 13
TX Power uW 0 0 0 0 1
RX Power uW 0 0 0 0 1
--------------Port 1:4:1 DDM--------------

-Warning- --Alarm--
Temp C 39 0 70 -5 75
Voltage mV 3341 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 503 158 794 125 1000
RX Power uW 592 15 1000 10 1258
--------------Port 1:4:2 DDM--------------

-Warning- --Alarm--
Temp C 42 0 70 -5 75
Voltage mV 3336 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 488 158 794 125 1000
RX Power uW 570 15 1000 10 1258
--------------Port 1:4:3 DDM--------------

-Warning- --Alarm--
Temp C 42 0 70 -5 75
Voltage mV 3324 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 476 158 794 125 1000
RX Power uW 2 15* 1000 10* 1258
--------------Port 1:4:4 DDM--------------

-Warning- --Alarm--
Temp C 39 0 70 -5 75
Voltage mV 3329 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 508 158 794 125 1000
RX Power uW 2 15* 1000 10* 1258
--------------Port 1:5:1 DDM--------------

-Warning- --Alarm--
Temp C 39 0 70 -5 75
Voltage mV 3338 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 497 158 794 125 1000
RX Power uW 579 15 1000 10 1258
--------------Port 1:5:2 DDM--------------

-Warning- --Alarm--
Temp C 40 0 70 -5 75
Voltage mV 3339 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 480 158 794 125 1000
RX Power uW 567 15 1000 10 1258
--------------Port 1:5:3 DDM--------------

-Warning- --Alarm--
Temp C 41 0 70 -5 75
Voltage mV 3300 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 222 158 794 125 1000
RX Power uW 2 15* 1000 10* 1258
--------------Port 1:5:4 DDM--------------

-Warning- --Alarm--
Temp C 43 0 70 -5 75
50
12-Apr--2021
Voltage mV 3329 3100 3500 3000 3600
TX Bias mA 7 2 11 1 12
TX Power uW 482 158 794 125 1000
RX Power uW 2 15* 1000 10* 1258
-------------Port 1:9:1 DDM--------------

-Warning- -Alarm--
Temp C 26 -8 73 -13 78
Voltage mV 3 3 3 2 3
TX Bias mA 13 5 12 4 13
TX Power uW 0 0 0 0 1
RX Power uW 0 0 0 0 1
----- showport -fs -----
File Persona is not active
The output for this example is very long, but it demonstrates the flexibility of using a regular expression to list metric
information from a config file object.
51
12-Apr--2021
8. Usage Comparisons
STLATEST vs S3MFT
STLATEST as you know it today…
cxo-datamine-04:~$ stlatest -n 1642005

/share/st704/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/alert/alert.200817.023741.0001
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/biosmsg/biosmsg.200823.095046.0001
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/chkupg/CHKUPG.200825.095053.0001
/share/st610/prod/data/files/3PAR.INSERV/TierTwo/2020-04/1642005/chkupg/CHKUPG.200417.033705.CKUP
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/config/config.200825.095217.0001
/share/st610/prod/data/files/3PAR.INSERV/TierTwo/2020-04/1642005/config/config.200417.032937.BAD
/share/st636/prod/data/files/3PAR.INSERV/TierTwo/2020-05/1642005/crashdmp/crashdmp.200517.190944.80057547
/share/st635/prod/data/files/3PAR.INSERV/TierTwo/2020-05/1642005/crashtxt/crashtxt.200517.190250.96979063
/share/st270/prod/data/files/3PAR.INSERV/TierTwo/2018-06/1642005/custdata/custdata.180617.134901.87804247
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/eeprom/eeprom.200823.095044.0001
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/environ/environ.200825.095043.0001
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/event/event.200825.115111.1+347746
/share/st534/prod/data/files/3PAR.INSERV/TierTwo/2020-
01/1642005/evtlog/evtlog.200106.160030.debug.SP0001642005.fbf02e
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/evtlog/evtlog.200825.115040.debug
/share/st371/prod/data/files/3PAR.INSERV/TierTwo/2019-04/1642005/evtlog/evtlog.190414.003853.swupd
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/hostconf/hostconf.200825.095049.0001
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/hwinvent/HWINVENT.200825.095053.0001
/share/st704/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/hwinvent/HWINVENT.200816.090701.BAD
/share/st607/prod/data/files/3PAR.INSERV/TierTwo/2020-04/1642005/insplore/insplore.200417.042100.34108472
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/memdata/memdata.200825.095049.0001
/share/st610/prod/data/files/3PAR.INSERV/TierTwo/2020-04/1642005/perfdb/perfdb.200417.033218.0001
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/perform/perform.200825.102427.0001
/share/st610/prod/data/files/3PAR.INSERV/TierTwo/2020-04/1642005/perform/perform.200417.033526.BAD
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/srhires/srhires.200825.115111.1-000214
/share/st462/prod/data/files/3PAR.INSERV/TierTwo/2019-
09/1642005/status/status.190918.113405.lite.SP0001642005.65b9b7
/share/st610/prod/data/files/3PAR.INSERV/TierTwo/2020-04/1642005/status/status.200417.033749.full
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/status/status.200824.215055.lite
/share/st610/prod/data/files/3PAR.INSERV/TierTwo/2020-04/1642005/sysinfof/sysinfof.200417.041457.0-000003
/share/st610/prod/data/files/3PAR.INSERV/TierTwo/2020-04/1642005/updatlog/updatlog.200417.033210.86062741
/share/st710/prod/data/files/3PAR.INSERV/TierTwo/2020-08/1642005/vmcollec/vmcollec.200825.095037.19745550
STLATEST via S3MFT…
>s3mft -n 1642005 -stlatest
stats-2020-08|3PAR.INSERV/1642005/biosmsg/biosmsg.200823.095046.0001
stats-2020-08|3PAR.INSERV/1642005/chkupg/CHKUPG.200825.095053.0001
stats-2020-05|3PAR.INSERV/1642005/crashdmp/crashdmp.200517.190944.80057547
stats-2020-08|3PAR.INSERV/1642005/eeprom/eeprom.200823.095044.0001
stats-2020-08|3PAR.INSERV/1642005/environ/environ.200825.095043.0001
stats-2020-08|3PAR.INSERV/1642005/event/event.200825.125142.1+349181
stats-2020-08|3PAR.INSERV/1642005/evtlog/evtlog.200825.125040.debug
stats-2020-08|3PAR.INSERV/1642005/hostconf/hostconf.200824.095049.0001
stats-2020-08|3PAR.INSERV/1642005/hwinvent/HWINVENT.200825.095053.0001
stats-2020-08|3PAR.INSERV/1642005/memdata/memdata.200825.095049.0001
stats-2020-08|3PAR.INSERV/1642005/perform/perform.200825.102427.0001
stats-2020-08|3PAR.INSERV/1642005/srhires/srhires.200825.115111.1-000214
stats-2020-08|3PAR.INSERV/1642005/vmcollec/vmcollec.200825.095037.19745550
The differences between these outputs are a result of S3MFT only returning the latest file based on file type and the
“file name” having the standard format. The standard format is a file name consisting of 4 parts:
1. File type
52
12-Apr--2021
2. Date – YYMMDD
3. Time – HHMMSS
4. Suffix
If the file name deviates from this format it will not be displayed. Secondly, S3MFT will not return file objects that have
the suffix of “BAD” or “CORRUPT”. Lastly, S3MFT does use a concept of sub-types based on the suffix field.
STALL vs S3MFT
STALL as you know it today…
$ stall -n 1642005
drwxr-xr-x+ 18 stapp csst 18 Feb 10 2017 /share/st137/prod/data/files/3PAR.INSERV/TierTwo/2017-02/1642005/
drwxr-xr-x+ 18 stapp csst 18 Feb 27 2017 /share/st142/prod/data/files/3PAR.INSERV/TierTwo/2017-02/1642005/
drwxr-xr-x+ 14 stapp csst 14 Mar 6 2017 /share/st142/prod/data/files/3PAR.INSERV/TierTwo/2017-03/1642005/
drwxr-xr-x+ 14 stapp csst 14 Mar 13 2017 /share/st146/prod/data/files/3PAR.INSERV/TierTwo/2017-03/1642005/
drwxr-xr-x+ 12 stapp csst 12 Apr 3 2017 /share/st149/prod/data/files/3PAR.INSERV/TierTwo/2017-03/1642005/
drwxr-xr-x+ 14 stapp csst 14 May 1 2017 /share/st151/prod/data/files/3PAR.INSERV/TierTwo/2017-05/1642005/
drwxr-xr-x+ 14 stapp csst 14 Jun 5 2017 /share/st160/prod/data/files/3PAR.INSERV/TierTwo/2017-06/1642005/
drwxr-xr-x+ 14 stapp csst 14 Jul 3 2017 /share/st167/prod/data/files/3PAR.INSERV/TierTwo/2017-07/1642005/
drwxr-xr-x+ 14 stapp csst 14 Aug 7 2017 /share/st175/prod/data/files/3PAR.INSERV/TierTwo/2017-08/1642005/
drwxr-xr-x+ 15 stapp csst 15 Sep 4 2017 /share/st183/prod/data/files/3PAR.INSERV/TierTwo/2017-09/1642005/
drwxr-xr-x+ 14 stapp csst 14 Oct 2 2017 /share/st189/prod/data/files/3PAR.INSERV/TierTwo/2017-10/1642005/
drwxr-xr-x+ 12 stapp csst 12 Nov 1 2017 /share/st195/prod/data/files/3PAR.INSERV/TierTwo/2017-11/1642005/
drwxr-xr-x+ 14 stapp csst 14 Dec 2 2018 /share/st316/prod/data/files/3PAR.INSERV/TierTwo/2018-12/1642005/
53
12-Apr--2021
STALL via S3MFT…
>s3mft.exe -n 1642005 -stall
Bucket stats-2020-03 contains data matching search criteria.

While the original “stall” utility lists each file system directory where data could be found for the serial number
specified, S3MFT will list each “bucket” where data exists for the specified serial number. Bear in mind, in terms of the
HPE AWS S3 solution a “bucket” would be synonymous with a file system top level directory, there are no sub-
directories in the AWS S3 architecture.
54
12-Apr--2021
9. User Initialization File
As of V5.0081, S3MFT now supports a single comprehensive user initialization file, an ini file. In prior
versions, S3MFT had the capability to support two (2) ini files that supported two different purposes. These
two (2) separate ini files have now been combined into a single ini files with the added benefit of supporting
several command line switch defaults that users may tailor to their specific needs.
The S3MFT ini file is a standard JSON text formatted file, so any text editor may be used to make changes to
the ini file.
Issuing the S3MFT command with the switch “-jsoninit” will generate the file “s3mft_init.json in the user’s
home directory:
 On Linux and macOS: the $HOME environment variable.
 On Windows, the %USERPROFILE% environment variable.
Please only change the field values that are appropriate. Once you are satisfied with your changes save your
work, do not move the file from your home directory.
The setting defined in this newly generated ini file will be default settings for each option. Using “-jsoninit”
will always generate a new default ini file, it will overwrite any existing ini file the user may have.
Below are descriptions of the options in the ini file in their appropriate section. Each option is listed as
follows:
“<option-name>”: <default-value> (value type) [associated command line switches]
Depending on the value type, which are:

 Integer
 Boolean
 String
if a user wishes to change the default value they will have to specify the value accordingly:
 An Integer value is specified as just the number.
 A Boolean value is either the text, true or false, without and quotation marks, single or double.
 A String value must be enclosed in double quotation marks (“”).
For those options that have associated command line switches, refer to those switches and their
descriptions. Also, if the option is a string value based option the command line switch description will
provide guidance of the string syntax/format.
Any option that has an associated command line switch may be overridden by specifying the command line
switch and its value if it requires one.
The ini option description may provide additional information as necessary.
Utilizing the debug logging switch, -dbg, a user can display some performance data for the worker. Please
bear in mind that not every activity that S3MFT executes utilizes the worker threads. Primarily, S3MFT will
use worker threads for searching, downloading, decompressing and displaying “files”.
55
12-Apr--2021
“defaults”
The “defaults” section of the JSON focuses on the command line defaults for several switches that users may
want set such that they need not be specified each time the S3MFT command is executed.
"arraydetails": false (Boolean) [-ad | -noad]
"arrayfeatures": false (Boolean) [-af | -noaf]
"filebanner": true (Boolean) [-fb | -nofb]
"pullupdate": false (Boolean) [-pullupdate]
"sntranslation": true (Boolean) [-xn | -noxn]
"sort": "ascending" (String) [-sort | -nosort | -unsort]

This ini file field option also allows for two (2) additional string values: “nosort” or “unsort” to represent
the –nosort and –unsort switches respectively.
"vendorproducts": "3PAR:INSERV,SP" (String) [-vp]

Users should define this value following the format allowed by the –vp switch. The default value should reflect the
user’s predominant vendor/product interest. For example, if the user is a 3PAR/PRIMERA support engineer they would
want to use “3PAR:INSERV,SP” as their default value.
"widesearch": false (Boolean) [-wide| -nowide]
“dlworker”
“dlworker” options focus on the number of file object download (DL) workers and how many outstanding
requests may wait in the queue. The download workers are responsible for retrieving the file object metadata
and/or contents from SCALITY/S3 and then depending, act on those contents, I.E. – displaying to STDOUT,
downloading the contents to a file on disk, searching the contents, decompressing, etc.
The “dlworker” section is broken down by OS as a convenience so that a single ini file could be maintained
and utilized by a user across the different OSs currently “supported” by HPE IT.
The default values are as follows:

 For all OS’s the default queue length is 5000, this be adequate for most purposes.
 The number of workers:
o Windows: 4
o macOS(darwin): 4
o Linux: 16
The minimums and maximums:

 Minimums, this applies to all OS’s:
o Workers: 1
o Queue Length: 50
 Maximums, this applies to all OS’s:
o Workers: 100
56
12-Apr--2021
o Queue Length: 10000
The default values should suffice for most needs.
Users who wish to make changes will have to determine on their own what will work best for their
environment, queries and needs through trial and error.
The “queue” field represents the worker queue length and the “count” field represents the number of worker
threads.
“count”: 4 (Integer) [-dlthreads]
“queue”: 5000 (Integer) [-dlqlen]
“mqworker”
“mqworker” options focus on the number of MONGODB/MySQL Query (MQ) workers and how many
outstanding requests may wait in the queue. The MQ workers are responsible for retrieving the list of file
objects information and/or contents from SCALITY/S3 and then depending, act on those contents, I.E. –
displaying to STDOU, downloading the contents to a file on disk, searching the contents, decompressing, etc.
The “mqworker” section is broken down by OS as a convenience so that a single ini file could be maintained
and utilized by a user across the different OSs currently “supported” by HPE IT.
The default values should suffice for most needs.
The default values are as follows:

 For all OS’s the default queue length is 6144, this be adequate for most purposes.
 The number of workers:
o Windows: 4
o macOS(darwin): 4
o Linux: 4
The minimums and maximums:

 Minimums, this applies to all OS’s:
o Workers: 1
o Queue Length: 50
 Maximums, this applies to all OS’s:
o Workers: 25
o Queue Length: 20000
Users who wish to make changes will have to determine on their own what will work best for their
environment, queries and needs through trial and error.
The “queue” field represents the worker queue length and the “count” field represents the number of worker
threads.
57
12-Apr--2021
“count”: 4 (Integer) [-mqthreads]
“queue”: 6144 (Integer) [-mqqlen]
“httptuning”
Any changes to these default options for http tuning should be approached with care and caution. Users
should not make any changes to these values if they are using S3MFT in a multi-user environment, those
changes have a potential for impacting their fellow users. There are no command line switches associated
with the HTTP tuning options.
"DialerTimeout": 30 (Integer) []
DialerTimeout is the maximum amount of time a dial will wait for a “connect” to complete. If Deadline is also set, it may
fail earlier.
The default is no timeout.
When using TCP and dialing a host name with multiple IP addresses, the timeout may be divided between them.
With or without a timeout, the operating system may impose its own earlier timeout. For instance, TCP timeouts are
often around 3 minutes.
"DialerKeepAlive": 30 (Integer) []
DialerKeepAlive specifies the interval between keep-alive probes for an active network connection.
If zero, keep-alive probes are sent with a default value (currently 15 seconds), if supported by the protocol and
operating system. Network protocols or operating systems that do not support keep-alives ignore this field.
If negative, keep-alive probes are disabled.
"ExpectContinueTimeout": 0 (Integer) []
ExpectContinueTimeout, if non-zero, specifies the amount of time to wait for a server's first response headers after
fully writing the request headers if the request has an "Expect: 100-continue" header. Zero means no timeout and
causes the body to be sent immediately, without waiting for the server to approve.
This time does not include the time to send the request header.
"IdleConnTimeout": 30 (Integer) []
IdleConnTimeout is the maximum amount of time an idle (keep-alive) connection will remain idle before closing itself.
Zero means no limit.
"MaxAllIdleConns": 64 (Integer) []
MaxAllIdleConns controls the maximum number of idle (keep-alive) connections across all hosts.
Zero means no limit.
"MaxHostIdleConns": 64 (Integer) []
MaxHostIdleConns, if non-zero, controls the maximum idle (keep-alive) connections to keep per-host.
If zero, DefaultMaxIdleConnsPerHost is used.
"ResponseHeaderTimeout": 0 (Integer) []
ResponseHeaderTimeout, if non-zero, specifies the amount of time to wait for a server's response headers after fully
writing the request (including its body, if any). This time does not include the time to read the response body.
58
12-Apr--2021
"TLSHandshakeTimeout": 0 (Integer) []
TLSHandshakeTimeout specifies the maximum amount of time waiting to wait for a TLS handshake.
Zero means no timeout.
59
12-Apr--2021
10. Fixes and New Features
V3.0180
 Corrected a problem with the metric search option, “-s”, that involves the single occurrence of special
characters in the specified metric filter and the search method that uses that filter.
 The default to display the contents of a file object when “-filename” is the only switch used has been fixed.
 Fixed a single output statement to output to STDOUT rather than STDERR. This single output statement is in
the multiple file fetch routine describing the action of the file object and the “serial number” is belongs to.
 Revert output back to current working default regardless of OS when user has not specified a different output
directory location.
60
12-Apr--2021
V3.0185
 Added the file type “hwinvent” to the file type list of the “-a” switch.
 Updated a bucket check for determining proper formatting of the “filedatetime” tag.
61
12-Apr--2021
V3.0190
 Corrected serial number lookups, for older arrays, to handle translating 10 character alphanumeric serial
numbers to their corresponding 7 digit serial number.
 Prevent the use of the “-D” or “-G” switches when neither “-s” or “-m” switches are present.
 Fixed an issue with parsing some file names having an 8 digit year.
62
12-Apr--2021
V3.0194
 Additional changes made with regards to various filename formats.
 Fixed a “-s” pattern matching issue.
 To output of start time and end time messages will require “-dbg” to se to at least 1.
 Made some minor output formatting changes.
63
12-Apr--2021
V3.0196
 Corrected one of the metric regular expressions as it had be reverted during the search routine re-writes.
(BOSS-114)
64
12-Apr--2021
V4.0230
 Can use “@<filename> with the “-n” switch to input multiple serial number. (BOSS-129)
 Can use “@<filename> with the “-filename” switch to input multiple files. (BOSS-130)
 Added a time zone designation to file information header in “showfield” emulation mode. (BOSS-131)
 Corrected the documentation for “-m” and “-s” to reflect the requirement of the “-n” or “filename” switches.
(BOSS-132)
 Enabled the use of the “-m” or “-s” switch with the “-filename” switch. (BOSS-133)
 Improved performance via additional multithreading. (BOSS-134)
 Modified logging to improve performance and cooperate with the multithreading changes. An s3mft.log file is
now created in your current working directory. (BOSS-135)
65
12-Apr--2021
V4.0240
 Additional memory improvements made to the multithreading updates. (BOSS-134)
66
12-Apr--2021
V4.0245
 Added an SP name/serial-number lookup for phone home verification purposes. (BOSS-137)
 Added capability to search the ITG data bucket. (BOSS-138)
 Use of a log file has been removed.(BOSS-135,136,142 rescinded)
 Changed the default value for –efdt to be 24 hours in the future from the current system time. (BOSS-146)
 Corrected an output issue when using –s or –m. (BOSS-139)
 Corrected several documentation issues. (BOSS-144)
 Fixed an issue when attempting to decompress multiple files. (BOSS-145)
 Corrected an issue when an ambiguous date/time provided. (BOSS-143)
 Updated the S3MFT to recognize that the April 2020 bucket has had its file date time key reformatted. (BOSS-
147)
 The –q switch will now also suppress the serial number translation message. (BOSS-141)
 Added 2 new file header switches enabling the display of “brief” file header data. (BOSS-151)
 Added the –bdump switch to fix an issue with dumping binary data to STDOUT. (BOSS-152)
 Updated and enhanced output to STDOUT and STDERR. (BOSS-153)
 Fixed an issue with “too many open files” error. (BOSS-149)
 Fixed an issue with parsing and interpreting the use of a tilde(~) in a file path.(BOSS-148)
67
12-Apr--2021
V4.0248
 Squelched the parsing messages regarding filenames with “BAD” or “CORRUPT” at the end. (BOSS-154)
 Corrected the exit status when S3MFT returns “No data found matching the specified search selection criteria.”.
(BOSS-155)
68
12-Apr--2021
V4.0294
 Corrected a date formatting validation issue introduced in BOSS-155 in V4.0248. (BOSS-156)
69
12-Apr--2021
V4.0300
 Changes made regarding the decompression of data either from a buffer from a downloaded file have been
made to reduce memory consumption in an effort to mitigate S3MFT from failing an OOM panic. (BOSS-157)
 Added a new switch, “-fnp”, to add the prefix “array_<serial#>_ to file names when downloaded to disk in
mass. (BOSS-160)
 Changed initialization of memory buffer when utilizing downloads to buffers to help reduce memory
consumption. (BOSS-161)
70
12-Apr--2021
V4.0304
 Changes made regarding automatic bucket selection when using –sfdt and selecting a first of the month date
and/or when using –efdt with the last day of a month specified. (BOSS-162)
71
12-Apr--2021
V5.0044
 New feature, automatic check for new versions of S3MFT. Use “-pullupdate” to download the new version.
(BOSS-117)
 More performance enhancements. (BOSS-134)
 Added the capability to sort the output, “-sort” or “-unsort”. (BOSS-166)
 Fixed an issue when generating a pre-signed URL and a bucket name is not provided. (BOSS-171)
 Cleaned up the help text formatting. (BOSS-179)
 Added the capability to utilize the date specified with “-T” in queries to the MONGO database. (BOSS-182)
 Provided a new option that allows for appending data to an output file, “-append” which requires the use of the
“-so” switch explicitly. (BOSS-183)
 Provided a new option to specify a CSV oriented prefix to the search results for “-text” and “-regex”, “-csv”.
(BOSS-184)
 Correct a serial number look up issue when an array does not appear to be sending telemetry data back to HPE
according to the stats_config.inservs database table. (BOSS-187)
72
12-Apr--2021
V5.0048
 Addendum: the switch “-wide” was introduced in V5.0044, but was not listed in the “Fixes and New Features”
section for that release. Use “-wide” when looking for telemetry “files” that does not adhere to the standard
naming conventions, possibly when looking for “files” that were sent back to HPE manually. (BOSS-188)
 Clarify help text for “-pullupdate”. (BOSS-189)
 Correct an ASCII to Integer conversion problem in the SYSRTL ConvertAtoI routine and with a SQL statement
look up in the stats_config.summary concerning number of nodes, corrected SQL statement to retun a zero(0)
if the field is blank. (BOSS-190)
73
12-Apr--2021
V5.0053
 Fixed a panic for a invalid memory address problem. (BOSS-191)
74
12-Apr--2021
V5.0055
 Corrected code with regards to a correction made to several regular expressions that dealt with date-time
formatting, this fixes the subscript out of range panics introduced in V5.0053 and hence pulling it from
production. (BOSS-192)
 Corrected array detail display when using the “-filename” switch and also had to address an issue where the
file information was not being displayed when using the “-s” or “-m” switches. (BOSS-193)
75
12-Apr--2021
V5.0087
 Provided the command line switch –xn | -noxn to enable and disable, respectively, the ability to translate serial
numbers provided by user. (BOSS-194)
 Corrected search requests utilizing –T as a legal search criteria. (BOSS-195)
 Corrected SQL queries to use the products specified with –product or –vp correctly. (BOSS-196)
 Corrected and enhanced the synthesis of a file object key name if the user specifies incomplete data via –
filename. (BOSS-197)
 Enhanced the capabilities of the s3mft_init.json initialization file. (BOSS-198)
 Corrected a race condition when querying MONGODB. (BOSS-199)
 Enhanced a message suggesting how to fetch “files” should they present the potential of causing problems
based on the command line options provided. (BOSS-200)
 Minor corrections to possible aberrations as a result of changes instituted with BOSS-193. (BOSS-201)
 Modified error message presentations for two (2) database routine calls. (BOSS-202)
76
12-Apr--2021

Hpe 3Par/Primera Peak/Boss S3Mft S3 "Multi-Function Tool" User's Guide

Uploaded by

Copyright:

Available Formats

Hpe 3Par/Primera Peak/Boss S3Mft S3 "Multi-Function Tool" User's Guide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Hpe 3Par/Primera Peak/Boss S3Mft S3 "Multi-Function Tool" User's Guide

Uploaded by

Copyright:

Available Formats

HPE 3PAR/PRIMERA

1. Specifying vendors and products has changed.

- /share/common-scripts/ERT/ - accessible via the CXO servers

macOS Users please see below for further details…

Should you encounter the following exception when executing s3mft...

Use the following workaround:

Thank you Naveena Kedlaya for providing these macOS instructions.

Breaking this down…

Time Zone Considerations

alert, config, event, environ, fabric, hostconf, hwinvent, memlog,

config, environ, hostconf, hwinvent

1234567|config.210304.231239.0001|294| ----- showdate -----

-csv will accept optional parameters as follows:

When –dx and –

If the file object is

See below about date-time formats.

1 - -bucket is required to perform the data retrieval

-n "<array serial number| SP name>|@<filename>"

-product[=]”<product>” (Being deprecated, unavailable after V5.0087)

If the file object is

then the file date is "200617.051351" and will be used in

See below about date-time formats.

-sort[=][<sort-options>] | -unsort | -nosort

-sort cannot be used with –bdump or -dx.

-sort and –unsort/-nosort are mutually exclusive.

The options that -sort accepts are as follows:

If an order is not provided when serial and/or file are specified,

If you do not specify a "key" (file/serial) that omitted key will be

-vendor="<vendor>" (Being deprecated, unavailable after V5.0087)

S3MFTrequires that one of the following be specified on the command line:

and a search option:

S3MFTallows for the following specifications to be used with the

+|-x[smhd] - Specify a delta of plus(+) or minus(-) X seconds(s) or

+|-[dd-]hh:mm[:ss] - Specify a plus(+) or minus(-) delta time comprised

bigbang - 1-Jan-1970 00:00:00

hh:mm:ss - The specified time using the current date.

s3mft -n 1642005 -s showpd.-c

Customer Info for 1642005 (windows)

System: 1642005 Information as of: 08/26/20 17:52:12

----- showpd -c -----

System: 1642005 Information as of: 08/26/20 09:50:42

System: 1642005 Information as of: 08/26/20 09:50:48

System: 1642005 Information as of: 08/26/20 09:50:50

Customer Info for 1642005 (windows)

System: 1642005 Information as of: 08/17/20 02:50:39

System: 1642005 Information as of: 08/26/20 17:52:12

System: 1642005 Information as of: 08/26/20 09:50:42

System: 1642005 Information as of: 08/26/20 23:54:56

System: 1642005 Information as of: 08/26/20 09:50:48

System: 1642005 Information as of: 08/26/20 22:24:24

System: 1642005 Information as of: 08/26/20 17:51:00

Customer Info for 1642005 (windows)

System: 1642005 Information as of: 08/17/20 02:50:39

Metric collected for: alert.200817.025039.0001

System: 1642005 Information as of: 08/26/20 17:52:12

Metric collected for: config.200826.175212.0001

System: 1642005 Information as of: 08/26/20 09:50:42

Metric collected for: environ.200826.095042.0001

System: 1642005 Information as of: 08/26/20 23:54:56