View unanswered posts | View active topics It is currently Tue May 21, 2019 11:27 am

All times are UTC + 10 hours [ DST ]

This topic is locked, you cannot edit posts or make further replies.  [ 1 post ] 
[Guide] Launching ANDS Registry as a NeCTAR Cloud Instance 
Author Message
ANDS Staff
User avatar

Joined: Mon Jan 24, 2011 4:11 pm
Posts: 7
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 Registry

1. Log Into the NeCTAR Dashboard
If you are an eligible Australian Researcher, you will be able to log into the NeCTAR Dashboard:
Login at: (by using your institution's login - i.e. <yourid>@<>)

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.

Helpful information:
  • 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:
    CentOS 6.4
    Apache HTTP (/var/www/html)
    ANDS-Registry-Core (/var/www/html)
    ANDS-Registry-Contrib (/var/www/html/applications/apps/)
    MySQL Server
    PHP 5.3
    Tomcat6 (/var/lib/tomcat6)
    SOLR (/usr/local/solr/)

    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).


For VM support, please use NeCTAR support or their community support forums. For questions specific to ANDS software, please use our General Discussion area.

Ben Greenwood
Technical Lead, Services
Australian National Data Service

Interested in ANDS software? Check out:

Mon Nov 25, 2013 1:12 pm
Display posts from previous:  Sort by  
This topic is locked, you cannot edit posts or make further replies.   [ 1 post ] 

All times are UTC + 10 hours [ DST ]

Who is online

Users browsing this forum: No registered users and 1 guest

You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
Powered by phpBB® Forum Software © phpBB Group
Designed by ST Software for PTF.