The ANDS Registry Software
is freely available as an open source project and can be installed on a modern web server in a matter of minutes. However, for Australian Researchers and Research Institutions, the NeCTAR Research Cloud
offers an even simpler method for setting up your own metadata registry.Note: This guide assumes familiarity with very basic system administration and launching a virtual machine from the NeCTAR Research Cloud. Your IT System Administrator should be familiar with these steps. If not, please consult the NeCTAR support documentation.Launching the ANDS Registry1. Log Into the NeCTAR Dashboard
If you are an eligible Australian Researcher, you will be able to log into the NeCTAR Dashboard:
Login at: http://dashboard.rc.nectar.org.au
(by using your institution's login - i.e. <yourid>@<yourinstitution.edu.au>
)2. Setup your VM Keypairs
If you haven't already, you will need to Setup your VM Keypair
on NeCTAR (this step is necessary so that you can log into the machine at a later date to manage it). 3. Select and launch the ANDS Image VM
Available images are listed under the dashboard Images tab. Select the "ANDS-MetadataRegistry-v11
" link and click "launch". You will see the launch page.
On the launch page, fill in the following options:
- Instance Name
(a name you would like to call this virtual machine)
- Access & Security -> Keypair
(the keypair you setup in Step 2 (above))
- Security Groups
(make sure that "http" and "ssh" are ticked)
Now click "Launch" -- within about a minute or two, the instance will be deployed and the system will supply you with an IP Address for your new server. Note: even after the instance has been "Deployed" by NeCTAR, the server still takes about a minute to boot up fully. 4. Start using your Metadata Registry
Now, simply visit your IP address (from the step above) in a web browser -- your new server instance will have been deployed.
Remember, you have now setup a virtual machine and will need to be responsible for system administration, maintenance and security. At a bare minimum, please run a server "yum update" as soon as you can (and continue to do regular updates and patches). Also, consult the NeCTAR Security Guidelines
- a default user is setup to access the registry (superuser / superuser) - you should update this password using the roles tool
- the operating system base is CentOS 6.4 (based on the official NeCTAR image - it has no iptables / selinux)
- an initialisation script runs in /etc/ands_init/ the first time the image is deployed to update it's config based on the new host IP address (it only runs for the first boot!)
- the default SSH user is ec2-user; your home directory is /var/www/html (where the Registry Software is primarily located)
- at time of writing, the following software is installed and configured to work with ANDS:
Apache HTTP (/var/www/html)
Note: at time of writing, ANDS-Harvester and the ANDS Vocabulary Server are not included in the image.
- there is a default mysql root password (see here) -- you should update this too!
You can update to the latest version of ANDS Registry Core by logging into ec2-user and executing a "git pull" (note: updates to major version may also require you to update the database/SOLR schema -- follow the ANDS-Registry upgrade instructions).Support
For VM support, please use NeCTAR support or their community support forums. For questions specific to ANDS software, please use our General Discussion area