2 Migrate Non-Clustered WebCenter Content Release 11g to a New Host on an Identical or Dissimilar Infrastructure
The following topics will guide you in moving an 11g WebCenter Content domain instance, Refinery and WebCenter Content user interface to a new host using the Template Builder tool from WebLogic Server. This information supplements Creating Domain Templates Using the Domain Template Builder.
Note:
Consider the following before starting the migration process:
- The versions of WebLogic Server and WebCenter Content must match between the old host and the new host. The sample steps included in the following topics can't be used to upgrade to a newer version at the same time you migrate WebCentent Content to new hosts.
- If there are other products in the domain such as WebCenter Portal or BPM, make sure that their instructions are also taken into account. The following topics are oriented toward WebCenter Content alone.
2.1 Preliminary Steps Before Migrating Non-Clustered WebCenter Content Release 11g
- Stop all managed servers, the admin server, and the node manager
- Back up WebCenter Content file system. For detailed information, see Recommendations for Oracle WebCenter Content.
- Back up WebCenter Content's database using your preferred method.
- Install the same JDK version on the new host as the one on the old host
- Install WebLogic Server's binaries 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 remote file system, unmount them at this time.
- If WebCenter Content is being cloned and the vault and weblayout directories are on a remote file system, unmount them at this time and copy them to their new locations.
- 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.
2.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.
2.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.
2.4 Create a New Domain
You've created the domain template and copied it to the new host to which you are migrating your WebCenter Content instance. Now create a new domain on the new host.
2.5 Copy WebCenter Content 11g Directory to the New Host
Now that the domain is created, go ahead and copy the WebCenter Content
directory to the new host. Several tools are available to help you accomplish this task. In
this example, we'll use rsync
to copy from one Linux host to
another.
2.6 Mount Vault and Weblayout Directories and Adjust Configuration Settings for WebCenter Content 11g and Inbound Refinery 11g
By default, both the vault and weblayout directories are located in the
DOMAINHOME/ucm/cs
directory. If WebCenter Content was migrated and the
vault and weblayout directories were on some remote file system, mount them at this time.
Instead, if it was cloned and the vault and weblayout directories were on some 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. In 11.1.1.9.0 and later releases, 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
.
2.7 Start Servers and Create boot.properties Files
Configuring a boot.properties
file allows you to start the managed
server from the command line without being prompted to provide a user name and password
during startup. You store the user name and password in the boot.properties
file which is read during startup.
startManagedWebLogic.sh/cmd
scripts
from a terminal session.
- Start the Admin Server on the new host.
- Start the Node Manager 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.
2.8 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.
2.8.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/Oracle_ECM1/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/bi
n directory and delete these items:IdcAdmin
Launcher.sh
UnixProcCtrl
- Copy the
FMWHOME/Oracle_ECM1/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/Oracle_ECM1/ucm/idc/native/windows-amd64/bin/NtProcCtrl.exe
file to theDOMAINHOME/ucm/cs/admin/bin
directory. - Repeat steps 1 through 4 for other content server cluster nodes in the domain.
- Go to the
DOMAINHOME/ucm/ibr/bin
directory and delete these items:ComponentWizard
IdcCommand
IdcRefineryInstaller
Launcher.sh
SystemProperties
UnixProcCtrl
- Copy the
FMWHOME/Oracle_ECM1/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/Oracle_ECM1/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/Oracle_ECM1/ucm/idc/native/windows-amd64/bin/NtProcCtrl.exe
file to theDOMAINHOME/ucm/ibr/admin/bin
directory.
2.9 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.
2.10 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.
Related Topics
2.11 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.
2.12 Verify Everything Works
UserAdmin
applet and
also configure the jdbc
connection using
SystemProperties
so the standalone java applications can interact
with the database and function.