WebSphere Extended Deployment Compute Grid, Version 6.1
             Operating Systems: AIX, HP-UX, Linux, Solaris, Windows, z/OS


Using the manageprofiles command to create profiles

Use the manageprofiles command utility to create profiles with WebSphere Extended Deployment templates.

Ensure that your environment meets all of the hardware and software requirements.
  • Install WebSphere Application Server Network Deployment Version 6.1 and the latest WebSphere Application Server fix pack.
  • Install WebSphere Extended Deployment Compute Grid Version 6.1 and the latest WebSphere Extended Deployment fix pack.
For more information, see Using the Update Installer to install maintenance packages .
[Version 6.1.0.5 and later] Avoid trouble: If your environment contains WebSphere® Application Server Network Deployment Version 7.0, you must install WebSphere Extended Deployment Version 6.1.0.5 before augmenting profiles to use with WebSphere Extended Deployment. Do not augment profiles to use with WebSphere Extended Deployment during the installation of Version 6.1.gotcha
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. The command file is located in the install_root/bin directory. For detailed help, use the -help parameter:
./manageprofiles.sh|bat -create -templatePath install_root/profileTemplates/wxdcg_augment/dmgr -help
Using the manageprofiles command, you can complete the following tasks:

Create a deployment manager profile

The following example creates a deployment manager profile:
./manageprofile.sh|bat -create -templatePath install_root/profileTemplates/wxdcg_augment/dmgr

Issue the following parameters:

-create
Creates a profile. (Required)
-templatePath template_path
Specifies the file path to the template. (Required)
Use the following format:
-templatePath install_root/profileTemplates/wxdcg_augment/dmgr
-profileName
Specifies the name of the profile. (Optional)
-profilePath
Specifies the intended location of the profile in the file system. (Optional)
-hostName
Specifies the host name of the profile. (Optional)
-nodeName
Specifies the node name of the profile. The name must be unique within the cell. (Optional)
-cellName
Specifies the cell name of the profile. The cell name must be unique for each profile. (Optional)
-isDefault
Designates the profile as the default target of commands that do not use a profile parameter. (Optional)
-omitAction
Omits optional features. (Optional)
-adminUserName
Specifies the valid username for use with administrative security. (Optional)
-adminPassword
Specifies the password that is used with the name specified with the -adminUserName parameter. (Optional)
-portsFile
Specifies the path to a file that defines port settings for the new profile. Do not use this parameter with the -startingPort or -defaultPorts parameters. (Optional)
-startingPort
Specifies the starting port number for generating all ports for the profile. Do not use this parameter with the -portsFile or -defaultPorts parameters. (Optional)
-defaultPorts
Accepts the default ports for the new profile. Do not use this parameter with the -portsFile or -startingPort parameters. (Optional)
-validatePorts
Specifies which ports to validate to ensure the ports are not already in use or reserved. (Optional)
-enableAdminSecurity
Enables administrative security for the profile. Specify the value as true. (Optional)
-winserviceCheck [For Windows operating system]
Creates a Windows service for the server process that is created within the profile. Specify the value as true . (Optional)
-winserviceAccountType [For Windows operating system]
Specifies the owner account of the Windows service. Valid types are specifieduser or localsystem. (Optional)
-winserviceUserName [For Windows operating system]
Specifies the user of the account for the Windows service. The -winserviceUserName parameter is used to verify the specified user as capable of creating a Windows service. (Optional)
-winservicePassword [For Windows operating system]
Specifies the password for the user or the local account that is to own the Windows service. (Optional)
-winserviceStartupType [For Windows operating system]
Valid types are manual, automatic, or disabled. (Optional)
-enableService [For Linux operating system]
Enables Linux service. Specify the value as true. (Optional)
-serviceUserName [For Linux operating system]
Specifies the name of the user to run the service as. (Optional)

Create a custom profile

The following example creates a custom profile:
./manageprofile.sh|bat -create -templatePath install_root/profileTemplates/wxdcg_augment/managed

Issue the following parameters:

-create
Creates a profile. (Required)
-templatePath template_path
Specifies the file path to the template. (Required)
Use the following format:
-templatePath install_root/profileTemplates/wxdcg_augment/managed
-profileName
Specifies the name of the profile. The parameter is optional, but is issued by default if no values are specified.
-profilePath
Specifies the intended location of the profile in the file system. The parameter is optional, but is issued by default if no values are specified.
-hostName
Specifies the host name of the profile. The parameter is optional, but is issued by default if no values are specified.
-nodeName
Specifies the node name of the profile. The name must be unique within the cell. The parameter is optional, but is issued by default if no values are specified.
-cellName
Specifies the cell name of the profile. The cell name must be unique for each profile. The parameter is optional, but is issued by default if no values are specified.
-federateLater
Federates the node at a later time. Specify the value as true. The parameter is optional, but is issued by default if no values are specified.
-dmgrHost
Specifies the workstation in which the deployment manager is running. The parameter is optional, but is issued by default if no values are specified.
-dmgrPort
Specifies the SOAP port of the deployment manager. The parameter is optional, but is issued by default if no values are specified.
-isDefault
Designates the profile as the default target of commands that do not use a profile parameter. (Optional)
-omitAction
Omits optional features. (Optional)
-portsFile
Specifies the path to a file that defines port settings for the new profile. Do not use this parameter with the -startingPort or -defaultPorts parameters. (Optional)
-dmgrAdminUserName
Specifies the username of the deployment manager that you want to federate to. (Optional)
-dmgrAdminPassword
Specifies the password for the deployment manager that you want to federate to. (Optional)

Create a stand-alone application server profile

The following example creates a stand-alone application server profile:
./manageprofile.sh|bat -create -templatePath install_root/profileTemplates/wxdcg_augment/default

Issue the following parameters:

-create
Creates a profile. (Required)
-templatePath template_path
Specifies the file path to the template. (Required)
Use the following format:
-templatePath install_root/profileTemplates/wxdcg_augment/default
-profileName
Specifies the name of the profile. The parameter is optional, but is issued by default if no values are specified.
-profilePath
Specifies the intended location of the profile in the file system. The parameter is optional, but is issued by default if no values are specified.
-hostName
Specifies the host name of the profile. The parameter is optional, but is issued by default if no values are specified.
-nodeName
Specifies the node name of the profile. The name must be unique within the cell. The parameter is optional, but is issued by default if no values are specified.
-cellName
Specifies the cell name of the profile. The cell name must be unique for each profile. The parameter is optional, but is issued by default if no values are specified.
-enableAdminSecurity
Enables administrative security for the profile. Specify the value as true. The parameter is optional, but is issued by default if no values are specified.
-winserviceCheck [For Windows operating system]
Creates a Windows service for the server process that is created within the profile. Specify the value as true . The parameter is optional, but is issued by default if no values are specified.
-winserviceAccountType [For Windows operating system]
Specifies the owner account of the Windows service. Valid types are specifieduser or localsystem. The parameter is optional, but is issued by default if no values are specified.
-winserviceUserName [For Windows operating system]
Specifies the user of the account for the Windows service, and is used to verify the specified user as capable of creating a Windows service. The parameter is optional, but is issued by default if no values are specified.
-winserviceStartupType [For Windows operating system]
Valid types are manual, automatic, or disabled. The parameter is optional, but is issued by default if no values are specified.
-enableService [For Linux operating system]
Enables Linux service. Specify the value as true. The parameter is optional, but is issued by default if no values are specified.
-webServerCheck
Creates a Web server definition. Specify the value as true. The parameter is optional, but is issued by default if no values are specified.
-webServerName
Specifies the name of the Web Server. The parameter is optional, but is issued by default if no values are specified.
-webServerHostname
Specifies the host name of the Web Server. The parameter is optional, but is issued by default if no values are specified.
-webServerPort
Specifies the port that the Web server runs on. The parameter is optional, but is issued by default if no values are specified.
-webServerInstallPath
Specifies the installation location of the Web server. The parameter is optional, but is issued by default if no values are specified.
-webServerPluginPath
Specifies the location of the plugin for the Web server. The parameter is optional, but is issued by default if no values are specified.
-isDefault
Designates the profile as the default target of commands that do not use a profile parameter. (Optional)
-omitAction
Omits optional features. (Optional)
-adminUserName
Specifies the valid username for use with administrative security. (Optional)
-adminPassword
Specifies the password that is used with the name specified with the -adminUserName parameter. (Optional)
-winservicePassword [For Windows operating system]
Specifies the password for the user or the local account that is to own the Windows service. (Optional)
-serviceUserName [For Linux operating system]
Specifies the name of the user to run the service as. (Optional)
-isDeveloperServer
Specifies that the default server is meant for development purposes only. (Optional)
-webServerType
Specifies the type of Web server to use. (Optional)
-webServerOS
Specifies the operating systems of the Web server. (Optional)
-portsFile
Specifies the path to a file that defines port settings for the new profile. Do not use this parameter with the -startingPort or -defaultPorts parameters. (Optional)
-startingPort
Specifies the starting port number for generating all ports for the profile. Do not use this parameter with the -portsFile or -defaultPorts parameters. (Optional)
-defaultPorts
Accepts the default ports for the new profile. Do not use this parameter with the -portsFile or -startingPort parameters. (Optional)
-validatePorts
Specifies which ports to validate to ensure the ports are not already in use or reserved. (Optional)

