Prerequisites:

  1. Server procured per hardware/OS requirements 
    • RHEL 7 or CentOS 7
    • At least 25GB free (unutilized) space in the /var directory
  2. License file received from Narrative Science (it will be filetype .rli)
  3. Optional: trusted SSL certificate (although you can do the initial installation without one, and we will generate a self-signed certificate to install with)

Installation Steps:

  1. On the server you’re requested, execute these commands to pull down the install bash script and then to execute the install:
    • curl -sSL -o install.sh https://get.replicated.com/quill-oyster/stable/swarm-init
    • sudo bash ./install.sh
  2. Follow the prompts to enter the server’s IP address (if it’s not automatically detected), and whether the server will sit behind a proxy to access the internet
  3. Once the images are pulled down and the install bash script completes, open your browser and enter in the URL provided (e.g. http://10.64.46.60:8800)
  4. In your browser, follow the prompts to generate a self-signed certificate.
  5. Enter in the hostname of your machine. You also have the opportunity to upload a custom SSL certificate if you wish. You can instead opt to continue with the self-signed certificate that was already generated.
  6. Now upload the license file you received from Narrative Science (it ends in .rli)
  7. You now have the option to secure the Admin Console to ensure only trusted parties can log-in. We recommend proceeding with a password (do not proceed with no password protection), and you can later integrate your LDAP more deeply into this Console.
  8. Preflight Checks will now run to ensure your server is ready, per the preinstallation requirements. Please heed the actions for any warning or failed checks. If everything looks good, click Continue.
  9. You’ll be brought to the Settings page, where you can edit the Hostname you entered previously, along with any other configuration values you may need. Click Save to continue.
  10. You’re then brought to the main Dashboard, where the services are being installed (top-left tile).