Saturday, February 15, 2014

Oracle Database Administration Scripts | DBA Bundle


In this post, I'll share with you one of the most helpful tools I ever created, it will make database administration day to day activities more easier, faster and safer for you.

I named it DBA Bundle , is a tar file contains a group of shell scripts, you can DOWNLOAD the latest version from this link: [V. 3.5  17-Jan-2017]

I've designed all scripts to be able to run on complicated environments, where there is one or more Oracle version / Oracle Home / Database installed on the same machine.

All scripts inside the bundle can easily identify the Oracle environment whether it's Linux or Unix, databases version, Oracle homes. and all of them are designed to smartly handle user wrong inputs.

Now let's get started with the top key features in this bundle ...

How to use the bundle:

First, download the bundle tar file and extract it under Oracle owner home directory, e.g. /home/oracle, please note that each script inside this bundle is independent, in other words, the absence of any script will not affect the execution of other scripts.

Second, Run a script called "", it will add an alias for each script inside the bundle to the user's profile to make it easy for you to call any script from any working directory using one command "alias"  from the Linux shell without the need to step under the bundle location.
Aliases will be like this.
alert     command alias will tail -f the ALERTLOG of the selected database|instance.
vialert  command alias will view the ALERTLOG of the selected database|instance.
tns        command alias will open the tnsnames.ora file using vi editor
lis         command alias will open the listener.ora file using vi editor

There is still more of nice and easy shortcuts will be listed along with its description after you execute ""script .
In order to keep this post abbreviated I didn't list all the features/scripts/aliases inside this bundle. I'll let you discover the rest yourself !

To call script "" use "." command: e.g.
#  .

Question: What if I've more than one database on the server, how can I use  "" to point to the logfiles of the database I want?

The answer is simple, let's say you've two databases running on the same machine 
(SALESDB & ORCL), if you want to use the shortcuts (alert,tns,bdump,..) for SALESDB, During the execution of script, select SALESDB number from the list, later if you want to use the shortcuts (aliases) for ORCL DB re-execute again script and select ORCL number from the list, and so on.
Note: Executing "" more than once, will not cause any harm.

If you don't want to run "" 
script to populate the aliases, each time you call a script you have to step under the bundle location and then execute the script you want.

Scripts Description:
Now let me give you a brief description of each script in this bundle:

Scripts having aliases:
Script Name        |  Description
-------------------|--------------------------------------------| Rebuild a table and its related indexes.
-------------------|--------------------------------------------  | Export Full DB|SCHEMA|TABLE data 
                             (gives your the option of using exp or expdp utility for the export).
-------------------|-------------------------------------------- | Take an online RMAN full backup for the database 
                           (gives you the option of compressed/Encrypted backup type).
-------------------|--------------------------------------------   | List All TABLESPACES /ASM Diskgroups and their size on the database.
-------------------|---------------------------------------------        | List All DATAFILES and it's size on a database.
-------------------|--------------------------------------------- | Retrieve AUDIT data for a DB user in a specific date or number of days back.
-------------------|--------------------------------------------- | Retrieve the AUDIT data for a DB user in a specific date
                                or number of days back. 
                                (this is the one linked to the alias if used "" script).
-------------------|--------------------------------------------   | Gather STATISTICS on a SCHEMA or TABLE using DBMS_STATS    
-------------------|-------------------------------------------- | List All Invalid Objects on the DB + it's compile statements.
-------------------|--------------------------------------------- | List the Biggest 50 Objects on a database. 
-------------------|---------------------------------------------| List the Details of a user session. 
                               (if no input, will list all sessions on the instance).
-------------------|---------------------------------------------| List All current sessions on all running instances [RAC DB].
-------------------|---------------------------------------------      | List the Blocking LOCKS on a database.
-------------------|--------------------------------------------- | Unlock a specific DB User Account + the option of reset the user's password.
-------------------|--------------------------------------------- | Show the details of a specific SQL STATEMENT by providing it's SQL_ID
                              and gives you the option to tune it using SQL TUNING ADVISOR.
                              Co-author: DBA: Farrukh Salman
-------------------|--------------------------------------------- |  Show the value of a Visible or Hidden initialization Parameter.
-------------------|---------------------------------------------        | List All database Jobs (dba_jobs + dba_scheduler_jobs).
-------------------|---------------------------------------------| Show the DB Session details when providing it's Unix PID.
-------------------|---------------------------------------------| Backup & Clean up All DB & it's Listener LOGs.
-------------------|---------------------------------------------| Show the last login date of ALL users in the database.
-------------------|--------------------------------------------- | Show the failed login attempts in the last provided n of days.
-------------------|---------------------------------------------  | Start TRACING an Oracle Session activities in a logfile.  
-------------------|---------------------------------------------  | Stop TRACING an already traced Oracle Session 
                            + provide the logfile and it's TKPROFED log.  
-------------------|---------------------------------------------  | Generate the Full SQL Creation script for a DB user + important info.
-------------------|---------------------------------------------    | Generate Full SQL Creation script for a database Object.
-------------------|--------------------------------------------| Delete all Archive logs older than (provided) number of days.
-------------------|--------------------------------------------| Analyze All tables under a specific SCHEMA (using ANALYZE command).
-------------------|--------------------------------------------      | Show all important info about specific table (size, indexes, non indexed FK, constraints,...).

