Administration guide > Install > Installing within WAS > Create and augment profiles


manageprofiles command

Use the manageprofiles utility to create profiles with the WebSphere eXtreme Scale template, and augment and unaugment existing application server profiles with the eXtreme Scale augment templates.

To use the features of the product, the environment must contain at least one profile augmented for the product.


Purpose

The manageprofiles command creates the runtime environment for a product process in a set of files called a profile. The profile defines the runtime environment. You can perform the following actions with the manageprofiles command:

When you augment an existing profile, you change the profile by applying a product-specific augmentation template.


Location

The command file is in the install_root/bin directory.


Usage

For detailed help, use the -help parameter:

./manageprofiles.sh -create -templatePath install_root/profileTemplates/xs_augment/dmgr -help

In the following sections, each task that you can perform using the manageprofiles command, along with a list of required parameters, is described. For details on the optional parameters to specify for each task, see the manageprofiles command in the WebSphere Application Server Information Center.


Create a deployment manager profile

Use the manageprofiles command to create a deployment manager profile. The deployment manager administers the application servers that are federated into the cell.


Parameters

-create

Creates a profile. (Required)

-templatePath template_path

File path to the template. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/dmgr

where template_type is xs_augment or pf_augment.


Example


Create a custom profile

Use the manageprofiles command to create a custom profile. A custom profile is an empty node that you customize through the deployment manager to include application servers, clusters, or other Java™ processes.


Parameters

-create

Creates a profile. (Required)

-templatePath template_path

File path to the template. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/managed

where template_type is xs_augment or pf_augment.


Example


Create a stand-alone application server profile

Use the manageprofiles command to create a stand-alone application server profile.


Parameters

-create

Creates a profile. (Required)

-templatePath template_path

File path to the template. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/default

where template_type is xs_augment or pf_augment.


Example


Create a cell profile

Use the manageprofiles command to create a cell profile, which consists of a deployment manager and an application server.


Parameters

Specify the following parameters in the deployment manager template:

-create

Creates a profile. (Required)

-templatePath template_path

File path to the template. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/cell/dmgr

where template_type is xs_augment or pf_augment.

Specify the following parameters with the application server template:

-create

Creates a profile. (Required)

-templatePath template_path

File path to the template. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/cell/default

where template_type is xs_augment or pf_augment.


Example


Augment a deployment manager profile

Use the manageprofiles command to augment a deployment manager profile.


Parameters

-augment

Augments the existing profile. (Required)

-profileName

Name of the profile. (Required)

-templatePath template_path

Specifies the path to the template files that are located in the installation root directory. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/dmgr

where template_type is xs_augment or pf_augment.


Example


Augment a custom profile

Use the manageprofiles command to augment a custom profile.


Parameters

-augment

Augments the existing profile. (Required)

-profileName

Name of the profile. (Required)

-templatePath template_path

Specifies the path to the template files that are located in the installation root directory. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/managed

where template_type is xs_augment or pf_augment.


Example


Augment a stand-alone application server profile

Use the manageprofiles command to augment a stand-alone application server profile.


Parameters

-augment

Augments the existing profile. (Required)

-profileName

Name of the profile. (Required)

-templatePath template_path

Specifies the path to the template files that are located in the installation root directory. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/default

where template_type is xs_augment or pf_augment.


Example


Augment a cell profile

Use the manageprofiles command to augment a cell profile.


Parameters

Specify the following parameters for the deployment manager profile:

-augment

Augments the existing profile. (Required)

-profileName

Name of the profile. (Required)

-templatePath template_path

Specifies the path to the template files that are located in the installation root directory. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/cell/dmgr

where template_type is xs_augment or pf_augment.

Specify the following parameters for the application server profile:

-augment

Augments the existing profile. (Required)

-profileName

Name of the profile. (Required)

-templatePath template_path

Specifies the path to the template files that are located in the installation root directory. (Required)

Use the following format:

-templatePath install_root/profileTemplates/template_type/cell/default

where template_type is xs_augment or pf_augment.


Example


Unaugment a profile

To unaugment a profile, specify the -ignoreStack parameter with the -templatePath parameter in addition to specifying the required -unaugment and -profileName parameters.


Parameters

-unaugment

Unaugments a previously augmented profile. (Required)

-profileName

Name of the profile. The parameter is issued by default if no values are specified. (Required)

-templatePath template_path

Specifies the path to the template files that are located in the installation root directory. (Optional)

Use the following format:

-templatePath install_root/profileTemplates/template_type/profile_type

where template_type is xs_augment or pf_augment and profile_type is one of four profile types:

  • dmgr: deployment manager profile

  • managed: custom profile

  • default: stand-alone application server profile

  • cell: cell profile

-ignoreStack

Used with the -templatePath parameter to unaugment a particular profile that has been augmented. (Optional)


Example


Parent topic:

Create and augment profiles for WebSphere eXtreme Scale


Related tasks

Create and augment profiles for WebSphere eXtreme Scale

Use the graphical user interface to create profiles

Use the graphical user interface to augment profiles