Mediaflux data collections can be accessed as a network share via the SMB (Server Message Block) protocol.

...

• Finder (Go -> Connect to Server...) )
  The username will be domain\username (see screenshots below)

  Code Block
  language text
  smb://mediaflux.researchsoftware.unimelb.edu.au/proj-testproject-1128.3.12

  
  

• Terminal - using the command-line mount command, the syntax is of the following form (including the domain, e.g. unimelb and user e.g. mfuser )
  

  Code Block
  language bash
  mount -t smbfs //unimelb\;sclaus@mediaflux.researchsoftware.unimelb.edu.au/proj-testproject-1128.3.12 /Users/mfuser/smb_mount

   where the last part is an empty directory you have created on you computer to receive the SMB mount point.
  
  

• Terminal with a secure identity token.  Macos uses the following syntax for connecting to SMB volumes on the CLI:

  • mount -t smbfs //[domain;]user[:password]@server[/share] path

• Note that the semicolon character will be interpreted by the zsh shell, so we need to surround the path with quotes.  When using a token, we want the password to be blank, so we specify the : with nothing following it.  For example:

  • domain: token
  • replace <your token code here> with your actual secure identity token
  • replace proj-testproject-1128.3.12 with your actual project
  • /Users/mfuser/smb_mount with the location of your mount point (where the files on the server will appear).  You may need to create this with the mkdir command.
    

• Example:
  

  Code Block
  language bash
  mount -t smbfs '//token;<your token code here>:@mediaflux.researchsoftware.unimelb.edu.au/proj-testproject-1128.3.12' /Users/mfuser/smb_mount

  
  

Linux

Use forward slashes in the path. 

• Using the smbclient command (similar to an FTP client), the syntax is of the following form (including the domain, e.g. unimelb and user, e.g. mfuser):

  Code Block
  language bash
  smbclient //mediaflux.researchsoftware.unimelb.edu.au/proj-test-project-1128.3.12 -W unimelb -U mfuser

  
  

• Using GNOME Files (AKA Nautilus): Other Locations -> Enter Server Address...
  

  Code Block
  language text
  smb://mediaflux.researchsoftware.unimelb.edu.au/proj-testproject-1128.3.12

  This will prompt you for your domain (generally unimelb or student), username and password.
  
  

• Using the command-line mount command the syntax is of the following form (including the domain, e.g. unimelb and user e.g. mfuser ).  Use the id command to find your uid and gid, and insert those into the mount options.
  

  Code Block
  language bash
  mkdir ~/mnt sudo apt install cifs-utils # provides the cifs mount helper (mount.cifs) sudo mount -t cifs -ouser=mfuser,domain=unimelb,uid=$UID,gid=$(id -g) //mediaflux.researchsoftware.unimelb.edu.au/proj-testproject-1128.3.12 $HOME/mnt

  Note: the uid, gid, file_mode and dir_mode options will control the local permissions on the files and directories inside the mount point.  In the example above, the uid and gid are set to the user who is running the mount command, but this may not work if you're mounting with one user and need to access the files as another user.  See the Users and Groups page on ArchWiki and use the man mount.cifs command on your local machine for more information.
  
  

• If you wish to use Kerberos authentication from the command line, you will need some additional software:

  Code Block
  language bash
  sudo apt install krb5-user keyutils

  Then you can log in using the kinit command, and then pass the cruid to the mount command instead of specifying the username, domain and password.

  Code Block
  language bash
  mkdir ~/mnt kinit mfuser@UNIMELB.EDU.AU sudo mount -t cifs -o cruid=$USER,sec=krb5,uid=$UID,gid=$(id -g) //mediaflux-test.researchsoftware.unimelb.edu.au/proj-test-1247.5.1 $HOME/mnt

  
  

• If you are using a secure identity token

  Code Block
  language bash
  mkdir ~/mnt sudo apt install cifs-utils # provides the cifs mount helper (mount.cifs) sudo mount -t cifs -ouser=<your token string>,domain=token,password='',uid=$UID,gid=$(id -g) //mediaflux.researchsoftware.unimelb.edu.au/proj-testproject-1128.3.12 $HOME/mnt

  
  

Authentication

If your computer is a University MOE (Managed Operating Environment), you won't need to enter your credential when you map the network drive on Windows or connect to the server (macOS). Your computer will supply your credential and log you in automatically because you have already logged in to your computer via the University domain.

...

If you have recently changed your University of Melbourne password, then it will be important to manually disconnect (and then reconnect) any previously-mounted SMB shares. Otherwise, these drives may continue to authenticate using old/legacy credentials - which can lead to account lockouts (due to repeated unsuccessful connection attempts) in some cases.

Using a secure identity token

If you are connecting with a secure identity token, you would use the following:

• Domain: token
• Username: <your token string>
• Password: <leave blank>

If you cannot leave the password blank, you can enter the token a second time in the password field.

Examples

Windows 10

N.B. On Windows you cannot use two different accounts to mount two different shares from the same server.

For this example, we assume you are logged in to a University of Melbourne Windows 10 MOE with your University Credential.

...

• If you needed to use a different account to connect to Mediaflux than the one you're logged in to your computer with, check the box Connect using different credentials and enter your username in the form domain\username and click OK.  In the following example, a localstaff account is used where where the domain is called 'VicNode'

...

• unimelb', students should use the 'student' domain.  If connecting with a secure identity token, enter token\<your token> in the username field, and leave the password field blank.
  

Image Added

Apple macOS Finder

...

• Enter your username in the domain\username form, and your university password and click Connect.  If you are using a secure identity token, enter token\<your token> in the Name field and leave the password field blank.

The finder will now have a mounted drive with the contents of your project.

...

• Open GNOME Files (AKA Nautilus), and click Other Locations on the left pane.
• In the Connect to Server box, enter your SMB address, e.g. smb://mediaflux.researchsoftware.unimelb.edu.au/proj-demonstration-1128.4.15
• Click Connect
  

  

• You will be prompted to authenticate.  Enter your University username, domain (usually unimelb or student) and your University password.  If you are connecting with a secure identity token, enter the token in the username field, token in the domain field, and the token a second time in the password field.  Nautilus will not accept a blank password.
  
• You will see the network drive attached on the left pane, and the contents of the network drive.  You can press the "eject" button to disconnect.
  

...