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

Subscription renewals: review and clarify JWT license file handling for subscription renewal #162

Open
3 tasks
travisamartin opened this issue Feb 3, 2025 · 2 comments
Labels
customer-feedback documentation Improvements or additions to documentation product/nginx-plus NGINX Plus (and NGINX Open Source in docs.ngninx.com) product/nim NGINX Instance Manager

Comments

@travisamartin
Copy link
Contributor

travisamartin commented Feb 3, 2025

Description

A customer provided feedback on the About subscription licenses documentation. They rated the content 6/7 for helpfulness but requested additional clarity on handling JWT license files for subscription renewals.

Customer feedback

For complete operational guidelines on license.jwt, it would be great to advise:

  1. For NGINX Plus instances running on an expiring subscription, do we just copy the new JWT to /etc/nginx/license.jwt, and will NGINX Plus start reporting usage to NIM under the new subscription ID?
  2. For renewed subscriptions (with a new subscription ID), does this process involve:
    • Downloading the new subscription's JWT license file
    • Uploading the JWT to the instance manager
    • Copying the new JWT to the running NGINX instance
    • Restarting/reloading NGINX?
  3. Does NIM require license.jwt itself on an active subscription?
  4. Does NIM support proxy servers in disconnected mode, or is there a separate process to upload usage reports from NIM to F5 over the proxy server?

Acceptance criteria

  • Review the existing doc to confirm whether it already addresses these questions
  • If the doc fully covers these points, ensure the explanations are clear and easy to find
  • If updates are needed, clarify:
    • How to apply a new license.jwt file
    • Whether a restart or reload is required
    • Whether NIM requires license.jwt on an active subscription
    • How proxy servers work for NIM in disconnected mode

The customer provided contact info and is open to being contacted. Consider following up, if appropriate.

Label

customer-feedback

@travisamartin travisamartin added documentation Improvements or additions to documentation product/nginx-plus NGINX Plus (and NGINX Open Source in docs.ngninx.com) product/nim NGINX Instance Manager customer-feedback labels Feb 3, 2025
@lucYang55
Copy link
Contributor

Hey I would love to contribute to this would you be able to provide the source file for this issue so I can work on it

@mjang
Copy link
Contributor

mjang commented Mar 11, 2025

Hey I would love to contribute to this would you be able to provide the source file for this issue so I can work on it

Hi @lucYang55,

To meet the requirements of this issue, you need to have subscription-based access to our JWT licenses. If you have such access, we'd love your suggestions! You can find the source file here.

I see that you're a relatively newer GitHub user. If you're a newer user to Git, we have a number of Good first issues that you can consider.

In either case, I'd love to help you make your contribution to our docs! You're welcome to contact me at mi.jang@f5.com or on LinkedIn at https://www.linkedin.com/in/mijang/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
customer-feedback documentation Improvements or additions to documentation product/nginx-plus NGINX Plus (and NGINX Open Source in docs.ngninx.com) product/nim NGINX Instance Manager
Projects
None yet
Development

No branches or pull requests

3 participants