WebSphere Enterprise Service Bus for z/OS, Version 6.2.0 Operating Systems: z/OS


Installing the server

Running the installation script, zSMPInstall.sh, creates the code definitions needed to run WebSphere® ESB for z/OS® on a WebSphere Application Server for z/OS server. If you are creating a Network Deployment configuration, you must run the installation script on each of the nodes that will belong to the Network Deployment cell.

Before you begin

Before you install the server, you must perform the following steps:
  1. Install and customize WebSphere Application Server for z/OS on the node.
  2. Load the product code from the installation media on to the z/OS system.
  3. Ensure that you have administrator authority on the system so that you can run the installation script.
  4. If you are running the installation script from TSO OMVS, ensure that the region size for the TSO user ID is large enough to run Java™ (typically 150M).
  5. Back up the file system on the server, so that you can restore it if necessary. For more information, see Backing up the WebSphere Application Server for z/OS system.
  6. Ensure that the application server is stopped. For more information, see Starting and stopping the server.

For more information about the installation shell script, see zSMPInstall.sh script.

Optionally, you can use JCL scripts to install the WebSphere ESB product definitions instead of running the zSMPInstall.sh script manually. See JCL for installing WebSphere Process Server into an empty node and JCL for installing WebSphere Process Server into a deployment manager node.

Procedure
  1. Optional: You might need to increase the OMVS time limit to allow the product configuration script time to complete. To increase the OMVS time limit so the session will not time out, enter the following command in the SPSF console:
    SETOMVS MAXCPUTIME=86400
  2. In OMVS, switch to the administrator user ID. For example:
    su wsadmin
  3. Change to the directory in which you want to run the installation script: For example:
    cd /usr/lpp/zWPS/V6R2/zos.config/bin
  4. Add the current directory to your PATH so that you can run the installation script:
    export PATH=.:$PATH
  5. From the command prompt, run the installation script. For example:
    zSMPInstall.sh -smproot /usr/lpp/zWPS/V6R2 -runtime
     /usr/lpp/zWebSphere/V6R2/AppServer -install

    Optionally, you can redirect the standard out messages to a file instead of displaying it in the console but these instructions assume that you are viewing the standard out messages while the script runs.

    If you are uncertain about the progress of the running script, refresh the console display and check the last few messages.

    When the installation script has finished running, the following messages (or similar) are displayed before you are returned to the shell prompt:
    CWPIZ0256I: set up configuration complete                      
    CWPIZ0257I: creating the symbolic links...                     
    CWPIZ0259I: creation of symbolic links complete                
    CWPIZ0260I: doing post install file updates...                 
    CWPIZ0262I: post install updates complete                      
    CWPIZ0263I: running Configuration Manager update...            
    Oct 19, 2007 4:28:16 PM com.ibm.ws390.installer.WPSInstaller   
    INFO: BBZWI218                                                 
    Oct 19, 2007 4:38:16 PM com.ibm.ws390.installer.WPSInstaller   
    WARNING: BBZWI221                                              
    CWPIZ0264I: Configuration Manager update complete              

    When the script has finished running, review the messages that are displayed in the console, checking that there are no error messages displayed.

    If the software did not install successfully, see Troubleshooting the installation and configuration for information about how to assess installation problems.

    Note: If you are creating a network deployment configuration, do not run the job BBOWMNAN to federate the node into the deployment manager at this time. You will federate the node at a later stage, after completing the configuration steps.

Results

The installation code for WebSphere ESB now contains symbolic links to WebSphere Application Server, and the WebSphere Application Server administrative console is updated so that you can use it to administer WebSphere ESB.

What to do next

After you have run the installation script successfully, you are ready to configure the server with WebSphere ESB for z/OS functions. For more information, see Configuring WebSphere ESB for z/OS.

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.zseries.doc/doc/tins_zos_runningthescript.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).