Configuration

This page will take you step-by-step on how to setup the registry to be complete. Again this page will refernce Tomcat.

Context Name - is your webapp name (hence usually the unpacked directory name in the webapps). This will be used a lot in various documentation usually with curly brackets around it.

By default the registry runs a xml database inside the webapp where all the data is stored inside the webapp directory. It is STRONGLY RECOMMENDED to read the "eXist With Registry Guide" to explain on how to move the data outside your webapp to ensure no data is lost when upgrading later.

Changing Properties

First we need to change some properties in the environment entries.

  • Go to your Administration GUI known as "Tomcat Administration" and login. This link is on the main tomcat menu site http://{server}:{port} example on your local machine with default tomcat port is; http://localhost:8080
  • Go to your environment entries for your {context name} this is located at: Service->Host->Context {context name}->Environment Entries.
  • Now change the following properties (don't commit yet)
  • reg.amend.authorityid - Your main authority id for this registry, normally an institution domain name ex: mssl.ucl.ac.uk
  • reg.amend.harvest - *Only if you want registry to automatically harvest then set to "true"
  • reg.amend.identify.adminEmail - to your contact e-mail.
  • reg.amend.oaipublish.0.10 - *Only if your {context name} is not "astrogrid-registry" then change it.
  • That is all for properties, it is strongly recommended to read the "Users Guide" to understand other properties.

Setting up for data

DO NOT NEED TO DO WHEN UPGRADING

  • 1.) Go to the registry jsp page of "http://...../{context name}/admin/index.jsp" and do the first registration process to register this registry. This will in setup your first entry into your registry which is your Registry Type describing about this registry.
  • If you are setting up a local Registry and do not need a Full Registry and DO NOT WANT TO BE HARVESTED BY OTHER REGISTRIES then stop here, all your entries are complete and other client apps may submit Resources to this registry as long as it is a AuthorityID managed by this Registry. Notice that Registry Type you entered in step one had {managedAuthority} element tags this is what is read to determine what authority ids you are allowed to use.
  • Now it is time to register your new Registry to the rest of the world.
  • 2.) Do the Second link on "/admin/index.jsp" for registering your registry to a full registry.
  • Now if your not planning on being a Full Registry then stop here.
  • 3.)Finally do the Third link on "/admin/index.jsp" to become a full registry by grabbing all the registry types of a full registry.
  • 4.) Now the next time your harvest cycle happens it will begin harvesting these Registries, the first time it will harvest with no Date, and then after that it will harvest by date. Optionally there is a "/admin/harvestResource.jsp" to perform harvests on individual Registries.
  • You're done.