Headless Linux Client (bn-cli) Explained

Headless Linux Client (bn-cli) Explained


Big Network makes a headless linux client, named "bn-cli", available for linux server environments. bn-cli is used in cases where interactive login via our SSO platform may not be viable for use.

Download and Installation

You can download our Headless Linux Client from our portal download center (https://portal.bignetwork.com/) under the "other downloads" section. This client is packaged as both .rpm and .deb files for both ARM and AMD64 architectures. To use this client, install using your preferred package manager. 

Joining Cloud Networks with bn-cli

To join a cloud network, use the following command: 'bn-cli join $networkid" where $networkid is the Network ID taken from the properties of your Cloud Networks.

When you initially join a cloud network in this manner, the client will be denied access. You will need to manually allow the device to join the network in the portal. Navigate to your cloud network, tick the allow checkbox for the instance in question, and apply network changes. "bn-cli" will automatically join the Cloud Network once permitted.

NOTE: You must have available "Other Device" licenses in your organization to join cloud networks in this manner.

Leaving Cloud Networks with bn-cli

You can leave a cloud network with the command: 'bn-cli leave $networkid".

Other Useful Commands

  1. To view the client status, use "bn-cli info"
  2. To view networks joined by the client, use "bn-cli listnetworks"
  3. For debugging connectivity, use "bn-cli peers"