Legacy Installation
CloudShark Enterprise 4.0.0 and later is distributed as an OVA virtual machine image. These legacy instructions should only be followed after contacting support@qacafe.com for assistance.
If you already have CloudShark Enterprise installed on a virtual machine, please follow the OVA Migration instructions to upgrade.
CloudShark runs on top of a RHEL-based 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.
Instructions
To install or upgrade CloudShark, you will need the following:
- A CloudShark installer binary downloaded from lounge.qacafe.com
- An up-to-date RHEL/Rocky 8 Linux system installed from the official minimal distribution.
The Installer
Copy the .run installer to your Linux system. The installer is a makeself binary that unpacks itself and executes a script. The following options are available:
./cloudshark-installer-v4.0.0.el8.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.
--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-v4.0.0.el8.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-v4.0.0.el8.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 output 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.