{"id":12665,"date":"2026-09-10T14:25:00","date_gmt":"2026-09-10T20:25:00","guid":{"rendered":"https:\/\/www.mrc-productivity.com\/techblog\/?post_type=ht_kb&p=12665"},"modified":"2026-09-10T15:14:12","modified_gmt":"2026-09-10T21:14:12","slug":"application-url-aliases","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/techblog\/?ht_kb=application-url-aliases","title":{"rendered":"Application URL Aliases"},"content":{"rendered":"\n

Say goodbye to deciphering cryptic application names in your browser address bar. The URL Alias feature allows you to serve applications under friendly, memorable URLs\u2014like using \/mrcjava\/servlet\/Customers<\/code> instead of \/mrcjava\/servlet\/MYLIB.I00010s<\/code>\u2014without altering the underlying application. Both the alias and the canonical URL will seamlessly run the same servlet.<\/p>\n\n\n\n

Configuration<\/h2>\n\n\n\n

Navigate to the URL Aliases screen in the m-Power interface by appending \/urlaliases<\/code> to your m-Power URL (e.g., [MPOWERSERVER:PORT]\/webapp\/mrc\/servlet\/mpower#\/urlaliases<\/code>). <\/p>\n\n\n\n

\"\"\/\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

From this screen, click the “Add Alias”<\/strong> button and configure the following:<\/p>\n\n\n\n

    \n
  • Alias Name<\/strong>: The friendly URL name. This must contain only letters, numbers, and underscores. It cannot contain dots, slashes, or dashes.<\/em><\/strong> Aliases must be unique and cannot conflict with reserved names such as app, quicklist, metalist, datastore, or chart.<\/li>\n\n\n\n
  • Application<\/strong>: The canonical LIB.APPNAME<\/code> servlet (e.g., MYLIB.I00010s<\/code>).<\/li>\n\n\n\n
  • Redirect Original URL<\/strong>: When checked, browsers loaded with the canonical URL (LIB.APPNAME) are auto-redirected to the alias. When unchecked, browsers loaded with the canonical URL (LIB.APPNAME) are not<\/em> auto-redirected to the alias and will load as normal. POST requests and ajax calls are never <\/em>redirected.<\/li>\n<\/ul>\n\n\n\n

    Click the “Save Changes”<\/strong> button to save the changes.<\/p>\n\n\n\n

    Every alias change requires a Tomcat restart.<\/p>\n\n\n\n

    Promoting to Production<\/h2>\n\n\n\n

    To apply your new URL aliases to your live environment, you must promote both the alias configuration file (\/mrcjava\/WEB-INF\/classes\/servlet-aliases.json<\/code>) and your updated web.xml<\/code> file to your Production environment. Once these files are successfully promoted, you must restart your production Tomcat service for the aliases to take effect.<\/p>\n\n\n\n

    Developer Notes<\/h2>\n\n\n\n
      \n
    • This feature only changes the URL displayed in the user’s web browser. Behind the scenes, the system will continue using the original application name for background processes like workflow calls, application-to-application communication, logging, auditing, and API connections.<\/li>\n\n\n\n
    • Links created dynamically by custom code (such as Java or JavaScript) might still output the original application name. These links will still work perfectly, and when a user clicks one to navigate to a new page, their browser will automatically redirect them to your friendly alias.<\/li>\n\n\n\n
    • URL aliasing is only supported for standard, compiled applications. Interpretive apps\u2014such as Data Models and AI applications\u2014are not supported.<\/li>\n<\/ul>\n\n\n\n

      Troubleshooting<\/h2>\n\n\n\n

      If an alias fails to map at startup, check the Tomcat catalina logs for URL alias<\/code> messages. The most common cause is the application lacking a servlet entry in the web.xml. This is resolved by running the update-webxml.bat file on the server or recompiling the app.<\/p>\n\n\n\n

      <\/p>\n","protected":false},"excerpt":{"rendered":"

      Say goodbye to deciphering cryptic application names in your browser address bar. The URL Alias feature allows you to serve applications under friendly, memorable URLs\u2014like using \/mrcjava\/servlet\/Customers instead of \/mrcjava\/servlet\/MYLIB.I00010s\u2014without altering the underlying application. Both the alias and the canonical URL will seamlessly run the same servlet. Configuration Navigate to…<\/p>\n","protected":false},"author":10,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[152],"ht-kb-tag":[],"class_list":["post-12665","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-administration"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=\/wp\/v2\/ht-kb\/12665","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=12665"}],"version-history":[{"count":7,"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=\/wp\/v2\/ht-kb\/12665\/revisions"}],"predecessor-version":[{"id":12672,"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=\/wp\/v2\/ht-kb\/12665\/revisions\/12672"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=12665"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=%2Fwp%2Fv2%2Fht-kb-category&post=12665"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/techblog\/index.php?rest_route=%2Fwp%2Fv2%2Fht-kb-tag&post=12665"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}