Control Panel Migration Guide

This Control Panel Migration Guide describes the migration procedure both for clouds with Static Hypervisors and for clouds with CloudBoot Hypervisors.

Install onapp packages on the new CP server. Package versions of both CPs must be the same.
Stop OnApp and httpd daemons on the old CP:
```
service onapp stop
service httpd stop 
```

Ensure OnApp and httpd daemons are stopped

ps ax |grep onapp_d  
ps ax |grep httpd

Make dump of OnApp database; /etc/ folder; .ssh/ folder (for root and OnApp users); /onapp/interface/ :

mkdir /BACKUP_DIR/
cd /BACKUP_DIR/ 
grep pass /onapp/interface/config/database.yml 
mysqldump --extended-insert onapp > onapp.sql
tar czf etc.tar.gz /etc/ 
tar cjf onapp_interface.tar.bz2  --exclude=/onapp/interface/log --exclude=/onapp/interface/db/dump /onapp/interface
cp -a /root/.ssh ./ssh_root 
cp -a /home/onapp/.ssh ./ssh_onapp

Versions 3.3.0 and later require backing up of Redis database.

echo "SAVE" | redis-cli -s /tmp/redis.sock -x
ll /var/lib/redis/onapp.rdb
cp -a /var/lib/redis/onapp.rdb .

Disable OnApp and httpd daemons in autorun:

chkconfig onapp off 
chkconfig httpd off

Ensure those daemons were really disabled:
```
chkconfig --list |egrep "onapp|httpd"
```
Copy all dumped data to new CP server (create /root/BACKUP_DIR on remote host):
```
rsync --progress -avz -e ssh /BACKUP_DIR/ user@host:/root/BACKUP_DIR/
```

Drop the new database on the new Control Panel server:

cd /root/BACKUP_DIR/
mysql -p onapp 
drop database onapp;
show databases
create database onapp; 
show databases

Apply database from the old CP to the new one:
```
mysql onapp < onapp.sql 
```
Apply Redis database if CP's version is 3.3.0 or later

Make sure the Redis database file is the /var/lib/redis/onapp.rdb file as it is assumed that the dbfilename onapp.rdb and dir var/lib/redis directives are set in /etc/redis.conf.
```
service redis stop
mv /var/lib/redis/onapp.rdb onapp.rdb.old
cp -a onapp.rdb /var/lib/redis/
service redis start
service redis status
```

Apply SSH files for root and onapp users:

rm /root/.ssh/*
rm /home/onapp/.ssh/*
cp -a ssh_root/* /root/.ssh/
cp -a ssh_onapp/* /home/onapp/.ssh/

Apply /onapp/interface/config:

mv /onapp/interface/config /onapp/interface/config.old
tar jxf onapp_interface.tar.bz2
cp -a ./onapp/interface/config /onapp/interface/
cp /onapp/interface/config.old/database.yml /onapp/interface/config/database.yml

Check owner of ssh keys in /onapp/interface/config/keys (in layout owner and group must be onapp):

ll /onapp/interface/config/keys

-rw------- 1 onapp onapp 1675 Dec 19 08:39 private
-rw-r--r-- 1 onapp onapp 382 Dec 19 08:39 public

Apply exports file to new CP:
```
tar zxf etc.tar.gz
cp ./etc/exports /etc/
```
Perform the following steps 16-20 only if your Cloud uses CloudBootHypervisors. For the cloud with StaticHypervisors - proceed to step 21

Copy TFTPBoot folder from the old CP to the new one:

rsync --progress -avz -e ssh /tftpboot user@host:/copied_backups_from_old_cp/

Copy /onapp/configuration/dhcp/dhcpd.conf from the old CP to the new one:
```
rsync --progress -avz -e ssh /onapp/configuration/dhcp/dhcpd.conf user@host:/copied_backups_from_old_cp/
```
For OnApp versions previous to 4.0 file location is /home/onapp/dhcpd.conf

Stop dhcpd daemon on the old CP and disable it in the autorun:

chkconfig dhcpd off
service dhcpd stop
ps ax |grep dhcpd
service redis stop
chkconfig redis off
chkconfig --list |egrep "onapp|httpd|dhcpd|redis"

Apply copied dhcp files and TFTPBoot folder to the new CP:

cp .etc/dhcp/dhcpd.conf /etc/dhcp/
cp /copied_backups_from_old_cp/dhcpd.conf /onapp/configuration/dhcp/dhcpd.conf
mv /tftpboot /tftpboot.old
cp -a /copied_backups_from_old_cp/tftpboot /

For OnApp versions previous to 4.0 apply the following:

cp .etc/dhcp/dhcpd.conf /etc/dhcp/
cp /copied_backups_from_old_cp/dhcpd.conf /home/onapp/
mv /tftpboot /tftpboot.old
cp -a /copied_backups_from_old_cp/tftpboot /

Check server_args directive in TFTP configuration. It should be server_args = -v -v -s /tftpboot:
```
cat /etc/xinetd.d/tftp
```
Make interchage of IP-addresses between old and new CP servers
On the new CP - try to obtain access to HVs via SSH under OnApp user

Add onapp and httpd daemons on CP to autorun:

chkconfig onapp on
chkconfig httpd on
chkconfig --list |egrep "onapp|httpd"

Run the following command to apply SNMP Trap IP_address of management network and RabbitMQ the new CP:
Perform this step if you are running OnApp 3.3.0 and above.
For successful migration you need to specify the RabbitMQ credentials. You can view your RabbitMQ credentials by running the following command:
# cat /onapp/onapp-rabbitmq/credentials.yml
or copy /onapp/onapp-rabbitmq/credentials.yml from the RabbitMQ server standalone box, into Control Panel's /onapp/configuration/rabbit_mq/vcloud/credentials.yml. For more information, refer to RabbitMQ Server Installation.
```
/onapp/onapp-cp-install/onapp-cp-install.sh [-v ONAPP_VERSION] [-i SNMP_TRAP_IPS] [--rbtlogin RBT_LOGIN] [--rbtpasswd RBT_PASSWD]
```
- --rbtlogin RBT_LOGIN - RabbitMQ manager login. The default value is 'rbtmgr'.
- --rbtpasswd RBT_PASSWD - RabbitMQ manager password. A random password is generated if this parameter isn't specified.
Make sure that the rbtlogin and rbtpasswd values are the same as at the Settings > Configuration page.
Go to Settings > Configuration in the OnApp UI and click Save to complete the process.
If Acceleration is enabled:
1. Specify user name and password for rabbitmq-server:
```
rabbitmqctl add_user username 'userpass'
```
2. Set permissions for this user:
```
rabbitmqctl set_permissions -p '/' username ".*" ".*" ".*"
```
3. Restart OnApp service:
```
service onapp restart
```
  Compute Resources and Control Panel must use the same rabbitmq-server.
4. Make sure RabbitMQ credentials are up to date for all HVs. To do this, perform the steps, marked as "Perform the following steps if you plan to deploy Accelerator. Otherwise skip." described in the Install Compute Resources section.
Run DB dump to be sure that all DB dumps are copied directly to the backup server:
```
sh /onapp/onapp-cp-install/onapp-database-dump.sh
```
After interchanging IP addresses between the CP servers, remount NFS volumes coming from the Control Panel on CloudBoot compute resources.