Question
How to properly migrate brand from Legacy Linux Shared Hosting to Shared Hosting NG cluster?
Answer
The general overview of the procedure:
- Deploy NG cluster as per Deploying Linux Web Cluster section> of the Deployment Guide
- Deploy UI service on NG as per Creating HA UI Cluster part of Deployment Guide
- Set the NG cluster to be ready to provide, verify that all resellers and providers have the resources to create webspaces on NG cluster
- Add IP pools which will be used for brand provisioning to NG cluster
For each brand which should be migrated execute the following steps:
- In brand settings switch UI node to NG cluster. Go to PCP > System Director > Settings > Brands > Your_Own_Brand, click
Edit
button and findUI Node
field. If you have NG cluster on your OA environment, you will be able to switch this field'a value; - Back up all certificates used on CP site;
- Verify that old hosts are marked as “not ready to provide”;
- On the reseller's subscription increase the resources
Branding webspace
,Apache Web Sites
andIP based virtual host
by 1 if any of them reached it's limit ('Available' amount is 0) in order to allow to create new webspace. - In reseller's (or Provider's in case Provider's brand is being migrated) CCP go to Websites > cp.reseller.com > Web tab;
- Click Change Hosting;
- Select required hosting resource from the Hosting drop-down list, click Next;
- Select Create new webspace (note – this will be missing if substep #4 was skipped);
- Select Exclusive IPv4 (optionally – and IPv6), click Next;
- Proceed through the wizard, verify correctness of settings, click Finish;
- Wait until spawned tasks complete;
- Install certificate from repository (if not available – import it from backup);
- Decrease Branding webspace on reseller's resource by 1.
- Check that old webspace was destroyed. In CCP > Websites check that there are no webspaces without domains assigned. If any - click
Delete
button; - Decrease
Branding webspace
and any other, which limits was increased on step #4, by 1.
- In brand settings switch UI node to NG cluster. Go to PCP > System Director > Settings > Brands > Your_Own_Brand, click
Note: you can find all brands existed on your OA environment in PCP > System Director > Settings > Brands, if you set Ownership
value to Any
and click Search
button.
Known issues
- When Proxy Store is configured on brand, 2 files with set of rules are placed to the specified folder of a webspace:
.htaccess
and.swaccess
. When brand is migrated, these files won't be moved to new webspace. To recreate them after migration, one should go to BA and update parameters of the proxy store (only IP address will be different, other parameters will be the same). Feature request POA-87181 has been submitted to add the full procedure in documentation. - 122122 Brand migration failed: Object does not exists in system
- 128861 Cannot enable SSL support when migrating a Brand - checkbox is absent