Enabling users to access the web client from platform-generated emails

Important: IBM Cloud Pak® for Data Version 4.6 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.

Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.6 reaches end of support. For more information, see Upgrading IBM Software Hub in the IBM Software Hub Version 5.1 documentation.

Some services in IBM Cloud Pak for Data generate notifications. For example, collaborators in an analytics project get a notification when assets or new collaborators are added to the project. If you configure a connection to your SMTP server, users can receive these notifications through email. To ensure that these emails include active links to the web client, you must add the URL_PREFIX for your deployment to the Cloud Pak for Data product-configmap.

About this task

A Red Hat® OpenShift® project (namespace) administrator can edit the Cloud Pak for Data product-configmap to specify the URL_PREFIX for your deployment.

The URL_PREFIX is the domain name at the beginning of your deployment URL. For example, if your deployment of Cloud Pak for Data is accessible from https://domain.my.company.com/zen, your domain name is domain.my.company.com. Do not include the protocol in the value that you specify.

If you use the default port, 443, you do not need to specify the port number in the value for the URL_PREFIX parameter. However, if you use a non-standard port, include it in the URL_PREFIX. For example, if you use port 31843, your entry would be:

URL_PREFIX: domain.my.company.com:31843

Procedure

To enable users to access the web client from platform-generated emails:

Log in to your Red Hat OpenShift cluster as a project administrator:
```
oc login OpenShift_URL:port
```
Change to the project where you installed Cloud Pak for Data:
```
oc project Project
```
Run the following command to edit the Cloud Pak for Data product-configmap:
```
oc edit cm product-configmap
```
Add an entry for the URL_PREFIX parameter to the data section of the product-configmap file. For example:
```
data:
  ...
  SHOW_USER_APPROVAL: "false"
  URL_PREFIX: domain.my.company.com
  ...
```
Save your changes to the product-configmap file.
For example, if you are using vi, hit esc and enter:
```
:wq
```
The changes are automatically applied to the platform.