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

Clarify support status of installing from source. #2941

Merged
merged 2 commits into from
Oct 9, 2023
Merged

Clarify support status of installing from source. #2941

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f677e00
Clarify support status of installing from source.
Oct 9, 2023
e7d5347
Merge branch 'develop' into install
narrieta Oct 9, 2023
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
21 changes: 15 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,11 +84,13 @@ Waagent depends on some system packages in order to function properly:

## Installation

Installation via your distribution's package repository is preferred.
You can also customize your own RPM or DEB packages using the configuration
samples provided (see deb and rpm sections below).
Installing via your distribution's package repository is the only method that is supported.

For more advanced installation options, such as installing to custom locations or prefixes, you can use **setuptools** to install from source by running:
You can install from source for more advanced options, such as installing to a custom location or creating
custom images. Installing from source, though, may override customizations done to the Agent by your
distribution, and is meant only for advanced users. We provide very limited support for this method.

To install from source, you can use **setuptools**:

```bash
sudo python setup.py install --register-service
Expand All @@ -108,11 +110,18 @@ You can view more installation options by running:

The agent's log file is kept at `/var/log/waagent.log`.

Lastly, you can also customize your own RPM or DEB packages using the configuration
samples provided in the deb and rpm sections below. This method is also meant for advanced users and we
provide very limited support for it.


## Upgrade

Upgrading via your distribution's package repository is strongly preferred.
Upgrading via your distribution's package repository or using automatic updates are the only supported
methods. More information can be found here: [Update Linux Agent](https://learn.microsoft.com/en-us/azure/virtual-machines/extensions/update-linux-agent)

If upgrading manually, same with installation above by running:
To upgrade the Agent from source, you can use **setuptools**. Upgrading from source is meant for advanced
users and we provide very limited support for it.

```bash
sudo python setup.py install --force
Expand Down
Loading