Page tree
Skip to end of metadata
Go to start of metadata

While helping you trouble-shoot docker or application issues, the SSDT may ask you to send a file to the SSDT from your docker host.   The SSDT Utils contains a script called /ssdt/scripts/send.sh which will transfer a file securely to an SSDT controlled server via HTTPS.  The init.sh script (if sourced in .bashrc or linked in profile.d) provides a send2ssdt alias to easily invoke the script.  

The script requires a file name parameter relative to the current working directory. The file must in contained in, or below, the current working directory. Alternatively, the file may be specified as a single dash (-) to read from standard input.

 An optional second parameter may be specified to indicate the name, or short description, of the file (no spaces or special characters). If not specified, the name parameter defaults to the basename of the current directory:

/ssdt/scripts/send.sh {file} [name]
# or
send2ssdt {file} [name]

The file size is currently limited to 2GB.

The script does not notify the SSDT that a file has been sent. Therefore, you should communicate via other means when you send a file.

When transmitted to the SSDT, the file will be given a name prefixed by your docker host name and suffixed with a time stamp to ensure uniqueness.

Examples:

To send the log file from all containers, use:

#  docker-compose logs| /ssdt/scripts/send.sh -

To send the log from a single container (such as usaspp or uspsapp):

#  docker-compose logs usasapp | /ssdt/scripts/send.sh -

To send a log file from the current directory:

/ssdt/scripts/send.sh usasimport.log
# or:
send2ssdt usasimport.log

Backups can be sent, since binary files up to 2GB's are supported. To send a backup:

send2ssdt backup/nameofdistrict-usasdb.2016-03-11-15-20-10.backup.gz our_troubled_sampletown_db

To send the output of a command:

 
/ssdt/scripts/info.sh | send2ssdt -

Technical Note:

The script uses the ssdt-utils image to execute the curl command to post the file to the SSDT's upload server at https://upload.ssdt.io/uploads. Since curl is running inside a temporary container, the file to be sent must be within or below your current working directory.  It also means you do no have to have curl installed on your server.

This web site is "write only" so only SSDT personnel can access the transmitted files.

SSDT Internal Note:

Files uploaded by this process can be accessed by SSDT personnel at upload.ssdt.io (currently ssdt-docker-02) at /data/upload.ssdt.io/uploads using scp. The naming convention for the files is:

source_name_originalFileName_timestamp

Where "source" is the hostname of the sending server (which may not be unique). "name" is the value entered in the second parameters or the parent directory of the file on the sending server.  "originalFilename" is the file name on the sending system or dash (-) if from standard input.

Files should be deleted from the upload server after they have been transferred or processed