Troubleshoot: Create a dmgr
Create a deployment manager for clustered environments. If we encounter a failure during the configuration process, determine whether we can run the step again, skip the step, or if we must clean up the step. For some failed steps, learn how to correct the issue and recover from the failure.
Each potential step in the configuration is included. Since the steps vary, depending on the selections, the steps are not numbered. Find the step that failed to learn more about correcting and recovering from the failure. To change a value entered in the wizard, then run the configuration again.
If we must go through the wizard again, download the wizard selections that you made to save time. Then, cancel the configuration. Start the process over and upload the saved selections. Correct or enter values for the parameters that caused the failure.
Manual Step: Install the deployment manager software
This is a manual step; any errors that occur are outside the context of the wizard.
Actions Notes Run the step again Not applicable Skip the step If we successfully completed the step before, then skip this step. Clean up step None required
Create the deployment manager profile
If the step fails, see the logs for the manageprofiles command to determine why the step failed. The wizard uses the portal profile templates to create the deployment manager profile. An error might result from a problem with the profile templates. The error message in the log provides more information.
The log files are in...
app_server_root/logs/manageprofiles
Actions Notes Run the step again Run the step again, if it did not complete successfully before. Skip the step If this step was successful, we can skip it if we run the configuration process again. Clean up step If an unrecoverable error occurs and the create deployment manager profile step fails, remove the profile.
- Use the manageprofiles command to remove the profile.
The command file is in the app_server_root/bin directory. The command file is a script named manageprofiles.sh|bat.
Example:
/opt/IBM/WebSphere/AppServer/bin/manageprofiles.sh -delete -profileName dmgr01
- Delete the profile directory.
- Then, run the Create a dmgr Profile step again.
Start the deployment manager server
If the step fails, check the systemout.log for the deployment manager. The log file is in the dmgr_profile/log/dmgr01 directory.
Actions Notes Run the step again Run this step again if the deployment manager is not running. Skip the step Do not skip this step if the deployment manager is not running. We cannot successfully run the step to augment the profile unless the deployment manager is running. Clean up step None required
Augment the deployment manager profile with the portal profile template
If the step fails, see the logs for the manageprofiles command to determine why the step failed. The wizard uses the portal profile templates to create the deployment manager profile. An error might result from a problem with the profile templates. The error message in the log provides more information.
The log files are in...
app_server_root/logs/manageprofiles
Actions Notes Run the step again Run the step again, if it did not complete successfully before. Skip the step If we successfully completed the step before, then skip this step. Clean up step If an unrecoverable error occurs and the augment deployment manager profile step fails, remove the profile.
- Use the manageprofiles command to remove the profile.
The command file is in the app_server_root/bin directory. The command file is a script named manageprofiles.sh|bat.
Example:
/opt/IBM/WebSphere/AppServer/bin/manageprofiles.sh -delete -profileName dmgr01
- Delete the profile directory.
- Then, run the Create a Deployment Manager Profile step again.
Stop the deployment manager
If the step fails, check the systemout.log for the deployment manager. The log file is in the dmgr_profile/log/dmgr01 directory.
Actions Notes Run the step again We can run this step again. Skip the step Do not skip this step. Clean up step None required
Start the deployment manager after the profile augmentation is complete
If the step fails, check the systemout.log for the deployment manager. The log file is in the dmgr_profile/log/dmgr01 directory.
Actions Notes Run the step again We can run this step again. Skip the step Do not skip this step. Clean up step None required