mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-08-23 16:05:58 +00:00
Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme
This commit is contained in:
+266
-189
File diff suppressed because it is too large
Load Diff
+358
-298
File diff suppressed because it is too large
Load Diff
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -123,11 +123,11 @@ msgid ""
|
||||
"|CL| images."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:4
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:4
|
||||
msgid "Verify the integrity of the |CL| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:6
|
||||
#: ../../guides/maintenance/download-verify-decompress.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."
|
||||
@@ -135,57 +135,202 @@ msgid ""
|
||||
"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."
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:11
|
||||
msgid "Download the corresponding SHA512 checksum file of your |CL| `image`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:12
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:12
|
||||
msgid "Start Command Prompt."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:13
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:13
|
||||
msgid "Go to the directory with the downloaded image and checksum files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:14
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:14
|
||||
msgid "Get the SHA512 checksum of the image with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:20
|
||||
#: ../../guides/maintenance/download-verify-decompress.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
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:24
|
||||
msgid "Decompress the |CL| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:26
|
||||
#: ../../guides/maintenance/download-verify-decompress.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
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:30
|
||||
msgid "Download and install `7-Zip`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:31
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:31
|
||||
msgid "Go to the directory with the downloaded image and right-click it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:32
|
||||
#: ../../guides/maintenance/download-verify-decompress.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
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:39
|
||||
msgid "Figure 1: Windows 7-Zip extract file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:44
|
||||
msgid "Image types"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:3
|
||||
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:6
|
||||
msgid "Table 1: Types of platform-independent |CL| images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:10 ../../reference/image-types.rst:23
|
||||
msgid "Image Type"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:11 ../../reference/image-types.rst:24
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:13
|
||||
msgid "live-desktop.img or live-desktop.iso"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:14
|
||||
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:16
|
||||
msgid "live-server.img or live-server.iso"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:17
|
||||
msgid "Image for booting to server command prompt to preview or install the OS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:19
|
||||
msgid "Table 2: Types of platform-specific |CL| images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:26
|
||||
msgid "aws.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:27
|
||||
msgid "Image suitable for use with Amazon\\* AWS\\*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:29
|
||||
msgid "azure.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:30
|
||||
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:32
|
||||
msgid "azure-docker.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:33
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
|
||||
"Docker\\* pre-installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:35
|
||||
msgid "azure-machine-learning.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:36
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
|
||||
"`machine-learning-basic` bundle installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:38
|
||||
msgid "cloudguest.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:39
|
||||
msgid ""
|
||||
"Image with generic cloud guest virtual machine (VM) requirements "
|
||||
"installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:41
|
||||
msgid "gce.tar"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:42
|
||||
msgid "Image with the Google Compute Engine (GCE) specific kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:44
|
||||
msgid "hyperv.vhdx"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:45
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
|
||||
"`optimized kernel`_ for Hyper-V."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:47
|
||||
msgid "kvm.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:48
|
||||
msgid ""
|
||||
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
|
||||
"kernel`_ for KVM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:51
|
||||
msgid "kvm-legacy.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:52
|
||||
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:54
|
||||
msgid "pxe.tar"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:55
|
||||
msgid "Image suitable for use with PXE server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:57
|
||||
msgid "vmware.vmdk"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:58
|
||||
msgid ""
|
||||
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
|
||||
"Workstation, and ESXi."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:75
|
||||
msgid "We also provide instructions for other operating systems:"
|
||||
msgstr ""
|
||||
@@ -194,78 +339,74 @@ msgstr ""
|
||||
msgid ":ref:`download-verify-decompress-linux`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:78
|
||||
msgid ":ref:`download-verify-decompress-mac`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:81
|
||||
#: ../../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:83
|
||||
#: ../../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:84
|
||||
#: ../../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:91
|
||||
#: ../../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:93
|
||||
#: ../../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:101
|
||||
#: ../../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:104
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:120
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:131
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:230
|
||||
#: ../../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:106
|
||||
#: ../../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:114
|
||||
#: ../../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:117
|
||||
#: ../../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:122
|
||||
#: ../../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:129
|
||||
#: ../../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:133
|
||||
#: ../../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 "
|
||||
@@ -274,220 +415,220 @@ msgid ""
|
||||
"figure 5."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:143
|
||||
#: ../../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:145
|
||||
#: ../../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:152
|
||||
#: ../../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:154
|
||||
#: ../../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:161
|
||||
#: ../../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:164
|
||||
#: ../../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:167
|
||||
#: ../../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:174
|
||||
#: ../../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:176
|
||||
#: ../../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:179
|
||||
#: ../../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:181
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:258
|
||||
#: ../../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:184
|
||||
#: ../../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:186
|
||||
#: ../../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:192
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:277
|
||||
#: ../../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:194
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:279
|
||||
#: ../../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:195
|
||||
#: ../../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:197
|
||||
#: ../../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:204
|
||||
#: ../../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:206
|
||||
#: ../../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:208
|
||||
#: ../../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:215
|
||||
#: ../../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:217
|
||||
#: ../../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:219
|
||||
#: ../../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:226
|
||||
#: ../../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:228
|
||||
#: ../../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:232
|
||||
#: ../../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:238
|
||||
#: ../../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:240
|
||||
#: ../../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:246
|
||||
#: ../../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:248
|
||||
#: ../../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:255
|
||||
#: ../../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:262
|
||||
#: ../../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:266
|
||||
#: ../../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:268
|
||||
#: ../../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:280
|
||||
#: ../../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:283
|
||||
#: ../../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:285
|
||||
#: ../../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:287
|
||||
#: ../../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:294
|
||||
#: ../../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:296
|
||||
#: ../../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:299
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:298
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:301
|
||||
#: ../../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:303
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:302
|
||||
msgid ":ref:`vmw-player`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:304
|
||||
#: ../../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:305
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:304
|
||||
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
|
||||
msgstr ""
|
||||
|
||||
@@ -523,3 +664,9 @@ msgstr ""
|
||||
#~ msgid "For additional help, see the `VMware Workstation Player guide`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Download the corresponding SHA512 checksum file of your |CL| image."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-mac`"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -25,7 +25,7 @@ msgstr ""
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:6
|
||||
msgid ""
|
||||
"This page explains how to create a new VM and install |CL| on it with the"
|
||||
" VMware Workstation 14 Player hypervisor."
|
||||
" VMware Workstation Player hypervisor."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:14
|
||||
@@ -34,293 +34,219 @@ msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:16
|
||||
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."
|
||||
"`VMware Workstation Player`_ is a type 2 hypervisor. It runs on top of "
|
||||
"Windows\\* or Linux\\* operating systems. 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:21
|
||||
msgid ""
|
||||
"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:24
|
||||
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:27
|
||||
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:33
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:27
|
||||
msgid ""
|
||||
"Screenshots in this document show VMware Workstation 14 Player for "
|
||||
"Windows. Menus and prompts in the Linux version have minor wording "
|
||||
"differences."
|
||||
"The screenshots on this document show the Windows version of the VMware "
|
||||
"Workstation 15 Player. The menus and prompts are similar to those in "
|
||||
"other versions and for the Linux OS save some minor wording differences."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:37
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:31
|
||||
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:35
|
||||
msgid "Install the VMware Workstation Player hypervisor"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:39
|
||||
#: ../../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:43
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:41
|
||||
msgid ""
|
||||
"`VMware Workstation 14 Player`_ is available for Windows and Linux. "
|
||||
"Download your preferred version."
|
||||
"`VMware Workstation Player`_ is available for Windows and Linux. Download"
|
||||
" your preferred version."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:46
|
||||
msgid ""
|
||||
"Install VMware Workstation 14 Player following the instructions "
|
||||
"appropriate for your system's OS:"
|
||||
"By default, selecting download means you receive the latest version of "
|
||||
"this application. Commands may differ based on the version."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:49
|
||||
msgid "On supported Linux distros:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:51
|
||||
msgid "Enable a GUI desktop."
|
||||
msgid ""
|
||||
"Install VMware Workstation Player following the instructions appropriate "
|
||||
"for your system's OS:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:52
|
||||
msgid "On supported Linux distros:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:54
|
||||
msgid "Enable a GUI desktop."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:55
|
||||
msgid "Start a terminal emulator."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:53
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:56
|
||||
msgid ""
|
||||
"Start the installer by issuing the command below and follow the guided "
|
||||
"steps."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:60
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:63
|
||||
msgid "On Windows:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:62
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:65
|
||||
msgid "Start the installer."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:63
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:66
|
||||
msgid "Follow the setup wizard."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:65
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:68
|
||||
msgid "For additional help, see the `VMware Workstation Player Documentation`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:68
|
||||
msgid "Download the latest |CL| installer ISO"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:70
|
||||
msgid ""
|
||||
"Get the latest |CL| installer ISO image from the `image`_ repository. "
|
||||
"Look for :file:`clear-[version number]-installer.iso.xz`."
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:71
|
||||
msgid "Download the latest |CL| installer"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:73
|
||||
msgid "Get the latest installer with |CL| OS Desktop from the `downloads`_ page."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:75
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:77
|
||||
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:78
|
||||
msgid "We also provide instructions for other operating systems:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:80
|
||||
msgid ":ref:`download-verify-decompress-linux`"
|
||||
"We also provide instructions for downloading and verifying a Clear Linux "
|
||||
"ISO. For more information, refer to :ref:`download-verify-decompress`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:81
|
||||
msgid ":ref:`download-verify-decompress-mac`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:84
|
||||
msgid "Create and configure a new VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:86
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:83
|
||||
msgid "Start the `VMware Workstation Player` app."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:88
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:85
|
||||
msgid ""
|
||||
"On the home screen, click :guilabel:`Create a New Virtual Machine`. See "
|
||||
"Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:95
|
||||
msgid "Figure 1: VMware Workstation 14 Player - Create a new virtual machine"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:92
|
||||
msgid "Figure 1: VMware Workstation Player - Create a new virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:98
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:95
|
||||
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:106
|
||||
msgid "Figure 2: VMware Workstation 14 Player - Select |CL| installer ISO"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:103
|
||||
msgid "Figure 2: VMware Workstation Player - Select |CL| installer ISO"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:108
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:105
|
||||
msgid ""
|
||||
"Click the :guilabel:`Browse` button and select the decompressed |CL| "
|
||||
"installer ISO."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:111
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:127
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:138
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:153
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:108
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:124
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:135
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:151
|
||||
msgid "Click the :guilabel:`Next` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:113
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:110
|
||||
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:121
|
||||
msgid ""
|
||||
"Figure 3: VMware Workstation 14 Player - Select guest operating system "
|
||||
"type"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:118
|
||||
msgid "Figure 3: VMware Workstation Player - Select guest operating system type"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:124
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:121
|
||||
msgid ""
|
||||
"Set the :guilabel:`Version` setting to :guilabel:`Other Linux 3.x or "
|
||||
"Set the :guilabel:`Version` setting to :guilabel:`Other Linux 4.x or "
|
||||
"later kernel 64-bit`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:129
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:126
|
||||
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:136
|
||||
msgid "Figure 4: VMware Workstation 14 Player - Name virtual machine"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:133
|
||||
msgid "Figure 4: VMware Workstation Player - Name virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:140
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:137
|
||||
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:147
|
||||
msgid "Figure 5: VMware Workstation 14 Player - Set disk capacity"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:144
|
||||
msgid "Figure 5: VMware Workstation Player - Set disk capacity"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:150
|
||||
#: ../../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."
|
||||
"For optimal performance with the |CL| Desktop image, we recommend 32GB of"
|
||||
" drive space. See :ref:`system-requirements` for more details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:155
|
||||
#: ../../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:162
|
||||
msgid "Figure 6: VMware Workstation 14 Player - Customize hardware"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:160
|
||||
msgid "Figure 6: VMware Workstation Player - Customize hardware"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:164
|
||||
#: ../../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:170
|
||||
msgid "Figure 7: VMware Workstation 14 Player - Set memory size"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:168
|
||||
msgid "Figure 7: VMware Workstation Player - Set memory size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:173
|
||||
#: ../../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 "
|
||||
@@ -328,170 +254,165 @@ msgid ""
|
||||
" details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:178
|
||||
#: ../../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:185
|
||||
msgid "Figure 8: VMware Workstation 14 Player - Set virtualization engine option"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:183
|
||||
msgid "Figure 8: VMware Workstation Player - Set virtualization engine option"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:188
|
||||
#: ../../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:191
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:189
|
||||
msgid "Click the :guilabel:`Close` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:193
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:191
|
||||
msgid "Click the :guilabel:`Finish` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:196
|
||||
#: ../../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:198
|
||||
#: ../../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:205
|
||||
msgid "Figure 9: VMware Workstation 14 Player - Power on virtual machine"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:203
|
||||
msgid "Figure 9: VMware Workstation Player - Power on virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:207
|
||||
#: ../../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:210
|
||||
#: ../../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:214
|
||||
#: ../../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:216
|
||||
#: ../../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:219
|
||||
#: ../../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 Player - Edit CD/DVD settings"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:226
|
||||
msgid "Figure 10: VMware Workstation 14 Player - Edit CD/DVD settings"
|
||||
msgid "Go to :menuselection:`Removable Devices-->CD/DVD (IDE)-->Disconnect`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:228
|
||||
msgid "Go to :menuselection:`Removable Devices-->CD/DVD (IDE)-->Settings`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:230
|
||||
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:238
|
||||
msgid "Figure 11: VMware Workstation 14 Player - Disconnect CD/DVD"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:240
|
||||
msgid "Click the :guilabel:`OK` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:242
|
||||
msgid "To power off the VM, click the :guilabel:`Player` menu. See Figure 12."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:248
|
||||
msgid "Figure 12: VMware Workstation 14 Player - Power off virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:250
|
||||
msgid "Go to :guilabel:`Power` and select :guilabel:`Shut Down Guest`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:253
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:231
|
||||
msgid "Enable UEFI boot support"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:255
|
||||
msgid ""
|
||||
"|CL| needs UEFI support to boot. To enable UEFI, add the following line "
|
||||
"to the end of your VM's :file:`.vmx` file:"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:233
|
||||
msgid "|CL| needs UEFI support to boot. To enable UEFI:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:264
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:235
|
||||
msgid "Power off the VM. click the :guilabel:`Player` menu. See Figure 11."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:241
|
||||
msgid "Figure 11: VMware Workstation Player - Power off virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:243
|
||||
msgid "Go to :guilabel:`Power` and select :guilabel:`Shut Down Guest`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:245
|
||||
msgid "Add the following line to the end of your VM's :file:`.vmx` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:253
|
||||
msgid "Depending on the OS, you can typically find the VMware VM files under:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:266
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:255
|
||||
msgid "On Linux distros: :file:`/home/username/vmware`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:267
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:256
|
||||
msgid ""
|
||||
"On Windows: :file:`C:\\\\Users\\\\username\\\\Documents\\\\Virtual "
|
||||
"Machines`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:270
|
||||
msgid "Power on the VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:272
|
||||
msgid "After configuring the settings above, power on your |CL| virtual machine."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:274
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:259
|
||||
msgid ""
|
||||
"On the :guilabel:`VMware Workstation Player` home screen, select your VM."
|
||||
" See Figure 13."
|
||||
"After configuring the settings above, power on your |CL| virtual machine."
|
||||
" On the :guilabel:`VMware Workstation Player` home screen, select your "
|
||||
"VM. See Figure 9."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:281
|
||||
msgid "Figure 13: VMware Workstation 14 Player - Power on virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:283
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:263
|
||||
msgid "Click :guilabel:`Play virtual machine`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:286
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:265
|
||||
msgid ""
|
||||
"Install Open VM Tools. You may want to install the `open-vm-tools` in "
|
||||
"your virtual machine. The Open Virtual Machine Tools (open-vm-tools) are "
|
||||
"the open source implementation of VMware Tools for Linux guest operating "
|
||||
"systems. In |CL| you can use the following to install the bundle in your "
|
||||
"VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:275
|
||||
msgid ""
|
||||
"More information is available on the `VMWare Tools Product "
|
||||
"Documentation`_ site."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:278
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:288
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:280
|
||||
msgid "For other guides on using the VMWare Player and ESXi, see:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:290
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:282
|
||||
msgid ":ref:`vmw-player-preconf`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:291
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:283
|
||||
msgid ":ref:`vmware-esxi-install-cl`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:292
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:284
|
||||
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
|
||||
msgstr ""
|
||||
|
||||
@@ -521,3 +442,215 @@ msgstr ""
|
||||
#~ msgid "For additional help, see the `VMware Workstation Player guide`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This page explains how to create a"
|
||||
#~ " new VM and install |CL| on it"
|
||||
#~ " with the VMware Workstation 14 "
|
||||
#~ "Player hypervisor."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Screenshots in this document show VMware"
|
||||
#~ " Workstation 14 Player for Windows. "
|
||||
#~ "Menus and prompts in the Linux "
|
||||
#~ "version have minor wording differences."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "`VMware Workstation 14 Player`_ is "
|
||||
#~ "available for Windows and Linux. "
|
||||
#~ "Download your preferred version."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Install VMware Workstation 14 Player "
|
||||
#~ "following the instructions appropriate for "
|
||||
#~ "your system's OS:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Download the latest |CL| installer ISO"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Get the latest |CL| installer ISO "
|
||||
#~ "image from the `image`_ repository. Look"
|
||||
#~ " for :file:`clear-[version number]-installer.iso.xz`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Verify the integrity of the |CL| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Download the corresponding SHA512 checksum file of your |CL| image."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Start Command Prompt."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to the directory with the downloaded image and checksum files."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Get the SHA512 checksum of the image with the command:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Manually compare the output with the "
|
||||
#~ "original checksum value shown in the "
|
||||
#~ "downloaded checksum file and make sure"
|
||||
#~ " they match."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Decompress the |CL| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Download and install `7-Zip`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to the directory with the downloaded image and right-click it."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "From the pop-up menu, select "
|
||||
#~ ":guilabel:`7-Zip` and select :guilabel:`Extract "
|
||||
#~ "Here` as shown in Figure 1."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 1: Windows 7-Zip extract file."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "We also provide instructions for other operating systems:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-linux`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-mac`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 1: VMware Workstation 14 Player - Create a new virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 2: VMware Workstation 14 Player - Select |CL| installer ISO"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Figure 3: VMware Workstation 14 Player"
|
||||
#~ " - Select guest operating system type"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Set the :guilabel:`Version` setting to "
|
||||
#~ ":guilabel:`Other Linux 3.x or later "
|
||||
#~ "kernel 64-bit`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 4: VMware Workstation 14 Player - Name virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 5: VMware Workstation 14 Player - Set disk capacity"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "A minimal |CL| installation can exist"
|
||||
#~ " on 600MB of drive space. See "
|
||||
#~ ":ref:`system-requirements` for more details."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 6: VMware Workstation 14 Player - Customize hardware"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 7: VMware Workstation 14 Player - Set memory size"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Figure 8: VMware Workstation 14 Player"
|
||||
#~ " - Set virtualization engine option"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 9: VMware Workstation 14 Player - Power on virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 10: VMware Workstation 14 Player - Edit CD/DVD settings"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to :menuselection:`Removable Devices-->CD/DVD (IDE)-->Settings`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "On the :guilabel:`Device status` section, "
|
||||
#~ "uncheck the :guilabel:`Connected` and the "
|
||||
#~ ":guilabel:`Connect at power on` settings. "
|
||||
#~ "See Figure 11."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 11: VMware Workstation 14 Player - Disconnect CD/DVD"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To power off the VM, click the :guilabel:`Player` menu. See Figure 12."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 12: VMware Workstation 14 Player - Power off virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Power on the VM"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "After configuring the settings above, "
|
||||
#~ "power on your |CL| virtual machine."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "On the :guilabel:`VMware Workstation Player`"
|
||||
#~ " home screen, select your VM. See "
|
||||
#~ "Figure 13."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 13: VMware Workstation 14 Player - Power on virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
+115
-115
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -73,205 +73,172 @@ msgid ""
|
||||
"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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:41
|
||||
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:"
|
||||
"We also provide instructions for downloading and verifying a Clear Linux "
|
||||
"ISO. For more information, refer to :ref:`download-verify-decompress`."
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:47
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:49
|
||||
msgid ""
|
||||
"Under the :guilabel:`Navigator` window, select :guilabel:`Storage`. See "
|
||||
"Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:57
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:51
|
||||
msgid ""
|
||||
"Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore "
|
||||
"browser` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:64
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:58
|
||||
msgid "Figure 1: VMware ESXi - Navigator > Storage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:66
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:60
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:67
|
||||
msgid "Figure 2: VMware ESXi - Datastore > Create directory"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:75
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:69
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:76
|
||||
msgid "Figure 3: VMware ESXi - Datastore > Upload ISO"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:84
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:78
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:82
|
||||
msgid "Create and configure a new VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:90
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:84
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:87
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:89
|
||||
msgid "In the right window, click the :guilabel:`Create / Register VM` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:101
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:95
|
||||
msgid "Figure 4: VMware ESXi - Navigator > Virtual Machines"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:103
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:97
|
||||
msgid "On the :guilabel:`Select creation type` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:105
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:99
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:101
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:115
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:126
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:179
|
||||
msgid "Click the :guilabel:`Next` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:113
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:107
|
||||
msgid "Figure 5: VMware ESXi - Create a new virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:115
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:109
|
||||
msgid "On the :guilabel:`Select a name and guest OS` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:117
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:111
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:112
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:113
|
||||
msgid "Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:120
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:114
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:121
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:123
|
||||
msgid "On the :guilabel:`Select storage` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:131
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:125
|
||||
msgid "Accept the default option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:134
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:128
|
||||
msgid "On the :guilabel:`Customize settings` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:136
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:130
|
||||
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 7."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:137
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:131
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:138
|
||||
msgid "Figure 7: VMware ESXi - Enable hardware virtualization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:146
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:140
|
||||
msgid "Set :guilabel:`Memory` size to 2048MB (2GB). See Figure 8."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:152
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:146
|
||||
msgid "Figure 8: VMware ESXi - Set memory size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:156
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:150
|
||||
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 "
|
||||
@@ -279,21 +246,21 @@ msgid ""
|
||||
"128MB of RAM. See :ref:`system-requirements` for more details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:161
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:155
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:161
|
||||
msgid "Figure 9: VMware ESXi - Set hard disk size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:171
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:165
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:168
|
||||
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 "
|
||||
@@ -302,173 +269,173 @@ msgid ""
|
||||
"uploaded to the VMware server. See Figure 10."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:183
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:177
|
||||
msgid "Figure 10: VMware ESXi - Set CD/DVD to boot installer ISO"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:186
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:180
|
||||
msgid "Click the :guilabel:`Finish` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:189
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:183
|
||||
msgid "Install |CL| into the new VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:191
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:185
|
||||
msgid "Power on the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:193
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:187
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:189
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:190
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:270
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:191
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.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-install-cl.rst:204
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:198
|
||||
msgid "Figure 11: VMware ESXi - Navigator > Virtual Machines > Power on VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:206
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:200
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:202
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:206
|
||||
msgid "Reconfigure the VM's settings to boot the newly-installed |CL|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:214
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:208
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:212
|
||||
msgid "Power off the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:220
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:214
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:222
|
||||
msgid "Figure 12: VMware ESXi - Actions > Power off"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:230
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:224
|
||||
msgid "Edit the VM settings."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:232
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:226
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:233
|
||||
msgid "Figure 13: VMware ESXi - Actions > Edit settings"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:241
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:235
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:237
|
||||
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 14."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:244
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:238
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:245
|
||||
msgid "Figure 14: VMware ESXi - Disconnect the CD/DVD drive"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:253
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:247
|
||||
msgid "|CL| needs UEFI support in order to boot. Enable it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:255
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:249
|
||||
msgid "Click the :guilabel:`VM Options` button. See Figure 15."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:256
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:250
|
||||
msgid "Expand the :guilabel:`Boot Options` setting."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:257
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:251
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:258
|
||||
msgid "Figure 15: VMware ESXi - Set boot firmware to EFI"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:266
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:260
|
||||
msgid "Click the :guilabel:`Save` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:269
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:263
|
||||
msgid "Power on the VM and boot |CL|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:271
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:265
|
||||
msgid "After configuring the settings above, power on the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:273
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:267
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:269
|
||||
msgid "In the right window, select the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:284
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:278
|
||||
msgid "Figure 16: VMware ESXi - Navigator > Virtual Machines > Power on VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:287
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:281
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:289
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:283
|
||||
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
|
||||
msgstr ""
|
||||
|
||||
@@ -517,3 +484,36 @@ msgstr ""
|
||||
#~ msgid "Install steps:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Decompress the |CL| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Start a terminal emulator."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to the directory with the downloaded image."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To decompress an XZ image, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To decompress a GZ image, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "For alternative instructions on other operating systems, see:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-mac`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-windows`"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
+109
-109
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -75,135 +75,102 @@ msgid ""
|
||||
"|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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:44
|
||||
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:"
|
||||
"We also provide instructions for downloading and verifying a Clear Linux "
|
||||
"ISO. For more information, refer to :ref:`download-verify-decompress`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:48
|
||||
msgid "For alternative instructions on other operating systems, see:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:50
|
||||
msgid ":ref:`download-verify-decompress-mac`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:51
|
||||
msgid ":ref:`download-verify-decompress-windows`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:54
|
||||
msgid "Upload the |CL| image to the VMware server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:56
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:50
|
||||
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:60
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:54
|
||||
msgid ""
|
||||
"The steps in this section can also be referenced from the VMware "
|
||||
"documentation `Using Datastore File Browser in the VMware Host Client`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:63
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:57
|
||||
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:66
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:60
|
||||
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:70
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:64
|
||||
msgid ""
|
||||
"Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore "
|
||||
"browser` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:77
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:71
|
||||
msgid "Figure 1: VMware ESXi - Navigator > Storage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:79
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:73
|
||||
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:86
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:80
|
||||
msgid "Figure 2: VMware ESXi - Datastore > Create directory"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:88
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:82
|
||||
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:95
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:89
|
||||
msgid "Figure 3: VMware ESXi - Datastore > Upload VMware image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:97
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:91
|
||||
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:101
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:95
|
||||
msgid "Convert the |CL| image to an ESXi-supported format"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:103
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:97
|
||||
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:107
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:101
|
||||
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:109
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:103
|
||||
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:114
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:108
|
||||
msgid ""
|
||||
"If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or "
|
||||
":abbr:`vCLI (vSphere CLI)` configured and available, you can temporarily "
|
||||
@@ -211,258 +178,258 @@ msgid ""
|
||||
"`Enable the Secure Shell (SSH) in the VMware Host Client`_ ."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:118
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:112
|
||||
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:121
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:115
|
||||
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:124
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:118
|
||||
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:131
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:125
|
||||
msgid "Two files should result from this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:133
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:127
|
||||
msgid ":file:`clear-[version number]-esxi-flat.vmdk`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:134
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:128
|
||||
msgid ":file:`clear-[version number]-esxi.vmdk`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:136
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:130
|
||||
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:140
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:134
|
||||
msgid "Create and configure a new VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:142
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:136
|
||||
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:146
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:140
|
||||
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:149
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:143
|
||||
msgid "In the right window, click the :guilabel:`Create / Register VM` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:155
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:149
|
||||
msgid "Figure 4: VMware ESXi - Navigator > Virtual Machines"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:157
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:151
|
||||
msgid "On the :guilabel:`Select creation type` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:159
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:153
|
||||
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:162
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:179
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:190
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:261
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:156
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:173
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:184
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:255
|
||||
msgid "Click the :guilabel:`Next` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:168
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:162
|
||||
msgid "Figure 5: VMware ESXi - Create a new virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:170
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:164
|
||||
msgid "On the :guilabel:`Select a name and guest OS` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:172
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:166
|
||||
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:174
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:168
|
||||
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:176
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:170
|
||||
msgid "Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:177
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:171
|
||||
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:185
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:179
|
||||
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:187
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:181
|
||||
msgid "On the :guilabel:`Select storage` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:189
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:183
|
||||
msgid "Accept the default option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:192
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:186
|
||||
msgid "On the :guilabel:`Customize settings` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:194
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:188
|
||||
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 7."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:195
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:189
|
||||
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:203
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:197
|
||||
msgid "Figure 7: VMware ESXi - Enable hardware virtualization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:205
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:199
|
||||
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:212
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:206
|
||||
msgid "Figure 8: VMware ESXi - Remove hard drive"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:214
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:208
|
||||
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:222
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:216
|
||||
msgid "Figure 9: VMware ESXi - Disconnect the CD/DVD drive"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:224
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:218
|
||||
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:227
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:221
|
||||
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:234
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:228
|
||||
msgid "Figure 10: VMware ESXi - Add an existing hard drive"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:236
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:230
|
||||
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:244
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:238
|
||||
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:247
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:241
|
||||
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:249
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:243
|
||||
msgid "Click the :guilabel:`VM Options` button. See Figure 12."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:250
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:244
|
||||
msgid "Expand the :guilabel:`Boot Options` setting."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:251
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:245
|
||||
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:258
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:252
|
||||
msgid "Figure 12: VMware ESXi - Set boot firmware to EFI"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:260
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:254
|
||||
msgid "Click the :guilabel:`Save` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:262
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:256
|
||||
msgid "Click the :guilabel:`Finish` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:265
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:259
|
||||
msgid "Power on the VM and boot |CL|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:267
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:261
|
||||
msgid "After configuring the settings above, power on the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:269
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:263
|
||||
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:271
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:265
|
||||
msgid "In the right window, select the newly-created VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:272
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:266
|
||||
msgid "Click the :guilabel:`Power on` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:273
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:267
|
||||
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:280
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:274
|
||||
msgid "Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:283
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:277
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:285
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:279
|
||||
msgid ":ref:`vmware-esxi-install-cl`"
|
||||
msgstr ""
|
||||
|
||||
@@ -518,3 +485,36 @@ msgstr ""
|
||||
#~ " Enable the Secure Shell (SSH)`_ ."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Decompress the |CL| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Start a terminal emulator."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to the directory with the downloaded image."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To decompress an XZ image, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To decompress a GZ image, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "For alternative instructions on other operating systems, see:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-mac`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-windows`"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,37 +24,45 @@ 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."
|
||||
"This guide describes deployment considerations and strategies when "
|
||||
"deploying |CL-ATTR| 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."
|
||||
#: ../../guides/deploy-at-scale.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:16
|
||||
msgid ""
|
||||
"This is not a replacement or blueprint for designing your own IT "
|
||||
"In this guide 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:21
|
||||
msgid ""
|
||||
"This guide is not a replacement or blueprint for designing your own IT "
|
||||
"operating environment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:19
|
||||
#: ../../guides/deploy-at-scale.rst:24
|
||||
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."
|
||||
"Implementation details for a scale deployment are beyond the scope of "
|
||||
"this guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:29
|
||||
msgid "Pick a |CL| usage and update strategy"
|
||||
#: ../../guides/deploy-at-scale.rst:27
|
||||
msgid ""
|
||||
"Your |CL| deployment should complement your existing environment and "
|
||||
"available tools. It is assumed core IT dependencies of your environment, "
|
||||
"such as your network, are healthy and scaled to suit the deployment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:31
|
||||
#: ../../guides/deploy-at-scale.rst:32
|
||||
msgid "Pick a usage and update strategy"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:34
|
||||
msgid ""
|
||||
"Different business scenarios call for different deployment methodologies."
|
||||
" |CL| offers the flexibility to continue consuming the upstream |CL| "
|
||||
@@ -62,56 +70,54 @@ msgid ""
|
||||
"act as your own :abbr:`OSV (Operating System Vendor)`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:36
|
||||
#: ../../guides/deploy-at-scale.rst:39
|
||||
msgid "Below is an overview of some considerations."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:39
|
||||
#: ../../guides/deploy-at-scale.rst:42
|
||||
msgid "Create your own Linux distribution (mix)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:41
|
||||
#: ../../guides/deploy-at-scale.rst:44
|
||||
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 "
|
||||
"own :abbr:`OSV (Operating System Vendor)` by leveraging the :ref:`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*."
|
||||
"customization*. Consider:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:47
|
||||
#: ../../guides/deploy-at-scale.rst:50
|
||||
msgid ""
|
||||
"Development systems that generate bundles and updates should have "
|
||||
"sufficient performance for the task and separate from the swupd update "
|
||||
"webservers that serve update content to production machines."
|
||||
"sufficient performance for the task and be separate from the swupd update"
|
||||
" webservers that serve update content to production machines."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:51
|
||||
#: ../../guides/deploy-at-scale.rst:54
|
||||
msgid ""
|
||||
"swupd update webservers that serve update content to production machines "
|
||||
"(see `mixer process`_ for more information) should be appropriately "
|
||||
"scaled."
|
||||
"should be appropriately scaled. Specific implementation details for a "
|
||||
"scalable, resilient web server are beyond the scope of this document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:55
|
||||
msgid ""
|
||||
"Your swupd update server is just like any other web application. |WEB-"
|
||||
"SERVER-SCALE|"
|
||||
#: ../../guides/deploy-at-scale.rst:58
|
||||
msgid "(See :ref:`mixer` for more information about update servers.)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:59
|
||||
#: ../../guides/deploy-at-scale.rst:61
|
||||
msgid "Adopt an agile methodology"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:60
|
||||
#: ../../guides/deploy-at-scale.rst:63
|
||||
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:63
|
||||
#: ../../guides/deploy-at-scale.rst:66
|
||||
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 "
|
||||
@@ -121,92 +127,92 @@ msgid ""
|
||||
" of software to your endpoints is an important prerequisite."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:70
|
||||
#: ../../guides/deploy-at-scale.rst:73
|
||||
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:73
|
||||
#: ../../guides/deploy-at-scale.rst:76
|
||||
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:76
|
||||
#: ../../guides/deploy-at-scale.rst:79
|
||||
msgid ""
|
||||
"Setup a path to production for building |CL| based images. At minimum "
|
||||
"this should include:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:79
|
||||
#: ../../guides/deploy-at-scale.rst:82
|
||||
msgid ""
|
||||
"A development clr-on-clr environment to test building packages and "
|
||||
"bundles for |CL| systems."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:82
|
||||
#: ../../guides/deploy-at-scale.rst:85
|
||||
msgid "A pre-production environment to deploy |CL| versions to before production"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:85
|
||||
#: ../../guides/deploy-at-scale.rst:88
|
||||
msgid ""
|
||||
"Employ a continuous integration and continuous deployment (CI/CD) "
|
||||
"philosophy in order to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:88
|
||||
#: ../../guides/deploy-at-scale.rst:91
|
||||
msgid ""
|
||||
"Automatically pull custom packages as they are updated from their "
|
||||
"upstream projects or vendors."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:91
|
||||
#: ../../guides/deploy-at-scale.rst:94
|
||||
msgid ""
|
||||
"Generate |CL| bundles and potentially bootable images with your "
|
||||
"customizations, if any."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:94
|
||||
#: ../../guides/deploy-at-scale.rst:97
|
||||
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:97
|
||||
#: ../../guides/deploy-at-scale.rst:100
|
||||
msgid ""
|
||||
"Integrate with your organization's governance processes, such as change "
|
||||
"control."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:101
|
||||
msgid "Versioning Infrastructure"
|
||||
#: ../../guides/deploy-at-scale.rst:104
|
||||
msgid "Versioning infrastructure"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:103
|
||||
#: ../../guides/deploy-at-scale.rst:106
|
||||
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:107
|
||||
#: ../../guides/deploy-at-scale.rst:109
|
||||
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:110
|
||||
#: ../../guides/deploy-at-scale.rst:112
|
||||
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:115
|
||||
#: ../../guides/deploy-at-scale.rst:117
|
||||
msgid "Pick an image distribution strategy"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:117
|
||||
#: ../../guides/deploy-at-scale.rst:119
|
||||
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 "
|
||||
@@ -214,56 +220,56 @@ msgid ""
|
||||
"automated installations or prebuilt images."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:122
|
||||
#: ../../guides/deploy-at-scale.rst:124
|
||||
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:126
|
||||
#: ../../guides/deploy-at-scale.rst:128
|
||||
msgid "See the available :ref:`image-types`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:128
|
||||
#: ../../guides/deploy-at-scale.rst:130
|
||||
msgid "Below are some common ways to install |CL| to systems at scale:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:131
|
||||
msgid "Baremetal"
|
||||
#: ../../guides/deploy-at-scale.rst:133
|
||||
msgid "Bare metal"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:133
|
||||
#: ../../guides/deploy-at-scale.rst:135
|
||||
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."
|
||||
" are one way to distribute |CL| to physical bare metal systems on a LAN."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:137
|
||||
#: ../../guides/deploy-at-scale.rst:138
|
||||
msgid ""
|
||||
"This option works well if your customizations are fairly small in size "
|
||||
"and infrastructure can be stateless."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:140
|
||||
#: ../../guides/deploy-at-scale.rst:141
|
||||
msgid ""
|
||||
"The |CL| `downloads page`_ offers a live image that can be deployed as a "
|
||||
"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:145
|
||||
msgid "Cloud Instances or Virtual Machines"
|
||||
#: ../../guides/deploy-at-scale.rst:146
|
||||
msgid "Cloud instances or virtual machines"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:147
|
||||
#: ../../guides/deploy-at-scale.rst:148
|
||||
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:151
|
||||
#: ../../guides/deploy-at-scale.rst:152
|
||||
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 "
|
||||
@@ -271,24 +277,24 @@ msgid ""
|
||||
"or moved between datacenters transparently."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:156
|
||||
#: ../../guides/deploy-at-scale.rst:157
|
||||
msgid ""
|
||||
"The |CL| `downloads page`_ offers example prebuilt VM images and is "
|
||||
"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:161
|
||||
#: ../../guides/deploy-at-scale.rst:162
|
||||
msgid "Containers"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:163
|
||||
#: ../../guides/deploy-at-scale.rst:164
|
||||
msgid ""
|
||||
"Containerization platforms allow images to be pulled from a repository "
|
||||
"and deployed repeatedly as isolated containers."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:166
|
||||
#: ../../guides/deploy-at-scale.rst:167
|
||||
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 "
|
||||
@@ -296,59 +302,59 @@ msgid ""
|
||||
"applications."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:171
|
||||
#: ../../guides/deploy-at-scale.rst:172
|
||||
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:176
|
||||
msgid "Considerations with stateless systems"
|
||||
" more information visit the `Containers`_ page."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:177
|
||||
msgid "Considerations with stateless systems"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:179
|
||||
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:182
|
||||
#: ../../guides/deploy-at-scale.rst:184
|
||||
msgid "Backup strategy"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:184
|
||||
#: ../../guides/deploy-at-scale.rst:186
|
||||
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:188
|
||||
#: ../../guides/deploy-at-scale.rst:190
|
||||
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:193
|
||||
msgid "Meaningful Logging & Telemetry"
|
||||
"areas like :file:`/home`, :file:`/etc`, and :file:`/var`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:195
|
||||
msgid "Meaningful logging & telemetry"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:197
|
||||
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:198
|
||||
#: ../../guides/deploy-at-scale.rst:200
|
||||
msgid ""
|
||||
"Remote syslogging in |CL| is available through the `systemd journal-"
|
||||
"remote service`_"
|
||||
"Remote syslogging in |CL| is available through the `systemd-journal-"
|
||||
"remote.service`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:201
|
||||
#: ../../guides/deploy-at-scale.rst:203
|
||||
msgid ""
|
||||
"|CL| offers a :ref:`telem-guide`, which can be a powerful tool for a "
|
||||
"large deployment to quickly crowdsource issues of interest. Take "
|
||||
@@ -357,33 +363,34 @@ msgid ""
|
||||
"appropriately."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:207
|
||||
#: ../../guides/deploy-at-scale.rst:209
|
||||
msgid ""
|
||||
"Your telemetry server is just like any other web application. |WEB-"
|
||||
"SERVER-SCALE|"
|
||||
"Like any web server, the telemetry server should be appropriately scaled "
|
||||
"and resilient. Specific implementation details for a scalable, resilient "
|
||||
"web server are beyond the scope of this document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:211
|
||||
msgid "Orchestration and Configuration Management"
|
||||
#: ../../guides/deploy-at-scale.rst:214
|
||||
msgid "Orchestration and configuration management"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:213
|
||||
#: ../../guides/deploy-at-scale.rst:216
|
||||
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:216
|
||||
#: ../../guides/deploy-at-scale.rst:219
|
||||
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`_ ."
|
||||
"configuration during deployment of |CL| endpoints see the :ref:`bulk-"
|
||||
"provision` guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:223
|
||||
#: ../../guides/deploy-at-scale.rst:226
|
||||
msgid ""
|
||||
"A configuration management tool is useful for maintaining consistent "
|
||||
"system and application-level configuration. Ansible\\* is offered through"
|
||||
@@ -391,11 +398,11 @@ msgid ""
|
||||
"automation tool."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:229
|
||||
#: ../../guides/deploy-at-scale.rst:232
|
||||
msgid "Cloud-native applications"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:231
|
||||
#: ../../guides/deploy-at-scale.rst:234
|
||||
msgid ""
|
||||
"An Infrastructure OS can design for good behavior, but it is ultimately "
|
||||
"up to applications to make agile design choices. Applications deployed on"
|
||||
@@ -403,7 +410,7 @@ msgid ""
|
||||
"run. References should be relative and dynamic when possible."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:236
|
||||
#: ../../guides/deploy-at-scale.rst:239
|
||||
msgid ""
|
||||
"The application architecture should incorporate an appropriate tolerance "
|
||||
"for infrastructure outages. Don't just keep stateless design as a noted "
|
||||
@@ -441,3 +448,155 @@ msgstr ""
|
||||
#~ " appropriately."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This is not a replacement or "
|
||||
#~ "blueprint for designing your own IT "
|
||||
#~ "operating environment."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Pick a |CL| usage and update strategy"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Development systems that generate bundles "
|
||||
#~ "and updates should have sufficient "
|
||||
#~ "performance for the task and separate"
|
||||
#~ " from the swupd update webservers "
|
||||
#~ "that serve update content to production"
|
||||
#~ " machines."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "swupd update webservers that serve "
|
||||
#~ "update content to production machines "
|
||||
#~ "(see `mixer process`_ for more "
|
||||
#~ "information) should be appropriately scaled."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Your swupd update server is just "
|
||||
#~ "like any other web application. |WEB-"
|
||||
#~ "SERVER-SCALE|"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Versioning Infrastructure"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Baremetal"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Cloud Instances or Virtual Machines"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Meaningful Logging & Telemetry"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Remote syslogging in |CL| is available"
|
||||
#~ " through the `systemd journal-remote "
|
||||
#~ "service`_"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Your telemetry server is just like "
|
||||
#~ "any other web application. |WEB-"
|
||||
#~ "SERVER-SCALE|"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Orchestration and Configuration Management"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -38,7 +38,11 @@ msgstr ""
|
||||
msgid "Network"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/guides.rst:33
|
||||
#: ../../guides/guides.rst:32
|
||||
msgid "Kernel"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/guides.rst:41
|
||||
msgid "Stacks"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,28 +24,32 @@ msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:6
|
||||
msgid ""
|
||||
"This guide shows how to obtain and compile a Linux* kernel source using "
|
||||
"|CL-ATTR| development tooling."
|
||||
"This guide shows how to obtain and compile a Linux\\* kernel source using"
|
||||
" |CL-ATTR| development tooling."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:9
|
||||
#: ../../guides/kernel/kernel-development.rst:15
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:17
|
||||
msgid ""
|
||||
"The :ref:`compatible-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
|
||||
#: ../../guides/kernel/kernel-development.rst:21
|
||||
msgid ""
|
||||
"`Source RPMs (SRPMS)`_ are also available for all |CL| kernels, and can "
|
||||
"be used for development instead."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:22
|
||||
#: ../../guides/kernel/kernel-development.rst:25
|
||||
msgid "Request changes be included with the |CL| kernel"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:24
|
||||
#: ../../guides/kernel/kernel-development.rst:27
|
||||
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 "
|
||||
@@ -53,39 +57,41 @@ msgid ""
|
||||
"maintain your own modified kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:29
|
||||
msgid "Make enhancement requests to the |CL| `Distribution Project`_ on GitHub."
|
||||
#: ../../guides/kernel/kernel-development.rst:32
|
||||
msgid ""
|
||||
"Make enhancement requests to the |CL| `Distribution Project`_ on "
|
||||
"GitHub\\*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:32
|
||||
#: ../../guides/kernel/kernel-development.rst:35
|
||||
msgid "Set up kernel development environment"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:34
|
||||
#: ../../guides/kernel/kernel-development.rst:37
|
||||
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:37
|
||||
#: ../../guides/kernel/kernel-development.rst:40
|
||||
msgid "You can build and install a custom kernel; however you must:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:39
|
||||
#: ../../guides/kernel/kernel-development.rst:42
|
||||
msgid "Disable Secure Boot"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:40
|
||||
#: ../../guides/kernel/kernel-development.rst:43
|
||||
msgid "Maintain any updates to the kernel going forward"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:42
|
||||
#: ../../guides/kernel/kernel-development.rst:45
|
||||
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:47
|
||||
#: ../../guides/kernel/kernel-development.rst:50
|
||||
msgid "Install the |CL| development tooling framework"
|
||||
msgstr ""
|
||||
|
||||
@@ -138,47 +144,47 @@ msgstr ""
|
||||
msgid "This global setting is used by |CL| tools that make use of Git."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:54
|
||||
#: ../../guides/kernel/kernel-development.rst:57
|
||||
msgid "Clone the kernel package"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:55
|
||||
#: ../../guides/kernel/kernel-development.rst:59
|
||||
msgid ""
|
||||
"Clone the existing kernel package repository from |CL| as a starting "
|
||||
"point."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:57
|
||||
#: ../../guides/kernel/kernel-development.rst:61
|
||||
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`_ repo on GitHub."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:67
|
||||
#: ../../guides/kernel/kernel-development.rst:71
|
||||
msgid "Navigate into the cloned package directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:74
|
||||
#: ../../guides/kernel/kernel-development.rst:78
|
||||
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`_ repo on GitHub."
|
||||
"The \"linux\" package is the kernel that comes with |CL| in the :command"
|
||||
":`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`_ repo on GitHub."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:81
|
||||
#: ../../guides/kernel/kernel-development.rst:85
|
||||
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:85
|
||||
#: ../../guides/kernel/kernel-development.rst:90
|
||||
msgid "Change the kernel version"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:87
|
||||
#: ../../guides/kernel/kernel-development.rst:92
|
||||
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 "
|
||||
@@ -188,198 +194,198 @@ msgid ""
|
||||
"made manually."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:93
|
||||
#: ../../guides/kernel/kernel-development.rst:286
|
||||
#: ../../guides/kernel/kernel-development.rst:98
|
||||
#: ../../guides/kernel/kernel-development.rst:294
|
||||
msgid "Open the Linux kernel package RPM SPEC file in an editor."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:99
|
||||
#: ../../guides/kernel/kernel-development.rst:104
|
||||
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:102
|
||||
#: ../../guides/kernel/kernel-development.rst:107
|
||||
msgid ""
|
||||
"A list of current and available kernel release can be found on "
|
||||
"`kernel.org`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:121
|
||||
#: ../../guides/kernel/kernel-development.rst:126
|
||||
msgid ""
|
||||
"Consider changing the Name from *linux* in the RPM spec file to easily "
|
||||
"identify a modified kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:123
|
||||
#: ../../guides/kernel/kernel-development.rst:129
|
||||
msgid ""
|
||||
"Consider changing the ktarget from *native* in the RPM spec file to "
|
||||
"easily identify a modified kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:125
|
||||
#: ../../guides/kernel/kernel-development.rst:132
|
||||
msgid "Commit and save the changes to the file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:128
|
||||
#: ../../guides/kernel/kernel-development.rst:137
|
||||
msgid "Pull a copy of the Linux kernel source code"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:130
|
||||
#: ../../guides/kernel/kernel-development.rst:139
|
||||
msgid "Obtain a local copy of the source code to make modifications against."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:132
|
||||
#: ../../guides/kernel/kernel-development.rst:141
|
||||
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:140
|
||||
#: ../../guides/kernel/kernel-development.rst:149
|
||||
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:147
|
||||
#: ../../guides/kernel/kernel-development.rst:156
|
||||
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:156
|
||||
#: ../../guides/kernel/kernel-development.rst:165
|
||||
msgid "Customize the Linux kernel source"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:158
|
||||
#: ../../guides/kernel/kernel-development.rst:167
|
||||
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:163
|
||||
#: ../../guides/kernel/kernel-development.rst:172
|
||||
msgid "Modify kernel configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:165
|
||||
#: ../../guides/kernel/kernel-development.rst:174
|
||||
msgid ""
|
||||
"The kernel source has many configuration options available to pick "
|
||||
"support for different hardware and software features."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:167
|
||||
#: ../../guides/kernel/kernel-development.rst:177
|
||||
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:172
|
||||
#: ../../guides/kernel/kernel-development.rst:229
|
||||
#: ../../guides/kernel/kernel-development.rst:182
|
||||
#: ../../guides/kernel/kernel-development.rst:238
|
||||
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."
|
||||
"Make sure you have followed the steps to :ref:`pull-copy-kernel-source` "
|
||||
"and are in the kernel source working directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:177
|
||||
#: ../../guides/kernel/kernel-development.rst:186
|
||||
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:186
|
||||
#: ../../guides/kernel/kernel-development.rst:195
|
||||
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:189
|
||||
#: ../../guides/kernel/kernel-development.rst:198
|
||||
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:192
|
||||
#: ../../guides/kernel/kernel-development.rst:201
|
||||
msgid ""
|
||||
":command:`make config` - a text-based tool that asks questions one-by-one"
|
||||
" to decide configuration options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:195
|
||||
#: ../../guides/kernel/kernel-development.rst:204
|
||||
msgid ""
|
||||
":command:`make menuconfig` - a terminal user interface that provides "
|
||||
"menus to decide configuration options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:198
|
||||
#: ../../guides/kernel/kernel-development.rst:207
|
||||
msgid ""
|
||||
":command:`make xconfig` - a graphical user interface that provides tree "
|
||||
"views to decide configuration options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:202
|
||||
#: ../../guides/kernel/kernel-development.rst:211
|
||||
msgid ""
|
||||
"More configuration tools can be found by looking at the make help: "
|
||||
":command:`make help | grep config`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:205
|
||||
#: ../../guides/kernel/kernel-development.rst:214
|
||||
msgid "Commit and save the changes to the :file:`.config` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:207
|
||||
#: ../../guides/kernel/kernel-development.rst:216
|
||||
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:215
|
||||
#: ../../guides/kernel/kernel-development.rst:224
|
||||
msgid "Modify kernel source code"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:217
|
||||
#: ../../guides/kernel/kernel-development.rst:226
|
||||
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:220
|
||||
#: ../../guides/kernel/kernel-development.rst:229
|
||||
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:224
|
||||
#: ../../guides/kernel/kernel-development.rst:233
|
||||
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:234
|
||||
#: ../../guides/kernel/kernel-development.rst:242
|
||||
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:244
|
||||
#: ../../guides/kernel/kernel-development.rst:252
|
||||
msgid ""
|
||||
"Apply patches provided by the |CL| kernel package to the kernel source in"
|
||||
" the working directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:252
|
||||
#: ../../guides/kernel/kernel-development.rst:260
|
||||
msgid "Make any of your desired code changes to the Linux source code files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:255
|
||||
#: ../../guides/kernel/kernel-development.rst:263
|
||||
msgid "Track and commit your changes to the local git repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:263
|
||||
#: ../../guides/kernel/kernel-development.rst:271
|
||||
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`_"
|
||||
@@ -387,17 +393,17 @@ msgid ""
|
||||
"patch`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:272
|
||||
#: ../../guides/kernel/kernel-development.rst:280
|
||||
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:280
|
||||
#: ../../guides/kernel/kernel-development.rst:288
|
||||
msgid "Navigate back to the RPM build directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:292
|
||||
#: ../../guides/kernel/kernel-development.rst:300
|
||||
msgid ""
|
||||
"Locate the section of the SPEC file that contains existing patch variable"
|
||||
" definitions and append your patch file name. Ensure the patch number "
|
||||
@@ -405,104 +411,104 @@ msgid ""
|
||||
"is called :file:`2001-my-patch-for-driver-A.patch`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:315
|
||||
#: ../../guides/kernel/kernel-development.rst:323
|
||||
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:334
|
||||
#: ../../guides/kernel/kernel-development.rst:342
|
||||
msgid "Commit and save the changes to the RPM SPEC file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:337
|
||||
#: ../../guides/kernel/kernel-development.rst:345
|
||||
msgid "Modify kernel boot parameters"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:338
|
||||
#: ../../guides/kernel/kernel-development.rst:346
|
||||
msgid ""
|
||||
"The kernel boot options are passed from the bootloader to the kernel with"
|
||||
" command-line parameters."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:341
|
||||
#: ../../guides/kernel/kernel-development.rst:349
|
||||
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:346
|
||||
#: ../../guides/kernel/kernel-development.rst:354
|
||||
msgid "Open the kernel :file:`cmdline` file in an editor."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:353
|
||||
#: ../../guides/kernel/kernel-development.rst:361
|
||||
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:357
|
||||
#: ../../guides/kernel/kernel-development.rst:365
|
||||
msgid "Commit and save the changes to the :file:`cmdline` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:359
|
||||
#: ../../guides/kernel/kernel-development.rst:367
|
||||
msgid ""
|
||||
"See the `kernel parameters`_ documentation for a list of available "
|
||||
"parameters."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:363
|
||||
#: ../../guides/kernel/kernel-development.rst:371
|
||||
msgid "Build and install the kernel"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:364
|
||||
#: ../../guides/kernel/kernel-development.rst:372
|
||||
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:367
|
||||
#: ../../guides/kernel/kernel-development.rst:375
|
||||
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:370
|
||||
#: ../../guides/kernel/kernel-development.rst:378
|
||||
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:378
|
||||
#: ../../guides/kernel/kernel-development.rst:386
|
||||
msgid ""
|
||||
"The mock plugin `ccache`_ 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:383
|
||||
#: ../../guides/kernel/kernel-development.rst:391
|
||||
msgid ""
|
||||
"The result will be multiple :file:`.rpm` files in the :file:`rpms` "
|
||||
"directory as output."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:390
|
||||
#: ../../guides/kernel/kernel-development.rst:398
|
||||
msgid ""
|
||||
"The kernel RPM will be named "
|
||||
":file:`linux<NAME>-<VERSION>-<RELEASE>.x86_64.rpm`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:394
|
||||
#: ../../guides/kernel/kernel-development.rst:402
|
||||
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:397
|
||||
#: ../../guides/kernel/kernel-development.rst:405
|
||||
msgid ""
|
||||
"Alternatively, the kernel RPM bundle can be installed manually on a local"
|
||||
" machine for testing. This approach works well for individual development"
|
||||
@@ -510,29 +516,29 @@ msgid ""
|
||||
"using the :ref:`mixer` to provide a custom kernel with updates."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:402
|
||||
#: ../../guides/kernel/kernel-development.rst:410
|
||||
msgid ""
|
||||
"Install the kernel onto the local system by extracting the RPM with the "
|
||||
":command:`rpm2cpio` command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:410
|
||||
#: ../../guides/kernel/kernel-development.rst:418
|
||||
msgid "Update the |CL| boot manager using :command:`clr-boot-manager` and reboot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:420
|
||||
#: ../../guides/kernel/kernel-development.rst:428
|
||||
msgid "After a reboot, verify the customized kernel is running."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:427
|
||||
#: ../../guides/kernel/kernel-development.rst:435
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:429
|
||||
#: ../../guides/kernel/kernel-development.rst:437
|
||||
msgid ":ref:`kernel-modules`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:430
|
||||
#: ../../guides/kernel/kernel-development.rst:438
|
||||
msgid ":ref:`mixer`"
|
||||
msgstr ""
|
||||
|
||||
@@ -604,3 +610,32 @@ msgstr ""
|
||||
#~ " reusing them."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This guide shows how to obtain and"
|
||||
#~ " compile a Linux* kernel source using"
|
||||
#~ " |CL-ATTR| development tooling."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Make enhancement requests to the |CL|"
|
||||
#~ " `Distribution Project`_ on GitHub."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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`_ repo on GitHub."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,6 +24,16 @@ msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:6
|
||||
msgid ""
|
||||
"This guide describes how to add kernel modules with :abbr:`DKMS (Dynamic "
|
||||
"Kernel Module System)`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:16
|
||||
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 "
|
||||
@@ -31,11 +41,11 @@ msgid ""
|
||||
"to :ref:`kernel-modules`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:16
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:22
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:18
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:24
|
||||
msgid ""
|
||||
"Kernel modules are additional pieces of software capable of being "
|
||||
"inserted into the Linux kernel to add functionality, such as a hardware "
|
||||
@@ -44,7 +54,7 @@ msgid ""
|
||||
" (out-of-tree)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:23
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:29
|
||||
msgid ""
|
||||
":abbr:`DKMS (Dynamic Kernel Module System)` is a framework that "
|
||||
"facilitates the building and installation of kernel modules. DKMS allows "
|
||||
@@ -94,46 +104,45 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:35
|
||||
msgid ""
|
||||
"Make enhancement requests to the |CL| `Distribution Project "
|
||||
"<https://github.com/clearlinux/distribution>`_ on GitHub."
|
||||
msgid "Make enhancement requests to the |CL| 'Distribution Project'_ on GitHub."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:37
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:38
|
||||
msgid "Install DKMS"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:41
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:42
|
||||
msgid ""
|
||||
"The *kernel-native-dkms* bundle provides the :command:`dkms` program and "
|
||||
"Linux kernel headers, which are required for compiling kernel modules."
|
||||
"The :command:`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:44
|
||||
msgid "The *kernel-native-dkms* bundle also:"
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:45
|
||||
msgid "The :command:`kernel-native-dkms` bundle also:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:46
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:47
|
||||
msgid ""
|
||||
"Adds a systemd update trigger (:file:`/usr/lib/systemd/system/dkms-new-"
|
||||
"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:51
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:52
|
||||
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:55
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:56
|
||||
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:60
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:61
|
||||
msgid ""
|
||||
"We recommend that you always review the :command:`swupd update` output to"
|
||||
" make sure kernel modules were successfully rebuilt against the new "
|
||||
@@ -173,71 +182,71 @@ msgstr ""
|
||||
msgid "Update the |CL| bootloader and reboot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:106
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:105
|
||||
msgid "Build, install, and load an out-of-tree module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:108
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:107
|
||||
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 :ref:`mixer` tool to provide a custom kernel and updates."
|
||||
" using :ref:`mixer` to provide a custom kernel and updates."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:115
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:113
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:117
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:115
|
||||
msgid "Before you begin, you must:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:119
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:117
|
||||
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:122
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:120
|
||||
msgid ""
|
||||
"Obtain a kernel module package in the form of source code and/or "
|
||||
"precompiled binaries."
|
||||
"Obtain a kernel module package in the form of source code or pre-compiled"
|
||||
" binaries."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:128
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:124
|
||||
msgid "Obtain kernel module source"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:130
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:126
|
||||
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:133
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:129
|
||||
msgid "Kernel modules may come packaged as:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:135
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:131
|
||||
msgid "Source code without a :file:`dkms.conf` file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:136
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:132
|
||||
msgid "Source code with a premade :file:`dkms.conf` file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:137
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:133
|
||||
msgid ""
|
||||
"Source code with a premade :file:`dkms.conf` file and precompiled module "
|
||||
"binaries"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:139
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:135
|
||||
msgid "Precompiled module binaries only (without source code)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:141
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:137
|
||||
msgid ""
|
||||
"Of the package types listed above, only precompiled kernel module "
|
||||
"binaries will not work, because |CL| requires kernel modules to be built "
|
||||
@@ -247,166 +256,166 @@ msgid ""
|
||||
"document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:147
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:143
|
||||
msgid "Download the kernel module's source code."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:149
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:145
|
||||
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:152
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:148
|
||||
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:164
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:159
|
||||
msgid "Build kernel module with an existing dkms.conf"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:166
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:161
|
||||
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:170
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:165
|
||||
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:175
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:169
|
||||
msgid ""
|
||||
"Run the :command:`dkms ldtarball` command against the kernel module "
|
||||
"archive."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:182
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:177
|
||||
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:187
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:182
|
||||
msgid ""
|
||||
"Verify the kernel module is detected by checking the output of the "
|
||||
":command:`dkms status` command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:195
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:190
|
||||
msgid "Install the kernel module."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:204
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:197
|
||||
msgid "Build kernel module without an existing dkms.conf"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:206
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:199
|
||||
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:210
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:203
|
||||
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:214
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:207
|
||||
msgid "Here are some additional resources that can be used for reference:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:216
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:209
|
||||
msgid ""
|
||||
"DKMS manual page (:command:`man dkms`) shows detailed syntax in the "
|
||||
"DKMS.CONF section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:219
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:212
|
||||
msgid ""
|
||||
"Ubuntu community wiki entry for the `Kernel DKMS Package`_ shows an "
|
||||
"example where a single package contains multiple modules."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:222
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:215
|
||||
msgid "Sample `dkms.conf`_ file in the GitHub\\* repository for the DKMS project."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:226
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:219
|
||||
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:229
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:222
|
||||
msgid "The instructions below show a generic example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:231
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:224
|
||||
msgid ""
|
||||
"Create or modify the :file:`dkms.conf` file inside of the extracted "
|
||||
"source code directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:247
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:240
|
||||
msgid ""
|
||||
"This example identifies a kernel module named *custom_module* with "
|
||||
"version *1.0*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:250
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:243
|
||||
msgid "Copy the kernel module source code into the :file:`/usr/src/` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:259
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:252
|
||||
msgid ""
|
||||
"*<PACKAGE_NAME>* and *<PACKAGE_VERSION>* must match the entries in the "
|
||||
":file:`dkms.conf` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:263
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:255
|
||||
msgid "Add the kernel module to the DKMS tree so that it is tracked by DKMS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:269
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:261
|
||||
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:276
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:268
|
||||
msgid "Install the kernel module using DKMS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:285
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:275
|
||||
msgid "Load kernel module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:287
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:277
|
||||
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:290
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:280
|
||||
msgid "Load the installed module with the :command:`modprobe` command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:296
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:286
|
||||
msgid "Validate the kernel module is loaded."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:304
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:293
|
||||
msgid "Examples"
|
||||
msgstr ""
|
||||
|
||||
@@ -460,22 +469,22 @@ msgstr ""
|
||||
msgid "Learn more about module loading in the modules-load.d manual page:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:314
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:300
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:316
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:302
|
||||
msgid "`Dynamic Kernel Module System (DKMS)`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:318
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:304
|
||||
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:320
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:306
|
||||
msgid ""
|
||||
"`Linux Journal: Exploring Dynamic Kernel Module Support "
|
||||
"<https://www.linuxjournal.com/article/6896>`_"
|
||||
@@ -512,3 +521,45 @@ msgstr ""
|
||||
#~ "project on GitHub <https://github.com/dell/dkms>`_"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Make enhancement requests to the |CL|"
|
||||
#~ " `Distribution Project "
|
||||
#~ "<https://github.com/clearlinux/distribution>`_ on GitHub."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The *kernel-native-dkms* bundle provides"
|
||||
#~ " the :command:`dkms` program and Linux "
|
||||
#~ "kernel headers, which are required for"
|
||||
#~ " compiling kernel modules."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The *kernel-native-dkms* bundle also:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 :ref:`mixer` tool to"
|
||||
#~ " provide a custom kernel and updates."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Obtain a kernel module package in "
|
||||
#~ "the form of source code and/or "
|
||||
#~ "precompiled binaries."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -23,6 +23,14 @@ msgid "Add kernel modules manually"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:6
|
||||
msgid "This guide describes how to add kernel modules manually."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:13
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:15
|
||||
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"
|
||||
@@ -30,11 +38,11 @@ msgid ""
|
||||
"kernel modules manually, or refer to :ref:`kernel-modules-dkms`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:17
|
||||
#: ../../guides/kernel/kernel-modules.rst:21
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:19
|
||||
#: ../../guides/kernel/kernel-modules.rst:23
|
||||
msgid ""
|
||||
"Kernel modules are additional pieces of software capable of being "
|
||||
"inserted into the Linux kernel to add functionality, such as a hardware "
|
||||
@@ -43,11 +51,11 @@ msgid ""
|
||||
" (out-of-tree)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:28
|
||||
#: ../../guides/kernel/kernel-modules.rst:32
|
||||
msgid "Kernel module availability"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:30
|
||||
#: ../../guides/kernel/kernel-modules.rst:34
|
||||
msgid ""
|
||||
"|CL| comes with many upstream kernel modules available for use. Using an "
|
||||
"existing module is significantly easier to maintain and retains signature"
|
||||
@@ -55,17 +63,17 @@ msgid ""
|
||||
"practices, see the :ref:`security` page."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:35
|
||||
#: ../../guides/kernel/kernel-modules.rst:39
|
||||
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
|
||||
#: ../../guides/kernel/kernel-modules.rst:44
|
||||
msgid "Check if the module is already available"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:43
|
||||
#: ../../guides/kernel/kernel-modules.rst:47
|
||||
msgid ""
|
||||
"You can search for kernel module file names, which end with the "
|
||||
":file:`.ko` file extension, using the :command:`swupd search` command, as"
|
||||
@@ -73,28 +81,26 @@ msgid ""
|
||||
"information."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:53
|
||||
#: ../../guides/kernel/kernel-modules.rst:57
|
||||
msgid "Submit a request to add the module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:55
|
||||
#: ../../guides/kernel/kernel-modules.rst:59
|
||||
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 Project "
|
||||
"<https://github.com/clearlinux/distribution>`_ on GitHub."
|
||||
#: ../../guides/kernel/kernel-modules.rst:63
|
||||
msgid "Make enhancement requests to the |CL| 'Distribution Project'_ on GitHub."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:66
|
||||
#: ../../guides/kernel/kernel-modules.rst:69
|
||||
msgid "Build, install, and load an out-of-tree module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:68
|
||||
#: ../../guides/kernel/kernel-modules.rst:71
|
||||
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 "
|
||||
@@ -102,122 +108,122 @@ msgid ""
|
||||
" using the :ref:`mixer` to provide a custom kernel and updates."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:75
|
||||
#: ../../guides/kernel/kernel-modules.rst:78
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:77
|
||||
#: ../../guides/kernel/kernel-modules.rst:80
|
||||
msgid "Before you begin, you must:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:79
|
||||
#: ../../guides/kernel/kernel-modules.rst:82
|
||||
msgid "Disable Secure Boot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:80
|
||||
#: ../../guides/kernel/kernel-modules.rst:83
|
||||
msgid "Disable kernel module integrity checking."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:81
|
||||
#: ../../guides/kernel/kernel-modules.rst:84
|
||||
msgid "Have a kernel module package in the form of source code."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:82
|
||||
#: ../../guides/kernel/kernel-modules.rst:85
|
||||
msgid "Rebuild the module against new versions of the Linux kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:86
|
||||
#: ../../guides/kernel/kernel-modules.rst:89
|
||||
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:91
|
||||
#: ../../guides/kernel/kernel-modules.rst:94
|
||||
msgid "Build and install kernel module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:93
|
||||
#: ../../guides/kernel/kernel-modules.rst:96
|
||||
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:101
|
||||
#: ../../guides/kernel/kernel-modules.rst:104
|
||||
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:105
|
||||
msgid "`linux-dev` for developing against the native kernel."
|
||||
#: ../../guides/kernel/kernel-modules.rst:108
|
||||
msgid ":command:`linux-dev` for developing against the native kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:106
|
||||
msgid "`linux-lts-dev` for developing against the LTS kernel."
|
||||
#: ../../guides/kernel/kernel-modules.rst:109
|
||||
msgid ":command:`linux-lts-dev` for developing against the LTS kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:112
|
||||
#: ../../guides/kernel/kernel-modules.rst:115
|
||||
msgid ""
|
||||
"Follow instructions from the kernel module source code to compile the "
|
||||
"kernel module. For example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:125
|
||||
#: ../../guides/kernel/kernel-modules.rst:128
|
||||
msgid "Load kernel module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:127
|
||||
#: ../../guides/kernel/kernel-modules.rst:130
|
||||
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:131
|
||||
#: ../../guides/kernel/kernel-modules.rst:134
|
||||
msgid ""
|
||||
"Disable signature checking for the kernel by modifying the kernel boot "
|
||||
"parameters and reboot the system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:134
|
||||
#: ../../guides/kernel/kernel-modules.rst:137
|
||||
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:143
|
||||
#: ../../guides/kernel/kernel-modules.rst:146
|
||||
msgid ""
|
||||
"Update the boot manager and reboot the system to implement the changed "
|
||||
"kernel parameters."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:153
|
||||
#: ../../guides/kernel/kernel-modules.rst:156
|
||||
msgid ""
|
||||
"If successful, the :command:`clr-boot-manager update` command does not "
|
||||
"return any console output."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:156
|
||||
#: ../../guides/kernel/kernel-modules.rst:159
|
||||
msgid ""
|
||||
"After rebooting, manually load out-of-tree modules using the "
|
||||
":command:`insmod` command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:164
|
||||
#: ../../guides/kernel/kernel-modules.rst:167
|
||||
msgid "Examples"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:169
|
||||
#: ../../guides/kernel/kernel-modules.rst:172
|
||||
msgid "Optional: Specify module options and aliases"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:171
|
||||
#: ../../guides/kernel/kernel-modules.rst:174
|
||||
msgid "Use the :command:`modprobe` command to load a module and set options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:173
|
||||
#: ../../guides/kernel/kernel-modules.rst:176
|
||||
msgid ""
|
||||
":command:`modprobe` may add or remove more than one module due to module "
|
||||
"interdependencies. You can specify which options to use with individual "
|
||||
@@ -225,7 +231,7 @@ msgid ""
|
||||
"directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:181
|
||||
#: ../../guides/kernel/kernel-modules.rst:184
|
||||
msgid ""
|
||||
"All files underneath the :file:`/etc/modprobe.d` directory that end with "
|
||||
"the :file:`.conf` extension specify module options to use when loading. "
|
||||
@@ -234,36 +240,36 @@ msgid ""
|
||||
"special requirements."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:186
|
||||
#: ../../guides/kernel/kernel-modules.rst:189
|
||||
msgid "Learn more about :command:`modprobe` on the modprobe.d manual page:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:193
|
||||
#: ../../guides/kernel/kernel-modules.rst:196
|
||||
msgid "Optional: Configure kernel modules to load at boot"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:195
|
||||
#: ../../guides/kernel/kernel-modules.rst:198
|
||||
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:202
|
||||
#: ../../guides/kernel/kernel-modules.rst:205
|
||||
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:206
|
||||
#: ../../guides/kernel/kernel-modules.rst:209
|
||||
msgid "Learn more about module loading in the modules-load.d manual page:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:216
|
||||
#: ../../guides/kernel/kernel-modules.rst:219
|
||||
msgid "Related topic"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:218
|
||||
#: ../../guides/kernel/kernel-modules.rst:221
|
||||
msgid ":ref:`kernel-modules-dkms`"
|
||||
msgstr ""
|
||||
|
||||
@@ -281,3 +287,15 @@ msgstr ""
|
||||
#~ "provide a custom kernel and updates."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Make enhancement requests to the |CL|"
|
||||
#~ " `Distribution Project "
|
||||
#~ "<https://github.com/clearlinux/distribution>`_ on GitHub."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`linux-dev` for developing against the native kernel."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`linux-lts-dev` for developing against the LTS kernel."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,115 +24,109 @@ 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"
|
||||
"This guide describes the basic, recommended infrastructure and workflow "
|
||||
"for maintaining a |CL-ATTR| derivative."
|
||||
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
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:16
|
||||
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
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:19
|
||||
msgid "Experience using :ref:`mixer <mixer>` to create a |CL|-based distro"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:31
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:21
|
||||
msgid ""
|
||||
"Experience using :ref:`swupd <swupd-guide>` for maintaining the |CL| "
|
||||
"build environment"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:34
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:24
|
||||
msgid "Familiarity with |CL| architecture and reuse of its content in releases"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:37
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:27
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:39
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:29
|
||||
msgid "Maintaining a |CL| derivative requires:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:31
|
||||
msgid "Monitoring upstream |CL| for new releases"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:32
|
||||
msgid "Building software packages and staging"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:33
|
||||
msgid "Employing CI/CD automation for building releases"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:34
|
||||
msgid "Integrating Quality Assurance for testing and validation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:36
|
||||
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."
|
||||
"parts: *Content Workflow*; and *Release Workflow*, shown in Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:49
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:44
|
||||
msgid "Figure 1: Architect the life-cycle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:52
|
||||
msgid "Content workflow"
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:47
|
||||
msgid "Content Workflow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:54
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:49
|
||||
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 "
|
||||
"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 "
|
||||
"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:63
|
||||
msgid "Release workflow"
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:58
|
||||
msgid "Release Workflow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:65
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:60
|
||||
msgid ""
|
||||
"The *Release Workflow* (Figure 1) gathers the content of the RPMs and "
|
||||
"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* "
|
||||
"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."
|
||||
"custom content. The Watcher Pipeline triggers the Release Pipeline to "
|
||||
"create new releases."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:74
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:69
|
||||
msgid "Implementation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:76
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:71
|
||||
msgid ""
|
||||
"Distro factory implements the *Release workflow*. To get started on a "
|
||||
"full implementation, visit |CL| `Distro Factory`_ documentation."
|
||||
"The |CL| Distro Factory manages the Release Workflow. For detailed "
|
||||
"information about Distro Factory deployment, refer to the `clr-distro-"
|
||||
"factory`_ GitHub\\* repo."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
@@ -142,3 +136,72 @@ msgstr ""
|
||||
#~ "factory documentation`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "This guide provides the foundation of the recommended infrastructure."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Content workflow"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Release workflow"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Distro factory implements the *Release "
|
||||
#~ "workflow*. To get started on a "
|
||||
#~ "full implementation, visit |CL| `Distro "
|
||||
#~ "Factory`_ documentation."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -22,12 +22,10 @@ msgstr ""
|
||||
msgid "Assign a static IP address"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:6
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:7
|
||||
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."
|
||||
"This guide explains how to assign a static IP address. This may be "
|
||||
"helpful in scenarios such as a network with no DHCP server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:15
|
||||
@@ -36,26 +34,26 @@ msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:17
|
||||
msgid ""
|
||||
"New installations of |CL| use NetworkManager as the default network "
|
||||
"New installations of |CL-ATTR| 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 "
|
||||
"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 "
|
||||
"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."
|
||||
"Before defining a configuration for assigning a static IP address, verify"
|
||||
" which program is managing the network interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:32
|
||||
@@ -67,28 +65,27 @@ 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."
|
||||
"the network configuration is being managed by NetworkManager, then use "
|
||||
"the instructions for :ref:`using NetworkManager <nm-static-ip>`."
|
||||
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"
|
||||
"If the STATE column for the device shows *unmanaged*, then check 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."
|
||||
"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."
|
||||
"configuration is being managed by `systemd-networkd`, then use the "
|
||||
"instructions for :ref:`using systemd-networkd <networkd-static-ip>`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:62
|
||||
@@ -124,7 +121,7 @@ msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:78
|
||||
msgid ""
|
||||
"The method below uses the command line tool *nmcli* to modify network "
|
||||
"The method below uses the command line tool nmcli to modify network "
|
||||
"connection."
|
||||
msgstr ""
|
||||
|
||||
@@ -133,20 +130,20 @@ msgid "Identify the existing connection name:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:88
|
||||
msgid "The output will look like this:"
|
||||
msgid "Sample output:"
|
||||
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`."
|
||||
"If a connection does not exist, create it with the :command:`nmcli "
|
||||
"connection add` command."
|
||||
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."
|
||||
"in brackets with the appropriate values. Replace *[CONNECTION_NAME]* with"
|
||||
" the NAME from the command above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:112
|
||||
@@ -186,16 +183,16 @@ msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:144
|
||||
msgid ""
|
||||
"Create the :file:`/etc/systemd/network` directory if it doesn't exist "
|
||||
"already:"
|
||||
"Create the :file:`/etc/systemd/network` directory if it does not already "
|
||||
"exist:"
|
||||
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."
|
||||
" variables in brackets with the appropriate values. Replace "
|
||||
"*[INTERFACE_NAME]* with LINK from the output of the :command:`networkctl "
|
||||
"list` command that was run previously."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:168
|
||||
@@ -206,6 +203,116 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:172
|
||||
msgid "Restart the systemd-networkd service:"
|
||||
msgid "Restart the `systemd-networkd` service:"
|
||||
msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "New installations of |CL| use "
|
||||
#~ "NetworkManager as the default network "
|
||||
#~ "interface manager for all network "
|
||||
#~ "connections."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The *cloud* |CL| images continue to "
|
||||
#~ "use systemd-networkd to manage network"
|
||||
#~ " connections."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "In earlier |CL| versions, systemd-"
|
||||
#~ "network was used to manage Ethernet "
|
||||
#~ "interfaces and NetworkManager was used "
|
||||
#~ "for wireless interfaces."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Before defining a configuration for "
|
||||
#~ "assigning a static IP address, you "
|
||||
#~ "should verify which program is managing"
|
||||
#~ " the network interface."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If the STATE column for the device"
|
||||
#~ " shows *unmanaged*, check to see if"
|
||||
#~ " the device is being managed by "
|
||||
#~ "systemd-networkd"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Check the output of :command:`networkctl "
|
||||
#~ "list` to see if systemd-networkd "
|
||||
#~ "is managing the device."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The method below uses the command "
|
||||
#~ "line tool *nmcli* to modify network "
|
||||
#~ "connection."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The output will look like this:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If a connection does not exist, it"
|
||||
#~ " will need to be created with "
|
||||
#~ ":command:`nmcli connection add`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Create the :file:`/etc/systemd/network` directory"
|
||||
#~ " if it doesn't exist already:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Restart the systemd-networkd service:"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,36 +24,48 @@ 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**."
|
||||
"This guide explains how to perform a bulk provision of |CL-ATTR| using a "
|
||||
"combination of the |CL| installer, Ister, and :abbr:`ICIS (Ister Cloud "
|
||||
"Init Service)`."
|
||||
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."
|
||||
#: ../../guides/maintenance/bulk-provision.rst:15
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:17
|
||||
msgid "To configure a bulk provision:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:19
|
||||
msgid "Define Ister configuration files to customize the installation process"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:20
|
||||
msgid "Define cloud-init\\* files to customize the installation instance"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:21
|
||||
msgid ""
|
||||
"Host the configuration files in ICIS to allow Ister to use them during "
|
||||
"the installation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:24
|
||||
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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:30
|
||||
msgid "Figure 1: Bulk provision information flow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:26
|
||||
#: ../../guides/maintenance/bulk-provision.rst:33
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:28
|
||||
#: ../../guides/maintenance/bulk-provision.rst:35
|
||||
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 "
|
||||
@@ -61,76 +73,77 @@ msgid ""
|
||||
"address translation)` for details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:33
|
||||
#: ../../guides/maintenance/bulk-provision.rst:40
|
||||
msgid ""
|
||||
"Because a bulk provision relies on a reboot, ensure the following "
|
||||
"preparations have been made:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:36
|
||||
#: ../../guides/maintenance/bulk-provision.rst:43
|
||||
msgid "No existing disks are bootable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:37
|
||||
#: ../../guides/maintenance/bulk-provision.rst:44
|
||||
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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:48
|
||||
msgid "Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:43
|
||||
#: ../../guides/maintenance/bulk-provision.rst:50
|
||||
msgid ""
|
||||
"Install **ICIS** by following the getting started guide on the `ICIS`_ "
|
||||
"GitHub repository."
|
||||
"Install ICIS by following the getting started guide on the `ICIS`_ "
|
||||
"GitHub\\* repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:46
|
||||
#: ../../guides/maintenance/bulk-provision.rst:53
|
||||
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:"
|
||||
" 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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:92
|
||||
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."
|
||||
"Every Ister installation file hosted on ICIS must contain the the "
|
||||
"`IsterCloudInitSvc` parameter as well as the :command:`os-cloudguest` "
|
||||
"bundle. These entries allow Ister to customize an instance of of an "
|
||||
"install."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:90
|
||||
#: ../../guides/maintenance/bulk-provision.rst:97
|
||||
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:"
|
||||
"the web hosting directory of ICIS. The following example shows an Ister "
|
||||
"configuration file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:99
|
||||
#: ../../guides/maintenance/bulk-provision.rst:106
|
||||
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:"
|
||||
"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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:121
|
||||
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."
|
||||
"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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:125
|
||||
msgid ""
|
||||
"Write a cloud-init document to customize the instance of the installation"
|
||||
" according to your requirements. The `cloud-init`_ documentation provides"
|
||||
@@ -138,62 +151,62 @@ msgid ""
|
||||
"customization options provided by cloud-init after an installation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:123
|
||||
#: ../../guides/maintenance/bulk-provision.rst:130
|
||||
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 "
|
||||
" 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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:134
|
||||
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:"
|
||||
"file in the :file:`static` directory within the web hosting directory of "
|
||||
"ICIS. The following example shows an example assignment:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:137
|
||||
#: ../../guides/maintenance/bulk-provision.rst:144
|
||||
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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:153
|
||||
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|."
|
||||
#: ../../guides/maintenance/bulk-provision.rst:155
|
||||
msgid "http://192.168.1.1:60000/icis/static/ister/ister.conf"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:156
|
||||
msgid "Power-cycle the PXE client and watch it customize the |CL| installation."
|
||||
msgid "http://192.168.1.1:60000/icis/static/ister/ister.json"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:157
|
||||
msgid "http://192.168.1.1:60000/icis/get_config/<MAC address>"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:158
|
||||
msgid "http://192.168.1.1:60000/icis/get_role/<role>"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:159
|
||||
msgid "http://192.168.1.1:60000/ipxe/ipxe_boot_script.txt"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:161
|
||||
msgid "Power on the PXE client and watch it boot and install |CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:163
|
||||
msgid "Power-cycle the PXE client and watch it customize the |CL| installation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:165
|
||||
msgid ""
|
||||
"**Congratulations!** You have successfully performed a bulk provision of "
|
||||
"|CL|."
|
||||
@@ -216,3 +229,126 @@ msgstr ""
|
||||
#~ "by cloud-init after an installation."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Install **ICIS** by following the "
|
||||
#~ "getting started guide on the `ICIS`_ "
|
||||
#~ "GitHub repository."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/icis/static/ister/ister.conf``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/icis/static/ister/ister.json``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/icis/get_config/<MAC address>``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/icis/get_role/<role>``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/ipxe/ipxe_boot_script.txt``"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -23,13 +23,21 @@ msgid "CPU Power and Performance"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:6
|
||||
msgid "This guide explains the CPU power and performance mechanisms in |CL-ATTR|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:13
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:15
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:18
|
||||
msgid ""
|
||||
"By default, |CL| prioritizes maximum CPU performance with the philosophy "
|
||||
"that the faster the program finishes execution, the faster the CPU can "
|
||||
@@ -38,45 +46,45 @@ msgid ""
|
||||
"changing the defaults."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:18
|
||||
#: ../../guides/maintenance/cpu-performance.rst:28
|
||||
msgid "CPU power saving mechanisms"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:20
|
||||
#: ../../guides/maintenance/cpu-performance.rst:30
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:37
|
||||
msgid "C-states (idle states)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:29
|
||||
#: ../../guides/maintenance/cpu-performance.rst:39
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:42
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:45
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:49
|
||||
msgid "To view the current cpuidle driver run this command in a terminal:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:45
|
||||
#: ../../guides/maintenance/cpu-performance.rst:55
|
||||
msgid ""
|
||||
"For troubleshooting, C-states can be limited with a kernel command line "
|
||||
"boot parameter by adding :command:`processor.max_cstate=N "
|
||||
@@ -84,71 +92,71 @@ msgid ""
|
||||
":command:`idle=poll`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:51
|
||||
#: ../../guides/maintenance/cpu-performance.rst:61
|
||||
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:54
|
||||
#: ../../guides/maintenance/cpu-performance.rst:64
|
||||
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:60
|
||||
#: ../../guides/maintenance/cpu-performance.rst:70
|
||||
msgid "P-states (performance states)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:62
|
||||
#: ../../guides/maintenance/cpu-performance.rst:72
|
||||
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."
|
||||
"P-states, also known as *Intel SpeedStep® technology* 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:66
|
||||
#: ../../guides/maintenance/cpu-performance.rst:76
|
||||
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:69
|
||||
#: ../../guides/maintenance/cpu-performance.rst:79
|
||||
msgid ""
|
||||
"P-states can typically be limited or disabled in a system's firmware "
|
||||
"(UEFI/BIOS)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:72
|
||||
#: ../../guides/maintenance/cpu-performance.rst:82
|
||||
msgid "Turbo boost"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:74
|
||||
#: ../../guides/maintenance/cpu-performance.rst:84
|
||||
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 "
|
||||
"`Intel® 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:79
|
||||
#: ../../guides/maintenance/cpu-performance.rst:89
|
||||
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:82
|
||||
#: ../../guides/maintenance/cpu-performance.rst:92
|
||||
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:90
|
||||
#: ../../guides/maintenance/cpu-performance.rst:100
|
||||
msgid "Linux CPU clock frequency scaling"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:92
|
||||
#: ../../guides/maintenance/cpu-performance.rst:102
|
||||
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 "
|
||||
@@ -156,29 +164,29 @@ msgid ""
|
||||
"these states."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:98
|
||||
#: ../../guides/maintenance/cpu-performance.rst:108
|
||||
msgid "Scaling driver"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:100
|
||||
#: ../../guides/maintenance/cpu-performance.rst:110
|
||||
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."
|
||||
"Linux uses the `Intel P-state driver`_, :command:`intel_pstate`, for "
|
||||
"modern Intel processors from the Sandy Bridge generation or newer. Other "
|
||||
"processors may default to the :command:`acpi-cpufreq*` driver which reads"
|
||||
" values from the systems UEFI or BIOS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:105
|
||||
#: ../../guides/maintenance/cpu-performance.rst:115
|
||||
msgid ""
|
||||
"To view the current CPU frequency scaling driver run this command in a "
|
||||
"terminal:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:112
|
||||
#: ../../guides/maintenance/cpu-performance.rst:122
|
||||
msgid "Scaling governor"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:114
|
||||
#: ../../guides/maintenance/cpu-performance.rst:124
|
||||
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 "
|
||||
@@ -187,43 +195,43 @@ msgid ""
|
||||
"clock frequency without a workload."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:120
|
||||
#: ../../guides/maintenance/cpu-performance.rst:130
|
||||
msgid ""
|
||||
"To view the current CPU frequency scaling governor run this command in a "
|
||||
"terminal:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:126
|
||||
#: ../../guides/maintenance/cpu-performance.rst:136
|
||||
msgid "To change the CPU frequency scaling governor:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:128
|
||||
#: ../../guides/maintenance/cpu-performance.rst:138
|
||||
msgid "Disable |CL| enforcement of certain power and performance settings:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:134
|
||||
#: ../../guides/maintenance/cpu-performance.rst:144
|
||||
msgid ""
|
||||
"Change the governor. In the example below, the governor is set to "
|
||||
"*performance*:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:141
|
||||
#: ../../guides/maintenance/cpu-performance.rst:151
|
||||
msgid ""
|
||||
"The list of all governors can be found in the Linux kernel documentation "
|
||||
"on `CPUFreq Governors`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:146
|
||||
#: ../../guides/maintenance/cpu-performance.rst:156
|
||||
msgid ""
|
||||
"The intel_pstate driver only supports *performance* and *powersave* "
|
||||
"governors."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:149
|
||||
#: ../../guides/maintenance/cpu-performance.rst:159
|
||||
msgid "Thermal management"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:151
|
||||
#: ../../guides/maintenance/cpu-performance.rst:161
|
||||
msgid ""
|
||||
"`thermald`_ is a Linux thermal management daemon used to prevent the "
|
||||
"overheating of platforms. When temperature thresholds are exceeded, "
|
||||
@@ -231,28 +239,29 @@ msgid ""
|
||||
"available cooling methods. This can be especially desirable for laptops."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:156
|
||||
#: ../../guides/maintenance/cpu-performance.rst:166
|
||||
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:165
|
||||
#: ../../guides/maintenance/cpu-performance.rst:175
|
||||
msgid "For more information, see the thermald man page:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:171
|
||||
#: ../../guides/maintenance/cpu-performance.rst:181
|
||||
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:"
|
||||
"temperatures from thermald. To use ThermalMonitor, add the :command"
|
||||
":`desktop-apps-extras` bundle and add your user account to the power "
|
||||
"group:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:183
|
||||
#: ../../guides/maintenance/cpu-performance.rst:194
|
||||
msgid ""
|
||||
"After adding a new group you must log out and log back in for the new "
|
||||
"group to take affect."
|
||||
"After adding a new group, you must log out and log back in for the new "
|
||||
"group to take effect."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
@@ -261,3 +270,46 @@ msgstr ""
|
||||
#~ "documentation on CPUFreq Governors`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "After adding a new group you must"
|
||||
#~ " log out and log back in for"
|
||||
#~ " the new group to take affect."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,176 +24,263 @@ 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."
|
||||
"This guide helps you find the minimum set of bundles needed 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."
|
||||
"Before continuing, review the :ref:`swupd <swupd-guide>` guide to learn "
|
||||
"more about the swupd tool and how |CL| simplifies software versioning "
|
||||
"compared to other Linux\\* distributions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:15
|
||||
#: ../../guides/maintenance/developer-workstation.rst:18
|
||||
msgid "Workstation Setup"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:17
|
||||
#: ../../guides/maintenance/developer-workstation.rst:20
|
||||
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."
|
||||
"After installing the minimum set of bundles required to get started, you "
|
||||
"can add more bundles relevant to your specific use case."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:25
|
||||
#: ../../guides/maintenance/developer-workstation.rst:23
|
||||
msgid ""
|
||||
"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 to deploy a leaner OS "
|
||||
"with only bundles relevant to your project."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:28
|
||||
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."
|
||||
"your role may not neatly fit in one of these categories, consider Table 1"
|
||||
" as a starting point."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:30
|
||||
#: ../../guides/maintenance/developer-workstation.rst:33
|
||||
msgid "**Table 1. Developer Profiles**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:34
|
||||
#: ../../guides/maintenance/developer-workstation.rst:37
|
||||
msgid "|CL| Bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:35
|
||||
#: ../../guides/maintenance/developer-workstation.rst:38
|
||||
msgid "*Internet of Things (IoT)*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:36
|
||||
#: ../../guides/maintenance/developer-workstation.rst:39
|
||||
msgid "*System Administrator*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:37
|
||||
#: ../../guides/maintenance/developer-workstation.rst:40
|
||||
msgid "*Client/Cloud/Web Developer*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:39
|
||||
msgid "`editors`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:42
|
||||
msgid ":command:`editors`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:40
|
||||
#: ../../guides/maintenance/developer-workstation.rst:41
|
||||
#: ../../guides/maintenance/developer-workstation.rst:42
|
||||
#: ../../guides/maintenance/developer-workstation.rst:43
|
||||
#: ../../guides/maintenance/developer-workstation.rst:44
|
||||
#: ../../guides/maintenance/developer-workstation.rst:45
|
||||
#: ../../guides/maintenance/developer-workstation.rst:46
|
||||
#: ../../guides/maintenance/developer-workstation.rst:47
|
||||
#: ../../guides/maintenance/developer-workstation.rst:48
|
||||
#: ../../guides/maintenance/developer-workstation.rst:49
|
||||
#: ../../guides/maintenance/developer-workstation.rst:50
|
||||
#: ../../guides/maintenance/developer-workstation.rst:51
|
||||
#: ../../guides/maintenance/developer-workstation.rst:52
|
||||
#: ../../guides/maintenance/developer-workstation.rst:56
|
||||
#: ../../guides/maintenance/developer-workstation.rst:57
|
||||
#: ../../guides/maintenance/developer-workstation.rst:61
|
||||
#: ../../guides/maintenance/developer-workstation.rst:62
|
||||
#: ../../guides/maintenance/developer-workstation.rst:66
|
||||
#: ../../guides/maintenance/developer-workstation.rst:67
|
||||
#: ../../guides/maintenance/developer-workstation.rst:53
|
||||
#: ../../guides/maintenance/developer-workstation.rst:54
|
||||
#: ../../guides/maintenance/developer-workstation.rst:55
|
||||
#: ../../guides/maintenance/developer-workstation.rst:59
|
||||
#: ../../guides/maintenance/developer-workstation.rst:60
|
||||
#: ../../guides/maintenance/developer-workstation.rst:64
|
||||
#: ../../guides/maintenance/developer-workstation.rst:65
|
||||
#: ../../guides/maintenance/developer-workstation.rst:69
|
||||
#: ../../guides/maintenance/developer-workstation.rst:70
|
||||
#: ../../guides/maintenance/developer-workstation.rst:71
|
||||
#: ../../guides/maintenance/developer-workstation.rst:72
|
||||
#: ../../guides/maintenance/developer-workstation.rst:77
|
||||
#: ../../guides/maintenance/developer-workstation.rst:73
|
||||
#: ../../guides/maintenance/developer-workstation.rst:74
|
||||
#: ../../guides/maintenance/developer-workstation.rst:75
|
||||
#: ../../guides/maintenance/developer-workstation.rst:80
|
||||
msgid "✓"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:44
|
||||
msgid "`network-basic`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:47
|
||||
msgid ":command:`network-basic`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:49
|
||||
msgid "`openssh-server`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:52
|
||||
msgid ":command:`openssh-server`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:54
|
||||
msgid "`webserver-basic`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:57
|
||||
msgid ":command:`webserver-basic`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:59
|
||||
msgid "`application-server`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:62
|
||||
msgid ":command:`application-server`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:64
|
||||
msgid "`database-basic`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:67
|
||||
msgid ":command:`database-basic`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:69
|
||||
msgid "`desktop-autostart`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:72
|
||||
msgid ":command:`desktop-autostart`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:74
|
||||
msgid "`dev-utils`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:77
|
||||
msgid ":command:`dev-utils`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:80
|
||||
msgid "`swupd` search"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:83
|
||||
msgid "swupd search"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:82
|
||||
#: ../../guides/maintenance/developer-workstation.rst:85
|
||||
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:85
|
||||
#: ../../guides/maintenance/developer-workstation.rst:88
|
||||
msgid ""
|
||||
"The guide provides an :ref:`example <swupd-guide-example-install-bundle>`"
|
||||
" that shows you how to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:88
|
||||
msgid "Use `swupd` to search for bundles"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:89
|
||||
msgid "Use `swupd` to add bundles"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:91
|
||||
msgid "Use swupd to search for bundles"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:92
|
||||
msgid "Use swupd to add bundles"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:95
|
||||
msgid "Core Concepts"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:94
|
||||
#: ../../guides/maintenance/developer-workstation.rst:97
|
||||
msgid ""
|
||||
"We recommend that you understand these core concepts in |CL| *before* "
|
||||
"developing your project."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:97
|
||||
msgid ":ref:`Bundles <bundles-about>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:98
|
||||
msgid ":ref:`Software update <swupd-about>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:99
|
||||
msgid ":ref:`Mixer <mixer-about>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:100
|
||||
msgid ":ref:`Autospec <autospec-about>`"
|
||||
msgid ":ref:`Software update <swupd-guide>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:103
|
||||
msgid "Other resources for developers"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:101
|
||||
msgid ":ref:`Mixer <mixer>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:102
|
||||
msgid ":ref:`Autospec <autospec>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:105
|
||||
msgid "Other resources for developers"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:107
|
||||
msgid "`Developer Tooling Framework`_ for |CL|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:106
|
||||
#: ../../guides/maintenance/developer-workstation.rst:108
|
||||
msgid "`Bundle Definition Files`_"
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "`Bundle definition files`_"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "*Developer Workstation* helps you find "
|
||||
#~ "the :ref:`bundles-about` you need to "
|
||||
#~ "start your |CL-ATTR| development "
|
||||
#~ "project."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "`editors`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`network-basic`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`openssh-server`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`webserver-basic`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`application-server`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`database-basic`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`desktop-autostart`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`dev-utils`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`swupd` search"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Use `swupd` to search for bundles"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Use `swupd` to add bundles"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`Bundles <bundles-about>`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`Software update <swupd-about>`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`Mixer <mixer-about>`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`Autospec <autospec-about>`"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -0,0 +1,349 @@
|
||||
# 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-22 12:54-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.rst:4
|
||||
msgid "Download, verify, and decompress a |CL-ATTR| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:6
|
||||
msgid ""
|
||||
"This guide describes the available types of |CL| images, where to "
|
||||
"download them, how to verify their integrity, and how to decompress them."
|
||||
" Follow the steps for your OS."
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:22
|
||||
msgid "Linux OS steps"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:27
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:86
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:131
|
||||
msgid "Verify the integrity of the |CL| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:29
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:88
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:133
|
||||
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.rst:34
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:93
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:138
|
||||
msgid "Download the corresponding SHA512 checksum file of your |CL| `image`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:35
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:61
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:94
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:114
|
||||
msgid "Open a Terminal."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:36
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:95
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:140
|
||||
msgid "Go to the directory with the downloaded image and checksum files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:37
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:96
|
||||
msgid ""
|
||||
"Verify the integrity of the image and compare it to its original checksum"
|
||||
" with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:44
|
||||
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.rst:49
|
||||
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.rst:55
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:108
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:151
|
||||
msgid "Decompress the |CL| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:57
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:153
|
||||
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.rst:62
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:115
|
||||
msgid "Go to the directory with the downloaded image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:64
|
||||
msgid "To decompress an XZ image, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:70
|
||||
msgid "To decompress a GZ image, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:81
|
||||
msgid "macOS\\* steps"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:103
|
||||
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.rst:110
|
||||
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.rst:116
|
||||
msgid ""
|
||||
"Use the :command:`gunzip` command to decompress either compression type. "
|
||||
"For example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:126
|
||||
msgid "Windows\\* OS steps"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:139
|
||||
msgid "Start Command Prompt."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:141
|
||||
msgid "Get the SHA512 checksum of the image with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:147
|
||||
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.rst:157
|
||||
msgid "Download and install `7-Zip`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:158
|
||||
msgid "Go to the directory with the downloaded image and right-click it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:159
|
||||
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.rst:166
|
||||
msgid "Figure 1: Windows 7-Zip extract file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:171
|
||||
msgid "Image types"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:3
|
||||
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:6
|
||||
msgid "Table 1: Types of platform-independent |CL| images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:10 ../../reference/image-types.rst:23
|
||||
msgid "Image Type"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:11 ../../reference/image-types.rst:24
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:13
|
||||
msgid "live-desktop.img or live-desktop.iso"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:14
|
||||
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:16
|
||||
msgid "live-server.img or live-server.iso"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:17
|
||||
msgid "Image for booting to server command prompt to preview or install the OS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:19
|
||||
msgid "Table 2: Types of platform-specific |CL| images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:26
|
||||
msgid "aws.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:27
|
||||
msgid "Image suitable for use with Amazon\\* AWS\\*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:29
|
||||
msgid "azure.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:30
|
||||
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:32
|
||||
msgid "azure-docker.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:33
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
|
||||
"Docker\\* pre-installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:35
|
||||
msgid "azure-machine-learning.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:36
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
|
||||
"`machine-learning-basic` bundle installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:38
|
||||
msgid "cloudguest.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:39
|
||||
msgid ""
|
||||
"Image with generic cloud guest virtual machine (VM) requirements "
|
||||
"installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:41
|
||||
msgid "gce.tar"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:42
|
||||
msgid "Image with the Google Compute Engine (GCE) specific kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:44
|
||||
msgid "hyperv.vhdx"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:45
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
|
||||
"`optimized kernel`_ for Hyper-V."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:47
|
||||
msgid "kvm.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:48
|
||||
msgid ""
|
||||
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
|
||||
"kernel`_ for KVM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:51
|
||||
msgid "kvm-legacy.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:52
|
||||
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:54
|
||||
msgid "pxe.tar"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:55
|
||||
msgid "Image suitable for use with PXE server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:57
|
||||
msgid "vmware.vmdk"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:58
|
||||
msgid ""
|
||||
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
|
||||
"Workstation, and ESXi."
|
||||
msgstr ""
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,8 +24,8 @@ 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:"
|
||||
"This guide provides steps to complete the following basic setup tasks for"
|
||||
" a newly installed |CL-ATTR| system:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:14
|
||||
@@ -35,7 +35,7 @@ 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:"
|
||||
"following commands as a root user:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:24
|
||||
@@ -47,27 +47,27 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:30
|
||||
msgid "Add the new user to the `wheel` group"
|
||||
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>`."
|
||||
" 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`_."
|
||||
"<userid> to the `wheel group`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:38
|
||||
msgid "Add `<userid>` to the `wheel` group:"
|
||||
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>`."
|
||||
msgid "Log out of root and into the new <userid>."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:46
|
||||
@@ -75,11 +75,11 @@ 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."
|
||||
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>`."
|
||||
msgid "You will now be in the home directory of <userid>."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:53
|
||||
@@ -104,16 +104,16 @@ msgstr ""
|
||||
#: ../../guides/maintenance/enable-user-space.rst:67
|
||||
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."
|
||||
":command:`swupd bundle-add`. Experienced Linux users might compare swupd "
|
||||
"to running :command:`apt-get` or :command:`yum install` for package "
|
||||
"management. However |CL| manages packages at the level of bundles, which "
|
||||
"are integrated stacks of packages."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:73
|
||||
msgid ""
|
||||
"For example, the `sysadmin-basic` bundle installs the majority of "
|
||||
"applications useful to a system administrator. To install it, enter:"
|
||||
"For example, the :command:`sysadmin-basic` bundle installs the majority "
|
||||
"of applications useful to a system administrator. To install it, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:80
|
||||
@@ -161,3 +161,63 @@ msgstr ""
|
||||
#~ "deprecated."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This section provides steps to complete"
|
||||
#~ " the following basic setup tasks for"
|
||||
#~ " a newly installed |CL-ATTR| system:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "To create a new user and set "
|
||||
#~ "a password for that user, enter "
|
||||
#~ "the following commands as a `root` "
|
||||
#~ "user:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Add the new user to the `wheel` group"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Before logging off as root and "
|
||||
#~ "logging into your new user account, "
|
||||
#~ "enable the :command:`sudo` command for "
|
||||
#~ "your new `<userid>`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "To be able to execute all "
|
||||
#~ "applications with root privileges, add "
|
||||
#~ "the `<userid>` to the `wheel group`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Add `<userid>` to the `wheel` group:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Log out of root and into the new `<userid>`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Enter the new `<userid>` and the password created earlier."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "You will now be in the home directory of `<userid>`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For example, the `sysadmin-basic` bundle"
|
||||
#~ " installs the majority of applications "
|
||||
#~ "useful to a system administrator. To "
|
||||
#~ "install it, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -19,39 +19,48 @@ msgstr ""
|
||||
"Generated-By: Babel 2.7.0\n"
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:4
|
||||
msgid "Fix a broken installation of |CL-ATTR|"
|
||||
msgid "Fix a broken installation"
|
||||
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."
|
||||
"This guide explains how to fix a broken installation of |CL-ATTR| using a"
|
||||
" live desktop image on a USB."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:10
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:16
|
||||
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."
|
||||
"This guide assumes you have installed |CL| on a target system, but the OS"
|
||||
" does not boot or function properly."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:15
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:19
|
||||
msgid ""
|
||||
"The process described in this guide can only verify and fix files that "
|
||||
":ref:`swupd<swupd-guide>` owns in :file:`/usr`. Files outside of this "
|
||||
"path, such as :file:`/home/`, :file:`/etc`, :file:`/var`, etc., cannot be"
|
||||
" repaired by this process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:25
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:17
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:27
|
||||
msgid ""
|
||||
":ref:`Download and install the live desktop image on a USB <bare-metal-"
|
||||
"install-desktop>`"
|
||||
"Download and install the live desktop image on a USB. See :ref:`bare-"
|
||||
"metal-install-desktop` for install instructions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:20
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:31
|
||||
msgid "Boot a live desktop image to fix target system"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:22
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:33
|
||||
msgid "Boot the |CL| live desktop image."
|
||||
msgstr ""
|
||||
|
||||
@@ -101,59 +110,96 @@ msgstr ""
|
||||
msgid "Figure 1: Clear Linux OS in boot menu"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:29
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:40
|
||||
msgid "Mount root partition, verify, and fix"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:31
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:42
|
||||
msgid "Open a Terminal window."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:33
|
||||
msgid "Assure the system is connected to the network."
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:44
|
||||
msgid "Ensure the system is connected to the network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:35
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:46
|
||||
msgid "Mount the system’s root partition."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:37
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:48
|
||||
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."
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:54
|
||||
msgid "We'll use :file:`/dev/sda3/` as the root partition example."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:45
|
||||
msgid "Next, mount the partition to the `/mnt` folder."
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:56
|
||||
msgid "Next, mount the partition to the :file:`/mnt` folder."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:51
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:62
|
||||
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
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:70
|
||||
msgid "Next, run swupd to fix any issues on the target system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:65
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:76
|
||||
msgid ":ref:`Learn more about how swupd works <swupd-guide>`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:67
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:78
|
||||
msgid "After the process is complete, unmount the root partition:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:73
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:84
|
||||
msgid ""
|
||||
"Reboot the system, remove the live desktop USB drive, and boot into the "
|
||||
"repaired system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:80
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:91
|
||||
msgid "**Congratulations!** You successfully restored |CL|."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Fix a broken installation of |CL-ATTR|"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ ":ref:`Download and install the live "
|
||||
#~ "desktop image on a USB <bare-"
|
||||
#~ "metal-install-desktop>`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Assure the system is connected to the network."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "We'll use `/dev/sda3/` as the root partition example."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Next, mount the partition to the `/mnt` folder."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -19,7 +19,7 @@ msgstr ""
|
||||
"Generated-By: Babel 2.7.0\n"
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:4
|
||||
msgid "Modify hostname on |CL-ATTR|"
|
||||
msgid "Modify hostname"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:6
|
||||
@@ -28,7 +28,11 @@ msgid ""
|
||||
"ATTR| system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:9
|
||||
#: ../../guides/maintenance/hostname.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:16
|
||||
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 "
|
||||
@@ -39,37 +43,37 @@ msgid ""
|
||||
"examples show human-friendly machine names:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:17
|
||||
#: ../../guides/maintenance/hostname.rst:24
|
||||
msgid "*regression-test*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:18
|
||||
#: ../../guides/maintenance/hostname.rst:25
|
||||
msgid "*sally-test-box1*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:19
|
||||
#: ../../guides/maintenance/hostname.rst:26
|
||||
msgid "*az-bldg2-lab*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:22
|
||||
#: ../../guides/maintenance/hostname.rst:29
|
||||
msgid "Set your hostname"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:24
|
||||
#: ../../guides/maintenance/hostname.rst:31
|
||||
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."
|
||||
"machine name. :command:`hostnamectl` is part of the :command:`os-core` "
|
||||
"bundle, which provides a basic Linux\\* user space and utilities."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:28
|
||||
#: ../../guides/maintenance/hostname.rst:35
|
||||
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
|
||||
#: ../../guides/maintenance/hostname.rst:46
|
||||
msgid ""
|
||||
"There are three types of hostname: *static*, *transient*, and *pretty*. "
|
||||
"The most common is the static hostname. Static hostnames must be between "
|
||||
@@ -77,34 +81,46 @@ msgid ""
|
||||
"and may contain letters (case-insensitive), numbers, dashes, or dots."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:44
|
||||
#: ../../guides/maintenance/hostname.rst:51
|
||||
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
|
||||
#: ../../guides/maintenance/hostname.rst:55
|
||||
msgid ""
|
||||
"The pretty hostname is a free-form UTF8 name used for presentation to the"
|
||||
" user."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:51
|
||||
#: ../../guides/maintenance/hostname.rst:58
|
||||
msgid "View your hostname"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:53
|
||||
#: ../../guides/maintenance/hostname.rst:60
|
||||
msgid "View your current hostname using the following command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:59
|
||||
#: ../../guides/maintenance/hostname.rst:66
|
||||
msgid "You should see output similar to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:74
|
||||
#: ../../guides/maintenance/hostname.rst:81
|
||||
msgid ""
|
||||
"**Congratulations!** You successfully modified the hostname of your |CL| "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Modify hostname on |CL-ATTR|"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -19,59 +19,60 @@ msgstr ""
|
||||
"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"
|
||||
msgid "Increase virtual disk size of an 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."
|
||||
"This guide describes how to increase the disk size of your prebuilt |CL-"
|
||||
"ATTR| 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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:14
|
||||
msgid "Determine the partition order and sizes of the prebuilt image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:15
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:16
|
||||
msgid ""
|
||||
"|CL| prebuilt images come in different sizes, ranging from 300 MB to 20 "
|
||||
"GB."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:19
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:22
|
||||
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 (/)"
|
||||
"with :file:`/dev/sda3` being the partition for the root filesystem (/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:22
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:26
|
||||
msgid "Checking :command:`lsblk` on the VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:24
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:28
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:35
|
||||
msgid "An example output of the :command:`lsblk` command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:41
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:45
|
||||
msgid "An example of this can also be seen in Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:44
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:48
|
||||
msgid "Checking :file:`config.json` used to build the image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:46
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:50
|
||||
msgid ""
|
||||
"The second method to determine partition to check the :file:`config.json`"
|
||||
" file used to create prebuilt image, located in the `releases`_ "
|
||||
@@ -79,167 +80,238 @@ msgid ""
|
||||
" number 20450, follow these steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:51
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:55
|
||||
msgid "Go to the `releases`_ repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:52
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:56
|
||||
msgid "Drill down into the `20450 > clear > config > image` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:53
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:57
|
||||
msgid "Open the :file:`hyperv-config.json` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:54
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:58
|
||||
msgid "Locate the `PartitionLayout` key."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:56
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:60
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:80
|
||||
msgid "Increase virtual disk size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:77
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:81
|
||||
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:"
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:85
|
||||
msgid "Power off VM and increase virtual disk size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:83
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:87
|
||||
msgid ""
|
||||
"To increase the virtual disk size for a prebuilt image, perform the steps"
|
||||
" below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:86
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:90
|
||||
msgid "Shut down your VM if it is running."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:87
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:91
|
||||
msgid ""
|
||||
"Use the process defined by your hypervisor or cloud provider to increase "
|
||||
"the virtual disk size of your |CL| VM."
|
||||
"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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:93
|
||||
msgid "Power up the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:94
|
||||
msgid "Resize the partition of the virtual disk:"
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:97
|
||||
msgid "Resize the partition of the virtual disk"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:96
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:99
|
||||
msgid "Log in to an account with root privileges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:97
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:100
|
||||
msgid "Open a terminal emulator."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:98
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:101
|
||||
msgid ""
|
||||
"Add the |CL| `storage-utils` bundle to install the :command:`parted` and "
|
||||
":command:`resize2fs` tools."
|
||||
"Add the :command:`storage-utils` bundle to install the :command:`parted` "
|
||||
"and :command:`resize2fs` tools."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:105
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:108
|
||||
msgid "Launch the `parted` tool."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:111
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:114
|
||||
msgid "In the `parted` tool, perform these steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:113
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:116
|
||||
msgid "Press :command:`p` to print the partitions table."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:114
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:117
|
||||
msgid "If the warning message below is displayed, enter :command:`Fix`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:124
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:127
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:129
|
||||
msgid "Enter :command:`yes` when prompted."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:127
|
||||
msgid "Enter the new `End` size."
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:130
|
||||
msgid "Enter the new End size."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:131
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:134
|
||||
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."
|
||||
":command:`p` command, the total disk size is shown after the "
|
||||
":guilabel:`Disk` label."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:136
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:139
|
||||
msgid "An example of this can be seen in Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:138
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:141
|
||||
msgid ""
|
||||
"Enter :command:`q` to exit `parted` when you are finished resizing the "
|
||||
"image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:141
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:144
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:150
|
||||
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`."
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:153
|
||||
msgid "Resize the filesystem"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:155
|
||||
msgid ""
|
||||
"Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where "
|
||||
"*[modified partition name]* is the partition that was changed in the "
|
||||
"`parted` tool."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:159
|
||||
msgid "Run the :command:`df -h` to verify that the filesystem size has increased."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:158
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:162
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:169
|
||||
msgid "Figure 2: Increase root filesystem size after partition has been expanded."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:166
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:171
|
||||
msgid ""
|
||||
"Congratulations! You have resized the disk, partition, and filesystem. At"
|
||||
" this point, the increase in disk capacity is usable."
|
||||
"**Congratulations!** You have resized the disk, partition, and "
|
||||
"filesystem. At this point, the increase in disk capacity is usable."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Increase virtual disk size of a |CL-ATTR| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "This guide will cover:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Power off VM and increase virtual disk size:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Use the process defined by your "
|
||||
#~ "hypervisor or cloud provider to increase"
|
||||
#~ " the virtual disk size of your "
|
||||
#~ "|CL| VM."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Resize the partition of the virtual disk:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Add the |CL| `storage-utils` bundle "
|
||||
#~ "to install the :command:`parted` and "
|
||||
#~ ":command:`resize2fs` tools."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Enter the new `End` size."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Resize the filesytem"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Enter :command:`sudo resize2fs -p "
|
||||
#~ "/dev/[modified partition name]` where "
|
||||
#~ "*[modified partition name]* is the "
|
||||
#~ "partition that was changed in `parted`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Congratulations! You have resized the "
|
||||
#~ "disk, partition, and filesystem. At this"
|
||||
#~ " point, the increase in disk capacity"
|
||||
#~ " is usable."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -0,0 +1,168 @@
|
||||
# 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-22 12:54-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/query-upstream.rst:4
|
||||
msgid "Query package info from upstream repository"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:6
|
||||
msgid ""
|
||||
"This guide describes how to query package information from the |CL| "
|
||||
"upstream repositories. This guide is intended for developers and advanced"
|
||||
" users."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:15
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:17
|
||||
msgid ""
|
||||
"In |CL-ATTR|, the :ref:`swupd<swupd-guide>` tool manages software "
|
||||
"dependencies and installs bundles instead of packages. Although a bundle "
|
||||
"is a collection of one or more packages, |CL| does not work with packages"
|
||||
" on the client side. However, on the upstream/factory side, |CL| does "
|
||||
"work with packages using a process called *mixing*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:23
|
||||
msgid ""
|
||||
"Currently, :command:`swupd` does not report which packages are installed,"
|
||||
" provide package version information, or return other package details. "
|
||||
"This guide describes a method for retrieving package information from the"
|
||||
" |CL| upstream repositories using :abbr:`DNF(Dandified Yum)` commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:29
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:31
|
||||
msgid ""
|
||||
"This guide assumes you have installed |CL| on your host system. For "
|
||||
"detailed instructions on installing |CL| on a bare metal system, visit "
|
||||
"the :ref:`bare metal installation guide <bare-metal-install-desktop>`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:35
|
||||
msgid ""
|
||||
"Before you install any new packages, update |CL| with the following "
|
||||
"command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:42
|
||||
msgid "Configure DNF"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:44
|
||||
msgid "Install the DNF bundle with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:50
|
||||
msgid "Create a :file:`dnf.conf` file with the commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:58
|
||||
msgid ""
|
||||
"Edit the :file:`/etc/dnf/dnf.conf` file and set the **baseurl** variable "
|
||||
"for binary and source RPMs as shown in lines 3 and 9 in the following "
|
||||
"example."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:78
|
||||
msgid "Initialize the RPM database with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:86
|
||||
msgid "DNF command usage examples"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:93
|
||||
msgid "List all binary and source RPMs in the current release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:95
|
||||
#: ../../guides/maintenance/query-upstream.rst:129
|
||||
#: ../../guides/maintenance/query-upstream.rst:150
|
||||
#: ../../guides/maintenance/query-upstream.rst:173
|
||||
#: ../../guides/maintenance/query-upstream.rst:196
|
||||
#: ../../guides/maintenance/query-upstream.rst:215
|
||||
msgid "Command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:101
|
||||
#: ../../guides/maintenance/query-upstream.rst:135
|
||||
#: ../../guides/maintenance/query-upstream.rst:156
|
||||
#: ../../guides/maintenance/query-upstream.rst:179
|
||||
#: ../../guides/maintenance/query-upstream.rst:202
|
||||
#: ../../guides/maintenance/query-upstream.rst:221
|
||||
msgid "Sample output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:125
|
||||
msgid "Show version information for a package in current release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:127
|
||||
msgid "This example queries version information for the zstd package."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:145
|
||||
msgid "Show version information for a package in a specific release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:147
|
||||
msgid ""
|
||||
"This example queries version information for the zstd package in release "
|
||||
"21000."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:168
|
||||
msgid ""
|
||||
"Show only version and release information for a package in a specific "
|
||||
"release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:170
|
||||
msgid ""
|
||||
"This example queries version and release information for the zstd package"
|
||||
" in release 15000."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:191
|
||||
msgid "Show the binary package for a specified binary file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:193
|
||||
msgid ""
|
||||
"This example returns the binary package that contains the "
|
||||
":file:`/usr/bin/zip` binary file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:210
|
||||
msgid "Show the source package for a specified binary file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:212
|
||||
msgid ""
|
||||
"This example returns the source package that contains the "
|
||||
":file:`/usr/bin/zip` binary file."
|
||||
msgstr ""
|
||||
|
||||
@@ -0,0 +1,237 @@
|
||||
# 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-22 12:54-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/restart.rst:4
|
||||
msgid "Restart system services after an OS update"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:6
|
||||
msgid "This guide describes how to use the :command:`clr-service-restart` tool."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:13
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:15
|
||||
msgid ""
|
||||
"|CL-ATTR| includes a :command:`clr-service-restart` tool that shows which"
|
||||
" system daemons require a restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:18
|
||||
msgid ""
|
||||
":command:`clr-service-restart` reads various files in the :file:`procfs` "
|
||||
"filesystem provided by the kernel and relies on :command:`systemd` to "
|
||||
"determine which services to restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:24
|
||||
msgid "How it works"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:26
|
||||
msgid ""
|
||||
":command:`clr-service-restart` implements a whitelist to identify which "
|
||||
"daemons can be restarted. As a system administrator, you can customize "
|
||||
"the default |CL| OS whitelist using :command:`allow` or "
|
||||
":command:`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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:35
|
||||
msgid "Basic options"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:37
|
||||
msgid ""
|
||||
":command:`clr-service-restart` has three basic options: :command:`allow`,"
|
||||
" :command:`disallow`, and :command:`default`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:41
|
||||
msgid "allow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:43
|
||||
msgid ""
|
||||
"The :command:`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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:54
|
||||
msgid "disallow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:56
|
||||
msgid ""
|
||||
"The :command:`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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:68
|
||||
msgid "default"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:70
|
||||
msgid ""
|
||||
"The :command:`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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:81
|
||||
msgid "Monitor options"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:83
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:87
|
||||
msgid ""
|
||||
"If you pass both options (:command:`-a` and :command:`-n`) described "
|
||||
"below, :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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:94
|
||||
msgid "-n option"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:96
|
||||
msgid ""
|
||||
"The :command:`-n` 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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:100
|
||||
msgid "Which service needs a restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:101
|
||||
msgid "What unit it is."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:102
|
||||
msgid "Why it needs a restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:103
|
||||
msgid "Which command is required to restart the unit."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:106
|
||||
msgid "-a option"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:108
|
||||
msgid ""
|
||||
"The :command:`-a` 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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:114
|
||||
msgid "Example"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:116
|
||||
msgid ""
|
||||
"In the example below, :command:`clr-service-restart` is invoked with both"
|
||||
" the :command:`-a` and :command:`-n` options, which displays a complete "
|
||||
"list of system services that require a restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:120
|
||||
msgid "Command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:126
|
||||
msgid "Sample output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:138
|
||||
msgid "Telemetry"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:140
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:146
|
||||
msgid "If a unit fails to automatically restart after an OS update."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:147
|
||||
msgid ""
|
||||
"If that unit resides in the system location "
|
||||
":file:`/usr/lib/systemd/system`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:149
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:157
|
||||
msgid "Conclusion"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:159
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:164
|
||||
msgid "https://github.com/clearlinux/clr-service-restart"
|
||||
msgstr ""
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -23,56 +23,72 @@ 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."
|
||||
"This guide describes how to reset the time in your |CL-ATTR| 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."
|
||||
#: ../../guides/maintenance/time.rst:9
|
||||
msgid "|CL| uses the `systemd-timesyncd.service` daemon to synchronize time."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:17
|
||||
#: ../../guides/maintenance/time.rst:12
|
||||
msgid "Install the :command:`sysadmin-basic` bundle."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:18
|
||||
msgid "Set your time zone. This example uses Los Angeles."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:25
|
||||
#: ../../guides/maintenance/time.rst:26
|
||||
msgid ""
|
||||
"To see a list of time zones, use the command: :command:`timedatectl list-"
|
||||
"timezones | grep <locale>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:28
|
||||
#: ../../guides/maintenance/time.rst:29
|
||||
msgid "Create a :file:`/etc/systemd/` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:34
|
||||
#: ../../guides/maintenance/time.rst:35
|
||||
msgid ""
|
||||
"Create a new file named :file:`/etc/systemd/timesyncd.conf` and enter the"
|
||||
" following text."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:43
|
||||
#: ../../guides/maintenance/time.rst:44
|
||||
msgid "Enable the `systemd-timesyncd` service."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:51
|
||||
#: ../../guides/maintenance/time.rst:52
|
||||
msgid ""
|
||||
"To check the service status, use the :command:`timedatectl status` "
|
||||
"command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:53
|
||||
#: ../../guides/maintenance/time.rst:54
|
||||
msgid ""
|
||||
"To restart the `timesyncd` daemon, enter :command:`systemctl restart "
|
||||
"systemd-timesyncd` into your terminal emulator."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:56
|
||||
#: ../../guides/maintenance/time.rst:57
|
||||
msgid "**Congratulations!** You successfully set up the time in your |CL| system."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "|CL-ATTR| uses the `systemd-"
|
||||
#~ "timesyncd.service` daemon to synchronize time."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Install the `sysadmin-basic` bundle."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -22,121 +22,219 @@ msgstr ""
|
||||
msgid "Validate signatures"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:6
|
||||
#: ../../guides/maintenance/validate-signatures.rst:7
|
||||
msgid "This guide describes how to validate the contents of a |CL-ATTR| image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:16
|
||||
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 "
|
||||
"Validating the contents of an image is a manual process and is the same "
|
||||
"process that :ref:`swupd-guide` performs internally."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:19
|
||||
msgid ""
|
||||
"|CL| 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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:28
|
||||
msgid "Image content validation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:20
|
||||
#: ../../guides/maintenance/validate-signatures.rst:30
|
||||
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."
|
||||
"In the steps below, we used the installer image of the latest release of "
|
||||
"|CL|. You may use any image of |CL| you choose."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:23
|
||||
#: ../../guides/maintenance/validate-signatures.rst:33
|
||||
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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:45
|
||||
msgid "Generate the SHA256 sum of the |CL| certificate."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:41
|
||||
#: ../../guides/maintenance/validate-signatures.rst:51
|
||||
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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:58
|
||||
msgid "Generate the SHA512 sum of the image and save it to a file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:54
|
||||
#: ../../guides/maintenance/validate-signatures.rst:64
|
||||
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 "
|
||||
" |CL| certificate. This confirms that the image is trusted and has not "
|
||||
"been modified."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:64
|
||||
#: ../../guides/maintenance/validate-signatures.rst:115
|
||||
#: ../../guides/maintenance/validate-signatures.rst:74
|
||||
#: ../../guides/maintenance/validate-signatures.rst:125
|
||||
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."
|
||||
"The :command:`-purpose any` option is required when using OpenSSL 1.1. If"
|
||||
" you use an earlier version of OpenSSL, omit this option to perform "
|
||||
"signature validation. The :command:`openssl version` command may be used"
|
||||
" to determine the version of OpenSSL in use."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:69
|
||||
#: ../../guides/maintenance/validate-signatures.rst:79
|
||||
msgid ""
|
||||
"The output should contain ``Verification successful``. If the output "
|
||||
"contains ``bad_signature`` anywhere, then the image is not trustworthy."
|
||||
"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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:83
|
||||
msgid "Update content validation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:75
|
||||
#: ../../guides/maintenance/validate-signatures.rst:85
|
||||
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``."
|
||||
"**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 :command:`swupd update`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:80
|
||||
#: ../../guides/maintenance/validate-signatures.rst:90
|
||||
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."
|
||||
#: ../../guides/maintenance/validate-signatures.rst:102
|
||||
msgid "Generate the SHA256 sum of the swupd certificate."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:98
|
||||
#: ../../guides/maintenance/validate-signatures.rst:108
|
||||
msgid ""
|
||||
"Ensure the generated SHA256 sum of the Swupd certificate matches "
|
||||
"following SHA256 sum to verify the integrity of the certificate."
|
||||
"Confirm that the generated SHA256 sum of the swupd certificate matches "
|
||||
"the SHA256 sum shown below to verify the integrity of the certificate."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:105
|
||||
#: ../../guides/maintenance/validate-signatures.rst:115
|
||||
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."
|
||||
"Confirm that 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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:132
|
||||
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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:136
|
||||
msgid ""
|
||||
"The output should contain ``Verification successful``. If the output "
|
||||
"contains ``bad_signature`` anywhere, then the MoM cannot be trusted. "
|
||||
"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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The output should contain ``Verification "
|
||||
#~ "successful``. If the output contains "
|
||||
#~ "``bad_signature`` anywhere, then the image "
|
||||
#~ "is not trustworthy."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Generate the SHA256 sum of the Swupd certificate."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Ensure the generated SHA256 sum of "
|
||||
#~ "the Swupd certificate matches following "
|
||||
#~ "SHA256 sum to verify the integrity "
|
||||
#~ "of the certificate."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,154 +24,193 @@ 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."
|
||||
"This guide contains the steps to build a custom container image. The "
|
||||
"official base |CL-ATTR| container image is published on Docker\\* Hub and"
|
||||
" is updated on a regular basis."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:11
|
||||
#: ../../guides/network/custom-clear-container.rst:15
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:13
|
||||
#: ../../guides/network/custom-clear-container.rst:17
|
||||
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
|
||||
#: ../../guides/network/custom-clear-container.rst:20
|
||||
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
|
||||
#: ../../guides/network/custom-clear-container.rst:22
|
||||
msgid "You have a basic understanding of Docker."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:21
|
||||
#: ../../guides/network/custom-clear-container.rst:25
|
||||
msgid "Build the base container image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:23
|
||||
#: ../../guides/network/custom-clear-container.rst:27
|
||||
msgid "Log in and get root privileges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:29
|
||||
#: ../../guides/network/custom-clear-container.rst:33
|
||||
msgid "Verify Docker is installed and running."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:35
|
||||
#: ../../guides/network/custom-clear-container.rst:39
|
||||
msgid "If Docker is installed and running, the output is similar to this example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:78
|
||||
#: ../../guides/network/custom-clear-container.rst:82
|
||||
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."
|
||||
#: ../../guides/network/custom-clear-container.rst:89
|
||||
msgid "Use :command:`os-install` to download and install the bundles."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:96
|
||||
msgid "The swupd example uses the following flags:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:98
|
||||
msgid ":command:`os-install` tells swupd to download and install."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:99
|
||||
msgid ":command:`-V / --version` specifies the version of the |CL| bundles."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:100
|
||||
msgid ":command:`--url` specifies the URL of the bundles repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:97
|
||||
#: ../../guides/network/custom-clear-container.rst:101
|
||||
msgid ""
|
||||
":command:`--statedir` specifies the state directory where downloaded "
|
||||
"bundles and any state information are stored."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:99
|
||||
#: ../../guides/network/custom-clear-container.rst:103
|
||||
msgid ""
|
||||
":command:`--no-boot-update` tells `swupd` to skip updating boot files "
|
||||
":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
|
||||
#: ../../guides/network/custom-clear-container.rst:106
|
||||
msgid ""
|
||||
"For more information on `swupd` flags, enter the :command:`swupd os-"
|
||||
"install -h` command."
|
||||
"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
|
||||
#: ../../guides/network/custom-clear-container.rst:109
|
||||
#: ../../guides/network/custom-clear-container.rst:172
|
||||
#: ../../guides/network/custom-clear-container.rst:199
|
||||
#: ../../guides/network/custom-clear-container.rst:233
|
||||
#: ../../guides/network/custom-clear-container.rst:295
|
||||
msgid "Example output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:141
|
||||
msgid "The `WARNING` message is expected and can be ignored."
|
||||
#: ../../guides/network/custom-clear-container.rst:146
|
||||
msgid "The WARNING message is expected and can be ignored."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:143
|
||||
#: ../../guides/network/custom-clear-container.rst:148
|
||||
msgid "Create a tarball and compress it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:150
|
||||
#: ../../guides/network/custom-clear-container.rst:155
|
||||
msgid "Create the Dockerfile to build the image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:161
|
||||
#: ../../guides/network/custom-clear-container.rst:166
|
||||
msgid "Build the |CL| container image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:188
|
||||
#: ../../guides/network/custom-clear-container.rst:193
|
||||
msgid "List the newly created |CL| container image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:201
|
||||
#: ../../guides/network/custom-clear-container.rst:206
|
||||
msgid "Launch the built |CL| container."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:208
|
||||
#: ../../guides/network/custom-clear-container.rst:213
|
||||
msgid "Manage bundles in a container"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:210
|
||||
#: ../../guides/network/custom-clear-container.rst:215
|
||||
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
|
||||
#: ../../guides/network/custom-clear-container.rst:219
|
||||
msgid "Add a bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:216
|
||||
#: ../../guides/network/custom-clear-container.rst:221
|
||||
msgid ""
|
||||
"This example Dockerfile adds the :file:`pxe-server` bundle to an existing"
|
||||
" |CL| Docker image:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:272
|
||||
#: ../../guides/network/custom-clear-container.rst:277
|
||||
msgid ""
|
||||
"The `WARNING` message can be ignored because systemd does not run inside "
|
||||
"a container."
|
||||
"The WARNING message can be ignored because systemd does not run inside a "
|
||||
"container."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:276
|
||||
#: ../../guides/network/custom-clear-container.rst:281
|
||||
msgid "Remove a bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:278
|
||||
#: ../../guides/network/custom-clear-container.rst:283
|
||||
msgid ""
|
||||
"This example Dockerfile removes the :file:`pxe-server` bundle from an "
|
||||
"existing |CL| Docker image:"
|
||||
msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Use `os-install` to download and install the bundles."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The `swupd` example uses the following flags:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":command:`os-install` tells `swupd` to download and install."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ ":command:`--no-boot-update` tells `swupd` "
|
||||
#~ "to skip updating boot files because "
|
||||
#~ "boot files are not required for a"
|
||||
#~ " container."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For more information on `swupd` flags,"
|
||||
#~ " enter the :command:`swupd os-install "
|
||||
#~ "-h` command."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The `WARNING` message is expected and can be ignored."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The `WARNING` message can be ignored "
|
||||
#~ "because systemd does not run inside "
|
||||
#~ "a container."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -23,354 +23,415 @@ 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."
|
||||
msgid "This guide describes how to send packets between two platforms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:17
|
||||
#: ../../guides/network/dpdk.rst:13
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:15
|
||||
msgid ""
|
||||
"Figure 1 shows how to send packets between two platforms in a simple "
|
||||
"configuration. 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:24
|
||||
msgid "Figure 1: Environment for l3fwd DPDK application"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:19
|
||||
#: ../../guides/network/dpdk.rst:26
|
||||
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."
|
||||
msgid "pktgen: Traffic generator. See `pktgen`_ documentation for details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:29
|
||||
msgid "Both images must include the :file:`kernel-native bundle`."
|
||||
msgid ""
|
||||
"l3fwd: Layer 3 forwarding example application. See `l3fwd`_ documentation"
|
||||
" for details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:30
|
||||
msgid "Install the :file:`network-basic-dev` bundle with the command:"
|
||||
#: ../../guides/network/dpdk.rst:33
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:35
|
||||
msgid "Two platforms using |CL-ATTR| release `13330`_ or higher."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:36
|
||||
msgid "Both images must include the :command:`kernel-native` bundle."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:37
|
||||
msgid "Install the :command:`network-basic-dev` bundle with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:43
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:46
|
||||
msgid "Two network cables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:42
|
||||
#: ../../guides/network/dpdk.rst:49
|
||||
msgid "Install dpdk and build l3fwd example (Platform B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:44
|
||||
#: ../../guides/network/dpdk.rst:51
|
||||
msgid "Change to the :file:`l3fwd` example directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:50
|
||||
#: ../../guides/network/dpdk.rst:57
|
||||
msgid "Assign :envvar:`RTE_SDK` variable to the makefiles path."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:56
|
||||
#: ../../guides/network/dpdk.rst:63
|
||||
msgid ""
|
||||
"Assign :envvar:`RTE_TARGET` variable to the location of the gcc\\* config"
|
||||
" file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:63
|
||||
#: ../../guides/network/dpdk.rst:70
|
||||
msgid ""
|
||||
"Build the `l3fwd` application and add the configuration header to the "
|
||||
":makevar:`CFLAGS` variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:72
|
||||
#: ../../guides/network/dpdk.rst:79
|
||||
msgid "Build pktgen (Platform A)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:74
|
||||
#: ../../guides/network/dpdk.rst:81
|
||||
msgid "Download the `pktgen tar package`_ v3.1.2 or newer."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:76
|
||||
#: ../../guides/network/dpdk.rst:83
|
||||
msgid "Decompress packages and move to uncompressed source directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:78
|
||||
#: ../../guides/network/dpdk.rst:85
|
||||
msgid "Assign :envvar:`RTE_SDK` variable to the path where makefiles are located."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:84
|
||||
#: ../../guides/network/dpdk.rst:91
|
||||
msgid "Assign :envvar:`RTE_TARGET` to the location of the gcc config file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:90
|
||||
#: ../../guides/network/dpdk.rst:97
|
||||
msgid ""
|
||||
"Build the `pktgen` project and set the "
|
||||
":makevar:`CONFIG_RTE_BUILD_SHARED_LIB` variable to \"n\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:98
|
||||
#: ../../guides/network/dpdk.rst:105
|
||||
msgid "Bind NICs to DPDK kernel drivers (Platforms A and B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:100
|
||||
#: ../../guides/network/dpdk.rst:107
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:110
|
||||
msgid "Load the DPDK I/O kernel module."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:109
|
||||
#: ../../guides/network/dpdk.rst:116
|
||||
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."
|
||||
"another application is using them, the status shows \"Active\", and those"
|
||||
" NICs cannot be bound."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:117
|
||||
#: ../../guides/network/dpdk.rst:124
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:132
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:138
|
||||
msgid "Set hugepages (Platforms A and B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:133
|
||||
#: ../../guides/network/dpdk.rst:140
|
||||
msgid ""
|
||||
"|CL| supports `hugepages` for the large memory pool allocation used for "
|
||||
"packet buffers."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:136
|
||||
#: ../../guides/network/dpdk.rst:143
|
||||
msgid "Set the number of hugepages."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:142
|
||||
#: ../../guides/network/dpdk.rst:149
|
||||
msgid "Allocate pages on NUMA machines."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:149
|
||||
#: ../../guides/network/dpdk.rst:156
|
||||
msgid "Make memory available for DPDK."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:155
|
||||
#: ../../guides/network/dpdk.rst:162
|
||||
msgid ""
|
||||
"For more information, refer to the `DPDK guide`_ System Requirements "
|
||||
"section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:160
|
||||
#: ../../guides/network/dpdk.rst:167
|
||||
msgid "Set up the physical environment (Platforms A and B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:162
|
||||
#: ../../guides/network/dpdk.rst:169
|
||||
msgid ""
|
||||
"Connect the NICs on Platform A to the NICs on Platform B using the "
|
||||
"network cables as shown in :ref:`Figure 2<f2>`."
|
||||
"network cables as shown in figure 2."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:169
|
||||
#: ../../guides/network/dpdk.rst:174
|
||||
msgid "Figure 2: Physical network environment"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:173
|
||||
#: ../../guides/network/dpdk.rst:178
|
||||
msgid "Run l3fwd application (Platform B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:175
|
||||
#: ../../guides/network/dpdk.rst:180
|
||||
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`_."
|
||||
"NIC to another. For details, refer to the `l3fwd`_ documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:179
|
||||
#: ../../guides/network/dpdk.rst:184
|
||||
msgid "Open the l3fwd example directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:185
|
||||
#: ../../guides/network/dpdk.rst:190
|
||||
msgid "**This step is very important.**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:187
|
||||
#: ../../guides/network/dpdk.rst:192
|
||||
msgid "DPDK needs poll mode drivers to operate."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:188
|
||||
#: ../../guides/network/dpdk.rst:193
|
||||
msgid "Poll mode drivers are shared objects in :file:`/usr/lib64`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:189
|
||||
#: ../../guides/network/dpdk.rst:194
|
||||
msgid "See the full list of supported NICs at `dpdk.org NICs`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:190
|
||||
#: ../../guides/network/dpdk.rst:195
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:198
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:202
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:210
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:214
|
||||
msgid "Save the MAC address for configuring the `pktgen` project."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:212
|
||||
#: ../../guides/network/dpdk.rst:217
|
||||
msgid "Run pktgen application (Platform A)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:214
|
||||
#: ../../guides/network/dpdk.rst:219
|
||||
msgid "`pktgen` is a network traffic generator included in the DPDK."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:216
|
||||
#: ../../guides/network/dpdk.rst:221
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:229
|
||||
msgid "Enable active colorful output (optional)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:230
|
||||
#: ../../guides/network/dpdk.rst:235
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:242 ../../guides/network/dpdk.rst:301
|
||||
#: ../../guides/network/dpdk.rst:319
|
||||
msgid "Here is a working example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:244
|
||||
#: ../../guides/network/dpdk.rst:249
|
||||
msgid "Send packets."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:250
|
||||
msgid "For more details, see the `pktgen documentation`_."
|
||||
#: ../../guides/network/dpdk.rst:255
|
||||
msgid "For more details, see the `pktgen`_ documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:253
|
||||
#: ../../guides/network/dpdk.rst:258
|
||||
msgid "Appendix A: Use pass-through for virtual machines"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:255
|
||||
#: ../../guides/network/dpdk.rst:260
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:263
|
||||
msgid "Create a new directory and move to it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:260
|
||||
#: ../../guides/network/dpdk.rst:265
|
||||
msgid ""
|
||||
"Download or create a :file:`start_qemu.sh` script for running a kvm "
|
||||
"virtual machine:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:267
|
||||
#: ../../guides/network/dpdk.rst:272
|
||||
msgid "Download a bare-metal image of |CL| and rename it as :file:`clear.img`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:269
|
||||
#: ../../guides/network/dpdk.rst:274
|
||||
msgid "Look for an Ethernet\\* device entry that contains vendor and device ID:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:275
|
||||
#: ../../guides/network/dpdk.rst:280
|
||||
msgid "An example output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:281
|
||||
#: ../../guides/network/dpdk.rst:286
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:291
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:310
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:326
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:333
|
||||
msgid ""
|
||||
"Here is a working example for a virtual machine with 4096 memory and four"
|
||||
" CPUs:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:336
|
||||
#: ../../guides/network/dpdk.rst:341
|
||||
msgid "Each NUMA machine must use the same quantity of memory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:338
|
||||
#: ../../guides/network/dpdk.rst:343
|
||||
msgid "Run the :file:`start_qemu.sh` script."
|
||||
msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "pktgen: Traffic generator. See `pktgen documentation`_ for details."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "l3fwd: Layer 3 forwarding example "
|
||||
#~ "application. See `l3fwd documentation`_ for"
|
||||
#~ " details."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Both images must include the :file:`kernel-native bundle`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Install the :file:`network-basic-dev` bundle with the command:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "For more details, see the `pktgen documentation`_."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -19,23 +19,27 @@ msgstr ""
|
||||
"Generated-By: Babel 2.7.0\n"
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:4
|
||||
msgid "Install |CL-ATTR| over the network with iPXE"
|
||||
msgid "Install 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)`."
|
||||
"Execution Environment)` over the network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:9
|
||||
#: ../../guides/network/ipxe-install.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:16
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:20
|
||||
msgid ""
|
||||
"The PXE extension called `iPXE`_ adds support for additional protocols "
|
||||
"such as HTTP, :abbr:`iSCSI (Internet Small Computer Systems Interface)`, "
|
||||
@@ -44,117 +48,117 @@ msgid ""
|
||||
" PXE support."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:18
|
||||
#: ../../guides/network/ipxe-install.rst:25
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:31
|
||||
msgid "Figure 1: PXE information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:28
|
||||
#: ../../guides/network/ipxe-install.rst:35
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:40
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:35
|
||||
#: ../../guides/network/ipxe-install.rst:42
|
||||
msgid "Before booting with iPXE, make the following preparations."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:37
|
||||
#: ../../guides/network/ipxe-install.rst:44
|
||||
msgid ""
|
||||
"Connect the PXE server and PXE clients to a switch on a private network, "
|
||||
"as shown in Figure 2."
|
||||
"as shown in figure 2."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:43
|
||||
#: ../../guides/network/ipxe-install.rst:50
|
||||
msgid "Figure 2: Network topology."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:45
|
||||
#: ../../guides/network/ipxe-install.rst:52
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:55
|
||||
msgid "Your PXE server must have:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:50
|
||||
#: ../../guides/network/ipxe-install.rst:57
|
||||
msgid "Ethernet/LAN boot option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:51
|
||||
#: ../../guides/network/ipxe-install.rst:58
|
||||
msgid "At least two network adapters."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:52
|
||||
#: ../../guides/network/ipxe-install.rst:59
|
||||
msgid "Connection to a public network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:53
|
||||
#: ../../guides/network/ipxe-install.rst:60
|
||||
msgid "Secure boot option disabled."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:57
|
||||
#: ../../guides/network/ipxe-install.rst:64
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:69
|
||||
msgid "Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:64
|
||||
#: ../../guides/network/ipxe-install.rst:71
|
||||
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`_."
|
||||
"`ister-cloud-init-svc`_ GitHub\\* repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:68
|
||||
#: ../../guides/network/ipxe-install.rst:76
|
||||
msgid "To set up |CL| manually, perform the steps below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:70
|
||||
#: ../../guides/network/ipxe-install.rst:78
|
||||
msgid "Define the variables used for iPXE boot configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:86
|
||||
#: ../../guides/network/ipxe-install.rst:94
|
||||
msgid "Log in and get root privilege."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:92
|
||||
#: ../../guides/network/ipxe-install.rst:100
|
||||
msgid ""
|
||||
"Add the `pxe-server` bundle to your |CL| system. The bundle contains all "
|
||||
"files needed to run a PXE server."
|
||||
"Add the :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:107
|
||||
msgid ""
|
||||
"Download the latest network-bootable release of |CL| and extract the "
|
||||
"files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:113
|
||||
#: ../../guides/network/ipxe-install.rst:121
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:125
|
||||
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 "
|
||||
@@ -162,38 +166,38 @@ msgid ""
|
||||
"ramdisk and kernel files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:133
|
||||
#: ../../guides/network/ipxe-install.rst:141
|
||||
msgid ""
|
||||
"The `pxe-server` bundle contains a lightweight web-server known as "
|
||||
"`nginx`. Create a configuration file for `nginx` to serve |CL| to PXE "
|
||||
"The :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:163
|
||||
msgid ""
|
||||
"Create a separate `nginx` configuration file to serve network-bootable "
|
||||
"images on a non-standard port number. This action saves existing `nginx` "
|
||||
"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."
|
||||
#: ../../guides/network/ipxe-install.rst:167
|
||||
msgid "Start nginx and enable the startup on boot option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:166
|
||||
#: ../../guides/network/ipxe-install.rst:174
|
||||
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`."
|
||||
"The :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:188
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:204
|
||||
msgid ""
|
||||
"Configure :abbr:`NAT (Network Address Translation)` to route traffic from"
|
||||
" the private network to the public network. This action makes the PXE "
|
||||
@@ -201,93 +205,93 @@ msgid ""
|
||||
"save the changes to the firewall with the following commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:212
|
||||
#: ../../guides/network/ipxe-install.rst:220
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:223
|
||||
msgid ""
|
||||
"Configure the kernel to forward network packets to different interfaces. "
|
||||
"Otherwise, NAT will not work."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:224
|
||||
#: ../../guides/network/ipxe-install.rst:232
|
||||
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 "
|
||||
"The :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:242
|
||||
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."
|
||||
"The :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:253
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:263
|
||||
msgid ""
|
||||
"Add the options to host a DHCP server for PXE clients to the `dnsmasq` "
|
||||
"configuration file."
|
||||
"Add the options to host a DHCP server for PXE clients to the "
|
||||
":file:`dnsmasq` configuration file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:277
|
||||
#: ../../guides/network/ipxe-install.rst:285
|
||||
msgid "The configuration provides the following important functions:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:279
|
||||
#: ../../guides/network/ipxe-install.rst:287
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:290
|
||||
msgid ""
|
||||
"Activates only on the network adapter that has an IP address on the "
|
||||
"defined subnet."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:284
|
||||
#: ../../guides/network/ipxe-install.rst:292
|
||||
msgid "Directs PXE clients to the DNS server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:285
|
||||
#: ../../guides/network/ipxe-install.rst:293
|
||||
msgid "Directs PXE clients to the PXE server for routing via NAT."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:286
|
||||
#: ../../guides/network/ipxe-install.rst:294
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:298
|
||||
msgid ""
|
||||
"Create a file for `dnsmasq` to record the IP addresses it provides to PXE"
|
||||
" clients."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:298
|
||||
#: ../../guides/network/ipxe-install.rst:306
|
||||
msgid "Start `dnsmasq` and enable startup on boot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:305
|
||||
#: ../../guides/network/ipxe-install.rst:313
|
||||
msgid "Start `systemd-resolved`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:313
|
||||
#: ../../guides/network/ipxe-install.rst:321
|
||||
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 "
|
||||
@@ -295,20 +299,107 @@ msgid ""
|
||||
":file:`/etc/resolv.conf`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:318
|
||||
#: ../../guides/network/ipxe-install.rst:326
|
||||
msgid "Power on the PXE client and watch the client boot and install |CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:320
|
||||
#: ../../guides/network/ipxe-install.rst:328
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:332
|
||||
msgid ""
|
||||
"**Congratulations!** You have successfully installed and configured a PXE"
|
||||
" server that enables PXE clients to boot and install |CL| over the "
|
||||
"network."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Install |CL-ATTR| over the network with iPXE"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This guide describes how to install "
|
||||
#~ "|CL-ATTR| using :abbr:`PXE (Pre-boot "
|
||||
#~ "Execution Environment)`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Connect the PXE server and PXE "
|
||||
#~ "clients to a switch on a private"
|
||||
#~ " network, as shown in Figure 2."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Add the `pxe-server` bundle to "
|
||||
#~ "your |CL| system. The bundle contains"
|
||||
#~ " all files needed to run a PXE"
|
||||
#~ " server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Start `nginx` and enable the startup on boot option."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Add the options to host a DHCP "
|
||||
#~ "server for PXE clients to the "
|
||||
#~ "`dnsmasq` configuration file."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,76 +24,80 @@ 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."
|
||||
"This guide describes how to configure systemd to use the "
|
||||
":command:`bonding` driver."
|
||||
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."
|
||||
"Network bonding combines multiple network interfaces into a single "
|
||||
"logical interface to provide redundancy and bandwidth aggregation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:12
|
||||
msgid "The example demonstrates how to:"
|
||||
msgid "|CL-ATTR| includes the Linux `Bonding driver`_ and `Team driver`_ ."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:14
|
||||
msgid "Bond all four ports of a quad-port NIC in `802.3ad` mode."
|
||||
msgid "The example demonstrates how to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:16
|
||||
msgid "Enable jumbo frames to optimize large data transfers on the local network."
|
||||
msgid "Bond all four ports of a quad-port NIC in 802.3ad mode."
|
||||
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."
|
||||
msgid "Enable jumbo frames to optimize large data transfers on the local network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:24
|
||||
msgid "You must run all commands in this guide as root."
|
||||
#: ../../guides/network/network-bonding.rst:20
|
||||
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:26
|
||||
msgid "You must run all commands in this guide as root."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:28
|
||||
msgid "Log in and get root privileges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:32
|
||||
#: ../../guides/network/network-bonding.rst:34
|
||||
msgid "Create the :file:`/etc/systemd/network` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:38
|
||||
#: ../../guides/network/network-bonding.rst:40
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:44
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:59
|
||||
msgid ""
|
||||
"Refer to the systemd.netdev_ manpage for :file:`30-bond1.netdev` file "
|
||||
"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
|
||||
#: ../../guides/network/network-bonding.rst:63
|
||||
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_."
|
||||
"virtual `bond1` device and use the syntax shown in `systemd.network`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:76
|
||||
#: ../../guides/network/network-bonding.rst:78
|
||||
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 "
|
||||
@@ -101,53 +105,96 @@ msgid ""
|
||||
"compatible, create a separate :file:`.network` file for each NIC."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:81
|
||||
#: ../../guides/network/network-bonding.rst:83
|
||||
msgid ""
|
||||
"For best results, do not assign addresses or DHCP support to the "
|
||||
"individual NICs."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:84
|
||||
#: ../../guides/network/network-bonding.rst:86
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:89
|
||||
msgid "Configure the bonded interface in a file named :file:`30-bond1.network`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:101
|
||||
#: ../../guides/network/network-bonding.rst:103
|
||||
msgid "`bond1` is a virtual interface with no physical link status."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:103
|
||||
#: ../../guides/network/network-bonding.rst:105
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:108
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:111
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:115
|
||||
msgid "Apply the new network configuration with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:119
|
||||
#: ../../guides/network/network-bonding.rst:121
|
||||
msgid ""
|
||||
"The `MTUBytes` settings do not take effect until you reboot or manually "
|
||||
"apply the settings with a utility such as `ifconfig`."
|
||||
"apply the settings with a utility such as ifconfig."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "|CL-ATTR| includes Linux bonding_ and"
|
||||
#~ " team_ drivers. This guide describes "
|
||||
#~ "how to configure systemd to use "
|
||||
#~ "the `bonding` driver."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Bond all four ports of a quad-port NIC in `802.3ad` mode."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The `MTUBytes` settings do not take "
|
||||
#~ "effect until you reboot or manually "
|
||||
#~ "apply the settings with a utility "
|
||||
#~ "such as `ifconfig`."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,151 @@
|
||||
# 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-22 12:54-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/stacks/dars.rst:4
|
||||
msgid "Data Analytics Reference Stack"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:6
|
||||
msgid ""
|
||||
"This guide explains how to use the :abbr:`DARS (Data Analytics Reference "
|
||||
"Stack)`, and to optionally build your own DARS container image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:9
|
||||
msgid ""
|
||||
"Any system that supports Docker\\* containers can be used with DARS. This"
|
||||
" steps in this guide use |CL-ATTR| as the host system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:17
|
||||
msgid "The Data Analytics Reference Stack release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:19
|
||||
msgid ""
|
||||
"The Data Analytics Reference Stack (DARS) provides developers and "
|
||||
"enterprises a straightforward, highly optimized software stack for "
|
||||
"storing and processing large amounts of data. More detail is available "
|
||||
"on the `DARS architecture and performance benchmarks`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:23
|
||||
msgid ""
|
||||
"The Data Analytics Reference Stack provides two pre-built Docker images, "
|
||||
"available on `Docker Hub`_:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:26
|
||||
msgid "A |CL|-derived `DARS with OpenBlas`_ stack optimized for `OpenBLAS`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:27
|
||||
msgid "A |CL|-derived `DARS with Intel® MKL`_ stack optimized for `MKL`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:29
|
||||
msgid ""
|
||||
"We recommend you view the latest component versions for each image in the"
|
||||
" :file:`README` found in the `Data Analytics Reference Stack`_ GitHub\\* "
|
||||
"repository. Because |CL| is a rolling distribution, the package version "
|
||||
"numbers in the |CL|-based containers may not be the latest released by "
|
||||
"|CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:36
|
||||
msgid ""
|
||||
"The Data Analytics Reference Stack is a collective work, and each piece "
|
||||
"of software within the work has its own license. Please see the `DARS "
|
||||
"Terms of Use`_ for more details about licensing and usage of the Data "
|
||||
"Analytics Reference Stack."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:42
|
||||
msgid "Using the Docker images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:44
|
||||
msgid ""
|
||||
"To immediately start using the latest stable DARS images, pull an image "
|
||||
"directly from `Docker Hub`_. This example uses the `DARS with Intel® "
|
||||
"MKL`_ Docker image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:48
|
||||
msgid "Once you have downloaded the image, you can run it with"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:54
|
||||
msgid ""
|
||||
"This will launch the image and drop you into a bash shell inside the "
|
||||
"container. You will see output similar to the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:75
|
||||
msgid ""
|
||||
"The :command:`--ulimit nofile` parameter is currently required in order "
|
||||
"to increase the number of open files opened at certain point by the spark"
|
||||
" engine."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:80
|
||||
msgid "Building DARS images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:82
|
||||
msgid ""
|
||||
"If you choose to build your own DARS container images, you can customize "
|
||||
"them as needed. Use the provided Dockerfile as a baseline."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:85
|
||||
msgid ""
|
||||
"To construct images with |CL|, start with a |CL| development platform "
|
||||
"that has the :command:`containers-basic-dev` bundle installed. Learn more"
|
||||
" about bundles and installing them by using :ref:`swupd-guide`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:89
|
||||
msgid "Clone the `Data Analytics Reference Stack`_ GitHub\\* repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:95
|
||||
msgid ""
|
||||
"Inside the DARS directory, run :command:`make` to build OpenBLAS and MKL "
|
||||
"images."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:101
|
||||
msgid ""
|
||||
"Run :command:`make baseline` to build the baseline CentOS image. "
|
||||
"Depending on the system, it may take a while to finish building."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:108
|
||||
msgid "Once completed, check the resulting images with :command:`Docker`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:114
|
||||
msgid ""
|
||||
"You can use any of the resulting images to launch fully functional "
|
||||
"containers. If you need to customize the containers, you can edit the "
|
||||
"provided :file:`Dockerfile`."
|
||||
msgstr ""
|
||||
|
||||
@@ -0,0 +1,616 @@
|
||||
# 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-22 12:54-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/stacks/dlrs/dlrs.rst:4
|
||||
msgid "Deep Learning Reference Stack"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:6
|
||||
msgid ""
|
||||
"This guide describes how to run benchmarking workloads for TensorFlow\\*,"
|
||||
" PyTorch\\*, and Kubeflow in |CL-ATTR| using the Deep Learning Reference "
|
||||
"Stack."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:16
|
||||
msgid ""
|
||||
"We created the Deep Learning Reference Stack to help AI developers "
|
||||
"deliver the best experience on Intel® Architecture. This stack reduces "
|
||||
"complexity common with deep learning software components, provides "
|
||||
"flexibility for customized solutions, and enables you to quickly "
|
||||
"prototype and deploy Deep Learning workloads. Use this guide to run "
|
||||
"benchmarking workloads on your solution."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:23
|
||||
msgid "The Deep Learning Reference Stack is available in the following versions:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:25
|
||||
msgid ""
|
||||
"`Intel MKL-DNN-VNNI`_, which is optimized using Intel® Math Kernel "
|
||||
"Library for Deep Neural Networks (Intel® MKL-DNN) primitives and "
|
||||
"introduces support for Intel® AVX-512 Vector Neural Network Instructions "
|
||||
"(VNNI)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:28
|
||||
msgid ""
|
||||
"`Intel MKL-DNN`_, which includes the TensorFlow framework optimized using"
|
||||
" Intel® Math Kernel Library for Deep Neural Networks (Intel® MKL-DNN) "
|
||||
"primitives."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:31
|
||||
msgid "`Eigen`_, which includes `TensorFlow`_ optimized for Intel® architecture."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:32
|
||||
msgid "`PyTorch with OpenBLAS`_, which includes PyTorch with OpenBlas."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:33
|
||||
msgid ""
|
||||
"`PyTorch with Intel MKL-DNN`_, which includes PyTorch optimized using "
|
||||
"Intel® Math Kernel Library (Intel® MKL) and Intel MKL-DNN."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:38
|
||||
msgid ""
|
||||
"To take advantage of the Intel® AVX-512 and VNNI functionality with the "
|
||||
"Deep Learning Reference Stack, you must use the following hardware:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:41
|
||||
msgid "Intel® AVX-512 images require an Intel® Xeon® Scalable Platform"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:42
|
||||
msgid "VNNI requires a 2nd generation Intel® Xeon® Scalable Platform"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:45
|
||||
msgid "Stack features"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:47
|
||||
msgid "`DLRS V3.0`_ release announcement."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:48
|
||||
msgid "Deep Learning Reference Stack v2.0 including current `PyTorch benchmark`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:50
|
||||
msgid ""
|
||||
"Deep Learning Reference Stack v1.0 including current `TensorFlow "
|
||||
"benchmark`_ results."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:52
|
||||
msgid ""
|
||||
"`DLRS Release notes`_ on Github\\* for the latest release of Deep "
|
||||
"Learning Reference Stack."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:57
|
||||
msgid ""
|
||||
"The Deep Learning Reference Stack is a collective work, and each piece of"
|
||||
" software within the work has its own license. Please see the `DLRS "
|
||||
"Terms of Use`_ for more details about licensing and usage of the Deep "
|
||||
"Learning Reference Stack."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:62
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:64
|
||||
msgid ":ref:`Install <bare-metal-install-desktop>` |CL| on your host system"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:65
|
||||
msgid ":command:`containers-basic` bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:66
|
||||
msgid ":command:`cloud-native-basic` bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:68
|
||||
msgid ""
|
||||
"In |CL|, :command:`containers-basic` includes Docker\\*, which is "
|
||||
"required for TensorFlow and PyTorch benchmarking. Use the "
|
||||
":command:`swupd` utility to check if :command:`containers-basic` and "
|
||||
":command:`cloud-native-basic` are present:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:77
|
||||
msgid ""
|
||||
"To install the :command:`containers-basic` or :command:`cloud-native-"
|
||||
"basic` bundles, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:84
|
||||
msgid ""
|
||||
"Docker is not started upon installation of the :command:`containers-"
|
||||
"basic` bundle. To start Docker, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:91
|
||||
msgid ""
|
||||
"To ensure that Kubernetes is correctly installed and configured, follow "
|
||||
"the instructions in :ref:`kubernetes`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:95
|
||||
msgid "Version compatibility"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:97
|
||||
msgid "We validated these steps against the following software package versions:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:99
|
||||
msgid "|CL| 26240 (Minimum supported version)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:100
|
||||
msgid "Docker 18.06.1"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:101
|
||||
msgid "Kubernetes 1.11.3"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:102
|
||||
msgid "Go 1.11.12"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:107
|
||||
msgid ""
|
||||
"The Deep Learning Reference Stack was developed to provide the best user "
|
||||
"experience when executed on a |CL| host. However, as the stack runs in a"
|
||||
" container environment, you should be able to complete the following "
|
||||
"sections of this guide on other Linux* distributions, provided they "
|
||||
"comply with the Docker*, Kubernetes* and Go* package versions listed "
|
||||
"above. Look for your distribution documentation on how to update packages"
|
||||
" and manage Docker services."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:112
|
||||
msgid "TensorFlow single and multi-node benchmarks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:114
|
||||
msgid ""
|
||||
"This section describes running the `TensorFlow Benchmarks`_ in single "
|
||||
"node. For multi-node testing, replicate these steps for each node. These "
|
||||
"steps provide a template to run other benchmarks, provided that they can "
|
||||
"invoke TensorFlow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:121
|
||||
msgid ""
|
||||
"Performance test results for the Deep Learning Reference Stack and for "
|
||||
"this guide were obtained using `runc` as the runtime."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:124
|
||||
msgid ""
|
||||
"Download either the `Eigen`_ or the `Intel MKL-DNN`_ Docker image from "
|
||||
"`Docker Hub`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:127 ../../guides/stacks/dlrs/dlrs.rst:169
|
||||
msgid "Run the image with Docker:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:136 ../../guides/stacks/dlrs/dlrs.rst:177
|
||||
msgid ""
|
||||
"Launching the Docker image with the :command:`-i` argument starts "
|
||||
"interactive mode within the container. Enter the following commands in "
|
||||
"the running container."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:140
|
||||
msgid "Clone the benchmark repository in the container:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:146 ../../guides/stacks/dlrs/dlrs.rst:187
|
||||
msgid "Execute the benchmark script:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:154
|
||||
msgid ""
|
||||
"You can replace the model with one of your choice supported by the "
|
||||
"TensorFlow benchmarks."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:157
|
||||
msgid ""
|
||||
"If you are using an FP32 based model, it can be converted to an int8 "
|
||||
"model using `Intel® quantization tools`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:161
|
||||
msgid "PyTorch single and multi-node benchmarks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:163
|
||||
msgid ""
|
||||
"This section describes running the `PyTorch benchmarks`_ for Caffe2 in "
|
||||
"single node."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:166
|
||||
msgid ""
|
||||
"Download either the `PyTorch with OpenBLAS`_ or the `PyTorch with Intel "
|
||||
"MKL-DNN`_ Docker image from `Docker Hub`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:181
|
||||
msgid "Clone the benchmark repository:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:197
|
||||
msgid "Kubeflow multi-node benchmarks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:199
|
||||
msgid ""
|
||||
"The benchmark workload runs in a Kubernetes cluster. The guide uses "
|
||||
"`Kubeflow`_ for the Machine Learning workload deployment on three nodes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:204
|
||||
msgid ""
|
||||
"If you choose the Intel® MKL-DNN or Intel® MKL-DNN-VNNI image, your "
|
||||
"platform must support the Intel® AVX-512 instruction set. Otherwise, an "
|
||||
"*illegal instruction* error may appear, and you won’t be able to complete"
|
||||
" this guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:210
|
||||
msgid "Kubernetes setup"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:212
|
||||
msgid ""
|
||||
"Follow the instructions in the :ref:`kubernetes` tutorial to get set up "
|
||||
"on |CL|. The Kubernetes community also has instructions for creating a "
|
||||
"cluster, described in `Creating a single control-plane cluster with "
|
||||
"kubeadm`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:217
|
||||
msgid "Kubernetes networking"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:219
|
||||
msgid ""
|
||||
"We used `flannel`_ as the network provider for these tests. If you prefer"
|
||||
" a different network layer, refer to the Kubernetes network documentation"
|
||||
" described in `Creating a single control-plane cluster with kubeadm`_ for"
|
||||
" setup."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:224
|
||||
msgid "Kubectl"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:226
|
||||
msgid ""
|
||||
"You can use kubectl to run commands against your Kubernetes cluster. "
|
||||
"Refer to the `Overview of kubectl`_ for details on syntax and operations."
|
||||
" Once you have a working cluster on Kubernetes, use the following YAML "
|
||||
"script to start a pod with a simple shell script, and keep the pod open."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:231
|
||||
msgid "Copy this example.yaml script to your system:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:248
|
||||
msgid "Execute the script with kubectl:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:254
|
||||
msgid ""
|
||||
"This script opens a single pod. More robust solutions would create a "
|
||||
"deployment or inject a python script or larger shell script into the "
|
||||
"container."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:258
|
||||
msgid "Images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:260
|
||||
msgid ""
|
||||
"You must add `launcher.py`_ to the Docker image to include the Deep "
|
||||
"Learning Reference Stack and put the benchmarks repo in the correct "
|
||||
"location. Note that this guide uses Kubeflow v0.4.0, and cannot guarantee"
|
||||
" results if you use a different version."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:264
|
||||
msgid "From the Docker image, run the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:273
|
||||
msgid "Your entry point becomes: :file:`/opt/launcher.py`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:275
|
||||
msgid "This builds an image that can be consumed directly by TFJob from Kubeflow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:278
|
||||
msgid "ksonnet\\*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:280
|
||||
msgid ""
|
||||
"Kubeflow uses ksonnet\\* to manage deployments, so you must install it "
|
||||
"before setting up Kubeflow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:283
|
||||
msgid ""
|
||||
"ksonnet was added to the :command:`cloud-native-basic` bundle in |CL| "
|
||||
"version 27550. If you are using an older |CL| version (not recommended), "
|
||||
"you must manually install ksonnet as described below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:287
|
||||
msgid "On |CL|, follow these steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:298
|
||||
msgid ""
|
||||
"After the ksonnet installation is complete, ensure that binary `ks` is "
|
||||
"accessible across the environment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:302
|
||||
msgid "Kubeflow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:304
|
||||
msgid ""
|
||||
"Once you have Kubernetes running on your nodes, set up `Kubeflow`_ by "
|
||||
"following these instructions from the `Getting Started with Kubeflow`_ "
|
||||
"guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:322
|
||||
msgid "Next, deploy the primary package for our purposes: tf-job-operator."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:332
|
||||
msgid ""
|
||||
"This creates the CustomResourceDefinition (CRD) endpoint to launch a "
|
||||
"TFJob."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:335
|
||||
msgid "Run a TFJob"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:337
|
||||
msgid "Get the ksonnet registries for deploying TFJobs from `dlrs-tfjob`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:339
|
||||
msgid "Install the TFJob components as follows:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:347
|
||||
msgid "Export the image name to use for the deployment:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:355
|
||||
msgid "Replace <docker_name> with the image name you specified in previous steps."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:357
|
||||
msgid ""
|
||||
"Generate Kubernetes manifests for the workloads and apply them using "
|
||||
"these commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:367
|
||||
msgid "This replicates and deploys three test setups in your Kubernetes cluster."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:370
|
||||
msgid "Results of running this guide"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:372
|
||||
msgid ""
|
||||
"You must parse the logs of the Kubernetes pod to retrieve performance "
|
||||
"data. The pods will still exist post-completion and will be in "
|
||||
"‘Completed’ state. You can get the logs from any of the pods to inspect "
|
||||
"the benchmark results. More information about Kubernetes logging is "
|
||||
"available in the Kubernetes `Logging Architecture`_ documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:379
|
||||
msgid "Use Jupyter Notebook"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:381
|
||||
msgid ""
|
||||
"This example uses the `PyTorch with OpenBLAS`_ container image. After it "
|
||||
"is downloaded, run the Docker image with :command:`-p` to specify the "
|
||||
"shared port between the container and the host. This example uses port "
|
||||
"8888."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:389
|
||||
msgid ""
|
||||
"After you start the container, launch the Jupyter Notebook. This command "
|
||||
"is executed inside the container image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:396
|
||||
msgid ""
|
||||
"After the notebook has loaded, you will see output similar to the "
|
||||
"following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:404
|
||||
msgid ""
|
||||
"From your host system, or any system that can access the host's IP "
|
||||
"address, start a web browser with the following. If you are not running "
|
||||
"the browser on the host system, replace :command:`127.0.0.1` with the IP "
|
||||
"address of the host."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:412
|
||||
msgid "Your browser displays the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:418
|
||||
msgid "Figure 1: :guilabel:`Jupyter Notebook`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:421
|
||||
msgid ""
|
||||
"To create a new notebook, click :guilabel:`New` and select "
|
||||
":guilabel:`Python 3`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:427
|
||||
msgid "Figure 2: Create a new notebook"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:429
|
||||
msgid "A new, blank notebook is displayed, with a cell ready for input."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:436
|
||||
msgid ""
|
||||
"To verify that PyTorch is working, copy the following snippet into the "
|
||||
"blank cell, and run the cell."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:450
|
||||
msgid "When you run the cell, your output will look something like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:456
|
||||
msgid ""
|
||||
"You can continue working in this notebook, or you can download existing "
|
||||
"notebooks to take advantage of the Deep Learning Reference Stack's "
|
||||
"optimized deep learning frameworks. Refer to `Jupyter Notebook`_ for "
|
||||
"details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:461
|
||||
msgid "Uninstallation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:463
|
||||
msgid ""
|
||||
"To uninstall the Deep Learning Reference Stack, you can choose to stop "
|
||||
"the container so that it is not using system resources, or you can stop "
|
||||
"the container and delete it to free storage space."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:467
|
||||
msgid "To stop the container, execute the following from your host system:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:469
|
||||
msgid "Find the container's ID"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:475
|
||||
msgid "This will result in output similar to the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:482
|
||||
msgid ""
|
||||
"You can then use the ID or container name to stop the container. This "
|
||||
"example uses the name \"oss\":"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:490
|
||||
msgid "Verify that the container is not running"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:497
|
||||
msgid "To delete the container from your system you need to know the Image ID:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:503
|
||||
msgid "This command results in output similar to the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:511
|
||||
msgid "To remove an image use the image ID:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:527
|
||||
msgid ""
|
||||
"Note that you can execute the :command:`docker rmi` command using only "
|
||||
"the first few characters of the image ID, provided they are unique on the"
|
||||
" system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:529
|
||||
msgid "Once you have removed the image, you can verify it has been deleted with:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:537
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:539
|
||||
msgid "`DLRS V3.0`_ release announcement"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:540
|
||||
msgid "`TensorFlow Benchmarks`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:541
|
||||
msgid "`PyTorch benchmarks`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:542
|
||||
msgid "`Kubeflow`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:543
|
||||
msgid ":ref:`kubernetes` tutorial"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:544
|
||||
msgid "`Jupyter Notebook`_"
|
||||
msgstr ""
|
||||
|
||||
@@ -0,0 +1,664 @@
|
||||
# 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-22 12:54-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/stacks/greengrass.rst:4
|
||||
msgid "Enable AWS Greengrass\\* and OpenVINO™ toolkit"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:6
|
||||
msgid ""
|
||||
"This guide explains how to enable AWS Greengrass\\* and OpenVINO™ "
|
||||
"toolkit. Specifically, the guide demonstrates how to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:9
|
||||
msgid "Set up the Intel® edge device with |CL-ATTR|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:10
|
||||
msgid ""
|
||||
"Install the OpenVINO™ toolkit and Amazon Web Services\\* (AWS\\*) "
|
||||
"Greengrass\\* software stacks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:12
|
||||
msgid ""
|
||||
"Use AWS Greengrass\\* and AWS Lambda\\* to deploy the FaaS samples from "
|
||||
"the cloud"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:20
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:22
|
||||
msgid ""
|
||||
"Hardware accelerated Function-as-a-Service (FaaS) enables cloud "
|
||||
"developers to deploy inference functionalities [1] on Intel® IoT edge "
|
||||
"devices with accelerators (CPU, Integrated GPU, Intel® FPGA, and Intel® "
|
||||
"Movidius™ technology). These functions provide a great developer "
|
||||
"experience and seamless migration of visual analytics from cloud to edge "
|
||||
"in a secure manner using a containerized environment. Hardware-"
|
||||
"accelerated FaaS provides the best-in-class performance by accessing "
|
||||
"optimized deep learning libraries on Intel® IoT edge devices with "
|
||||
"accelerators."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:32
|
||||
msgid "Supported platforms"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:34
|
||||
msgid "Operating System: |CL| latest release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:35
|
||||
msgid "Hardware: Intel® core platforms (that support inference on CPU only)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:38
|
||||
msgid "Sample description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:40
|
||||
msgid ""
|
||||
"The AWS Greengrass samples are located at `Edge-Analytics-FaaS`_. This "
|
||||
"guide uses the 1.0 version of the source code."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:43
|
||||
msgid "|CL| provides the following AWS Greengrass samples:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:45
|
||||
msgid "`greengrass_classification_sample.py`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:47
|
||||
msgid ""
|
||||
"This AWS Greengrass sample classifies a video stream using classification"
|
||||
" networks such as AlexNet and GoogLeNet and publishes top-10 results on "
|
||||
"AWS\\* IoT Cloud every second."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:51
|
||||
msgid "`greengrass_object_detection_sample_ssd.py`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:53
|
||||
msgid ""
|
||||
"This AWS Greengrass sample detects objects in a video stream and "
|
||||
"classifies them using single-shot multi-box detection (SSD) networks such"
|
||||
" as SSD Squeezenet, SSD Mobilenet, and SSD300. This sample publishes "
|
||||
"detection outputs such as class label, class confidence, and bounding box"
|
||||
" coordinates on AWS IoT Cloud every second."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:61
|
||||
msgid "Install the OS on the edge device"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:63
|
||||
msgid ""
|
||||
"Start with a clean installation of |CL| on a new system, using the :ref"
|
||||
":`bare-metal-install-desktop`, found in :ref:`get-started`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:67
|
||||
msgid "Create user accounts"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:69
|
||||
msgid ""
|
||||
"After |CL| is installed, create two user accounts. Create an "
|
||||
"administrative user in |CL| and create a user account for the Greengrass "
|
||||
"services to use ( see Greengrass user below)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:73
|
||||
msgid ""
|
||||
"Create a new user and set a password for that user. Enter the following "
|
||||
"commands as ``root``:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:81
|
||||
msgid ""
|
||||
"Next, enable the :command:`sudo` command for your new <userid>. Add "
|
||||
"<userid> to the `wheel` group:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:88
|
||||
msgid "Create a :file:`/etc/fstab` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:96
|
||||
msgid ""
|
||||
"By default, |CL| does not create an :file:`/etc/fstab` file. You must "
|
||||
"create this file before the Greengrass service runs."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:100
|
||||
msgid "Add required bundles"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:102
|
||||
msgid ""
|
||||
"Use the :command:`swupd` software updater utility to add the prerequisite"
|
||||
" bundles for the OpenVINO software stack:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:111
|
||||
msgid "Learn more about how to :ref:`swupd-guide`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:113
|
||||
msgid ""
|
||||
"The :command:`computer-vision-basic` bundle installs the OpenVINO™ "
|
||||
"toolkit, and the sample models optimized for Intel® edge platforms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:117
|
||||
msgid "Convert deep learning models"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:120
|
||||
msgid "Locate sample models"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:122
|
||||
msgid ""
|
||||
"There are two types of provided models that can be used in conjunction "
|
||||
"with AWS Greengrass for this guide: classification or object detection."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:125
|
||||
msgid ""
|
||||
"To complete this guide using an image classification model, download the "
|
||||
"BVLC AlexNet model files `bvlc_alexnet.caffemodel`_ and "
|
||||
"`deploy.prototxt`_ to the default model_location at "
|
||||
":file:`/usr/share/openvino/models`. Any custom pre-trained classification"
|
||||
" models can be used with the classification sample."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:131
|
||||
msgid ""
|
||||
"For object detection, the sample models optimized for Intel® edge "
|
||||
"platforms are included with the computer-vision-basic bundle installation"
|
||||
" at :file:`/usr/share/openvino/models`. These models are provided as an "
|
||||
"example; you may also use a custom SSD model with the Greengrass object "
|
||||
"detection sample."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:137
|
||||
msgid "Run model optimizer"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:139
|
||||
msgid ""
|
||||
"Follow the instructions in the `Model Optimizer Developer Guide`_ for "
|
||||
"converting deep learning models to Intermediate Representation using "
|
||||
"Model Optimizer. To optimize either of the sample models described above,"
|
||||
" run one of the following commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:143
|
||||
msgid "For classification using BVLC AlexNet model:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:152
|
||||
msgid "For object detection using SqueezeNetSSD-5Class model:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:161
|
||||
msgid "In these examples:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:163
|
||||
msgid "`<model_location>` is :file:`/usr/share/openvino/models`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:165
|
||||
msgid "`<data_type>` is FP32 or FP16, depending on target device."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:167
|
||||
msgid ""
|
||||
"`<output_dir>` is the directory where the Intermediate Representation "
|
||||
"(IR) is stored. IR contains .xml format corresponding to the network "
|
||||
"structure and .bin format corresponding to weights. This .xml file should"
|
||||
" be passed to :command:`<PARAM_MODEL_XML>`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:172
|
||||
msgid ""
|
||||
"In the BVLC AlexNet model, the prototxt defines the input shape with "
|
||||
"batch size 10 by default. In order to use any other batch size, the "
|
||||
"entire input shape must be provided as an argument to the model "
|
||||
"optimizer. For example, to use batch size 1, you must provide: "
|
||||
"`--input_shape [1,3,227,227]`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:180
|
||||
msgid "Configure AWS Greengrass group"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:182
|
||||
msgid ""
|
||||
"For each Intel® edge platform, you must create a new AWS Greengrass group"
|
||||
" and install AWS Greengrass core software to establish the connection "
|
||||
"between cloud and edge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:186
|
||||
msgid ""
|
||||
"To create an AWS Greengrass group, follow the instructions in `Configure "
|
||||
"AWS IoT Greengrass on AWS IoT`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:189
|
||||
msgid ""
|
||||
"To install and configure AWS Greengrass core on edge platform, follow the"
|
||||
" instructions in `Start AWS Greengrass on the Core Device`_. In step "
|
||||
"8(b), download the x86_64 Ubuntu\\* configuration of the AWS Greengrass "
|
||||
"core software."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:196
|
||||
msgid ""
|
||||
"You do not need to run the :file:`cgroupfs-mount.sh` script in step #6 of"
|
||||
" Module 1 of the `AWS Greengrass Developer Guide`_ because this is "
|
||||
"enabled already in |CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:200
|
||||
msgid ""
|
||||
"Be sure to download both the security resources and the AWS Greengrass "
|
||||
"core software."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:205
|
||||
msgid "Security certificates are linked to your AWS account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:209
|
||||
msgid "Create and package Lambda function"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:211
|
||||
msgid ""
|
||||
"Complete steps 1-4 of the AWS Greengrass guide at `Create and Package a "
|
||||
"Lambda Function`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:216
|
||||
msgid ""
|
||||
"This creates the tarball needed to create the AWS Greengrass environment "
|
||||
"on the edge device."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:220
|
||||
msgid ""
|
||||
"In step 5, replace :file:`greengrassHelloWorld.py` with the "
|
||||
"classification or object detection Greengrass sample from `Edge-"
|
||||
"Analytics-Faas`_:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:223
|
||||
msgid "Classification: `greengrass_classification_sample.py`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:225
|
||||
msgid "Object Detection: `greengrass_object_detection_sample_ssd.py`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:227
|
||||
msgid ""
|
||||
"Zip the selected Greengrass sample with the extracted Greengrass SDK "
|
||||
"folders from the previous step into "
|
||||
":file:`greengrass_sample_python_lambda.zip`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:230
|
||||
msgid "The zip should contain:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:232
|
||||
msgid "greengrasssdk"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:234
|
||||
msgid "greengrass classification or object detection sample"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:236
|
||||
msgid "For example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:243
|
||||
msgid ""
|
||||
"Return to the AWS documentation section called `Create and Package a "
|
||||
"Lambda Function`_ and complete the procedure."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:248
|
||||
msgid ""
|
||||
"In step 9(a) of the AWS documentation, while uploading the zip file, make"
|
||||
" sure to name the handler to one of the following, depending on the AWS "
|
||||
"Greengrass sample you are using:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:252
|
||||
msgid "greengrass_object_detection_sample_ssd.function_handler"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:253
|
||||
msgid "greengrass_classification_sample.function_handler"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:257
|
||||
msgid "Configure Lambda function"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:259
|
||||
msgid ""
|
||||
"After creating the Greengrass group and the Lambda function, start "
|
||||
"configuring the Lambda function for AWS Greengrass."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:262
|
||||
msgid ""
|
||||
"Follow steps 1-8 in `Configure the Lambda Function for AWS IoT "
|
||||
"Greengrass`_ in the AWS documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:265
|
||||
msgid ""
|
||||
"In addition to the details mentioned in step 8, change the Memory limit "
|
||||
"to 2048 MB to accommodate large input video streams."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:268
|
||||
msgid ""
|
||||
"Add the following environment variables as key-value pairs when editing "
|
||||
"the Lambda configuration and click on update:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:271
|
||||
msgid "**Table 1. Environment variables: Lambda configuration**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:275
|
||||
msgid "Key"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:276
|
||||
msgid "Value"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:277
|
||||
msgid "PARAM_MODEL_XML"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:278
|
||||
msgid ""
|
||||
"<MODEL_DIR>/<IR.xml>, where <MODEL_DIR> is user specified and contains "
|
||||
"IR.xml, the Intermediate Representation file from Intel® Model Optimizer."
|
||||
" For this guide, <MODEL_DIR> should be set to "
|
||||
"'/usr/share/openvino/models' or one of its subdirectories."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:282
|
||||
msgid "PARAM_INPUT_SOURCE"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:283
|
||||
msgid "<DATA_DIR>/input.webm to be specified by user. Holds both input and"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:284
|
||||
msgid "output data. For webcam, set PARAM_INPUT_SOURCE to ‘/dev/video0’"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:285
|
||||
msgid "PARAM_DEVICE"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:286
|
||||
msgid "\"CPU\""
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:287
|
||||
msgid "PARAM_CPU_EXTENSION_PATH"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:288
|
||||
msgid "/usr/lib64/libcpu_extension.so"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:289
|
||||
msgid "PARAM_OUTPUT_DIRECTORY"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:290
|
||||
msgid "<DATA_DIR> to be specified by user. Holds both input and output data"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:292
|
||||
msgid "PARAM_NUM_TOP_RESULTS"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:293
|
||||
msgid ""
|
||||
"User specified for classification sample. (e.g. 1 for top-1 result, 5 for"
|
||||
" top-5 results)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:296
|
||||
msgid ""
|
||||
"Add subscription to subscribe, or publish messages from AWS Greengrass "
|
||||
"Lambda function by completing the procedure in `Configure the Lambda "
|
||||
"Function for AWS IoT Greengrass`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:301
|
||||
msgid ""
|
||||
"The optional topic filter field is the topic mentioned inside the Lambda "
|
||||
"function. In this guide, sample topics include the following: "
|
||||
":command:`openvino/ssd` or :command:`openvino/classification`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:305
|
||||
msgid "Add local resources"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:307
|
||||
msgid ""
|
||||
"Refer to the AWS documentation `Access Local Resources with Lambda "
|
||||
"Functions and Connectors`_ for details about local resources and access "
|
||||
"privileges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:310
|
||||
msgid "The following table describes the local resources needed for the CPU:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:312
|
||||
msgid "**Local resources**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:316
|
||||
msgid "Name"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:317
|
||||
msgid "Resource type"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:318
|
||||
msgid "Local path"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:319
|
||||
msgid "Access"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:321
|
||||
msgid "ModelDir"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:322
|
||||
#: ../../guides/stacks/greengrass.rst:332
|
||||
msgid "Volume"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:323
|
||||
msgid "<MODEL_DIR> to be specified by user"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:324
|
||||
#: ../../guides/stacks/greengrass.rst:329
|
||||
msgid "Read-Only"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:326
|
||||
msgid "Webcam"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:327
|
||||
msgid "Device"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:328
|
||||
msgid "/dev/video0"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:331
|
||||
msgid "DataDir"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:333
|
||||
msgid "<DATA_DIR> to be specified by user. Holds both input and output data."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:335
|
||||
msgid "Read and Write"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:338
|
||||
msgid "Deploy Lambda function"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:340
|
||||
msgid ""
|
||||
"Refer to the AWS documentation `Deploy Cloud Configurations to an AWS IoT"
|
||||
" Greengrass Core Device`_ for instructions on how to deploy the lambda "
|
||||
"function to AWS Greengrass core device. Select *Deployments* on the group"
|
||||
" page and follow the instructions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:344
|
||||
msgid "Output consumption"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:346
|
||||
msgid ""
|
||||
"There are four options available for output consumption. These options "
|
||||
"are used to report, stream, upload, or store inference output at an "
|
||||
"interval defined by the variable :command:`reporting_interval` in the AWS"
|
||||
" Greengrass samples."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:350
|
||||
msgid "IoT cloud output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:352
|
||||
msgid ""
|
||||
"This option is enabled by default in the AWS Greengrass samples using the"
|
||||
" :command:`enable_iot_cloud_output` variable. You can use it to verify "
|
||||
"the lambda running on the edge device. It enables publishing messages to "
|
||||
"IoT cloud using the subscription topic specified in the lambda. (For "
|
||||
"example, topics may include :command:`openvino/classification` for "
|
||||
"classification and :command:`openvino/ssd` for object detection samples.)"
|
||||
" For classification, top-1 result with class label are published to IoT "
|
||||
"cloud. For SSD object detection, detection results such as bounding box "
|
||||
"coordinates of objects, class label, and class confidence are published."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:362
|
||||
msgid ""
|
||||
"Refer to the AWS documentation `Verify the Lambda Function Is Running on "
|
||||
"the Device`_ for instructions on how to view the output on IoT cloud."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:366
|
||||
msgid "Kinesis streaming:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:368
|
||||
msgid ""
|
||||
"This option enables inference output to be streamed from the edge device "
|
||||
"to cloud using Kinesis [3] streams when :command:`enable_kinesis_output` "
|
||||
"is set to True. The edge devices act as data producers and continually "
|
||||
"push processed data to the cloud. You must set up and specify Kinesis "
|
||||
"stream name, Kinesis shard, and AWS region in the AWS Greengrass samples."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:375
|
||||
msgid "Cloud storage using AWS S3 bucket:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:377
|
||||
msgid ""
|
||||
"When the :command:`enable_s3_jpeg_output` variable is set to True, it "
|
||||
"enables uploading and storing processed frames (in jpeg format) in an AWS"
|
||||
" S3 bucket. You must set up and specify the S3 bucket name in the AWS "
|
||||
"Greengrass samples to store the JPEG images. The images are named using "
|
||||
"the timestamp and uploaded to S3."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:383
|
||||
msgid "Local storage:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:385
|
||||
msgid ""
|
||||
"When the :command:`enable_s3_jpeg_output` variable is set to True, it "
|
||||
"enables storing processed frames (in jpeg format) on the edge device. The"
|
||||
" images are named using the timestamp and stored in a directory specified"
|
||||
" by :command:`PARAM_OUTPUT_DIRECTORY`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:391
|
||||
msgid "References"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:393
|
||||
msgid "AWS Greengrass: https://aws.amazon.com/greengrass/"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:394
|
||||
msgid "AWS Lambda: https://aws.amazon.com/lambda/"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:395
|
||||
msgid "AWS Kinesis: https://aws.amazon.com/kinesis/"
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -45,28 +45,15 @@ msgid ""
|
||||
" optimization patches are found in our `Linux`_ GitHub\\* repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:24
|
||||
msgid "Kernel Container"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:20
|
||||
msgid ""
|
||||
"The *kernel-container* bundle contains the kernel used by the Intel® "
|
||||
"Clear Containers project. This kernel is optimized for fast booting and "
|
||||
"performs best on |CC| running on the Intel® architectures described on "
|
||||
"the :ref:`supported hardware list<system-requirements>`. The optimization"
|
||||
" patches are found in our `Linux-Container`_ GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:29
|
||||
#: ../../tooling/compatible-kernels.rst:22
|
||||
msgid "Also compatible with VMs"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:39
|
||||
#: ../../tooling/compatible-kernels.rst:32
|
||||
msgid "Kernel LTS"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:32
|
||||
#: ../../tooling/compatible-kernels.rst:25
|
||||
msgid ""
|
||||
"The *kernel-lts* bundle focuses on the bare metal platforms but uses the "
|
||||
"latest :abbr:`LTS (Long Term Support)` Linux kernel. It is optimized for "
|
||||
@@ -78,15 +65,15 @@ msgid ""
|
||||
"GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:42
|
||||
#: ../../tooling/compatible-kernels.rst:35
|
||||
msgid "VM only"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:54
|
||||
#: ../../tooling/compatible-kernels.rst:47
|
||||
msgid "Kernel KVM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:45
|
||||
#: ../../tooling/compatible-kernels.rst:38
|
||||
msgid ""
|
||||
"The *kernel-kvm* bundle focuses on the Linux :abbr:`KVM (Kernel-based "
|
||||
"Virtual Machine)`. It is optimized for fast booting and performs best on "
|
||||
@@ -99,11 +86,11 @@ msgid ""
|
||||
"optimization patches are found in our `Linux-KVM`_ GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:65
|
||||
#: ../../tooling/compatible-kernels.rst:58
|
||||
msgid "Kernel Hyper-V\\*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:57
|
||||
#: ../../tooling/compatible-kernels.rst:50
|
||||
msgid ""
|
||||
"The *kernel-hyperv* bundle focuses on running Linux on Microsoft\\* "
|
||||
"Hyper-V. It is optimized for fast booting and performs best on Virtual "
|
||||
@@ -116,11 +103,11 @@ msgid ""
|
||||
"GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:78
|
||||
#: ../../tooling/compatible-kernels.rst:71
|
||||
msgid "Kernel Hyper-V LTS"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:68
|
||||
#: ../../tooling/compatible-kernels.rst:61
|
||||
msgid ""
|
||||
"The *kernel-hyperv-lts* bundle focuses on running Linux on Microsoft "
|
||||
"Hyper-V but uses the latest :abbr:`LTS (Long Term Support)` Linux kernel."
|
||||
@@ -133,3 +120,19 @@ msgid ""
|
||||
"optimization patches are found in our `Linux-HyperV-LTS`_ GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Kernel Container"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The *kernel-container* bundle contains "
|
||||
#~ "the kernel used by the Intel® "
|
||||
#~ "Clear Containers project. This kernel is"
|
||||
#~ " optimized for fast booting and "
|
||||
#~ "performs best on |CC| running on "
|
||||
#~ "the Intel® architectures described on "
|
||||
#~ "the :ref:`supported hardware list<system-"
|
||||
#~ "requirements>`. The optimization patches are"
|
||||
#~ " found in our `Linux-Container`_ "
|
||||
#~ "GitHub repo."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,248 @@
|
||||
# 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-22 12:54-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"
|
||||
|
||||
#: ../../tooling/security.rst:4
|
||||
msgid "OS Security"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/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 ""
|
||||
|
||||
#: ../../tooling/security.rst:14
|
||||
msgid "Security in updates"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:16
|
||||
msgid ""
|
||||
"The |CL| team believes in the benefits of software security through open "
|
||||
"sourcing, incremental updates, and rapidly resolving known security "
|
||||
"advisories."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:20
|
||||
msgid "The latest Linux\\* codebase"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:22
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:27
|
||||
msgid "Automated effective updating"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:29
|
||||
msgid "|CL| is incrementally updated multiple times per day."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:31
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:35
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:41
|
||||
msgid ""
|
||||
"In |CL| updates are delivered automatically, efficiently, and "
|
||||
"effectively. For more information about software updates in |CL|, refer "
|
||||
"to the :ref:`swupd-guide` guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:46
|
||||
msgid "Automated CVE scanning and remediation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:48
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:53
|
||||
msgid ""
|
||||
"|CL| employs a proactive and measured approach to addressing known and "
|
||||
"fixable :abbr:`CVEs (Common Vulnerabilities and Exposures)`. Packages are"
|
||||
" automatically scanned against CVEs daily, and security patches are "
|
||||
"deployed as soon as they are available."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:58
|
||||
msgid ""
|
||||
"These combined practices minimize the amount of time |CL| systems are "
|
||||
"exposed to unnecessary security risk."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:61
|
||||
msgid "Security in software"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:64
|
||||
msgid "Minimized attack surface"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:66
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:70
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:74
|
||||
msgid ""
|
||||
"Services and subsystems which expose sensitive system information have "
|
||||
"been removed such as the `finger` and `tcpwrappers`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:77
|
||||
msgid "`SFTP` has been disabled by default due to security considerations."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:80
|
||||
msgid "Verified trust"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:82
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:86
|
||||
msgid ""
|
||||
"All update operations from swupd are transparently encrypted and checked "
|
||||
"against the |CL| maintainers' public key for authenticity. More "
|
||||
"information about swupd security can be found in the `Security for "
|
||||
"software update in Clear Linux* OS`_ blog post."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:91
|
||||
msgid ""
|
||||
"Before being built, packages available from |CL| verify checksums and "
|
||||
"signatures provided by third party project codebases and maintainers."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:94
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:100
|
||||
msgid "Compiled with secure options"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:102
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:106
|
||||
msgid ""
|
||||
"Kernels shipped with |CL| are signed and disallow the usage of custom "
|
||||
"kernel modules to maintain verifiable system integrity."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:109
|
||||
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 about PIE executables can "
|
||||
"be found in the `Recent GNU* C library improvements`_ blog post."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:116
|
||||
msgid "Security in system design"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:118
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:122
|
||||
msgid ""
|
||||
"Full disk encryption using :abbr:`LUKS (Linux Unified Key Setup)` is "
|
||||
"available during installation. Refer to `cryptsetup`_ for additional "
|
||||
"information about LUKS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:126
|
||||
msgid ""
|
||||
"|CL| uses the PAM cracklib module to harden user login and password "
|
||||
"security resulting in:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:129
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:132
|
||||
msgid ""
|
||||
"Simple password schemes, which are known to be easily compromised, cannot"
|
||||
" be set in |CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:135
|
||||
msgid ""
|
||||
"A password blacklist, to avoid system passwords being set to passwords "
|
||||
"which have been compromised in the past."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:138
|
||||
msgid ""
|
||||
"`Tallow`_, a lightweight service which monitors and blocks suspicious SSH"
|
||||
" login patterns, is installed with the :command:`openssh-server` bundle."
|
||||
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-22 12:54-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"
|
||||
|
||||
#: ../../tooling/stateless.rst:4
|
||||
msgid "Stateless"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:6
|
||||
msgid ""
|
||||
"In most operating systems, user data, system data, and configuration "
|
||||
"files can become intermingled."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:14
|
||||
msgid ""
|
||||
"Figure 1: Without stateless, user and system files become mixed on the "
|
||||
"filesystem over time."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:16
|
||||
msgid ""
|
||||
"|CL-ATTR| has a stateless design philosophy with the goal 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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:25
|
||||
msgid "File-level separation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:27
|
||||
msgid ""
|
||||
"To accomplish a stateless design the Linux Filesystem Hierarchy is "
|
||||
"separated between user-owned areas and |CL|-owned areas."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:35
|
||||
msgid ""
|
||||
"Figure 2: With stateless, user and system files are separated on the "
|
||||
"filesystem."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:38
|
||||
msgid "System areas"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:39
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:45
|
||||
msgid "User areas"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:46
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:54
|
||||
msgid "Software configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:56
|
||||
msgid ""
|
||||
"With stateless separation, default software configurations are read in "
|
||||
"order from predefined source code, |CL| provided defaults, and user-"
|
||||
"provided configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:61
|
||||
msgid "Default configurations"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:63
|
||||
msgid ""
|
||||
"Software in |CL| provides default configuration values so that it is "
|
||||
"immediately functional, whenever it is appropriate to do so."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:66
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:71
|
||||
msgid ""
|
||||
"For example, the default configuration that Apache uses when installed "
|
||||
"can be found at :file:`/usr/share/defaults/httpd/httpd.conf` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:76
|
||||
msgid "Overriding configurations"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:78
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:82
|
||||
msgid ""
|
||||
"User defined configuration files should contain the minimal set of "
|
||||
"desired changes and rely on default configuration for the rest."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:85
|
||||
msgid "For example, a customized Apache configuration can be used instead by:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:87
|
||||
msgid "Create the destination directory for the configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:93
|
||||
msgid "Copy the default configuration as a reference template:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:99
|
||||
msgid "Make any desired modifications to the configurations:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:105
|
||||
msgid "Reload the service or reboot the system to pickup any changes:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:111
|
||||
msgid ""
|
||||
"This pattern can be used to modify the configurations of other programs "
|
||||
"too. The `stateless man page`_ has application-specific examples."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:115
|
||||
msgid "System reset"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:117
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:121
|
||||
msgid ""
|
||||
"Running the commands below effectively performs a system reset as if it "
|
||||
"was just installed:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:129
|
||||
msgid ""
|
||||
"In other Linux distributions, this can be a catastrophic action that "
|
||||
"renders a system unable to boot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:133
|
||||
msgid "Additional information"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:135
|
||||
msgid "`stateless man page`_"
|
||||
msgstr ""
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -28,6 +28,34 @@ msgid ""
|
||||
"important tools and concepts for managing your install."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:18
|
||||
msgid "Training"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:20
|
||||
msgid ""
|
||||
"Additional training materials are available in the `how-to-clear`_ "
|
||||
"GitHub\\* project to help you get started with |CL| tools."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:23
|
||||
msgid ""
|
||||
"The training helps you create a customized OS that is based on |CL| and "
|
||||
"provides complete details on the methods and tools used to create updates"
|
||||
" and how to deploy updates to targets."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:27
|
||||
msgid ""
|
||||
"To complete the training, you will need a clean |CL| installation and a "
|
||||
"network connection. The project includes all files needed to complete the"
|
||||
" exercises."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:29
|
||||
msgid "`how-to-clear`_ training on GitHub"
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Tooling"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -25,7 +25,7 @@ msgstr ""
|
||||
#: ../../tutorials/docker/docker.rst:6
|
||||
msgid ""
|
||||
"|CL-ATTR| supports multiple containerization platforms, including a "
|
||||
"Docker\\* solution. |CL| has many `unique features`_ including a minimal "
|
||||
"Docker solution. |CL| has many unique features including a minimal "
|
||||
"default installation, which makes it compelling to use as a host for "
|
||||
"container workloads, management, and orchestration."
|
||||
msgstr ""
|
||||
@@ -66,7 +66,7 @@ msgid "Additionally, you should have:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:39
|
||||
msgid "A basic understanding of Linux and Docker."
|
||||
msgid "A basic understanding of Linux\\* and Docker."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:41
|
||||
@@ -116,7 +116,7 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:83
|
||||
msgid "Integration with Kata Containers (optional)"
|
||||
msgid "Integration with Kata Containers\\* (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:85
|
||||
@@ -136,10 +136,10 @@ msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:96
|
||||
msgid ""
|
||||
"The proceeding sections of this tutorial are standard to Docker setup and"
|
||||
" configuration. If you are familiar with Docker basics, you do not need "
|
||||
"to continue reading. The following sections are provided here for sake of"
|
||||
" completeness."
|
||||
"The remaining sections of this tutorial are standard to Docker setup and "
|
||||
"configuration. If you are familiar with Docker basics, you do not need to"
|
||||
" continue reading. The following sections are provided here for sake of "
|
||||
"completeness."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:104
|
||||
@@ -150,8 +150,8 @@ msgstr ""
|
||||
msgid ""
|
||||
"Perform additional Docker daemon configuration via a configuration file "
|
||||
"typically located at :file:`/etc/docker/daemon.json`. |CL| features a "
|
||||
"`stateless system`_ so the configuration file :file:`daemon.json` does "
|
||||
"*NOT* exist by default."
|
||||
":ref:`stateless` system so the configuration file :file:`daemon.json` "
|
||||
"does *NOT* exist by default."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:111
|
||||
@@ -195,14 +195,14 @@ msgstr ""
|
||||
msgid ""
|
||||
"`Docker Hub`_ is a publically available container image repository which "
|
||||
"comes preconfigured with Docker. In the example below we will pull and "
|
||||
"run an the official Docker image for nginx, an open source reverse proxy "
|
||||
"server."
|
||||
"run an the official Docker image for nginx\\*, an open source reverse "
|
||||
"proxy server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:153
|
||||
msgid ""
|
||||
"First, pull a container image from Docker Hub using the :command:`docker "
|
||||
"pull` command. Download the latest nginx Docker container image by "
|
||||
"pull` command. Download the latest nginx\\* Docker container image by "
|
||||
"running this command:"
|
||||
msgstr ""
|
||||
|
||||
@@ -295,3 +295,56 @@ msgstr ""
|
||||
msgid "`Kata Containers`_"
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "|CL-ATTR| supports multiple containerization"
|
||||
#~ " platforms, including a Docker\\* solution."
|
||||
#~ " |CL| has many `unique features`_ "
|
||||
#~ "including a minimal default installation, "
|
||||
#~ "which makes it compelling to use "
|
||||
#~ "as a host for container workloads, "
|
||||
#~ "management, and orchestration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "A basic understanding of Linux and Docker."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Integration with Kata Containers (optional)"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The proceeding sections of this tutorial"
|
||||
#~ " are standard to Docker setup and "
|
||||
#~ "configuration. If you are familiar with"
|
||||
#~ " Docker basics, you do not need "
|
||||
#~ "to continue reading. The following "
|
||||
#~ "sections are provided here for sake "
|
||||
#~ "of completeness."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Perform additional Docker daemon configuration"
|
||||
#~ " via a configuration file typically "
|
||||
#~ "located at :file:`/etc/docker/daemon.json`. |CL| "
|
||||
#~ "features a `stateless system`_ so the"
|
||||
#~ " configuration file :file:`daemon.json` does "
|
||||
#~ "*NOT* exist by default."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "`Docker Hub`_ is a publically available"
|
||||
#~ " container image repository which comes "
|
||||
#~ "preconfigured with Docker. In the "
|
||||
#~ "example below we will pull and run"
|
||||
#~ " an the official Docker image for "
|
||||
#~ "nginx, an open source reverse proxy "
|
||||
#~ "server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "First, pull a container image from "
|
||||
#~ "Docker Hub using the :command:`docker "
|
||||
#~ "pull` command. Download the latest nginx"
|
||||
#~ " Docker container image by running "
|
||||
#~ "this command:"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -167,60 +167,60 @@ msgid ""
|
||||
" kata-runtime."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:138
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:139
|
||||
msgid "Configure and run CRI-O + kata-runtime"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:140
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:141
|
||||
msgid "Enable the CRI-O service:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:146
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:147
|
||||
msgid "Enter the commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:153
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:154
|
||||
msgid ""
|
||||
"Initialize the master control plane with the command below and follow the"
|
||||
" displayed instructions to set up `kubectl`:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:159
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:161
|
||||
msgid "Register kata-runtime as a RuntimeClass handler:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:178
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:180
|
||||
msgid "Install pod network add-on"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:180
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:182
|
||||
msgid ""
|
||||
"You must choose and install a `pod network add-on`_ to allow your pods to"
|
||||
" communicate. Check whether or not your add-on requires special flags "
|
||||
"when you initialize the master control plane."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:184
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:186
|
||||
msgid "**Notes about flannel add-on**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:186
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:188
|
||||
msgid ""
|
||||
"If you choose the `flannel` add-on, then you must add the following to "
|
||||
"the `kubeadm init` command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:193
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:195
|
||||
msgid ""
|
||||
"Furthermore, if you are using CRI-O and `flannel` and you want to use "
|
||||
"Kata Containers, edit the :file:`/etc/crio/crio.conf` file to add:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:202
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:204
|
||||
msgid "Use your cluster"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:204
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:206
|
||||
msgid ""
|
||||
"Once your master control plane is successfully initialized, instructions "
|
||||
"on how to use your cluster and its *IP*, *token*, and *hash* values are "
|
||||
@@ -229,11 +229,11 @@ msgid ""
|
||||
"have a valid period. The values are presented in a format similar to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:214
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:216
|
||||
msgid "**Congratulations!**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:216
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:218
|
||||
msgid ""
|
||||
"You've successfully installed and set up Kubernetes in |CL| using CRI-O "
|
||||
"and kata-runtime. You are now ready to follow on-screen instructions to "
|
||||
@@ -241,46 +241,46 @@ msgid ""
|
||||
"displayed token and IP information."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:222
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:224
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:224
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:226
|
||||
msgid "Read the Kubernetes documentation to learn more about:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:226
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:228
|
||||
msgid "`Understanding basic Kubernetes architecture`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:228
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:230
|
||||
msgid "`Deploying an application to your cluster`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:230
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:232
|
||||
msgid "Installing a `pod network add-on`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:232
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:234
|
||||
msgid "`Joining your nodes`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:235
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:237
|
||||
msgid "Cloud native setup automation (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:237
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:239
|
||||
msgid ""
|
||||
"Clone the `cloud-native-setup`_ repository on your system and follow the "
|
||||
"instructions. This repository includes helper scripts to automate "
|
||||
"configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:240
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:243
|
||||
msgid "Package configuration customization (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:242
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:245
|
||||
msgid ""
|
||||
"|CL| is a stateless system that looks for user-defined package "
|
||||
"configuration files in the :file:`/etc/<package-name>` directory to be "
|
||||
@@ -288,7 +288,7 @@ msgid ""
|
||||
"distribution-provided configuration files for each package."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:247
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:250
|
||||
msgid ""
|
||||
"If you customize any of the default package configuration files, you "
|
||||
"**must** store the customized files in the :file:`/etc/` directory. If "
|
||||
@@ -296,21 +296,23 @@ msgid ""
|
||||
"will be lost in the next system update."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:252
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:255
|
||||
msgid ""
|
||||
"For example, to customize CRI-O configuration in your system, run the "
|
||||
"following commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:261
|
||||
msgid "Learn more about `Stateless`_ in |CL| and view the |CL| `documentation`_."
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:264
|
||||
msgid ""
|
||||
"Learn more about :ref:`stateless` in |CL| and view the |CL| "
|
||||
"`documentation`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:264
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:267
|
||||
msgid "Proxy configuration (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:266
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:269
|
||||
msgid ""
|
||||
"If you use a proxy server, you must set your proxy environment variables "
|
||||
"and create an appropriate proxy configuration file for both CRI-O "
|
||||
@@ -320,78 +322,78 @@ msgid ""
|
||||
"is not enough.)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:271
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:274
|
||||
msgid ""
|
||||
"If you have already set your proxy environment variables, run the "
|
||||
"following commands as a shell script to configure all of these services "
|
||||
"in one step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:289
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:292
|
||||
msgid "Next steps"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:291
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:294
|
||||
msgid ":ref:`kubernetes-bp`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:295
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:298
|
||||
msgid "Troubleshooting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:297
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:300
|
||||
msgid "<HOSTNAME> not found in <IP> message."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:299
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:302
|
||||
msgid ""
|
||||
"Your DNS server may not be appropriately configured. Try adding an entry "
|
||||
"to the :file:`/etc/hosts` file with your host's IP and Name."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:302
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:305
|
||||
msgid "For example: 100.200.50.20 myhost"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:304
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:307
|
||||
msgid ""
|
||||
"Use the commands :command:`hostname` and :command:`hostname -I` to "
|
||||
"retrieve them."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:306
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:309
|
||||
msgid "Images cannot be pulled."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:308
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:311
|
||||
msgid ""
|
||||
"You may be behind a proxy server. Try configuring your proxy settings, "
|
||||
"using the environment variables *HTTP_PROXY*, *HTTPS_PROXY*, and "
|
||||
"*NO_PROXY* as required in your environment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:312
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:315
|
||||
msgid "Connection refused error."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:314
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:317
|
||||
msgid ""
|
||||
"If you are behind a proxy server, you may need to add the master's IP to "
|
||||
"the environment variable *NO_PROXY*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:317
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:320
|
||||
msgid "Connection timed-out or Access Refused errors."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:319
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:322
|
||||
msgid ""
|
||||
"You must ensure that the appropriate proxy settings are available from "
|
||||
"the same terminal where you will initialize the control plane. To verify "
|
||||
"the proxy settings that Kubernetes will actually use, run the commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:329
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:332
|
||||
msgid ""
|
||||
"If the displayed proxy values are different from your assigned values, "
|
||||
"the cluster initialization will fail. Contact your IT support team to "
|
||||
@@ -400,49 +402,54 @@ msgid ""
|
||||
"SSH access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:334
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:337
|
||||
msgid ""
|
||||
"If the result of the above commands is blank, you may need to add a "
|
||||
"``profile`` to the :file:`/etc` directory. To do so, follow these steps."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:337
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:340
|
||||
msgid "Create a `profile` in :file:`/etc`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:343
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:346
|
||||
msgid ""
|
||||
"With a preferred editor, open `profile`, and enter your proxy settings. "
|
||||
"Example shown below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:355
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:358
|
||||
msgid "<master IP> can be obtained by running :command:`ifconfig`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:357
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:360
|
||||
msgid "Save and exit the `profile`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:359
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:362
|
||||
msgid "Run:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:365
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:368
|
||||
msgid "To ensure your system isn't running previous session variables, run:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:371
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:374
|
||||
msgid "Continue below while passing `-E` in the command as shown."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:373
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:376
|
||||
msgid "Missing environment variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:375
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:378
|
||||
msgid ""
|
||||
"If you are behind a proxy server, pass environment variables by adding "
|
||||
"*-E* to the command that initializes the master control plane."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Learn more about `Stateless`_ in |CL|"
|
||||
#~ " and view the |CL| `documentation`_."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -92,17 +92,18 @@ msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:3
|
||||
msgid ""
|
||||
"The *kernel-native-dkms* bundle provides the :command:`dkms` program and "
|
||||
"Linux kernel headers, which are required for compiling kernel modules."
|
||||
"The :command:`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:6
|
||||
msgid "The *kernel-native-dkms* bundle also:"
|
||||
msgid "The :command:`kernel-native-dkms` bundle also:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:8
|
||||
msgid ""
|
||||
"Adds a systemd update trigger (:file:`/usr/lib/systemd/system/dkms-new-"
|
||||
"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 ""
|
||||
@@ -128,35 +129,35 @@ msgid ""
|
||||
"relies on a kernel module."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:28
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:27
|
||||
msgid ""
|
||||
"Install the :command:`kernel-native-dkms` or :command:`kernel-lts-dkms` "
|
||||
"bundle:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:31
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:30
|
||||
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:40
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:39
|
||||
msgid "Ensure *.native* or *.lts* is in the kernel name."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:42
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:41
|
||||
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:50
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:49
|
||||
msgid "or"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:57
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:56
|
||||
msgid "Update the |CL| bootloader and reboot."
|
||||
msgstr ""
|
||||
|
||||
@@ -418,3 +419,22 @@ msgid ""
|
||||
"<https://download.nvidia.com/XFree86/Linux-x86_64/>`_"
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The *kernel-native-dkms* bundle provides"
|
||||
#~ " the :command:`dkms` program and Linux "
|
||||
#~ "kernel headers, which are required for"
|
||||
#~ " compiling kernel modules."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The *kernel-native-dkms* bundle also:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -25,7 +25,7 @@ msgstr ""
|
||||
#: ../../tutorials/wordpress/web-server-install.rst:6
|
||||
msgid ""
|
||||
"This tutorial provides instructions on how to set up a :abbr:`LAMP "
|
||||
"(Linux, Apache, MySQL, PHP)` web server on |CL-ATTR| and how to use "
|
||||
"(Linux, Apache\\*, MySQL, PHP)` web server on |CL-ATTR| and how to use "
|
||||
"phpMyAdmin\\* to manage an associated database. Note that this tutorial "
|
||||
"installs MariaDB\\*, which is a drop-in replacement for MySQL\\*."
|
||||
msgstr ""
|
||||
@@ -106,9 +106,9 @@ msgstr ""
|
||||
|
||||
#: ../../tutorials/wordpress/web-server-install.rst:78
|
||||
msgid ""
|
||||
"|CL| is designed to be a `stateless`_ operating system which means that "
|
||||
"you must create an optional configuration file to override the default "
|
||||
"values. The default location of the Apache configuration file, "
|
||||
"|CL| is designed to be a :ref:`stateless` operating system which means "
|
||||
"that you must create an optional configuration file to override the "
|
||||
"default values. The default location of the Apache configuration file, "
|
||||
":file:`httpd.conf`, is located in the :file:`/usr/share/defaults/httpd` "
|
||||
"directory. |CL| can override this directory as part of the stateless "
|
||||
"paradigm. This default :file:`.conf` file includes the following "
|
||||
@@ -545,3 +545,30 @@ msgid ""
|
||||
"with :ref:`wp-install`."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This tutorial provides instructions on "
|
||||
#~ "how to set up a :abbr:`LAMP "
|
||||
#~ "(Linux, Apache, MySQL, PHP)` web server"
|
||||
#~ " on |CL-ATTR| and how to use"
|
||||
#~ " phpMyAdmin\\* to manage an associated "
|
||||
#~ "database. Note that this tutorial "
|
||||
#~ "installs MariaDB\\*, which is a drop-"
|
||||
#~ "in replacement for MySQL\\*."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "|CL| is designed to be a "
|
||||
#~ "`stateless`_ operating system which means "
|
||||
#~ "that you must create an optional "
|
||||
#~ "configuration file to override the "
|
||||
#~ "default values. The default location of"
|
||||
#~ " the Apache configuration file, "
|
||||
#~ ":file:`httpd.conf`, is located in the "
|
||||
#~ ":file:`/usr/share/defaults/httpd` directory. |CL| "
|
||||
#~ "can override this directory as part "
|
||||
#~ "of the stateless paradigm. This default"
|
||||
#~ " :file:`.conf` file includes the following"
|
||||
#~ " directives that allow for additional "
|
||||
#~ "locations of configuration definitions:"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
+266
-189
File diff suppressed because it is too large
Load Diff
+358
-298
File diff suppressed because it is too large
Load Diff
+230
-83
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -123,11 +123,11 @@ msgid ""
|
||||
"|CL| images."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:4
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:4
|
||||
msgid "Verify the integrity of the |CL| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:6
|
||||
#: ../../guides/maintenance/download-verify-decompress.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."
|
||||
@@ -135,57 +135,202 @@ msgid ""
|
||||
"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."
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:11
|
||||
msgid "Download the corresponding SHA512 checksum file of your |CL| `image`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:12
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:12
|
||||
msgid "Start Command Prompt."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:13
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:13
|
||||
msgid "Go to the directory with the downloaded image and checksum files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:14
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:14
|
||||
msgid "Get the SHA512 checksum of the image with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:20
|
||||
#: ../../guides/maintenance/download-verify-decompress.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
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:24
|
||||
msgid "Decompress the |CL| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:26
|
||||
#: ../../guides/maintenance/download-verify-decompress.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
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:30
|
||||
msgid "Download and install `7-Zip`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:31
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:31
|
||||
msgid "Go to the directory with the downloaded image and right-click it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress-windows.rst:32
|
||||
#: ../../guides/maintenance/download-verify-decompress.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
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:39
|
||||
msgid "Figure 1: Windows 7-Zip extract file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:44
|
||||
msgid "Image types"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:3
|
||||
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:6
|
||||
msgid "Table 1: Types of platform-independent |CL| images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:10 ../../reference/image-types.rst:23
|
||||
msgid "Image Type"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:11 ../../reference/image-types.rst:24
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:13
|
||||
msgid "live-desktop.img or live-desktop.iso"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:14
|
||||
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:16
|
||||
msgid "live-server.img or live-server.iso"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:17
|
||||
msgid "Image for booting to server command prompt to preview or install the OS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:19
|
||||
msgid "Table 2: Types of platform-specific |CL| images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:26
|
||||
msgid "aws.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:27
|
||||
msgid "Image suitable for use with Amazon\\* AWS\\*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:29
|
||||
msgid "azure.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:30
|
||||
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:32
|
||||
msgid "azure-docker.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:33
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
|
||||
"Docker\\* pre-installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:35
|
||||
msgid "azure-machine-learning.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:36
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
|
||||
"`machine-learning-basic` bundle installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:38
|
||||
msgid "cloudguest.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:39
|
||||
msgid ""
|
||||
"Image with generic cloud guest virtual machine (VM) requirements "
|
||||
"installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:41
|
||||
msgid "gce.tar"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:42
|
||||
msgid "Image with the Google Compute Engine (GCE) specific kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:44
|
||||
msgid "hyperv.vhdx"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:45
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
|
||||
"`optimized kernel`_ for Hyper-V."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:47
|
||||
msgid "kvm.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:48
|
||||
msgid ""
|
||||
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
|
||||
"kernel`_ for KVM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:51
|
||||
msgid "kvm-legacy.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:52
|
||||
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:54
|
||||
msgid "pxe.tar"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:55
|
||||
msgid "Image suitable for use with PXE server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:57
|
||||
msgid "vmware.vmdk"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:58
|
||||
msgid ""
|
||||
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
|
||||
"Workstation, and ESXi."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:75
|
||||
msgid "We also provide instructions for other operating systems:"
|
||||
msgstr ""
|
||||
@@ -194,78 +339,74 @@ msgstr ""
|
||||
msgid ":ref:`download-verify-decompress-linux`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:78
|
||||
msgid ":ref:`download-verify-decompress-mac`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:81
|
||||
#: ../../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:83
|
||||
#: ../../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:84
|
||||
#: ../../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:91
|
||||
#: ../../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:93
|
||||
#: ../../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:101
|
||||
#: ../../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:104
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:120
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:131
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:230
|
||||
#: ../../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:106
|
||||
#: ../../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:114
|
||||
#: ../../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:117
|
||||
#: ../../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:122
|
||||
#: ../../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:129
|
||||
#: ../../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:133
|
||||
#: ../../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 "
|
||||
@@ -274,220 +415,220 @@ msgid ""
|
||||
"figure 5."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:143
|
||||
#: ../../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:145
|
||||
#: ../../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:152
|
||||
#: ../../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:154
|
||||
#: ../../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:161
|
||||
#: ../../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:164
|
||||
#: ../../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:167
|
||||
#: ../../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:174
|
||||
#: ../../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:176
|
||||
#: ../../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:179
|
||||
#: ../../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:181
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:258
|
||||
#: ../../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:184
|
||||
#: ../../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:186
|
||||
#: ../../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:192
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:277
|
||||
#: ../../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:194
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:279
|
||||
#: ../../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:195
|
||||
#: ../../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:197
|
||||
#: ../../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:204
|
||||
#: ../../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:206
|
||||
#: ../../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:208
|
||||
#: ../../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:215
|
||||
#: ../../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:217
|
||||
#: ../../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:219
|
||||
#: ../../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:226
|
||||
#: ../../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:228
|
||||
#: ../../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:232
|
||||
#: ../../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:238
|
||||
#: ../../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:240
|
||||
#: ../../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:246
|
||||
#: ../../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:248
|
||||
#: ../../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:255
|
||||
#: ../../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:262
|
||||
#: ../../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:266
|
||||
#: ../../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:268
|
||||
#: ../../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:280
|
||||
#: ../../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:283
|
||||
#: ../../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:285
|
||||
#: ../../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:287
|
||||
#: ../../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:294
|
||||
#: ../../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:296
|
||||
#: ../../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:299
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:298
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:301
|
||||
#: ../../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:303
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:302
|
||||
msgid ":ref:`vmw-player`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:304
|
||||
#: ../../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:305
|
||||
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:304
|
||||
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
|
||||
msgstr ""
|
||||
|
||||
@@ -523,3 +664,9 @@ msgstr ""
|
||||
#~ msgid "For additional help, see the `VMware Workstation Player guide`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Download the corresponding SHA512 checksum file of your |CL| image."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-mac`"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -25,7 +25,7 @@ msgstr ""
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:6
|
||||
msgid ""
|
||||
"This page explains how to create a new VM and install |CL| on it with the"
|
||||
" VMware Workstation 14 Player hypervisor."
|
||||
" VMware Workstation Player hypervisor."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:14
|
||||
@@ -34,293 +34,219 @@ msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:16
|
||||
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."
|
||||
"`VMware Workstation Player`_ is a type 2 hypervisor. It runs on top of "
|
||||
"Windows\\* or Linux\\* operating systems. 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:21
|
||||
msgid ""
|
||||
"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:24
|
||||
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:27
|
||||
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:33
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:27
|
||||
msgid ""
|
||||
"Screenshots in this document show VMware Workstation 14 Player for "
|
||||
"Windows. Menus and prompts in the Linux version have minor wording "
|
||||
"differences."
|
||||
"The screenshots on this document show the Windows version of the VMware "
|
||||
"Workstation 15 Player. The menus and prompts are similar to those in "
|
||||
"other versions and for the Linux OS save some minor wording differences."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:37
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:31
|
||||
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:35
|
||||
msgid "Install the VMware Workstation Player hypervisor"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:39
|
||||
#: ../../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:43
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:41
|
||||
msgid ""
|
||||
"`VMware Workstation 14 Player`_ is available for Windows and Linux. "
|
||||
"Download your preferred version."
|
||||
"`VMware Workstation Player`_ is available for Windows and Linux. Download"
|
||||
" your preferred version."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:46
|
||||
msgid ""
|
||||
"Install VMware Workstation 14 Player following the instructions "
|
||||
"appropriate for your system's OS:"
|
||||
"By default, selecting download means you receive the latest version of "
|
||||
"this application. Commands may differ based on the version."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:49
|
||||
msgid "On supported Linux distros:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:51
|
||||
msgid "Enable a GUI desktop."
|
||||
msgid ""
|
||||
"Install VMware Workstation Player following the instructions appropriate "
|
||||
"for your system's OS:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:52
|
||||
msgid "On supported Linux distros:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:54
|
||||
msgid "Enable a GUI desktop."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:55
|
||||
msgid "Start a terminal emulator."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:53
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:56
|
||||
msgid ""
|
||||
"Start the installer by issuing the command below and follow the guided "
|
||||
"steps."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:60
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:63
|
||||
msgid "On Windows:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:62
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:65
|
||||
msgid "Start the installer."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:63
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:66
|
||||
msgid "Follow the setup wizard."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:65
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:68
|
||||
msgid "For additional help, see the `VMware Workstation Player Documentation`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:68
|
||||
msgid "Download the latest |CL| installer ISO"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:70
|
||||
msgid ""
|
||||
"Get the latest |CL| installer ISO image from the `image`_ repository. "
|
||||
"Look for :file:`clear-[version number]-installer.iso.xz`."
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:71
|
||||
msgid "Download the latest |CL| installer"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:73
|
||||
msgid "Get the latest installer with |CL| OS Desktop from the `downloads`_ page."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:75
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:77
|
||||
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:78
|
||||
msgid "We also provide instructions for other operating systems:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:80
|
||||
msgid ":ref:`download-verify-decompress-linux`"
|
||||
"We also provide instructions for downloading and verifying a Clear Linux "
|
||||
"ISO. For more information, refer to :ref:`download-verify-decompress`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:81
|
||||
msgid ":ref:`download-verify-decompress-mac`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:84
|
||||
msgid "Create and configure a new VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:86
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:83
|
||||
msgid "Start the `VMware Workstation Player` app."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:88
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:85
|
||||
msgid ""
|
||||
"On the home screen, click :guilabel:`Create a New Virtual Machine`. See "
|
||||
"Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:95
|
||||
msgid "Figure 1: VMware Workstation 14 Player - Create a new virtual machine"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:92
|
||||
msgid "Figure 1: VMware Workstation Player - Create a new virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:98
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:95
|
||||
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:106
|
||||
msgid "Figure 2: VMware Workstation 14 Player - Select |CL| installer ISO"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:103
|
||||
msgid "Figure 2: VMware Workstation Player - Select |CL| installer ISO"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:108
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:105
|
||||
msgid ""
|
||||
"Click the :guilabel:`Browse` button and select the decompressed |CL| "
|
||||
"installer ISO."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:111
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:127
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:138
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:153
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:108
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:124
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:135
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:151
|
||||
msgid "Click the :guilabel:`Next` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:113
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:110
|
||||
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:121
|
||||
msgid ""
|
||||
"Figure 3: VMware Workstation 14 Player - Select guest operating system "
|
||||
"type"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:118
|
||||
msgid "Figure 3: VMware Workstation Player - Select guest operating system type"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:124
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:121
|
||||
msgid ""
|
||||
"Set the :guilabel:`Version` setting to :guilabel:`Other Linux 3.x or "
|
||||
"Set the :guilabel:`Version` setting to :guilabel:`Other Linux 4.x or "
|
||||
"later kernel 64-bit`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:129
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:126
|
||||
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:136
|
||||
msgid "Figure 4: VMware Workstation 14 Player - Name virtual machine"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:133
|
||||
msgid "Figure 4: VMware Workstation Player - Name virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:140
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:137
|
||||
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:147
|
||||
msgid "Figure 5: VMware Workstation 14 Player - Set disk capacity"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:144
|
||||
msgid "Figure 5: VMware Workstation Player - Set disk capacity"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:150
|
||||
#: ../../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."
|
||||
"For optimal performance with the |CL| Desktop image, we recommend 32GB of"
|
||||
" drive space. See :ref:`system-requirements` for more details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:155
|
||||
#: ../../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:162
|
||||
msgid "Figure 6: VMware Workstation 14 Player - Customize hardware"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:160
|
||||
msgid "Figure 6: VMware Workstation Player - Customize hardware"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:164
|
||||
#: ../../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:170
|
||||
msgid "Figure 7: VMware Workstation 14 Player - Set memory size"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:168
|
||||
msgid "Figure 7: VMware Workstation Player - Set memory size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:173
|
||||
#: ../../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 "
|
||||
@@ -328,170 +254,165 @@ msgid ""
|
||||
" details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:178
|
||||
#: ../../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:185
|
||||
msgid "Figure 8: VMware Workstation 14 Player - Set virtualization engine option"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:183
|
||||
msgid "Figure 8: VMware Workstation Player - Set virtualization engine option"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:188
|
||||
#: ../../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:191
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:189
|
||||
msgid "Click the :guilabel:`Close` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:193
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:191
|
||||
msgid "Click the :guilabel:`Finish` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:196
|
||||
#: ../../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:198
|
||||
#: ../../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:205
|
||||
msgid "Figure 9: VMware Workstation 14 Player - Power on virtual machine"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:203
|
||||
msgid "Figure 9: VMware Workstation Player - Power on virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:207
|
||||
#: ../../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:210
|
||||
#: ../../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:214
|
||||
#: ../../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:216
|
||||
#: ../../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:219
|
||||
#: ../../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 Player - Edit CD/DVD settings"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:226
|
||||
msgid "Figure 10: VMware Workstation 14 Player - Edit CD/DVD settings"
|
||||
msgid "Go to :menuselection:`Removable Devices-->CD/DVD (IDE)-->Disconnect`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:228
|
||||
msgid "Go to :menuselection:`Removable Devices-->CD/DVD (IDE)-->Settings`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:230
|
||||
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:238
|
||||
msgid "Figure 11: VMware Workstation 14 Player - Disconnect CD/DVD"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:240
|
||||
msgid "Click the :guilabel:`OK` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:242
|
||||
msgid "To power off the VM, click the :guilabel:`Player` menu. See Figure 12."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:248
|
||||
msgid "Figure 12: VMware Workstation 14 Player - Power off virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:250
|
||||
msgid "Go to :guilabel:`Power` and select :guilabel:`Shut Down Guest`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:253
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:231
|
||||
msgid "Enable UEFI boot support"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:255
|
||||
msgid ""
|
||||
"|CL| needs UEFI support to boot. To enable UEFI, add the following line "
|
||||
"to the end of your VM's :file:`.vmx` file:"
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:233
|
||||
msgid "|CL| needs UEFI support to boot. To enable UEFI:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:264
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:235
|
||||
msgid "Power off the VM. click the :guilabel:`Player` menu. See Figure 11."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:241
|
||||
msgid "Figure 11: VMware Workstation Player - Power off virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:243
|
||||
msgid "Go to :guilabel:`Power` and select :guilabel:`Shut Down Guest`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:245
|
||||
msgid "Add the following line to the end of your VM's :file:`.vmx` file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:253
|
||||
msgid "Depending on the OS, you can typically find the VMware VM files under:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:266
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:255
|
||||
msgid "On Linux distros: :file:`/home/username/vmware`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:267
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:256
|
||||
msgid ""
|
||||
"On Windows: :file:`C:\\\\Users\\\\username\\\\Documents\\\\Virtual "
|
||||
"Machines`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:270
|
||||
msgid "Power on the VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:272
|
||||
msgid "After configuring the settings above, power on your |CL| virtual machine."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:274
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:259
|
||||
msgid ""
|
||||
"On the :guilabel:`VMware Workstation Player` home screen, select your VM."
|
||||
" See Figure 13."
|
||||
"After configuring the settings above, power on your |CL| virtual machine."
|
||||
" On the :guilabel:`VMware Workstation Player` home screen, select your "
|
||||
"VM. See Figure 9."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:281
|
||||
msgid "Figure 13: VMware Workstation 14 Player - Power on virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:283
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:263
|
||||
msgid "Click :guilabel:`Play virtual machine`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:286
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:265
|
||||
msgid ""
|
||||
"Install Open VM Tools. You may want to install the `open-vm-tools` in "
|
||||
"your virtual machine. The Open Virtual Machine Tools (open-vm-tools) are "
|
||||
"the open source implementation of VMware Tools for Linux guest operating "
|
||||
"systems. In |CL| you can use the following to install the bundle in your "
|
||||
"VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:275
|
||||
msgid ""
|
||||
"More information is available on the `VMWare Tools Product "
|
||||
"Documentation`_ site."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:278
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:288
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:280
|
||||
msgid "For other guides on using the VMWare Player and ESXi, see:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:290
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:282
|
||||
msgid ":ref:`vmw-player-preconf`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:291
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:283
|
||||
msgid ":ref:`vmware-esxi-install-cl`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:292
|
||||
#: ../../get-started/virtual-machine-install/vmw-player.rst:284
|
||||
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
|
||||
msgstr ""
|
||||
|
||||
@@ -521,3 +442,215 @@ msgstr ""
|
||||
#~ msgid "For additional help, see the `VMware Workstation Player guide`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This page explains how to create a"
|
||||
#~ " new VM and install |CL| on it"
|
||||
#~ " with the VMware Workstation 14 "
|
||||
#~ "Player hypervisor."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Screenshots in this document show VMware"
|
||||
#~ " Workstation 14 Player for Windows. "
|
||||
#~ "Menus and prompts in the Linux "
|
||||
#~ "version have minor wording differences."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "`VMware Workstation 14 Player`_ is "
|
||||
#~ "available for Windows and Linux. "
|
||||
#~ "Download your preferred version."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Install VMware Workstation 14 Player "
|
||||
#~ "following the instructions appropriate for "
|
||||
#~ "your system's OS:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Download the latest |CL| installer ISO"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Get the latest |CL| installer ISO "
|
||||
#~ "image from the `image`_ repository. Look"
|
||||
#~ " for :file:`clear-[version number]-installer.iso.xz`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Verify the integrity of the |CL| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Download the corresponding SHA512 checksum file of your |CL| image."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Start Command Prompt."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to the directory with the downloaded image and checksum files."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Get the SHA512 checksum of the image with the command:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Manually compare the output with the "
|
||||
#~ "original checksum value shown in the "
|
||||
#~ "downloaded checksum file and make sure"
|
||||
#~ " they match."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Decompress the |CL| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Download and install `7-Zip`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to the directory with the downloaded image and right-click it."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "From the pop-up menu, select "
|
||||
#~ ":guilabel:`7-Zip` and select :guilabel:`Extract "
|
||||
#~ "Here` as shown in Figure 1."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 1: Windows 7-Zip extract file."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "We also provide instructions for other operating systems:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-linux`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-mac`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 1: VMware Workstation 14 Player - Create a new virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 2: VMware Workstation 14 Player - Select |CL| installer ISO"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Figure 3: VMware Workstation 14 Player"
|
||||
#~ " - Select guest operating system type"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Set the :guilabel:`Version` setting to "
|
||||
#~ ":guilabel:`Other Linux 3.x or later "
|
||||
#~ "kernel 64-bit`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 4: VMware Workstation 14 Player - Name virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 5: VMware Workstation 14 Player - Set disk capacity"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "A minimal |CL| installation can exist"
|
||||
#~ " on 600MB of drive space. See "
|
||||
#~ ":ref:`system-requirements` for more details."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 6: VMware Workstation 14 Player - Customize hardware"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 7: VMware Workstation 14 Player - Set memory size"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Figure 8: VMware Workstation 14 Player"
|
||||
#~ " - Set virtualization engine option"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 9: VMware Workstation 14 Player - Power on virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 10: VMware Workstation 14 Player - Edit CD/DVD settings"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to :menuselection:`Removable Devices-->CD/DVD (IDE)-->Settings`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "On the :guilabel:`Device status` section, "
|
||||
#~ "uncheck the :guilabel:`Connected` and the "
|
||||
#~ ":guilabel:`Connect at power on` settings. "
|
||||
#~ "See Figure 11."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 11: VMware Workstation 14 Player - Disconnect CD/DVD"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To power off the VM, click the :guilabel:`Player` menu. See Figure 12."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 12: VMware Workstation 14 Player - Power off virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Power on the VM"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "After configuring the settings above, "
|
||||
#~ "power on your |CL| virtual machine."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "On the :guilabel:`VMware Workstation Player`"
|
||||
#~ " home screen, select your VM. See "
|
||||
#~ "Figure 13."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Figure 13: VMware Workstation 14 Player - Power on virtual machine"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
+115
-115
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -73,205 +73,172 @@ msgid ""
|
||||
"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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:41
|
||||
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:"
|
||||
"We also provide instructions for downloading and verifying a Clear Linux "
|
||||
"ISO. For more information, refer to :ref:`download-verify-decompress`."
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:47
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:49
|
||||
msgid ""
|
||||
"Under the :guilabel:`Navigator` window, select :guilabel:`Storage`. See "
|
||||
"Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:57
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:51
|
||||
msgid ""
|
||||
"Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore "
|
||||
"browser` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:64
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:58
|
||||
msgid "Figure 1: VMware ESXi - Navigator > Storage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:66
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:60
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:67
|
||||
msgid "Figure 2: VMware ESXi - Datastore > Create directory"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:75
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:69
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:76
|
||||
msgid "Figure 3: VMware ESXi - Datastore > Upload ISO"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:84
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:78
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:82
|
||||
msgid "Create and configure a new VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:90
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:84
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:87
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:89
|
||||
msgid "In the right window, click the :guilabel:`Create / Register VM` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:101
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:95
|
||||
msgid "Figure 4: VMware ESXi - Navigator > Virtual Machines"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:103
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:97
|
||||
msgid "On the :guilabel:`Select creation type` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:105
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:99
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:101
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:115
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:126
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:179
|
||||
msgid "Click the :guilabel:`Next` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:113
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:107
|
||||
msgid "Figure 5: VMware ESXi - Create a new virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:115
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:109
|
||||
msgid "On the :guilabel:`Select a name and guest OS` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:117
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:111
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:112
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:113
|
||||
msgid "Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:120
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:114
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:121
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:123
|
||||
msgid "On the :guilabel:`Select storage` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:131
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:125
|
||||
msgid "Accept the default option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:134
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:128
|
||||
msgid "On the :guilabel:`Customize settings` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:136
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:130
|
||||
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 7."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:137
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:131
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:138
|
||||
msgid "Figure 7: VMware ESXi - Enable hardware virtualization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:146
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:140
|
||||
msgid "Set :guilabel:`Memory` size to 2048MB (2GB). See Figure 8."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:152
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:146
|
||||
msgid "Figure 8: VMware ESXi - Set memory size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:156
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:150
|
||||
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 "
|
||||
@@ -279,21 +246,21 @@ msgid ""
|
||||
"128MB of RAM. See :ref:`system-requirements` for more details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:161
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:155
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:161
|
||||
msgid "Figure 9: VMware ESXi - Set hard disk size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:171
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:165
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:168
|
||||
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 "
|
||||
@@ -302,173 +269,173 @@ msgid ""
|
||||
"uploaded to the VMware server. See Figure 10."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:183
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:177
|
||||
msgid "Figure 10: VMware ESXi - Set CD/DVD to boot installer ISO"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:186
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:180
|
||||
msgid "Click the :guilabel:`Finish` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:189
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:183
|
||||
msgid "Install |CL| into the new VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:191
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:185
|
||||
msgid "Power on the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:193
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:187
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:189
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:190
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:270
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:191
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.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-install-cl.rst:204
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:198
|
||||
msgid "Figure 11: VMware ESXi - Navigator > Virtual Machines > Power on VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:206
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:200
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:202
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:206
|
||||
msgid "Reconfigure the VM's settings to boot the newly-installed |CL|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:214
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:208
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:212
|
||||
msgid "Power off the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:220
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:214
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:222
|
||||
msgid "Figure 12: VMware ESXi - Actions > Power off"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:230
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:224
|
||||
msgid "Edit the VM settings."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:232
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:226
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:233
|
||||
msgid "Figure 13: VMware ESXi - Actions > Edit settings"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:241
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:235
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:237
|
||||
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 14."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:244
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:238
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:245
|
||||
msgid "Figure 14: VMware ESXi - Disconnect the CD/DVD drive"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:253
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:247
|
||||
msgid "|CL| needs UEFI support in order to boot. Enable it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:255
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:249
|
||||
msgid "Click the :guilabel:`VM Options` button. See Figure 15."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:256
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:250
|
||||
msgid "Expand the :guilabel:`Boot Options` setting."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:257
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:251
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:258
|
||||
msgid "Figure 15: VMware ESXi - Set boot firmware to EFI"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:266
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:260
|
||||
msgid "Click the :guilabel:`Save` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:269
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:263
|
||||
msgid "Power on the VM and boot |CL|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:271
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:265
|
||||
msgid "After configuring the settings above, power on the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:273
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:267
|
||||
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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:269
|
||||
msgid "In the right window, select the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:284
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:278
|
||||
msgid "Figure 16: VMware ESXi - Navigator > Virtual Machines > Power on VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:287
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:281
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:289
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:283
|
||||
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
|
||||
msgstr ""
|
||||
|
||||
@@ -517,3 +484,36 @@ msgstr ""
|
||||
#~ msgid "Install steps:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Decompress the |CL| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Start a terminal emulator."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to the directory with the downloaded image."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To decompress an XZ image, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To decompress a GZ image, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "For alternative instructions on other operating systems, see:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-mac`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-windows`"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
+109
-109
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -75,135 +75,102 @@ msgid ""
|
||||
"|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
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:44
|
||||
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:"
|
||||
"We also provide instructions for downloading and verifying a Clear Linux "
|
||||
"ISO. For more information, refer to :ref:`download-verify-decompress`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:48
|
||||
msgid "For alternative instructions on other operating systems, see:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:50
|
||||
msgid ":ref:`download-verify-decompress-mac`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:51
|
||||
msgid ":ref:`download-verify-decompress-windows`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:54
|
||||
msgid "Upload the |CL| image to the VMware server"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:56
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:50
|
||||
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:60
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:54
|
||||
msgid ""
|
||||
"The steps in this section can also be referenced from the VMware "
|
||||
"documentation `Using Datastore File Browser in the VMware Host Client`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:63
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:57
|
||||
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:66
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:60
|
||||
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:70
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:64
|
||||
msgid ""
|
||||
"Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore "
|
||||
"browser` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:77
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:71
|
||||
msgid "Figure 1: VMware ESXi - Navigator > Storage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:79
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:73
|
||||
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:86
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:80
|
||||
msgid "Figure 2: VMware ESXi - Datastore > Create directory"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:88
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:82
|
||||
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:95
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:89
|
||||
msgid "Figure 3: VMware ESXi - Datastore > Upload VMware image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:97
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:91
|
||||
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:101
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:95
|
||||
msgid "Convert the |CL| image to an ESXi-supported format"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:103
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:97
|
||||
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:107
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:101
|
||||
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:109
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:103
|
||||
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:114
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:108
|
||||
msgid ""
|
||||
"If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or "
|
||||
":abbr:`vCLI (vSphere CLI)` configured and available, you can temporarily "
|
||||
@@ -211,258 +178,258 @@ msgid ""
|
||||
"`Enable the Secure Shell (SSH) in the VMware Host Client`_ ."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:118
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:112
|
||||
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:121
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:115
|
||||
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:124
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:118
|
||||
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:131
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:125
|
||||
msgid "Two files should result from this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:133
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:127
|
||||
msgid ":file:`clear-[version number]-esxi-flat.vmdk`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:134
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:128
|
||||
msgid ":file:`clear-[version number]-esxi.vmdk`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:136
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:130
|
||||
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:140
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:134
|
||||
msgid "Create and configure a new VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:142
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:136
|
||||
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:146
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:140
|
||||
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:149
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:143
|
||||
msgid "In the right window, click the :guilabel:`Create / Register VM` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:155
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:149
|
||||
msgid "Figure 4: VMware ESXi - Navigator > Virtual Machines"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:157
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:151
|
||||
msgid "On the :guilabel:`Select creation type` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:159
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:153
|
||||
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:162
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:179
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:190
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:261
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:156
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:173
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:184
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:255
|
||||
msgid "Click the :guilabel:`Next` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:168
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:162
|
||||
msgid "Figure 5: VMware ESXi - Create a new virtual machine"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:170
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:164
|
||||
msgid "On the :guilabel:`Select a name and guest OS` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:172
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:166
|
||||
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:174
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:168
|
||||
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:176
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:170
|
||||
msgid "Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:177
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:171
|
||||
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:185
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:179
|
||||
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:187
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:181
|
||||
msgid "On the :guilabel:`Select storage` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:189
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:183
|
||||
msgid "Accept the default option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:192
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:186
|
||||
msgid "On the :guilabel:`Customize settings` step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:194
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:188
|
||||
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 7."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:195
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:189
|
||||
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:203
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:197
|
||||
msgid "Figure 7: VMware ESXi - Enable hardware virtualization"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:205
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:199
|
||||
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:212
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:206
|
||||
msgid "Figure 8: VMware ESXi - Remove hard drive"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:214
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:208
|
||||
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:222
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:216
|
||||
msgid "Figure 9: VMware ESXi - Disconnect the CD/DVD drive"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:224
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:218
|
||||
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:227
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:221
|
||||
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:234
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:228
|
||||
msgid "Figure 10: VMware ESXi - Add an existing hard drive"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:236
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:230
|
||||
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:244
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:238
|
||||
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:247
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:241
|
||||
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:249
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:243
|
||||
msgid "Click the :guilabel:`VM Options` button. See Figure 12."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:250
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:244
|
||||
msgid "Expand the :guilabel:`Boot Options` setting."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:251
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:245
|
||||
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:258
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:252
|
||||
msgid "Figure 12: VMware ESXi - Set boot firmware to EFI"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:260
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:254
|
||||
msgid "Click the :guilabel:`Save` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:262
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:256
|
||||
msgid "Click the :guilabel:`Finish` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:265
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:259
|
||||
msgid "Power on the VM and boot |CL|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:267
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:261
|
||||
msgid "After configuring the settings above, power on the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:269
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:263
|
||||
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:271
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:265
|
||||
msgid "In the right window, select the newly-created VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:272
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:266
|
||||
msgid "Click the :guilabel:`Power on` button."
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:273
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:267
|
||||
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:280
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:274
|
||||
msgid "Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:283
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:277
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:285
|
||||
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:279
|
||||
msgid ":ref:`vmware-esxi-install-cl`"
|
||||
msgstr ""
|
||||
|
||||
@@ -518,3 +485,36 @@ msgstr ""
|
||||
#~ " Enable the Secure Shell (SSH)`_ ."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Decompress the |CL| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Start a terminal emulator."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Go to the directory with the downloaded image."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To decompress an XZ image, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "To decompress a GZ image, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "For alternative instructions on other operating systems, see:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-mac`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`download-verify-decompress-windows`"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,37 +24,45 @@ 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."
|
||||
"This guide describes deployment considerations and strategies when "
|
||||
"deploying |CL-ATTR| 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."
|
||||
#: ../../guides/deploy-at-scale.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:16
|
||||
msgid ""
|
||||
"This is not a replacement or blueprint for designing your own IT "
|
||||
"In this guide 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:21
|
||||
msgid ""
|
||||
"This guide is not a replacement or blueprint for designing your own IT "
|
||||
"operating environment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:19
|
||||
#: ../../guides/deploy-at-scale.rst:24
|
||||
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."
|
||||
"Implementation details for a scale deployment are beyond the scope of "
|
||||
"this guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:29
|
||||
msgid "Pick a |CL| usage and update strategy"
|
||||
#: ../../guides/deploy-at-scale.rst:27
|
||||
msgid ""
|
||||
"Your |CL| deployment should complement your existing environment and "
|
||||
"available tools. It is assumed core IT dependencies of your environment, "
|
||||
"such as your network, are healthy and scaled to suit the deployment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:31
|
||||
#: ../../guides/deploy-at-scale.rst:32
|
||||
msgid "Pick a usage and update strategy"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:34
|
||||
msgid ""
|
||||
"Different business scenarios call for different deployment methodologies."
|
||||
" |CL| offers the flexibility to continue consuming the upstream |CL| "
|
||||
@@ -62,56 +70,54 @@ msgid ""
|
||||
"act as your own :abbr:`OSV (Operating System Vendor)`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:36
|
||||
#: ../../guides/deploy-at-scale.rst:39
|
||||
msgid "Below is an overview of some considerations."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:39
|
||||
#: ../../guides/deploy-at-scale.rst:42
|
||||
msgid "Create your own Linux distribution (mix)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:41
|
||||
#: ../../guides/deploy-at-scale.rst:44
|
||||
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 "
|
||||
"own :abbr:`OSV (Operating System Vendor)` by leveraging the :ref:`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*."
|
||||
"customization*. Consider:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:47
|
||||
#: ../../guides/deploy-at-scale.rst:50
|
||||
msgid ""
|
||||
"Development systems that generate bundles and updates should have "
|
||||
"sufficient performance for the task and separate from the swupd update "
|
||||
"webservers that serve update content to production machines."
|
||||
"sufficient performance for the task and be separate from the swupd update"
|
||||
" webservers that serve update content to production machines."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:51
|
||||
#: ../../guides/deploy-at-scale.rst:54
|
||||
msgid ""
|
||||
"swupd update webservers that serve update content to production machines "
|
||||
"(see `mixer process`_ for more information) should be appropriately "
|
||||
"scaled."
|
||||
"should be appropriately scaled. Specific implementation details for a "
|
||||
"scalable, resilient web server are beyond the scope of this document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:55
|
||||
msgid ""
|
||||
"Your swupd update server is just like any other web application. |WEB-"
|
||||
"SERVER-SCALE|"
|
||||
#: ../../guides/deploy-at-scale.rst:58
|
||||
msgid "(See :ref:`mixer` for more information about update servers.)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:59
|
||||
#: ../../guides/deploy-at-scale.rst:61
|
||||
msgid "Adopt an agile methodology"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:60
|
||||
#: ../../guides/deploy-at-scale.rst:63
|
||||
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:63
|
||||
#: ../../guides/deploy-at-scale.rst:66
|
||||
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 "
|
||||
@@ -121,92 +127,92 @@ msgid ""
|
||||
" of software to your endpoints is an important prerequisite."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:70
|
||||
#: ../../guides/deploy-at-scale.rst:73
|
||||
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:73
|
||||
#: ../../guides/deploy-at-scale.rst:76
|
||||
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:76
|
||||
#: ../../guides/deploy-at-scale.rst:79
|
||||
msgid ""
|
||||
"Setup a path to production for building |CL| based images. At minimum "
|
||||
"this should include:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:79
|
||||
#: ../../guides/deploy-at-scale.rst:82
|
||||
msgid ""
|
||||
"A development clr-on-clr environment to test building packages and "
|
||||
"bundles for |CL| systems."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:82
|
||||
#: ../../guides/deploy-at-scale.rst:85
|
||||
msgid "A pre-production environment to deploy |CL| versions to before production"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:85
|
||||
#: ../../guides/deploy-at-scale.rst:88
|
||||
msgid ""
|
||||
"Employ a continuous integration and continuous deployment (CI/CD) "
|
||||
"philosophy in order to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:88
|
||||
#: ../../guides/deploy-at-scale.rst:91
|
||||
msgid ""
|
||||
"Automatically pull custom packages as they are updated from their "
|
||||
"upstream projects or vendors."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:91
|
||||
#: ../../guides/deploy-at-scale.rst:94
|
||||
msgid ""
|
||||
"Generate |CL| bundles and potentially bootable images with your "
|
||||
"customizations, if any."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:94
|
||||
#: ../../guides/deploy-at-scale.rst:97
|
||||
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:97
|
||||
#: ../../guides/deploy-at-scale.rst:100
|
||||
msgid ""
|
||||
"Integrate with your organization's governance processes, such as change "
|
||||
"control."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:101
|
||||
msgid "Versioning Infrastructure"
|
||||
#: ../../guides/deploy-at-scale.rst:104
|
||||
msgid "Versioning infrastructure"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:103
|
||||
#: ../../guides/deploy-at-scale.rst:106
|
||||
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:107
|
||||
#: ../../guides/deploy-at-scale.rst:109
|
||||
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:110
|
||||
#: ../../guides/deploy-at-scale.rst:112
|
||||
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:115
|
||||
#: ../../guides/deploy-at-scale.rst:117
|
||||
msgid "Pick an image distribution strategy"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:117
|
||||
#: ../../guides/deploy-at-scale.rst:119
|
||||
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 "
|
||||
@@ -214,56 +220,56 @@ msgid ""
|
||||
"automated installations or prebuilt images."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:122
|
||||
#: ../../guides/deploy-at-scale.rst:124
|
||||
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:126
|
||||
#: ../../guides/deploy-at-scale.rst:128
|
||||
msgid "See the available :ref:`image-types`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:128
|
||||
#: ../../guides/deploy-at-scale.rst:130
|
||||
msgid "Below are some common ways to install |CL| to systems at scale:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:131
|
||||
msgid "Baremetal"
|
||||
#: ../../guides/deploy-at-scale.rst:133
|
||||
msgid "Bare metal"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:133
|
||||
#: ../../guides/deploy-at-scale.rst:135
|
||||
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."
|
||||
" are one way to distribute |CL| to physical bare metal systems on a LAN."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:137
|
||||
#: ../../guides/deploy-at-scale.rst:138
|
||||
msgid ""
|
||||
"This option works well if your customizations are fairly small in size "
|
||||
"and infrastructure can be stateless."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:140
|
||||
#: ../../guides/deploy-at-scale.rst:141
|
||||
msgid ""
|
||||
"The |CL| `downloads page`_ offers a live image that can be deployed as a "
|
||||
"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:145
|
||||
msgid "Cloud Instances or Virtual Machines"
|
||||
#: ../../guides/deploy-at-scale.rst:146
|
||||
msgid "Cloud instances or virtual machines"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:147
|
||||
#: ../../guides/deploy-at-scale.rst:148
|
||||
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:151
|
||||
#: ../../guides/deploy-at-scale.rst:152
|
||||
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 "
|
||||
@@ -271,24 +277,24 @@ msgid ""
|
||||
"or moved between datacenters transparently."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:156
|
||||
#: ../../guides/deploy-at-scale.rst:157
|
||||
msgid ""
|
||||
"The |CL| `downloads page`_ offers example prebuilt VM images and is "
|
||||
"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:161
|
||||
#: ../../guides/deploy-at-scale.rst:162
|
||||
msgid "Containers"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:163
|
||||
#: ../../guides/deploy-at-scale.rst:164
|
||||
msgid ""
|
||||
"Containerization platforms allow images to be pulled from a repository "
|
||||
"and deployed repeatedly as isolated containers."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:166
|
||||
#: ../../guides/deploy-at-scale.rst:167
|
||||
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 "
|
||||
@@ -296,59 +302,59 @@ msgid ""
|
||||
"applications."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:171
|
||||
#: ../../guides/deploy-at-scale.rst:172
|
||||
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:176
|
||||
msgid "Considerations with stateless systems"
|
||||
" more information visit the `Containers`_ page."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:177
|
||||
msgid "Considerations with stateless systems"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:179
|
||||
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:182
|
||||
#: ../../guides/deploy-at-scale.rst:184
|
||||
msgid "Backup strategy"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:184
|
||||
#: ../../guides/deploy-at-scale.rst:186
|
||||
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:188
|
||||
#: ../../guides/deploy-at-scale.rst:190
|
||||
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:193
|
||||
msgid "Meaningful Logging & Telemetry"
|
||||
"areas like :file:`/home`, :file:`/etc`, and :file:`/var`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:195
|
||||
msgid "Meaningful logging & telemetry"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:197
|
||||
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:198
|
||||
#: ../../guides/deploy-at-scale.rst:200
|
||||
msgid ""
|
||||
"Remote syslogging in |CL| is available through the `systemd journal-"
|
||||
"remote service`_"
|
||||
"Remote syslogging in |CL| is available through the `systemd-journal-"
|
||||
"remote.service`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:201
|
||||
#: ../../guides/deploy-at-scale.rst:203
|
||||
msgid ""
|
||||
"|CL| offers a :ref:`telem-guide`, which can be a powerful tool for a "
|
||||
"large deployment to quickly crowdsource issues of interest. Take "
|
||||
@@ -357,33 +363,34 @@ msgid ""
|
||||
"appropriately."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:207
|
||||
#: ../../guides/deploy-at-scale.rst:209
|
||||
msgid ""
|
||||
"Your telemetry server is just like any other web application. |WEB-"
|
||||
"SERVER-SCALE|"
|
||||
"Like any web server, the telemetry server should be appropriately scaled "
|
||||
"and resilient. Specific implementation details for a scalable, resilient "
|
||||
"web server are beyond the scope of this document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:211
|
||||
msgid "Orchestration and Configuration Management"
|
||||
#: ../../guides/deploy-at-scale.rst:214
|
||||
msgid "Orchestration and configuration management"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:213
|
||||
#: ../../guides/deploy-at-scale.rst:216
|
||||
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:216
|
||||
#: ../../guides/deploy-at-scale.rst:219
|
||||
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`_ ."
|
||||
"configuration during deployment of |CL| endpoints see the :ref:`bulk-"
|
||||
"provision` guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:223
|
||||
#: ../../guides/deploy-at-scale.rst:226
|
||||
msgid ""
|
||||
"A configuration management tool is useful for maintaining consistent "
|
||||
"system and application-level configuration. Ansible\\* is offered through"
|
||||
@@ -391,11 +398,11 @@ msgid ""
|
||||
"automation tool."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:229
|
||||
#: ../../guides/deploy-at-scale.rst:232
|
||||
msgid "Cloud-native applications"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:231
|
||||
#: ../../guides/deploy-at-scale.rst:234
|
||||
msgid ""
|
||||
"An Infrastructure OS can design for good behavior, but it is ultimately "
|
||||
"up to applications to make agile design choices. Applications deployed on"
|
||||
@@ -403,7 +410,7 @@ msgid ""
|
||||
"run. References should be relative and dynamic when possible."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/deploy-at-scale.rst:236
|
||||
#: ../../guides/deploy-at-scale.rst:239
|
||||
msgid ""
|
||||
"The application architecture should incorporate an appropriate tolerance "
|
||||
"for infrastructure outages. Don't just keep stateless design as a noted "
|
||||
@@ -441,3 +448,155 @@ msgstr ""
|
||||
#~ " appropriately."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This is not a replacement or "
|
||||
#~ "blueprint for designing your own IT "
|
||||
#~ "operating environment."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Pick a |CL| usage and update strategy"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Development systems that generate bundles "
|
||||
#~ "and updates should have sufficient "
|
||||
#~ "performance for the task and separate"
|
||||
#~ " from the swupd update webservers "
|
||||
#~ "that serve update content to production"
|
||||
#~ " machines."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "swupd update webservers that serve "
|
||||
#~ "update content to production machines "
|
||||
#~ "(see `mixer process`_ for more "
|
||||
#~ "information) should be appropriately scaled."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Your swupd update server is just "
|
||||
#~ "like any other web application. |WEB-"
|
||||
#~ "SERVER-SCALE|"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Versioning Infrastructure"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Baremetal"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Cloud Instances or Virtual Machines"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Meaningful Logging & Telemetry"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Remote syslogging in |CL| is available"
|
||||
#~ " through the `systemd journal-remote "
|
||||
#~ "service`_"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Your telemetry server is just like "
|
||||
#~ "any other web application. |WEB-"
|
||||
#~ "SERVER-SCALE|"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Orchestration and Configuration Management"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -38,7 +38,11 @@ msgstr ""
|
||||
msgid "Network"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/guides.rst:33
|
||||
#: ../../guides/guides.rst:32
|
||||
msgid "Kernel"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/guides.rst:41
|
||||
msgid "Stacks"
|
||||
msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,28 +24,32 @@ msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:6
|
||||
msgid ""
|
||||
"This guide shows how to obtain and compile a Linux* kernel source using "
|
||||
"|CL-ATTR| development tooling."
|
||||
"This guide shows how to obtain and compile a Linux\\* kernel source using"
|
||||
" |CL-ATTR| development tooling."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:9
|
||||
#: ../../guides/kernel/kernel-development.rst:15
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:17
|
||||
msgid ""
|
||||
"The :ref:`compatible-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
|
||||
#: ../../guides/kernel/kernel-development.rst:21
|
||||
msgid ""
|
||||
"`Source RPMs (SRPMS)`_ are also available for all |CL| kernels, and can "
|
||||
"be used for development instead."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:22
|
||||
#: ../../guides/kernel/kernel-development.rst:25
|
||||
msgid "Request changes be included with the |CL| kernel"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:24
|
||||
#: ../../guides/kernel/kernel-development.rst:27
|
||||
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 "
|
||||
@@ -53,39 +57,41 @@ msgid ""
|
||||
"maintain your own modified kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:29
|
||||
msgid "Make enhancement requests to the |CL| `Distribution Project`_ on GitHub."
|
||||
#: ../../guides/kernel/kernel-development.rst:32
|
||||
msgid ""
|
||||
"Make enhancement requests to the |CL| `Distribution Project`_ on "
|
||||
"GitHub\\*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:32
|
||||
#: ../../guides/kernel/kernel-development.rst:35
|
||||
msgid "Set up kernel development environment"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:34
|
||||
#: ../../guides/kernel/kernel-development.rst:37
|
||||
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:37
|
||||
#: ../../guides/kernel/kernel-development.rst:40
|
||||
msgid "You can build and install a custom kernel; however you must:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:39
|
||||
#: ../../guides/kernel/kernel-development.rst:42
|
||||
msgid "Disable Secure Boot"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:40
|
||||
#: ../../guides/kernel/kernel-development.rst:43
|
||||
msgid "Maintain any updates to the kernel going forward"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:42
|
||||
#: ../../guides/kernel/kernel-development.rst:45
|
||||
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:47
|
||||
#: ../../guides/kernel/kernel-development.rst:50
|
||||
msgid "Install the |CL| development tooling framework"
|
||||
msgstr ""
|
||||
|
||||
@@ -138,47 +144,47 @@ msgstr ""
|
||||
msgid "This global setting is used by |CL| tools that make use of Git."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:54
|
||||
#: ../../guides/kernel/kernel-development.rst:57
|
||||
msgid "Clone the kernel package"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:55
|
||||
#: ../../guides/kernel/kernel-development.rst:59
|
||||
msgid ""
|
||||
"Clone the existing kernel package repository from |CL| as a starting "
|
||||
"point."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:57
|
||||
#: ../../guides/kernel/kernel-development.rst:61
|
||||
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`_ repo on GitHub."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:67
|
||||
#: ../../guides/kernel/kernel-development.rst:71
|
||||
msgid "Navigate into the cloned package directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:74
|
||||
#: ../../guides/kernel/kernel-development.rst:78
|
||||
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`_ repo on GitHub."
|
||||
"The \"linux\" package is the kernel that comes with |CL| in the :command"
|
||||
":`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`_ repo on GitHub."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:81
|
||||
#: ../../guides/kernel/kernel-development.rst:85
|
||||
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:85
|
||||
#: ../../guides/kernel/kernel-development.rst:90
|
||||
msgid "Change the kernel version"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:87
|
||||
#: ../../guides/kernel/kernel-development.rst:92
|
||||
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 "
|
||||
@@ -188,198 +194,198 @@ msgid ""
|
||||
"made manually."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:93
|
||||
#: ../../guides/kernel/kernel-development.rst:286
|
||||
#: ../../guides/kernel/kernel-development.rst:98
|
||||
#: ../../guides/kernel/kernel-development.rst:294
|
||||
msgid "Open the Linux kernel package RPM SPEC file in an editor."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:99
|
||||
#: ../../guides/kernel/kernel-development.rst:104
|
||||
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:102
|
||||
#: ../../guides/kernel/kernel-development.rst:107
|
||||
msgid ""
|
||||
"A list of current and available kernel release can be found on "
|
||||
"`kernel.org`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:121
|
||||
#: ../../guides/kernel/kernel-development.rst:126
|
||||
msgid ""
|
||||
"Consider changing the Name from *linux* in the RPM spec file to easily "
|
||||
"identify a modified kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:123
|
||||
#: ../../guides/kernel/kernel-development.rst:129
|
||||
msgid ""
|
||||
"Consider changing the ktarget from *native* in the RPM spec file to "
|
||||
"easily identify a modified kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:125
|
||||
#: ../../guides/kernel/kernel-development.rst:132
|
||||
msgid "Commit and save the changes to the file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:128
|
||||
#: ../../guides/kernel/kernel-development.rst:137
|
||||
msgid "Pull a copy of the Linux kernel source code"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:130
|
||||
#: ../../guides/kernel/kernel-development.rst:139
|
||||
msgid "Obtain a local copy of the source code to make modifications against."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:132
|
||||
#: ../../guides/kernel/kernel-development.rst:141
|
||||
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:140
|
||||
#: ../../guides/kernel/kernel-development.rst:149
|
||||
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:147
|
||||
#: ../../guides/kernel/kernel-development.rst:156
|
||||
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:156
|
||||
#: ../../guides/kernel/kernel-development.rst:165
|
||||
msgid "Customize the Linux kernel source"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:158
|
||||
#: ../../guides/kernel/kernel-development.rst:167
|
||||
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:163
|
||||
#: ../../guides/kernel/kernel-development.rst:172
|
||||
msgid "Modify kernel configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:165
|
||||
#: ../../guides/kernel/kernel-development.rst:174
|
||||
msgid ""
|
||||
"The kernel source has many configuration options available to pick "
|
||||
"support for different hardware and software features."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:167
|
||||
#: ../../guides/kernel/kernel-development.rst:177
|
||||
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:172
|
||||
#: ../../guides/kernel/kernel-development.rst:229
|
||||
#: ../../guides/kernel/kernel-development.rst:182
|
||||
#: ../../guides/kernel/kernel-development.rst:238
|
||||
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."
|
||||
"Make sure you have followed the steps to :ref:`pull-copy-kernel-source` "
|
||||
"and are in the kernel source working directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:177
|
||||
#: ../../guides/kernel/kernel-development.rst:186
|
||||
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:186
|
||||
#: ../../guides/kernel/kernel-development.rst:195
|
||||
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:189
|
||||
#: ../../guides/kernel/kernel-development.rst:198
|
||||
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:192
|
||||
#: ../../guides/kernel/kernel-development.rst:201
|
||||
msgid ""
|
||||
":command:`make config` - a text-based tool that asks questions one-by-one"
|
||||
" to decide configuration options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:195
|
||||
#: ../../guides/kernel/kernel-development.rst:204
|
||||
msgid ""
|
||||
":command:`make menuconfig` - a terminal user interface that provides "
|
||||
"menus to decide configuration options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:198
|
||||
#: ../../guides/kernel/kernel-development.rst:207
|
||||
msgid ""
|
||||
":command:`make xconfig` - a graphical user interface that provides tree "
|
||||
"views to decide configuration options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:202
|
||||
#: ../../guides/kernel/kernel-development.rst:211
|
||||
msgid ""
|
||||
"More configuration tools can be found by looking at the make help: "
|
||||
":command:`make help | grep config`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:205
|
||||
#: ../../guides/kernel/kernel-development.rst:214
|
||||
msgid "Commit and save the changes to the :file:`.config` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:207
|
||||
#: ../../guides/kernel/kernel-development.rst:216
|
||||
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:215
|
||||
#: ../../guides/kernel/kernel-development.rst:224
|
||||
msgid "Modify kernel source code"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:217
|
||||
#: ../../guides/kernel/kernel-development.rst:226
|
||||
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:220
|
||||
#: ../../guides/kernel/kernel-development.rst:229
|
||||
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:224
|
||||
#: ../../guides/kernel/kernel-development.rst:233
|
||||
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:234
|
||||
#: ../../guides/kernel/kernel-development.rst:242
|
||||
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:244
|
||||
#: ../../guides/kernel/kernel-development.rst:252
|
||||
msgid ""
|
||||
"Apply patches provided by the |CL| kernel package to the kernel source in"
|
||||
" the working directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:252
|
||||
#: ../../guides/kernel/kernel-development.rst:260
|
||||
msgid "Make any of your desired code changes to the Linux source code files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:255
|
||||
#: ../../guides/kernel/kernel-development.rst:263
|
||||
msgid "Track and commit your changes to the local git repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:263
|
||||
#: ../../guides/kernel/kernel-development.rst:271
|
||||
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`_"
|
||||
@@ -387,17 +393,17 @@ msgid ""
|
||||
"patch`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:272
|
||||
#: ../../guides/kernel/kernel-development.rst:280
|
||||
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:280
|
||||
#: ../../guides/kernel/kernel-development.rst:288
|
||||
msgid "Navigate back to the RPM build directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:292
|
||||
#: ../../guides/kernel/kernel-development.rst:300
|
||||
msgid ""
|
||||
"Locate the section of the SPEC file that contains existing patch variable"
|
||||
" definitions and append your patch file name. Ensure the patch number "
|
||||
@@ -405,104 +411,104 @@ msgid ""
|
||||
"is called :file:`2001-my-patch-for-driver-A.patch`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:315
|
||||
#: ../../guides/kernel/kernel-development.rst:323
|
||||
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:334
|
||||
#: ../../guides/kernel/kernel-development.rst:342
|
||||
msgid "Commit and save the changes to the RPM SPEC file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:337
|
||||
#: ../../guides/kernel/kernel-development.rst:345
|
||||
msgid "Modify kernel boot parameters"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:338
|
||||
#: ../../guides/kernel/kernel-development.rst:346
|
||||
msgid ""
|
||||
"The kernel boot options are passed from the bootloader to the kernel with"
|
||||
" command-line parameters."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:341
|
||||
#: ../../guides/kernel/kernel-development.rst:349
|
||||
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:346
|
||||
#: ../../guides/kernel/kernel-development.rst:354
|
||||
msgid "Open the kernel :file:`cmdline` file in an editor."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:353
|
||||
#: ../../guides/kernel/kernel-development.rst:361
|
||||
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:357
|
||||
#: ../../guides/kernel/kernel-development.rst:365
|
||||
msgid "Commit and save the changes to the :file:`cmdline` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:359
|
||||
#: ../../guides/kernel/kernel-development.rst:367
|
||||
msgid ""
|
||||
"See the `kernel parameters`_ documentation for a list of available "
|
||||
"parameters."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:363
|
||||
#: ../../guides/kernel/kernel-development.rst:371
|
||||
msgid "Build and install the kernel"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:364
|
||||
#: ../../guides/kernel/kernel-development.rst:372
|
||||
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:367
|
||||
#: ../../guides/kernel/kernel-development.rst:375
|
||||
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:370
|
||||
#: ../../guides/kernel/kernel-development.rst:378
|
||||
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:378
|
||||
#: ../../guides/kernel/kernel-development.rst:386
|
||||
msgid ""
|
||||
"The mock plugin `ccache`_ 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:383
|
||||
#: ../../guides/kernel/kernel-development.rst:391
|
||||
msgid ""
|
||||
"The result will be multiple :file:`.rpm` files in the :file:`rpms` "
|
||||
"directory as output."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:390
|
||||
#: ../../guides/kernel/kernel-development.rst:398
|
||||
msgid ""
|
||||
"The kernel RPM will be named "
|
||||
":file:`linux<NAME>-<VERSION>-<RELEASE>.x86_64.rpm`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:394
|
||||
#: ../../guides/kernel/kernel-development.rst:402
|
||||
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:397
|
||||
#: ../../guides/kernel/kernel-development.rst:405
|
||||
msgid ""
|
||||
"Alternatively, the kernel RPM bundle can be installed manually on a local"
|
||||
" machine for testing. This approach works well for individual development"
|
||||
@@ -510,29 +516,29 @@ msgid ""
|
||||
"using the :ref:`mixer` to provide a custom kernel with updates."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:402
|
||||
#: ../../guides/kernel/kernel-development.rst:410
|
||||
msgid ""
|
||||
"Install the kernel onto the local system by extracting the RPM with the "
|
||||
":command:`rpm2cpio` command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:410
|
||||
#: ../../guides/kernel/kernel-development.rst:418
|
||||
msgid "Update the |CL| boot manager using :command:`clr-boot-manager` and reboot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:420
|
||||
#: ../../guides/kernel/kernel-development.rst:428
|
||||
msgid "After a reboot, verify the customized kernel is running."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:427
|
||||
#: ../../guides/kernel/kernel-development.rst:435
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:429
|
||||
#: ../../guides/kernel/kernel-development.rst:437
|
||||
msgid ":ref:`kernel-modules`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-development.rst:430
|
||||
#: ../../guides/kernel/kernel-development.rst:438
|
||||
msgid ":ref:`mixer`"
|
||||
msgstr ""
|
||||
|
||||
@@ -604,3 +610,32 @@ msgstr ""
|
||||
#~ " reusing them."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This guide shows how to obtain and"
|
||||
#~ " compile a Linux* kernel source using"
|
||||
#~ " |CL-ATTR| development tooling."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Make enhancement requests to the |CL|"
|
||||
#~ " `Distribution Project`_ on GitHub."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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`_ repo on GitHub."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,6 +24,16 @@ msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:6
|
||||
msgid ""
|
||||
"This guide describes how to add kernel modules with :abbr:`DKMS (Dynamic "
|
||||
"Kernel Module System)`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:16
|
||||
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 "
|
||||
@@ -31,11 +41,11 @@ msgid ""
|
||||
"to :ref:`kernel-modules`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:16
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:22
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:18
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:24
|
||||
msgid ""
|
||||
"Kernel modules are additional pieces of software capable of being "
|
||||
"inserted into the Linux kernel to add functionality, such as a hardware "
|
||||
@@ -44,7 +54,7 @@ msgid ""
|
||||
" (out-of-tree)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:23
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:29
|
||||
msgid ""
|
||||
":abbr:`DKMS (Dynamic Kernel Module System)` is a framework that "
|
||||
"facilitates the building and installation of kernel modules. DKMS allows "
|
||||
@@ -94,46 +104,45 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:35
|
||||
msgid ""
|
||||
"Make enhancement requests to the |CL| `Distribution Project "
|
||||
"<https://github.com/clearlinux/distribution>`_ on GitHub."
|
||||
msgid "Make enhancement requests to the |CL| 'Distribution Project'_ on GitHub."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:37
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:38
|
||||
msgid "Install DKMS"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:41
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:42
|
||||
msgid ""
|
||||
"The *kernel-native-dkms* bundle provides the :command:`dkms` program and "
|
||||
"Linux kernel headers, which are required for compiling kernel modules."
|
||||
"The :command:`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:44
|
||||
msgid "The *kernel-native-dkms* bundle also:"
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:45
|
||||
msgid "The :command:`kernel-native-dkms` bundle also:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:46
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:47
|
||||
msgid ""
|
||||
"Adds a systemd update trigger (:file:`/usr/lib/systemd/system/dkms-new-"
|
||||
"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:51
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:52
|
||||
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:55
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:56
|
||||
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:60
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:61
|
||||
msgid ""
|
||||
"We recommend that you always review the :command:`swupd update` output to"
|
||||
" make sure kernel modules were successfully rebuilt against the new "
|
||||
@@ -173,71 +182,71 @@ msgstr ""
|
||||
msgid "Update the |CL| bootloader and reboot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:106
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:105
|
||||
msgid "Build, install, and load an out-of-tree module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:108
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:107
|
||||
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 :ref:`mixer` tool to provide a custom kernel and updates."
|
||||
" using :ref:`mixer` to provide a custom kernel and updates."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:115
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:113
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:117
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:115
|
||||
msgid "Before you begin, you must:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:119
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:117
|
||||
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:122
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:120
|
||||
msgid ""
|
||||
"Obtain a kernel module package in the form of source code and/or "
|
||||
"precompiled binaries."
|
||||
"Obtain a kernel module package in the form of source code or pre-compiled"
|
||||
" binaries."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:128
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:124
|
||||
msgid "Obtain kernel module source"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:130
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:126
|
||||
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:133
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:129
|
||||
msgid "Kernel modules may come packaged as:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:135
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:131
|
||||
msgid "Source code without a :file:`dkms.conf` file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:136
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:132
|
||||
msgid "Source code with a premade :file:`dkms.conf` file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:137
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:133
|
||||
msgid ""
|
||||
"Source code with a premade :file:`dkms.conf` file and precompiled module "
|
||||
"binaries"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:139
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:135
|
||||
msgid "Precompiled module binaries only (without source code)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:141
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:137
|
||||
msgid ""
|
||||
"Of the package types listed above, only precompiled kernel module "
|
||||
"binaries will not work, because |CL| requires kernel modules to be built "
|
||||
@@ -247,166 +256,166 @@ msgid ""
|
||||
"document."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:147
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:143
|
||||
msgid "Download the kernel module's source code."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:149
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:145
|
||||
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:152
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:148
|
||||
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:164
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:159
|
||||
msgid "Build kernel module with an existing dkms.conf"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:166
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:161
|
||||
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:170
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:165
|
||||
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:175
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:169
|
||||
msgid ""
|
||||
"Run the :command:`dkms ldtarball` command against the kernel module "
|
||||
"archive."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:182
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:177
|
||||
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:187
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:182
|
||||
msgid ""
|
||||
"Verify the kernel module is detected by checking the output of the "
|
||||
":command:`dkms status` command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:195
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:190
|
||||
msgid "Install the kernel module."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:204
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:197
|
||||
msgid "Build kernel module without an existing dkms.conf"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:206
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:199
|
||||
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:210
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:203
|
||||
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:214
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:207
|
||||
msgid "Here are some additional resources that can be used for reference:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:216
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:209
|
||||
msgid ""
|
||||
"DKMS manual page (:command:`man dkms`) shows detailed syntax in the "
|
||||
"DKMS.CONF section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:219
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:212
|
||||
msgid ""
|
||||
"Ubuntu community wiki entry for the `Kernel DKMS Package`_ shows an "
|
||||
"example where a single package contains multiple modules."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:222
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:215
|
||||
msgid "Sample `dkms.conf`_ file in the GitHub\\* repository for the DKMS project."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:226
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:219
|
||||
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:229
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:222
|
||||
msgid "The instructions below show a generic example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:231
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:224
|
||||
msgid ""
|
||||
"Create or modify the :file:`dkms.conf` file inside of the extracted "
|
||||
"source code directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:247
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:240
|
||||
msgid ""
|
||||
"This example identifies a kernel module named *custom_module* with "
|
||||
"version *1.0*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:250
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:243
|
||||
msgid "Copy the kernel module source code into the :file:`/usr/src/` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:259
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:252
|
||||
msgid ""
|
||||
"*<PACKAGE_NAME>* and *<PACKAGE_VERSION>* must match the entries in the "
|
||||
":file:`dkms.conf` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:263
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:255
|
||||
msgid "Add the kernel module to the DKMS tree so that it is tracked by DKMS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:269
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:261
|
||||
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:276
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:268
|
||||
msgid "Install the kernel module using DKMS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:285
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:275
|
||||
msgid "Load kernel module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:287
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:277
|
||||
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:290
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:280
|
||||
msgid "Load the installed module with the :command:`modprobe` command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:296
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:286
|
||||
msgid "Validate the kernel module is loaded."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:304
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:293
|
||||
msgid "Examples"
|
||||
msgstr ""
|
||||
|
||||
@@ -460,22 +469,22 @@ msgstr ""
|
||||
msgid "Learn more about module loading in the modules-load.d manual page:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:314
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:300
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:316
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:302
|
||||
msgid "`Dynamic Kernel Module System (DKMS)`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:318
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:304
|
||||
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:320
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:306
|
||||
msgid ""
|
||||
"`Linux Journal: Exploring Dynamic Kernel Module Support "
|
||||
"<https://www.linuxjournal.com/article/6896>`_"
|
||||
@@ -512,3 +521,45 @@ msgstr ""
|
||||
#~ "project on GitHub <https://github.com/dell/dkms>`_"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Make enhancement requests to the |CL|"
|
||||
#~ " `Distribution Project "
|
||||
#~ "<https://github.com/clearlinux/distribution>`_ on GitHub."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The *kernel-native-dkms* bundle provides"
|
||||
#~ " the :command:`dkms` program and Linux "
|
||||
#~ "kernel headers, which are required for"
|
||||
#~ " compiling kernel modules."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The *kernel-native-dkms* bundle also:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 :ref:`mixer` tool to"
|
||||
#~ " provide a custom kernel and updates."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Obtain a kernel module package in "
|
||||
#~ "the form of source code and/or "
|
||||
#~ "precompiled binaries."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -23,6 +23,14 @@ msgid "Add kernel modules manually"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:6
|
||||
msgid "This guide describes how to add kernel modules manually."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:13
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:15
|
||||
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"
|
||||
@@ -30,11 +38,11 @@ msgid ""
|
||||
"kernel modules manually, or refer to :ref:`kernel-modules-dkms`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:17
|
||||
#: ../../guides/kernel/kernel-modules.rst:21
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:19
|
||||
#: ../../guides/kernel/kernel-modules.rst:23
|
||||
msgid ""
|
||||
"Kernel modules are additional pieces of software capable of being "
|
||||
"inserted into the Linux kernel to add functionality, such as a hardware "
|
||||
@@ -43,11 +51,11 @@ msgid ""
|
||||
" (out-of-tree)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:28
|
||||
#: ../../guides/kernel/kernel-modules.rst:32
|
||||
msgid "Kernel module availability"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:30
|
||||
#: ../../guides/kernel/kernel-modules.rst:34
|
||||
msgid ""
|
||||
"|CL| comes with many upstream kernel modules available for use. Using an "
|
||||
"existing module is significantly easier to maintain and retains signature"
|
||||
@@ -55,17 +63,17 @@ msgid ""
|
||||
"practices, see the :ref:`security` page."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:35
|
||||
#: ../../guides/kernel/kernel-modules.rst:39
|
||||
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
|
||||
#: ../../guides/kernel/kernel-modules.rst:44
|
||||
msgid "Check if the module is already available"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:43
|
||||
#: ../../guides/kernel/kernel-modules.rst:47
|
||||
msgid ""
|
||||
"You can search for kernel module file names, which end with the "
|
||||
":file:`.ko` file extension, using the :command:`swupd search` command, as"
|
||||
@@ -73,28 +81,26 @@ msgid ""
|
||||
"information."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:53
|
||||
#: ../../guides/kernel/kernel-modules.rst:57
|
||||
msgid "Submit a request to add the module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:55
|
||||
#: ../../guides/kernel/kernel-modules.rst:59
|
||||
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 Project "
|
||||
"<https://github.com/clearlinux/distribution>`_ on GitHub."
|
||||
#: ../../guides/kernel/kernel-modules.rst:63
|
||||
msgid "Make enhancement requests to the |CL| 'Distribution Project'_ on GitHub."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:66
|
||||
#: ../../guides/kernel/kernel-modules.rst:69
|
||||
msgid "Build, install, and load an out-of-tree module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:68
|
||||
#: ../../guides/kernel/kernel-modules.rst:71
|
||||
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 "
|
||||
@@ -102,122 +108,122 @@ msgid ""
|
||||
" using the :ref:`mixer` to provide a custom kernel and updates."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:75
|
||||
#: ../../guides/kernel/kernel-modules.rst:78
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:77
|
||||
#: ../../guides/kernel/kernel-modules.rst:80
|
||||
msgid "Before you begin, you must:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:79
|
||||
#: ../../guides/kernel/kernel-modules.rst:82
|
||||
msgid "Disable Secure Boot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:80
|
||||
#: ../../guides/kernel/kernel-modules.rst:83
|
||||
msgid "Disable kernel module integrity checking."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:81
|
||||
#: ../../guides/kernel/kernel-modules.rst:84
|
||||
msgid "Have a kernel module package in the form of source code."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:82
|
||||
#: ../../guides/kernel/kernel-modules.rst:85
|
||||
msgid "Rebuild the module against new versions of the Linux kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:86
|
||||
#: ../../guides/kernel/kernel-modules.rst:89
|
||||
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:91
|
||||
#: ../../guides/kernel/kernel-modules.rst:94
|
||||
msgid "Build and install kernel module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:93
|
||||
#: ../../guides/kernel/kernel-modules.rst:96
|
||||
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:101
|
||||
#: ../../guides/kernel/kernel-modules.rst:104
|
||||
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:105
|
||||
msgid "`linux-dev` for developing against the native kernel."
|
||||
#: ../../guides/kernel/kernel-modules.rst:108
|
||||
msgid ":command:`linux-dev` for developing against the native kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:106
|
||||
msgid "`linux-lts-dev` for developing against the LTS kernel."
|
||||
#: ../../guides/kernel/kernel-modules.rst:109
|
||||
msgid ":command:`linux-lts-dev` for developing against the LTS kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:112
|
||||
#: ../../guides/kernel/kernel-modules.rst:115
|
||||
msgid ""
|
||||
"Follow instructions from the kernel module source code to compile the "
|
||||
"kernel module. For example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:125
|
||||
#: ../../guides/kernel/kernel-modules.rst:128
|
||||
msgid "Load kernel module"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:127
|
||||
#: ../../guides/kernel/kernel-modules.rst:130
|
||||
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:131
|
||||
#: ../../guides/kernel/kernel-modules.rst:134
|
||||
msgid ""
|
||||
"Disable signature checking for the kernel by modifying the kernel boot "
|
||||
"parameters and reboot the system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:134
|
||||
#: ../../guides/kernel/kernel-modules.rst:137
|
||||
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:143
|
||||
#: ../../guides/kernel/kernel-modules.rst:146
|
||||
msgid ""
|
||||
"Update the boot manager and reboot the system to implement the changed "
|
||||
"kernel parameters."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:153
|
||||
#: ../../guides/kernel/kernel-modules.rst:156
|
||||
msgid ""
|
||||
"If successful, the :command:`clr-boot-manager update` command does not "
|
||||
"return any console output."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:156
|
||||
#: ../../guides/kernel/kernel-modules.rst:159
|
||||
msgid ""
|
||||
"After rebooting, manually load out-of-tree modules using the "
|
||||
":command:`insmod` command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:164
|
||||
#: ../../guides/kernel/kernel-modules.rst:167
|
||||
msgid "Examples"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:169
|
||||
#: ../../guides/kernel/kernel-modules.rst:172
|
||||
msgid "Optional: Specify module options and aliases"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:171
|
||||
#: ../../guides/kernel/kernel-modules.rst:174
|
||||
msgid "Use the :command:`modprobe` command to load a module and set options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:173
|
||||
#: ../../guides/kernel/kernel-modules.rst:176
|
||||
msgid ""
|
||||
":command:`modprobe` may add or remove more than one module due to module "
|
||||
"interdependencies. You can specify which options to use with individual "
|
||||
@@ -225,7 +231,7 @@ msgid ""
|
||||
"directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:181
|
||||
#: ../../guides/kernel/kernel-modules.rst:184
|
||||
msgid ""
|
||||
"All files underneath the :file:`/etc/modprobe.d` directory that end with "
|
||||
"the :file:`.conf` extension specify module options to use when loading. "
|
||||
@@ -234,36 +240,36 @@ msgid ""
|
||||
"special requirements."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:186
|
||||
#: ../../guides/kernel/kernel-modules.rst:189
|
||||
msgid "Learn more about :command:`modprobe` on the modprobe.d manual page:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:193
|
||||
#: ../../guides/kernel/kernel-modules.rst:196
|
||||
msgid "Optional: Configure kernel modules to load at boot"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:195
|
||||
#: ../../guides/kernel/kernel-modules.rst:198
|
||||
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:202
|
||||
#: ../../guides/kernel/kernel-modules.rst:205
|
||||
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:206
|
||||
#: ../../guides/kernel/kernel-modules.rst:209
|
||||
msgid "Learn more about module loading in the modules-load.d manual page:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:216
|
||||
#: ../../guides/kernel/kernel-modules.rst:219
|
||||
msgid "Related topic"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules.rst:218
|
||||
#: ../../guides/kernel/kernel-modules.rst:221
|
||||
msgid ":ref:`kernel-modules-dkms`"
|
||||
msgstr ""
|
||||
|
||||
@@ -281,3 +287,15 @@ msgstr ""
|
||||
#~ "provide a custom kernel and updates."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Make enhancement requests to the |CL|"
|
||||
#~ " `Distribution Project "
|
||||
#~ "<https://github.com/clearlinux/distribution>`_ on GitHub."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`linux-dev` for developing against the native kernel."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`linux-lts-dev` for developing against the LTS kernel."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,115 +24,109 @@ 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"
|
||||
"This guide describes the basic, recommended infrastructure and workflow "
|
||||
"for maintaining a |CL-ATTR| derivative."
|
||||
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
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:16
|
||||
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
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:19
|
||||
msgid "Experience using :ref:`mixer <mixer>` to create a |CL|-based distro"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:31
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:21
|
||||
msgid ""
|
||||
"Experience using :ref:`swupd <swupd-guide>` for maintaining the |CL| "
|
||||
"build environment"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:34
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:24
|
||||
msgid "Familiarity with |CL| architecture and reuse of its content in releases"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:37
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:27
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:39
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:29
|
||||
msgid "Maintaining a |CL| derivative requires:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:31
|
||||
msgid "Monitoring upstream |CL| for new releases"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:32
|
||||
msgid "Building software packages and staging"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:33
|
||||
msgid "Employing CI/CD automation for building releases"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:34
|
||||
msgid "Integrating Quality Assurance for testing and validation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:36
|
||||
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."
|
||||
"parts: *Content Workflow*; and *Release Workflow*, shown in Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:49
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:44
|
||||
msgid "Figure 1: Architect the life-cycle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:52
|
||||
msgid "Content workflow"
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:47
|
||||
msgid "Content Workflow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:54
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:49
|
||||
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 "
|
||||
"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 "
|
||||
"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:63
|
||||
msgid "Release workflow"
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:58
|
||||
msgid "Release Workflow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:65
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:60
|
||||
msgid ""
|
||||
"The *Release Workflow* (Figure 1) gathers the content of the RPMs and "
|
||||
"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* "
|
||||
"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."
|
||||
"custom content. The Watcher Pipeline triggers the Release Pipeline to "
|
||||
"create new releases."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:74
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:69
|
||||
msgid "Implementation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:76
|
||||
#: ../../guides/maintenance/architect-lifecycle.rst:71
|
||||
msgid ""
|
||||
"Distro factory implements the *Release workflow*. To get started on a "
|
||||
"full implementation, visit |CL| `Distro Factory`_ documentation."
|
||||
"The |CL| Distro Factory manages the Release Workflow. For detailed "
|
||||
"information about Distro Factory deployment, refer to the `clr-distro-"
|
||||
"factory`_ GitHub\\* repo."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
@@ -142,3 +136,72 @@ msgstr ""
|
||||
#~ "factory documentation`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "This guide provides the foundation of the recommended infrastructure."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Content workflow"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Release workflow"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Distro factory implements the *Release "
|
||||
#~ "workflow*. To get started on a "
|
||||
#~ "full implementation, visit |CL| `Distro "
|
||||
#~ "Factory`_ documentation."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -22,12 +22,10 @@ msgstr ""
|
||||
msgid "Assign a static IP address"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:6
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:7
|
||||
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."
|
||||
"This guide explains how to assign a static IP address. This may be "
|
||||
"helpful in scenarios such as a network with no DHCP server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:15
|
||||
@@ -36,26 +34,26 @@ msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:17
|
||||
msgid ""
|
||||
"New installations of |CL| use NetworkManager as the default network "
|
||||
"New installations of |CL-ATTR| 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 "
|
||||
"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 "
|
||||
"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."
|
||||
"Before defining a configuration for assigning a static IP address, verify"
|
||||
" which program is managing the network interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:32
|
||||
@@ -67,28 +65,27 @@ 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."
|
||||
"the network configuration is being managed by NetworkManager, then use "
|
||||
"the instructions for :ref:`using NetworkManager <nm-static-ip>`."
|
||||
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"
|
||||
"If the STATE column for the device shows *unmanaged*, then check 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."
|
||||
"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."
|
||||
"configuration is being managed by `systemd-networkd`, then use the "
|
||||
"instructions for :ref:`using systemd-networkd <networkd-static-ip>`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:62
|
||||
@@ -124,7 +121,7 @@ msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:78
|
||||
msgid ""
|
||||
"The method below uses the command line tool *nmcli* to modify network "
|
||||
"The method below uses the command line tool nmcli to modify network "
|
||||
"connection."
|
||||
msgstr ""
|
||||
|
||||
@@ -133,20 +130,20 @@ msgid "Identify the existing connection name:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:88
|
||||
msgid "The output will look like this:"
|
||||
msgid "Sample output:"
|
||||
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`."
|
||||
"If a connection does not exist, create it with the :command:`nmcli "
|
||||
"connection add` command."
|
||||
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."
|
||||
"in brackets with the appropriate values. Replace *[CONNECTION_NAME]* with"
|
||||
" the NAME from the command above."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:112
|
||||
@@ -186,16 +183,16 @@ msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:144
|
||||
msgid ""
|
||||
"Create the :file:`/etc/systemd/network` directory if it doesn't exist "
|
||||
"already:"
|
||||
"Create the :file:`/etc/systemd/network` directory if it does not already "
|
||||
"exist:"
|
||||
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."
|
||||
" variables in brackets with the appropriate values. Replace "
|
||||
"*[INTERFACE_NAME]* with LINK from the output of the :command:`networkctl "
|
||||
"list` command that was run previously."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:168
|
||||
@@ -206,6 +203,116 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/assign-static-ip.rst:172
|
||||
msgid "Restart the systemd-networkd service:"
|
||||
msgid "Restart the `systemd-networkd` service:"
|
||||
msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "New installations of |CL| use "
|
||||
#~ "NetworkManager as the default network "
|
||||
#~ "interface manager for all network "
|
||||
#~ "connections."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The *cloud* |CL| images continue to "
|
||||
#~ "use systemd-networkd to manage network"
|
||||
#~ " connections."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "In earlier |CL| versions, systemd-"
|
||||
#~ "network was used to manage Ethernet "
|
||||
#~ "interfaces and NetworkManager was used "
|
||||
#~ "for wireless interfaces."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Before defining a configuration for "
|
||||
#~ "assigning a static IP address, you "
|
||||
#~ "should verify which program is managing"
|
||||
#~ " the network interface."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If the STATE column for the device"
|
||||
#~ " shows *unmanaged*, check to see if"
|
||||
#~ " the device is being managed by "
|
||||
#~ "systemd-networkd"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Check the output of :command:`networkctl "
|
||||
#~ "list` to see if systemd-networkd "
|
||||
#~ "is managing the device."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The method below uses the command "
|
||||
#~ "line tool *nmcli* to modify network "
|
||||
#~ "connection."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The output will look like this:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "If a connection does not exist, it"
|
||||
#~ " will need to be created with "
|
||||
#~ ":command:`nmcli connection add`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Create the :file:`/etc/systemd/network` directory"
|
||||
#~ " if it doesn't exist already:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Restart the systemd-networkd service:"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,36 +24,48 @@ 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**."
|
||||
"This guide explains how to perform a bulk provision of |CL-ATTR| using a "
|
||||
"combination of the |CL| installer, Ister, and :abbr:`ICIS (Ister Cloud "
|
||||
"Init Service)`."
|
||||
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."
|
||||
#: ../../guides/maintenance/bulk-provision.rst:15
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:17
|
||||
msgid "To configure a bulk provision:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:19
|
||||
msgid "Define Ister configuration files to customize the installation process"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:20
|
||||
msgid "Define cloud-init\\* files to customize the installation instance"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:21
|
||||
msgid ""
|
||||
"Host the configuration files in ICIS to allow Ister to use them during "
|
||||
"the installation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:24
|
||||
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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:30
|
||||
msgid "Figure 1: Bulk provision information flow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:26
|
||||
#: ../../guides/maintenance/bulk-provision.rst:33
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:28
|
||||
#: ../../guides/maintenance/bulk-provision.rst:35
|
||||
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 "
|
||||
@@ -61,76 +73,77 @@ msgid ""
|
||||
"address translation)` for details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:33
|
||||
#: ../../guides/maintenance/bulk-provision.rst:40
|
||||
msgid ""
|
||||
"Because a bulk provision relies on a reboot, ensure the following "
|
||||
"preparations have been made:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:36
|
||||
#: ../../guides/maintenance/bulk-provision.rst:43
|
||||
msgid "No existing disks are bootable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:37
|
||||
#: ../../guides/maintenance/bulk-provision.rst:44
|
||||
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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:48
|
||||
msgid "Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:43
|
||||
#: ../../guides/maintenance/bulk-provision.rst:50
|
||||
msgid ""
|
||||
"Install **ICIS** by following the getting started guide on the `ICIS`_ "
|
||||
"GitHub repository."
|
||||
"Install ICIS by following the getting started guide on the `ICIS`_ "
|
||||
"GitHub\\* repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:46
|
||||
#: ../../guides/maintenance/bulk-provision.rst:53
|
||||
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:"
|
||||
" 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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:92
|
||||
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."
|
||||
"Every Ister installation file hosted on ICIS must contain the the "
|
||||
"`IsterCloudInitSvc` parameter as well as the :command:`os-cloudguest` "
|
||||
"bundle. These entries allow Ister to customize an instance of of an "
|
||||
"install."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:90
|
||||
#: ../../guides/maintenance/bulk-provision.rst:97
|
||||
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:"
|
||||
"the web hosting directory of ICIS. The following example shows an Ister "
|
||||
"configuration file:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:99
|
||||
#: ../../guides/maintenance/bulk-provision.rst:106
|
||||
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:"
|
||||
"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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:121
|
||||
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."
|
||||
"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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:125
|
||||
msgid ""
|
||||
"Write a cloud-init document to customize the instance of the installation"
|
||||
" according to your requirements. The `cloud-init`_ documentation provides"
|
||||
@@ -138,62 +151,62 @@ msgid ""
|
||||
"customization options provided by cloud-init after an installation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:123
|
||||
#: ../../guides/maintenance/bulk-provision.rst:130
|
||||
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 "
|
||||
" 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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:134
|
||||
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:"
|
||||
"file in the :file:`static` directory within the web hosting directory of "
|
||||
"ICIS. The following example shows an example assignment:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:137
|
||||
#: ../../guides/maintenance/bulk-provision.rst:144
|
||||
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
|
||||
#: ../../guides/maintenance/bulk-provision.rst:153
|
||||
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|."
|
||||
#: ../../guides/maintenance/bulk-provision.rst:155
|
||||
msgid "http://192.168.1.1:60000/icis/static/ister/ister.conf"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:156
|
||||
msgid "Power-cycle the PXE client and watch it customize the |CL| installation."
|
||||
msgid "http://192.168.1.1:60000/icis/static/ister/ister.json"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:157
|
||||
msgid "http://192.168.1.1:60000/icis/get_config/<MAC address>"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:158
|
||||
msgid "http://192.168.1.1:60000/icis/get_role/<role>"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:159
|
||||
msgid "http://192.168.1.1:60000/ipxe/ipxe_boot_script.txt"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:161
|
||||
msgid "Power on the PXE client and watch it boot and install |CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:163
|
||||
msgid "Power-cycle the PXE client and watch it customize the |CL| installation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/bulk-provision.rst:165
|
||||
msgid ""
|
||||
"**Congratulations!** You have successfully performed a bulk provision of "
|
||||
"|CL|."
|
||||
@@ -216,3 +229,126 @@ msgstr ""
|
||||
#~ "by cloud-init after an installation."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Install **ICIS** by following the "
|
||||
#~ "getting started guide on the `ICIS`_ "
|
||||
#~ "GitHub repository."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/icis/static/ister/ister.conf``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/icis/static/ister/ister.json``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/icis/get_config/<MAC address>``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/icis/get_role/<role>``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``http://192.168.1.1:60000/ipxe/ipxe_boot_script.txt``"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -23,13 +23,21 @@ msgid "CPU Power and Performance"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:6
|
||||
msgid "This guide explains the CPU power and performance mechanisms in |CL-ATTR|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:13
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:15
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:18
|
||||
msgid ""
|
||||
"By default, |CL| prioritizes maximum CPU performance with the philosophy "
|
||||
"that the faster the program finishes execution, the faster the CPU can "
|
||||
@@ -38,45 +46,45 @@ msgid ""
|
||||
"changing the defaults."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:18
|
||||
#: ../../guides/maintenance/cpu-performance.rst:28
|
||||
msgid "CPU power saving mechanisms"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:20
|
||||
#: ../../guides/maintenance/cpu-performance.rst:30
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:37
|
||||
msgid "C-states (idle states)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:29
|
||||
#: ../../guides/maintenance/cpu-performance.rst:39
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:42
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:45
|
||||
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
|
||||
#: ../../guides/maintenance/cpu-performance.rst:49
|
||||
msgid "To view the current cpuidle driver run this command in a terminal:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:45
|
||||
#: ../../guides/maintenance/cpu-performance.rst:55
|
||||
msgid ""
|
||||
"For troubleshooting, C-states can be limited with a kernel command line "
|
||||
"boot parameter by adding :command:`processor.max_cstate=N "
|
||||
@@ -84,71 +92,71 @@ msgid ""
|
||||
":command:`idle=poll`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:51
|
||||
#: ../../guides/maintenance/cpu-performance.rst:61
|
||||
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:54
|
||||
#: ../../guides/maintenance/cpu-performance.rst:64
|
||||
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:60
|
||||
#: ../../guides/maintenance/cpu-performance.rst:70
|
||||
msgid "P-states (performance states)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:62
|
||||
#: ../../guides/maintenance/cpu-performance.rst:72
|
||||
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."
|
||||
"P-states, also known as *Intel SpeedStep® technology* 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:66
|
||||
#: ../../guides/maintenance/cpu-performance.rst:76
|
||||
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:69
|
||||
#: ../../guides/maintenance/cpu-performance.rst:79
|
||||
msgid ""
|
||||
"P-states can typically be limited or disabled in a system's firmware "
|
||||
"(UEFI/BIOS)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:72
|
||||
#: ../../guides/maintenance/cpu-performance.rst:82
|
||||
msgid "Turbo boost"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:74
|
||||
#: ../../guides/maintenance/cpu-performance.rst:84
|
||||
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 "
|
||||
"`Intel® 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:79
|
||||
#: ../../guides/maintenance/cpu-performance.rst:89
|
||||
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:82
|
||||
#: ../../guides/maintenance/cpu-performance.rst:92
|
||||
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:90
|
||||
#: ../../guides/maintenance/cpu-performance.rst:100
|
||||
msgid "Linux CPU clock frequency scaling"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:92
|
||||
#: ../../guides/maintenance/cpu-performance.rst:102
|
||||
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 "
|
||||
@@ -156,29 +164,29 @@ msgid ""
|
||||
"these states."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:98
|
||||
#: ../../guides/maintenance/cpu-performance.rst:108
|
||||
msgid "Scaling driver"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:100
|
||||
#: ../../guides/maintenance/cpu-performance.rst:110
|
||||
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."
|
||||
"Linux uses the `Intel P-state driver`_, :command:`intel_pstate`, for "
|
||||
"modern Intel processors from the Sandy Bridge generation or newer. Other "
|
||||
"processors may default to the :command:`acpi-cpufreq*` driver which reads"
|
||||
" values from the systems UEFI or BIOS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:105
|
||||
#: ../../guides/maintenance/cpu-performance.rst:115
|
||||
msgid ""
|
||||
"To view the current CPU frequency scaling driver run this command in a "
|
||||
"terminal:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:112
|
||||
#: ../../guides/maintenance/cpu-performance.rst:122
|
||||
msgid "Scaling governor"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:114
|
||||
#: ../../guides/maintenance/cpu-performance.rst:124
|
||||
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 "
|
||||
@@ -187,43 +195,43 @@ msgid ""
|
||||
"clock frequency without a workload."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:120
|
||||
#: ../../guides/maintenance/cpu-performance.rst:130
|
||||
msgid ""
|
||||
"To view the current CPU frequency scaling governor run this command in a "
|
||||
"terminal:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:126
|
||||
#: ../../guides/maintenance/cpu-performance.rst:136
|
||||
msgid "To change the CPU frequency scaling governor:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:128
|
||||
#: ../../guides/maintenance/cpu-performance.rst:138
|
||||
msgid "Disable |CL| enforcement of certain power and performance settings:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:134
|
||||
#: ../../guides/maintenance/cpu-performance.rst:144
|
||||
msgid ""
|
||||
"Change the governor. In the example below, the governor is set to "
|
||||
"*performance*:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:141
|
||||
#: ../../guides/maintenance/cpu-performance.rst:151
|
||||
msgid ""
|
||||
"The list of all governors can be found in the Linux kernel documentation "
|
||||
"on `CPUFreq Governors`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:146
|
||||
#: ../../guides/maintenance/cpu-performance.rst:156
|
||||
msgid ""
|
||||
"The intel_pstate driver only supports *performance* and *powersave* "
|
||||
"governors."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:149
|
||||
#: ../../guides/maintenance/cpu-performance.rst:159
|
||||
msgid "Thermal management"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:151
|
||||
#: ../../guides/maintenance/cpu-performance.rst:161
|
||||
msgid ""
|
||||
"`thermald`_ is a Linux thermal management daemon used to prevent the "
|
||||
"overheating of platforms. When temperature thresholds are exceeded, "
|
||||
@@ -231,28 +239,29 @@ msgid ""
|
||||
"available cooling methods. This can be especially desirable for laptops."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:156
|
||||
#: ../../guides/maintenance/cpu-performance.rst:166
|
||||
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:165
|
||||
#: ../../guides/maintenance/cpu-performance.rst:175
|
||||
msgid "For more information, see the thermald man page:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:171
|
||||
#: ../../guides/maintenance/cpu-performance.rst:181
|
||||
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:"
|
||||
"temperatures from thermald. To use ThermalMonitor, add the :command"
|
||||
":`desktop-apps-extras` bundle and add your user account to the power "
|
||||
"group:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/cpu-performance.rst:183
|
||||
#: ../../guides/maintenance/cpu-performance.rst:194
|
||||
msgid ""
|
||||
"After adding a new group you must log out and log back in for the new "
|
||||
"group to take affect."
|
||||
"After adding a new group, you must log out and log back in for the new "
|
||||
"group to take effect."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
@@ -261,3 +270,46 @@ msgstr ""
|
||||
#~ "documentation on CPUFreq Governors`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "After adding a new group you must"
|
||||
#~ " log out and log back in for"
|
||||
#~ " the new group to take affect."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,176 +24,263 @@ 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."
|
||||
"This guide helps you find the minimum set of bundles needed 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."
|
||||
"Before continuing, review the :ref:`swupd <swupd-guide>` guide to learn "
|
||||
"more about the swupd tool and how |CL| simplifies software versioning "
|
||||
"compared to other Linux\\* distributions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:15
|
||||
#: ../../guides/maintenance/developer-workstation.rst:18
|
||||
msgid "Workstation Setup"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:17
|
||||
#: ../../guides/maintenance/developer-workstation.rst:20
|
||||
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."
|
||||
"After installing the minimum set of bundles required to get started, you "
|
||||
"can add more bundles relevant to your specific use case."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:25
|
||||
#: ../../guides/maintenance/developer-workstation.rst:23
|
||||
msgid ""
|
||||
"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 to deploy a leaner OS "
|
||||
"with only bundles relevant to your project."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:28
|
||||
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."
|
||||
"your role may not neatly fit in one of these categories, consider Table 1"
|
||||
" as a starting point."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:30
|
||||
#: ../../guides/maintenance/developer-workstation.rst:33
|
||||
msgid "**Table 1. Developer Profiles**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:34
|
||||
#: ../../guides/maintenance/developer-workstation.rst:37
|
||||
msgid "|CL| Bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:35
|
||||
#: ../../guides/maintenance/developer-workstation.rst:38
|
||||
msgid "*Internet of Things (IoT)*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:36
|
||||
#: ../../guides/maintenance/developer-workstation.rst:39
|
||||
msgid "*System Administrator*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:37
|
||||
#: ../../guides/maintenance/developer-workstation.rst:40
|
||||
msgid "*Client/Cloud/Web Developer*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:39
|
||||
msgid "`editors`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:42
|
||||
msgid ":command:`editors`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:40
|
||||
#: ../../guides/maintenance/developer-workstation.rst:41
|
||||
#: ../../guides/maintenance/developer-workstation.rst:42
|
||||
#: ../../guides/maintenance/developer-workstation.rst:43
|
||||
#: ../../guides/maintenance/developer-workstation.rst:44
|
||||
#: ../../guides/maintenance/developer-workstation.rst:45
|
||||
#: ../../guides/maintenance/developer-workstation.rst:46
|
||||
#: ../../guides/maintenance/developer-workstation.rst:47
|
||||
#: ../../guides/maintenance/developer-workstation.rst:48
|
||||
#: ../../guides/maintenance/developer-workstation.rst:49
|
||||
#: ../../guides/maintenance/developer-workstation.rst:50
|
||||
#: ../../guides/maintenance/developer-workstation.rst:51
|
||||
#: ../../guides/maintenance/developer-workstation.rst:52
|
||||
#: ../../guides/maintenance/developer-workstation.rst:56
|
||||
#: ../../guides/maintenance/developer-workstation.rst:57
|
||||
#: ../../guides/maintenance/developer-workstation.rst:61
|
||||
#: ../../guides/maintenance/developer-workstation.rst:62
|
||||
#: ../../guides/maintenance/developer-workstation.rst:66
|
||||
#: ../../guides/maintenance/developer-workstation.rst:67
|
||||
#: ../../guides/maintenance/developer-workstation.rst:53
|
||||
#: ../../guides/maintenance/developer-workstation.rst:54
|
||||
#: ../../guides/maintenance/developer-workstation.rst:55
|
||||
#: ../../guides/maintenance/developer-workstation.rst:59
|
||||
#: ../../guides/maintenance/developer-workstation.rst:60
|
||||
#: ../../guides/maintenance/developer-workstation.rst:64
|
||||
#: ../../guides/maintenance/developer-workstation.rst:65
|
||||
#: ../../guides/maintenance/developer-workstation.rst:69
|
||||
#: ../../guides/maintenance/developer-workstation.rst:70
|
||||
#: ../../guides/maintenance/developer-workstation.rst:71
|
||||
#: ../../guides/maintenance/developer-workstation.rst:72
|
||||
#: ../../guides/maintenance/developer-workstation.rst:77
|
||||
#: ../../guides/maintenance/developer-workstation.rst:73
|
||||
#: ../../guides/maintenance/developer-workstation.rst:74
|
||||
#: ../../guides/maintenance/developer-workstation.rst:75
|
||||
#: ../../guides/maintenance/developer-workstation.rst:80
|
||||
msgid "✓"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:44
|
||||
msgid "`network-basic`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:47
|
||||
msgid ":command:`network-basic`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:49
|
||||
msgid "`openssh-server`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:52
|
||||
msgid ":command:`openssh-server`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:54
|
||||
msgid "`webserver-basic`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:57
|
||||
msgid ":command:`webserver-basic`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:59
|
||||
msgid "`application-server`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:62
|
||||
msgid ":command:`application-server`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:64
|
||||
msgid "`database-basic`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:67
|
||||
msgid ":command:`database-basic`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:69
|
||||
msgid "`desktop-autostart`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:72
|
||||
msgid ":command:`desktop-autostart`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:74
|
||||
msgid "`dev-utils`"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:77
|
||||
msgid ":command:`dev-utils`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:80
|
||||
msgid "`swupd` search"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:83
|
||||
msgid "swupd search"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:82
|
||||
#: ../../guides/maintenance/developer-workstation.rst:85
|
||||
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:85
|
||||
#: ../../guides/maintenance/developer-workstation.rst:88
|
||||
msgid ""
|
||||
"The guide provides an :ref:`example <swupd-guide-example-install-bundle>`"
|
||||
" that shows you how to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:88
|
||||
msgid "Use `swupd` to search for bundles"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:89
|
||||
msgid "Use `swupd` to add bundles"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:91
|
||||
msgid "Use swupd to search for bundles"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:92
|
||||
msgid "Use swupd to add bundles"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:95
|
||||
msgid "Core Concepts"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:94
|
||||
#: ../../guides/maintenance/developer-workstation.rst:97
|
||||
msgid ""
|
||||
"We recommend that you understand these core concepts in |CL| *before* "
|
||||
"developing your project."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:97
|
||||
msgid ":ref:`Bundles <bundles-about>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:98
|
||||
msgid ":ref:`Software update <swupd-about>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:99
|
||||
msgid ":ref:`Mixer <mixer-about>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:100
|
||||
msgid ":ref:`Autospec <autospec-about>`"
|
||||
msgid ":ref:`Software update <swupd-guide>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:103
|
||||
msgid "Other resources for developers"
|
||||
#: ../../guides/maintenance/developer-workstation.rst:101
|
||||
msgid ":ref:`Mixer <mixer>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:102
|
||||
msgid ":ref:`Autospec <autospec>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:105
|
||||
msgid "Other resources for developers"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:107
|
||||
msgid "`Developer Tooling Framework`_ for |CL|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/developer-workstation.rst:106
|
||||
#: ../../guides/maintenance/developer-workstation.rst:108
|
||||
msgid "`Bundle Definition Files`_"
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "`Bundle definition files`_"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "*Developer Workstation* helps you find "
|
||||
#~ "the :ref:`bundles-about` you need to "
|
||||
#~ "start your |CL-ATTR| development "
|
||||
#~ "project."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "`editors`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`network-basic`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`openssh-server`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`webserver-basic`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`application-server`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`database-basic`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`desktop-autostart`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`dev-utils`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "`swupd` search"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Use `swupd` to search for bundles"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Use `swupd` to add bundles"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`Bundles <bundles-about>`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`Software update <swupd-about>`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`Mixer <mixer-about>`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":ref:`Autospec <autospec-about>`"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -0,0 +1,349 @@
|
||||
# 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-22 12:54-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.rst:4
|
||||
msgid "Download, verify, and decompress a |CL-ATTR| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:6
|
||||
msgid ""
|
||||
"This guide describes the available types of |CL| images, where to "
|
||||
"download them, how to verify their integrity, and how to decompress them."
|
||||
" Follow the steps for your OS."
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:22
|
||||
msgid "Linux OS steps"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:27
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:86
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:131
|
||||
msgid "Verify the integrity of the |CL| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:29
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:88
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:133
|
||||
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.rst:34
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:93
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:138
|
||||
msgid "Download the corresponding SHA512 checksum file of your |CL| `image`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:35
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:61
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:94
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:114
|
||||
msgid "Open a Terminal."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:36
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:95
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:140
|
||||
msgid "Go to the directory with the downloaded image and checksum files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:37
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:96
|
||||
msgid ""
|
||||
"Verify the integrity of the image and compare it to its original checksum"
|
||||
" with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:44
|
||||
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.rst:49
|
||||
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.rst:55
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:108
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:151
|
||||
msgid "Decompress the |CL| image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:57
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:153
|
||||
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.rst:62
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:115
|
||||
msgid "Go to the directory with the downloaded image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:64
|
||||
msgid "To decompress an XZ image, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:70
|
||||
msgid "To decompress a GZ image, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:81
|
||||
msgid "macOS\\* steps"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:103
|
||||
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.rst:110
|
||||
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.rst:116
|
||||
msgid ""
|
||||
"Use the :command:`gunzip` command to decompress either compression type. "
|
||||
"For example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:126
|
||||
msgid "Windows\\* OS steps"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:139
|
||||
msgid "Start Command Prompt."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:141
|
||||
msgid "Get the SHA512 checksum of the image with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:147
|
||||
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.rst:157
|
||||
msgid "Download and install `7-Zip`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:158
|
||||
msgid "Go to the directory with the downloaded image and right-click it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:159
|
||||
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.rst:166
|
||||
msgid "Figure 1: Windows 7-Zip extract file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/download-verify-decompress.rst:171
|
||||
msgid "Image types"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:3
|
||||
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:6
|
||||
msgid "Table 1: Types of platform-independent |CL| images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:10 ../../reference/image-types.rst:23
|
||||
msgid "Image Type"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:11 ../../reference/image-types.rst:24
|
||||
msgid "Description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:13
|
||||
msgid "live-desktop.img or live-desktop.iso"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:14
|
||||
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:16
|
||||
msgid "live-server.img or live-server.iso"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:17
|
||||
msgid "Image for booting to server command prompt to preview or install the OS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:19
|
||||
msgid "Table 2: Types of platform-specific |CL| images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:26
|
||||
msgid "aws.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:27
|
||||
msgid "Image suitable for use with Amazon\\* AWS\\*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:29
|
||||
msgid "azure.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:30
|
||||
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:32
|
||||
msgid "azure-docker.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:33
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
|
||||
"Docker\\* pre-installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:35
|
||||
msgid "azure-machine-learning.vhd"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:36
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
|
||||
"`machine-learning-basic` bundle installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:38
|
||||
msgid "cloudguest.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:39
|
||||
msgid ""
|
||||
"Image with generic cloud guest virtual machine (VM) requirements "
|
||||
"installed."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:41
|
||||
msgid "gce.tar"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:42
|
||||
msgid "Image with the Google Compute Engine (GCE) specific kernel."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:44
|
||||
msgid "hyperv.vhdx"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:45
|
||||
msgid ""
|
||||
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
|
||||
"`optimized kernel`_ for Hyper-V."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:47
|
||||
msgid "kvm.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:48
|
||||
msgid ""
|
||||
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
|
||||
"kernel`_ for KVM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:51
|
||||
msgid "kvm-legacy.img"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:52
|
||||
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:54
|
||||
msgid "pxe.tar"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:55
|
||||
msgid "Image suitable for use with PXE server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:57
|
||||
msgid "vmware.vmdk"
|
||||
msgstr ""
|
||||
|
||||
#: ../../reference/image-types.rst:58
|
||||
msgid ""
|
||||
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
|
||||
"Workstation, and ESXi."
|
||||
msgstr ""
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,8 +24,8 @@ 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:"
|
||||
"This guide provides steps to complete the following basic setup tasks for"
|
||||
" a newly installed |CL-ATTR| system:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:14
|
||||
@@ -35,7 +35,7 @@ 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:"
|
||||
"following commands as a root user:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:24
|
||||
@@ -47,27 +47,27 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:30
|
||||
msgid "Add the new user to the `wheel` group"
|
||||
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>`."
|
||||
" 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`_."
|
||||
"<userid> to the `wheel group`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:38
|
||||
msgid "Add `<userid>` to the `wheel` group:"
|
||||
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>`."
|
||||
msgid "Log out of root and into the new <userid>."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:46
|
||||
@@ -75,11 +75,11 @@ 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."
|
||||
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>`."
|
||||
msgid "You will now be in the home directory of <userid>."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:53
|
||||
@@ -104,16 +104,16 @@ msgstr ""
|
||||
#: ../../guides/maintenance/enable-user-space.rst:67
|
||||
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."
|
||||
":command:`swupd bundle-add`. Experienced Linux users might compare swupd "
|
||||
"to running :command:`apt-get` or :command:`yum install` for package "
|
||||
"management. However |CL| manages packages at the level of bundles, which "
|
||||
"are integrated stacks of packages."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:73
|
||||
msgid ""
|
||||
"For example, the `sysadmin-basic` bundle installs the majority of "
|
||||
"applications useful to a system administrator. To install it, enter:"
|
||||
"For example, the :command:`sysadmin-basic` bundle installs the majority "
|
||||
"of applications useful to a system administrator. To install it, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/enable-user-space.rst:80
|
||||
@@ -161,3 +161,63 @@ msgstr ""
|
||||
#~ "deprecated."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This section provides steps to complete"
|
||||
#~ " the following basic setup tasks for"
|
||||
#~ " a newly installed |CL-ATTR| system:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "To create a new user and set "
|
||||
#~ "a password for that user, enter "
|
||||
#~ "the following commands as a `root` "
|
||||
#~ "user:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Add the new user to the `wheel` group"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Before logging off as root and "
|
||||
#~ "logging into your new user account, "
|
||||
#~ "enable the :command:`sudo` command for "
|
||||
#~ "your new `<userid>`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "To be able to execute all "
|
||||
#~ "applications with root privileges, add "
|
||||
#~ "the `<userid>` to the `wheel group`_."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Add `<userid>` to the `wheel` group:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Log out of root and into the new `<userid>`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Enter the new `<userid>` and the password created earlier."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "You will now be in the home directory of `<userid>`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For example, the `sysadmin-basic` bundle"
|
||||
#~ " installs the majority of applications "
|
||||
#~ "useful to a system administrator. To "
|
||||
#~ "install it, enter:"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -19,39 +19,48 @@ msgstr ""
|
||||
"Generated-By: Babel 2.7.0\n"
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:4
|
||||
msgid "Fix a broken installation of |CL-ATTR|"
|
||||
msgid "Fix a broken installation"
|
||||
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."
|
||||
"This guide explains how to fix a broken installation of |CL-ATTR| using a"
|
||||
" live desktop image on a USB."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:10
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:16
|
||||
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."
|
||||
"This guide assumes you have installed |CL| on a target system, but the OS"
|
||||
" does not boot or function properly."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:15
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:19
|
||||
msgid ""
|
||||
"The process described in this guide can only verify and fix files that "
|
||||
":ref:`swupd<swupd-guide>` owns in :file:`/usr`. Files outside of this "
|
||||
"path, such as :file:`/home/`, :file:`/etc`, :file:`/var`, etc., cannot be"
|
||||
" repaired by this process."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:25
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:17
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:27
|
||||
msgid ""
|
||||
":ref:`Download and install the live desktop image on a USB <bare-metal-"
|
||||
"install-desktop>`"
|
||||
"Download and install the live desktop image on a USB. See :ref:`bare-"
|
||||
"metal-install-desktop` for install instructions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:20
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:31
|
||||
msgid "Boot a live desktop image to fix target system"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:22
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:33
|
||||
msgid "Boot the |CL| live desktop image."
|
||||
msgstr ""
|
||||
|
||||
@@ -101,59 +110,96 @@ msgstr ""
|
||||
msgid "Figure 1: Clear Linux OS in boot menu"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:29
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:40
|
||||
msgid "Mount root partition, verify, and fix"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:31
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:42
|
||||
msgid "Open a Terminal window."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:33
|
||||
msgid "Assure the system is connected to the network."
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:44
|
||||
msgid "Ensure the system is connected to the network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:35
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:46
|
||||
msgid "Mount the system’s root partition."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:37
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:48
|
||||
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."
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:54
|
||||
msgid "We'll use :file:`/dev/sda3/` as the root partition example."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:45
|
||||
msgid "Next, mount the partition to the `/mnt` folder."
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:56
|
||||
msgid "Next, mount the partition to the :file:`/mnt` folder."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:51
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:62
|
||||
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
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:70
|
||||
msgid "Next, run swupd to fix any issues on the target system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:65
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:76
|
||||
msgid ":ref:`Learn more about how swupd works <swupd-guide>`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:67
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:78
|
||||
msgid "After the process is complete, unmount the root partition:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:73
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:84
|
||||
msgid ""
|
||||
"Reboot the system, remove the live desktop USB drive, and boot into the "
|
||||
"repaired system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:80
|
||||
#: ../../guides/maintenance/fix-broken-install.rst:91
|
||||
msgid "**Congratulations!** You successfully restored |CL|."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Fix a broken installation of |CL-ATTR|"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ ":ref:`Download and install the live "
|
||||
#~ "desktop image on a USB <bare-"
|
||||
#~ "metal-install-desktop>`"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Assure the system is connected to the network."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "We'll use `/dev/sda3/` as the root partition example."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Next, mount the partition to the `/mnt` folder."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -19,7 +19,7 @@ msgstr ""
|
||||
"Generated-By: Babel 2.7.0\n"
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:4
|
||||
msgid "Modify hostname on |CL-ATTR|"
|
||||
msgid "Modify hostname"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:6
|
||||
@@ -28,7 +28,11 @@ msgid ""
|
||||
"ATTR| system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:9
|
||||
#: ../../guides/maintenance/hostname.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:16
|
||||
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 "
|
||||
@@ -39,37 +43,37 @@ msgid ""
|
||||
"examples show human-friendly machine names:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:17
|
||||
#: ../../guides/maintenance/hostname.rst:24
|
||||
msgid "*regression-test*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:18
|
||||
#: ../../guides/maintenance/hostname.rst:25
|
||||
msgid "*sally-test-box1*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:19
|
||||
#: ../../guides/maintenance/hostname.rst:26
|
||||
msgid "*az-bldg2-lab*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:22
|
||||
#: ../../guides/maintenance/hostname.rst:29
|
||||
msgid "Set your hostname"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:24
|
||||
#: ../../guides/maintenance/hostname.rst:31
|
||||
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."
|
||||
"machine name. :command:`hostnamectl` is part of the :command:`os-core` "
|
||||
"bundle, which provides a basic Linux\\* user space and utilities."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:28
|
||||
#: ../../guides/maintenance/hostname.rst:35
|
||||
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
|
||||
#: ../../guides/maintenance/hostname.rst:46
|
||||
msgid ""
|
||||
"There are three types of hostname: *static*, *transient*, and *pretty*. "
|
||||
"The most common is the static hostname. Static hostnames must be between "
|
||||
@@ -77,34 +81,46 @@ msgid ""
|
||||
"and may contain letters (case-insensitive), numbers, dashes, or dots."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:44
|
||||
#: ../../guides/maintenance/hostname.rst:51
|
||||
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
|
||||
#: ../../guides/maintenance/hostname.rst:55
|
||||
msgid ""
|
||||
"The pretty hostname is a free-form UTF8 name used for presentation to the"
|
||||
" user."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:51
|
||||
#: ../../guides/maintenance/hostname.rst:58
|
||||
msgid "View your hostname"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:53
|
||||
#: ../../guides/maintenance/hostname.rst:60
|
||||
msgid "View your current hostname using the following command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:59
|
||||
#: ../../guides/maintenance/hostname.rst:66
|
||||
msgid "You should see output similar to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/hostname.rst:74
|
||||
#: ../../guides/maintenance/hostname.rst:81
|
||||
msgid ""
|
||||
"**Congratulations!** You successfully modified the hostname of your |CL| "
|
||||
"system."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Modify hostname on |CL-ATTR|"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -19,59 +19,60 @@ msgstr ""
|
||||
"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"
|
||||
msgid "Increase virtual disk size of an 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."
|
||||
"This guide describes how to increase the disk size of your prebuilt |CL-"
|
||||
"ATTR| 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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:14
|
||||
msgid "Determine the partition order and sizes of the prebuilt image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:15
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:16
|
||||
msgid ""
|
||||
"|CL| prebuilt images come in different sizes, ranging from 300 MB to 20 "
|
||||
"GB."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:19
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:22
|
||||
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 (/)"
|
||||
"with :file:`/dev/sda3` being the partition for the root filesystem (/)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:22
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:26
|
||||
msgid "Checking :command:`lsblk` on the VM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:24
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:28
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:35
|
||||
msgid "An example output of the :command:`lsblk` command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:41
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:45
|
||||
msgid "An example of this can also be seen in Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:44
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:48
|
||||
msgid "Checking :file:`config.json` used to build the image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:46
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:50
|
||||
msgid ""
|
||||
"The second method to determine partition to check the :file:`config.json`"
|
||||
" file used to create prebuilt image, located in the `releases`_ "
|
||||
@@ -79,167 +80,238 @@ msgid ""
|
||||
" number 20450, follow these steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:51
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:55
|
||||
msgid "Go to the `releases`_ repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:52
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:56
|
||||
msgid "Drill down into the `20450 > clear > config > image` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:53
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:57
|
||||
msgid "Open the :file:`hyperv-config.json` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:54
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:58
|
||||
msgid "Locate the `PartitionLayout` key."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:56
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:60
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:80
|
||||
msgid "Increase virtual disk size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:77
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:81
|
||||
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:"
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:85
|
||||
msgid "Power off VM and increase virtual disk size"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:83
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:87
|
||||
msgid ""
|
||||
"To increase the virtual disk size for a prebuilt image, perform the steps"
|
||||
" below:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:86
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:90
|
||||
msgid "Shut down your VM if it is running."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:87
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:91
|
||||
msgid ""
|
||||
"Use the process defined by your hypervisor or cloud provider to increase "
|
||||
"the virtual disk size of your |CL| VM."
|
||||
"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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:93
|
||||
msgid "Power up the VM."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:94
|
||||
msgid "Resize the partition of the virtual disk:"
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:97
|
||||
msgid "Resize the partition of the virtual disk"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:96
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:99
|
||||
msgid "Log in to an account with root privileges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:97
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:100
|
||||
msgid "Open a terminal emulator."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:98
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:101
|
||||
msgid ""
|
||||
"Add the |CL| `storage-utils` bundle to install the :command:`parted` and "
|
||||
":command:`resize2fs` tools."
|
||||
"Add the :command:`storage-utils` bundle to install the :command:`parted` "
|
||||
"and :command:`resize2fs` tools."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:105
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:108
|
||||
msgid "Launch the `parted` tool."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:111
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:114
|
||||
msgid "In the `parted` tool, perform these steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:113
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:116
|
||||
msgid "Press :command:`p` to print the partitions table."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:114
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:117
|
||||
msgid "If the warning message below is displayed, enter :command:`Fix`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:124
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:127
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:129
|
||||
msgid "Enter :command:`yes` when prompted."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:127
|
||||
msgid "Enter the new `End` size."
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:130
|
||||
msgid "Enter the new End size."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:131
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:134
|
||||
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."
|
||||
":command:`p` command, the total disk size is shown after the "
|
||||
":guilabel:`Disk` label."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:136
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:139
|
||||
msgid "An example of this can be seen in Figure 1."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:138
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:141
|
||||
msgid ""
|
||||
"Enter :command:`q` to exit `parted` when you are finished resizing the "
|
||||
"image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:141
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:144
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:150
|
||||
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`."
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:153
|
||||
msgid "Resize the filesystem"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:155
|
||||
msgid ""
|
||||
"Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where "
|
||||
"*[modified partition name]* is the partition that was changed in the "
|
||||
"`parted` tool."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:159
|
||||
msgid "Run the :command:`df -h` to verify that the filesystem size has increased."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:158
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:162
|
||||
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
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:169
|
||||
msgid "Figure 2: Increase root filesystem size after partition has been expanded."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:166
|
||||
#: ../../guides/maintenance/increase-virtual-disk-size.rst:171
|
||||
msgid ""
|
||||
"Congratulations! You have resized the disk, partition, and filesystem. At"
|
||||
" this point, the increase in disk capacity is usable."
|
||||
"**Congratulations!** You have resized the disk, partition, and "
|
||||
"filesystem. At this point, the increase in disk capacity is usable."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Increase virtual disk size of a |CL-ATTR| image"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "This guide will cover:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Power off VM and increase virtual disk size:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Use the process defined by your "
|
||||
#~ "hypervisor or cloud provider to increase"
|
||||
#~ " the virtual disk size of your "
|
||||
#~ "|CL| VM."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Resize the partition of the virtual disk:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Add the |CL| `storage-utils` bundle "
|
||||
#~ "to install the :command:`parted` and "
|
||||
#~ ":command:`resize2fs` tools."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Enter the new `End` size."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Resize the filesytem"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Enter :command:`sudo resize2fs -p "
|
||||
#~ "/dev/[modified partition name]` where "
|
||||
#~ "*[modified partition name]* is the "
|
||||
#~ "partition that was changed in `parted`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Congratulations! You have resized the "
|
||||
#~ "disk, partition, and filesystem. At this"
|
||||
#~ " point, the increase in disk capacity"
|
||||
#~ " is usable."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -0,0 +1,168 @@
|
||||
# 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-22 12:54-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/query-upstream.rst:4
|
||||
msgid "Query package info from upstream repository"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:6
|
||||
msgid ""
|
||||
"This guide describes how to query package information from the |CL| "
|
||||
"upstream repositories. This guide is intended for developers and advanced"
|
||||
" users."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:15
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:17
|
||||
msgid ""
|
||||
"In |CL-ATTR|, the :ref:`swupd<swupd-guide>` tool manages software "
|
||||
"dependencies and installs bundles instead of packages. Although a bundle "
|
||||
"is a collection of one or more packages, |CL| does not work with packages"
|
||||
" on the client side. However, on the upstream/factory side, |CL| does "
|
||||
"work with packages using a process called *mixing*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:23
|
||||
msgid ""
|
||||
"Currently, :command:`swupd` does not report which packages are installed,"
|
||||
" provide package version information, or return other package details. "
|
||||
"This guide describes a method for retrieving package information from the"
|
||||
" |CL| upstream repositories using :abbr:`DNF(Dandified Yum)` commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:29
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:31
|
||||
msgid ""
|
||||
"This guide assumes you have installed |CL| on your host system. For "
|
||||
"detailed instructions on installing |CL| on a bare metal system, visit "
|
||||
"the :ref:`bare metal installation guide <bare-metal-install-desktop>`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:35
|
||||
msgid ""
|
||||
"Before you install any new packages, update |CL| with the following "
|
||||
"command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:42
|
||||
msgid "Configure DNF"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:44
|
||||
msgid "Install the DNF bundle with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:50
|
||||
msgid "Create a :file:`dnf.conf` file with the commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:58
|
||||
msgid ""
|
||||
"Edit the :file:`/etc/dnf/dnf.conf` file and set the **baseurl** variable "
|
||||
"for binary and source RPMs as shown in lines 3 and 9 in the following "
|
||||
"example."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:78
|
||||
msgid "Initialize the RPM database with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:86
|
||||
msgid "DNF command usage examples"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:93
|
||||
msgid "List all binary and source RPMs in the current release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:95
|
||||
#: ../../guides/maintenance/query-upstream.rst:129
|
||||
#: ../../guides/maintenance/query-upstream.rst:150
|
||||
#: ../../guides/maintenance/query-upstream.rst:173
|
||||
#: ../../guides/maintenance/query-upstream.rst:196
|
||||
#: ../../guides/maintenance/query-upstream.rst:215
|
||||
msgid "Command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:101
|
||||
#: ../../guides/maintenance/query-upstream.rst:135
|
||||
#: ../../guides/maintenance/query-upstream.rst:156
|
||||
#: ../../guides/maintenance/query-upstream.rst:179
|
||||
#: ../../guides/maintenance/query-upstream.rst:202
|
||||
#: ../../guides/maintenance/query-upstream.rst:221
|
||||
msgid "Sample output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:125
|
||||
msgid "Show version information for a package in current release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:127
|
||||
msgid "This example queries version information for the zstd package."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:145
|
||||
msgid "Show version information for a package in a specific release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:147
|
||||
msgid ""
|
||||
"This example queries version information for the zstd package in release "
|
||||
"21000."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:168
|
||||
msgid ""
|
||||
"Show only version and release information for a package in a specific "
|
||||
"release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:170
|
||||
msgid ""
|
||||
"This example queries version and release information for the zstd package"
|
||||
" in release 15000."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:191
|
||||
msgid "Show the binary package for a specified binary file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:193
|
||||
msgid ""
|
||||
"This example returns the binary package that contains the "
|
||||
":file:`/usr/bin/zip` binary file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:210
|
||||
msgid "Show the source package for a specified binary file"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/query-upstream.rst:212
|
||||
msgid ""
|
||||
"This example returns the source package that contains the "
|
||||
":file:`/usr/bin/zip` binary file."
|
||||
msgstr ""
|
||||
|
||||
@@ -0,0 +1,237 @@
|
||||
# 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-22 12:54-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/restart.rst:4
|
||||
msgid "Restart system services after an OS update"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:6
|
||||
msgid "This guide describes how to use the :command:`clr-service-restart` tool."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:13
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:15
|
||||
msgid ""
|
||||
"|CL-ATTR| includes a :command:`clr-service-restart` tool that shows which"
|
||||
" system daemons require a restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:18
|
||||
msgid ""
|
||||
":command:`clr-service-restart` reads various files in the :file:`procfs` "
|
||||
"filesystem provided by the kernel and relies on :command:`systemd` to "
|
||||
"determine which services to restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:24
|
||||
msgid "How it works"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:26
|
||||
msgid ""
|
||||
":command:`clr-service-restart` implements a whitelist to identify which "
|
||||
"daemons can be restarted. As a system administrator, you can customize "
|
||||
"the default |CL| OS whitelist using :command:`allow` or "
|
||||
":command:`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."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:35
|
||||
msgid "Basic options"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:37
|
||||
msgid ""
|
||||
":command:`clr-service-restart` has three basic options: :command:`allow`,"
|
||||
" :command:`disallow`, and :command:`default`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:41
|
||||
msgid "allow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:43
|
||||
msgid ""
|
||||
"The :command:`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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:54
|
||||
msgid "disallow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:56
|
||||
msgid ""
|
||||
"The :command:`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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:68
|
||||
msgid "default"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:70
|
||||
msgid ""
|
||||
"The :command:`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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:81
|
||||
msgid "Monitor options"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:83
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:87
|
||||
msgid ""
|
||||
"If you pass both options (:command:`-a` and :command:`-n`) described "
|
||||
"below, :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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:94
|
||||
msgid "-n option"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:96
|
||||
msgid ""
|
||||
"The :command:`-n` 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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:100
|
||||
msgid "Which service needs a restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:101
|
||||
msgid "What unit it is."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:102
|
||||
msgid "Why it needs a restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:103
|
||||
msgid "Which command is required to restart the unit."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:106
|
||||
msgid "-a option"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:108
|
||||
msgid ""
|
||||
"The :command:`-a` 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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:114
|
||||
msgid "Example"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:116
|
||||
msgid ""
|
||||
"In the example below, :command:`clr-service-restart` is invoked with both"
|
||||
" the :command:`-a` and :command:`-n` options, which displays a complete "
|
||||
"list of system services that require a restart."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:120
|
||||
msgid "Command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:126
|
||||
msgid "Sample output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:138
|
||||
msgid "Telemetry"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:140
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:146
|
||||
msgid "If a unit fails to automatically restart after an OS update."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:147
|
||||
msgid ""
|
||||
"If that unit resides in the system location "
|
||||
":file:`/usr/lib/systemd/system`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:149
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:157
|
||||
msgid "Conclusion"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:159
|
||||
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 ""
|
||||
|
||||
#: ../../guides/maintenance/restart.rst:164
|
||||
msgid "https://github.com/clearlinux/clr-service-restart"
|
||||
msgstr ""
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -23,56 +23,72 @@ 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."
|
||||
"This guide describes how to reset the time in your |CL-ATTR| 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."
|
||||
#: ../../guides/maintenance/time.rst:9
|
||||
msgid "|CL| uses the `systemd-timesyncd.service` daemon to synchronize time."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:17
|
||||
#: ../../guides/maintenance/time.rst:12
|
||||
msgid "Install the :command:`sysadmin-basic` bundle."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:18
|
||||
msgid "Set your time zone. This example uses Los Angeles."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:25
|
||||
#: ../../guides/maintenance/time.rst:26
|
||||
msgid ""
|
||||
"To see a list of time zones, use the command: :command:`timedatectl list-"
|
||||
"timezones | grep <locale>`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:28
|
||||
#: ../../guides/maintenance/time.rst:29
|
||||
msgid "Create a :file:`/etc/systemd/` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:34
|
||||
#: ../../guides/maintenance/time.rst:35
|
||||
msgid ""
|
||||
"Create a new file named :file:`/etc/systemd/timesyncd.conf` and enter the"
|
||||
" following text."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:43
|
||||
#: ../../guides/maintenance/time.rst:44
|
||||
msgid "Enable the `systemd-timesyncd` service."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:51
|
||||
#: ../../guides/maintenance/time.rst:52
|
||||
msgid ""
|
||||
"To check the service status, use the :command:`timedatectl status` "
|
||||
"command."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:53
|
||||
#: ../../guides/maintenance/time.rst:54
|
||||
msgid ""
|
||||
"To restart the `timesyncd` daemon, enter :command:`systemctl restart "
|
||||
"systemd-timesyncd` into your terminal emulator."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/time.rst:56
|
||||
#: ../../guides/maintenance/time.rst:57
|
||||
msgid "**Congratulations!** You successfully set up the time in your |CL| system."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "|CL-ATTR| uses the `systemd-"
|
||||
#~ "timesyncd.service` daemon to synchronize time."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Install the `sysadmin-basic` bundle."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -22,121 +22,219 @@ msgstr ""
|
||||
msgid "Validate signatures"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:6
|
||||
#: ../../guides/maintenance/validate-signatures.rst:7
|
||||
msgid "This guide describes how to validate the contents of a |CL-ATTR| image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:16
|
||||
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 "
|
||||
"Validating the contents of an image is a manual process and is the same "
|
||||
"process that :ref:`swupd-guide` performs internally."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:19
|
||||
msgid ""
|
||||
"|CL| 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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:28
|
||||
msgid "Image content validation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:20
|
||||
#: ../../guides/maintenance/validate-signatures.rst:30
|
||||
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."
|
||||
"In the steps below, we used the installer image of the latest release of "
|
||||
"|CL|. You may use any image of |CL| you choose."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:23
|
||||
#: ../../guides/maintenance/validate-signatures.rst:33
|
||||
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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:45
|
||||
msgid "Generate the SHA256 sum of the |CL| certificate."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:41
|
||||
#: ../../guides/maintenance/validate-signatures.rst:51
|
||||
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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:58
|
||||
msgid "Generate the SHA512 sum of the image and save it to a file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:54
|
||||
#: ../../guides/maintenance/validate-signatures.rst:64
|
||||
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 "
|
||||
" |CL| certificate. This confirms that the image is trusted and has not "
|
||||
"been modified."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:64
|
||||
#: ../../guides/maintenance/validate-signatures.rst:115
|
||||
#: ../../guides/maintenance/validate-signatures.rst:74
|
||||
#: ../../guides/maintenance/validate-signatures.rst:125
|
||||
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."
|
||||
"The :command:`-purpose any` option is required when using OpenSSL 1.1. If"
|
||||
" you use an earlier version of OpenSSL, omit this option to perform "
|
||||
"signature validation. The :command:`openssl version` command may be used"
|
||||
" to determine the version of OpenSSL in use."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:69
|
||||
#: ../../guides/maintenance/validate-signatures.rst:79
|
||||
msgid ""
|
||||
"The output should contain ``Verification successful``. If the output "
|
||||
"contains ``bad_signature`` anywhere, then the image is not trustworthy."
|
||||
"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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:83
|
||||
msgid "Update content validation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:75
|
||||
#: ../../guides/maintenance/validate-signatures.rst:85
|
||||
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``."
|
||||
"**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 :command:`swupd update`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:80
|
||||
#: ../../guides/maintenance/validate-signatures.rst:90
|
||||
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."
|
||||
#: ../../guides/maintenance/validate-signatures.rst:102
|
||||
msgid "Generate the SHA256 sum of the swupd certificate."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:98
|
||||
#: ../../guides/maintenance/validate-signatures.rst:108
|
||||
msgid ""
|
||||
"Ensure the generated SHA256 sum of the Swupd certificate matches "
|
||||
"following SHA256 sum to verify the integrity of the certificate."
|
||||
"Confirm that the generated SHA256 sum of the swupd certificate matches "
|
||||
"the SHA256 sum shown below to verify the integrity of the certificate."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/maintenance/validate-signatures.rst:105
|
||||
#: ../../guides/maintenance/validate-signatures.rst:115
|
||||
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."
|
||||
"Confirm that 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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:132
|
||||
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
|
||||
#: ../../guides/maintenance/validate-signatures.rst:136
|
||||
msgid ""
|
||||
"The output should contain ``Verification successful``. If the output "
|
||||
"contains ``bad_signature`` anywhere, then the MoM cannot be trusted. "
|
||||
"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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The output should contain ``Verification "
|
||||
#~ "successful``. If the output contains "
|
||||
#~ "``bad_signature`` anywhere, then the image "
|
||||
#~ "is not trustworthy."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Generate the SHA256 sum of the Swupd certificate."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Ensure the generated SHA256 sum of "
|
||||
#~ "the Swupd certificate matches following "
|
||||
#~ "SHA256 sum to verify the integrity "
|
||||
#~ "of the certificate."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,154 +24,193 @@ 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."
|
||||
"This guide contains the steps to build a custom container image. The "
|
||||
"official base |CL-ATTR| container image is published on Docker\\* Hub and"
|
||||
" is updated on a regular basis."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:11
|
||||
#: ../../guides/network/custom-clear-container.rst:15
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:13
|
||||
#: ../../guides/network/custom-clear-container.rst:17
|
||||
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
|
||||
#: ../../guides/network/custom-clear-container.rst:20
|
||||
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
|
||||
#: ../../guides/network/custom-clear-container.rst:22
|
||||
msgid "You have a basic understanding of Docker."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:21
|
||||
#: ../../guides/network/custom-clear-container.rst:25
|
||||
msgid "Build the base container image"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:23
|
||||
#: ../../guides/network/custom-clear-container.rst:27
|
||||
msgid "Log in and get root privileges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:29
|
||||
#: ../../guides/network/custom-clear-container.rst:33
|
||||
msgid "Verify Docker is installed and running."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:35
|
||||
#: ../../guides/network/custom-clear-container.rst:39
|
||||
msgid "If Docker is installed and running, the output is similar to this example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:78
|
||||
#: ../../guides/network/custom-clear-container.rst:82
|
||||
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."
|
||||
#: ../../guides/network/custom-clear-container.rst:89
|
||||
msgid "Use :command:`os-install` to download and install the bundles."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:96
|
||||
msgid "The swupd example uses the following flags:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:98
|
||||
msgid ":command:`os-install` tells swupd to download and install."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:99
|
||||
msgid ":command:`-V / --version` specifies the version of the |CL| bundles."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:100
|
||||
msgid ":command:`--url` specifies the URL of the bundles repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:97
|
||||
#: ../../guides/network/custom-clear-container.rst:101
|
||||
msgid ""
|
||||
":command:`--statedir` specifies the state directory where downloaded "
|
||||
"bundles and any state information are stored."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:99
|
||||
#: ../../guides/network/custom-clear-container.rst:103
|
||||
msgid ""
|
||||
":command:`--no-boot-update` tells `swupd` to skip updating boot files "
|
||||
":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
|
||||
#: ../../guides/network/custom-clear-container.rst:106
|
||||
msgid ""
|
||||
"For more information on `swupd` flags, enter the :command:`swupd os-"
|
||||
"install -h` command."
|
||||
"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
|
||||
#: ../../guides/network/custom-clear-container.rst:109
|
||||
#: ../../guides/network/custom-clear-container.rst:172
|
||||
#: ../../guides/network/custom-clear-container.rst:199
|
||||
#: ../../guides/network/custom-clear-container.rst:233
|
||||
#: ../../guides/network/custom-clear-container.rst:295
|
||||
msgid "Example output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:141
|
||||
msgid "The `WARNING` message is expected and can be ignored."
|
||||
#: ../../guides/network/custom-clear-container.rst:146
|
||||
msgid "The WARNING message is expected and can be ignored."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:143
|
||||
#: ../../guides/network/custom-clear-container.rst:148
|
||||
msgid "Create a tarball and compress it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:150
|
||||
#: ../../guides/network/custom-clear-container.rst:155
|
||||
msgid "Create the Dockerfile to build the image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:161
|
||||
#: ../../guides/network/custom-clear-container.rst:166
|
||||
msgid "Build the |CL| container image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:188
|
||||
#: ../../guides/network/custom-clear-container.rst:193
|
||||
msgid "List the newly created |CL| container image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:201
|
||||
#: ../../guides/network/custom-clear-container.rst:206
|
||||
msgid "Launch the built |CL| container."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:208
|
||||
#: ../../guides/network/custom-clear-container.rst:213
|
||||
msgid "Manage bundles in a container"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:210
|
||||
#: ../../guides/network/custom-clear-container.rst:215
|
||||
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
|
||||
#: ../../guides/network/custom-clear-container.rst:219
|
||||
msgid "Add a bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:216
|
||||
#: ../../guides/network/custom-clear-container.rst:221
|
||||
msgid ""
|
||||
"This example Dockerfile adds the :file:`pxe-server` bundle to an existing"
|
||||
" |CL| Docker image:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:272
|
||||
#: ../../guides/network/custom-clear-container.rst:277
|
||||
msgid ""
|
||||
"The `WARNING` message can be ignored because systemd does not run inside "
|
||||
"a container."
|
||||
"The WARNING message can be ignored because systemd does not run inside a "
|
||||
"container."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:276
|
||||
#: ../../guides/network/custom-clear-container.rst:281
|
||||
msgid "Remove a bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/custom-clear-container.rst:278
|
||||
#: ../../guides/network/custom-clear-container.rst:283
|
||||
msgid ""
|
||||
"This example Dockerfile removes the :file:`pxe-server` bundle from an "
|
||||
"existing |CL| Docker image:"
|
||||
msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Use `os-install` to download and install the bundles."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The `swupd` example uses the following flags:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ":command:`os-install` tells `swupd` to download and install."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ ":command:`--no-boot-update` tells `swupd` "
|
||||
#~ "to skip updating boot files because "
|
||||
#~ "boot files are not required for a"
|
||||
#~ " container."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "For more information on `swupd` flags,"
|
||||
#~ " enter the :command:`swupd os-install "
|
||||
#~ "-h` command."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The `WARNING` message is expected and can be ignored."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The `WARNING` message can be ignored "
|
||||
#~ "because systemd does not run inside "
|
||||
#~ "a container."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -23,354 +23,415 @@ 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."
|
||||
msgid "This guide describes how to send packets between two platforms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:17
|
||||
#: ../../guides/network/dpdk.rst:13
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:15
|
||||
msgid ""
|
||||
"Figure 1 shows how to send packets between two platforms in a simple "
|
||||
"configuration. 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:24
|
||||
msgid "Figure 1: Environment for l3fwd DPDK application"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:19
|
||||
#: ../../guides/network/dpdk.rst:26
|
||||
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."
|
||||
msgid "pktgen: Traffic generator. See `pktgen`_ documentation for details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:29
|
||||
msgid "Both images must include the :file:`kernel-native bundle`."
|
||||
msgid ""
|
||||
"l3fwd: Layer 3 forwarding example application. See `l3fwd`_ documentation"
|
||||
" for details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:30
|
||||
msgid "Install the :file:`network-basic-dev` bundle with the command:"
|
||||
#: ../../guides/network/dpdk.rst:33
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:35
|
||||
msgid "Two platforms using |CL-ATTR| release `13330`_ or higher."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:36
|
||||
msgid "Both images must include the :command:`kernel-native` bundle."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:37
|
||||
msgid "Install the :command:`network-basic-dev` bundle with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:43
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:46
|
||||
msgid "Two network cables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:42
|
||||
#: ../../guides/network/dpdk.rst:49
|
||||
msgid "Install dpdk and build l3fwd example (Platform B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:44
|
||||
#: ../../guides/network/dpdk.rst:51
|
||||
msgid "Change to the :file:`l3fwd` example directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:50
|
||||
#: ../../guides/network/dpdk.rst:57
|
||||
msgid "Assign :envvar:`RTE_SDK` variable to the makefiles path."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:56
|
||||
#: ../../guides/network/dpdk.rst:63
|
||||
msgid ""
|
||||
"Assign :envvar:`RTE_TARGET` variable to the location of the gcc\\* config"
|
||||
" file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:63
|
||||
#: ../../guides/network/dpdk.rst:70
|
||||
msgid ""
|
||||
"Build the `l3fwd` application and add the configuration header to the "
|
||||
":makevar:`CFLAGS` variable."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:72
|
||||
#: ../../guides/network/dpdk.rst:79
|
||||
msgid "Build pktgen (Platform A)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:74
|
||||
#: ../../guides/network/dpdk.rst:81
|
||||
msgid "Download the `pktgen tar package`_ v3.1.2 or newer."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:76
|
||||
#: ../../guides/network/dpdk.rst:83
|
||||
msgid "Decompress packages and move to uncompressed source directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:78
|
||||
#: ../../guides/network/dpdk.rst:85
|
||||
msgid "Assign :envvar:`RTE_SDK` variable to the path where makefiles are located."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:84
|
||||
#: ../../guides/network/dpdk.rst:91
|
||||
msgid "Assign :envvar:`RTE_TARGET` to the location of the gcc config file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:90
|
||||
#: ../../guides/network/dpdk.rst:97
|
||||
msgid ""
|
||||
"Build the `pktgen` project and set the "
|
||||
":makevar:`CONFIG_RTE_BUILD_SHARED_LIB` variable to \"n\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:98
|
||||
#: ../../guides/network/dpdk.rst:105
|
||||
msgid "Bind NICs to DPDK kernel drivers (Platforms A and B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:100
|
||||
#: ../../guides/network/dpdk.rst:107
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:110
|
||||
msgid "Load the DPDK I/O kernel module."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:109
|
||||
#: ../../guides/network/dpdk.rst:116
|
||||
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."
|
||||
"another application is using them, the status shows \"Active\", and those"
|
||||
" NICs cannot be bound."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:117
|
||||
#: ../../guides/network/dpdk.rst:124
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:132
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:138
|
||||
msgid "Set hugepages (Platforms A and B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:133
|
||||
#: ../../guides/network/dpdk.rst:140
|
||||
msgid ""
|
||||
"|CL| supports `hugepages` for the large memory pool allocation used for "
|
||||
"packet buffers."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:136
|
||||
#: ../../guides/network/dpdk.rst:143
|
||||
msgid "Set the number of hugepages."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:142
|
||||
#: ../../guides/network/dpdk.rst:149
|
||||
msgid "Allocate pages on NUMA machines."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:149
|
||||
#: ../../guides/network/dpdk.rst:156
|
||||
msgid "Make memory available for DPDK."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:155
|
||||
#: ../../guides/network/dpdk.rst:162
|
||||
msgid ""
|
||||
"For more information, refer to the `DPDK guide`_ System Requirements "
|
||||
"section."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:160
|
||||
#: ../../guides/network/dpdk.rst:167
|
||||
msgid "Set up the physical environment (Platforms A and B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:162
|
||||
#: ../../guides/network/dpdk.rst:169
|
||||
msgid ""
|
||||
"Connect the NICs on Platform A to the NICs on Platform B using the "
|
||||
"network cables as shown in :ref:`Figure 2<f2>`."
|
||||
"network cables as shown in figure 2."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:169
|
||||
#: ../../guides/network/dpdk.rst:174
|
||||
msgid "Figure 2: Physical network environment"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:173
|
||||
#: ../../guides/network/dpdk.rst:178
|
||||
msgid "Run l3fwd application (Platform B)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:175
|
||||
#: ../../guides/network/dpdk.rst:180
|
||||
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`_."
|
||||
"NIC to another. For details, refer to the `l3fwd`_ documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:179
|
||||
#: ../../guides/network/dpdk.rst:184
|
||||
msgid "Open the l3fwd example directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:185
|
||||
#: ../../guides/network/dpdk.rst:190
|
||||
msgid "**This step is very important.**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:187
|
||||
#: ../../guides/network/dpdk.rst:192
|
||||
msgid "DPDK needs poll mode drivers to operate."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:188
|
||||
#: ../../guides/network/dpdk.rst:193
|
||||
msgid "Poll mode drivers are shared objects in :file:`/usr/lib64`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:189
|
||||
#: ../../guides/network/dpdk.rst:194
|
||||
msgid "See the full list of supported NICs at `dpdk.org NICs`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:190
|
||||
#: ../../guides/network/dpdk.rst:195
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:198
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:202
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:210
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:214
|
||||
msgid "Save the MAC address for configuring the `pktgen` project."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:212
|
||||
#: ../../guides/network/dpdk.rst:217
|
||||
msgid "Run pktgen application (Platform A)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:214
|
||||
#: ../../guides/network/dpdk.rst:219
|
||||
msgid "`pktgen` is a network traffic generator included in the DPDK."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:216
|
||||
#: ../../guides/network/dpdk.rst:221
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:229
|
||||
msgid "Enable active colorful output (optional)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:230
|
||||
#: ../../guides/network/dpdk.rst:235
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:242 ../../guides/network/dpdk.rst:301
|
||||
#: ../../guides/network/dpdk.rst:319
|
||||
msgid "Here is a working example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:244
|
||||
#: ../../guides/network/dpdk.rst:249
|
||||
msgid "Send packets."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:250
|
||||
msgid "For more details, see the `pktgen documentation`_."
|
||||
#: ../../guides/network/dpdk.rst:255
|
||||
msgid "For more details, see the `pktgen`_ documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:253
|
||||
#: ../../guides/network/dpdk.rst:258
|
||||
msgid "Appendix A: Use pass-through for virtual machines"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:255
|
||||
#: ../../guides/network/dpdk.rst:260
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:263
|
||||
msgid "Create a new directory and move to it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:260
|
||||
#: ../../guides/network/dpdk.rst:265
|
||||
msgid ""
|
||||
"Download or create a :file:`start_qemu.sh` script for running a kvm "
|
||||
"virtual machine:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:267
|
||||
#: ../../guides/network/dpdk.rst:272
|
||||
msgid "Download a bare-metal image of |CL| and rename it as :file:`clear.img`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:269
|
||||
#: ../../guides/network/dpdk.rst:274
|
||||
msgid "Look for an Ethernet\\* device entry that contains vendor and device ID:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:275
|
||||
#: ../../guides/network/dpdk.rst:280
|
||||
msgid "An example output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:281
|
||||
#: ../../guides/network/dpdk.rst:286
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:291
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:310
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:326
|
||||
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
|
||||
#: ../../guides/network/dpdk.rst:333
|
||||
msgid ""
|
||||
"Here is a working example for a virtual machine with 4096 memory and four"
|
||||
" CPUs:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:336
|
||||
#: ../../guides/network/dpdk.rst:341
|
||||
msgid "Each NUMA machine must use the same quantity of memory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/dpdk.rst:338
|
||||
#: ../../guides/network/dpdk.rst:343
|
||||
msgid "Run the :file:`start_qemu.sh` script."
|
||||
msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "pktgen: Traffic generator. See `pktgen documentation`_ for details."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "l3fwd: Layer 3 forwarding example "
|
||||
#~ "application. See `l3fwd documentation`_ for"
|
||||
#~ " details."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Both images must include the :file:`kernel-native bundle`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Install the :file:`network-basic-dev` bundle with the command:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "For more details, see the `pktgen documentation`_."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -19,23 +19,27 @@ msgstr ""
|
||||
"Generated-By: Babel 2.7.0\n"
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:4
|
||||
msgid "Install |CL-ATTR| over the network with iPXE"
|
||||
msgid "Install 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)`."
|
||||
"Execution Environment)` over the network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:9
|
||||
#: ../../guides/network/ipxe-install.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:16
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:20
|
||||
msgid ""
|
||||
"The PXE extension called `iPXE`_ adds support for additional protocols "
|
||||
"such as HTTP, :abbr:`iSCSI (Internet Small Computer Systems Interface)`, "
|
||||
@@ -44,117 +48,117 @@ msgid ""
|
||||
" PXE support."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:18
|
||||
#: ../../guides/network/ipxe-install.rst:25
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:31
|
||||
msgid "Figure 1: PXE information flow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:28
|
||||
#: ../../guides/network/ipxe-install.rst:35
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:40
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:35
|
||||
#: ../../guides/network/ipxe-install.rst:42
|
||||
msgid "Before booting with iPXE, make the following preparations."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:37
|
||||
#: ../../guides/network/ipxe-install.rst:44
|
||||
msgid ""
|
||||
"Connect the PXE server and PXE clients to a switch on a private network, "
|
||||
"as shown in Figure 2."
|
||||
"as shown in figure 2."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:43
|
||||
#: ../../guides/network/ipxe-install.rst:50
|
||||
msgid "Figure 2: Network topology."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:45
|
||||
#: ../../guides/network/ipxe-install.rst:52
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:55
|
||||
msgid "Your PXE server must have:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:50
|
||||
#: ../../guides/network/ipxe-install.rst:57
|
||||
msgid "Ethernet/LAN boot option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:51
|
||||
#: ../../guides/network/ipxe-install.rst:58
|
||||
msgid "At least two network adapters."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:52
|
||||
#: ../../guides/network/ipxe-install.rst:59
|
||||
msgid "Connection to a public network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:53
|
||||
#: ../../guides/network/ipxe-install.rst:60
|
||||
msgid "Secure boot option disabled."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:57
|
||||
#: ../../guides/network/ipxe-install.rst:64
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:69
|
||||
msgid "Configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:64
|
||||
#: ../../guides/network/ipxe-install.rst:71
|
||||
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`_."
|
||||
"`ister-cloud-init-svc`_ GitHub\\* repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:68
|
||||
#: ../../guides/network/ipxe-install.rst:76
|
||||
msgid "To set up |CL| manually, perform the steps below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:70
|
||||
#: ../../guides/network/ipxe-install.rst:78
|
||||
msgid "Define the variables used for iPXE boot configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:86
|
||||
#: ../../guides/network/ipxe-install.rst:94
|
||||
msgid "Log in and get root privilege."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:92
|
||||
#: ../../guides/network/ipxe-install.rst:100
|
||||
msgid ""
|
||||
"Add the `pxe-server` bundle to your |CL| system. The bundle contains all "
|
||||
"files needed to run a PXE server."
|
||||
"Add the :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:107
|
||||
msgid ""
|
||||
"Download the latest network-bootable release of |CL| and extract the "
|
||||
"files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:113
|
||||
#: ../../guides/network/ipxe-install.rst:121
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:125
|
||||
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 "
|
||||
@@ -162,38 +166,38 @@ msgid ""
|
||||
"ramdisk and kernel files."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:133
|
||||
#: ../../guides/network/ipxe-install.rst:141
|
||||
msgid ""
|
||||
"The `pxe-server` bundle contains a lightweight web-server known as "
|
||||
"`nginx`. Create a configuration file for `nginx` to serve |CL| to PXE "
|
||||
"The :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:163
|
||||
msgid ""
|
||||
"Create a separate `nginx` configuration file to serve network-bootable "
|
||||
"images on a non-standard port number. This action saves existing `nginx` "
|
||||
"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."
|
||||
#: ../../guides/network/ipxe-install.rst:167
|
||||
msgid "Start nginx and enable the startup on boot option."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:166
|
||||
#: ../../guides/network/ipxe-install.rst:174
|
||||
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`."
|
||||
"The :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:188
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:204
|
||||
msgid ""
|
||||
"Configure :abbr:`NAT (Network Address Translation)` to route traffic from"
|
||||
" the private network to the public network. This action makes the PXE "
|
||||
@@ -201,93 +205,93 @@ msgid ""
|
||||
"save the changes to the firewall with the following commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:212
|
||||
#: ../../guides/network/ipxe-install.rst:220
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:223
|
||||
msgid ""
|
||||
"Configure the kernel to forward network packets to different interfaces. "
|
||||
"Otherwise, NAT will not work."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:224
|
||||
#: ../../guides/network/ipxe-install.rst:232
|
||||
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 "
|
||||
"The :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:242
|
||||
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."
|
||||
"The :command:`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
|
||||
#: ../../guides/network/ipxe-install.rst:253
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:263
|
||||
msgid ""
|
||||
"Add the options to host a DHCP server for PXE clients to the `dnsmasq` "
|
||||
"configuration file."
|
||||
"Add the options to host a DHCP server for PXE clients to the "
|
||||
":file:`dnsmasq` configuration file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:277
|
||||
#: ../../guides/network/ipxe-install.rst:285
|
||||
msgid "The configuration provides the following important functions:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:279
|
||||
#: ../../guides/network/ipxe-install.rst:287
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:290
|
||||
msgid ""
|
||||
"Activates only on the network adapter that has an IP address on the "
|
||||
"defined subnet."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:284
|
||||
#: ../../guides/network/ipxe-install.rst:292
|
||||
msgid "Directs PXE clients to the DNS server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:285
|
||||
#: ../../guides/network/ipxe-install.rst:293
|
||||
msgid "Directs PXE clients to the PXE server for routing via NAT."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:286
|
||||
#: ../../guides/network/ipxe-install.rst:294
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:298
|
||||
msgid ""
|
||||
"Create a file for `dnsmasq` to record the IP addresses it provides to PXE"
|
||||
" clients."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:298
|
||||
#: ../../guides/network/ipxe-install.rst:306
|
||||
msgid "Start `dnsmasq` and enable startup on boot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:305
|
||||
#: ../../guides/network/ipxe-install.rst:313
|
||||
msgid "Start `systemd-resolved`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:313
|
||||
#: ../../guides/network/ipxe-install.rst:321
|
||||
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 "
|
||||
@@ -295,20 +299,107 @@ msgid ""
|
||||
":file:`/etc/resolv.conf`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:318
|
||||
#: ../../guides/network/ipxe-install.rst:326
|
||||
msgid "Power on the PXE client and watch the client boot and install |CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/ipxe-install.rst:320
|
||||
#: ../../guides/network/ipxe-install.rst:328
|
||||
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
|
||||
#: ../../guides/network/ipxe-install.rst:332
|
||||
msgid ""
|
||||
"**Congratulations!** You have successfully installed and configured a PXE"
|
||||
" server that enables PXE clients to boot and install |CL| over the "
|
||||
"network."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Install |CL-ATTR| over the network with iPXE"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This guide describes how to install "
|
||||
#~ "|CL-ATTR| using :abbr:`PXE (Pre-boot "
|
||||
#~ "Execution Environment)`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Connect the PXE server and PXE "
|
||||
#~ "clients to a switch on a private"
|
||||
#~ " network, as shown in Figure 2."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Add the `pxe-server` bundle to "
|
||||
#~ "your |CL| system. The bundle contains"
|
||||
#~ " all files needed to run a PXE"
|
||||
#~ " server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid "Start `nginx` and enable the startup on boot option."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Add the options to host a DHCP "
|
||||
#~ "server for PXE clients to the "
|
||||
#~ "`dnsmasq` configuration file."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -24,76 +24,80 @@ 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."
|
||||
"This guide describes how to configure systemd to use the "
|
||||
":command:`bonding` driver."
|
||||
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."
|
||||
"Network bonding combines multiple network interfaces into a single "
|
||||
"logical interface to provide redundancy and bandwidth aggregation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:12
|
||||
msgid "The example demonstrates how to:"
|
||||
msgid "|CL-ATTR| includes the Linux `Bonding driver`_ and `Team driver`_ ."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:14
|
||||
msgid "Bond all four ports of a quad-port NIC in `802.3ad` mode."
|
||||
msgid "The example demonstrates how to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:16
|
||||
msgid "Enable jumbo frames to optimize large data transfers on the local network."
|
||||
msgid "Bond all four ports of a quad-port NIC in 802.3ad mode."
|
||||
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."
|
||||
msgid "Enable jumbo frames to optimize large data transfers on the local network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:24
|
||||
msgid "You must run all commands in this guide as root."
|
||||
#: ../../guides/network/network-bonding.rst:20
|
||||
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:26
|
||||
msgid "You must run all commands in this guide as root."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:28
|
||||
msgid "Log in and get root privileges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:32
|
||||
#: ../../guides/network/network-bonding.rst:34
|
||||
msgid "Create the :file:`/etc/systemd/network` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:38
|
||||
#: ../../guides/network/network-bonding.rst:40
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:44
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:59
|
||||
msgid ""
|
||||
"Refer to the systemd.netdev_ manpage for :file:`30-bond1.netdev` file "
|
||||
"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
|
||||
#: ../../guides/network/network-bonding.rst:63
|
||||
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_."
|
||||
"virtual `bond1` device and use the syntax shown in `systemd.network`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:76
|
||||
#: ../../guides/network/network-bonding.rst:78
|
||||
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 "
|
||||
@@ -101,53 +105,96 @@ msgid ""
|
||||
"compatible, create a separate :file:`.network` file for each NIC."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:81
|
||||
#: ../../guides/network/network-bonding.rst:83
|
||||
msgid ""
|
||||
"For best results, do not assign addresses or DHCP support to the "
|
||||
"individual NICs."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:84
|
||||
#: ../../guides/network/network-bonding.rst:86
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:89
|
||||
msgid "Configure the bonded interface in a file named :file:`30-bond1.network`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:101
|
||||
#: ../../guides/network/network-bonding.rst:103
|
||||
msgid "`bond1` is a virtual interface with no physical link status."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:103
|
||||
#: ../../guides/network/network-bonding.rst:105
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:108
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:111
|
||||
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
|
||||
#: ../../guides/network/network-bonding.rst:115
|
||||
msgid "Apply the new network configuration with the command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/network/network-bonding.rst:119
|
||||
#: ../../guides/network/network-bonding.rst:121
|
||||
msgid ""
|
||||
"The `MTUBytes` settings do not take effect until you reboot or manually "
|
||||
"apply the settings with a utility such as `ifconfig`."
|
||||
"apply the settings with a utility such as ifconfig."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "|CL-ATTR| includes Linux bonding_ and"
|
||||
#~ " team_ drivers. This guide describes "
|
||||
#~ "how to configure systemd to use "
|
||||
#~ "the `bonding` driver."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Bond all four ports of a quad-port NIC in `802.3ad` mode."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The `MTUBytes` settings do not take "
|
||||
#~ "effect until you reboot or manually "
|
||||
#~ "apply the settings with a utility "
|
||||
#~ "such as `ifconfig`."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,151 @@
|
||||
# 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-22 12:54-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/stacks/dars.rst:4
|
||||
msgid "Data Analytics Reference Stack"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:6
|
||||
msgid ""
|
||||
"This guide explains how to use the :abbr:`DARS (Data Analytics Reference "
|
||||
"Stack)`, and to optionally build your own DARS container image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:9
|
||||
msgid ""
|
||||
"Any system that supports Docker\\* containers can be used with DARS. This"
|
||||
" steps in this guide use |CL-ATTR| as the host system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:17
|
||||
msgid "The Data Analytics Reference Stack release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:19
|
||||
msgid ""
|
||||
"The Data Analytics Reference Stack (DARS) provides developers and "
|
||||
"enterprises a straightforward, highly optimized software stack for "
|
||||
"storing and processing large amounts of data. More detail is available "
|
||||
"on the `DARS architecture and performance benchmarks`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:23
|
||||
msgid ""
|
||||
"The Data Analytics Reference Stack provides two pre-built Docker images, "
|
||||
"available on `Docker Hub`_:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:26
|
||||
msgid "A |CL|-derived `DARS with OpenBlas`_ stack optimized for `OpenBLAS`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:27
|
||||
msgid "A |CL|-derived `DARS with Intel® MKL`_ stack optimized for `MKL`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:29
|
||||
msgid ""
|
||||
"We recommend you view the latest component versions for each image in the"
|
||||
" :file:`README` found in the `Data Analytics Reference Stack`_ GitHub\\* "
|
||||
"repository. Because |CL| is a rolling distribution, the package version "
|
||||
"numbers in the |CL|-based containers may not be the latest released by "
|
||||
"|CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:36
|
||||
msgid ""
|
||||
"The Data Analytics Reference Stack is a collective work, and each piece "
|
||||
"of software within the work has its own license. Please see the `DARS "
|
||||
"Terms of Use`_ for more details about licensing and usage of the Data "
|
||||
"Analytics Reference Stack."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:42
|
||||
msgid "Using the Docker images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:44
|
||||
msgid ""
|
||||
"To immediately start using the latest stable DARS images, pull an image "
|
||||
"directly from `Docker Hub`_. This example uses the `DARS with Intel® "
|
||||
"MKL`_ Docker image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:48
|
||||
msgid "Once you have downloaded the image, you can run it with"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:54
|
||||
msgid ""
|
||||
"This will launch the image and drop you into a bash shell inside the "
|
||||
"container. You will see output similar to the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:75
|
||||
msgid ""
|
||||
"The :command:`--ulimit nofile` parameter is currently required in order "
|
||||
"to increase the number of open files opened at certain point by the spark"
|
||||
" engine."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:80
|
||||
msgid "Building DARS images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:82
|
||||
msgid ""
|
||||
"If you choose to build your own DARS container images, you can customize "
|
||||
"them as needed. Use the provided Dockerfile as a baseline."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:85
|
||||
msgid ""
|
||||
"To construct images with |CL|, start with a |CL| development platform "
|
||||
"that has the :command:`containers-basic-dev` bundle installed. Learn more"
|
||||
" about bundles and installing them by using :ref:`swupd-guide`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:89
|
||||
msgid "Clone the `Data Analytics Reference Stack`_ GitHub\\* repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:95
|
||||
msgid ""
|
||||
"Inside the DARS directory, run :command:`make` to build OpenBLAS and MKL "
|
||||
"images."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:101
|
||||
msgid ""
|
||||
"Run :command:`make baseline` to build the baseline CentOS image. "
|
||||
"Depending on the system, it may take a while to finish building."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:108
|
||||
msgid "Once completed, check the resulting images with :command:`Docker`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dars.rst:114
|
||||
msgid ""
|
||||
"You can use any of the resulting images to launch fully functional "
|
||||
"containers. If you need to customize the containers, you can edit the "
|
||||
"provided :file:`Dockerfile`."
|
||||
msgstr ""
|
||||
|
||||
@@ -0,0 +1,616 @@
|
||||
# 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-22 12:54-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/stacks/dlrs/dlrs.rst:4
|
||||
msgid "Deep Learning Reference Stack"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:6
|
||||
msgid ""
|
||||
"This guide describes how to run benchmarking workloads for TensorFlow\\*,"
|
||||
" PyTorch\\*, and Kubeflow in |CL-ATTR| using the Deep Learning Reference "
|
||||
"Stack."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:14
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:16
|
||||
msgid ""
|
||||
"We created the Deep Learning Reference Stack to help AI developers "
|
||||
"deliver the best experience on Intel® Architecture. This stack reduces "
|
||||
"complexity common with deep learning software components, provides "
|
||||
"flexibility for customized solutions, and enables you to quickly "
|
||||
"prototype and deploy Deep Learning workloads. Use this guide to run "
|
||||
"benchmarking workloads on your solution."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:23
|
||||
msgid "The Deep Learning Reference Stack is available in the following versions:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:25
|
||||
msgid ""
|
||||
"`Intel MKL-DNN-VNNI`_, which is optimized using Intel® Math Kernel "
|
||||
"Library for Deep Neural Networks (Intel® MKL-DNN) primitives and "
|
||||
"introduces support for Intel® AVX-512 Vector Neural Network Instructions "
|
||||
"(VNNI)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:28
|
||||
msgid ""
|
||||
"`Intel MKL-DNN`_, which includes the TensorFlow framework optimized using"
|
||||
" Intel® Math Kernel Library for Deep Neural Networks (Intel® MKL-DNN) "
|
||||
"primitives."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:31
|
||||
msgid "`Eigen`_, which includes `TensorFlow`_ optimized for Intel® architecture."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:32
|
||||
msgid "`PyTorch with OpenBLAS`_, which includes PyTorch with OpenBlas."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:33
|
||||
msgid ""
|
||||
"`PyTorch with Intel MKL-DNN`_, which includes PyTorch optimized using "
|
||||
"Intel® Math Kernel Library (Intel® MKL) and Intel MKL-DNN."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:38
|
||||
msgid ""
|
||||
"To take advantage of the Intel® AVX-512 and VNNI functionality with the "
|
||||
"Deep Learning Reference Stack, you must use the following hardware:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:41
|
||||
msgid "Intel® AVX-512 images require an Intel® Xeon® Scalable Platform"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:42
|
||||
msgid "VNNI requires a 2nd generation Intel® Xeon® Scalable Platform"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:45
|
||||
msgid "Stack features"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:47
|
||||
msgid "`DLRS V3.0`_ release announcement."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:48
|
||||
msgid "Deep Learning Reference Stack v2.0 including current `PyTorch benchmark`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:50
|
||||
msgid ""
|
||||
"Deep Learning Reference Stack v1.0 including current `TensorFlow "
|
||||
"benchmark`_ results."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:52
|
||||
msgid ""
|
||||
"`DLRS Release notes`_ on Github\\* for the latest release of Deep "
|
||||
"Learning Reference Stack."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:57
|
||||
msgid ""
|
||||
"The Deep Learning Reference Stack is a collective work, and each piece of"
|
||||
" software within the work has its own license. Please see the `DLRS "
|
||||
"Terms of Use`_ for more details about licensing and usage of the Deep "
|
||||
"Learning Reference Stack."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:62
|
||||
msgid "Prerequisites"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:64
|
||||
msgid ":ref:`Install <bare-metal-install-desktop>` |CL| on your host system"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:65
|
||||
msgid ":command:`containers-basic` bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:66
|
||||
msgid ":command:`cloud-native-basic` bundle"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:68
|
||||
msgid ""
|
||||
"In |CL|, :command:`containers-basic` includes Docker\\*, which is "
|
||||
"required for TensorFlow and PyTorch benchmarking. Use the "
|
||||
":command:`swupd` utility to check if :command:`containers-basic` and "
|
||||
":command:`cloud-native-basic` are present:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:77
|
||||
msgid ""
|
||||
"To install the :command:`containers-basic` or :command:`cloud-native-"
|
||||
"basic` bundles, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:84
|
||||
msgid ""
|
||||
"Docker is not started upon installation of the :command:`containers-"
|
||||
"basic` bundle. To start Docker, enter:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:91
|
||||
msgid ""
|
||||
"To ensure that Kubernetes is correctly installed and configured, follow "
|
||||
"the instructions in :ref:`kubernetes`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:95
|
||||
msgid "Version compatibility"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:97
|
||||
msgid "We validated these steps against the following software package versions:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:99
|
||||
msgid "|CL| 26240 (Minimum supported version)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:100
|
||||
msgid "Docker 18.06.1"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:101
|
||||
msgid "Kubernetes 1.11.3"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:102
|
||||
msgid "Go 1.11.12"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:107
|
||||
msgid ""
|
||||
"The Deep Learning Reference Stack was developed to provide the best user "
|
||||
"experience when executed on a |CL| host. However, as the stack runs in a"
|
||||
" container environment, you should be able to complete the following "
|
||||
"sections of this guide on other Linux* distributions, provided they "
|
||||
"comply with the Docker*, Kubernetes* and Go* package versions listed "
|
||||
"above. Look for your distribution documentation on how to update packages"
|
||||
" and manage Docker services."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:112
|
||||
msgid "TensorFlow single and multi-node benchmarks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:114
|
||||
msgid ""
|
||||
"This section describes running the `TensorFlow Benchmarks`_ in single "
|
||||
"node. For multi-node testing, replicate these steps for each node. These "
|
||||
"steps provide a template to run other benchmarks, provided that they can "
|
||||
"invoke TensorFlow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:121
|
||||
msgid ""
|
||||
"Performance test results for the Deep Learning Reference Stack and for "
|
||||
"this guide were obtained using `runc` as the runtime."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:124
|
||||
msgid ""
|
||||
"Download either the `Eigen`_ or the `Intel MKL-DNN`_ Docker image from "
|
||||
"`Docker Hub`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:127 ../../guides/stacks/dlrs/dlrs.rst:169
|
||||
msgid "Run the image with Docker:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:136 ../../guides/stacks/dlrs/dlrs.rst:177
|
||||
msgid ""
|
||||
"Launching the Docker image with the :command:`-i` argument starts "
|
||||
"interactive mode within the container. Enter the following commands in "
|
||||
"the running container."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:140
|
||||
msgid "Clone the benchmark repository in the container:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:146 ../../guides/stacks/dlrs/dlrs.rst:187
|
||||
msgid "Execute the benchmark script:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:154
|
||||
msgid ""
|
||||
"You can replace the model with one of your choice supported by the "
|
||||
"TensorFlow benchmarks."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:157
|
||||
msgid ""
|
||||
"If you are using an FP32 based model, it can be converted to an int8 "
|
||||
"model using `Intel® quantization tools`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:161
|
||||
msgid "PyTorch single and multi-node benchmarks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:163
|
||||
msgid ""
|
||||
"This section describes running the `PyTorch benchmarks`_ for Caffe2 in "
|
||||
"single node."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:166
|
||||
msgid ""
|
||||
"Download either the `PyTorch with OpenBLAS`_ or the `PyTorch with Intel "
|
||||
"MKL-DNN`_ Docker image from `Docker Hub`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:181
|
||||
msgid "Clone the benchmark repository:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:197
|
||||
msgid "Kubeflow multi-node benchmarks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:199
|
||||
msgid ""
|
||||
"The benchmark workload runs in a Kubernetes cluster. The guide uses "
|
||||
"`Kubeflow`_ for the Machine Learning workload deployment on three nodes."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:204
|
||||
msgid ""
|
||||
"If you choose the Intel® MKL-DNN or Intel® MKL-DNN-VNNI image, your "
|
||||
"platform must support the Intel® AVX-512 instruction set. Otherwise, an "
|
||||
"*illegal instruction* error may appear, and you won’t be able to complete"
|
||||
" this guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:210
|
||||
msgid "Kubernetes setup"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:212
|
||||
msgid ""
|
||||
"Follow the instructions in the :ref:`kubernetes` tutorial to get set up "
|
||||
"on |CL|. The Kubernetes community also has instructions for creating a "
|
||||
"cluster, described in `Creating a single control-plane cluster with "
|
||||
"kubeadm`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:217
|
||||
msgid "Kubernetes networking"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:219
|
||||
msgid ""
|
||||
"We used `flannel`_ as the network provider for these tests. If you prefer"
|
||||
" a different network layer, refer to the Kubernetes network documentation"
|
||||
" described in `Creating a single control-plane cluster with kubeadm`_ for"
|
||||
" setup."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:224
|
||||
msgid "Kubectl"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:226
|
||||
msgid ""
|
||||
"You can use kubectl to run commands against your Kubernetes cluster. "
|
||||
"Refer to the `Overview of kubectl`_ for details on syntax and operations."
|
||||
" Once you have a working cluster on Kubernetes, use the following YAML "
|
||||
"script to start a pod with a simple shell script, and keep the pod open."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:231
|
||||
msgid "Copy this example.yaml script to your system:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:248
|
||||
msgid "Execute the script with kubectl:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:254
|
||||
msgid ""
|
||||
"This script opens a single pod. More robust solutions would create a "
|
||||
"deployment or inject a python script or larger shell script into the "
|
||||
"container."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:258
|
||||
msgid "Images"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:260
|
||||
msgid ""
|
||||
"You must add `launcher.py`_ to the Docker image to include the Deep "
|
||||
"Learning Reference Stack and put the benchmarks repo in the correct "
|
||||
"location. Note that this guide uses Kubeflow v0.4.0, and cannot guarantee"
|
||||
" results if you use a different version."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:264
|
||||
msgid "From the Docker image, run the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:273
|
||||
msgid "Your entry point becomes: :file:`/opt/launcher.py`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:275
|
||||
msgid "This builds an image that can be consumed directly by TFJob from Kubeflow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:278
|
||||
msgid "ksonnet\\*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:280
|
||||
msgid ""
|
||||
"Kubeflow uses ksonnet\\* to manage deployments, so you must install it "
|
||||
"before setting up Kubeflow."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:283
|
||||
msgid ""
|
||||
"ksonnet was added to the :command:`cloud-native-basic` bundle in |CL| "
|
||||
"version 27550. If you are using an older |CL| version (not recommended), "
|
||||
"you must manually install ksonnet as described below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:287
|
||||
msgid "On |CL|, follow these steps:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:298
|
||||
msgid ""
|
||||
"After the ksonnet installation is complete, ensure that binary `ks` is "
|
||||
"accessible across the environment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:302
|
||||
msgid "Kubeflow"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:304
|
||||
msgid ""
|
||||
"Once you have Kubernetes running on your nodes, set up `Kubeflow`_ by "
|
||||
"following these instructions from the `Getting Started with Kubeflow`_ "
|
||||
"guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:322
|
||||
msgid "Next, deploy the primary package for our purposes: tf-job-operator."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:332
|
||||
msgid ""
|
||||
"This creates the CustomResourceDefinition (CRD) endpoint to launch a "
|
||||
"TFJob."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:335
|
||||
msgid "Run a TFJob"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:337
|
||||
msgid "Get the ksonnet registries for deploying TFJobs from `dlrs-tfjob`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:339
|
||||
msgid "Install the TFJob components as follows:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:347
|
||||
msgid "Export the image name to use for the deployment:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:355
|
||||
msgid "Replace <docker_name> with the image name you specified in previous steps."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:357
|
||||
msgid ""
|
||||
"Generate Kubernetes manifests for the workloads and apply them using "
|
||||
"these commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:367
|
||||
msgid "This replicates and deploys three test setups in your Kubernetes cluster."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:370
|
||||
msgid "Results of running this guide"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:372
|
||||
msgid ""
|
||||
"You must parse the logs of the Kubernetes pod to retrieve performance "
|
||||
"data. The pods will still exist post-completion and will be in "
|
||||
"‘Completed’ state. You can get the logs from any of the pods to inspect "
|
||||
"the benchmark results. More information about Kubernetes logging is "
|
||||
"available in the Kubernetes `Logging Architecture`_ documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:379
|
||||
msgid "Use Jupyter Notebook"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:381
|
||||
msgid ""
|
||||
"This example uses the `PyTorch with OpenBLAS`_ container image. After it "
|
||||
"is downloaded, run the Docker image with :command:`-p` to specify the "
|
||||
"shared port between the container and the host. This example uses port "
|
||||
"8888."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:389
|
||||
msgid ""
|
||||
"After you start the container, launch the Jupyter Notebook. This command "
|
||||
"is executed inside the container image."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:396
|
||||
msgid ""
|
||||
"After the notebook has loaded, you will see output similar to the "
|
||||
"following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:404
|
||||
msgid ""
|
||||
"From your host system, or any system that can access the host's IP "
|
||||
"address, start a web browser with the following. If you are not running "
|
||||
"the browser on the host system, replace :command:`127.0.0.1` with the IP "
|
||||
"address of the host."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:412
|
||||
msgid "Your browser displays the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:418
|
||||
msgid "Figure 1: :guilabel:`Jupyter Notebook`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:421
|
||||
msgid ""
|
||||
"To create a new notebook, click :guilabel:`New` and select "
|
||||
":guilabel:`Python 3`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:427
|
||||
msgid "Figure 2: Create a new notebook"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:429
|
||||
msgid "A new, blank notebook is displayed, with a cell ready for input."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:436
|
||||
msgid ""
|
||||
"To verify that PyTorch is working, copy the following snippet into the "
|
||||
"blank cell, and run the cell."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:450
|
||||
msgid "When you run the cell, your output will look something like this:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:456
|
||||
msgid ""
|
||||
"You can continue working in this notebook, or you can download existing "
|
||||
"notebooks to take advantage of the Deep Learning Reference Stack's "
|
||||
"optimized deep learning frameworks. Refer to `Jupyter Notebook`_ for "
|
||||
"details."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:461
|
||||
msgid "Uninstallation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:463
|
||||
msgid ""
|
||||
"To uninstall the Deep Learning Reference Stack, you can choose to stop "
|
||||
"the container so that it is not using system resources, or you can stop "
|
||||
"the container and delete it to free storage space."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:467
|
||||
msgid "To stop the container, execute the following from your host system:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:469
|
||||
msgid "Find the container's ID"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:475
|
||||
msgid "This will result in output similar to the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:482
|
||||
msgid ""
|
||||
"You can then use the ID or container name to stop the container. This "
|
||||
"example uses the name \"oss\":"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:490
|
||||
msgid "Verify that the container is not running"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:497
|
||||
msgid "To delete the container from your system you need to know the Image ID:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:503
|
||||
msgid "This command results in output similar to the following:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:511
|
||||
msgid "To remove an image use the image ID:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:527
|
||||
msgid ""
|
||||
"Note that you can execute the :command:`docker rmi` command using only "
|
||||
"the first few characters of the image ID, provided they are unique on the"
|
||||
" system."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:529
|
||||
msgid "Once you have removed the image, you can verify it has been deleted with:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:537
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:539
|
||||
msgid "`DLRS V3.0`_ release announcement"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:540
|
||||
msgid "`TensorFlow Benchmarks`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:541
|
||||
msgid "`PyTorch benchmarks`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:542
|
||||
msgid "`Kubeflow`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:543
|
||||
msgid ":ref:`kubernetes` tutorial"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/dlrs/dlrs.rst:544
|
||||
msgid "`Jupyter Notebook`_"
|
||||
msgstr ""
|
||||
|
||||
@@ -0,0 +1,664 @@
|
||||
# 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-22 12:54-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/stacks/greengrass.rst:4
|
||||
msgid "Enable AWS Greengrass\\* and OpenVINO™ toolkit"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:6
|
||||
msgid ""
|
||||
"This guide explains how to enable AWS Greengrass\\* and OpenVINO™ "
|
||||
"toolkit. Specifically, the guide demonstrates how to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:9
|
||||
msgid "Set up the Intel® edge device with |CL-ATTR|"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:10
|
||||
msgid ""
|
||||
"Install the OpenVINO™ toolkit and Amazon Web Services\\* (AWS\\*) "
|
||||
"Greengrass\\* software stacks"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:12
|
||||
msgid ""
|
||||
"Use AWS Greengrass\\* and AWS Lambda\\* to deploy the FaaS samples from "
|
||||
"the cloud"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:20
|
||||
msgid "Overview"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:22
|
||||
msgid ""
|
||||
"Hardware accelerated Function-as-a-Service (FaaS) enables cloud "
|
||||
"developers to deploy inference functionalities [1] on Intel® IoT edge "
|
||||
"devices with accelerators (CPU, Integrated GPU, Intel® FPGA, and Intel® "
|
||||
"Movidius™ technology). These functions provide a great developer "
|
||||
"experience and seamless migration of visual analytics from cloud to edge "
|
||||
"in a secure manner using a containerized environment. Hardware-"
|
||||
"accelerated FaaS provides the best-in-class performance by accessing "
|
||||
"optimized deep learning libraries on Intel® IoT edge devices with "
|
||||
"accelerators."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:32
|
||||
msgid "Supported platforms"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:34
|
||||
msgid "Operating System: |CL| latest release"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:35
|
||||
msgid "Hardware: Intel® core platforms (that support inference on CPU only)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:38
|
||||
msgid "Sample description"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:40
|
||||
msgid ""
|
||||
"The AWS Greengrass samples are located at `Edge-Analytics-FaaS`_. This "
|
||||
"guide uses the 1.0 version of the source code."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:43
|
||||
msgid "|CL| provides the following AWS Greengrass samples:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:45
|
||||
msgid "`greengrass_classification_sample.py`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:47
|
||||
msgid ""
|
||||
"This AWS Greengrass sample classifies a video stream using classification"
|
||||
" networks such as AlexNet and GoogLeNet and publishes top-10 results on "
|
||||
"AWS\\* IoT Cloud every second."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:51
|
||||
msgid "`greengrass_object_detection_sample_ssd.py`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:53
|
||||
msgid ""
|
||||
"This AWS Greengrass sample detects objects in a video stream and "
|
||||
"classifies them using single-shot multi-box detection (SSD) networks such"
|
||||
" as SSD Squeezenet, SSD Mobilenet, and SSD300. This sample publishes "
|
||||
"detection outputs such as class label, class confidence, and bounding box"
|
||||
" coordinates on AWS IoT Cloud every second."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:61
|
||||
msgid "Install the OS on the edge device"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:63
|
||||
msgid ""
|
||||
"Start with a clean installation of |CL| on a new system, using the :ref"
|
||||
":`bare-metal-install-desktop`, found in :ref:`get-started`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:67
|
||||
msgid "Create user accounts"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:69
|
||||
msgid ""
|
||||
"After |CL| is installed, create two user accounts. Create an "
|
||||
"administrative user in |CL| and create a user account for the Greengrass "
|
||||
"services to use ( see Greengrass user below)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:73
|
||||
msgid ""
|
||||
"Create a new user and set a password for that user. Enter the following "
|
||||
"commands as ``root``:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:81
|
||||
msgid ""
|
||||
"Next, enable the :command:`sudo` command for your new <userid>. Add "
|
||||
"<userid> to the `wheel` group:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:88
|
||||
msgid "Create a :file:`/etc/fstab` file."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:96
|
||||
msgid ""
|
||||
"By default, |CL| does not create an :file:`/etc/fstab` file. You must "
|
||||
"create this file before the Greengrass service runs."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:100
|
||||
msgid "Add required bundles"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:102
|
||||
msgid ""
|
||||
"Use the :command:`swupd` software updater utility to add the prerequisite"
|
||||
" bundles for the OpenVINO software stack:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:111
|
||||
msgid "Learn more about how to :ref:`swupd-guide`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:113
|
||||
msgid ""
|
||||
"The :command:`computer-vision-basic` bundle installs the OpenVINO™ "
|
||||
"toolkit, and the sample models optimized for Intel® edge platforms."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:117
|
||||
msgid "Convert deep learning models"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:120
|
||||
msgid "Locate sample models"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:122
|
||||
msgid ""
|
||||
"There are two types of provided models that can be used in conjunction "
|
||||
"with AWS Greengrass for this guide: classification or object detection."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:125
|
||||
msgid ""
|
||||
"To complete this guide using an image classification model, download the "
|
||||
"BVLC AlexNet model files `bvlc_alexnet.caffemodel`_ and "
|
||||
"`deploy.prototxt`_ to the default model_location at "
|
||||
":file:`/usr/share/openvino/models`. Any custom pre-trained classification"
|
||||
" models can be used with the classification sample."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:131
|
||||
msgid ""
|
||||
"For object detection, the sample models optimized for Intel® edge "
|
||||
"platforms are included with the computer-vision-basic bundle installation"
|
||||
" at :file:`/usr/share/openvino/models`. These models are provided as an "
|
||||
"example; you may also use a custom SSD model with the Greengrass object "
|
||||
"detection sample."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:137
|
||||
msgid "Run model optimizer"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:139
|
||||
msgid ""
|
||||
"Follow the instructions in the `Model Optimizer Developer Guide`_ for "
|
||||
"converting deep learning models to Intermediate Representation using "
|
||||
"Model Optimizer. To optimize either of the sample models described above,"
|
||||
" run one of the following commands."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:143
|
||||
msgid "For classification using BVLC AlexNet model:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:152
|
||||
msgid "For object detection using SqueezeNetSSD-5Class model:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:161
|
||||
msgid "In these examples:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:163
|
||||
msgid "`<model_location>` is :file:`/usr/share/openvino/models`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:165
|
||||
msgid "`<data_type>` is FP32 or FP16, depending on target device."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:167
|
||||
msgid ""
|
||||
"`<output_dir>` is the directory where the Intermediate Representation "
|
||||
"(IR) is stored. IR contains .xml format corresponding to the network "
|
||||
"structure and .bin format corresponding to weights. This .xml file should"
|
||||
" be passed to :command:`<PARAM_MODEL_XML>`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:172
|
||||
msgid ""
|
||||
"In the BVLC AlexNet model, the prototxt defines the input shape with "
|
||||
"batch size 10 by default. In order to use any other batch size, the "
|
||||
"entire input shape must be provided as an argument to the model "
|
||||
"optimizer. For example, to use batch size 1, you must provide: "
|
||||
"`--input_shape [1,3,227,227]`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:180
|
||||
msgid "Configure AWS Greengrass group"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:182
|
||||
msgid ""
|
||||
"For each Intel® edge platform, you must create a new AWS Greengrass group"
|
||||
" and install AWS Greengrass core software to establish the connection "
|
||||
"between cloud and edge."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:186
|
||||
msgid ""
|
||||
"To create an AWS Greengrass group, follow the instructions in `Configure "
|
||||
"AWS IoT Greengrass on AWS IoT`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:189
|
||||
msgid ""
|
||||
"To install and configure AWS Greengrass core on edge platform, follow the"
|
||||
" instructions in `Start AWS Greengrass on the Core Device`_. In step "
|
||||
"8(b), download the x86_64 Ubuntu\\* configuration of the AWS Greengrass "
|
||||
"core software."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:196
|
||||
msgid ""
|
||||
"You do not need to run the :file:`cgroupfs-mount.sh` script in step #6 of"
|
||||
" Module 1 of the `AWS Greengrass Developer Guide`_ because this is "
|
||||
"enabled already in |CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:200
|
||||
msgid ""
|
||||
"Be sure to download both the security resources and the AWS Greengrass "
|
||||
"core software."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:205
|
||||
msgid "Security certificates are linked to your AWS account."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:209
|
||||
msgid "Create and package Lambda function"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:211
|
||||
msgid ""
|
||||
"Complete steps 1-4 of the AWS Greengrass guide at `Create and Package a "
|
||||
"Lambda Function`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:216
|
||||
msgid ""
|
||||
"This creates the tarball needed to create the AWS Greengrass environment "
|
||||
"on the edge device."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:220
|
||||
msgid ""
|
||||
"In step 5, replace :file:`greengrassHelloWorld.py` with the "
|
||||
"classification or object detection Greengrass sample from `Edge-"
|
||||
"Analytics-Faas`_:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:223
|
||||
msgid "Classification: `greengrass_classification_sample.py`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:225
|
||||
msgid "Object Detection: `greengrass_object_detection_sample_ssd.py`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:227
|
||||
msgid ""
|
||||
"Zip the selected Greengrass sample with the extracted Greengrass SDK "
|
||||
"folders from the previous step into "
|
||||
":file:`greengrass_sample_python_lambda.zip`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:230
|
||||
msgid "The zip should contain:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:232
|
||||
msgid "greengrasssdk"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:234
|
||||
msgid "greengrass classification or object detection sample"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:236
|
||||
msgid "For example:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:243
|
||||
msgid ""
|
||||
"Return to the AWS documentation section called `Create and Package a "
|
||||
"Lambda Function`_ and complete the procedure."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:248
|
||||
msgid ""
|
||||
"In step 9(a) of the AWS documentation, while uploading the zip file, make"
|
||||
" sure to name the handler to one of the following, depending on the AWS "
|
||||
"Greengrass sample you are using:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:252
|
||||
msgid "greengrass_object_detection_sample_ssd.function_handler"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:253
|
||||
msgid "greengrass_classification_sample.function_handler"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:257
|
||||
msgid "Configure Lambda function"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:259
|
||||
msgid ""
|
||||
"After creating the Greengrass group and the Lambda function, start "
|
||||
"configuring the Lambda function for AWS Greengrass."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:262
|
||||
msgid ""
|
||||
"Follow steps 1-8 in `Configure the Lambda Function for AWS IoT "
|
||||
"Greengrass`_ in the AWS documentation."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:265
|
||||
msgid ""
|
||||
"In addition to the details mentioned in step 8, change the Memory limit "
|
||||
"to 2048 MB to accommodate large input video streams."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:268
|
||||
msgid ""
|
||||
"Add the following environment variables as key-value pairs when editing "
|
||||
"the Lambda configuration and click on update:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:271
|
||||
msgid "**Table 1. Environment variables: Lambda configuration**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:275
|
||||
msgid "Key"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:276
|
||||
msgid "Value"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:277
|
||||
msgid "PARAM_MODEL_XML"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:278
|
||||
msgid ""
|
||||
"<MODEL_DIR>/<IR.xml>, where <MODEL_DIR> is user specified and contains "
|
||||
"IR.xml, the Intermediate Representation file from Intel® Model Optimizer."
|
||||
" For this guide, <MODEL_DIR> should be set to "
|
||||
"'/usr/share/openvino/models' or one of its subdirectories."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:282
|
||||
msgid "PARAM_INPUT_SOURCE"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:283
|
||||
msgid "<DATA_DIR>/input.webm to be specified by user. Holds both input and"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:284
|
||||
msgid "output data. For webcam, set PARAM_INPUT_SOURCE to ‘/dev/video0’"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:285
|
||||
msgid "PARAM_DEVICE"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:286
|
||||
msgid "\"CPU\""
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:287
|
||||
msgid "PARAM_CPU_EXTENSION_PATH"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:288
|
||||
msgid "/usr/lib64/libcpu_extension.so"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:289
|
||||
msgid "PARAM_OUTPUT_DIRECTORY"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:290
|
||||
msgid "<DATA_DIR> to be specified by user. Holds both input and output data"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:292
|
||||
msgid "PARAM_NUM_TOP_RESULTS"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:293
|
||||
msgid ""
|
||||
"User specified for classification sample. (e.g. 1 for top-1 result, 5 for"
|
||||
" top-5 results)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:296
|
||||
msgid ""
|
||||
"Add subscription to subscribe, or publish messages from AWS Greengrass "
|
||||
"Lambda function by completing the procedure in `Configure the Lambda "
|
||||
"Function for AWS IoT Greengrass`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:301
|
||||
msgid ""
|
||||
"The optional topic filter field is the topic mentioned inside the Lambda "
|
||||
"function. In this guide, sample topics include the following: "
|
||||
":command:`openvino/ssd` or :command:`openvino/classification`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:305
|
||||
msgid "Add local resources"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:307
|
||||
msgid ""
|
||||
"Refer to the AWS documentation `Access Local Resources with Lambda "
|
||||
"Functions and Connectors`_ for details about local resources and access "
|
||||
"privileges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:310
|
||||
msgid "The following table describes the local resources needed for the CPU:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:312
|
||||
msgid "**Local resources**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:316
|
||||
msgid "Name"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:317
|
||||
msgid "Resource type"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:318
|
||||
msgid "Local path"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:319
|
||||
msgid "Access"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:321
|
||||
msgid "ModelDir"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:322
|
||||
#: ../../guides/stacks/greengrass.rst:332
|
||||
msgid "Volume"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:323
|
||||
msgid "<MODEL_DIR> to be specified by user"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:324
|
||||
#: ../../guides/stacks/greengrass.rst:329
|
||||
msgid "Read-Only"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:326
|
||||
msgid "Webcam"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:327
|
||||
msgid "Device"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:328
|
||||
msgid "/dev/video0"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:331
|
||||
msgid "DataDir"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:333
|
||||
msgid "<DATA_DIR> to be specified by user. Holds both input and output data."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:335
|
||||
msgid "Read and Write"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:338
|
||||
msgid "Deploy Lambda function"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:340
|
||||
msgid ""
|
||||
"Refer to the AWS documentation `Deploy Cloud Configurations to an AWS IoT"
|
||||
" Greengrass Core Device`_ for instructions on how to deploy the lambda "
|
||||
"function to AWS Greengrass core device. Select *Deployments* on the group"
|
||||
" page and follow the instructions."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:344
|
||||
msgid "Output consumption"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:346
|
||||
msgid ""
|
||||
"There are four options available for output consumption. These options "
|
||||
"are used to report, stream, upload, or store inference output at an "
|
||||
"interval defined by the variable :command:`reporting_interval` in the AWS"
|
||||
" Greengrass samples."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:350
|
||||
msgid "IoT cloud output:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:352
|
||||
msgid ""
|
||||
"This option is enabled by default in the AWS Greengrass samples using the"
|
||||
" :command:`enable_iot_cloud_output` variable. You can use it to verify "
|
||||
"the lambda running on the edge device. It enables publishing messages to "
|
||||
"IoT cloud using the subscription topic specified in the lambda. (For "
|
||||
"example, topics may include :command:`openvino/classification` for "
|
||||
"classification and :command:`openvino/ssd` for object detection samples.)"
|
||||
" For classification, top-1 result with class label are published to IoT "
|
||||
"cloud. For SSD object detection, detection results such as bounding box "
|
||||
"coordinates of objects, class label, and class confidence are published."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:362
|
||||
msgid ""
|
||||
"Refer to the AWS documentation `Verify the Lambda Function Is Running on "
|
||||
"the Device`_ for instructions on how to view the output on IoT cloud."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:366
|
||||
msgid "Kinesis streaming:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:368
|
||||
msgid ""
|
||||
"This option enables inference output to be streamed from the edge device "
|
||||
"to cloud using Kinesis [3] streams when :command:`enable_kinesis_output` "
|
||||
"is set to True. The edge devices act as data producers and continually "
|
||||
"push processed data to the cloud. You must set up and specify Kinesis "
|
||||
"stream name, Kinesis shard, and AWS region in the AWS Greengrass samples."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:375
|
||||
msgid "Cloud storage using AWS S3 bucket:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:377
|
||||
msgid ""
|
||||
"When the :command:`enable_s3_jpeg_output` variable is set to True, it "
|
||||
"enables uploading and storing processed frames (in jpeg format) in an AWS"
|
||||
" S3 bucket. You must set up and specify the S3 bucket name in the AWS "
|
||||
"Greengrass samples to store the JPEG images. The images are named using "
|
||||
"the timestamp and uploaded to S3."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:383
|
||||
msgid "Local storage:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:385
|
||||
msgid ""
|
||||
"When the :command:`enable_s3_jpeg_output` variable is set to True, it "
|
||||
"enables storing processed frames (in jpeg format) on the edge device. The"
|
||||
" images are named using the timestamp and stored in a directory specified"
|
||||
" by :command:`PARAM_OUTPUT_DIRECTORY`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:391
|
||||
msgid "References"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:393
|
||||
msgid "AWS Greengrass: https://aws.amazon.com/greengrass/"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:394
|
||||
msgid "AWS Lambda: https://aws.amazon.com/lambda/"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/stacks/greengrass.rst:395
|
||||
msgid "AWS Kinesis: https://aws.amazon.com/kinesis/"
|
||||
msgstr ""
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -45,28 +45,15 @@ msgid ""
|
||||
" optimization patches are found in our `Linux`_ GitHub\\* repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:24
|
||||
msgid "Kernel Container"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:20
|
||||
msgid ""
|
||||
"The *kernel-container* bundle contains the kernel used by the Intel® "
|
||||
"Clear Containers project. This kernel is optimized for fast booting and "
|
||||
"performs best on |CC| running on the Intel® architectures described on "
|
||||
"the :ref:`supported hardware list<system-requirements>`. The optimization"
|
||||
" patches are found in our `Linux-Container`_ GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:29
|
||||
#: ../../tooling/compatible-kernels.rst:22
|
||||
msgid "Also compatible with VMs"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:39
|
||||
#: ../../tooling/compatible-kernels.rst:32
|
||||
msgid "Kernel LTS"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:32
|
||||
#: ../../tooling/compatible-kernels.rst:25
|
||||
msgid ""
|
||||
"The *kernel-lts* bundle focuses on the bare metal platforms but uses the "
|
||||
"latest :abbr:`LTS (Long Term Support)` Linux kernel. It is optimized for "
|
||||
@@ -78,15 +65,15 @@ msgid ""
|
||||
"GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:42
|
||||
#: ../../tooling/compatible-kernels.rst:35
|
||||
msgid "VM only"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:54
|
||||
#: ../../tooling/compatible-kernels.rst:47
|
||||
msgid "Kernel KVM"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:45
|
||||
#: ../../tooling/compatible-kernels.rst:38
|
||||
msgid ""
|
||||
"The *kernel-kvm* bundle focuses on the Linux :abbr:`KVM (Kernel-based "
|
||||
"Virtual Machine)`. It is optimized for fast booting and performs best on "
|
||||
@@ -99,11 +86,11 @@ msgid ""
|
||||
"optimization patches are found in our `Linux-KVM`_ GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:65
|
||||
#: ../../tooling/compatible-kernels.rst:58
|
||||
msgid "Kernel Hyper-V\\*"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:57
|
||||
#: ../../tooling/compatible-kernels.rst:50
|
||||
msgid ""
|
||||
"The *kernel-hyperv* bundle focuses on running Linux on Microsoft\\* "
|
||||
"Hyper-V. It is optimized for fast booting and performs best on Virtual "
|
||||
@@ -116,11 +103,11 @@ msgid ""
|
||||
"GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:78
|
||||
#: ../../tooling/compatible-kernels.rst:71
|
||||
msgid "Kernel Hyper-V LTS"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/compatible-kernels.rst:68
|
||||
#: ../../tooling/compatible-kernels.rst:61
|
||||
msgid ""
|
||||
"The *kernel-hyperv-lts* bundle focuses on running Linux on Microsoft "
|
||||
"Hyper-V but uses the latest :abbr:`LTS (Long Term Support)` Linux kernel."
|
||||
@@ -133,3 +120,19 @@ msgid ""
|
||||
"optimization patches are found in our `Linux-HyperV-LTS`_ GitHub repo."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Kernel Container"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The *kernel-container* bundle contains "
|
||||
#~ "the kernel used by the Intel® "
|
||||
#~ "Clear Containers project. This kernel is"
|
||||
#~ " optimized for fast booting and "
|
||||
#~ "performs best on |CC| running on "
|
||||
#~ "the Intel® architectures described on "
|
||||
#~ "the :ref:`supported hardware list<system-"
|
||||
#~ "requirements>`. The optimization patches are"
|
||||
#~ " found in our `Linux-Container`_ "
|
||||
#~ "GitHub repo."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,248 @@
|
||||
# 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-22 12:54-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"
|
||||
|
||||
#: ../../tooling/security.rst:4
|
||||
msgid "OS Security"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/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 ""
|
||||
|
||||
#: ../../tooling/security.rst:14
|
||||
msgid "Security in updates"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:16
|
||||
msgid ""
|
||||
"The |CL| team believes in the benefits of software security through open "
|
||||
"sourcing, incremental updates, and rapidly resolving known security "
|
||||
"advisories."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:20
|
||||
msgid "The latest Linux\\* codebase"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:22
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:27
|
||||
msgid "Automated effective updating"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:29
|
||||
msgid "|CL| is incrementally updated multiple times per day."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:31
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:35
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:41
|
||||
msgid ""
|
||||
"In |CL| updates are delivered automatically, efficiently, and "
|
||||
"effectively. For more information about software updates in |CL|, refer "
|
||||
"to the :ref:`swupd-guide` guide."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:46
|
||||
msgid "Automated CVE scanning and remediation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:48
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:53
|
||||
msgid ""
|
||||
"|CL| employs a proactive and measured approach to addressing known and "
|
||||
"fixable :abbr:`CVEs (Common Vulnerabilities and Exposures)`. Packages are"
|
||||
" automatically scanned against CVEs daily, and security patches are "
|
||||
"deployed as soon as they are available."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:58
|
||||
msgid ""
|
||||
"These combined practices minimize the amount of time |CL| systems are "
|
||||
"exposed to unnecessary security risk."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:61
|
||||
msgid "Security in software"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:64
|
||||
msgid "Minimized attack surface"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:66
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:70
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:74
|
||||
msgid ""
|
||||
"Services and subsystems which expose sensitive system information have "
|
||||
"been removed such as the `finger` and `tcpwrappers`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:77
|
||||
msgid "`SFTP` has been disabled by default due to security considerations."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:80
|
||||
msgid "Verified trust"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:82
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:86
|
||||
msgid ""
|
||||
"All update operations from swupd are transparently encrypted and checked "
|
||||
"against the |CL| maintainers' public key for authenticity. More "
|
||||
"information about swupd security can be found in the `Security for "
|
||||
"software update in Clear Linux* OS`_ blog post."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:91
|
||||
msgid ""
|
||||
"Before being built, packages available from |CL| verify checksums and "
|
||||
"signatures provided by third party project codebases and maintainers."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:94
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:100
|
||||
msgid "Compiled with secure options"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:102
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:106
|
||||
msgid ""
|
||||
"Kernels shipped with |CL| are signed and disallow the usage of custom "
|
||||
"kernel modules to maintain verifiable system integrity."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:109
|
||||
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 about PIE executables can "
|
||||
"be found in the `Recent GNU* C library improvements`_ blog post."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:116
|
||||
msgid "Security in system design"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:118
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:122
|
||||
msgid ""
|
||||
"Full disk encryption using :abbr:`LUKS (Linux Unified Key Setup)` is "
|
||||
"available during installation. Refer to `cryptsetup`_ for additional "
|
||||
"information about LUKS."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:126
|
||||
msgid ""
|
||||
"|CL| uses the PAM cracklib module to harden user login and password "
|
||||
"security resulting in:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:129
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/security.rst:132
|
||||
msgid ""
|
||||
"Simple password schemes, which are known to be easily compromised, cannot"
|
||||
" be set in |CL|."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:135
|
||||
msgid ""
|
||||
"A password blacklist, to avoid system passwords being set to passwords "
|
||||
"which have been compromised in the past."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/security.rst:138
|
||||
msgid ""
|
||||
"`Tallow`_, a lightweight service which monitors and blocks suspicious SSH"
|
||||
" login patterns, is installed with the :command:`openssh-server` bundle."
|
||||
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-22 12:54-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"
|
||||
|
||||
#: ../../tooling/stateless.rst:4
|
||||
msgid "Stateless"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:6
|
||||
msgid ""
|
||||
"In most operating systems, user data, system data, and configuration "
|
||||
"files can become intermingled."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:14
|
||||
msgid ""
|
||||
"Figure 1: Without stateless, user and system files become mixed on the "
|
||||
"filesystem over time."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:16
|
||||
msgid ""
|
||||
"|CL-ATTR| has a stateless design philosophy with the goal 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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:25
|
||||
msgid "File-level separation"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:27
|
||||
msgid ""
|
||||
"To accomplish a stateless design the Linux Filesystem Hierarchy is "
|
||||
"separated between user-owned areas and |CL|-owned areas."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:35
|
||||
msgid ""
|
||||
"Figure 2: With stateless, user and system files are separated on the "
|
||||
"filesystem."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:38
|
||||
msgid "System areas"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:39
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:45
|
||||
msgid "User areas"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:46
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:54
|
||||
msgid "Software configuration"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:56
|
||||
msgid ""
|
||||
"With stateless separation, default software configurations are read in "
|
||||
"order from predefined source code, |CL| provided defaults, and user-"
|
||||
"provided configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:61
|
||||
msgid "Default configurations"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:63
|
||||
msgid ""
|
||||
"Software in |CL| provides default configuration values so that it is "
|
||||
"immediately functional, whenever it is appropriate to do so."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:66
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:71
|
||||
msgid ""
|
||||
"For example, the default configuration that Apache uses when installed "
|
||||
"can be found at :file:`/usr/share/defaults/httpd/httpd.conf` directory."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:76
|
||||
msgid "Overriding configurations"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:78
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:82
|
||||
msgid ""
|
||||
"User defined configuration files should contain the minimal set of "
|
||||
"desired changes and rely on default configuration for the rest."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:85
|
||||
msgid "For example, a customized Apache configuration can be used instead by:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:87
|
||||
msgid "Create the destination directory for the configuration:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:93
|
||||
msgid "Copy the default configuration as a reference template:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:99
|
||||
msgid "Make any desired modifications to the configurations:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:105
|
||||
msgid "Reload the service or reboot the system to pickup any changes:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:111
|
||||
msgid ""
|
||||
"This pattern can be used to modify the configurations of other programs "
|
||||
"too. The `stateless man page`_ has application-specific examples."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:115
|
||||
msgid "System reset"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:117
|
||||
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 ""
|
||||
|
||||
#: ../../tooling/stateless.rst:121
|
||||
msgid ""
|
||||
"Running the commands below effectively performs a system reset as if it "
|
||||
"was just installed:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:129
|
||||
msgid ""
|
||||
"In other Linux distributions, this can be a catastrophic action that "
|
||||
"renders a system unable to boot."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:133
|
||||
msgid "Additional information"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/stateless.rst:135
|
||||
msgid "`stateless man page`_"
|
||||
msgstr ""
|
||||
|
||||
@@ -9,7 +9,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Clear Linux* Project Docs latest\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -28,6 +28,34 @@ msgid ""
|
||||
"important tools and concepts for managing your install."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:18
|
||||
msgid "Training"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:20
|
||||
msgid ""
|
||||
"Additional training materials are available in the `how-to-clear`_ "
|
||||
"GitHub\\* project to help you get started with |CL| tools."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:23
|
||||
msgid ""
|
||||
"The training helps you create a customized OS that is based on |CL| and "
|
||||
"provides complete details on the methods and tools used to create updates"
|
||||
" and how to deploy updates to targets."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:27
|
||||
msgid ""
|
||||
"To complete the training, you will need a clean |CL| installation and a "
|
||||
"network connection. The project includes all files needed to complete the"
|
||||
" exercises."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tooling/tooling.rst:29
|
||||
msgid "`how-to-clear`_ training on GitHub"
|
||||
msgstr ""
|
||||
|
||||
#~ msgid "Tooling"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -25,7 +25,7 @@ msgstr ""
|
||||
#: ../../tutorials/docker/docker.rst:6
|
||||
msgid ""
|
||||
"|CL-ATTR| supports multiple containerization platforms, including a "
|
||||
"Docker\\* solution. |CL| has many `unique features`_ including a minimal "
|
||||
"Docker solution. |CL| has many unique features including a minimal "
|
||||
"default installation, which makes it compelling to use as a host for "
|
||||
"container workloads, management, and orchestration."
|
||||
msgstr ""
|
||||
@@ -66,7 +66,7 @@ msgid "Additionally, you should have:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:39
|
||||
msgid "A basic understanding of Linux and Docker."
|
||||
msgid "A basic understanding of Linux\\* and Docker."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:41
|
||||
@@ -116,7 +116,7 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:83
|
||||
msgid "Integration with Kata Containers (optional)"
|
||||
msgid "Integration with Kata Containers\\* (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:85
|
||||
@@ -136,10 +136,10 @@ msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:96
|
||||
msgid ""
|
||||
"The proceeding sections of this tutorial are standard to Docker setup and"
|
||||
" configuration. If you are familiar with Docker basics, you do not need "
|
||||
"to continue reading. The following sections are provided here for sake of"
|
||||
" completeness."
|
||||
"The remaining sections of this tutorial are standard to Docker setup and "
|
||||
"configuration. If you are familiar with Docker basics, you do not need to"
|
||||
" continue reading. The following sections are provided here for sake of "
|
||||
"completeness."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:104
|
||||
@@ -150,8 +150,8 @@ msgstr ""
|
||||
msgid ""
|
||||
"Perform additional Docker daemon configuration via a configuration file "
|
||||
"typically located at :file:`/etc/docker/daemon.json`. |CL| features a "
|
||||
"`stateless system`_ so the configuration file :file:`daemon.json` does "
|
||||
"*NOT* exist by default."
|
||||
":ref:`stateless` system so the configuration file :file:`daemon.json` "
|
||||
"does *NOT* exist by default."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:111
|
||||
@@ -195,14 +195,14 @@ msgstr ""
|
||||
msgid ""
|
||||
"`Docker Hub`_ is a publically available container image repository which "
|
||||
"comes preconfigured with Docker. In the example below we will pull and "
|
||||
"run an the official Docker image for nginx, an open source reverse proxy "
|
||||
"server."
|
||||
"run an the official Docker image for nginx\\*, an open source reverse "
|
||||
"proxy server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/docker/docker.rst:153
|
||||
msgid ""
|
||||
"First, pull a container image from Docker Hub using the :command:`docker "
|
||||
"pull` command. Download the latest nginx Docker container image by "
|
||||
"pull` command. Download the latest nginx\\* Docker container image by "
|
||||
"running this command:"
|
||||
msgstr ""
|
||||
|
||||
@@ -295,3 +295,56 @@ msgstr ""
|
||||
msgid "`Kata Containers`_"
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "|CL-ATTR| supports multiple containerization"
|
||||
#~ " platforms, including a Docker\\* solution."
|
||||
#~ " |CL| has many `unique features`_ "
|
||||
#~ "including a minimal default installation, "
|
||||
#~ "which makes it compelling to use "
|
||||
#~ "as a host for container workloads, "
|
||||
#~ "management, and orchestration."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "A basic understanding of Linux and Docker."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Integration with Kata Containers (optional)"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The proceeding sections of this tutorial"
|
||||
#~ " are standard to Docker setup and "
|
||||
#~ "configuration. If you are familiar with"
|
||||
#~ " Docker basics, you do not need "
|
||||
#~ "to continue reading. The following "
|
||||
#~ "sections are provided here for sake "
|
||||
#~ "of completeness."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Perform additional Docker daemon configuration"
|
||||
#~ " via a configuration file typically "
|
||||
#~ "located at :file:`/etc/docker/daemon.json`. |CL| "
|
||||
#~ "features a `stateless system`_ so the"
|
||||
#~ " configuration file :file:`daemon.json` does "
|
||||
#~ "*NOT* exist by default."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "`Docker Hub`_ is a publically available"
|
||||
#~ " container image repository which comes "
|
||||
#~ "preconfigured with Docker. In the "
|
||||
#~ "example below we will pull and run"
|
||||
#~ " an the official Docker image for "
|
||||
#~ "nginx, an open source reverse proxy "
|
||||
#~ "server."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "First, pull a container image from "
|
||||
#~ "Docker Hub using the :command:`docker "
|
||||
#~ "pull` command. Download the latest nginx"
|
||||
#~ " Docker container image by running "
|
||||
#~ "this command:"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -167,60 +167,60 @@ msgid ""
|
||||
" kata-runtime."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:138
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:139
|
||||
msgid "Configure and run CRI-O + kata-runtime"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:140
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:141
|
||||
msgid "Enable the CRI-O service:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:146
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:147
|
||||
msgid "Enter the commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:153
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:154
|
||||
msgid ""
|
||||
"Initialize the master control plane with the command below and follow the"
|
||||
" displayed instructions to set up `kubectl`:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:159
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:161
|
||||
msgid "Register kata-runtime as a RuntimeClass handler:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:178
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:180
|
||||
msgid "Install pod network add-on"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:180
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:182
|
||||
msgid ""
|
||||
"You must choose and install a `pod network add-on`_ to allow your pods to"
|
||||
" communicate. Check whether or not your add-on requires special flags "
|
||||
"when you initialize the master control plane."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:184
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:186
|
||||
msgid "**Notes about flannel add-on**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:186
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:188
|
||||
msgid ""
|
||||
"If you choose the `flannel` add-on, then you must add the following to "
|
||||
"the `kubeadm init` command:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:193
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:195
|
||||
msgid ""
|
||||
"Furthermore, if you are using CRI-O and `flannel` and you want to use "
|
||||
"Kata Containers, edit the :file:`/etc/crio/crio.conf` file to add:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:202
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:204
|
||||
msgid "Use your cluster"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:204
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:206
|
||||
msgid ""
|
||||
"Once your master control plane is successfully initialized, instructions "
|
||||
"on how to use your cluster and its *IP*, *token*, and *hash* values are "
|
||||
@@ -229,11 +229,11 @@ msgid ""
|
||||
"have a valid period. The values are presented in a format similar to:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:214
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:216
|
||||
msgid "**Congratulations!**"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:216
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:218
|
||||
msgid ""
|
||||
"You've successfully installed and set up Kubernetes in |CL| using CRI-O "
|
||||
"and kata-runtime. You are now ready to follow on-screen instructions to "
|
||||
@@ -241,46 +241,46 @@ msgid ""
|
||||
"displayed token and IP information."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:222
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:224
|
||||
msgid "Related topics"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:224
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:226
|
||||
msgid "Read the Kubernetes documentation to learn more about:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:226
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:228
|
||||
msgid "`Understanding basic Kubernetes architecture`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:228
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:230
|
||||
msgid "`Deploying an application to your cluster`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:230
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:232
|
||||
msgid "Installing a `pod network add-on`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:232
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:234
|
||||
msgid "`Joining your nodes`_"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:235
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:237
|
||||
msgid "Cloud native setup automation (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:237
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:239
|
||||
msgid ""
|
||||
"Clone the `cloud-native-setup`_ repository on your system and follow the "
|
||||
"instructions. This repository includes helper scripts to automate "
|
||||
"configuration."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:240
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:243
|
||||
msgid "Package configuration customization (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:242
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:245
|
||||
msgid ""
|
||||
"|CL| is a stateless system that looks for user-defined package "
|
||||
"configuration files in the :file:`/etc/<package-name>` directory to be "
|
||||
@@ -288,7 +288,7 @@ msgid ""
|
||||
"distribution-provided configuration files for each package."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:247
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:250
|
||||
msgid ""
|
||||
"If you customize any of the default package configuration files, you "
|
||||
"**must** store the customized files in the :file:`/etc/` directory. If "
|
||||
@@ -296,21 +296,23 @@ msgid ""
|
||||
"will be lost in the next system update."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:252
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:255
|
||||
msgid ""
|
||||
"For example, to customize CRI-O configuration in your system, run the "
|
||||
"following commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:261
|
||||
msgid "Learn more about `Stateless`_ in |CL| and view the |CL| `documentation`_."
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:264
|
||||
msgid ""
|
||||
"Learn more about :ref:`stateless` in |CL| and view the |CL| "
|
||||
"`documentation`_."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:264
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:267
|
||||
msgid "Proxy configuration (optional)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:266
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:269
|
||||
msgid ""
|
||||
"If you use a proxy server, you must set your proxy environment variables "
|
||||
"and create an appropriate proxy configuration file for both CRI-O "
|
||||
@@ -320,78 +322,78 @@ msgid ""
|
||||
"is not enough.)"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:271
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:274
|
||||
msgid ""
|
||||
"If you have already set your proxy environment variables, run the "
|
||||
"following commands as a shell script to configure all of these services "
|
||||
"in one step:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:289
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:292
|
||||
msgid "Next steps"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:291
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:294
|
||||
msgid ":ref:`kubernetes-bp`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:295
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:298
|
||||
msgid "Troubleshooting"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:297
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:300
|
||||
msgid "<HOSTNAME> not found in <IP> message."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:299
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:302
|
||||
msgid ""
|
||||
"Your DNS server may not be appropriately configured. Try adding an entry "
|
||||
"to the :file:`/etc/hosts` file with your host's IP and Name."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:302
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:305
|
||||
msgid "For example: 100.200.50.20 myhost"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:304
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:307
|
||||
msgid ""
|
||||
"Use the commands :command:`hostname` and :command:`hostname -I` to "
|
||||
"retrieve them."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:306
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:309
|
||||
msgid "Images cannot be pulled."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:308
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:311
|
||||
msgid ""
|
||||
"You may be behind a proxy server. Try configuring your proxy settings, "
|
||||
"using the environment variables *HTTP_PROXY*, *HTTPS_PROXY*, and "
|
||||
"*NO_PROXY* as required in your environment."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:312
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:315
|
||||
msgid "Connection refused error."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:314
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:317
|
||||
msgid ""
|
||||
"If you are behind a proxy server, you may need to add the master's IP to "
|
||||
"the environment variable *NO_PROXY*."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:317
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:320
|
||||
msgid "Connection timed-out or Access Refused errors."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:319
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:322
|
||||
msgid ""
|
||||
"You must ensure that the appropriate proxy settings are available from "
|
||||
"the same terminal where you will initialize the control plane. To verify "
|
||||
"the proxy settings that Kubernetes will actually use, run the commands:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:329
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:332
|
||||
msgid ""
|
||||
"If the displayed proxy values are different from your assigned values, "
|
||||
"the cluster initialization will fail. Contact your IT support team to "
|
||||
@@ -400,49 +402,54 @@ msgid ""
|
||||
"SSH access."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:334
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:337
|
||||
msgid ""
|
||||
"If the result of the above commands is blank, you may need to add a "
|
||||
"``profile`` to the :file:`/etc` directory. To do so, follow these steps."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:337
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:340
|
||||
msgid "Create a `profile` in :file:`/etc`"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:343
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:346
|
||||
msgid ""
|
||||
"With a preferred editor, open `profile`, and enter your proxy settings. "
|
||||
"Example shown below."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:355
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:358
|
||||
msgid "<master IP> can be obtained by running :command:`ifconfig`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:357
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:360
|
||||
msgid "Save and exit the `profile`."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:359
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:362
|
||||
msgid "Run:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:365
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:368
|
||||
msgid "To ensure your system isn't running previous session variables, run:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:371
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:374
|
||||
msgid "Continue below while passing `-E` in the command as shown."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:373
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:376
|
||||
msgid "Missing environment variables."
|
||||
msgstr ""
|
||||
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:375
|
||||
#: ../../tutorials/kubernetes/kubernetes.rst:378
|
||||
msgid ""
|
||||
"If you are behind a proxy server, pass environment variables by adding "
|
||||
"*-E* to the command that initializes the master control plane."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Learn more about `Stateless`_ in |CL|"
|
||||
#~ " and view the |CL| `documentation`_."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -92,17 +92,18 @@ msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:3
|
||||
msgid ""
|
||||
"The *kernel-native-dkms* bundle provides the :command:`dkms` program and "
|
||||
"Linux kernel headers, which are required for compiling kernel modules."
|
||||
"The :command:`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:6
|
||||
msgid "The *kernel-native-dkms* bundle also:"
|
||||
msgid "The :command:`kernel-native-dkms` bundle also:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:8
|
||||
msgid ""
|
||||
"Adds a systemd update trigger (:file:`/usr/lib/systemd/system/dkms-new-"
|
||||
"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 ""
|
||||
@@ -128,35 +129,35 @@ msgid ""
|
||||
"relies on a kernel module."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:28
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:27
|
||||
msgid ""
|
||||
"Install the :command:`kernel-native-dkms` or :command:`kernel-lts-dkms` "
|
||||
"bundle:"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:31
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:30
|
||||
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:40
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:39
|
||||
msgid "Ensure *.native* or *.lts* is in the kernel name."
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:42
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:41
|
||||
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:50
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:49
|
||||
msgid "or"
|
||||
msgstr ""
|
||||
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:57
|
||||
#: ../../guides/kernel/kernel-modules-dkms.rst:56
|
||||
msgid "Update the |CL| bootloader and reboot."
|
||||
msgstr ""
|
||||
|
||||
@@ -418,3 +419,22 @@ msgid ""
|
||||
"<https://download.nvidia.com/XFree86/Linux-x86_64/>`_"
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "The *kernel-native-dkms* bundle provides"
|
||||
#~ " the :command:`dkms` program and Linux "
|
||||
#~ "kernel headers, which are required for"
|
||||
#~ " compiling kernel modules."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "The *kernel-native-dkms* bundle also:"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ 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 ""
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ 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"
|
||||
"POT-Creation-Date: 2019-07-22 12:54-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"
|
||||
@@ -25,7 +25,7 @@ msgstr ""
|
||||
#: ../../tutorials/wordpress/web-server-install.rst:6
|
||||
msgid ""
|
||||
"This tutorial provides instructions on how to set up a :abbr:`LAMP "
|
||||
"(Linux, Apache, MySQL, PHP)` web server on |CL-ATTR| and how to use "
|
||||
"(Linux, Apache\\*, MySQL, PHP)` web server on |CL-ATTR| and how to use "
|
||||
"phpMyAdmin\\* to manage an associated database. Note that this tutorial "
|
||||
"installs MariaDB\\*, which is a drop-in replacement for MySQL\\*."
|
||||
msgstr ""
|
||||
@@ -106,9 +106,9 @@ msgstr ""
|
||||
|
||||
#: ../../tutorials/wordpress/web-server-install.rst:78
|
||||
msgid ""
|
||||
"|CL| is designed to be a `stateless`_ operating system which means that "
|
||||
"you must create an optional configuration file to override the default "
|
||||
"values. The default location of the Apache configuration file, "
|
||||
"|CL| is designed to be a :ref:`stateless` operating system which means "
|
||||
"that you must create an optional configuration file to override the "
|
||||
"default values. The default location of the Apache configuration file, "
|
||||
":file:`httpd.conf`, is located in the :file:`/usr/share/defaults/httpd` "
|
||||
"directory. |CL| can override this directory as part of the stateless "
|
||||
"paradigm. This default :file:`.conf` file includes the following "
|
||||
@@ -545,3 +545,30 @@ msgid ""
|
||||
"with :ref:`wp-install`."
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "This tutorial provides instructions on "
|
||||
#~ "how to set up a :abbr:`LAMP "
|
||||
#~ "(Linux, Apache, MySQL, PHP)` web server"
|
||||
#~ " on |CL-ATTR| and how to use"
|
||||
#~ " phpMyAdmin\\* to manage an associated "
|
||||
#~ "database. Note that this tutorial "
|
||||
#~ "installs MariaDB\\*, which is a drop-"
|
||||
#~ "in replacement for MySQL\\*."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "|CL| is designed to be a "
|
||||
#~ "`stateless`_ operating system which means "
|
||||
#~ "that you must create an optional "
|
||||
#~ "configuration file to override the "
|
||||
#~ "default values. The default location of"
|
||||
#~ " the Apache configuration file, "
|
||||
#~ ":file:`httpd.conf`, is located in the "
|
||||
#~ ":file:`/usr/share/defaults/httpd` directory. |CL| "
|
||||
#~ "can override this directory as part "
|
||||
#~ "of the stateless paradigm. This default"
|
||||
#~ " :file:`.conf` file includes the following"
|
||||
#~ " directives that allow for additional "
|
||||
#~ "locations of configuration definitions:"
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
Reference in New Issue
Block a user