Icon indicating 6.0.1 content only

manageprofiles command for use with WebSphere Process Server, version 6.0.1

The manageprofiles command-line tool can be used to create or augment WebSphere Process Server runtime environments. The command can be used to manage a profile, which is the set of files that define the runtime environment for a deployment manager, a custom profile, or a stand-alone profile. The command can be used to create, delete, augment, unaugment, list or validate profiles.

The manageprofiles command is another method of creating profiles in addition to the Profile Wizard (which can be used in graphical mode or with silent response files). Using the Profile Wizard or the response files (which in turn activate the Profile Wizard, but "silently") is a sufficient method of creating a profile in most situations. However, advanced users might find it desirable, in some circumstances, to use the manageprofiles command. You must use the manageprofiles command to unaugment and then delete a profile, for instance, because the Profile Wizard does not provide these functions. Remember, before you delete a profile you must unaugment it.

When the Profile Wizard (including silent installation) is used to initially create or augment a profile, a command-line version of the profile creation or augmentation is written to a log file. You can extract this command line from the log file, carefully modify specific portions of it, and use it to create or augment other profiles.

Important: IBM strongly recommends that for WebSphere Process Server you initially use the Profile Wizard or the silent installation process to create a new profile or augment an existing WebSphere Application Server profile, and only use the manageprofiles command to "copy" such a profile or augmentation or create one that is very similar. Using the manageprofiles command to create and augment profiles contains step-by-step instructions for this procedure.

Usage

Only use the manageprofiles command with WebSphere Process Server as described in Using the manageprofiles command to create and augment profiles.
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 you happen to have any. The templates that should be used for WebSphere Process Server are as follows:
  • default.wbiserver: for a stand-alone profile
  • managed.wbiserver: for a custom profile
  • dmgr.wbiserver: for a deployment manager 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 manageprofiles will create two logs in the install_root/logs/wasprofile directory.
  • The wasprofile_<mode>_profile_name.log will contain the details of the action that was executed by the manageprofiles command.
  • The manageProfiles-<mode>-profile_name.log will contain 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.sh command syntax

Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms: Use the following syntax and parameters with the manageprofiles command to get information about your profiles, to delete profiles, or to unaugment profiles. To create or augment a profile with manageprofiles, follow the instructions in Using the manageprofiles command to create and augment profiles.

List existing profiles:
# ./manageprofiles.sh -listProfiles 
                 
Remove the most recent augmentation for a profile:
# ./manageprofiles.sh -unaugment 
              -profileName profile_name 
Delete profiles:
Note: All augmentations must be removed from a profile before you delete the profile. Otherwise unexpected results might occur.
# ./manageprofiles.sh -delete 
                -profileName profile_name | -profilePath profile_path 
                
Get the name of an existing profile from its path:
# ./manageprofiles.sh -getName 
                 -profilePath profile_path 
                
Get the path of an existing profile from its name:
# ./manageprofiles.sh -getPath 
                 -profileName profile_name 
                
Check the integrity of the profile registry:
# ./manageprofiles.sh -validateRegistry 
                
Check the integrity of the profile registry, removing profiles that are not found:
# ./manageprofiles.sh -validateAndUpdateRegistry 
                 [-backup file_name] 
                
Get help for the command:
# ./manageprofiles -help

# ./manageprofiles -option_name -help

manageprofiles.bat command syntax

Icon indicating Windows platforms On Windows platforms: List existing profiles:
manageprofiles -listProfiles 
Remove the most recent augmentation for a profile:
manageprofiles -unaugment 
               -profileName  profile_name 
Delete profiles:
Note: All augmentations must be removed from a profile before you delete the profile. Otherwise unexpected results might occur.
manageprofiles -delete 
              -profileName profile_name | -profilePath profile_path 
            

Get the name of an existing profile from its path:
manageprofiles -getName 
               -profilePath fully_qualified_profile_path 
             
Get the path of an existing profile from its name:
manageprofiles -getPath 
               -profileName profile_name 
             
Check the integrity of the profile registry:
manageprofiles -validateRegistry 
             
Check the integrity of the profile registry, removing any unfound profiles:
manageprofiles -validateAndUpdateRegistry 
             [-backup file_name] 
             
Get help for the command:
manageprofiles -help

manageprofiles -option_name -help

Parameters

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

Command output

On completion, each command will print one of the following statements to the command line (exact wording will vary depending on what 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 will be printed more that once. For example the INSTCONFSUCCESS line will be printed three times to the command line.
Related tasks
Using the manageprofiles command to create and augment profiles
Related reference
manageprofiles parameters

Terms of use |

Last updated: Tue Feb 21 17:47:10 2006

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