WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Installing WebSphere ESB interactively

You can install WebSphere® ESB using the installation wizard. A Typical installation installs WebSphere ESB, optionally installs WebSphere Application Server Network Deployment, version 6.1 with Feature Pack for Web Services, and optionally creates a stand-alone server, a deployment manager, or a custom profile. A Deployment environment installation guides you through setting up a new deployment environment or refining an existing one.

Before you begin

Ensure that you have reviewed the list of prerequisites for installing the product at Prerequisites for installing WebSphere ESB.

About this task

If you plan to install from images downloaded from Passport Advantage®, see Special considerations when installing from Passport Advantage for important information.
The language of the installation wizard is determined by the default language on the system. If the default language on the system is not one of the supported languages, English is used. You can override the system's default language by starting the installation wizard from the command line and using the java user.language setting to replace the default language. Use the following command, which can be run from the WBI directory on the product DVD or from an electronic installation image. In this example, the variable lang represents the language.
  • For i5/OS operating system On i5/OS® platform: (You use a Windows® system client machine to connect to the i5/OS system.) ..\JDK\jre.pak\repository\package.java.jre\java\jre\bin\java -Duser.language=lang -cp setup.jar run -os400was
  • For Linux operating systemFor UNIX operating system On Linux® and UNIX® platforms: ../JDK/jre.pak/repository/package.java.jre/java/jre/bin/java -Duser.language=lang -cp setup.jar run
  • For Windows operating system On Windows platforms: ..\JDK\jre.pak\repository\package.java.jre\java\jre\bin\java -Duser.language=lang -cp setup.jar run
For example, to start the installation wizard in the German language on a Windows system, type the following command:
..\JDK\jre.pak\repository\package.java.jre\java\jre\bin\java 
-Duser.language=de -cp setup.jar run
Restriction: Do not run two instances of the installation wizard concurrently. If you do so, you will receive a warning about an installation already being in progress.

The installer program does not support console-mode installation.

To install WebSphere ESB using the installation wizard, complete the following steps.

