+

Search Tips   |   Advanced Search

WAS installation information

Installation requirements, examples, and other information for installing and uninstalling WebSphere Application Server. The WAS offering is the main product offering and provides the application server, which uses Java technology to extend web server capabilities to handle web application requests.


About WAS

IBM WAS Network Deployment is an integrated platform containing an application server, web development tools, a web server, and additional supporting software and documentation.

Before installing the product, plan what other optional components we want to install and determine where to install each component.

(Dist) For examples of possible topologies, see Planning to install WAS.

The installation of the application server product installs a shared set of core product files. Afterward, we create at least one profile, which is a separate file system that includes the files that define a runtime environment for an application server process, such as a dmgr or an application server.

After installation, we can create an application server profile, a management profile, a cell set of profiles containing a dmgr and a federated application server, or a custom profile. At least one profile must exist to have a functioning application server environment. Use the manageprofiles command or the Profile Management Tool to create profiles.


Requirements

In addition to the following requirements, the system might require other prerequisites so that we can install WAS offerings.

See Prepare the operating system for product installation.


Repositories and offering IDs

To install WAS from the online service repository, use the following repository URL with Installation Manager: 

http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v90

When we use the command line or response files to install, uninstall, or otherwise modify WAS, specify the main offering ID. We can also add a comma-separated list of optional features to install. If we do not specify optional features, a default set of features is installed. To install only the features that we want, specify the list of features explicitly.

Offering ID Optional feature IDs Default features

WAS ND 

com.ibm.websphere.ND.v90

  • core.feature: WAS

    This feature must be specified to specify the following optional subfeatures:

We cannot use Installation Manager to modify, update, or rollback functions to later add or remove core.feature. Only the subfeatures can be added or removed.

  • core.feature

    • thinclient
    • embeddablecontainer
    • ejbdeploy

For a complete list of product repositories and offering IDs, see Online product repositories for WAS offerings and WAS product offerings for supported operating systems.


Installation examples

All WAS offerings are installed using IBM Installation Manager. For step-by-step instructions for installing product offerings, see Install the product offerings.

(Dist) Important: Because IBM SDK Java Technology Edition is no longer embedded with the product, specify both the WAS offering ID and the IBM Java SDK offering ID (com.ibm.java.jdk.v8). WAS cannot be installed without a Java SDK.

Command-line examples

For step-by-step instructions for installing using the command line, see Install the product offerings using the command line.

  • (Windows) 

    imcl.exe install com.ibm.websphere.ND.v90 com.ibm.java.jdk.v8
  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v90 
  -installationDirectory "C:\IBM\WebSphere\AppServer"
  -sharedResourcesDirectory "C:\IBM\IMShared"
  -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts'/>=false
  -secureStorageFile C:\IM\credential.store -masterPasswordFile C:\IM\master_password.txt
  -log installv9.xml
  -acceptLicense
  -showProgress
  • (Linux) 

    ./imcl install com.ibm.websphere.ND.v90 com.ibm.java.jdk.v8
  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v90 
  -installationDirectory /opt/IBM/WebSphere/AppServer
  -sharedResourcesDirectory /opt/IBM/IMShared
  -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=false
  -secureStorageFile /var/IM/credential.store -masterPasswordFile /var/IM/master_password.txt
  -log installv9.xml
  -acceptLicense
  -showProgress

  • (iSeries) 

    ./imcl install com.ibm.websphere.ND.v90
  -repositories https://downloads.mycorp.com:8080/WAS_90_repository
  -installationDirectory /QIBM/ProdData/WebSphere/AppServer/V9/ND
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V9/ND
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store
  -acceptLicense
  -showProgress

Response file example

For step-by-step instructions for installing using a response file, see Install the product offerings using response files.

(Windows) 

<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean="true" temporary="true">
<server>
<repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v90" />
</server>
<install modify='false'>
<offering id='com.ibm.websphere.ND.v90' 
  profile='IBM WAS V9.0' 
  features='core.feature,ejbdeploy,thinclient,embeddablecontainer' installFixes='none'/>
<offering id='com.ibm.java.jdk.v8'
  profile='IBM WAS V9.0'
  features='com.ibm.sdk.8'/>
</install>
<profile id='IBM WAS V9.0' 
  installLocation='C:\IBM\WebSphere\AppServer'>
<data key='eclipseLocation' value='C:\IBM\WebSphere\AppServer'/>
<data key='user.import.profile' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>

(iSeries) 

<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean="true" temporary="true">
<server>
<repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v90" />
</server>
<install modify='false'>
<offering id='com.ibm.websphere.ND.v90' 
  profile='IBM WAS V9.0' 
  features='core.feature,ejbdeploy,thinclient,embeddablecontainer' installFixes='none'/>
</install>
<profile id='IBM WAS V9.0' 
  installLocation='/QIBM/ProdData/WebSphere/AppServer/V9/ND'>
<data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/AppServer/V9/ND'/>
<data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppServer/V9/ND'/>
<data key='user.import.profile' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>


Usage notes

The versionInfo and historyInfo commands return version and history information for the WAS based on all of the installation, uninstallation, update, and rollback activities performed on the system.

After installing the product, create the profiles that define the application server runtime environment. See Set up applications.

(Dist) Note: When we install the WAS offering on a distributed operating system, the program automatically installs two additional tools on that system:

The GUI for these tools is supported only on AIX, Linux, and Windows. On other platforms.:


Uninstallation examples

All WAS offerings are uninstalled using IBM Installation Manager.

For step-by-step instructions for uninstalling product offerings, see Uninstall the product offerings.

IBM SDK (com.ibm.java.jdk.v8) must be uninstalled at the same time that you uninstall the product offering..

Command-line examples

For step-by-step instructions for uninstalling using the command line, see Uninstall the product offerings using the command line.

  • (Windows) 

    imcl.exe uninstall com.ibm.websphere.ND.v90 com.ibm.java.jdk.v8
  -installationDirectory "C:\IBM\WebSphere\AppServer"
  • (HPUX) (Linux) (Solaris) 

    ./imcl uninstall com.ibm.websphere.ND.v90 com.ibm.java.jdk.v8
  -installationDirectory /opt/IBM/WebSphere/AppServer

  • (iSeries) 

    ./imcl uninstall com.ibm.websphere.ND.v90
  -installationDirectory /QIBM/ProdData/WebSphere/AppServer/V9/ND

Response file example

For step-by-step instructions for uninstalling using a response file, see Uninstall the product offerings using response files.

(Windows) 

<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<uninstall modify='false'>
<offering id='com.ibm.websphere.ND.v90' 
  profile='IBM WAS V9.0'/>
<offering id='com.ibm.java.jdk.v8' 
  profile='IBM WAS V9.0'/>
</uninstall>
<profile id='IBM WAS V9.0' 
  installLocation='C:\IBM\WebSphere\AppServer'>
<data key='eclipseLocation' value='C:\IBM\WebSphere\AppServer'/>
<data key='user.import.profile' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>

(iSeries) 

<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<uninstall modify='false'>
<offering id='com.ibm.websphere.ND.v90' 
  profile='IBM WAS V9.0'/>
</uninstall>
<profile id='IBM WAS V9.0' 
  installLocation='/QIBM/ProdData/WebSphere/AppServer/V9/ND'>
<data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/AppServer/V9/ND'/>
<data key='user.import.profile' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>


Related:

  • WAS product offerings for supported operating systems
  • Online product repositories for WAS offerings
  • Planning to install WAS
  • Install the product offerings
  • Install the product offerings on distributed operating systems using the GUI
  • Install the product offerings using the command line
  • Install the product offerings using response files
  • Uninstall the product offerings
  • WebSphere Customization Toolbox installation information
  • Supported hardware and software website