Portal V6.1.x on application server V7 stand-alone: Upgrade the portal profile
To migrate properties, upgrade database domains, and apply other updates needed to bring the profile to the current level, run the upgrade-profile task.Before upgrading the profile, if you have configured VMM (lookaside) in source environment, make sure you have the correct JDBC driver defined.
- Access the WAS admin console.
- Navigate through Environment > WebSphere variables.
- Edit WP_DB2_JDBC_DRIVER_CLASSPATH_VMM_1.
- Make sure is it configured to use db2jcc4.jar.
- cd WP_PROFILE/ConfigEngine
./ConfigEngine.sh upgrade-profile -DWasPassword=WasAdminPwd -DPortalAdminPwd=PortalAdminPwd
Important:
- If you updated the database schemas manually, include the parameter -DDbSafeMode=true.
ConfigEngine.bat upgrade-profile -DWasPassword=WasAdminPwd -DPortalAdminPwd=PortalAdminPwd -DDbSafeMode=true
Do not specify this parameter if you want the migration process to update the database schemas for you.
- If we are migrating a large amount of content in the JCR repository (WCM data), include the parameter -Dwcm.transactionTimeout=1200
ConfigEngine.bat upgrade-profile -DWasPassword=WasAdminPwd -DPortalAdminPwd=PortalAdminPwd -Dwcm.transactionTimeout=1200.
- If you cloned the FileServer portlet in the earlier version and supplied HTML files in the directory...
wp_old_root/installedApps/FileServer_PA_1_0_4H.ear/FileServer.war/FileServerPortlet/html
...copy those files to...
PORTAL_HOME/installedApps/cell_name/PA_FileServer.ear/FileServer.war/FileServerPortlet/html
...after running the upgrade-profile task and before restarting the server, to make the files accessible in the new version.
For IBM i, the directories are wp_user_old_root and PortalServer_root_user, respectively.
- Verify the migrated portal.
- Start the portal server
- Open a web browser and enter the URL for the migrated portal.
The migrated portal URL takes this form:
http://host_name:port_number/original-context-root_migrated/portalFor example, if the original portal URL is http://www.example.com:10040/wps/portal, the URL for the migrated portal is...
http://www.example.com:10040/wps_migrated/portal
During migration, the following changes are made to wkplc.properties stored in the WP_PROFILE/ConfigEngine/properties directory:
- WpsContextRootOriginal is set to the original value of the context root before migration was performed. This property is for reference only and is not used by the migrated portal.
- WpsContextRoot property is set to the migrated value original-context-root_migrated (for example, wps_migrated).
Parent: Stand-alone environment
Related:
Plan for migration: Security