Installation

Search…
Installation
This article contains instructions on how to deploy Binalyze AIR using Docker and also covers the models of deployment.
Supported Distributions 
CentOS: 7, 8 (x64)
Ubuntu: 18.04 (LTS), 20.04 (LTS) (x64)
Prerequisites
Docker (version 19.03.6 or higher)
You can download it from: https://docs.docker.com/engine/install/​
Docker Compose (version 1.28.0 or higher to support Compose file version 3.4)
You can download it from: https://docs.docker.com/compose/install/​
Deployment Models
You can deploy AIR in one of two models:
​Single Tier Deployment
All platform components, such as App, Web, NATS, DB, and Redis, are installed and run on the same machine. 
​2-Tier Deployment
All components except the Database Layer are installed and run on a single instance, while Database has its own dedicated instance. 
Which deployment model to use?
Single Tier Model is the quickest way of deploying AIR that can be used for PoCs and testing purposes, while the 2-Tier Model is meant for Enterprise usage. 
2-Tier Model comes with a dedicated Console Server that can serve more endpoints and moves the Database into an isolated server that increases the database performance. 
Installation
Before you start
Make sure you have updated package repositories of the Operating System you are using. Please find below the commands for CentOS and Ubuntu:
For CentOS:
1
yum update
Copied!
For Ubuntu:
1
apt-get update
Copied!
Start and enable docker service by executing the following command:
1
systemctl start docker && systemctl enable docker
Copied!
Single-Tier Deployment 
Suitable for PoCs, Demos, and non-mission critical deployments.
This deployment model installs all components into a single machine.
Method 1: Quick Deployment (preferred method)
1.Run the one-liner below and wait for it to complete
1
curl -fsSL https://cdn.binalyze.com/air-deploy/console.sh | sudo -E bash
Copied!
2.Proceed with the Finalizing Setup section​
Method 2: Manual Deployment (use only when required)
1.Create a folder for the Binalyze AIR under /opt directory and cd into it
1
mkdir /opt/binalyze-air && cd /opt/binalyze-air
Copied!
2.Download the docker-compose.yml file and save it
1
curl -fsSL "https://cdn.binalyze.com/air-deploy/docker-compose.yml" -o docker-compose.yml
Copied!
3.Create the directory for the database volume with defined access:
1
install -d -o 1001 -g 1001 ./volumes/mongodb/bitnami/mongodb
Copied!
4.Change the default password for NATS real-time messaging platform
1
sed -i s/air_nats_password/$(tr -dc 'a-zA-Z0-9' </dev/urandom | fold -w 32 | head -n 1)/g docker-compose.yml
Copied!
5.Run the following command to start Binalyze AIR installation in docker:
1
docker-compose -p binalyze-air up -d
Copied!
6.Wait for the installation to complete. It may take several minutes
7.Proceed with the Finalizing Setup section​
2-Tier Deployment
Suitable for Enterprise Deployments.
This deployment model requires you to deploy the Database Component first (Step 1) and then start the deployment of the Console Server (Step 2) by pointing to the database server's address.
Method 1: Quick Deployment (preferred method)
1.Run the one-liner below and wait for it to complete (this script will deploy the database component - Step 1)
1
curl -fsSL https://cdn.binalyze.com/air-deploy/db.sh | sudo -E bash
Copied!
2.Once the database is deployed, the above script will output the commands that need to be executed on the Console Server machine (Step 2)
3.SSH into the Console Server machine
4.Run the commands provided by the above script and wait for it to complete
5.Proceed with the Finalizing Setup section​
Method 2: Manual Deployment (use only when required)
You should execute the commands below on the Database Server!
1.SSH into Database Server
2.Create a folder for the Binalyze AIR DB under /opt directory and cd into it
1
mkdir /opt/binalyze-air-db && cd /opt/binalyze-air-db
Copied!
3.Download the docker-compose.yml file and save it
1
curl -fsSL "https://cdn.binalyze.com/air-deploy/docker-compose-db.yml" -o docker-compose.yml
Copied!
4.Create the directory for the database volume with defined access:
1
install -d -o 1001 -g 1001 ./volumes/mongodb/bitnami/mongodb
Copied!
5.Change the default password for MongoDB
1
sed -i s/mongo_root_password/$(tr -dc 'a-zA-Z0-9' </dev/urandom | fold -w 32 | head -n 1)/g docker-compose.yml
Copied!
6.Run the following command to start the Binalyze AIR Database component in Docker:
1
docker-compose -p binalyze-air-db up -d
Copied!
7.Wait for the installation to complete. It may take several minutes.
8.Proceed to the installation of Console Server
You should execute the commands below on Console Server!
1.SSH into Console Server
2.Create a folder for the Binalyze AIR under /opt directory and cd into it
1
mkdir /opt/binalyze-air && cd /opt/binalyze-air
Copied!
3.Download the docker-compose.yml file and save it
1
curl -fsSL "https://cdn.binalyze.com/air-deploy/docker-compose-without-db.yml" -o docker-compose.yml
Copied!
4.Change the default password for NATS real-time messaging platform
1
sed -i s/air_nats_password/$(tr -dc 'a-zA-Z0-9' </dev/urandom | fold -w 32 | head -n 1)/g docker-compose.yml
Copied!
5.Create a folder for saving the configuration
1
mkdir -p ./volumes/app/binalyze-air/config
Copied!
6.Set the database URI for connecting Console Server to DB
IMPORTANT: You should replace DB Root Password and DB Server IP in the command below.
1
echo "AIR_DB_URI=mongodb://root:<DB_ROOT_PASSWORD>@<DB_SERVER_IP>/airdb?authSource=admin" >> ./volumes/app/binalyze-air/config/.env
Copied!
7.Run the following command to start Binalyze AIR installation in docker
1
docker-compose -p binalyze-air up -d
Copied!
8.Wait for the installation to complete. It may take several minutes
9.Proceed with the Finalizing Setup section​
Finalizing Setup
Regardless of the deployment model you chose, you will be asked several configurations at the end of the deployment, such as an organization name, the credentials of the first user account, etc.
Once you have completed the above steps successfully, you should: 
1.Visit http://IP-ADDRESS for accessing the Console (IP address here is the public IP address of the machine you have deployed Binalyze AIR)
2.Accept EULA and provide the configuration you are asked for in each step
3.Complete the setup and login using the credentials you have provided
4.Enjoy Binalyze AIR! 
Pre-Installation
Migrating to AIR v1.8+
Last modified 1mo ago
Copy link
Contents
Supported Distributions
Prerequisites
Deployment Models
Installation
Single-Tier Deployment
2-Tier Deployment
Finalizing Setup