[AIX HP-UX Linux Solaris Windows]

install command

The install command installs the product and most of the components in the product. When you install the product, the installer program installs the core product files and creates zero, one, or two profiles, depending on the product that you are installing and your installation selections. A silent parameter runs the Installation wizard in silent mode without displaying the graphical user interface.

Purpose

This topic describes the command-line syntax for the install command. Start the install command module from the command line to install the product.

Before you begin installing the product

Prepare the operating system for installation. Follow the procedure in Task overview: Installing to get started.

The command file resides in the root directory of the component on the product disk.

In an effort to simplify your task environment, WebSphere Application Server has adopted a common install engine for WebSphere software components in the Version 6.1 product package. The install command starts the installation program in almost all components in the product package:
  • [AIX] [HP-UX] [Linux] [Solaris] install
  • [Windows] install.exe
  • [Windows] Edge Components only: setup
Avoid trouble Avoid trouble: If you use uniform naming conventions (UNC) to identify file paths in your install command, the items you anticipate installing may not all be installed after the command runs. To guard against this possibility, you should first map the file path to a drive, then run the install command against that mapped drive. This will ensure that all the items are installed.gotcha

If the command or an alternative command is not applicable for a component on a particular operating system, the N/A abbreviation is displayed in the following table. A command is not applicable if the component cannot be installed on the operating system.

Table 1. . Component installation commands by operating system
Operating System WebSphere Application Server Application Client IBM HTTP Server Web Server Plug-ins Application Server Toolkit Edge Components Update Installer (UPDI)
AIX install install install install N/A install install
HP-UX install install install install N/A install install
Linux install install install install install install install
Solaris install install install install N/A install install
Windows install install install install install setup install
Note: Edge Components historically use native operating system installer tools instead of the common installation engine. The new Version 6.1 ISMP install wrapper surrounds the native installer packages, except for Windows systems, where the setup command must be used. Native commands that you can use to install the Edge Components include:
Table 2.
Operating System Installation command
AIX pkgadd -d ./packagename
HP-UX installp -acXd ./packagename
Linux rpm -i ./packagename
Solaris swinstall -s ./packagename
Windows setup

Parameters and syntax

This section describes the command that starts the Installation wizard.
  • Issue the install command to start the Installation wizard and display the graphical user interface:
    component_disc_directory/install
    
  • Issue the install -silent command to start the Installation wizard in silent mode, without the graphical user interface:
    component_disc_directory/install -options "response_file_name" -silent

Use the following install command options to install a new installation, add a feature to an existing installation, or configure an existing WebSphere Application Server Network Deployment product by creating a profile.

