The wasprofile command line tool creates all Application Server runtime environments in Version 6. The command creates a profile, which is the set of files that define the runtime environment for a stand-alone application server.
You can also use the profile creation tool graphical user interface to create and manage profiles.
The wasprofile command creates the runtime environment for a WebSphere Application Server process in a set of files called a profile. The profile defines the runtime environment and includes all of the files that the server processes in the runtime environment can change.
The profile creation tool and its graphical user interface, the Profile creation wizard, are the only ways to create runtime environments in V6.
The Profile creation wizard is an InstallShield for Multiplatforms (ISMP) application. You can use the wizard to enter most of the parameters that are described in this topic. Some parameters, however, require you to use the wasprofile command. You must use the wasprofile command to delete a profile, for instance, because the Profile creation wizard does not provide a deletion function.
However, the Profile creation wizard also performs tasks that the wasprofile command does not. For instance, the wizard can create a Windows service for each profile that it creates. It can also assign non-conflicting ports based on previous Version 6 port assignments.
The command file is located in the app_server_root/bin directory.
The Profile creation wizard is the graphical user interface to the command line tool. The file name of the command that calls the Profile creation wizard varies per operating system platform. See Creating profiles using the graphical user interface for more information.
The wasprofile command creates a log for every profile that it creates. The logs are in the app_server_root/logs/wasprofile directory. The files are named in this pattern: profile_name_create.log.
The command also creates a log for every profile that it deletes. The logs are in the app_server_root/logs/wasprofile directory. The files are named in this pattern: profile_name_delete.log.
The length of the wasprofile command cannot exceed the normal shell window limit for one line of 256 characters. If your command is longer than the limit, issue the command on multiple lines by ending a line with a backward slash, pressing Enter, and continuing the command on the next line.
./wasprofile.sh \ -create -profileName bladetcb6profile \ -profilePath /usr/IBM/WebSphere/AppServer/profiles/bladetcb6profile \ -templatePath /usr/WebSphere/AppServer/profileTemplates/default \ -nodeName bladetcb6node \ -cellName bladetcb6Cell \ -hostName bladetcb6.rtp.raleigh.ibm.com
Omit the line continuation character from the last line to signal the end of the command to the operating system.
# ./wasprofile.sh -help # ./wasprofile.sh -augment -help # ./wasprofile.sh -create -help # ./wasprofile.sh -create -templatePath fully_qualified_path/dmgr -help # ./wasprofile.sh -create -templatePath fully_qualified_path/default -help # ./wasprofile.sh -create -templatePath fully_qualified_path/managed -help # ./wasprofile.sh -delete -help # ./wasprofile.sh -getName -help # ./wasprofile.sh -getPath -help # ./wasprofile.sh -unaugment -help # ./wasprofile.sh -validateRegistry -help # ./wasprofile.sh -validateAndUpdateRegistry -help
# ./wasprofile.sh -listProfiles [-debug]
# ./wasprofile.sh -delete -profileName profile_name
# ./wasprofile.sh -create -profileName profile_name -profilePath fully_qualified_profile_path -templatePath template_path -nodeName node_name -cellName cell_name -hostName host_name [-isDefault] [-startingPort starting_port | -portsFile file_path] [-debug]
# ./wasprofile.sh -getName -profilePath profile_path [-debug]
# ./wasprofile.sh -getPath -profileName profile_name [-debug]
# ./wasprofile.sh -validateRegistry [-debug]
# ./wasprofile.sh -validateAndUpdateRegistry [-backup file_name] [-debug]
# ./wasprofile.sh -augment -profileName profile_name -templatePath fully_qualified_template_path
# ./wasprofile.sh -unaugment -profileName profile_name
# ./wasprofile.bat -help # ./wasprofile.bat -augment -help # ./wasprofile.bat -create -help # ./wasprofile.bat -create -templatePath fully_qualified_path\dmgr -help # ./wasprofile.bat -create -templatePath fully_qualified_path\default -help # ./wasprofile.bat -create -templatePath fully_qualified_path\managed -help # ./wasprofile.bat -delete -help # ./wasprofile.bat -getName -help # ./wasprofile.bat -getPath -help # ./wasprofile.bat -unaugment -help # ./wasprofile.bat -validateRegistry -help # ./wasprofile.bat -validateAndUpdateRegistry -help
# ./wasprofile.bat -listProfiles [-debug]
# ./wasprofile.bat -delete -profileName profile_name | -profilePath profile_path [-debug]
# ./wasprofile.bat -create -profileName profile_name -profilePath fully_qualified_profile_path -templatePath template_path -nodeName node_name [-cellName cell_name] -hostName host_name [-isDefault] [-startingPort starting_port | -portsFile file_path] [-winserviceCheck true | false] [-winserviceAccountType specified_user | localsystem] [-winserviceUserName your_user_name] [-winservicePassword your_password] [-winserviceStartupType manual | automatic | disabled] [-debug]
When the -startingPort parameter is not used, the profile creation tool uses the default port settings specified in the serverindex.xml file.
# ./wasprofile.bat -getName -profilePath fully_qualified_profile_path [-debug]
# ./wasprofile.bat -getPath -profileName profile_name [-debug]
# ./wasprofile.bat -validateRegistry [-debug]
# ./wasprofile.bat -validateAndUpdateRegistry [-backup file_name] [-debug]
# ./wasprofile.bat -augment -profileName profile_name -templatePath fully_qualified_template_path
# ./wasprofile.bat -unaugment -profileName profile_name
For specific examples of creating a profile, see the Example: Using commands to create profiles section.
When the augment action is invoked, the wasprofile command attempts to access the actionRegistry.xml file in the specified template path. The operations defined in the Config Actions stanza in the action registry file are then applied against the specified profile.
Specify the fully qualified file path for -templatePath. Specifying a relative file path for the -templatePath parameter results in the specified profile not being fully augmented.
See also the unaugment parameter.
This is an optional parameter for WebSphere Application Server - Express.
If you omit the parameter, a default cell name is assigned.
Unaugment any augmentations that you have made before deleting the profile.
You can delete or leave the directory. However, the profile_dir/logs directory contains information about uninstalling the profile. For example, you might retain the _nodeuninst.log file to determine the cause of any problem during the uninstall procedure.
The delete parameter does not perform an unaugment automatically. You must perform an unaugment manually before deleting the profile.
Do not use this parameter when using the -startingPort parameter.
If the fully qualified path contains spaces, enclose
the value in quotation marks.
Do not use this parameter with the -portsFile parameter.
Within the profileTemplates directory are various directories that correspond to different profile types and that vary with the type of product installed.
The profile directories are the paths that you indicate while using the -templatePath option.
You can specify profile templates that lie outside the installation root, if you happen to have any.
If you specify a relative path, the specified template location defaults to the app_server_root/profileTemplates directory.
For example, the following paired specifications each point to the same template path:
-templatePath /usr/WebSphere/AppServer/profileTemplates/default
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/default
-templatePath C:\Program Files\IBM\WebSphere\AppServer\profileTemplates\default
When the unaugment action is invoked, wasprofile attempts to access the deleteRegistry.xml file in the template path that was specified in the augment command. The operations defined in the Config Actions stanza in the delete registry file are then applied against the specified profile.
See also the augment parameter.
Use cases are a description of common tasks for which the tool is used.
wasprofile.sh -delete
-profileName shasti
When you use the wasprofile tool without the -startingPort parameter, the tool uses the app_server_root/profileTemplates/profile_type/actions/portsUpdate/portdef.props file to set the initial ports.
wasprofile.bat -create -profileName Wow_Profile -profilePath profile_root -templatePath app_server_root\profileTemplates\default -nodeName Wow_node -cellName Wow_cell -hostName lorriemb -portsFile C:\temp\ports\portdef.props
WC_defaulthost=39080 WC_adminhost=39060 WC_defaulthost_secure=39443 WC_adminhost_secure=39043 BOOTSTRAP_ADDRESS=32809 SOAP_CONNECTOR_ADDRESS=38880 SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401 CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403 CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402 ORB_LISTENER_ADDRESS=39100 DCS_UNICAST_ADDRESS=39353 SIB_ENDPOINT_ADDRESS=37276 SIB_ENDPOINT_SECURE_ADDRESS=37286 SIB_MQ_ENDPOINT_ADDRESS=35558 SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
<?xml version="1.0" encoding="UTF-8"?> <serverindex:ServerIndex xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" ... <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="BOOTSTRAP_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="32809"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SOAP_CONNECTOR_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="38880"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SAS_SSL_SERVERAUTH_LISTENER_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39401"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39403"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39402"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="WC_adminhost"> <endPoint xmi:id="EndPoint_..." host="*" port="39060"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="WC_defaulthost"> <endPoint xmi:id="EndPoint_..." host="*" port="39080"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="DCS_UNICAST_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39353"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="WC_adminhost_secure"> <endPoint xmi:id="EndPoint_..." host="*" port="39043"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="WC_defaulthost_secure"> <endPoint xmi:id="EndPoint_..." host="*" port="39443"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SIB_ENDPOINT_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="*" port="37276"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SIB_ENDPOINT_SECURE_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="*" port="37286"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SIB_MQ_ENDPOINT_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="*" port="35558"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="SIB_MQ_ENDPOINT_SECURE_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="*" port="35578"/> </specialEndpoints> <specialEndpoints xmi:id="NamedEndPoint_..." endPointName="ORB_LISTENER_ADDRESS"> <endPoint xmi:id="EndPoint_..." host="lorriemb" port="39100"/> </specialEndpoints> </serverEntries> </serverindex:ServerIndex>
The wasprofile command creates a copy of the current portdefs.props file in the profile_root\logs directory.
Do not use the portsFile parameter when using the startingPort parameter. The two parameters are mutually exclusive.
The wasprofile command can assign port numbers based on a starting port value that you give on the command line, using the -startingPort parameter. The tool assigns port numbers sequentially from the starting port number value.
The order of port assignments is arbitrary. Predicting assignments is not possible.
For example, ports created with -startingPort 20002 would appear similar to the following example:
Assigned ports for an Application Server profile
WC_defaulthost=20002 WC_adminhost=20003 WC_defaulthost_secure=20004 WC_adminhost_secure=20005 BOOTSTRAP_ADDRESS=20006 SOAP_CONNECTOR_ADDRESS=20007 SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20008 CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20009 CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20010 ORB_LISTENER_ADDRESS=20011 DCS_UNICAST_ADDRESS=20012 SIB_ENDPOINT_ADDRESS=20013 SIB_ENDPOINT_SECURE_ADDRESS=20014 SIB_MQ_ENDPOINT_ADDRESS=20015 SIB_MQ_ENDPOINT_SECURE_ADDRESS=20016
wasprofile.bat -create -profileName shasti -profilePath profile_root -templatePath template_path -nodeName W2K03 -cellName W2K03_Cell01 -hostName planetnt -startingPort 20002
The following examples show how to create profiles using the wasprofile command.
Issue the command in any of the following examples on one line. Each example shows the command on more than one line to increase clarity.
Create an application server profile named Default01 with the following command:
app_server_root\bin wasprofile -create -profileName Default01 -profilePath profile_root -templatePath app_server_root\profileTemplates\default -nodeName Default01Node -cellName Default01Cell -hostName myhost.mycity.mycompany.com -isDefault false -winserviceCheck true -winserviceAccountType user -winserviceUserName my_user_id -winservicePassword my_password -winserviceStartupType manual -startingPort 21000
app_server_root/bin/wasprofile.sh -create -profileName Default01 -profilePath profile_root -templatePath app_server_root/profileTemplates/default -nodeName Default01Node -cellName Default01Cell -hostName myhost.mycity.mycompany.com -isDefault -startingPort 21000