Galaxy File Uploads

From UABgrid Documentation
(Difference between revisions)
Jump to: navigation, search
(updated ftp related to sections with importfs and revised other sections aswell)
m (added section privacy with Sensitive information template)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[https://galaxy.uabgrid.uab.edu UAB Galaxy] supports data import in three ways:
 
[https://galaxy.uabgrid.uab.edu UAB Galaxy] supports data import in three ways:
# Direct file uploads to using a web browser
 
# Fetching data from external URLs through Galaxy
 
# Importing existing files on Cheaha file system
 
  
Web browser based file upload is a convenient approach, but not recommended for files larger than 2 GB in size because of browser limitations. Also, web browser based upload in Galaxy doesn't provide any feedback on upload progress and it can be an unreliable operation. You can fetch data from external URL locations through Galaxy, but that's not an efficient operation. Hence, it's recommended to stage data on Galaxy accessible file-system and then import it in Galaxy.
+
{| border="1"
 +
|+
 +
! Method !! Limitation
 +
|-
 +
|  Direct file uploads to using a web browser
 +
|  only files < 2G
 +
|-
 +
|  Fetching data from external URLs through Galaxy (ftp/http)
 +
|  can't access some password protected sites, such as the HudsonAlpha GSL
 +
|-
 +
|  Importing files via the Cheaha file system
 +
|  requires an [[Cheaha_GettingStarted#Access|account]] on cheaha, but command-line can be avoided
 +
|-
 +
|}
  
UAB Galaxy instance is configured to look for files in '/scratch/importfs/galaxy/$USER' and '/scratch/user/$USER' directories on Cheaha. Data files can be copied to Cheaha using [wikipedia:Secure_copy scp] or they can be downloaded using tools like wget, curl or ftp. Please refer to [[Cheaha_GettingStarted#Access]] page for getting access to Cheaha.
+
==Privacy==
 +
{{SensitiveInformation}}
 +
 
 +
==Direct file uploads to using a web browser==
 +
Web browser based file upload is a convenient approach, but not recommended for files larger than 2 GB in size because of browser limitations. Also, web browser based upload in Galaxy doesn't provide any feedback on upload progress and it can be an unreliable operation. Hence, it's recommended to stage data on Galaxy accessible file-system and then import it in Galaxy.
 +
 
 +
==Importing files via the Cheaha file system==
 +
UAB Galaxy instance is configured to look for files in '/scratch/importfs/galaxy/$USER' and '/scratch/user/$USER' directories on Cheaha. Data files can be copied to Cheaha using [[Wikipedia:Secure_copy|scp]] or they can be downloaded using tools like wget, curl or ftp. A nice windows-friendly drag-and-drop tool is [http://winscp.net/eng/download.php#download2 WinSCP]. Please refer to [[Cheaha_GettingStarted#Access]] page for getting access to Cheaha.
  
 
Following sections provide an overview of UAB Galaxy import methods.  
 
Following sections provide an overview of UAB Galaxy import methods.  
  
# importfs or file drop-off mode: UAB Galaxy platform is configured to import files in '/scratch/importfs/galaxy/$USER' directory. Galaxy application 'moves' files from imports directory to it's internal datasets directory. See [[Galaxy_Data_Import]] page for more details on the importfs method.
+
# importfs or file drop-off mode: UAB Galaxy platform is configured to import files in $GALAXY_IMPORTFS directory on Cheaha (/scratch/importfs/galaxy/$USER). Galaxy application 'moves' files from imports directory to it's internal datasets directory. See [[Galaxy_Importfs]] page for more details on this upload method.
# Data Library: Galaxy has a concept of 'Data Libraries' which is a data container to organize files in an hierarchical manner, similar to directories on a desktop. Data libraries provide other features for data organization and sharing as well. Data libraries support direct files uploads from a web browser, data fetch from external URLs and also file system imports. The file system import options is similar to FTP option described above, however, it doesn't delete original file on the file system after it has been imported in Galaxy. UAB Galaxy platform is configured to import files in '/scratch/user/$USER' directory. See [[Galaxy_Data_Library_Import]] page for more details on this data import method.
+
# Data Library: Galaxy has a concept of 'Data Libraries' which is a data container to organize files in an hierarchical manner, similar to directories on a desktop. Data libraries provide other features for data organization and sharing as well. Data libraries support files uploads using a web browser, fetching from external URLs and also by copying existing directories in a file-system. The file-system copy is similar to importfs option described above, however, it copies file to internal datasets directory rather than moving it. UAB Galaxy platform is configured to copy files in $USER_SCRATCH (/scratch/user/$USER) directory. See [[Galaxy_Data_Libraries]] page for more details on data libraries.

Latest revision as of 10:49, 3 May 2018

UAB Galaxy supports data import in three ways:

Method Limitation
Direct file uploads to using a web browser only files < 2G
Fetching data from external URLs through Galaxy (ftp/http) can't access some password protected sites, such as the HudsonAlpha GSL
Importing files via the Cheaha file system requires an account on cheaha, but command-line can be avoided

[edit] Privacy

Do not store sensitive information on this filesystem. It is not encrypted. Note that your data will be stored on the cluster filesystem, and while not accessible to ordinary users, it could be accessible to the cluster administrator(s).

[edit] Direct file uploads to using a web browser

Web browser based file upload is a convenient approach, but not recommended for files larger than 2 GB in size because of browser limitations. Also, web browser based upload in Galaxy doesn't provide any feedback on upload progress and it can be an unreliable operation. Hence, it's recommended to stage data on Galaxy accessible file-system and then import it in Galaxy.

[edit] Importing files via the Cheaha file system

UAB Galaxy instance is configured to look for files in '/scratch/importfs/galaxy/$USER' and '/scratch/user/$USER' directories on Cheaha. Data files can be copied to Cheaha using scp or they can be downloaded using tools like wget, curl or ftp. A nice windows-friendly drag-and-drop tool is WinSCP. Please refer to Cheaha_GettingStarted#Access page for getting access to Cheaha.

Following sections provide an overview of UAB Galaxy import methods.

  1. importfs or file drop-off mode: UAB Galaxy platform is configured to import files in $GALAXY_IMPORTFS directory on Cheaha (/scratch/importfs/galaxy/$USER). Galaxy application 'moves' files from imports directory to it's internal datasets directory. See Galaxy_Importfs page for more details on this upload method.
  2. Data Library: Galaxy has a concept of 'Data Libraries' which is a data container to organize files in an hierarchical manner, similar to directories on a desktop. Data libraries provide other features for data organization and sharing as well. Data libraries support files uploads using a web browser, fetching from external URLs and also by copying existing directories in a file-system. The file-system copy is similar to importfs option described above, however, it copies file to internal datasets directory rather than moving it. UAB Galaxy platform is configured to copy files in $USER_SCRATCH (/scratch/user/$USER) directory. See Galaxy_Data_Libraries page for more details on data libraries.
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox