All notable changes to the Zowe Installer will be documented in this file.
- Updated ZWEWRF03 workflow to be up to date with the installed software
- zwe now has a
zwe config get
andzwe config validate
command. The get command can be used to get a part of the zowe yaml configuration without needing to read the yaml yourself.zwe config get
only returns values upon proving the configuration is valid first.zwe config validate
can be used to perform validation of the zowe configuration files without running any additional actions. This is useful for verifying that a change is valid before starting zowe, for example.
- A new component management command
zwe components upgrade
allows you to install an already-installed component. - A new component management command
zwe components uninstall
allows you to remove an installed extension. - A new component management command
zwe components search
allows you to query for extensions. zwe components
subcommands can now search for, install, and upgrade extensions retrieved via an on-prem or remote package registry. At this time, npm is supported as the registry and package manager technology thatzwe
can use to download content. This is an optional feature and is not enabled by default: it must be configured. View the schema for zowe.yaml to learn more about the "package registry" and "registry handler" technologies to configure for this feature. More information and a recorded demo is available at zowe#2980
- Use of DVIPA may cause Zowe to believe a port is not free when it is. Starting in this release, Zowe can narrow its port validation to a specific IP via
zowe.network.vipaIp=some.ip
or bypass the verification viazowe.network.validatePortFree=false
. Setting this to false will still cause the servers to be unable to connect if the port is not free, but this can be a more accurate and portable setting. - component configure stages will now have their STDOUT printed when running at the INFO level of zwe verbosity.
- zwe was not guaranteeing that the workspace folder had 770 permission when zowe.useConfigmgr=true was set
- Zowe's 'configmgr' mode is now the default operating mode for installation and configuration when available. To disable this behavior, set
zowe.useConfigmgr
tofalse
in yourzowe.yaml
.- Zowe containerization does not yet support 'configmgr' mode. If you have an existing Kubernetes deployment of Zowe and are upgrading to 2.4.0, you should set
zowe.useConfigmgr
tofalse
in your zowe YAML configmap. This is set by default for new Kubernetes deployments.
- Zowe containerization does not yet support 'configmgr' mode. If you have an existing Kubernetes deployment of Zowe and are upgrading to 2.4.0, you should set
- zwe can now validate component configuration through use of configmgr and json-schema. If a component does not have a schema, a warning will be printed. Due to schemas being required since 2.0, this behavior may change in a later version.
- Components can now provide an array of schema files rather than just one. This allows for better re-use and organization.
- Zowe can now start using zowe.yaml loaded from PARMLIB members if you want, when using the STC startup as well as the
zwe start
,zwe stop
, andzwe components
commands. These can be specified in --config / CONFIG input as PARMLIB() entries. For example, zwe start --config FILE(/my/customizations.yaml):PARMLIB(TEAM.CUSTOM.ZOWE(YAML)):PARMLIB(ORG.CUSTOM.ZOWE(YAML)):FILE(/zowe/defaults.yaml) ... Note when using PARMLIB, every member name must be the same.
- zowe.environments was not applied when zowe.useConfigmgr=true was set
- A new dataset, SZWELOAD was added. It contains versions of configmgr named
ZWECFG31
,ZWECFG64
, andZWERXCFG
which can be used to invoke configmgr from within a rexx program. The expected use case is to simplify how complex JCL gets configuration info about Zowe. - Zowe can now start in a mode called 'configmgr' mode. You can enable this in certain
zwe
commands by adding--configmgr
. Not all commands support this yet, more will over time. For now, you can use it inzwe start
,zwe stop
, andzwe components
. This mode is generally significantly faster to start up Zowe, but also enforces validation of the zowe.yaml configuration against the zowe.yaml schema files (found in/schemas
). - Zowe can now start using multiple zowe.yaml files when using 'configmgr' mode. This works for the STC startup as well as the
zwe start
,zwe stop
, andzwe components
commands. Each file must follow the same zowe.yaml schema as before, but in the list of files, properties found in a file to the right will be overridden by the file to the left. Through this, you can separate portions of Zowe configuration any way you want. To use multiple files, change your existing --config / CONFIG input to instead be a list of FILE() entries which are colon ':' separated. For example, zwe start --config FILE(/my/customizations.yaml):FILE(/zowe/defaults.yaml) - Zowe server YAML files can now have templates within them when using 'configmgr' mode. When the value of any attribute contains
${{ }}
, the content within the brackets will be replaced with whatever the template evaluates to. The entries are processed as ECMAScript2020-compatible javascript assignments. You can for example, set one property to the value of another, such as havingparmlib: ${{ zowe.setup.dataset.prefix }}.MYPARM
rather than needing to type the prefix explicitly. You can also use this to set conditionals. For examples, please check the ZSS default yaml file: https://github.com/zowe/zss/blob/013d11d700003483fde38e1df0a373bb5bd4ef8c/defaults.yaml
- Schema pattern for semver range has been simplified as it was not compiling in configmgr
- When
zwe components install
could not find or set the PC bit of a ZSS plugin, it would print out an example command for fixing the issue. Now, it shows the exact command you could execute to fix the PC bit problem.
- A new command,
configmgr
is now present. It can load, validate, and report on the zowe configuration file.
- A new command, 'zwe' is now present which can be used to do various zowe server commands like install and run. To learn more, try
zwe --help
or find the same help on the zowe documentation website.
- Zowe no longer uses instance.env, but instead uses a zowe.yaml file for configuration
- Zowe no longer uses an instance directory, but instead uses the zowe.yaml to find all zowe directories, and the zwe command to handle most zowe management operations.
- app-server's uninstall-app.sh script is now available in the instance bin folder.
- zss's zis-plugin-install.sh script is now available in the instance bin/utils folder.
- A new dataset is created during instance creation. The dataset is to be used for holding ZIS plugins, as an alternative to putting the plugins inside of the ZIS loadlib which is still the default.
- New instance parameters describing ZIS are available and automatically recorded in instance.env if a new install is done via a convenience build. These parameters can be used in future automation of detecting ZIS and installing ZIS plugins
- New instance creation parameters -d or -l, -p, and -z are now available in the instance creation script for manually specifying the new ZIS parameters.
- server-bundle docker image has been optimized to greatly reduce the size without impacting the content and usability
- server-bundle docker image now runs zowe under the user "zowe", and the default mount locations of instance, keystore, and plugins directories is now within /home/zowe as a result
- You can now start ZSS independent from the Zowe Application Framework server by specifying the
LAUNCH_COMPONENT_GROUP "ZSS"
. IfDESKTOP
is specified instead ofZSS
, ZSS will still be included as a prerequisite to the Application Framework server. #1632 - Zowe instance configuration script (
zowe-configure-instance.sh
) can now skip checking for Node.js by passing in the-s
flag since Node.js may not be needed if the components to be launched don't require it. #1677 - The
run-zowe.sh
script can also skip the checking for Node.js by setting the environment variableSKIP_NODE=1
for the cases where the components to be launched don't require Node.js. - Exported the
EXTERNAL_CERTIFICATE_AUTHORITIES
variable to thezowe-certificates.env
file such that it may be used by the Application Framework server. #1742
- Moved explorer-ui-server out of explorers into new
shared
folder under Zowe Runtime Directory. It involved following PRs (zowe#1545), (zowe/explorer-jes#207), (zowe/explorer-ui-server#37). Thanks @stevenhorsman, @nakulmanchanda, @jackjia-ibm - Created
zowe-setup-keyring-certificates.env
and removed the overloaded properties fromzowe-setup-certificates.env
to try and clarify the user experience when setting up certificates in the keyring and USS keystore modes. #1603
- Allow the user to verify the authenticity of a Zowe driver. The script
zowe-verify-authenticity.sh
will check that a ZoweROOT_DIR
for an installed release matches the contents for when that release was created, which assists with support and troubleshooting. To verify pre-1.14 releases, the script and its associated code are available separately (see #1552). For more information, see the new topic Verify Zowe Runtime Directory that describes the operation of the script. - Allow multiple domains (names/IP Addresses) when generating certificates. This also includes SMP/E
HOLDDATA
for the affected functionZowe Configuration
. #1511 - Included z/OSMF workflows for Zowe z/OS configuration. #1527
- Added warning if
ZWESVSTC
runs under user IDIZUSVR
. #1534 - [Docs] Changed the documentation to say that SZWEAUTH PDSE load library members should not be copied elsewhere, but instead that the original installation target SZWEAUTH PDSE should be APF-authorized and used as the runtime load library. This also includes SMP/E
HOLDDATA
for the affected functionSTC JCL
as well as changes to topics Installing and configuring the Zowe cross memory server (ZWESISTC) and Installing and starting the Zowe started task (ZWESVSTC). - [Docs] Added a new topic Installing and configuring Zowe z/OS components using scripts.
- Updated zowe-configure-instance upgrade to update ROOT_DIR #1414
- Update port validation logic to reduce false negatives #1399
- Update install and configure to tolerate ZERT Network Analyzer better #1124
- Edit default plugin references to point to $ROOT_DIR env var
2020-05-08 Timothy Gerstel tgerstel@rocketsoftware.com
-
Set up SSO in a standard install of Zowe via new environment variables set in zowe-setup-certificates.env
-
Automate conversion of APIML public key and storage within PKCS#11 token
-
When the hostname cannot be resolved use the IP address instead. This covers the scenario when the USS
hostname
command returned a system name that wasn't externally addressable, such asS0W1.DAL-EBIS.IHOST.COM
which occurs on an image created from the z/OS Application Developers Controlled Distribution (ADCD). -
Separate zss component from app-server component