Edit
Attach
P
rintable
r4 - 2018-03-23 - 11:38:53 -
PaulEllis
You are here:
TWiki
>
Deployment Web
>
ServiceabilityWhereToStart
<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="https://jazz.net/wiki/pub/Deployment/WebPreferences/community-img.gif" alt="community-img.gif" width="52" height="80" align="left" hspace="10"/> Serviceability: Where to start? %DKGRAY% Cross-cutting theme technical leaders and senior editors: Main.GeraldMitchell <br> %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> UNDER CONSTRUCTION ---++ What is serviceability? ---+++ What does serviceability mean to me? ---++++ As an end user ---++++ As an administrator ---++++ As an implementer ---++ Self-servicing as a Jazz User ---+++ Steps to take Report any issues to the administrator. Gauge the severity of the issue for need of contact. * Take a screen snapshot if appropriate and you have the capability. * If there is an error message, record the error message information, including the error message indicator. * If the problem is related to performance of the interface be specific as to what steps are being taken, and how long it takes to perform the step. If this process was at any time faster, also report the expected performance. Be sure to record the date, time and time length when this issue occurs. * If the problem is related to a specific activity being taken write down all of the steps to the activity including steps not yet taken, and mark where in the steps the problem occurs. If this activity was completed in the past, record the when the last time the activity was successful. ---++ Self-servicing as a Jazz Administrator ---+++ Recognizing there is a problem Assessing the scope of the situation can help you narrow down a list of possible causes. Included below are some questions to keep in mind as you investigate. These questions provide general guidance for getting started and isolating the source of the problem. [[https://jazz.net/wiki/bin/view/Deployment/HowToStartATroubleshootingAssessment][How to start a troubleshooting assessment]] will really assist in gathering the contextual information that IBM Client Success will require. ---+++ Steps to take ---++++ keep complete and consistent backups Keeping good backups allows for quick restoration in the event of a catastrophe. * Keep synchronized Database and index backups. The various indices and database information are directly related and should be saved and restored together. * Keep historically recorded backups. The problem that manifested may have not surfaced for some time. In the event of a problem like data corruption, it may be possible for an IBM Support engineer to aid in recovery if there is a comparable good and bad backup. * Test the backup process. More information on Jazz Backup processes can be found [[https://jazz.net/wiki/bin/view/Deployment/BackupCLM][here]]. ---++++ Record everything during an issue. There may not be time, capability, or awareness to diagnose and fix a problem at the time of occurrence with a permanent solution. Some issues become worse if not corrected, and others will possibly reoccur. It is therefore important to gather and save the information, that can then be reviewed and if necessary passed along to support at a later time. * Always create a backup of database, configuration, and indices before making changes to the system. * Also, make backup copies of the logs when the issue is first discovered, so that the logs do not roll over and the information is lost. * If possible, create a IBM Support Assistance bundle. More information can be found [[#][here]]. * Document who first reported the problem, how, and when. * If the problem is re-creatable, document the steps to recreate, and the time of each recreation. ---++++ Places to look for more information Error messages have a unique identifier. This identifier may be used to search through documentation and support for more information on why the error message occurred, more details into the error, and possible actions to take to resolve the issue. The error message identifier may also be used to search the logs for the occurrences of the the issue that may not have been reported as well as finding the occurrence. The occurrence in the logs may be preceded or followed by more information related to the issue. The time stamp associated in the logs may also be used to correlate the issue with other events such as Database or Network outages, or events in other system logs. There is also a very informative write-up in the [[https://jazz.net/wiki/bin/view/Deployment/CommonJazzHWConfigPerfImpact][Common Jazz hardware configuration and performance impact overview]]. ---++ Involving IBM support If you have a need to open a service request with [[http://www.ibm.com/support/docview.wss?uid=swg27020747][IBM Rational Support]] for further assistance, you can send the archive file with the data collection so that they can help diagnose and fix problems. ---++++Must-gather Must-gather is the information absolutely necessary to resolve an issue through IBM Support * If possible, create a IBM Support Assistance bundle. * More information can be found [[https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.team.concert.doc/topics/t_using_the_isal.html][here]]. * There is a comprehensive [[https://jazz.net/wiki/bin/view/Deployment/MustgatherPerformanceProblemsInCLM][CLM must gather]] within this wiki. * There are specific must-gather information for each product * [[https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.rational.rrm.help.doc/topics/c_compose_reqs.html&scope=null][Troubleshooting the Requirements Management application]] * [[https://jazz.net/wiki/bin/view/Deployment/RTCTroubleshootingBasicsandDataCollection][RTC Troubleshooting Basics and Data Collection]] * [[https://www-947.ibm.com/support/entry/myportal/product/rational/rational_quality_manager?productContext=-1981314478][Support Portal for RQM]] * [[http://www-01.ibm.com/support/docview.wss?uid=swg21645071][Diagnostic information for IBM Rational Reporting Development Intelligence and Insight]] There is also a really helpful page containing [[http://www-01.ibm.com/support/docview.wss?uid=swg21634706][MustGather documents for Rational Collaborative Lifecycle Management products]], focusing on key scenarios and integrations. ---+++++!! Related topics: [[DeploymentWebHome][Deployment web home]] ---+++++!! External links: * None ---+++++!! Additional contributors: Main.PaulEllis <sticky></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r5
<
r4
<
r3
<
r2
<
r1
|
More 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
.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.