Getting Started
Automatic installation#
If your system runs on:
- Ubuntu Linux
CentOS/Red Had Linux- macOS (requires homebrew)
You should be able to proceed with the automatic installation:
Piping to bash
You should be very worried when someone asks you to do what I just did. Downloading a bash script from the internet and piping it to bash with root privileges is a terrible idea, unless you fully trust the source. Please don't trust me - go look at the code and determine for your self if it's safe to execute. If you feel it's not, please proceed with the manual installation (and tell me why, so I can fix it).
Manual Installation#
System Dependencies#
Python#
hyperglass is written in Python 3 and requires Python version 3.6 as a minimum dependency.
If you're confident upgrading your system's version of Python won't break your system (many Linux operating systems rely heavily on Python for package management and other system functions), you can install Python 3.6:
- Debian/Ubuntu
- RHEL/CentOS
Documentation for CentOS is still in-progress. However, it's been determined that these dependencies may also be required, depending on the version of CentOS:
Until further testing with CentOS can be done, you should install the above dependencies before installing Python 3. You may have to uninstall and re-install Python 3 if these dependencies weren't already installed.
You can install python from the CentOS 7 repository:
But you can also use the SCL repository
You can then verify your Python 3 version:
Other Dependencies#
The hyperglass UI is written in ReactJS. As such, some Javascript dependencies are required. hyperglass also relies on Redis for caching purposes.
- Debian/Ubuntu
- RHEL/CentOS