Scripts without aliases:
The following scripts doesn't have aliases because it's not applicable or need to be used carefully:
-------------------------------------------------------------------------------------------------------- | Monitor CPU utilization + Filesystem usage + ALERTLOGs of ALL Databases and
                     Listeners running on the server and instantly report ORA- errors and TNS- errors
                     that appears in these logs to the DBA E-mail Address
                     by sending a detailed email to the DBA.
                     (you have to modify this parameter in line number 27 to point to your E-mail Address):

                      > Of course the sendmail service should be configured on the server.

                                  *The best usage of this script, is to schedule it to run in the crontab 

                                    every 5 minutes (or less) to report ORA- and TNS- errors 
                                    when they written to alertlog & listeners logs.
-------------------------|----------------------------------------------           | Perform health check tasks on all running databases on the server such as:
                                   - Checking all databases alert logs for errors.
                                   - Checking all listeners alert logs for errors.
                                   - Checking CPU utilization.
                                   - Checking filesystem utilization.
                                   - Checking tablespaces utilization on all databases.
                                   - Checking blocking sessions on all databases.
                                   - Checking unusable indexes on all databases.
                                   - Checking invalid objects on all databases.
                                   - Checking failed login attempts on all databases.
                                   - Checking audit records on all databases.
                                   - Checking corrupted blocks on all databases.
                                   - Checking failed jobs on all databases.
                                   Modify line# 75 by replacing to your e-mail address.
                                               You can also customize the defined thresholds as per your preferences under
                                               THRESHOLD section inside the script.
                                               Last step, Schedule the script to run in the crontab every day morning:
                                               0 6 * * * /home/oracle/
                                               For detailed information, please visit:
-------------------------|----------------------------------------------  | SHUTDOWN ALL running Databases & Listeners on The server.
-------------------------|----------------------------------------------  | Take a COLD BACKUP of a specific database 
                                         (It will also creates another script to help you restore the taken cold backup easily) 
                                         This script will shutdown the database, take a cold backup, 
                                         create a restore script (in case you want to restore this cold backup
                                         later ) then it will startup the database.
-------------------------|---------------------------------------------- Collect configuration baseline data for OS and all running DATABASES.                        

From time to time I'll keep updating this bundle (adding new scripts, fixing bugs, adding new features), so give this topic a visit at least every 3 months to download the latest version.


                                           No one is perfect... that's why pencils have erasers.

You can download older versions from below links :   [V. 1.1]   [V. 1.2]   [V. 1.3]     [V. 1.4]     [V. 1.5]   [V. 1.6]   [V. 1.7 Sep2014]      [V. 1.8 Oct2014]  [V. 2.0 08-May-2015] [V. 2.2 Oct-2015] [V2.3 Feb2016] [V2.4 Apr2016] [V3.1 Oct2016] [V3.3 Dec2016] [V3.4 Jan2017]

Your suggestions, bug reporting and comments are most welcome :-)

You can watch this video tutorial on how to use this bundle: (watch this video in full screen mode)

Lastly, A special thank you to Abd El-Gawad Othman, without his support, suggestions and encouragement I wouldn't have been confident enough to share this bundle with you.


mohamed said...

Thanks a lot

Anonymous said...

great job, thanks for sharing!

Rahul N said...

Great work. Thank you!!

Mahmmoud ADEL said...

Mohamed, Anonymous gentleman, Rahul
Thanks to you, I hope this bundle be beneficial for you.

manoj said...

Superb Mohamed, its one thing to spend your time on developing this beauty..but to share it for free, its something else.. :) Thanks a ton..

Mahmmoud ADEL said...

Thank you for your nice compliment, long time back since I started my career in Oracle world, I've got tons of invaluable information from others web sites and blogs. now it's time to reciprocate the favor to the Oracle community by sharing my humble knowledge hoping that help others.

gnz_bLog said...

Thanks a lot for sharing

Venk@t Oracle DBA's said...

Thanks a lot Mahmmoud Adel it's very useful for daily activity for DBA.

Anonymous said...

Thanks Mahmomoud! That is really useful set of scripts!

Jean-Pierre Tomes said...

thank you, i am going read all yours scripts

Jean-Pierre Tomes said...

thank you for yours scripts

Jean-Pierre Tomes said...

thanks you for yours scripts

Vishal Pawar said...

Thank you sir for valuable information.

vikram reddy said...

Thanks Mohamed!! Appreciate your efforts.

Anonymous said...

Very kind of you! Thanks

Anonymous said...

this is really awesome....Greatly appreciate...

Özgür Umut said...

Really awesome...
Thanks for sharing Mahmmoud..

David Williams said...

Thanks for Information Oracle Online Training Oracle is an object-relational database management system created and marketed by Oracle Corporation.Oracle Online Training

Anonymous said...

Thank you for sharing a great set of scripts!

Maksudan said...

great job.........
thanks for sharing your knowledge

Path Infotech said...

Thanks for sharing the information

