diff options
author | growupboron <shankhoghosh123@gmail.com> | 2020-10-09 00:19:18 +0530 |
---|---|---|
committer | Jan-Simon Moeller <jsmoeller@linuxfoundation.org> | 2020-10-14 11:19:53 +0000 |
commit | eefc3ab6cbb8a5901632f46d99e13c8d90b2415d (patch) | |
tree | 90815d532ed7b2d0962a1468aee29f05a4404eef /docs/3_Developer_Guides/2_Building_Microservices_Natively/2_download-packages.md | |
parent | 4aad369c9728061c97b3de792286e743ee884b09 (diff) |
rewrote quickstart, build-process
Revamped and updated documentation to install and build AGL images.
(removed whitespaces, added contribution guide, corrected rcar-gen3 section 7, added aglsetup.h flags to hardware support, some minor changes)
Bug-AGL: [SPEC-3633]
Signed-off-by: Shankho Boron Ghosh <shankhoghosh123@gmail.com>
Change-Id: Iedb6c7dc1661f4bc58b5f25ea5d188778c7ff908
Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/25407
Reviewed-by: Jan-Simon Moeller <jsmoeller@linuxfoundation.org>
Tested-by: Jan-Simon Moeller <jsmoeller@linuxfoundation.org>
Diffstat (limited to 'docs/3_Developer_Guides/2_Building_Microservices_Natively/2_download-packages.md')
-rw-r--r-- | docs/3_Developer_Guides/2_Building_Microservices_Natively/2_download-packages.md | 239 |
1 files changed, 0 insertions, 239 deletions
diff --git a/docs/3_Developer_Guides/2_Building_Microservices_Natively/2_download-packages.md b/docs/3_Developer_Guides/2_Building_Microservices_Natively/2_download-packages.md deleted file mode 100644 index c1502d2..0000000 --- a/docs/3_Developer_Guides/2_Building_Microservices_Natively/2_download-packages.md +++ /dev/null @@ -1,239 +0,0 @@ ---- -edit_link: '' -title: Download Packages -origin_url: >- - https://raw.githubusercontent.com/automotive-grade-linux/docs-sources/master/agl-documentation/host-configuration/docs/2-download-packages.md ---- - -<!-- WARNING: This file is generated by fetch_docs.js using /home/boron/Documents/AGL/docs-webtemplate/site/_data/tocs/devguides/master/host-configuration-developer-guides-devguides-book.yml --> - -# Download Packages - -Different repositories exist for different AGL releases.\ -You need to download and install the packages based on your version -of AGL. - -## Set the `REVISION` Environment Variable - -All the packages reside in repositories managed by the -[OpenSUSE Build Service (OBS)](https://build.opensuse.org/).\ -You can see the packages -[here](https://build.opensuse.org/project/subprojects/isv:LinuxAutomotive#). - -Currently, support exists for the following AGL releases: - -* ElectricEel -* FunkyFlounder -* GrumpyGuppy -* HappyHalibut -* Master - -You need to set the `REVISION` environment variable to the AGL release you -are using.\ -For this example, set and export `REVISION` as "Master". - -```bash -export REVISION=Master -``` - -For additional details about OBS, see -[LinuxAutomotive page on OBS](https://build.opensuse.org/project/show/isv:LinuxAutomotive). - -## Make Sure Your `DISTRO` Environment Variable is Set - -The `DISTRO` environment variable needs to be correctly set for your -Linux distribution.\ -See the -"[Verify Your Build Host](./1-verify-build-host.html)" -section for information on how to set this variable. - -## Install the Repository - -```bash -Hit:1 https://deb.nodesource.com/node_10.x xenial InRelease -Hit:2 https://download.docker.com/linux/ubuntu xenial InRelease -Hit:3 http://security.ubuntu.com/ubuntu xenial-security InRelease -Hit:4 http://us.archive.ubuntu.com/ubuntu xenial InRelease -Ign:5 http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/AGL_FunkyFlounder/xUbuntu_16.04 ./ InRelease -Hit:6 http://us.archive.ubuntu.com/ubuntu xenial-updates InRelease -Hit:7 http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/AGL_FunkyFlounder/xUbuntu_16.04 ./ Release -Hit:8 http://us.archive.ubuntu.com/ubuntu xenial-backports InRelease -Reading package lists... Done -``` - -Not sure why you get the `Ign` on line 5.\ -I guess InRelease does not exist. - -If you don't have a `/etc/apt/sources.list.d/AGL.list` file to even start with, -and you run through the whole thing, you get the following output: - -```bash -$ sudo apt-get update -Hit:1 https://deb.nodesource.com/node_10.x xenial InRelease -Hit:2 https://download.docker.com/linux/ubuntu xenial InRelease -Hit:3 http://us.archive.ubuntu.com/ubuntu xenial InRelease -Get:4 http://us.archive.ubuntu.com/ubuntu xenial-updates InRelease [109 kB] -Get:5 http://security.ubuntu.com/ubuntu xenial-security InRelease [107 kB] -Ign:6 http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/AGL_FunkyFlounder/xUbuntu_16.04 ./ InRelease -Hit:7 http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/AGL_FunkyFlounder/xUbuntu_16.04 ./ Release -Get:9 http://us.archive.ubuntu.com/ubuntu xenial-backports InRelease [107 kB] -Get:10 http://us.archive.ubuntu.com/ubuntu xenial-updates/main amd64 Packages [902 kB] -Fetched 1,225 kB in 1s (803 kB/s) -Reading package lists... Done -``` - -Following are example commands that show how to install the package repository -based on various values of `DISTRO` and `REVISION`: - -### Ubuntu and "Master" - -```bash -export REVISION=Master -export DISTRO="xUbuntu_18.04" -wget -O - http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/AGL_${REVISION}/${DISTRO}/Release.key | sudo apt-key add - -sudo bash -c "cat >> /etc/apt/sources.list.d/AGL.list <<EOF -#AGL -deb http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/AGL_${REVISION}/${DISTRO}/ ./ -EOF" -sudo apt-get update -``` - -You can see the installed repository using the following command: - -```bash -cat /etc/apt/sources.list.d/AGL.list -``` - -### OpenSUSE and "Master" - -```bash -export DISTRO="openSUSE_Leap_15.0" -export REVISION=Master -source /etc/os-release; export DISTRO=$(echo $PRETTY_NAME | sed "s/ /_/g") -sudo zypper ar http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/AGL_${REVISION}/${DISTRO}/isv:LinuxAutomotive:AGL_${REVISION}.repo -sudo zypper --gpg-auto-import-keys ref -``` - -You can see the installed repository using the following command: - -```bash -zypper repos | grep AGL -``` - -### Fedora and "Master" - -```bash -export DISTRO="Fedora_28" -export REVISION=Master -source /etc/os-release ; export DISTRO="${NAME}_${VERSION_ID}" -sudo wget -O /etc/yum.repos.d/isv:LinuxAutomotive:AGL_${REVISION}.repo http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/AGL_${REVISION}/${DISTRO}/isv:LinuxAutomotive:AGL_${REVISION}.repo -``` - -You can see the installed repository using the following command: - -```bash -dnf repolist --all | grep AGL -``` - -## Switching Between Repositories - -The commands in the previous section showed you how to install the packages -from a specific repository and how to verify whether or not the packages -are enabled or disabled. -You can switch between different repositories. -You must disable your current AGL repository and then enable the repository -designated for the switch. - -Following is an example for Debian distributions: - -### Example for Debian distro - -Suppose you are on "master" and you want the "ElectricEel" AGL revision. - -```bash -export OLDR=Master -export NEWR=ElectricEel -sudo sed -i "s/${OLDR}/${NEWR}/g" /etc/apt/sources.list.d/AGL.list -sudo apt-get update -``` - -### Example for openSuse distro - -```bash -# | Alias | Name | Enabled | GPG Check | Refresh ----+-------------------------------------+-------------------------------------------------------------------------------------------+---------+-----------+-------- - 1 | Atom | Atom Editor | Yes | (r ) Yes | No - 2 | code | Visual Studio Code | Yes | (r ) Yes | No - 3 | http-ftp.uni-erlangen.de-e3cebb6d | Packman Repository | Yes | (r ) Yes | Yes - 4 | isv_LinuxAutomotive_AGL_ElectricEel | isv:LinuxAutomotive:AGL_ElectricEel (openSUSE_Leap_15.0) | Yes | (r ) Yes | No - 5 | isv_LinuxAutomotive_AGL_Master | Automotive Grade Linux Application Development tools - master branch (openSUSE_Leap_15.0) | No | ---- | ---- - 6 | openSUSE-Leap-15.0-1 | openSUSE-Leap-15.0-1 | No | ---- | ---- - 7 | repo-debug | openSUSE-Leap-15.0-Debug | No | ---- | ---- - 8 | repo-debug-non-oss | openSUSE-Leap-15.0-Debug-Non-Oss | No | ---- | ---- - 9 | repo-debug-update | openSUSE-Leap-15.0-Update-Debug | No | ---- | ---- -10 | repo-debug-update-non-oss | openSUSE-Leap-15.0-Update-Debug-Non-Oss | No | ---- | ---- -11 | repo-non-oss | openSUSE-Leap-15.0-Non-Oss | Yes | (r ) Yes | Yes -12 | repo-oss | openSUSE-Leap-15.0-Oss | Yes | (r ) Yes | Yes -13 | repo-source | openSUSE-Leap-15.0-Source | No | ---- | ---- -14 | repo-source-non-oss | openSUSE-Leap-15.0-Source-Non-Oss | No | ---- | ---- -15 | repo-update | openSUSE-Leap-15.0-Update | Yes | (r ) Yes | Yes -16 | repo-update-non-oss | openSUSE-Leap-15.0-Update-Non-Oss | Yes | (r ) Yes | Yes -``` - -Now, you want your "master" repository enabled. -In the above output, the "ElectricEel" repository is at the fourth line -and the "master" repository is at the fifth line. -Thus, enter the following: - -```bash -$ sudo zypper mr -d 4 && sudo zypper mr -e 5 -Repository 'isv_LinuxAutomotive_AGL_ElectricEel' has been successfully disabled. -Repository 'isv_LinuxAutomotive_AGL_Master' has been successfully enabled. -sudo zypper refresh -``` - -**NOTE:** In the previous command, the "-d" option is used for "disable" and the -"-e" option is used for "enable". - -Following are the results: - -```bash -# | Alias | Name | Enabled | GPG Check | Refresh ----+-------------------------------------+-------------------------------------------------------------------------------------------+---------+-----------+-------- - 1 | Atom | Atom Editor | Yes | (r ) Yes | No - 2 | code | Visual Studio Code | Yes | (r ) Yes | No - 3 | http-ftp.uni-erlangen.de-e3cebb6d | Packman Repository | Yes | (r ) Yes | Yes - 4 | isv_LinuxAutomotive_AGL_ElectricEel | isv:LinuxAutomotive:AGL_ElectricEel (openSUSE_Leap_15.0) | No | ---- | ---- - 5 | isv_LinuxAutomotive_AGL_Master | Automotive Grade Linux Application Development tools - master branch (openSUSE_Leap_15.0) | Yes | (r ) Yes | No - 6 | openSUSE-Leap-15.0-1 | openSUSE-Leap-15.0-1 | No | ---- | ---- - 7 | repo-debug | openSUSE-Leap-15.0-Debug | No | ---- | ---- - 8 | repo-debug-non-oss | openSUSE-Leap-15.0-Debug-Non-Oss | No | ---- | ---- - 9 | repo-debug-update | openSUSE-Leap-15.0-Update-Debug | No | ---- | ---- -10 | repo-debug-update-non-oss | openSUSE-Leap-15.0-Update-Debug-Non-Oss | No | ---- | ---- -11 | repo-non-oss | openSUSE-Leap-15.0-Non-Oss | Yes | (r ) Yes | Yes -12 | repo-oss | openSUSE-Leap-15.0-Oss | Yes | (r ) Yes | Yes -13 | repo-source | openSUSE-Leap-15.0-Source | No | ---- | ---- -14 | repo-source-non-oss | openSUSE-Leap-15.0-Source-Non-Oss | No | ---- | ---- -15 | repo-update | openSUSE-Leap-15.0-Update | Yes | (r ) Yes | Yes -16 | repo-update-non-oss | openSUSE-Leap-15.0-Update-Non-Oss | Yes | (r ) Yes | Yes -``` - -### Example for Fedora distro - -```bash -isv_LinuxAutomotive_AGL_FunkyFlounder isv:LinuxAutomotive:AGL disabled -isv_LinuxAutomotive_AGL_Master Automotive Grade Linux enabled -``` - -The following commands enable the "ElectricEel" repository: - -```bash -dnf config-manager --set-disabled isv_LinuxAutomotive_AGL_Master -dnf config-manager --set-enabled isv_LinuxAutomotive_AGL_FunkyFlounder -``` - -```bash -$ dnf repolist --all | grep AGL -isv_LinuxAutomotive_AGL_FunkyFlounder isv:LinuxAutomotive:AGL enabled -isv_LinuxAutomotive_AGL_Master Automotive Grade Linux disabled -``` |