{"id":18561994,"url":"https://github.com/timstaley/trap-demo","last_synced_at":"2025-05-15T17:34:54.523Z","repository":{"id":144784008,"uuid":"49138842","full_name":"timstaley/trap-demo","owner":"timstaley","description":"Ansible scripts for deploying TraP + Banana to a virtual machine or cloud instance.","archived":false,"fork":false,"pushed_at":"2016-05-16T17:17:23.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-17T12:45:27.944Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timstaley.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-01-06T14:07:13.000Z","updated_at":"2016-05-04T13:59:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"546825b0-0cb9-4ad4-badb-f91503529f83","html_url":"https://github.com/timstaley/trap-demo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timstaley%2Ftrap-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timstaley%2Ftrap-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timstaley%2Ftrap-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timstaley%2Ftrap-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timstaley","download_url":"https://codeload.github.com/timstaley/trap-demo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254388193,"owners_count":22063003,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T22:08:30.702Z","updated_at":"2025-05-15T17:34:54.499Z","avatar_url":"https://github.com/timstaley.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TraP-Demo\nA dead-simple means of setting up [TraP][] in a [virtual machine][] so you can\neasily try it out on your local machine, whether you run Linux,\nMac OSX, or (possibly) even Windows!\n\n[TraP]: http://tkp.readthedocs.io/en/latest/introduction.html\n[virtual machine]: https://simple.wikipedia.org/wiki/Virtual_machine\n\n## Setup\n### Pre-requisites:\n\nYou will need:\n\n- [Virtualbox](https://www.virtualbox.org/wiki/Downloads). This provides the\n    virtual machine container. When this is successfully installed you\n    should be able to launch the Virtualbox GUI from start menu\n    (just to check it's working OK - we won't actually be using that inferface).\n- [Vagrant](https://www.vagrantup.com/downloads.html).\n  Vagrant provides a convenient command line interface for setting up and\n  configuring virtual machines. You can check if vagrant is installed OK by\n  running `vagrant help` from the command line.\n- [Ansible](http://docs.ansible.com/ansible/intro_installation.html). Ansible\n  provides a scripting language and associated tools for system installation\n  and configuration. It's a Python package, so my preferred installation method\n  is to simply install it using `pip`, but see the installation instructions\n  for other options. You can check if ansible is installed and in your\n  path by running `ansible --help` from the command line.\n\n### Installation:\n\nFrom the command line:\n\nClone this repository and navigate to the *vagrant* directory:\n\n    git clone https://github.com/timstaley/trap-demo.git\n    cd trap-demo/vagrant\n\nInstall the Ansible [roles][] - these are 'building blocks' for system\nconfiguration, e.g. we use one role to install casacore, another to configure\nPostgres databases, etc. The required roles are listed in *requirements.txt*,\nand we can install them with:\n\n    ansible-galaxy install -r requirements.txt\n\n[roles]: http://docs.ansible.com/ansible/playbooks_roles.html#roles\n\nWe're ready to go! The *Vagrantfile* is configured so that vagrant will\ncreate a virtual machine running Ubuntu 14.04 and then install TraP and Banana\nusing the Ansible configuration scripts. Simply run:\n\n    vagrant up\n\n(from the *vagrant* directory). This will take a while the first time - perhaps\nan hour or so depending on your internet connection speed, etc.\nIf something goes wrong (maybe you get disconnected from the\ninternet or whatever) then you can resume the install process using:\n\n    vagrant provision\n\nThat's also the command to run if you change the configuration scripts and want\nto bring your virtual machine up to date.\n\nWhen everything's up and running, try bringing up a web-browser and take a look\nat http://localhost:8080 - if everything worked OK you should see the front\npage of the Banana web-interface.\n\nYou can also connect to your virtual machine over SSH. Try:\n\n    vagrant ssh\n\n### Teardown:\nRunning a virtual machine uses up some of your RAM, and some hard drive space.\nIf you want to 'switch off' the virtual machine and free up your RAM again, run:\n\n    vagrant halt\n\n(you can `vagrant up` later to switch it back on again).\nIf you want to delete the virtual machine entirely and reclaim your disk space,\nrun:\n\n    vagrant destroy\n\n## Data reduction\nThe next step is to actually analyse some radio-astronomy images using the TraP.\nWe'll refer to the virtual machine as the 'guest machine' or just 'guest'\nfrom here on. (Your regular operating system is the 'host'.)\n\nVagrant configures the guest machine so that the *vagrant* folder we've been\nworking from is also visible from the guest, at the path */vagrant*.\nIf you `vagrant ssh` into the guest and then `cd /vagrant` you can\ncheck this for yourself. The setup scripts created a couple of subfolders here,\n*trap-jobs* and *trap-data*.\nFrom the host, you should move a copy of your radio images into *trap-data*\n(perhaps organised into a subfolder).\n\nNext, we'll configure a TraP job to analyse this dataset.\nFrom a guest terminal (To be continued...)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimstaley%2Ftrap-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimstaley%2Ftrap-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimstaley%2Ftrap-demo/lists"}