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.
- Before creating and augmenting profiles, install eXtreme Scale.
- If the environment contains WAS v6.0.2, use wasprofile to create and augment profiles...
cd install_root/bin ./wasprofile.sh -augment -profileName dmgr_01 -templatePath "/WAS70/AppServer/profileTemplates/xs_augment/dmgr"
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:
- Create and augment a deployment manager profile
- Create and augment a custom profile
- Create and augment stand-alone application server profile
- Create and augment a cell profile
- Unaugment any type of profile
When you augment an existing profile, you change the profile by applying a product-specific augmentation template.
- Augment the profile with the xs_augment template if you installed the eXtreme Scale client or both the client and server.
- Augment the profile with the pf_augment template if you installed only the partitioning facility.
- Apply both templates if the environment contains the eXtreme Scale client and the partitioning facility.
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
Example
- Use the xs_augment template:
./manageprofile.sh -create -templatePath install_root/profileTemplates/xs_augment/dmgr
- Use the pf_augment template:
./manageprofile.sh -create -templatePath install_root/profileTemplates/pf_augment/dmgr
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/managedwhere template_type is xs_augment or pf_augment.
Example
- Use the xs_augment template:
./manageprofile.sh -create -templatePath install_root/profileTemplates/xs_augment/managed
- Use the pf_augment template:
./manageprofile.sh -create -templatePath install_root/profileTemplates/pf_augment/managed
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/defaultwhere template_type is xs_augment or pf_augment.
Example
- Use the xs_augment template:
./manageprofile.sh -create -templatePath install_root/profileTemplates/xs_augment/default
- Use the pf_augment template:
./manageprofile.sh -create -templatePath install_root/profileTemplates/pf_augment/default
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/dmgrwhere 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/defaultwhere template_type is xs_augment or pf_augment.
Example
- Use the xs_augment template:
./manageprofile.sh -create -templatePath install_root/profileTemplates/xs_augment/cell/dmgr -nodeProfilePath install_root/profiles/AppSrv01 -cellName cell01dmgr -nodeName node01dmgr -appServerNodeName node01 ./manageprofile.sh -create -templatePath install_root/profileTemplates/xs_augment/cell/default -dmgrProfilePath install_root/profiles/Dmgr01 -portsFile install_root/profiles/Dmgr01/properties/portdef.props -nodePortsFile install_root/profiles/Dmgr01/properties/nodeportdef.props -cellName cell01dmgr -nodeName node01dmgr -appServerNodeName node01
- Use the pf_augment template:
./manageprofile.sh -create -templatePath install_root/profileTemplates/pf_augment/cell/dmgr -nodeProfilePath install_root/profiles/AppSrv01 -cellName cell01dmgr -nodeName node01dmgr -appServerNodeName node01 ./manageprofile.sh -create -templatePath install_root/profileTemplates/pf_augment/cell/default -dmgrProfilePath install_root/profiles/Dmgr01 -portsFile install_root/profiles/Dmgr01/properties/portdef.props -nodePortsFile install_root/profiles/Dmgr01/properties/nodeportdef.props -cellName cell01dmgr -nodeName node01dmgr -appServerNodeName node01
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/dmgrwhere template_type is xs_augment or pf_augment.
Example
- Use the xs_augment template:
./manageprofile.sh -augment -profileName profile01 -templatePath install_root/profileTemplates/xs_augment/dmgr
- Use the pf_augment template:
./manageprofile.sh -augment -profileName profile01 -templatePath install_root/profileTemplates/pf_augment/dmgr
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/managedwhere template_type is xs_augment or pf_augment.
Example
- Use the xs_augment template:
./manageprofile.sh -augment -profileName profile01 -templatePath install_root /profileTemplates/xs_augment/managed
- Use the pf_augment template:
./manageprofile.sh -augment -profileName profile01 -templatePath install_root /profileTemplates/pf_augment/managed
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/defaultwhere template_type is xs_augment or pf_augment.
Example
- Use the xs_augment template:
./manageprofile.sh -augment -profileName profile01 -templatePath install_root /profileTemplates/xs_augment/default
- Use the pf_augment template:
./manageprofile.sh -augment -profileName profile01 -templatePath install_root /profileTemplates/pf_augment/default
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/dmgrwhere 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/defaultwhere template_type is xs_augment or pf_augment.
Example
- Use the xs_augment template:
./manageprofile.sh -augment -profileName profile01 -templatePath install_root /profileTemplates/xs_augment/cell/dmgr ./manageprofile.sh -augment -profileName profile01 -templatePath install_root /profileTemplates/xs_augment/cell/default
- Use the pf_augment template:
./manageprofile.sh -augment -profileName profile01 -templatePath install_root /profileTemplates/pf_augment/cell/dmgr ./manageprofile.sh -augment -profileName profile01 -templatePath install_root /profileTemplates/pf_augment/cell/default
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_typewhere 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
- Use the xs_augment template:
./manageprofile.sh -unaugment -profileName profile01 -ignoreStack -templatePath install_root/profileTemplates/xs_augment/profile_type
- Use the pf_augment template:
./manageprofile.sh -unaugment -profileName profile01 -ignoreStack -templatePath install_root/profileTemplates/pf_augment/profile_type
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