Installing WebSphere Process Server or the Client to coexist with existing installations of various WebSphere products

Use this procedure to install WebSphere Process Server or the Client on a system with an existing installation of WebSphere Process Server, WebSphere Process Server Client, WebSphere Enterprise Service Bus, or a supported version of WebSphere Application Server or WebSphere Application Server Network Deployment. This procedure uses the Installation wizard graphical user interface (GUI).

Before you begin

Before installing using this procedure, ensure that:
  • You have decided on the type of installation you prefer:
    • A Complete (default) installation, which installs WebSphere Process Server and WebSphere Application Server Network Deployment using default installation selections and configurations. It also creates a stand-alone process server profile named default with a server named server1.
      Important: This selection does not create a sample Business Process Choreographer configuration for the stand-alone process server profile.
    • A Custom installation, which lets you select the product features you wish to install. It can also install WebSphere Application Server Network Deployment, and allows you to run the Profile wizard at the end of the installation to create a WebSphere Process Server profile.
    • A Client installation, which installs the WebSphere Process Server Client and can install WebSphere Application Server Network Deployment.
  • You have decided whether to install WebSphere Application Server Network Deployment as part of your WebSphere Process Server or Client installation or to instead use an existing installation of WebSphere Application Server or WebSphere Application Server Network Deployment, version 6.0.x.x.
  • You have reviewed possible installation topologies in Planning installation topologies.
  • Your system meets all hardware requirements and that you have installed all required software corequisites and prerequisites. See Hardware and software requirements for more information.
  • You have prepared your operating system for installation. See Preparing the operating system for installation for instructions.
  • You are installing the product as the root user on a Linux or UNIX system, or as a member of the Administrator group on a Windows system.
  • You are installing from product CDs. If you plan to install from images obtained from Passport Advantage, see Special considerations when installing from Passport Advantage for installation tips.

Why and when to perform this task

This procedure assumes you have an installation of WebSphere Process Server, WebSphere Process Server Client, WebSphere Enterprise Service Bus, WebSphere Application Server, version 6.0.x.x, or WebSphere Application Server Network Deployment, version 6.0.x.x on your system. You do not have to have existing profiles. It also assumes you want to install using an interactive interface. If your proposed installation does not meet these criteria, see Installing the software for descriptions of other installation procedures. Use the following procedure to install the product.

