+

Search Tips   |   Advanced Search

Portal V7.0 cluster: Upgrade local nodes


If the source and target nodes are on the same server, complete these steps to migrate the source portal application server profile to the primary node. After completing the process for the primary node, repeat the procedure for each secondary node. When you migrate local nodes on the same machine, the source nodes will be disabled

Complete the following steps on the dmgr primary node. Then, repeat the procedure for each secondary node.

  1. Create a profile

    cd WAS_HOME/bin/
    ./manageprofiles.sh -create   \
                        -defaultPorts   \
                        -enableAdminSecurity false   \
                        -profileName wp_profile_name   \
                        -profilePath profile_path   \
                        -templatePath WAS_HOME/profileTemplates/default   \
                        -nodeName source_node_name   \
                        -cellName source_cell_name   \
                        -hostName host_name   \
                        -isDefault   \
                        -omitAction samplesInstallAndConfig defaultAppDeployAndConfig 
    

    ...where...

    wp_profile_name Profile on the target server or node to which the source portal profile is to be migrated.
    profile_path Profile location on the target server or node that is to contain the migrated source portal profile.
    source_node_name Node name of the source portal profile. Must be the same. We can change node name, only after migration.
    source_cell_name Cell name of the source portal profile. Must be the same. We can change cell name, only after migration.
    host_name Host name for the target server or dmgr where we are creating the profile.

  2. Update all references to the source environment in wkplc.properties with the new values used by the target dmgr. The wkplc.properties file is located in the WP_PROFILE/ConfigEngine/properties directory.

  3. If the target portal is on AIX, Linux, Solaris, or IBM i, increase the file descriptor limit on the target portal to 200000.

    ulimit -n 200000

  4. On portal v8 host run WASPreUpgrade

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

    where

      backup_dir

      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.

      source_WasHome

      WebSphere Application Server 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 the backupDirectory/logs directory. 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.

  5. Update the backup files you created when running WASPreUpgrade to point to the new environment. Replace the source dmgr host name with the target dmgr host name.

      backup_dir/profiles/wp_profile_name/config/cells/cell_name/nodes/cell_Manager/serverindex.xml
      backup_dir/profiles/wp_profile_nawsadmin.properties

    ...where...

      backup_dir

      Is the directory you specified when running WASPreUpgrade.

      wp_profile_name

      Portal profile on the source environment.

      cell_name

      Name of the cell for the dmgr.

      cell_Manager

      Name of the cell manager node.

  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 -includeApps true -backupConfig false -traceString trace_spec -traceFile trace_file -javaoption -Xmx1536m

    ...where...

      backup_dir

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

      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.

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

  7. Update WP_PROFILE/ConfigEngine/properties/wkplc.properties with the correct WAS administrator password for the portal to migrate.

WAS provides a Migration wizard,WAS_HOME/bin/migration.bat(shthat automatically creates the profile in the WAS_HOME/profiles directory. To create the profile in a specified location, we can use either the pmt.sh (PMT) (on 32-bit application server) or the manageprofiles.sh (on 64-bit application server). Then, when we use the Migration wizard, we can select the new profile as the target profile for migration.

When pre-creating a profile, create a default application server profile and install the WAS admin console only; do not install any sample applications.

To migrate the application server profile on IBM i, use the manual steps described here. WAS does not provide a Migration wizard on IBM i.


Parent: Portal V7.0 cluster: Upgrade application server nodes
Related reference:
Configure JVM heap size from command line