Upgrading from CloudShark 3.8 to 3.9
CloudShark 3.9.5 has the same feature set as CloudShark 3.8.3 but revamps how our software is downloaded,
installed and licensed. The changes made under the hood make licensing much more flexible,
installation easier, and managing data on your disk a lot cleaner.
This update is powered by the new QA Cafe Customer Lounge,
which has replaced the CloudShark Lounge that served us well over the last 10 years.
Step 1. Accessing the QA Cafe Customer Lounge
The QA Cafe Customer Lounge at lounge.qacafe.com uses passwordless authentication. Enter your email address and a one-time login link will be sent to you. If you need an account, you can request one from the login page.
Download your license
Our licensing mechanism has completely changed, and license files from CloudShark 3.8.3 and older are no longer supported in CloudShark.
A temporary license is available for download from the QA Cafe Customer Lounge. This license is good for 14-days from when you first download it. If you need additional time, please contact Support.
Step 2. Install or Upgrade CloudShark
To upgrade CloudShark, you will need the following:
- A 3.9.5 installer downloaded from lounge.qacafe.com
- A temporary license
- A CentOS 7 Linux system
CloudShark 3.9.5 requires a CentOS 7 Minimal installation. If you require CentOS 8 or RHEL 8 binaries, please contact support for an updated timeline.
Backup Your Current Installation
Important: We recommend taking a backup or snapshot of your VM prior to changing any system configurations or installing or upgrading any software, including CloudShark. Rolling back to a snapshot is the only supported “undo” mechanism.
.run installer and temporary license from the email to your system. The installer is a “makeself” binary that unpacks itself and executes a script.
The installer creates a local repository on your disk and installs CloudShark as RPM packages via
yum. All the necessary dependencies are included and no internet access is required.
Run the Installer
./cloudshark-installer-v3.9.5.el7.run -- --license path/to/cloudshark.lic
If you have purchased the Threat Assessment add-on, include the
-- --with-threat option, otherwise, omit it.
If the installer detects an existing version of CloudShark, it will prompt you to confirm upgrading it in place. You can provide the
--upgrade flag to suppress this prompt.
An upgrade will remove all old versions of CloudShark, relocate preferences and configuration files to their new locations, perform a database migration to update file information, and symlink your PCAP data directory to it’s new location.
If you have added custom TLS certificates to the nginx config, will need to move the certificate and private key files to the following locations,
- Private Key:
and restart nginx:
systemctl restart nginx
For a more detailed breakdown of the changes please see the bottom of this document.
CloudShark 3.9 will be running on your system via HTTPS port 443. The default username is “admin” and the password is “cloudshark”. If this was an upgrade, your username and password has not been changed.
Step 3. Registering your system
A temporary license can be supplied by QA Cafe Support to allow you to install and
re-install CloudShark as many times as you need to get your system up and
running the way you want it. Please take this time to ensure that there are
no additional hardware or software changes necessary.
Once your system is stable, you must register it with QA Cafe Support.
CloudShark uses our new QA License Application (QALA) which was installed and
running on HTTPS port 5050 on your system.
Open your web browser and point it at
https://<your-cloudshark-ip>:5050/. (You may need
to add a security exception in the browser to allow the self-signed certificate.)
Access is password-protected. Enter: “qacafe”
When you log in, you will see the following screen:
Click on the “Register a new license” button to view the registration information. This takes the form of a hexadecimal Host ID.
Please copy and paste the host ID into an email to firstname.lastname@example.org and our staff will register your permanent license. Once they have fulfilled your request, your license will appear on the QA Cafe Lounge and be available to download.
Good news! This license is valid through the end of your MSA or subscription term. It does not need to be modified or updated with each new release of CloudShark.
Step 4. Install your new license
When you have your permanent license, return to QALA on HTTPS port 5050, and click the Upload .lic button. Select your license file, and upload it. Your license count should indicate it was "unchanged" because the production license replaces your temporary upgrade one.
Your new production license will be added to the bottom of the pool. Double-check that the support and expiration dates for your license match your current subscription or MSA terms.
Note: The temporary license will remain in-use and in the pool until CloudShark is restarted:
systemctl restart cloudshark-full
Double check that CloudShark is using the new license by going to the Appliance Setup → System Info page.
You are now setup with the new QA Cafe Lounge, running the latest CloudShark 3.9.4, and ready for all our future releases!
Customized Installations: Upgrade Details
The following is a detailed list of the steps happen during an upgrade. If you have customized your installation, some of these steps may need to be modified. We recommend you contact us to work through your upgrade.
To view the upgrade script, run the installer with the following options:
./cloudshark-installer-v3.9.5.el7.run --noexec --keep
The contents of the installer will be extracted to a new directory in the current path. The
upgrade.sh scripts will give you details about the following steps:
- The CloudShark application is stopped
- All yum packages matching cloudshark-* are removed along with their dependencies. Local databases remain untouched.
- The online
cloudshark repo is removed from the yum configuration
- A new local repository containing only 3.9.5 is extracted onto your local disk
- CloudShark is installed from this local repository.
- Configuration files are copied to their new locations under
- Your PCAP upload directory is symlinked to
database-upgrade utility rewrites the path to all the uploaded PCAP files, and inserts the SHA1 sum from the
cap_files table. It can be reversed by running