TABLE OF CONTENTS


Prerequisites for installing Conduit on a Windows machine

  • Install Virtual Box: Downloads – Oracle VM VirtualBox and allocate the following minimum Config:

    • 16G Ram (24G Ram)

    • 80G Disk space

    • 4 cores (6 cores recommended)

  • Conduit will need 20GB disk space for the application and operating system.

  • install Putty


Install Ubuntu 18.4 server on Virtual Box

  • download Ubuntu 18.4 server  Ubuntu 18.04.6 LTS (Bionic Beaver) :
  • follow the guide to installing Ubuntu Server on Virtual box with SSH enabled 
    • this guide enables you to have copy+paste and SSH abilities into Ubuntu server from the Host machine
  • In Virtual Box, go to Settings-> Storage → Insert CD image for Ubuntu and install Linux (Before restart the VM, check for the Virtual CD image to be removed from Settings → Storage)

  • in Ubuntu terminal RUN: apt-get install gcc make perl -> this will install compilers that enable the operating system to build and install other components


Install Virtual Box Guest Additions

The following steps are not required if you followed the guide to installing Ubuntu Server on Virtual box with SSH enabled .

After Linux is installed, to be easy to copy Conduit Files, Install additional packages:

  • From Devices menu, click on Install Guest Additions CD Image 

  • Install dkms, build-essential and linux-headers on Ubuntu 18.04: 

    • sudo apt-get update

      sudo apt-get install build-essential dkms linux-headers-$(uname -r)

  • Create a new directory to mount the CD drive:

    • sudo mkdir -p /mnt/cdrom

      sudo mount /dev/cdrom /mnt/cdrom

  • Navigate to the directory and run the VBoxLinuxAdditions.run:

    • cd /mnt/cdrom

      sudo sh ./VBoxLinuxAdditions.run

  • Reboot the server for the changes to take effect:

    • sudo shutdown -r now


Enable File Share on the Virtual Box

These steps allow you to have a shared folder between host machine and virtual machine in order to speed up sharing of files. These steps are optional. Copying files can still be done via `ssh scp` commands. 


  • Machine → Settings → Shared Folders → Add.
  • For Folder Path: Select a file on your drive (or create new)

  • Select Auto-mount

  • For Mount Point enter: /mnt/share

  • Select Make Permanent.


Copy Conduit installation files on Virtual Box

  • On the Windows machine, have the Conduit files in a shared folder that’s accessible from the Virtual Box.

  • Conduit installation files can be found by navigating to Latest release version.



Open ports in Virtual Box

  • In VirtualBox, go to Network → Port Forwarding → Add 80, 10002, 443 and 22.

  • These ports are used by Conduit for the following:

    • 80 - for http connections to Conduit Proxy

    • 443 - for https connections to Conduit Proxy

    • 10002 - for thrift connections to Conduit server

    • 22 - for ssh access to the virtual machine hosting Conduit services

  • find the machine IP address by:

    • running the following command in Ubuntu terminal: ifconfig

  • Go to Windows → Putty and enter the IP and port 22. 

  • Save the IP Address

    • it will be required during Conduit Installation.


Before you start Conduit installation:

  • Ensure that you have access to the shared folder on the VirtualBox with the Conduit files.

  • Ensure that you know the IP address of the VM

  • Ensure that you know the Azure credentials for the Parquet Files storage (Parquet Storage location is configured during Conduit installation).

    • Access Key

    • Storage Account

    • Container

    • For more information about Configure parquet store file system on Azure, click here


Installing Conduit

For Conduit installation, click Conduit on-premise installation


Related articles