How To Upload File to TUF Using SFTP

Summary

When working on a case, it is common for the Hitachi Vantara Global Support Center (GSC) to request additional information from the affected product for analysis, like system logs or screenshots, these files are uploaded to Technical Upload Facility (TUF).

Objective

Upload the information request by GSC to TUF via SFTP, using either the native CLI tools or WinSCP.

Hitachi Vantara does not support the upload of files using FTP because it is unencrypted.

Environment

  • Hitachi Vantara Technical Upload Facility (TUF)
  • Microsoft Windows 10 version 1803 or later
  • WinSCP

Procedure

File preparation and naming convention

Before uploading the file to TUF,  the files must follow some name conventions, they must be named with the Case Number as the first part of the file name.  Files uploaded via SFTP without that naming convention will be lost. Hitachi does not support the upload of files using FTP because it is unencrypted.

 CAUTION: Files uploaded via SFTP without that naming convention will be lost, as they won't be properly routed to the case 

Rename  the files to match the correct format. It is important to remember to place a period between the case number and the filename, other characters do not follow the required naming convention.

  • To upload a file named Performance_Data.zip to case 02345678, rename the file to 02345678.Performance_Data.zip.
  • To upload a file named Another_Example.tgz to case 07654321, rename the file to 07654321.Another_Example.tgz.

It is required to have a valid open Case Number prior to upload files to TUF.

 EXAMPLE: Valid file names:

  • 00001234.trace.dat
  • 00005678.hdcp.tgz
  • 00009101.getconfig.zip

Use WinSCP to transfer a file over to a case

  1. On the local computer open WinSCP.
     TIP: It is possible to use any software that supports SFTP, the instructions should be similar, but the procedure and GUI may be different. 
  2. On the Login window, fill the form with the following information:
    1. File protocol:
      SFTP
    2. Host name: 
      tuf.hitachivantara.com
    3. Port number:
      22
    4. User name:
      trcsftp
    5. Password:
       TIP: The 'O' in North is a zero '0' 
      TrueN0rth
    Image
  3. Once the connection is established, drag the file into the folder incoming.
     CAUTION: Do not open the incoming folder and try to drag a file inside. 
     CAUTION: DO NOT create any subdirectories.  Upload the files to the incoming directory only. 
    090240412027913.png

Once the upload completes, files will be automatically moved to the Case after 10-20 minutes. The Case notes will be updated with the upload of the files, and anyone subscribed to the Case will receive a notification.

Use the Windows Command Prompt (CLI)

  1. On a Microsoft Windows 10 version 1803 or later, open the Command Prompt (CMD).
  2. Move to the local directory where the file to upload (with the correct naming convention) is located:
    cd <local_path>
  3. Start a SFTP connection with TUF:
    sftp trcsftp@tuf.hitachivantara.com:incoming
  4. [Optional] If this is the first time starting an SFTP connection to TUF from this client, the connection may prompt you you verify and allow the connection, a message similar to the following is displayed:
    C:\>sftp trcsftp@tuf.hitachivantara.com
    The authenticity of host 'tuf.hitachivantara.com (10.78.149.26)' can't be established.
    RSA key fingerprint is SHA256:m9Cno6mf5fJQX6rKChqPdOEfrneNHiLAByk1CJSKO/8.
    This key is not known by any other names.
    Are you sure you want to continue connecting (yes/no/[fingerprint])?

    Verify the authenticity of the site, and if it is correct, type:

    yes
  5. Then the prompt asks for a password:
    C:\>sftp trcsftp@tuf.hitachivantara.com:incoming
    trcsftp@tuf.hitachivantara.com's password:
    Type the following password:
     TIP: The 'O' in North is a zero '0' 
    TrueN0rth
  6. Once the connection is established, the prompt in the CMD changes to:
    sftp>

    Run the following command to upload a file to TUF:
     NOTE: The file should be reachable on the local path where the SFTP connection was started 

    put <file_path_and_name>
  7. When the upload completes, run the following command to exit the SFTP connection:
    bye

    The prompt returns to the local computer and the file is now uploaded to TUF. The files will be automatically moved to the Case after 10-20 minutes. 

Solution Properties

Keywords
SFTP FTP TUF Logs Upload Facility GSC Support raexternalrequest
Solution ID
242403040001383
Last Modified Date
09/05/2024 06:38:24 PM
Attributes
Page Privacy and Permission Assignment
  • Page Privacy: Private
  • Page Level Permissions: Anonymous; Employee; Service Partner; Customer; Knowledge Author; Knowledge Editor; eServices; Knowledge Draft
  • Article: howto
  • Pagetype: knowledgearticle
Taxonomy
  • Support Information > Data Collection > TUF
Collections
  • Guest (Public)
Views
3002