Overview

CloudShark runs on top of a CentOS or RHEL 7 Linux installation which meets our system requirements. The system can be bare metal hardware, a virtual machine, or on your public or private cloud infrastructure.

If you are installing via Docker, please refer to our Docker installation instructions.

Please note that CloudShark must be licensed for the system it is installed on. A temporary installation license will be granted to you while setting up your system. See our licensing page for more information.

Installation Instructions

To install or upgrade CloudShark, you will need the following:

  • A CloudShark installer binary downloaded from lounge.qacafe.com
  • An up-to-date CentOS 7 Linux system installed from the official CentOS-7 Minimal distribution.

Notes

Currently, CloudShark 3.9.x only supports CentOS 7.

The Installer

Copy the .run installer to you CentOS 7 system. The installer is a “makeself” binary that unpacks itself and executes a script. The following options are available:

./cloudshark-installer-v3.9.5.el7.run -- --help
Usage:

Install CloudShark

 -h, --help                  Display help for this command
 -l, --license license_file  License to copy to /usr/qacafe/licenses/
 -d, --debug                 Enable verbose output
 -f, --force                 Ignore errors

 --upgrade                   Do not prompt if this requires an upgrade from the
                             previous version. The default behavior is to prompt
                             the user to continue if an older version is detected.
 --with-threat               Install Threat Assessment Addon
 --repo-only                 Create the 'cloudshark' repository only
 --trust-yum                 Leave the yum repos that are enabled alone when
                             performing any actions. The default is to disable
                             everything but the new 'cloudshark' repository.

Note, a double-dash to separate makeself from the install-script’s options is required.

The installer creates a local repository on your disk and installs CloudShark as RPM packages via yum. All dependencies are included in the local repository and no internet connection is required.

Run the Installer

As the root user, change to the directory where you have copied the installer over, and make it executable:

chmod u+x cloudshark-installer-v3.9.5.el7.run

Install with Threat Assessment

If you have purchased the Threat Assessment package, or are doing a trial evaluation of CloudShark, append the --with-threat option to your CLI command:

./cloudshark-installer-v3.9.5.el7.run -- --with-threat

Without Threat Assessment

Customers without Threat Assessment do not need to install the additional packages. Run the installer without any additional arguments.

./cloudshark-installer-v3.9.5.el7.run

Upgrades

The installer will prompt you if an older version of CloudShark was detected and needs to be upgraded. If you wish to avoid being prompted, include the --upgrade option on the CLI.

./cloudshark-installer-v3.9.5.el7.run -- --upgrade

Getting a License

If you have a license file from the QA Cafe Customer Lounge that you wish to install at the same time, you may pass it to the installer with the --license flag to have it copied and enabled at the same time. This is not required.

If you do not yet have a license, please follow our CloudShark Licensing documentation for information on providing a Host-ID or getting access to a temporary installation license provided by Support.

Access the Web UI and Login

To access CloudShark, point a web browser at the system’s DNS hostname or IP address. The IP address can be determined by looking at the ouput of:

ip addr

If the system’s IP address is 192.168.1.100, then CloudShark can be accessed vi the URL:

https://192.168.1.100/

If the CloudShark system is running, you should receive a login page.

By default CloudShark listens on port 443 for HTTPS using a self-signed certificate. Here is more information about the default configuration and how to update this.

We encourage you to log in and explore your CloudShark system’s settings. The default user account and password for CloudShark are:

  • Username: admin
  • Password: cloudshark

After logging into CloudShark change the default password by going to Preferences -> Account in the upper right corner.

The admin account is a special account with additional functionality and privileges. Visit the Administration link in the top right-hand corner of the page to create additional user accounts and set system-wide preferences.

Need Help?

If you have any questions about the installation or configuration of CloudShark, or if you’re just curious about some of CloudShark’s features, please don’t hesitate to contact us. We can be reached via email at support@qacafe.com.