{"id":18722599,"url":"https://github.com/mdsumner/nectar","last_synced_at":"2025-04-12T14:53:07.497Z","repository":{"id":22159668,"uuid":"25491161","full_name":"mdsumner/nectar","owner":"mdsumner","description":null,"archived":false,"fork":false,"pushed_at":"2023-04-19T00:11:19.000Z","size":190,"stargazers_count":15,"open_issues_count":6,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-26T09:22:03.464Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/mdsumner.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":"2014-10-20T23:20:08.000Z","updated_at":"2025-03-22T08:14:22.000Z","dependencies_parsed_at":"2024-11-07T13:43:48.924Z","dependency_job_id":"00eaecf0-0954-450a-bbd1-87889dd57f47","html_url":"https://github.com/mdsumner/nectar","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/mdsumner%2Fnectar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdsumner%2Fnectar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdsumner%2Fnectar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdsumner%2Fnectar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mdsumner","download_url":"https://codeload.github.com/mdsumner/nectar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248586227,"owners_count":21128995,"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-07T13:42:11.556Z","updated_at":"2025-04-12T14:53:07.472Z","avatar_url":"https://github.com/mdsumner.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"nectar\n======\n\n\n# Introduction\n\n\nThis page describes use of Nectar for beginners. Nectar is the cloud computing resource. \n\n\u003e NeCTAR is a scientific \"cloud-compute\" resource, The National eResearch \n\u003e Collaboration Tools and Resources (NeCTAR) Project  \n\nhttps://nectar.org.au/about-nectar\n\nOfficial guides and how-to here: ttps://support.nectar.org.au/support/solutions\n\n# Summary\n\nWe will\n\n1. What is the cloud? What is it used for? \n2. Log in to Nectar and launch a VM (virtual computer)\n3. Log in to the VM\n4. Use the VM\n\n\n# 1. What is the cloud? What is it used for? \n\nIt's just computers - computers that aren't physically on your desk, but also computers that you \"create\" for your own use. \n\n* Linux shell\n* RStudio\n* Matlab\n* Python\n* etc. \n\n*The hard thing*\n\nAccess is less direct than with a computer on your desk. \n\n*The great thing*\n\n**A.** can create a very powerful computer with all dependencies need, and then make a copy of it, \"snapshot it\" and use it again, share with others. \n\n**B.** It's also possible to create a \"recipe script\" to take a clean computer and install everything on it that you need automatically. \n\nThese two cases have pros and cons, but are not mutually exclusive. \n\n# 2. Log in to Nectar and launch a VM (virtual computer)\n\n* need AAF account (e.g. a UTAS account)\n* create Security Rules for the VM\n* create a keypair for admin login\n* create the computer!\n\n## 3. Log in to the VM\n\n* need an SSH client (*Windows needs extra installation*)\n* create a normal user (don't always be the Administrator)\n\n## 4. Use the VM\n\n* transfer files (to and from the VM)\n* install applications (as the Administrator)\n* run the applications (as a user)\n\n\nSummary of the process \nThe crucial parts with Nectar are ensuring you have\na Nectar account\nSecurity Rules for the right ports\na keypair set up for the initial admin login \na Nectar allocation to launch the RStudio server against\nsomewhere to log into the virtual machine from (e.g. via SSH with MobaXTerm on Windows)\na tiny bit of Linux-fu to create a normal user\nNectar account\nMany Australian universities provide access via pre-existing email account logins.  Go to the dashboard login, find your institution, e.g. UTas and follow the trail into the dashboard.  \n\nLog in here: https://dashboard.rc.nectar.org.au/auth/login/?next=/project/\nNext we will set up Security Rules, a keypair for secure access, and the actual launching. \nSecurity Rules\nGo to Access and Security, and the Security Groups tab.\nYou may need the following ports open:\n22   SSH  - this is needed for us to log in as admin to create users on the server\n8787  RStudio Server - this allows users to log into the RStudio interface\nOnce you have Security Group/s defined you can apply them to an instance that you launch, either at launch or after the fact.\n\nKey pair\n\nCreate one under the \"Keypairs\" tab under Access and Security. Save the resulting .pem file somewhere you can use it to SSH in (see Log in below). \n\nNote: the default admin user on this Ubuntu machine is \"ubuntu\", you'll use this name with the keypair to log in to the machine for creating normal users. \nLaunch a server\nLaunching goes like this, with details relevant for 2014-05-28: \n\nfind the most recent version of Ubuntu, currently 14.04 under \"Images and Snapshots\", make sure \"Nectar official\" tab is active, choose \"NeCTAR Ubuntu 14.04 (Trusty) amd64\", click Launch\nset your Flavor (server grunt within limits of your allocation)\ngive it an “Instance Name”  \nunder Access \u0026 Security tab specify the keypair you will use (THIS IS REQUIRED BEFORE LAUNCHING)\nalso make sure the Security groups are applied – so you have all those ports for HTTP, SSH, HTTPS, RStudio Server and Shiny as required for your needs (See images of my rules above. )\nunder Availability Zone optionally choose a location\nunder \"Customization\", enter the script text (see below)\nclick “Launch” - once this is fired up you can get the IP address, which we use next\nScript text\nSee here, enter the entire contents of r-spatial.sh into the Customization text field: \nhttps://github.com/mdsumner/nectar/blob/master/r-spatial.sh\n\nYou do need to run the gdebi install for the RStudio as sudo, and should do it interactively. \n\nLog in\nOption 1)\nLog in using SSH on Windows like this (I recommend using MobaXTerm)  http://mobaxterm.mobatek.net/\n     (putty also works but isn't as \"nice\". )\nin MobaXTerm create an SSH session\ninput your ip address \"Remote Host\", and \"username\"  ubuntu (note that it's using port 22 as per our SSH rule for Security Groups above)\nconfigure it to use your keypair.pem file\nconfigure any other settings relevant to your situation\n\nOption 2)\nIf you don't know what this is go to Option 1: \nssh ubuntu@[ip.number] -i [thekey].pem\n\nCreate a normal user, with a username/password\nthen create a normal Linux user with e.g. sudo adduser normalusername and follow the prompts. \nThat normalusername should now be able to log in to the RStudio Server instance at http://ipaddress:8787 and also in the usual ways to the server. \n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmdsumner%2Fnectar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmdsumner%2Fnectar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmdsumner%2Fnectar/lists"}