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