diff --git a/.gitignore b/.gitignore index 68045474..204719fe 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,5 @@ _site .DS_Store -Gemfile.lock \ No newline at end of file +Gemfile.lock +.jekyll-metadata +.vscode/ diff --git a/_config.yml b/_config.yml index a1ad82a7..a0d3821e 100644 --- a/_config.yml +++ b/_config.yml @@ -19,7 +19,7 @@ mailing_list_user_url: https://lists.openmainframeproject.org/g/zowe-user youtube_zowe_url: https://www.youtube.com/playlist?list=PL8REpLGaY9QE_9d57tw3KQdwSVLKuTpUZ conformance_page_url: https://www.openmainframeproject.org/projects/zowe/conformance omp_calendar_url: https://zoom-lfx.platform.linuxfoundation.org/meetings/zowe -zos_download_url: legal.html?version= +zos_download_url: legal.html?type=pax&version= containerization_download_url: legal.html?type=containerization&version= cli_download_url: legal.html?type=cli&version= cli_plugins_download_url: legal.html?type=cli-plugins&version= @@ -44,6 +44,7 @@ zowe_v2_fmid_oss_version: 2.0.0 zos_component_install_doc_url: https://docs.zowe.org/stable/user-guide/install-zos.html zowe_containerization_install_doc_url: https://docs.zowe.org/stable/user-guide/k8s-introduction zowe_cli_install_doc_url: https://docs.zowe.org/stable/user-guide/cli-install-cli-checklist +zowe_intellij_explorer_install_doc_url: https://docs.zowe.org/stable/user-guide/intellij-install zowe_explorer_install_doc_url: https://docs.zowe.org/stable/user-guide/ze-install zowe_sdk_install_doc_url: https://docs.zowe.org/stable/user-guide/sdks-using vscode_marketplace_url: https://marketplace.visualstudio.com/items?itemName=Zowe.vscode-extension-for-zowe @@ -66,6 +67,7 @@ zowe_cli_db2_plugin_url: https://github.com/zowe/zowe-cli-db2-plugin zowe_cli_ftp_plugin_url: https://github.com/zowe/zowe-cli-ftp-plugin zowe_cli_ims_plugin_url: https://github.com/zowe/zowe-cli-ims-plugin zowe_cli_mq_plugin_url: https://github.com/zowe/zowe-cli-mq-plugin +zowe_intellij_explorer_marketplace_url: https://plugins.jetbrains.com/plugin/18688-zowe-explorer zowe_explorer_doc_url: https://docs.zowe.org/stable/user-guide/ze-install.html#installing-zowe-explorer zowe_explorer_github_url: https://github.com/zowe/zowe-explorer-vscode zowe_explorer_slack_url: https://openmainframeproject.slack.com/archives/CUVE37Z5F diff --git a/_data/releases.yml b/_data/releases.yml index 4b550479..def45fb4 100644 --- a/_data/releases.yml +++ b/_data/releases.yml @@ -1,13 +1,33 @@ # List of Zowe releases - update here and it will update the entire site :-) # Note - keep this in order as the latest release is pulled from the first item in the list! future: + v3: + - version: 3.1.0 + release_date: 2025-02-03 v2: - version: 2.18.1 - release_date: 2025-01-15 + release_date: 2025-02-24 v1: - version: 1.28.8 release_date: 2024-10-14 +v3: + - version: 3.0.0 + zos_version: 3.0.0 + smpe_version: 3.0.0 + smpe_sysmod: + smpe_numbers: + containerization_version: 3.0.0 + cli_version: 3.0.0 + cli_plugins_version: 3.0.0 + intellij_explorer_version: 3.0.0 + explorer_version: 3.0.0 + node_sdk_version: 3.0.0 + python_sdk_version: 3.0.0 + release_date: 2024-10-01 + documentation: stable + release_notes: v3_0_0 + v2: - version: 2.18.0 zen_version: 1.0.1 diff --git a/_includes/common.html b/_includes/common.html new file mode 100644 index 00000000..f0e83970 --- /dev/null +++ b/_includes/common.html @@ -0,0 +1,59 @@ + + diff --git a/_includes/legal-script.html b/_includes/legal-script.html index 64178d48..cdbf9028 100644 --- a/_includes/legal-script.html +++ b/_includes/legal-script.html @@ -2,189 +2,197 @@ diff --git a/_includes/post-download-script-legacy.html b/_includes/post-download-script-legacy.html new file mode 100644 index 00000000..b4682d4b --- /dev/null +++ b/_includes/post-download-script-legacy.html @@ -0,0 +1,96 @@ + + \ No newline at end of file diff --git a/_includes/post-download-script.html b/_includes/post-download-script.html index a018fcdc..b1727eb2 100644 --- a/_includes/post-download-script.html +++ b/_includes/post-download-script.html @@ -1,116 +1,86 @@ \ No newline at end of file diff --git a/_layouts/default.html b/_layouts/default.html index 9913a496..04c34b63 100644 --- a/_layouts/default.html +++ b/_layouts/default.html @@ -32,7 +32,7 @@ - + @@ -72,7 +72,7 @@ Future
  • - go to Zowe Docs + Go to Zowe Docs
    • @@ -112,6 +112,14 @@
    Copyright © Zowe a Series of LF Projects, LLC. For web site terms of use, trademark policy and other project policies please see lfprojects.org.
    - {% if page.extraJs %}{% include {{ page.extraJs }} %}{% endif %} + {% if page.extraJs %} + {% if page.extraJs.first %} + {% for js in page.extraJs %} + {% include {{ js }} %} + {% endfor %} + {% else %} + {% include {{ page.extraJs }} %} + {% endif %} + {% endif %} diff --git a/assets/css/style.css b/assets/css/styles.css similarity index 100% rename from assets/css/style.css rename to assets/css/styles.css diff --git a/download.md b/download.md index 594be759..cd4306a5 100644 --- a/download.md +++ b/download.md @@ -34,6 +34,15 @@

    + + + + + + Latest V3 Release + @@ -61,6 +70,15 @@ Technical Preview + + + + + + All Zowe V3.x Releases + @@ -112,6 +130,224 @@

    + +

    Zowe V3

    + {% if site.data.releases.v3[0].cli_version and site.data.releases.v3[0].cli_plugins_version and site.data.releases.v3[0].zos_version and site.data.releases.v3[0].smpe_version and site.data.releases.v3[0].node_sdk_version and site.data.releases.v3[0].python_sdk_version %} +
    +
    +

    Server-side component installer

    +
    +

    Install Zowe z/OS components from the convenience build, the SMP/E build, + the PSWI build or the containerization build depending on your need.

    +
    +
    +
    Convenience build
    +

    PAX archive format installed on the z/OS server

    +

    Zowe + {{ site.data.releases.v3[0].zos_version }} z/OS Convenience build

    + +
    +
    +
    SMP/E build
    +

    SMP/E format installed on the z/OS server

    + +

    Download the base FMID AZWE003 (based on v3.0.0) + {% if site.data.releases.v3[0].smpe_sysmod and site.data.releases.v3[0].smpe_numbers %} + first and then apply the PTFs + {% endif %} + to get the latest version.

    +

    Zowe 3.0.0 + FMID {{ site.zowe_v3_fmid }}

    + {% if site.data.releases.v3[0].smpe_sysmod and site.data.releases.v3[0].smpe_numbers %} +

    Zowe + {{ site.data.releases.v3[0].zos_version }} {{ site.data.releases.v3[0].smpe_sysmod }} + {{ site.data.releases.v3[0].smpe_numbers }}

    + {% endif %} + +
    +
    +
    Zowe Portable Software Instance
    +

    The Zowe Portable Software Instance (PSWI) is a new way of z/OS component + distribution. The PSWI allows the full installation as you are used to from SMP/E build, but it uses the + new standard for mainframe software distribution.

    +

    Download the PSWI based on FMID AZWE003

    +

    Zowe PSWI + {{ site.data.releases.v3[0].zos_version }}

    + +
    +
    +
    Containerization build
    +

    Files to launch Zowe in a container environment like Kubernetes

    +

    + {% if site.data.releases.v3[0].containerization_version %} + Zowe + {{ site.data.releases.v3[0].containerization_version }} Containerization build + {% else %} + Zowe + {{ site.data.releases.v3[0].zos_version }} Containerization build + {% endif %} +

    + +
    +
    +
    +
    +
    +

    Client-side component installer

    +
    +

    Install Zowe CLI, Zowe Client SDKs, Zowe Explorer for VSCode, or Zowe Explorer for IntelliJ IDEA, a rich set of client tools for easier interaction with the mainframe.

    +
    +
    +
    Zowe CLI
    +

    Install Zowe CLI from the local package or from an npm registry if your computer is + connected to the Internet.

    +

    Download the Zowe CLI core package and optionally download the plug-ins (CICS, Db2, + IMS, MQ, z/OS FTP, and so on) to gain more capabilities.

    +

    Zowe + {{ site.data.releases.v3[0].cli_plugins_version }} CLI Core

    +

    Zowe + {{ site.data.releases.v3[0].cli_plugins_version }} CLI Plug-ins

    + +
    +
    +
    Zowe Client SDKs
    +

    Download the Zowe Software Development Kits (SDKs) for use in development and + automation.

    +

    Zowe + {{ site.data.releases.v3[0].node_sdk_version }} Node.js Client SDK

    + +
    +
    +
    Zowe Explorer for VSCode
    +

    Zowe Explorer for VSCode V3 no longer supports V1 profiles. If you are using V1 profiles with V2, you must migrate them to the new format.

    +

    Zowe Explorer downloads are available on the VSCode Marketplace. To view installation instructions for the VSCode Marketplace, follow the installation docs link below.

    +
    Direct download
    +

    To download the V3 version of the FTP and CICS extensions, click Zowe Explorer {{ site.data.releases.v3[0].explorer_version }}. Separate downloads are available for Zowe Explorer and Zowe Explorer + Extension for FTP.

    +

    To install the .vsix files, use Extensions > Install from vsix within + VS Code.

    + +
    +
    +
    Zowe Explorer for IntelliJ IDEA
    +

    Zowe Explorer for IntelliJ IDEA brings support for browsing, editing and creating data on z/OS in IntelliJ IDEA.

    +
    Marketplace Installation
    +

    Zowe Explorer for IntelliJ is available through the IntelliJ Marketplace.

    + +
    +
    +
    +
    +
    + {% endif %} +

    Zowe V2

    {% if site.data.releases.v2[0].cli_version and site.data.releases.v2[0].cli_plugins_version and site.data.releases.v2[0].zos_version and site.data.releases.v2[0].smpe_version and site.data.releases.v2[0].node_sdk_version and site.data.releases.v2[0].python_sdk_version and site.data.releases.v2[0].zen_version %} @@ -596,6 +832,64 @@ +

    All Zowe V3.x Releases

    +

    Download releases of Zowe V3.x by version number. The future release dates are tentative and may change.

    +
    + + {% for release in site.data.releases.future.v3 %} + + + + + + + + + {% endfor %} + {% for release in site.data.releases.v3 %} + + + + {% if release.zos_version %} + + {% else %} + + {% endif %} + {% if release.smpe_version and release.smpe_sysmod == "PE-PTF" %} + + {% elsif release.smpe_version and release.smpe_sysmod %} + + {% else %} + + {% endif %} + {% if release.cli_version and release.cli_plugins_version %} + + {% else %} + {% if release.cli_version %} + + {% else %} + + {% endif %} + {% endif %} + {% if release.cli_plugins_version %} + + {% else %} + + {% endif %} + {% if release.documentation == 'versions' %} + + {% else %} + + {% endif %} + + + {% if forloop.last %} +
    Zowe {{release.version}} ({{release.release_date}})
    Zowe {{release.version}} ({{release.release_date}})z/OS Convenience buildSMP/E {{release.smpe_sysmod}} {{release.smpe_numbers}}SMP/E {{release.smpe_sysmod}} + {{release.smpe_numbers}}CLI CoreCLICLICLI Plug-insDocumentationDocumentation
    +
    + {% endif %} + {% endfor %} +

    All Zowe V2.x Releases

    Download releases of Zowe V2.x by version number. The future release dates are tentative and may change.

    @@ -761,14 +1055,6 @@

    Zowe Extensions V3 Compatibility, Conformance, and Availability Statement

    General
    Backward Compatibility
    -

    Zowe v2 conformant extensions / plug-ins are not guaranteed to be compatible with Zowe v3 and therefore may - not be operable. In general, plug-ins/extensions which leverage v2 APIs that have known “breaking changes” are at - high risk of incompatibility and unpredictable results.

    -

    Recommendation: ALL v2 extenders test with the Zowe v3, identify any issues, and disclose results to - consumers to clearly indicate backward compatibility status in the extension documentation. If unable to test, - clearly document as such.

    -
    - Forward Compatibility

    Zowe v3 conformant (planning to earn conformance) extensions / plug-ins are not guaranteed to be compatible with Zowe v2 LTS. In general, plug-ins / extensions with no known dependency on any newly introduced Zowe v3 functions are at minimum risk.

    @@ -776,23 +1062,21 @@ consumers to clearly indicate forward compatibility status in the extension documentation. If unable to test, clearly document as such.


    - Conformance Compatibility
    + Forward Compatibility
    +

    Zowe v2 conformant extensions / plug-ins are not guaranteed to be compatible with Zowe v3 and therefore may + not be operable. In general, plug-ins/extensions which leverage v2 APIs that have known “breaking changes” are at + high risk of incompatibility and unpredictable results.

    +

    Recommendation: ALL v2 extenders test with the Zowe v3, identify any issues, and disclose results to + consumers to clearly indicate backward compatibility status in the extension documentation. If unable to test, + clearly document as such.

    +
    + Conformance Program and Zowe v3

    Zowe v2 conformant extensions / plug-ins are likely to require changes to meet Zowe v3 conformance criteria. All extensions (regardless of v2 conformance status) must apply for v3 conformance and satisfy all required v3 testing criteria.

    Recommendation: All extenders interested in earning v3 conformance review the v3 conformance criteria, determine if technical changes are necessary, make appropriate modifications and prepare to apply for v3 conformance prior to v3 LTS publication.

    - Zowe v3 Availability to Extenders
    - Early Access Software
    -

    Several pre-GA releases of Zowe v3 will be made available to Zowe extenders and the general public prior* to the - actual Zowe v3 GA release delivery to allow extenders time to perform Zowe v3 testing with their extensions and - disclose their compatibility status. (The PAX and SMP/E builds are available since Dec 2023)

    - Early Access Conformance Criteria
    -

    The Zowe v3 conformance criteria for all extensions/plugins participating in the conformance program will be made - available to all Zowe v2 conformant extenders prior* to the Zowe v3 GA release to give extenders time to adapt to - applicable changes. (*dates to-be-determined) Note: See Zowe Support Provider conformance section below for details - on v3 Support Provider conformance.

    More Information

    Visit the Zowe v3 release page at https://zowe.org/vNext.html for comprehensive information related to the V3 release.

    @@ -808,7 +1092,7 @@
  • Nightly builds are made available to allow preview and early distribution of in-progress work items which may be functionally incomplete and unstable. The coverage and successful execution of tests has not been guaranteed and the builds should be treated accordingly.
    • -
  • The latest build status is available from #zowe-build +
  • The latest build status is available from #zowe-nightly-builds Slack channel.
  • A nightly build will be removed about 30 days after release.
    • diff --git a/index.md b/index.md index 743d06c4..03aa7e7f 100644 --- a/index.md +++ b/index.md @@ -64,8 +64,9 @@ redirect_from: - +{% assign currentTime = 'now' | date: '%s' | plus: 0 %} {% assign announcements = site.data.announcements %} +{% assign release_date_v3 = site.data.releases.v3[0].release_date | date: '%s' | plus: 0 %} {% assign release_date_v2 = site.data.releases.v2[0].release_date | date: '%s' | plus: 0 %} {% assign release_date_v1 = site.data.releases.v1[0].release_date | date: '%s' | plus: 0 %} {% assign week_time = 1209600 %} @@ -84,6 +85,13 @@ redirect_from: {% assign version_v2_announcements= version_v2_announcements | split: "~" %} {% assign announcements = version_v2_announcements | concat: announcements %} {% endif %} +{% if release_date_v3 > today_minus_week %} + {% capture version_v3_announcements %} + Zowe version {{ site.data.releases.v2[0].version }} is now available. You can download the installers for this release from the Download page. To learn what's new in this release, see the Release notes. + {% endcapture %} + {% assign version_v3_announcements= version_v3_announcements | split: "~" %} + {% assign announcements = version_v3_announcements | concat: announcements %} +{% endif %}
    @@ -111,6 +119,17 @@ redirect_from: {% assign next_version = 2.7 %} {% assign next_version_date = currentTime %} {% assign minimum_difference = 9999999 %} +{% for release in site.data.releases.future.v3 %} + {% assign current_release_date = release.release_date | date: '%s' | plus: 0 %} + {% if current_release_date > currentTime %} + {% assign difference_in_seconds = current_release_date | minus: currentTime %} + {% if difference_in_seconds < minimum_difference %} + {% assign minimum_difference = difference_in_seconds %} + {% assign next_version_date = release.release_date %} + {% assign next_version = release.version %} + {% endif %} + {% endif %} +{% endfor %} {% for release in site.data.releases.future.v2 %} {% assign current_release_date = release.release_date | date: '%s' | plus: 0 %} {% if current_release_date > currentTime %} diff --git a/legal.md b/legal.md index a96e6bc8..88d6c1a1 100644 --- a/legal.md +++ b/legal.md @@ -1,7 +1,7 @@ --- title: "Download" extraHeaders: google-analytics-downloads-header.html -extraJs: legal-script.html +extraJs: [common.html, legal-script.html] ---

    diff --git a/post_download.md b/post_download.md index 99b88240..29d768f7 100644 --- a/post_download.md +++ b/post_download.md @@ -1,58 +1,89 @@ --- title: "Download" extraHeaders: google-analytics-downloads-header.html -extraJs: post-download-script.html +extraJs: [common.html, post-download-script.html] --- -
    +

    Thank you for downloading the Zowe binary

    - If you had an issue or your download did not start, please click + 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] -     + How to verify binaries with digital signatures +
    +

    All Zowe binaries are signed using Sigstore, an OpenSSF project.

    +

    Pre-Requisites

    + +

    Download the Verification Bundle

    +

    +

    Online Verification

    + +

    This verification method is the preferred option for digital signature validation, and requires an internet connection with access to the public sigstore infrastructure to work (*.sigstore.dev). + Ensure that the the artifact you downloaded and its respective signing bundle you acquired from the pre-requisite step are in the same directory. + Navigate to that directory with your terminal, and issue the following command:

    + + cosign verify-blob ./artifact-you-downloaded --bundle ./bundle-you-downloaded + --certificate-identity=https://github.com/zowe/zowe-install-packaging/.github/workflows/build-packaging.yml@refs/heads/v3.x/master + --certificate-oidc-issuer=https://token.actions.githubusercontent.com +

    + + If the verification succeeded, you will see:
    + + Verified OK

    + + If the veritication failed, you will see:
    + + Error: error verifying bundle: matching bundle to payload: ....more output +

    + +

    Offline Verification

    + +

    This verification method is >>not<< the preferred option for digital signature validation, as the signature is not compared against the public transparency log. This method is useful mostly for artifact hash validation. + Ensure that the the artifact you downloaded and its respective signing bundle you acquired from the pre-requisite step are in the same directory. + Navigate to that directory with your terminal, and issue the following command:

    + + cosign verify-blob ./artifact-you-downloaded --bundle ./bundle-you-downloaded --offline=true + --certificate-identity=https://github.com/zowe/zowe-install-packaging/.github/workflows/build-packaging.yml@refs/heads/v3.x/master + --certificate-oidc-issuer=https://token.actions.githubusercontent.com +

    + + If the verification succeeded, you will see:
    + + Verified OK

    + + If the veritication failed, you will see:
    + + Error: error verifying bundle: matching bundle to payload: ....more output
    +
    + +