Previous Step   Previous Step Next Step   Next Step

Migrate managed base application servers

Map Step 10 towards the goal: Scenario 3: Flexible Management: Migrating an administrative agent profile and its registered set of managed base application servers

About this task

Ensure that the Version 8.0 administrative agent is running. For each managed base application server that you plan to migrate to Version 8.0, perform the following steps:
Avoid trouble Avoid trouble: For the migration to be successful: gotcha

Before you begin

Start the Version 8.0 administrative agent

Procedure

  1. Create the target base application server profile. Run the manageprofiles command with the appropriate parameters to create a new managed profile. For example:
    /QIBM/ProdData/WebSphere/AppServer/V8/ND/bin/manageprofiles -create -profileName 
    AppSrv01 -templatePath /QIBM/ProdData/WebSphere/AppServer/V8/ND/profileTemplates/default 
    -nodeName AppSrv01Node01 -cellName AppSrv01Cell01 -hostName mynode1host.company.com
  2. Run the WASPreUpgrade command to save the current managed base application server information to a migration backup directory. Choose a new directory for the backup files. For example:
    /QIBM/ProdData/WebSphere/AppServer/V8/ND/bin/WASPreUpgrade /mybackup/
    WAS70Appserver01backup /QIBM/UserData/WebSphere/AppServer/V70/ND/profiles/AppSrv01
  3. If the WASPreUpgrade command completed with Success, then checking the logs for errors or warnings is not necessary.
  4. Check the WASPreUpgrade console output for the following messages: "Failed with errors" or "Completed with warnings".
  5. Look in the following logs for warnings or errors:
    • <migration backupdir>/logs/WASPreMigrationSummary.log
    • WASPreUpgrade.< timestamp >.log
    • WASPreUpgrade.trace
  6. Run the WASPostUpgrade command to restore the saved managed application server profile configuration into the new Version 8.0 base application server profile.
    Avoid trouble Avoid trouble: This command requires additional parameters and the following example assumes that security is enabled on both administrative agents.gotcha
    For example:
    /QIBM/ProdData/WebSphere/AppServer/V8/ND/bin/WASPostUpgrade 
    /mybackup/WAS70Appserver01backup -profileName AppSrv01 
    -oldAdminAgentProfilePath /QIBM/UserData/WebSphere/AppServer
    /V70/ND/profiles/AdminAgent01 -oldAdminAgentHostname myhostname 
    -oldAdminAgentSoapPort 8879 -oldAdminAgentUsername myusername 
    -oldAdminAgentPassword mypassword -newAdminAgentProfilePath 
    /QIBM/UserData/WebSphere/AppServer/V8/ND/profiles/AdminAgent01 
    -newAdminAgentHostname myhostname -newAdminAgentSoapPort 8887
    -newAdminAgentUsername myusername1 -newAdminAgentPassword mypassword1
  7. If the command completed with Success, then checking the logs for errors or warnings is not necessary.
  8. Check the WASPostUpgrade console output for the following messages: "Failed with errors" or "Completed with warnings".
  9. Look in the following logs for errors or warnings:
    • <migration backupdir>/logs/WASPostMigrationSummary.log
    • WASPostUpgrade. <target profile>.< timestamp >.log
    • WASPostUpgrade.< target profile name >.trace
  10. Start the migrated Version 8.0 managed application server.
  11. Check the Version 8.0 managed application server SystemOut.log for warnings or errors.
    New feature New feature: This topic references one or more of the application server log files. Beginning in WebSphere Application Server Version 8.0 you can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files or native z/OS logging facilities. If you are using HPEL, you can access all of your log and trace information using the LogViewer command-line tool from your server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.newfeat

Supporting information (generally applicable)

What to do next

Troubleshooting

Previous Step   Previous Step Next Step   Next Step


Terms of Use | Feedback

Last updated: Sep 20, 2011 1:05:25 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-express-iseries&topic=tmig_migrate_admin_agent_step10
File name: tmig_migrate_admin_agent_step10.html