Release managers and site owners use a Launch Group to group sites from one Multi-Experience Operations, or MEO, environment under a shared set of domains. One site in the group is the published site, which serves all traffic for the group. The other sites are additional sites. Build and review a new version of a site as an additional site, and then publish the site when it is ready.
After you publish a different site, traffic on the domains for the group moves to that site without requiring Domain Name System (DNS) changes. To roll back, publish the previous site again.
Note for Site Factory users
Launch Groups in MEO are the functional equivalent of Site Collections in Site Factory.
How Launch Groups work
All sites in a Launch Group must be in the same environment.
A site can belong to only one Launch Group.
Only one site in a group is published at a time.
Acquia creates a group domain for each Launch Group in the following format: {name}-{codebase_hash}-lg.{realm}.acquia-sites.com.
After a one-time DNS cutover for each custom domain, publish and roll back sites without additional DNS changes.
Launch Groups
Release managers and site owners use a Launch Group to group sites from one Multi-Experience Operations, or MEO, environment under a shared set of domains. One site in the group is the published site, which serves all traffic for the group. The other sites are additional sites. Build and review a new version of a site as an additional site, and then publish the site when it is ready.
After you publish a different site, traffic on the domains for the group moves to that site without requiring Domain Name System (DNS) changes. To roll back, publish the previous site again.
Note for Site Factory users
Launch Groups in MEO are the functional equivalent of Site Collections in Site Factory.
How Launch Groups work
All sites in a Launch Group must be in the same environment.
A site can belong to only one Launch Group.
Only one site in a group is published at a time.
Acquia creates a group domain for each Launch Group in the following format: {name}-{codebase_hash}-lg.{realm}.acquia-sites.com.
After a one-time DNS cutover for each custom domain, publish and roll back sites without additional DNS changes.
Select your MEO codebase, and then select the environment.
In the Sites table, find the site that you want to add and select Add to launch group.
Select one of the following options:
New launch group: Enter a name. The name can contain only letters and numbers and can be up to 52 characters long.
Existing launch group: Select the group.
Save your changes.
You can add a site to a group from the Overview page for the site, the Overview page for the environment, or the Overview page for the Launch Group.
After you add a site to a Launch Group, the Launch Group column in the Sites table displays the group that the site belongs to. To access all Launch Groups in an environment, open the Launch Groups list.
Add or delete member sites
To add more sites, follow the steps in Create a Launch Group and select the existing group. The site must be in the same environment as the group, and it cannot belong to another group.
To delete a member site from a group:
Select Remove on the site.
You cannot delete a published site from the group. First, set another site as published, and then delete the original site.
If you delete a published site, you access a broken site. Therefore, you must ensure that you change the published site before you delete it.
Publish a site
After you publish a site, the domains for the group move to that site. The published site is marked with a badge.
Important
Site publication does not clear Varnish or CDN caches. Cached content and redirects such as 301s from the previous site continue to serve until their Time-to-Live (TTL) expires. To serve updated content immediately after site publication, manually purge both the Acquia Varnish cache and any external CDN caches.
To publish a site:
Open the Overview page for the Launch Group.
Find the site that you want to publish and select Publish this site instance.
Review the list of domains that move to this site.
Enter CONFIRM, and then confirm the action.
Important considerations
During a switch, each domain continues to route to the previously published site until the switch is complete.
Visitor browser sessions might not continue after a switch. Visitors might need to sign in again.
Plan switches for low-traffic periods.
Roll back to a previous site
To roll back, publish the previously published site again. Follow the steps in Publish a site.
Manage domains
On the Domain Management page for the Launch Group, perform the following actions:
Assign domains to the group.
Transfer Standby domains into the group. Standby domains are domains that point to the site instance and are not added to the launch group from the UI.
Add domains. A group can have up to 100 domains.
Remove domains.
Important
If you remove a domain assigned to a site, the system deletes the domain from that site.
Domain Name System (DNS) status
Each domain displays one of the following DNS statuses:
Status
Meaning
DNS updated
The DNS for the domain points to the Launch Group. Traffic follows the published site.
DNS not updated
The DNS for the domain does not point to the Launch Group. Update your DNS records with the values in DNS Information.
Pending
Acquia checks the DNS for the domain.
Not found
Acquia cannot find DNS records for the domain.
Cloud Platform does not verify the Domain Name System, or DNS, status automatically. To verify the DNS status again, select Refresh. The verification runs in the background.
DNS Information
Before your first switch, provide your IT team or DNS provider with the following values from DNS Information:
Domain
Environment
Canonical Name (CNAME)
Internet Protocol (IP) addresses
Your IT team updates the DNS records one time for each domain. After that update, you do not must change DNS to publish or roll back.
Delete a Launch Group
To delete a Launch Group:
Remove all custom domains from the group. You cannot delete a group that contains custom domains.
On the Overview page for the Launch Group, select Delete Launch Group.
After you delete the group, the Launch Groups list opens. Member sites continue to run on their default Acquia domains.
Permissions
Launch Group permissions are set at the codebase level:
Permission
Description
View launch group
Access Launch Groups and their details.
Create launch group
Create Launch Groups.
Manage launch group
Add and delete member sites, and manage domains.
Delete launch group
Delete Launch Groups.
Publish site
Publish a site in a Launch Group, including a rollback.
Cloud Platform records all changes to Launch Groups in the audit log, including automatic changes such as member site deletion.
Limits
Up to 100 domains for each group
Group names: Letters and numbers only, up to 52 characters
One group for each site, and all sites must be in the same environment
One switch at a time in each environment
Limitations
Launch Groups do not synchronize content or databases between sites. Prepare content for a site before you publish it.
Launch Groups do not split traffic by percentage. A switch moves all traffic at once.
Launch Groups do not support groups that span environments.
Acquia does not change DNS records in your DNS zone. You are responsible for the one-time cutover.
Path-based domains cannot be deleted. After you add a path-based domain to a Launch Group, you cannot remove it.
Automated domains not supported. Launch Groups do not support automated domains.
After you switch a published site and select Publish this site instance, the Site instance published. notification opens, but the Status field remains stuck on Switching published site... and the Published site field does not update. To clear the indicator and display the newly published site in the UI, perform a hard refresh of your browser by pressing Ctrl + Shift + R on Windows or Linux, or Cmd + Shift + R on Mac. This issue is planned for resolution in an upcoming release.
Select your MEO codebase, and then select the environment.
In the Sites table, find the site that you want to add and select Add to launch group.
Select one of the following options:
New launch group: Enter a name. The name can contain only letters and numbers and can be up to 52 characters long.
Existing launch group: Select the group.
Save your changes.
You can add a site to a group from the Overview page for the site, the Overview page for the environment, or the Overview page for the Launch Group.
After you add a site to a Launch Group, the Launch Group column in the Sites table displays the group that the site belongs to. To access all Launch Groups in an environment, open the Launch Groups list.
Add or delete member sites
To add more sites, follow the steps in Create a Launch Group and select the existing group. The site must be in the same environment as the group, and it cannot belong to another group.
To delete a member site from a group:
Select Remove on the site.
You cannot delete a published site from the group. First, set another site as published, and then delete the original site.
If you delete a published site, you access a broken site. Therefore, you must ensure that you change the published site before you delete it.
Publish a site
After you publish a site, the domains for the group move to that site. The published site is marked with a badge.
Important
Site publication does not clear Varnish or CDN caches. Cached content and redirects such as 301s from the previous site continue to serve until their Time-to-Live (TTL) expires. To serve updated content immediately after site publication, manually purge both the Acquia Varnish cache and any external CDN caches.
To publish a site:
Open the Overview page for the Launch Group.
Find the site that you want to publish and select Publish this site instance.
Review the list of domains that move to this site.
Enter CONFIRM, and then confirm the action.
Important considerations
During a switch, each domain continues to route to the previously published site until the switch is complete.
Visitor browser sessions might not continue after a switch. Visitors might need to sign in again.
Plan switches for low-traffic periods.
Roll back to a previous site
To roll back, publish the previously published site again. Follow the steps in Publish a site.
Manage domains
On the Domain Management page for the Launch Group, perform the following actions:
Assign domains to the group.
Transfer Standby domains into the group. Standby domains are domains that point to the site instance and are not added to the launch group from the UI.
Add domains. A group can have up to 100 domains.
Remove domains.
Important
If you remove a domain assigned to a site, the system deletes the domain from that site.
Domain Name System (DNS) status
Each domain displays one of the following DNS statuses:
Status
Meaning
DNS updated
The DNS for the domain points to the Launch Group. Traffic follows the published site.
DNS not updated
The DNS for the domain does not point to the Launch Group. Update your DNS records with the values in DNS Information.
Pending
Acquia checks the DNS for the domain.
Not found
Acquia cannot find DNS records for the domain.
Cloud Platform does not verify the Domain Name System, or DNS, status automatically. To verify the DNS status again, select Refresh. The verification runs in the background.
DNS Information
Before your first switch, provide your IT team or DNS provider with the following values from DNS Information:
Domain
Environment
Canonical Name (CNAME)
Internet Protocol (IP) addresses
Your IT team updates the DNS records one time for each domain. After that update, you do not must change DNS to publish or roll back.
Delete a Launch Group
To delete a Launch Group:
Remove all custom domains from the group. You cannot delete a group that contains custom domains.
On the Overview page for the Launch Group, select Delete Launch Group.
After you delete the group, the Launch Groups list opens. Member sites continue to run on their default Acquia domains.
Permissions
Launch Group permissions are set at the codebase level:
Permission
Description
View launch group
Access Launch Groups and their details.
Create launch group
Create Launch Groups.
Manage launch group
Add and delete member sites, and manage domains.
Delete launch group
Delete Launch Groups.
Publish site
Publish a site in a Launch Group, including a rollback.
Cloud Platform records all changes to Launch Groups in the audit log, including automatic changes such as member site deletion.
Limits
Up to 100 domains for each group
Group names: Letters and numbers only, up to 52 characters
One group for each site, and all sites must be in the same environment
One switch at a time in each environment
Limitations
Launch Groups do not synchronize content or databases between sites. Prepare content for a site before you publish it.
Launch Groups do not split traffic by percentage. A switch moves all traffic at once.
Launch Groups do not support groups that span environments.
Acquia does not change DNS records in your DNS zone. You are responsible for the one-time cutover.
Path-based domains cannot be deleted. After you add a path-based domain to a Launch Group, you cannot remove it.
Automated domains not supported. Launch Groups do not support automated domains.
After you switch a published site and select Publish this site instance, the Site instance published. notification opens, but the Status field remains stuck on Switching published site... and the Published site field does not update. To clear the indicator and display the newly published site in the UI, perform a hard refresh of your browser by pressing Ctrl + Shift + R on Windows or Linux, or Cmd + Shift + R on Mac. This issue is planned for resolution in an upcoming release.
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.