Prepare the previous environment for migration

This section describes the required manual steps to prepare your previous IBM WebSphere Portal environment for migration. To ensure a proper migration, clean up the previous environment and apply the following interim fixes to the appropriate, previous WebSphere Portal environment:

You must apply the fixes in the order provided below to ensure a proper migration process.

1. Clean up the previous environment if you deleted pages, resources, users, or groups to ensure that you have a clean migration:
   • If you deleted portal pages, see Delayed cleanup of deleted portal pages.

   • If you deleted resources, you may have orphaned data; see Delete orphaned data.

   • If you deleted users or groups using the configured user registry, see Deregistering Users and Groups from WebSphere Portal.

2. Validate the database property values

   Run the validate-database-connection task on the previous environment to verify that the proper values are specified in the wpconfig.properties file because these values are required when running the migration tasks.

3. Use the following steps to apply the following interim fixes to the previous environment:
   1. Create an update directory on the previous WebSphere Portal directory; for example,...

      C:\Program Files\WebSphere\PortalServer\update.

   2. Download the WebSphere Portal Update Installer from http://www-3.ibm.com/software/genservers/portal/support/ to the update directory you created in the previous step.

   3. Unzip the interim fixes from the appropriate directory of the current WebSphere Portal directory to the update directory created in the previous step:
      • portal_server_root/migration/fixes/510

      • portal_server_root/migration/fixes/5101

      • portal_server_root/migration/fixes/5102

      • portal_server_root/migration/fixes/5103

   4. Enter the following command on the command line to set the WAS_HOME environment variable for the previous version directory where you will run the WebSphere Portal Update Installer:
      • Windows:...

        set WAS_HOME=was_old_root;

        ...for example...

        set WAS_HOME=C:\Program Files\WebSphere\AppServer

      • UNIX:

        export WAS_HOME=was_old_root;

        ...for example...

        export WAS_HOME=/opt/Websphere/AppServer

        i5/OS:

        export WAS_HOME=was_old_root;

        ...for example...

        export WAS_HOME=/opt/Websphere/AppServer

   5. Enter the following command on the command line to install the interim fixes for the previous version:
      • Windows:

        .\updatePortal.bat -install -installDir wp_old_root -fix -fixDir wp_old_root/update -fixes list of fixes;

        ...for example...

        updatePortal.bat -install -installDir "C:\Program Files\WebSphere\PortalServer" -fix -fixDir "C:\Program Files\WebSphere\PortalServer\update" -fixes PK07258 PK07872

      • UNIX:

        ./updatePortal.sh -install -installDir wp_old_root -fix -fixDir wp_old_root/update -fixes list of fixes;

        ...for example...

        ./updatePortal.sh -install -installDir /opt/WebSphere/PortalServer -fix -fixDir /opt/WebSphere/PortalServer/update -fixes PK07258 PK07872

      • i5/OS:

        ./updatePortal.sh -install -installDir wp_old_root -fix -fixDir wp_old_root/update -fixes list of fixes;

        ...for example...

        updatePortal.sh -install -installDir /opt/WebSphere/PortalServer -fix -fixDir /opt/WebSphere/PortalServer/update -fixes PK07258 PK07872

   6. Apply the following interim fixes for v5.1.0 (all platforms):
      1. PQ96317
      2. PQ98046
      3. PQ97287
      4. PQ95975
      5. PQ97656
      6. PQ99439
      7. PQ99519
      8. PK01286
      9. PK00826
      10. PK03737
      11. PK01695
      12. PK07872
      13. PK14100
      14. PK15013
      15. PK19790
      16. PK23171
      17. PK20467

   7. Apply the following interim fixes for v5.1.0.1 (all platforms):
      1. PK07872
      2. PK14100
      3. PK14103
      4. PK15013
      5. PK19790
      6. PK23171
      7. PK20467
      8. PK16371
      9. PK16597
      10. PK18538
      11. PK21688
      12. PK07258
      13. PK17690
      14. PK21136
      15. PK23901

   8. Apply the following interim fixes for v5.1.0.2 (all platforms):
      1. PK14100
      2. PK14103
      3. PK15013
      4. PK19790
      5. PK23171
      6. PK20467
      7. PK16371
      8. PK16597
      9. PK18538
      10. PK21688
      11. PK17690
      12. PK21136
      13. PK22244
      14. PK23901

   9. Apply the following interim fixes for v5.1.0.3 (all platforms):
      1. PK23171

      2. PK20467

      3. PK18538

      4. PK21688

      5. PK21136

      6. PK22244

      7. PK23901

   10. Apply the following interim fixes (iSeries only):
       • 510:
         1. PK01639

         2. PK08409

         3. PK11536

       • 5101:
         1. PK08409

         2. PK11536

       • 5102:
         1. PK11536

 

Parent topic:

Migrating

 

---