How to redirect legacy SDMS WebVision URLs to a new server - WKB54295

OBJECTIVE or GOAL

Redirect legacy SDMS WebVision URLs, which were stored outside of SDMS and are read-only, to a new SDMS web server.

ENVIRONMENT

• NuGenesis 9 SDMS
• NuGenesis 8 SDMS
• The NuGenesis database contains data that was migrated from a previous version of NuGenesis
• The NuGenesis web server has a different name than its predecessor
• SDMS WebVision URLs were stored outside of NuGenesis in another system, are read-only, and point to the old NuGenesis web server

PROCEDURE

1. Configure a CNAME entry in the relevant DNS server so that the old NuGenesis web server's name resolves to the IP address of the new NuGenesis web server.
2. Configure a URL Rewrite rule in IIS on the new NuGenesis web server. This rule will change the hostname in the URL from the old name to the new one as the request is parsed by the server. This step is critical, so that when the HTTP reply from the server is received by the client, the hostname in the URL will match the "Issued To" name in the HTTPS certificate.
   1. In IIS Administrator, select the server entry in the list, and double-click URL Rewrite.
   2. Click Add Rule(s).
   3. Select Inbound rules > Blank rule.
   4. Enter a name for the rule.
   5. Set the following parameters:
      1. Match URL
         1. Requested URL: Matches the Pattern
         2. Using: Regular expressions
         3. Pattern: .*
      2. Conditions:
         1. Expand the Conditions section
         2. Logical grouping: Match Any
         3. Click the Add button
            1. Condition input: {HTTP_HOST}
            2. Check if input string: Matches the Pattern
            3. Pattern: oldServerName
         4. If additional server names are needed, repeat these three steps, substituting the other legacy server name for "oldServerName"
      3. Server Variables: leave blank
      4. Action
         1. Action type: Redirect
         2. Rewrite URL: https://newServerName{REQUEST_URI}
         3. Append query string: false
         4. Redirect type: Permanent (301)
   6. Click the Apply button.
   7. Restart IIS.
3. Move the new rule to the top of the list, above the "SDMS" rule
4. Modify the Default Web Site's web.config file to allow additional characters in HTTP requests.
   1. Edit this file in Notepad: Drive:\inetpub\wwwroot\web.config
   2. Add the following lines to the file below "<configuration>"
      •  <system.web>
          <httpRuntime requestPathInvalidCharacters="*,:,&amp;,\" />
         </system.web>
   3. Save and close the file.

ADDITIONAL INFORMATION

This procedure ensures that the legacy URLs are handled by the new NuGenesis web server. It does not modify the SDMS server name embedded in the WebVision URLs. If the server name in the URL—that is, the name immediately following %3cLocal%20Servers%3e or %3cV2%3e in the URL—also changes, the new NuGenesis server must make use of the "URL Redirector" utility. This tool is provided at no charge to customers with an active service plan as part of the NuGenesis 8 Utilities release. The URL redirector is an ISAPI filter that can change the URLs based on a series of mappings in a configuration file. If the SDMS server name will not change in the new NuGenesis system, the URL redirector is not needed.