Skip to content

Commit aa45ece

Browse files
committed
(#1057) Update CCM dependency versions
With the 0.13.0 release, the CCM dependency versions (and package IDs) are changing, so updating the dependency information is necessary.
1 parent c9be145 commit aa45ece

File tree

4 files changed

+16
-16
lines changed

4 files changed

+16
-16
lines changed

src/content/docs/en-us/central-management/setup/index.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -68,13 +68,13 @@ choco download dotnet4.5.2 dotnetfx --force --internalize --internalize-all-urls
6868
choco download $_ --force --internalize --internalize-all-urls --append-use-original-location --source="'https://community.chocolatey.org/api/v2/'" --output-directory="'C:\packages'"
6969
}
7070
71-
# 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.
72-
@('dotnet-6.0-runtime', 'dotnet-6.0-aspnetruntime') | Foreach-Object {
73-
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'"
71+
# 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.
72+
@('dotnet-8.0-runtime', 'dotnet-8.0-aspnetruntime') | Foreach-Object {
73+
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'"
7474
}
7575
76-
# 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
77-
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'"
76+
# 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
77+
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'"
7878
7979
# Download Licensed Packages
8080
## DO NOT RUN WITH `--internalize` and `--internalize-all-urls` - see https://github.com/chocolatey/chocolatey-licensed-issues/issues/155

src/content/docs/en-us/central-management/setup/service.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -609,8 +609,8 @@ Please refer to the <Xref title="Chocolatey Central Management Service Windows A
609609

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

612-
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.
612+
If the Chocolatey Central Management Service cannot be started due to "Error 1053: The service did not respond to the start or control request in a timely fashion.", it will likely be caused by no compatible versions of dotnet aspnetruntime being installed.
613613

614-
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`.
614+
The installed runtimes can be listed with `dotnet --list-runtimes`. Ensure that a 8.x.x version of Microsoft.AspNetCore.App is listed. If there is not a version listed, reinstall `dotnet-8.0-aspnetruntime`.
615615

616-
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
616+
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

src/content/docs/en-us/central-management/setup/upgrade.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ $YourInternalRepositoryApiKey = '<YOUR API KEY HERE>'
4141
$YourBusinessLicenseGuid = '<INSERT C4B LICENSE GUID HERE>'
4242
4343
# Download Chocolatey community related dependencies, internalization necessary
44-
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'"
44+
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'"
4545
4646
# Download Licensed Packages
4747
## DO NOT RUN WITH `--internalize` and `--internalize-all-urls` - see https://github.com/chocolatey/chocolatey-licensed-issues/issues/155

src/content/docs/en-us/central-management/setup/website.mdx

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,9 @@ This is the Chocolatey Central Management website that gives an API and a web la
2828
* <Xref title="High-level Requirements" value="ccm-setup" anchor="high-level-requirements" />
2929
* PowerShell 5.1
3030
* IIS Set up and available
31-
* dotnet-aspnetcoremodule-v2 version 16.0.23055
32-
* dotnet-6.0-runtime version 6.0.15
33-
* dotnet-6.0-aspnetruntime version 6.0.15
31+
* dotnet-aspnetcoremodule-v2 version 18.0.24201
32+
* dotnet-8.0-runtime version 8.0.8
33+
* dotnet-8.0-aspnetruntime version 8.0.8
3434

3535
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.
3636

@@ -39,9 +39,9 @@ The Chocolatey Central Management Website is built on ASP.Net Core, and as such
3939
```powershell
4040
choco install IIS-WebServer --source windowsfeatures --no-progress -y
4141
choco install IIS-ApplicationInit --source windowsfeatures --no-progress -y
42-
choco install dotnet-aspnetcoremodule-v2 --version 16.0.23055 --no-progress -y
43-
choco install dotnet-6.0-runtime --version 6.0.15 --no-progress -y
44-
choco install dotnet-6.0-aspnetruntime --version 6.0.15 --no-progress -y
42+
choco install dotnet-aspnetcoremodule-v2 --version 18.0.24201 --no-progress -y
43+
choco install dotnet-8.0-runtime --version 8.0.8 --no-progress -y
44+
choco install dotnet-8.0-aspnetruntime --version 8.0.8 --no-progress -y
4545
```
4646

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

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

480-
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
480+
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.
481481

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

0 commit comments

Comments
 (0)