Set up Hololight Hub prerequisites

Objectives

  • Be able to take a step in successfully installing Hololight Hub.

Prerequisites

  • Computer, physical or virtualized, for hosting Hololight Hub.

  • Hololight Hub setup wizard.

  • Hololight Hub license file.

  • Your own fully-qualified domain name, along with a domain certificate and corresponding private key

Set up prerequisites

Hololight Hub requires some third-party software installed in order to work. The Hololight Hub setup wizard will ask you which of these pieces of software you don’t already have installed and then guide you through the process of installing what you still need.

When setting up these prerequisites, be aware there are some pieces of information from the PostgreSQL setup that you need to save for future use. This is information isn’t easy to retrieve late, so make sure to save it somewhere.

  • Database server superuser password

  • Database server port number

  • Database cluster locale

Selecting prerequisites

  1. Select Next.
    hololight hub hub setup welcome

  2. Select which prerequisites you want to install. All of them are necessary for Hololight Hub to work, but may already be installed on the computer. When you are satisfied with your selection, select Next.

    If you installed any of these components previously, uncheck the checkbox next to those components you already successfully installed to prevent potential conflicts.

    hololight hub hub setup prerequisites

  3. The installing prerequisites screen will appear. While this is visible, setup wizards for all the previously selected prerequisites will appear one at a time.
    The windows for the third-party setup wizards may not appear where you can easily see them, so if you get stuck, try looking around your desktop for the next wizard.
    hololight hub hub setup prerequisites installing

Set up Java SE Development Kit

Hololight Hub uses Java in multiple instances, making it a necessary component for your deployment.

  1. If previously marked, the Java SE Development Kit setup wizard will appear. In this new window select Next.
    hololight hub hub setup prerequisites installing java welcome

  2. You have the opportunity to change the default destination folder for Java if needed. When you are satisfied with the target folder, select Next.
    hololight hub hub setup prerequisites installing java folder

    hololight hub hub setup prerequisites installing java installing

  3. Select Close.
    hololight hub hub setup prerequisites installing java complete

Set up PostgreSQL server

Hololight Hub uses an SQL database to keep track of necessary information relevant to its applications and users.

  1. If previously marked, the PostgreSQL setup wizard will appear. This will set up a PostgreSQL server to host your Hololight Hub database. In this new window select Next.
    hololight hub hub setup prerequisites installing postgresql welcome

  2. You have the opportunity to change the destination folder if needed. When you are satisfied with the target folder, select Next.
    hololight hub hub setup prerequisites installing postgresql installation directory

  3. Check the check boxes next to the components you want to install. PostgreSQL Server, pgAdmin 4, and Command Line Tools are all required. Stack Builder is not. When you are satisfied with your choices, select Next.
    hololight hub hub setup prerequisites installing postgresql select components no stack builder

  4. You have the opportunity to change the directory if needed. When you are satisfied with the target folder, select Next.
    hololight hub hub setup prerequisites installing postgresql data directory

  5. Enter a password for your database superuser, which by default is "postgres". You need to save this username and password pair to use later. When you are ready, select Next.
    hololight hub hub setup prerequisites installing postgresql password

  6. You have the opportunity to select a port other than the default if needed. Make sure to remember this port for a future step. When you are satisfied with the port, select Next.
    hololight hub hub setup prerequisites installing postgresql port

  7. You have the opportunity to select a specific locale if needed. When you are satisfied with the locale, select Next.
    hololight hub hub setup prerequisites installing postgresql advanced options

  8. Select Next.
    hololight hub hub setup prerequisites installing postgresql preinstallation summary

  9. Select Next.
    hololight hub hub setup prerequisites installing postgresql ready to install

  10. When the installation is complete, select Next.
    hololight hub hub setup prerequisites installing postgresql installing

  11. Select Finish.
    hololight hub hub setup prerequisites installing postgresql complete

Set up psqlodbc

Hololight Hub uses psqlodbc to allow components that require it, access to the database.

  1. If previously marked, the psqlodbc setup wizard will appear. For more information on psqlodbc, check out psqlODBC - PostgreSQL ODBC driver.

    In this new window check the checkbox next to I agree to the license terms and conditions and then select Next.
    hololight hub hub setup prerequisites installing psqlodbc license agree

    hololight hub hub setup prerequisites installing psqlodbc installing

  2. Select Close.
    hololight hub hub setup prerequisites installing psqlodbc complete

After prerequisite setup

After installing the prerequisites you will return to the Hololight Hub setup wizard. The prerequisite installer will show that it’s complete. Select Next.

Now that your prerequisites are set up, you can continue to setting up the Hololight Hub web server. Remember that you will need the database superuser password, database server port number, and database cluster locale later.