ONES Orchestration Agent Installation

On the ONES Application server, go to ONES-2.1/ones_fm_agent

root@ones-application:~$ cd /ONES-2.1/ones_fm_agent

Installation (Agent Install on multiple switches at the same time)

• Enter device details (Management IP, Username, Password ) in device_info.csv

root@ones-application/ONES-2.1/ones_fm_agent:~$ vi device_info.csv

ip,user,passwd
10.4.4.61,admin,YourPaSsWoRd
10.4.4.62,admin,YourPaSsWoRd
...
...
...

• Save the file

• Execute the installation script

Supported Deployment Methods

Installation

1. Update the device_info.csv file with switch mgmt ip, username and password

2. Run sudo ./deploy_fmcli.sh install

Uninstallation

1. Update the device_info.csv file with switch mgmt ip, username and password

2. Run sudo ./deploy_fmcli.sh uninstall

Cleanup device and install FMCLI

1. Update the device_info.csv file with switch mgmt ip, username and password

2. Run sudo ./deploy_fmcli.sh installresetconfig

Upgrade Existing FMCLI without removing the config

1. Update the device_info.csv file with switch mgmt ip, username and password

2. Run sudo ./deploy_fmcli.sh upgrade

Installation

root@ones-application/ONES-2.1/ones_fm_agent:~$ ./deploy_fmcli.sh 'install'

Installer will proceed with FMCLI-install ...

468025bd9c12: Loading layer [==================================================>]   2.56kB/2.56kB
1961412d5783: Loading layer [==================================================>]  36.56MB/36.56MB
de3513fa22d1: Loading layer [==================================================>]  42.69MB/42.69MB
ca3343e443b5: Loading layer [==================================================>]  1.421MB/1.421MB
Loaded image: avizdock/agent_installer:latest
Docker image 'avizdock/agent_installer:latest' is loaded.
f404ff0948564cd6813550368668f3b1c3548cdf47d79f1ad8d858769fa25f38

Docker container 'agent_installer' is running.
CONTAINER ID   IMAGE                             COMMAND     CREATED                  STATUS                  PORTS     NAMES
f404ff094856   avizdock/agent_installer:latest   "python3"   Less than a second ago   Up Less than a second             agent_installer

Docker container 'ones-fm' is running.
Update success for 10.4.4.61
Update success for 10.4.4.62
Ignore below Error if Installing Agent via docker installer

ones-fm container is not running

Server IP: 172.17.0.3
fm_port: None
[{'ip': '10.4.4.61', 'passwd': 'YourPaSsWoRd', 'user': 'admin', 'server_ip': '172.17.0.3', 'fm_port': None}, {'ip': '10.4.4.62', 'passwd': 'YourPaSsWoRd', 'user': 'admin', 'server_ip': '172.17.0.3', 'fm_port': None}]
Operation = install
##### params = {'ip': '10.4.4.61', 'passwd': 'YourPaSsWoRd', 'user': 'admin', 'server_ip': '172.17.0.3', 'fm_port': None} #####
###############Connecting to switch###############
##### params = {'ip': '10.4.4.62', 'passwd': 'YourPaSsWoRd', 'user': 'admin', 'server_ip': '172.17.0.3', 'fm_port': None} #####
###############Connecting to switch###############
...
...
...
#################### Installing FMCLI on the device 10.4.4.61 ######################

#################### Installing FMCLI on the device 10.4.4.62 ######################
####### Debug LOGS on the device 10.4.4.61 #######
fmcli-app/
fmcli-app/libhiredis.so.1.1.0
fmcli-app/fmcli.sh
fmcli-app/fmcli
fmcli-app/ip_validate
fmcli-app/fmcli.cli
fmcli-app/fmcli.version
...
...
...
####### Debug LOGS on the device 10.4.4.62 #######
fmcli-app/
fmcli-app/libhiredis.so.1.1.0
fmcli-app/fmcli.sh
fmcli-app/fmcli
fmcli-app/ip_validate
fmcli-app/fmcli.cli
fmcli-app/fmcli.version

FM-Agent installed successfully on the device 10.4.4.62........
####### Deleting ones-fm_1713190726_4057596 dir on the device 10.4.4.62 #######
Print deployment of FM-Agent to switch 10.4.4.62 is Completed
FMCLI install Result
{'10.4.4.61': 'PASS', '10.4.4.62': 'PASS'}
╒═════════╤═══════════╤══════════════════╕
│   SL.No │ Device    │ install Result   │
╞═════════╪═══════════╪══════════════════╡
│       1 │ 10.4.4.61 │ PASS             │
├─────────┼───────────┼──────────────────┤
│       2 │ 10.4.4.62 │ PASS             │
╘═════════╧═══════════╧══════════════════╛

root@Switch:~$ sudo fmcli

root@Switch:~$ sudo fmcli 
fmcli# 

Uninstallation

root@ones-application/ONES-2.1/ones_fm_agent:~$ ./deploy_fmcli.sh 'uninstall'

Installer will proceed with FMCLI-uninstall ...

a09c0ffdcba2: Loading layer [==================================================>]   2.56kB/2.56kB
8c6091db46c1: Loading layer [==================================================>]  36.63MB/36.63MB
38f3a9e347f1: Loading layer [==================================================>]  42.69MB/42.69MB
7783a5157651: Loading layer [==================================================>]  1.421MB/1.421MB
Loaded image: avizdock/agent_installer:latest
Docker image 'avizdock/agent_installer:latest' is loaded.
7724e9ab3a139f6c74fdf8f2f9536891a1ffc6c88168011dee5d6a8bc24d6041

