WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

manageprofiles parameters

You can use the following parameters with the manageprofiles command for WebSphere ESB.

Note: Do not use any parameters other than those mentioned in this topic when creating or augmenting a WebSphere ESB profile.

For some parameters listed below, for more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.

-augment
This indicates to the manageprofiles command line tool that you wish to augment an existing profile. Do not change this parameter if it is in your command line. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-ceiDbPwd userid password
If you are creating or augmenting a stand-alone profile and you chose to create a database for the Common Event Infrastructure Configuration other than Cloudscape, then change the corresponding value "MASKED_PARAMETER_VALUE" to the password you specified on the "Additional Database Configuration Information for Common Event Infrastructure" panel in the Profile Wizard for the user ID you had entered.
-ceiDbSysPwd userid password
If you are creating or augmenting a stand-alone profile and you chose to create an Oracle database for the Common Event Infrastructure Configuration, then change the corresponding value "MASKED_PARAMETER_VALUE" to the password you specified on the "Additional Database Configuration Information for Common Event Infrastructure" panel in the Profile Wizard for the user ID with SYSDBA authority you had entered.
-ceiSampleJmsPwd userid password
If you are creating or augmenting a stand alone profile then change the corresponding value "MASKED_PARAMETER_VALUE" to the password you specified on the "Common Event Infrastructure Configuration" panel in the Profile Wizard for the user ID you had entered.
-cellName cell_name
Specifies the cell name of the profile. Use a unique cell name for each profile. Use a unique name even though you plan to federate the custom profile or stand-alone profile into a deployment manager cell. Federation requires unique cell names before it can make the node part of the deployment manager cell. A cell name must be unique in any circumstance in which the product is running on the same physical machine or cluster of machines (such as a sysplex). Additionally, a cell name must be unique in any circumstance in which network connectivity between entities is required either between the cells or from a client that must communicate with each of the cells. Cell names also must be unique if their name spaces are going to be federated. Otherwise, you might encounter symptoms such as a javax.naming.NameNotFoundException, in which case, you will need to create uniquely named cells. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-create
This indicates to the mangeprofiles command line tool that you wish to create a new profile. Do not change this parameter if it is in your command line. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-dbPassword userid password
If you entered a user ID and password value on the "Additional Database Configuration Information" panel then change the corresponding value "MASKED_PARAMETER_VALUE" to the password you specified for the user ID you entered on that panel.
-dmgrHost host_name
Identifies the machine where the deployment manager is running. Specify this parameter and the dmgrPort parameter to federate a custom profile as it is created.

The host name can be the long or short DNS name or the IP address of the deployment manager machine.

Specifying this optional parameter directs the manageprofiles command to attempt to federate the custom node into the deployment manager cell as it creates the custom profile. This parameter is ignored when creating a deployment manager profile or an Application Server profile.

Federating when the deployment manager is not available

If you federate a custom node when the deployment manager is not running or is not available because of security being enabled or for other reasons, the installation indicator in the logs is INSTCONFFAIL to indicate a complete failure. The resulting custom profile is unusable. You must move the custom profile directory out of the profile repository (the profiles installation root directory) before creating another custom profile with the same profile name.

If you have enabled security or changed the default JMX connector type, you cannot federate with the wasprofile command. Use the addNode command instead. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.

-dmgrPort port_number
Identifies the SOAP port of the deployment manager. Specify this parameter and the dmgrHost parameter to federate a custom profile as it is created. The deployment manager must be running and accessible. If you have enabled security or changed the default JMX connector type, you cannot federate with the wasprofile command. Use the addNode command instead. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-federateLater true | false
If this is set to "true" a custom profile on a create will not be federated to the deployment manager even if -dmgrPort and -dmgrHost are specified. If it is set to "false" then both -dmgrPort and -dmgrHost must be specified. Currently the Profile Wizard will record -federateLater to the command line as "true" even if you specify to federate the profile to federate on create. You can manually change this to "false" in the command line.
-hostName host_name
Specifies the host name where you are creating the profile. This should match the host name that you specified during installation of the initial product. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-mqPwd userid password
If you are creating or augmenting a stand-alone profile and chose to configure a sample Business Process Choreographer, then change the corresponding value "MASKED_PARAMETER_VALUE" to the password you specified on the "Business Process Choreographer Configuration" panel in the Profile Wizard for the user ID you had entered.
-nodeName node_name
Specifies the node name for the node that is created with the new profile. Use a unique value within the cell or on the machine. Each profile that shares the same set of product binaries must have a unique node name. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-portsFile file_path
An optional parameter that specifies the path to a file that defines port settings for the new profile. When omitted, the wasprofile tool looks for the install_root /profileTemplates/profile_type /actions/portsUpdate/bin/portdef.props file. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-profileName profile_name
Profile name is the unique identifier for a given profile. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-profilePath profile_path

For Windows platforms Specify the full path to avoid an ANT scripting limitation that can cause a failure when federating the profile into a cell. For example: -profilePath C:\IBM\WebSphere\AppServer\profiles\profile01

For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
scaSecurityPassword userid password
If you are creating or augmenting a stand alone profile and chose to configure the Service Integration Bus in a secured mode, then change the corresponding value "MASKED_PARAMETER_VALUE" to the password you specified on the "Service Component Architecture configuration" panel in the Profile Wizard for the user ID you had entered.
-startingPort startingPort
You must add to your command line either -startingPoint or -portsFile. This parameter specifies the starting port number for generating all ports for the profile. If not specified, the command uses default ports specified in the serverindex.xml file. Do not use this parameter with the -portsFile parameter. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-templatePath template_path
Specifies the directory path to the template files in the installation root directory. Change the value of template_path only if you are creating or augmenting a profile for a different WebSphere Process Server installation. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.
-winservicePassword userid password
This is a password value that will have been masked out. If you are running on Microsoft Windows and your command line has the parameter value for "true" for the parameter name -winserviceCheck, then change the corresponding value "MASKED_PARAMETER_VALUE" to the password you specified in the Profile Wizard for the user or the local account that is to own the Windows service. For more information, refer to the description of the parameter of the same name in the documentation for the wasprofile command in the WebSphere Application Server information center.

Reference topic

Terms of Use | Rate this page

Timestamp iconLast updated: 13 Dec 2005
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc\doc\rins_manageprofiles_parms.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)