# HG changeset patch # User yhoogstrate # Date 1466516788 14400 # Node ID 6d0453b21b1cd1c83a77a547aa72bb790aa252a3 # Parent 258bef8153278dc27276608631ab5979848a03a8 planemo upload for repository https://github.com/ErasmusMC-Bioinformatics/ega_client_galaxy_wrapper commit f0c50d449bdbd88fc32d725e6c9503a03853da7f-dirty diff -r 258bef815327 -r 6d0453b21b1c README.rst --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.rst Tue Jun 21 09:46:28 2016 -0400 @@ -0,0 +1,36 @@ +ega_client_galaxy_wrapper +========================= + +Bio-molecular high throughput data is privacy sensitive and can not easily made accessible to the entire outside world. To manage access to long term-archival of such data the European Genome-phenome Archive (EGA) project was initiated to facilitate data access and management to funded projects after completion to enable continued access to these data. Strict protocols govern how information is managed, stored, transferred and distributed and each data provider is responsible for ensuring a Data Access Committee is in place to grant access to the data. Obtaining such data is achieved with the EGA download streamer. + +License +------- +This embeds access to the EGA download streamer into Galaxy (16.07+). The EGA download streamer (https://www.ebi.ac.uk/ega/about/your_EGA_account/download_streaming_client) is free software released under the GNU GPL 3 license. By installating this tool you automatically agree with the terms of this license. + + +Installation +------------ +The galaxy wrapper is available in the public tool sheds under the name *ega_download_streamer* and can be viewed at the following url: https://toolshed.g2.bx.psu.edu/view/yhoogstrate/ega_download_streamer + +The galaxy web administrator can install this wrapper in the admin menu, under the tabs **Tools and Tool Shed**: *Search Tool Shed*. In here, the admin needs to go to the **Galaxy main tool shed** where the search term *ega_download_streamer* should show the tool installer maintained by *yhoogstrate*. By pressing on it, a new page will open. This page will indicate that it will automatically install the tool dependencies and shows this README, including the LICENSE, and a button that will install the entire package into the galaxy server. + +Because currently galaxy does not (yet?) support a password input type, the tool has to be configured by setting up 1 generic account. This is done by adding lines, setting up the proper environment variables, to a destination (computer node) in galaxy's `./config/job_conf.xml`: + +```` + +``email`` + +``Secret12456...blabla`` + +```` + +The `runner="local"` should correspond to the runner that runs the ega_download_streamer (only for complex setups, local is default). + + +Maintainance +------------ + +The galaxy repository is maintained by Youri Hoogstrate and was written for an ELIXIR/EGA project. + +Bugs and other contributions to the galaxy wrapper are more than welcome at: +https://github.com/ErasmusMC-Bioinformatics/ega_client_galaxy_wrapper diff -r 258bef815327 -r 6d0453b21b1c ega_download_streamer.xml --- a/ega_download_streamer.xml Tue Mar 29 07:41:51 2016 -0400 +++ b/ega_download_streamer.xml Tue Jun 21 09:46:28 2016 -0400 @@ -113,13 +113,15 @@ **What it does** -Individual files or whole datasets may be downloaded from European Genome-phenome Archive (EGA) in a secure manner by first placing a download request and then downloading the file/s associated with the request. All files are automatically encrypted prior to streaming and must be decrypted using the streamer after download is complete. +Individual files or whole datasets may be downloaded from European Genome-phenome Archive (EGA) in a secure manner by first placing a download request and then downloading the file/s associated with the request. All files are automatically encrypted prior to streaming and shall be decrypted using the streamer after downloading has completed. -To download a given dataset, the user should provide the corresponding EGA file identifier (e.g. EGAF00001059069). +**How to use** + +When you load the tool in galaxy, the user should provide the corresponding EGA file identifier (e.g. EGAF00001059069). **Configuration** -The admin has to configure the server such that the environment variables $user and $pass are exported and reflect the credentials of the EGA account. The user and password shall not be visible to users. This can also be done in the config/jobs_conf.xml file. +The admin has to configure a generic account, further described in the README: https://raw.githubusercontent.com/ErasmusMC-Bioinformatics/ega_client_galaxy_wrapper/master/README.rst https://www.ebi.ac.uk/ega/about/your_EGA_account/download_streaming_client