Step 1: Enable Pairing Setting (Linux Agent)
NOTE - commands must be run from Agent installed directory. Example /usr/bp/bin
[root@alma9]# /usr/bp/bin/cli_key_manager json_pairing --action set --force true
Running Json Pairing Command
Action: get
Exp: 09/13/2023 16:36:36
Is_Enabled: true
Is_Forced: true
Log_level: 3
Step 1.1: Enable Pairing Setting (Appliance)
[root@UB]# /usr/bp/bin/cli_key_manager json_pairing --action get
Running Json Pairing Command
Action: get
Exp: 09/13/2023 16:36:36
Is_Enabled: true
Is_Forced: false
Log_level: 3
[root@UB]# /usr/bp/bin/cli_key_manager json_pairing --action set --enable true --force true
Running Json Pairing Command
Action: get
Exp: 09/13/2023 16:36:36
Is_Enabled: true
Is_Forced: true
Log_level: 3
Then attempt to re-save or register the asset in the Unitrends UI normally. This will work for the next pairing attempt only. If you need to pair manually with multiple appliances, repeat this step after each pairing.
Alternatively, you can set a pairing window to retain pairing mode until a specified date or date and time. The time value is optional and can be left off. Please use date formats as MM/DD/YYYY time should be in 24 hour format if included.
/usr/bp/bin/cli_key_manager json_pairing --action set --exp "05/19/2022 09:20"
Step 2: Reload Listener
Once pairing is set, it is necessary to restart the bpagent on the client to load this change.
To do this, run:
/usr/bp/bin/bpinetd stop
/usr/bp/bin/bpinetd start
Step 3: Pair the Agent
If you have yet to successfully register the asset to an appliance, an attempt should now succeed.
If the asset was prior registered and was presenting pairing or SSL errors, it would be necessary now to also follow additional steps on the appliance.
Please see our KB Unitrends Agent Pairing - Clearing Appliance Pairing for information on how to clear prior pairing status on the appliance as needed.
Note: For the above steps to work, permit pairing mode must be yes. This is the default value upon agent installation.
[Pairing mode]
PermitPairingMode=Yes
PairingPort=888