Procedure
  1. Log on to the system.

    For Linux operating systemFor UNIX operating systemFor Windows operating system On Linux, UNIX, and Windows platforms: Your user ID need not have root or Administrator privileges. However, installing the product as a non-root or non-Administrator user does create some restrictions. For example, you will not be able to create a Windows or Linux service for WebSphere ESB. Also, the program will not register with the operating system. For more details on restrictions of non-root installers, see the following topic in the WebSphere Application Server Network Deployment, version 6.1.x information center: Limitations of non-root installers.

    For i5/OS operating system On i5/OS platforms: If you plan to use the launchpad to install WebSphere ESB on an i5/OS system, sign onto a Windows system. You use the Windows system as a client machine to connect to the System i server while performing the interactive installation. The launchpad runs on the Windows client. To install on an i5/OS system, you must use a valid i5/OS user profile for that system. The user profile must have *ALLOBJ and *SECADM authorities. Without these authorities, the installation will fail.

  2. Access the media in one of the following ways, depending on whether you are installing from the product DVD or from images downloaded from Passport Advantage.
    • If you are installing from the product DVD, insert the product disk labeled WebSphere Enterprise Service Bus V6.2 DVD into the disk drive.
    • If you are installing from images downloaded from Passport Advantage, navigate to the directory into which you extracted the images.
  3. Start the installation wizard from the launchpad or a command line.
    • To start the installation from the launchpad:
      1. Start the launchpad by following the procedure in Starting the launchpad.
      2. Click IBM WebSphere ESB installation.
      3. Click Launch the installation wizard for WebSphere ESB.

    • To start the installation from a command line, issue the install command as follows, depending on whether you are installing from the product DVD or from images downloaded from Passport Advantage:

      When installing from the product DVD, enter the following command:
      • For i5/OS operating system On i5/OS platforms: (You use a Windows system client machine to connect to the i5/OS system.) From the root directory of the disk drive, \WBI\install.exe
      • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: mount_point/WBI/install, where mount_point is the mount point on the Linux or UNIX system.
      • For Windows operating system On Windows platforms: From the root directory of the disk drive, \WBI\install.exe
      When installing from images downloaded from Passport Advantage, enter the following command, where extract_directory represents the directory into which you extracted the electronic image:
      • For i5/OS operating system On i5/OS platforms: (You use a Windows system client machine to connect to the i5/OS system.) extract_directory\WBI\install.exe
      • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: extract_directory/WBI/install
      • For Windows operating system On Windows platforms: extract_directory\WBI\install.exe

      The next step depends on which platform you are using:

    Platform you are installing on Next step
    i5/OS The i5/OS signon panel is displayed. Go to step 4.
    Linux, UNIX, or Windows The Welcome panel is displayed. Go to step 5.
  4. For i5/OS operating system On i5/OS platforms: On the i5/OS signon panel, enter the following information:
    • The target i5/OS system name or IP address.
    • An i5/OS user profile that is valid on the target system. This profile must have *ALLOBJ and *SECADM special authorities.
    • The password for the i5/OS user profile.

    Click Next.

    The Welcome panel is displayed.
  5. On the Welcome panel, click Next. The Software license agreement panel is displayed.
  6. In the Software license agreement panel, review the IBM® and non-IBM licensing terms and, if you agree, select I accept both the IBM and the non-IBM terms, and click Next.

    The installation wizard checks for a supported operating system with prerequisite patches. At the end of the process, the System prerequisites check panel is displayed and indicates whether your system passed the check.

    If your system did not pass, cancel the installation, make the required changes, and restart the installation.

  7. In the System prerequisites check panel, click Next.
    Restriction: If your user ID does not have root or Administrator privileges, a warning panel is displayed, which describes the restrictions you will encounter during product installation. For example, you will not be able to create a Windows or Linux service for WebSphere ESB. Also, the program will not register with the operating system. To continue the installation, click Next.
    The installation wizard checks for existing installations of the following products:
    • WebSphere Application Server, Version 6.1.x
    • WebSphere Application Server Network Deployment, Version 6.1.x
    • WebSphere ESB, Version 6.2
    Important: The installation wizard also detects unregistered instances of WebSphere Application Server or WebSphere Application Server Network Deployment if they have entries in the .nifregistry file. See .nifregistry and vpd.properties files for the location of this file based on platform for root, Administrator, or non-root users. Using an unregistered installation of one of these products with your WebSphere ESB installation is not supported.
    If the installation wizard finds existing installations of any WebSphere products, the wizard reports which product or products it found. You must then make choices for your new installation. Do one of the following depending on whether you have existing installations of WebSphere products on your system:
    • If you have no existing installations of any WebSphere products on your system, the Installation type panel is displayed. Go to step 9.
    • If you have existing installations of any WebSphere products on your system, go to step 8.
  8. The panel that is displayed and your next step depend on which WebSphere products the installer found on your system. Choose the next step from Table 1 based on which panel is displayed on your system.
    Table 1. Next step based on existing installations of WebSphere products
    Panel that is displayed Product found and next step
    Detected IBM WebSphere ESB An existing installation of WebSphere ESB by itself or together with installations of other WebSphere products. Go to the topic Installing with existing WebSphere ESB installations for instructions to complete your installation.
    Detected WebSphere Application Server An existing installation of WebSphere Application Server or WebSphere Application Server Network Deployment, and no existing installations of WebSphere ESB. Go to the topic Installing with existing WebSphere Application Server or WebSphere Application Server Network Deployment installations for instructions to complete your installation.
  9. On the Installation type panel, select the type of installation you want to perform and click Next.

    The installation wizard provides a choice of installation paths (not all might appear based on selections you made on previous panels). The next step depends on the type of installation you want.

    Installation type Next step
    Typical Installation (the default): installs WebSphere ESB and optionally installs WebSphere Application Server Network Deployment with Feature Pack for Web Services using default installation selections and configurations. You can optionally install the WebSphere ESB samples. You can also create a stand-alone server, deployment manager, or custom profile, or choose None to bypass this option and later use the Profile Management Tool to create profiles, which is recommended for production environments.

    The Features selection panel is displayed. Go to the topic Installing WebSphere ESB and creating a profile interactively.
    Deployment Environment Installation: installs WebSphere ESB and optionally installs WebSphere Application Server Network Deployment with Feature Pack for Web Services, and guides you through setting up a deployment environment. You can create a deployment manager and choose a deployment environment pattern for it or choose a cluster or clusters to apply to a managed node. The Features selection panel is displayed. Go to the topic Installing WebSphere ESB with a deployment environment interactively.

Results

You have started the installation wizard, accepted the licensing agreement, checked prerequisites, and identified any existing installations of WebSphere products that could impact your installation. If no existing installations of WebSphere products impact your installation, you have also chosen the type of installation you want to perform (Typical or Deployment environment).

What to do next

Continue your installation by following the instructions from the appropriate link depending on the choices you have made.

task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tins_install_chkprereq.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).