Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Revises Advanced Configuration, revising several figures.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Revert to 1a3b3c7b7bebf8b580d6d9cc6d4d564f46b394bd.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Reorders figures from Fig. 9 onward; inserts many new screenshots.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Make uniform description of recommended partitioning schema.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Revises Fig 7, removing warning; saves edits to Fig 29.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Apply edits on encyption per mdhorn feedback.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Refines desc of installation methods; distinguish 2 methods of encryption.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Remove internal cross-ref; fix duplicate ref to Telemetry.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Adds repair of failed installation. Adds, revises target refs where needed.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Adds repair of failed installation. Adds, revises target refs where needed.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Add cross-ref to swupd-guide per feedback.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Incorporate reviewer feedback; reset refs for includes to `-beta`.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Revise per reviewer feedback on PR.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Removes configuration /etc/systemd/system/docker.service.d/50-runtime.conf
- 50-runtime.conf file automatically created on CL builds > 27000
- Adds Troubleshooting, and adds prev manual conf option
- Closes#453
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Revises kata.rst adding Troubleshooting link to change devicemapper for production.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Revise to ../50-runtime.conf
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Replace storage driver devicemapper with overlay2; add note.
- kata: add note re options of storage drivers.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Remove grep runtime bc of errors; assign bullets to troubleshooting.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Adds smb-desktop for samba sharing from CL Gnome desktop.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Add tut on how to connect to Win share with Nautilus on CL.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Add toc reference.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Adds missing `_` leading space before file name; root cause image failure. (#431)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Remove older unused openssh-server ref from toctree. (#432)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* updating dd command to add sync for Linux section (#425)
* Add document on installing proprietary NVIDIA drivers (#429)
* Add document on using YubiKey with U2F (#416)
* Add document on using YubiKey with U2F
* Add yubikey doc to tutorials TOC
* Update all links to the download website to use the CDN (#434)
Update all links pointing at https://download.clearlinux.org to use
the CDN, i.e. https://cdn.download.clearlinux.org
Signed-off-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com>
* Move autoproxy content to updated guide template (#417)
* first draft revision of autoproxy guide with guide template
* removed related topics as there is currently nothing that qualifies
* restructured a bit more to match guide template; removed autoproxy_about.txt and autoproxy_guide.txt as they are no longer needed
* made changes recommended by @mvincerx
* minor corrections based on feedback
* Update to the swupd Guide (#409)
* partial commit to save work
* latest changes
* replaced out of date swupd-guide.rst with contents of swupd-temp.rst; removed swupd-temp.rst
* changed page ref to swupd-guide from swupd; too many existing dependencies
* Added descriptions of manifests and delta packs from How to Clear
* fixed typo
* changed header organization slightly and removed unnecessary text formatting
* updated a couple headers to make more sense
* numerous cosmetic and readability changes based on full render review
* changes to description section based on updated swupd concept page
* updates based on feedback
* updates based on technical review
* removed swupd-search.rst; updated maintenance.rst toc tree after removal; updated references in developer-workstation.rst and kernel-module.rst that linked to swupd-search.rst
* Bootable USB (#436)
* bootable-usb: Add extra caution about unmount
Not unmounting an USB partition before an image is burned could cause
file system checksum errors leading to other issues (including kernel
panics) when trying to boot from the USB drive. This commit adds an extra
caution note to warn the users about the possible issues they could find
when this step is not followed correctly.
Signed-off-by: Jair Gonzalez <jair.de.jesus.gonzalez.plascencia@intel.com>
* bootable-usb: Add o_sync to the dd command
Update the example 'dd' command to burn an image, by adding the 'oflag=sync'
option. This allows to reduce the flashing time in conjunction with the
recommended 'bs=4M', enables a more accurate progress indicator, and allows
to remove the additional sync command, while preserving some cache
optimizations.
Signed-off-by: Jair Gonzalez <jair.de.jesus.gonzalez.plascencia@intel.com>
* Revises intro to add expl of CIFS/SMB in context; removes empty ref.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Adds smb-desktop for samba sharing from CL Gnome desktop.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Add tut on how to connect to Win share with Nautilus on CL.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Add toc reference.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Revises intro to add expl of CIFS/SMB in context; removes empty ref.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Revise intro per feedback; corrects hidden indent error; adds note.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Initial commit of rework
- Restructure organization of content to be task and background oriented
- Include references to available man pages
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* - Updated bundle section: updates in tooling, simplified and added ref to man page
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Tested all examples except Docker proxy info.
Expanded examples and included setup of VM to test image and update content.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Comment removal
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Clean up comments and TODOs in preparation for initial review.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Updates based on @intelkevinputnam feedback
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Update bundle section based on new info from engineering.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Correct capitalization of mixer name.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Edits per feedback from @bktan8
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Update prereq formatting and numbered list formatting (remove bold).
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Minor edit to section heading for standardization
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Minor edits around prerequirements formatting to bring inline with template.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Revise example intro to be more concise.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Minor revisions to standardize CL tooling guides
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Revisions based on feedback from @rchiossi.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* updates based on feedback
* slight wording fix
* fixed lack of indent after line break which was causing a problem with numbered list; fixed console code block syntax error
* fixed final instruction to read 'no longer'; added local bundles and upstream RMPs to bullet list
* fixed json proxy urls
* bootable-usb: Add extra caution about unmount
Not unmounting an USB partition before an image is burned could cause
file system checksum errors leading to other issues (including kernel
panics) when trying to boot from the USB drive. This commit adds an extra
caution note to warn the users about the possible issues they could find
when this step is not followed correctly.
Signed-off-by: Jair Gonzalez <jair.de.jesus.gonzalez.plascencia@intel.com>
* bootable-usb: Add o_sync to the dd command
Update the example 'dd' command to burn an image, by adding the 'oflag=sync'
option. This allows to reduce the flashing time in conjunction with the
recommended 'bs=4M', enables a more accurate progress indicator, and allows
to remove the additional sync command, while preserving some cache
optimizations.
Signed-off-by: Jair Gonzalez <jair.de.jesus.gonzalez.plascencia@intel.com>
* partial commit to save work
* latest changes
* replaced out of date swupd-guide.rst with contents of swupd-temp.rst; removed swupd-temp.rst
* changed page ref to swupd-guide from swupd; too many existing dependencies
* Added descriptions of manifests and delta packs from How to Clear
* fixed typo
* changed header organization slightly and removed unnecessary text formatting
* updated a couple headers to make more sense
* numerous cosmetic and readability changes based on full render review
* changes to description section based on updated swupd concept page
* updates based on feedback
* updates based on technical review
* removed swupd-search.rst; updated maintenance.rst toc tree after removal; updated references in developer-workstation.rst and kernel-module.rst that linked to swupd-search.rst
* first draft revision of autoproxy guide with guide template
* removed related topics as there is currently nothing that qualifies
* restructured a bit more to match guide template; removed autoproxy_about.txt and autoproxy_guide.txt as they are no longer needed
* made changes recommended by @mvincerx
* minor corrections based on feedback
- Adds `architect-lifecycle` as Phase 1 prior to `distro-factory` in guides for a DevOps toolchain.
- Adds Figure 1 overview.
- Adds architect-lifecycle to toctree in maintenance.rst
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
Incorporate @mbelluzzo feedback. In progress.
Include reference/reference changes.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Redefine scope, title of document: Maintain CL life-cycle.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Revise intro after re-scoping.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Revises scope as overview of life-cycle; context for distro-factory.
Adds new simplified graphic.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Retitles; revises intro and Content Workflow.
Revise Figure 1 and renames it. Revises document filename.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Removes older version.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Adds revised title to toctree. Corrects missing `-`.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Stop referring to other distros as "traditional"
* Revise swupd-about to focus on swupd
* Minor fixes
* Revised with feedback from @mvincerx
* Apply line-edits for brevity and readability.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* Fix typo Ln 19.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* adding pytorch section
* updated doc
Minor nits and corrections
* scripts: Code Block rst parser
Signed-off-by: John Andersen <john.s.andersen@intel.com>
* limited to bash code blocks and added description to the header
* added ability to create a list of code blocks to parse
* adding pytorch section
* updating PyTorch image link & name
* updating docker image link and adding PyTorch benchmarking link
* Sphinx syntax corrections; reorganizes contents/toctree; line-edits.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
* updating link to PyTorch benchmarks
- Wording improvments
- Move instructions for required setup for building source to References section.
This follows similar org to the mixer guide, keeping emphasis in 'how it works' on
the description of what is required and how it works, and keeping the examples
section as just examples of autospec. Idea is this setup is a supporting reference
for using/enabling the tool.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
presented more as the setup for building source in CL (rather than autospec
specific). So that the setup instructions may be reused. Added section labels
back in for external reference.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
Beth Dean