.. _network_file_access:

|

:Last modified: |today|

Please help me make this page better! Send recommendations to support-neuro@berkeley.edu.

|

==================
Mount cluster data
==================
You may mount data from the Neuro Cluster to your desktop, which is important if you want to run software that doesn't exist on the Neuro Cluster. However, if you want me to install software on the Neuro Cluster, please don't hesitate to email support-neuro@berkeley.edu to request it. 

----------------------------------------------------------------------------------------------------------------
sshfs
----------------------------------------------------------------------------------------------------------------
sshfs is a program to securely access network data. It's available for Mac and linux.

.. _commandline:

#. If you haven't done so already, then enable :ref:`2-step authentication<mfa>`

#. Open a terminal window

#. Choose from a host in the table below. I recommend choosing a host with the fewest Users.

        .. image:: x2go/images/listsessions.png
            :alt: host load
            :scale: 100 %

#. Choose a destination directory. If the directory doesn't exist, then make it::

        mkdir /path/to/local/directory

   For example, create a directory on my Mac called 'neurocluster-joe'::

        mkdir -p ~/neurocluster-joe

#. Mount the Neuro cluster directory via sshfs::

        sshfs -o idmap=user username@host:/path/to/neurocluster/directory /path/to/local/directory

   For example mount /home/despo/joe (on the Neuro cluster) to the ~/neurocluster-joe directory (on the Mac)::

        sshfs -o idmap=user joe@nx2.neuro.berkeley.edu:/home/despo/joe ~/neurocluster-joe

#. when you're finished, unmount the local directory with the 'fusermount -u' command::

        fusermount -u /path/to/local/directory

   For example::

        fusermount -u ~/neurocluster-joe

----------------------------------------------------------------------------------------------------------------
graphical interface
----------------------------------------------------------------------------------------------------------------
Below are instructions to install OSXFuse and MacFusion for Mac OSX.

.. _osxfuse-install:

#. If you haven't done so already, then enable :ref:`2-step authentication<mfa>`

#. Open a terminal window

#.  Use the command-line 'ssh' program to generate a SSH key fingerprint of the server::

        ssh username@nx2.neuro.berkeley.edu

    For example::

        [joe@mac ~]$ ssh joe@nx2.neuro.berkeley.edu
        The authenticity of host 'nx2.neuro.berkeley.edu (169.229.248.250)' can't be established.
        RSA key fingerprint is 1d:96:75:1b:dc:e1:11:d3:39:78:5f:cc:4d:3c:02:c4.
        Are you sure you want to continue connecting (yes/no)? 


#. download the latest "OSXFUSE-{version}.dmg" from `osxfuse.github.com <http://osxfuse.github.com/>`_. 

#. double-click on "Install OSXFUSE {version}".

   .. image:: images/osxfuse/installer.png

#. After successful installation, remove the .dmg and .pkg files

#. Download Macfusion from `macfusionapp.org <http://macfusionapp.org>`_.

#. Double click on the downloaded file to extract Macfusion to your Desktop.

#. Drag this application into your Applications folder, then double-click to launch it. 

#. Open Macfusion.  

#. Click the plus menu, then select SSHFS to add a new SFTP target.

#. Create a target for the directory you want to access. Normally this is your home directory, but it can be any directory you have permission to access. Below is an example configuration:

  * Title: HWNI home directory
  * Host: nx2.neuro.berkeley.edu
  * User Name: joe
  * Password: Leave this blank
  * Path: Normally you may leave this blank. To access a group directory, specify the full path to the group directory , e.g. '/home/lab/COMMON'. 

.. image:: images/macfuse/macfusion1.png