Bank of Z

Deploy Using Direct USS Access

Use this procedure to deploy Bank of Z by connecting directly to z/OS USS via SSH and running the setup scripts manually. This is the most transparent option because you run each command manually and can observe each stage of the deployment process.

Before you begin, ensure that you have:

  • SSH access to your z/OS system
  • Git installed on z/OS USS
  • A z/OS environment that meets the requirements described in Prerequisites

1. SSH to z/OS

ssh user@your-zos-host

2. Clone the repository

Choose a working directory on USS. You will specify this path in the configuration file in the next step.

export BANK_OF_Z_WORK_DIR=/usr/local/sandboxes/bank-of-z
mkdir -p $BANK_OF_Z_WORK_DIR
cd $BANK_OF_Z_WORK_DIR
git clone https://github.com/IBM/Bank-of-Z.git
cd Bank-of-Z

3. Edit the configuration file

Open the configuration file by using your preferred text editor on USS and update it for your environment:

vi .setup/config/config.yaml

For information about each configuration field, see Environment Configuration.

4. Validate prerequisites

.setup/setup-common.sh validate-prereqs

Verifies that all required tools are installed at the required versions. Resolve any failures before continuing. For more information, see Troubleshooting.

5. Provision middleware

.setup/setup-common.sh environment

Provisions the complete application runtime, including Db2 tables, a CICS region, an IMS region and database, an MQ queue manager, a z/OS Connect server, and the Liberty frontend server. Expect this to take several minutes. Includes prereq check.

6. Build and deploy

.setup/setup-common.sh install-bank-of-z

Includes prereq check. Performs a full application build by using IBM Dependency Based Build (DBB), packages the generated artifacts, deploys them by using Wazi Deploy, and populates the Db2 and IMS databases with sample data. The initial build and deployment typically take 15 to 20 minutes.

Note: Warnings related to the YAML scanner and chown failures are expected and do not indicate a problem.

7. Verify the deployment

Open the Bank of Z frontend in a browser:

HTTP

http://<your-zos-host>:9081/admin.html

HTTPS

https://<your-zos-host>:9445/admin.html

For HTTPS access and certificate configuration, see Accessing Bank of Z over HTTPS.

8. Run post-install verification tests

.setup/setup-common.sh verify-installation

Runs the integration test suite in tests/ against the deployed application. The tests exercise the CICS and IMS API paths and report a pass/fail result for each. All tests must pass before the installation is considered complete.