aruba-instant-cli

Introduction

Aruba Instant cli is a console utility using node.js to interface via IAP's HTTP Swarm CGI Module

Dependencies

• aruba-instant
• bluebird
• console.table
• debug
• minimist

Compatibility

• Tested against Aruba Instant 6.4.x.x
• Node v7.2

Installation

Local

Node.js - https://nodejs.org/

npm install -g aruba-instant-cli

Docker

docker run --rm -it vostro/aruba-instant-cli --protocol https  --host {master ap ip} --port 4343 --username {username} --password {password} show "summary" 

Commands

• show "${cmd}" (e.g. show summary, show "ap monitor ap-list")
• show-raw (Same as show except does not prefix the cmd with show e.g. show-raw "show aps")
• action "${cmd}" (when you need to change settings this is the function you need to use)
• backup "./instant.cfg" (will save a backup copy of the current config)
• reload (reboots the Access Point)
• disconnect-user "${ip}" (disconnects target client ip from the network)

Arguments

  --help - Prints out the help text and quit.
  --protocol {https}
  --port {4343}
  --password {password} - //TODO: if password is not provided - secure input prompt is presented
  --apip {target Access Point's Ip in the instant cluster - defaults to 127.0.0.1}
  --notlsreject 1 {set to 1/true if the master access point has a insecure ssl certificate}
  --file {config.json} load cli connection details}
  --useHTTPGetLogin true only set if working with a old version

Required Arguments (if environment vars or config file do not provide the relevant info):

  --host {master ap ip}
  --username {username}

Usage

Command Line

aic --protocol https --host {master ap ip} --port 4343 --username {username} --password {password} --apip 0.0.0.0 show "summary" 

File Based

./config.json

{
  "notlsreject": true, 
  "protocol": "https",
  "host": "{master-ap-ip}",
  "port": 4343,
  "username": "{username}",
  "password": "{password}"
}

Command

aic --file ./config.json show "summary" 

Environment

SET AICLI_PROTOCOL=https
SET AICLI_HOST=test-server
SET AICLI_PORT=test-server
SET AICLI_USERNAME={username}
SET AICLI_PASSWORD={password}
SET NODE_TLS_REJECT_UNAUTHORIZED=0 //For invalid certs
SET AICLI_HTTPGETLOGIN=1 For old arubas

Command

aic show "summary" 

Debugging

This library uses debug for its logging, We prefix all logging entries with aruba-instant-cli:

SET DEBUG=aruba-instant-cli*

TODO

• Examine the rest of the api