System restore requirements
A system backup can be restored only to a system having the following:
•
The same controller version that existed at the time the backup was taken.
•
The same network settings (IP address) as were present at the backup.
•
The same license ID as was in effect when the controller was installed.
NOTE:
If you have modified any environment—specific settings in files such as
/opt/sdn/virgo/options
or
/etc/init/sdnc.conf
, ensure that the appropriate changes
are made to these files after you re-install the controller and before you start the restore. For
example, the network interface that the Virgo service uses (default:
eth0
) might be
eth1
or
another setting on some systems.
Restoring a controller from a backup
1.
Uninstall the controller(s) to be restored. If this is a rollback to a previous state, uninstall all
controllers.
2.
Set
CTL_RESTORE_INSTALL_MODE=True
in the
~/.sdn_install_options
file in the
home directory. If this file is not present in the directory, create it with the
CTL_RESTORE_INSTALL_MODE
entry. If the file is already present, ensure that it includes
the
CTL_RESTORE_INSTALL_MODE
entry. This entry directs the installer to perform the
necessary changes to direct the controller to start in recovery/restore mode, during which
OpenFlow activity is suspended for the subject controller.
3.
Re-install the failed controller(s), making sure to use the same IP address configuration.
During the re-installation, log messages similar to the following appear in the Audit Log:
root@mak:~/dev/controller/dist# sudo dpkg -i hp-sdn-ctl_1.11_amd64.deb
Selecting previously unselected package hp-sdn-ctl.
(Reading database ... 212350 files and directories currently installed.)
Unpacking hp-sdn-ctl (from hp-sdn-ctl_1.11_amd64.deb) ...
Setup has detected a compatible jre-headless - 1.7.0_25
Creating system group 'sdn'...
...done.
Creating system user 'sdn'...
...done.
Creating system user 'sdnadmin'...
...done.
Configuring PostgreSQL database...
* Restarting PostgreSQL 9.1 database server [ OK ]
...done.
Adding SDN-related items to Keystone...
keystone stop/waiting
keystone start/running, process 11514
...done.
Setting up hp-sdn-ctl (1.11) ...
Certificate was added to keystore
CTL_RESTORE_INSTALL_MODE option is set
SDN controller will be started in restore mode
sdna start/running, process 11633
sdnc start/running, process 11636
Processing triggers for ureadahead ...
CAUTION:
Do not re-install any applications before you complete the restore process.
The restoration adds data from the backup file into the current database contents. If you
re-install applications that are part of the controller backup, then those applications might
end up with duplicate or conflicting entries in their database. If required, only re-install
applications after you have completed all steps of the restore process.
4.
Acquire the authentication token for the system restore:
curl --noproxy
controller_ip
-X POST
--fail -ksSfL --url
138
Backing up and restoring