[Version 5.0.2 and later]Installing on Windows platforms

This topic describes how to install the product from a user ID that belongs to the administrator group.

Before you begin

Logging on as an administrator user is required to successfully install the product. You cannot install the product correctly as a non-administrator group user. If you back up the product CD-ROM, do so as an administrator. Backup copies made from non-administrator users do not preserve the correct file attributes and might not work.

Some steps of the installation procedure on a Windows platform require you to belong to the administrator group and have the following advanced user rights, Act as part of the operating system and Log on as a service. This topic guides you through preparing Windows, which includes choosing and installing the variety of options and features provided.

If you encounter a problem such as not having enough disk space, cancel the installation, make the required changes, and restart the installation.

The installation uses InstallShield for Multiplatforms (ISMP) to perform the installation. You can use the Installation wizard or perform the installation from a command line, using the silent installation method.

Installation programs in WebSphere Application Server products

[5.0 only][Version 5.0.2]

Product Link to installation procedure Label on product CD
(Base) WebSphere Application Server Base product installation Application Server, IBM HTTP Server
Network Deployment Network Deployment installation Deployment Manager
Enterprise Enterprise installation (which links to this procedure!) Enterprise Application Server


Use the Network Deployment installation image to manage a multimachine environment, where you have installed the base product on different machines and want to manage the Application Servers in a group, or cell. If you buy the Network Deployment product, you also get the base product in the package.

[5.0 only][Version 5.0.2]If you buy the Enterprise product, you also get the Network Deployment product and the base product in the package.

Creating multiple Application Servers on a single machine

Although you can create multiple servers on a base WebSphere Application Server node, the servers all share one set of configuration files. Changes that you make to one server affect the others. Configuration documents might become corrupted. The wsinstance command can create multiple configuration instances. Each instance is a stand-alone Application Server with its own set of configuration files. Or install the Network Deployment product to create and manage multiple base Application Servers.

Order of installation

[5.0 only][Version 5.0.2]Install the base product before installing the Network Deployment product when installing both products on the same machine. Install the Network Deployment product before the Enterprise product that extends the Network Deployment product. You can install the Enterprise product before the base product. The Enterprise product can install the base product in what is known as an umbrella installation but Enterprise cannot install the Network Deployment product. Some features of the base product cannot be installed by Enterprise.

The embedded messaging feature that is included in the default installation requires that you install base before Network Deployment when installing both on the same machine. Otherwise, the order does not matter. See the following installation tip for more information:

Installation tip
Operating platform Tip in Platform-specific tips for installing and migrating
All platforms Installing WebSphere Application Server products in order on the same machine, when installing the embedded messaging component


This topic is available in Adobe PDF format on the product CD-ROM and online in an information center. The information center always has the most current information. The information center displays in the language of your machine locale if possible.

[5.0 only][Version 5.0.2]Download a new installation guide at ftp://ftp.software.ibm.com/software/webserver/appserv/library/wasv502ee_gs.pdf .

Why and when to perform this task

The Launchpad tool lets you access the product overview, the readme.html file, and installation guides. See Using the Launchpad to start the installation for more information.

After using the Launchpad to view product documentation, perform the following procedure. The procedure includes several preliminary steps before actually launching the installer program.