Use the following table to determine valid values for each option.
Table 3. Install command option values table
Option Name (-OPT) WebSphere Application Server Network Deployment
Values Default
allowNonRootSilentInstall "true | false" "false"
feature "noFeature | samplesSelected" "samplesSelected"
installLocation Any valid directory path app_server_root directories for root and non-root installers
installType "installNew | addFeature | createProfile" "installNew"
profileType "standAlone" | "deploymentManager" | "cell" | "custom" | "none" "none"
silentInstallLicenseAcceptance "true | false" "false"
traceFormat ALL | text | XML Commented
traceLevel OFF | SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST Commented
PROF_adminUserName Any valid user ID. "ADMIN_USER_NAME"
PROF_adminPassword Any valid user password. "ADMIN_PASSWORD"
PROF_appServerProfileName A valid profile name Commented
PROF_appServerNodeName A string with valid characters Commented
PROF_cellName A string with valid characters Commented
PROF_defaultPorts Commented | Uncommented Commented
PROF_dmgrAdminPassword Valid deployment manager administrative user password Commented
PROF_dmgrAdminUserName Valid deployment manager administrative user name Commented
PROF_dmgrHost Host name of the deployment manager Commented
PROF_dmgrPort SOAP port of the deployment manager Commented
PROF_dmgrProfileName A valid profile name Commented
PROF_enableAdminSecurity "true | false" "true"
PROF_hostName Any valid host name. Commented
PROF_isDefault Commented | Uncommented Commented
PROF_nodeName Any valid and unique node name. Commented
PROF_nodeOmitAction Valid name of a configuration action for the cell Commented
PROF_omitAction Name of a configuration action. Commented
PROF_portsFile Any valid file path to a valid ports file. Commented
PROF_profileName Any valid profile name string. Commented
PROF_profilePath Any valid file path. See the description of profile_root in Directory conventions for default values. Commented
PROF_serverName Any application server name, such as server1. Commented
PROF_startingPort Any valid port number. Commented
PROF_validatePorts Commented | Uncommented Commented
PROF_webServerCheck "true | false" Commented
PROF_webServerHostname A valid host name of the system with the Web server. Commented
PROF_webServerInstallPath Any valid directory path to the Web server. Commented
PROF_webServerName A valid name of a valid Web server. Commented
PROF_webServerOS linux | windows | aix | hp | solaris | os390 | i5os Commented
PROF_webServerPluginPath Any valid directory path to the Web server plug-ins. Commented
PROF_webServerPort A valid port to access the Web server. Commented
PROF_webServerType IHS | IIS | SUNJAVASYSTEM | DOMINO | APACHE | HTTPSERVER_ZOS Commented
PROF_winserviceAccountType specified user | localsystem Commented
PROF_winserviceCheck "true | false" Commented
PROF_winserviceStartupType manual | automatic | disabled Commented
PROF_winservicePassword The password of the valid specified user Commented
PROF_winserviceUserName The name of the valid specified user Commented

See the following descriptions for more information about each option.

Option descriptions

Use the following information to learn the purpose of an option and to determine which options to use for profile creation.
allowNonRootSilentInstall
Change this option to "true" to allow a non-root or non-administrator installer ID to install the product. A "true" value indicates that you accept the limitations associated with installing as a non-root user. If the value is "false", a non-root user cannot install the product.

See Limitations of non-root installers for more information.

feature
Change the selection state of the Application Server Samples" feature.
Valid values are:
samplesSelected
Indicates that the feature is selected for installation.
noFeature
Indicates that the feature is not selected for installation.
installLocation

Change the installation location of the product. Specify any valid directory.

[Windows] Enclose directory names with spaces in double-quotes.

The default values vary per operating system. Separate default locations exist for non-administrator or non-root installer IDs. See the description of app_server_root directories for root and non-root installers in Directory conventions.

installType

Change the installType option to control the type of installation. The default is to install a new copy of WebSphere Application Server. Each operation type requires a separate invocation of the install command.

Valid values include:
installNew
This default value installs a new copy of the core product files.
addFeature
Adds features to an existing installation in an incremental installation.

Each WebSphere Application Server Version 6.1 product has just one feature.

For components that have more than one feature, set the option for each feature. If a feature is already installed, set the feature option to false. To install a new feature, set the feature to true.

createProfile
Create a profile in an existing installation.

Set the installLocation option to your existing installation root directory.

Set the profileType option to the type of profile that you require.

Set the appropriate profile options for the type of profile that you are creating. Profile options are described by profile type in a later section in this topic.

profileType
Indicate the type of profile to create.
Valid values include:
Application Server
Create a stand-alone application server profile.
Deployment Manager
Create a deployment manager profile.
Cell
Create a cell with two profiles: a deployment manager and an application server node that is already federated into the deployment manager cell.
Custom
Create a profile with an empty node.

You must federate this node to use it.

None
Do not create a profile.
silentInstallLicenseAcceptance
By changing the silentInstallLicenseAcceptance property in a silent response file to "true", you agree that you have reviewed and agree to the terms of the IBM International Program License Agreement accompanying the program, which is located in the mount point or disc_drive/WAS/lafiles directory.

If you do not agree to these terms, do not change the value or otherwise download, install, copy, access, or use the program and promptly return the program and proof of entitlement to the party from whom you acquired it to obtain a refund of the amount you paid.

traceFormat
Control the trace file output.
traceLevel
Control the amount of trace information collected.
PROF_adminPassword
Select the password for the administrative user ID.

