5 Migrate Non-Clustered WebCenter Content 12c to a Dissimilar Infrastructure
If you are planning to move a non-clustered WebCenter Content Release 12c to an infrastructure where Operating System and the directory structure of WebCenter Content will be different from those on the existing infrastructure, then the topics that follow will guide you in accomplishing your goal.
5.1 Preliminary Steps for Migrating Non-Clustered WebCenter Content Release 12c
- Stop all managed servers, the admin server, and the node manager.
- Back up WebCenter Content file system. For detailed information, see Recommendations for WebCenter Content in Disaster Recovery Guide.
- Back up WebCenter Content database using your preferred method.
- Install the same JDK version on the new host as the one on the old host.
- Install Fusion Middleware infrastructure's binaries to the same directory paths on the new host.
- Install WebCenter Content's binaries on the new host.
- Install the same patches on the new host as were applied to the old host.
- If WebCenter Content is being migrated and the vault and weblayout directories are on a shared/remote file system, unmount them at this time.
- If WebCenter Content is being cloned, copy the vault and weblayout directories from their old locations to their new locations.
- Move the
ucm
directory out from theDOMAINHOME
directory on the existing system. This directory typically includes thevault
(DOMAINHOME/ucm/cs/vault
) andweblayout
directories (DOMAINHOME/ucm/cs/weblayout
) of WebCenter Content that should not be included when the domain template is built. The domain template is written to a single.jar
file which cannot grow to include the potential size of thevault
andweblayout
directories. - There are a few scenarios in which the database will be moving as well. One
such scenario is when WebCenter Content is moving to the Oracle Cloud. A second
scenario is when the database is moving to a new infrastructure for an
on-premise migration. A third scenario could be that WebCenter Content is being
cloned. In any of these cases, the database schemas are assumed to be available
in their new database instance and reachable from the new hosts on which
WebCenter Content will reside. When the Configuration Wizard
(
config.sh
) is run, additional steps will need to be taken to ensure connectivity to the database schemas in their new location.There are three objects within the system schema that are required for Fusion Middleware to operate properly, especially when it comes to upgrades. These objects are: schema_version_registry view, schema_version_registry synonym, and schema_version_registry$ table. If any of these items are missed, you must follow the steps in Recover Lost RCU Database SYSTEM.SCHEMA_VERSION_REGISTRY Objects to recreate the missing objects in the new database instance to prevent issues in the future. In addition to that, you must also include all of the schemas whose names contain the prefix that you defined for the environment in question.
5.2 Recover Lost RCU Database SYSTEM.SCHEMA_VERSION_REGISTRY Objects
The SYSTEM.SCHEMA_VERSION_REGISTRY
schema version registry
table contains version data for all the schemas. Many operations such as upgrade cannot
proceed if this table is not available.
5.3 Build a Template for an Existing Domain
After you've performed the preliminary steps, build a template for the domain you plan to migrate on the old host and then copy it to the new host.
5.4 Create a New Domain
You'll create a new domain on the new host to which you're migrating your non-clustered WebCenter Content release 12c.
5.5 Update JPS Configuration with New Database Information
If the database is moving, a couple of configuration files need to be modified using the steps below. However, if the database is not moving, ignore this procedure and continue with the next that describes how to copy the UCM directory to the new host.
5.6 Copy WebCenter Content Directory to the New Host
A variety of tools are available to help you copy WebCenter Content
directory to another host. In this example, we'll use rsync
to copy from
one Linux host to another.
5.7 Mount Vault and Weblayout Directories and Adjust Configuration Settings for WebCenter Content 12c and Inbound Refinery 12c
By default, both the vault and weblayout directories are located in the
DOMAINHOME/ucm/cs
directory. If you migrated WebCenter Content and the
vault and weblayout directories were on some shared/remote file system, mount them at this
time. But, if you cloned WebCenter Content and the vault and weblayout directories were on
some shared/remote file system, mount their copies from the new location at this
time.
DOMAINHOME/ucm/cs/bin/intradoc.cfg
file
for the VaultDir
and WeblayoutDir
configuration
entries to see what those are set to. You not only need to check the
intradoc.cfg
, but also the
MANAGEDSERVERNAME_intradoc.cfg
in the same directory, which takes
precedence over the intradoc.cfg
.
5.8 Start Servers and Create boot.properties Files
Using the Admin Server and Node Manager to start the managed servers is one option.
Another option is to just use the startManagedWebLogic.sh/cmd
scripts from
a terminal session.
- Start the Admin Server on the new host.
- Start the NodeManager on the new host.
- Start the managed servers on the new host.
- Create the
boot.properties
files for the Admin Server and each managed server.
5.9 Swap Out Executables
If the operating system has changed or directory paths have changed, you will need to replace the executables or redo the symbolic links with the proper ones. Here are a few possible scenarios.
5.9.3 Linux to Windows
- Go to the
DOMAINHOME/ucm/cs/bin
directory and delete these items:Archiver
BatchLoader
ComponentTool
ComponentWizard
ConfigurationManager
IdcAnalyze
IdcCommand
IdcServer
IdcShell
Installer
IntradocApp
RepositoryManager
SystemProperties
UnixProcCtrl
UserAdmin
WebLayoutEditor
WorkflowAdmin
- Copy the
FMWHOME/wccontent/ucm/idc/native/windows-amd64/bin/Launcher.exe
to theDOMAINHOME/ucm/cs/bin
directory - Copy the
DOMAINHOME/ucm/cs/bin/Launcher.exe
to theDOMAINHOME/ucm/cs/bin
directory with the following names:Archiver.exe
BatchLoader.exe
ComponentTool.exe
ComponentWizard.exe
ConfigurationManager.exe
IdcAnalyze.exe
IdcCommand.exe
IdcServer.exe
IdcShell.exe
Installer.exe
IntradocApp.exe
RepositoryManager.exe
SystemProperties.exe
UserAdmin.exe
WebLayoutEditor.exe
WorkflowAdmin.exe
- Delete the
DOMAINHOME/ucm/cs/bin/Launcher.exe
file. - Go to the
DOMAINHOME/ucm/cs/admin/bin
directory and delete these items:IdcAdmin
Launcher.sh
UnixProcCtrl
- Copy the
FMWHOME/wccontent/ucm/idc/native/windows-amd64/bin/Launcher.exe
file to theDOMAINHOME/ucm/cs/admin/bin
directory - Copy the
DOMAINHOME/ucm/cs/admin/bin/Launcher.exe
to theDOMAINHOME/ucm/cs/admin/bin
directory with the following names:IdcAdmin.exe
IdcAdminNT.exe
- Delete the
DOMAINHOME/ucm/cs/admin/bin/Launcher.exe
file. - Copy the
FMWHOME/wccontent/ucm/idc/native/windows-amd64/bin/Launcher.exe
file to theDOMAINHOME/ucm/cs/admin/bin
directory. - Go to the
DOMAINHOME/ucm/ibr/bin
directory and delete these items:ComponentWizard
IdcCommand
IdcRefineryInstaller
Launcher.sh
SystemProperties
UnixProcCtrl
- Copy the
FMWHOME/wccontent/ucm/idc/native/windows-amd64/bin/Launcher.exe
file to theDOMAINHOME/ucm/ibr/bin
directory. - Copy the
DOMAINHOME/ucm/ibr/bin/Launcher.exe
to theDOMAINHOME/ucm/ibr/bin
directory with the following names:ComponentWizard.exe
IdcRefinery.exe
IdcRefineryNT.exe
Installer.exe
SystemProperties.exe
- Delete the
DOMAINHOME/ucm/ibr/bin/Launcher.exe
file. - Go to the
DOMAINHOME/ucm/ibr/admin/bin
directory and delete these items:IdcAdmin
Launcher.sh
UnixProcCtrl
- Copy the
FMWHOME/wccontent/ucm/idcnative/windows-amd64/bin/Launcher.exe
file to theDOMAINHOME/ucm/ibr/admin/bin
directory. - Copy the
DOMAINHOME/ucm/ibr/admin/bin/Launcher.exe
to theDOMAINHOME/ucm/ibr/admin/bin
directory with the following names:IdcAdmin.exe
IdcAdminNT.exe
- Delete the
DOMAINHOME/ucm/ibr/admin/bin/Launcher.exe
file - Copy the
FMWHOME/wccontent/ucm/idc/native/windows-amd64/bin/NtProcCtrl.exe
file to theDOMAINHOME/ucm/ibr/admin/bin
directory.
5.10 Adjust Outgoing Provider Settings on WebCenter Content for the Inbound Refinery
- Log into WebCenter Content.
- Go to the Administration - Providers page. For the outgoing provider connected to the refinery, click Info and then click Edit.
- Provide the new values for Server Host Name and HTTP Server Address, and click Update.
- Restart the managed server for WebCenter Content.
5.12 Configure Security Providers
Manually port the security provider data to the domain's new location.
This is required because the Domain Template Builder is an offline utility, and therefore, does not export security provider data such as embedded LDAP data, into domain templates. For more information, see Porting Security Provider Data to a New Domain.
5.13 Update Database Information for Standalone Java Applications
- From the
DOMAINHOME/ucm/cs/bin
directory, run theSystemProperties
application. - From within the
SystemProperties
application, update the database information on the Database tab so that the standalone Java applications in WebCenter Content's bin directory can be launched successfully.
5.14 Verify That Everything Works
UserAdmin
applet and
also configure the jdbc
connection using
SystemProperties
so the standalone java applications can interact
with the database and function.