E
dit
A
ttach
P
rintable
r12 - 2015-05-27 - 16:50:27 - Main.sbagot
You are here:
TWiki
>
Deployment Web
>
DeploymentTroubleshooting
>
UpgradeTroubleshooting
>
RRDIUpgrade
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%"> ---+!! <img src="" alt="" width="50" height="50" align="right"/> RRDI upgrade troubleshooting %DKGRAY% Authors: Main.StephanieBagot, [[UpgradeTroubleshootingTeam][UpgradeTroubleshootingTeam]]<br> Build basis: CLM 3.x and later, RRDI 2.x and later %ENDCOLOR%</div></sticky> <!-- Page contents top of page on right hand side in box --> <sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;"> %TOC{title="Page contents"}% </div></sticky> <sticky><div style="margin:15px;"></sticky> This page is the starting point for information and techniques to help diagnose and troubleshoot upgrade issues when upgrading Rational Reporting for Development Intelligence (RRDI) servers. ---++ Before upgrading * Check the [[https://jazz.net/wiki/bin/view/Deployment/RRDIKnownIssues][Known issues]] as a prerequisite for the upgrade * [[https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.rational.rrdi.admin.doc/topics/t_postupgrade_backup.html&scope=null][Backup your current RRDI Configuration]] * Ensure that your current environment meets all the requirements by checking the [[EnvironmentCheckList][Environment checklist]] and [[https://jazz.net/wiki/bin/view/Deployment/VersionCompatibilityCLMRRDIAndInsight][Version Compatibility]] * Perform the upgrade in a test environment prior to upgrading your production environment ---+++ Upgrade Philosophy During an RRDI Upgrade, you may be advised on some 'philosophies' on how to be best successful in your upgrade. Below we discuss some of these items. ---++++ Always upgrade CLM before RRDI We advise the upgrade of CLM prior to RRDI to ensure that the data warehouse is at the correct level prior to an RRDI upgrade. If you choose to upgrade RRDI first, be prepared to see a "The datawarehouse was created by a previous version" error. The workaround is discussed below under Performing the Upgrade. ---++++ Always keep RRDI and CLM at the same version level This is a recommendation to ensure that you are using a tested compatible version of both products, as well as utilizing all features or changes. However, this is not a hard rule. See [[https://jazz.net/wiki/bin/view/Deployment/VersionCompatibilityCLMRRDIAndInsight][Version Compatibility]] for more information on which versions are supported together if you cannot keep RRDI and CLM at the same version. ---++++ You must download RRDI Installation Repository to install While you have the option to download the RRDI Installation Repository from jazz.net to install RRDI, you can also upgrade in-place referencing the repositories on jazz.net. ---++ Performing the upgrade This section will discuss known issues that can occur during the outlined steps of the upgrade for the Rational Reporting for Development Intelligence server. ---+++ Install the new version RRDI * Some installation issues: [[http://www-01.ibm.com/support/docview.wss?uid=swg21665912][Technote 1665912: RRDI Installation or upgrade fails with wrong MD5]] [[http://www-01.ibm.com/support/docview.wss?uid=swg21567843][Technote 1567843: Installation fails with error "CRRRD4515E Error creating table spaces"]] ---+++ Starting the setup wizard for RRDI and proceeding with its configuration * The following article [[https://jazz.net/library/article/1294][Workarounds: Setup problems in RRDI 2.0.3]] discusses known issues with RRDI Setup problems ---++++ Error "The datawarehouse was created by a previous version" This error is indicative that the datawarehouse used by a CLM application was created with an older version. For example, if you are upgrading RRDI to 2.0., this error may occur if CLM is at version 3.0.1. This error is document in [[http://www-01.ibm.com/support/docview.wss?uid=swg21614140][Technote 1614140: Running RRDI Setup during upgrade results in Previous Version error]]. ---++++ Deploying report resources results in CRRRA2083E Upon deploying the report resources in the setup wizard for RRDI, the following error is seen: <verbatim>CRRRA2083E: Cannot connect to the report server</verbatim> For information on this error, see [[http://www-01.ibm.com/support/docview.wss?uid=swg21652043][Technote 1652043: Upgrading RRDI results in CRRRA2083E error during RRDI setup]] ---+++ Uninstalling the previous version of RRDI ---++ Issues during upgrade If the setup fails, consult the technote [[http://www-01.ibm.com/support/docview.wss?uid=swg21645071][MustGather: Diagnostic information for IBM Rational Reporting Development Intelligence and Insight]] section RRDI/Insight Setup Wizard for logs Additional tips may be found under this topic: [[https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.rational.rrdi.admin.doc/topics/r_upgrade.html&scope=null][Troubleshooting the upgrade of Rational Reporting for Development Intelligence]] ---+++ Proceeding through the steps manually In some cases, it may be necessary to proceed through a step manually. <br>These steps are not detailed in the Information Center. There is an [[http://www.ibm.com/developerworks/rfe/execute?use_case=viewRfe&CR_ID=53215][Enhancement (53215)]] open to have the manual steps documented. <br>Here are the detailed steps for the setup wizard: 1. Configure Database Management System 2. Configure Content Store Database * [[https://jazz.net/help-dev/clm/topic/com.ibm.rational.rrdi.admin.doc/topics/t_configure_content_store_combine.html][Creating the database for the content store]] * During the setup, save configuration scripts to run after you finish deploying the report server. * [[http://pic.dhe.ibm.com/infocenter/clmhelp/v3r0m1/index.jsp?topic=%2Fcom.ibm.rational.rcpr.help.doc%2Ftopics%2Ft_add_content_store_object.html][Configure connection to the Content Store]] 3. Configure Data Warehouse * Create data warehouse * [[http://pic.dhe.ibm.com/infocenter/clmhelp/v4r0m6/index.jsp?topic=%2Fcom.ibm.jazz.install.doc%2Ftopics%2Fr_repotools_createwarehouse.html][Populate data warehouse]] <verbatim> repotools-jts -createWarehouse </verbatim> * Connect report server to data warehouse 4. [[http://pic.dhe.ibm.com/infocenter/clmhelp/v3r0m1/index.jsp?topic=%2Fcom.ibm.rational.rcpr.help.doc%2Ftopics%2Ft_postreq_reportalserver_db2isdw_repservISwas.html][Configure Application Server]] 5. Configure Rational Reporting User Authentication 6. [[http://pic.dhe.ibm.com/infocenter/clmhelp/v3r0m1/index.jsp?topic=%2Fcom.ibm.rational.rcpr.help.doc%2Ftopics%2Ft_postreq_reportalserver_db2isdw_repservISwas.html][Build and Deploy Reporting Components]] ---++++ How to Reinitialize the Setup Wizard User data (all values entered in the RRDI Setup Wizard) is persisted in a triple store database as a collection of files in the [RRDI-Install-Location]/setup/tool/JazzTeamServer/server/conf/rrdi/repository directory. You may want to re-initialize the setup wizard without having to reinstall. For example, you need to reset the password or change a port. Here are the steps: 1. Back up all the files in <verbatim>[RRDI-Install-Location]/setup/tool/JazzTeamServer/server/conf/rrdi/repository directory</verbatim> 2. Delete the content of this directory. 3. Start the RRDI Setup Wizard again 4. Re-enter values for all the steps and fields in the Wizard. This will update the RRDI Setup Wizard's configuration data. ---++ Issues after upgrade * Check the [[https://jazz.net/library/#q=&tag=workaround%2C2.0&project=rrdi&sort=pubDate][documented workarounds]] for known issues ---++ Where do I go from here? If you are unable to resolve your issue using the available online resources, open a service request with IBM Rational Support. Refer to [[DataCollectionandSupportResources][Additional troubleshooting resources]] for further details.<br> ---+++++!! Related topics: None ---+++++!! External links: * None ---+++++!! Additional contributors: Main.AntoinetteIacobo <sticky></div></sticky>
E
dit
|
A
ttach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
: r12
<
r11
<
r10
<
r9
<
r8
|
M
ore topic actions
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use.
Please read the following
disclaimer
.