# ARCS: $Header: /home/cvs/repository/RDA_4/src/scripting/lib/modules/profiles.pod,v 1.22 2008/02/25 14:14:50 mschenke Exp $
=head1 NAME

profiles - Oracle Remote Diagnostic Agent Setup Profiles

=head1 PROFILE DEFINITION

A setup profile consists of a list of data collection modules and predefined
settings. Therefore, the data collected using a profile can be slightly
different than using the module separately. Profiles are typically used to
set up all modules required to diagnose a specific class of problems.

Profile names are case sensitive.

=head1 USING A PROFILE

In this page, E<lt>rdaE<gt> represents the command you selected to run RDA (for
example, F<rda.pl>, F<rda.cmd>, F<rda.sh>, and C<perl rda.pl>).

When profiles are not used, RDA considers all existing modules by default. To
set up the data collection with a profile, use the following command:

<rda> -S -p <profile_name>

Run the data collection as usual. If you want to perform all steps in a single
run, then use a command such as the following:

<rda> -vdSCRP -p <profile_name>

You can combine profiles with other options. For example, specify an
alternative setup file location as follows:

<rda> -vdSCRP -s $HOME/rda/system1 -p <profile_name>

Note: The F<$HOME/rda> directory must exist and is used also as the default
location for the report directory.

While a profile remains the current profile, its setting values can
override other default values each time the setup is performed. To avoid this
behavior, you can switch to the C<Default> profile, by using a command similar
to the following:

<rda> -S -p Default

To obtain a list of available profile names and their applicability, use the
following command:

<rda> -L profiles

To view this manual page, enter the following:

<rda> -M profiles

To obtain the modules and profiles cross reference, enter the following:

<rda> -x profiles

=head2 Setting Level Definitions

Only a minimum set of settings are prompted by default. To fine-tune the data
collection, run the profile with the C<advanced> setting level. For
example:

<rda> -S -p advanced DB

This setting level is stored in the setup file. Therefore, if you have to
change the setting level, then run the profile again as follows:

<rda> -S -p basic CFG

To obtain the list of all setting levels, enter the following:

<rda> -L levels

=head2 Combining Setting Level and Profile

You can combine setting levels and profiles by concatenating them with a '-'
sign. You can specify them in any order.

<rda> -S -p AS10g-advanced

As mentioned above, the setting level is saved in the setup file and is reused
by default in the next setup operations, including when configuring extra
modules.

=head2 Custom Profiles Definitions

These explanations assume that you are using the default profile definition
file. You can define the location of a custom profile definition with an
C<RDA_PROFILE> environment variable.

=head1 PROFILE APPLICABILITY

=over 20

=item o B<9iAS             > Oracle Application Server 9i-related problems

=item o B<AS10g            > Oracle Application Server 10g-related problems

=item o B<AS_BackupRecovery> Oracle Application Server backup and recovery-related problems

=item o B<AS_MiddleTier    > Oracle Application Server middle tier-related problems

=item o B<Act              > Oracle Applications overview

=item o B<AppsCheck        > Equivalent to Appscheck

=item o B<Beehive          > Oracle Beehive-related problems

=item o B<Beehive_Oid      > Oracle Beehive and OID-related problems

=item o B<DB8i             > Oracle Database 8i-related problems

=item o B<DB9i             > Oracle Database 9i-related problems

=item o B<DB10g            > Oracle Database 10g-related problems

=item o B<DB_BackupRecovery> Oracle Database backup and recovery-related problems

=item o B<DB_Perf          > Oracle Database performance problems

=item o B<Discoverer       > Oracle Discoverer-related problems

=item o B<Linux            > Linux-related problems

=item o B<LinuxPerf        > Linux performance problems

=item o B<OSMonitor        > Operating system performance sampling

=item o B<Pda              > Portal-related problems

=item o B<Rac              > Real Application Cluster-related problems

=item o B<Rac_AdvancedAsm  > Cluster and ASM-related problems (ASM advanced mode)

=item o B<Rac_Asm          > Cluster and ASM-related problems

=item o B<Rac_Perf         > Cluster performance problems

=item o B<Retail           > Oracle Retail problems

=item o B<Security         > Filter sensitive information from the reports

=item o B<SupportInformer70> Portal Software 7.0 problems

=item o B<SupportInformer72> Portal Software 7.2 problems

=item o B<SupportInformer73> Portal Software 7.3 problems

=item o B<WebCenter        > Oracle WebCenter-related problems

=back

=head1 COPYRIGHT NOTICE

Copyright (c) 2002-2008, Oracle. All rights reserved.

=head1 TRADEMARK NOTICE

Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle
Corporation and/or its affiliates. Other names may be trademarks of their
respective owners.