KB485012: How to make sure your link to History List in Email work

Symptom

Some users are using Strategy Web with SAML Authentication, when they triggered a History List Subscription with email notification, they complained about not being able to open the link to History List in the notification email, and the below error message will be shown.

Root Cause

The root cause is that they configured Intelligence Server with FQDN(Fully Qualified Domain Name) in MSTR WebAdmin, while the Intelligence Server was using the machine name in the link to History List, not FQDN.

• Hint:
  
• machine name: tec-w-0xxxxx
  
• FQDN: tec-w-0xxxxx.labs.Strategy.com

Solutions

There are two ways to solve this problem.

Solution 1

Use machine name when configuring Intelligence Server in Web Admin Page.

​​​

Solution 2

Use FQDN as server name in the link to History List, follow up the below steps to configure Intelligence Server.

1. Create a new registry key:
   
• For Linux: SOFTWARE\MicroStrategy\DSS Server\Castor\ReplyClusterMembershipWithDomainForWeb.
  
• For Windows: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\MicroStrategy\DSS Server\Castor\ReplyClusterMembershipWithDomainForWeb.
  
   
  
2. Set dword.value =1 (So the server name included in the link to History List will be FQDN)

Appendix

Before MSTR m2021 Update1, the server name in the link to History List is the machine name: http://tec-w-0xxxxx.labs.microstrategy.com:8080/MicroStrategy/servlet/mstrWeb?server=tec-w-016372&project=MicroStrategy+Tutorial&reportViewMode=1&evt=4001&reportID=5745ADCC4B3736B03FCF64ADD491BA2B&messageID=B24BC9EC43739F4C698125ACC7C4ECC2&Port=34952
Since MSTR m2021 Update1, if we create the registry key mentioned above and set the dword.value= 1, the server name in the link to History List will be the FQDN: http://tec-w-0xxxxx.labs.microstrategy.com:8080/MicroStrategy/servlet/mstrWeb?server=TEC-W-017301.labs.microstrategy.com&project=MicroStrategy+Tutorial&reportViewMode=1&evt=4001&reportID=5745ADCC4B3736B03FCF64ADD491BA2B&messageID=82733E5B48EB8121F4F740B26744FFA1&Port=34952
Otherwise, the link to History List will keep the same as before.
So Since MSTR m2021 Update1, users can decide whether they want just machine name or FQDN for the server name in the link to History List.
Note: No matter which server name users choose, the link to History List can always work if we make sure the server name configured in the Web Admin page to be consistent with the server name generated by Intelligence Server for History List link.