Skip to main content

Installing ioBuster with Limited Internet Connectivity

For Air-Gapped Environment

Certain network environment is completely isolated from the internet due to extremely strong security policies. We are already aware of customers in this situation, and you may download intallation files where internet access is enable and transfer them to an air-gapped environment using a removable storage such as a USB stick.

Installing ioBuster Coordinator using a tarball

After you downloaded iobc from the download links from the installation page, you need to download an extra tarball file for manual installation.

Once you download both iobc and the tarball, latest_iobc.tar, please run the following command from a command terminal to complete the installation.

iobc install latest_iobc.tar

Installing ioBuster Framework using a tarball

ioBuster Coordinator downloads and installs ioBuster Framework from Google Cloud Storage when adding or updating a test host. If your network has limited connections to the internet, you can manually download the ioBuster Framework and install it using host update command.

After you download the ioBuster Framework, latest_iobc.tgz, please use the following commands to install the framework.

coordinator # host add -n
coordinator # host update test-host -f latest_iobc.tgz

For a Network Behind Proxy

Checking existing proxy settings

On Windows

netsh winhttp show proxy

On Linux and macOS

echo $HTTP_PROXY
echo $HTTPS_PROXY

Setting HTTP_PROXY and HTTP_PROXY environment variables

To set the proxy on Windows

setx HTTP_PROXY "http://proxyserver:port"
setx HTTPS_PROXY "https://proxyserver:port"

On Linux and macOS

export HTTP_PROXY="http://proxyserver:port"
export HTTPS_PROXY="https://proxyserver:port"

Replace "http://proxyserver:port" and "https://proxyserver:port" with your actual proxy server and port details.

Verifying proxy configuration

When you run the coordinator, it will print out the configured proxy setting if they exist. This way, you can confirm that your program is using the correct proxy configuration.

iobuster$ iobc run
IO Buster Coordinator, Ver. 23.09.1
HTTP_PROXY=http://proxyserver:port
HTTPS_PROXY=https://proxyserver:port
coordinator [iobuster] #