Uploading scrutinize Results to Support

In most cases, your Customer Support contact provides arguments for you to run with the scrutinize script. These arguments include the URL that you supply with the ‑‑url or ‑‑auth‑upload options.

Before you run scrutinize with an upload option:

When you use the upload options:

Authenticated Upload

You can use the --url or the --auth-upload option to upload scrutinize output to Vertica Customer Support. Each option authenticates the upload in a different way:

The ‑‑auth‑upload argument requires a valid Vertica Premium Edition license. In both cases, the upload uses a URL or FTP address supplied by Vertica Customer Support.

Upload Examples

The following example shows a generic upload that invokes the ‑‑url option to gather all diagnostics on the cluster and posts the collected output to a support-provided URL:

$ scrutinize -U username -P 'password' -u 'ftp://username/password@customers.vertica.com/'

You can also use the authenticated upload method to gather the same information and your customer name:

$ scrutinize -U username -P 'password' --auth-upload "url"

Including Messages in scrutinize Output

The scrutinize option ‑‑message (‑m) includes a message in the scrutinize output, in reason.txt. Messages are typically included in order to provide the following information:

If no message is specified, scrutinize generates the default message 'Unknown reason for collection.'

You can set a message several ways:

Database Identifiers

scrutinize generates a unique identifier for the database that it analyzes. This identifier is based on your Vertica license and the database creation time. scrutinize generates the same name for a given database each time it collects data on that database. It displays this name near the end of its standard output—in the following example, PURPLE LEAD:

Vertica Scrutinize Report
-----------------------------
Result Dir:              /home/dbadmin/VerticaScrutinize.20140206144429
...
Gathered diagnostics for
Customer: Vertica Systems, Inc.
Database designation: PURPLE LEAD
Timestamp: 20140206144429
...

You can use this identifier when you interact with Customer Support. It is particularly useful in the following cases: