http://kerryosborne.oracle-guy.com/2008/10/oracle-management-packs/
There has been quite a bit of confusion about the licensing of Oracle
Management Packs and about their functionality. Here are a couple of links to
the Oracle Docs which describe what’s not allowed without licensing these
packs.
10gR2
Management Pack Licensing
11gR1
Management Pack Licensing
A couple of things to be aware of.
- They are only available with Enterprise Edition
- The Tuning Pack depends on the Diagnostic Pack
11gR1 includes a new parameter (CONTROL_MANAGEMENT_PACK_ACCESS) which
controls access to features based on the Diagnostic and Tuning Packs at the
database level. The valid values for this parameter are NONE, DIAGNOSTIC, and
DIAGNOSTIC+TUNING. Setting this parameter to NONE disables several features at
the database level including AWR (which is the only feature I’ll discuss in this
post). By the way, the default is TUNING+DIAGNOSTICS, so AWR is still enabled by
default. Also, note that snapshots are still created, even if the parameter is
set to NONE, but they don’t contain any data. So they are not just limiting
access to the reporting capability, but also disabling the collection of data.
Here’s a quick example on a 11.1.0.7 database:
SQL> @test_cmpa
SQL> --
SQL> -- Test setting control_management_pack_access=NONE
SQL> --
SQL> select name,value from v$parameter where name like ‘%pack%‘;NAME VALUE
-------------------------------- ------------------------------
control_management_pack_access DIAGNOSTIC+TUNINGSQL> select snap_id, begin_interval_time, snap_level, snap_flag from dba_hist_snapshot where snap_id = (select max(snap_id) from dba_hist_snapshot);
SNAP_ID BEGIN_INTERVAL_TIME SNAP_LEVEL SNAP_FLAG
---------- ------------------------- ---------- ----------
3826 27-OCT-08 08.12.32.405 PM 1 1SQL> select count(*) from dba_hist_sysstat where snap_id = (select max(snap_id) from dba_hist_snapshot);
COUNT(*)
----------
500SQL> alter system set control_management_pack_access=NONE;
System altered.
SQL> select name,value from v$parameter where name like ‘%pack%‘;
NAME VALUE
-------------------------------- ------------------------------
control_management_pack_access NONESQL> @awr_snap
SQL> exec dbms_workload_repository.create_snapshot();PL/SQL procedure successfully completed.
SQL> select snap_id, begin_interval_time, snap_level, snap_flag from dba_hist_snapshot where snap_id = (select max(snap_id) from dba_hist_snapshot);
SNAP_ID BEGIN_INTERVAL_TIME SNAP_LEVEL SNAP_FLAG
---------- ------------------------- ---------- ----------
3827 27-OCT-08 08.13.10.553 PM 1 5SQL> select count(*) from dba_hist_sysstat where snap_id = (select max(snap_id) from dba_hist_snapshot);
COUNT(*)
----------
0
So it seems clear that the setting affects not only reporting but also
collecting since no records were created in the DBA_HIST_SYSSTATS view. You may
have also noticed the SNAPSHOT_FLAG column which is new in 11g. This column is
used for a couple of purposes. First, it indicates whether the snapshot was
generated manually using the dbms_workload_repository.create_snapshot procedure
or automatically by the standard scheduled AWR snapshot process. I’m not sure
why that is important, but hey, what do I know. I guess someone at Oracle
decided that checking on manually created snapshots is a way to track AWR usage.
Here’s an excerpt from the DBMS_FEATURE_REGISTER_ALLFEAT package which is used
to monitor usage of “special” features.
/**************************************
* Automatic Workload Repository (AWR)
**************************************/ declare
DBFUS_AWR_STR CONSTANT VARCHAR2(1000) :=
‘select count(*), NULL, NULL ‘ ||
‘from wrm$_snapshot ‘ ||
‘where dbid = (select dbid from v$database) ‘ ||
‘and status = 0 ‘ ||
‘and bitand(snap_flag, 1) = 1 ‘ ||
‘and end_interval_time > ‘ || DBFUS_LAST_SAMPLE_DATE_STR; begin
dbms_feature_usage.register_db_feature
(‘Automatic Workload Repository‘,
dbms_feature_usage.DBU_INST_ALWAYS_INSTALLED,
NULL,
dbms_feature_usage.DBU_DETECT_BY_SQL,
DBFUS_AWR_STR,
‘A manual Automatic Workload Repository (AWR) snapshot was taken ‘ ||
‘in the last sample period.‘);
end;
By the way, there are a couple of views that will allow you to see how your
database is spying on you (DBA_FEATURE_USAGE_STATISTICS and
DBA_HIGH_WATER_MARK_STATISTICS). Here’s a couple of scripts to look at them,
feature_usage.sql and feature_hwm_stats.sql. Note that these views exist in
10gR2 as well, so these scripts will work in a 10g environment as well.
SQL> @feature_usage
SQL> set lines 132
SQL> set pages 999
SQL> break on version skip 1
SQL> select version, name, detected_usages, currently_used, first_usage_date, last_usage_date
2 from DBA_FEATURE_USAGE_STATISTICS
3 where detected_usages > 0
4 order by 1, 2
5 /VERSION NAME DETECTED_USAGES CURRE FIRST_USA LAST_USAG
----------------- ---------------------------------------------------------------- --------------- ----- --------- ---------
11.1.0.6.0 Audit Options 24 TRUE 14-AUG-07 10-OCT-08
Automatic Maintenance - Optimizer Statistics Gathering 24 TRUE 14-AUG-07 10-OCT-08
Automatic Maintenance - SQL Tuning Advisor 24 TRUE 14-AUG-07 10-OCT-08
Automatic Maintenance - Space Advisor 24 TRUE 14-AUG-07 10-OCT-08
Automatic Memory Tuning 24 TRUE 14-AUG-07 10-OCT-08
Automatic SQL Tuning Advisor 20 TRUE 21-AUG-07 10-OCT-08
Automatic Segment Advisor 21 TRUE 21-AUG-07 10-OCT-08
Automatic Segment Space Management (system) 24 TRUE 14-AUG-07 10-OCT-08
Automatic Undo Management 24 TRUE 14-AUG-07 10-OCT-08
Automatic Workload Repository 4 TRUE 14-AUG-08 10-OCT-08
Character Set 24 TRUE 14-AUG-07 10-OCT-08
DICOM 1 FALSE 14-AUG-07 14-AUG-07
EM Database Control 2 FALSE 14-AUG-07 21-AUG-07
Extensibility 24 TRUE 14-AUG-07 10-OCT-08
LOB 24 TRUE 14-AUG-07 10-OCT-08
Locally Managed Tablespaces (system) 24 TRUE 14-AUG-07 10-OCT-08
Locally Managed Tablespaces (user) 24 TRUE 14-AUG-07 10-OCT-08
Materialized Views (User) 24 TRUE 14-AUG-07 10-OCT-08
Object 24 TRUE 14-AUG-07 10-OCT-08
Oracle Text 24 TRUE 14-AUG-07 10-OCT-08
Parallel SQL DDL Execution 3 FALSE 14-AUG-07 28-AUG-07
Parallel SQL Query Execution 6 TRUE 28-AUG-08 10-OCT-08
Partitioning (system) 24 TRUE 14-AUG-07 10-OCT-08
Partitioning (user) 24 TRUE 14-AUG-07 10-OCT-08
Recovery Area 24 TRUE 14-AUG-07 10-OCT-08
Resource Manager 18 TRUE 21-AUG-07 10-OCT-08
Result Cache 1 TRUE 10-OCT-08 10-OCT-08
SQL Plan Management 1 TRUE 10-OCT-08 10-OCT-08
SQL Tuning Advisor 1 FALSE 28-AUG-08 28-AUG-08
Segment Advisor 23 TRUE 21-AUG-07 10-OCT-08
Server Parameter File 14 TRUE 14-AUG-07 10-OCT-08
Services 24 TRUE 14-AUG-07 10-OCT-08
XDB 24 TRUE 14-AUG-07 10-OCT-0811.1.0.7.0 Audit Options 2 TRUE 17-OCT-08 24-OCT-08
Automatic Maintenance - Optimizer Statistics Gathering 2 TRUE 17-OCT-08 24-OCT-08
Automatic Maintenance - SQL Tuning Advisor 2 TRUE 17-OCT-08 24-OCT-08
Automatic Maintenance - Space Advisor 2 TRUE 17-OCT-08 24-OCT-08
Automatic Memory Tuning 2 TRUE 17-OCT-08 24-OCT-08
Automatic SQL Tuning Advisor 2 TRUE 17-OCT-08 24-OCT-08
Automatic Segment Advisor 2 TRUE 17-OCT-08 24-OCT-08
Automatic Segment Space Management (system) 2 TRUE 17-OCT-08 24-OCT-08
Automatic Undo Management 2 TRUE 17-OCT-08 24-OCT-08
Automatic Workload Repository 1 FALSE 17-OCT-08 17-OCT-08
Character Set 2 TRUE 17-OCT-08 24-OCT-08
Extensibility 2 TRUE 17-OCT-08 24-OCT-08
LOB 2 TRUE 17-OCT-08 24-OCT-08
Locally Managed Tablespaces (system) 2 TRUE 17-OCT-08 24-OCT-08
Locally Managed Tablespaces (user) 2 TRUE 17-OCT-08 24-OCT-08
Logfile Multiplexing 2 TRUE 17-OCT-08 24-OCT-08
Materialized Views (User) 2 TRUE 17-OCT-08 24-OCT-08
Object 2 TRUE 17-OCT-08 24-OCT-08
Oracle Text 2 TRUE 17-OCT-08 24-OCT-08
Parallel SQL DDL Execution 2 TRUE 17-OCT-08 24-OCT-08
Partitioning (system) 2 TRUE 17-OCT-08 24-OCT-08
Partitioning (user) 2 TRUE 17-OCT-08 24-OCT-08
RMAN - Disk Backup 2 TRUE 17-OCT-08 24-OCT-08
Recovery Area 2 TRUE 17-OCT-08 24-OCT-08
Recovery Manager (RMAN) 2 TRUE 17-OCT-08 24-OCT-08
Resource Manager 1 TRUE 24-OCT-08 24-OCT-08
Result Cache 1 TRUE 24-OCT-08 24-OCT-08
SQL Plan Management 2 TRUE 17-OCT-08 24-OCT-08
Segment Advisor 2 TRUE 17-OCT-08 24-OCT-08
Server Parameter File 2 TRUE 17-OCT-08 24-OCT-08
Services 2 TRUE 17-OCT-08 24-OCT-08
XDB 2 TRUE 17-OCT-08 24-OCT-08 65 rows selected. SQL> @feature_hwm_stats
SQL> set lines 155
SQL> col description for a60
SQL> col name for a30
SQL> break on version skip 1
SQL> select version, name, highwater, last_value, description from dba_high_water_mark_statistics
2 order by version, name
3 / VERSION NAME HIGHWATER LAST_VALUE DESCRIPTION
----------------- ------------------------------ ---------- ---------- ------------------------------------------------------------
11.1.0.6.0 ACTIVE_SESSIONS 4.36474119 .0221502 Maximum Number of Active Sessions seen in the system
CPU_COUNT 16 16 Maximum Number of CPUs
DATAFILES 5 5 Maximum Number of Datafiles
DB_SIZE 4797759488 4797759488 Maximum Size of the Database (Bytes)
INSTANCES 1 1 Oracle Database instances
PART_INDEXES 2 2 Maximum Number of Partitions belonging to an User Index
PART_TABLES 2 2 Maximum Number of Partitions belonging to an User Table
QUERY_LENGTH 1904 1371 Maximum Query Length
SEGMENT_SIZE 1484783616 1484783616 Size of Largest Segment (Bytes)
SESSIONS 70 33 Maximum Number of Concurrent Sessions seen in the database
SQL_NCHAR_COLUMNS 39 39 Maximum Number of SQL NCHAR Columns
TABLESPACES 6 6 Maximum Number of Tablespaces
USER_INDEXES 2797 2797 Number of User Indexes
USER_MV 1 1 Maximum Number of Materialized Views (User)
USER_TABLES 1502 1502 Number of User Tables 11.1.0.7.0 ACTIVE_SESSIONS 5.97538533 5.44210966 Maximum Number of Active Sessions seen in the system
CPU_COUNT 16 16 Maximum Number of CPUs
DATAFILES 5 5 Maximum Number of Datafiles
DB_SIZE 5697044480 5697044480 Maximum Size of the Database (Bytes)
INSTANCES 1 1 Oracle Database instances
PART_INDEXES 2 2 Maximum Number of Partitions belonging to an User Index
PART_TABLES 2 2 Maximum Number of Partitions belonging to an User Table
QUERY_LENGTH 392780 392780 Maximum Query Length
SEGMENT_SIZE 1484783616 1484783616 Size of Largest Segment (Bytes)
SESSIONS 66 66 Maximum Number of Concurrent Sessions seen in the database
SQL_NCHAR_COLUMNS 39 39 Maximum Number of SQL NCHAR Columns
TABLESPACES 6 6 Maximum Number of Tablespaces
USER_INDEXES 2855 2855 Number of User Indexes
USER_MV 1 1 Maximum Number of Materialized Views (User)
USER_TABLES 1530 1530 Number of User Tables 30 rows selected.
But I digress, remember the SNAP_FLAG field that I said was used for a couple of purposes. Well the second thing it’s used for is as an indicator of whether there is any data associated with a snapshot (i.e. if the CONTROL_MANAGEMENT_PACK_ACCESS parameter was set to NONE when the snapshot was generated). So after a little playing around here’s a table of possible values:
I’m pretty sure about the Snap_Mode (i.e. whether it’s automatic or manual)
because of the code snippet we saw in the usage monitoring package
(DBMS_FEATURE_REGISTER_ALLFEAT). The Data_Collection part is just a guess based
on my observation (and very little observation actually, so there may well be
other possibilities), but it appears that the 3rd bit (4) is on (1xx) when data
has not been gathered (i.e. when CONTROL_MANAGEMENT_PACK_ACCESS=NONE). I have no
idea what the second bit does by the way. So here’s a little script to look at
the snapshots using what we’ve learned thus far (it shows the number of SQL
statements on which data has been collected as a verification of whether data
has been collected for this snapshot or not):
SQL> @awr_snaps2
SQL> col snap_mode for a10
SQL> col awr_mode for a10
SQL> select a.snap_id, snap_flag,
2 decode(bitand(snap_flag,1),1,‘Manual‘,‘Automatic‘) Snap_Mode,
3 decode(bitand(snap_flag,4),4,‘Off‘,‘On‘) Data_collection,
4 count(sql_id)
5 from dba_hist_snapshot a, dba_hist_sqlstat b
6 where a.snap_id = b.snap_id(+)
7 and begin_interval_time > sysdate-1
8 group by a.snap_id, snap_flag
9 order by 1
10 / SNAP_ID SNAP_FLAG SNAP_MODE DATA_COLLECTION COUNT(SQL_ID)
---------- ---------- ---------- --------------- -------------
3770 0 Automatic ON 90
3771 0 Automatic ON 85
3772 0 Automatic ON 83
3773 0 Automatic ON 86
3774 0 Automatic ON 89
3775 5 Manual OFF 0
3776 5 Manual OFF 0
3777 1 Manual ON 93
3778 1 Manual ON 96
3779 1 Manual ON 99
3780 5 Manual OFF 0
3781 5 Manual OFF 0
3782 5 Manual OFF 0
3783 5 Manual OFF 0
3784 1 Manual ON 98
3785 5 Manual OFF 0
3786 1 Manual ON 88
3787 1 Manual ON 68
3788 1 Manual ON 99
3789 1 Manual ON 74
3790 0 Automatic ON 109
3791 4 Automatic OFF 0
3792 5 Manual OFF 0
3793 1 Manual ON 100
3794 1 Manual ON 72
3795 1 Manual ON 72
3796 5 Manual OFF 0
3797 1 Manual ON 77
3798 1 Manual ON 71
3799 1 Manual ON 71
3800 5 Manual OFF 0
3801 1 Manual ON 68
3802 1 Manual ON 72
3803 1 Manual ON 73
3804 5 Manual OFF 0
3805 1 Manual ON 78
3806 1 Manual ON 73
3807 1 Manual ON 72
3808 5 Manual OFF 0
3809 1 Manual ON 79
3810 1 Manual ON 69
3811 0 Automatic ON 82
3812 0 Automatic ON 86
3813 0 Automatic ON 88
3814 4 Automatic OFF 0 45 rows selected.
So what’s this good for. Well not that much probably, but at least we’ll be
able to easily see what we can and can’t access with or without the DIAGNOSTICS
and TUNING packs. And it’s nice to know that, if were’ not licensed to use AWR,
we can turn off the collection of the data easily. (No sense spending CPU cycles
collecting data we’re not licensed to look at)