Skip to content

Warnings

Jump to bottom
Zer0CoolX edited this page Apr 28, 2020 · 6 revisions

Warnings

The Apache Guacamole install script is intended to be used under certain circumstances. It's important to understand what these circumstances are, what the script does/does not do and what to expect before attempting to use it.

The biggest warning: By using this instillation script you are doing so at your own risk. There is no warranty or guarantee implied or expressly given. You are responsible for ensuring that if you do chose to use this script, you test it in a safe environment and ensure it works for your needs. No one is responsible if you chose to use this script and lose data, work, time, etc.

Critical I highly recommend first testing this script in a test environment, like a VM until you are comfortable with the process and are positive it will work in your environment. I suggest setting up a VM and taking a snapshot prior to running the script. If the script fails, you may restore the snapshot and attempt the installation again.

Further:

  • The script is intended to be run on RHEL and CentOS 7.x and up ONLY.
    • I only test the script on the latest stable RHEL and/or CentOS release. This means older 7.x revisions may stop being compatible without warning.
  • It is meant to be installed on a clean/fresh install of RHEL or CentOS. Trying the script on a server running other software, especially with any overlap of the software setup by the script will likely have negative results.
  • If the script fails for any reason, you cannot simply re-run the script again. The script does not cleanup after itself should the install fail and it does not account for partial configurations. You may attempt manual cleanup of all the completed actions of the script or, what I recommend, is to do this on a system in which you can restore a snapshot to re-attempt installation.
  • Be sure you have read the documentation and understand the script, prompts and goals prior to running the script.

Other Things to Know

  • The script runs yum update.
  • The script requires SELinux (SEL) be active and in "Enforcing mode".
  • The script requires firewalld to be installed.
  • The script opens the firewalld ports required for HTTP and HTTPS services as well as ports 8080/tcp and 8443/tcp on the server.
  • The script requires being run as sudo/root
Clone this wiki locally