Troubleshoot the Configuration Wizard

If we encounter a failure using Configuration Wizard, do not go back to the Answer questions or Customize values pages. To recover from the failure and continue the configuration:

1. Click "View Results" for the step that failed to determine what caused the failure.

2. Save the selections in case we must reset the configuration process or start over...
   Download Wizard Selections

3. Recovery steps vary based on the cause of the failure.

   • Update the configuration environment and run the step that failed again.

   • Reset the configuration steps and start over.

View Results to determine cause

When we encounter a problem, it is typically recorded in a log file. There are a number of log files. The two most frequently used log files are ConfigTrace.log and SystemOut.log. On the Configure page, use the View Results link to open the ConfigTrace.log. To inspect the ConfigTrace.log...

1. Search the log file for BUILD FAILED.

2. After you find BUILD FAILED, search for an error message that occurred before that message.

3. Each error has a code and message. The code includes an E to indicate error, such as EJPXX1234E. Ideally the message indicates what failed, why, and what we need to do to recover.

Run Step to run a single step again

We can run the step again if the failure resulted from:

• Not being able to connect to the LDAP or database server because the server was not online. Start the server and when it is online, run the failed step again.
• Network communications instability. When network becomes stable, run the failed step again.

Reset Steps

The "Reset Steps" option forces us to start over. If we must reset all the steps, download your wizard selections to save time. After you click Reset Steps, you return to the home page. Select the configuration options and click Upload Saved Selections. After the XML file uploads, we can correct the settings that led to the error.

We need to reset the steps and start the configuration again if you:

• Provided an incorrect value for the profile path, administrator credentials, or another repeatedly used property.
• Completed manual steps only before the failure occurred.

Resetting the steps does not undo any tasks the wizard completed before the failure occurred. Steps that we need to take to clean up depend on the configuration steps the wizard ran before the failure occurred. See individual configuration troubleshooting topics for guidance.

After correcting the values, on the Configure page, click Skip Step for any steps that ran that we do not need to run again. If we completed a step in the previous attempt that did not use values that we changed, then we can skip the step.

See also

1. Database Transfer
   
2. Troubleshooting the enable federated security option
   
3. Create a dmgr
   
4. Troubleshooting the create a cluster option
   
5. Create an Additional Cluster Node
   
6. Create a WebSphere Portal profile
   
7. Remove a WebSphere Portal profile
   
8. Migrate a stand-alone server
   
9. Migrate the deployment manager profile for a cluster environment
   
10. Migrate node profiles for a cluster environment
    
11. Upgrade node profiles for a cluster environment
    

Parent Troubleshooting