Add How To User Merlin

pages/merlin7/02-How-To-Use-Merlin/connect-from-macos.md

@@ -0,0 +1,58 @@
+---
+title: Connecting from a MacOS Client
+#tags:
+keywords: MacOS, mac os, mac, connecting, client, configuration, SSH, X11
+last_updated: 07 September 2022
+summary: "This document describes a recommended setup for a MacOS client."
+sidebar: merlin7_sidebar
+permalink: /merlin7/connect-from-macos.html
+---
+
+## SSH without X11 Forwarding
+
+This is the standard method. Official X11 support is provided through [NoMachine](/merlin7/nomachine.html).
+For normal SSH sessions, use your SSH client as follows:
+
+```bash
+ssh $username@login001.merlin7.psi.ch
+ssh $username@login002.merlin7.psi.ch
+```
+
+## SSH with X11 Forwarding
+
+### Requirements
+
+For running SSH with X11 Forwarding in MacOS, one needs to have a X server running in MacOS.
+The official X Server for MacOS is **[XQuartz](https://www.xquartz.org/)**. Please ensure
+you have it running before starting a SSH connection with X11 forwarding.
+
+### SSH with X11 Forwarding in MacOS
+
+Official X11 support is through NoMachine. Please follow the document
+[{Job Submission -> Interactive Jobs}](/merlin7/interactive-jobs.html#Requirements) and
+[{Accessing Merlin -> NoMachine}](/merlin7/nomachine.html) for more details. However,
+we provide a small recipe for enabling X11 Forwarding in MacOS.
+
+* Ensure that **[XQuartz](https://www.xquartz.org/)** is installed and running in your MacOS.
+
+* For enabling client X11 forwarding, add the following to the start of ``~/.ssh/config``
+to implicitly add ``-X`` to all ssh connections:
+   
+   ```bash
+   ForwardAgent yes
+   ForwardX11Trusted yes
+   ```
+
+* Alternatively, you can add the option ``-Y`` to the ``ssh`` command. In example:
+
+   ```bash
+   ssh -X $username@login001.merlin7.psi.ch
+   ssh -X $username@login002.merlin7.psi.ch
+   ```
+
+* For testing that X11 forwarding works, just run ``xclock``. A X11 based clock should
+popup in your client session.
+
+   ```bash
+   xclock
+   ```