Oracle Certification Courses in Noida

Samar said...

Great dear I am thankful to you as I am new to oracle

oracle remote database administration said...

DBA Bundle is awesome tool for oracle database administration. Thanks

Satyajit Mohapatra said...

Super work Mahmoud, much appreciated.

Database Expert said...

DBA Metrix Solutions provides database administrator (DBA) that have responsibility of implementing, maintaining, tuning, repairing a database among other production support related functions. Our remote DBA involved in implementing security to protect the data. DBA metrix helps you to achieve all business goals with database consulting and support.
DBA Metrix Solutions

Anonymous said...

Such bundle should be the FIRST thing ORACLE CORP HAD TO DO after SQLPLUS.
GREAT! Thank you!

Mohamed Adel said...


Anonymous said...


[oracle@ol6-112-rac1 DBA_BUNDLE3]$ .
-bash: /bin/sqlplus: No such file or directory
-bash: /bin/sqlplus: No such file or directory

Setting Up Alieses...

Please help to check above error!
My server OS plaform is Oracle Linux.

[oracle@ol6-112-rac1 DBA_BUNDLE3]$ echo $ORACLE_HOME

[oracle@ol6-112-rac1 DBA_BUNDLE3]$ echo $ORACLE_SID
[oracle@ol6-112-rac1 DBA_BUNDLE3]$

Mahmmoud ADEL said...


This error indicates that your ORACLE_HOME variable is not set in your environment:
You have one of two options:

Option 1: export ORACLE_HOME variable in oracle user .bash_profile:
e.g. add this line to /home/oracle/.bash_profile

Option 2: Add an extra line in your /etc/oratab e.g.:

Mahmmoud ADEL said...

Sorry some words got trimmed in my last comment. Blogger has treated them as HTML tags !

Option 1: export ORACLE_HOME variable in oracle user .bash_profile:
e.g. add this line to /home/oracle/.bash_profile

Option 2: Add an extra line in your /etc/oratab e.g.:

Technology for us said...


I have added it but still the same.

[oracle@ol6-112-rac1 DBA_BUNDLE3]$ .
-bash: /bin/sqlplus: No such file or directory
-bash: /bin/sqlplus: No such file or directory

Setting Up Alieses...

[oracle@ol6-112-rac1 ~]$ cat .bash_profile
# .bash_profile

# Get the aliases and functions
if [ -f ~/.bashrc ]; then
. ~/.bashrc

# User specific environment and startup programs


export PATH

# Oracle Settings
TMP=/tmp; export TMP

ORACLE_HOSTNAME=ol6-112-rac1.localdomain; export ORACLE_HOSTNAME
ORACLE_BASE=/u01/app/oracle; export ORACLE_BASE
GRID_HOME=/u01/app/; export GRID_HOME
DB_HOME=$ORACLE_BASE/product/; export DB_HOME
BASE_PATH=/usr/sbin:$PATH; export BASE_PATH


alias grid_env='. /home/oracle/grid_env'
alias db_env='. /home/oracle/db_env'

# The Following Entry For DBA_BUNDLE Aliases
. /home/oracle/.DBA_BUNDLE_profile
[oracle@ol6-112-rac1 ~]$

[oracle@ol6-112-rac1 ~]$ cat /etc/oratab
#Backup file is /u01/app/oracle/product/ line added by Agent

# This file is used by ORACLE utilities. It is created by
# and updated by either Database Configuration Assistant while creating
# a database or ASM Configuration Assistant while creating ASM instance.

# A colon, ':', is used as the field terminator. A new line terminates
# the entry. Lines beginning with a pound sign, '#', are comments.
# Entries are of the form:
# The first and second fields are the system identifier and home
# directory of the database respectively. The third filed indicates
# to the dbstart utility that the database should , "Y", or should not,
# "N", be brought up at system boot time.
# Multiple entries with the same $ORACLE_SID are not allowed.
+ASM1:/u01/app/ # line added by Agent
RAC:/u01/app/oracle/product/ # line added by Agent
[oracle@ol6-112-rac1 ~]$



Mahmmoud ADEL said...

Hi Pitou,

Thanks for your comment. Printing the values of your .bash_profile showed me the full picture.
Actually you've triggered a small bug in the script where ORACLE_HOME should be defined without including any implicit variables. e.g.:
The script will work if ORACLE_HOME was defined in .bash_profile like this:

But first, I recommend you to re-download the bundle tar file from the same link as I triggered another bug in your environment as well and have already fixed it.

Also /etc/oratab should have an entry for your instance name "RAC1" but you only have an entry for database name "RAC".
So adding an extra entry for your instance inside /etc/oratab will fix this issue permanently:
RAC1:/u01/app/oracle/product/ # line added for DBA_BUNDLE deployment

The last resort, is to explicitly define your ORACLE_HOME inside script. Which I don't recommend in case you have more than one instance running from different ORACLE HOMEs. you can do that by adding this line:
export ORACLE_HOME=/u01/app/oracle/product/
just BEFORE this block of code:
# #########################
# Getting DB_NAME:
# #########################

Technology for us said...

It works now after add bellow line to /etc/oratab.