Infrastructure maintenance requires some operations with hardware. The hardware may fail some time, it may be upgraded to improve the performance, or your system may need to be moved to other physical location. So Qosifire node may need to go down and then re-installed again.
To cover cases like hardware change Qosifire agent has a recovery mode for registration tool. It will re-register the instance in recovery mode and Qosifire will push existing configs to it.
When you install Qosifire via proper OS instruction, you need to complete firsts steps and stop before following the registration step, as you will need to use a special command. It will register your existing node back with the same ID and apply existing settings. It will allow Qosifire to work with new instance just like it's the existing one.
Note: Please back up your /etc/qosifire/qosifire.conf before using this method to avoid accidental damages.
As mentioned above, start installation as usual and then during registration step, use this command:
sudo /usr/bin/qosifire_regutil --recovery-id node_id [-u user -p password]
- node_id value for recovery-id parameter an be found in /etc/qosifire/qosifire.conf under "panel_uuid" parameter. It will be a UID with numbers of characters like 12345678-abcd-efgh-5432-1375699202.
- -u and -p parameters are there for user and password for registration. They can be used from command line if you don't want to enter those values manually after launching the command.
Once you run this command, your agent node will be registered. Complete the installation using the rest of the commands from installation instruction and your node will be shown as Online, with all configs moved to it.
Please use it only if you'd like to recover existing instance after major hardware failure. If the server was unavailable due to network issues, then just re-start the instance according to your operating system as mentioned in installation procedure.