Public Registry Virtual Machine

This document describes how to setup and use the copy of the Public Registry that is delivered as a Virtual Machine.

At Connectathons I bring a small server running VMWare. Under VMWare is three virtual machines called Red, Green, and Blue. These are identical VMs that contain the Public Registry code and a current copy of XDS Toolkit. When I say identical I mean that Green and Blue were created by cloning Red which is always the master copy.

System preparation

MAC system running VMWare Fusion version 8.1 or later.

Download

The download is found here.

Installation

Unzip the download on your MAC. Go VMWare Fusion, open the File menu -> Open and select the PubReg.vmwarevm file produced by unzip. You should be able to start the VM from the VMWare management window.

The primary account name on the VM is bill (password is gaithersburg) and the home directory for this user holds many useful items:

bin - collection of shell scripts for starting/terminating key services

tomcat7 - tomcat which runs XDS Toolkit and the front half of the Public Registry

tomcat2 - tomcat which runs the back half of the Public Registry.

tmp/toolkit2 - external cache (supports Toolkit)

tomcat7/webapps/ROOT/index.html - this is the server home page. It resides at http://localhost:9080. It will need to be updated for local events.

Configure network

This VM is Ubuntu Linux so there are many online guides for managing the system. The network configuration is kept in the file

/etc/network/interfaces  

As delivered it is configured with a static IP address which is appropriate given that it is a server. After network configuration changes the system should be rebooted to make changes take affect

sudo shutdown -r now

Start server

cd ~/bin
./prup

Stop server

cd ~/bin
./prup

Launch the home page

The home page is found at

http://localhost:9080

which has the system configuration and pointers to various services. Before this page is useful you must edit the IP address to match your network configuration. I usually do this with vim and the :1,$s/oldip/newip/ command. After the edit reload the page in your browser.

You should be able to bring up XDS Toolkit from its link at the top of the page. Open Toolkit Configuration (found at the top of the home page). The default password is history. Update toolkit host to match your configuration.

I use raw IP address at Connectathons instead of DNS names because 
there are some who do not configure their DNS.