Set the PROF_enableAdminSecurity option to true to use this option.

Table 4. PROF_adminPassword applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_adminUserName
Select the administrative user ID.

Set the PROF_enableAdminSecurity option to true to use this option.

Table 5. PROF_adminUserName applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
Important: Write down the user name and password. You cannot log onto the administrative console without it. You cannot use WebSphere Application Server at all unless you know the ID and password.
PROF_appServerNodeName
Specify a unique node name for the federated application server profile.
Table 6. PROF_appServerNodeName applicability
Cell Deployment Manager Application Server Custom
Yes No No No

The node name must be unique within the WebSphere Application Server environment.

PROF_appServerProfileName
Specify the profile name for the federated application server.
Table 7. PROF_appServerProfileName applicability
Cell Deployment Manager Application Server Custom
Yes No No No

The profile name must be unique for this WebSphere Application Server installation and the cell to which it belongs.

Valid values are a string with valid characters.

PROF_cellName
Specify a unique cell name for the profile.
Table 8. PROF_cellName applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes Yes

The cell name must be unique within the WebSphere Application Server environment.

Even though you might plan to federate a stand-alone application server at some time, specify a unique cell name for the profile that is not the cell name of the deployment manager.

PROF_defaultPorts
Uncomment the option to use the default WebSphere Application Server port settings.

Do not use this parameter with the PROF_portsFile option or the PROF_startingPort option.

Table 9. PROF_defaultPorts applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_dmgrAdminPassword
If administrative security is enabled in the deployment manager that is to federate the custom profile, specify the administrative user password of the deployment manager.
Table 10. PROF_dmgrAdminPassword applicability
Cell Deployment Manager Application Server Custom
No No No Yes
PROF_dmgrAdminUserName
If administrative security is enabled in the deployment manager that is to federate the custom profile, specify the administrative user ID of the deployment manager.
Table 11. PROF_dmgrAdminUserName applicability
Cell Deployment Manager Application Server Custom
No No No Yes
PROF_dmgrHost
Specify the host name of the machine of the deployment manager that is to federate the custom profile.
Table 12. PROF_dmgrHost applicability
Cell Deployment Manager Application Server Custom
No No No Yes
PROF_dmgrPort
Specify the SOAP port of the deployment manager that is to federate the custom profile.
Table 13. PROF_dmgrPort applicability
Cell Deployment Manager Application Server Custom
No No No Yes
PROF_dmgrProfileName
Specify the name of the profile for the deployment manager profile that is part of the cell profile.

The profile name must be unique for this WebSphere Application Server installation and cell.

Valid values are a string with valid characters.

Table 14. PROF_dmgrProfileName applicability
Cell Deployment Manager Application Server Custom
Yes No No No
PROF_enableAdminSecurity
Choose whether to enable administrative security during the installation process.

Set the createProfile option to true.

Set the installLocation option to your existing installation root directory.

Set the profileType option.

Set other appropriate profile options (PROF_ options) for your type of profile.

If profileType="custom" or profileType="none", set this option to false.

Valid values are:
true
Administrative security is enabled. You must specify a user name and a password.
Important: Write down the user name and password. You cannot log onto the administrative console without it. You cannot use WebSphere Application Server at all unless you know the ID and password.
false
Administrative security is not enabled.
Table 15. PROF_enableAdminSecurity applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes Yes
PROF_hostName
Specify the host name of the machine where the profile is to reside.
Table 16. PROF_hostName applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes Yes

The host name is the domain name system (DNS) name (short or long) or the IP address of this computer.

PROF_isDefault
Set a default profile.
Table 17. PROF_isDefault applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes Yes

The default profile is the default target for commands issued against an anonymous profile, such as commands issued from the app_server_root/bin directory.

Issuing a command from the bin directory of another profile sets the command window to address the other profile, and not the default profile. Opening a new command window targets anonymous commands to the default profile again.

PROF_nodeName
Specify a unique node name for the profile.
Table 18. PROF_nodeName applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes Yes

The node name must be unique within the WebSphere Application Server environment.

PROF_nodeOmitAction
Omit the specified configuration action for the cell node.
Table 19. PROF_nodeOmitAction applicability
Cell Deployment Manager Application Server Custom
Yes No No No
PROF_omitAction
Omit the specified configuration action.
Table 20. PROF_omitAction applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_portsFile
Specify the path to a property file containing the desired port values.

Valid values are a valid file path default WebSphere Application Server port settings.

Do not use this parameter with the PROF_defaultPorts option or the PROF_startingPort option.

Table 21. PROF_portsFile applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_profileName
Set the profile name.
Table 22. PROF_profileName applicability
Cell Deployment Manager Application Server Custom
No Yes Yes Yes

Specify the name of the profile. The profile name must be unique for this WebSphere Application Server installation or for the cell to which it might belong at some time.

Valid values are a string with valid characters.

PROF_profilePath
Specify the fully qualified file path to the profile_root directory.
Table 23. PROF_profilePath applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes Yes

Specify a valid directory to contain the files that define the run-time profile environment, such as commands, configuration files, and log files.

[Windows] If the directory contains spaces, enclose the path in double-quotes.

Valid values are a valid directory path.

PROF_serverName
Specify the server name for the stand-alone application server profile, for the deployment manager, or for the federated application server that is part of the cell profile.
Table 24. PROF_serverName applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No

Each stand-alone application server profile or each federated application server profile can have a server named server1, for example. Server names have to be unique within a profile, but not within a cell or within an installation.

PROF_startingPort
Specify the starting port number for generating all ports for the profile. If not specified, the profile uses default ports specified in the serverindex.xml file.

Do not use this parameter with the PROF_portsFile option.

Table 25. PROF_startingPort applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_validatePorts
Uncomment the option to validate that no conflicts exist within the selected ports.
Table 26. PROF_validatePorts applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_webServerCheck
Specify whether you wish to define a Web server definition.
Table 27. PROF_webServerCheck applicability
Cell Deployment Manager Application Server Custom
Yes No Yes No
PROF_webServerHostname
Specify the host name of the system with the Web server.

Requires the PROF_webServerCheck option.

Table 28. PROF_webServerHostname applicability
Cell Deployment Manager Application Server Custom
Yes No Yes No
PROF_webServerInstallPath
Specify the local or remote installation path of the Web server.

Requires the PROF_webServerCheck option.

Table 29. PROF_webServerInstallPath applicability
Cell Deployment Manager Application Server Custom
Yes No Yes No
PROF_webServerName
Specify the name of the Web server.

Requires the PROF_webServerCheck option.

Table 30. PROF_webServerName applicability
Cell Deployment Manager Application Server Custom
Yes No Yes No
PROF_webServerOS
Specify the operating system of the system where the Web server runs.

Requires the PROF_webServerCheck option.

Table 31. PROF_webServerOS applicability
Cell Deployment Manager Application Server Custom
Yes No Yes No
PROF_webServerPluginPath
Specify the path to the Web server plug-in for the Web server.

Requires the PROF_webServerCheck option.

Table 32. PROF_webServerPluginPath applicability
Cell Deployment Manager Application Server Custom
Yes No Yes No
PROF_webServerPort
Specify the access port of the Web server, such as port 80.

Requires the PROF_webServerCheck option.

Table 33. PROF_webServerPort applicability
Cell Deployment Manager Application Server Custom
Yes No Yes No
PROF_webServerType
Specify the type of web server.

Requires the PROF_webServerCheck option.

Table 34. PROF_webServerType applicability
Cell Deployment Manager Application Server Custom
Yes No Yes No
PROF_winserviceAccountType
Specify the type of windows service to create.

Requires the PROF_winserviceCheck option.

Table 35. PROF_winserviceAccountType applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_winserviceCheck
Choose whether to run the server process as a Windows service.
Table 36. PROF_winserviceCheck applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_winserviceStartupType
Specify the start up method for the windows service.

Requires the PROF_winserviceCheck option.

