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

Adding proxy configuration in the updates documentation #327

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

bleader
Copy link
Contributor

@bleader bleader commented Feb 27, 2025

Adding some explanations about how to configure proxies in order to be able to update when a proxy is needed to reach the repositories.

Before submitting the pull request, you must agree with the following statements by checking both boxes with a 'x'.

  • "I accept that my contribution is placed under the CC BY-SA 2.0 license [1]."
  • "My contribution complies with the Developer Certificate of Origin [2]."

[1] https://creativecommons.org/licenses/by-sa/2.0/
[2] https://docs.xcp-ng.org/project/contributing/#developer-certificate-of-origin-dco

@@ -30,6 +30,31 @@ If your version is lower than `8.2`, it will not receive updates anymore. To kee

Your dom0 system must either have access to the internet, or to a local mirror. In the second case, make sure to update the `baseurl` values in `/etc/yum.repos.d/xcp-ng.repo` to make them point at the local mirror, and keep the mirror regularly synced.

#### Proxy configuration

If your hosts need to use a proxy to be able to access the repositories, there are multiple ways to configure it depending on your use case:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
If your hosts need to use a proxy to be able to access the repositories, there are multiple ways to configure it depending on your use case:
If your hosts need a proxy to access the repositories, there are a few ways to set it up depending on what you need:

- Set `proxy=<proxy_url>` in the repository section of your choice in files present in `/etc/yum.repos.d`

Set a system-wide proxy that will be used for everything, not only yum:
- Add you can export lines for `http_proxy` and `https_proxy` variables in `/etc/environment`
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
- Add you can export lines for `http_proxy` and `https_proxy` variables in `/etc/environment`
- Export the `http_proxy` and `https_proxy` variables in `/etc/environment`:

or

Suggested change
- Add you can export lines for `http_proxy` and `https_proxy` variables in `/etc/environment`
Add these export lines for `http_proxy` and `https_proxy` variables in `/etc/environment`

```

:::warning
There are caveats for each methods:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
There are caveats for each methods:
Each method has its own quirks:

or

Suggested change
There are caveats for each methods:
Each method has its caveat:

- Updating the `yum` package may overwrite `/etc/yum.conf`
- Updating the `xcp-ng-release` package may overwrite files in `/etc/yum.repos.d/`
- Updating the `setup` package may overwrite `/etc/environment`
- Environmentn variables won't be taken into account when updating through Xen Orchestra
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
- Environmentn variables won't be taken into account when updating through Xen Orchestra
- Environment variables won't be used when updating through Xen Orchestra

or

Suggested change
- Environmentn variables won't be taken into account when updating through Xen Orchestra
- Environment variables won't be taken into account when updating through Xen Orchestra

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants