Skip to content

Commit 1ed2ca0

Browse files
authored
Add more details about SSHFS mounting
1 parent 8756dda commit 1ed2ca0

File tree

1 file changed

+16
-2
lines changed

1 file changed

+16
-2
lines changed

docs/PrincetonUTutorial.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -213,16 +213,17 @@ A regular FRNN run will produce several outputs and callbacks.
213213

214214
Currently supports graph visualization, histograms of weights, activations and biases, and scalar variable summaries of losses and accuracies.
215215

216-
The summaries are written in real time to `/tigress/<netid>/Graph`. For macOS, you can set up the `sshfs` mount of the `/tigress` filesystem and view those summaries in your browser.
216+
The summaries are written in real time to `/tigress/<netid>/Graph`. For macOS, you can set up the `sshfs` mount of the [`/tigress`](https://researchcomputing.princeton.edu/storage/tigress) filesystem and view those summaries in your browser.
217217

218218
To install SSHFS on a macOS system, you could follow the instructions here:
219219
https://github.com/osxfuse/osxfuse/wiki/SSHFS
220220
Or use [Homebrew](https://brew.sh/), `brew cask install osxfuse; brew install sshfs`. Note, to install and/or use `osxfuse` you may need to enable its kernel extension in: System Preferences → Security & Privacy → General
221221

222-
then do something like:
222+
After installation, execute:
223223
```
224224
sshfs -o allow_other,defer_permissions [email protected]:/tigress/<netid>/ <destination folder name on your laptop>/
225225
```
226+
The local destination folder may be an existing (possibly nonempty) folder. If it does not exist, SSHFS will create the folder. You can confirm that the operation succeeded via the `mount` command, which prints the list of currently mounted filesystems if no arguments are given.
226227

227228
Launch TensorBoard locally (assuming that it is installed on your local computer):
228229
```
@@ -234,6 +235,19 @@ You should see something like:
234235

235236
![tensorboard example](https://github.com/PPPLDeepLearning/plasma-python/blob/master/docs/tb.png)
236237

238+
When you are finished with analyzing the summaries in TensorBoard, you may wish to unmount the remote filesystem:
239+
```
240+
umount <destination folder name on your laptop>
241+
```
242+
The local destination folder will remain present, but it will no longer contain the remote files. It will be returned to its previous state, either empty or containing the original local files. Note, the `umount` command is appropriate for macOS systems; some Linux systems instead offer the `fusermount` command.
243+
244+
These commands may be useful when the SSH connection is lost and an existing mount point cannot be re-mounted, e.g. errors such as:
245+
```
246+
mount_osxfuse: mount point <destination folder name on your laptop> is itself on a OSXFUSE volume
247+
```
248+
249+
More aggressive options such as `umount -f <destination folder name on your laptop>` and alternative approaches may be necessary; see [discussion here](https://github.com/osxfuse/osxfuse/issues/45#issuecomment-21943107).
250+
237251
#### Learning curves and ROC per epoch
238252

239253
Besides TensorBoard summaries you can produce the ROC curves for validation and test data as well as visualizations of shots:

0 commit comments

Comments
 (0)