diff --git a/docs/whats-new/zowe-v3-conformance-criteria.md b/docs/whats-new/zowe-v3-conformance-criteria.md new file mode 100644 index 0000000000..b55f22c422 --- /dev/null +++ b/docs/whats-new/zowe-v3-conformance-criteria.md @@ -0,0 +1,25 @@ +# Zowe V3 conformance criteria + +The final version of Zowe V3 Conformance Criteria is published here. + +See the link in each section for a PDF with the specific criteria for the corresponding project. + +## Zowe API Mediation Layer + +Review the [API Mediation Layer related conformance criteria](https://ibm.box.com/s/qin12i90slsxzv2zdpiq4we6o6157gh5). + +## Zowe CLI + +Review the [CLI related conformance criteria](https://ibm.box.com/s/d8dgrx37k42wi2o92bk6vglfdazmkte9). + +## Zowe Explorer + +Review the [Explorer related conformance criteria](https://ibm.box.com/s/xmiwe01li8n0mgx4wpj68dqpsw2ybati). + +## Zowe Application Framework + +Review the [Application Framework related conformance criteria](https://ibm.box.com/s/krk4cckl7mo1wgmjkghv1s82q8cu5rx1). + +## Support providers + +Review the [support providers related conformance criteria](https://ibm.box.com/s/ok85oj6eflnpxsxvp1rntrebjbhebuk1). diff --git a/docs/whats-new/zowe-v3-frequently-asked-questions.md b/docs/whats-new/zowe-v3-frequently-asked-questions.md new file mode 100644 index 0000000000..0247009e96 --- /dev/null +++ b/docs/whats-new/zowe-v3-frequently-asked-questions.md @@ -0,0 +1,113 @@ +# Zowe V3 Frequently Asked Questions + +## General questions + +1. When will Zowe V3 be released? + + Zowe V3 is scheduled to be released on Sept. 28, 2024. Any changes to the plan will be communicated via all available channels. + +2. When will Zowe V3 be available for preview? + + Currently, Zowe V3 pre-release versions are available for the PAX, Zowe CLI, Zowe Client Node.js SDKs, Zowe Explorer for Visual Studio Code, and the Zowe IntelliJ Plug-in. + +## Extender questions + +### API Mediation Layer + +1. Do we need to move away from PassTickets as the method of authentication to the API Mediation Layer? + + No, we will continue to support PassTickets. However, PassTickets will be deprecated in Zowe V3, and are no longer recommended due to the inefficiency of configuration wherein users must configure a PassTicket for every service that uses them. + +2. With the introduction of the new cloud gateway, how is the configuration going to change? + + The cloud gateway configuration for V3 will move to the currently used gateway configuration space (For example, `zowe.components.gateway`).The configuration that was Zuul specific will be removed and replaced with the Spring Cloud Gateway configuration. + +3. How does client certificate authentication work in Zowe V3? + + Northbound authentication accepts client certificates. The API Mediation Layer then transforms the client certificate to another method of authentication (such as a JWT token, SAF IDT, or PassTicket). This new method is then accepted by southbound services. Currently, we do not plan to support authentication with client certificates to z/OSMF. + +4. Will you identify deprecated functionality such as PassTickets? + + PassTickets will be deprecated in V3, but they will still be supported, possibly even through to Zowe V4. + + We plan to identify all deprecated functionality. We will announce how this functionality will be identified in the near future. + +5. How do you intend to work with the the bypass scheme? + + The bypass scheme will remain. You can still claim conformance for services that only provide public endpoints that do not require authentication. + +6. Do the dependency changes mean that I need Java 17 to run Zowe V3? + + Yes, Java 17 is required to run the API Mediation Layer in Zowe V3. + +### Zowe Explorer for Visual Studio Code + +1. Will the functionality to convert Zowe V1 profiles to team configuration remain available for Zowe V3? + + Yes. However, users will not be able to use Zowe V1 profiles to connect to services on the mainframe. + +2. Will the APIs that Zowe CLI provides for extenders remain the same? + + In broad terms, yes. However, some of the functionality that was available in Zowe V2 has been changed (or removed). The changes are included in the [Zowe CLI](https://ibm.ent.box.com/s/vqu92d82b4wk0i6fupo8glbrxvufn4zw) and [Imperative](https://github.com/zowe/imperative/issues/970) lists of breaking changes. + +### Zowe Application Framework, ZSS + +1. Is it possible to run 31-bit plug-ins at the same time as 64-bit plug-ins with ZSS? + + No. ZSS runs in either 31-bit or 64-bit mode, which means it can accommodate only one type of plug-in. + +2. Are Angular and Webpack updated to the latest current versions? + + In Zowe V3, the Application Framework uses Angular 16 and Webpack 5, which are the latest current releases. + +3. What _React_ versions are supported by Zowe Desktop? + + It is possible for Desktop extensions to use different versions of _React_. While the Desktop is not built on _React_, it is still compatible with extensions that import _React_. + +4. Is the Zowe Server Install Wizard application running on Zowe Desktop or on z/OS? + + The Zowe Server Install Wizard runs on a laptop/desktop and connects to z/OS via standard methods. + +5. Is it possible to validate and change the `zowe.yaml` file and job definition within the Zowe Server Install Wizard? + + Yes. + +### Zowe System Installation and Configuration + +1. Does Zowe provide a Software Bill of Materials (SBOM)? + + SBOMs are available in the SPDX format from the [Bill of Materials](https://docs.zowe.org/stable/appendix/bill-of-materials/) page on Zowe Docs. + +## User questions + +### Zowe API Mediation Layer + +1. Will Zowe V3 API ML support clients with the V2 onboarding enabler? + + The API ML in Zowe V3 supports clients with onboarding enablers from Zowe V2. It also works the other way around: The onboarding enablers from Zowe V3 will continue working with Zowe V2 API ML. + +2. The jump to Java 17 means that we have to maintain two separate versions of our application, one with apiml-enabler V2 and one with V3, to support customers who want to stay with Java 8. Do you have a recommendation or a workaround for supporting both Java versions? + + The plain Java Enabler from Zowe V2 works in Zowe V3. You can keep this until Zowe V4. + + Zowe V4 will only support Spring Boot, which requires Java 17. We recommend building applications for Java 17 to ensure that applications continue to be compatible with API ML. + +3. Can you speak about the migration from Zuul to Spring Cloud Gateway? Today there are two separate gateway services in API ML with separate configurations. + + Spring Cloud Gateway is replacing Zuul as the technology to provide the API Gateway. The configuration for the API Gateway remains in the `components.gateway` namespace. If you were using Spring Cloud Gateway in V2 for the multi-tenancy scenario, you need to update the configuration for the central gateway and move this configuration from `components.cloud-gateway` to `components.gateway`. + +4. If I have a legacy gateway deployed, how will I migrate to the new gateway? Will the old gateway be removed? + + The old gateway is removed in Zowe V3, but nothing should change from the point of view of the user. However, we may deliver a configuration utility to help with this transition if required. + +5. How would a client-side end user find and obtain the correct API ML service instance ID for the desired instance of the user's service? + + In Zowe V2, clients can use the header instance ID to route communications to a specific instance. Clients can get instance IDs for specific services via an API on the Discovery service. We are planning to improve the method for finding service IDs in Zowe V3. + +6. Will the LPAR ID be available for the clients to obtain? + + It is not currently available, but we are scheduled to work on this functionality in 2024. + +7. API ML static onboarding locates templates that are then used to set variables in the api-defs directory. No manual user action is required. Will this automated process still be available in Zowe V3? + + Static onboarding will continue to be available. The recommendation for Zowe V3 is to move the api-defs directory out of the [Zowe workspace](../appendix/zowe-glossary.md#workspace-directory). The `zowe.yaml` file contains a parameter called `components.discovery.alternativeStaticApiDefinitionsDirectories` that specifies where the directories for static definitions reside. diff --git a/docs/whats-new/zowe-v3-office-hours.md b/docs/whats-new/zowe-v3-office-hours.md index e20e8ba83c..dfce925f41 100644 --- a/docs/whats-new/zowe-v3-office-hours.md +++ b/docs/whats-new/zowe-v3-office-hours.md @@ -1,12 +1,47 @@ -# Zowe V3 office hours videos +# Zowe V3 Office Hours -Zowe Office Hours are a chance for users and extenders to hear directly from Zowe devs about what to expect from the next major Zowe release. +Zowe Office Hours are a chance for users and extenders to hear directly from Zowe developers about what to expect from the next major Zowe release. Zowe squads go over their upcoming projects and answer your questions about Zowe V3. Missed a session? Catch up here. Office hours are recorded and made available with videos posted to the [Open Mainframe Project](https://www.youtube.com/@OpenMainframeProject) YouTube channel. -## Office hours series for Extenders +## Consumer focused Office Hours + +### Upcoming Consumer focused Office Hours + +| Date | Topic | Link to the meeting | Link to the recording | Links to the materials | +| ------------------------ | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------| +| 09/06/2024 8AM - 9AM ET | Web UI | [https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2](https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2) | | | +| 09/13/2024 8AM - 9AM ET | API Mediation Layer | [https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2](https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2) | | | +| 09/20/2024 8AM - 9AM ET | Zowe CLI & Client Node SDK | [https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2](https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2) | | | +| 09/27/2024 8AM - 9AM ET | Explorer (VS Code) | [https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2](https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2) | | | +| 10/04/2024 8AM - 9AM ET | Explorer (Intellij) | [https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2](https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2) | | | +| 10/11/2024 8AM - 9AM ET | Systems, Install & Packaging | [https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2](https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2) | | | +| 10/18/2024 8AM - 9AM ET | Open Office Hours | [https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2](https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2) | | | + +### Past Consumer focused Office Hours +| Date | Topic | Link to the meeting | Link to the recording | Links to the materials | +| ------------------------ | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------| +| 01/05/2024 8AM - 9AM ET | API Mediation Layer | [https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7](https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7) | [Zoom recording](https://youtu.be/6gkoSSypTck?si=h4DJCZ8LzZMj3rHh) | [Presentation](https://ibm.box.com/s/06rtqh1at3nd7q3lgi36ly8uum1h4adn) | +| 01/12/2024 8AM - 9AM ET | Zowe CLI | [https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7](https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7) | [Zoom recording](https://youtu.be/wgzJO9eyyhA?si=dgER1FQVzwAvm_1t) | [Presentation](https://ibm.box.com/s/aqcwrc83i8uq9llyo3kae8pjxi0p1xlb) | +| 01/12/2024 8AM - 9AM ET | Node Client SDK | [https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7](https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7) | [Zoom recording](https://youtu.be/wgzJO9eyyhA?si=dgER1FQVzwAvm_1t) | [Presentation](https://ibm.box.com/s/ujdkjfb6f1zhx4amse1x7aysdb76ai80) | +| 01/19/2024 8AM - 9AM ET | Explorer (VSCode) | [https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7](https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7) | [Zoom recording](https://youtu.be/ZGmD2hxJVHE?si=ra46RJu3YdkecrXu) | [Presentation](https://ibm.box.com/s/366i3i576c3r2s6kn3sqtwxzsj9lcpzm) | +| 01/26/2024 8AM - 9AM ET | Explorer (Intellij) | [https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7](https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7) | [Zoom recording](https://youtu.be/mDlCuhizy3M?si=OlFs5mXUahH59xEl) | [Presentation](https://ibm.box.com/s/monvnv2b55v1p6cz5cpxrmeyf8m794j4) | +| 02/02/2024 8AM - 9AM ET | Web UI | [https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7](https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7) | [Zoom recording](https://youtu.be/KllchLDvBjs?si=WxJ4nBJrUDzqwwwW) | [Presentation](https://ibm.box.com/s/asqn9wx7qc1mfwmdn6dqnkt56xuuflaz) | +| 02/09/2024 8AM - 9AM ET | Systems Install & Packaging | [https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7](https://zoom-lfx.platform.linuxfoundation.org/meeting/95815909111?password=57c97886-d2b6-4430-9c05-1eedfa1e0fa7) | [Zoom recording](https://youtu.be/EQ-jYYl6wnY?si=W3ei2hVVqMcR0Mcn) | [Presentation](https://ibm.box.com/s/iy5fwn7u5jcjaxfnopd9i6acjsb491qx) | + +## Past Extender focused Office Hours + +| Date | Topic | Link to the meeting | Link to the recording | Links to the materials | +| ---- | ----- |----------------------------------------------------------------------------------------------------------------------|-----------------------|------------------------| +| 11/10/2023 8AM - 9AM ET | Other SYSTEMS Installation & Packaging & z/OS | [https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129](https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129) | [Zoom recording](https://youtu.be/XdU4YTcjBaw?feature=shared) | [Presentation](https://ibm.box.com/shared/static/jrc9sfdiqipyk13enskcpri32ykg8f38.pptx) | +| 11/03/2023 8AM - 9AM ET | Web UI | [https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129](https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129) | [Zoom recording](https://youtu.be/xcoN3z4W_GM?feature=shared) | Not Available | +| 10/20/2023 8AM - 9AM ET | Explorer (VSCode) | [https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129](https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129) | [Zoom recording](https://youtu.be/Ur-yPjJyTH8?feature=shared) | [Presentation](https://ibm.box.com/s/h5nizhrgke12z63u7v1wivax126usjda) | +| 10/13/2023 8AM - 9AM ET | Zowe CLI | [https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129](https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129) | [Zoom recording](https://youtu.be/3DLV28Z3szE?feature=shared) | [Presentation](https://ibm.box.com/s/cdw0q1xnpnmm1wmtbjl3bk0esiqnfyox) | +| 10/06/2023 8AM - 9AM ET | API Mediation Layer | [https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129](https://zoom-lfx.platform.linuxfoundation.org/meeting/93849373934?password=15f05b8e-88c9-4bf5-be2b-2a48f3120129) | [Zoom recording](https://youtu.be/6TTpRx9TyO4?feature=shared) | [Presentation](https://ibm.box.com/s/0srch736nkq0q6kcrxazt0nvgfjnxyd3) | + +## Office Hours video series for Extenders @@ -19,13 +54,13 @@ Missed a session? Catch up here. Office hours are recorded and made available wi diff --git a/sidebars.js b/sidebars.js index faaae6040f..89cede8543 100644 --- a/sidebars.js +++ b/sidebars.js @@ -2,14 +2,6 @@ module.exports = { "whats-new": [ //id of the sidebar "whats-new/zowe-announcements", - { - type: "category", // doc(default), 'link'(external links), 'ref'(page without without sidebar) - label: "Zowe vNext", - link: {type:"doc", id:"whats-new/breaking-changes-v3"}, - items: [ - "whats-new/zowe-v3-office-hours", - ], - }, { type: "category", // doc(default), 'link'(external links), 'ref'(page without without sidebar) label: "Release notes", @@ -38,6 +30,16 @@ module.exports = { "whats-new/release-notes/v2_0_0", ], }, + { + type: "category", // doc(default), 'link'(external links), 'ref'(page without without sidebar) + label: "Zowe V3 preview", + link: {type:"doc", id:"whats-new/breaking-changes-v3"}, + items: [ + "whats-new/zowe-v3-office-hours", + "whats-new/zowe-v3-conformance-criteria", + "whats-new/zowe-v3-frequently-asked-questions", + ], + }, ], "getting-started": [ {
-Command Line Interface (CLI) +Zowe CLI
-Zowe Explorer +Zowe Explorer for Visual Studio Code