Skip to content

Conversation

@1000TurquoisePogs
Copy link
Member

I am prototyping a set of utilities that can be invoked by zwe validate by a user or zwe itself in order to check if a Zowe install is likely to run successfully or not prior to starting up all the servers and getting complex errors that users may not understand the meaning of.

At this point nothing is set in stone. It is rather a place to dump ideas to return to later.
If this PR becomes more official, this description will be updated to reflect what it can do.

So far, the following exists:

  • zwe validate config: an alias of zwe config validate
  • zwe validate port available: runs the same "is port available" code that apiml startup scripts do, but does it for all enabled components - in the future, apiml would not need that script as this command could handle it.
  • zwe validate directories: validates that key directories exist and are not within the runtime directory since that is not supported
  • zwe validate dependencies: validates that dependencies requested by the environment are met (such as how java is required for apiml, and node is required for app-server, but these are both conditional) - this is what zwe internal start prepare already does, so the code could be moved here to be reusable
  • warns upon possibly okay, but untested dependency versions (node, java, zos)

It could be helpful to invoke these at the last step of zwe init as well as at each startup, to catch as much user error as possible.
I am intending to write a bypass, set in the YAML, so that if any validation fails it can be ignored rather than to prevent some execution, in case our validation logic itself is an error.

@github-actions
Copy link

github-actions bot commented Apr 9, 2025

build 7423 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/14366348265

@github-actions
Copy link

github-actions bot commented Apr 9, 2025

Test workflow 6413 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.2.0-PR-4276/zowe-3.2.0-pr-4276-7423-20250409203131.pax
Running on machine: zzow09
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/14366435218

@github-actions
Copy link

github-actions bot commented Apr 11, 2025

build 7440 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/14410634117


common.printDebug(`Java ${javaVersionShort} is supported.`);
if (tooHigh) {
common.printMessage(`WARNING: Java ${javaVersionShort} is higher than the latest known working version for Zowe, v${JAVA_TESTED_VERSION}.`);
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should probably omit warning when startupcheck for dependency is set false

Copyright Contributors to the Zowe Project.
*/

import * as common from '../../../../libs/common';
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

unsure if port-available is worth keeping if port-bind does the same and more.

@github-actions
Copy link

github-actions bot commented Apr 11, 2025

Test workflow 6423 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.2.0-PR-4276/zowe-3.2.0-pr-4276-7440-20250411193350.pax
Running on machine: zzow11
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/14410713657

@github-actions
Copy link

github-actions bot commented May 29, 2025

build 7772 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15325054649

@github-actions
Copy link

github-actions bot commented May 29, 2025

Test workflow 6692 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-7772-20250529133729.pax
Running on machine: zzow09
Result: SUCCESS
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15325153569

@github-actions
Copy link

github-actions bot commented May 30, 2025

build 7779 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15347011333

@github-actions
Copy link

github-actions bot commented May 30, 2025

Test workflow 6698 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-7779-20250530124548.pax
Running on machine: zzow11
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15347103431

@github-actions
Copy link

github-actions bot commented May 30, 2025

build 7780 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15348868958

@github-actions
Copy link

github-actions bot commented May 30, 2025

Test workflow 6699 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-7780-20250530142637.pax
Running on machine: zzow11
Result: SUCCESS
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15348973307

@github-actions
Copy link

github-actions bot commented May 30, 2025

build 7781 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15349653338

@github-actions
Copy link

github-actions bot commented May 30, 2025

Test workflow 6700 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-7781-20250530150855.pax
Running on machine: zzow09
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15349797364

@github-actions
Copy link

github-actions bot commented May 30, 2025

build 7782 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15349854451

@github-actions
Copy link

github-actions bot commented May 30, 2025

Test workflow 6701 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-7782-20250530151642.pax
Running on machine: zzow09
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15349947250

@github-actions
Copy link

github-actions bot commented May 31, 2025

build 7797 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15361756853

@github-actions
Copy link

github-actions bot commented May 31, 2025

Test workflow 6707 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-7797-20250531081156.pax
Running on machine: zzow10
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15361798958

@github-actions
Copy link

github-actions bot commented May 31, 2025

Test workflow 6707 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-7797-20250531081156.pax
Running on machine: zzow10
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15361798958

@github-actions
Copy link

github-actions bot commented May 31, 2025

build 7798 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15365152048

@github-actions
Copy link

github-actions bot commented May 31, 2025

Test workflow 6708 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-7798-20250531154509.pax
Running on machine: zzow09
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15365192586

@github-actions
Copy link

github-actions bot commented Jun 3, 2025

build 7810 FAILED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15425800856

@github-actions
Copy link

github-actions bot commented Jun 4, 2025

build 7815 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15437623750

@github-actions
Copy link

github-actions bot commented Jun 4, 2025

Test workflow 6723 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-7815-20250604084016.pax
Running on machine: zzow09
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/15437718426

Signed-off-by: 1000TurquoisePogs <[email protected]>
…icate validation. Use validators on zwe internal start prepare operation.

Signed-off-by: 1000TurquoisePogs <[email protected]>
…EnabledComponents for zwe internal start prepare. Seemed to be a prior bug?

Signed-off-by: 1000TurquoisePogs <[email protected]>
…ty about when to pass/fail on unknown errors

Signed-off-by: 1000TurquoisePogs <[email protected]>
Signed-off-by: 1000TurquoisePogs <[email protected]>
Signed-off-by: 1000TurquoisePogs <[email protected]>
Signed-off-by: 1000TurquoisePogs <[email protected]>
@github-actions
Copy link

github-actions bot commented Aug 8, 2025

build 8416 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/16838371750

@github-actions
Copy link

github-actions bot commented Aug 8, 2025

Test workflow 7169 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.3.0-PR-4276/zowe-3.3.0-pr-4276-8416-20250808190606.pax
Running on machine: zzow11
Result: FAILURE
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/16838472800

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status
Status: No status

Development

Successfully merging this pull request may close these issues.

3 participants