OpenAthens LA support ended on 31 March 2020

Search

Skip to end of metadata
Go to start of metadata

You can activate the proxy server when you install, or you can add it later. In both cases the basic process is:

  1. Decide on the hostname, e.g. proxy.yourdomain.com
  2. Add the relevant certificates to your runtime(s)
  3. Configure networking
  4. Specify the proxy hostname in your configuration
  5. Publish

This page assumes you are using one runtime only.

Prerequisites

  • Access to the runtime server with the maint account
  • A suitable wildcard SSL certificate for your server - e.g. *.proxy.yourdomain.com
  • A suitable wildcard DNS record to route traffic - e.g. *.proxy.yourdoman.com

Method

  1. If you have installed on your own hardware, you may need to install the proxy module via yum. If you are working with our virtual machine images you can skip this step. The command would be:

    sudo yum install openathensla-proxy
  2. Add your wildcard certificate and key to the /etc/pki/tls/certs and /etc/pki/tls/private folders and set ownership and permissions as covered in the install documentation: Certificates on the runtime

  3. (Recommended) - add a second NIC to the virtual machine according to the instructions of your virtualisation platform.

    1. Configure the runtime to use the second NIC as well (covered in the install documentation: Configure networking for the runtime)

  4. Configure DNS to route traffic to the address that will be used by the proxy

  5. Specify the proxy hostname in the OpenAthens LA interface

    1. On the Configurations tab select your configuration and in the right hand panel go to the Proxy tab

    2. Enter your proxy hostname - e.g. proxy.yourdomain.com

    3. Apply



  6. Reattach your runtime(s)

    1. On the overview tab, select [each] runtime from the list, click the edit button and step through the wizard
    2. On the third page, set the different network connection for the proxy if you are using it
    3. Finish the wizard

  7. Publish

  8. Test - see PLACEHOLDER - LINK TO USING THE PROXY PAGE
  • No labels