Steps for this task

  1. Log on as the root user on a Linux or UNIX system, or as a member of the Administrator group on a Windows system.
  2. Start the WebSphere Process Server installer.
    Do the following:
    1. Start the Launchpad by following the procedure in Starting the Launchpad.
    2. From the right pane of the Launchpad, select WebSphere Process Server installation > Launch the Installation wizard for WebSphere Process Server for Multiplatforms.
  3. From the Welcome panel on the installer, select Next.
  4. In the License agreement panel, review the IBM and non-IBM licensing terms, select I accept the terms in the license agreement, and select Next.

    The Installation wizard checks for a supported operating system with prerequisite patches. At the end of the process, the Checking prerequisites panel indicates whether your system passed the check. This procedure assumes that your system passed.

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

  5. In the Checking prerequisites panel, select Next.
    The Installation wizard checks for existing installations of WebSphere Process Server, WebSphere Process Server Client, WebSphere Enterprise Service Bus, WebSphere Application Server, and WebSphere Application Server Network Deployment. This procedure assumes you might have an existing installation of any of these products.
    • If you have an existing installation of WebSphere Process Server, WebSphere Process Server Client, or WebSphere Enterprise Service Bus, an Existing installation detected panel is displayed.
      In this case, do the following:
      • Select Install a new copy of WebSphere Process Server for Multiplatforms 6.0.2 and Next. A warning panel outlines considerations you must make when installing the product on a system with an existing installation.
      • Select Next. A second warning panel outlines considerations you must make when installing the product on a system with an existing installation of WebSphere Application Server or WebSphere Application Server Network Deployment.
      • Select Next.
    • If you have an existing installation of WebSphere Application Server or WebSphere Application Server Network Deployment, an Existing installation detected panel is displayed. In this case, do the following:
      • Select Install a new copy of WebSphere Application Server Network Deployment, Version 6.0 and select Next (since in this example scenario, we want a new installation of WebSphere Process Server to coexist with an existing installation of WebSphere Application Server or WebSphere Application Server Network Deployment – not be installed on top of it). A warning panel outlines considerations you must make when installing the product on a system with an existing installation of WebSphere Application Server or WebSphere Application Server Network Deployment.
      • Select Next.
    Important: The installer will also detect unregistered instances of WebSphere Application Server or WebSphere Application Server Network Deployment if they have entries in the .WASRegistry file. This file is located in the $USER_HOME directory of the installation. Using an unregistered installation of one of these products with your WebSphere Process Server installation is neither recommended nor supported.
  6. In the Installation location panel, accept the default installation root directory for the products or specify a different directory, and select Next.
    See Default installation paths for the default installation directories.
    Important:
    • You must provide a value for the installation root directory to continue.
    • The installation root directory you specify must be empty. If it is not, an error message instructs you to provide a different directory.
    • Do not use non-ASCII special characters in directory names – they are not supported.
    • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms: Do not use symbolic links as the installation root directory – they are not supported. Also, do not use spaces in the directory path.
    • Icon indicating Linux platforms On Linux platforms: The installation root directory path must be no longer than 256 characters to successfully install the products.
    • Icon indicating Windows platforms On Windows platforms: When performing a Complete installation, the installation root directory path must be no longer than 60 characters to successfully create the default stand-alone server profile.
  7. In the Installation type panel, select the type of installation you want and select Next. The Installation wizard provides three installation paths (not all might appear based on selections you made on previous panels):
    • The Complete path installs WebSphere Process Server and WebSphere Application Server Network Deployment, and creates a stand-alone process server profile named default with a server named server1.
    • The Custom path allows you to select those features you want to install, plus can install WebSphere Application Server Network Deployment. It does not create a profile but allows you to run the Profile wizard at the end of the installation.
    • The Client path installs the WebSphere Process Server Client and can install WebSphere Application Server Network Deployment. It does not create a profile.
    If you selected Complete or Client, proceed to step 9. If you selected Custom, proceed to step 8.
  8. In the Feature selection panel, select the features you want to install and select Next. See Product components for descriptions of the features you can select from this panel.
  9. In the Installation summary panel, review the components that will be installed, the amount of space they will consume, and where they will be located on the system, and select Next to install or Back to change your specifications.

    The Installation wizard creates the uninstaller program and shows a progress panel to indicate that components are being installed. At the end of the installation, the Installation complete panel is displayed.

    Attention: If errors are detected during installation, other panels might be displayed in place of the Installation complete panel. Examples include the following:
    • Installation is complete with errors panel, which indicates that the installation completed but errors were generated.
    • Installation failed panel, which indicates that the installation failed completely.
    Each of these panels identifies the log file to reference in order to troubleshoot the problems. See the descriptions of relevant log files listed in Log files, error messages in Error messages: installation and profile creation and augmentation, and refer to Troubleshooting installation for tips on troubleshooting your installation. If you performed a Complete installation and the default profile did not create successfully, refer to Recovering from profile creation or augmentation failure for troubleshooting tips.
  10. The Installation complete panel differs depending on the type of installation you performed.
    • If you performed a Complete installation, ensure the check box to launch the First Steps console is selected, and select Finish to close the Installation wizard and launch the First Steps console.
    • If you performed a Client installation, select Finish to close the Installation wizard.
    • If you performed a Custom installation, do one of the following depending on whether you want to create a new profile:
      • To create a new profile, leave the check box beside Launch the Profile Wizard selected and select Next. The Installation wizard closes and the Profile wizard is launched. See Creating profiles using the Profile wizard and Augmenting profiles using the Profile wizard for instructions on how to use this wizard to create new process server profiles or augment existing application server profiles into process server profiles.
      • To not create a new profile, unselect the check box beside Launch the Profile wizard and select Next. In this case, a warning panel is displayed, which explains that without a profile there is no operational server. Do one of the following:
        • Select Back for another chance to launch the Profile wizard.
        • Select Next. The Installation complete panel is displayed with a check box to launch the First Steps console. Ensure that this check box is selected and select Finish to close the Installation wizard and launch the First Steps console.
      Attention: To have an operational environment, a WebSphere Process Server stand-alone profile or deployment manager profile with managed nodes must exist.

Result

If the Installation complete panel is displayed, the components you selected were installed successfully, and in a Complete installation, a stand-alone process server profile named default with a server named server1 was created.

What to do next

If the installation was successful, after you have created a WebSphere Process Server stand-alone server or deployment manager profile, start the server or deployment manager from its First Steps console to verify that your installation is operating properly. See Options on the First Steps console for more details.

You can also use the installation verification tools to verify your installation. See Using the installation verification tools with WebSphere Process Server for more information.


Last updated: Wed 01 Nov 2006 07:47:12

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)