Remote Observing 
================ 

Remote observing allows you to run the observatory from any computer exactly as
if you were in the control room.  We use TightVNC remote desktop software to
access the observatory computer.  Because the computer is behind USTs firewall,
Off campus users will have create an SSH tunnel through the department server.  

Initial Setup
-------------
#. If you are off campus, :ref:`Set up tunneling<setup-tunnel>`   
#. Set up :ref:`Remote Desktop access <TightVNC-setup>`
#. Set up the :ref:`Webcam Software <setup-webcam>`

Begin a remote observing session at the observatory
---------------------------------------------------
#. If you are off campus, :ref:`start the SSH tunnel<start-tunnel>`
#. Run TightVNC Viewer.
#. Enter the observatory computer's address:   

    * On Campus

        .. image:: VNC_OnCampus.PNG

    * Off Campus

        .. image:: VNC_OffCampus.PNG

#. Click **Connect** and you should see the observatory computer desktop.

Access the Dome Webcam
----------------------
#. If you haven't already, :ref:`set up the webcam<setup-webcam>`
#. Start up the ReoLink client
#. Hovering the mouse over the image brings up a menu in the lower right.  Click
   the PTZ button to bring up the camera control dialog

   .. image:: Reolink_MainWindow.png

#. In the PTZ dialog, click the *Presets* button to bring up some useful preset positions

    .. image:: Reolink_PTZ.png

.. _start-tunnel:

Start the SSH tunnel
--------------------
#. If you haven't already, :ref:`set up tunneling<setup-tunnel>`.
#. Run MobaXTerm and select **Tunneling** from the ribbon  

    .. image:: MobaMain2_scaled.PNG

#. On the tunneling dialog, click the start button next to your observatory and 
   webcam tunnels.
 
    .. image:: MobaTunnel2p.PNG

#. Enter your password if asked.
#. That's it!  Your tunnel to the observatory is running!

.. _setup-tunnel:

Set up Tunneling
----------------
#. Install `MobaXTerm <https://mobaxterm.mobatek.net/>`_ 
#. Run MobaXTerm and select Tunneling from the ribbon 

    .. image:: MobaMain2_scaled.PNG

#. In the tunneling dialog, click the **New Tunnel** button  

    .. image:: MobaTunnel1p.PNG

#. Fill in the New Tunnel dialog as shown below.  In the username field, put in the username that you received from the observatory administrator.  

    .. image:: MobaNewTunnel_scaled.PNG

#. Give your new tunnel a name (like Observatory or Bob)
#. click the **New Tunnel** button again

#. Fill in the New Tunnel dialog as shown below.  In the username field, put in
   the username that you received from the observatory administrator.  

   .. image:: MobaNewTunnel2.PNG

#. Give your new tunnel a name (like Webcam or Other Bob)
#. Click the *Exit* button.

.. _TightVNC-setup:

Set up the TightVNC Viewer
--------------------------
#. Download and run the installer for `TightVNC <https://tightvnc.com/download.html>`_ .
#. Accept the License Agreement
#. On the **Choose Setup Type** screen choose **Custom**.
#. On the **Custom Setup** screen, deselect **TightVNC Server** since you likely do not want to make your computer available for remote access.  
   
    .. image:: VNC_ViewerOnly.png

#. Select the defaults for the rest of the installation.
#. TightVNC is ready to run!

.. _setup-webcam:

Set up Webcam
-------------
#. Download and install the `ReoLink Client <https://reolink.com/software-and-manual/>`_
#. Click the *Add Device* button in the upper right hand corner of the Reolink window

    .. image:: ReoLink1.png

#. Put in the IP address and the Port and click the *Add* button

    On Campus

    .. image:: Reolink_on_campus.png

    Off Campus

    .. image:: Reolink_off_campus.png

#. Enter the password when prompted.