Installation

Clone (or pull) the latest code for the Remote Data Toolbox with Git:

git clone https://github.com/isetbio/RemoteDataToolbox.git

Add the RemoteDataToolbox folder and sub-folders to your Matlab path.

For most people, this is all you will have to do.

Java

In some cases, as the software evolved, we had to deal with compatibility between gradle and java versions. The modern gradle software requires at least java 8 and perhaps even 9.

MAC

We had difficulty doing the java install on MacOS, but what worked was using brew to install java.

brew cask install java

Installation requires the su password, but it produces this output upon success.

==> Caveats
This Cask makes minor modifications to the JRE to prevent issues with
packaged applications, as discussed here:

  https://bugs.eclipse.org/bugs/show_bug.cgi?id=411361

If your Java application still asks for JRE installation, you might need
to reboot or logout/login.

Installing this Cask means you have AGREED to the Oracle Binary Code
License Agreement for Java SE at

  https://www.oracle.com/technetwork/java/javase/terms/license/index.html

==> Satisfying dependencies
==> Downloading http://download.oracle.com/otn-pub/java/jdk/9.0.4+11/c2514751926b4512b076cc82f959763f/jdk-9.0.4_osx-x64_bin.dmg
######################################################################## 100.0%
==> Verifying checksum for Cask java
==> Installing Cask java
==> Running installer for java; your password may be necessary.
==> Package installers may write to any location; options such as --appdir are ignored.
==> installer: Package name is JDK 9.0.4
==> installer: Upgrading at base path /
==> installer: The upgrade was successful.
🍺  java was successfully installed!

To verify you can type

java -version
java version "9.0.4"
Java(TM) SE Runtime Environment (build 9.0.4+11)
Java HotSpot(TM) 64-Bit Server VM (build 9.0.4+11, mixed mode)

Linux

On linux you will need to make sure that you have openjdk-8 installed and configured. The way you do this depends upon your distribution of linux.

For Ubuntu distros >= 14.10:

sudo apt-get install openjdk-8

For Ubuntu distros <14.10 (tested with 14.04):

sudo add-apt-repository ppa:openjdk-r/ppa
sudo apt-get update
sudo apt-get install openjdk-8-jdk
sudo update-alternatives --config java
sudo update-alternatives --config javac

Test the installation

If you are an ISETBIO user, try running the the code in the Connecting and Downloading (ISETBIO) sections.

For other users, there are 4 example scripts in the RemoteDataToolbox/examples folder.

• brainard-archiva/rdtExamplePublishData.m shows how you can create some data locally, upload it to our demo repository, and view the data in your web browser. This example uses image data, so it's easy to view.

• brainard-archiva/rdtExampleReadData.m follows the previous. It shows how you can download data from our demo repository -- in this case the image you just created.

• brainard-archiva/rdtExampleQueryRepository.m shows how you can use the Remote Data Toolbox to list and query artifacts that live in our demo repository.

• maven-central/rdtExampleMavenCentral.m shows that Remote Data Toolbox can access other data repositories, not just our own server. In this case it accesses a repository called "Maven Central" which stores lots of open-source Java stuff.