Recovering from profile creation or augmentation failure

The Profile Wizard can experience failures when creating new, or augmenting existing, profiles.

Icon indicating 6.0.1 content only The same can occur using the manageprofiles command.

If such a failure occurs, first check the log files as described here, then follow the recovery instructions below depending on the situation.

Log files

The following is a list of log files that should be looked at 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.
  1. The log file was created by the Profile Wizard.
    Note: Icon indicating 6.0.1 content only If you used the manageprofiles command and experienced failure, you would not look for this file.
    The name of the file is partially based on a timestamp and is in the form pcatLogNNNNNNNNNNNNN.txt, where NNNNNNNNNNNNN is a number. This file can be found in the directory profile_root/logs on Linux and UNIX systems and profile_root\logs on Microsoft Windows systems (where profile_root is the installation location of the profile). If you cannot determine the cause of the failure, review the log files described in the following options.
    Note: If you have run the Profile Wizard multiple times for a profile, more than one of these files might exist. Always refer to the newest file.
  2. The log file wasprofile_create_profile_name.log (where profile_name is the name of the profile).
    Note: You would look at this file only if you were creating a new profile. If you were augmenting an existing profile, then you would not look at this file.

    This log file is located in the directory install_root/logs/wasprofile on Linux and UNIX systems and install_root\logs\wasprofile on Windows systems (where install_root is the WebSphere Process Server installation root location). Search for the text "Result of executing" and verify that each occurrence ends with "true." Each true or false value results from the execution of a profile template configuration action .ant script. For example:

    <message>Result of executing
    E:\o0536.15\profileTemplates\default\actions\first was: true</messages>

    A value of false in this file can indicate the source of the failure.

    Note: There can be multiple occurrences of "false". You should investigate and remedy each one. Also review the log files described in the following options, if the profile was created.
  3. Log file wasprofile_augment_profile_name.log (where profile_name is the name of the profile).

    This log file is located in the directory install_root/logs/wasprofile on Linux and UNIX systems and install_root\logs\wasprofile on Windows systems (where install_root is the WebSphere Process Server installation root location). Search for the text "Result of executing" and verify that each occurrence ends with "true." Each true or false value results from the execution of a profile template configuration action .ant script. For example:

    <messages>Result of executing
    E:\o0536.15\profileTemplates\default.wbicore\actions\saveParamsWbiCore.ant 
    was:true</messages>

    A value of false in this file can indicate the source of the failure. Also review the log files described in the following option.

    Note: There can be multiple occurrences of "false". You should investigate and remedy each one.
  4. 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 directory profile_root/logs on Linux and UNIX systems and profile_root\logs on Windows systems (where profile_root is the installation location of the profile). These log files do not follow a consistent naming convention, but typically, it is the name of the .ant script that failed followed by .log. For example, if the following entry is in the wasprofile_augment_profile_name.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 wasprofile_augment_profile_name.log file. 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 address 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 WebSphere Process Server profile templates to create a WebSphere Process Server profile. Even if you encountered a profile creation failure, a profile can exist that does not have all the needed augmentations (presumably because of the failure).

To determine if the profile exists, run the install root/bin/wasprofile.sh -listProfiles command on Linux and UNIX systems or the install_root\bin\wasprofile.bat -listProfiles command on Windows systems (where install_root is the WebSphere Process Server installation root location). 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 the following section.

Icon indicating 6.0.1 content only In the event the profile was created but augmentations failed when using the manageprofiles command, it is recommended that you finish the remaining augmentations with the Profile Wizard.

Recovery for augmentation failure

After you determine why profile augmentation failed and address the cause of the failure, you can try to augment the existing profile again to successfully create a complete WebSphere Process Server profile by following the steps below.

  1. Start the Profile Wizard and, instead of creating a new profile, choose to augment an existing profile.
  2. Choose the profile you were working with, and enter the correct information for it.
Note: Some of the augmentations may have completed successfully the first time you ran the Profile Wizard. As a result, you may not see all of the panels that you saw the first time you tried to create the profile. This is because the Profile Wizard detects which remaining augmentations must be completed and displays only the necessary panels.

Terms of use |

Last updated: Thu Apr 27 15:07:55 2006

(c) Copyright IBM Corporation 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)