Skip to main content
Version: v2.17.x LTS

Configuring Sysplex for high availability

Configuring Sysplex for high availability

To deploy Zowe high availability, you must set up the Parallel Sysplex® environment. A Parallel Sysplex is a collection of z/OS® systems that cooperatively use certain hardware and software components to achieve a high-availability workload processing environment.

Sysplex environment requirements

Zowe high availability instances require a Sysplex environment that consists of the following:

note

It is highly recommended that Node.js is installed on a shared file system.

Configuring Sysplex Distributor

The following example DVIPA configuration ensures the availability of Zowe in Hot-Standby mode. For example, suppose that you have a Sysplex of two z/OS systems: A, B.

  1. Enable dynamic XCF on each host by adding the following TCP/IP definitions:

    • IPCONFIG SYSPLEXROUTING DYNAMICXCF x.x.x.A 255.255.255.0 1 for SYSA
    • IPCONFIG SYSPLEXROUTING DYNAMICXCF x.x.x.B 255.255.255.0 1 for SYSB
  2. Define a DVIPA for both systems:

     VIPADYNAMIC                                                      
    VIPADEFINE 255.255.255.0 x.x.x.V
    VIPADISTRIBUTE DEFINE DISTM HOTSTANDBY x.x.x.V
    PORT 7554 DESTIP
    x.x.x.A PREFERRED
    x.x.x.B BACKUP
    ENDVIPADYNAMIC

    where,

    • x.x.x.A
      Specifies the home address for SYSA.

    • x.x.x.B
      Specifies the home address for SYSB.

    • x.x.x.V
      Specifies the Dynamic VIP Address.

    • 7554
      Specifies the port number of you Zowe API Mediation Layer Gateway. This should be the same port number you configured for zowe.externalPort in zowe.yaml. See Zowe YAML configuration file reference to learn more about zowe.yaml.

The VIPADISTRIBUTE statement with PREFERRED and BACKUP settings is used to enable automatic dynamic VIPA takeover to occur, if needed.

All Zowe instances are bound to the DVIPA x.x.x.V. With both z/OS systems active in the Sysplex, the preferred Zowe instance, SYSA receives all new incoming requests. If SYSA fails, new work requests to Zowe are routed to the server on SYSB. When SYSA resumes normal operations, new work requests for Zowe are routed to SYSA again. This is the default behavior because the AUTOSWITCHBACK parameter of the VIPADISTRIBUTE statement is in effect by default.

If you do not want the distributor to switch back to the preferred target when it becomes available, you can specify the NOAUTOSWITCHBACK parameter for the VIPADISTRIBUTE statement.

VIPADYNAMIC                                                      
VIPADEFINE 255.255.255.0 x.x.x.V
VIPADISTRIBUTE DEFINE DISTM HOTSTANDBY NOAUTOSWITCHBACK x.x.x.V
PORT 7554 DESTIP
x.x.x.A PREFERRED
x.x.x.B BACKUP
ENDVIPADYNAMIC