Installing WebSphere eXtreme Scale Client with WebSphere Application Server

You can install WebSphere® eXtreme Scale Client in an environment in which WebSphere Application Server or WebSphere Application Server Network Deployment is installed. You can use the existing features of WebSphere Application Server or WebSphere Application Server Network Deployment to enhance your eXtreme Scale applications.

Before you begin

  • Install WebSphere Application Server or WebSphere Application Server Network Deployment. See Installing your application serving environment for more information.
  • Based on what version you install, Version 6.1 or Version 7.0, apply the latest fix pack for WebSphere Application Server or WebSphere Application Server Network Deployment to update your product level. See the Latest fix packs for WebSphere Application Server for more information.
  • Verify that the target installation directory does not contain an existing installation of WebSphere eXtreme Scale Client.
  • Stop all processes that are running in your WebSphere Application Server or WebSphere Application Server Network Deployment environment. See Command-line utilities for more information about the stopManager, stopNode, and stopServer commands.
    CAUTION:
    Ensure that any running processes are stopped. If the running processes are not stopped, the installation proceeds, creating unpredictable results and leaving the installation in an undetermined state on some platforms.
  • If you are installing the client only, you can either use the DVD to install the client or download the WebSphere eXtreme Scale Client for the specific platform from the downloads section on the Support site.
Important: When you install WebSphere eXtreme Scale Client, it should be in the same directory in which you installed WebSphere Application Server. For example, if you installed WebSphere Application Server in C:\was_root, then you should also choose C:was_root as the target directory for your WebSphere eXtreme Scale Client installation.

About this task

Integrate eXtreme Scale with WebSphere Application Server or WebSphere Application Server Network Deployment to apply the features of eXtreme Scale to your Java™ Platform, Enterprise Edition applications. Java EE applications host data grids and access the data grids using a client connection.

Procedure

  1. Use the wizard to complete the installation.
    • Run the following script to start the wizard for theWebSphere eXtreme Scale Client installation. The installation files are in the zip file that you download from the downloads section on the Support site:
      • [Linux][Unix] root/WXS_Client/install
      • [Windows] root\WXS_Client\install.bat
    Attention: If you use uniform naming conventions (UNC) to identify file paths in your installation command, the items you anticipate installing may not all be installed after the command runs. To avoid trouble, map the file path to a network drive. Run the install command against the mapped drive. Using a mapped network drive ensures that all the items are installed.
  2. Follow the prompts in the wizard.

    The optional features panel lists the features from which you can choose to install. However, features cannot be added incrementally to the product environment after the product is installed. If you choose not to install a feature with the initial product installation, you must uninstall and reinstall the product to add the feature.

    The Profile augmentation panel lists existing profiles that you can select to augment with the features of eXtreme Scale. If you select existing profiles that are already in use, however, a warning panel is displayed. To continue with the installation, either stop the servers that are configured in the profiles, or click Back to remove the profiles from your selection.

Results

[Windows] If you are installing the WebSphere eXtreme Scale Client on Windows, you might see the following text in the results of the installation:
Success: The installation of the following product was successful:   
WebSphere eXtreme Scale Client.  Some configuration steps have errors. 
For more information, refer to the following log file:  
<WebSphere Application Server install root>\logs\wxs_client\install\log.txt"  
Review the installation log (log.txt) and review the deployment manager 
augmentation log. 
If you see a failure with the iscdeploy.sh file, you can ignore the error. This error does not cause any problems.

What to do next

  • If you are running WebSphere Application Server Version 6.1 or Version 7.0, you can use the Profile Management Tool plug-in or the manageprofiles command.
Parent topic: Installing WebSphere eXtreme Scale Client
Related tasks:
Installing WebSphere eXtreme Scale Client in a stand-alone environment
Installing WebSphere eXtreme Scale Client with silent mode