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.

Sign up for GitHub

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

Jump to bottom

(#1057) Update CCM Dependency versions #1061

Closed
wants to merge 1 commit into from
Closed

(#1057) Update CCM Dependency versions #1061

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
10 changes: 5 additions & 5 deletions src/content/docs/en-us/central-management/setup/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,13 +68,13 @@ choco download dotnet4.5.2 dotnetfx --force --internalize --internalize-all-urls
choco download $_ --force --internalize --internalize-all-urls --append-use-original-location --source="'https://community.chocolatey.org/api/v2/'" --output-directory="'C:\packages'"
}

# We must use the 6.x.x versions of these packages, so we need to download/internalize these specific items. At the time of publishing, the most recent version of this package is 6.0.5, but later package versions (within the 6.x.x release) are expected to work.
@('dotnet-6.0-runtime', 'dotnet-6.0-aspnetruntime') | Foreach-Object {
choco download $_ --version 6.0.5 --force --internalize --internalize-all-urls --append-use-original-location --source="'https://community.chocolatey.org/api/v2/'" --output-directory="'C:\packages'"
# We must use the 8.x.x versions of these packages, so we need to download/internalize these specific items. At the time of publishing, the most recent version of this package is 8.0.8, but later package versions (within the 8.x.x release) are expected to work.
@('dotnet-8.0-runtime', 'dotnet-8.0-aspnetruntime') | ForEach-Object {
choco download $_ --version 8.0.8 --force --internalize --internalize-all-urls --append-use-original-location --source="'https://community.chocolatey.org/api/v2/'" --output-directory="'C:\packages'"
}

# Starting with v0.9.0 of the CCM Website package, it uses dotnet-aspnetcoremodule-v2. At the time of publishing, the most recent version of this package 16.0.22108, but later package versions (within the 17.x.x release) are expected to work
choco download dotnet-aspnetcoremodule-v2 --version 16.0.22108 --force --internalize --internalize-all-urls --append-use-original-location --source="'https://community.chocolatey.org/api/v2/'" --output-directory="'C:\packages'"
# Starting with v0.9.0 of the CCM Website package, it uses dotnet-aspnetcoremodule-v2. At the time of publishing, the most recent version of this package 18.0.24201, but later package versions (within the 18.x.x release) are expected to work
choco download dotnet-aspnetcoremodule-v2 --version 18.0.24201 --force --internalize --internalize-all-urls --append-use-original-location --source="'https://community.chocolatey.org/api/v2/'" --output-directory="'C:\packages'"

# Download Licensed Packages
## DO NOT RUN WITH `--internalize` and `--internalize-all-urls` - see https://github.com/chocolatey/chocolatey-licensed-issues/issues/155
Expand Down
6 changes: 3 additions & 3 deletions src/content/docs/en-us/central-management/setup/service.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -605,8 +605,8 @@ Please refer to the <Xref title="Chocolatey Central Management Service Windows A

### Error 1053: The service did not respond to the start or control request in a timely fashion.

If the Chocolatey Central Management Service is not able to be started due to "Error 1053: The service did not respond to the start or control request in a timely fashion.", it is likely caused due to no compatible versions of dotnet aspnetruntime not being installed.
If the Chocolatey Central Management Service is not able to be started due to "Error 1053: The service did not respond to the start or control request in a timely fashion.", it is likely caused due to no compatible versions of dotnet aspnetruntime not being installed.

The installed runtimes can be listed with `dotnet --list-runtimes`. Ensure that a 6.x.x version of Microsoft.AspNetCore.App is listed. If there is not a version listed, reinstall `dotnet-6.0-aspnetruntime`.
The installed runtimes can be listed with `dotnet --list-runtimes`. Ensure that an 8.x.x version of Microsoft.AspNetCore.App is listed. If there is not a version listed, reinstall `dotnet-8.0-aspnetruntime`.

There is a known issue with the aspnetcoremodule-v2 installer that will uninstall the aspnetruntime on upgrade, which may be the root cause for this missing runtime. https://github.com/dotnetcore-chocolatey/dotnetcore-chocolateypackages/issues/64
There is a known issue with the aspnetcoremodule-v2 installer that will uninstall the aspnetruntime on upgrade, which may be the root cause for this missing runtime. https://github.com/dotnetcore-chocolatey/dotnetcore-chocolateypackages/issues/64
2 changes: 1 addition & 1 deletion src/content/docs/en-us/central-management/setup/upgrade.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ $YourInternalRepositoryApiKey = '<YOUR API KEY HERE>'
$YourBusinessLicenseGuid = '<INSERT C4B LICENSE GUID HERE>'

# Download Chocolatey community related dependencies, internalization necessary
choco download dotnet-6.0-runtime dotnet-6.0-aspnetruntime dotnet-aspnetcoremodule-v2 --source="'https://community.chocolatey.org/api/v2/'" --internalize --output-directory="'C:\packages'"
choco download dotnet-8.0-runtime dotnet-8.0-aspnetruntime dotnet-aspnetcoremodule-v2 --source="'https://community.chocolatey.org/api/v2/'" --internalize --output-directory="'C:\packages'"

# Download Licensed Packages
## DO NOT RUN WITH `--internalize` and `--internalize-all-urls` - see https://github.com/chocolatey/chocolatey-licensed-issues/issues/155
Expand Down
16 changes: 8 additions & 8 deletions src/content/docs/en-us/central-management/setup/website.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,20 +27,20 @@ This is the Chocolatey Central Management website that gives an API and a web la
* <Xref title="High-level Requirements" value="ccm-setup" anchor="high-level-requirements" />
* PowerShell 5.1
* IIS Set up and available
* dotnet-aspnetcoremodule-v2 version 16.0.23055
* dotnet-6.0-runtime version 6.0.15
* dotnet-6.0-aspnetruntime version 6.0.15
* dotnet-aspnetcoremodule-v2 version 18.0.24201
* dotnet-8.0-runtime version 8.0.8
* dotnet-8.0-aspnetruntime version 8.0.8

The Chocolatey Central Management Website is built on ASP.Net Core, and as such we need to ensure that it is installed on the server for proper function. Note that the codebase is currently locked to version `6.x.x` of these packages, and it is critical that you install these right, otherwise you will encounter errors. At the time of release, the most recent version of these packages was 6.0.5, though we recommend installing the latest versions of these packages.
The Chocolatey Central Management Website is built on ASP.Net Core, and as such we need to ensure that it is installed on the server for proper function. Note that the codebase is currently locked to version `8.x.x` of these packages, and it is critical that you install these right, otherwise you will encounter errors. At the time of release, the most recent version of these packages was 8.0.8, though we recommend installing the latest versions of these packages.

### Script for some prerequisites

```powershell
choco install IIS-WebServer --source windowsfeatures --no-progress -y
choco install IIS-ApplicationInit --source windowsfeatures --no-progress -y
choco install dotnet-aspnetcoremodule-v2 --version 16.0.23055 --no-progress -y
choco install dotnet-6.0-runtime --version 6.0.15 --no-progress -y
choco install dotnet-6.0-aspnetruntime --version 6.0.15 --no-progress -y
choco install dotnet-aspnetcoremodule-v2 --version 18.0.24201 --no-progress -y
choco install dotnet-8.0-runtime --version 8.0.8 --no-progress -y
choco install dotnet-8.0-aspnetruntime --version 8.0.8 --no-progress -y
```

## Step 2: Install Chocolatey Central Management Web Package
Expand Down Expand Up @@ -474,7 +474,7 @@ These errors happen very early in the application execution, and as a result, ar

In these situations, we have found that incorrect database connection strings are typically the root cause of the problem.

Another possible cause for this error is if there are mismatching versions of `dotnet-6.0-aspnetruntime` and `dotnet-aspnetcoremodule-v2`. Ensure that both are on the same patch level. Note that `dotnet-aspnetcoremodule-v2` package versioning does not directly correspond to the dotnet patch level, so it is recommended to use the versions specified in the prerequisites above
Another possible cause for this error is if there are mismatching versions of `dotnet-8.0-aspnetruntime` and `dotnet-aspnetcoremodule-v2`. Ensure that both are on the same patch level. Note that `dotnet-aspnetcoremodule-v2` package versioning does not directly correspond to the dotnet patch level, so it is recommended to use the versions specified in the prerequisites above

### The term 'Install-ChocolateyAppSettingsJsonFile' is not recognized as the name of a cmdlet, function, script file, or operable program.

Expand Down