Skip to content
    All posts
    Oracle WebCenter ContentUCMOracle Cloud InfrastructureMigrationFusion Middleware

    Migrating an Oracle WebCenter Content repository to OCI: a real migration plan

    July 16, 20269 min readBy Andrew Blackman

    If you run Oracle WebCenter Content (WCC, still called UCM by most of the people who administer it) and you're looking at where it lives long-term, moving the repository to Oracle Cloud Infrastructure is one of the cleaner modernization paths available to you. Your content model, your security model, your custom components, and your integrations all carry forward. What changes is the platform underneath: the database, the file store, and the middleware tier land on OCI, and you come off aging on-premises hardware without reimagining the application your users know.

    But a WebCenter Content repository is not a single thing you copy across. It's three coordinated stores — a database schema, a file store split across Vault and WebLayout on shared disk, and a full-text search collection — plus a middleware tier that has to be rebuilt to point at all of it. Treat it as a lift-and-shift and you'll discover, usually at go-live, that your metadata and your files no longer agree with each other.

    I planned exactly this migration for a large US state government agency running a clustered WCC estate — production and test, WebCenter Portal on top, Inbound Refinery, SOA, custom components, and a multi-terabyte content store on NFS. Here's the field plan: what moves, in what order, and the decisions that a generic runbook won't make for you.

    First, inventory what "the repository" actually is

    Before you sequence anything, you have to write down every moving part, because WCC spreads itself across more places than people expect. On the estate I planned, the real inventory looked like this:

    • The database schema — the WCC metadata, security model, and content records. This is the system of record for what content exists.
    • The file store — the actual bytes, split into the Vault (native files) and the WebLayout (web-viewable renditions), living on an NFS share alongside the shared cluster configuration. On this estate that store was ~15 TB in production.
    • The search collection — the full-text index that makes content findable. It has to come across intact or be rebuilt.
    • Custom components — server-side customizations (in this case a handful: home-page and browse-results customizations, a config component, and others).
    • Custom Java deployments — WebLogic-deployed EARs reading content through RIDC.
    • Integrations — Inbound Refinery for PDF conversion, WebCenter Portal / Spaces pulling HTML and images out of WCC, a capture/scanning front end, batch loaders, and SMTP.

    If any one of these isn't on your list, it's the one that breaks the migration. The security model in particular — roles, security groups, and accounts — has to be captured explicitly, because it's enforced by the schema and referenced by every integration.

    The core decision: how each store moves

    The single most important design choice is recognizing that the three stores migrate by different mechanisms, and the whole plan is built around keeping them consistent with each other.

    The database moves by backup and restore. On this estate the plan was to first upgrade the on-premises database in place to a supported release, then take a backup and restore the WCC schema onto the target. Preserving the schema names exactly is not optional — WCC's configuration references them, and renaming turns a restore into a reconfiguration project.

    The file store — Vault, WebLayout, and the shared cluster files — moves as a file-system clone of the NFS share. This is where the terabytes are, and it's also where the clock runs longest, which is what forces the sequencing decision below.

    The search collection comes across with the file store and gets validated after cutover: you confirm the collection is intact and that content is searchable before you trust it.

    The middleware tier, by contrast, is not migrated — it's rebuilt from scratch on the target and re-pointed at the restored schema and cloned file store. This is deliberate. A clean FMW / WebLogic / WCC install on OCI, configured to connect back to your migrated data, is far more predictable than trying to drag a middleware domain across environments.

    The sequencing problem: a multi-terabyte store and a live system

    Here's the decision the runbook won't make for you. You have a ~15 TB file store and a database that keeps taking checkins right up until go-live. If you back up the database on Friday and cut over the following Friday, every document checked in during that week exists in the source but not the target. Your restored schema and your cloned file store are a week out of sync.

    The answer is a delta migration using the WCC Archiver, and it's the load-bearing part of the whole plan:

    1. Bulk-move the big, slow stores first — restore the database schema and clone the multi-terabyte file store. This is the expensive operation, and you do it once, ahead of go-live.
    2. Capture the delta with Archiver. From the source, export the content items checked in since the database backup timestamp using a custom query on the Archiver. Make that export available on the target host with the correct Oracle user permissions.
    3. Import the delta on the target, repeatedly, right up to go-live. Set up the Archiver import location on the target and bring the delta across on a regular cadence. Add the ArchiverReplicationExceptions (ARE) configuration so that replication exceptions are handled rather than silently dropped.
    4. Validate integrity after each pass — count content items, check metadata — so you know the target is converging on the source, not drifting from it.

    This turns an impossible "freeze the business for a week" conversation into a background process. The bulk data moves once; the trickle of new checkins is caught continuously until the moment you switch over.

    Rebuilding and re-pointing the middleware

    With the data in place, the middleware rebuild on OCI is methodical. The prerequisite checks are the usual FMW discipline — confirm the OS and Java are on versions the target WebLogic / WCC binaries actually certify against per Oracle's Fusion Middleware Certification Matrix, get the binaries staged with correct permissions, and open the ports the WCC, Inbound Refinery, SOA, Portal, and database tiers need to talk to each other.

    Then the configuration migration, which is where the file store and the middleware get reconnected:

    • Install binaries and configure the domain — FMW, WCC, SOA — with the WCC, IBR, and SOA clusters, connected to the restored schemas under their preserved names.
    • Re-point the WCC shared configuration. In WCC's intradoc.cfg, the IntradocDir, VaultDir, and WeblayoutDir entries have to point at the cloned NFS paths on the target. This is the literal line where metadata meets bytes — get it right and content resolves; get it wrong and every document is a broken link.
    • Update host- and environment-specific settings — the server's HTTP address and mail server in the shared config, so the migrated instance stops referring to the old environment.
    • Migrate custom deployments. Download the WebLogic-deployed EARs from the source, edit each deployment plan's hostname to the target, and install and start them on the target console.
    • Migrate custom components — export the component ZIP from the source WCC, install and enable on the target, restart, and validate each one.
    • Move the rest of the configuration with a CMU bundle. Create a Configuration Migration Utility bundle on the source with every section selected and "Add Dependencies" on, export it, and import it on the target. The dependency capture is what stops you from importing a config that references something that didn't come along.

    Two decisions that quietly remove most of the pain

    Two choices on this plan did more to reduce risk than anything else, and both are the kind of thing you only appreciate after you've done a migration the hard way:

    Keep the hostnames the same between source and target where you can. WCC and its integrations bake hostnames into configuration in more places than you'll enumerate up front. Every hostname you preserve is a class of reconfiguration — and a class of "we missed one" go-live bug — that simply never happens.

    Keep the install user, group, and file permissions identical. The file store comes across as a clone with its ownership and permissions intact. Match the Oracle user, group, and permissions on the target and there's no permissions-remediation pass on a multi-terabyte tree — which, at that scale, is a real saving and a real source of avoided errors.

    Neither is glamorous. Both are the difference between a migration that validates cleanly and one that turns into a week of chasing broken references.

    Validate against the real failure modes

    A migration is only done when you've proven it, and the validation follows the same three-store shape as the plan. Confirm the content and file store agree: check that Vault, WebLayout, and the cluster shared files are present, then exercise check-in, full-text search, and check-out end to end and confirm the search collection is intact. Validate every integration point — the capture/scanning front end, WebCenter Portal, Spaces. And validate every customization — each custom component and each RIDC-based Java deployment — because those are the pieces most likely to be quietly depending on something environment-specific.

    One more sizing note that belongs in every plan: when you size the OCI target, plan for growth, not for today's footprint. On this estate the target was sized for two years of storage growth. A repository that's 15 TB now is not 15 TB in eighteen months, and resizing under a live content system is a project you'd rather not schedule.

    Why this is on your desk now

    If your WebCenter Content estate is on Fusion Middleware 12c, the timing has a reason attached to it. FMW 12c (12.2.1.4) reaches end of Premier Support in December 2026, with Extended Support running a year beyond. WebCenter Content almost never lives alone — the same clock governs the WebLogic underneath it, and usually SOA, Inbound Refinery, and WebCenter Portal alongside. That makes a repository move to OCI less of a standalone infrastructure task and more of a natural moment to modernize the whole stack onto a platform with a real support runway ahead of it.

    The work itself is well-understood — I've mapped and planned it on real, clustered, multi-terabyte WCC estates. The database restores, the file store clones, the Archiver catches the delta, the middleware rebuilds clean on OCI, and your content model and customizations carry forward untouched. The hard part isn't any single step; it's the sequencing — keeping three stores consistent while the business keeps working — and that's the part worth planning carefully rather than improvising.

    If you're weighing a WebCenter Content move to OCI against the 12c deadline and want a second opinion on the sequence, let's talk. It's a specialist conversation, and the plan is very migratable from one estate to the next.

    See it against your Oracle AP

    Book a 30-minute walkthrough — we'll run a real exception from supplier email to Oracle posting, on Fusion or EBS.