Update brXM virtual hosts for the bloomreach.cloud domain
Bloomreach Cloud is switching its default domain from onehippo.io to bloomreach.cloud. This switch requires a reconfiguration of Bloomreach Experience Manager's delivery tier (HST) virtual hosts.
The URLs that are being affected
Only the default URLs to the environments are affected. Example of such URLs:
The URLs that are not affected
Any URLs that access the environment through a domain created in the Mission Control Domains page.
The following steps show how to enable a Bloomreach Cloud environment to be accessible via the bloomreach.cloud domain. The procedure must be repeated for each environment.
1. Open Console
Open the environment in Mission Control and click on the CONSOLE button:
2. Locate the mainsite, hst:hosts, od2
Login into the console and navigate to /hst:mainsite/hst:hosts/od2. This node is the root node for all virtual hosts configuration. All operations will be applied under it.
3. Explore the tree
Below the 'od2' node, there should be at least one subtree, which allows access to the site via the onehippo.io domain, in this case the URL is https://prod-upgra.onehippo.io. Each part of the URL corresponds to a separate node in the HST configuration:
Right click the 'io' node and select Copy node:
In the copy dialog that appears, set the name to "cloud":
This will copy the whole 'io' hierarchy, the result should look like this:
5. Rename 'onehippo' to 'bloomreach'
Right click the 'onehippo' node and select Rename node, in the input box enter "bloomreach" without the quotes.
6. Rename the prod-upgra to your stack name
Right click the 'prod-upgra' node (or the corresponding node in your configuration) and rename it to your stack name. In this case, the stack is named 'upgra'. The end result should look like this:
7. Create a new node 'prod'
Since the HST tree has to have one node per DNS domain - prod.upgra.bloomreach.cloud requires four nodes - 'cloud', 'bloomreach', 'upgra', 'prod'. We need to create the 'prod' node. Right click the node that represents the stack name and select Add node:
In the Name field, enter the name of your environment (in this case it’s "prod"), in the Primary type field enter "hst:virtualhost":
The end result should look like this:
8. Move the 'hst:root' node under the 'prod' node
Right click the 'hst:root' node and select Move node. Select the previously created node with the environment name as a target:
The end result should be like this:
9. Save changes
In the top-right corner click Write changes to repository to save the changes.
10. Access the environment
Access your environment via the following URL scheme:
In this particular case, it would be:
You should see the site main page.
11. Making the Experience Manager work (optional)
If you're using the CMS via a default URL (such as onehippo.io), the Experience Manager requires all the steps from 1 to 10 be repeated, but this time inside of the /hst:platform/hst:hosts/od2 hierarchy. If you're accessing the CMS via a custom domain defined in Mission Control, no such steps are needed, it is expected for that configuration to be already in place.