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 Operations
Optimization Version 6.1 and the latest WebSphere
Extended Deployment fix pack.
For more information, see
Using the Update Installer to install maintenance packages
.
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/xd_augment/dmgr -help
Using the
manageprofiles command,
you can complete the following tasks:
Create a custom profile
The
following example creates a custom profile:
./manageprofile.sh|bat -create -templatePath install_root/profileTemplates/xd_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/xd_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/xd_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/xd_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
- 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
- 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
- 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
- Valid types are manual, automatic,
or disabled. The parameter is optional, but
is issued by default if no values are specified.
- -enableService
- 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
- Specifies the password for the user or the local account that
is to own the Windows service. (Optional)
- -serviceUserName
- 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/xd_augment/cell/dmgr -nodeProfilePath install_root/profiles/AppSrv01 -cellName cell01dmgr -nodeName node01dmgr -appServerNodeName node01
./manageprofile.sh|bat -create -templatePath install_root/profileTemplates/xd_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/xd_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
- 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
- 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
- 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
- Valid types are manual, automatic,
or disabled. The parameter is optional, but
is issued by default if no values are specified.
- -enableService
- 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
- Specifies the password for the user or the local account that
is to own the Windows service. (Optional)
- -serviceUserName
- 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/xd_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)