Installing Black Duck Binary Analysis as a Virtual Appliance

From the Download Arena, you can obtain a Black Duck Binary Analysis virtual appliance in OVA format. With a vSphere client, importing the OVA package is straightforward. The OVA package includes default configuration values.

In KVM, you can import a virtual appliance in a number of formats. The qcow2 format supports variable disk size, whereas the raw format is fixed. These instructions assume that you have already installed and configured KVM on your system.

To import Black Duck Binary Analysis in qcow2 format, follow these steps:

1. Unzip the protecode-sc-appliance-<version>.qcow2.xz file that you downloaded from the Download Arena.
2. Enter the following command:

    $ qemu-img convert -O qcow2 protecode-sc-appliance-<version>.qcow2.xz my-BDBA.qcow2

   The last part of the command is the name of the output file, which you can change. The output file is ready to be imported to KVM.

With VirtualBox, you can deploy Black Duck Binary Analysis as a virtual appliance locally. This can be useful if you want to familiarize yourself with the product before production deployment. VirtualBox is not recommended for a production deployment of Black Duck Binary Analysis.

1. Select File > Import Appliance. Use the File System browser to choose the protecode-sc-appliance-<version>.ova file that you downloaded from Black Duck.
2. Select Continue.
3. In the Appliance Settings pane, make sure the Guest OS type is Debian (64-bit). If it is not, select the Guest OS Type setting to reveal a pull-down menu and select Linux > Debian (64-bit).
4. Select Import.
   Figure 1. The VirtualBox Manager

After importing the appliance, you should see your new virtual machine listed in the VirtualBox Manager, however, it isn't ready to use yet.

1. In VirtualBox Manager, select your Black Duck Binary Analysis virtual machine from the list of machines on the left, then select Settings > Network.
2. In the Network pane, toggle Advanced, and then select Port Forwarding.
   Figure 2. Advanced options displayed in the Network pane
3. Add the following two port forwarding rules. You can add a rule by selecting the icon in the upper right-hand corner of the following window:
   Figure 3. Port forwarding rules as entered in VirtualBox

   When you enter port forwarding rules, the third and fifth columns should remain empty.

4. Select OK to save the settings.
5. Select Start to boot the virtual machine.

   When VirtualBox finishes loading your virtual machine, you should see the Black Duck Binary Analysis console.

   Figure 4. The Black Duck Binary Analysis Console

   You can now access Black Duck Binary Analysis through a web browser by entering http://localhost:8000 in the address bar.