Formatting Your Properties File You must make sure you escape values correctly
Patching Oracle WebCenter 5-15
This process also migrates attachments and provide links to them in your wiki pages as appropriate. Links to other wiki pages within your wiki page content will be
updated to point to the new locations, provided that the URL in each link has the same WebCenter Spaces root that is provided in the migration parameters.
The migration process will not migrate comments, discussion threads, templates, nor will it alter any other wiki or blog content.
Any errors during this process can be found in the output log, which is located in the same directory as the wiki-upgrade.jar file. For more information, see
Section 5.5.1.2, Troubleshooting Problems During Wiki Migration .
Before performing wiki migration, make sure you do the following:
1.
Make sure Oracle Universal Content Management UCM is upgraded to Release 11g see
Section 5.2, Upgrading Oracle Universal Content Management 10g .
2.
Verify that the root folder PersonalSpaces exists in UCM; this is the folder in which all personal folders get created. Wiki migration may fail if the
PersonalSpaces folder does not exist in UCM. The PersonalSpaces folder is created when the WebCenter Spaces server is started. Therefore, it is
recommended that you start the WebCenter Spaces server prior to performing wiki migration.
3.
Update the folder limit in UCM as follows:
a.
Log in to the UCM user interface, go to Administration Folder Configuration
and change the Maximum Folders Per Virtual Folder and Maximum Content Per Virtual Folder to 1000.
b.
Create a temporary folder that the Wiki migration utility will use to store the orphan data for example, the data that does not have a corresponding group
space. This does NOT have to be a root folder; it can be created as the Administrator user under the PersonalSpaces or Group Space root folder. If a
root folder is preferred, the service using the URL IdcService=COLLECTION_ADD will need to be used. For example:
http:
host
:
port
idcidcplg?IdcService=COLLECTION_ ADDdParentCollectionID=-1hasParentCollectionID=trueforce=true20xForceF
olderSecurity=FALSEignoreMaxFolderLimit=truehasMark=truedCollectionName= PS3WikiMigration_Orphansmark=PS3WikiMigration_
OrphansdDocAccount=PUBLICidcToken=1290338486670:A17C2CCCCE0C2FD2544E0A1B2 F03DB67
Note the idcToken can be retrieved via the browsers Page Source from a logged in session to UCM. Alternatively, the attribute
DisableAuthorizationTokenCheck can be disabled by selecting Administration Content Server General Configuration Additional
Configuration Variables - DisableAuthorizationTokenCheck=true
and then restarting the server.
After these tasks are finished, choose one of the following ways to run the wiki-upgrade.jar file:
■
Do not pass any arguments from the command line, as follows:
cd
WEBCENTER_ORACLE_HOME
webcenterarchives
MW_HOME
jdk160_21binjava -jar wiki-upgrade.jar
You will be prompted for each of the required arguments listed in Table 5–3
.
■
Pass a properties file WikiMigrator.properties as an argument:
5-16 Oracle Fusion Middleware Patching Guide
MW_HOME
jdk160_21binjava -jar
WebCenter_ORACLE_HOME
webcenterarchiveswiki-upgrade.jar WikiMigrator.properties
The WikiMigrator.properties must reside in the same directory as wiki-upgrade.jar. Below are the contents of a sample file:
MDSConn = jdbc:oracle:thin:exampleDB:1521:exampleSID MDSUser = dbuser_example_mds
UCMConn = idc:examplehost:9444 UCMUser = sysadmin
UCMConnName = example_connection_name UCMTempFolderPath = RootFolder...TempFolder
wikiConn = jdbc:oracle:thin:exampleDB:1521:exampleSID wikiUser = example_wiki
SpacesRootURL = http:examplehost:
port
webcenter
You will be prompted for the following from the command line:
■
Enter MDS Password:
■
Enter UCM Password:
■
Enter Wiki Password:
■
Pass all arguments from the command line: MW_HOME
jdk160_21binjava -jar wiki-upgrade.jar
MDSConn MDSUser
MDSPswd UCMConn
UCMTempFolderPath
UCMUser UCMPswd
UCMConnName wikiConn
wikiUser wikiPswd
SpacesRootURL For example:
java -jar WikiMigrator.jar jdbc:oracle:thin:exampleDB:1521:exampleSID
dbuser_example_mds example_mds_password
idc:examplehost:9444 sysadmin
example_ucm_password example_ucm_connection_name
example_path_to_ucm_temporary_folder jdbc:oracle:thin:example:1521:exampleSID
example_wiki example_wiki_password
http:examplehost:
port
webcenter
Table 5–3 Descriptions and Examples of the Wiki Migration Utility Arguments
Argument Description or Example
MDS Spaces Data Source Connection
For example: jdbc:oracle:thin:
host
:
port
:
SID
MDS Spaces Data Source User
This is the name of the database user that is used to connect to the MDS data source.
MDS Spaces Data Source Password
This is the password to the database user that is used to connect to the MDS data source.
UCM Connection For example: idc:
host
:
port
UCM User Use sysadmin as the UCM user; the user weblogic does not
get administrator privileges with socket connections. UCM Password
The password for the UCM user account.