Upgrade Instructions

Upgrading from CloudShark 3.8 to 3.10

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.10.0 installer downloaded from lounge.qacafe.com
  • A temporary license
  • A CentOS 7 Linux system
Notes

CloudShark 3.10.0 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.

The Installer

Copy the .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.10.0.el7.run -- --license path/to/cloudshark.lic

If you have purchased the Threat Assessment add-on, include the -- --with-threat option, otherwise, omit it.

Upgrading

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.

Custom Certificates

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,

  • Certificate: /usr/cloudshark/etc/tls-certificate/cloudshark.crt
  • Private Key: /usr/cloudshark/etc/tls-certificate/cloudshark.key

and restart nginx: systemctl restart nginx

For a more detailed breakdown of the changes please see the bottom of this document.

Accessing CloudShark

CloudShark 3.10 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.)

QALA Login Screen

Access is password-protected. Enter: “qacafe”

When you log in, you will see the following screen:

QALA License Screen

Click on the “Register a new license” button to view the registration information. This takes the form of a hexadecimal Host ID.

QALA HostID registration

Please copy and paste the host ID into an email to support@qacafe.com 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 SetupSystem Info page.

Congratulations!

You are now setup with the new QA Cafe Lounge, running the latest CloudShark 3.10.0, 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.10.0.el7.run --noexec --keep

The contents of the installer will be extracted to a new directory in the current path. The install.sh and upgrade.sh scripts will give you details about the following steps:

  1. The CloudShark application is stopped
  2. All yum packages matching cloudshark-* are removed along with their dependencies. Local databases remain untouched.
  3. The online cloudshark repo is removed from the yum configuration
  4. A new local repository containing only 3.10.0 is extracted onto your local disk
  5. CloudShark is installed from this local repository.
  6. Configuration files are copied to their new locations under /usr/cloudshark/etc
  7. Your PCAP upload directory is symlinked to /usr/cloudshark/data
  8. The 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 ./database-upgrade -reset