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

(doc) Make documentation consistent with practice #809

Merged
merged 1 commit into from
Aug 16, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion input/en-us/choco/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -494,7 +494,7 @@ package {'chocolatey':
## Move cache location so Chocolatey is very deterministic about
## cleaning up temporary data
chocolateyconfig {'cacheLocation':
value => 'c:\ProgramData\choco-cache',
value => 'c:\ProgramData\chocolatey\choco-cache',
}

## Increase timeout to 4 hours
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ From the machine with internet access:
> It is normal to see an error at this point, the next steps which install the extension resolve this.
1. C4B / MSP / C4BTRIAL: Run `choco upgrade chocolatey.extension -y`. You will see what looks like an error message about not having chocolatey.extension installed. That's a warning and should clear up when this command completes.
1. Run `choco` - you should no longer see the error about not having chocolatey.extension installed. If you do, please circle back and use copy/paste for instructions as you may have mistyped something.
1. Run `choco config set --name cacheLocation --value $env:ALLUSERSPROFILE\choco-cache`. This moves the TEMP location in scripts to use this and makes clean up more deterministic.
1. Run `choco config set --name cacheLocation --value $env:ChocolateyInstall\choco-cache`. This moves the TEMP location in scripts to use this and makes clean up more deterministic.
1. Run `choco config set --name commandExecutionTimeoutSeconds --value 14400`. This increases the timeout more than the default 45 minutes, you may wish to set it higher.
1. C4B / MSP / C4BTRIAL: Run `choco feature enable --name="'internalizeAppendUseOriginalLocation'"`. This sets Package Internalizer to append `-UseOriginalLocation` to the end of `Install-ChocolateyPackage` to make it behave more like `Install-ChocolateyInstallPackage`. Since the files are local, we won't need it copying them to temp prior to running it.
1. C4B / MSP / C4BTRIAL: Run `choco feature enable --name="'reduceInstalledPackageSpaceUsage'"` to ensure Package Reducer is turned on.
Expand Down Expand Up @@ -188,7 +188,7 @@ choco upgrade chocolatey.extension -y --pre
Write-Host "If you see what looks like an error about a missing extension, that is what this step does so it will clear up on the next command."

# Set Configuration
choco config set --name cacheLocation --value $env:ALLUSERSPROFILE\choco-cache
choco config set --name cacheLocation --value $env:ChocolateyInstall\choco-cache
choco config set --name commandExecutionTimeoutSeconds --value 14400
#TODO: Add other items you would configure here
# https://docs.chocolatey.org/en-us/configuration
Expand Down Expand Up @@ -239,7 +239,7 @@ Now that we've finished the first exercise and have those files over on our offl
1. C4B / MSP / C4BTRIAL: Copy the license file ("chocolatey.license.xml") into that folder that was just created. Run `Copy-Item "$env:SystemDrive\choco-setup\files\chocolatey.license.xml" $env:ChocolateyInstall\license\chocolatey.license.xml -Force`.
1. C4B / MSP / C4BTRIAL: Run `choco source disable --name="'chocolatey.licensed'"`. When the license is placed, Chocolatey automatically adds the license and we don't want to use that source. Note we can't remove the license because the existence of the license file will have Chocolatey adding it right back - so we just disable it. You will see what looks like an error message about not having chocolatey.extension installed. That's a warning and we are going to take care of that in the next step.
1. C4B / MSP / C4BTRIAL: Run `choco upgrade chocolatey.extension -y --pre`. You will see what looks like an error message about not having chocolatey.extension installed. That's a warning and should clear up when this command completes.
1. Run `choco config set --name cacheLocation --value $env:ALLUSERSPROFILE\choco-cache`. This moves the TEMP location in scripts to use this and makes clean up more deterministic.
1. Run `choco config set --name cacheLocation --value $env:ChocolateyInstall\choco-cache`. This moves the TEMP location in scripts to use this and makes clean up more deterministic.
1. Run `choco config set --name commandExecutionTimeoutSeconds --value 14400`. This increases the timeout more than the default 45 minutes, you may wish to set it higher.
1. C4B / MSP / C4BTRIAL: Run `choco feature enable --name="'internalizeAppendUseOriginalLocation'"`. This sets Package Internalizer to append `-UseOriginalLocation` to the end of `Install-ChocolateyPackage` to make it behave more like `Install-ChocolateyInstallPackage`. Since the files are local, we won't need it copying them to temp prior to running it.
1. C4B / MSP / C4BTRIAL: Run `choco feature enable --name="'reduceInstalledPackageSpaceUsage'"` to ensure Package Reducer is turned on.
Expand Down Expand Up @@ -272,7 +272,7 @@ Write-Host "You can ignore the red text in the output above, as it is more of a
choco upgrade chocolatey.extension -y --pre

# Set Configuration
choco config set --name cacheLocation --value $env:ALLUSERSPROFILE\choco-cache
choco config set --name cacheLocation --value $env:ChocolateyInstall\choco-cache
choco config set --name commandExecutionTimeoutSeconds --value 14400
#TODO: Add other items you would configure here
# https://docs.chocolatey.org/en-us/configuration
Expand Down Expand Up @@ -583,7 +583,7 @@ Starting with Chocolatey.Server v0.2.3, you get a similar experience where you j
1. C4B / MSP / C4BTRIAL: Install the license package we've pushed - `choco upgrade chocolatey-license -y`. This may be a place you see an error if things are not configured correctly. If you run into an error, be sure that you have the source added properly with the right permissions (not api key - that is for pushes only).
1. C4B / MSP / C4BTRIAL: Run `choco source disable --name="'chocolatey.licensed'"`. When the license is placed, Chocolatey automatically adds the license and we don't want to use that source. Note we can't remove the license because the existence of the license file will have Chocolatey adding it right back - so we just disable it. You will see what looks like an error message about not having chocolatey.extension installed. That's a warning and we are going to take care of that in the next step.
1. C4B / MSP / C4BTRIAL: Run `choco upgrade chocolatey.extension -y --pre`. You will see what looks like an error message about not having chocolatey.extension installed. That's a warning and should clear up when this command completes.
1. Run `choco config set --name cacheLocation --value $env:ALLUSERSPROFILE\choco-cache`. This moves the TEMP location in scripts to use this and makes clean up more deterministic.
1. Run `choco config set --name cacheLocation --value $env:ChocolateyInstall\choco-cache`. This moves the TEMP location in scripts to use this and makes clean up more deterministic.
1. Run `choco config set --name commandExecutionTimeoutSeconds --value 14400`. This increases the timeout more than the default 45 minutes, you may wish to set it higher.
1. C4B / MSP / C4BTRIAL: Run `choco feature enable --name="'internalizeAppendUseOriginalLocation'"`. This sets Package Internalizer to append `-UseOriginalLocation` to the end of `Install-ChocolateyPackage` to make it behave more like `Install-ChocolateyInstallPackage`. Since the files are local, we won't need it copying them to temp prior to running it.
1. C4B / MSP / C4BTRIAL: Run `choco feature enable --name="'reduceInstalledPackageSpaceUsage'"` to ensure Package Reducer is turned on.
Expand Down Expand Up @@ -637,7 +637,7 @@ Write-Host "You can ignore the red text in the output above, as it is more of a
choco upgrade chocolatey.extension -y --pre

# Set Configuration
choco config set --name cacheLocation --value $env:ALLUSERSPROFILE\choco-cache
choco config set --name cacheLocation --value $env:ChocolateyInstall\choco-cache
choco config set --name commandExecutionTimeoutSeconds --value 14400
#TODO: Add other items you would configure here
# https://docs.chocolatey.org/en-us/configuration
Expand Down
2 changes: 1 addition & 1 deletion input/en-us/licensed-extension/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -213,7 +213,7 @@ package {'chocolatey':
## Move cache location so Chocolatey is very deterministic about
## cleaning up temporary data
chocolateyconfig {'cacheLocation':
value => 'c:\ProgramData\choco-cache',
value => 'c:\ProgramData\chocolatey\choco-cache',
}

## Increase timeout to 4 hours
Expand Down
Loading