Skip to content

Commit

Permalink
[REFACTOR:data-transfer] Further simplify presentation of sshfs
Browse files Browse the repository at this point in the history
  • Loading branch information
gkaf89 committed Jul 25, 2024
1 parent 0d178e5 commit a0c1904
Showing 1 changed file with 16 additions and 10 deletions.
26 changes: 16 additions & 10 deletions docs/data/transfer.md
Original file line number Diff line number Diff line change
Expand Up @@ -222,6 +222,8 @@ You can also consider alternative approaches to synchronize data with the cluste

### SSHFS

Install the requires packages if they are not already available in your system.

=== "Linux"
```bash
# Debian-like
Expand Down Expand Up @@ -249,23 +251,27 @@ sshfs [user@]host:[dir] mountpoint [options]

Proceed as follows (_assuming_ you have a working [SSH connection](../connect/ssh.md)):
```bash
# Create a local directory for the mounting point
mkdir -p ~/ulhpc # Your prefered mount point
sshfs iris-cluster: ~/ulhpc -o follow_symlinks -o reconnect -o dir_cache=no
# Create a local directory for the mounting point, e.g. ~/ulhpc
mkdir -p ~/ulhpc
# Mount the remote file system
sshfs iris-cluster: ~/ulhpc -o follow_symlinks,reconnect,dir_cache=no
```
Options used:
Note the leaving the `[dir]` argument blanck, mounts the user's home directory by default. The options (`-o`) used are:

- `follow_symlinks` presents symbolic links in the remote files system as regular files in the local file system, useful when the symbolic link points outside the mounted directory;
- `reconnect` allows the SSHFS client to automatically reconnect to server if connection is interrupted;
- `dir_cache` enables or disables the directory cache which holds the names of directory entries (can be slow for mounted remote directories with many files).

When you no longer need the mounted remote directory, you **must** unmount your remote file system:
```bash
# Linux
fusermount -u ~/ulhpc
# Mac OS X
diskutil umount ~/ulhpc
```

=== "Linux"
```bash
fusermount -u ~/ulhpc
```
=== "Mac OS X"
```
diskutil umount ~/ulhpc
```

## Transfers between long term storage and the HPC facilities

Expand Down

0 comments on commit a0c1904

Please sign in to comment.