Table 37. PROF_winserviceStartupType applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_PROF_winservicePassword
Specify the password for the windows service.

Requires the PROF_winserviceCheck option.

Table 38. PROF_PROF_winservicePassword applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No
PROF_PROF_winserviceUserName
Specify the user name for the windows service.

Requires the PROF_winserviceCheck option.

Table 39. PROF_PROF_winserviceUserName applicability
Cell Deployment Manager Application Server Custom
Yes Yes Yes No

Example

Install WebSphere Application Server Network Deployment with the Installation wizard user interface
install

See Installing the product and additional software for more information about installing with the Installation wizard.

Install WebSphere Application Server Network Deployment from the command line
install -options /tmp/was/my_response_file.txt -silent
Contents of /tmp/was/my_response_file.txt

-OPT allowNonRootSilentInstall="false"
-OPT feature="samplesSelected"
-OPT installLocation="app_server_root"
-OPT installType="installNew"
-OPT silentInstallLicenseAcceptance="true"
-OPT traceFormat=ALL
-OPT traceLevel=INFO

Create a cell profile from the command line
install -options /tmp/was/my_response_file2.txt -silent
Contents of /tmp/was/my_response_file2.txt

-OPT allowNonRootSilentInstall="false"
-OPT installLocation="app_server_root"
-OPT installType="createProfile"
-OPT profileType="cell"
-OPT silentInstallLicenseAcceptance="true"
-OPT traceFormat=ALL
-OPT traceLevel=INFO
-OPT PROF_appServerNodeName="cellappnode01"
-OPT PROF_appServerProfileName="cellapp01"
-OPT PROF_cellName="dmgrcell01"
-OPT PROF_defaultPorts=
-OPT PROF_dmgrProfileName="dmgr01"
-OPT PROF_enableAdminSecurity="false"
-OPT PROF_hostName="5.55.555.555"
-OPT PROF_isDefault=
-OPT PROF_nodeName="dmgrnode"
-OPT PROF_profilePath="profile_root"
-OPT PROF_serverName="server01"
-OPT PROF_validatePorts=
-OPT PROF_webServerCheck="true"
-OPT PROF_webServerHostname="5.55.555.555"
-OPT PROF_webServerInstallPath="Web_server_root"
-OPT PROF_webServerName="IHS01"
-OPT PROF_webServerOS="linux"
-OPT PROF_webServerPluginPath="plugins_root"
-OPT PROF_webServerPort="80"
-OPT PROF_webServerType="IHS"

See Installing silently for more information about using the installation wizard in silent mode, without the graphical user interface.

Logging

Examine the app_server_root/logs/install/log.txt file to verify that there were no file system or other unusual errors while installing. If there are problems, correct them, and reinstall the product.

WebSphere Application Server uses return codes to indicate the results of an installation operation:
0
Success
1
Failed
2
Partial success
3
Reserved
4
License not accepted
5
PrereqCheck failed
6
Reserved

Return codes are in use in the following components on the following operating systems.

Table 40. Return codes
Operating System WebSphere Application Server Application Client IBM HTTP Server Web Server Plug-ins Application Server Toolkit Edge Components Update Installer (UPDI)
Operating system such as AIX or Linux Yes Yes Yes Yes Yes Yes Yes

[Windows] ISMP does not set exit codes on Windows due to a limitation. Consult the install log to determine success or failure.

The exit codes for the Application Client are different than the Version 6.0 exit codes, which are “1=success” and “0=failure”.

Partial success means that some portion of the installation failed but the installation is still at least partially usable. The failure is recoverable. Once recovered, the installation is completely usable. Consult the log to determine the exact failure and what, if any, corrective action can be taken.




Related concepts
Limitations of non-root installers
Related tasks
Installing the product and additional software
Related reference
vpd.properties file
Related information
Operating system registry keys
responsefile.nd.txt
Reference topic    

Terms of Use | Feedback

Last updated: Feb 19, 2011 5:25:36 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v610web&product=was-nd-mp&topic=rins_install
File name: rins_install.html