Skip to content

Update documentation for new commercial licensing API endpoints#4207

Open
RitvikPatil777 wants to merge 5 commits into
chef:mainfrom
RitvikPatil777:server_license_api_docs
Open

Update documentation for new commercial licensing API endpoints#4207
RitvikPatil777 wants to merge 5 commits into
chef:mainfrom
RitvikPatil777:server_license_api_docs

Conversation

@RitvikPatil777

Copy link
Copy Markdown

Summary

Updates Chef Server documentation to reference the new commercial licensing API endpoints.

Changes

  • Replace packages.chef.io references with chefdownload-commercial.chef.io
  • Add license_id requirement for commercial downloads
  • Improve clarity and readability of download instructions

Files Modified

  • docs-chef-io/content/server/ctl_chef_server.md
  • docs-chef-io/content/server/install_server_tiered.md
  • docs-chef-io/content/server/reusable/md/ctl_chef_server_install_features_download.md

@RitvikPatil777 RitvikPatil777 requested a review from a team as a code owner June 8, 2026 16:56
@github-actions github-actions Bot added the Documentation Pulls PR onto docs board so they know it exists label Jun 8, 2026
Signed-off-by: Ritvik Patil <rpatil@progress.com>
Signed-off-by: Ritvik Patil <rpatil@progress.com>
@RitvikPatil777 RitvikPatil777 force-pushed the server_license_api_docs branch from 00ce994 to 323f12c Compare June 8, 2026 16:57
@netlify

netlify Bot commented Jun 8, 2026

Copy link
Copy Markdown

Deploy Preview for chef-server failed.

Name Link
🔨 Latest commit 00ce994
🔍 Latest deploy log https://app.netlify.com/projects/chef-server/deploys/6a26f427ca5f7f00084b44f6

@netlify

netlify Bot commented Jun 8, 2026

Copy link
Copy Markdown

👷 Deploy Preview for chef-server processing.

Name Link
🔨 Latest commit b30cbec
🔍 Latest deploy log https://app.netlify.com/projects/chef-server/deploys/6a47934d8dbb7500078b490f

@@ -1,5 +1,4 @@
The `install` subcommand downloads packages from <https://packages.chef.io> by default.
For systems that are not behind a firewall (and have connectivity to <https://packages.chef.io>), these packages can be installed as described below.
The `install` subcommand downloads packages from <https://chefdownload-commercial.chef.io> by default (requires a valid `license_id`).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

How do they pass in the license ID with this command?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Updated to include the commercial download URL syntax and where license_id is passed (?license_id=<LICENSE_ID>).

Signed-off-by: Ian Maddaus <ian.maddaus@progress.com>
<https://packages.chef.io/> by default. For systems that are not behind
a firewall (and have connectivity to <https://packages.chef.io/>), the
Chef management console package can be installed as described below:
The `install` subcommand downloads packages from `chefdownload-commercial.chef.io` by default and requires a valid Progress Chef license ID.

@IanMadd IanMadd Jun 23, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Same question here. How do they pass in a license ID?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

The license ID is passed in the commercial install URL as a query parameter: ?license_id=<LICENSE_ID>.

Signed-off-by: Ritvik Patil <rpatil@progress.com>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

From what I understand, this won't work.

This would have to be rewritten entirely so that users download the chef-manage package from chefdownload-commercial and then use the --path option to install the package. E.g. sudo chef-server-ctl install PACKAGE_NAME --path /path/to/package/directory

This content would have to be merged with the following section where it documents using a local file path.

Unless the endpoint is updated in the install command.

@IanMadd IanMadd Jul 8, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Another option is to remove this block of instructions entirely because Chef Manage is EOL. We shouldn't be telling people to install EOL things. I'm not sure what other packages can be installed with this command, though.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

@IanMadd since Chef Manage is EOL, the Chef Manage installation block has been removed.

<https://packages.chef.io/> by default. For systems that are not behind
a firewall (and have connectivity to <https://packages.chef.io/>), the
Chef management console package can be installed as described below:
For commercial downloads, use the following URL:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

It looks like the same issue here. Users would have to download packages from chefdownload-commercial, then use the --path option to install the package.

Signed-off-by: Ritvik Patil <rpatil@progress.com>
@RitvikPatil777 RitvikPatil777 force-pushed the server_license_api_docs branch from 7618b12 to 8370a61 Compare July 10, 2026 15:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Pulls PR onto docs board so they know it exists

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants