[Version 5.0.2 and later]Installing available Integration Server features on a base node

This topic describes how to install available Integration Server features on a base node.

Before you begin

If you encounter a problem such as not having enough temporary space or not having the right packages on your system, cancel the installation, make the required changes, and restart the installation.

The installation of new features uses the InstallShield for Multiplatforms (ISMP) wizard 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

If you are adding features to the base product, see Installing additional features on a base Application Server.

This topic describes adding features to the Integration Server on a base node.

Why and when to perform this task

You can add features to the WebSphere Business Integration Server Foundation product on a stand-alone base node at any time, by running the Installation wizard for WebSphere Business Integration Server Foundation again.

If you are adding features to WebSphere Business Integration Server Foundation on a managed node, you cannot install certain deactivated features. The following Integration Server features are always hidden and deactivated on a federated base node:

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

If the managed node does not have both the administrative console feature and the administrative scripting features, the following Integration Server features are hidden and deactivated:

To install any of these deactivated features, you must remove the base node from the cell as described in the following procedure. See Installing deactivated Integration Server features on a base node for a procedure to install available features to the Integration Server on a stand-alone or managed node.

You do not have to remove a managed node from a cell to install available features. Use the following procedure to avoid component regression problems when installing available features to WebSphere Business Integration Server Foundation on a base node.

Steps for this task

  1. Log on as the root user on a Linux or UNIX system or as a user in the administrator group on a Windows system.

    You cannot install features correctly as a non-root user on a Linux or UNIX system, or as a non-administrator on a Windows system.

  2. Insert the product CD labeled, Integration Server Disk 1.
    Windows systems and most Linux systems are configured to automatically mount CD-ROM drives.
  3. Open a shell window and mount the CD-ROM drive if necessary.
  4. Start the installation with the ./launchpad.sh command or the launchpad command on a Windows system.
    See the platform-specific installation instructions if you need more information about restarting the installation from the product CD-ROM, such as instructions for mounting the CD drive.

    Corresponding entries in the response files exist for every prompt that is described as part of the wizard. Comments in the response file describe how to customize the options.

    The rest of this procedure assumes that you are using the Installation wizard.

  5. Click Next to continue.
    The license agreement displays.

    The Installation wizard does not support hot keys, such as Alt-N. You can tab to Next and press Enter to select it, for example.

    [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.

  6. 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.
  7. Choose to install additional features.
    The Installation wizard panel that appears when the installer program detects a previous installation at the same product level has an option for installing additional features. Select the check box labeled "Add features to the existing copy."
  8. Skip the coexistence panel that lets you select new ports, if it appears.
  9. 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.

    The JMS user ID must be less than or equal to 12 characters.

    You can create the user ID later and add the user to the mqm user group. Or specify the root user as the value for the field:

    root

    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 Administrator group is to perform the security role on some systems.

    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.

    See Using Process Choreographer for more information.

  10. 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 if errors occur during its installation.
  11. Review the mq_install.log installation log if it displays. Click Next to continue.
    The wizard displays the Registration panel.
  12. Clear the check box and click Next on the registration panel.

    The Installation wizard starts the firststeps command.

  13. Click Finish to close the Installation wizard.
  14. Close the First Steps panel.
  15. Install the most current fix pack on a stand-alone base product.
  16. Install the most current fix pack on the Integration Server product.
    If the Integration Server is on a managed node, install the same level fix pack that is installed on the base product. The base product and the Integration Server must be at the same fix pack level. The deployment manager must be at the highest fix level within the cell. The other products can be at the same level but cannot be at a higher fix level.

    See Recommended updates for WebSphere Application Server for information about downloading and installing updates. See Installing interim fixes, cumulative fixes, and fix packs for information about using the update installer program.

  17. Install the most current cumulative fix on a stand-alone base product.
  18. Install the most current cumulative fix on the Integration Server product.
    If the Integration Server is on a managed node, install the same level cumulative fix that is installed on the base node.
  19. Linux and UNIX only: Issue write permissions for the new files to your non-root user group (wasgroup, for example), if you run an Application Server, the deployment manager, or a nodeagent from a non-root user.

    See the following topics for more information:

Results

You can successfully install available features for the Integration Server on a base node.


Related tasks
Installing the product
Using the Launchpad to start the installation
Installing silently
Automatically restarting WebSphere processes
Related reference
Platform-specific tips for installing and migrating
Tips for installing the embedded messaging feature



Searchable topic ID:   featuresw
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_featuresw.html

Library | Support | Terms of Use | Feedback