Viscosity
logo-black
  • Data
    • Database Services
      • Performance Assessment
      • Proactive Healthcheck
      • Database Migration & Consolidation
      • Performance Tuning
    • Microsoft Services
      • Microsoft Azure Services
      • Microsoft SQL Server Services
      • Microsoft Gold Azure Partner
    • Oracle Services
      • Oracle Database 19c
      • RAC
      • GoldenGate
      • Data Guard
      • Oracle & SQL Database
    • Viscosity Remote Services
  • Apps
    • App Dev Services
    • Oracle APEX
    • Viscosity AMP
    • Viscosity-ai
    • Shane-ai
  • Cloud
    • Cloud Services
    • Hybrid Cloud
    • Viscosity Edge Cloud
    • Virtualization & Cloud Expertise
    • Microsoft Azure Services
  • Infrastructure
    • Infrastructure Services
    • Exadata
      • Exadata Resale & Services
    • Oracle Database Appliance
      • Oracle Database Appliance Resale & Services
      • ODA Health Checks
    • Zero Data Loss Recovery Appliance
    • VMware to KVM Migration
  • Events
    • Upcoming Events
    • Virtual Training
    • 2025 Past Events
    • 2024 Past Events
    • 2023 Past Events
    • 2022 Past Events
  • About
    • About Us
    • News
    • Blogs
    • Publications
    • Contact
Hit enter to search or ESC to close
ENGAGE WITH US

Database Upgrades , Oracle Cloud , Oracle 19c , Scripts and Tools , Oracle 23c

Use Caution When Creating Gold Images!

By Sean Scott
December 05, 2023

In older Oracle database releases, you would use the clone.pl script to create a copy of your Oracle Home. This process is much faster (and easier) than installing the database software and patches on a new host and guarantees that the new installation is identical to the old one.

This functionality was deprecated with the release of Oracle Database version 18c. It still works, but Oracle recommends using runInstaller’s -createGoldImage option instead. With good reason—it’s a multi-step process that includes manually removing configuration files present in the original home. Creating a Gold Image is a single step, and the result is a zip file that works identically to the vanilla software installation files downloaded from Oracle—but with all the patches of your custom installation embedded. It’s ready to use to create a new, custom database home.

Or, nearly so.

Don’t Clone Production Homes

Oracle’s instructions for cloning direct users to manually clean up configuration files from ORACLE_HOME/dbs and ORACLE_HOME/network/admin. This keeps sensitive data from being moved across the environment and prevents potentially confusing and dangerous situations. Imagine production and development environments that use the same TNS aliases for different systems within each stack. Copying the production tnsnames.ora to development could have disastrous effects. Likewise, sharing a production password file allows users privileged access to the production database from the development environment.

The -createGoldImage functionality automates this step for the network/admin directory but does not clean up the dbs directory. That means anything stored in the source database’s dbs directory is in the Gold Image, including the lock, health check, parameter, and password files:

[oracle - ORCL] /u01/app/oracle/product/19.21/dbhome_1
# ./runInstaller -silent -createGoldImage -destinationLocation /u02/app/oracle/oradata
Launching Oracle Database Setup Wizard...

Successfully Setup Software.
Gold Image location: /u02/app/oracle/oradata/db_home_2023-11-07_02-58-43PM.zip

# unzip -l /u02/app/oracle/oradata/db_home_2023-11-07_02-58-43PM.zip | grep -E "\bdbs/"
0 11-07-2023 14:58 dbs/
24 11-06-2023 17:17 dbs/lkORCL
3079 05-14-2015 09:32 dbs/init.ora
1544 11-07-2023 14:44 dbs/hc_ORCL.dat
47 11-06-2023 17:17 dbs/orapwORCL
52 11-06-2023 17:17 dbs/spfileORCL.ora


I’ve identified this behavior in Oracle 19c, 21c, and 23.3, and Oracle has confirmed it as a bug. A fix is anticipated for version 23.4 or 23.5 and should then be backported to 19c and 21c.

In the meantime, you can work around this by manually removing files under ORACLE_HOME/dbs immediately after creating the Gold Image or creating Gold Images in a “clean” environment without a database.

All posts
About Author
Sean Scott

Sean is an Oracle ACE Director, Oracle Cloud Infrastructure Certified Architect Professional, and Oracle Autonomous Database Certified Specialist. He's a Managing Principal Consultant with Viscosity North America, where he designs highly available and scalable databases, leads database modernization and migration projects, and coaches database teams on their journeys toward DevOps and automation. Sean is a featured speaker at user group conferences and events around the world and author of the Apress book, "Oracle on Docker: Running Oracle Databases in Linux Containers."

You might also like
Run Oracle 23c On-Premises NOW
Run Oracle 23c On-Premises NOW
December 05, 2023
SUBMIT YOUR COMMENT
logo for footer

Viscosity's core expertise includes:

Data Transformation, Emerging Technology, High Availability & Scalability Solutions, Cloud Migrations, Performance Tuning, Data Integrations, Machine Learning, APEX Development, and Custom Application Development.


Solutions

Resources

Partnerships

Careers

Clients

 

Contact
Email: sales@viscosityna.com

Telephone:
(469) 444-1380

Address:
3016 Communications Pkwy Suite 200, Plano, TX 75093

Copyright 2025. All Rights Reserved by Viscosity North America.