WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


manageprofiles command

The manageprofiles command creates a profile, which is the set of files that define the runtime environment for a deployment manager, a managed node, or a stand-alone server.

The profile defines the runtime environment and includes all of the files that the server processes can change during runtime.

The manageprofiles command and its graphical user interface, the Profile Management Tool, are the only ways to create profiles, or the only ways to create runtime environments. You can also augment profiles and delete profiles with the manageprofiles command.

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

The manageprofiles command creates a log for every profile that it creates, deletes, or augments. The logs are in the following directory, depending on platform:
  • For Linux operating systemFor UNIX operating system install_root/logs/manageprofiles
  • For Windows operating system install_root\logs\manageprofiles
  • For i5/OS operating system user_data_root/profileRegistry/logs/manageprofiles
The files are named as follows:
  • profile_name_create.log
  • profile_name_augment.log
  • profile_name_delete.log
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. Use the following templates with WebSphere® ESB:
  • default.esbserver: for a WebSphere Enterprise Service Bus stand-alone server profile, which defines a stand-alone server.
  • dmgr.esbserver: for a WebSphere Enterprise Service Bus deployment manager profile, which defines a deployment manager.
  • managed.esbserver: for a WebSphere Enterprise Service Bus custom profile, which, when federated to a deployment manager, defines a managed node.

Syntax

The manageprofiles command is used to perform the following tasks:
  • Creating a profile (-create parameter).

    Follow the instructions in Creating profiles using the manageprofiles command.

  • Augmenting a profile (-augment parameter).

    Follow the instructions in Augmenting profiles using the manageprofiles command.

    Note: Using profiles that have been unaugmented (-unaugment parameter) is not supported.
  • Deleting a profile (-delete parameter).

    Follow the instructions in Deleting profiles using the manageprofiles command.

  • Deleting all profiles (-deleteAll parameter)
  • Listing all profiles (-listProfiles parameter)
  • Getting the name of an existing profile from its name (-getName parameter)
  • Getting the name of an existing profile from its path (-getPath parameter)
  • Validating a profile registry (-validateRegistry parameter)
  • Validating and updating a profile registry (-validateAndUpdateRegistry parameter)
  • Getting the default profile name (-getDefaultName parameter)
  • Setting the default profile name (-setDefaultName parameter)
  • Backing up a profile (-backupProfile parameter)
  • Restoring a profile (-restoreProfile parameter)
  • Using a response file containing the information required to run a manageprofiles command (-response parameter)

For detailed help including the required parameters for each of the tasks accomplished with the manageprofiles command, use the -help parameter. The following is an example of using the help parameter with the manageprofiles command -augment parameter on Windows operating systems: manageprofiles.bat -augment -help. The output specifies which parameters are required and which are optional.

Parameters

Depending on the operation that you want to perform with the manageprofiles command, you might need to provide one or more of the parameters described in manageprofiles parameters. The Profile Management Tool validates that the required parameters are provided and the values entered for those parameters are valid. Be sure to type the name of the parameters with the correct case, because the command line does not validate the case of the parameter name. Incorrect results can occur when the parameter case is not typed correctly.

Command output

On completion, the command displays a statement similar to one of the following messages. (Exact wording varies depending on whether you created, deleted or augmented a profile.)
  • 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 displayed more than once. For example, the INSTCONFSUCCESS line is displayed three times at the command line. For more information, see Installation and profile creation log files

reference Reference topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rins_manageprofiles.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).