Overview#

knlcli is the command line tool to manage KNL labs.

KNL CLI tool

Usage:
  knlcli [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  console     connect to the console of specified node in the specified lab
  create      create a lab via the specified YAML file
  help        Help about any command
  rm          remove a lab
  shell       connect to the specified node in the specified lab
  show        show existing Lab info

Flags:
  -h, --help              help for knlcli
      --kubeconf string   path to k8s config (default "/home/hj/.kube/config")
  -n, --ns string         k8s namespace (default "knl-system")
  -v, --version           version for knlcli

Use "knlcli [command] --help" for more information about a command.

Installation#

see here

Shell completion#

knlcli supports bash completion, enable it via following:

sudo apt-get install -y bash-completion # install bash-completion if not already installed
knlcli completion bash | sudo tee /etc/bash_completion.d/knlcli # install the knlcli completion script
source <(knlcli completion bash) # activate the completion for current shell session

Create a lab#

knlcli create <labdef.yaml>, this is equivalent to kubectl apply -f <labdef.yaml>.

List existing labs#

knlcli show

example-lab:
   Node      Type    Chassis   Pods                                       Worker/PodIP
   srsim-1   SRSIM   SR-7      example-lab-srsim-1                        worker-1/10.244.2.92
   vsim-1    VSIM    SR-7      virt-launcher-example-lab-vsim-1-1-cjfn6   worker-2/10.244.0.95
                               virt-launcher-example-lab-vsim-1-a-lvhqd   worker-2/10.244.0.115
   Link      Nodes
   link1     srsim-1
             vsim-1

Access a lab node via shell command#

knlcli shell <lab> <node>

vSIM, VSR, MAG-c, SR-SIM, SRLinux: this command creates a SSH session to the control card (e.g. CPM).
General VM: this command creates a SSH sesion to the VM
General pod: this command command trys to execute bash inside the pod

Access a lab node via console command#

knlcli console <lab> <node>

vSIM, VSR, MAG-c: this command creates a console session to the control card (e.g. CPM).
General VM: this command creates a console sesion to the VM
SR-SIM, SRLinux, general pod: this command command trys to execute bash inside the pod

Remove lab#

knlcli remove <lab>: remove the specified lab
knlcli remove --all: remove all labs
Note
Removing a lab won’t remove the perisisten storage of nodes in the lab.