Skip to content

Conversation

@ArooshLele
Copy link
Collaborator

List the file(s) included in this PR:
configuring-at-tls-for-zowe-server.md

Describe your pull request here:
Based on my discussion with @1000TurquoisePogs , I added a cautionary note at the beginning of the "Enabling AT-TLS" topic.

After creating the PR, follow the instructions in the comments.
CC: @ArooshLele @gauravs-20

@ArooshLele ArooshLele self-assigned this Sep 29, 2025
@ArooshLele ArooshLele added area: docs Documentation issue or issues that have documentation impact area: misc This issue is a miscelleneous doc requirement not for a specific component or area priority-medium area: install and config Issues related to z/OS install and config release: V3 Zowe V3 content review: doc Needs review by Doc Squad member review: sme Needs review by an SME labels Sep 29, 2025
@github-actions
Copy link

😺 Thank you for creating this PR! To publish your content to Zowe Docs, follow these required steps.

  • Add the label review: doc.
  • Identify your content topic with a label. (Examples: area: apiml, area: cli, area: install and config, etc.)
  • Specify the major Zowe release(s) for your content. (Examples: release: V1, release: V2, release: V3)
    • If adding content that needs to be removed from V3 documentation, add the V3 N/A tag.
  • Select the master branch if your PR updates content that is on the live site. Select docs-staging if your PR updates content for a future release.
  • Notify the Doc Squad about this PR. If you don't know whom should review your content, message the #zowe-doc Slack channel. If you know which Doc Squad writer should approve your content, add that person as a reviewer.

Need help? Contact the Doc Squad in the #zowe-doc Slack channel.

@github-actions
Copy link

github-actions bot commented Sep 29, 2025

@github-actions github-actions bot temporarily deployed to pull request September 29, 2025 12:21 Inactive
# Enabling AT-TLS

:::caution
Do not use AT-TLS in high availability until you install Zowe on z/OS. First, ensure that the components of Zowe are functional and run as expected.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

'in high availability'? I don't see how HA is related.
My opinion is people should not try an AT-TLS setup until they have a non-ATTLS setup working first. There are situations in which non-ATTLS is not possible and therefore the recommendation doesn't make sense, but for most people it is.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@1000TurquoisePogs Thanks for your review. I have removed HA from the Note.
Based on your feedback, here's the Pull Request: #4744
This Pull Request is now merged.
The updated Note is as follows:
Do not use an AT-TLS setup until you have a non-AT-TLS setup that works.
For more information about how to install Zowe, refer to Installing Zowe.
For more information about how to verify whether Zowe components are functional, refer to Verifying Zowe installation on z/OS.
CC: @ArooshLele @gauravs-20


:::caution
Do not use AT-TLS in high availability until you install Zowe on z/OS. First, ensure that the components of Zowe are functional and run as expected.
For more information about how to install Zowe, refer to [Installing Zowe](../user-guide/install-overview.md)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add punctuation after links

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@janan07 Thanks for your review. I have added the punctuation marks after the links.
Here's the Pull Request: #4744
This Pull Request (containing the punctuation marks) is now merged.
CC: @ArooshLele @gauravs-20

@github-actions github-actions bot temporarily deployed to pull request October 9, 2025 14:23 Inactive
@github-actions github-actions bot temporarily deployed to pull request October 13, 2025 11:45 Inactive
@DivergentEuropeans
Copy link
Member

Updated w/ https://github.com/zowe/docs-site/pull/4744/files + Aroosh and I will make minor correction to 4744

Copy link
Collaborator

@anaxceron anaxceron left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @ArooshLele!

# Enabling AT-TLS

:::caution
Do not use an AT-TLS setup until you have a non-AT-TLS setup that works.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similarly, do not attempt a Zowe HA setup until you have a non-HA Zowe setup that works.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add both sentences into here too: https://docs.zowe.org/stable/user-guide/zowe-ha-overview/

(or just the HA one)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is tricky recommendation as up until at least 3.4, maybe 3.5 the hardware based ICSF Keyrings requires usage of AT-TLS and it won't work without it.

Otherwise I agree.

# Enabling AT-TLS

:::caution
Do not use an AT-TLS setup until you have a non-AT-TLS setup that works.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add both sentences into here too: https://docs.zowe.org/stable/user-guide/zowe-ha-overview/

(or just the HA one)

@github-actions github-actions bot temporarily deployed to pull request October 13, 2025 15:31 Inactive
@github-actions github-actions bot temporarily deployed to pull request October 27, 2025 14:40 Inactive
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Documentation issue or issues that have documentation impact area: install and config Issues related to z/OS install and config area: misc This issue is a miscelleneous doc requirement not for a specific component or area priority-medium release: V3 Zowe V3 content review: doc Needs review by Doc Squad member review: sme Needs review by an SME

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants