Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

change title from Using to Adding and other similar changes #4021

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -62,8 +62,8 @@ There are two ways to set up certificates on a z/OS machine:
- [Certificates in SAF keyring](#api-ml-saf-keyring)

For detailed instructions about how to set up certificates during installation, see the following articles:
* [Use PKCS12 certificates](../../user-guide/use-certificates.md#use-pkcs12-certificates)
* [Use JCERACFS certificates](../../user-guide/use-certificates.md#use-jceracfks-certificates) in a keyring
* [Use PKCS12 certificates](../../user-guide/use-certificates.md#add-pkcs12-certificates)
* [Use JCERACFS certificates](../../user-guide/use-certificates.md#add-jceracfks-certificates) in a keyring

Follow the procedure in the applicable section described in this article during installation.

Expand Down
2 changes: 1 addition & 1 deletion docs/user-guide/generate-certificates.md
Original file line number Diff line number Diff line change
Expand Up @@ -282,4 +282,4 @@ You completed the procedure to generate a JCERACFKS certificate.

### Next steps after JCERACFKS setup

For more information about how to use your JCERACFKS certificate, see [Use JCERACFKS certificates](./use-certificates.md).
For more information about how to use your JCERACFKS certificate, see [Add JCERACFKS certificates](./use-certificates.md).
2 changes: 1 addition & 1 deletion docs/user-guide/import-certificates.md
Original file line number Diff line number Diff line change
Expand Up @@ -221,5 +221,5 @@ zowe:
The configuration of `zowe.setup.certificate` populates information to be used by the subcommand `zwe init certificate` of `zwe init`.
## Next steps

Once your certificate is successfully imported, review the documentation about how to [use certificates](./use-certificates.md) in a Zowe production environment.
Once your certificate is successfully imported, review the documentation about how to [add certificates](./use-certificates.md) in a Zowe production environment.

18 changes: 9 additions & 9 deletions docs/user-guide/use-certificates.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
# Using certificates
# Adding certificates to Zowe configuration

Once you have generated or imported your certificates, you can now use the certificates with Zowe. Use the procedure descibed in this article that corresponds to the type of certificates you generated or imported.
Once you have generated or imported your certificates, you can now add your certificates in your Zowe configuration. Use the procedure descibed in this article that corresponds to the type of certificates you generated or imported.

:::info Required roles: system programmer, security administrator
:::
Choose from the following procedures:

- [Use PKCS12 certificates](#use-pkcs12-certificates)
- [Use JCERACFKS certificates](#use-jceracfks-certificates)
- [Add PKCS12 certificates](#add-pkcs12-certificates)
- [Add JCERACFKS certificates](#add-jceracfks-certificates)

## Use PKCS12 certificates
## Add PKCS12 certificates

To use PKCS12 certificates, run the command `zwe start -c ./zowe.yaml` in the directory with the `zowe.yaml` file to start Zowe.
To add PKCS12 certificates to your Zowe configuration, run the command `zwe start -c ./zowe.yaml` in the directory with the `zowe.yaml` file to start Zowe.

Details about the PKCS12 certificate used when Zowe is launched are specified in the `zowe.yaml` section `certificates`. This section contains information about the certificate name and the location of the certificate, together with the truststore location.

The two most common scenarios for using a PKCS12 certificate are:
The two most common scenarios for adding a PKCS12 certificate in your Zowe configuration are:

* You have an existing certificate and wish to configure Zowe to use the certificate.
* You do not have a certificate and wish to [generate a new certificate](./generate-certificates.md).
Expand All @@ -24,11 +24,11 @@ The two most common scenarios for using a PKCS12 certificate are:

To troubleshoot issues during Zowe startup, see [Troubleshooting startup of Zowe z/OS components](https://docs.zowe.org/stable/troubleshoot/troubleshoot-zos-startup).

## Use JCERACFKS certificates
## Add JCERACFKS certificates

Details about the JCERACFKS certificate used when Zowe is launched are specified in the `zowe.yaml` section `certificates`. This section contains information about the certificate name and location, together with the truststore location.

The two most common scenarios for using a JCERACFKS certificate are:
The two most common scenarios for adding a JCERACFKS certificate to your Zowe configuration are:

* You have been given an existing certificate and wish to configure Zowe to use it.
* You do not have a certificate and wish to generate a new one.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Use one of the following installation options to install Zowe z/OS components.
| Verification Step | Task | Results | Time Estimate |
|----|-----------|----|-------------|
| [Verify Zowe Application Framework installation](../user-guide/verify-zowe-runtime-install.md#verifying-zowe-application-framework-installation) | Open the Zowe Desktop from a supported browser | You should be able to open the Zowe Desktop from a supported browser. | 20 minutes|
| [Verify API Mediation installation](../user-guide/verify-zowe-runtime-install.md#verifying-api-mediation-installation) |Use a REST API client to review the value of the status variable of the API Catalog service routed through the API Gateway | See the example presented in Verify API Mediation installation | 15 minutes |
| [Verify API Mediation installation](../user-guide/verify-zowe-runtime-install.md#verifying-api-mediation-layer-installation) |Use a REST API client to review the value of the status variable of the API Catalog service routed through the API Gateway | See the example presented in Verify API Mediation installation | 15 minutes |
|[Verify z/OS Services installation](../user-guide/verify-zowe-runtime-install.md#verifying-zos-services-installation) |Zowe z/OS services usually are registered with Zowe APIML Discovery| You should see JSON format data of all jobs running on the system | 15 minutes |


Expand Down
Loading