1. Prerequisites
2. Install
3. Connect
4. Known Issues
   1. Open File - Security Warning
   2. Web Page - Forbidden
   3. OpenVPN Service failed to start
   4. Error creating HKLM\\SOFTWARE\\OpenVPN-MI-GUI key
   5. Internet Explorer Security Warning - Mixed Content

Prerequisites

Riverstick is only supported by CAS ITS on Windows 7 or later. Watching of video is only supported in Internet Explorer 8 or higher. QuickTime is required to view recordings; the version is irrelevant.

Computers must be approved prior to being allowed to connect to the Riverstick VPN. Approval is done only by:

1. Psychology Clinic Director (Randall Cox)
2. Psychology Clinic Manager (Carla Houser)

Check with the Psychology Clinic Manager first.

Install

CAS IT STAFF This procedure is currently not working, check the tech notes for manual install instructions

If you need Riverstick installed contact CAS IT at 940-565-4498

Installation of the Riverstick VPN is automated through Software Center for authorized computers.

If you're running Windows 7 or 10, you'll need to look for the Riverstick VPN Program Name

If it's blank, simply select it and click Install. If it's listed as failed, contact the CAS ITS Helpdesk.

Connect

After the Riverstick VPN is installed on your computer, you will have a new icon in your Start Menu, as shown below for Windows 10

Turn this into a Desktop Shortcut.

Additionally, you'll notice a Local Area Connection is labeled as unplugged, in your Notification Area, as shown:

This icon can be hidden.

In order to connect, simply do the following:

1. Right Click the OpenVPN MI GUI icon in the Notification Area.
   The Riverstick VPN shortcut that is in your Start Menu is only used to make the OpenVPN MI GUI icon in the Notification Area, in the event that you accidentally exit. The OpenVPN MI GUI icon will appear in the Notification Area automatically everytime you logon.
2. Left Click Connect, as shown:
   
3. Enter your Riverstick credentials when prompted, as shown:
   
4. Notice that the status window will scroll while the connection is being established. The status window will minimize when it's completed and you'll be notified that Riverstick is now connected, as shown:
   

If you see any variation to this, please check the Known Issues below. If your issue isn't listed, please contact the CAS ITS Helpdesk.

Known Issues

1. Open File - Security Warning
   No Fix Planned, for WinXP
   • Problem:
     A warning may appear the first time that you login or run the OpenVPN GUI shortcut on your desktop, as shown:
     
     CAS ITS has verified this executable and is confident in its usability.
   • Resolution:
     To prevent this Security Warning from continuously showing up, simply:
     1. Verify the Name and From match the picture above.
     2. Uncheck the Alway ask before opening this file checkbox.
     3. Click the Run button.
2. Web Page - Forbidden
   • Problem:
     The UNT Psychology Riverstick web page returns the following error:
     Forbidden: You don't have permission to access /users/ on this server.
   • Cause:
     Your computer's IP address is not on the list of IP addresses that are allowed to connect to that server.
   • Resolution:
     1. Contact us if you need assistance determining what your IP address is.
     2. Contact the Psychology Clinic Administrative Staff to have your IP address added to list of IP addresses that are allowed to connect to that server.
3. OpenVPN Service failed to start
   Fix already implemented for 99% success.
   1. The OpenVPN MI GUI may post an error, as shown:
      
      This error will only occur under two circumstances:
      1. If user logs into a domain other than the UNT domain (i.e.: Students).
      2. If the Service Stops/Fails unexpectedly.
   2. To resolve this issue, you can do one of three options:
      1. Reboot the Computer.
      2. Log off and Log back in.
      3. Start the Service.
         1. Make sure the OpenVPN MI GUI icon is not running in the system tray.
         2. Click the Start Menu.
         3. Click Run.
         4. Enter cmd /c net start "OpenVPN Service" in the Open field, exactly as shown:
            
         5. Click OK.
         6. You will see a black window appear for a couple seconds indicating that the OpenVPN Service is starting, as shown:
            
         7. Double Click the OpenVPN GUI shortcut on your desktop. The error shouldn't appear this time. If it does, contact the CAS ITS Helpdesk.
4. Error creating HKLM\\SOFTWARE\\OpenVPN-MI-GUI key
   Fix already implemented for 99% success.
   1. The OpenVPN MI GUI may post an error, as shown:
      
      This error occurs when the OpenVPN MI GUI failed to launch during the install, cause unknown.
   2. Contact the CAS ITS Helpdesk and have them run the OpenVPN MI GUI as an Admin once. The issue will not persist for all other users of the computer after this.
5. Internet Explorer Security Warning - Mixed Content
   Fix already implemented for Win7. WinXP users must do as shown -- for now.
   1. when attempting to view a Live or Recorded session, you might receive a Security Warning, as shown:
      
      This occurs because the Riverstick page is loaded securely (https), but after the video passes through the VPN, it is decrypted and arrives at the QuickTime plugin insecurely. This violates best practices, but isn't a risk.
   2. To view your video, click: No