How to access and upload files to the Cloud SFTP (Staging and Production)

SFTP is used to bulk upload large SCORM courses, site assets, and for securely exchanging data files

Table of Contents:

FTP Client

Directions for accessing SFTP with Filezilla using Learnsoft provided Username and Password

Direction for Accessing SFTP with Filezilla using Learnsoft provided SSH Key

Uploading files to the SFTP

Explanation of directories

 

FTP Clients

If you don't already have one, you will need to download a FTP client on your computer. 

Examples of free FTP Clients:

  • FileZilla (Windows and macOS)
  • WinSCP (Windows) 
  • Cyberduck (Windows and macOS).

We recommend Filezilla for its ease of use.  

 

If Cloud SFTP credentials have not been provided to you, you will need to submit a request for SFTP Access.

 

Accessing SFTP with Filezilla using Learnsoft provided Username and Password

1.  Open Filezilla and select:  File > Site Manager

2. Click "New Site" and rename as needed.

3. Select "SFTP - SSH File Transfer Protocol" for the "Protocol".

4.  Add "sftp.learnsoft.com" for the "Host"

5.  Add "2222" for the "Port"

6. Select "Normal" for the "Logon Type"

7.  Enter in the Learnsoft provided "User" and "Password". 

8. Click "Connect"

The first time you connect, you may see a prompt about an Unknown host key. This is normal, and happens when your computer has not connected to the server before. You can select "Always trust this host, add this key to the cache" and then click OK. 

sftp-unknownhostkey

 

Direction for Accessing SFTP with Filezilla using Learnsoft provided SSH Key

For this login option you will need to know the location of the key.pem (SSH Key) that was provided to you by Learnsoft support. 

1.  Open Filezilla and select:  File > Site Manager

2. Click "New Site" and rename as needed.

3. Select "SFTP - SSH File Transfer Protocol" for the "Protocol".

4.  Add "sftp.learnsoft.com" for the "Host"

5.  Add "2222" for the "Port"

6. Select "Key file" for the "Logon Type"

7.  Enter in the Learnsoft provided username in the "User" field.

8. Select "Browse" in the "Key file" section and locate/select the downloaded key.pem (SSH Key) file that was provided by Learnsoft support.  

9. Click "Connect".

 

Uploading files to the SFTP

Once connected to your Client SFTP site you will see the directories/folders that you have been given access to. The content you are uploading will determine which directory to upload your file (see "Explanation of directories" section).

1.  Locate and click on the directory/folder you wish to upload your file to. This can be found in the "Remote Site" section (right side) of Filezilla.

2. Search for the file to be uploaded in the "Local Site" section (left side) of Filezilla. 

3. Drag the file into the directory folder opened in step 1 above. 

Alternatively, you can right mouse click on the file to bring up the options menu and select "Upload".  

4.  Wait for file upload to complete. 

 

Explanation of Directories

Use this section to determine which directory should be used depending on content and site. Most users will not have access to all of the directories listed below; for example, integrations and outbound directories are usually provisioned to service accounts and are not visible to users. 

"prod" refers to the Production (live) site. 

"staging" refers to the Sandbox (testing) site. 

Production

prod-assets - Production directory used for uploading additional content for the site.  (Ex. HTML file for Global announcements, Theme content, Logos, etc.)

prod-integrations - Production directory used for uploading Integration content. (Ex. Nightly HR feed file, Client automated integrations, etc.)

prod-training-content - Production directory used for uploading course content. (Ex. SCORM/AICC packages, etc.) Formerly named WBT content.

prod-outbound - Production directory used for Sending content from Learnsoft to the Client.

Staging

staging-assets - Staging directory used for uploading additional content for the site.  (Ex. HTML file for Global announcements, Theme content, Logos, etc.)

staging-integrations - Staging directory used for uploading Integration content. (Ex. Nightly HR feed file, Client automated integrations, etc.)

staging-training-content - Staging directory used for uploading course content. (Ex. SCORM/AICC packages, etc.) Formerly named WBT content.

staging-outbound - Staging directory used for Sending content from Learnsoft to the Client.