Research Platform Services Wiki

If you're a researcher, we'll help you do stuff.

User Tools

Site Tools


Sidebar

data_management:mediaflux:howto:unimelb-mf-clients

unimelb-mf-clients

Summary

These are a collection of Mediaflux clients developed at the University of Melbourne. They are mainly focused on moving data (uploads, upload checking, and downloads) to and from a Mediaflux server.

The main clients are called

  • unimelb-mf-upload - upload data to Mediaflux (restartable, efficient, checksums)
  • unimelb-mf-check - integrity check the data you uploaded to Mediaflux (i.e. make sure the source and destination are the same)
  • unimelb-mf-download - download data from Mediaflux (restartable, efficient)

University of Melbourne Spartan Users

Please note that these clients are pre-configured and available on the University's Spartan service.

Download

Download from the GitLab page.

  • Select the release for your platform (Windows/macOS/Linux) which includes an embedded Java distribution (recommended), or get the pure Java release which requires a local Java distribution (tested on Oracle Java 1.8).

Install

  • Unpack the download (a zip file) by double clicking on it via a GUI (or using a CLI unzip tool such as unzip on Unix systems)
  • Move the unpacked directory (named like unimelb-mf-clients-0.3.8) to wherever you'd like to keep it long term. E.g. the Desktop for Windows, or a ~/bin folder (on Unix systems like Linux and OSX)

Configure

Access to the Mediaflux server is managed via a configuration file which you must create and populate appropriately.

Add to your PATH

Optionally, you can add the commands to your PATH so that you can run them from any directory.

Using The Clients

  • Execute the client of interest on the command line and supply it the arguments that you need. See the specific examples below.
    • On Windows, the clients can be run from Windows PowerShell or the Command Prompt. You can start these by pressing the Start button and typing powershell or cmd.
    • On macOS, the clients can be run from the Terminal (Applications → Utilities → Terminal).
    • On Linux, you can execute the clients from any terminal or shell prompt. Linux commonly allows you to launch a terminal with ctrl-alt-t.
  • unimelb-mf-download enables efficient, restartable download to the local host from Mediaflux
  • unimelb-mf-upload enables efficient, restartable upload from the local host to Mediaflux
  • unimelb-mf-check enables efficient directory comparison/verification between the local host file system and Mediaflux.
  • mexplorer is a shell wrapper of the interactive Arcitecta Java Explorer tool (does not use a configuration file)

More Information

data_management/mediaflux/howto/unimelb-mf-clients.txt · Last modified: 2019/10/31 14:53 by Neil Killeen