Skip to content

Latest commit

 

History

History
22 lines (12 loc) · 2.06 KB

galaxy_tool_install.md

File metadata and controls

22 lines (12 loc) · 2.06 KB
Raw

Galaxy tool installation

  1. This step requires a restart of Galaxy: Edit your Galaxy config file ("universe_wsgi.conf" in older installs):

  2. Add the tool's default user name "[email protected]" to the admin_user's list line.

  3. Ensure the Galaxy API is activated: "enable_api = True"

  4. Then ensure you have an API key (from User > Api keys menu).

  5. Login to Galaxy as an administrator, and install the Versioned Data tool. Go to the Galaxy Admin > Tool Sheds > "Search and browse tool sheds" menu. Currently this tool is available from the tool shed at https://toolshed.g2.bx.psu.edu/view/damion/versioned_data . The "versioned_data" repository is located under the "sequence analysis" category.

  6. After it is installed, display the tool form once in Galaxy - this allows the tool to do the remaining setup of its "versioneddata" user. The tool automatically creates a galaxy API user (by default, [email protected]). You will see an API key generated automatically as well. The tool (via Galaxy) automatically writes a copy of this key in a file called "versioneddata_api_key.txt" in its install file folder for reference; if you ever want to change the API key for the versioneddata user, you need to delete this file, and it will be regenerated automatically on next use of the tool by an admin.

  7. Also, ensure that the kipper.py file has the Galaxy server's system user as its owner with executable permission ( "chown galaxy kipper.py; chmod u+x kipper.py").

Command-line Kipper

Optional: If you want to work with Kipper files directly, e.g. to start a Kipper repository from scratch, then sym-link the kipper.py file that is in the Versioned Data tool code folder's /data_stores/ subfolder - you could link it as "/usr/bin/kipper" for example. The tool path is shown in the "location" field when you click on "Versioned Data" tool in Galaxy's "admin > Administration > Manage installed tool shed repositories" report.

More info on command-line kipper is available here.