+

Search Tips   |   Advanced Search

Portal V7.0 cluster: Migrate v7 dmgr to remote v8 dmgr

  1. From portal v8 binary install host, copy filesForDmgr.zip to the source dmgr system...

      scp filesForDmgr.zip src_dmgr_host:/opt/IBM/Portal/WebSphere/Appserver

  2. Log on to source dmgr host, stop the dmgr, and unarchive file...

      cd /opt/IBM/Portal/WebSphere/Appserver/bin
      ./stopManager.sh
      cd /opt/IBM/Portal/WebSphere/Appserver
      unzip filesForDmgr.zip

    Failure to copy the migration plug-in files to the dmgr can result in the following error when you try to upgrade the ConfigEngine tool:

      com.ibm.websphere.management.exception.InvalidConfigDataTypeException: ADMG0007E: The configuration data type CellCompRegistryCollection is not valid

  3. If the dmgr profile location is not the default...

      ./Appserver/profiles/Dmgr01

    ...then copy metadata_wkplc.xml in the compressed file to the actual dmgr profile directory...

      cp ./Appserver/profiles/Dmgr01/config/.repository/metadata_wkplc.xml $MY_DMGR_PROFILE/config/.repository

  4. On the WebSphere Portal v8.0 server create WAS_V8_OS.arch_RemoteMigrSupport.jar...

      cd WAS_HOME/bin/migration/bin/
      ./createRemoteMigrJar.sh -targetDir /tmp

    This creates a file similar to...

      /tmp/WAS_V8_windows.x86_RemoteMigrSupport.jar

  5. Copy file to v7 source environment...

      scp WAS_V8_OS.arch_RemoteMigrSupport.jar source_env:/tmp

  6. Log on to source env and run WASPreUpgrade

    cd /tmp
    jar xvf WAS_V8_OS.arch_RemoteMigrSupport.jar  
    chmod -R 755 supp_dir 
    cd supp_dir/bin/
    ./WASPreUpgrade.sh backup_dir 
                       source_WasHome 
                       -traceString trace_spec 
                       -traceFile trace_file 
                       -oldProfile wp_profile_name 
                       -machineChange true 
                       -javaoption 
                       -Xmx2048m
    

    ...where...

    supp_dir Directory on the source portal server where you assembled the supplementary file required for migration.
    backup_dir Required. Must be the first parameter specified. Directory on the source portal where WASPreUpgrade stores the exported profile data generated by command. If the directory does not exist, WASPreUpgrade creates it. Neither the supp_dir nor WAS_HOME directories, depending on whether we are performing local or remote migration, or any of the nested subdirectories are valid for the location of backup_dir.
    source_WasHome WAS installation directory on the source server.
    trace_spec Trace information to collect. Optional. To gather all trace information, specify "*=all=enabled" (including the quotation marks). If you include this parameter, also specify the trace_file. If you do not specify the -traceString or -traceFile parameter, the command creates a trace file by default and places it in the backupDir/logs directory. If we specify the -traceString parameter but omit the -traceFile parameter, the command does not generate a trace file.
    trace_file Name of the output file where trace information is stored. Optional. If you do not specify the -traceString or -traceFile parameter, the command creates a trace file by default and places it in...

      backupDirectory/logs

    If we specify the -traceString parameter but omit the -traceFile parameter, the command does not generate a trace file.

    wp_profile_name Portal profile on the source environment.
    machineChange Required for remote migrations when source and target environment are separate machines. If not specified, the default value is false and used for local migrations.

  7. scp -r backup_dir target_dmgr_host:/tmp

  8. Create a profile on the target dmgr:

    cd WAS_HOME/bin/
    ./manageprofiles.sh -create 
                        -profileName dmgr_profile_name 
                        -templatePath WAS_HOME/profileTemplates/management 
                        -serverType DEPLOYMENT_MANAGER 
                        -nodeName node_name 
                        -cellName cell_name 
                        -hostName host_name
    

    ...where...

    dmgr_profile_name Dmgr profile name
    node_name Current dmgr node name.
    cell_name Current cell name.
    host_name Host name for the dmgr where we are creating the profile.

  9. From dmgr, run the WASPostUpgrade command:

    cd WAS_HOME/bin/
    ./WASPostUpgrade.sh backup_dir 
                        -profileName wp_profile_name 
                        -oldProfile old_wp_profile_name 
                        -username source_admin_user 
                        -password source_foo 
                        -replacePorts TRUE 
                        -backupConfig TRUE 
                        -scriptCompatibility TRUE
    -keepDmgrEnabled TRUE
    

    ...where...

    backup_dir Directory containing WASPreUpgrade data from source server.
    wp_profile_name New portal profile on the target server or node to which the WasPostUpgrade command migrates the source portal profile.
    old_wp_profile_name Source portal's profile name. The profile name must already exist in the backup_dir directory you just provided.
    source_admin_user Administrator ID for the source portal. Specify the login form of the administrator ID rather than the fully qualified name; for example specify wpsadmin rather than uid=wpsadmin, o=defaultWIMFileBasedRealm.
    source_foo Administrator ID password for the source portal.


Parent: Portal V7.0 cluster: Migrating dmgr