Docker container 'agent_installer' is running.
CONTAINER ID   IMAGE                             COMMAND     CREATED                  STATUS                  PORTS     NAMES
7724e9ab3a13   avizdock/agent_installer:latest   "python3"   Less than a second ago   Up Less than a second             agent_installer

Docker container 'ones-fm' is running.
Update success for 10.4.4.68
Ignore below Error if Installing Agent via docker installer

ones-fm container is not running

Server IP: 172.17.0.3
fm_port: None
[{'ip': '10.4.4.68', 'passwd': 'YourPaSsWoRd', 'user': 'admin', 'server_ip': '172.17.0.3', 'fm_port': None}]
Operation = uninstall
##### params = {'ip': '10.4.4.68', 'passwd': 'YourPaSsWoRd', 'user': 'admin', 'server_ip': '172.17.0.3', 'fm_port': None} #####
###############Connecting to switch###############
<paramiko.client.SSHClient object at 0x7fc2bb03e190>
Connection to switch 10.4.4.68 successfull.....................
/home/ones_fm_agent
############### Uninstalling FM Agent ###############
FMCLI uninstall Result
{'10.4.4.68': 'PASS'}
╒═════════╤═══════════╤════════════════════╕
│   SL.No │ Device    │ uninstall Result   │
╞═════════╪═══════════╪════════════════════╡
│       1 │ 10.4.4.68 │ PASS               │
╘═════════╧═══════════╧════════════════════╛

Installation with a config cleanup

using this process, Script will clear the base config like port--channel related config, IP related config, VXlan related config and more related configuration.

root@ones-application/ONES-2.1/ones_fm_agent:~$ ./deploy_fmcli.sh 'installresetconfig'

Installer will proceed with FMCLI-installresetconfig ...

468025bd9c12: Loading layer [==================================================>]   2.56kB/2.56kB
1961412d5783: Loading layer [==================================================>]  36.56MB/36.56MB
de3513fa22d1: Loading layer [==================================================>]  42.69MB/42.69MB
ca3343e443b5: Loading layer [==================================================>]  1.421MB/1.421MB
Loaded image: avizdock/agent_installer:latest
Docker image 'avizdock/agent_installer:latest' is loaded.
bf5fee40fc8d6ba3e16525fdddf329a79d1a5701d096fa9d52f95d8d05ed2273
...
...
...
##### params = {'ip': '10.4.4.61', 'passwd': 'YourPaSsWoRd', 'user': 'admin', 'server_ip': '172.17.0.3', 'fm_port': None} #####
###############Connecting to switch###############
Connection to switch 10.4.4.61 successfull.....................
/home/ones_fm_agent
Creating work directory  on the device 10.4.4.61........
...
...
...
#################### Installing FMCLI on the device 10.4.4.61 ######################
...
...
...
FM-Agent installed successfully on the device 10.4.4.61........
####### Deleting ones-fm_1713191010_027004 dir on the device 10.4.4.61 #######
Print deployment of FM-Agent to switch 10.4.4.61 is Completed
#################### Cleaning config on the device 10.4.4.61 ######################
File '/usr/lib/frr/frr-reload.py' exists in container 'bgp'
Skip scp as File: /usr/lib/frr/frr-reload.py exits inside bgp container
...
...
...
###### Config Reset Successful !!! #######
#######
╒═════════╤═══════════╤══════════════════╤══════════════════════╕
│   SL.No │ Device    │ Install Result   │ ConfigReset Result   │
╞═════════╪═══════════╪══════════════════╪══════════════════════╡
│       1 │ 10.4.4.61 │ PASS             │ PASS                 │
╘═════════╧═══════════╧══════════════════╧══════════════════════╛

Upgrade Installation

root@ones-application/ONES-2.1/ones_fm_agent:~$ ./deploy_fmcli.sh 'upgrade'

Installer will proceed with FMCLI-upgrade ...

468025bd9c12: Loading layer [==================================================>]   2.56kB/2.56kB
1961412d5783: Loading layer [==================================================>]  36.56MB/36.56MB
de3513fa22d1: Loading layer [==================================================>]  42.69MB/42.69MB
ca3343e443b5: Loading layer [==================================================>]  1.421MB/1.421MB
Loaded image: avizdock/agent_installer:latest
Docker image 'avizdock/agent_installer:latest' is loaded.
d77a146cae3a6abb3d980961b9af7adc14632c96b35789076e098e8138474102
...
...
...
Server IP: 172.17.0.3
fm_port: None
[{'ip': '10.4.4.61', 'passwd': 'YourPaSsWoRd', 'user': 'admin', 'server_ip': '172.17.0.3', 'fm_port': None}]
Operation = upgrade
##### params = {'ip': '10.4.4.61', 'passwd': 'YourPaSsWoRd', 'user': 'admin', 'server_ip': '172.17.0.3', 'fm_port': None} #####
###############Connecting to switch###############
<paramiko.client.SSHClient object at 0x7f500f363190>
Connection to switch 10.4.4.61 successfull.....................

#################### Upgrading FMCLI on the device 10.4.4.61 ######################
####### Debug LOGS on the device 10.4.4.61 #######
...
...
...
FM-Agent Upgraded successfully on the device 10.4.4.61........
####### Deleting ones-fm_1713191627_4676907 dir on the device 10.4.4.61 #######
Print deployment of FM-Agent to switch 10.4.4.61 is Completed
FMCLI upgrade Result
{'10.4.4.61': 'PASS'}
╒═════════╤═══════════╤══════════════════╕
│   SL.No │ Device    │ upgrade Result   │
╞═════════╪═══════════╪══════════════════╡
│       1 │ 10.4.4.61 │ PASS             │
╘═════════╧═══════════╧══════════════════╛

• Verify the Installation success by running the fmcli command on individual devices