Guide - 7.8 Migration URL Rewrite Handler

Product Version


Product To Version




1 Introduction

ICM 7.8 and newer versions come with a new URL rewrite handler implementation which is based on configurations stored in XML files. This rewrite handler will be used by default when the system is prepared using DBInit.

2 DBMigrate of URL Rewrite Handler

DBMigrate does not replace any setting in terms of URL rewriting. So for existing systems migrating from ICM 7.7. to 7.8. the URL rewriting will work as before.

It is possible to determine the used rewrite handler with the following statements:

Get current URL rewrite handler
select * from preferencedefinition where preferencename = 'URLRewriteHandler';

select * from preference where preferencename = 'URLRewriteHandler';

If the DefaultValue is com.intershop.beehive.core.internal.urlrewrite.RewriteRuleHandler, then the old rewrite handler implementation is used.

In case you want to manually migrate refer to the recipe Migrate Old Rewrite Properties Configurations.

3 Using the New URL Rewrite Handler Implementation

If the customer wants to use the new URL rewrite handler after a migration to 7.8 the following task needs to be done:

  1. Change the URLRewriteHandler preference definition default value to com.intershop.component.urlrewrite.internal.handler.URLRewriteHandlerImpl.

    Sample sql statement
    update preferencedefinition set defaultvalue = 'com.intershop.component.urlrewrite.internal.handler.URLRewriteHandlerImpl' where preferencename = 'URLRewriteHandler';

    This preference definition default value is used for all channels where the preference is not set explicitly.

  2. Update the existing preferences values for all domains which point to the old URL Rewrite Handler.

    Sample sql statement
    update preference set stringvalue = 'com.intershop.component.urlrewrite.internal.handler.URLRewriteHandlerImpl' where preferencename = 'URLRewriteHandler';
  3. Create according rewrite rules and XML files.
    See Concept - URL Rewriting (from 7.10.5) and Cookbook - URL Rewriting for information how to use the new URL Rewrite Handler.


The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources