manageprofiles command reference

Use the manageprofiles command to create, augment, or delete a profile. The manageprofiles command and its graphical user interface and the Profile Management Tool, are the only ways to create profiles, or runtime environments.

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.

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:

install_root/logs/manageprofiles
install_root\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 WSRR:

default.wsrr: for a stand-alone server profile, which defines a stand-alone server. Use this template to deploy WSRR to a stand-alone server.
dmgr.wsrr: for a deployment manager profile, which defines a deployment manager. Use this template to deploy WSRR to a federated server or a cluster.
managed.wsrr: for a managed node profile, which defines a managed node. Use this template to deploy WebSphere® Service Registry and Repository to a federated server or a cluster.

Syntax

The manageprofiles command is used to perform the following tasks:

Creating a profile (-create parameter).
Follow the instructions in Creating WSRR profiles using the manageprofiles command.
Augmenting a profile (-augment parameter).
Follow the instructions in Augmenting profiles using the manageprofiles command.
Unaugmenting a profile (-unaugment parameter).
Follow the instructions in Unaugmenting profiles using the manageprofiles command.
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 -templatePath install_root/profiles/default.wsrr -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: stand-alone server profiles, manageprofiles parameters: deployment manager profiles, and manageprofiles parameters: custom profiles. The Profile Management Tool validates that the required parameters are provided and the values entered for those parameters are valid. Parameters are case sensitive.

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