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.propertiesfiles 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/bindirectory and delete these items:ArchiverBatchLoaderComponentToolComponentWizardConfigurationManagerIdcAnalyzeIdcCommandIdcServerIdcShellInstallerIntradocAppRepositoryManagerSystemPropertiesUnixProcCtrlUserAdminWebLayoutEditorWorkflowAdmin
- Copy the
FMWHOME/Oracle_ECM1/ucm/idc/native/windows-amd64/bin/Launcher.exeto theDOMAINHOME/ucm/cs/bindirectory. - Copy the
DOMAINHOME/ucm/cs/bin/Launcher.exeto theDOMAINHOME/ucm/cs/bindirectory with the following names:Archiver.exeBatchLoader.exeComponentTool.exeComponentWizard.exeConfigurationManager.exeIdcAnalyze.exeIdcCommand.exeIdcServer.exeIdcShell.exeInstaller.exeIntradocApp.exeRepositoryManager.exeSystemProperties.exeUserAdmin.exeWebLayoutEditor.exeWorkflowAdmin.exe
- Delete the
DOMAINHOME/ucm/cs/bin/Launcher.exefile. - Go to the
DOMAINHOME/ucm/cs/admin/bin directory and delete these items:IdcAdminLauncher.shUnixProcCtrl
- Copy the
FMWHOME/Oracle_ECM1/ucm/idc/native/windows-amd64/bin/Launcher.exefile to theDOMAINHOME/ucm/cs/admin/bindirectory - Copy the
DOMAINHOME/ucm/cs/admin/bin/Launcher.exeto theDOMAINHOME/ucm/cs/admin/bindirectory with the following names:IdcAdmin.exeIdcAdminNT.exe
- Delete the
DOMAINHOME/ucm/cs/admin/bin/Launcher.exefile. - Copy the
FMWHOME/Oracle_ECM1/ucm/idc/native/windows-amd64/bin/NtProcCtrl.exefile to theDOMAINHOME/ucm/cs/admin/bindirectory. - Repeat steps 1 through 4 for other content server cluster nodes in the domain.
- Go to the
DOMAINHOME/ucm/ibr/bindirectory and delete these items:ComponentWizardIdcCommandIdcRefineryInstallerLauncher.shSystemPropertiesUnixProcCtrl
- Copy the
FMWHOME/Oracle_ECM1/ucm/idc/native/windows-amd64/bin/Launcher.exefile to theDOMAINHOME/ucm/ibr/bindirectory. - Copy the
DOMAINHOME/ucm/ibr/bin/Launcher.exeto theDOMAINHOME/ucm/ibr/bindirectory with the following names:ComponentWizard.exeIdcRefinery.exeIdcRefineryNT.exeInstaller.exeSystemProperties.exe
- Delete the
DOMAINHOME/ucm/ibr/bin/Launcher.exefile. - Go to the
DOMAINHOME/ucm/ibr/admin/bindirectory and delete these items:IdcAdminLauncher.shUnixProcCtrl
- Copy the
FMWHOME/Oracle_ECM1/ucm/idcnative/windows-amd64/bin/Launcher.exefile to theDOMAINHOME/ucm/ibr/admin/bindirectory. - Copy the
DOMAINHOME/ucm/ibr/admin/bin/Launcher.exeto theDOMAINHOME/ucm/ibr/admin/bindirectory with the following names:IdcAdmin.exeIdcAdminNT.exe
- Delete the
DOMAINHOME/ucm/ibr/admin/bin/Launcher.exefile - Copy the
FMWHOME/Oracle_ECM1/ucm/idc/native/windows-amd64/bin/NtProcCtrl.exefile to theDOMAINHOME/ucm/ibr/admin/bindirectory.
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/bindirectory, run theSystemPropertiesapplication. - From within the
SystemPropertiesapplication, 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.