/numishare-vagrant

A packaged Numishare for Vagrant users

Primary LanguageShell

Numishare-Vagrant

A pre-packaged Numishare for Vagrant users.

Pre-requisite

Install Vagrant.

Vagrant depends on a VM engine. For local development on the Mac, I use VirtualBox. VirtualBox also works on Windows. There are Vagrant providers for AWS VMs and IBM Cloud, among others, if you wish to run Numishare on a cloud.

Running Numishare

Recommended: edit vagrant/tomcat-users.xml to supply an admin password first.

cd vagrant
vagrant up

Once Vagrant-Numishare is up and running, you may browse to Numishare at http://localhost:8080/orbeon/numishare/admin/. From there you may create a collection. When creating a collection, use the Tomcat role collection1.

You may also visit http://localhost:8983/solr/#/numishare/core-overview and http://localhost:8888/exist/.

Loading databases

After you have created a collection interactively you will be able to interactively add coins.

You may also add coins using an API. The coins must be in NUDS XML format.

EXIST_HOST=localhost:8888
COLLECTION=collection1
EXIST_USER=admin
EXIST_PASSWORD=...
for filename in nuds/*.xml; do
   curl -v --user "$EXIST_USER":"$EXIST_PASSWORD" http://"$EXIST_HOST"/exist/rest/db/"$COLLECTION"/objects/ --upload-file "$filename"
done 

If the data you wish to load isn't already in NUDS format you may be interested in contributing to csv-nuds, a project aiming to convert the CSV output of spreadseets and databases into NUDS.

Mantainence

To back up the database log in to http://localhost:8888/exist/apps/dashboard/admin# Choose backup, zip. You can download it via the browser after creating it. The file is created in the $EXIST_HOME/data/export directory.