Difference between revisions of "RCUG 1 Introducing RootCause"
m |
m |
||
| Line 16: | Line 16: | ||
<!-- header --> {{FULLPAGENAME}} | <!-- header --> {{FULLPAGENAME}} | ||
| − | + | rcc-4 | |
| − | |||
| − | |||
<!-- | <!-- | ||
<DIV> | <DIV> | ||
<A NAME=HEADING4></A> | <A NAME=HEADING4></A> | ||
| − | |||
<DIV> | <DIV> | ||
| − | <P><A HREF=rcc-5.html>[Next]</A> <A HREF=rcc-3.html>[Previous]</A> <A HREF=rcc-1.html>[Top]</A> <A | + | <P><A HREF=rcc-5.html>[Next]</A> |
| − | + | <A HREF=rcc-3.html>[Previous]</A> | |
| − | HREF=rcc-3.html>[Contents]</A> <A HREF=rcc-14.html>[Index]</A></P> | + | <A HREF=rcc-1.html>[Top]</A> |
| + | <A HREF=rcc-3.html>[Contents]</A> | ||
| + | <A HREF=rcc-14.html>[Index]</A></P> | ||
<P>RootCause</P> | <P>RootCause</P> | ||
| − | + | </DIV> | |
| − | </DIV | + | <A NAME="LINK-01intro_rc.fm-firstpage"></A> |
| − | + | <A NAME=HEADING4-0></A> | |
| − | |||
<A NAME="UID-01intro_rc.fm-864080"></A> --> | <A NAME="UID-01intro_rc.fm-864080"></A> --> | ||
| − | <!-- <H1> <A NAME=MARKER-9-153></A> Introducing RootCause</H1> -- | + | <!-- <H1> <A NAME=MARKER-9-153></A> Introducing RootCause</H1> |
| − | + | ---- <!-- <HR> --> | |
| − | <HR> | ||
| − | |||
<!-- | <!-- | ||
<A NAME=HEADING4-1></A> | <A NAME=HEADING4-1></A> | ||
<A NAME="UID-01intro_rc.fm-949214"></A> --> | <A NAME="UID-01intro_rc.fm-949214"></A> --> | ||
| − | + | == What Is RootCause? == | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | RootCause is a sophisticated tool designed to help software organizations solve a problem as quickly as possible, ideally from a single occurrence, while simultaneously reducing support costs. Fundamental to this is a tracing capability. We have designed RootCause to make powerful application tracing and root cause analysis as simple as possible. | |
| − | + | The fundamental concept is that all of the data needed to debug an application problem is recorded in its RootCause workspace. The RootCause Console Graphical User Interface (GUI) allows you to choose the data to be collected and to navigate the collected data. | |
| − | + | When an application problem occurs, the "user" sends the RootCause workspace to the support organization as the problem report. If the support organization has defined the trace correctly, this RootCause workspace contains sufficient information to do the root cause analysis of the problem. There's no need to recreate the problem or ask the user further questions. | |
| − | platform or on a customer's computer, without access to the development environment. | + | The RootCause Console tools are used in the application development and support environments to define what to trace and also ultimately to view the trace data. The application being traced may be run in the development environment as well, of course; or it may be run remotely, on a separate test platform or on a customer's computer, without access to the development environment. |
| − | + | You can choose to | |
<!-- <A NAME=MARKER-2-154></A> --> | <!-- <A NAME=MARKER-2-154></A> --> | ||
| − | deploy the RootCause trace to the application environment after a problem occurs, or you can include | + | deploy the RootCause trace to the application environment after a problem occurs, or you can include RootCause as part of your shipped application so that any time a problem occurs you can immediately examine the data collected by RootCause to perform a root cause analysis of the problem. |
| − | RootCause | + | Note that RootCause is designed to work on shipped applications. No change is needed to your application or your build processes! The traces will be automatically inserted into your application when a copy of it is loaded into memory; the traces remain only while your application is running, and they vanish afterwards. |
| − | + | <!-- | |
| − | + | <A NAME=HEADING4-8></A> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | <!-- <A NAME=HEADING4-8></A> | ||
<A NAME="UID-01intro_rc.fm-950330"></A> --> | <A NAME="UID-01intro_rc.fm-950330"></A> --> | ||
| + | == Java, C++, or Both? == | ||
| − | + | RootCause is packaged as '''RootCause for Java''' and '''RootCause for C++'''. This is the user's guide for the | |
| − | |||
| − | |||
| − | |||
| − | user's guide for the | ||
<!-- <A NAME=MARKER-10-155></A> --> | <!-- <A NAME=MARKER-10-155></A> --> | ||
| − | + | '''C++''' version only. You should read the documentation and do the demos that correspond to the version of RootCause you're interested in. | |
| − | version | + | The differences in features between '''RootCause for Java''' and '''RootCause for C++''' are determined solely by the license key(s) you are issued by OC Systems. If this isn't the version you want, or you want to use RootCause on native code libraries loaded by Java, or Java run as applets or beans from a compiled application, you will need licenses to enable both the Java and C++ features. For more information see |
| + | []<A HREF="rcc-5.html#MARKER-9-259">"Licensing"</A>, and | ||
| + | []<A HREF="rcc-13.html#MARKER-9-2192">"Tracing Java and C++ In One Program"</A>. | ||
| − | + | <!-- | |
| − | + | <A NAME=HEADING4-11></A> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | <!-- <A NAME=HEADING4-11></A> | ||
<A NAME="UID-01intro_rc.fm-944228"></A> --> | <A NAME="UID-01intro_rc.fm-944228"></A> --> | ||
| + | == About This Guide == | ||
| − | + | This User's Guide describes version 2 of the RootCause product for | |
| − | |||
| − | |||
<!-- <A NAME=MARKER-10-156></A> --> | <!-- <A NAME=MARKER-10-156></A> --> | ||
C/C++ | C/C++ | ||
| Line 126: | Line 78: | ||
on the Unix | on the Unix | ||
<!-- <A NAME=MARKER-10-158></A> --> | <!-- <A NAME=MARKER-10-158></A> --> | ||
| − | platform. Your feedback is desired, both on problems that you encounter and on suggestions of how the | + | platform. Your feedback is desired, both on problems that you encounter and on suggestions of how the product could better accomplish its goals of solving problems from a single occurrence and of reducing support costs. |
| − | |||
| − | product could better accomplish its goals of solving problems from a single occurrence and of reducing | ||
| − | + | Please e-mail feedback to [mailto:support@ocsystems.com support@ocsystems.com] | |
| − | + | <!-- <A HREF="mailto:support@ocsystems.com">support@ocsystems.com</A> --> | |
| − | + | and indicate what version of RootCause you are using. The version number can be obtained | |
| − | <A HREF="mailto:support@ocsystems.com">support@ocsystems.com</A> | ||
| − | and indicate what version of RootCause you are using. The version number can be obtained | ||
<!-- <A NAME=MARKER-10-161></A> --> | <!-- <A NAME=MARKER-10-161></A> --> | ||
| − | with the command <CODE>rootcause help</CODE>. | + | with the command <CODE>rootcause help</CODE>. |
| − | + | If you are evaluating RootCause, or you are a first time user, we suggest that you install RootCause in a local directory (no special system administrator privileges are needed) and do the demonstrations outlined in | |
| + | []<A HREF="rcc-8.html#MARKER-9-707">Chapter 5, "RootCause Demo"</A>. | ||
| + | Then return to this manual to get specific questions answered. If the information is not clear, let us know. | ||
| − | + | []<A HREF="rcc-5.html#MARKER-9-205">Chapter 2, "Installing RootCause"</A> | |
| + | discusses the installation of RootCause. | ||
| − | + | []<A HREF="rcc-6.html#MARKER-9-335">Chapter 3, "Terminology and Concepts"</A> | |
| + | introduces some terminology and concepts that RootCause users should know to make best use of the product. This chapter also contains a | ||
| + | []<A HREF="rcc-6.html#MARKER-9-386">Glossary</A>. | ||
| − | <A HREF="rcc- | + | []<A HREF="rcc-7.html#MARKER-9-508">Chapter 4, "Getting Started"</A> |
| + | discusses how an individual user would set up to use RootCause after it is installed and gives a quick description of getting started with RootCause. | ||
| − | + | []<A HREF="rcc-8.html#MARKER-9-707">Chapter 5, "RootCause Demo"</A> | |
| + | demonstrates how to apply RootCause to a simple program. | ||
| − | + | []<A HREF="rcc-9.html#MARKER-9-873">Chapter 6, "Deploying the RootCause Workspace"</A> | |
| + | explains how to define a RootCause trace session at your local site and then send it to a remote site to do remote debugging. | ||
| − | + | []<A HREF="rcc-10.html#MARKER-9-946">Chapter 7, "RootCause Files and Environment Variables"</A> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | Variables"</A> | ||
discusses the environment variables | discusses the environment variables | ||
<!-- <A NAME=MARKER-10-162></A> --> | <!-- <A NAME=MARKER-10-162></A> --> | ||
| − | and files that affect RootCause. | + | and files that affect RootCause. |
| − | |||
| − | |||
| − | |||
| − | + | []<A HREF="rcc-11.html#MARKER-9-1320">Chapter 8, "RootCause GUI Reference"</A> | |
| + | describes the RootCause Graphical User Interface in detail, briefly describing each dialog, menu item, and button. | ||
| − | + | []<A HREF="rcc-12.html#MARKER-9-2008">Chapter 9, "RootCause Command Reference"</A> | |
| − | describes the <CODE>rootcause</CODE> command line. | + | describes the <CODE>rootcause</CODE> command line. |
| − | + | []<A HREF="rcc-13.html#MARKER-9-2163">Chapter 10, "Selected Topics"</A> | |
| − | contains technical discussions for issues of interest to RootCause users. | + | contains technical discussions for issues of interest to RootCause users. |
| − | + | <!-- <A NAME=MARKER-10-163></A> --> | |
Problems and platform-specific issues are discussed in the | Problems and platform-specific issues are discussed in the | ||
<!-- <A NAME=MARKER-2-164></A> --> | <!-- <A NAME=MARKER-2-164></A> --> | ||
| − | Release Notes for the current release of the product. | + | Release Notes for the current release of the product. |
| − | + | Check our web site at [http://www.ocsystems.com/ www.ocsystems.com] | |
| − | <A HREF="http://www.ocsystems.com/">www.ocsystems.com</A> | + | <!-- <A HREF="http://www.ocsystems.com/">www.ocsystems.com</A> --> |
for | for | ||
<!-- <A NAME=MARKER-2-167></A> --> | <!-- <A NAME=MARKER-2-167></A> --> | ||
| − | white papers and the newest version of the product. | + | white papers and the newest version of the product. |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
<!-- | <!-- | ||
| − | <P><A HREF=rcc-5.html>[Next]</A> <A HREF=rcc-3.html>[Previous]</A> <A HREF=rcc-1.html>[Top]</A> <A | + | <A NAME="LINK-01intro_rc.fm-lastpage"></A> |
| − | + | </DIV> | |
| − | HREF=rcc-3.html>[Contents]</A> <A HREF=rcc-14.html>[Index]</A></P> | + | <DIV> |
| + | ---- <!-- <HR> --> | ||
| + | <!-- | ||
| + | <P><A HREF=rcc-5.html>[Next]</A> | ||
| + | <A HREF=rcc-3.html>[Previous]</A> | ||
| + | <A HREF=rcc-1.html>[Top]</A> | ||
| + | <A HREF=rcc-3.html>[Contents]</A> | ||
| + | <A HREF=rcc-14.html>[Index]</A></P> | ||
<P></P> | <P></P> | ||
<ADDRESS>Copyright 2006 OC Systems, Inc.</ADDRESS> | <ADDRESS>Copyright 2006 OC Systems, Inc.</ADDRESS> | ||
| − | <P></P | + | <P></P> |
| − | + | </DIV> --> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
<!-- footer --> | <!-- footer --> | ||
Revision as of 02:40, 16 August 2017
RootCause User Guide
Contents
Introducing RootCause
RCUG 1 Introducing RootCause
rcc-4
What Is RootCause?
RootCause is a sophisticated tool designed to help software organizations solve a problem as quickly as possible, ideally from a single occurrence, while simultaneously reducing support costs. Fundamental to this is a tracing capability. We have designed RootCause to make powerful application tracing and root cause analysis as simple as possible.
The fundamental concept is that all of the data needed to debug an application problem is recorded in its RootCause workspace. The RootCause Console Graphical User Interface (GUI) allows you to choose the data to be collected and to navigate the collected data.
When an application problem occurs, the "user" sends the RootCause workspace to the support organization as the problem report. If the support organization has defined the trace correctly, this RootCause workspace contains sufficient information to do the root cause analysis of the problem. There's no need to recreate the problem or ask the user further questions.
The RootCause Console tools are used in the application development and support environments to define what to trace and also ultimately to view the trace data. The application being traced may be run in the development environment as well, of course; or it may be run remotely, on a separate test platform or on a customer's computer, without access to the development environment.
You can choose to deploy the RootCause trace to the application environment after a problem occurs, or you can include RootCause as part of your shipped application so that any time a problem occurs you can immediately examine the data collected by RootCause to perform a root cause analysis of the problem.
Note that RootCause is designed to work on shipped applications. No change is needed to your application or your build processes! The traces will be automatically inserted into your application when a copy of it is loaded into memory; the traces remain only while your application is running, and they vanish afterwards.
Java, C++, or Both?
RootCause is packaged as RootCause for Java and RootCause for C++. This is the user's guide for the C++ version only. You should read the documentation and do the demos that correspond to the version of RootCause you're interested in.
The differences in features between RootCause for Java and RootCause for C++ are determined solely by the license key(s) you are issued by OC Systems. If this isn't the version you want, or you want to use RootCause on native code libraries loaded by Java, or Java run as applets or beans from a compiled application, you will need licenses to enable both the Java and C++ features. For more information see []<A HREF="rcc-5.html#MARKER-9-259">"Licensing"</A>, and []<A HREF="rcc-13.html#MARKER-9-2192">"Tracing Java and C++ In One Program"</A>.
About This Guide
This User's Guide describes version 2 of the RootCause product for C/C++ on the Unix platform. Your feedback is desired, both on problems that you encounter and on suggestions of how the product could better accomplish its goals of solving problems from a single occurrence and of reducing support costs.
Please e-mail feedback to support@ocsystems.com
and indicate what version of RootCause you are using. The version number can be obtained
with the command rootcause help.
If you are evaluating RootCause, or you are a first time user, we suggest that you install RootCause in a local directory (no special system administrator privileges are needed) and do the demonstrations outlined in []<A HREF="rcc-8.html#MARKER-9-707">Chapter 5, "RootCause Demo"</A>. Then return to this manual to get specific questions answered. If the information is not clear, let us know.
[]<A HREF="rcc-5.html#MARKER-9-205">Chapter 2, "Installing RootCause"</A> discusses the installation of RootCause.
[]<A HREF="rcc-6.html#MARKER-9-335">Chapter 3, "Terminology and Concepts"</A> introduces some terminology and concepts that RootCause users should know to make best use of the product. This chapter also contains a []<A HREF="rcc-6.html#MARKER-9-386">Glossary</A>.
[]<A HREF="rcc-7.html#MARKER-9-508">Chapter 4, "Getting Started"</A> discusses how an individual user would set up to use RootCause after it is installed and gives a quick description of getting started with RootCause.
[]<A HREF="rcc-8.html#MARKER-9-707">Chapter 5, "RootCause Demo"</A> demonstrates how to apply RootCause to a simple program.
[]<A HREF="rcc-9.html#MARKER-9-873">Chapter 6, "Deploying the RootCause Workspace"</A> explains how to define a RootCause trace session at your local site and then send it to a remote site to do remote debugging.
[]<A HREF="rcc-10.html#MARKER-9-946">Chapter 7, "RootCause Files and Environment Variables"</A> discusses the environment variables and files that affect RootCause.
[]<A HREF="rcc-11.html#MARKER-9-1320">Chapter 8, "RootCause GUI Reference"</A> describes the RootCause Graphical User Interface in detail, briefly describing each dialog, menu item, and button.
[]<A HREF="rcc-12.html#MARKER-9-2008">Chapter 9, "RootCause Command Reference"</A>
describes the rootcause command line.
[]<A HREF="rcc-13.html#MARKER-9-2163">Chapter 10, "Selected Topics"</A> contains technical discussions for issues of interest to RootCause users.
Problems and platform-specific issues are discussed in the Release Notes for the current release of the product.
Check our web site at www.ocsystems.com for white papers and the newest version of the product.
Copyright 2006-2017 OC Systems, Inc.