Merge pull request #612 from krisdale/rtd-theme

Initial commit for localization files
This commit is contained in:
Kevin Putnam
2019-07-12 13:14:48 -07:00
committed by GitHub
283 changed files with 53395 additions and 0 deletions
Binary file not shown.
+275
View File
@@ -0,0 +1,275 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../FAQ/faq.rst:4
msgid "FAQ"
msgstr ""
#: ../../FAQ/faq.rst:6
msgid ""
"Below is a list of commonly asked questions with answers sourced from the"
" |CL-ATTR| team and `Clear Linux community forums`_."
msgstr ""
#: ../../FAQ/faq.rst:14
msgid "General"
msgstr ""
#: ../../FAQ/faq.rst:17
msgid "Why did you make another distro?"
msgstr ""
#: ../../FAQ/faq.rst:19
msgid ""
"The |CL| team felt that performance was left on the table with Linux "
"software. |CL| takes a holistic approach to improving performance across "
"the stack. We also wanted to take more modern approaches with OS updates "
"and tooling."
msgstr ""
#: ../../FAQ/faq.rst:26
msgid "Can other distros copy |CL| improvements?"
msgstr ""
#: ../../FAQ/faq.rst:28
msgid "Yes, we absolutely love open source reuse and upstreaming improvements."
msgstr ""
#: ../../FAQ/faq.rst:33
msgid "How often do you update?"
msgstr ""
#: ../../FAQ/faq.rst:35
msgid ""
"The |CL| team puts out multiple releases a week, often releasing 2 or "
"more times a day. This rolling release approach allows |CL| to remain "
"agile to upstream changes and security patches."
msgstr ""
#: ../../FAQ/faq.rst:42
msgid "Is telemetry required?"
msgstr ""
#: ../../FAQ/faq.rst:44
msgid ""
"The telemetry solution provided by |CL| is entirely optional and "
"customizable. It is disabled by default. If you do choose to enable "
"telemetry, the data helps the |CL| team proactively identify and resolve "
"bugs. See the :ref:`telemetry <telemetry-about>` page for more "
"information."
msgstr ""
#: ../../FAQ/faq.rst:52
msgid "What is the default firewall?"
msgstr ""
#: ../../FAQ/faq.rst:54
msgid ""
"|CL| packages :command:`iptables` as a bundle, however, there are no "
"default firewall rules. All network traffic is allowed by default."
msgstr ""
#: ../../FAQ/faq.rst:60
msgid "Where are the files that I usually see under /etc like fstab?"
msgstr ""
#: ../../FAQ/faq.rst:62
msgid ""
"|CL| has a stateless design that maintains a separation between system "
"files and user files. Default values are stored under "
":file:`/usr/share/defaults/`. Files under :file:`/etc/` are not created "
"unless you create one."
msgstr ""
#: ../../FAQ/faq.rst:66
msgid ""
"A blog post explaining how this is accomplished with :file:`/etc/fstab/` "
"specifically is available here: https://clearlinux.org/news-blogs/where-"
"etcfstab-clear-linux"
msgstr ""
#: ../../FAQ/faq.rst:73
msgid "Software packages"
msgstr ""
#: ../../FAQ/faq.rst:76
msgid "How is software installed and updated?"
msgstr ""
#: ../../FAQ/faq.rst:78
msgid ""
"|CL| provides software in the form of :ref:`bundles <bundles-about>` and "
"updates software with :ref:`swupd <swupd-about>`."
msgstr ""
#: ../../FAQ/faq.rst:81
msgid ""
":ref:`FlatPak\\* <flatpak>` is an application virtualization solution "
"that allows more software to be available to |CL| users by augmenting the"
" software |CL| packages natively with software available through FlatPak."
msgstr ""
#: ../../FAQ/faq.rst:85
msgid ""
"Our goal is to have software packaged natively and made available through"
" bundles whenever possible."
msgstr ""
#: ../../FAQ/faq.rst:91
msgid "Does |CL| use RPMs like other distros?"
msgstr ""
#: ../../FAQ/faq.rst:93
msgid ""
"|CL| provides software in the form of :ref:`bundles <bundles-about>`. The"
" RPM format is used as an intermediary step for packaging and determining"
" software dependencies at OS build time."
msgstr ""
#: ../../FAQ/faq.rst:97
msgid ""
"Individual RPMs can sometimes be manually installed on a |CL| system with"
" the right tools, but that is not the intended use case."
msgstr ""
#: ../../FAQ/faq.rst:103
msgid "Can I install a software package from another OS on |CL|?"
msgstr ""
#: ../../FAQ/faq.rst:105
msgid ""
"Software that is packaged in other formats for other Linux distributions "
"is not guaranteed to work on |CL| and may be impacted by |CL| updates."
msgstr ""
#: ../../FAQ/faq.rst:108
msgid ""
"If the software you're seeking is open source, please submit a request to"
" add it to |CL|. Submit requests on GitHub\\* here: "
"https://github.com/clearlinux/distribution/issues"
msgstr ""
#: ../../FAQ/faq.rst:115
msgid "Software availability"
msgstr ""
#: ../../FAQ/faq.rst:118
msgid "What software is available on |CL|?"
msgstr ""
#: ../../FAQ/faq.rst:120
msgid ""
"Available software can be found in the `Software Store`_, through the "
"GNOME\\* Software application on the desktop, or by using :ref:`swupd "
"search <bundle-commands>`."
msgstr ""
#: ../../FAQ/faq.rst:126
msgid "Is Google\\* Chrome\\* available?"
msgstr ""
#: ../../FAQ/faq.rst:128
msgid ""
"The Google Chrome web browser is not distributed as a bundle in |CL| due "
"to copyright and licensing complexities."
msgstr ""
#: ../../FAQ/faq.rst:131
msgid ""
"A discussion on manually installing and maintaining Google Chrome can be "
"found on GitHub: https://github.com/clearlinux/distribution/issues/422"
msgstr ""
#: ../../FAQ/faq.rst:137
msgid "Is FFmpeg available?"
msgstr ""
#: ../../FAQ/faq.rst:139
msgid ""
"`FFmpeg`_ is a multimedia software suite, which is commonly used for "
"various media encoding/decoding, streaming, and playback."
msgstr ""
#: ../../FAQ/faq.rst:142
msgid ""
"|CL| does not distribute FFmpeg due to well-known licensing and legal "
"complexities (See https://www.ffmpeg.org/legal.html and "
"http://blog.pkh.me/p/13-the-ffmpeg-libav-situation.html)."
msgstr ""
#: ../../FAQ/faq.rst:146
msgid ""
"Read more in the |CL| repository, including discussion of an alternative "
"hardware-based solution: "
"https://github.com/clearlinux/distribution/issues/429."
msgstr ""
#: ../../FAQ/faq.rst:150
msgid ""
"While |CL| cannot distribute FFmpeg, a manual solution to build and "
"install FFmpeg under :file:`/usr/local` has been shared on the community "
"forums: https://community.clearlinux.org/t/how-to-h264-etc-support-for-"
"firefox-including-ffmpeg-install."
msgstr ""
#: ../../FAQ/faq.rst:157
msgid "Is ZFS\\* available?"
msgstr ""
#: ../../FAQ/faq.rst:159
msgid ""
"ZFS is not available with |CL| because of copyright and licensing "
"complexities. BTRFS is an alternative filesystem that is available in "
"|CL| natively."
msgstr ""
#: ../../FAQ/faq.rst:163
msgid ""
"A user on GitHub notes that the ZFS kernel module can be compiled, built,"
" and installed manually: "
"https://github.com/clearlinux/distribution/issues/631"
msgstr ""
#: ../../FAQ/faq.rst:169
msgid "Can you add a driver that I need?"
msgstr ""
#: ../../FAQ/faq.rst:171
msgid ""
"If a kernel module is available as part of the Linux kernel source tree "
"but not enabled in the |CL| kernels, in many cases the |CL| team will "
"enable it upon request. Submit requests on GitHub here: "
"https://github.com/clearlinux/distribution/issues"
msgstr ""
#: ../../FAQ/faq.rst:176
msgid ""
"The |CL| team does not typically add out-of-tree kernel modules as a "
"matter of practice because of the maintenance overhead. If the driver was"
" unable to be merged upstream, there is a good chance we may be unable to"
" merge it for similar reasons."
msgstr ""
#: ../../FAQ/faq.rst:181
msgid ""
"Kernel modules can be individually built and installed on |CL|. See the "
":ref:`kernel modules <kernel-modules>` page for more information."
msgstr ""
Binary file not shown.
@@ -0,0 +1,223 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../concepts/autospec-about.rst:4
msgid "Autospec"
msgstr ""
#: ../../concepts/autospec-about.rst:6
msgid ""
"``autospec`` is a tool to assist in the automated creation and "
"maintenance of RPM packaging in |CL-ATTR|. Where a standard RPM build "
"process using ``rpmbuild`` requires a tarball and .spec file to start, "
"``autospec`` requires only a tarball and package name to start."
msgstr ""
"``autospec`` ist ein Werkzeug zur automatisierten Erstellung und Pflege von RPM-Verpackungen in |CL-ATTR| zu unterstützen. Ein Standard-RPM Build-Prozess"
"unter Verwendung von ``rpmbuild`` erfordert einen Tarball und .spec Datei zu "
"begginen. Vergleichsweise, ``autospec`` erfordert nur einen Tarball und "
"Paketnamen um zu starten."
#: ../../concepts/autospec-about.rst:12
msgid "How autospec works"
msgstr "Wie autospec functioniert"
#: ../../concepts/autospec-about.rst:14
msgid ""
"``autospec`` attempts to infer the requirements of the .spec file by "
"analyzing the source code and :file:`Makefile` information. It will "
"continuously run updated builds based on new information discovered from "
"build failures until it has a complete and valid .spec file. Although not"
" required, you can influence the behavior of ``autospec`` by providing "
":ref:`control files <control-files>`."
msgstr ""
#: ../../concepts/autospec-about.rst:20
msgid "The basic process is described in the following steps:"
msgstr ""
#: ../../concepts/autospec-about.rst:22
msgid ""
"The :command:`make autospec` command generates a .spec based on analysis "
"of code and control files, if present."
msgstr ""
#: ../../concepts/autospec-about.rst:25
msgid "``autospec`` creates a ``build root`` with ``mock`` config."
msgstr ""
#: ../../concepts/autospec-about.rst:27
msgid "``autospec`` attempts to build an RPM from the generated .spec."
msgstr ""
#: ../../concepts/autospec-about.rst:29
msgid "``autospec`` detects any missed declarations in the .spec."
msgstr ""
#: ../../concepts/autospec-about.rst:31
msgid ""
"If build errors occur, ``autospec`` will scan the build log to try and "
"detect the root cause."
msgstr ""
#: ../../concepts/autospec-about.rst:34
msgid ""
"If ``autospec`` detects the root cause and knows how to continue, it will"
" restart the build automatically at step 1 with updated build "
"instructions."
msgstr ""
#: ../../concepts/autospec-about.rst:37
msgid ""
"Otherwise, ``autospec`` will stop the build for user inspection and "
"editing of control files to resolve the errors. The user resumes the "
"process at step 1 after errors are resolved."
msgstr ""
#: ../../concepts/autospec-about.rst:40
msgid ""
"Following these steps, ``autospec`` continues to rebuild the package, "
"based on new information discovered from build failures, until it has a "
"valid .spec. If no build errors occur, RPM packages are successfully "
"built."
msgstr ""
#: ../../concepts/autospec-about.rst:47
msgid "Control files"
msgstr ""
#: ../../concepts/autospec-about.rst:49
msgid ""
"It is possible to influence the behavior of ``autospec`` by providing "
"control files. These files may be used to alter the default behavior of "
"the configure routine, to blacklist build dependencies, etc. Control "
"files must be located in the same directory as the resulting .spec."
msgstr ""
#: ../../concepts/autospec-about.rst:54
msgid "Table 1 shows control files used to control dependencies, for example."
msgstr ""
#: ../../concepts/autospec-about.rst:56
msgid "**Table 1. Control files to control dependencies**"
msgstr ""
#: ../../concepts/autospec-about.rst:60
msgid "Filename"
msgstr ""
#: ../../concepts/autospec-about.rst:61
msgid "Description"
msgstr ""
#: ../../concepts/autospec-about.rst:62
msgid "buildreq_add"
msgstr ""
#: ../../concepts/autospec-about.rst:63
msgid ""
"Each line in the file provides the name of a package to add as a build "
"dependency to the .spec."
msgstr ""
#: ../../concepts/autospec-about.rst:65
msgid "buildreq_ban"
msgstr ""
#: ../../concepts/autospec-about.rst:66
msgid ""
"Each line in the file is a build dependency that under no circumstance "
"should be automatically added to the build dependencies. This is useful "
"to block automatic configuration routines adding undesired functionality,"
" or to omit any automatically discovered dependencies during tarball "
"scanning."
msgstr ""
#: ../../concepts/autospec-about.rst:71
msgid "pkgconfig_add"
msgstr ""
#: ../../concepts/autospec-about.rst:72
msgid ""
"Each line in the file is assumed to be a pkgconfig() build dependency. "
"Add the pkg-config names here, as ``autospec`` will automatically "
"transform the names into their ``pkgconfig($name)`` style when generating"
" the .spec."
msgstr ""
#: ../../concepts/autospec-about.rst:76
msgid "pkgconfig_ban"
msgstr ""
#: ../../concepts/autospec-about.rst:77
msgid ""
"Each line in this file is a pkgconfig() build dependency that should not "
"be added automatically to the build, much the same as `` buildreq_ban``. "
"As with ``pkgconfig_add``, these names are automatically transformed by "
"``autospec`` into their correct ``pkgconfig($name))`` style."
msgstr ""
#: ../../concepts/autospec-about.rst:82
msgid "requires_add"
msgstr ""
#: ../../concepts/autospec-about.rst:83
msgid ""
"Each line in the file provides the name of a package to add as a runtime "
"dependency to the .spec."
msgstr ""
#: ../../concepts/autospec-about.rst:85
msgid "requires_ban"
msgstr ""
#: ../../concepts/autospec-about.rst:86
msgid ""
"Each line in the file is a runtime dependency that under no circumstance "
"should be automatically added to the runtime dependencies. This is useful"
" to block automatic configuration routines adding undesired "
"functionality, or to omit any automatically discovered dependencies "
"during tarball scanning."
msgstr ""
#: ../../concepts/autospec-about.rst:92
msgid ""
"Further control of the build can be achieved through the use of the "
"``options.conf`` file. If this file does not exist, it is created by "
"``autospec`` with default values. If certain deprecated configuration "
"files exists ``autospec`` will use the value indicated by those files and"
" remove them."
msgstr ""
#: ../../concepts/autospec-about.rst:98
msgid "For a comprehensive list of control files, view the `autospec readme`_."
msgstr ""
#: ../../concepts/autospec-about.rst:101
msgid "Related topics"
msgstr ""
#: ../../concepts/autospec-about.rst:103
msgid ":ref:`autospec`"
msgstr ""
#: ../../concepts/autospec-about.rst:104
msgid ":ref:`mixer`"
msgstr ""
Binary file not shown.
@@ -0,0 +1,71 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../concepts/bundles-about.rst:4
msgid "Bundles"
msgstr ""
#: ../../concepts/bundles-about.rst:6
msgid ""
"Linux-based operating systems contain the code of several hundred, if not"
" thousands, of open source projects. To make this manageable, "
"distributions use a concept called \"packages\" to configure and compile "
"the source code of these projects into binaries."
msgstr ""
#: ../../concepts/bundles-about.rst:11
msgid ""
"Many distributions then split the content of these compiled packages into"
" so-called sub-packages, which are the granularity at which these "
"distributions deploy their software. With those kinds of distributions, "
"system administrators can then install and update sub-packages "
"individually or as a set, using tools such as \"yum\" and \"apt-get.\""
msgstr ""
#: ../../concepts/bundles-about.rst:17
msgid ""
"The |CL-ATTR| takes a slightly different approach. While we also use the "
"concept of packages to manage compiling source code into binaries, we do "
"not use the package concept to deploy software. Instead, we provide "
"software \"bundles\" that are installed and managed using :ref:`swupd"
"<swupd-about>`. Each bundle contains as many or as few open source "
"projects needed to provide a complete functionality."
msgstr ""
#: ../../concepts/bundles-about.rst:24
msgid "Next steps"
msgstr ""
#: ../../concepts/bundles-about.rst:26
msgid "To put this concept into practice, see the following resources:"
msgstr ""
#: ../../concepts/bundles-about.rst:28
msgid ":ref:`bundles`"
msgstr ""
#: ../../concepts/bundles-about.rst:29
msgid ":ref:`bundle-commands`"
msgstr ""
#: ../../concepts/bundles-about.rst:30
msgid ":ref:`compatible-kernels`"
msgstr ""
Binary file not shown.
@@ -0,0 +1,115 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../concepts/mixer-about.rst:4
msgid "Mixer"
msgstr ""
#: ../../concepts/mixer-about.rst:6
msgid ""
"|CL-ATTR| is a powerful, modular, and customizable OS. Upstream |CL| "
"offers many images to support different environments and use-cases. "
"There are hundreds of bundles that will meet most, if not all, of your OS"
" and software needs."
msgstr ""
#: ../../concepts/mixer-about.rst:11
msgid ""
"However, if you need additional customization or content, |CL| provides "
"the mixer tool. Depending on your needs, the mixer tool allows you to:"
msgstr ""
#: ../../concepts/mixer-about.rst:15
msgid ":ref:`create-mix` to create a distinct derivative of the |CL| that"
msgstr ""
#: ../../concepts/mixer-about.rst:15
msgid "contains your custom software."
msgstr ""
#: ../../concepts/mixer-about.rst:20
msgid "Create a mix"
msgstr ""
#: ../../concepts/mixer-about.rst:22
msgid "When creating a mix, you can"
msgstr ""
#: ../../concepts/mixer-about.rst:24
msgid "Use any existing upstream bundles with no modification."
msgstr ""
#: ../../concepts/mixer-about.rst:25
msgid "Redefine what goes into existing bundles."
msgstr ""
#: ../../concepts/mixer-about.rst:26
msgid "Create completely new, custom bundles with your own custom packages."
msgstr ""
#: ../../concepts/mixer-about.rst:28
msgid ""
"With mixer you are not required to incorporate every upstream release "
"into your mix. You decide which upstream versions to update your "
"derivative to, as illustrated in Figure 1."
msgstr ""
#: ../../concepts/mixer-about.rst:36
msgid ""
"Figure 1: With a custom mix, you add your custom bundle and decide which "
"upstream versions to update your mix to, on your own release cycle."
msgstr ""
#: ../../concepts/mixer-about.rst:39
msgid ""
"Creating your own mix forks away from the |CL| upstream and requires that"
" you act as your own OSV. There is a greater level of responsibility, "
"requiring more infrastructure and processes to adopt. However, with this "
"approach, you have a higher degree of control and customization of your "
"custom |CL|."
msgstr ""
#: ../../concepts/mixer-about.rst:45
msgid "Related topics"
msgstr ""
#: ../../concepts/mixer-about.rst:47
msgid ""
"|CL| provides flexibility in how you customize your OS. Learn more about "
"mixer and related topics to decide which customization approach is best "
"for you."
msgstr ""
#: ../../concepts/mixer-about.rst:51
msgid ":ref:`mixer`"
msgstr ""
#: ../../concepts/mixer-about.rst:52
msgid ":ref:`bundles-about`"
msgstr ""
#: ../../concepts/mixer-about.rst:53
msgid ":ref:`swupd-about`"
msgstr ""
#: ../../concepts/mixer-about.rst:54
msgid ":ref:`deploy-at-scale`"
msgstr ""
Binary file not shown.
+301
View File
@@ -0,0 +1,301 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../concepts/restart.rst:4
msgid "Restart system services after an OS update"
msgstr ""
#: ../../concepts/restart.rst:6
msgid ""
"The software life cycle describes how software is created, developed, and"
" deployed, and includes how to replace or update software. A good OS "
"provides tools for the entire software life cycle. These tools must "
"include ways to remove software components properly when replaced with "
"something else."
msgstr ""
#: ../../concepts/restart.rst:12
msgid ""
"Most of the work on software update code in |CL| was focused on adding "
"new software to the system. We recommended that users reboot their system"
" once in a while, but we did not provide any tools to restart services "
"easily, until now."
msgstr ""
#: ../../concepts/restart.rst:18
msgid "User challenges"
msgstr ""
#: ../../concepts/restart.rst:20
msgid ""
"It is difficult to determine which services to restart. You can either "
"evaluate each system and reboot manually, or figure out which services to"
" restart based on documentation like the |CL| release notes. Since "
"neither option solves the issue completely, the |CL| team created a "
"solution."
msgstr ""
#: ../../concepts/restart.rst:25
msgid ""
"Over the years, several OSes approached the problem and created partial "
"solutions such as the following:"
msgstr ""
#: ../../concepts/restart.rst:28
msgid "Automatically restart services during an upgrade."
msgstr ""
#: ../../concepts/restart.rst:29
msgid "Evaluate services using these steps:"
msgstr ""
#: ../../concepts/restart.rst:31
msgid "Mark updates requiring a reboot, such as kernel updates."
msgstr ""
#: ../../concepts/restart.rst:32
msgid "Inform the user of those updates."
msgstr ""
#: ../../concepts/restart.rst:33
msgid "Ask the user to restart the OS."
msgstr ""
#: ../../concepts/restart.rst:35
msgid ""
"Both solutions are acceptable for many OSes. However, |CL| updates "
"software automatically and users do not see notices from the updater "
"unless they review the journal. |CL| requires a completely different "
"solution, with the following requirements:"
msgstr ""
#: ../../concepts/restart.rst:40
msgid ""
"Eliminate the guesswork about what to restart and under what "
"circumstances."
msgstr ""
#: ../../concepts/restart.rst:41
msgid ""
"Cannot restart everything. Many service daemons do not support an "
"automatic background restart."
msgstr ""
#: ../../concepts/restart.rst:43
msgid "Fit into the |CL| architectural perspective: be small, quick, and lean."
msgstr ""
#: ../../concepts/restart.rst:46
msgid "clr-service-restart functionality"
msgstr ""
#: ../../concepts/restart.rst:48
msgid "Typical reasons to restart a service daemon include:"
msgstr ""
#: ../../concepts/restart.rst:50
msgid "A new version replaces the executable file itself."
msgstr ""
#: ../../concepts/restart.rst:51
msgid "A new version replaces a library component used by a service daemon."
msgstr ""
#: ../../concepts/restart.rst:53
msgid ""
"Our method restarts daemons when it is really needed, especially in the "
"case of security updates. The tool restarts daemons by reading various "
"files in the :file:`procfs` filesystem provided by the kernel."
msgstr ""
#: ../../concepts/restart.rst:57
msgid ""
"The second part of the problem is to determine whether or not running "
"processes are part of a system service. The tool focuses on system "
"services because most system services are background tasks with no direct"
" user interaction. Fortunately, :command:`systemd` provides a simple way "
"to:"
msgstr ""
#: ../../concepts/restart.rst:62
msgid "Determine which active tasks are within the system domain."
msgstr ""
#: ../../concepts/restart.rst:63
msgid "Determine which tasks map to which service."
msgstr ""
#: ../../concepts/restart.rst:65
msgid ""
"We combined both solutions into a low-overhead tool that shows which "
"system daemons require a restart, as shown below:"
msgstr ""
#: ../../concepts/restart.rst:68
msgid "Figure 1: Invoke :command:`clr-service-restart`."
msgstr ""
#: ../../concepts/restart.rst:83
msgid ""
":command:`clr-service-restart` implements a whitelist to identify which "
"daemons can be restarted. The system administrator can customize the "
"default |CL| OS whitelist using *allow* or *disallow* options for "
"restarting system services. When a software update occurs, :command:`clr-"
"service-restart` consults the whitelist to see if a service daemon is "
"allowed to be restarted or not. See the options section for details."
msgstr ""
#: ../../concepts/restart.rst:93
msgid "Options for clr-service-restart"
msgstr ""
#: ../../concepts/restart.rst:95
msgid ""
"The *allow* option identifies a daemon to restart after an OS software "
"update. The :command:`clr-service-restart` daemon creates a symlink in "
":file:`/etc/clr-service-restart` as a record. The example below tells "
":command:`clr-service-restart` to restart the *tallow* daemon after an OS"
" software update."
msgstr ""
#: ../../concepts/restart.rst:105
msgid ""
"The *disallow* option tells :command:`clr-service-restart` not to restart"
" the specified daemon even if the OS defaults permit the daemon to be "
"restarted. The :command:`clr-service-restart` daemon creates a symlink in"
" :file:`/etc/clr-service-restart` that points to :file:`/dev/null` as a "
"record. The example below tells :command:`clr-service-restart` not to "
"restart the *rngd* daemon after an OS software update."
msgstr ""
#: ../../concepts/restart.rst:116
msgid ""
"The *default* option makes :command:`clr-service-restart` revert back to "
"the OS defaults and delete any symlink in :file:`/etc/clr-service-"
"restart`. The example below tells :command:`clr-service-restart` to "
"restart *rngd* automatically again, because *rngd* is whitelisted for "
"automatic service restarts by default in |CL|."
msgstr ""
#: ../../concepts/restart.rst:128
msgid "Monitor options for clr-service-restart"
msgstr ""
#: ../../concepts/restart.rst:130
msgid ""
":command:`clr-service-restart` works in the background and is invoked "
"with :command:`swupd` automatically. Review the journal output to verify "
"that services are restarted after an OS software update."
msgstr ""
#: ../../concepts/restart.rst:134
msgid ""
"To monitor :command:`clr-service-restart`, use one or both options "
"described below."
msgstr ""
#: ../../concepts/restart.rst:139
msgid ""
"This option makes :command:`clr-service-restart` perform no restarts. "
"Instead it displays the services that could potentially be restarted. "
"When used, :command:`clr-service-restart` outputs a list of messages "
"showing:"
msgstr ""
#: ../../concepts/restart.rst:144
msgid "Which service needs a restart."
msgstr ""
#: ../../concepts/restart.rst:145
msgid "What unit it is."
msgstr ""
#: ../../concepts/restart.rst:146
msgid "Why it needs a restart."
msgstr ""
#: ../../concepts/restart.rst:147
msgid "Which command is required to restart the unit."
msgstr ""
#: ../../concepts/restart.rst:151
msgid ""
"This option makes :command:`clr-service-restart` consider all system "
"services, not only the ones that are whitelisted. Because the default "
"whitelist in |CL| is relatively short, you can use this option to restart"
" all impacted services when you log in on the system."
msgstr ""
#: ../../concepts/restart.rst:156
msgid ""
"If you pass both options (:option:`-a` and :option:`-n`), :command:`clr-"
"service-restart` displays a complete list of system services that require"
" a restart. Use both options to verify that all desired daemons are "
"restarted."
msgstr ""
#: ../../concepts/restart.rst:163
msgid "Telemetry"
msgstr ""
#: ../../concepts/restart.rst:165
msgid ""
":command:`clr-service-restart` may cause problems such as a short service"
" outage when a daemon is being restarted, or if a daemon fails to "
"properly restart. To minimize issues, :command:`clr-service-restart` "
"creates a telemetry record and sends it to the optional |CL| telemetry "
"service if both conditions below are met:"
msgstr ""
#: ../../concepts/restart.rst:171
msgid "If a unit fails to automatically restart after an OS update."
msgstr ""
#: ../../concepts/restart.rst:172
msgid ""
"If that unit resides in the system location "
":file:`/usr/lib/systemd/system`."
msgstr ""
#: ../../concepts/restart.rst:175
msgid ""
"If you do not install the |CL| telemetrics bundle, the data is discarded."
" If you install the telemetrics bundle and you opt to send telemetry, "
"then the system unit name is sent to the |CL| telemetry service. We "
"evaluate the report and update the whitelist to remove services that are "
"not safe to restart."
msgstr ""
#: ../../concepts/restart.rst:182
msgid "Conclusion"
msgstr ""
#: ../../concepts/restart.rst:184
msgid ""
"The |CL| team enjoys coming up with simple and efficient solutions to "
"make your work easier. We made a github project of :command:`clr-service-"
"restart` and we invite you to look at the code, share your thoughts, and "
"work with us on improving the project. You can find the project at:"
msgstr ""
#: ../../concepts/restart.rst:189
msgid "https://github.com/clearlinux/clr-service-restart"
msgstr ""
Binary file not shown.
+249
View File
@@ -0,0 +1,249 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../concepts/security.rst:4
msgid "OS Security"
msgstr ""
#: ../../concepts/security.rst:6
msgid ""
"|CL-ATTR| aims to make systemic and layered security-conscious decisions "
"that are both performant and practical. This security philosophy is "
"rooted within the project's codebase and operating culture."
msgstr ""
#: ../../concepts/security.rst:17
msgid "Security in Updates"
msgstr ""
#: ../../concepts/security.rst:19
msgid ""
"The |CL| team believes in the benefits of software security through open "
"sourcing, incremental updates, and rapidly resolving known security "
"advisories."
msgstr ""
#: ../../concepts/security.rst:26
msgid "The latest Linux* codebase"
msgstr ""
#: ../../concepts/security.rst:28
msgid ""
"|CL| uses the newest version of the Linux kernel which allows the "
"operating system to leverage the latest features from the upstream Linux "
"kernel, including security fixes."
msgstr ""
#: ../../concepts/security.rst:36
msgid "Automated Effective Updating"
msgstr ""
#: ../../concepts/security.rst:38
msgid "|CL| is incrementally updated multiple times per day."
msgstr ""
#: ../../concepts/security.rst:40
msgid ""
"This `rolling release model`_ allows |CL| to consume the latest security "
"fixes of software packages as soon as they become available. There is no "
"waiting for major or minor releases on |CL|."
msgstr ""
#: ../../concepts/security.rst:44
msgid ""
"An update is not effective if it is just simply downloaded onto a system."
" It needs to be obtained *AND* ensured that the new patched copy is being"
" used; not an older copy loaded into memory. |CL| will let you know when "
"a service needs to be rebooted or do it for your automatically after a "
"software update, if desired."
msgstr ""
#: ../../concepts/security.rst:51
msgid ""
"In |CL| updates are delivered automatically, efficiently, and "
"effectively. For more information see `documentation about Software "
"Updates`_ in |CL|."
msgstr ""
#: ../../concepts/security.rst:60
msgid "Automated CVE Scanning and Remediation"
msgstr ""
#: ../../concepts/security.rst:62
msgid ""
"The sheer number of software packages and security vulnerabilities is "
"growing exponentially. Repositories of Common Vulnerabilities and "
"Exposures (CVEs) and their fixes, if known, are published by :abbr:`NIST`"
" in a National Vulnerability Database \\ |NVD|\\ and at \\ |MITRE|\\ ."
msgstr ""
#: ../../concepts/security.rst:68
msgid ""
"|CL| employs a proactive and measured approach to addressing known and "
"fixable :abbr:`CVEs (Common Vulnerabilities and Exposures)`. Packages are"
" automatically scanned against :abbr:`CVEs (Common Vulnerabilities and "
"Exposures)` daily, and security patches are deployed as soon as they are "
"available."
msgstr ""
#: ../../concepts/security.rst:74
msgid ""
"These combined practices minimize the amount of time |CL| systems are "
"exposed to unnecessary security risk."
msgstr ""
#: ../../concepts/security.rst:82
msgid "Security in Software"
msgstr ""
#: ../../concepts/security.rst:86
msgid "Minimized attack surface"
msgstr ""
#: ../../concepts/security.rst:88
msgid ""
"|CL| removes legacy, unneeded, or redundant standards and components as "
"much as possible to enable the use of best known security standards. "
"Below are some examples:"
msgstr ""
#: ../../concepts/security.rst:92
msgid ""
"`RC4`, `SSLv3`, `3DES`, and `SHA-1` ciphers which have had known "
"vulnerabilities, have been explicitly disabled within many |CL| packages "
"to avoid their accidental usage."
msgstr ""
#: ../../concepts/security.rst:96
msgid ""
"Services and subsystems which expose sensitive system information have "
"been removed such as the `finger` and `tcpwrappers`."
msgstr ""
#: ../../concepts/security.rst:99
msgid "`SFTP` has been disabled by default due to security considerations."
msgstr ""
#: ../../concepts/security.rst:104
msgid "Verified trust"
msgstr ""
#: ../../concepts/security.rst:106
msgid ""
"|CL| encourages the use of secure practices such as encryption and "
"digital signature verification throughout the system and discourages "
"blind trust. Below are some examples:"
msgstr ""
#: ../../concepts/security.rst:110
msgid ""
"All update operations from swupd are transparently encrypted and checked "
"against the |CL| maintainers' public key for authenticity. More "
"information can be found in this blog post: `blog post about swupd "
"security`_"
msgstr ""
#: ../../concepts/security.rst:115
msgid ""
"Before being built, packages available from |CL| verify checksums and "
"signatures provided by third party project codebases and maintainers."
msgstr ""
#: ../../concepts/security.rst:118
msgid ""
"|CL| features a unified certificate store, `clrtrust`_ which comes ready "
"to work with well-known Certificate Authorities out of the box. "
"`clrtrust`_ also offers an easy to use command line interface for "
"managing system-wide chains of trust, instead of ignoring foreign "
"certificates."
msgstr ""
#: ../../concepts/security.rst:129
msgid "Compiled with secure options"
msgstr ""
#: ../../concepts/security.rst:131
msgid ""
"While |CL| packages are optimized for performance on Intel® architecture,"
" security conscious kernel and compiler options are sensibly taken "
"advantage of. Below are some examples:"
msgstr ""
#: ../../concepts/security.rst:136
msgid ""
"Kernels shipped with |CL| are signed and disallow the usage of custom "
"kernel modules to maintain verifiable system integrity."
msgstr ""
#: ../../concepts/security.rst:139
msgid ""
"`Address space layout randomization (ASLR)`_ and `Kernel address space "
"layout randomization (KASLR)`_ are kernel features which defend against "
"certain memory based attacks. More information can be found in a `blog "
"post about PIE executables`_ ."
msgstr ""
#: ../../concepts/security.rst:150
msgid "Security in System Design"
msgstr ""
#: ../../concepts/security.rst:152
msgid ""
"Simple, yet effective, techniques are used throughout the |CL| system "
"design to defend against common attack vectors and enable good security "
"hygiene. Below are some examples:"
msgstr ""
#: ../../concepts/security.rst:157
msgid ""
"Full disk encryption using `Linux Unified Key Setup`_ (LUKS) is "
"available during installation."
msgstr ""
#: ../../concepts/security.rst:160
msgid ""
"|CL| uses the PAM cracklib module to harden user login and password "
"security resulting in:"
msgstr ""
#: ../../concepts/security.rst:163
msgid ""
"No default username or root password set out of the box with |CL|, you "
"will be asked to set your own password immediately."
msgstr ""
#: ../../concepts/security.rst:166
msgid ""
"Simple password schemes, which are known to be easily compromised, cannot"
" be set in |CL|."
msgstr ""
#: ../../concepts/security.rst:169
msgid ""
"A password blacklist, to avoid system passwords being set to passwords "
"which have been compromised in the past."
msgstr ""
#: ../../concepts/security.rst:172
msgid ""
"`Tallow`_, a lightweight service which monitors and blocks suspicious SSH"
" login patterns, is installed with the :command:`openssh-server` bundle."
msgstr ""
Binary file not shown.
+202
View File
@@ -0,0 +1,202 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../concepts/stateless.rst:4
msgid "Stateless"
msgstr ""
#: ../../concepts/stateless.rst:6
msgid ""
"In most operating systems, files can become intermingled with user and "
"system data and configurations."
msgstr ""
#: ../../concepts/stateless.rst:14
msgid ""
"Figure 1: Without stateless, user and system files become mixed on the "
"filesystem over time."
msgstr ""
#: ../../concepts/stateless.rst:16
msgid ""
"|CL-ATTR| has a stateless design philosophy of which the goal is to "
"provide an :abbr:`OS (operating system)` that functions without excessive"
" user configuration or customization. Stateless in this context does "
"*not* mean ephemeral or non-persistent."
msgstr ""
#: ../../concepts/stateless.rst:26
msgid "File-level separation"
msgstr ""
#: ../../concepts/stateless.rst:28
msgid ""
"To accomplish a stateless design the Linux Filesystem Hierarchy is "
"separated between user-owned areas and |CL|-owned areas."
msgstr ""
#: ../../concepts/stateless.rst:36
msgid ""
"Figure 2: With stateless, user and system files are separated on the "
"filesystem."
msgstr ""
#: ../../concepts/stateless.rst:39
msgid "System areas"
msgstr ""
#: ../../concepts/stateless.rst:40
msgid ""
"File under the :file:`/usr` directory are managed by |CL| as system "
"files. Files written under the :file:`/usr` directory by users can get "
"removed through system updates with :ref:`swupd <swupd-about>`.This "
"operating assumption allows |CL| to verify and maintain integrity of "
"system files."
msgstr ""
#: ../../concepts/stateless.rst:46
msgid "User areas"
msgstr ""
#: ../../concepts/stateless.rst:47
msgid ""
"Files under the :file:`/etc/`, :file:`/home`, and :file:`/var` "
"directories are owned and managed by the user. A freshly installed |CL| "
"system will only have a minimal set of files in the :file:`/etc/` "
"directory and software installed by |CL| does not write to :file:`/etc`. "
"This operating assumption allows |CL| users to clearly identify the "
"configuration that makes their system unique."
msgstr ""
#: ../../concepts/stateless.rst:55
msgid "Software Configuration"
msgstr ""
#: ../../concepts/stateless.rst:57
msgid ""
"With stateless separation, default software configurations are read in "
"order from predefined source code, |CL| provided defaults, and user-"
"provided configuration."
msgstr ""
#: ../../concepts/stateless.rst:62
msgid "Default configurations"
msgstr ""
#: ../../concepts/stateless.rst:64
msgid ""
"Software in |CL| provides default configuration values so that it is "
"immediately functional, whenever it is appropriate to do so."
msgstr ""
#: ../../concepts/stateless.rst:67
msgid ""
"|CL| distributed software packages may be directly modified to include "
"default configuration values or default configuration files may be "
"provided by |CL| under :file:`/usr/share/defaults`. These files can be "
"referenced as templates for customization."
msgstr ""
#: ../../concepts/stateless.rst:72
msgid ""
"For example, the default configuration that Apache uses when installed "
"can be found at :file:`/usr/share/defaults/httpd/httpd.conf` directory."
msgstr ""
#: ../../concepts/stateless.rst:77
msgid "Overriding configurations"
msgstr ""
#: ../../concepts/stateless.rst:79
msgid ""
"If a configuration needs to be changed, the appropriate file should be "
"modified by the user under :file:`/etc/`. If the configuration file does "
"not already exist, it can be created in the appropriate location."
msgstr ""
#: ../../concepts/stateless.rst:83
msgid ""
"User defined configuration files should contain the minimal set of "
"desired changes and rely on default configuration for the rest."
msgstr ""
#: ../../concepts/stateless.rst:86
msgid "For example, a customized Apache configuration can be used instead by:"
msgstr ""
#: ../../concepts/stateless.rst:88
msgid "Create the destination directory for the configuration:"
msgstr ""
#: ../../concepts/stateless.rst:94
msgid "Copy the default configuration as a reference template:"
msgstr ""
#: ../../concepts/stateless.rst:100
msgid "Make any desired modifications to the configurations:"
msgstr ""
#: ../../concepts/stateless.rst:106
msgid "Reload the service or reboot the system to pickup any changes:"
msgstr ""
#: ../../concepts/stateless.rst:113
msgid ""
"This pattern can be used to modify the configurations of other programs "
"too. The `stateless man page`_ has application-specific examples."
msgstr ""
#: ../../concepts/stateless.rst:118
msgid "System reset"
msgstr ""
#: ../../concepts/stateless.rst:120
msgid ""
"Once advantage of the stateless design is that the system defaults can be"
" easily restored by simply deleting everything under :file:`/etc/` and "
":file:`/var`."
msgstr ""
#: ../../concepts/stateless.rst:124
msgid ""
"Running the commands below effectively performs a system reset as if it "
"was just installed:"
msgstr ""
#: ../../concepts/stateless.rst:132
msgid ""
"In other Linux distributions, this can be a catastrophic action that "
"renders a system unable to boot."
msgstr ""
#: ../../concepts/stateless.rst:136
msgid "Additional information"
msgstr ""
#: ../../concepts/stateless.rst:138
msgid "`stateless man page`_"
msgstr ""
#: ../../concepts/stateless.rst:140
msgid ""
"`Where is /etc/fstab in Clear Linux? <https://clearlinux.org/news-blogs"
"/where-etcfstab-clear-linux>`_"
msgstr ""
Binary file not shown.
@@ -0,0 +1,193 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../concepts/swupd-about.rst:4
msgid "swupd: software updater"
msgstr ""
#: ../../concepts/swupd-about.rst:6
msgid ""
":command:`swupd` is an operating system software manager and update "
"program that operates at a file-level to enable verifiable integrity and "
"update efficiency."
msgstr ""
#: ../../concepts/swupd-about.rst:10
msgid "Visit the `swupd man page`_ for more details."
msgstr ""
#: ../../concepts/swupd-about.rst:13
msgid "Versioning"
msgstr ""
#: ../../concepts/swupd-about.rst:15
msgid ""
"Using package managers to keep track of software version compatibility or"
" compare multiple systems on many Linux distributions can be cumbersome."
msgstr ""
#: ../../concepts/swupd-about.rst:17
msgid ""
"With |CL| :command:`swupd`, versioning happens at the individual file-"
"level. This means |CL| generates an entirely new OS version with any set "
"of software changes to the system (including software downgrades or "
"removals). This rolling release versioning model is similar to "
":command:`git` internal version tracking, where any of the individual "
"file commits are tracked and move the pointer forward when changed."
msgstr ""
#: ../../concepts/swupd-about.rst:23
msgid ""
"While administrators can pick and choose which `bundles`_ a system has "
"installed, a single |CL| version number strictly represents one "
"combination of all software versions that can be installed onto a system "
"of that |CL| version. This method of whole OS versioning offers unique "
"advantages. Namely, system administrators can quickly compare multiple "
"|CL| systems that share the same version for important software and "
"security fixes."
msgstr ""
#: ../../concepts/swupd-about.rst:31
msgid "Updating"
msgstr ""
#: ../../concepts/swupd-about.rst:33
msgid ""
"|CL| promotes regular and automated updating of software to ensure "
"integration of new enhancements and security fixes. Refer to "
":ref:`security` documentation for more information."
msgstr ""
#: ../../concepts/swupd-about.rst:37
msgid "Learn how to update your system using :ref:`swupd <swupd-guide>`."
msgstr ""
#: ../../concepts/swupd-about.rst:40
msgid "Update efficiency"
msgstr ""
#: ../../concepts/swupd-about.rst:42
msgid ""
"Because :command:`swupd` operates at the individual file-level instead of"
" a package-level, |CL| updates are small and fast."
msgstr ""
#: ../../concepts/swupd-about.rst:45
msgid ""
"On many Linux\\* distributions, updates to a particular software package "
"require the whole software package to be downloaded and replaced --even "
"for one line of code."
msgstr ""
#: ../../concepts/swupd-about.rst:49
msgid ""
"In |CL|, updates are generated using the :ref:`mixer <mixer-about>` tool."
" Mixer calculates the difference between two |CL| versions and makes "
"available *binary deltas*, which contain only the changed portion of "
"files. This *binary delta technology* [1]_ means :command:`swupd` on |CL|"
" systems only needs to download and apply a small fraction of a package "
"in order to receive an update."
msgstr ""
#: ../../concepts/swupd-about.rst:55
msgid ""
"The :ref:`mixer <mixer-about>` tool additionally computes updates files "
"in multiple compression formats, allowing :command:`swupd` to utilize the"
" most efficiently compressed format for a |CL| system to minimize the "
"cost to update."
msgstr ""
#: ../../concepts/swupd-about.rst:61
msgid "Update integrity"
msgstr ""
#: ../../concepts/swupd-about.rst:63
msgid ""
"This is the basis of the :command:`swupd diagnose` subcommand, which "
"allows a |CL| system to check for any discrepancies to system files. As "
"necessary, :command:`swupd repair` provides a useful way for software "
"developers to remediate these discrepancies and return to a known "
"filesystem state."
msgstr ""
#: ../../concepts/swupd-about.rst:67
msgid "Bundles"
msgstr ""
#: ../../concepts/swupd-about.rst:69
msgid ""
"|CL-ATTR| approaches software management differently than many other "
"Linux-based operating systems."
msgstr ""
#: ../../concepts/swupd-about.rst:72
msgid ""
"Instead of deploying granular software packages, |CL| uses the concept of"
" bundles with pre-associated software. Each bundle encapsulates a "
"particular use-case, which is enabled by composing all the required "
"upstream open-source projects and packages into one logical unit."
msgstr ""
#: ../../concepts/swupd-about.rst:77
msgid "This bundle-based approach offers some unique advantages:"
msgstr ""
#: ../../concepts/swupd-about.rst:79
msgid ""
"Bundles provide a particular functionality, or stack, which include all "
"associated runtime dependencies."
msgstr ""
#: ../../concepts/swupd-about.rst:82
msgid ""
"Software package dependencies are resolved on the server, so file-level "
"conflicts do not occur on the target system after an update."
msgstr ""
#: ../../concepts/swupd-about.rst:85
msgid "All combinations of bundles are able to co-exist on a |CL| system."
msgstr ""
#: ../../concepts/swupd-about.rst:87
msgid "For more information on bundles, visit:"
msgstr ""
#: ../../concepts/swupd-about.rst:89
msgid ":ref:`bundles`"
msgstr ""
#: ../../concepts/swupd-about.rst:90
msgid ":ref:`bundles-about`"
msgstr ""
#: ../../concepts/swupd-about.rst:91
msgid ":ref:`bundle-commands`"
msgstr ""
#: ../../concepts/swupd-about.rst:92
msgid ":ref:`compatible-kernels`"
msgstr ""
#: ../../concepts/swupd-about.rst:94
msgid ""
"The software update technology for |CL-ATTR| was first presented at the "
"Linux Plumbers conference in 2012."
msgstr ""
Binary file not shown.
@@ -0,0 +1,176 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../concepts/telemetry-about.rst:4
msgid "Telemetrics"
msgstr ""
#: ../../concepts/telemetry-about.rst:6
msgid ""
"One of the key features of |CL-ATTR| is telemetry, which is used to "
"monitor system health. Telemetry enables developers to observe and "
"proactively address issues before end users are impacted."
msgstr ""
#: ../../concepts/telemetry-about.rst:10
msgid "*Telemetrics* is a combination word made from:"
msgstr ""
#: ../../concepts/telemetry-about.rst:12
msgid "*Telemetry* which is sensing and reporting data."
msgstr ""
#: ../../concepts/telemetry-about.rst:13
msgid ""
"*Analytics* which is using visualization and statistical inferencing to "
"make sense of the reported data."
msgstr ""
#: ../../concepts/telemetry-about.rst:16
msgid ""
"|CL| telemetry reports system-level debug/crash information using "
"specialized probes. The probes monitor system tasks such as :abbr:`swupd "
"(software updater)`, kernel oops, machine error checks, and BIOS error "
"report table for unhandled hardware failures. Telemetry enables real-time"
" issue reporting to allow system developers to quickly focus on an issue "
"and monitor corrective actions."
msgstr ""
#: ../../concepts/telemetry-about.rst:22
msgid ""
"|CL| telemetry is fully customizable and can be used during software "
"development for debugging purposes. You can use **libtelemetry** in your "
"code to create custom telemetry records. You can also use **telem-record-"
"gen** in script files or call it from another program."
msgstr ""
#: ../../concepts/telemetry-about.rst:29
msgid ""
"The |CL| telemetry client is disabled by default until you decide to "
"enable it. Telemetry is an **opt-in** solution and can be easily enabled"
" or disabled."
msgstr ""
#: ../../concepts/telemetry-about.rst:32
msgid "Architecture"
msgstr ""
#: ../../concepts/telemetry-about.rst:34
msgid ""
"|CL| telemetry has two fundamental components, which are shown in figure "
"1:"
msgstr ""
#: ../../concepts/telemetry-about.rst:36
msgid ""
"Client: generates and delivers records to the backend server via the "
"network."
msgstr ""
#: ../../concepts/telemetry-about.rst:37
msgid ""
"Backend: captures records sent from the client and displays the "
"cumulative content through a specialized interface."
msgstr ""
#: ../../concepts/telemetry-about.rst:42
msgid ""
"If you want to capture your own records for analysis, you must set up "
"your own backend server."
msgstr ""
#: ../../concepts/telemetry-about.rst:49
msgid "Figure 1: Clear Linux Telemetry Architecture."
msgstr ""
#: ../../concepts/telemetry-about.rst:51
msgid ""
"The telemetry client provides the front end of a complete telemetrics "
"solution and includes the following components:"
msgstr ""
#: ../../concepts/telemetry-about.rst:54
msgid ""
"**telemprobd**, a daemon that prepares the telemetry records and spools "
"them on disk prior to delivery"
msgstr ""
#: ../../concepts/telemetry-about.rst:55
msgid ""
"**telempostd**, a daemon that sends the records to the telemetry backend "
"server or leaves them on disk until deleting after the record expires."
msgstr ""
#: ../../concepts/telemetry-about.rst:57
msgid "**probes**, that collect specific types of data from the operating system."
msgstr ""
#: ../../concepts/telemetry-about.rst:58
msgid ""
"**libtelemetry**, that telemetrics probes use to create telemetrics "
"records and send them to the telemprobd daemon for further processing."
msgstr ""
#: ../../concepts/telemetry-about.rst:62
msgid ""
"The telemetry backend provides the server-side component of a complete "
"telemetrics solution and consists of:"
msgstr ""
#: ../../concepts/telemetry-about.rst:65
msgid "Nginx web server."
msgstr ""
#: ../../concepts/telemetry-about.rst:66
msgid "Two Flask apps:"
msgstr ""
#: ../../concepts/telemetry-about.rst:68
msgid ""
"Collector, an ingestion web app for records received from telemetrics-"
"client probes."
msgstr ""
#: ../../concepts/telemetry-about.rst:69
msgid ""
"TelemetryUI, a web app that exposes several views to visualize the "
"telemetry data and also provides a REST API to perform queries."
msgstr ""
#: ../../concepts/telemetry-about.rst:72
msgid "PostgreSQL as the underlying database server."
msgstr ""
#: ../../concepts/telemetry-about.rst:74
msgid ""
"The default telemetry backend server reports back to the |CL| development"
" team and is not viewable outside the Intel firewall. If you want to "
"collect your own records, then you must set up your own telemetry backend"
" server."
msgstr ""
#: ../../concepts/telemetry-about.rst:79
msgid "Next steps"
msgstr ""
#: ../../concepts/telemetry-about.rst:81
msgid "To put this concept into practice, refer to :ref:`telem-guide`."
msgstr ""
Binary file not shown.
+32
View File
@@ -0,0 +1,32 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../disclaimers.rst:7
msgid "Disclaimer"
msgstr ""
#: ../../disclaimers.rst:9
msgid ""
"This documentation is a work in progress and is being provided for "
"informative purposes only. Because it is a work in progress, there are "
"parts that are either missing or will be revised as code development "
"continues."
msgstr ""
Binary file not shown.
@@ -0,0 +1,20 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
@@ -0,0 +1,745 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:4
msgid "Install |CL-ATTR| from the live desktop"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:6
msgid ""
"The live desktop allows you to boot |CL-ATTR| in a GNOME desktop without "
"modifying the host system, offering the chance to explore developing on "
"|CL|. Better yet, launch the |CL| installer to install on your target "
"system."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:15
msgid "System requirements"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:17
msgid "Assure that your target system supports the installation:"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:19
msgid ":ref:`system-requirements`"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:20
msgid ":ref:`compatibility-check`"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:23
msgid "Preliminary steps"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:25
msgid "`Visit our Downloads page`_."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:27
msgid "Download the file :file:`clear-<release number>-live-desktop.iso`"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:31
msgid "<release-number> is the latest |CL| auto-numbered release."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:33
msgid "Follow your OS instructions to create a bootable USB drive."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:35
msgid ":ref:`bootable-usb`"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:40
msgid "Install from live image"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:42
msgid ""
"After you download and burn the live desktop image on a USB drive, follow"
" these steps."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:45
msgid "Insert the USB drive into an available USB slot."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:47
msgid "Power on the system."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:49
msgid ""
"Open the system BIOS setup menu by pressing the :kbd:`F2` key. Your BIOS "
"setup menu entry point may vary."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:52
msgid ""
"In the setup menu, enable the UEFI boot and set the USB drive as the "
"first option in the device boot order."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:55
msgid "Save these settings, e.g. :kbd:`F10`, and exit."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:57
msgid "Reboot the target system."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:59
msgid "Select :guilabel:`Clear Linux OS` in the boot menu, shown in Figure 1."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:65
msgid "Figure 1: Clear Linux OS in boot menu"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:70
msgid "Confirm network connection"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:72
msgid ""
"Confirm there is a network connection before launching the installer. "
"Choose a method: `Wired Connection`, or `WiFi Connected`. This guide "
"shows an example of a **Wired Connection**."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:76
msgid ""
"In the upper right of the top menu bar, select the square icon to view "
"Network settings, shown in Figure 2."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:79
msgid "Select :guilabel:`Wired Connected` and then :guilabel:`Wired Settings`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:85
msgid "Figure 2: Software icon, Network settings"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:87
msgid ""
"View the :guilabel:`Wired` menu to assure that you're target system and "
"installer are connected to a network."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:90
msgid "Optional: Configure Proxy settings."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:92
msgid "To view :guilabel:`Network Proxy`, select its :guilabel:`Gear` icon."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:94
msgid "Select from `Automatic`, `Manual` or `Disabled` as desired."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:96
msgid "Close the dialogue box."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:98
msgid "Select the :guilabel:`Gear` icon to view Network settings."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:100
msgid ""
"If desired, select :guilabel:`Connect automatically`. Select other "
"options as desired."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:103
msgid "Select :guilabel:`Apply` button to confirm change to settings."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:106
msgid "Software"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:108
msgid ""
"Optional: Explore |CL| bundles and other software available. Double-click"
" the :guilabel:`Software` icon from the Activities menu, shown in Figure "
"2."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:112
msgid ""
"`Sofware` application is *only intended for exploring* available bundles,"
" applications, and images. Do not attempt to install them."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:115
msgid "Assure there is a network connection before launching `Software`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:118
msgid "Launch the |CL| installer"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:120
msgid ""
"After the live desktop image boots, find the |CL| icon in the "
":guilabel:`Activities` menu at left, shown in Figure 3."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:123
msgid "Click the icon, :guilabel:`Install Clear Linux OS`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:129
msgid "Figure 3: Install Clear Linux OS icon"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:131
msgid "The installer is launched, as shown in Figure 4."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:137
msgid "Figure 4: |CL| OS Desktop Installer"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:139
msgid ""
"In :guilabel:`Select Language`, select a language from the options, or "
"type your preferred language in the search bar."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:142
msgid "Select :guilabel:`Next`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:148
msgid "Minimum installation requirements"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:150
msgid ""
"To fulfill minimum installation requirements, complete the `Required "
"options`_. We also recommend completing `Advanced options`_."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:155
msgid ""
"The :kbd:`Install` button is only highlighted **after** you complete "
"`Required options`_."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:158
msgid "Checkmarks indicate a selection has been made."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:160
msgid ""
"An Internet connection is required. You may want to launch a browser "
"prior to installation to verify your Internet connection."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:164
msgid "|CL| Desktop Installer"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:166
msgid ""
"The |CL| Desktop Installer Main Menu appears as shown in Figure 5. To "
"meet the minimum requirements, enter values in all submenus for the "
":guilabel:`Required options`. After you complete them, your selections "
"appear below submenus and a checkmark appears at right."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:175
msgid "Figure 5: Clear Linux OS Desktop Installer - Main Menu"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:178
msgid "Navigation"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:180
msgid "Use the :kbd:`mouse` to navigate or select options."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:182
msgid ""
"Use :kbd:`Tab` key to navigate between :guilabel:`Required options` and "
":guilabel:`Advanced options`"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:185
msgid "Use :kbd:`Up` or :kbd:`Down` arrow keys to navigate submenu list."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:187
msgid "Select :kbd:`Confirm`, or :kbd:`Cancel` in submenus."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:190
msgid "Required options"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:193
msgid "Select Time Zone"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:195
msgid ""
"From the Main Menu, select :guilabel:`Select Time Zone`. `UTC` is "
"selected by default."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:198
msgid ""
"In :guilabel:`Select Time Zone`, navigate to the desired time zone. Or "
"start typing the region and then city. (.e.g., "
":file:`America/Los_Angeles`)."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:202
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:218
msgid "Select :guilabel:`Confirm`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:208
msgid "Figure 6: Select System Time Zone"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:211
msgid "Select Keyboard"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:213
msgid "From the Main Menu, select :guilabel:`Select Keyboard`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:215
msgid ""
"Navigate to your desired keyboard layout. We select \"us\" for the United"
" States."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:224
msgid "Figure 7: Select Keyboard menu"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:227
msgid "Select Installation Media"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:229
msgid "From the Main Menu, select :guilabel:`Select Installation Media`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:231
msgid ""
"Choose an installation method: `Safe Installation`_ or `Destructive "
"Installation`_."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:238
msgid "Figure 8: Select Installation Media"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:241
msgid "Safe Installation"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:242
msgid ""
"Use this method to safely install |CL| on media with available space, or "
"alongside existing partitions, and accept the `Default partition "
"schema`_. If enough free space exists, safe installation is allowed."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:248
msgid ""
"|CL| allows installation alongside another OS. Typically, when you boot "
"your system, you can press an `F key` to view and select a bootable "
"device or partition during the BIOS POST stage. Some BIOSes present the "
"|CL| partition, and you can select and boot it. However, other BIOSes may"
" only show the primary partition, in which case you will not be able boot"
" |CL|. Be aware of this possible limitation."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:257
msgid "Destructive Installation"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:259
msgid ""
"Use this method to destroy the contents of the target device, install "
"|CL| on it, and accept the `Default partition schema`_."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:262
msgid "Disk encryption"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:264
msgid ""
"For greater security, disk encryption is supported using LUKS. Encryption"
" is optional."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:267
msgid ""
"To encrypt the root partition, select :guilabel:`Enable Encryption`, as "
"shown in Figure 9."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:274
msgid "Figure 9: Enable Encryption"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:276
msgid "When :guilabel:`Encryption Passphrase` appears, enter a passphrase."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:282
msgid "Figure 10: Encryption Passphrase"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:286
msgid "Minimum length is 8 characters. Maximum length is 94 characters."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:288
msgid "Enter the same passphrase in the second field."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:290
msgid "Select :guilabel:`Confirm` in the dialogue box."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:294
msgid ":guilabel:`Confirm` is only highlighted if passphrases match."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:296
msgid "Select :guilabel:`Confirm` in submenu."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:299
msgid "Manage User"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:301
msgid "In Required Options, select :guilabel:`Manage User`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:303
msgid "In :guilabel:`User Name`, enter a user name."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:309
msgid "Figure 11: Manage User"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:311
msgid ""
"In :guilabel:`Login`, create a login name. It must start with a letter "
"and can use numbers, hyphens, and underscores. Maximum length is 31 "
"characters."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:315
msgid ""
"In :guilabel:`Password`, enter a password. Minimum length is 8 "
"characters. Maximum length is 255 characters."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:318
msgid "In :guilabel:`Confirm`, enter the same password."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:322
msgid ""
":guilabel:`Administrator` rights are selected by default. For security "
"purposes, the default user must be assigned as an Administrator."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:326
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:394
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:427
msgid "Select :kbd:`Confirm`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:330
msgid "Select :guilabel:`Cancel` to return to the Main Menu."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:333
msgid "Modify User"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:335
msgid "In Manager User, select :guilabel:`Manage User`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:337
msgid "Modify user details as desired."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:339
msgid "Select :guilabel:`Confirm` to save the changes you made."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:343
msgid ""
"Optional: Select :guilabel:`Cancel` to return to the Main Menu to revert "
"changes."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:346
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:404
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:429
msgid "Optional: Skip to `Finish installation`_."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:349
msgid "Telemetry"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:351
msgid ""
"Choose whether to participate in `telemetry`. :ref:`telem-guide` is a "
"|CL| feature that reports failures and crashes to the |CL| development "
"team for improvements. For more information, see :ref:`telemetry-about`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:355
msgid "From :guilabel:`Required Options`, select :guilabel:`Telemetry`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:357
msgid "Select :kbd:`Yes`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:363
msgid "Figure 12: Enable Telemetry"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:365
msgid "If you don't wish to participate, select :kbd:`No`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:368
msgid "Advanced options"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:370
msgid ""
"After you complete the `Required options`_, we recommend completing "
":guilabel:`Advanced options`--though they're not required. Doing so "
"customizes your development environment, so you're ready to go "
"immediately after reboot."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:375
msgid "`Bundle Selection`_"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:377
msgid "`Assign Hostname`_"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:379
msgid "As for bundles, you can always add more later with :ref:`swupd-guide`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:382
msgid "Bundle Selection"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:384
msgid "On the Advanced menu, select :guilabel:`Bundle Selection`"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:386
msgid "Select your desired bundles."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:392
msgid "Figure 13: Bundle Selection"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:396
msgid "View the bundles that you selected."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:402
msgid "Figure 14: Bundle Selections - Advanced Options"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:407
msgid "Assign Hostname"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:409
msgid "In Advanced Options, select :guilabel:`Assign Hostname`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:411
msgid "In :guilabel:`Hostname`, enter the hostname only (excluding the domain)."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:417
msgid "Figure 15: Assign Hostname"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:421
msgid ""
"Hostname does not allow empty spaces. Hostname must start with an "
"alphanumeric character but may also contain hyphens. Maximum length of 63"
" characters."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:425
msgid "Navigate to :kbd:`Confirm` until highlighted."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:432
msgid "Finish installation"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:434
msgid ""
"When you are satisfied with your installation configuration, select "
":guilabel:`Install`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:441
msgid "Figure 16: Finish installation"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:447
msgid ""
"If you do not enter a selection for all :guilabel:`Required Options`, the"
" :guilabel:`Install` button remains greyed out, as shown in Figure 17. "
"Return to `Required Options`_ and make selections."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:456
msgid "Figure 17: Required Options - Incomplete"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:458
msgid "After installation is complete, select :guilabel:`Exit`."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:460
msgid "Shut down the target system."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:462
msgid "Remove the USB or any installation media."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:464
msgid "Power on your system."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:468
msgid ""
"Allow time for the graphical login to appear. A login prompt shows the "
"administrative user that you created."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:470
msgid "Log in as the adminstrative user."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:472
msgid "Congratulations. You successfully installed |CL|."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:475
msgid "Default partition schema"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:477
msgid ""
"Table 1 shows the defult partition schema with the exception of root, "
"which varies."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:480
msgid "**Table 1. Disk Partition Setup**"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:484
msgid "FileSystem"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:485
msgid "Mount Point"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:486
msgid "Minimum size"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:487
msgid "``VFAT``"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:488
msgid "/boot"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:489
msgid "150M"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:490
msgid "``swap``"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:492
msgid "256MB"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:493
msgid "``root``"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:494
msgid "/"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:495
msgid "*Size depends upon use case/desired bundles.*"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:498
msgid "Next steps"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:500
msgid ":ref:`guides`"
msgstr ""
@@ -0,0 +1,227 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/bootable-usb/bootable-usb.rst:4
msgid "Create a bootable USB drive"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:6
msgid ""
"Instructions to create a |CL-ATTR| USB drive vary depending on your "
"operating system. Follow the instructions applicable to your system:"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:9
msgid ":ref:`bootable-usb-linux`"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:10
msgid ":ref:`bootable-usb-mac`"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:11
msgid ":ref:`bootable-usb-windows`"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:14
msgid "Prerequisites"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:16
msgid "Use an **8GB** or larger USB drive."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:17
msgid "`Download`_ the |CL| live boot image or interactive installer image."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:22
msgid "Create a bootable USB drive on Linux\\*"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:24
#: ../../get-started/bootable-usb/bootable-usb.rst:107
#: ../../get-started/bootable-usb/bootable-usb.rst:166
msgid "Make sure you have have completed all `Prerequisites`_."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:26
msgid ""
"Before burning the image onto your USB drive, :ref:`verify and decompress"
" your image <verify-linux>`."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:30
#: ../../get-started/bootable-usb/bootable-usb.rst:113
#: ../../get-started/bootable-usb/bootable-usb.rst:172
msgid "Burn the |CL| image onto a USB drive"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:34
#: ../../get-started/bootable-usb/bootable-usb.rst:117
#: ../../get-started/bootable-usb/bootable-usb.rst:176
msgid "|CAUTION-BACKUP-USB|"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:36
msgid "Open a terminal emulator and get root privilege."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:42
#: ../../get-started/bootable-usb/bootable-usb.rst:121
msgid "Go to the directory with the decompressed image."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:44
msgid "Plug in the USB drive."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:46
msgid ""
"Identify the USB drive using the :command:`lsblk` command. This shows all"
" drives attached to the system, including the primary hard disk. In the "
"example output below, there are 4 drives (`/dev/sda`, `/dev/sdb`, "
"`/dev/sdc`, and `/dev/sdd`) attached, where `/dev/sda` is primary drive. "
"The remaining are three USB drives. The output also shows the mounted "
"partitions (under the `MOUNTPOINT` column) for each drive."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:58
msgid "Example output:"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:81
msgid ""
"You must unmount a USB drive before burning an image onto it. Note that "
"some Linux distros automatically mount a USB drive when it is plugged in."
" Unmount a USB drive with the :command:`umount` command followed by the "
"device identifier/partition. For example:"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:91
msgid ""
"Burn the image onto the USB drive. The example below burns an "
"uncompressed image onto `<your USB device>`:"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:100
msgid "|CAUTION-UNMOUNT-USB-PARTITIONS|"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:105
msgid "Create a bootable USB drive on macOS\\*"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:109
msgid ""
"Before burning the image onto your USB drive, :ref:`verify and decompress"
" your image <verify-mac>`."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:119
msgid "Launch the Terminal app."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:123
msgid "Plug in a USB drive and get its identifier:"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:129
msgid "This will list available disks and their partitions, as shown in Figure 1."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:135
msgid "Figure 1: macOS - Get USB drive identifier"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:137
msgid "Unmount the USB drive identified in the previous step. For example:"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:143
msgid ""
"Burn the image onto the drive using the :command:`dd` command. The "
"example below burns an uncompressed image onto `<your USB device>`:"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:150
msgid ""
"To speed up the imaging process, add an ‘r’ in front of the disk "
"identifier. For example `/dev/rdisk2`."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:153
msgid "Press :kbd:`<CTL>-T` to check imaging progress."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:155
msgid "Eject the USB drive."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:164
msgid "Create a bootable USB drive on Windows\\*"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:168
msgid ""
"Before burning the image onto your USB drive, :ref:`verify and decompress"
" your image <verify-windows>`."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:178
msgid ""
"Download the `Rufus`_ utility to burn the image onto a USB drive. We use "
"Rufus 3.5 here. **Only use the latest version of Rufus**."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:181
msgid "Plug in the USB drive and open Rufus."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:183
msgid "Under `Boot selection`, click the :guilabel:`SELECT` button."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:185
msgid "Find and select the previously extracted |CL| image file."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:187
msgid "Click the :guilabel:`START` button. See Figure 2."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:193
msgid "Figure 2: Rufus utility"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:195
msgid ""
"When the dialogue appears, select :guilabel:`Write in ISO image mode "
"(Recommended)`. See Figure 3."
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:202
msgid "Figure 3: ISOHybrid image detected"
msgstr ""
#: ../../get-started/bootable-usb/bootable-usb.rst:204
msgid "Select the Windows taskbar menu for USB and select eject."
msgstr ""
@@ -0,0 +1,71 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/compatibility-check.rst:4
msgid "Check processor and EFI firmware compatibility"
msgstr ""
#: ../../get-started/compatibility-check.rst:6
msgid ""
"On a system that is currently running a Linux\\* operating system, follow"
" the instructions below to determine if your system's processor and EFI "
"firmware is capable of running |CL-ATTR|. Otherwise, :ref:`bare-metal-"
"install-desktop` and then perform the steps below."
msgstr ""
#: ../../get-started/compatibility-check.rst:13
msgid ""
"This does not check other system components (for example: storage and "
"graphics) for compatibility with |CL|."
msgstr ""
#: ../../get-started/compatibility-check.rst:16
msgid "Download the `clear-linux-check-config.sh`_ file."
msgstr ""
#: ../../get-started/compatibility-check.rst:18
msgid "If a browser is not available, use:"
msgstr ""
#: ../../get-started/compatibility-check.rst:24
msgid "Make the script executable."
msgstr ""
#: ../../get-started/compatibility-check.rst:30
msgid "Run the script."
msgstr ""
#: ../../get-started/compatibility-check.rst:32
msgid ""
"Check to see if the host's processor and EFI firmware is capable of "
"running |CL|."
msgstr ""
#: ../../get-started/compatibility-check.rst:39
msgid "Check to see if the host is capable of running |CL| in a container."
msgstr ""
#: ../../get-started/compatibility-check.rst:45
msgid ""
"The script will print a list of test results similar to the output below."
" All items should return a `SUCCESS` status. This example indicates the "
"host's processor and EFI firmware support running |CL|."
msgstr ""
Binary file not shown.
@@ -0,0 +1,67 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/get-started.rst:4
msgid "Get started"
msgstr ""
#: ../../get-started/get-started.rst:6
msgid ""
"The Get Started section will get you up and running fast with |CL-ATTR|. "
"Use these step-by-step instructions to guide you through the installing "
"|CL| from a live desktop or to a virtual machine."
msgstr ""
#: ../../get-started/get-started.rst:11
msgid "Pre-install"
msgstr ""
#: ../../get-started/get-started.rst:13
msgid "There are a couple of things to take care of before you install."
msgstr ""
#: ../../get-started/get-started.rst:15
msgid ":ref:`system-requirements`"
msgstr ""
#: ../../get-started/get-started.rst:16
msgid ":ref:`compatibility-check`"
msgstr ""
#: ../../get-started/get-started.rst:17
msgid ":ref:`bootable-usb`"
msgstr ""
#: ../../get-started/get-started.rst:19
msgid "When installing |CL-ATTR| in a VM, consider which kernel to use."
msgstr ""
#: ../../get-started/get-started.rst:21
msgid ":ref:`Compatible VM kernels <vm-kernels>`"
msgstr ""
#: ../../get-started/get-started.rst:31
msgid "Install"
msgstr ""
#: ../../get-started/get-started.rst:42
msgid "Install in a virtual machine"
msgstr ""
@@ -0,0 +1,340 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/virtual-machine-install/gce.rst:4
msgid "Launch |CL-ATTR| Compute Engine on Google Cloud Platform\\*"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:6
msgid ""
"This tutorial walks you through the steps to create a virtual machine "
"instance of |CL-ATTR| on `Google Cloud Platform`_ (:abbr:`GCP (Google "
"Cloud Platform)`)."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:13
msgid "Prerequisites"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:15
msgid "Set up a Google account and a GCP billing account."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:17
msgid ""
"Generate and install a user SSH key in the Linux PCs that will connect to"
" the VMs in GCP."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:22
msgid "Process"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:24
msgid ""
"Sign in to your Google\\* account on the `Google Cloud Console "
"<https://console.cloud.google.com/>`_:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:31
msgid "Figure 1: Google sign in screen"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:33
msgid ""
"Google Cloud Platform uses **Projects** to manage resources. Select or "
"create a new project for hosting the |CL| VM."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:38
msgid ""
"Refer to the `Quickstart Using a Linux VM "
"<https://cloud.google.com/compute/docs/quickstart-linux>`_ guide to learn"
" about the process of creating VM instances on GCP."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:42
msgid ""
"Navigate to the latest |CL| `release folder "
"<https://download.clearlinux.org/releases/current/clear/>`_ to view the "
"currently released :abbr:`GCE (Google Compute Engine\\*)` image, and "
"download the :file:`clear-<release number>-gce.tar.gz` image archive."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:48
msgid ""
"You don't need to uncompress the image archive, the intact file will be "
"uploaded to the Google Cloud Storage later."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:51
msgid ""
"Create a *Storage Bucket* for hosting the |CL| image source archive "
"downloaded in the previous step:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:54
#: ../../get-started/virtual-machine-install/gce.rst:112
#: ../../get-started/virtual-machine-install/gce.rst:157
msgid "Click the *Navigation menu* icon on the upper left screen menu."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:56
msgid ""
"Select the *Storage* item from the side bar on the left. You will be sent"
" to the Storage Browser tool or the Cloud Storage overview page."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:63
msgid "Figure 2: Browse Google Cloud Storage"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:66
msgid ""
"You may need to create a billing account and link to this project before "
"you create a bucket."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:73
msgid "Figure 3: Cloud Storage Browser tool"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:75
msgid ""
"Click the ``CREATE BUCKET`` button to enter the bucket creation tool. The"
" bucket name must be unique because buckets in the Cloud Storage share a "
"single global namespace."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:79
msgid ""
"Leave the remaining options set to the defaults, and select the "
"``Create`` button at the bottom to create a *Bucket*."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:86
msgid "Figure 4: Set bucket name"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:88
msgid ""
"Once the bucket is created, click the ``Upload files`` button on the "
"Bucket details page to upload the |CL| GCE image archive to the named "
"bucket:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:96
msgid "Figure 5: Cloud Storage bucket"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:102
msgid "Figure 6: Uploading the image source archive file"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:108
msgid "Figure 7: Importing complete"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:110
msgid "Browse the Compute Engine Image library page:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:114
msgid "Hover your mouse over the *Compute Engine* menu and select *Images*."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:120
msgid "Figure 8: Image library"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:122
msgid ""
"On the Compute Engine Image library page, click the ``[+] CREATE IMAGE`` "
"menu item to create a custom image:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:129
msgid "Figure 9: Create image"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:131
msgid ""
"In the VM image creation page, change the image source type to *Cloud "
"Storage file*."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:134
msgid "Under :guilabel:`Cloud Storage file`, select :guilabel:`Browse`."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:136
msgid ""
"Locate the :file:`clear-<release number>-gce.tar.gz` file, and click "
":guilabel:`Select`."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:143
msgid "Figure 10: Create image using imported object"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:145
msgid ""
"Accept all default options, and click the ``Create`` button at the bottom"
" to import the Clear Linux GCE image to the image library."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:152
msgid "Figure 11: Image is created"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:154
msgid ""
"After the |CL| image is imported, you can launch a VM instance running "
"|CL|:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:159
msgid ""
"Hover your mouse over the *Compute Engine* menu group and select the *VM "
"instances* item."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:166
msgid "Figure 12: VM instances catalog"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:168
msgid ""
"If no VM instance was created in this project, you will be prompted to "
"create one."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:171
msgid ""
"Alternatively, click the ``CREATE INSTANCE`` button on the VM instances "
"page to create a VM instance."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:178
msgid "Figure 13: VM creation"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:184
msgid "Figure 14: VM instances list"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:186
msgid ""
"In :guilabel:`Region`, choose a region based on the `Best practices for "
"Compute Engine regions selection`_."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:189
msgid "Under *Boot disk*, click the ``Change`` button."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:195
msgid "Figure 15: Use custom image"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:197
msgid "Select the *Custom images* tab for using Clear Linux OS GCE image."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:203
msgid "Figure 16: Select Clear Linux boot disk to create a VM instance"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:205
msgid ""
"Scroll down to the bottom of the VM instance creation page, expand the "
"*Management, security, disks, networking, sole tenancy* group."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:212
msgid "Figure 17: Set up SSH keys"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:215
msgid ""
"|CL| does not allow SSH login with a root account by default. As a "
"result, you must configure the VM instance with your SSH public key, so "
"that you are able to access it remotely."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:219
msgid "Refer to :ref:`security` for more details."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:221
msgid "Click the *Security* tab, copy and paste your SSH public key:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:227
msgid "Figure 18: Set SSH key for remote login"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:231
msgid ""
"The username is assigned from characters preceding ``@`` in the email "
"address, included in the SSH key. The dot symbol \".\" is not allowed, "
"because it is an invalid character while creating user accounts in |CL|."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:236
msgid "Click the ``Create`` button to create the |CL| VM."
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:238
msgid "The Clear Linux VM instance is created and assigned a public IP address:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:244
msgid "Figure 19: Clear Linux VM instance is created and started"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:246
msgid ""
"You can now SSH login to the VM using the IP address obtained in the "
"previous step, and the username associated with the SSH public key:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:253
msgid "Figure 20: SSH login to Clear Linux VM"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:256
msgid "Related topics"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:258
msgid ""
"The following tutorials describe a similar process and may be useful "
"references:"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:260
msgid ":ref:`azure`"
msgstr ""
#: ../../get-started/virtual-machine-install/gce.rst:261
msgid ":ref:`aws-web`"
msgstr ""
@@ -0,0 +1,111 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/virtual-machine-install/hyper-v.rst:4
msgid "Use Hyper-V\\*"
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:6
msgid ""
"This section explains how to run |CL-ATTR| inside a `Windows Server "
"Virtualization`_\\* or **Hyper-V** environment."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:9
msgid ""
"Please ensure you have enabled `Intel® Virtualization Technology "
"<http://www.intel.com/content/www/us/en/virtualization/virtualization-"
"technology/intel-virtualization-technology.html>`_ (Intel® VT) and "
"`Intel® Virtualization Technology for Directed I/O "
"<https://software.intel.com/en-us/articles/intel-virtualization-"
"technology-for-directed-io-vt-d-enhancing-intel-platforms-for-efficient-"
"virtualization-of-io-devices>`_ (Intel® VT-d) in your BIOS/UEFI firmware "
"configuration."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:16
msgid "Enable Hyper-V"
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:18
msgid ""
"Please refer to the `Microsoft documentation`_ to enable and configure "
"*Hyper-V* on your machine."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:22
msgid "Create a virtual network"
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:24
msgid ""
"Once *Hyper-V* has been enabled on your Windows system you will need to "
"create a virtual network in the **Hyper-V Manager**. Refer to the "
"`Create a Virtual Network documentation`_ to create and configure a "
"virtual network."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:30
msgid "Create a virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:32
msgid ""
"Download and decompress the latest hyperv disk image :file:`clear-XXXXX-"
"hyperv.img.gz`, where XXXXX is the latest available version of |CL| from "
"our `downloads`_ section."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:36
msgid "Create a virtual machine using the **Hyper-V Manager**:"
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:38
msgid "Choose **Generation 2** when prompted to *specify VM generation*."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:39
msgid ""
"Choose **Use an existing virtual hard disk** and browse to find the :file"
":`clear-XXXX-hyperv.vhdx` file."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:41
msgid ""
"When finished, open VM settings, select Firmware Section and in Secure "
"Boot config, **uncheck** Enable Secure Boot."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:44
msgid "Currently, |CL| does not boot with `secure boot` enabled."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:47
msgid "Connect to your new VM and start it. You should see a prompt:"
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:53
msgid "Set a root user password."
msgstr ""
#: ../../get-started/virtual-machine-install/hyper-v.rst:55
msgid "Your virtual machine running |CL| is ready!"
msgstr ""
@@ -0,0 +1,231 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/virtual-machine-install/kvm.rst:4
msgid "Run |CL-ATTR| as a KVM guest OS"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:6
msgid ""
"This guide explains how to run |CL-ATTR| in a virtualized environment "
"using :abbr:`KVM (Kernel-based Virtual Machine)`."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:10
msgid "Install QEMU-KVM"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:12
msgid ""
"Enable the `Intel® Virtualization Technology`_ (Intel® VT) and the "
"`Intel®Virtualization Technology for Directed I/O`_ (Intel® VT-d) in the "
"host machine’s BIOS."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:16
msgid "Log in and open a terminal emulator."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:18
msgid "Install `QEMU*-KVM` on the host machine. Below are some example distros."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:20
msgid "On |CL|:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:26
#: ../../get-started/virtual-machine-install/kvm.rst:155
msgid "On Ubuntu\\* 18.04 LTS Desktop:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:32
#: ../../get-started/virtual-machine-install/kvm.rst:161
msgid "On Mint\\* 19.1 “Cinnamon” Desktop:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:38
#: ../../get-started/virtual-machine-install/kvm.rst:167
msgid "On Fedora\\* 30 Workstation:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:45
msgid "Download and launch the virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:47
msgid ""
"Download the latest pre-built |CL| KVM image file from the `image "
"<https://cdn.download.clearlinux.org/image/>`_ directory. Look for "
"``clear-<version>-kvm.img.xz``. You can also use this command:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:55
msgid "Uncompress the downloaded image:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:61
msgid ""
"Download the 3 OVMF files (`OVMF.fd`, `OVMF_CODE.fd`, `OVMF_VARS.fd`) "
"that provides UEFI support for virtual machines."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:72
msgid ""
"The default OVMF files from |CL| may not work for some distro version(s)."
" You may get an `ASSERT` in the `debug.log` file when starting the VM. If"
" that is the case, use the distro-specific-OVMF files instead. For "
"example, the |CL| OVMF files work for Ubuntu 18.04 LTS, but not for "
"Ubuntu 19.04 LTS. Installing and using the OVMF files for Ubuntu 19.04 "
"LTS resolved the `ASSERT` issue."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:78
msgid ""
"Download the `QEMU-KVM launcher`_ script from the `image "
"<https://cdn.download.clearlinux.org/image/>`_ directory. This script "
"will launch the |CL| VM and provide console interaction within the same "
"terminal emulator window."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:87
msgid "Make the script executable:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:93
msgid "Start the |CL| KVM virtual machine:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:99
msgid "Log in as ``root`` user and set a new password."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:102
msgid "SSH access into the virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:104
msgid ""
"To interact with the |CL| VM through SSH instead of the console it was "
"launched from, follow these steps."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:107
msgid "Configure SSH in the |CL| VM to allow root login:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:115
msgid "Enable and start SSH server in the |CL| VM:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:122
#: ../../get-started/virtual-machine-install/kvm.rst:211
msgid ""
"Determine the IP address of the host on which you will launch the VM. "
"Substitute <ip-addr-of-kvm-host> in the next step with this information."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:129
msgid "SSH into the |CL| VM using the default port of `10022`:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:136
msgid "Optional: Add the GNOME Display Manager (GDM)"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:138
msgid ""
"To add :abbr:`GDM (GNOME Display Manager)` to the |CL| VM, follow these "
"steps:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:140
msgid "Shutdown the active |CL| VM."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:146
msgid ""
"Install the Spice viewer on the local host or remote system. Below are "
"some example distros."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:149
msgid "On Clear Linux:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:173
msgid ""
"Modify the :file:`start_qemu.sh` script to increase memory (`-m`), add "
"graphics driver (`-vga`), and add Spice (`-spice`, `-usb`, and `-device`)"
" support."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:194
msgid ""
"Due to changes in the :file:`start_qemu.sh` script from the previous "
"step, using the same OVMF files will result in the VM not booting "
"properly and you end up in the the UEFI shell. The easiest way to avoid "
"this is to delete the OVMF files and restore the originals before "
"relaunching the VM."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:199
msgid "Increase the size of the VM by 10GB to accommodate the GDM installation:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:205
msgid "Relaunch the |CL| VM:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:218
msgid ""
"From the local host or remote system, open a new terminal emulator window"
" and connect into the |CL| VM using the Spice viewer:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:225
msgid "Log in as `root` user into the |CL| VM."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:227
msgid ""
"Follow these steps to `resize the partition`_ of the virtual disk of the "
"VM."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:229
msgid "Add GDM to the |CL| VM:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:235
msgid "Reboot the |CL| VM to start GDM:"
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:241
msgid "Go through the GDM out-of-box experience (OOBE)."
msgstr ""
#: ../../get-started/virtual-machine-install/kvm.rst:243
msgid ""
"The default aspect ratio of the GDM GUI for the |CL| VM is 4:3. To change"
" it, use GDM's `Devices > Displays` setting tool (located at the top-"
"right corner)."
msgstr ""
@@ -0,0 +1,554 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:4
msgid "Install a |CL-ATTR| VM in VirtualBox\\*"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:6
msgid ""
"Oracle\\* VirtualBox\\* is a type 2 hypervisor. This document explains "
"how to create a virtual machine on the `VirtualBox hypervisor`_ with |CL-"
"ATTR| as the guest operating system. These instructions support use of "
"the |CL| live-server installer to create |CL| virtual machine (VM)."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:15
msgid "Prerequisites"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:17
msgid "Before continuing, assure you have:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:19
msgid ""
"Enabled virtualization, such as Intel® `Virtualization Technology`_ "
"(Intel® VT), on the host system from EFI/BIOS."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:23
msgid ""
"Downloaded and installed |VB| **version 6.0 or greater** from the "
"`official VirtualBox website`_ per the `appropriate instructions`_ for "
"your platform."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:28
msgid "Download and extract the |CL| installer ISO"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:30
msgid ""
"Download the :file:`clear-<VERSION>-live-server.iso.xz` of |CL| on the "
"`downloads page`_."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:33
msgid ""
"Validate the integrity of the downloaded image by checking the file hash "
"and signatures. Refer :ref:`validate-signatures` for detailed steps."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:36
msgid "Decompress the downloaded image."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:38
msgid ""
"On Windows you can use `7zip`_ to extract the file by right-clicking the "
"file to *Extract Here* (in the same directory)"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:45
msgid "Figure 1: 7zip extract here command"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:47
msgid "On Linux :"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:53
msgid "Delete the originally downloaded compressed file."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:56
msgid "Create a new |VB| virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:58
msgid ""
"A new :abbr:`VM (Virtual Machine)` needs to be created in |VBM| where "
"|CL| will be installed. General instructions for creating a virtual "
"machine and details about using different settings are available on the "
"`VirtualBox manual section on Creating a VM`_."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:63
msgid "Launch the |VBM| from your host system."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:65
msgid "Click the *New* button to create a new VM."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:67
msgid "Choose :guilabel:`Expert mode`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:69
msgid "In :guilabel:`Create Virtual Machine`, enter the following settings:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:71
msgid "**Name**: Choose name (e.g. ClearLinuxOS-VM)."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:72
msgid "**Type**: Linux"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:73
msgid "**Version**: **Linux 2.6 / 3.x / 4.x (64-bit)**"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:74
msgid "**Hard disk**: `Create a virtual hard disk now`"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:75
msgid "**Memory size default**: 2048 MB (Adjust appropriately.)"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:78
msgid ""
"Later, if you want to change the amount of RAM allocated, power down your"
" VM. Return to :file:`Settings > System` and change :guilabel:`Base "
"Memory` to the desired size."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:85
msgid "Figure 2: Create Virtual Machine"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:87
msgid "Select :guilabel:`Create`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:89
msgid "In :guilabel:`Create Virtual Hard Disk`, select:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:91
msgid "**File location**"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:92
msgid "**File size**: **32.00 GB**. Adjust size to your needs."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:93
msgid "**Hard disk file type**: `VDI (VirtualBox Disk Image)`"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:94
msgid "**Storage on physical hard disk**:`Dynamically allocated`"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:100
msgid "Figure 3: Create Virtual Hard Disk"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:102
msgid "Click *Create*."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:104
msgid "A new virtual machine will be created and appear in the |VBM|."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:106
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:222
msgid "Click *Settings* to configure the |CL| VM."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:108
msgid "In the left-hand menu, navigate to the :guilabel:`System` menu."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:110
msgid ""
"In the :guilabel:`Motherboard` tab, select the `Chipset` pulldown menu, "
"and then select :guilabel:`ICH9`. See Figure 4."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:115
msgid ""
"You can select which chipset will be presented to the virtual machine. "
"Consult the `VM VirtualBox User Manual`_ for more details."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:118
msgid "In :guilabel:`Enabled Features`, check these boxes:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:120
msgid "**Enable I/O APIC**"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:121
msgid "**Enable EFI (special OSes only)**"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:127
msgid "Figure 4: Settings > System"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:131
msgid ""
"By default, only 1 virtual CPU is allocated to the new VM. Consider "
"increasing the number of virtual processors allocated to the virtual "
"machine under Settings > System > Processor for increased performance."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:136
msgid "Select :guilabel:`OK`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:139
msgid "Install |CL| on the |VB| VM"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:141
msgid "|CL| is ready to be installed."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:144
msgid "Mount the installation ISO"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:146
msgid ""
"The |CL| installer ISO needs to be mounted as a virtual CD-ROM on the VM "
"before powering the VM on."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:149
msgid ""
"From the *ClearLinux-OS* :guilabel:`Settings` at left, select "
":guilabel:`Storage`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:152
msgid ""
"From :guilabel:`Storage Devices`, middle column, click the blue disk "
"labeled *Empty*."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:155
msgid ""
"From the :guilabel:`Attributes` menu, click the blue CD disk next to the "
"*Optical Drive* drop down menu and click *Choose Virtual Optical Disk "
"File...*"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:163
msgid "Figure 5: Choose Virtual Optical Disk Drive"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:165
msgid ""
"Where there appears :guilabel:`Please choose a virtual optical disk "
"file`, select the ISO file and click *Open*."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:172
msgid "Figure 6: Mounting an ISO"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:174
msgid "Select :guilabel:`OK` to exit and return to the main |VBM|."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:177
msgid "Install |CL| with live-server installer"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:179
msgid "In the |VBM|, select virtual machine you created and click *Start*."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:185
msgid "Figure 7: Start the installer"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:189
msgid ""
"To release the mouse cursor from the VM console window, press the right "
":kbd:`Ctrl` key on the keyboard."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:192
msgid ""
"When :guilabel:`Clear Linux Installer` in boot manager appears, select "
":kbd:`Enter`. Do not install the bundle `desktop-autostart`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:195
msgid ""
"Follow the steps in :ref:`bare-metal-install-server` to install |CL| onto"
" the VM virtual disk. Note:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:198
msgid ""
"In :guilabel:`Configure Installation Media`, navigate top VBOX HARDDISK, "
"and then select :guilabel:`Confirm`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:201
msgid ""
"In :guilabel:`Advanced options` > :guilabel:`Manage User`, create an "
"administrative user."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:204
msgid "Do not install the bundle `desktop-autostart`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:206
msgid "When |CL| installation is complete, select :guilabel:`Exit`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:208
msgid "At the prompt, enter:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:215
msgid "Unmount the ISO"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:217
msgid ""
"The |CL| installer ISO needs to be unmounted to allow the VM to boot from"
" the virtual hard disk."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:220
msgid "Return to the |VBM|."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:224
msgid ""
"From the *VM - Settings* window, navigate to the *Storage* pane from the "
"left-hand side."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:227
msgid ""
"From the middle *Storage Devices* column, click the blue CD disk labeled "
"*clear-<VERSION>-live-server.iso* under the *Controller: IDE* from."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:230
msgid ""
"From the *Attributes* column at right, in *Optical Drive*, select the "
"blue CD icon beside and click *Remove Disk from Virtual Drive*."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:237
msgid "Figure 8: Remove Disk from Virtual Drive"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:239
msgid "Click *OK* to exit the *VM Settings* menu and return to the main |VBM|."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:243
msgid "Install |VB| Linux Guest Additions"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:245
msgid ""
"|CL| provides Linux Guest Additions drivers for full compatibility using "
"an install script in the **kernel-lts** (Long Term Support) bundle by "
"|CL|."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:248
msgid "From the |VBM| select the |CL| VM, and select :guilabel:`Start`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:250
msgid "In the VM Console, log in as the administrative user previously created."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:253
msgid ""
"A message may appear: \"A kernel update is available: you may wish to "
"reboot the system.\""
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:256
msgid "To update the kernel, enter:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:262
msgid "At initial login, enter the administrative user's password and continue."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:264
msgid ""
"Validate the installed kernel is **kernel-lts** by checking the output of"
" the :command:`uname -r` command. It should end in **.lts** or "
"**.lts2018**."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:272
msgid ""
"If the running kernel is not **lts**: install the LTS kernel manually, "
"update the bootloader, and check again:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:282
msgid ""
"Remove any kernel bundles that do not end in *-lts* or *kernel-install* "
"to simplify and avoid conflicts:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:290
msgid ""
"In the VM Console top menu, click *Devices*, and select *Insert Guest "
"Additions CD image...* to mount the |VB| driver installation to the |CL| "
"VM."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:297
msgid "Figure 9: Insert Guest Additions CD image"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:299
msgid ""
"If a dialogue appears, \"VBx_GAs_6.0.8... Would you like to run it?\", "
"select :guilabel:`Cancel`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:302
msgid "Instead, we provide a script to patch and install |VB| drivers on |CL|."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:304
msgid "Open a Terminal and enter the script:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:312
msgid ""
"Successful installation shows: \"Guest Additions installation complete\"."
" If drivers are already installed, don't re-install them."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:315
msgid "Shut down the system. Select :guilabel:`Machine>ACPI Shutdown`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:321
msgid "Figure 10: Powering off a VirtualBox VM"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:323
msgid "Select :guilabel:`Settings`, :guilabel:`Display`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:325
msgid ""
"In :guilabel:`Graphics Controller`, select :guilabel:`VBoxSVGA` to adjust"
" screen size dynamically."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:332
msgid "Figure 11: VirtualBox hardware acceleration error"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:334
msgid "In the |VBM|, select :guilabel:`Start`."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:336
msgid "In the VM console, login and verify the |VB| drivers are loaded:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:342
msgid ""
"You should see drivers loaded with names beginning with **vbox**: (e.g., "
"vboxvideo, vboxguest)."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:345
msgid "Add `desktop-autostart` for a full desktop experience."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:351
msgid "Reboot the VM and log in with the administrative user."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:357
msgid "The |CL| VM running on |VB| is ready to develop and explore."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:360
msgid "Troubleshooting"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:362
msgid ""
"**Problem:** On a Microsoft\\* Windows\\* OS, |VB| encounters an error "
"when trying to start a VM indicating *VT-X/AMD-v hardware acceleration is"
" not available on your system.*"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:370
msgid "Figure 12: VirtualBox hardware acceleration error"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:372
msgid ""
"**Solution:** First, double check the `Prerequisites`_ section to make "
"sure *Hardware accelerated virtualization* extensions have been enabled "
"in the host system's EFI/BIOS."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:376
msgid ""
"*Hardware accelerated virtualization*, may get disabled for |VB| when "
"another hypervisor, such as *Hyper-V* is enabled."
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:379
msgid ""
"To disable *Hyper-V* execute this command in an **Administrator: Command "
"Prompt or Powershell**, and reboot the system:"
msgstr ""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:386
msgid ""
"To enable Hyper-V again, execute this command in an **Administrator: "
"Command Prompt or Powershell**, and reboot the system:"
msgstr ""
@@ -0,0 +1,493 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:4
msgid ""
"Run pre-configured |CL-ATTR| image as a VMware\\* Workstation Player "
"guest OS"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:6
msgid ""
"`VMware Workstation 14 Player`_ is a type 2 hypervisor. It runs on top of"
" another operating system such as Windows\\* or Linux\\*. With VMware "
"ESXi, you can create, configure, manage, and run |CL-ATTR| :abbr:`VMs "
"(Virtual Machines)` on your local system."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:11
msgid ""
"This section shows how to deploy a pre-configured |CL| VMware image on "
"VMware Workstation 14 Player."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:14
msgid "In this tutorial, we perform the following steps:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:21
msgid ""
"The screenshots on this document show the Windows version of the VMware "
"Workstation 14 Player. The menus and prompts are similar to those in the "
"Linux version save some minor wording differences."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:26
msgid "Install the VMware Workstation Player hypervisor"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:28
msgid ""
"Enable :abbr:`Intel® VT (Intel® Virtualization Technology)` and "
":abbr:`Intel® VT-d (Intel® Virtualization Technology for Directed I/O)` "
"in your system's BIOS."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:32
msgid ""
"`VMware Workstation 14 Player`_ is available for Windows and Linux. "
"Download your preferred version."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:35
msgid ""
"Depending on which OS you're running, install it by following one of "
"these instructions:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:38
msgid "On supported Linux distros:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:40
msgid "Enable a GUI desktop."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:42
msgid "Start a terminal emulator."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:44
msgid ""
"Start the installer by issuing the command below and following the guided"
" steps."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:51
msgid "On Windows:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:53
msgid "Start the installer."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:54
msgid "Follow the setup wizard."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:56
msgid "For additional help, see the `VMware Workstation Player guide`_."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:59
msgid "Download the latest |CL| VMware image"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:61
msgid ""
"Get the latest |CL| VMware image from the `image`_ repository. Look for "
":file:`clear-[version number]-vmware.vmdk.xz`. You can also use this "
"command:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:69
msgid ""
"Visit :ref:`image-types` for additional information about all available "
"|CL| images."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:4
msgid "Verify the integrity of the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:6
msgid ""
"Before you use a downloaded |CL| image, verify its integrity. This action"
" eliminates the small chance of a corrupted image due to download issues."
" To support verification, each released |CL| image has a corresponding "
"SHA512 checksum file designated with the suffix `-SHA512SUMS`."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:11
msgid "Download the corresponding SHA512 checksum file of your |CL| image."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:12
msgid "Start Command Prompt."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:13
msgid "Go to the directory with the downloaded image and checksum files."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:14
msgid "Get the SHA512 checksum of the image with the command:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:20
msgid ""
"Manually compare the output with the original checksum value shown in the"
" downloaded checksum file and make sure they match."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:24
msgid "Decompress the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:26
msgid ""
"Released |CL| images are compressed with either GNU zip (*.gz*) or XZ "
"(*.xz*). The compression type depends on the target platform or "
"environment. To decompress the image, follow these steps:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:30
msgid "Download and install `7-Zip`_."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:31
msgid "Go to the directory with the downloaded image and right-click it."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:32
msgid ""
"From the pop-up menu, select :guilabel:`7-Zip` and select "
":guilabel:`Extract Here` as shown in Figure 1."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:39
msgid "Figure 1: Windows 7-Zip extract file."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:74
msgid "We also provide instructions for other operating systems:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:76
msgid ":ref:`download-verify-decompress-linux`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:77
msgid ":ref:`download-verify-decompress-mac`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:80
msgid "Create and configure a new VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:82
msgid "Start the `VMware Workstation Player` app."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:83
msgid ""
"On the home screen, click :guilabel:`Create a New Virtual Machine`. See "
"figure 1."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:90
msgid "Figure 1: VMware Workstation 14 Player - Create a new virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:92
msgid ""
"On the :guilabel:`Welcome to the New Virtual Machine Wizard` screen, "
"select the :guilabel:`I will install the operating system later` option. "
"See figure 2."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:100
msgid ""
"Figure 2: VMware Workstation 14 Player - Select install operating system "
"later."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:103
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:119
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:130
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:229
msgid "Click the :guilabel:`Next` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:105
msgid ""
"On the :guilabel:`Select a Guest Operating System` screen, set the "
":guilabel:`Guest operating system` setting to :guilabel:`Linux`. See "
"figure 3."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:113
msgid ""
"Figure 3: VMware Workstation 14 Player - Select guest operating system "
"type"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:116
msgid ""
"Set :guilabel:`Version` setting to :guilabel:`Other Linux 3.x or later "
"kernel 64-bit`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:121
msgid ""
"On the :guilabel:`Name the Virtual Machine` screen, give your new VM a "
"name. See figure 4."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:128
msgid "Figure 4: VMware Workstation 14 Player - Name virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:132
msgid ""
"On the :guilabel:`Specify Disk Capacity` screen, click the "
":guilabel:`Next` button. Keep the default disk settings unchanged. When "
"we attach the pre-configured |CL| VMware image, we will remove the "
"default virtual disk and replace it with the pre-configured one. See "
"figure 5."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:142
msgid "Figure 5: VMware Workstation 14 Player - Set disk capacity"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:144
msgid ""
"On the :guilabel:`Ready to Create Virtual Machine` screen, click the "
":guilabel:`Customize Hardware...` button. See figure 6."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:151
msgid "Figure 6: VMware Workstation 14 Player - Customize hardware"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:153
msgid ""
"Under the :guilabel:`Device` list, select :guilabel:`Processors`. See "
"figure 7."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:160
msgid "Figure 7: VMware Workstation 14 Player - Set virtualization engine option"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:163
msgid ""
"Under the :guilabel:`Virtualization engine` section, check "
":guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:166
msgid ""
"To disconnect the virtual CD/DVD (IDE) since it is not needed, under the "
":guilabel:`Device` list, select :guilabel:`New CD/DVD (IDE)`. See figure "
"8."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:173
msgid "Figure 8: VMware Workstation 14 Player - Disconnect CD/DVD (IDE)"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:175
msgid ""
"Under the :guilabel:`Device status` section, uncheck :guilabel:`Connect "
"at power on`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:178
msgid "Click the :guilabel:`Close` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:180
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:257
msgid "Click the :guilabel:`Finish` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:183
msgid "Attach the pre-configured |CL| VMware image"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:185
msgid ""
"Move the downloaded and decompressed pre-configured |CL| VMware image "
"file :file:`clear-[version number]-basic.vmdk` to the directory where "
"your newly-created VM resides."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:191
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:276
msgid "Depending on the OS, you can typically find the VMware VM files under:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:193
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:278
msgid "On Linux distros: :file:`/home/username/vmware`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:194
msgid "On Windows: :file:`C:\\Users\\username\\Documents\\Virtual Machines`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:196
msgid ""
"On the :guilabel:`VMware Workstation Player` home screen, select your "
"newly-created VM. See figure 9."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:203
msgid "Figure 9: VMware Workstation 14 Player - Edit virtual machine settings"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:205
msgid "Click :guilabel:`Edit virtual machine settings`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:207
msgid ""
"To remove the default hard disk, under the :guilabel:`Device` list, "
"select :guilabel:`Hard Disk (SCSI)`. See figure 10."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:214
msgid "Figure 10: VMware Workstation 14 Player - Remove hard drive"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:216
msgid "Click the :guilabel:`Remove` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:218
msgid ""
"To add a new hard disk and attach the pre-configured |CL| VMware image, "
"click the :guilabel:`Add...` button. See Figure 11."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:225
msgid "Figure 11: VMware Workstation 14 Player - Add new hard drive"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:227
msgid ""
"Under the :guilabel:`Hardware types` section, select :guilabel:`Hard "
"Disk`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:231
msgid "Select your preferred :guilabel:`Virtual disk type`. See figure 12."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:237
msgid "Figure 12: VMware Workstation 14 Player - Select virtual disk type"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:239
msgid "Select the :guilabel:`Use an existing virtual disk` option. See figure 13."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:245
msgid "Figure 13: VMware Workstation 14 Player - Use existing virtual disk"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:247
msgid ""
"Click the :guilabel:`Browse` button and select the pre-configured |CL| "
"VMware image file. See figure 14."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:254
msgid ""
"Figure 14: VMware Workstation 14 Player - Select ready-made VMware |CL| "
"image file"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:261
msgid ""
"When asked to convert the existing virtual disk to a newer format, "
"selecting either option works."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:265
msgid "Enable UEFI boot support"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:267
msgid ""
"|CL| needs UEFI support to boot.To enable it, add the following line to "
"the end of your VM's :file:`.vmx` file:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:279
msgid ""
"On Windows: :file:`C:\\\\Users\\\\username\\\\Documents\\\\Virtual "
"Machines`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:282
msgid "Power on the VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:284
msgid "After configuring the settings above, power on your |CL| virtual machine."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:286
msgid ""
"On the :guilabel:`VMware Workstation Player` home screen, select your VM."
" See figure 15."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:293
msgid "Figure 15: VMware Workstation 14 Player - Power on virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:295
msgid "Click :guilabel:`Play virtual machine`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:298
msgid "Related topics"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:300
msgid "For other guides on using the VMWare Player and ESXi, see:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:302
msgid ":ref:`vmw-player`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:303
msgid ":ref:`vmware-esxi-install-cl`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:304
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
msgstr ""
@@ -0,0 +1,492 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/virtual-machine-install/vmw-player.rst:4
msgid "Install |CL-ATTR| as a VMware\\* Workstation Player guest OS"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:6
msgid ""
"`VMware Workstation 14 Player`_ is a type 2 hypervisor. It runs on top of"
" another operating system such as Windows\\* or Linux\\*. With VMware "
"ESXi, you can create, configure, manage, and run |CL-ATTR| :abbr:`VMs "
"(Virtual Machines)` on your local system."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:11
msgid ""
"This section shows how to create a new VM and install |CL| into it with "
"the VMware Workstation 14 Player hypervisor. Installing |CL| into a new "
"VM provides you flexibility when configuring the VM. You can configure "
"the VM's size, number of partitions, installed bundles, etc."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:16
msgid "In this tutorial, we perform the following steps:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:21
msgid ""
"If you prefer to use a pre-configured |CL| VMware image instead, see our "
":ref:`vmw-player-preconf` guide."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:24
msgid ""
"VMware offers a type 1 hypervisor called `VMware ESXi`_ designed for the "
"cloud environment. For information on how to install |CL| as guest OS on "
"it, see :ref:`vmware-esxi-install-cl`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:30
msgid ""
"The screenshots on this document show the Windows version of the VMware "
"Workstation 14 Player. The menus and prompts are similar to those in the "
"Linux version save some minor wording differences."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:35
msgid "Install the VMware Workstation Player hypervisor"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:37
msgid ""
"Enable :abbr:`Intel® VT (Intel® Virtualization Technology)` and "
":abbr:`Intel® VT-d (Intel® Virtualization Technology for Directed I/O)` "
"in your system's BIOS."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:41
msgid ""
"`VMware Workstation 14 Player`_ is available for Windows and Linux. "
"Download your preferred version."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:44
msgid ""
"Install VMware Workstation 14 Player following the instructions "
"appropriate for your system's OS:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:47
msgid "On supported Linux distros:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:49
msgid "Enable a GUI desktop."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:50
msgid "Start a terminal emulator."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:51
msgid ""
"Start the installer by issuing the command below and follow the guided "
"steps."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:58
msgid "On Windows:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:60
msgid "Start the installer."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:61
msgid "Follow the setup wizard."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:63
msgid "For additional help, see the `VMware Workstation Player guide`_."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:66
msgid "Download the latest |CL| installer ISO"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:68
msgid ""
"Get the latest |CL| installer ISO image from the `image`_ repository. "
"Look for :file:`clear-[version number]-installer.iso.xz`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:71
msgid ""
"Visit :ref:`image-types` for additional information about all available "
"|CL| images."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:4
msgid "Verify the integrity of the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:6
msgid ""
"Before you use a downloaded |CL| image, verify its integrity. This action"
" eliminates the small chance of a corrupted image due to download issues."
" To support verification, each released |CL| image has a corresponding "
"SHA512 checksum file designated with the suffix `-SHA512SUMS`."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:11
msgid "Download the corresponding SHA512 checksum file of your |CL| image."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:12
msgid "Start Command Prompt."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:13
msgid "Go to the directory with the downloaded image and checksum files."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:14
msgid "Get the SHA512 checksum of the image with the command:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:20
msgid ""
"Manually compare the output with the original checksum value shown in the"
" downloaded checksum file and make sure they match."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:24
msgid "Decompress the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:26
msgid ""
"Released |CL| images are compressed with either GNU zip (*.gz*) or XZ "
"(*.xz*). The compression type depends on the target platform or "
"environment. To decompress the image, follow these steps:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:30
msgid "Download and install `7-Zip`_."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:31
msgid "Go to the directory with the downloaded image and right-click it."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:32
msgid ""
"From the pop-up menu, select :guilabel:`7-Zip` and select "
":guilabel:`Extract Here` as shown in Figure 1."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:39
msgid "Figure 1: Windows 7-Zip extract file."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:76
msgid "We also provide instructions for other operating systems:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:78
msgid ":ref:`download-verify-decompress-linux`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:79
msgid ":ref:`download-verify-decompress-mac`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:82
msgid "Create and configure a new VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:84
msgid "Start the `VMware Workstation Player` app."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:86
msgid ""
"On the home screen, click :guilabel:`Create a New Virtual Machine`. See "
"Figure 1."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:93
msgid "Figure 1: VMware Workstation 14 Player - Create a new virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:96
msgid ""
"On the :guilabel:`Welcome to the New Virtual Machine Wizard` screen, "
"select the :guilabel:`Installer disc image file (iso)` option. See Figure"
" 2."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:104
msgid "Figure 2: VMware Workstation 14 Player - Select |CL| installer ISO"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:106
msgid ""
"Click the :guilabel:`Browse` button and select the decompressed |CL| "
"installer ISO."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:109
#: ../../get-started/virtual-machine-install/vmw-player.rst:125
#: ../../get-started/virtual-machine-install/vmw-player.rst:136
#: ../../get-started/virtual-machine-install/vmw-player.rst:151
msgid "Click the :guilabel:`Next` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:111
msgid ""
"On the :guilabel:`Select a Guest Operating System`, set the "
":guilabel:`Guest operating system` setting to :guilabel:`Linux`. See "
"Figure 3."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:119
msgid ""
"Figure 3: VMware Workstation 14 Player - Select guest operating system "
"type"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:122
msgid ""
"Set the :guilabel:`Version` setting to :guilabel:`Other Linux 3.x or "
"later kernel 64-bit`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:127
msgid ""
"On the :guilabel:`Name the Virtual Machine` screen, name the new VM. See "
"Figure 4."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:134
msgid "Figure 4: VMware Workstation 14 Player - Name virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:138
msgid ""
"On the :guilabel:`Specify Disk Capacity` screen, set the VM's maximum "
"disk size. See Figure 5."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:145
msgid "Figure 5: VMware Workstation 14 Player - Set disk capacity"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:148
msgid ""
"A minimal |CL| installation can exist on 600MB of drive space. See :ref"
":`system-requirements` for more details."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:153
msgid ""
"On the :guilabel:`Ready to Create Virtual Machine` screen, click the "
":guilabel:`Customize Hardware...` button. See Figure 6."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:160
msgid "Figure 6: VMware Workstation 14 Player - Customize hardware"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:162
msgid "Select :guilabel:`Memory` and set the size to 2GB. See Figure 7."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:168
msgid "Figure 7: VMware Workstation 14 Player - Set memory size"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:171
msgid ""
"The |CL| installer ISO needs a minimum of 2GB of RAM. After completing "
"installation, |CL| can run on as little as 128MB of RAM. Thus, you can "
"reduce the memory size if needed. See :ref:`system-requirements` for more"
" details."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:176
msgid ""
"Under the :guilabel:`Device` list, select :guilabel:`Processors`. See "
"Figure 8."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:183
msgid "Figure 8: VMware Workstation 14 Player - Set virtualization engine option"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:186
msgid ""
"Under the :guilabel:`Virtualization engine` section, check "
":guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:189
msgid "Click the :guilabel:`Close` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:191
msgid "Click the :guilabel:`Finish` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:194
msgid "Install |CL| into the new VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:196
msgid ""
"Select the newly-created VM and click the :guilabel:`Play virtual "
"machine` button. See Figure 9."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:203
msgid "Figure 9: VMware Workstation 14 Player - Power on virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:205
msgid ""
"Follow the :ref:`install-on-target-start` guide to complete the "
"installation of |CL|."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:208
msgid ""
"After the installation completes, reboot the VM. This reboot restarts the"
" |CL| installer."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:212
msgid "Detach the |CL| installer ISO from the VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:214
msgid ""
"To enable the mouse pointer so you access VMware Workstation Player's "
"menus, press :kbd:`<CTRL>` + :kbd:`<ALT>` on the keyboard."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:217
msgid ""
"To disconnect the CD/DVD to stop it from booting the |CL| installer ISO "
"again, click the :guilabel:`Player` menu. See Figure 10."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:224
msgid "Figure 10: VMware Workstation 14 Player - Edit CD/DVD settings"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:226
msgid "Go to :menuselection:`Removable Devices-->CD/DVD (IDE)-->Settings`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:228
msgid ""
"On the :guilabel:`Device status` section, uncheck the "
":guilabel:`Connected` and the :guilabel:`Connect at power on` settings. "
"See Figure 11."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:236
msgid "Figure 11: VMware Workstation 14 Player - Disconnect CD/DVD"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:238
msgid "Click the :guilabel:`OK` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:240
msgid "To power off the VM, click the :guilabel:`Player` menu. See Figure 12."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:246
msgid "Figure 12: VMware Workstation 14 Player - Power off virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:248
msgid "Go to :guilabel:`Power` and select :guilabel:`Shut Down Guest`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:251
msgid "Enable UEFI boot support"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:253
msgid ""
"|CL| needs UEFI support to boot. To enable UEFI, add the following line "
"to the end of your VM's :file:`.vmx` file:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:262
msgid "Depending on the OS, you can typically find the VMware VM files under:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:264
msgid "On Linux distros: :file:`/home/username/vmware`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:265
msgid ""
"On Windows: :file:`C:\\\\Users\\\\username\\\\Documents\\\\Virtual "
"Machines`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:268
msgid "Power on the VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:270
msgid "After configuring the settings above, power on your |CL| virtual machine."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:272
msgid ""
"On the :guilabel:`VMware Workstation Player` home screen, select your VM."
" See Figure 13."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:279
msgid "Figure 13: VMware Workstation 14 Player - Power on virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:281
msgid "Click :guilabel:`Play virtual machine`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:284
msgid "Related topics"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:286
msgid "For other guides on using the VMWare Player and ESXi, see:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:288
msgid ":ref:`vmw-player-preconf`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:289
msgid ":ref:`vmware-esxi-install-cl`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmw-player.rst:290
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
msgstr ""
@@ -0,0 +1,477 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:4
msgid "Install |CL-ATTR| as a VMware\\* ESXi guest OS"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:6
msgid ""
"`VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on "
"top of server hardware. With VMware ESXi, you can create, configure, "
"manage, and run |CL-ATTR| virtual machines in the cloud."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:10
msgid ""
"This section shows you how to create a new :abbr:`VM (Virtual Machine)` "
"and manually install |CL| into it with VMware ESXi 6.5."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:13
msgid ""
"Manually installing |CL| into a new VM provides you some additional "
"configuration flexibility during installation. For example: alternate "
"disk sizes, number of partitions, pre-installed bundles, etc."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:17
msgid ""
"If you would prefer to use a preconfigured |CL| VMware image instead, see"
" :ref:`vmware-esxi-preconfigured-cl-image`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:22
msgid ""
"VMware also offers a type 2 hypervisor called `VMware Workstation "
"Player`_ which is designed for the desktop environment."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:25
msgid "See :ref:`vmw-player-preconf` or see :ref:`vmw-player`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:27
msgid "Visit :ref:`image-types` to learn more about all available images."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:29
msgid "Install steps:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:36
msgid "Download the latest |CL| installer ISO"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:38
msgid ""
"Get the latest |CL| installer ISO image from the `image`_ repository. "
"Look for :file:`clear-[version number]-installer.iso.xz`."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:4
msgid "Decompress the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:6
msgid ""
"Released |CL| images are compressed with either GNU zip (*.gz*) or XZ "
"(*.xz*). The compression type depends on the target platform or "
"environment. To decompress the image, follow these steps:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:10
msgid "Start a terminal emulator."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:11
msgid "Go to the directory with the downloaded image."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:13
msgid "To decompress an XZ image, enter:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:19
msgid "To decompress a GZ image, enter:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:45
msgid "For alternative instructions on other operating systems, see:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:47
msgid ":ref:`download-verify-decompress-mac`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:48
msgid ":ref:`download-verify-decompress-windows`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:51
msgid "Upload the |CL| installer ISO to the VMware server"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:53
msgid ""
"Connect to the VMware server and log into an account with sufficient "
"permission to create and manage VMs."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:55
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Storage`. See "
"Figure 1."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:57
msgid ""
"Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore "
"browser` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:64
msgid "Figure 1: VMware ESXi - Navigator > Storage"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:66
msgid ""
"Click the :guilabel:`Create directory` button and name the directory "
"`ISOs`. See Figure 2."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:73
msgid "Figure 2: VMware ESXi - Datastore > Create directory"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:75
msgid ""
"Select the newly-created directory and click the :guilabel:`Upload` "
"button. See Figure 3."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:82
msgid "Figure 3: VMware ESXi - Datastore > Upload ISO"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:84
msgid ""
"Select the decompressed |CL| installer ISO file :file:`clear-[version "
"number]-installer.iso` and upload it."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:88
msgid "Create and configure a new VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:90
msgid ""
"In this section, you will create a new VM, configure its basic parameters"
" such as drive size, number of CPUs, memory size, and then attach the "
"|CL| installer ISO."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:93
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 4."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:95
msgid "In the right window, click the :guilabel:`Create / Register VM` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:101
msgid "Figure 4: VMware ESXi - Navigator > Virtual Machines"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:103
msgid "On the :guilabel:`Select creation type` step:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:105
msgid "Select the :guilabel:`Create a new virtual machine` option. See Figure 5."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:107
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:121
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:132
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:185
msgid "Click the :guilabel:`Next` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:113
msgid "Figure 5: VMware ESXi - Create a new virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:115
msgid "On the :guilabel:`Select a name and guest OS` step:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:117
msgid "Give the new VM a name in the :guilabel:`Name` field. See Figure 6."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:118
msgid ""
"Set the :guilabel:`Compatability` option to :guilabel:`ESXi 6.5 virtual "
"machine`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:119
msgid "Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:120
msgid ""
"Set the :guilabel:`Guest OS version` option to :guilabel:`Other 3.x or "
"later Linux (64-bit)`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:127
msgid "Figure 6: VMware ESXi - Give a name and select guest OS type"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:129
msgid "On the :guilabel:`Select storage` step:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:131
msgid "Accept the default option."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:134
msgid "On the :guilabel:`Customize settings` step:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:136
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 7."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:137
msgid ""
"Expand the :guilabel:`CPU` setting and enable :guilabel:`Hardware "
"virtualization` by checking :guilabel:`Expose hardware assisted "
"virtualization to the guest OS`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:144
msgid "Figure 7: VMware ESXi - Enable hardware virtualization"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:146
msgid "Set :guilabel:`Memory` size to 2048MB (2GB). See Figure 8."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:152
msgid "Figure 8: VMware ESXi - Set memory size"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:156
msgid ""
"The |CL| installer ISO needs a minimum of 2GB of RAM to work properly. "
"You can reduce the memory size after the installation completes if you "
"want, because a minimum |CL| installation can function on as little as "
"128MB of RAM. See :ref:`system-requirements` for more details."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:161
msgid "Set :guilabel:`Hard disk 1` to the desired capacity. See Figure 9."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:167
msgid "Figure 9: VMware ESXi - Set hard disk size"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:171
msgid ""
"A minimum |CL| installation can exist on 600MB of drive space. See :ref"
":`system-requirements` for more details."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:174
msgid ""
"Attach the |CL| installer ISO. For the :guilabel:`CD/DVD Drive 1` "
"setting, click the drop-down list to the right of it and select the "
":guilabel:`Datastore ISO file` option. Then select the |CL| installer "
"ISO :file:`clear-[version number]-installer.iso` that you previously "
"uploaded to the VMware server. See Figure 10."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:183
msgid "Figure 10: VMware ESXi - Set CD/DVD to boot installer ISO"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:186
msgid "Click the :guilabel:`Finish` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:189
msgid "Install |CL| into the new VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:191
msgid "Power on the VM."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:193
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 11."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:195
msgid "In the right window, select the newly-created VM."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:196
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:276
msgid "Click the :guilabel:`Power on` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:197
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:277
msgid ""
"Click on the icon representing the VM to bring it into view and maximize "
"its window."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:204
msgid "Figure 11: VMware ESXi - Navigator > Virtual Machines > Power on VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:206
msgid ""
"Follow the :ref:`install-on-target-start` guide to complete the "
"installation of |CL|."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:208
msgid ""
"After the installation is complete, follow the |CL| instruction to reboot"
" it. This will restart the installer again."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:212
msgid "Reconfigure the VM's settings to boot the newly-installed |CL|"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:214
msgid ""
"After |CL| has been installed using the installer ISO, it must be "
"detached so it will not run again. Also, in order to boot the newly-"
"installed |CL|, you must enable UEFI support."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:218
msgid "Power off the VM."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:220
msgid ""
"Click the :guilabel:`Actions` button - located on the top-right corner of"
" the VM's windows - and go to the :guilabel:`Power` setting and select "
"the :guilabel:`Power off` option. See Figure 12."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:228
msgid "Figure 12: VMware ESXi - Actions > Power off"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:230
msgid "Edit the VM settings."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:232
msgid ""
"Click the :guilabel:`Actions` button again and select :guilabel:`Edit "
"settings`. See Figure 13."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:239
msgid "Figure 13: VMware ESXi - Actions > Edit settings"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:241
msgid ""
"Disconnect the CD/DVD to stop it from booting the |CL| installer ISO "
"again."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:243
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 14."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:244
msgid ""
"For the :guilabel:`CD/DVD Drive 1` setting, uncheck the "
":guilabel:`Connect` checkbox."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:251
msgid "Figure 14: VMware ESXi - Disconnect the CD/DVD drive"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:253
msgid "|CL| needs UEFI support in order to boot. Enable it."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:255
msgid "Click the :guilabel:`VM Options` button. See Figure 15."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:256
msgid "Expand the :guilabel:`Boot Options` setting."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:257
msgid ""
"For the :guilabel:`Firmware` setting, click the drop-down list to the "
"right of it and select the :guilabel:`EFI` option."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:264
msgid "Figure 15: VMware ESXi - Set boot firmware to EFI"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:266
msgid "Click the :guilabel:`Save` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:269
msgid "Power on the VM and boot |CL|"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:271
msgid "After configuring the settings above, power on the VM."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:273
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 16."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:275
msgid "In the right window, select the VM."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:284
msgid "Figure 16: VMware ESXi - Navigator > Virtual Machines > Power on VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:287
msgid "Related topics"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:289
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
msgstr ""
@@ -0,0 +1,466 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:4
msgid "Run preconfigured |CL-ATTR| image as a VMware\\* ESXi guest OS"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:6
msgid ""
"`VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on "
"top of server hardware. With VMware ESXi, you can create, configure, "
"manage, and run |CL-ATTR| virtual machines at scale."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:10
msgid ""
"This section shows you how to deploy a preconfigured |CL| VMware "
":abbr:`VM (Virtual Machine)` image on a VMware ESXi 6.5 host."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:13
msgid ""
"If you would prefer to perform a manual installation of |CL| into a new "
"VMware ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-"
"install-cl`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:19
msgid ""
"VMware also offers a type 2 hypervisor called `VMware Workstation Player`"
" which is designed for the desktop environment."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:22
msgid "See :ref:`vmw-player-preconf` or see :ref:`vmw-player`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:25
msgid "Install steps:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:31
msgid "Download the latest |CL| VMware image"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:33
msgid ""
"Get the latest |CL| VMware prebuilt image from the `image`_ repository. "
"Look for :file:`clear-[version number]-vmware.vmdk.xz`. You can also use "
"this command:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:41
msgid ""
"Visit :ref:`image-types` for additional information about all available "
"|CL| images."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:4
msgid "Decompress the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:6
msgid ""
"Released |CL| images are compressed with either GNU zip (*.gz*) or XZ "
"(*.xz*). The compression type depends on the target platform or "
"environment. To decompress the image, follow these steps:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:10
msgid "Start a terminal emulator."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:11
msgid "Go to the directory with the downloaded image."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:13
msgid "To decompress an XZ image, enter:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:19
msgid "To decompress a GZ image, enter:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:47
msgid "For alternative instructions on other operating systems, see:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:49
msgid ":ref:`download-verify-decompress-mac`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:50
msgid ":ref:`download-verify-decompress-windows`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:53
msgid "Upload the |CL| image to the VMware server"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:55
msgid ""
"Once the |CL| VMware prebuilt image has been downloaded and decompressed "
"on your local system, it must be uploaded to a datastore on the VMware "
"ESXi server."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:59
msgid ""
"The steps in this section can also be referenced from the `VMware "
"documentation on Using the Datastore File Browser`_"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:61
msgid ""
"Connect to the VMware ESXi server and login to an account with sufficient"
" permission to create and manage VMs."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:64
msgid ""
"Under the :guilabel:`Navigator` window on the left side, select "
":guilabel:`Storage`. See Figure 1"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:68
msgid ""
"Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore "
"browser` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:75
msgid "Figure 1: VMware ESXi - Navigator > Storage"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:77
msgid ""
"Click the :guilabel:`Create directory` button and name the directory "
"`Clear Linux VM`. See Figure 2."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:84
msgid "Figure 2: VMware ESXi - Datastore > Create directory"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:86
msgid ""
"Select the newly-created directory and click the :guilabel:`Upload` "
"button. See Figure 3."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:93
msgid "Figure 3: VMware ESXi - Datastore > Upload VMware image"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:95
msgid ""
"Select the decompressed |CL| VMware image file :file:`clear-[version "
"number]-vmware.vmdk` and upload it."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:99
msgid "Convert the |CL| image to an ESXi-supported format"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:101
msgid ""
"Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi "
"datastore, it must be converted to a format for usable with VMware's ESXi"
" hypervisor."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:105
msgid ""
"The steps in this section can also be referenced from the `VMware "
"documentation on Cloning and converting virtual machine disks with "
"vmkfstools`_"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:107
msgid ""
"SSH into the `vSphere Management Assistant`_ appliance that is managing "
"the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:112
msgid ""
"If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or "
":abbr:`vCLI (vSphere CLI)` configured and available, you can temporarily "
"enable SSH directly on the ESXi host by referencing the `VMware "
"documentation on Enable the Secure Shell (SSH)`_ ."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:116
msgid ""
"As a security best practice, remember to disable SSH access after "
"following the steps in this section."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:119
msgid ""
"Locate the uploaded image, which is typically found in "
":file:`/vmfs/volumes/datastore1`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:122
msgid ""
"Use the :command:`vmkfstools` command to perform the conversion, as shown"
" below:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:129
msgid "Two files should result from this:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:131
msgid ":file:`clear-[version number]-esxi-flat.vmdk`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:132
msgid ":file:`clear-[version number]-esxi.vmdk`"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:134
msgid ""
"The :file:`clear-[version number]-esxi.vmdk` file will be used in the "
"next section when you create a new VM."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:138
msgid "Create and configure a new VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:140
msgid ""
"In this section, you will create a new VM, configure its basic parameters"
" such as number of CPUs, memory size, and then attach the converted |CL| "
"VMware image. Also, in order to boot |CL|, you must enable UEFI support."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:144
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 4."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:147
msgid "In the right window, click the :guilabel:`Create / Register VM` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:153
msgid "Figure 4: VMware ESXi - Navigator > Virtual Machines"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:155
msgid "On the :guilabel:`Select creation type` step:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:157
msgid "Select the :guilabel:`Create a new virtual machine` option. See Figure 5."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:160
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:177
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:188
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:259
msgid "Click the :guilabel:`Next` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:166
msgid "Figure 5: VMware ESXi - Create a new virtual machine"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:168
msgid "On the :guilabel:`Select a name and guest OS` step:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:170
msgid "Give the new VM a name in the :guilabel:`Name` field. See Figure 6."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:172
msgid ""
"Set the :guilabel:`Compatability` option to :guilabel:`ESXi 6.5 virtual "
"machine`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:174
msgid "Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:175
msgid ""
"Set the :guilabel:`Guest OS version` option to :guilabel:`Other 3.x or "
"later Linux (64-bit)`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:183
msgid "Figure 6: VMware ESXi - Give a name and select guest OS type"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:185
msgid "On the :guilabel:`Select storage` step:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:187
msgid "Accept the default option."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:190
msgid "On the :guilabel:`Customize settings` step:"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:192
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 7."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:193
msgid ""
"Expand the :guilabel:`CPU` setting and enable :guilabel:`Hardware "
"virtualization` by checking :guilabel:`Expose hardware assisted "
"virtualization to the guest OS`."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:201
msgid "Figure 7: VMware ESXi - Enable hardware virtualization"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:203
msgid ""
"Remove the default :guilabel:`Hard drive 1` setting by clicking the `X` "
"icon on the right side. See Figure 8."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:210
msgid "Figure 8: VMware ESXi - Remove hard drive"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:212
msgid ""
"Since a preconfigured image will be used, the :guilabel:`CD/DVD Drive 1` "
"setting will not be needed. Disable it by unchecking the "
":guilabel:`Connect` checkbox. See Figure 9."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:220
msgid "Figure 9: VMware ESXi - Disconnect the CD/DVD drive"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:222
msgid ""
"Attach the :file:`clear-[version number]-esxi.vmdk` file that was "
"converted from the preconfigured |CL| VMware image."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:225
msgid ""
"Click the :guilabel:`Add hard disk` button and select the "
":guilabel:`Existing hard drive` option. See Figure 10."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:232
msgid "Figure 10: VMware ESXi - Add an existing hard drive"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:234
msgid ""
"Select the converted :file:`clear-[version number]-esxi.vmdk` file. Do "
"not use the original unconverted :file:`clear-[version "
"number]-vmware.vmdk` file. See Figure 11."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:242
msgid ""
"Figure 11: VMware ESXi - Select the converted :file:`clear-[version "
"number]-esxi.vmdk` file"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:245
msgid "|CL| needs UEFI support in order to boot. Enable UEFI boot support."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:247
msgid "Click the :guilabel:`VM Options` button. See Figure 12."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:248
msgid "Expand the :guilabel:`Boot Options` setting."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:249
msgid ""
"For the :guilabel:`Firmware` setting, click the drop-down list to the "
"right of it and select the :guilabel:`EFI` option."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:256
msgid "Figure 12: VMware ESXi - Set boot firmware to EFI"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:258
msgid "Click the :guilabel:`Save` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:260
msgid "Click the :guilabel:`Finish` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:263
msgid "Power on the VM and boot |CL|"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:265
msgid "After configuring the settings above, power on the VM."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:267
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 13."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:269
msgid "In the right window, select the newly-created VM."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:270
msgid "Click the :guilabel:`Power on` button."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:271
msgid ""
"Click on the icon representing the VM to bring it into view and maximize "
"its window."
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:278
msgid "Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:281
msgid "Related topics"
msgstr ""
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:283
msgid ":ref:`vmware-esxi-install-cl`"
msgstr ""
Binary file not shown.
@@ -0,0 +1,414 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/deploy-at-scale.rst:4
msgid "Deploy at Scale"
msgstr ""
#: ../../guides/deploy-at-scale.rst:6
msgid ""
"Once you are comfortable with |CL-ATTR| :ref:`concepts <concepts>`, your "
"next step as a system administrator is to understand how to deploy |CL| "
"at scale in your environment."
msgstr ""
#: ../../guides/deploy-at-scale.rst:10
msgid ""
"In this document the term *endpoint* refers to a system targeted for |CL|"
" installation, whether that is a datacenter system or unit deployed in "
"field."
msgstr ""
#: ../../guides/deploy-at-scale.rst:16
msgid ""
"This is not a replacement or blueprint for designing your own IT "
"operating environment."
msgstr ""
#: ../../guides/deploy-at-scale.rst:19
msgid ""
"Your |CL| deployment should complement the existing environment and "
"available tools. It is assumed foundational core IT dependencies of your "
"environment, such as your network, are healthy and scaled to suit the "
"deployment."
msgstr ""
#: ../../guides/deploy-at-scale.rst:28
msgid "Pick a |CL| usage and update strategy"
msgstr ""
#: ../../guides/deploy-at-scale.rst:30
msgid ""
"Different business scenarios call for different deployment methodologies."
" |CL| offers the flexibility to continue consuming the upstream |CL| "
"distribution or the option to fork away from the |CL| distribution and "
"act as your own :abbr:`OSV (Operating System Vendor)`."
msgstr ""
#: ../../guides/deploy-at-scale.rst:35
msgid "Below is an overview of some considerations."
msgstr ""
#: ../../guides/deploy-at-scale.rst:38
msgid "Create your own Linux distribution (mix)"
msgstr ""
#: ../../guides/deploy-at-scale.rst:40
msgid ""
"This approach forks away from the |CL| upstream and has you act as your "
"own :abbr:`OSV (Operating System Vendor)` by leveraging the `mixer "
"process`_ to create customized images based on |CL|. This is a level of "
"responsibility that requires having more infrastructure and processes to "
"adopt. In return, this approach *offers you a high degree of control and "
"customization*."
msgstr ""
#: ../../guides/deploy-at-scale.rst:46
msgid ""
"Development systems which are generating bundles and updates should be "
"sufficiently performant for the task and separate from the swupd update "
"webservers which are serving update content to production machines."
msgstr ""
#: ../../guides/deploy-at-scale.rst:50
msgid ""
"swupd update webservers which are serving update content to production "
"machines (see `mixer process`_ for more information) should be "
"appropriately scaled."
msgstr ""
#: ../../guides/deploy-at-scale.rst:54
msgid ""
"Your swupd update server is just like any other web application. |WEB-"
"SERVER-SCALE|"
msgstr ""
#: ../../guides/deploy-at-scale.rst:58
msgid "Adopt an agile methodology"
msgstr ""
#: ../../guides/deploy-at-scale.rst:59
msgid ""
"The cloud, and other scaled deployments, are all about flexibility and "
"speed. It only makes sense that any |CL| deployment strategy should "
"follow suit."
msgstr ""
#: ../../guides/deploy-at-scale.rst:62
msgid ""
"Manually rebuilding your own bundles or mix for every release is not "
"sustainable at a large scale. A |CL| deployment pipeline should be agile "
"enough to validate and produce new versions with speed. Whether or not "
"those updates actually make their way to your production can be separate "
"business decision. However this *ability to frequently roll new versions*"
" of software to your endpoints is an important prerequisite."
msgstr ""
#: ../../guides/deploy-at-scale.rst:69
msgid ""
"You own the validation and lifecycle of the OS and should treat it like "
"any other software development lifecycle. Below are some pointers:"
msgstr ""
#: ../../guides/deploy-at-scale.rst:72
msgid ""
"Thoroughly understand the custom software packages that you will need to "
"integrate with |CL| and maintain along with their dependencies."
msgstr ""
#: ../../guides/deploy-at-scale.rst:75
msgid ""
"Setup a path to production for building |CL| based images. At minimum "
"this should include:"
msgstr ""
#: ../../guides/deploy-at-scale.rst:78
msgid ""
"A development clr-on-clr environment to test building packages and "
"bundles for |CL| systems."
msgstr ""
#: ../../guides/deploy-at-scale.rst:81
msgid "A pre-production environment to deploy |CL| versions to before production"
msgstr ""
#: ../../guides/deploy-at-scale.rst:84
msgid ""
"Employ a continuous integration and continuous deployment (CI/CD) "
"philosophy in order to:"
msgstr ""
#: ../../guides/deploy-at-scale.rst:87
msgid ""
"Automatically pull custom packages as they are updated from their "
"upstream projects or vendors."
msgstr ""
#: ../../guides/deploy-at-scale.rst:90
msgid ""
"Generate |CL| bundles and potentially bootable images with your "
"customizations, if any."
msgstr ""
#: ../../guides/deploy-at-scale.rst:93
msgid ""
"Measure against metrics and indicators which are relevant to your "
"business (e.g. performance, power, etc) from release to release."
msgstr ""
#: ../../guides/deploy-at-scale.rst:96
msgid ""
"Integrate with your organization's governance processes, such as change "
"control."
msgstr ""
#: ../../guides/deploy-at-scale.rst:100
msgid "Versioning Infrastructure"
msgstr ""
#: ../../guides/deploy-at-scale.rst:102
msgid ""
"|CL| version numbers are very important as they apply to the whole "
"infrastructure stack from OS components to libraries and applications."
msgstr ""
#: ../../guides/deploy-at-scale.rst:106
msgid ""
"Good record keeping is important, so you should keep a detailed registry "
"and history of previously deployed versions and their contents."
msgstr ""
#: ../../guides/deploy-at-scale.rst:109
msgid ""
"With a glance at the |CL| version numbers deployed, you should be able to"
" tell if your Clear systems are patched against a particular security "
"vulnerability or incorporate a critical new feature."
msgstr ""
#: ../../guides/deploy-at-scale.rst:114
msgid "Pick an image distribution strategy"
msgstr ""
#: ../../guides/deploy-at-scale.rst:116
msgid ""
"Once you have decided on a usage and update strategy, you should "
"understand *how* |CL| will be deployed to your endpoints. In a large "
"scale deployment, interactive installers should be avoided in favor of "
"automated installations or prebuilt images."
msgstr ""
#: ../../guides/deploy-at-scale.rst:121
msgid ""
"There are many well-known ways to install an operating system at scale. "
"Each have their own benefits, and one may lend itself easier in your "
"environment depending on the resources available to you."
msgstr ""
#: ../../guides/deploy-at-scale.rst:125
msgid "See the available :ref:`image-types`."
msgstr ""
#: ../../guides/deploy-at-scale.rst:127
msgid "Below are some common ways to install |CL| to systems at scale:"
msgstr ""
#: ../../guides/deploy-at-scale.rst:130
msgid "Baremetal"
msgstr ""
#: ../../guides/deploy-at-scale.rst:132
msgid ""
"Preboot Execution Environments (PXE) or other out-of-band booting options"
" are one way to distribute |CL| to physical baremetal systems on a LAN."
msgstr ""
#: ../../guides/deploy-at-scale.rst:136
msgid ""
"This option works well if your customizations are fairly small in size "
"and infrastructure can be stateless."
msgstr ""
#: ../../guides/deploy-at-scale.rst:139
msgid ""
"The |CL| `downloads page`_ offers a live image that can be deployed as a "
"PXE boot server if one doesn't already exist in your environment. Also "
"see documentation on how to :ref:`bare-metal-install-server`."
msgstr ""
#: ../../guides/deploy-at-scale.rst:144
msgid "Cloud Instances or Virtual Machines"
msgstr ""
#: ../../guides/deploy-at-scale.rst:146
msgid ""
"Image templates in the form of cloneable disks are an effective way to "
"distribute |CL| for virtual machine environments, whether on-premises or "
"hosted by a Cloud Solution Provider (CSP)."
msgstr ""
#: ../../guides/deploy-at-scale.rst:150
msgid ""
"When used in concert with cloud VM migration features, this can be a good"
" option for allowing your applications a degree of high availability and "
"workload mobility; VMs can be restarted on a cluster of hypervisor host "
"or moved between datacenters transparently."
msgstr ""
#: ../../guides/deploy-at-scale.rst:155
msgid ""
"The |CL| `downloads page`_ offers example prebuilt VM images and is "
"readily available on popular CSPs. Also see documentation on how to :ref"
":`virtual-machine-install`."
msgstr ""
#: ../../guides/deploy-at-scale.rst:160
msgid "Containers"
msgstr ""
#: ../../guides/deploy-at-scale.rst:162
msgid ""
"Containerization platforms allow images to be pulled from a repository "
"and deployed repeatedly as isolated containers."
msgstr ""
#: ../../guides/deploy-at-scale.rst:165
msgid ""
"Containers with a |CL| image can be a good option to blueprint and ship "
"your application, including all its dependencies, as an artifact while "
"allowing you or your customers to dynamically orchestrate and scale "
"applications."
msgstr ""
#: ../../guides/deploy-at-scale.rst:170
msgid ""
"|CL| is capable of running a Docker host, has a container image which can"
" be pulled from DockerHub, or can be built as a customized container. For"
" more information visit the `containers page`_."
msgstr ""
#: ../../guides/deploy-at-scale.rst:175
msgid "Considerations with stateless systems"
msgstr ""
#: ../../guides/deploy-at-scale.rst:176
msgid ""
"An important |CL| concept is statelessness and partitioning of system "
"data from user data. This concept can change the way you think about an "
"at scale deployment."
msgstr ""
#: ../../guides/deploy-at-scale.rst:181
msgid "Backup strategy"
msgstr ""
#: ../../guides/deploy-at-scale.rst:183
msgid ""
"A |CL| system and its infrastructure should be considered a commodity and"
" be easily reproducible. Avoid focusing on backing up the operating "
"system itself or default values."
msgstr ""
#: ../../guides/deploy-at-scale.rst:187
msgid ""
"Instead, focus on backing up what's important and unique - the "
"application and data. In other words, only focus on backing up critical "
"areas like `/home`, `/etc`, and `/var`."
msgstr ""
#: ../../guides/deploy-at-scale.rst:192
msgid "Meaningful Logging & Telemetry"
msgstr ""
#: ../../guides/deploy-at-scale.rst:194
msgid ""
"Offload logging and telemetry from endpoints to external servers, so it "
"is persistent and can be accessed on another server when an issue occurs."
msgstr ""
#: ../../guides/deploy-at-scale.rst:197
msgid ""
"Remote syslogging in |CL| is available through the `systemd journal-"
"remote service`_"
msgstr ""
#: ../../guides/deploy-at-scale.rst:200
msgid ""
"|CL| offers a `native telemetry solution`_ which can be a powerful tool "
"for a large deployment to quickly crowdsource issues of interest. Take "
"advantage of this feature with careful consideration of the target "
"audience and the kind of data that would be valuable, and expose events "
"appropriately."
msgstr ""
#: ../../guides/deploy-at-scale.rst:206
msgid ""
"Your telemetry server is just like any other web application. |WEB-"
"SERVER-SCALE|"
msgstr ""
#: ../../guides/deploy-at-scale.rst:210
msgid "Orchestration and Configuration Management"
msgstr ""
#: ../../guides/deploy-at-scale.rst:212
msgid ""
"In cloud environments, where systems can be ephemeral, being able to "
"configure and maintain generic instances is valuable."
msgstr ""
#: ../../guides/deploy-at-scale.rst:215
msgid ""
"|CL| offers an efficient cloud-init style solution, `micro-config-"
"drive`_, through the *os-cloudguest* bundles which allow you to configure"
" many Day 1 tasks such as setting hostname, creating users, or placing "
"SSH keys in an automated way at boot. For more information on automating "
"configuration during deployment of |CL| endpoints see the `documentation "
"on bulk provisioning`_ ."
msgstr ""
#: ../../guides/deploy-at-scale.rst:222
msgid ""
"A configuration management tool is useful for maintaining consistent "
"system and application-level configuration. Ansible\\* is offered through"
" the *sysadmin-hostmgmt* bundle as a configuration management and "
"automation tool."
msgstr ""
#: ../../guides/deploy-at-scale.rst:228
msgid "Cloud-native applications"
msgstr ""
#: ../../guides/deploy-at-scale.rst:230
msgid ""
"An Infrastructure OS can design for good behavior, but it is ultimately "
"up to applications to make agile design choices. Applications deployed on"
" |CL| should aim to be host-aware but not depend on any specific host to "
"run. References should be relative and dynamic when possible."
msgstr ""
#: ../../guides/deploy-at-scale.rst:235
msgid ""
"The application architecture should incorporate an appropriate tolerance "
"for infrastructure outages. Don't just keep stateless design as a noted "
"feature. Continuously test its use; Automate its use by redeploying |CL| "
"and application on new hosts. This naturally minimizes configuration "
"drift, challenges your monitoring systems, and business continuity plans."
msgstr ""
Binary file not shown.
+44
View File
@@ -0,0 +1,44 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/guides.rst:4
msgid "Guides"
msgstr ""
#: ../../guides/guides.rst:6
msgid "The following guides provide step-by-step instructions on using |CL|."
msgstr ""
#: ../../guides/guides.rst:10
msgid "As of 22 May 2019 :file:`mixin` is no longer supported."
msgstr ""
#: ../../guides/guides.rst:13
msgid "Maintenance"
msgstr ""
#: ../../guides/guides.rst:23
msgid "Network"
msgstr ""
#: ../../guides/guides.rst:33
msgid "Kernel"
msgstr ""
@@ -0,0 +1,539 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/kernel/kernel-development.rst:4
msgid "Kernel development"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:6
msgid ""
"This document shows how to obtain and compile a Linux* kernel source "
"using |CL-ATTR| development tooling."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:9
msgid ""
"The `kernels available`_ in |CL| aim to be performant and practical. In "
"some cases, it may be necessary to modify the kernel to suit your "
"specific needs or test new kernel code as a developer."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:18
msgid ""
"Source RPM files (SRPM) are also available for all |CL| kernels, and can "
"be used for development instead. Select this link to view the latest "
"`source RPM files`_."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:22
msgid "Request changes be included with the |CL| kernel"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:24
msgid ""
"If the kernel modification you need is already open source and likely to "
"be useful to others, consider submitting a request to include it in the "
"|CL| kernels.If your change request is accepted, you do not need to "
"maintain your own modified kernel."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:28
msgid "Make enhancement requests to the |CL| `distribution on GitHub`_ ."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:31
msgid "Set up kernel development environment"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:33
msgid ""
"In some cases, it may be necessary to modify the kernel to suit your "
"specific needs or to test new kernel code."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:36
msgid "You can build and install a custom kernel; however you must:"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:38
msgid "Disable Secure Boot"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:39
msgid "Maintain any updates to the kernel going forward"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:41
msgid ""
"To create a custom kernel, start with the |CL| development environment. "
"Then make changes to the kernel, build it, and install it."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:46
msgid "Install the |CL| development tooling framework"
msgstr ""
#: ../../tooling/autospec.rst:3
msgid ""
"Setup of the workspace and tooling used for building source in |CL| is "
"mostly automated for you with a setup script. It uses tools from the "
":command:`os-clr-on-clr` bundle."
msgstr ""
#: ../../tooling/autospec.rst:7
msgid ""
"The setup script creates a workspace in the :file:`clearlinux` folder, "
"with the subfolders :file:`Makefile`, :file:`packages`, and "
":file:`projects`. The :file:`projects` folder contains the main tools "
"used for making packages in |CL| :file:`autospec` and :file:`common`."
msgstr ""
#: ../../tooling/autospec.rst:12
msgid "Follow these steps to setup the workspace and tooling for building source:"
msgstr ""
#: ../../tooling/autospec.rst:14
msgid "Install the :command:`os-clr-on-clr` bundle:"
msgstr ""
#: ../../tooling/autospec.rst:20
msgid "Download the :file:`user-setup.sh` script:"
msgstr ""
#: ../../tooling/autospec.rst:26
msgid "Make :file:`user-setup.sh` executable:"
msgstr ""
#: ../../tooling/autospec.rst:32
msgid "Run the script as an unprivileged user:"
msgstr ""
#: ../../tooling/autospec.rst:38
msgid ""
"After the script completes, log out and log in again to complete the "
"setup process."
msgstr ""
#: ../../tooling/autospec.rst:41
msgid "Set your Git user email and username for the repos on your system:"
msgstr ""
#: ../../tooling/autospec.rst:48
msgid "This global setting is used by |CL| tools that make use of Git."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:53
msgid "Clone the kernel package"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:54
msgid ""
"Clone the existing kernel package repository from |CL| as a starting "
"point."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:56
msgid ""
"Clone the Linux kernel package from |CL|. Using the :command:`make "
"clone_<PACKAGENAME>` command in the :file:`clearlinux/` directory clones "
"the package from the `clearlinux-pkgs GitHub`_."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:66
msgid "Navigate into the cloned package directory."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:73
msgid ""
"The \"linux\" package is the kernel that comes with |CL| in the `kernel-"
"native` bundle. Alternatively, you can use a different kernel variant as "
"the base for modification. For a list of kernel package names which you "
"can clone instead, see the `clearlinux-pkgs GitHub`_."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:80
msgid ""
"The latest version of the |CL| kernel package is pulled as a starting "
"point. An older version can pulled by switching to different git tag by "
"using :command:`git checkout tag/<TAG_NAME>`."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:84
msgid "Change the kernel version"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:86
msgid ""
"|CL| tends to use the latest kernel available from `kernel.org`_, the "
"Linux upstream. The kernel version that will be built can be changed in "
"the RPM SPEC file. While most packages in Clear Linux are typically "
"packaged using :ref:`autospec-about`, the kernel is not. This means "
"control files provided by autospec are not available and changes must be "
"made manually."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:92
#: ../../guides/kernel/kernel-development.rst:285
msgid "Open the Linux kernel package RPM SPEC file in an editor."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:98
msgid ""
"Modify the Version, Release, and Source0 URL entries at the top of the "
"file to change the version of Linux kernel that will be compiled."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:101
msgid ""
"A list of current and available kernel release can be found on "
"`kernel.org`_."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:120
msgid ""
"Consider changing the Name from *linux* in the RPM spec file to easily "
"identify a modified kernel."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:122
msgid ""
"Consider changing the ktarget from *native* in the RPM spec file to "
"easily identify a modified kernel."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:124
msgid "Commit and save the changes to the file."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:127
msgid "Pull a copy of the Linux kernel source code"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:129
msgid "Obtain a local copy of the source code to make modifications against."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:131
msgid ""
"Run make sources to pull the kernel source code specified in the RPM SPEC"
" file. In the example, it downloads the :file:`linux-4.20.8.tar.xz` file."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:139
msgid ""
"Extract the kernel source code archive. This will create a working copy "
"of the Linux source that you can modify."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:146
msgid ""
"Navigate to the extracted directory. In this example, it has been "
"extracted into a :file:`linux-4.20.8` directory."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:155
msgid "Customize the Linux kernel source"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:157
msgid ""
"After the kernel sources have been obtained, customizations to the kernel"
" configuration or source code can be made for inclusion with the kernel "
"build. These customizations are optional."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:162
msgid "Modify kernel configuration"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:164
msgid ""
"The kernel source has many configuration options available to pick "
"support for different hardware and software features."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:166
msgid ""
"These configuration values must be provided in the :file:`.config` file "
"at compile time. You will need to make modifications to the "
":file:`.config` file, and include it in the kernel package."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:171
#: ../../guides/kernel/kernel-development.rst:228
msgid ""
"Make sure you have followed the steps to `Pull a copy of the Linux kernel"
" source code`_ and are in the kernel source working directory."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:176
msgid ""
"If you have an existing :file:`.config` file from an old kernel, copy it "
"into the working directory as :file:`.config` for comparison. Otherwise, "
"use the |CL| kernel configuration file as template"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:185
msgid ""
"Make any desired changes to the :file:`.config` using a kernel "
"configuration tool. Below are some popular options:"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:188
msgid ""
":command:`$EDITOR .config` - the .config file can be directly edited for "
"simple changes with names that are already known."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:191
msgid ""
":command:`make config` - a text-based tool that asks questions one-by-one"
" to decide configuration options."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:194
msgid ""
":command:`make menuconfig` - a terminal user interface that provides "
"menus to decide configuration options."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:197
msgid ""
":command:`make xconfig` - a graphical user interface that provides tree "
"views to decide configuration options."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:201
msgid ""
"More configuration tools can be found by looking at the make help: "
":command:`make help | grep config`"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:204
msgid "Commit and save the changes to the :file:`.config` file."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:206
msgid ""
"Copy the :file:`.config` file from the kernel source directory into the "
"kernel package directory as :file:`config` for inclusion in the build."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:214
msgid "Modify kernel source code"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:216
msgid ""
"Changes to kernel code are applied with patch files. Patch files are "
"formatted git commits that can be applied to the main source code."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:219
msgid ""
"You will need to obtain a copy of the source code, make modifications, "
"generate patch file(s), and add them to the RPM SPEC file for inclusion "
"during the kernel build."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:223
msgid ""
"If you have a large number of patches or a more complex workflow, "
"consider using a patch management tool in addition to Git such as "
"`Quilt`_."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:233
msgid ""
"Initialize the kernel source directory as a new git repo and create a "
"commit with all the existing source files to begin tracking changes."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:243
msgid ""
"Apply patches provided by the |CL| kernel package to the kernel source in"
" the working directory."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:251
msgid "Make any of your desired code changes to the Linux source code files."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:254
msgid "Track and commit your changes to the local git repo."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:262
msgid ""
"Generate a patch file based on your git commits. <n> represents the "
"number of local commits to create patch file. See the `git-format-patch "
"Documentation`_ for detailed information on using :command:`git format-"
"patch`"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:271
msgid ""
"Copy the patch files from the patches directory in the linux source tree "
"to the RPM build directory."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:279
msgid "Navigate back to the RPM build directory."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:291
msgid ""
"Locate the section of the SPEC file that contains existing patch variable"
" definitions and append your patch file name. Ensure the patch number "
"does not collide with an existing patch. In this example, the patch file "
"is called :file:`2001-my-patch-for-driver-A.patch`"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:314
msgid ""
"Locate the section of the SPEC file further down that contains patch "
"application and append your patch file number used in the step above. In "
"this example, patch2001 is added."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:333
msgid "Commit and save the changes to the RPM SPEC file."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:336
msgid "Modify kernel boot parameters"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:337
msgid ""
"The kernel boot options are passed from the bootloader to the kernel with"
" command-line parameters."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:340
msgid ""
"While temporary changes can be made to kernel parameters on a running "
"system or on a during boot, you can also modify the default parameters "
"that are persistent and distributed with a customized kernel."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:345
msgid "Open the kernel :file:`cmdline` file in an editor."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:352
msgid ""
"Make any desired change to the kernel parameters. For example, you can "
"remove the :command:`quiet` parameter to see more verbose output of "
"kernel log messages during the boot process."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:356
msgid "Commit and save the changes to the :file:`cmdline` file."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:358
msgid ""
"See the `Kernel parameters documentation`_ for a list of available "
"parameters."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:362
msgid "Build and install the kernel"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:363
msgid ""
"After changes have been made to the kernel source and RPM SPEC file, the "
"kernel is ready to be compiled and packaged into an RPM."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:366
msgid ""
"The |CL| development tooling makes use of :command:`mock` environments to"
" isolate building of packages in a sanitized workspace."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:369
msgid ""
"Start the compilation process by issuing the :command:`make build` "
"command. This process is typically resource intensive and will take a "
"while."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:377
msgid ""
"The `ccache plugin for mock`_ can be enabled to help speed up any future "
"rebuilds of the kernel package by caching compiler outputs and reusing "
"them."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:380
msgid ""
"The result will be multiple :file:`.rpm` files in the :file:`rpms` "
"directory as output."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:387
msgid ""
"The kernel RPM will be named "
":file:`linux<NAME>-<VERSION>-<RELEASE>.x86_64.rpm`"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:391
msgid ""
"The kernel RPM file can be input to the :ref:`mixer` to create a custom "
"bundle and mix of |CL|."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:394
msgid ""
"Alternatively, the kernel RPM bundle can be installed manually on a local"
" machine for testing. This approach works well for individual development"
" or testing. For a more scalable and customizable approach, consider "
"using the :ref:`mixer` to provide a custom kernel with updates."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:399
msgid ""
"Install the kernel onto the local system by extracting the RPM with the "
":command:`rpm2cpio` command."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:407
msgid "Update the |CL| boot manager using :command:`clr-boot-manager` and reboot."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:417
msgid "After a reboot, verify the customized kernel is running."
msgstr ""
#: ../../guides/kernel/kernel-development.rst:424
msgid "Related topics"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:426
msgid ":ref:`kernel-modules`"
msgstr ""
#: ../../guides/kernel/kernel-development.rst:427
msgid ":ref:`mixer`"
msgstr ""
@@ -0,0 +1,483 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/kernel/kernel-modules-dkms.rst:4
msgid "Add kernel modules with DKMS"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:6
msgid ""
"Certain kernel modules are enabled by default in |CL-ATTR|. To use "
"additional kernel modules that are not part of the Linux source tree, you"
" may need to build out-of-tree kernel modules. Use this guide to add "
"kernel modules with :abbr:`DKMS (Dynamic Kernel Module System)` or refer "
"to :ref:`kernel-modules`."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:18
msgid "Description"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:20
msgid ""
"Kernel modules are additional pieces of software capable of being "
"inserted into the Linux kernel to add functionality, such as a hardware "
"driver. Kernel modules may already be part of the Linux source tree (in-"
"tree) or may come from an external source, such as directly from a vendor"
" (out-of-tree)."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:25
msgid ""
":abbr:`DKMS (Dynamic Kernel Module System)` is a framework that "
"facilitates the building and installation of kernel modules. DKMS allows "
"|CL| to provide hooks that automatically rebuild modules against new "
"kernel versions."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:4
msgid "Kernel module availability"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:6
msgid ""
"|CL| comes with many upstream kernel modules available for use. Using an "
"existing module is significantly easier to maintain and retains signature"
" verification of the |CL| kernel. For more information on |CL| security "
"practices, see the :ref:`security` page."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:11
msgid ""
"Before continuing, check if the kernel module you're looking for is "
"already available in |CL| or submit a request to add the module."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:16
msgid "Check if the module is already available"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:19
msgid ""
"You can search for kernel module file names, which end with the "
":file:`.ko` file extension, using the :command:`swupd search` command, as"
" shown in the following example. See :ref:`swupd-guide` for more "
"information."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:29
msgid "Submit a request to add the module"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:31
msgid ""
"If the kernel module you need is already open source (for example, in the"
" Linux upstream) and likely to be useful to others, consider submitting a"
" request to add or enable it in the |CL| kernel."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:35
msgid "Make enhancement requests to the |CL| distribution `on GitHub`_."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:39
msgid "Install DKMS"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:43
msgid ""
"The *kernel-native-dkms* bundle provides the :command:`dkms` program and "
"Linux kernel headers, which are required for compiling kernel modules."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:46
msgid "The *kernel-native-dkms* bundle also:"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:48
msgid ""
"Adds a systemd update trigger (:file:`/usr/lib/systemd/system/dkms-new-"
"kernel.service`) to automatically run DKMS to rebuild modules after a "
"kernel upgrade occurs with :ref:`swupd update <swupd-guide>`."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:53
msgid ""
"Disables kernel module signature verification by appending a kernel "
"command-line parameter (:command:`module.sig_unenforce`) from the "
":file:`/usr/share/kernel/cmdline.d/clr-ignore-mod-sig.conf` file."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:57
msgid ""
"Adds a notification to the Message of the Day (MOTD) indicating kernel "
"module signature verification is disabled."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:62
msgid ""
"We recommend that you always review the :command:`swupd update` output to"
" make sure kernel modules were successfully rebuilt against the new "
"kernel. This is especially important for systems where a successful boot "
"relies on a kernel module."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:68
msgid ""
"Install the :command:`kernel-native-dkms` or :command:`kernel-lts-dkms` "
"bundle:"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:71
msgid ""
"Determine which kernel variant is running on |CL|. Only the *native* and "
"*lts* kernels are enabled to build and load out-of-tree kernel modules "
"with DKMS."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:80
msgid "Ensure *.native* or *.lts* is in the kernel name."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:82
msgid ""
"Install the DKMS bundle corresponding to the installed kernel. Use "
":command:`kernel-native-dkms` for the native kernel or :command:`kernel-"
"lts-dkms` for the lts kernel."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:90
msgid "or"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:97
msgid "Update the |CL| bootloader and reboot."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:108
msgid "Build, install, and load an out-of-tree module"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:110
msgid ""
"Follow the steps in this section if you are an individual user or "
"testing, and you need an out-of-tree kernel module that is not available "
"through |CL|. For a more scalable and customizable approach, we recommend"
" using the `mixer tool`_ to provide a custom kernel and updates."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:117
msgid "Prerequisites"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:119
msgid "Before you begin, you must:"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:121
msgid ""
"Disable Secure Boot in UEFI/BIOS. The loading of new out-of-tree modules "
"modifies the signatures that Secure Boot relies on for trust."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:124
msgid ""
"Obtain a kernel module package in the form of source code and/or "
"precompiled binaries."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:130
msgid "Obtain kernel module source"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:132
msgid ""
"A required :file:`dkms.conf` file inside of the kernel module's source "
"code directory informs DKMS how the kernel module should be compiled."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:135
msgid "Kernel modules may come packaged as:"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:137
msgid "Source code without a :file:`dkms.conf` file"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:138
msgid "Source code with a premade :file:`dkms.conf` file"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:139
msgid ""
"Source code with a premade :file:`dkms.conf` file and precompiled module "
"binaries"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:141
msgid "Precompiled module binaries only (without source code)"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:143
msgid ""
"Of the package types listed above, only precompiled kernel module "
"binaries will not work, because |CL| requires kernel modules to be built "
"against the same kernel source tree before they can be loaded. If you are"
" only able to obtain source code without a :file:`dkms.conf` file, you "
"must manually create a :file:`dkms.conf` file, described later in this "
"document."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:149
msgid "Download the kernel module's source code."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:151
msgid ""
"Review the available download options. Some kernel modules provide "
"separate archives that are specifically enabled for DKMS support."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:154
msgid ""
"Review the README documentation, because it often provides required "
"information to build the module with DKMS support."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:166
msgid "Build kernel module with an existing dkms.conf"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:168
msgid ""
"If the kernel module maintainer packaged the source archive with the "
":command:`dkms mktarball` command, the entire archive can be passed to "
"the :command:`dkms ldtarball` which completes many steps for you."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:172
msgid ""
"The archive contains the required :file:`dkms.conf` file, and may contain"
" a :file:`dkms_source_tree` directory and a :file:`dkms_binaries_only` "
"directory."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:177
msgid ""
"Run the :command:`dkms ldtarball` command against the kernel module "
"archive."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:184
msgid ""
":command:`dkms ldtarball` places the kernel module source under "
":file:`/usr/src/<MODULE-NAME>-<MODULE-VERSION>/`, builds it if necessary,"
" and adds the module into the DKMS tree."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:189
msgid ""
"Verify the kernel module is detected by checking the output of the "
":command:`dkms status` command."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:197
msgid "Install the kernel module."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:206
msgid "Build kernel module without an existing dkms.conf"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:208
msgid ""
"If the kernel module source does not contain a :file:`dkms.conf` file or "
"the :command:`dkms ldtarball` command encounters errors, you must "
"manually create the file."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:212
msgid ""
"Review the kernel module README documentation for guidance on what needs "
"to be in the :file:`dkms.conf` file, including special variables that may"
" be required to build successfully."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:216
msgid "Here are some additional resources that can be used for reference:"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:218
msgid ""
"DKMS manual page (:command:`man dkms`) shows detailed syntax in the "
"DKMS.CONF section."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:221
msgid ""
"`Ubuntu community wiki`_ shows an example where a single package contains"
" multiple modules."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:224
msgid "`Sample dkms.conf file`_ in the GitHub\\* repository for the DKMS project."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:228
msgid ""
":command:`AUTOINSTALL=yes` must be set in the dkms.conf for the module to"
" be automatically recompiled with |CL| updates."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:231
msgid "The instructions below show a generic example:"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:233
msgid ""
"Create or modify the :file:`dkms.conf` file inside of the extracted "
"source code directory."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:249
msgid ""
"This example identifies a kernel module named *custom_module* with "
"version *1.0*."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:252
msgid "Copy the kernel module source code into the :file:`/usr/src/` directory."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:261
msgid ""
"*<PACKAGE_NAME>* and *<PACKAGE_VERSION>* must match the entries in the "
":file:`dkms.conf` file."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:265
msgid "Add the kernel module to the DKMS tree so that it is tracked by DKMS."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:271
msgid ""
"Build the kernel module using DKMS. If the build encounters errors, you "
"may need to edit the :file:`dkms.conf` file."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:278
msgid "Install the kernel module using DKMS."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:287
msgid "Load kernel module"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:289
msgid ""
"By default, DKMS installs modules \"in-tree\" under :file:`/lib/modules` "
"so the :command:`modprobe` command can be used to load them."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:292
msgid "Load the installed module with the :command:`modprobe` command."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:298
msgid "Validate the kernel module is loaded."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:306
msgid "Examples"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:4
msgid "Optional: Specify module options and aliases"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:6
msgid "Use the :command:`modprobe` command to load a module and set options."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:8
msgid ""
":command:`modprobe` may add or remove more than one module due to module "
"interdependencies. You can specify which options to use with individual "
"modules, by using configuration files under the :file:`/etc/modprobe.d` "
"directory."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:16
msgid ""
"All files underneath the :file:`/etc/modprobe.d` directory that end with "
"the :file:`.conf` extension specify module options to use when loading. "
"You can use :file:`.conf` files to create convenient aliases for modules "
"or to override the normal loading behavior altogether for those with "
"special requirements."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:21
msgid "Learn more about :command:`modprobe` on the modprobe.d manual page:"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:28
msgid "Optional: Configure kernel modules to load at boot"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:30
msgid ""
"Use the :file:`/etc/modules-load.d` configuration directory to specify "
"kernel modules to load automatically at boot."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:37
msgid ""
"All files underneath the :file:`/etc/modules-load.d` directory that end "
"with the :file:`.conf` extension contain a list of module names of "
"aliases (one per line) to load at boot."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:41
msgid "Learn more about module loading in the modules-load.d manual page:"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:316
msgid "Related topics"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:318
msgid ""
"`Dynamic Kernel Module System (DKMS) project on GitHub "
"<https://github.com/dell/dkms>`_"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:320
msgid ""
"`Dell Linux Engineering Dynamic Kernel Module Support: From Theory to "
"Practice "
"<https://www.kernel.org/doc/ols/2004/ols2004v1-pages-187-202.pdf>`_"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:322
msgid ""
"`Linux Journal: Exploring Dynamic Kernel Module Support "
"<https://www.linuxjournal.com/article/6896>`_"
msgstr ""
@@ -0,0 +1,267 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/kernel/kernel-modules.rst:4
msgid "Add kernel modules manually"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:6
msgid ""
"Certain kernel modules are enabled by default in |CL-ATTR|. To use "
"additional kernel modules that are not part of the Linux source tree, you"
" may need to build out-of-tree kernel modules. Use this guide to add "
"kernel modules manually, or refer to :ref:`kernel-modules-dkms`."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:17
msgid "Description"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:19
msgid ""
"Kernel modules are additional pieces of software capable of being "
"inserted into the Linux kernel to add functionality, such as a hardware "
"driver. Kernel modules may already be part of the Linux source tree (in-"
"tree) or may come from an external source, such as directly from a vendor"
" (out-of-tree)."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:28
msgid "Kernel module availability"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:30
msgid ""
"|CL| comes with many upstream kernel modules available for use. Using an "
"existing module is significantly easier to maintain and retains signature"
" verification of the |CL| kernel. For more information on |CL| security "
"practices, see the :ref:`security` page."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:35
msgid ""
"Before continuing, check if the kernel module you're looking for is "
"already available in |CL| or submit a request to add the module."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:40
msgid "Check if the module is already available"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:43
msgid ""
"You can search for kernel module file names, which end with the "
":file:`.ko` file extension, using the :command:`swupd search` command, as"
" shown in the following example. See :ref:`swupd-guide` for more "
"information."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:53
msgid "Submit a request to add the module"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:55
msgid ""
"If the kernel module you need is already open source (for example, in the"
" Linux upstream) and likely to be useful to others, consider submitting a"
" request to add or enable it in the |CL| kernel."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:59
msgid "Make enhancement requests to the |CL| distribution `on GitHub`_."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:65
msgid "Build, install, and load an out-of-tree module"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:67
msgid ""
"Follow the steps in this section if you are an individual user or "
"testing, and you need an out-of-tree kernel module that is not available "
"through |CL|. For a more scalable and customizable approach, we recommend"
" using the `mixer tool`_ to provide a custom kernel and updates."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:74
msgid "Prerequisites"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:76
msgid "Before you begin, you must:"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:78
msgid "Disable Secure Boot."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:79
msgid "Disable kernel module integrity checking."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:80
msgid "Have a kernel module package in the form of source code."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:81
msgid "Rebuild the module against new versions of the Linux kernel."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:85
msgid ""
"Any time the kernel is upgraded on your Clear Linux system, you must "
"rebuild your out-of-tree modules."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:90
msgid "Build and install kernel module"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:92
msgid ""
"Determine which kernel variant is running on |CL|. In the example below, "
"the *native* kernel is in use."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:100
msgid ""
"Install the kernel dev bundle corresponding to the installed kernel. The "
"kernel dev bundle contains the kernel headers, which are required for "
"compiling kernel modules. For example:"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:104
msgid "`linux-dev` for developing against the native kernel."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:105
msgid "`linux-lts-dev` for developing against the LTS kernel."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:111
msgid ""
"Follow instructions from the kernel module source code to compile the "
"kernel module. For example:"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:124
msgid "Load kernel module"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:126
msgid ""
"Disable Secure Boot in your system's UEFI settings, if you have enabled "
"it. The loading of new out-of-tree modules modifies the signatures that "
"Secure Boot relies on for trust."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:130
msgid ""
"Disable signature checking for the kernel by modifying the kernel boot "
"parameters and reboot the system."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:133
msgid ""
"All kernel modules from |CL| have been signed to enforce kernel security."
" However, out-of-tree modules break this chain of trust so this mechanism"
" needs to be disabled."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:142
msgid ""
"Update the boot manager and reboot the system to implement the changed "
"kernel parameters."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:152
msgid ""
"If successful, the :command:`clr-boot-manager update` command does not "
"return any console output."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:155
msgid ""
"After rebooting, manually load out-of-tree modules using the "
":command:`insmod` command."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:163
msgid "Examples"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:168
msgid "Optional: Specify module options and aliases"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:170
msgid "Use the :command:`modprobe` command to load a module and set options."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:172
msgid ""
":command:`modprobe` may add or remove more than one module due to module "
"interdependencies. You can specify which options to use with individual "
"modules, by using configuration files under the :file:`/etc/modprobe.d` "
"directory."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:180
msgid ""
"All files underneath the :file:`/etc/modprobe.d` directory that end with "
"the :file:`.conf` extension specify module options to use when loading. "
"You can use :file:`.conf` files to create convenient aliases for modules "
"or to override the normal loading behavior altogether for those with "
"special requirements."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:185
msgid "Learn more about :command:`modprobe` on the modprobe.d manual page:"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:192
msgid "Optional: Configure kernel modules to load at boot"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:194
msgid ""
"Use the :file:`/etc/modules-load.d` configuration directory to specify "
"kernel modules to load automatically at boot."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:201
msgid ""
"All files underneath the :file:`/etc/modules-load.d` directory that end "
"with the :file:`.conf` extension contain a list of module names of "
"aliases (one per line) to load at boot."
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:205
msgid "Learn more about module loading in the modules-load.d manual page:"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:215
msgid "Related topic"
msgstr ""
#: ../../guides/kernel/kernel-modules.rst:217
msgid ":ref:`kernel-modules-dkms`"
msgstr ""
@@ -0,0 +1,137 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/architect-lifecycle.rst:4
msgid "Architect the life-cycle of |CL-ATTR|"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:6
msgid ""
"This guide provides DevOps with a model to architect the life-cycle of a "
"|CL| derivative that integrates custom software and content using "
"distinct workflows."
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:10
msgid "Maintaining a |CL| derivative requires:"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:12
msgid "Monitoring upstream |CL| for new releases"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:13
msgid "Building software packages and staging"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:14
msgid "Employing CI/CD automation for building releases"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:15
msgid "Integrating Quality Assurance for testing and validation"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:17
msgid "This guide provides the foundation of the recommended infrastructure."
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:24
msgid "Prerequisites"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:26
msgid ""
"A repository with software RPM artifacts and a CI/CD system with a |CL| "
"machine for building `mixes`"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:29
msgid "Experience using :ref:`mixer <mixer>` to create a |CL|-based distro"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:31
msgid ""
"Experience using :ref:`swupd <swupd-guide>` for maintaining the |CL| "
"build environment"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:34
msgid "Familiarity with |CL| architecture and reuse of its content in releases"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:37
msgid "Description"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:39
msgid ""
"Coordinated infrastructure is deployed to automate the life-cycle of your"
" |CL| derivative. We divide deployment of this infrastucture in two "
"parts: *Content Workflow*; and *Release Workflow*, shown in Figure 1. "
"Distro Factory manages the *Release Workflow* while capturing the "
"requirements for maintaining a long-term release cadence."
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:48
msgid "Figure 1: Architect the life-cycle"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:51
msgid "Content workflow"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:53
msgid ""
"The *Content Workflow* (Figure 1) orchestrates the processes used to "
"manage the creation of content for the distribution. This includes "
"everything from detecting a new release in a custom software repository "
"to generating RPM package files. The RPM files serve as intermediary "
"artifacts that track software dependencies and provide file-level data "
"consumed in a *Release Workflow*. The `Watcher Pipeline`_ checks |CL| "
"and a content provider, such as Koji, to determine if a new release is "
"necessary."
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:57
msgid "Release workflow"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:59
msgid ""
"The *Release Workflow* (Figure 1) gathers the content of the RPMs and "
"ensures it can be consumed by :ref:`mixer <mixer>`. A content web server "
"hosts the |CL| derivative, to which targets connect for updating their "
"OSes. As an integral part of this toolchain, the *Release Pipeline* "
"enables these derivatives to incorporate |CL| content into their own "
"custom content. The *Watcher Pipeline* triggers the `Release Pipeline`_ "
"to create new releases."
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:68
msgid "Implementation"
msgstr ""
#: ../../guides/maintenance/architect-lifecycle.rst:70
msgid ""
"Distro factory implements the *Release workflow*. To get started on a "
"full implementation, visit |CL| `Distro factory documentation`_."
msgstr ""
@@ -0,0 +1,211 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/assign-static-ip.rst:4
msgid "Assign a static IP address"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:6
msgid ""
"By default, your |CL-ATTR| system automatically gets an IP address from "
"your network via DHCP. If you do not have a DHCP server on your network "
"or simply want to use a static IP address, follow the steps in this "
"guide."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:15
msgid "Identify which program is managing the interface"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:17
msgid ""
"New installations of |CL| use NetworkManager as the default network "
"interface manager for all network connections."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:22
msgid ""
"The *cloud* |CL| images continue to use systemd-networkd to manage "
"network connections."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:25
msgid ""
"In earlier |CL| versions, systemd-network was used to manage Ethernet "
"interfaces and NetworkManager was used for wireless interfaces."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:29
msgid ""
"Before defining a configuration for assigning a static IP address, you "
"should verify which program is managing the network interface."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:32
msgid ""
"Check the output of :command:`nmcli device` to see if NetworkManager is "
"managing the device."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:39
msgid ""
"If the STATE column for the device shows *connected* or *disconnected*, "
"the network configuration is being managed by NetworkManager and the "
"instructions for :ref:`using NetworkManager <nm-static-ip>` should be "
"used."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:43
msgid ""
"If the STATE column for the device shows *unmanaged*, check to see if the"
" device is being managed by systemd-networkd"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:47
msgid ""
"Check the output of :command:`networkctl list` to see if systemd-networkd"
" is managing the device."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:54
msgid ""
"If the SETUP column for the device shows *configured*, the network "
"configuration is being managed by systemd-networkd and the instructions "
"for :ref:`using systemd-networkd <networkd-static-ip>` should be used."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:62
msgid "Using NetworkManager"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:64
msgid ""
"Network connections managed by NetworkManager are stored as files with "
"the :file:`.nmconnection` file extension in the "
":file:`/etc/NetworkManager/system-connections/` directory."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:68
msgid ""
"A few tools exists to aid to manipulate network connections managed by "
"NetworkManager:"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:71
msgid "nmcli - a command-line tool"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:73
msgid ""
"nmtui - a text user interface that provides a pseudo graphical menu in "
"the terminal"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:76
msgid "nm-connection-editor - a graphical user interface"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:78
msgid ""
"The method below uses the command line tool *nmcli* to modify network "
"connection."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:82
msgid "Identify the existing connection name:"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:88
msgid "The output will look like this:"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:95
msgid ""
"If a connection does not exist, it will need to be created with "
":command:`nmcli connection add`."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:99
msgid ""
"Modify the connection to use a static IP address. Replace the variables "
"in brackets with the appropriate values. *[CONNECTION_NAME]* should be "
"replaced with the NAME from the command above."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:112
msgid ""
"See the `nmcli developer page "
"<https://developer.gnome.org/NetworkManager/stable/nmcli.html>`_ for more"
" configuration options. For advanced configurations, the "
":file:`/etc/NetworkManager/system-connections/*.nmconnection`. can be "
"edited directly."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:118
msgid "Restart the NetworkManager server to reload the DNS servers:"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:125
#: ../../guides/maintenance/assign-static-ip.rst:179
msgid "Verify your static IP address details have been set:"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:136
msgid "Using systemd-networkd"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:138
msgid ""
"Network connections managed by systemd-networkd are stored as files with "
"the :file:`.network` file extension the :file:`/etc/systemd/network/` "
"directory."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:141
msgid ""
"Files to manipulate network connections managed by systemd-networkd must "
"be created manually."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:144
msgid ""
"Create the :file:`/etc/systemd/network` directory if it doesn't exist "
"already:"
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:150
msgid ""
"Create a :file:`.network` file and add the following content. Replace the"
" variables in brackets with the appropriate values. *[INTERFACE_NAME]* "
"should be replaced with LINK from the output of :command:`networkctl "
"list` ran previously."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:168
msgid ""
"See the `systemd-network man page "
"<https://www.freedesktop.org/software/systemd/man/systemd.network.html>`_"
" for more configuration options."
msgstr ""
#: ../../guides/maintenance/assign-static-ip.rst:172
msgid "Restart the systemd-networkd service:"
msgstr ""
@@ -0,0 +1,201 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/bulk-provision.rst:4
msgid "Bulk provision"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:6
msgid ""
"The |CL-ATTR| can be automatically provisioned in bulk using a "
"combination of the |CL| installer, **Ister**, and :abbr:`ICIS (Ister "
"Cloud Init Service)`. This guide covers how to perform a bulk provision "
"of |CL| using **Ister** and **ICIS**."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:11
msgid ""
"To configure a bulk provision, Ister configuration files and cloud-init "
"files must be defined. Hosting the configuration files in **ICIS** allows"
" **Ister** to use them during the installation. The Ister configuration "
"files allow us to customize the installation process. The cloud-init\\* "
"files allow us to customize the instance of the installation."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:17
msgid ""
"Figure 1 depicts the flow of information between a PXE server and a PXE "
"client that needs to be set up to perform a bulk provision."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:23
msgid "Figure 1: Bulk provision information flow"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:26
msgid "Prerequisites"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:28
msgid ""
"Before performing a bulk provision, verify you have a PXE server capable "
"of performing network boots of |CL|. Please refer to our :ref:`guide on "
"how to perform an iPXE boot<ipxe-install>` using :abbr:`NAT (network "
"address translation)` for details."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:33
msgid ""
"Because a bulk provision relies on a reboot, ensure the following "
"preparations have been made:"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:36
msgid "No existing disks are bootable."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:37
msgid ""
"The network boot option must come immediately after the disk boot option "
"on any computer performing the installation."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:41
msgid "Configuration"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:43
msgid ""
"Install **ICIS** by following the getting started guide on the `ICIS "
"GitHub repository`_."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:46
msgid ""
"Create an Ister installation file and save it to the :file:`static/ister`"
" directory within the web hosting directory for **ICIS**. The "
"installation file is a JSON block and provides **Ister** with the steps "
"it needs to perform an installation. The file outlines what partitions, "
"file systems, and mount points **Ister** should set up. Lastly, the file "
"outlines which bundles to install. See our :ref:`bundles` document for "
"the list of available bundles. The following example shows the contents "
"of an Ister installation file:"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:85
msgid ""
"Every Ister installation file hosted on **ICIS** must contain the the "
"``IsterCloudInitSvc`` parameter as well as the ``os-cloudguest`` bundle. "
"These entries allow **Ister** to customize an instance of of an install."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:90
msgid ""
"Create an Ister configuration file to define the location of the Ister "
"installation file. Save it to the :file:`static/ister` directory within "
"the web hosting directory of **ICIS**. The following example shows an "
"Ister configuration file:"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:99
msgid ""
"Modify the iPXE boot script by adding a kernel parameter to the command "
"line for booting the network image. Add the kernel parameter "
"``isterconf`` with the location of the Ister configuration file hosted on"
" **ICIS** as the kernel parameter value. The following example shows an "
"iPXE boot script with the ``isterconf`` parameter:"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:114
msgid ""
"After the network image of |CL| boots, **Ister** inspects the parameters "
"used during boot in :file:`/proc/cmdline` to find the location of the "
"Ister configuration file."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:118
msgid ""
"Write a cloud-init document to customize the instance of the installation"
" according to your requirements. The `cloud-init Read the Docs`_ provides"
" a guide on how to write a cloud-init document. The guide covers the "
"customization options provided by cloud-init after an installation."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:123
msgid ""
"Save the cloud-init document to the :file:`static/roles` directory within"
" the web hosting directory for **ICIS** with the name of a role you would"
" like to create. For example, a role may be \"database\", \"web\", or "
"\"ciao\"."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:127
msgid ""
"After creating the roles, also known as cloud-init files, assign roles to"
" MAC addresses of PXE clients. To do so, modify the :file:`config.txt` "
"file in the ``static`` directory within the web hosting directory of "
"**ICIS**. The following example shows one such assignment:"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:137
msgid ""
"If MAC addresses of PXE clients are not listed within the "
":file:`config.txt` file, a default role for those MAC address may be "
"defined as follows:"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:146
msgid "Verify the following URLs are accessible on your local network:"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:148
msgid "``http://192.168.1.1:60000/icis/static/ister/ister.conf``"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:149
msgid "``http://192.168.1.1:60000/icis/static/ister/ister.json``"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:150
msgid "``http://192.168.1.1:60000/icis/get_config/<MAC address>``"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:151
msgid "``http://192.168.1.1:60000/icis/get_role/<role>``"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:152
msgid "``http://192.168.1.1:60000/ipxe/ipxe_boot_script.txt``"
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:154
msgid "Power on the PXE client and watch it boot and install |CL|."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:156
msgid "Power-cycle the PXE client and watch it customize the |CL| installation."
msgstr ""
#: ../../guides/maintenance/bulk-provision.rst:158
msgid ""
"**Congratulations!** You have successfully performed a bulk provision of "
"|CL|."
msgstr ""
@@ -0,0 +1,257 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/cpu-performance.rst:4
msgid "CPU Power and Performance"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:6
msgid ""
"Modern x86 :abbr:`CPUs (central processing units)` employ a number of "
"features and technologies to balance performance, energy, and thermal "
"efficiencies."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:9
msgid ""
"By default, |CL| prioritizes maximum CPU performance with the philosophy "
"that the faster the program finishes execution, the faster the CPU can "
"return to a low energy idle state. It is important to understand and "
"evaluate all of these technologies when troubleshooting or considering "
"changing the defaults."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:18
msgid "CPU power saving mechanisms"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:20
msgid ""
"C-states and P-states are both CPU power saving mechanisms that are "
"entered under different operating conditions. The tradeoff is a slightly "
"longer time to exit these states when the CPU is needed once again."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:27
msgid "C-states (idle states)"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:29
msgid ""
"C-states are hardware sleep states that are entered when it is determined"
" that the CPU is idle and not executing instructions."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:32
msgid ""
"C-states aim to reduce power utilization by increasingly reducing clock "
"frequency, voltages, and features in each state."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:35
msgid ""
"Although C-states can typically be limited or disabled in a system's UEFI"
" or BIOS configuration, these settings are overridden when the "
"`intel_idle driver`_ is in use."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:39
msgid "To view the current cpuidle driver run this command in a terminal:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:45
msgid ""
"For troubleshooting, C-states can be limited with a kernel command line "
"boot parameter by adding :command:`processor.max_cstate=N "
"intel_idle.max_cstate=N` or completely disabled with "
":command:`idle=poll`."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:51
msgid ""
":command:`processor.max_cstate=0` is changed to "
":command:`processor.max_cstate=1` by the kernel to be a valid value."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:53
msgid ""
":command:`intel_idle.max_cstate=0` disables the Intel Idle driver, not "
"set it to C-state 0."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:59
msgid "P-states (performance states)"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:61
msgid ""
"P-states, also known as *SpeedStep* on Intel processors or *Cool'n'Quiet*"
" on AMD processors, are states entered while the CPU is active and "
"executing instructions."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:65
msgid ""
"P-states aim to reduce power utilization by adjusting CPU clock frequency"
" and voltages based on CPU demand."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:68
msgid ""
"P-states can typically be limited or disabled in a system's firmware "
"(UEFI/BIOS)."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:71
msgid "Turbo boost"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:73
msgid ""
"`Turbo Boost technology`_, found on some modern Intel CPUs, allows "
"core(s) on a processor to temporarily operate at a higher than rated CPU "
"clock frequency to accommodate demanding workloads if the CPU is under "
"defined power and thermal thresholds."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:78
msgid ""
"Turbo boost is an extension of P-states. As such, changing or limiting "
"C-states or P-states impact the ability of a process to enter Turbo "
"boost."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:81
msgid ""
"Turbo boost can be disabled in a system's UEFI or BIOS. Turbo boost can "
"also be disabled within |CL| with the command:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:89
msgid "Linux CPU clock frequency scaling"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:91
msgid ""
"The CPUFreq subsystem in Linux allows the OS to control :ref:`C-states <c"
"-states-section>` and :ref:`P-states <P-states-section>` via CPU drivers "
"and governors that provide algorithms that define how and when to enter "
"these states."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:97
msgid "Scaling driver"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:99
msgid ""
"Linux uses the `Intel P-state driver`_, *intel_pstate*, for modern Intel "
"processors from the Sandy Bridge generation or newer. Other processors "
"may default to the *acpi-cpufreq* driver which reads values from the "
"systems UEFI or BIOS."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:104
msgid ""
"To view the current CPU frequency scaling driver run this command in a "
"terminal:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:111
msgid "Scaling governor"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:113
msgid ""
"|CL| sets the CPU governor to *performance* which calls for the CPU to "
"operate at maximum clock frequency. In other words, P-state P0. While "
"this may sound wasteful at first, it is important to remember that power "
"utilization does not increase significantly simply because of a locked "
"clock frequency without a workload."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:119
msgid ""
"To view the current CPU frequency scaling governor run this command in a "
"terminal:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:125
msgid "To change the CPU frequency scaling governor:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:127
msgid "Disable |CL| enforcement of certain power and performance settings:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:133
msgid ""
"Change the governor. In the example below, the governor is set to "
"*performance*:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:140
msgid ""
"The list of all governors can be found in the `Linux kernel documentation"
" on CPUFreq Governors`_."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:145
msgid ""
"The intel_pstate driver only supports *performance* and *powersave* "
"governors."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:148
msgid "Thermal management"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:150
msgid ""
"`thermald`_ is a Linux thermal management daemon used to prevent the "
"overheating of platforms. When temperature thresholds are exceeded, "
"thermald forces a C-state by inserting CPU sleep cycles and adjusts "
"available cooling methods. This can be especially desirable for laptops."
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:155
msgid ""
"By default, thermald is disabled in |CL| and starts automatically if "
"battery power is detected. thermald can be manually enabled using the "
"systemd service by running the command:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:164
msgid "For more information, see the thermald man page:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:170
msgid ""
"`ThermalMonitor`_ is a GUI application that can visually graph and log "
"temperatures from thermald. To use ThermalMonitor, add the desktop-apps-"
"extras bundle and add your user account to the power group:"
msgstr ""
#: ../../guides/maintenance/cpu-performance.rst:182
msgid ""
"After adding a new group you must log out and log back in for the new "
"group to take affect."
msgstr ""
@@ -0,0 +1,196 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/developer-workstation.rst:4
msgid "Developer Workstation"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:6
msgid ""
"*Developer Workstation* helps you find the :ref:`bundles-about` you need "
"to start your |CL-ATTR| development project."
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:9
msgid ""
"Before continuing, we recommend that you learn how to use :ref:`swupd "
"<swupd-guide>`. Visit our :ref:`swupd-about` page to understand how |CL| "
"simplifies software versioning compared to other Linux\\* distributions."
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:15
msgid "Workstation Setup"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:17
msgid ""
"This guide helps you understand the minimum bundles required to get "
"started. After installing them, you can add more bundles relevant to your"
" use case. To run any process required for |CL| development, you can add "
"the large bundle :ref:`*os-clr-on-clr* <enable-user-space>`. However, "
"given how many packages this bundle contains, you may want instead to "
"deploy a leaner OS with only those bundles relevant to your project. "
"Developer Workstation responds to this need."
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:25
msgid ""
"Use Table 1, *Developer Profiles*, to identify the *minimum required "
"bundles* to get started developing based on your role or project. While "
"your role may not neatly fit in one of these categories, consider using "
"Table 1 as a starting point."
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:29
msgid "**Table 1. Developer Profiles**"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:33
msgid "|CL| Bundle"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:34
msgid "*Internet of Things (IoT)*"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:35
msgid "*System Administrator*"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:36
msgid "*Client/Cloud/Web Developer*"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:38
msgid "`editors`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:39
#: ../../guides/maintenance/developer-workstation.rst:40
#: ../../guides/maintenance/developer-workstation.rst:41
#: ../../guides/maintenance/developer-workstation.rst:44
#: ../../guides/maintenance/developer-workstation.rst:45
#: ../../guides/maintenance/developer-workstation.rst:46
#: ../../guides/maintenance/developer-workstation.rst:49
#: ../../guides/maintenance/developer-workstation.rst:50
#: ../../guides/maintenance/developer-workstation.rst:51
#: ../../guides/maintenance/developer-workstation.rst:55
#: ../../guides/maintenance/developer-workstation.rst:56
#: ../../guides/maintenance/developer-workstation.rst:60
#: ../../guides/maintenance/developer-workstation.rst:61
#: ../../guides/maintenance/developer-workstation.rst:65
#: ../../guides/maintenance/developer-workstation.rst:66
#: ../../guides/maintenance/developer-workstation.rst:69
#: ../../guides/maintenance/developer-workstation.rst:70
#: ../../guides/maintenance/developer-workstation.rst:71
#: ../../guides/maintenance/developer-workstation.rst:76
msgid "✓"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:43
msgid "`network-basic`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:48
msgid "`openssh-server`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:53
msgid "`webserver-basic`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:58
msgid "`application-server`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:63
msgid "`database-basic`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:68
msgid "`desktop-autostart`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:73
msgid "`dev-utils`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:79
msgid "`swupd` search"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:81
msgid ""
"We recommend learning about :ref:`swupd <swupd-guide>`, to learn the "
"commands to search for and add bundles relevant to your project."
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:84
msgid ""
"The guide provides an :ref:`example <swupd-guide-example-install-bundle>`"
" that shows you how to:"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:87
msgid "Use `swupd` to search for bundles"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:88
msgid "Use `swupd` to add bundles"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:91
msgid "Core Concepts"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:93
msgid ""
"We recommend that you understand these core concepts in |CL| *before* "
"developing your project."
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:96
msgid ":ref:`Bundles <bundles-about>`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:97
msgid ":ref:`Software update <swupd-about>`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:98
msgid ":ref:`Mixer <mixer-about>`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:99
msgid ":ref:`Autospec <autospec-about>`"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:102
msgid "Other resources for developers"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:104
msgid "`Developer Tooling Framework`_ for |CL|"
msgstr ""
#: ../../guides/maintenance/developer-workstation.rst:105
msgid "`Bundle definition files`_"
msgstr ""
@@ -0,0 +1,282 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:4
msgid "Download, verify, and decompress a |CL-ATTR| image on Linux"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:6
msgid ""
"This guide describes the types of |CL| images available, where to "
"download them, how to verify the integrity of an image, and how to "
"decompress it."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:9
msgid "Instructions for other operating systems are available:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:11
msgid ":ref:`download-verify-decompress-mac`"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:12
msgid ":ref:`download-verify-decompress-windows`"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:15
msgid "Image types"
msgstr ""
#: ../../reference/image-types.rst:3
msgid ""
"|CL-ATTR| offers many types of `images`_ for different platforms and "
"environments."
msgstr ""
#: ../../reference/image-types.rst:7
msgid "The naming convention of a |CL| image filename is:"
msgstr ""
#: ../../reference/image-types.rst:13
msgid "The *[version number]* field specifies the version number."
msgstr ""
#: ../../reference/image-types.rst:15
msgid ""
"The *[image type]* field specifies the type of image and its "
"corresponding file format."
msgstr ""
#: ../../reference/image-types.rst:18
msgid ""
"The *[compression type]* field specifies the compression type. Two types "
"of compressions are used: GNU\\* zip (*.gz*) and XZ (*.xz*)."
msgstr ""
#: ../../reference/image-types.rst:23
msgid ""
"Table 1 lists the currently available images that are platform "
"independent. Table 2 lists the currently available images that are "
"platform specific."
msgstr ""
#: ../../reference/image-types.rst:26
msgid "Table 1: Types of platform-independent |CL| images"
msgstr ""
#: ../../reference/image-types.rst:30 ../../reference/image-types.rst:43
msgid "Image Type"
msgstr ""
#: ../../reference/image-types.rst:31 ../../reference/image-types.rst:44
msgid "Description"
msgstr ""
#: ../../reference/image-types.rst:33
msgid "live-desktop.img or live-desktop.iso"
msgstr ""
#: ../../reference/image-types.rst:34
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
msgstr ""
#: ../../reference/image-types.rst:36
msgid "live-server.img or live-server.iso"
msgstr ""
#: ../../reference/image-types.rst:37
msgid "Image for booting to server command prompt to preview or install the OS."
msgstr ""
#: ../../reference/image-types.rst:39
msgid "Table 2: Types of platform-specific |CL| images"
msgstr ""
#: ../../reference/image-types.rst:46
msgid "aws.img"
msgstr ""
#: ../../reference/image-types.rst:47
msgid "Image suitable for use with Amazon\\* AWS\\*."
msgstr ""
#: ../../reference/image-types.rst:49
msgid "azure.vhd"
msgstr ""
#: ../../reference/image-types.rst:50
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
msgstr ""
#: ../../reference/image-types.rst:52
msgid "azure-docker.vhd"
msgstr ""
#: ../../reference/image-types.rst:53
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
"Docker\\* pre-installed."
msgstr ""
#: ../../reference/image-types.rst:55
msgid "azure-machine-learning.vhd"
msgstr ""
#: ../../reference/image-types.rst:56
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
"`machine-learning-basic` bundle installed."
msgstr ""
#: ../../reference/image-types.rst:58
msgid "cloudguest.img"
msgstr ""
#: ../../reference/image-types.rst:59
msgid ""
"Image with generic cloud guest virtual machine (VM) requirements "
"installed."
msgstr ""
#: ../../reference/image-types.rst:61
msgid "gce.tar"
msgstr ""
#: ../../reference/image-types.rst:62
msgid "Image with the Google Compute Engine (GCE) specific kernel."
msgstr ""
#: ../../reference/image-types.rst:64
msgid "hyperv.vhdx"
msgstr ""
#: ../../reference/image-types.rst:65
msgid ""
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
"`optimized kernel`_ for Hyper-V."
msgstr ""
#: ../../reference/image-types.rst:67
msgid "kvm.img"
msgstr ""
#: ../../reference/image-types.rst:68
msgid ""
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
"kernel`_ for KVM."
msgstr ""
#: ../../reference/image-types.rst:71
msgid "kvm-legacy.img"
msgstr ""
#: ../../reference/image-types.rst:72
msgid ""
"Image for booting in a simple VM using legacy BIOS, if using "
"start_qemu.sh make sure to remove -bios parameter."
msgstr ""
#: ../../reference/image-types.rst:74
msgid "pxe.tar"
msgstr ""
#: ../../reference/image-types.rst:75
msgid "Image suitable for use with PXE server."
msgstr ""
#: ../../reference/image-types.rst:77
msgid "vmware.vmdk"
msgstr ""
#: ../../reference/image-types.rst:78
msgid ""
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
"Workstation, and ESXi."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:23
msgid "Verify the integrity of the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:25
msgid ""
"Before you use a downloaded |CL| image, verify its integrity. This action"
" eliminates the small chance of a corrupted image due to download issues."
" To support verification, each released |CL| image has a corresponding "
"SHA512 checksum file designated with the suffix `-SHA512SUMS`."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:30
msgid "Download the corresponding SHA512 checksum file of your |CL| image."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:31
#: ../../guides/maintenance/download-verify-decompress-linux.rst:57
msgid "Start a terminal emulator."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:32
msgid "Go to the directory with the downloaded image and checksum files."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:33
msgid ""
"Verify the integrity of the image and compare it to its original checksum"
" with the command:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:40
msgid ""
"If the checksum of the downloaded image is different than the original "
"checksum, a warning is displayed with a message indicating the computed "
"checksum does **not** match. Otherwise, the name of the image is printed "
"on the screen followed by `OK`."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:45
msgid ""
"For a more in-depth discussion of image verification including checking "
"the certificate see :ref:`image-content-validation`."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:51
msgid "Decompress the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:53
msgid ""
"Released |CL| images are compressed with either GNU zip (*.gz*) or XZ "
"(*.xz*). The compression type depends on the target platform or "
"environment. To decompress the image, follow these steps:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:58
msgid "Go to the directory with the downloaded image."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:60
msgid "To decompress an XZ image, enter:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-linux.rst:66
msgid "To decompress a GZ image, enter:"
msgstr ""
@@ -0,0 +1,273 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:4
msgid "Download, verify, and decompress a |CL-ATTR| image on macOS\\*"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:6
msgid ""
"This guide describes the types of |CL| images available, where to "
"download them, how to verify the integrity of an image, and how to "
"decompress it."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:9
msgid "Instructions for other operating systems are available:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:11
msgid ":ref:`download-verify-decompress-linux`"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:12
msgid ":ref:`download-verify-decompress-windows`"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:15
msgid "Image types"
msgstr ""
#: ../../reference/image-types.rst:3
msgid ""
"|CL-ATTR| offers many types of `images`_ for different platforms and "
"environments."
msgstr ""
#: ../../reference/image-types.rst:7
msgid "The naming convention of a |CL| image filename is:"
msgstr ""
#: ../../reference/image-types.rst:13
msgid "The *[version number]* field specifies the version number."
msgstr ""
#: ../../reference/image-types.rst:15
msgid ""
"The *[image type]* field specifies the type of image and its "
"corresponding file format."
msgstr ""
#: ../../reference/image-types.rst:18
msgid ""
"The *[compression type]* field specifies the compression type. Two types "
"of compressions are used: GNU\\* zip (*.gz*) and XZ (*.xz*)."
msgstr ""
#: ../../reference/image-types.rst:23
msgid ""
"Table 1 lists the currently available images that are platform "
"independent. Table 2 lists the currently available images that are "
"platform specific."
msgstr ""
#: ../../reference/image-types.rst:26
msgid "Table 1: Types of platform-independent |CL| images"
msgstr ""
#: ../../reference/image-types.rst:30 ../../reference/image-types.rst:43
msgid "Image Type"
msgstr ""
#: ../../reference/image-types.rst:31 ../../reference/image-types.rst:44
msgid "Description"
msgstr ""
#: ../../reference/image-types.rst:33
msgid "live-desktop.img or live-desktop.iso"
msgstr ""
#: ../../reference/image-types.rst:34
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
msgstr ""
#: ../../reference/image-types.rst:36
msgid "live-server.img or live-server.iso"
msgstr ""
#: ../../reference/image-types.rst:37
msgid "Image for booting to server command prompt to preview or install the OS."
msgstr ""
#: ../../reference/image-types.rst:39
msgid "Table 2: Types of platform-specific |CL| images"
msgstr ""
#: ../../reference/image-types.rst:46
msgid "aws.img"
msgstr ""
#: ../../reference/image-types.rst:47
msgid "Image suitable for use with Amazon\\* AWS\\*."
msgstr ""
#: ../../reference/image-types.rst:49
msgid "azure.vhd"
msgstr ""
#: ../../reference/image-types.rst:50
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
msgstr ""
#: ../../reference/image-types.rst:52
msgid "azure-docker.vhd"
msgstr ""
#: ../../reference/image-types.rst:53
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
"Docker\\* pre-installed."
msgstr ""
#: ../../reference/image-types.rst:55
msgid "azure-machine-learning.vhd"
msgstr ""
#: ../../reference/image-types.rst:56
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
"`machine-learning-basic` bundle installed."
msgstr ""
#: ../../reference/image-types.rst:58
msgid "cloudguest.img"
msgstr ""
#: ../../reference/image-types.rst:59
msgid ""
"Image with generic cloud guest virtual machine (VM) requirements "
"installed."
msgstr ""
#: ../../reference/image-types.rst:61
msgid "gce.tar"
msgstr ""
#: ../../reference/image-types.rst:62
msgid "Image with the Google Compute Engine (GCE) specific kernel."
msgstr ""
#: ../../reference/image-types.rst:64
msgid "hyperv.vhdx"
msgstr ""
#: ../../reference/image-types.rst:65
msgid ""
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
"`optimized kernel`_ for Hyper-V."
msgstr ""
#: ../../reference/image-types.rst:67
msgid "kvm.img"
msgstr ""
#: ../../reference/image-types.rst:68
msgid ""
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
"kernel`_ for KVM."
msgstr ""
#: ../../reference/image-types.rst:71
msgid "kvm-legacy.img"
msgstr ""
#: ../../reference/image-types.rst:72
msgid ""
"Image for booting in a simple VM using legacy BIOS, if using "
"start_qemu.sh make sure to remove -bios parameter."
msgstr ""
#: ../../reference/image-types.rst:74
msgid "pxe.tar"
msgstr ""
#: ../../reference/image-types.rst:75
msgid "Image suitable for use with PXE server."
msgstr ""
#: ../../reference/image-types.rst:77
msgid "vmware.vmdk"
msgstr ""
#: ../../reference/image-types.rst:78
msgid ""
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
"Workstation, and ESXi."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:23
msgid "Verify the integrity of the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:25
msgid ""
"Before you use a downloaded |CL| image, verify its integrity. This action"
" eliminates the small chance of a corrupted image due to download issues."
" To support verification, each released |CL| image has a corresponding "
"SHA512 checksum file designated with the suffix `-SHA512SUMS`."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:30
msgid "Download the corresponding SHA512 checksum file of your |CL| image."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:31
#: ../../guides/maintenance/download-verify-decompress-mac.rst:51
msgid "Start the Terminal app."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:32
msgid "Go to the directory with the downloaded image and checksum files."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:33
msgid ""
"Verify the integrity of the image and compare it to its original checksum"
" with the command:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:40
msgid ""
"If the checksum of the downloaded image is different than the original "
"checksum, the differences will be displayed. Otherwise, an empty output "
"indicates a match and your downloaded image is good."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:45
msgid "Decompress the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:47
msgid ""
"We compress all released |CL| images by default with either GNU zip "
"(`.gz`) or xz (`.xz`). The compression type we use depends on the target "
"platform or environment. To decompress the image, follow these steps:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:52
msgid "Go to the directory with the downloaded image."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-mac.rst:53
msgid ""
"Use the :command:`gunzip` command to decompress either compression type. "
"For example:"
msgstr ""
@@ -0,0 +1,277 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:4
msgid "Download, verify, and decompress a |CL-ATTR| image on Windows\\*"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:6
msgid ""
"This guide describes the types of |CL-ATTR| images available, where to "
"download them, how to verify the integrity of an image, and how to "
"decompress it."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:9
msgid "Instructions for other operating systems are available:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:11
msgid ":ref:`download-verify-decompress-linux`"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:12
msgid ":ref:`download-verify-decompress-mac`"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:15
msgid "Image types"
msgstr ""
#: ../../reference/image-types.rst:3
msgid ""
"|CL-ATTR| offers many types of `images`_ for different platforms and "
"environments."
msgstr ""
#: ../../reference/image-types.rst:7
msgid "The naming convention of a |CL| image filename is:"
msgstr ""
#: ../../reference/image-types.rst:13
msgid "The *[version number]* field specifies the version number."
msgstr ""
#: ../../reference/image-types.rst:15
msgid ""
"The *[image type]* field specifies the type of image and its "
"corresponding file format."
msgstr ""
#: ../../reference/image-types.rst:18
msgid ""
"The *[compression type]* field specifies the compression type. Two types "
"of compressions are used: GNU\\* zip (*.gz*) and XZ (*.xz*)."
msgstr ""
#: ../../reference/image-types.rst:23
msgid ""
"Table 1 lists the currently available images that are platform "
"independent. Table 2 lists the currently available images that are "
"platform specific."
msgstr ""
#: ../../reference/image-types.rst:26
msgid "Table 1: Types of platform-independent |CL| images"
msgstr ""
#: ../../reference/image-types.rst:30 ../../reference/image-types.rst:43
msgid "Image Type"
msgstr ""
#: ../../reference/image-types.rst:31 ../../reference/image-types.rst:44
msgid "Description"
msgstr ""
#: ../../reference/image-types.rst:33
msgid "live-desktop.img or live-desktop.iso"
msgstr ""
#: ../../reference/image-types.rst:34
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
msgstr ""
#: ../../reference/image-types.rst:36
msgid "live-server.img or live-server.iso"
msgstr ""
#: ../../reference/image-types.rst:37
msgid "Image for booting to server command prompt to preview or install the OS."
msgstr ""
#: ../../reference/image-types.rst:39
msgid "Table 2: Types of platform-specific |CL| images"
msgstr ""
#: ../../reference/image-types.rst:46
msgid "aws.img"
msgstr ""
#: ../../reference/image-types.rst:47
msgid "Image suitable for use with Amazon\\* AWS\\*."
msgstr ""
#: ../../reference/image-types.rst:49
msgid "azure.vhd"
msgstr ""
#: ../../reference/image-types.rst:50
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
msgstr ""
#: ../../reference/image-types.rst:52
msgid "azure-docker.vhd"
msgstr ""
#: ../../reference/image-types.rst:53
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
"Docker\\* pre-installed."
msgstr ""
#: ../../reference/image-types.rst:55
msgid "azure-machine-learning.vhd"
msgstr ""
#: ../../reference/image-types.rst:56
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
"`machine-learning-basic` bundle installed."
msgstr ""
#: ../../reference/image-types.rst:58
msgid "cloudguest.img"
msgstr ""
#: ../../reference/image-types.rst:59
msgid ""
"Image with generic cloud guest virtual machine (VM) requirements "
"installed."
msgstr ""
#: ../../reference/image-types.rst:61
msgid "gce.tar"
msgstr ""
#: ../../reference/image-types.rst:62
msgid "Image with the Google Compute Engine (GCE) specific kernel."
msgstr ""
#: ../../reference/image-types.rst:64
msgid "hyperv.vhdx"
msgstr ""
#: ../../reference/image-types.rst:65
msgid ""
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
"`optimized kernel`_ for Hyper-V."
msgstr ""
#: ../../reference/image-types.rst:67
msgid "kvm.img"
msgstr ""
#: ../../reference/image-types.rst:68
msgid ""
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
"kernel`_ for KVM."
msgstr ""
#: ../../reference/image-types.rst:71
msgid "kvm-legacy.img"
msgstr ""
#: ../../reference/image-types.rst:72
msgid ""
"Image for booting in a simple VM using legacy BIOS, if using "
"start_qemu.sh make sure to remove -bios parameter."
msgstr ""
#: ../../reference/image-types.rst:74
msgid "pxe.tar"
msgstr ""
#: ../../reference/image-types.rst:75
msgid "Image suitable for use with PXE server."
msgstr ""
#: ../../reference/image-types.rst:77
msgid "vmware.vmdk"
msgstr ""
#: ../../reference/image-types.rst:78
msgid ""
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
"Workstation, and ESXi."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:23
msgid "Verify the integrity of the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:25
msgid ""
"Before you use a downloaded |CL| image, verify its integrity. This action"
" eliminates the small chance of a corrupted image due to download issues."
" To support verification, each released |CL| image has a corresponding "
"SHA512 checksum file designated with the suffix `-SHA512SUMS`."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:30
msgid "Download the corresponding SHA512 checksum file of your |CL| image."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:31
msgid "Start Command Prompt."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:32
msgid "Go to the directory with the downloaded image and checksum files."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:33
msgid "Get the SHA512 checksum of the image with the command:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:39
msgid ""
"Manually compare the output with the original checksum value shown in the"
" downloaded checksum file and make sure they match."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:43
msgid "Decompress the |CL| image"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:45
msgid ""
"Released |CL| images are compressed with either GNU zip (*.gz*) or XZ "
"(*.xz*). The compression type depends on the target platform or "
"environment. To decompress the image, follow these steps:"
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:49
msgid "Download and install `7-Zip`_."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:50
msgid "Go to the directory with the downloaded image and right-click it."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:51
msgid ""
"From the pop-up menu, select :guilabel:`7-Zip` and select "
":guilabel:`Extract Here` as shown in Figure 1."
msgstr ""
#: ../../guides/maintenance/download-verify-decompress-windows.rst:58
msgid "Figure 1: Windows 7-Zip extract file."
msgstr ""
@@ -0,0 +1,155 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/enable-user-space.rst:4
msgid "Create and enable a new user space"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:6
msgid ""
"This section provides steps to complete the following basic setup tasks "
"for a newly installed |CL-ATTR| system:"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:14
msgid "Create a new user"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:16
msgid ""
"To create a new user and set a password for that user, enter the "
"following commands as a `root` user:"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:24
msgid ""
"Replace the <userid> with the name of the user account you want to create"
" including the password for that user. The :command:`passwd` command "
"prompts you to enter a new password. Retype the new password for the new "
"user account just created."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:30
msgid "Add the new user to the `wheel` group"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:32
msgid ""
"Before logging off as root and logging into your new user account, enable"
" the :command:`sudo` command for your new `<userid>`."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:35
msgid ""
"To be able to execute all applications with root privileges, add the "
"`<userid>` to the `wheel group`_."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:38
msgid "Add `<userid>` to the `wheel` group:"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:44
msgid "Log out of root and into the new `<userid>`."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:46
msgid "To log off as root, enter :command:`exit`."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:48
msgid "Enter the new `<userid>` and the password created earlier."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:50
msgid "You will now be in the home directory of `<userid>`."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:53
msgid "Install and update the OS software to its current version"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:55
msgid ""
"The |CL| software utility :ref:`swupd <swupd-guide>` allows you to "
"perform system updates while reaping the benefits of upstream "
"development."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:57
msgid "To update your newly installed OS, run:"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:64
msgid "Add a bundle"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:66
msgid ""
"Software applications are installed as bundles using the command "
":command:`swupd bundle-add`. Experienced Linux* users might compare "
"`swupd` to running :command:`apt-get` or :command:`yum install` for "
"package management. Yet |CL| manages packages at the level of bundles, "
"which are integrated stacks of packages."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:72
msgid ""
"For example, the `sysadmin-basic` bundle installs the majority of "
"applications useful to a system administrator. To install it, enter:"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:78
msgid ""
"View a full list of bundles and packages installed with the `sysadmin-"
"basic`_ bundle. You can also view `all bundles`_ for |CL|, active or "
"deprecated."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:80
msgid ""
"Expand your knowledge of :command:`swupd` and check out our developer "
"resources:"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:82
msgid ":ref:`swupd-guide`"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:83
msgid ":ref:`developer-workstation`"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:86
msgid "Next steps"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:88
msgid "Check out our guides and tutorials."
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:90
msgid ":ref:`guides`"
msgstr ""
#: ../../guides/maintenance/enable-user-space.rst:91
msgid ":ref:`tutorials`"
msgstr ""
@@ -0,0 +1,159 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/fix-broken-install.rst:4
msgid "Fix a broken installation of |CL-ATTR|"
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:6
msgid ""
"This guide explains how to fix a broken installation of |CL| using a live"
" desktop image on a USB. It's assumed you already installed |CL| on a "
"target system, but your operating system does not boot or function "
"properly."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:10
msgid ""
"This process can only verify and fix files that :ref:`swupd<swupd-guide>`"
" owns in :file:`/usr`. Files outside of this path, such as /home/, /etc, "
"/var, etc., cannot be repaired by this process."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:15
msgid "Prerequisites"
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:17
msgid ""
":ref:`Download and install the live desktop image on a USB <bare-metal-"
"install-desktop>`"
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:20
msgid "Boot a live desktop image to fix target system"
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:22
msgid "Boot the |CL| live desktop image."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:4
msgid "Install from live image"
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:6
msgid ""
"After you download and burn the live desktop image on a USB drive, follow"
" these steps."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:9
msgid "Insert the USB drive into an available USB slot."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:11
msgid "Power on the system."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:13
msgid ""
"Open the system BIOS setup menu by pressing the :kbd:`F2` key. Your BIOS "
"setup menu entry point may vary."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:16
msgid ""
"In the setup menu, enable the UEFI boot and set the USB drive as the "
"first option in the device boot order."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:19
msgid "Save these settings, e.g. :kbd:`F10`, and exit."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:21
msgid "Reboot the target system."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:23
msgid "Select :guilabel:`Clear Linux OS` in the boot menu, shown in Figure 1."
msgstr ""
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:29
msgid "Figure 1: Clear Linux OS in boot menu"
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:29
msgid "Mount root partition, verify, and fix"
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:31
msgid "Open a Terminal window."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:33
msgid "Assure the system is connected to the network."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:35
msgid "Mount the system’s root partition."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:37
msgid "To find the root partition, run:"
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:43
msgid "We'll use `/dev/sda3/` as the root partition example."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:45
msgid "Next, mount the partition to the `/mnt` folder."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:51
msgid ""
"Verify that you mounted the correct root partition by checking for some "
"files commonly found on |CL| systems."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:59
msgid "Next, run swupd to fix any issues on the target system."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:65
msgid ":ref:`Learn more about how swupd works <swupd-guide>`."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:67
msgid "After the process is complete, unmount the root partition:"
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:73
msgid ""
"Reboot the system, remove the live desktop USB drive, and boot into the "
"repaired system."
msgstr ""
#: ../../guides/maintenance/fix-broken-install.rst:80
msgid "**Congratulations!** You successfully restored |CL|."
msgstr ""
Binary file not shown.
@@ -0,0 +1,110 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/hostname.rst:4
msgid "Modify hostname on |CL-ATTR|"
msgstr ""
#: ../../guides/maintenance/hostname.rst:6
msgid ""
"This guide describes how to modify and view the hostname of your |CL-"
"ATTR| system."
msgstr ""
#: ../../guides/maintenance/hostname.rst:9
msgid ""
"By default, |CL| installations have a machine generated name, which is a "
"long string of letters and numbers. The generated name is fine for "
"computers but is not human-friendly. Administrators and users will often "
"want to rename their machines with a name that is easier to remember, "
"type, and search for. Renaming a machine also makes it easier to "
"identify, by including meaningful data in the name. The following "
"examples show human-friendly machine names:"
msgstr ""
#: ../../guides/maintenance/hostname.rst:17
msgid "*regression-test*"
msgstr ""
#: ../../guides/maintenance/hostname.rst:18
msgid "*sally-test-box1*"
msgstr ""
#: ../../guides/maintenance/hostname.rst:19
msgid "*az-bldg2-lab*"
msgstr ""
#: ../../guides/maintenance/hostname.rst:22
msgid "Set your hostname"
msgstr ""
#: ../../guides/maintenance/hostname.rst:24
msgid ""
"|CL| uses the :command:`hostnamectl` command to display and modify the "
"machine name. :command:`hostnamectl` is part of the **os-core** bundle, "
"which provides a basic Linux\\* user space and utilities."
msgstr ""
#: ../../guides/maintenance/hostname.rst:28
msgid ""
"This example sets the hostname to *telemetry-test-2-h15*, to identify a "
"|CL| telemetry test machine on the second floor at grid location H15. "
"Make sure to reboot after setting a new hostname."
msgstr ""
#: ../../guides/maintenance/hostname.rst:39
msgid ""
"There are three types of hostname: *static*, *transient*, and *pretty*. "
"The most common is the static hostname. Static hostnames must be between "
"two and 63 characters long, must start and end with a letter or number, "
"and may contain letters (case-insensitive), numbers, dashes, or dots."
msgstr ""
#: ../../guides/maintenance/hostname.rst:44
msgid ""
"If the static hostname exists, it is used to generate the transient "
"hostname, which is maintained by the kernel. The transient hostname can "
"be changed by DHCP or mDNS at runtime."
msgstr ""
#: ../../guides/maintenance/hostname.rst:48
msgid ""
"The pretty hostname is a free-form UTF8 name used for presentation to the"
" user."
msgstr ""
#: ../../guides/maintenance/hostname.rst:51
msgid "View your hostname"
msgstr ""
#: ../../guides/maintenance/hostname.rst:53
msgid "View your current hostname using the following command:"
msgstr ""
#: ../../guides/maintenance/hostname.rst:59
msgid "You should see output similar to:"
msgstr ""
#: ../../guides/maintenance/hostname.rst:74
msgid ""
"**Congratulations!** You successfully modified the hostname of your |CL| "
"system."
msgstr ""
@@ -0,0 +1,245 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:4
msgid "Increase virtual disk size of a |CL-ATTR| image"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:6
msgid ""
"|CL-ATTR| prebuilt images come in different sizes, ranging from 300 MB to"
" 20 GB. This guide describes how to increase the size of your prebuilt "
"|CL| image if you need more capacity."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:10
msgid "This guide will cover:"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:13
msgid "Determine the partition order and sizes of the prebuilt image"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:15
msgid ""
"There are two methods to find the order and sizes of partitions virtual "
"disk of your prebuilt |CL| image."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:18
msgid ""
"In both examples, the prebuilt Hyper-V image has a disk size of 8.5 GB "
"with / dev/sda3 being the partition for the root filesystem (/)"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:22
msgid "Checking :command:`lsblk` on the VM"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:24
msgid ""
"The first method is to boot up your :abbr:`VM (Virtual Machine)` and "
"execute the :command:`lsblk` command as shown below:"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:31
msgid "An example output of the :command:`lsblk` command:"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:41
msgid "An example of this can also be seen in Figure 1."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:44
msgid "Checking :file:`config.json` used to build the image"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:46
msgid ""
"The second method to determine partition to check the :file:`config.json`"
" file used to create prebuilt image, located in the `releases`_ "
"repository. For example, to find the size of the Hyper-V\\* image version"
" number 20450, follow these steps:"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:51
msgid "Go to the `releases`_ repository."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:52
msgid "Drill down into the `20450 > clear > config > image` directory."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:53
msgid "Open the :file:`hyperv-config.json` file."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:54
msgid "Locate the `PartitionLayout` key."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:56
msgid ""
"The example shows 512 MB for the EFI partition, 32 MB for the swap "
"partition, and 8 GB for the root partition."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:76
msgid "Increase virtual disk size"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:77
msgid ""
"Once you have determined the disk and partition to be increased, you are "
"ready to perform the actual increase of the disk, partition, and "
"filesystem."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:81
msgid "Power off VM and increase virtual disk size:"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:83
msgid ""
"To increase the virtual disk size for a prebuilt image, perform the steps"
" below:"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:86
msgid "Shut down your VM if it is running."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:87
msgid ""
"Use the process defined by your hypervisor or cloud provider to increase "
"the virtual disk size of your |CL| VM."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:90
msgid "Power up the VM."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:94
msgid "Resize the partition of the virtual disk:"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:96
msgid "Log in to an account with root privileges."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:97
msgid "Open a terminal emulator."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:98
msgid ""
"Add the |CL| `storage-utils` bundle to install the :command:`parted` and "
":command:`resize2fs` tools."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:105
msgid "Launch the `parted` tool."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:111
msgid "In the `parted` tool, perform these steps:"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:113
msgid "Press :command:`p` to print the partitions table."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:114
msgid "If the warning message below is displayed, enter :command:`Fix`."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:124
msgid ""
"Enter :command:`resizepart [partition number]` where *[partition number]*"
" is the partition number of the partition to modify."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:126
msgid "Enter :command:`yes` when prompted."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:127
msgid "Enter the new `End` size."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:131
msgid ""
"If you want a partition to take up the remaining disk space, then enter "
"the total size of the disk. When you print the partitions table with the "
":command:`p` command, the total disk size is shown after the `Disk` "
"label."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:136
msgid "An example of this can be seen in Figure 1."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:138
msgid ""
"Enter :command:`q` to exit `parted` when you are finished resizing the "
"image."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:141
msgid ""
"Figure 1 depicts the described steps to resize the partition of the "
"virtual disk from 8.5GB to 20GB."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:147
msgid "Figure 1: Increase root partition size."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:150
msgid "Resize the filesytem"
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:152
msgid ""
"Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where "
"*[modified partition name]* is the partition that was changed in "
"`parted`."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:155
msgid "Run the :command:`df -h` to verify that the filesystem size has increased."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:158
msgid ""
"Figure 2 depicts the described steps to resize the partition of the "
"virtual disk from 8.5GB to 20GB."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:164
msgid "Figure 2: Increase root filesystem size after partition has been expanded."
msgstr ""
#: ../../guides/maintenance/increase-virtual-disk-size.rst:166
msgid ""
"Congratulations! You have resized the disk, partition, and filesystem. At"
" this point, the increase in disk capacity is usable."
msgstr ""
Binary file not shown.
@@ -0,0 +1,78 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/time.rst:4
msgid "Set the time"
msgstr ""
#: ../../guides/maintenance/time.rst:6
msgid "|CL-ATTR| uses the `systemd-timesyncd.service` daemon to synchronize time."
msgstr ""
#: ../../guides/maintenance/time.rst:8
msgid ""
"This guide describes how to reset the time in your |CL| system when the "
"default :abbr:`NTP (Network Time Protocol)` servers cannot be reached."
msgstr ""
#: ../../guides/maintenance/time.rst:11
msgid "Install the `sysadmin-basic` bundle."
msgstr ""
#: ../../guides/maintenance/time.rst:17
msgid "Set your time zone. This example uses Los Angeles."
msgstr ""
#: ../../guides/maintenance/time.rst:25
msgid ""
"To see a list of time zones, use the command: :command:`timedatectl list-"
"timezones | grep <locale>`"
msgstr ""
#: ../../guides/maintenance/time.rst:28
msgid "Create a :file:`/etc/systemd/` directory."
msgstr ""
#: ../../guides/maintenance/time.rst:34
msgid ""
"Create a new file named :file:`/etc/systemd/timesyncd.conf` and enter the"
" following text."
msgstr ""
#: ../../guides/maintenance/time.rst:43
msgid "Enable the `systemd-timesyncd` service."
msgstr ""
#: ../../guides/maintenance/time.rst:51
msgid ""
"To check the service status, use the :command:`timedatectl status` "
"command."
msgstr ""
#: ../../guides/maintenance/time.rst:53
msgid ""
"To restart the `timesyncd` daemon, enter :command:`systemctl restart "
"systemd-timesyncd` into your terminal emulator."
msgstr ""
#: ../../guides/maintenance/time.rst:56
msgid "**Congratulations!** You successfully set up the time in your |CL| system."
msgstr ""
@@ -0,0 +1,142 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/validate-signatures.rst:4
msgid "Validate signatures"
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:6
msgid ""
"|CL-ATTR| offers a way to validate the content of an image or an update. "
"All validation of content works by creating and signing a hash. A valid "
"signature creates a chain of trust. A broken chain of trust, seen as an "
"invalid signature, means the content is not valid."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:11
msgid ""
"This guide covers how to validate the contents of an image, which is a "
"manual process and is the same process ``swupd`` performs internally to "
"validate an update."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:18
msgid "Image content validation"
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:20
msgid ""
"For the outlined steps, the installer image of the latest release of |CL|"
" is used for illustrative purposes. You may use any image of |CL| you "
"choose."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:23
msgid ""
"Download the image, the signature of the SHA512 sum of the image, and the"
" |CL| certificate used for signing the SHA512 sum."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:35
msgid "Generate the SHA256 sum of the |CL| certificate."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:41
msgid ""
"Ensure the generated SHA256 sum of the |CL| certificate matches the "
"following SHA256 sum to verify the integrity of the certificate."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:48
msgid "Generate the SHA512 sum of the image and save it to a file."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:54
msgid ""
"Ensure the signature of the SHA512 sum of the image was created using the"
" |CL| certificate. This validates the image is trusted and it has not "
"been modified."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:64
#: ../../guides/maintenance/validate-signatures.rst:115
msgid ""
"The `-purpose any` option is required when using OpenSSL 1.1. If using "
"an earlier version of OpenSSL, omit this option to perform signature "
"validation. The `openssl version` command may be used to determine the "
"version of OpenSSL in use."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:69
msgid ""
"The output should contain ``Verification successful``. If the output "
"contains ``bad_signature`` anywhere, then the image is not trustworthy."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:73
msgid "Update content validation"
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:75
msgid ""
"``swupd`` validates all update content automatically before applying the "
"update content. The process ``swupd`` follows internally is illustrated "
"here with manual steps using the latest |CL| release. There is no need to"
" perform these steps manually when performing a ``swupd update``."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:80
msgid ""
"Download the :abbr:`MoM (top-level manifest)`, the signature of the MoM, "
"and the Swupd certificate used for signing the signature of the MoM."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:92
msgid "Generate the SHA256 sum of the Swupd certificate."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:98
msgid ""
"Ensure the generated SHA256 sum of the Swupd certificate matches "
"following SHA256 sum to verify the integrity of the certificate."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:105
msgid ""
"Ensure the signature of the MoM was created using the Swupd certificate. "
"This signature validates the update content is trustworthy and has not "
"been modified."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:122
msgid ""
"The SHA512 sum of the MoM is not generated and then signed. Instead, the "
"MoM is signed directly because it is small in size compared to an image "
"of |CL|."
msgstr ""
#: ../../guides/maintenance/validate-signatures.rst:126
msgid ""
"The output should contain ``Verification successful``. If the output "
"contains ``bad_signature`` anywhere, then the MoM cannot be trusted. "
"Because the MoM contains a list of hashes for bundle manifests, if the "
"MoM cannot be trusted, then the bundle content cannot be trusted."
msgstr ""
@@ -0,0 +1,177 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/network/custom-clear-container.rst:4
msgid "Build a custom |CL-ATTR| based Docker container image"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:6
msgid ""
"The official base |CL-ATTR| container image is published on Docker\\* Hub"
" and is updated on a regular basis. This guide contains the steps to "
"build a custom container image."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:11
msgid "Prerequisites"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:13
msgid ""
"You must perform these steps on a |CL| system because the :abbr:`swupd "
"(software updater)` is used to manage bundles in the container."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:16
msgid ""
"You must install the :file:`containers-basic` bundle on the |CL| system "
"or Docker will not work."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:18
msgid "You have a basic understanding of Docker."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:21
msgid "Build the base container image"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:23
msgid "Log in and get root privileges."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:29
msgid "Verify Docker is installed and running."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:35
msgid "If Docker is installed and running, the output is similar to this example:"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:78
msgid "If Docker is not installed, enter the commands:"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:85
msgid "Use `os-install` to download and install the bundles."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:92
msgid "The `swupd` example uses the following flags:"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:94
msgid ":command:`os-install` tells `swupd` to download and install."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:95
msgid ":command:`-V / --version` specifies the version of the |CL| bundles."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:96
msgid ":command:`--url` specifies the URL of the bundles repository."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:97
msgid ""
":command:`--statedir` specifies the state directory where downloaded "
"bundles and any state information are stored."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:99
msgid ""
":command:`--no-boot-update` tells `swupd` to skip updating boot files "
"because boot files are not required for a container."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:102
msgid ""
"For more information on `swupd` flags, enter the :command:`swupd os-"
"install -h` command."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:104
#: ../../guides/network/custom-clear-container.rst:167
#: ../../guides/network/custom-clear-container.rst:194
#: ../../guides/network/custom-clear-container.rst:228
#: ../../guides/network/custom-clear-container.rst:290
msgid "Example output:"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:141
msgid "The `WARNING` message is expected and can be ignored."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:143
msgid "Create a tarball and compress it."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:150
msgid "Create the Dockerfile to build the image."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:161
msgid "Build the |CL| container image."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:188
msgid "List the newly created |CL| container image."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:201
msgid "Launch the built |CL| container."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:208
msgid "Manage bundles in a container"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:210
msgid ""
"You can add and remove bundles from a |CL| container using the "
":command:`RUN swupd` command in the Dockerfile."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:214
msgid "Add a bundle"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:216
msgid ""
"This example Dockerfile adds the :file:`pxe-server` bundle to an existing"
" |CL| Docker image:"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:272
msgid ""
"The `WARNING` message can be ignored because systemd does not run inside "
"a container."
msgstr ""
#: ../../guides/network/custom-clear-container.rst:276
msgid "Remove a bundle"
msgstr ""
#: ../../guides/network/custom-clear-container.rst:278
msgid ""
"This example Dockerfile removes the :file:`pxe-server` bundle from an "
"existing |CL| Docker image:"
msgstr ""
Binary file not shown.
@@ -0,0 +1,376 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/network/dpdk.rst:4
msgid "Use DPDK to send packets between platforms"
msgstr ""
#: ../../guides/network/dpdk.rst:6
msgid ""
"This document describes how to send packets between two platforms in the "
"simple configuration shown in :ref:`Figure 1 <f1>`. The example uses the "
":abbr:`Data Plane Development Kit (DPDK)`, which is a set of libraries, "
"drivers, sample applications, and tools for fast packet processing."
msgstr ""
#: ../../guides/network/dpdk.rst:17
msgid "Figure 1: Environment for l3fwd DPDK application"
msgstr ""
#: ../../guides/network/dpdk.rst:19
msgid "This example uses the following DPDK components:"
msgstr ""
#: ../../guides/network/dpdk.rst:21
msgid "pktgen: Traffic generator. See `pktgen documentation`_ for details."
msgstr ""
#: ../../guides/network/dpdk.rst:22
msgid ""
"l3fwd: Layer 3 forwarding example application. See `l3fwd documentation`_"
" for details."
msgstr ""
#: ../../guides/network/dpdk.rst:26
msgid "Prerequisites"
msgstr ""
#: ../../guides/network/dpdk.rst:28
msgid "Two platforms using |CL-ATTR| release `13330`_ or higher."
msgstr ""
#: ../../guides/network/dpdk.rst:29
msgid "Both images must include the :file:`kernel-native bundle`."
msgstr ""
#: ../../guides/network/dpdk.rst:30
msgid "Install the :file:`network-basic-dev` bundle with the command:"
msgstr ""
#: ../../guides/network/dpdk.rst:36
msgid ""
"Each platform must have at least one :abbr:`NIC (Network Interface "
"Card)`. Check the `DPDK project`_ for the list of supported `dpdk.org "
"NICs`_."
msgstr ""
#: ../../guides/network/dpdk.rst:39
msgid "Two network cables."
msgstr ""
#: ../../guides/network/dpdk.rst:42
msgid "Install dpdk and build l3fwd example (Platform B)"
msgstr ""
#: ../../guides/network/dpdk.rst:44
msgid "Change to the :file:`l3fwd` example directory."
msgstr ""
#: ../../guides/network/dpdk.rst:50
msgid "Assign :envvar:`RTE_SDK` variable to the makefiles path."
msgstr ""
#: ../../guides/network/dpdk.rst:56
msgid ""
"Assign :envvar:`RTE_TARGET` variable to the location of the gcc\\* config"
" file."
msgstr ""
#: ../../guides/network/dpdk.rst:63
msgid ""
"Build the `l3fwd` application and add the configuration header to the "
":makevar:`CFLAGS` variable."
msgstr ""
#: ../../guides/network/dpdk.rst:72
msgid "Build pktgen (Platform A)"
msgstr ""
#: ../../guides/network/dpdk.rst:74
msgid "Download the `pktgen tar package`_ v3.1.2 or newer."
msgstr ""
#: ../../guides/network/dpdk.rst:76
msgid "Decompress packages and move to uncompressed source directory."
msgstr ""
#: ../../guides/network/dpdk.rst:78
msgid "Assign :envvar:`RTE_SDK` variable to the path where makefiles are located."
msgstr ""
#: ../../guides/network/dpdk.rst:84
msgid "Assign :envvar:`RTE_TARGET` to the location of the gcc config file."
msgstr ""
#: ../../guides/network/dpdk.rst:90
msgid ""
"Build the `pktgen` project and set the "
":makevar:`CONFIG_RTE_BUILD_SHARED_LIB` variable to \"n\"."
msgstr ""
#: ../../guides/network/dpdk.rst:98
msgid "Bind NICs to DPDK kernel drivers (Platforms A and B)"
msgstr ""
#: ../../guides/network/dpdk.rst:100
msgid ""
"The `l3fwd` application uses two NICs. The DPDK includes tools for "
"binding NICs to DPDK modules to run DPDK applications."
msgstr ""
#: ../../guides/network/dpdk.rst:103
msgid "Load the DPDK I/O kernel module."
msgstr ""
#: ../../guides/network/dpdk.rst:109
msgid ""
"Check the NIC status to determine which network cards are not busy. When "
"another application is using them, the status shows `Active`, and those "
"NICs cannot be bound."
msgstr ""
#: ../../guides/network/dpdk.rst:117
msgid ""
"Bind two available NICs. The general syntax for binding is: :command"
":`dpdk-devbind --bind=vfio-pci <device-entry>`. A working example is "
"shown below:"
msgstr ""
#: ../../guides/network/dpdk.rst:125
msgid ""
"Check the NIC status to verify that the NICs are bound correctly. If "
"successful, `drv` displays the value `igb_uio`, which confirms that the "
"NICs are using the DPDK modules."
msgstr ""
#: ../../guides/network/dpdk.rst:131
msgid "Set hugepages (Platforms A and B)"
msgstr ""
#: ../../guides/network/dpdk.rst:133
msgid ""
"|CL| supports `hugepages` for the large memory pool allocation used for "
"packet buffers."
msgstr ""
#: ../../guides/network/dpdk.rst:136
msgid "Set the number of hugepages."
msgstr ""
#: ../../guides/network/dpdk.rst:142
msgid "Allocate pages on NUMA machines."
msgstr ""
#: ../../guides/network/dpdk.rst:149
msgid "Make memory available for DPDK."
msgstr ""
#: ../../guides/network/dpdk.rst:155
msgid ""
"For more information, refer to the `DPDK guide`_ System Requirements "
"section."
msgstr ""
#: ../../guides/network/dpdk.rst:160
msgid "Set up the physical environment (Platforms A and B)"
msgstr ""
#: ../../guides/network/dpdk.rst:162
msgid ""
"Connect the NICs on Platform A to the NICs on Platform B using the "
"network cables as shown in :ref:`Figure 2<f2>`."
msgstr ""
#: ../../guides/network/dpdk.rst:169
msgid "Figure 2: Physical network environment"
msgstr ""
#: ../../guides/network/dpdk.rst:173
msgid "Run l3fwd application (Platform B)"
msgstr ""
#: ../../guides/network/dpdk.rst:175
msgid ""
"The `l3fwd` application is one of the DPDK examples available when you "
"install the :file:`dpdk-dev` bundle. `l3fwd` forwards packets from one "
"NIC to another. For details, refer to the `l3fwd documentation`_."
msgstr ""
#: ../../guides/network/dpdk.rst:179
msgid "Open the l3fwd example directory."
msgstr ""
#: ../../guides/network/dpdk.rst:185
msgid "**This step is very important.**"
msgstr ""
#: ../../guides/network/dpdk.rst:187
msgid "DPDK needs poll mode drivers to operate."
msgstr ""
#: ../../guides/network/dpdk.rst:188
msgid "Poll mode drivers are shared objects in :file:`/usr/lib64`."
msgstr ""
#: ../../guides/network/dpdk.rst:189
msgid "See the full list of supported NICs at `dpdk.org NICs`_."
msgstr ""
#: ../../guides/network/dpdk.rst:190
msgid ""
"You must know which kernel module each NIC is using and choose a poll "
"mode driver that corresponds to your NICs."
msgstr ""
#: ../../guides/network/dpdk.rst:193
msgid ""
"NIC binding and `pktgen` configuration depends upon network use cases and"
" available system resources. Use the :command:`-d` flag to set the poll "
"mode driver."
msgstr ""
#: ../../guides/network/dpdk.rst:197
msgid ""
"The following example assumes that the NICs use the `e1000` network "
"driver and the `e1000` poll mode driver. The :file:`librte_pmd_e1000.so` "
"is located in :file:`/usr/lib64` in |CL|."
msgstr ""
#: ../../guides/network/dpdk.rst:205
msgid ""
"The `l3fwd` application shows port initialization details at startup. "
"After port 0 initialization completes, `l3fwd` shows a MAC address and "
"information for port 1."
msgstr ""
#: ../../guides/network/dpdk.rst:209
msgid "Save the MAC address for configuring the `pktgen` project."
msgstr ""
#: ../../guides/network/dpdk.rst:212
msgid "Run pktgen application (Platform A)"
msgstr ""
#: ../../guides/network/dpdk.rst:214
msgid "`pktgen` is a network traffic generator included in the DPDK."
msgstr ""
#: ../../guides/network/dpdk.rst:216
msgid ""
"`pktgen` configuration depends upon the network setup and the available "
"system resources. The following example shows a basic configuration."
msgstr ""
#: ../../guides/network/dpdk.rst:224
msgid "Enable active colorful output (optional)."
msgstr ""
#: ../../guides/network/dpdk.rst:230
msgid ""
"Use the MAC addresses shown by the `l3fwd` application during "
"initialization. The command to set the MAC addresses in `pktgen` has the "
"format:"
msgstr ""
#: ../../guides/network/dpdk.rst:237 ../../guides/network/dpdk.rst:296
#: ../../guides/network/dpdk.rst:314
msgid "Here is a working example:"
msgstr ""
#: ../../guides/network/dpdk.rst:244
msgid "Send packets."
msgstr ""
#: ../../guides/network/dpdk.rst:250
msgid "For more details, see the `pktgen documentation`_."
msgstr ""
#: ../../guides/network/dpdk.rst:253
msgid "Appendix A: Use pass-through for virtual machines"
msgstr ""
#: ../../guides/network/dpdk.rst:255
msgid ""
"This section explains how to set up a virtual environment where virtual "
"machines control the NICs on the host."
msgstr ""
#: ../../guides/network/dpdk.rst:258
msgid "Create a new directory and move to it."
msgstr ""
#: ../../guides/network/dpdk.rst:260
msgid ""
"Download or create a :file:`start_qemu.sh` script for running a kvm "
"virtual machine:"
msgstr ""
#: ../../guides/network/dpdk.rst:267
msgid "Download a bare-metal image of |CL| and rename it as :file:`clear.img`."
msgstr ""
#: ../../guides/network/dpdk.rst:269
msgid "Look for an Ethernet\\* device entry that contains vendor and device ID:"
msgstr ""
#: ../../guides/network/dpdk.rst:275
msgid "An example output:"
msgstr ""
#: ../../guides/network/dpdk.rst:281
msgid ""
"where `03:00.0` is the device entry and `8086:1521` is the `vendor:device"
" ID`. Record this information, because you need it to unbind the NICs "
"from a host."
msgstr ""
#: ../../guides/network/dpdk.rst:286
msgid ""
"Unbind the NICs from the host to do pass-through with virtual machines. "
"|CL| supports this action. The commands take the format:"
msgstr ""
#: ../../guides/network/dpdk.rst:305
msgid ""
"Assign the unbound NICs to the KVM virtual machine (guest). Modify the "
":file:`start_qemu.sh` script in `qemu-system-x86_64` arguments, and add "
"the lines with the host's NICs information in the format:"
msgstr ""
#: ../../guides/network/dpdk.rst:321
msgid ""
"Add more NUMA machines to the virtual machine by adding lines to the "
"Makefile boot target in the format:"
msgstr ""
#: ../../guides/network/dpdk.rst:328
msgid ""
"Here is a working example for a virtual machine with 4096 memory and four"
" CPUs:"
msgstr ""
#: ../../guides/network/dpdk.rst:336
msgid "Each NUMA machine must use the same quantity of memory."
msgstr ""
#: ../../guides/network/dpdk.rst:338
msgid "Run the :file:`start_qemu.sh` script."
msgstr ""
Binary file not shown.
@@ -0,0 +1,314 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/network/ipxe-install.rst:4
msgid "Install |CL-ATTR| over the network with iPXE"
msgstr ""
#: ../../guides/network/ipxe-install.rst:6
msgid ""
"This guide describes how to install |CL-ATTR| using :abbr:`PXE (Pre-boot "
"Execution Environment)`."
msgstr ""
#: ../../guides/network/ipxe-install.rst:9
msgid ""
"PXE is an industry standard that describes client-server interaction with"
" network-boot software and uses the DHCP and TFTP protocols. This guide "
"shows one method of using the PXE environment to install |CL|."
msgstr ""
#: ../../guides/network/ipxe-install.rst:13
msgid ""
"The PXE extension called `iPXE`_ adds support for additional protocols "
"such as HTTP, :abbr:`iSCSI (Internet Small Computer Systems Interface)`, "
":abbr:`AoE (ATA over Ethernet\\*)`, and :abbr:`FCoE (Fiber Channel over "
"Ethernet\\*)`. iPXE enables network booting on computers with no built-in"
" PXE support."
msgstr ""
#: ../../guides/network/ipxe-install.rst:18
msgid ""
"To install |CL| through iPXE, you must create a PXE client. Figure 1 "
"depicts the flow of information between a PXE server and a PXE client."
msgstr ""
#: ../../guides/network/ipxe-install.rst:24
msgid "Figure 1: PXE information flow."
msgstr ""
#: ../../guides/network/ipxe-install.rst:28
msgid ""
"The |CL| image that boots through the PXE process automatically erases "
"all data and partitions on the PXE client system and creates 3 new "
"partitions to install onto."
msgstr ""
#: ../../guides/network/ipxe-install.rst:33
msgid "Prerequisites"
msgstr ""
#: ../../guides/network/ipxe-install.rst:35
msgid "Before booting with iPXE, make the following preparations."
msgstr ""
#: ../../guides/network/ipxe-install.rst:37
msgid ""
"Connect the PXE server and PXE clients to a switch on a private network, "
"as shown in Figure 2."
msgstr ""
#: ../../guides/network/ipxe-install.rst:43
msgid "Figure 2: Network topology."
msgstr ""
#: ../../guides/network/ipxe-install.rst:45
msgid ""
"Your PXE client must have a boot order where the network boot option is "
"prioritized before the disk boot option."
msgstr ""
#: ../../guides/network/ipxe-install.rst:48
msgid "Your PXE server must have:"
msgstr ""
#: ../../guides/network/ipxe-install.rst:50
msgid "Ethernet/LAN boot option."
msgstr ""
#: ../../guides/network/ipxe-install.rst:51
msgid "At least two network adapters."
msgstr ""
#: ../../guides/network/ipxe-install.rst:52
msgid "Connection to a public network."
msgstr ""
#: ../../guides/network/ipxe-install.rst:53
msgid "Secure boot option disabled."
msgstr ""
#: ../../guides/network/ipxe-install.rst:57
msgid ""
"You must disable the secure boot option in the BIOS because the UEFI "
"binaries used to boot |CL| are not signed."
msgstr ""
#: ../../guides/network/ipxe-install.rst:62
msgid "Configuration"
msgstr ""
#: ../../guides/network/ipxe-install.rst:64
msgid ""
"To set up |CL| using iPXE automatically, use the :file:`configure-"
"ipxe.sh` script included with :abbr:`ICIS (Ister Cloud Init Service)`. "
"For additional instructions on the script, refer to the guide on the "
"`ICIS GitHub repository`_."
msgstr ""
#: ../../guides/network/ipxe-install.rst:68
msgid "To set up |CL| manually, perform the steps below."
msgstr ""
#: ../../guides/network/ipxe-install.rst:70
msgid "Define the variables used for iPXE boot configuration."
msgstr ""
#: ../../guides/network/ipxe-install.rst:86
msgid "Log in and get root privilege."
msgstr ""
#: ../../guides/network/ipxe-install.rst:92
msgid ""
"Add the `pxe-server` bundle to your |CL| system. The bundle contains all "
"files needed to run a PXE server."
msgstr ""
#: ../../guides/network/ipxe-install.rst:99
msgid ""
"Download the latest network-bootable release of |CL| and extract the "
"files."
msgstr ""
#: ../../guides/network/ipxe-install.rst:113
msgid ""
"Ensure that the initial ramdisk file is named :file:`initrd` and the "
"kernel file is named :file:`linux`, which is a symbolic link to the "
"actual kernel file."
msgstr ""
#: ../../guides/network/ipxe-install.rst:117
msgid ""
"Create an iPXE boot script with the following contents. During an iPXE "
"boot, the iPXE boot script directs the PXE client to download the files "
"to boot and install |CL|. Use the names previously given to the initial "
"ramdisk and kernel files."
msgstr ""
#: ../../guides/network/ipxe-install.rst:133
msgid ""
"The `pxe-server` bundle contains a lightweight web-server known as "
"`nginx`. Create a configuration file for `nginx` to serve |CL| to PXE "
"clients with the following contents:"
msgstr ""
#: ../../guides/network/ipxe-install.rst:155
msgid ""
"Create a separate `nginx` configuration file to serve network-bootable "
"images on a non-standard port number. This action saves existing `nginx` "
"configurations."
msgstr ""
#: ../../guides/network/ipxe-install.rst:159
msgid "Start `nginx` and enable the startup on boot option."
msgstr ""
#: ../../guides/network/ipxe-install.rst:166
msgid ""
"The `pxe-server` bundle contains a lightweight DNS server which conflicts"
" with the DNS stub listener provided in `systemd-resolved`. Disable the "
"DNS stub listener and temporarily stop `systemd-resolved`."
msgstr ""
#: ../../guides/network/ipxe-install.rst:180
msgid ""
"Assign a static IP address to the network adapter for the private network"
" and restart `systemd-networkd` with the following commands:"
msgstr ""
#: ../../guides/network/ipxe-install.rst:196
msgid ""
"Configure :abbr:`NAT (Network Address Translation)` to route traffic from"
" the private network to the public network. This action makes the PXE "
"server act as a router. To make these changes persistent during reboots, "
"save the changes to the firewall with the following commands:"
msgstr ""
#: ../../guides/network/ipxe-install.rst:212
msgid ""
"The firewall masks packets to make them appear as coming from the PXE "
"server and hides PXE clients from the public network."
msgstr ""
#: ../../guides/network/ipxe-install.rst:215
msgid ""
"Configure the kernel to forward network packets to different interfaces. "
"Otherwise, NAT will not work."
msgstr ""
#: ../../guides/network/ipxe-install.rst:224
msgid ""
"The `pxe-server` bundle contains iPXE firmware images that allow "
"computers without an iPXE implementation to perform an iPXE boot. Create "
"a TFTP hosting directory and populate the directory with the iPXE "
"firmware images with the following commands:"
msgstr ""
#: ../../guides/network/ipxe-install.rst:234
msgid ""
"The `pxe-server` bundle contains a lightweight TFTP, DNS, and DHCP server"
" known as `dnsmasq`. Create a configuration file for `dnsmasq` to listen "
"on a dedicated IP address for those functions. PXE clients on the private"
" network will use this IP address."
msgstr ""
#: ../../guides/network/ipxe-install.rst:245
msgid ""
"Add the options to serve iPXE firmware images to PXE clients over TFTP to"
" the `dnsmasq` configuration file."
msgstr ""
#: ../../guides/network/ipxe-install.rst:255
msgid ""
"Add the options to host a DHCP server for PXE clients to the `dnsmasq` "
"configuration file."
msgstr ""
#: ../../guides/network/ipxe-install.rst:277
msgid "The configuration provides the following important functions:"
msgstr ""
#: ../../guides/network/ipxe-install.rst:279
msgid ""
"Directs PXE clients without an iPXE implementation to the TFTP server to "
"acquire architecture-specific iPXE firmware images that allow them to "
"perform an iPXE boot."
msgstr ""
#: ../../guides/network/ipxe-install.rst:282
msgid ""
"Activates only on the network adapter that has an IP address on the "
"defined subnet."
msgstr ""
#: ../../guides/network/ipxe-install.rst:284
msgid "Directs PXE clients to the DNS server."
msgstr ""
#: ../../guides/network/ipxe-install.rst:285
msgid "Directs PXE clients to the PXE server for routing via NAT."
msgstr ""
#: ../../guides/network/ipxe-install.rst:286
msgid ""
"Divides the private network into two pools of IP addresses. One pool is "
"for network boot and one pool is used after boot. Each pool has their own"
" lease times."
msgstr ""
#: ../../guides/network/ipxe-install.rst:290
msgid ""
"Create a file for `dnsmasq` to record the IP addresses it provides to PXE"
" clients."
msgstr ""
#: ../../guides/network/ipxe-install.rst:298
msgid "Start `dnsmasq` and enable startup on boot."
msgstr ""
#: ../../guides/network/ipxe-install.rst:305
msgid "Start `systemd-resolved`."
msgstr ""
#: ../../guides/network/ipxe-install.rst:313
msgid ""
"`systemd-resolved` dynamically updates the list of DNS servers for the "
"private network if you use the `dnsmasq` DNS server. The setup creates a "
"pass-through DNS server that relies on the DNS servers listed in "
":file:`/etc/resolv.conf`."
msgstr ""
#: ../../guides/network/ipxe-install.rst:318
msgid "Power on the PXE client and watch the client boot and install |CL|."
msgstr ""
#: ../../guides/network/ipxe-install.rst:320
msgid ""
"After booting, |CL| automatically partitions the hard drive, installs "
"itself, updates to the latest version, and reboots."
msgstr ""
#: ../../guides/network/ipxe-install.rst:324
msgid ""
"**Congratulations!** You have successfully installed and configured a PXE"
" server that enables PXE clients to boot and install |CL| over the "
"network."
msgstr ""
@@ -0,0 +1,153 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/network/network-bonding.rst:4
msgid "Combine multiple interfaces with network bonding"
msgstr ""
#: ../../guides/network/network-bonding.rst:6
msgid ""
"Network bonding combines multiple network interfaces into a single "
"logical interface to provide redundancy and bandwidth aggregation."
msgstr ""
#: ../../guides/network/network-bonding.rst:9
msgid ""
"|CL-ATTR| includes Linux bonding_ and team_ drivers. This guide describes"
" how to configure systemd to use the `bonding` driver."
msgstr ""
#: ../../guides/network/network-bonding.rst:12
msgid "The example demonstrates how to:"
msgstr ""
#: ../../guides/network/network-bonding.rst:14
msgid "Bond all four ports of a quad-port NIC in `802.3ad` mode."
msgstr ""
#: ../../guides/network/network-bonding.rst:16
msgid "Enable jumbo frames to optimize large data transfers on the local network."
msgstr ""
#: ../../guides/network/network-bonding.rst:18
msgid ""
"Your NICs and network switch must support `802.3ad` mode and jumbo "
"frames. The example explains how to configure your NICs for both "
"features. Your switch may require additional configuration. See your "
"switch documentation for details."
msgstr ""
#: ../../guides/network/network-bonding.rst:24
msgid "You must run all commands in this guide as root."
msgstr ""
#: ../../guides/network/network-bonding.rst:26
msgid "Log in and get root privileges."
msgstr ""
#: ../../guides/network/network-bonding.rst:32
msgid "Create the :file:`/etc/systemd/network` directory."
msgstr ""
#: ../../guides/network/network-bonding.rst:38
msgid ""
"The :file:`/etc/systemd/network` directory contains configuration files "
"and network settings for the virtual device and its underlying physical "
"interfaces."
msgstr ""
#: ../../guides/network/network-bonding.rst:42
msgid ""
"Configure systemd to create a virtual network device called `bond1`. Use "
"a text editor to create a file named :file:`30-bond1.netdev`."
msgstr ""
#: ../../guides/network/network-bonding.rst:57
msgid ""
"Refer to the systemd.netdev_ manpage for :file:`30-bond1.netdev` file "
"syntax. This example is based on Example 9 on the manpage. Modify the "
"example for your configuration."
msgstr ""
#: ../../guides/network/network-bonding.rst:61
msgid ""
"Configure the slave interfaces. Create a text file named "
":file:`30-bond1-enp1s0.network`. Assign the slave interfaces to the "
"virtual `bond1` device and use the syntax shown in systemd.network_."
msgstr ""
#: ../../guides/network/network-bonding.rst:76
msgid ""
"The example bonds all four ports of a quad-port NIC as a slave of "
"`bond1`. The example uses a wildcard match because the NIC names are in "
"the range `enp1s0f0-enp1s0f3`. If your NIC names are not wildcard-"
"compatible, create a separate :file:`.network` file for each NIC."
msgstr ""
#: ../../guides/network/network-bonding.rst:81
msgid ""
"For best results, do not assign addresses or DHCP support to the "
"individual NICs."
msgstr ""
#: ../../guides/network/network-bonding.rst:84
msgid ""
"The `MTUBytes` setting enables jumbo frames of up to 9000 bytes. Your "
"switch may require additional configuration to support this setting."
msgstr ""
#: ../../guides/network/network-bonding.rst:87
msgid "Configure the bonded interface in a file named :file:`30-bond1.network`."
msgstr ""
#: ../../guides/network/network-bonding.rst:101
msgid "`bond1` is a virtual interface with no physical link status."
msgstr ""
#: ../../guides/network/network-bonding.rst:103
msgid ""
"`BindCarrier` indicates that the `bond1` link status is determined by the"
" status of the listed slave devices."
msgstr ""
#: ../../guides/network/network-bonding.rst:106
msgid ""
"`Address` contains an IP address that you assign to the logical "
"interface. DHCP bonded interfaces are complex and outside the scope of "
"this example."
msgstr ""
#: ../../guides/network/network-bonding.rst:109
msgid ""
"`MTUBytes` must be set to 9000 on all slave interfaces and on the bonded "
"interface for successful jumbo frames operation. If `MTUBytes` is not the"
" same on all interfaces, then the lowest value is used."
msgstr ""
#: ../../guides/network/network-bonding.rst:113
msgid "Apply the new network configuration with the command:"
msgstr ""
#: ../../guides/network/network-bonding.rst:119
msgid ""
"The `MTUBytes` settings do not take effect until you reboot or manually "
"apply the settings with a utility such as `ifconfig`."
msgstr ""
Binary file not shown.
+921
View File
@@ -0,0 +1,921 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/network/vnc.rst:4
msgid "Remote-desktop to a |CL-ATTR| host using VNC"
msgstr ""
#: ../../guides/network/vnc.rst:6
msgid ""
":abbr:`VNC (Virtual Network Computing)` is a client-server GUI-based tool"
" that allows you to connect via remote-desktop to your |CL-ATTR| host."
msgstr ""
#: ../../guides/network/vnc.rst:9
msgid "This guide shows you how to:"
msgstr ""
#: ../../guides/network/vnc.rst:11
msgid "Install the VNC server and misc. components on your |CL| host."
msgstr ""
#: ../../guides/network/vnc.rst:12
msgid "Configure a VNC-server-start method on your |CL| host."
msgstr ""
#: ../../guides/network/vnc.rst:13
msgid "Install a VNC viewer app and an SSH client on your client system."
msgstr ""
#: ../../guides/network/vnc.rst:14
msgid "Establish a VNC connection to your |CL| host."
msgstr ""
#: ../../guides/network/vnc.rst:15
msgid "Terminate a VNC connection to your |CL| host."
msgstr ""
#: ../../guides/network/vnc.rst:16
msgid "Encrypt VNC traffic through an SSH tunnel."
msgstr ""
#: ../../guides/network/vnc.rst:19
msgid "Install the VNC server and misc. components on your host"
msgstr ""
#: ../../guides/network/vnc.rst:21
msgid "To configure VNC to work on your |CL| host, install these bundles:"
msgstr ""
#: ../../guides/network/vnc.rst:23
msgid ""
"`desktop-autostart`: Installs :abbr:`GDM (Gnome Desktop Manager)`, sets "
"it to start automatically on boot, and installs TigerVNC Viewer."
msgstr ""
#: ../../guides/network/vnc.rst:25
msgid "`vnc-server`: Installs the TigerVNC server."
msgstr ""
#: ../../guides/network/vnc.rst:27
msgid "Follow these steps:"
msgstr ""
#: ../../guides/network/vnc.rst:29
msgid "Log into your |CL| host and get root privileges."
msgstr ""
#: ../../guides/network/vnc.rst:35
msgid "Install the |CL| bundles."
msgstr ""
#: ../../guides/network/vnc.rst:41
msgid "Reboot your |CL| host."
msgstr ""
#: ../../guides/network/vnc.rst:44
msgid "Configure a VNC-server-start method on your host"
msgstr ""
#: ../../guides/network/vnc.rst:46
msgid ""
"There are three methods you can use to configure and start the VNC server"
" on your |CL| host:"
msgstr ""
#: ../../guides/network/vnc.rst:49
msgid "Table 1: VNC-server-start Configuration Methods"
msgstr ""
#: ../../guides/network/vnc.rst:53
msgid "Attribute"
msgstr ""
#: ../../guides/network/vnc.rst:54
msgid "`Method 1`: Manually start a VNC session"
msgstr ""
#: ../../guides/network/vnc.rst:55
msgid "`Method 2`: Automatically start a VNC session via a systemd service script"
msgstr ""
#: ../../guides/network/vnc.rst:56
msgid "`Method 3`: Create multi-user logins with authentication through GDM"
msgstr ""
#: ../../guides/network/vnc.rst:57
msgid "Description"
msgstr ""
#: ../../guides/network/vnc.rst:58
msgid ""
"This is the traditional method where you SSH into the |CL| host, manually"
" start a VNC session to get a display ID, and connect to it by supplying "
"the display ID."
msgstr ""
#: ../../guides/network/vnc.rst:61
msgid ""
"The system administrator sets up a systemd service script for you with a "
"pre-assigned display ID. You make a VNC connection and supply your pre-"
"assigned display ID."
msgstr ""
#: ../../guides/network/vnc.rst:64
msgid ""
"The system adminstrator configures GDM to accept connection requests. "
"When you make a VNC connection to the |CL| host, you see the GDM login "
"screen and authenticate as if you are local."
msgstr ""
#: ../../guides/network/vnc.rst:67
msgid "Who configures VNC settings?"
msgstr ""
#: ../../guides/network/vnc.rst:68 ../../guides/network/vnc.rst:72
#: ../../guides/network/vnc.rst:76 ../../guides/network/vnc.rst:77
msgid "You"
msgstr ""
#: ../../guides/network/vnc.rst:69 ../../guides/network/vnc.rst:70
msgid "System adminstrator"
msgstr ""
#: ../../guides/network/vnc.rst:71
msgid "Who starts VNC session?"
msgstr ""
#: ../../guides/network/vnc.rst:73 ../../guides/network/vnc.rst:74
msgid "Set to start automatically on boot by system administrator"
msgstr ""
#: ../../guides/network/vnc.rst:75
msgid "Who ends VNC sesssion?"
msgstr ""
#: ../../guides/network/vnc.rst:78
msgid "System administrator can disable VNC service altogether"
msgstr ""
#: ../../guides/network/vnc.rst:79
msgid "Requires VNC password to authenticate?"
msgstr ""
#: ../../guides/network/vnc.rst:80 ../../guides/network/vnc.rst:81
msgid "Yes"
msgstr ""
#: ../../guides/network/vnc.rst:82
msgid "No. Use |CL| account username and password through GDM"
msgstr ""
#: ../../guides/network/vnc.rst:85
msgid ""
"Although all three methods can coexist on the same |CL| host, we "
"recommend you pick a method that suits your needs."
msgstr ""
#: ../../guides/network/vnc.rst:88
msgid ""
"For simplicity, the rest of this guide refers to these methods as `Method"
" 1`, `Method 2`, and `Method 3`."
msgstr ""
#: ../../guides/network/vnc.rst:92
msgid "Method 1: Manually start a VNC session"
msgstr ""
#: ../../guides/network/vnc.rst:94
msgid ""
"You (and each user) must perform these steps to initialize your VNC "
"settings."
msgstr ""
#: ../../guides/network/vnc.rst:96
msgid "Log in."
msgstr ""
#: ../../guides/network/vnc.rst:97 ../../guides/network/vnc.rst:557
msgid "Open a terminal emulator."
msgstr ""
#: ../../guides/network/vnc.rst:98
msgid ""
"Start VNC with the :command:`vncserver` command. Since this is your "
"first time starting VNC, it adds default configuration files and asks you"
" to set a VNC password."
msgstr ""
#: ../../guides/network/vnc.rst:106 ../../guides/network/vnc.rst:431
msgid "Example output:"
msgstr ""
#: ../../guides/network/vnc.rst:126
msgid ""
"Upon completion, you can find the default configuration files and the "
"password file hidden in the `.vnc` directory in your home directory."
msgstr ""
#: ../../guides/network/vnc.rst:129
msgid ""
"Also, a VNC session starts and shows a unique display ID, which is the "
"number following the hostname and the colon `:`. In the above example, "
"the display ID is 2. In a later step, you will supply the display ID to "
"your VNC viewer app for connection."
msgstr ""
#: ../../guides/network/vnc.rst:133
msgid ""
"Kill the active VNC session for the time being with the "
":command:`vncserver -kill :[display ID]` command. Substitute [display "
"ID] with your active VNC session display ID. For example:"
msgstr ""
#: ../../guides/network/vnc.rst:143
msgid ""
"If you do not recall the active session display ID, use the "
":command:`vncserver -list` command to find it."
msgstr ""
#: ../../guides/network/vnc.rst:146
msgid "Optional configurations:"
msgstr ""
#: ../../guides/network/vnc.rst:148
msgid ""
"To customize settings such as screen size, security type, etc., modify "
"the :file:`$HOME/.vnc/config` file."
msgstr ""
#: ../../guides/network/vnc.rst:150
msgid ""
"To customize the applications to run at startup, modify the "
":file:`$HOME/.vnc/xstartup` file."
msgstr ""
#: ../../guides/network/vnc.rst:154
msgid "Method 2: Automatically start a VNC session via a systemd service script"
msgstr ""
#: ../../guides/network/vnc.rst:156
msgid ""
"To configure VNC for this method, you must have root privileges. You "
"will set up a systemd service file for all intended VNC users with their "
"own preassigned unique display ID."
msgstr ""
#: ../../guides/network/vnc.rst:160 ../../guides/network/vnc.rst:244
msgid "Log in and get root privileges."
msgstr ""
#: ../../guides/network/vnc.rst:166
msgid ""
"Make sure the user accounts already exist. Use the following command to "
"list all users."
msgstr ""
#: ../../guides/network/vnc.rst:174 ../../guides/network/vnc.rst:250
msgid "Create the path :file:`/etc/systemd/system`."
msgstr ""
#: ../../guides/network/vnc.rst:180
msgid ""
"Create a systemd service script file :file:`vncserver@:[X].service`, "
"where [X] is the display ID, for each user in :file:`/etc/systemd/system`"
" Each user must be assigned a unique display ID. Be sure the correct "
"username is entered in the `User` field. The example below shows user "
"`vnc-user-b` who is assigned the display ID `5`."
msgstr ""
#: ../../guides/network/vnc.rst:208
msgid ""
"Have each user log into their account and set a VNC password with the "
":command:`vncpasswd` command before proceeding to the next step."
msgstr ""
#: ../../guides/network/vnc.rst:211
msgid ""
"Start the VNC service script and set it to start automatically on boot "
"for each user. Replace the [X] with the display ID."
msgstr ""
#: ../../guides/network/vnc.rst:220
msgid "After starting the services, verify they are running."
msgstr ""
#: ../../guides/network/vnc.rst:226
msgid ""
"The example below shows 2 VNC sessions that were successfully started for"
" users `vnc-user-b` with display ID 5 and `vnc-user-c` with display ID 6."
msgstr ""
#: ../../guides/network/vnc.rst:238
msgid "Method 3: Multi-user logins with authentication through GDM"
msgstr ""
#: ../../guides/network/vnc.rst:240
msgid ""
"For this method, VNC is configured as a systemd service that listens on "
"port 5900 and GDM is configured to accept access requests from VNC. When "
"you make a VNC connection to your |CL| host, you are presented with the "
"GDM login screen and you authenticate as if you are local. You must have"
" root privileges to perform this configuration."
msgstr ""
#: ../../guides/network/vnc.rst:256
msgid "Create a systemd socket file :file:`xvnc.socket` and add the following:"
msgstr ""
#: ../../guides/network/vnc.rst:274
msgid "Create a systemd service file :file:`xvnc@.service` and add the following:"
msgstr ""
#: ../../guides/network/vnc.rst:291
msgid "Create the path :file:`/etc/gdm`."
msgstr ""
#: ../../guides/network/vnc.rst:298
msgid "Create a GDM :file:`custom.conf` file and add the following:"
msgstr ""
#: ../../guides/network/vnc.rst:310
msgid "Start the VNC socket script and set it to start automatically on boot."
msgstr ""
#: ../../guides/network/vnc.rst:318
msgid "After starting the socket, verify it is running."
msgstr ""
#: ../../guides/network/vnc.rst:324
msgid "The example below shows the xvnc.socket is running."
msgstr ""
#: ../../guides/network/vnc.rst:333
msgid "See the `vncserver` Man page for additional information."
msgstr ""
#: ../../guides/network/vnc.rst:336
msgid "Install a VNC viewer app and an SSH client on your client system"
msgstr ""
#: ../../guides/network/vnc.rst:338
msgid ""
"You need a VNC viewer app on your client system to connect to your |CL| "
"host. An SSH client is only needed if you chose to use `Method 1` or you "
"plan to encrypt your VNC traffic, which is discussed later in this guide."
msgstr ""
#: ../../guides/network/vnc.rst:342
msgid "Perform the steps below to add these apps to your client system."
msgstr ""
#: ../../guides/network/vnc.rst:345
msgid "Install a VNC viewer app"
msgstr ""
#: ../../guides/network/vnc.rst:347
msgid "On |CL|:"
msgstr ""
#: ../../guides/network/vnc.rst:353
msgid "On Ubuntu, Mint:"
msgstr ""
#: ../../guides/network/vnc.rst:359
msgid "On Fedora:"
msgstr ""
#: ../../guides/network/vnc.rst:365 ../../guides/network/vnc.rst:407
msgid "On Windows:"
msgstr ""
#: ../../guides/network/vnc.rst:367
msgid "Install `RealVNC for Windows`_"
msgstr ""
#: ../../guides/network/vnc.rst:369
msgid "On macOS:"
msgstr ""
#: ../../guides/network/vnc.rst:371
msgid "Install `RealVNC for macOS`_"
msgstr ""
#: ../../guides/network/vnc.rst:374
msgid "Install an SSH client"
msgstr ""
#: ../../guides/network/vnc.rst:376
msgid ""
"On most Linux distros (|CL|, Ubuntu, Mint, Fedora, etc.) and macOS, SSH "
"is built-in so you don't need to install it."
msgstr ""
#: ../../guides/network/vnc.rst:378
msgid "On Windows, you can install `Putty`_."
msgstr ""
#: ../../guides/network/vnc.rst:381
msgid "Establish a VNC connection to your host"
msgstr ""
#: ../../guides/network/vnc.rst:383
msgid ""
"Depending on the VNC-server-configuration method chosen, use the "
"appropriate VNC connection:"
msgstr ""
#: ../../guides/network/vnc.rst:385
msgid ""
"If you chose `Method 1`, you must take a few extra steps by using SSH to "
"connect to your |CL| host and then manually launching VNC."
msgstr ""
#: ../../guides/network/vnc.rst:388
msgid ""
"If you chose `Method 2`, get your preassigned VNC display ID from your "
"system administrator first and then proceed to the :ref:`connect-to-vnc-"
"session` section below."
msgstr ""
#: ../../guides/network/vnc.rst:392
msgid ""
"If you chose `Method 3`, proceed to the :ref:`connect-to-vnc-session` "
"below."
msgstr ""
#: ../../guides/network/vnc.rst:397
msgid "SSH into your host and launch VNC"
msgstr ""
#: ../../guides/network/vnc.rst:399
msgid "SSH into your |CL| host"
msgstr ""
#: ../../guides/network/vnc.rst:401
msgid "On Linux distros and macOS:"
msgstr ""
#: ../../guides/network/vnc.rst:409 ../../guides/network/vnc.rst:724
msgid "Launch Putty."
msgstr ""
#: ../../guides/network/vnc.rst:410 ../../guides/network/vnc.rst:727
msgid ""
"Under the :guilabel:`Category` section, select :guilabel:`Session`. See "
"Figure 1."
msgstr ""
#: ../../guides/network/vnc.rst:412 ../../guides/network/vnc.rst:729
msgid ""
"Enter the IP address of your |CL| host in the :guilabel:`Host Name (or IP"
" address)` field."
msgstr ""
#: ../../guides/network/vnc.rst:414 ../../guides/network/vnc.rst:731
msgid "Set the :guilabel:`Connection type` option to :guilabel:`SSH`."
msgstr ""
#: ../../guides/network/vnc.rst:415 ../../guides/network/vnc.rst:753
msgid "Click the :guilabel:`Open` button."
msgstr ""
#: ../../guides/network/vnc.rst:421
msgid "Figure 1: Putty - configure SSH session settings"
msgstr ""
#: ../../guides/network/vnc.rst:423
msgid "Log in with your |CL| username and password. Do not use your VNC password."
msgstr ""
#: ../../guides/network/vnc.rst:425
msgid "Start a VNC session."
msgstr ""
#: ../../guides/network/vnc.rst:442
msgid ""
"Take note of the generated display ID because you will input it into the "
"VNC viewer app to establish the connection. The above example shows the "
"display ID is 3."
msgstr ""
#: ../../guides/network/vnc.rst:448
msgid ""
"VNC automatically picks a unique display ID unless you specify one. To "
"specify a display ID, enter a unique number that is not already in use "
"after the colon. For example:"
msgstr ""
#: ../../guides/network/vnc.rst:456
msgid ""
"You can now end the SSH connection by logging out. This does not "
"terminate your active VNC session."
msgstr ""
#: ../../guides/network/vnc.rst:462
msgid "Connect to your VNC session"
msgstr ""
#: ../../guides/network/vnc.rst:464
msgid ""
"For `Method 1` and `Method 2`, you must connect to a specific active "
"session or display ID using one of two options:"
msgstr ""
#: ../../guides/network/vnc.rst:467
msgid ""
"Use a fully-qualified VNC port number, which consists of the default VNC "
"server port (5900) plus the display ID"
msgstr ""
#: ../../guides/network/vnc.rst:469
msgid "Use the display ID"
msgstr ""
#: ../../guides/network/vnc.rst:471
msgid ""
"For example, if the display ID is 3, it can be specified as `5903` or "
"just as `3`. For `Method 3`, VNC does not expect a display ID. Use "
"`5900`. For simplicity, the instructions below use the fully-qualified "
"VNC port number."
msgstr ""
#: ../../guides/network/vnc.rst:475 ../../guides/network/vnc.rst:762
msgid "**On Linux distros:**"
msgstr ""
#: ../../guides/network/vnc.rst:477
msgid "Open a terminal emulator and enter:"
msgstr ""
#: ../../guides/network/vnc.rst:483 ../../guides/network/vnc.rst:512
msgid "Enter your credentials."
msgstr ""
#: ../../guides/network/vnc.rst:485 ../../guides/network/vnc.rst:514
msgid ""
"For `Method 1` and `Method 2`, enter your VNC password. No username is "
"required."
msgstr ""
#: ../../guides/network/vnc.rst:487 ../../guides/network/vnc.rst:516
msgid "For `Method 3`, enter your |CL| account username and password through GDM."
msgstr ""
#: ../../guides/network/vnc.rst:492 ../../guides/network/vnc.rst:521
msgid ""
"With `Method 3`, you cannot remotely log into your |CL| host through VNC "
"if you are logged in locally and vice versa."
msgstr ""
#: ../../guides/network/vnc.rst:495
msgid "**On Windows and macOS using `RealVNC` app:**"
msgstr ""
#: ../../guides/network/vnc.rst:497
msgid "Start the RealVNC viewer app. See Figure 2."
msgstr ""
#: ../../guides/network/vnc.rst:498
msgid ""
"Enter the IP address of the |CL| host and the fully-qualified VNC port "
"number."
msgstr ""
#: ../../guides/network/vnc.rst:501
msgid ""
"The following screenshot shows connecting to |CL| host 192.168.25.54 with"
" a fully-qualified VNC port number 5902."
msgstr ""
#: ../../guides/network/vnc.rst:508
msgid "Figure 2: RealVNC Viewer"
msgstr ""
#: ../../guides/network/vnc.rst:510
msgid "Press the :kbd:`Enter` key."
msgstr ""
#: ../../guides/network/vnc.rst:525
msgid "`Optional: Configure RealVNC Image Quality`"
msgstr ""
#: ../../guides/network/vnc.rst:527
msgid ""
"To increase the RealVNC viewer image quality, manually change the "
"`ColorLevel` value. Follow these steps:"
msgstr ""
#: ../../guides/network/vnc.rst:529
msgid ""
"Right-click a connection node and select :guilabel:`Properties...`. See "
"Figure 3."
msgstr ""
#: ../../guides/network/vnc.rst:536
msgid "Figure 3: RealVNC Viewer - change connection node properties"
msgstr ""
#: ../../guides/network/vnc.rst:538
msgid "Select the :guilabel:`Expert` tab. See Figure 4."
msgstr ""
#: ../../guides/network/vnc.rst:540
msgid ""
"Select the :guilabel:`ColorLevel` setting and change it to your preferred"
" setting."
msgstr ""
#: ../../guides/network/vnc.rst:547
msgid "Figure 4: RealVNC Viewer - change :guilabel:`ColorLevel`"
msgstr ""
#: ../../guides/network/vnc.rst:550
msgid "Terminate a VNC connection to your host"
msgstr ""
#: ../../guides/network/vnc.rst:552
msgid ""
"For `Method 1` and `Method 2`, once started, a VNC session remains active"
" on your |CL| host even if you close your VNC viewer app. If you want to "
"truly terminate an active VNC session, follow these steps:"
msgstr ""
#: ../../guides/network/vnc.rst:556
msgid "SSH into your |CL| host."
msgstr ""
#: ../../guides/network/vnc.rst:558
msgid ""
"Find the active VNC session display ID with the command "
":command:`vncserver -list`."
msgstr ""
#: ../../guides/network/vnc.rst:565
msgid ""
"Terminate it with the :command:`vncserver -kill` command followed by a "
"colon and the display ID."
msgstr ""
#: ../../guides/network/vnc.rst:572
msgid ""
"For `Method 3`, only the system administrator can stop and disable the "
"VNC service by using these commands:"
msgstr ""
#: ../../guides/network/vnc.rst:582
msgid "Encrypt VNC traffic through an SSH tunnel"
msgstr ""
#: ../../guides/network/vnc.rst:584
msgid ""
"By default, VNC traffic is not encrypted. Figure 6 shows an example "
"warning from RealVNC Viewer."
msgstr ""
#: ../../guides/network/vnc.rst:591
msgid "Figure 6: RealVNC Viewer - Connection not encrypted warning"
msgstr ""
#: ../../guides/network/vnc.rst:593
msgid ""
"To add security, VNC traffic can be routed through an SSH tunnel. This is"
" accomplished by following these steps:"
msgstr ""
#: ../../guides/network/vnc.rst:595
msgid ""
"Configure the VNC server to only accept connection from localhost by "
"adding the `-localhost` option."
msgstr ""
#: ../../guides/network/vnc.rst:597
msgid ""
"Set up an SSH tunnel between your client system and your |CL| host. Your "
"client system will forward traffic from the localhost (the client) "
"destined for a specified fully-qualified VNC port number (on the client) "
"to your |CL| host with the same port number."
msgstr ""
#: ../../guides/network/vnc.rst:601
msgid ""
"The VNC viewer app on your client system will now connect to localhost, "
"instead of the IP address of your |CL| host."
msgstr ""
#: ../../guides/network/vnc.rst:605
msgid "Configure VNC to only accept connection from localhost"
msgstr ""
#: ../../guides/network/vnc.rst:607
msgid "For `Method 1`:"
msgstr ""
#: ../../guides/network/vnc.rst:609
msgid ""
"Edit the :file:`config` file located in :file:`$HOME/.vnc` and uncomment "
"the `# localhost` line. It should look like this:"
msgstr ""
#: ../../guides/network/vnc.rst:625
msgid "If an active session exists, kill it, and then restart it."
msgstr ""
#: ../../guides/network/vnc.rst:627
msgid "For `Method 2`:"
msgstr ""
#: ../../guides/network/vnc.rst:629
msgid ""
"Edit the systemd service script :file:`vncserver@:[X].service` located in"
" :file:`/etc/systemd/system` and add `-localhost` to the `ExecStart` "
"line. The example below uses vncserver@:5.service:"
msgstr ""
#: ../../guides/network/vnc.rst:651
msgid "Restart the service script:"
msgstr ""
#: ../../guides/network/vnc.rst:658
msgid "For `Method 3`:"
msgstr ""
#: ../../guides/network/vnc.rst:660
msgid "No change is needed to the :file:`xvnc@service` script."
msgstr ""
#: ../../guides/network/vnc.rst:662
msgid ""
"After you have restarted your VNC session, you can verify that it only "
"accepts connections from localhost by using the :command:`netstat` "
"command like this:"
msgstr ""
#: ../../guides/network/vnc.rst:672
msgid "Add the |CL| `network-basic` bundle to get the :command:`netstat` command."
msgstr ""
#: ../../guides/network/vnc.rst:675
msgid ""
"Figure 7 shows two VNC sessions (5901 and 5905) accepting connections "
"from any host as specified by the `0.0.0.0`'s. This is before the "
"`-localhost` option was used."
msgstr ""
#: ../../guides/network/vnc.rst:682
msgid "Figure 7: VNC sessions (5901 and 5905) accepting connections from any host"
msgstr ""
#: ../../guides/network/vnc.rst:684
msgid ""
"Figure 8 shows two VNC sessions (5901 and 5905) only accepting "
"connections from localhost as specified by `127.0.0.1`'s. This is after "
"the `-localhost` option was used."
msgstr ""
#: ../../guides/network/vnc.rst:690
msgid ""
"Figure 8: VNC sessions (5901 and 5905) only accepting connections from "
"localhost"
msgstr ""
#: ../../guides/network/vnc.rst:693
msgid "Set up an SSH tunnel from your client system to your |CL| host"
msgstr ""
#: ../../guides/network/vnc.rst:695
msgid "**On Linux distros and macOS:**"
msgstr ""
#: ../../guides/network/vnc.rst:697 ../../guides/network/vnc.rst:764
msgid "Open terminal emulator and enter:"
msgstr ""
#: ../../guides/network/vnc.rst:704 ../../guides/network/vnc.rst:754
msgid "Enter your |CL| account password (not your VNC password)."
msgstr ""
#: ../../guides/network/vnc.rst:708
msgid ""
"`-L` specifies that [client port number] on the localhost (on the client "
"side) is forwarded to [fully-qualified VNC port number] (on the server "
"side)."
msgstr ""
#: ../../guides/network/vnc.rst:711
msgid ""
"Replace `[client port number]` with an available client port number (for "
"example: 1234). For simplicity, you can make the `[client port number]` "
"the same as the `[fully-qualified VNC port number]`."
msgstr ""
#: ../../guides/network/vnc.rst:714
msgid ""
"Replace `[fully-qualified VNC port number]` with 5900 (default VNC port) "
"plus the display ID. For example, if the display ID is 2, the fully-"
"qualified VNC port number is is 5902."
msgstr ""
#: ../../guides/network/vnc.rst:717
msgid "`-N` tells SSH to only forward ports and not execute a remote command."
msgstr ""
#: ../../guides/network/vnc.rst:719
msgid "`-f` tells SSH to go into the background before command execution."
msgstr ""
#: ../../guides/network/vnc.rst:720
msgid "`-l` specifies the username to log in as."
msgstr ""
#: ../../guides/network/vnc.rst:722
msgid "**On Windows:**"
msgstr ""
#: ../../guides/network/vnc.rst:725
msgid "Specify the |CL| VNC host to connect to."
msgstr ""
#: ../../guides/network/vnc.rst:733
msgid "Configure the SSH tunnel. See Figure 9 for an example."
msgstr ""
#: ../../guides/network/vnc.rst:735
msgid ""
"Under the :guilabel:`Category` section, go to :guilabel:`Connection` > "
":guilabel:`SSH` > :guilabel:`Tunnels`."
msgstr ""
#: ../../guides/network/vnc.rst:738
msgid ""
"In the :guilabel:`Source port` field, enter an available client port "
"number (for example: 1234). For simplicity, you can make the `Source "
"port` the same as the fully-qualified VNC port number."
msgstr ""
#: ../../guides/network/vnc.rst:742
msgid ""
"In the :guilabel:`Destination` field, enter `localhost:` plus the fully-"
"qualified VNC port number."
msgstr ""
#: ../../guides/network/vnc.rst:745
msgid "Click the :guilabel:`Add` button."
msgstr ""
#: ../../guides/network/vnc.rst:751
msgid "Figure 9: Putty - configure SSH tunnel"
msgstr ""
#: ../../guides/network/vnc.rst:757
msgid "Connect to a VNC session through an SSH tunnel"
msgstr ""
#: ../../guides/network/vnc.rst:759
msgid ""
"After you have set up an SSH tunnel, follow these instructions to connect"
" to your VNC session."
msgstr ""
#: ../../guides/network/vnc.rst:770
msgid "**On Windows and macOS using `RealVNC`:**"
msgstr ""
#: ../../guides/network/vnc.rst:772
msgid "Start the RealVNC viewer app."
msgstr ""
#: ../../guides/network/vnc.rst:773
msgid ""
"Enter `localhost` and the fully-qualified VNC port number. See Figure 10"
" for an example."
msgstr ""
#: ../../guides/network/vnc.rst:780
msgid "Figure 10: RealVNC viewer app connecting to `localhost:1234`"
msgstr ""
#: ../../guides/network/vnc.rst:784
msgid ""
"RealVNC will still warn that the connection is not encrypted even though "
"its traffic is going through the SSH tunnel. You can ignore this "
"warning."
msgstr ""
@@ -0,0 +1,942 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/telemetrics/telem-guide.rst:4
msgid "Telemetrics"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:6
msgid ""
"Telemetrics in |CL-ATTR| is a client and server solution used to collect "
"data from running |CL| systems to help quickly identify and fix bugs in "
"the OS. Both client and server are customizable, and an API is available"
" on the client side for instrumenting your code for debug and analysis."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:10
msgid ""
"Telemetry in |CL| is **opt-in**. The telemetry client is **not** active "
"and sends **no** data until you explicitly enable it."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:14
msgid ""
"The telemetry functionality adheres to `Intel privacy policies`_ "
"regarding the collection and use of :abbr:`PII (Personally Identifiable "
"Information)` and is open source. Specifically, no intentionally "
"identifiable information about the user or system owner is collected."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:23
msgid "Description"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:25
msgid ""
"Telemetry, one of the key features of |CL|, enables developers to observe"
" and proactively address issues in the OS before end users are impacted."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:27
msgid "Telemetrics is a combination word made from:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:29
msgid "Telemetry, which is sensing and reporting data."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:30
msgid ""
"Analytics, which is using visualization and statistical inferencing to "
"make sense of the reported data."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:32
msgid ""
"|CL| telemetry reports system-level debug/crash information using "
"specialized probes. The probes monitor system tasks such as swupd, kernel"
" oops, machine error checks, and the BIOS error report table for "
"unhandled hardware failures. Telemetry enables real-time issue reporting "
"to allow system developers to quickly focus on an issue and monitor "
"corrective actions."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:34
msgid ""
"|CL| telemetry is fully customizable and can be used during software "
"development for debugging purposes. You can use the libtelemetry library"
" in your code to create custom telemetry records. You can also use the "
"telem-record-gen utility in script files for light touch record creation "
"where instrumenting code files doesn't make sense."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:36
msgid ""
"The |CL| telemetrics solution is an **opt-in** choice on the client side."
" By default, the telemetry client is disabled until you choose to enable"
" it. Enabling the client is covered in this guide."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:39
msgid "Architecture"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:41
msgid ""
"|CL| telemetry has two fundamental components, which are shown in figure "
"1:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:43
msgid ""
"Client: generates and delivers records to the backend server via the "
"network"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:45
msgid ""
"Backend: receives records sent from the client and displays the "
"cumulative content through a specialized web interface."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:50
msgid "Figure 1: :guilabel:`|CL| Telemetry Architecture`"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:52
msgid ""
"The telemetry client provides the front end of the telemetrics solution "
"and includes the following components:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:54
msgid ""
"telemprobd, a daemon that receives and prepares telemetry records from "
"probes and spools them to disk."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:55
msgid ""
"telempostd, a daemon that manages spooled telemetry records and delivers "
"these records according to configurable settings."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:56
msgid "probes, that collect specific types of data from the operating system."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:57
msgid "libtelemetry, the API that telemetrics probes use to create records."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:59
msgid ""
"The telemetry backend provides the server-side component of the "
"telemetrics solution and consists of:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:61
msgid "Nginx web server."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:62
msgid ""
"Two Flask apps: * Collector, an ingestion web app for records received "
"from client probes. * TelemetryUI, a web app that exposes different views"
" to visualize the telemetry data."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:65
msgid "PostgreSQL as the underlying database server."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:69
msgid ""
"The default telemetry backend server is hosted by the Intel |CL| "
"development team and is not viewable outside the Intel firewall. To "
"collect your own records, you must set up your own telemetry backend "
"server."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:74
msgid "How To Use"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:76
msgid ""
"From a workflow perspective, the |CL| telemetrics system is "
"straightforward. On the client side, the main decisions after "
"installation and enabling telemetry concern what to do with the record "
"data generated by the probes. You can send the data to the default or a "
"custom backend server, keep the data local to the system, or both. The "
"backend server has a more complex setup, but once it's running, it is "
"simple to use and configure."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:78
msgid ""
"This section walks through some of the possible scenarios for configuring"
" the |CL| telemetrics system, and suggests which make sense according to "
"your needs."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:81
msgid "Scenarios"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:82
msgid "Enable telemetry"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:84
msgid ""
"Before probes can generate records, the telemetry client daemons must be "
"enabled. You can configure the client before enabling by creating a "
"custom :file:`telemetrics.conf` file that you place in the "
":file:`/etc/telemetrics` directory. If you choose to use the default "
"settings, records will be sent to the telemetrics backend server managed "
"by the |CL| development team at Intel."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:86
msgid "Save record data locally"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:88
msgid ""
"You can configure the telemetry client to save records locally. This is "
"convenient when you want instant feedback during a development cycle, or "
"to track system issues if you believe there is a machine specific "
"problem. The client can be set to not send records at all, or to both "
"keep the records locally and send to the backend server."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:90
msgid "Set up a server to collect data"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:92
msgid ""
"Whether you are managing a network of |CL| systems or you don't want to "
"send records to the default telemetry server, you can set up a backend "
"server to collect your records. The backend server can be installed on "
"any Linux system and will give you the same dashboard as the default "
"server."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:95
#: ../../guides/telemetrics/telem-guide.rst:362
msgid "Instrument your code with the libtelemetry API"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:97
msgid ""
"The ``telemetrics`` bundle includes the libtelemetry C library, which "
"exposes an API used by the telemprobd and telempostd daemons. You can use"
" these in your applications as well. The API documentation is found in "
"the :file:`telemetry.h` file in `Telemetrics client`_ repository."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:101
msgid "Examples"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:108
msgid "Enable or Disable Telemetry"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:110
msgid "Enabling during installation"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:112
msgid ""
"During the initial installation of |CL|, you are requested to join the "
"stability enhancement program and allow |CL| to collect anonymous reports"
" to improve system stability. If you choose not to join this program, "
"then the telemetry software bundle is not added to your system. Choosing "
"to join will automatically enable telemetry on your system after "
"installation is commplete."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:114
msgid "Enabling after install"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:116
msgid "To start telemetry on your system, run the following command:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:122
msgid ""
"This enables and starts the :command:`telemprobd` and "
":command:`telempostd` daemons. Your system will begin to send telemetry "
"data to the server defined in the file "
":file:`/etc/telemetrics/telemetrics.conf`. If this file does not exist, "
"the :command:`telemprobd` and :command:`telempostd` daemons will use the "
"file :file:`/usr/share/defaults/telemetrics/telemetrics.conf`."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:124
msgid "Disabling after install"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:126
msgid "To disable both of the telemetry daemons, run the following command:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:132
msgid "Opt in to telemetry"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:134
msgid ""
"To opt-in to the telemetry services, simply enter the opt-in command and "
"start the service:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:140
msgid ""
"This removes the :file:`/etc/telemetrics/opt-out` file, if it exists, and"
" starts the telemetry services."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:144
msgid ""
"To opt-in but not immediately start telemetry services, you will need to "
"run the command :command:`sudo telemctl stop` after the :command:`opt-in`"
" command is entered. Once you are ready to start the service, enter the "
"command :command:`sudo telemctl start`."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:146
msgid "Opt out of telemetry"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:148
msgid ""
"To stop sending telemetrics data from your system, opt out of the "
"telemetry service:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:154
msgid ""
"This creates the file :file:`/etc/telemetrics/opt-out` and stops the "
"telemetry services."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:158
msgid "Saving Data Locally"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:160
msgid ""
"This example requires |CL| to be installed, and telemetry to be enabled "
"on the system."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:162
msgid ""
"To change how records are managed, we will be copying the default "
":file:`/usr/share/defaults/telemetrics/telemetrics.conf` file to "
":file:`/etc/telemetrics/telemetrics.conf` and editing it. The changes in"
" the :file:`/etc/telemetrics/telemetrics.conf` file will override the "
"defaults in the :file:`/usr/share/defaults/telemetrics/telemetrics.conf` "
"file. You may need ``root`` permissions to create and edit files in "
":file:`/etc`. For each example, and for any time you make changes to the "
"configuration file, you will need to restart the client daemons to pick "
"up the changes:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:169
msgid ""
"The :command:`telemctl journal` command gives you access to features and "
"options of the telemetry journal to assist with system analytics and "
"debug. :command:`telemctl journal` has a number of options to help filter"
" records. Use :command:`-h` or :command:`--help` to view usage options."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:172
msgid "Keep local copy and send records to backend server"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:174
msgid ""
"To keep a local copy of the telemetry record and also send it on to the "
"backend server, we will need to change the "
":guilabel:`record_retention_enabled` configuration key value to "
":guilabel:`true`."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:177
msgid "Keep all records -- don't send to backend server"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:179
msgid ""
"To keep records on the system without sending them to a backend server, "
"set the :guilabel:`record_server_delivery_enabled` key value to "
":guilabel:`false`. Note that you will also need to ensure the "
":guilabel:`record_retention_enabled` configuration key value is set to "
":guilabel:`true` or the system will not keep local copies."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:181
msgid "Keep and send records to custom server"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:183
msgid ""
"This assumes you have set up a custom server according to the next "
"example."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:185
msgid ""
"The server is identified by the :guilabel:`server` setting, and by "
"default records will be sent to the |CL| server "
":guilabel:`server=https://clr.telemetry.intel.com/v2/collector`. To "
"change this, you can use an IP address or fully qualified domain name."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:190
msgid "Set up a backend server to collect telemetry records"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:192
msgid ""
"For this example, start with a clean installation of |CL| on a new system"
" using the :ref:`bare-metal-install-server` getting started guide and:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:195
msgid ""
"Join the :guilabel:`Stability Enhancement Program` to install and enable "
"the telemetrics components."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:197
msgid "Select the manual installation method with the following settings:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:199
msgid "Set the hostname to :guilabel:`clr-telem-server`,"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:200
msgid ""
"Create an administrative user named :guilabel:`clear` and add this user "
"to sudoers"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:203
msgid ""
"Log in with your administrative user, from your :file:`$HOME` directory, "
"run :command:`git` to clone the :guilabel:`telemetrics-backend` "
"repository into the :file:`$HOME/telemetrics-backend` directory:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:211
msgid ""
"You may need to set up the :envvar:`https_proxy` environment variable if "
"you have issues reaching github.com."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:213
msgid ""
"Change your current working directory to :file:`telemetrics-"
"backend/scripts`."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:214
msgid ""
"We will install the telemetrics backend with the :file:`deploy.sh` script"
" file. We will set the following options and leave the remainder as "
"default:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:216
msgid "*-a install* to perform an install"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:217
msgid "*-d clr* to install to a |CL| distro"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:218
msgid "*-H localhost* to set the domain to localhost"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:221
msgid ""
"The :file:`deploy.sh` shell script has minimal error checking and makes "
"several changes to your system. Be sure that the options you define on "
"the cmdline are correct before proceeding."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:224
msgid ""
"Run the shell script from the :file:`$HOME/telemetrics-backend/scripts` "
"directory:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:232
msgid ""
"The script will start and list all the defined options and prompt you for"
" the :guilabel:`PostgreSQL` database password"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:245
msgid ""
"For the :guilabel:`DB password:`, press the :kbd:`Enter` key to accept "
"the default password `postgres`."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:249
msgid ""
"The :file:`deploy.sh` script uses :command:`sudo` to run commands and you"
" may be prompted to enter your user password at any time while the script"
" is executing. If this occurs, enter your user password to execute the "
":command:`sudo` command."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:252
msgid ""
"Once all the server components have been installed you are prompted to "
"enter the :guilabel:`PostgreSQL` database password to change it as "
"illustrated below:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:261
msgid ""
"Enter `postgres` for the current value of the password and then enter a "
"new password, retype it to verify the new password and the "
":guilabel:`PostgreSQL` database password will be updated."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:263
msgid ""
"Once the installation is complete you can use your web browser to view "
"the new server by opening the browser on the system and typing in "
"``localhost`` in the address bar. You should see a web page similar to "
"the one shown in figure 1:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:268
msgid "Figure 1: :guilabel:`Telemetry UI`"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:273
msgid "Create records with telem-record-gen"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:275
msgid ""
"The telemetrics bundle provides a record generator tool called ``telem-"
"record-gen``. This tool can be used to create records from shell scripts "
"or the command line when writing a probe in C is not desirable. Records "
"are sent to the backend server, and can also be echoed to stdout."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:277
msgid "There are three ways to supply the payload to the record."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:279
msgid "On the command line, use the :command:`-p <string>` option:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:305
msgid ""
"Specify a file that contains the payload with the option :command:`-P "
"path/to/file`."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:331
msgid ""
"If the :command:`-p` or :command:`-P` options are absent, the tool reads "
"from stdin so you can use it in a :file:`heredoc` in scripts."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:365
msgid "Prerequisites"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:366
msgid ""
"Confirm that the telemetrics header file is located on the system at "
":file:`usr/include/telemetry.h` The `latest version`_ of the file can "
"also be found on github for reference, but installing the `telemetry` "
"bundle will install the header file that matches your |CL| version."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:368
msgid "Includes and variables"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:370
msgid ""
"You will need to include the following headers in your code to use the "
"API:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:381
msgid ""
"Use the following code to create the variables we need to hold the data "
"for the record we will be creating:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:396
msgid "Severity:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst
msgid "Type: uint32_t"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst
msgid ""
"Value: Severity field value. Accepted values are in the range 1-4, with "
"1 being the lowest severity, and 4 being the highest severity. Values "
"provided outside of this range are clamped to 1 or 4. [low, med, high, "
"crit]"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:400
msgid "Payload_version:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst
msgid ""
"Value: Payload format version. The only supported value right now is 1, "
"which indicates that the payload is a freely-formatted (unstructured) "
"string. Values greater than 1 are reserved for future use."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:404
msgid "Classification:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst
msgid "Type: char array"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst
msgid ""
"Value: It should have the form, DOMAIN/PROBENAME/REST: DOMAIN is the "
"reverse domain to use as a namespace for the probe (e.g. org.clearlinux);"
" PROBENAME is the name of the probe; and REST is an arbitrary value that "
"the probe should use to classify the record. The maximum length for the "
"classification string is 122 bytes. Each sub-category may be no longer "
"than 40 bytes long. Two / delimiters are required."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:408
msgid "Tm_handle:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst
msgid "Type: Telem_ref struct pointer"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst
msgid ""
"Value: Struct pointer declared by the caller, The struct is initialized "
"if the function returns success."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:414
msgid "Payload:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst
msgid "Type: char pointer"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst
msgid "Value: The payload to set"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:416
msgid "For this example, we'll set the payload to “hello” by using ``asprintf()``"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:426
msgid ""
"The functions ``asprintf()`` and ``vasprintf()`` are analogs of "
"``sprintf(3)`` and ``vsprintf(3)``, except that they allocate a string"
" large enough to hold the output including the terminating null byte "
"('\\0'), and return a pointer to it via the first argument. This pointer"
" should be passed to ``free(3)`` to release the allocated storage when it"
" is no longer needed."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:428
msgid "Create the new telemetry record"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:430
msgid ""
"The function ``tm_create_record()`` initializes a telemetry record and "
"sets the severity and classification of that record, as well as the "
"payload version number. The memory needed to store the telemetry record "
"is allocated and should be freed with ``tm_free_record()`` when no longer"
" needed."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:440
msgid "Set the payload field of a telemetrics record"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:442
msgid ""
"The function ``tm_set_payload()`` attaches the provided telemetry record "
"data to the telemetry record. The current maximum payload size is 8192b."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:453
msgid ""
"The ``free()`` function frees the memory space pointed to by ptr, which "
"must have been returned by a previous call to ``malloc()``, ``calloc()``,"
" or ``realloc()``. Otherwise, or if ``free(ptr)`` has already been "
"called before, undefined behavior occurs. If ptr is NULL, no operation "
"is performed."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:455
msgid "Send a record to the telemetrics daemon"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:457
msgid ""
"The function ``tm_send_record()`` delivers the record to the local "
"``telemprobd(1)`` service. Since the telemetry record was allocated by "
"the program it should be freed with ``tm_free_record()`` when it is no "
"longer needed."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:476
msgid "Full sample application with compiling flags"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:478
msgid "Create a new file test.c add the following code."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:533
msgid "Compile with the gcc compiler, using this command:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:540
msgid "Test to ensure the program is working:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:549
msgid ""
"A full example of the `heartbeat probe`_ in C is documented in the source"
" code."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:552
msgid "Reference"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:559
msgid "The Telemetry API"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:561
msgid ""
"Installing the ``telemetrics`` bundle includes the libtelemetry C "
"library, which exposes an API used by the telemprobd and telempostd "
"daemons. You can use these in your applications as well. The API "
"documentation is found in the :file:`telemetry.h` file in `Telemetrics "
"client`_ repository."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:564
msgid "Client Configuration"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:566
msgid ""
"The telemetry client will look for the configuration file located at "
":file:`/etc/telemetrics/telemetrics.conf` and use it if it exists. If the"
" file does not exist, the client will use the default configuration "
"located at :file:`/usr/share/defaults telemetrics/telemetrics.conf`. To "
"modify or customize the configuration, copy the file from "
":file:`/usr/share/defaults/telemetrics` to :file:`/etc/telemetrics` and "
"edit it."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:569
msgid "Configuration Options"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:570
msgid "The client uses the following configuration options from the config file:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:572
msgid ""
"**server**: This specifies the web server to which telempostd sends the "
"telemetry records."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:573
msgid ""
"**socket_path**: This specifies the path of the unix domain socket that "
"the telemprobd listens on for connections from the probes."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:574
msgid ""
"**spool_dir**: This configuration option is related to spooling. If the "
"daemon is not able to send the telemetry records to the backend server "
"due to reasons such as the network availability, then it stores the "
"records in a spool directory. This option specifies that path of the "
"spool directory. This directory should be owned by the same user as the "
"daemon."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:575
msgid ""
"**record_expiry**: This is the time in minutes after which the records in"
" the spool directory are deleted by the daemon."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:576
msgid ""
"**spool_process_time**: This specifies the time interval in seconds that "
"the daemon waits for before checking the spool directory for records. The"
" daemon picks up the records in the order of modification date and tries "
"to send the record to the server. It sends a maximum of 10 records at a "
"time. If it was able to send a record successfully, it deletes the record"
" from the spool. If the daemon finds a record older than the "
"\"record_expiry\" time, then it deletes that record. The daemon looks at "
"a maximum of 20 records in a single spool run loop."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:577
msgid ""
"**rate_limit_enabled**: This determines whether rate-limiting is enabled "
"or disabled. When enabled, there is a threshold on both records sent "
"within a window of time, and record bytes sent within a window a time."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:578
msgid ""
"**record_burst_limit**: This is the maximum amount of records allowed to "
"be passed by the daemon within the record_window_length of time. If set "
"to -1, the rate-limiting for record bursts is disabled."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:579
msgid ""
"**record_window_length**: The time in minutes (0-59) that establishes the"
" window length for the record_burst_limit. EX: if "
"record_burst_window=1000 and record_window_length=15, then no more than "
"1000 records can be passed within any given fifteen minute window."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:580
msgid ""
"**byte_burst_limit**: This is the maximum amount of bytes that can be "
"passed by the daemon within the byte_window_length of time. If set to -1,"
" the rate-limiting for byte bursts is disabled."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:582
msgid ""
"**byte_window_length**: This is the time, in minutes (0-59), that "
"establishes the window length for the byte_burst_limit."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:583
msgid ""
"**rate_limit_strategy**: This is the strategy chosen once the rate-"
"limiting threshold has been reached. Currently the options are 'drop' or "
"'spool', with spool being the default. If spool is chosen, records will "
"be spooled and sent at a later time."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:584
msgid ""
"**record_retention_enabled**: When this key is enabled (true) the daemon "
"saves a copy of the payload on disk from all valid records. To avoid the "
"excessive use of disk space only the latest 100 records are kept. The "
"default value for this configuration key is false."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:585
msgid ""
"**record_server_delivery_enabled**: This key controls the delivery of "
"records to server; when enabled (default value), the record will be "
"posted to the address in the configuration file. If this configuration "
"key is disabled (false), records will not be spooled or posted to "
"backend. This configuration key can be used in combination with "
"record_retention_enabled to keep copies of telemetry records locally "
"only."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:589
msgid ""
"Configuration options may change as the telemetry client evolves. Please "
"use the comments in the file itself as the most accurate reference for "
"configuration."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:595
msgid "Client Run-time Options"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:596
msgid ""
"The |CL| telemetry client provides an admin tool called "
":guilabel:`telemctl` for managing the telemetry services and probes. The "
"tool is located in :file:`/usr/bin`. Running it with no argument results "
"in the following:"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:615
msgid "start/stop/restart"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:617
msgid ""
"The commands to start, stop and restart the telemetry services manage all"
" required services and probes on the system. There is no need to "
"separately start/stop/restart the two client daemons **telemprobd** and "
"**telempostd**. The **restart** command option will call **telemctl "
"stop** followed by **telemctl start** ."
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:620
msgid "is-active"
msgstr ""
#: ../../guides/telemetrics/telem-guide.rst:622
msgid ""
"The `is-active` option reports whether the two client daemons are active."
" This is useful to verify that the **opt-in** and **opt-out** options "
"have taken effect, or to ensure that telemetry is functioning on the "
"system. Note that both daemons are verified."
msgstr ""
Binary file not shown.
+94
View File
@@ -0,0 +1,94 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../index.rst:4
msgid "|CL-PRJ|"
msgstr ""
#: ../../index.rst:6
msgid ""
"Welcome to the |CL-ATTR| documentation pages, the source for |CL| "
"documentation."
msgstr ""
#: ../../index.rst:12
msgid "Our documentation is divided into the following sections:"
msgstr ""
#: ../../index.rst:15
msgid ":ref:`get-started`"
msgstr ""
#: ../../includes/get-started.txt:1
msgid ""
"If you are new to |CL|, get started fast with tutorials for installing "
"|CL| on bare metal, in a virtual environment, or as a live image on a USB"
" stick."
msgstr ""
#: ../../index.rst:19
msgid ":ref:`tooling`"
msgstr ""
#: ../../index.rst:18
msgid ""
"Clear Linux is a little different from other distros. Here are some "
"important tools and concept for managing your install."
msgstr ""
#: ../../index.rst:24
msgid ":ref:`guides`"
msgstr ""
#: ../../index.rst:22
msgid ""
"Guides show how to complete common tasks that help you leverage |CL| "
"native features effectively. From basic system configuration to advanced "
"management of a cloud installation, there is a guide for you."
msgstr ""
#: ../../index.rst:28
msgid ":ref:`tutorials`"
msgstr ""
#: ../../index.rst:27
msgid ""
"|CL| tutorials provide step-by-step instructions on how |CL| features can"
" be used and extended, frequently with third-party tools."
msgstr ""
#: ../../index.rst:32
msgid ":ref:`reference`"
msgstr ""
#: ../../index.rst:31
msgid ""
"Find the detailed information you need to enable your configuration or "
"task in our |CL| reference section."
msgstr ""
#: ../../index.rst:35
msgid ":ref:`faq`"
msgstr ""
#: ../../index.rst:35
msgid "Refer to our FAQ section to read commonly asked questions and answers."
msgstr ""

Some files were not shown because too many files have changed in this diff Show More