faq-remote_osx_access.md
... ...
@@ -0,0 +1,27 @@
1
+# Remote Access to OS X / MacOS Workstations
2
+
3
+Self-administered OS X / MacOS workstations on the SBGrid network can be configured for remote access (both command line and graphical).
4
+*You will need to be on the [SBGrid/CMCD VPN](faq-connecting-to-cmcd-vpn) to use this approach.*
5
+This will work from a local OS X / MacOS system (aka - a mac laptop).
6
+
7
+## Configuration
8
+This should be configured with terminal access to your workstation (either a local terminal window, or through ssh), and assumes that the you have administrative (sudo) access.
9
+
10
+- enable ssh access: `sudo systemsetup -setremotelogin on`
11
+- configure the system to restart on power failure: `sudo -setrestartpowerfailure on`
12
+- configure the system to wake on network access: `sudo systemsetup -setwakeonnetworkaccess on`
13
+- enable graphical remote access (*assumes that the user you run these commands as is the one who will be connecting locally*): `sudo /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Resources/kickstart -activate -configure -access -on -users $USER -privs -all -restart -agent`
14
+- record / remember the DNS hostname of your workstation, and your user name on that workstation.
15
+
16
+## Usage
17
+
18
+- Connect to [SBGrid/CMCD VPN](faq-connecting-to-cmcd-vpn)
19
+
20
+### Command Line (after connecting to VPN)
21
+- connect by ssh: `ssh $my_workstation_user_name@$my_workstation_hostname` (e.g. `ssh bob@ps-bob-macmini.in.hwlab`)
22
+
23
+### GUI (after connecting to VPN)
24
+- connect by vnc: `open vnc://$my_workstation_hostname`) (e.g. `open vnc://ps-bob-macmini.in.hwlab`)
25
+
26
+
27
+-