list OpenSSH as pre-req

[OnnoVdT]

No description provided.

[OnnoVdT]

https://zowe.github.io/docs-site/latest/user-guide/systemrequirements.html lists z/OS, z/OSMF and Node as pre-req, but not OpenSSH. Like z/OSMF, OpenSSH was added to base z/OS in 2.2, but it is not configured by default. So the sysprog will have to take action if it's not set up already for another reason.

[nannanli]

@Joe-Winchester @NayerNajafi Hi Joe, Nayer, any comment on this request to list OpenSSH as a pre-req for Zowe? Thanks!

[Joe-Winchester]

@OnnoVdT - good catch. I wasn't aware that OpenSSH wasn't configured by default. If it isn't configured what Zowe function will fail ? Is it the new installer, or something in a 1.3 existing build that will fall over ?

[OnnoVdT]

Looking at the name of the environment variable used to store the ssh port number (ZOWE_ZLUX_SSH_PORT), I would say something in zLUX will break if this is not set up, regardless of how it was installed.

[Joe-Winchester]

ZLUX desktop contains two apps - a TN3270 terminal and a VT Terminal, which are effectively ways of logging into z/OS through a green screen or a terminal. By default these connect to 23 and 22 respectively, and the port can be overridden at install time so that the default ports are different if they have been changed on the host (e.g. to 2023 and 2022) which occurs on zD&T often for example. If openSSH isn't active and you can't open a termninal, the user failure is just that the VT terminal fails to open and displays a "can't connect screen". The other parts of Zowe - the 3270 - the explorers - the editors - the API gateway - will all continue to function.
This means that the pre-req isn't for Zowe per-say, it is for a particular app only. Because of that I don't think we should list it as a hard pre-req (in the same way that Java or node are for example), however we should add sections to the doc that cover each app and each pre-req in turn. With Cupids having the new launcher that does specific pre-req checking pre app I think is the place we should rewrite the docs, so for now I think the docs should stay as-is.

[nannanli]

Closing this issue based on the discussion above. The system requirement doc will stay as is. Feel free to reopen if the problem or confusion persists.