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.
Patching Oracle WebCenter 5-17
Special Note for 10
g
Users
If you are migrating from a 10g release or Release 1 11.1.1.1.0 version of Wiki, you must also perform the following after migration:
1.
Log in to UCM and go to the MigrationTemp folder under sysadmin or the UCM user running the migration program. Move the Wiki and Blog folders to the
correct group space folder.
2.
Log in to the group space and create a new page with Wiki or Blog page style. The name of the page must match the name of the wikiblog folder in order for the
page to properly display the wikiblog content.
5.5.1.2 Troubleshooting Problems During Wiki Migration
During wiki migration, you may see some error messages in the output log. Descriptions and available workarounds are described below.
[INFO] PROCESSING Domain:
domain_name
[INFO] migrating to temp folder - there is no webcenter page information stored on the domain:
domain_name This message indicates that there is no data specified in the domain to connect it with a
group space page the wcURL on the domain is missing.
[INFO] PROCESSING Domain:
domain_name
[INFO] migrating to temp folder - invalid group space that corresponds to the guid:
group_space_guid This message indicates that there is either no group space information specified in the
domain, or the group space guid specified is not valid the group space guid specified in the wcURL is not valid.
[INFO] PROCESSING Domain:
domain_name
[INFO] migrating to temp folder - no group space that corresponds to the guid: UCM Connection Name
This is the name used in Enterprise Manager or WLST to create the connection to UCM.
UCM Temporary Folder For example:
RootFolder
...TempFolder Wiki Data Source
Connection For example: jdbc:oracle:thin:
host
:
port
:
SID
Wiki Data Source User The name of the database user that is used to connect to the
Wiki data source. Wiki Data Source Password
The password for the database user that is used to connect to the Wiki data source.
Spaces Root URL For example: http:
host
:
port context_root
Note: The last part of the migration program will find any remaining
unmigrated group space pages that still point to owc_wiki and will try to gather domain information from the pages source URL to be
matched against a jzwiki domain. If the proper information is found, it will move the folder and content out of migration temp and
into the proper group space folder.
Table 5–3 Cont. Descriptions and Examples of the Wiki Migration Utility Arguments
Argument Description or Example
5-18 Oracle Fusion Middleware Patching Guide
group_space_guid This message indicates that the domains group space information points to a group
space that no longer exists. Doing a lookup with the group space guid does not find a corresponding group space name. Most likely the group space has been deleted.
[INFO] PROCESSING Domain:
domain_name
[ERROR] migrating to temp folder - no UCM folder for the groupspace exists:
page_ name
, gsname:
group_space_name This message indicates that the spaces page has been migrated already, but the UCM
folder for that group space does not exist. To correct this, create the group space folder by provisioning the Document service in
the group space, and then move the folder with the same name as the domain from migration temp to the group space folder. Then rename the domain folder to have the
same name as the page.
[INFO] PROCESSING Domain:
domain_name
[ERROR] migrating to temp folder - could not get UCM folder for the wiki domain, page:
page_name
, gsname:
group_space_name This message indicates that the spaces page has been migrated already, but the UCM
folder for domain could not be created in the group space folder. To correct this, move the folder with the same name as the domain from migration
temp to the group space folder. Then rename the domain folder to have the same name as the page.
[INFO] PROCESSING Domain:
domain_name
[ERROR] migrating to temp folder - no UCM folder exists for the user:
user_name
, page:
page_name This message indicates that the spaces page has been migrated already, but the UCM
folder for the user does not exist. To correct this, create the users personal folder this folder is created when the user
accesses Documents from the home space, and then move the folder with the same name as the domain from migration temp to the personal folder. Then rename the
domain folder to have the same name as the page.
[INFO] PROCESSING Domain:
domain_name
[ERROR] migrating to temp folder - could not get personal UCM folder for the user:
user_name
, page:
page_name This message indicates that the spaces page has been migrated already, but the UCM
folder for the domain could not be created in the users personal folder. To correct this, move the folder with the same name as the domain from migration
temp to the users personal folder. Then rename the domain folder to have the same name as the page.
[INFO] PROCESSING Domain:
domain_name
[INFO] migrating to temp folder - default scope, but no user specified on page:
page_name This message indicates that this is a personal wiki or blog, but the information stored
on the domain the wcURL passed in from the spaces page does not indicate a user.
[INFO] PROCESSING Domain:
domain_name
[INFO] sourceUrl:
source_url
[INFO] migrating to temp folder - the page source url is not pointing to the
Patching Oracle WebCenter 5-19
correct domain, page:
page_name
, wcURL:
wcURL This message indicates that there is more than one domain pointing to the same group
space and page information, and the current domain being processed does not match the domain indicated in the source URL.
[INFO] PROCESSING User Blog:
blog_name
[INFO] migrating to temp folder - could not get user UCM folder for the user:
user_name This is a jzwiki user blog that is not connected with a domain. The message indicates
that the UCM folder for the user does not exist, so the content could not be migrated there.
[INFO] PROCESSING User Blog:
blog_name
[INFO] migrating to temp folder - could not get UCM folder for the user:
user_name This is a jzwiki user blog that is not connected with a domain. The message indicates
that the Blogs UCM folder for the user does not exist and could not be created, so the content could not be migrated there.
5.5.2 Restoring Your OmniPortlet and WebClipping Customizations
After you have saved your customizations Section 5.1.2, Saving Your OmniPortlet
and WebClipping Customizations and successfully patched your software, you can
restore OmniPortlet and WebClipping configuration and customizations as follows:
1.
Find out the path to the following directories: On UNIX operating systems:
■
path_to_war_directory
WEB-INFprovidersomniPortlet
■
path_to_war_directory
WEB-INFproviderswebclipping On Windows operating systems:
■
path_to_war_directory
\WEB-INF\providers\omniPortlet
■
path_to_war_directory
\WEB-INF\providers\webclipping The
path_to_war_directory
refers to the following path on a UNIX operating system:
DOMAIN_HOME
serversWLS_PORTALtmp_WL_userportalTools_
version randomly_
generated_directory
war
On a Windows operating system: DOMAIN_HOME
\servers\WLS_PORTAL\tmp\_WL_user\portalTools_
version
\
randomly_ generated_directory
\war
DOMAIN_HOME
is the domain home locations for your Oracle Portal or Oracle WebCenter domain, as specified on the Specify Domain Name and Location
screen in the Configuration Wizard.
2.
Replace these directories with their backed up copies.
Note: Since the Patch Set Installer re-deployed the OmniPortlet and
WebClipping applications, the new path may be different than the path from where you backed up customizations.
