From 5f6e4947ff663bd47bad92ef94ef80608625cb06 Mon Sep 17 00:00:00 2001 From: Jakub Balhar Date: Tue, 5 Dec 2023 09:40:40 +0000 Subject: [PATCH 1/9] Add information on EOS Signed-off-by: Jakub Balhar --- _includes/post-download-script.html | 4 + post_download.md | 117 ++++++++++++++++------------ 2 files changed, 70 insertions(+), 51 deletions(-) diff --git a/_includes/post-download-script.html b/_includes/post-download-script.html index 55885e3d..25154aff 100644 --- a/_includes/post-download-script.html +++ b/_includes/post-download-script.html @@ -34,6 +34,10 @@ if (params.has('version')) { document.getElementById('download_link').href = "legal.html?version=" + params.get('version'); + if(params.get('version').toString().startsWith('1')) { + document.getElementById('end-of-support-reminder').style.display = "block"; + } + document.getElementById('page_title').innerText = 'Thank you for downloading the ' + package_name; document.getElementById('verify_drop').innerText = 'Verify Hash and Signature of ' + package_name; document.getElementById('hash_download').href = "https://zowe.jfrog.io/zowe/list/libs-release-local/org/zowe/" + diff --git a/post_download.md b/post_download.md index 28601ddb..99b88240 100644 --- a/post_download.md +++ b/post_download.md @@ -4,58 +4,73 @@ extraHeaders: google-analytics-downloads-header.html extraJs: post-download-script.html ---
-

Thank you for downloading the Zowe binary

-

If you had an issue or your download did not start, please - click here - to try again.


-
- Verify Hash and Signature of Zowe Binary -

These commands are tested on both Mac OS X v10.13.6 and Ubuntu v17.11.

-
-

Step 1 - Verify Hash Code

-

You can download hash code file zowe-1.0.0.pax.sha512, then use this command to check:

- (gpg --print-md SHA512 zowe-1.0.0.pax > zowe-1.0.0.pax.sha512.my) && diff - zowe-1.0.0.pax.sha512.my zowe-1.0.0.pax.sha512 && echo matched || echo "not match" -

If you see "matched" means the binary you have downloaded is the same one that was officially - distributed by the Zowe project. You can delete temporary "zowe-1.0.0.pax.sha512.my" - after that.


-

You can also use other commands, like "sha512", "sha512sum", or "openssl - dgst -sha512" to generate SHA512 hash code. Just those hash code results are in a - different format from what we provided but the values should be the same.

+

Thank you for downloading the Zowe binary

+

+ If you had an issue or your download did not start, please click + here to try again. +

+
+ Verify Hash and Signature of Zowe Binary +

These commands are tested on both Mac OS X v10.13.6 and Ubuntu v17.11.

+
+

Step 1 - Verify Hash Code

+

You can download hash code file zowe-1.0.0.pax.sha512, + then use this command to check:

+ (gpg --print-md SHA512 zowe-1.0.0.pax > zowe-1.0.0.pax.sha512.my) && diff + zowe-1.0.0.pax.sha512.my zowe-1.0.0.pax.sha512 && echo matched || echo "not match" +

If you see "matched" means the binary you have downloaded is the same one that was officially + distributed by the Zowe project. You can delete temporary "zowe-1.0.0.pax.sha512.my" + after that.


+

You can also use other commands, like "sha512", "sha512sum", or "openssl + dgst -sha512" to generate SHA512 hash code. Just those hash code results are in a + different format from what we provided but the values should be the same.

-

Step 2 - Verify With Signature File

-

In addition to the SHA512 hash we ensure that the hash is verifiable as well. This is done by digitally - signing the hash text file with a KEY from one of the Zowe developers.


-

You can download the signature file zowe-1.0.0.pax.asc, - and public key KEYS.

-

There are few steps:

-
    -
  1. Import the public key with command: gpg --import KEYS
    2. -
  2. If you never use gpg before, you may need to generate keys first: gpg --gen-key. - Otherwise, please proceed to next step.
    3. -
  3. Sign the downloaded public key with command: gpg --sign-key KEY
    4. -
  4. Verify the file with command: gpg --verify zowe-1.0.0.pax.asc zowe-1.0.0.pax
    5. -
  5. You can remove the imported key with command: gpg --delete-key KEY
    6. -
-

If you see output like this that matches the info in the public key you downloaded you can be assured - that the binary file you have has come from the Zowe project.

- - gpg:         using RSA key KEY
- gpg: Good signature from "SIGNER (CODE SIGNING KEY) " [full] - -
+

Step 2 - Verify With Signature File

+

In addition to the SHA512 hash we ensure that the hash is verifiable as well. This is done by digitally + signing the hash text file with a KEY from one of the Zowe developers.


+

You can download the signature file zowe-1.0.0.pax.asc, + and public key KEYS.

+

There are few steps:

+
    +
  1. Import the public key with command: gpg --import KEYS
    2. +
  2. If you never use gpg before, you may need to generate keys first: gpg --gen-key. + Otherwise, please proceed to next step.
    3. +
  3. Sign the downloaded public key with command: gpg --sign-key KEY
    4. +
  4. Verify the file with command: gpg --verify zowe-1.0.0.pax.asc zowe-1.0.0.pax
    5. +
  5. You can remove the imported key with command: gpg --delete-key KEY
    6. +
+

If you see output like this that matches the info in the public key you downloaded you can be assured + that the binary file you have has come from the Zowe project.

+ + gpg:         using RSA key KEY
+ gpg: Good signature from "SIGNER (CODE SIGNING KEY) " [full] + +
-
-

Read the Zowe Documentation at docs.zowe.org

-

After you download the Zowe package, you're ready to get started. Read the Zowe documentation to review the - system requirements and follow the instructions to install Zowe.

-

Provide feedback and contribute to Zowe on GitHub

-

View the source code, provide feedback, and contribute to the project through Zowe GitHub.

+ + +
+

Read the Zowe Documentation at docs.zowe.org

+

After you download the Zowe package, you're ready to get started. Read the Zowe documentation to review the + system requirements and follow the instructions to install Zowe.

+

Provide feedback and contribute to Zowe on GitHub

+

View the source code, provide feedback, and contribute to the project through Zowe GitHub.

+
\ No newline at end of file From acca1bf98f4f19972b95efa59f3938200a4e003f Mon Sep 17 00:00:00 2001 From: adam-wolfe <122040687+adam-wolfe@users.noreply.github.com> Date: Tue, 26 Dec 2023 14:51:12 -0500 Subject: [PATCH 2/9] Updates to CLI Vnext items Signed-off-by: adam-wolfe <122040687+adam-wolfe@users.noreply.github.com> --- _data/vnext_changes.yml | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_data/vnext_changes.yml b/_data/vnext_changes.yml index 0d103aba..1e528b73 100644 --- a/_data/vnext_changes.yml +++ b/_data/vnext_changes.yml @@ -39,13 +39,12 @@ **Breaking changes** + - Introduce new format for error messages to improve clarity - Remove V1 profile support - - Change authentication order of preference - Remove deprecated items - [CLI](https://github.com/zowe/zowe-cli/issues/1694) and [Imperative](https://github.com/zowe/imperative/issues/970) **Important updates** - - Support multiple API ML Gateway connections within a single config file. - Provide a Jenkinsfile template to replace shared library (github.com/zowe/zowe-cli-version-controller) - name: Explorer for Intellij From 6d1b8736da192c22f8d545c57fd1efb33182a8da Mon Sep 17 00:00:00 2001 From: adam-wolfe <122040687+adam-wolfe@users.noreply.github.com> Date: Tue, 26 Dec 2023 15:23:49 -0500 Subject: [PATCH 3/9] Fix "try again". Simplify strings. Signed-off-by: adam-wolfe <122040687+adam-wolfe@users.noreply.github.com> --- _includes/post-download-script.html | 58 +++++++++++++++++------------ 1 file changed, 35 insertions(+), 23 deletions(-) diff --git a/_includes/post-download-script.html b/_includes/post-download-script.html index 55885e3d..1a8f8963 100644 --- a/_includes/post-download-script.html +++ b/_includes/post-download-script.html @@ -2,59 +2,72 @@ \ No newline at end of file From 095accdfef6fa196560f1799a1454c6c6c8e1e07 Mon Sep 17 00:00:00 2001 From: Jakub Balhar Date: Wed, 10 Jan 2024 13:31:00 +0000 Subject: [PATCH 4/9] Add API ML Office Hours Signed-off-by: Jakub Balhar Signed-off-by: Jakub Balhar --- _data/vnext_faq.yml | 53 ++++++++++++++++++++++++++++++++++++ _data/vnext_office_hours.yml | 4 +-- 2 files changed, 55 insertions(+), 2 deletions(-) diff --git a/_data/vnext_faq.yml b/_data/vnext_faq.yml index d5a26b27..daf62841 100644 --- a/_data/vnext_faq.yml +++ b/_data/vnext_faq.yml @@ -121,3 +121,56 @@ extenders: answer: | Zowe provides the SBOMs with V3 in updated SPDX Formats. + +consumers: + - name: API ML for Users Frequently Asked Questions + id: questions-apiml-users + questions: + - number: 1 + question: APIML v3 won't support clients with onboarding enabler v2, right? + answer: | + + The API ML in version 3 supports clients with onboarding enablers from version 2. It also works the other way around the onboarding enablers from version 3 will continue working with Zowe v2 + + - number: 2 + question: For us, as for extenders, jump to Java 17 means that we have to maintain 2 separate versions of our application - one with apiml-enabler v2 and another one with v3 to support customers who want to stay with Java 8. Do you have any recommendation or a workaround how to support both java versions? + answer: | + + Plain Java Enabler in v2 will work in v3 - you can keep this for 1 - 2 years + + Using Spring Boot, Java 17 requirement comes from SPRING, recommendation is to MOVE if you are using something from SPRING + + - number: 3 + question: Can you speak about the migration from Zuul to Spring Cloud Gateway? Today there are two separate gateway services in API-ML with separate config. + answer: | + + Goal is to have 1, spring-cloud gateway. The spring-cloud-gateway configuration should move under the component.gateway namespace. We expect to have one cluster od spring cloud gateway ahead of multiple sysplexes and then one cluster on every sysplex. Most of the configuration that was used should remain, new one from Spring Cloud Gateway remains. + + - number: 4 + question: If you have a legacy gateway deployed will there be migration help? / is the old gateway gone? + answer: | + + It is gone in V3, but nothing should change from the point of view of the user… if we discover that is not true we will plan to deliver a configuration utility to help with this transition + + - number: 5 + question: Can you talk us through how a client-side end-user will find and obtain the correct APIML service instance ID for the desired instance of their service? + answer: | + + Since one service can have multiple instances, living on different LPARS or different Environments how can clients identify a specific service on a specific system? + + TODAY - Clients can use the header instance ID to route to a specific instance / get information from specific services via an API on discovery service, but this part is going to be improved in 2Q 2024 + + - number: 6 + question: Will the LPAR id be available for the clients to obtain? + answer: | + + It isn't now, but we will work on this functionality in 2Q 2024 + + - number: 7 + question: Regarding Static Onboarding - we're using a template that Zowe upon startup would find through manifest, then read, fill variables and put into the api-defs directory, no manual user action required. Will this still be available? + answer: | + + It will remain available. The recommendation is through the V3 to move the directory away from Zowe workspace, if it isn't away by now. The zowe.yaml contains parameter specifying where the static definitions directories live components.discovery.alternativeStaticApiDefinitionsDirectories + + + diff --git a/_data/vnext_office_hours.yml b/_data/vnext_office_hours.yml index 8e257066..27eeed44 100644 --- a/_data/vnext_office_hours.yml +++ b/_data/vnext_office_hours.yml @@ -29,8 +29,8 @@ consumers: - date: 01/05/2024 8AM - 9AM ET topic: API Mediation Layer meeting_link: https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7 - recording_link: - materials_link: + recording_link: https://zoom.us/rec/share/iZ6-6mv0qy8tlnaIshVYyEF5fWAREjWYuwuvyyB9v9QKUcAzrpXZArT83qgpmO4u.tQFWMquAL3_sqgug + materials_link: https://ibm.box.com/s/06rtqh1at3nd7q3lgi36ly8uum1h4adn - date: 01/12/2024 8AM - 9AM ET topic: CLI & Node SDK meeting_link: https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7 From fd4c82386721e5f5369a6a46157487fa59f35bbd Mon Sep 17 00:00:00 2001 From: Jakub Balhar Date: Thu, 11 Jan 2024 10:16:16 +0100 Subject: [PATCH 5/9] Update contribute.md Signed-off-by: Jakub Balhar --- contribute.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contribute.md b/contribute.md index 41c2cbfb..9e0e8632 100644 --- a/contribute.md +++ b/contribute.md @@ -29,7 +29,7 @@

Hosted by the Open Mainframe Project, this is a messaging board where you can directly engage with Zowe users and contributors - ask questions, engage in discussions, and contribute your ideas!

Some popular channels to get started:

  • #zowe-onboarding
    • -
  • #zowe-user
    • +
  • #zowe-help
  • #zowe-cli
  • #zowe-explorer
  • #zowe-api
    • @@ -146,4 +146,4 @@ - {% endif %} --> \ No newline at end of file + {% endif %} --> From 33d816ff25705b5c51440af546757265c517a39f Mon Sep 17 00:00:00 2001 From: Jakub Balhar Date: Thu, 18 Jan 2024 09:27:11 +0000 Subject: [PATCH 6/9] Add the CLI & SDK Office Hours Signed-off-by: Jakub Balhar --- _data/vnext_office_hours.yml | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/_data/vnext_office_hours.yml b/_data/vnext_office_hours.yml index 27eeed44..2175a64a 100644 --- a/_data/vnext_office_hours.yml +++ b/_data/vnext_office_hours.yml @@ -32,10 +32,15 @@ consumers: recording_link: https://zoom.us/rec/share/iZ6-6mv0qy8tlnaIshVYyEF5fWAREjWYuwuvyyB9v9QKUcAzrpXZArT83qgpmO4u.tQFWMquAL3_sqgug materials_link: https://ibm.box.com/s/06rtqh1at3nd7q3lgi36ly8uum1h4adn - date: 01/12/2024 8AM - 9AM ET - topic: CLI & Node SDK + topic: CLI meeting_link: https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7 - recording_link: - materials_link: + recording_link: https://zoom.us/rec/share/oWx79e8rAeAMFSikY9klU0-zURSE4TBZGxUQg33aqsBRPQs8LWQuE8DG4qIWy4fK.bGhUwOZitTNq0gYz + materials_link: https://ibm.box.com/s/aqcwrc83i8uq9llyo3kae8pjxi0p1xlb + - date: 01/12/2024 8AM - 9AM ET + topic: Node SDK + meeting_link: https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7 + recording_link: https://zoom.us/rec/share/oWx79e8rAeAMFSikY9klU0-zURSE4TBZGxUQg33aqsBRPQs8LWQuE8DG4qIWy4fK.bGhUwOZitTNq0gYz + materials_link: https://ibm.box.com/s/ujdkjfb6f1zhx4amse1x7aysdb76ai80 - date: 01/19/2024 8AM - 9AM ET topic: Explorer (VSCode) meeting_link: https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7 From e7cc1d019bbf86be716b4f7f8b84b497178a0fd9 Mon Sep 17 00:00:00 2001 From: Jakub Balhar Date: Mon, 22 Jan 2024 08:58:33 +0100 Subject: [PATCH 7/9] Change to Node CLient SDK Signed-off-by: Jakub Balhar --- _data/vnext_office_hours.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_data/vnext_office_hours.yml b/_data/vnext_office_hours.yml index 2175a64a..aee397e4 100644 --- a/_data/vnext_office_hours.yml +++ b/_data/vnext_office_hours.yml @@ -37,7 +37,7 @@ consumers: recording_link: https://zoom.us/rec/share/oWx79e8rAeAMFSikY9klU0-zURSE4TBZGxUQg33aqsBRPQs8LWQuE8DG4qIWy4fK.bGhUwOZitTNq0gYz materials_link: https://ibm.box.com/s/aqcwrc83i8uq9llyo3kae8pjxi0p1xlb - date: 01/12/2024 8AM - 9AM ET - topic: Node SDK + topic: Node Client SDK meeting_link: https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7 recording_link: https://zoom.us/rec/share/oWx79e8rAeAMFSikY9klU0-zURSE4TBZGxUQg33aqsBRPQs8LWQuE8DG4qIWy4fK.bGhUwOZitTNq0gYz materials_link: https://ibm.box.com/s/ujdkjfb6f1zhx4amse1x7aysdb76ai80 From e8e1198d532492dcfd39bf755537f8a538a90575 Mon Sep 17 00:00:00 2001 From: Jakub Balhar Date: Mon, 22 Jan 2024 09:01:11 +0100 Subject: [PATCH 8/9] Add Explorers Signed-off-by: Jakub Balhar --- _data/vnext_office_hours.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_data/vnext_office_hours.yml b/_data/vnext_office_hours.yml index aee397e4..b5a5b031 100644 --- a/_data/vnext_office_hours.yml +++ b/_data/vnext_office_hours.yml @@ -44,8 +44,8 @@ consumers: - date: 01/19/2024 8AM - 9AM ET topic: Explorer (VSCode) meeting_link: https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7 - recording_link: - materials_link: + recording_link: https://zoom.us/rec/share/DjXmEXpMaQKTww7czM2IgDpHvUPi4ltC7DsrvNXI0EX1pBel3S4F7cgLXp_qOo-y.ChpJROsc0PhkhAh4 + materials_link: https://ibm.box.com/s/366i3i576c3r2s6kn3sqtwxzsj9lcpzm - date: 01/26/2024 8AM - 9AM ET topic: Explorer (Intellij) meeting_link: https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7 From cb6f1774fd48d59933a12e9dbe2b5ad1cc368d6d Mon Sep 17 00:00:00 2001 From: MarkAckert Date: Fri, 26 Jan 2024 11:23:43 -0500 Subject: [PATCH 9/9] prepare 2.14.0 release Signed-off-by: MarkAckert --- _data/releases.yml | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/_data/releases.yml b/_data/releases.yml index a0c6d9e1..efc88677 100644 --- a/_data/releases.yml +++ b/_data/releases.yml @@ -2,15 +2,29 @@ # Note - keep this in order as the latest release is pulled from the first item in the list! future: v2: + - version: 2.15.1 + release_date: 2024-05-27 - version: 2.15.0 release_date: 2024-03-04 - - version: 2.14.0 - release_date: 2024-01-22 v1: - version: 1.28.6 release_date: 2024-09-30 v2: + - version: 2.14.0 + zos_version: 2.14.0 + smpe_version: 2.14.0 + smpe_sysmod: PTF + smpe_numbers: UO90047 UO90048 + containerization_version: 2.13.0 + cli_version: 2.14.0 + cli_plugins_version: 2.14.0 + explorer_version: 2.14.0 + node_sdk_version: 2.14.0 + python_sdk_version: 2.14.0 + release_date: 2023-01-26 + documentation: stable + release_notes: v2_14_0 - version: 2.13.0 zos_version: 2.13.0 smpe_version: 2.13.0 @@ -23,7 +37,7 @@ v2: node_sdk_version: 2.13.0 python_sdk_version: 2.13.0 release_date: 2023-12-14 - documentation: stable + documentation: v2_13_x release_notes: v2_13_0 - version: 2.12.0 zos_version: 2.12.0