This chapter describes how to download the software and data files needed to install a Black Duck Air-gapped KnowledgeBase.

These files are located on the Google Cloud. To download the files, you must do the following tasks:

  1. Install Google command line tools.

  2. Activate your service account and download the files.

    Note: All the commands in this guide can be executed by the root user, or a user with sudo privileges.

Prerequisites

You need the following prerequisites to complete the tasks described on this page:

  • Computer with access to the internet

  • Portable storage with a minimum of 8 TB of storage, which is attached to the computer with internet access.

  • Google command-line tools, which you can install using the following command on an Ubuntu system:

    curl https://sdk.cloud.google.com | bash

  • The key file: kb-onprem.json that you receive from Black Duck Support. This file is required to activate your Google service account.

Note: Black Duck recommends that you consider an overnight schedule for this task as extracting the data will be a time-consuming process. Also, be aware of internet bandwidth requirements for this large download and consider downloading the artifacts overnight as the download size for the artifacts is about 5 TB.

Activating your service account

Activate your service account from the system you will use to download the software and data.

  1. Activate your Google service account.

    Locate the kb-onprem.json file on your system and run the following command:

    • gcloud auth activate-service-account --key-file=kb-onprem.json

    Expect to see the following message when you authenticate successfully:

    Activated service account credentials for:
[kb-onprem-ro@kb-onprem.iam.gserviceaccount.com]
    Note: If you have any issues authenticating, contact Black Duck support and include any error messages.

  2. Access and download the artifacts.

    The Google Cloud bucket is divided into two high level folders: software and data. Black Duck stores three software releases in the bucket, which consists of the Current_GA (latest) and two previous releases.

    To simplify the separation of KnowledgeBase artifacts from Black Duck artifacts, the software is shipped as the following three components:

    • KB Services: contains all artifacts necessary to build a KB Server.

    • Black Duck: contains all artifacts to build Black Duck Hub instance.

    • Orchestration: orchestration to bring up both, KB and Black Duck SCA instances.

    Tip: Black Duck recommends executing the download steps overnight to avoid waiting for the download to finish as the data artifacts are about 5 TB in total size.

    • If you are using portable storage, ensure that the portable storage is connected before downloading to that storage.

    • Black Duck recommends using tmux for this session because it's a time-consuming step.

    To download the latest version of the software, use the following commands:

    • gsutil cp -r gs://kb-onprem-us/2025.11/Orchestration <destination_path>

    • gsutil cp -r gs://kb-onprem-us/2025.11/KBServices <destination_path>

    • gsutil cp -r gs://kb-onprem-us/2025.11/BlackDuck <destination_path>

    Note: Replace 2025.11 with the current YYYY.MM. Run gsutil ls gs://kb-onprem-us/2025.11/Data/01 to see the data that exists in the 2025.11 release.

    To download the other data sets, use the following commands:

    • gsutil cp gs://kb-onprem-us/2025.11/Data/01/*tar.gz <destination>

    • gsutil cp -r gs://kb-onprem-us/2025.11/Data/01/ikb_match/ <destination>

    • gsutil cp gs://kb-onprem-us/2025.11/Data/fingerprints_*.gz <destination>

    Tip: Using gsutil -m cp enables multi-threaded downloads and can significantly improve performance if you are performing operations on a large number of files over a reasonably fast network connection. However, it can consume a significant amount of network bandwidth and cause problems or make your performance worse if you use a slower network.

    To list folders, use the following command:

    • ls gs://kb-onprem-us/

    Tip: At the end of every month, an announcement is made on the Community website, which includes links to that month’s software and data release. Your Black Duck representative can also provide this information

  3. Configure the Air-gapped KB server.