Skip to content

Commit

Permalink
Merge pull request #91 from zowe/1000TurquoisePogs-patch-2
Browse files Browse the repository at this point in the history
New readme
  • Loading branch information
1000TurquoisePogs authored Jul 28, 2023
2 parents 32e0a3a + 44127c9 commit 7b324f9
Showing 1 changed file with 13 additions and 12 deletions.
25 changes: 13 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,10 @@ Copyright Contributors to the Zowe Project.

<h1 align="center">Zowe Launcher</h1>

This is a POC project with the goal to provide an advanced launcher for Zowe components.
The Zowe launcher is a part of the Zowe server architecture that was added as an optional program for HA/FT usage in v1.
In v2, the Zowe laucher became the sole way to start the Zowe servers.
The launcher's purpose is to start, restart, and stop each Zowe server component which has a `start` command,
And in doing so it watches over such components for health (restarting them if they crash) and log management.

## Current features
* Stopping Zowe using the conventional `P` operator command
Expand All @@ -35,14 +38,12 @@ The launcher binary will be saved into the bin directory.

## Deployment

* Specify the Zowe installation and instance directories in `zowe.conf`
* Run `patch-zowe.sh` to apply the require Zowe changes
* Copy the launcher JCL (`samplib/ZWELNCH`) to your PROCLIB
* Edit the JCL and specify the launcher directory in the WORKDIR variable

## Component configuration

Edit `components.conf` to add and remove components. The configuration consists of key-value pairs, where a key is a component name and a value is the path to the component binary.
* Find the JCL used to start your Zowe instance (ZWESLSTC)
* Stop that Zowe instance
* Find the dataset used by that STC
* Copy the binary from the bin directory into that dataset with whatever name you want
* If necessary, update the PGM name to match the name of the resulting copy you just did
* Restart that Zowe instance

## Operating the launcher

Expand All @@ -67,6 +68,6 @@ F ZWELNCH,APPL=START(component_name)
F ZWELNCH,APPL=DISP
```

## The project should fix the following issues
* https://github.com/zowe/zowe-install-packaging/issues/1137
* https://github.com/zowe/zowe-install-packaging/issues/790
## Community

This part of Zowe is currently developed by the zOS squad, which you can find on Slack at #zowe-zos-interface or

0 comments on commit 7b324f9

Please sign in to comment.