Create a cell profile

The following example creates a cell profile, which consists of a deployment manager and an application server:
./manageprofile.sh|bat -create -templatePath install_root/profileTemplates/wxdcg_augment/cell/dmgr -nodeProfilePath install_root/profiles/AppSrv01 -cellName cell01dmgr -nodeName node01dmgr -appServerNodeName node01

./manageprofile.sh|bat -create -templatePath install_root/profileTemplates/wxdcg_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

Issue the following parameters with the deployment manager template:

-create
Creates a profile. (Required)
-templatePath template_path
Specifies the file path to the template. (Required)
Use the following format:
-templatePath install_root/profileTemplates/wxdcg_augment/cell/dmgr
-profileName
Specifies the name of the profile. The parameter is optional, but is issued by default if no values are specified.
-profilePath
Specifies the intended location of the profile in the file system. The parameter is optional, but is issued by default if no values are specified.
-hostName
Specifies the host name of the profile. The parameter is optional, but is issued by default if no values are specified.
-nodeName
Specifies the node name of the profile. The name must be unique within the cell. The parameter is optional, but is issued by default if no values are specified.
-cellName
Specifies the cell name of the profile. The cell name must be unique for each profile. The parameter is optional, but is issued by default if no values are specified.
-appServerNodeName
Specifies the name of the application server for the node portion of the cell. The parameter is optional, but is issued by default if no values are specified.
-enableAdminSecurity
Enable administrative security for the profile. The parameter is optional, but is issued by default if no values are specified.
-winserviceCheck [For Windows operating system]
Creates a Windows service for the server process that is created within the profile. Specify the value as true . The parameter is optional, but is issued by default if no values are specified.
-winserviceAccountType [For Windows operating system]
Specifies the owner account of the Windows service. Valid types are specifieduser or localsystem. The parameter is optional, but is issued by default if no values are specified.
-winserviceUserName [For Windows operating system]
Specifies the user of the account for the Windows service, and is used to verify the specified user as capable of creating a Windows service. The parameter is optional, but is issued by default if no values are specified.
-winserviceStartupType [For Windows operating system]
Valid types are manual, automatic, or disabled. The parameter is optional, but is issued by default if no values are specified.
-enableService [For Linux operating system]
Enables Linux service. Specify the value as true. The parameter is optional, but is issued by default if no values are specified.
-webServerCheck
Creates a Web server definition. Specify the value as true. The parameter is optional, but is issued by default if no values are specified.
-webServerName
Specifies the name of the Web Server. The parameter is optional, but is issued by default if no values are specified.
-webServerHostname
Specifies the host name of the Web Server. The parameter is optional, but is issued by default if no values are specified.
-webServerPort
Specifies the port that the Web server runs on. The parameter is optional, but is issued by default if no values are specified.
-webServerInstallPath
Specifies the installation location of the Web server. The parameter is optional, but is issued by default if no values are specified.
-webServerPluginPath
Specifies the location of the plugin for the Web server. The parameter is optional, but is issued by default if no values are specified.
-isDefault
Designates the profile as the default target of commands that do not use a profile parameter. (Optional)
-omitAction
Omits optional features. (Optional)
-adminUserName
Specifies the valid username for use with administrative security. (Optional)
-adminPassword
Specifies the password that is used with the name specified with the -adminUserName parameter. (Optional)
-portsFile
Specifies the path to a file that defines port settings for the new profile. Do not use this parameter with the -startingPort or -defaultPorts parameters. (Optional)
-startingPort
Specifies the starting port number for generating all ports for the profile. Do not use this parameter with the -portsFile or -defaultPorts parameters. (Optional)
-defaultPorts
Accepts the default ports for the new profile. Do not use this parameter with the -portsFile or -startingPort parameters. (Optional)
-validatePorts
Specifies which ports to validate to ensure the ports are not already in use or reserved. (Optional)
-nodePortsFile
Specifies the path to a file that defines the port settings for the node portion of the cell. Do not use this parameter with the -nodeStartingPort or the -nodeDefaultPorts parameters. (Optional)
-nodeStartingPort
Specifies the starting port number for generating all ports for the node portion of the cell. Do not use this parameter with the -nodePortsFile or the -nodeDefaultPorts parameters. (Optional)
-nodeDefaultPorts
Accepts the default ports for the node portion of the cell. Do not use this parameter with the -nodePortsFile or the -nodeStartingPort parameters. (Optional)
-winservicePassword [For Windows operating system]
Specifies the password for the user or the local account that is to own the Windows service. (Optional)
-serviceUserName [For Linux operating system]
Specifies the name of the user to run the service as. (Optional)
-webServerType
Specifies the type of Web server to use. (Optional)
-webServerOS
Specifies the operating system of the Web server. (Optional)

Issue the following parameters with the application server template:

-create
Creates a profile. (Required)
-templatePath template_path
Specifies the file path to the template. (Required)
Use the following format:
-templatePath install_root/profileTemplates/wxdcg_augment/cell/default
-profileName
Specifies the name of the profile. The parameter is optional, but is issued by default if no values are specified.
-profilePath
Specifies the intended location of the profile in the file system. The parameter is optional, but is issued by default if no values are specified.
-hostName
Specifies the host name of the profile. The parameter is optional, but is issued by default if no values are specified.
-nodeName
Specifies the node name of the profile. The name must be unique within the cell. The parameter is optional, but is issued by default if no values are specified.
-cellName
Specifies the cell name of the profile. The cell name must be unique for each profile. The parameter is optional, but is issued by default if no values are specified.
-appServerNodeName
Specifies the name of the application server for the node portion of the cell. The parameter is optional, but is issued by default if no values are specified.
-enableAdminSecurity
Enable administrative security for the profile. The parameter is optional, but is issued by default if no values are specified.
-isDefault
Designates the profile as the default target of commands that do not use a profile parameter. (Optional)
-omitAction
Omits optional features. (Optional)
-adminUserName
Specifies the valid username for use with administrative security. (Optional)
-adminPassword
Specifies the password that is used with the name specified with the -adminUserName parameter. (Optional)
-portsFile
Specifies the path to a file that defines port settings for the new profile. Do not use this parameter with the -startingPort or -defaultPorts parameters. (Optional)
-startingPort
Specifies the starting port number for generating all ports for the profile. Do not use this parameter with the -portsFile or -defaultPorts parameters. (Optional)
-defaultPorts
Accepts the default ports for the new profile. Do not use this parameter with the -portsFile or -startingPort parameters. (Optional)
-validatePorts
Specifies which ports to validate to ensure the ports are not already in use or reserved. (Optional)
-nodePortsFile
Specifies the path to a file that defines the port settings for the node portion of the cell. Do not use this parameter with the -nodeStartingPort or the -nodeDefaultPorts parameters. (Optional)
-nodeStartingPort
Specifies the starting port number for generating all ports for the node portion of the cell. Do not use this parameter with the -nodePortsFile or the -nodeDefaultPorts parameters. (Optional)
-nodeDefaultPorts
Accepts the default ports for the node portion of the cell. Do not use this parameter with the -nodePortsFile or the -nodeStartingPort parameters. (Optional)



Related concepts
Non-root profile creation and augmentation
Related tasks
Creating profiles for multiple products
Creating profiles for use with other IBM products
Related reference
Using the manageprofiles command to augment and unaugment profiles
First steps console
Reference topic    

Terms of Use | Feedback

Last updated: Oct 30, 2009 6:21:02 PM EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1/index.jsp?topic=/com.ibm.websphere.gridmgr.doc/info/install/rinstallprofile_silent.html