miclark/jboss-as — comment on commit 53d90c8f33cea283bf24f683f5488d98d7c45b81
File:  line 0
By miclark:

Hey Jaikiran,

> what does this tool do?
This tool creates a "JDR Report" which is a zip file containing a
listing of all files in the instance, log files, configuration files,
list of jars with checksums, and runtime info if available. It is
executed by the :generate-jdr-report operation. This addresses PRD item
1002: "It will be possible to generate support snapshots..."

On 11/03/2011 03:45 AM, Jaikiran wrote:
> I don't know much about what this tool does, so my questions are really basic:
>
> 1) Does this really have to be a "subsystem" within the AS? Isn't it just another tool, that could perhaps be deployed or integrated in some other way?
This a good question. I went down a subsystem route based on Brain
Stansberry's suggestion. We certainly would like access to the
generate-jdr-report operation via the management apis (and eventually
have access via the Admin Console.) I happy to entertain other
approaches if you feel there is a better way.
> 2) Does this really have to be part of the AS codebase? i.e. should it be built (in each AS build) and released as part of AS7 release lifecycle
Another good question. From my view, it wouldn't have to be in the AS
code base. But, I think it makes sense as a component that generates a
packaged "snapshot" of the system. I went the AS7 route after putting
this question to Brain as well. At the time (and before any code was
slung) he agreed it should be in the AS7 code base. Again, happy to
discuss alternatives.
> 3) How is the report generation triggered? Or what triggers the report generation? Depending on that, perhaps the "services" that are installed by this subsystem might be marked as ON_DEMAND? Currently they are installed as ACTIVE.
It can be triggered in two ways. First via the CLI
(subsystem="jdr":generate-jdr-report). Then, there is some scripts to
run outside the AS ($JBOSS_HOME/bin/util/jdr.sh). (Eventually we may
also have a Log Handler to trigger a report when, for example, specific
message id's appear to catch a snapshot at the time specific errors occur.)

Cheers,
Mike C.