Search Tips   |   Advanced Search

Portal V6.1.x on application server V6.1 cluster: Migrating a remote dmgr

To migrate a dmgr on a remote machine.

  1. Copy the required files (including the migration plug-in) from the WebSphere Portal V8.0 binary installation to the dmgr system:

    1. Copy the filesForDmgr.zip file to the remote dmgr system.

    2. Stop the dmgr.

    3. Expand the filesForDmgr.zip file into the installation root directory of the dmgr; for example in the C:\IBM\WebSphere\AppServer directory.

      If the dmgr profile was not created in the default Appserver/profiles/Dmgr01 directory, then the metadata_wkplc.xml file, located in the Appserver/profiles/Dmgr01\config\.repository\metadata_wkplc.xml directory in the compressed file, must be copied into the config\.repository subdirectory under the dmgr profile directory.

    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

  2. On the WebSphere Portal v8.0 server to create the WAS_V8_OS.arch_RemoteMigrSupport.jar file, for example WAS_V8_windows.x86_RemoteMigrSupport.jar.

      WAS_HOME/bin/migration/bin/createRemoteMigrJar.sh -targetDir remote_jar_dir

    Where remote_jar_dir is an existing directory where that will contain the generated file.

    1. Copy WAS_V8_OS.arch_RemoteMigrSupport.jar from the WebSphere Portal v8.0 server into a temporary directory in the source environment, for example supp_dir.

    2. Extract WAS_V8_OS.arch_RemoteMigrSupport.jar.
    3. Ensure that read and execute permissions are set on the extracted files.

      For example:

      chmod -R 755 supp_dir

  3. On portal v8 host run WASPreUpgrade

      supp_dir/bin/WASPreUpgrade.sh backup_dir source_WasHome -traceString trace_spec -traceFile trace_file -oldProfile wp_profile_name -machineChange true -javaoption -Xmx2048m



      Directory on the source portal server where you assembled the supplementary file required for migration.


      Required. Must be the first parameter specified. Specifies the directory on the source portal where WASPreUpgrade stores the exported profile data. 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.


      WAS installation directory on the source server.


      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.


      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 the backupDirectory/logs directory. If we specify the -traceString parameter but omit the -traceFile parameter, the command does not generate a trace file.


      Portal profile on the source environment.


      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.

  4. scp -r backup_dir target_v8_node:/tmp

  5. Create a profile on the target dmgr:

      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



      Dmgr profile name


      Current dmgr node name.


      Current cell name.


      Host name for the dmgr where we are creating the profile.

  6. Run the WASPostUpgrade command:

      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



      Directory where WASPreUpgrade stores the data that it exports from the source server, and from which the WASPostUpgrade command reads and imports data.


      New portal profile on the target server or node to which the WasPostUpgrade command migrates the source portal profile.


      Source portal's profile name. The profile name must already exist in the backup_dir directory you just provided.


      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.


      Administrator ID password for the source portal.

Parent: Portal V6.1.x on application server V6.1 cluster: Migrating dmgr