Merge pull request #661 from krisdale/rtd-theme

Updated .po files for translation.
This commit is contained in:
Kristal Dale
2019-07-22 13:44:42 -07:00
committed by GitHub
86 changed files with 17200 additions and 6194 deletions
@@ -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 ""
@@ -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 ""
@@ -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 ""
+263 -104
View File
@@ -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 ""
+6 -2
View File
@@ -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 systems 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 ""
+154 -93
View File
@@ -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
+151
View File
@@ -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 wont 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
+248
View File
@@ -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 ""
+196
View File
@@ -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 ""
+29 -1
View File
@@ -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 ""
+31 -11
View File
@@ -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 ""
@@ -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 ""
@@ -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 ""
@@ -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 ""
+263 -104
View File
@@ -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 ""
+6 -2
View File
@@ -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 systems 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 ""
+154 -93
View File
@@ -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 wont 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 ""
+29 -1
View File
@@ -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 ""
+31 -11
View File
@@ -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 ""