Installation Instructions

1. Before you begin, ensure that you have performed a successful backup of your Rational Change databases.
   
   
2. Log in to the machine where Rational Change is installed as the user who installed Rational Change.
   
   
3. Unzip (Windows) or untar (UNIX) the patch file into <CHANGE_APP_HOME>/WEB-INF/packages. The resultant directory will have the name rc<patch version>.
   
   For example, on UNIX:
   $ cd <CHANGE_APP_HOME>/WEB-INF/packages
   $ tar xvf <file path>
   
   
4. Install the Interim Fix
1. Login to Rational Change as Admin, and click the System Administration link in the action panel.
2. Click on the Package Installer tab, select this fix pack from the Available Packages listbox, and click the Install button.
3. Add below tags to "WEB-INF\web.xml" just before the commented line "<!-- The encoding filter needs to be first to correctly commit the"

<filter> <filter-name>ParamFilter</filter-name> <filter-class>com.telelogic.cs.filters.ParamFilter</filter-class> <init-param> <param-name>excludeParams</param-name> <param-value>(.*\.|^|.*|\[('|"))(c|C)lass(\.|('|")]|\[).*</param-value> </init-param> </filter> <filter-mapping> <filter-name>ParamFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

4. Logging mechanism for Change and RDS communication is improved and this requires adding below tags to configuration file "<CHANGE_APP_HOME>/WEB-INF/classes/TDSConfiguration.xml".

<entry key="TDSAT_LOGGING_LEVEL">INFO</entry> <!-- Levels can be : SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF --> <entry key="TLS_LDAPLIB_LOGGING_LEVEL">INFO</entry> <!-- Levels can be : SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF-->

5. After the patch installation is successful, stop and re-start Rational Change.
   
   Notes:
• If Rational Change is running in the WAS or WASCE application server, restart the application server
• If you are using the OSLC REST API (used to integrate with products such as Rational Publishing Engine and Rational Quality Manager) for the first time, stop and start Rational Change again to activate the API.
  
  
5. Uninstall the Interim Fix:
   If it becomes necessary to remove this iFix after it has been installed, apply the following steps.
1. Login to Rational Change as Admin, and click the System Administration link in the action panel.
2. Click on the Package Installer tab, select the fix pack from the Installed Packages listbox, and click the Uninstall button.
3. Delete below tags from "WEB-INF\web.xml" just before the commented line "<!-- The encoding filter needs to be first to correctly commit the"

<filter> <filter-name>ParamFilter</filter-name> <filter-class>com.telelogic.cs.filters.ParamFilter</filter-class> <init-param> <param-name>excludeParams</param-name> <param-value>(.*\.|^|.*|\[('|"))(c|C)lass(\.|('|")]|\[).*</param-value> </init-param> </filter> <filter-mapping> <filter-name>ParamFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

4. Stop and start Rational Change.
   
   Note: If Rational Change is running in the WAS or WASCE application server, restart the application server.