You might encounter problems while migrating from an older version of WebSphere Application Server.
This indicates that a configuration error was detected before beginning the migration process. This can be due to either incorrect data entered when you created the migration jobs or a configuration problem. Review the log output for the error detected, then correct and rerun. The logs are located in temporary_directory_location/nnnnn, where temporary_directory_location is the value that you specified when you created the migration jobs (where the default is /tmp/migrate) and nnnnn is a unique number that is generated and displayed during the creation of your migration jobs as well as displayed in the JESOUT DDNAME of the WROUT and WRERR steps of your batch job stream.
In the event of failure in the migration job after the Verify step, you can rerun the migration job; but first, you must delete the WebSphere Application Server for z/OS configuration home directory created in the CRHOME step. This corresponds to the home directory that you entered when you created the migration jobs, and it can also be found in the migration JCL environment variable V6_HomeDir. Because the migration procedure creates a new configuration HFS for each node being migrated, it is a simple process to delete the configuration and start from scratch.
A federated node is the most complex node to migrate because it is essentially two migrations rolled into one. A federated node requires a migration of the node configuration information contained in the deployment manager's master repository, as well as the configuration information contained in the federated node. Federated node migration requires a JMX connection to the deployment manager as well as an active connection to the configuration repository on the deployment manager. If you have security enabled, it is essential that you follow the instructions that were generated when you created the migration jobs. The migration job must be submitted with a WebSphere Administrator's user ID that has been properly configured for obtaining secure connections. Failure to do so will result in the inability to initiate the migration process on the deployment manager.
./wsadmin.sh -connType -username -password -host -port
The federated migration process runs inside of the deployment manager's servant and obtains a JMX connection to an active repository to perform its tasks. The size of your node's configuration will determine the length of time required to perform the migration. If a timeout occurs, the migration task on the deployment manager will continue to run and might continue to completion; however, the migration will not have completed on the node being migrated. In this case, wait for the processing on the deployment manager to complete before proceeding. To increase the timeout value, you will need to modify the migration JCL connectionTimeout=120 parameter, which specifies the timeout interval in minutes. Follow the instructions in the Job fails after the Verify step above to proceed.
The migration procedure that runs on the deployment manager produces a separate set of log files that is not located in the same place as the federate node's log files and is not copied to the output logs of your batch migration job. Debugging failures on the deployment manager during a federated node migration requires inspecting the log files on the deployment manager's configuration file system. These log files are placed under the /temp directory of your deployment manager's default profile in a folder prefixed with the node name that is being migrated.
/WebSphere/V6R0/DeploymentManager/profiles/default/temp/SY1_migration_temp
On failure, there will be a Migration Failed file present in this directory. Examine the deployment manager servant's log for additional messages that might indicate the cause of failure.
The migration logs are located in temporary_directory_location/nnnnn, where temporary_directory_location is the value that you specified when you created the migration jobs (where the default is /tmp/migrate) and nnnnn is a unique number that was generated and displayed during the creation of your migration jobs. Normally, the space requirements for the migration logs are small. If you enable tracing, however, the log files can be quite large. The best practice is to enable tracing only after problems have been found. If tracing is required, try to only enable tracing related to the step in the process that is being debugged. This will help to reduce the space requirements.
TraceState=enabled profileTrace=disabled preUpGradeTrace=disabled postUpGradeTrace=enabled
During migration, a backup copy of your Version 5.x configuration is made. This backup becomes the source of the information being migrated. The default backup location is /tmp/migrate/nnnnn. This location can be changed when you create the migration jobs. It is specified by the V5_BackupDirectory variable. Depending on the size of the node being migrated, this backup can be quite large. If your temporary space is inadequate, then you will need to relocate this backup.
Each z/OS installation is different with respect to job classes and time limitations. Make sure you have specified appropriate job classes and timeout values on your job card.
Review the instructions that were generated when you created the migration jobs. Verify that the JCL procedures have been copied over correctly to your PROCLIB, the RACF definitions have been created, the Version 6.0.x libraries have been authorized, and, if required, your STEPLIB statements to the Version 6.0.x libraries have been specified. Make sure that the daemon process associated with your cell is at the appropriate level. The daemon process must be at the highest WebSphere Application Server for z/OS version level of all servers that it manages within the cell.
If you update Version 6.0 or 6.0.1 to Version 6.0.2 before migrating the Version 5.x deployment manager, you can use the Version 6.0.2 administrative console to add a Version 5.x member to a Version 5.x cluster.
If you did not find your problem listed, contact IBM support.
In this information ... | IBM Redbooks, demos, education, and more(Index) Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience. This feature requires Internet access. Most of the following links will take you to information that is not part of the formal product documentation and is provided "as is." Some of these links go to non-IBM Web sites and are provided for your convenience only and do not in any manner serve as an endorsement by IBM of those Web sites, the material thereon, or the owner thereof. |