Recovering from profile creation or augmentation failure

The Profile Management Tool can experience failures when creating new or when augmenting existing profiles. The same can occur using the manageprofiles command-line utility. If such a failure occurs, first check the log files as described in this topic, then follow the recovery instructions described, depending on the situation.

Log files

All manageprofiles log files are in install_root/logs/manageprofiles. Look at the following log files in the order given. Each log file must contain the entry INSTCONFSUCCESS. If a file does not include this entry, a failure was detected. Look at the log files to determine why a failure was encountered and to determine a remedy.

The log file profile_name_create_error.log (where profile_name is the name of the profile).
Note: Look at this file only if you were creating a new profile, not augmenting an existing one.
- install_root/logs/manageprofiles/profile_name_create_error.log
- install_root\logs\wbi\update\profile_name_create_error.log
Search for the text Configuration action succeeded or Configuration action failed.

Note: There can be multiple occurrences of Configuration action failed. Investigate and remedy each one. Also review the log files described in the following options, if the profile was created.

Note: Additional information is available in the manageprofiles directory in the pmt.log, which logs all events that occur when a default profile is created during a complete installation using the Profile Management Tool.
Log file profile_name_augment_error.log (where profile_name is the name of the profile).
This log file is located in the following directories:
- install_root/logs/manageprofiles/profile_name_augment_error.log
- install_root\logs\wbi\update\profile_name_augment_error.log
Search for the text Configuration action succeeded or Configuration action failed.

Note: There can be multiple occurrences of Configuration action failed. Investigate and remedy each one. Also review the log files described in the following options, if the profile was created.
Note: If you want to know the status of a profile you created during installation, run the following commands:
- install_root/bin/logProfileErrors.sh
- install_root\bin\logProfileErrors.bat
Individual profile template action log files.
If you discovered false values in the log files described in the preceding options, review the log files in the following directories:
- install_root/logs/manageprofiles/profile_name on Linux® and UNIX systems
- install_root\logs\manageprofiles\profile_name on Windows systems
where profile_root or user_data_root is the installation location of the profile.
These log files do not follow a consistent naming convention, but typically, each is the name of the Apache Ant script that failed followed by .log. For example, suppose the following entry is in the profile_name_augment.log file:
```
<messages>Result of executing
E:\o0536.15\profileTemplates\default.wbicore\actions\saveParamsWbiCore.ant 
was:false</messages>
```
First look at the surrounding entries in the profile_name_augment.log file in the install_root/logs/manageprofiles directory. If you cannot determine the cause of the failure from the surrounding entries, look for the corresponding log file for any failing Ant script entries. In this case, the log file created by the saveParamsWbiCore.ant script is saveParamsWbiCore.ant.log. Look at that file to investigate why the failure occurred.

Recovery for creation failure

After you determine why profile creation failed and have addressed the cause of the failure, you can try to create the profile again.

Note: When you create a profile, it first creates a WebSphere® Application Server profile and then augments it with IBM® Business Automation Workflow profile templates to create the IBM Business Automation Workflow profile. Even if you encountered a profile creation failure, a profile can exist that does not have all the needed augmentations.

To determine if the profile exists, run the install_root/bin/manageprofiles -listProfiles command. If the profile name you used for creation does not exist, you can recreate the profile. If the profile name you used for creation exists, then the profile was created and you have encountered an augmentation failure. For tips on recovering from an augmentation failure, see Recovery for augmentation failure.

Recovery for augmentation failure

For recovery from a profile augmentation failure, follow these steps:

If any of the profile creation was successful and if the create succeeded by a subsequent augmentation failed then you have to delete the profile using the manageprofiles command: manageprofiles -delete -profileName

You must remove the profile directory manually since the deletion will leave file remnants behind.
You must remove and recreate the database if the profile creation went far enough to start working with the database. However if it failed during WAS profile creation it is not necessary to remove and recreate the database.