manageprofiles command

Use the manageprofiles command-line tool to manage WebSphere Process Server profiles. The command can be used to create, delete, augment, unaugment, list, or validate profiles.

The manageprofiles command is another method of creating or augmenting profiles in addition to the Profile wizard. When you create or augment a profile using the Profile wizard or create a profile silently, a command-line version of the profile creation or augmentation configuration is written to a log file. Advanced users can extract this command line from the log file, carefully modify specific portions of it, and use it with the manageprofiles command to create or augment other profiles. The manageprofiles command also enables functions not provided by the Profile wizard, such as unaugmenting and then deleting a profile.

Important: IBM supports creation or augmentation of a WebSphere Process Server profile with the manageprofiles command only if you first create or augment a like profile using the Profile wizard (or create a like profile silently using a response file – silent profile augmentation is not supported) and then use the manageprofiles command to "copy" such a profile creation or augmentation to create one that is very similar. Creating profiles using the manageprofiles command and Augmenting profiles using the manageprofiles command contain step-by-step instructions for these procedures. For tasks other than creating or augmenting a WebSphere Process Server profile (unaugmenting, deleting, listing, or validating profiles) use of manageprofiles from the command line (without copying a previously generated command) is supported.

Usage

To create or augment WebSphere Process Server profiles with the manageprofiles command, follow the instructions described in Creating profiles using the manageprofiles command and Augmenting profiles using the manageprofiles command. You can also use the manageprofiles command to delete, unaugment, list, or validate a profile directly from the command line as shown in manageprofiles command syntax.
Restriction:
Do not use the wasprofile command to modify a WebSphere Process Server profile.

Profile types

Templates for each profile are located in the install_root/profileTemplates directory. Within this directory are various directories that correspond to different profile types. The directories are the paths that you indicate while using the manageprofiles command with the -templatePath option. You can also specify profile templates that lie outside the installation root if they exist. The templates to use with WebSphere Process Server are as follows:
  • default.wbiserver: for a stand-alone profile.
  • dmgr.wbiserver: for a deployment manager profile.
  • managed.wbiserver: for a custom profile.

Location of the command file

The command file is located in the install_root/bin directory. The command file is a script named manageprofiles.sh for Linux and UNIX platforms or manageprofiles.bat for Windows platforms.

Logging

Each invocation of the manageprofiles command creates two logs in the install_root/logs/wasprofile directory.
  • The wasprofile_<mode>_profile_name.log contains the details of the action that was executed by the manageprofiles command.
  • The manageProfiles-<mode>-profile_name.log contains a much briefer description of which templates were applied for a given invocation, and their return codes.
For example, the manageprofiles command manageprofiles_create_profile1 creates two log files:
  • install_root/logs/wasprofile/wasprofile_create_profile1.log
  • install_root/logs/wasprofile/manageProfiles-create-profile1.log

manageprofiles command syntax

Use the following syntax and parameters with the manageprofiles command to get information about your profiles, to delete profiles, or to unaugment profiles.

Table 1.
Task Command
Create a profile. Follow the instructions in Creating profiles using the manageprofiles command.
Augment a profile. Follow the instructions in Augmenting profiles using the manageprofiles command.
List existing profiles.
  • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
    # ./manageprofiles.sh -listProfiles
  • Icon indicating Windows platforms On Windows platforms:
    manageprofiles -listProfiles 
Remove the most recent augmentation for a profile.
  • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
    # ./manageprofiles.sh -unaugment 
            -profileName profile_name
  • Icon indicating Windows platforms On Windows platforms:
    manageprofiles -unaugment 
            -profileName profile_name
Delete profiles.
Note: You must remove all augmentations from a profile before you delete it. Otherwise unexpected results might occur.
  • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
    # ./manageprofiles.sh -delete 
              -profileName profile_name | 
              -profilePath profile_path
  • Icon indicating Windows platforms On Windows platforms:
    manageprofiles -delete 
              -profileName profile_name | 
              -profilePath profile_path
Get the name of an existing profile from its path.
  • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
    # ./manageprofiles.sh -getPath 
               -profilePath profile_path
  • Icon indicating Windows platforms On Windows platforms:
    manageprofiles -getPath 
               -profilePath profile_path
Get the name of an existing profile from its name.
  • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
    # ./manageprofiles.sh -getName 
               -profileName profile_name
  • Icon indicating Windows platforms On Windows platforms:
    manageprofiles -getName 
               -profileName profile_name
Check the integrity of the profile registry.
  • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
    # ./manageprofiles.sh 
                 -validateRegistry
  • Icon indicating Windows platforms On Windows platforms:
    manageprofiles -validateRegistry
Check the integrity of the profile registry, removing profiles that are not found.
  • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
    # ./manageprofiles.sh 
               -validateAndUpdateRegistry 
               [-backup file_name] 
  • Icon indicating Windows platforms On Windows platforms:
    manageprofiles 
               -validateAndUpdateRegistry 
               [-backup file_name] 
Get help for the command.
  • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
    # ./manageprofiles -help
    
    # ./manageprofiles -option_name -help
    
  • Icon indicating Windows platforms On Windows platforms:
    manageprofiles -help
    
    manageprofiles -option_name -help
    

Parameters

Refer to manageprofiles command parameters for descriptions of parameters to use with the manageprofiles command for WebSphere Process Server.

Command output

On completion, the command prints a statement similar to one of the following (exact wording will vary depending on which mode of manageprofiles was called):
  • INSTCONFSUCCESS: Profile creation succeeded.
  • INSTCONFFAILED: Profile creation failed.
  • INSTCONFPARTIALSUCCESS: Some non-critical post installation configuration actions did not succeed.
In some cases, the statement is printed more than once. For example, the INSTCONFSUCCESS line is printed three times to the command line.

Last updated: Wed 01 Nov 2006 07:47:12

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