Steps for this task

  1. Stop all WebSphere Application Server-related Java processes on the machine where you are installing the product.
  2. Stop any Web server process such as the IBM HTTP Server, if you are extending the base product.
  3. Provide adequate disk space.

    If you do not have enough free space in the system %TEMP% directory, you see a message prompting you to add more space. Cancel the installation, create a total of 2200 MB of free space on the disk, which includes a total of 400 MB of free space in the system %TEMP% directory, and start the installation again.

    [5.0 only][Version 5.0.2]

    Installed sizes of installation directories for Windows platforms

      Base product Enterprise product extending base Network Deployment Enterprise extending Network Deployment IBM HTTP Server Tivoli Global Security Kit Temp space
    Installation directory C:\Program Files\ WebSphere\ AppServer C:\Program Files\ WebSphere\ AppServer C:\Program Files\ WebSphere\ Deployment Manager C:\Program Files\ WebSphere\ Deployment Manager C:\Program Files\ IBM Http Server C:\Program Files\ IBM\ gsK7 C:\temp
    Minimum space for installation 520 MB 520 + 83 MB 520 MB 520 + 65 MB 17.3 MB 16.8 MB At least 100 MB



    If you plan to migrate applications and the configuration from a previous version, verify that application objects have available disk space. As a rough guideline, plan for space equal to 110 percent of the size of the application objects:

    • For Version 4.0.x: The size of enterprise archive (EAR) files

  4. Allocate adequate disk space for the embedded messaging feature if you are planning to install the feature.
    You can specify the file system into which the embedded messaging feature is installed. The following table shows default locations and free space requirements for the base messaging functions and the messaging broker functions for publish/subscribe messaging.
    Space requirements for the embedded messaging feature on Windows platforms
    Component Base messaging Messaging broker
    Installation directory C:\Program Files\IBM\WebSphere MQ C:\Program Files\IBM\WebSphere MQ\WEMPS
    Server and client subfeature 70 MB 45 MB
    Client subfeature 15 MB N/A


    If you are using the Installation wizard to install IBM WebSphere Application Server, you can specify an installation location for the embedded messaging feature during either a Full or Custom installation. You can also specify an installation location for the embedded messaging feature when installing silently.

  5. Prepare to install the embedded messaging feature.
    The embedded messaging feature is based on the IBM WebSphere MQ product. The feature and the product each provide a Java message service (JMS) function that supports queues for point-to-point messaging and topics for publish and subscribe messaging. You can install the embedded messaging feature with or without the WebSphere MQ product on the same machine. To support both the embedded messaging feature and the WebSphere MQ product on the same machine, the WebSphere MQ product must be at a certain fix level and must have several of its features installed.

    If you already have WebSphere MQ installed, you can configure it as the JMS provider. Otherwise, you can install the embedded messaging feature during the installation or install the WebSphere MQ product or another JMS provider after you install the product.

    Even though you might decide now to install only the embedded messaging feature, you can install the WebSphere MQ product later and use the IBM WebSphere MQ product as the JMS provider instead.

    [5.0 only][Version 5.0.2]If you are installing the embedded messaging feature, follow the instructions in Installing WebSphere embedded messaging as the JMS provider.

  6. Verify that prerequisites and corequisites are at the required release levels.

    Although the Installation wizard checks for prerequisite operating system patches with the prereqChecker application, review the prerequisites.

    See the System requirements for IBM WebSphere Business Integration Server Foundation Web site if you have not already done so.

    [5.0 only][Version 5.0.2]See WebSphere Application Server detailed system requirements . The Enterprise product offering is one of the sections on the Web page.

    Refer to the documentation for non-IBM prerequisite and corequisite products to learn how to migrate to their supported versions.

    Some operating systems that were not supported at the time that this product was shipped on CD-ROM might now be supported. You might receive a message from the prereqChecker program that an operating system is not supported when, in fact, the operating system is supported.

    Always consult the Web site to determine whether your operating system is supported when you receive a message from the prereqChecker program. The Web site lists all supported operating systems and the operating system fixes and patches that you must install to have a compliant operating system. After confirming that your operating system is supported and that you have installed all necessary patches, you can click Next to continue an installation when you receive an error message from the prereqChecker program.

  7. Install the required msvcp60.dll file for Windows 2000 Server platforms.
    The embedded messaging feature requires a DLL file on Windows 2000 Server platforms. The DLL file is already installed on Windows 2000 Advanced Server and other Windows platforms that are supported. If you see a message similar to the following example, download the msvcp60.dll file:
    wempsdeletebroker.exe - Unable To Locate DLL 
    The dynamic link library MSVCP60.dll could 
       not be found in the specified path...

    The prereq checker in the installer program does not check for this DLL file on the Windows 2000 Server platform. If you select the Windows 2000 Support Tools during Windows 2000 Server installation, the installation program for Windows 2000 Server installs the DLL file in the C:\Program Files\Support Tools directory. The DLL file is installed during the installation of Windows 2000 Advanced Server in the C:\WINNT\system32 directory.

    You can download the DLL file from the Microsoft Web site.

  8. Lower the Internet Explorer security level from High to Medium to view the Product overviews from the WebSphere Application Server Installation LaunchPad on Windows 2003 machines.

    You might see a blank page when trying to view Product overviews from the WebSphere Application Server Installation LaunchPad on Windows 2003 machines. Internet Explorer is set with High security level on the Internet Zone. Use the following procedure to lower the Internet zone security level to Medium:

    1. Right-click the Internet Explorer icon on the desktop.
    2. Click Properties > Security > Internet Zone.
    3. In the Security level for this zone area, move the slider from High to Medium.
    4. Click OK to save the change.

  9. Verify the Java 2 SDK on the product CD.
    Perform the following steps to verify that the Java 2 SDK on the product CD-ROM is working correctly.
    1. Change directories to the \win\WAS\jdk\java\bin directory on the product CD-ROM.
      Type the following command:
      cd CD_Drive_D:\win\WAS\jdk\java\bin
    2. Verify the Java 2 SDK version.
      Type the following command:
      .\java -version

      The command completes successfully with no errors when the Java 2 SDK is intact.

  10. Select the Installation wizard method or the silent installation method (Installing silently) but do not start the installation yet.
    The installer program has two interfaces, the Installation wizard and a silent command-line installation.

    Performing the installation with the wizard

    You can start the Installation wizard in two ways. The default installation method is to open a command window to a read/write directory, issue the fully qualified command to start the Launchpad tool (Using the Launchpad to start the installation), and click the Install the product option. This option launches the Installation wizard in the language of your machine locale unless there is no translation for your locale, in which case you receive the English version. A short delay occurs before the ISMP wizard displays. You do not need to click the Install the product option more than once to cause the wizard to display.

    You can also start the Installation wizard using the C:\> D:\win\install.bat command, where the D: drive is your CD-ROM drive and win is the platform directory. Start the installation from a read/write location and not from the CD-ROM.

    The following example shows a fully qualified call to the installer program:

    > fully_qualified_CD_pathname\install.bat
    
    C:\> D:\win\install

    Performing a silent installation

    You can also perform a silent installation using the -options C:\fully qualified path\setup.response parameter (or the -options C:\fully qualified path\setup_nd.response parameter for use with the Network Deployment product) with the command method:

    C:\> fully_qualified_CD_pathname\install
          -options fully_qualified_HDD_pathname\setup.response
    
    C:\>  D:\win\install -options \temp\setup.response

    Start the silent installation with a fully qualified path to the options response file. Otherwise, the Installation wizard starts. Start the silent installation from a read/write location and not from the CD-ROM or another read-only directory.

    [5.0 only][Version 5.0.2]A silent installation causes the installation program to read your responses from the options response file, instead of from the wizard interface. You must customize the response files before installing silently, as described in Customizing the Enterprise options response file.

    After customizing one of the files, you can issue the command to silently install, as described in Installing silently. After issuing the command, the following text displays:

    # ...................................
    .InstallShield Wizard
    
    Initializing InstallShield Wizard...
    
    Searching for Java(tm) Virtual Machine...
    

    You can change the -W launchPRTBean.active option to display the Registration panel to indicate the completion of a silent installation on a local system with a graphical user interface.

    To determine the status of the silent installation, review the installation logs (Troubleshooting the installation) in the install_root\logs directory or in the system %TEMP% directory.

    Silent installation is particularly useful if you install the product often.

    The rest of this procedure assumes that you are using the Installation wizard. Corresponding entries in the response file exist for every prompt that is described as part of the wizard. Review the description of the setup.response file and the setup_nd.response file for more information. Comments in each file describe how to customize their options.

  11. [5.0 only][Version 5.0.2]Insert the product CD-ROM into the CD-ROM drive.
  12. Open a DOS window.

    Use the same DOS window throughout the installation procedure.

  13. Start the installation with the D:\win\launchpad.bat command, where the D: drive is your CD-ROM drive and win is the platform directory on the CD-ROM.

    You can also start the installation using the D:\win\install.bat command:

    C:\> D:\win\install

    The readme link in the Launchpad is to the readme.html file in the CD root directory. The readme directory off the root of the CD has a more detailed readme file. The Getting Started document that contains installation information is in the docs directory on the CD. You can download the current version of the Getting Started document from the Library Web page.

    The rest of this procedure assumes that you are using the Installation wizard. Corresponding entries in the response file exist for every prompt that is described as part of the wizard. Review the description of the setup.response file and the setup_nd.response file for more information. Comments in each file describe how to customize the options.

  14. Click Next to continue.
    The license agreement appears for you to read.

    [5.0 only][Version 5.0.2]The license that the Installation wizard displays can contain characters that display incorrectly in Japanese. For example, the section labeled Part 1 does not show the number 1. These missing characters do not significantly affect the content of the license agreement.

  15. Click the radio button beside the I accept the terms in the license agreement message if you agree to the license agreement and click Next to continue.
    After you accept the licensing terms, the Installation wizard checks for prerequisites and for previous versions, with which it can either migrate or coexist.

    [5.0 only][Version 5.0.2]As the WebSphere Application Server Enterprise product version changes, its prerequisites and corequisites change. It is probably necessary to update your database, Web server, Software Development Kit (SDK), and other software.

    [5.0 only][Version 5.0.2]As mentioned in the introduction to this topic, the Enterprise product can install the base WebSphere Application Server product. The base product simplifies migrating product prerequisites, by providing the option to install a complimentary Java 2 SDK on your supported operating system. You can uninstall back-level prerequisites and let the Installation wizard install current versions.

    If the wizard finds a previous version of WebSphere Application Server, it prompts you to migrate applications and the configuration from the previous version, or to coexist with it. If it finds more than one previous version, the Installation wizard lists them for you to select which one to migrate.

    You can use a different node name, if you prefer, when migrating Network Deployment from V5.0.x to V5.1.x. However, you must use the administrative console after installation, to change the Secure Sockets Layer (SSL) settings that mention the node name.

  16. [5.0 only][Version 5.0.2]Install the administrative console extensions on the Network Deployment product or the programming model extensions on the base WebSphere Application Server product, when both products are installed on the same machine.
    If you have both the base WebSphere Application Server product and the Network Deployment product on the same machine, the Installation wizard for the Enterprise product displays a panel for you to select which part of the Enterprise product to install.
  17. Install additional features or install another instance of the product when a previous installation of the same level product exists.

    When the installer program detects a previous installation at the same product level, a panel appears to let you add features to the existing installation or perform a new installation to another directory. When adding features, previously installed features are checked and grayed out with the term (Installed) at the end of the feature name.

    You can add features to an unfederated base node or to a deployment manager node at any time, by running the Installation wizard again and choosing to add features.

    If you are installing on a federated node, the installer program does not allow you to install certain features. The following features are always hidden and deactivated on a federated base node:

    • Samples
    • Embedded messaging

    Features that are not grayed out are available for installation on a federated base node. You do not have to unfederate the base node to add available features.

    If the federated base node does not have both the administrative console feature and the administrative scripting features, these additional features are hidden and deactivated:

    • Business Rule Beans
    • Process choreographer

    To install any of these deactivated features, you must unfederate the managed node, install the Integration Server product again, select the features you require, and add the node to the cell again as described in Installing deactivated Integration Server features on a base node.

    You do not have to unfederate a managed node to add features that appear in the list of available features. See Installing available Integration Server features on a base node for more information.

    [5.0 only][Version 5.0.2]

    Install Enterprise features before installing interim fixes or fix packs to avoid component regression problems. Regression problems can occur when installing V5.0.0 or V5.0.1 Enterprise features from the product CD-ROM onto an Enterprise system where you have installed interim fixes or fix packs. As the product installer installs the new features, it also reinstalls related components at the V5.0.0 or V5.0.1 level, which regresses those components from the fix level back to the previous level.

    If you intend to install additional features to the base product, use the following procedure to avoid component regression problems. It is important that you understand that no way exists to add features to a base node without unfederating it from its cell and losing its configuration. The configuration for the base node is restored back to its original configuration, before it was federated and before you changed it with the administrative console of the deployment manager. This means that you lose the configuration for any additional servers that you created on the base node from the deployment manager. (The additional servers do not exist any more.) You lose any other configuration you performed from the deployment manager administrative console.

    Use the backupConfig command to save the Network Deployment configuration so that you can restore the configuration if necessary. Although you can use the backupConfig command to save the configuration, the restoreConfig command restores the configuration without any features you add to the base node. However, you can refer to the saved configuration after adding features and adding the base node back to the cell. Refer to the saved configuration as you use the administrative console of the deployment manager to reconfigure the base node.

    Applicability of the following list: [5.0 only][Version 5.0.2]

    1. If the base product node is in a deployment manager cell, unfederate the node with the removeNode command.
      Removing the base node from the cell also removes the configuration for the base node, which resides at the cell level.
    2. Uninstall any interim fixes.
    3. Uninstall any fix packs that you installed, starting with the last one and finishing with the first one.
    4. Log off and back on.
    5. Install new features using the InstallEE50 command.
    6. Install the most current fix pack.
    7. Install any interim fixes to bring the base product back to its previous fix level.
    8. If the node was part of a cell, rejoin the node to the cell with the addNode command or the deployment manager administrative console.
      This action synchronizes the master cell configuration with changes that you make to the Application Server configuration during the installation of the new features.
    9. Reconfigure the base node with the Network Deployment administrative console.
      Consult the configuration that you saved to determine how to configure the node, if necessary.
  18. Choose to migrate applications and the configuration from a previous version, or to coexist with another version (Migrating and coexisting), or to do neither, and click Next to continue.

    After installing the product, reboot the system before installing again.

    To share embedded messaging in a coexistence environment, the node names for each installation must be unique, so that each installation has a message queue manager that is named uniquely. To migrate V5.0.2 to V5.1, the node names must be identical. Therefore, the queue manager names are also identical, if you are migrating from V5.0.2 to V5.1. To prevent losing the queue manager when you uninstall V5.0.2 or V5.1, you must create a dummy queue manager before uninstalling one of the WebSphere Application Server versions.

    [5.0 only][Version 5.0.2]The first rule of migration is to migrate after you install Enterprise:

    If you are planning to install these products: Select the migration option while installing this product:
    Base product Enterprise Base product Enterprise
    X

    X

    X X

    X


    If you are planning to install these products: Select the migration option while installing this product:
    Network Deployment Enterprise Network Deployment Enterprise
    X

    X

    X X

    X


    [5.0 only][Version 5.0.2]Migrating Enterprise also migrates the product that Enterprise extends.

    When you perform an umbrella installation of the base WebSphere Application Server product, you can choose to migrate applications and the configuration from a previous version, or to coexist with another version of the base WebSphere Application Server product, or to do neither.

    You can also perform a silent migration or configure for coexistence during a silent installation. Refer to Installing silently for a description of performing a silent installation, including the options that you can specify.

    The migration prompt appears only when the Installation wizard detects a previous version. The coexistence prompt appears when the Installation wizard detects any other installation, including another Version 5 installation.

    If you choose to coexist, the wizard displays a Port selection panel, where you can specify port assignments that do not conflict with existing ports. For example, you can change the HTTP transport port for coexistence, from 9081 (one more than the default Version 5 port number) to 9085 or higher, to avoid potential conflicts with port numbers that previous versions of WebSphere Application Server commonly use.

    Use the netstat -a command to display all ports in use.

    In some cases, such as when installing a non-English version, the Installation wizard might not detect a previous version. You can force the Migration panel or the Coexistence panel to appear, by starting the installation with an option on the D:\win\install.bat command, where the D: drive is your CD-ROM drive and win is the platform directory on the CD-ROM.

    For example, use this command:

    D:\win\install 
       -W showPreviousVersionDetectedPanel.active="true"

    You can also force the appearance of the Coexistence panel to change conflicting port number assignments using this command:

    D:\win\install 
       -W showCoexistencePanel.active="true"

    [5.0 only][Version 5.0.2]If you choose neither the migration option nor the coexistence option, you can run Version 5.0.x and the previous version, but not at the same time. Although it is possible that both versions might coexist without port conflicts, you can ensure that both versions run together by selecting the coexistence option and checking for conflicting port assignments.

    The Migration panel lists all previous releases that it can identify. If you highlight a release, the text boxes labeled, "select previous version," show the location of the previous product. Select the product to migrate. If you do not see the previous version that you intend to migrate, click Select previous version to enter a location and configuration file name if you are migrating a WebSphere Application Server Advanced Edition Single Server Edition, Version 4.0.x installation.

    The field labeled "Configuration file" is valid only for WebSphere Application Server Advanced Edition Single Server Edition, Version 4.0.x. For the other versions of WebSphere Application Server that are supported by migration (Version 3.5 Standard Edition, Version 3.5 Extended Edition, and Version 4.0 Advanced Edition), the admin.config file provides the host and port values for the administrative server. If you use a file name other than admin.config, issue the commands that call the migration tools instead of migrating while installing. Issuing the commands that call the migration tools is described in Migrating and coexisting.

    Migrate V3.5.x to V5.1 during the installation of the base product or the Network Deployment product, before installing the Integration Server product.

    You must start the administrative server of some previous versions so that the Installation wizard can export the configuration from the admin.config file.

    Although you might select migration at this point in the installation process, the actual migration does not begin until after the Version 5 installation is complete. At that time, if the WASPreUpgrade tool fails, the Installation wizard does not call the WASPostUpgrade tool to complete the migration, but instead displays the WASPreUpgrade.log and WASPostUpgrade.log log files for you to diagnose the problem. After fixing the problem, such as starting the administrative server of a previous release, you can start the migration again, as described in Migrating and coexisting.

  19. [5.0 only][Version 5.0.2]Choose a type of installation and click Next.
    • Choose Typical install to install the following features on your system:
      • Embedded messaging server and client (This feature requires some operating system preparation, as described in Tips for installing the embedded messaging feature.)
      • Business rule beans
      • Container managed messaging
      • CMP 2.0 extensions
      • Other services
      • Scheduler
      • Asynchronous beans
      • Process choreography beans
      • Samples

      If you choose a typical installation, skip the next step.

    • Choose Custom install to select features to install.

    After selecting a typical installation, the wizard prompts you to select the directory for the program code. After selecting a custom installation, the wizard displays a list of features.

  20. [5.0 only][Version 5.0.2]Select features to install and click Next to continue, when performing a custom installation.
    This step is available only when you choose the custom installation type. A description of each feature appears at the bottom of the panel when you roll the cursor over the feature.

    Selecting certain features causes the installation of other prerequisite features. The following table shows this feature relationship.

    Features and feature dependencies

    If you select these features: These Enterprise features are also installed: Feature description
    Embedded Messaging   Installing and configuring a JMS provider
    Sub-features: Server and Client  
    Client Only
    Message-driven Bean Samples (for the server and not for the client)
    You can install the MDBSamples application without installing the embedded messaging server and client feature. Perhaps you have already installed the server and client feature. Or perhaps you intend to reconfigure the MDBSamples to use messaging resources that WebSphere MQ software provides.

    In any case, if you install the MDBSamples application and do not have the server and client feature installed, errors occur. The Application Server starts the MDBSamples application at start up. The MDBSamples application cannot start the required messaging resources in the Java Naming and Directory Interface (JNDI).

    Because of the lack of required resources, the message-driven beans fail to start, which causes an exception that the Application Server logs. The Application Server is not affected other than being unable to start the MDBSamples application.

    Business Rule Beans   Externalizing business rules with Business Rule Beans
    Sub-features: Business Rule Beans Sample  
    Extended Messaging   Using extended messaging in applications
    Sub-features: Extended Messaging Sample Embedded Messaging
    Dynamic Query   Using the dynamic query service
    Sub-features: Dynamic Query Sample  
    Additional Enterprise Extensions  
    Sub-features: Additional Enterprise Extensions Samples  
    Scheduler and Asynchronous Beans  
    Sub-features: Scheduler and Asynchronous Beans Samples Embedded Messaging
    Process Choreographer Additional Enterprise Extensions Using process choreographer
    Scheduler and Asynchronous Beans
    Sub-features: Process Choreographer Samples Additional Enterprise Extensions
    Scheduler and Asynchronous Beans
    Configure a sample BPE container Embedded Messaging
    Additional Enterprise Extensions
    Scheduler and Asynchronous Beans
    CORBA C++ SDK (deprecated)   Implementing CORBA applications
    Sub-features: Interface Repository Support (Requires DB2)  
    CORBA C++ SDK Samples
    Javadocs   IBM WebSphere Application Server, Release 5 API Specification in Javadoc format



    If you do not have the prerequisite base WebSphere Application Server product installed, the Enterprise installation can install it for you. The Enterprise installation installs the base WebSphere Application Server product without these features:

    • IBM HTTP Server
    • Web server plug-ins
    • Performance and analysis tools
    If you want one or more of the features, cancel the Enterprise installation and issue the D:\WAS\install command, where D: is the CD-ROM drive and WAS is the directory on the CD-ROM for installing the base WebSphere Application Server product.

    If you already have an unfederated base node installed, but select an Enterprise feature that requires a base product feature that you have not installed, the Enterprise installation installs the feature on the unfederated base node. The following table describes which base features are required when you select an Enterprise feature.


    Enterprise features and base product feature dependencies

    If you select these features: These base product features are also installed:
    Embedded Messaging        
    Sub-features: Server and Client
    Client Only
    Message-driven Bean Samples (These samples are the MDBSamples application, which is for the server and not for the client.)
    Business Rule Beans WebSphere Application Server
    Admin Scripting
    Administrative Console
    Sub-features: Business Rule Beans sample Application Server samples
    Extended Messaging WebSphere Application Server
    Sub-features: Extended Messaging sample Application Server samples
    Embedded Messaging
    Messaging-driven Bean Samples
    Dynamic Query WebSphere Application Server
    Sub-features: Dynamic Query Sample Application Server samples
    Additional Enterprise Extensions Application Server
    Application Assembly Tool
    Administrative Console
    Sub-features: Additional Enterprise Extensions samples Application Server samples
    Scheduler and Asynchronous Beans Application Server
    Sub-features: Scheduler and Asynchronous Beans Samples Application Server samples
    Process Choreographer Application Server
    Admin Scripting
    Administrative Console
    Sub-features: Process Choreographer samples Application Server samples
    Configure a sample BPE container Embedded Messaging
    CORBA C++ SDK    
    Sub-features: Interface Repository Support (Requires DB2)
    CORBA C++ SDK samples Application Server samples
    Javadocs  



    You can run the uninstaller program to remove all installed features.

  21. [5.0 only][Version 5.0.2]Specify a destination directory, then click Next to continue.

    The default installation path is drive:\Program Files\IBM\WebSphere MQ\. You can specify a different directory during installation. There is an advantage for downloading and installing interim fixes and fix packs when the installation root directory does not contain spaces, which the Program Files directory does.

    Deleting the default target location and leaving an installation directory field empty stops you from continuing the installation process. The Installation wizard does not proceed when you click Next. Enter the required target directory to proceed to the next panel. Non-ASCII special characters are not supported in the name of the installation directory.

    Ensure that the target directory has adequate space available. Also ensure that approximately 100 MB or more of free space exists in the platform temp directory.

    If you have problems accessing the administrative console after installation, check the installAdminConsole.log file for a failure indication. Correct any problems and reinstall the administrative console using the wsadmin scripting facility.

    If you select the embedded messaging feature and prerequisites are missing, the Installation wizard displays the mq_prereq.log error log and takes you back to the Installation type panel. Choose Custom installation and clear the embedded messaging feature to continue. The mq_prereq.log file is in the system temp directory.

  22. Specify whether to run the base Application Server as a Windows service (Automatically restarting WebSphere processes) if you are performing an umbrella installation of the base product.
  23. Specify node information and click Next.
    Specify the node name and host name. Although the wizard inserts the machine name (of the installation platform) as the node name, you can specify any unique name. The node name is an arbitrary WebSphere Application Server-specific name that must be unique within a cell.

    The host name is the network name for the physical machine on which the node is installed. The host name must resolve to a physical network node on the server. When multiple network cards exist in the server, the host name or IP address must resolve to one of the network cards. Remote WebSphere Application Server nodes use the host name to connect to and to communicate with this node. Selecting a host name that other machines can reach within your network is extremely important. Do not use the generic localhost identifier for this value.

    If you define coexisting nodes on the same computer with unique IP addresses, define each IP address in the hosts file or in a domain name server (DNS) look-up table. WebSphere Application Server configuration files do not provide domain name resolution for multiple IP addresses on a machine with a single network address.

    The value that you specify for the host name is used as the value of the hostName property in WebSphere Application Server configuration documents. Specify the host name value in one of the following formats:

    • Fully qualified domain name servers (DNS) host name string, such as xmachine.manhattan.ibm.com
    • The default short DNS host name string, such as xmachine
    • Numeric IP address, such as 127.1.255.3

    The fully qualified DNS host name has the advantage of being totally unambiguous and also flexible. You have the flexibility of changing the actual IP address for the host system without having to change the WebSphere Application Server configuration. This value for host name is particularly useful if you plan to change the IP address frequently when using Dynamic Host Configuration Protocol (DHCP) to assign IP addresses. A format disadvantage is being dependent on DNS. If DNS is not available, then connectivity is compromised.

    The short host name is also dynamically resolvable. A short name format has the added ability of being redefined in the local hosts file so that the system can run WebSphere Application Server even when disconnected from the network. Define the short name to 127.0.0.1 (local loopback) in the hosts file to run disconnected. A format disadvantage is being dependent on DNS for remote access. If DNS is not available, then connectivity is compromised.

    A numeric IP address has the advantage of not requiring name resolution through DNS. A remote node can connect to the node you name with a numeric IP address without DNS being available. A format disadvantage is that the numeric IP address is fixed. You must change the setting of the hostName property in WebSphere Application Server configuration documents whenever you change the machine IP address. Therefore, do not use a numeric IP address if you use DHCP, or if you change IP addresses regularly. Another format disadvantage is that you cannot use the node if the host is disconnected from the network.

  24. Configure the sample business process container, if you selected it and click Next to continue.
    Specify values for the following fields:

    User ID to authenticate with the embedded messaging queue manager

    This field is the JMS user ID who authenticates the connection to the JMS provider. This user ID must have administration rights for the messaging service.

    You can create the user ID later as a member of the Administrators group. The JMS user ID must be less than or equal to 12 characters. For example, the default Windows user ID, Administrator, is not valid for use as the JMS user ID for the embedded messaging feature because the ID contains 13 characters. Use mqm as the user ID.

    Password

    Type the password for the user you specified as the JMS user ID in the first field.

    Confirmation password

    Repeat the password for the user you specified as the JMS user ID in the first field.

    Security role for the business process system administrator

    This field is the security role mapping. Specify the user or group from the domain user registry that is mapped onto the role of Business Process Administrator. The value to use depends on the local settings. For example, you can specify that the Administrators group is to perform the security role.

    The user registry can be the local operating system, Lightweight Directory Access Protocol (LDAP), or custom registry. The user or group specified must already exist in the user registry being used.

  25. Review the summary information and click Next to install the product code or Back to change your specifications.
    When the installation is complete, the wizard displays the install_root\logs\mq_install.log installation log if you selected the embedded messaging feature and errors occur with its installation.
  26. Review the mq_install.log installation log if it appears. Click Next to continue.
    The wizard displays the Registration panel.
  27. Click Next to register the product, or clear the check box and click Next to register at a later time.
    The Registration panel is in English when the machine locale uses a double byte character set (DBCS) language.

    You can register the product now by using the link on this panel or later, by using the Web address in the install_root\prt\readme_prt.txt file. The Web address in the file is encoded for your locale. A known problem for some locales corrupts the Web address so that it is similar to the following example. (The Web address is all one line in the file. The following example shows the address on two lines for clarity.)

    http%3A%2F%2Fwww.ibm.com%2Fsoftware%2Fwebprt%2Fregister%2Fprodreg.nsf%
       2Fcontact%3FOpenForm%26lang%3DENU%26pid%3D45P8842%26q2%3DWindows+2000

    Use one of the following Web addresses if your install_root\prt\readme_prt.txt file is corrupt:

    • http://www.ibm.com/software/webprt/register/prodreg.nsf/contact?OpenForm&
    • https://www6.software.ibm.com/reg/prt/prt-r

    The Installation wizard starts the First Steps tool. See firststeps command for more information.

    If you are migrating a federated node as you install, close the First Steps tool. Migrated federated nodes have configuration differences that prevent you from using the First Steps tool.

  28. [5.0 only][Version 5.0.2]Verify the success of the installer program by examining the Exit summary panel and the install_root\logs\WAS.PME.install.log file in the installation root directory for installation status.
    If you performed an umbrella installation of the base product or if you installed new base product features, also examine the install_root\logs\log.txt file. ISMP records a success message in the WAS.PME.install.log file: "INSTFIN: The installation is complete." The logs are the only source of status information for a silent installation.

    Look for severe errors that the installer records in the \logs\WAS.PME.install.log file in the installation root directory to verify that no file system or other unusual errors occurred during installation.

    If the \logs\log.txt file and the \logs\WAS.PME.install.log file do not contain a record of any problems but problems exist, verify or troubleshoot the installation, as described in Troubleshooting the installation and Installation component troubleshooting tips.

  29. Click Finish to close the Installation wizard.
  30. Install the most current fix pack and cumulative fix for the WebSphere Application Server products.

    Always install the latest cumulative fixes as they are released. See Cumulative Fix Strategy for WebSphere Application Server V5.0 and V5.1 for more information.

    Recommended updates for WebSphere Application Server products are listed on the Recommended updates for WebSphere Application Server Base and Network Deployment editions Web page.

Results

The Installation wizard configures the product. It is not necessary to perform further configuration at this time.

[5.0 only][Version 5.0.2]You have now successfully installed WebSphere Application Server Enterprise and the features that you selected.

What to do next

Uninstalling and reinstalling

See Uninstalling the product for information about uninstalling any WebSphere Application Server product.

After uninstalling a WebSphere Application Server product, reinstalling into the same directory without first deleting all directory contents results in invalid XML configurations because of the retention of old files. Uninstall manually to delete all of the files so that you can reinstall with a clean system, as described in Manually uninstalling on Windows platforms

Miscellaneous tips for Windows platforms


Installation and migration tips

Operating platform Tip in Platform-specific tips for installing and migrating
Windows platforms Windows platforms
All platforms All platforms




Related tasks
Installing the product
Using the Launchpad to start the installation
Installing silently
Customizing the Enterprise options response file[5.0 only][Version 5.0.2]
Automatically restarting WebSphere processes
Related reference
Platform-specific tips for installing and migrating
Tips for installing the embedded messaging feature
setup.response
setup_nd.response



Searchable topic ID:   installwindowsw
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/tins_installwindowsw.html

Library | Support | Terms of Use | Feedback