3118
3154
"connect via VNC to complete the installation."
3121
#: serverguide/C/virtualization.xml:189(para)
3157
#: serverguide/C/virtualization.xml:192(para)
3123
3159
"<emphasis>--noautoconsole:</emphasis> will not automatically connect to the "
3124
3160
"virtual machine's console."
3127
#: serverguide/C/virtualization.xml:194(para)
3163
#: serverguide/C/virtualization.xml:197(para)
3128
3164
msgid "<emphasis>-v:</emphasis> creates a fully virtualized guest."
3131
#: serverguide/C/virtualization.xml:199(para)
3167
#: serverguide/C/virtualization.xml:202(para)
3133
3169
"After launching <application>virt-install</application> you can connect to "
3134
3170
"the virtual machine's console either locally using a GUI (if your server has "
3135
3171
"a GUI), or via a remote VNC client from a GUI-based computer."
3138
#: serverguide/C/virtualization.xml:206(title)
3174
#: serverguide/C/virtualization.xml:209(title)
3139
3175
msgid "virt-clone"
3142
#: serverguide/C/virtualization.xml:208(para)
3178
#: serverguide/C/virtualization.xml:211(para)
3144
3180
"The <application>virt-clone</application> application can be used to copy "
3145
3181
"one virtual machine to another. For example:"
3148
#: serverguide/C/virtualization.xml:212(command)
3184
#: serverguide/C/virtualization.xml:215(command)
3150
"sudo virt-clone -o web_devel -n database_devel -f "
3151
"/path/to/database_devel.img \\ --connect=qemu:///system"
3186
"sudo virt-clone -o web_devel -n database_devel -f /path/to/database_devel.img"
3154
#: serverguide/C/virtualization.xml:218(para)
3189
#: serverguide/C/virtualization.xml:220(para)
3155
3190
msgid "<emphasis>-o:</emphasis> original virtual machine."
3158
#: serverguide/C/virtualization.xml:222(para)
3193
#: serverguide/C/virtualization.xml:224(para)
3159
3194
msgid "<emphasis>-n:</emphasis> name of the new virtual machine."
3162
#: serverguide/C/virtualization.xml:227(para)
3197
#: serverguide/C/virtualization.xml:229(para)
3164
3199
"<emphasis>-f:</emphasis> path to the file, logical volume, or partition to "
3165
3200
"be used by the new virtual machine."
3168
#: serverguide/C/virtualization.xml:232(para)
3170
"<emphasis>--connect:</emphasis> specifies which hypervisor to connect to."
3173
#: serverguide/C/virtualization.xml:237(para)
3203
#: serverguide/C/virtualization.xml:234(para)
3175
3205
"Also, use <emphasis>-d</emphasis> or <emphasis>--debug</emphasis> option to "
3176
3206
"help troubleshoot problems with <application>virt-clone</application>."
3179
#: serverguide/C/virtualization.xml:242(para)
3209
#: serverguide/C/virtualization.xml:239(para)
3181
3211
"Replace <emphasis>web_devel</emphasis> and "
3182
3212
"<emphasis>database_devel</emphasis> with appropriate virtual machine names."
3215
#: serverguide/C/virtualization.xml:246(title)
3216
msgid "Virtual Machine Management"
3185
3219
#: serverguide/C/virtualization.xml:249(title)
3186
msgid "Virtual Machine Management"
3189
#: serverguide/C/virtualization.xml:252(title)
3193
#: serverguide/C/virtualization.xml:254(para)
3223
#: serverguide/C/virtualization.xml:251(para)
3195
3225
"There are several utilities available to manage virtual machines and "
3196
3226
"<application>libvirt</application>. The <application>virsh</application> "
3197
3227
"utility can be used from the command line. Some examples:"
3200
#: serverguide/C/virtualization.xml:261(para)
3230
#: serverguide/C/virtualization.xml:258(para)
3201
3231
msgid "To list running virtual machines:"
3204
#: serverguide/C/virtualization.xml:264(command)
3205
msgid "virsh -c qemu:///system list"
3234
#: serverguide/C/virtualization.xml:261(command)
3208
#: serverguide/C/virtualization.xml:269(para)
3238
#: serverguide/C/virtualization.xml:266(para)
3209
3239
msgid "To start a virtual machine:"
3212
#: serverguide/C/virtualization.xml:272(command)
3213
msgid "virsh -c qemu:///system start web_devel"
3242
#: serverguide/C/virtualization.xml:269(command)
3243
msgid "virsh start web_devel"
3216
#: serverguide/C/virtualization.xml:277(para)
3246
#: serverguide/C/virtualization.xml:274(para)
3217
3247
msgid "Similarly, to start a virtual machine at boot:"
3220
#: serverguide/C/virtualization.xml:280(command)
3221
msgid "virsh -c qemu:///system autostart web_devel"
3250
#: serverguide/C/virtualization.xml:277(command)
3251
msgid "virsh autostart web_devel"
3224
#: serverguide/C/virtualization.xml:285(para)
3254
#: serverguide/C/virtualization.xml:282(para)
3225
3255
msgid "Reboot a virtual machine with:"
3228
#: serverguide/C/virtualization.xml:288(command)
3229
msgid "virsh -c qemu:///system reboot web_devel"
3258
#: serverguide/C/virtualization.xml:285(command)
3259
msgid "virsh reboot web_devel"
3232
#: serverguide/C/virtualization.xml:293(para)
3262
#: serverguide/C/virtualization.xml:290(para)
3234
3264
"The <emphasis>state</emphasis> of virtual machines can be saved to a file in "
3235
3265
"order to be restored later. The following will save the virtual machine "
3236
3266
"state into a file named according to the date:"
3239
#: serverguide/C/virtualization.xml:299(command)
3240
msgid "virsh -c qemu:///system save web_devel web_devel-022708.state"
3269
#: serverguide/C/virtualization.xml:296(command)
3270
msgid "virsh save web_devel web_devel-022708.state"
3243
#: serverguide/C/virtualization.xml:302(para)
3273
#: serverguide/C/virtualization.xml:299(para)
3244
3274
msgid "Once saved the virtual machine will no longer be running."
3247
#: serverguide/C/virtualization.xml:307(para)
3277
#: serverguide/C/virtualization.xml:304(para)
3248
3278
msgid "A saved virtual machine can be restored using:"
3251
#: serverguide/C/virtualization.xml:310(command)
3252
msgid "virsh -c qemu:///system restore web_devel-022708.state"
3281
#: serverguide/C/virtualization.xml:307(command)
3282
msgid "virsh restore web_devel-022708.state"
3255
#: serverguide/C/virtualization.xml:315(para)
3285
#: serverguide/C/virtualization.xml:312(para)
3256
3286
msgid "To shutdown a virtual machine do:"
3259
#: serverguide/C/virtualization.xml:318(command)
3260
msgid "virsh -c qemu:///system shutdown web_devel"
3289
#: serverguide/C/virtualization.xml:315(command)
3290
msgid "virsh shutdown web_devel"
3263
#: serverguide/C/virtualization.xml:323(para)
3293
#: serverguide/C/virtualization.xml:320(para)
3264
3294
msgid "A CDROM device can be mounted in a virtual machine by entering:"
3267
#: serverguide/C/virtualization.xml:327(command)
3268
msgid "virsh -c qemu:///system attach-disk web_devel /dev/cdrom /media/cdrom"
3297
#: serverguide/C/virtualization.xml:324(command)
3298
msgid "virsh attach-disk web_devel /dev/cdrom /media/cdrom"
3271
#: serverguide/C/virtualization.xml:333(para)
3301
#: serverguide/C/virtualization.xml:330(para)
3273
3303
"In the above examples replace <emphasis>web_devel</emphasis> with the "
3274
3304
"appropriate virtual machine name, and <filename>web_devel-"
3275
3305
"022708.state</filename> with a descriptive file name."
3308
#: serverguide/C/virtualization.xml:334(para)
3310
"If virsh (or other vir* tools) shall connect to something else than the "
3311
"default qemu-kvm/system hipervisor one can find alternatives for the "
3312
"<emphasis>connect</emphasis> option in <emphasis>man virsh</emphasis> or "
3313
"<ulink url=\"http://libvirt.org/uri.html\">libvirt doc</ulink>"
3278
3316
#: serverguide/C/virtualization.xml:341(title)
3320
#: serverguide/C/virtualization.xml:342(para)
3322
"There are different types of migration available depending on the versions "
3323
"of libvirt and the hipervisor being used. In general those types are:"
3326
#: serverguide/C/virtualization.xml:345(ulink)
3327
msgid "offline migration"
3330
#: serverguide/C/virtualization.xml:346(ulink)
3331
msgid "live migration"
3334
#: serverguide/C/virtualization.xml:347(ulink)
3335
msgid "postcopy migration"
3338
#: serverguide/C/virtualization.xml:349(para)
3340
"There are various options to those methods, but the entry point for all of "
3341
"them is <emphasis>virsh migrate</emphasis>. Read the integrated help for "
3345
#: serverguide/C/virtualization.xml:350(command)
3346
msgid "virsh migrate --help"
3349
#: serverguide/C/virtualization.xml:351(para)
3351
"Some useful documentation on constraints and considerations about live "
3352
"migration can be found at the <ulink "
3353
"url=\"https://wiki.ubuntu.com/QemuKVMMigration\">Ubuntu Wiki</ulink>"
3356
#: serverguide/C/virtualization.xml:355(title)
3279
3357
msgid "Virtual Machine Manager"
3282
#: serverguide/C/virtualization.xml:343(para)
3360
#: serverguide/C/virtualization.xml:357(para)
3284
3362
"The <application>virt-manager</application> package contains a graphical "
3285
3363
"utility to manage local and remote virtual machines. To install virt-manager "
3289
#: serverguide/C/virtualization.xml:348(command)
3367
#: serverguide/C/virtualization.xml:362(command)
3290
3368
msgid "sudo apt install virt-manager"
3293
#: serverguide/C/virtualization.xml:351(para)
3371
#: serverguide/C/virtualization.xml:365(para)
3295
3373
"Since <application>virt-manager</application> requires a Graphical User "
3296
3374
"Interface (GUI) environment it is recommended to be installed on a "
3338
#: serverguide/C/virtualization.xml:390(para)
3416
#: serverguide/C/virtualization.xml:404(para)
3340
3418
"To install <application>virt-viewer</application> from a terminal enter:"
3343
#: serverguide/C/virtualization.xml:394(command)
3421
#: serverguide/C/virtualization.xml:408(command)
3344
3422
msgid "sudo apt install virt-viewer"
3347
#: serverguide/C/virtualization.xml:397(para)
3425
#: serverguide/C/virtualization.xml:411(para)
3349
3427
"Once a virtual machine is installed and running you can connect to the "
3350
3428
"virtual machine's console by using:"
3353
#: serverguide/C/virtualization.xml:401(command)
3354
msgid "virt-viewer -c qemu:///system web_devel"
3431
#: serverguide/C/virtualization.xml:415(command)
3432
msgid "virt-viewer web_devel"
3357
#: serverguide/C/virtualization.xml:404(para)
3435
#: serverguide/C/virtualization.xml:418(para)
3359
3437
"Similar to <application>virt-manager</application>, <application>virt-"
3360
3438
"viewer</application> can connect to a remote host using "
3361
3439
"<emphasis>SSH</emphasis> with key authentication, as well:"
3364
#: serverguide/C/virtualization.xml:409(command)
3442
#: serverguide/C/virtualization.xml:423(command)
3365
3443
msgid "virt-viewer -c qemu+ssh://virtnode1.mydomain.com/system web_devel"
3368
#: serverguide/C/virtualization.xml:412(para)
3446
#: serverguide/C/virtualization.xml:426(para)
3370
3448
"Be sure to replace <emphasis role=\"italic\">web_devel</emphasis> with the "
3371
3449
"appropriate virtual machine name."
3374
#: serverguide/C/virtualization.xml:415(para)
3452
#: serverguide/C/virtualization.xml:429(para)
3376
3454
"If configured to use a <emphasis>bridged</emphasis> network interface you "
3377
3455
"can also setup <application>SSH</application> access to the virtual machine."
3380
#: serverguide/C/virtualization.xml:421(title) serverguide/C/virtualization.xml:674(title) serverguide/C/virtualization.xml:745(title) serverguide/C/virtualization.xml:2680(title) serverguide/C/samba.xml:247(title) serverguide/C/samba.xml:345(title) serverguide/C/samba.xml:700(title) serverguide/C/samba.xml:1094(title) serverguide/C/samba.xml:1292(title) serverguide/C/reporting-bugs.xml:252(title) serverguide/C/remote-administration.xml:414(title) serverguide/C/other-apps.xml:151(title) serverguide/C/other-apps.xml:305(title) serverguide/C/other-apps.xml:399(title) serverguide/C/network-config.xml:588(title) serverguide/C/network-config.xml:843(title) serverguide/C/network-config.xml:1691(title) serverguide/C/network-auth.xml:2140(title) serverguide/C/network-auth.xml:2673(title) serverguide/C/network-auth.xml:3389(title) serverguide/C/network-auth.xml:3942(title) serverguide/C/network-auth.xml:4177(title) serverguide/C/installation.xml:880(title) serverguide/C/installation.xml:1166(title) serverguide/C/installation.xml:1677(title) serverguide/C/databases.xml:264(title) serverguide/C/databases.xml:419(title) serverguide/C/cgroups.xml:198(title) serverguide/C/backups.xml:870(title)
3458
#: serverguide/C/virtualization.xml:435(title) serverguide/C/virtualization.xml:742(title) serverguide/C/virtualization.xml:813(title) serverguide/C/virtualization.xml:2748(title) serverguide/C/samba.xml:247(title) serverguide/C/samba.xml:345(title) serverguide/C/samba.xml:700(title) serverguide/C/samba.xml:1094(title) serverguide/C/samba.xml:1292(title) serverguide/C/reporting-bugs.xml:252(title) serverguide/C/remote-administration.xml:414(title) serverguide/C/other-apps.xml:151(title) serverguide/C/other-apps.xml:305(title) serverguide/C/other-apps.xml:399(title) serverguide/C/network-config.xml:588(title) serverguide/C/network-config.xml:843(title) serverguide/C/network-config.xml:1945(title) serverguide/C/network-auth.xml:2140(title) serverguide/C/network-auth.xml:2666(title) serverguide/C/network-auth.xml:3382(title) serverguide/C/network-auth.xml:3935(title) serverguide/C/network-auth.xml:4170(title) serverguide/C/installation.xml:880(title) serverguide/C/installation.xml:1166(title) serverguide/C/installation.xml:1677(title) serverguide/C/databases.xml:264(title) serverguide/C/databases.xml:419(title) serverguide/C/cgroups.xml:198(title) serverguide/C/backups.xml:870(title)
3381
3459
msgid "Resources"
3384
#: serverguide/C/virtualization.xml:425(para)
3462
#: serverguide/C/virtualization.xml:439(para)
3386
3464
"See the <ulink url=\"http://www.linux-kvm.org/\">KVM</ulink> home page for "
3387
3465
"more details."
3390
#: serverguide/C/virtualization.xml:430(para)
3468
#: serverguide/C/virtualization.xml:444(para)
3392
3470
"For more information on <application>libvirt</application> see the <ulink "
3393
3471
"url=\"http://libvirt.org/\">libvirt home page</ulink>"
3396
#: serverguide/C/virtualization.xml:436(para)
3474
#: serverguide/C/virtualization.xml:450(para)
3398
3476
"The <ulink url=\"http://virt-manager.org/\">Virtual Machine Manager</ulink> "
3399
3477
"site has more information on <application>virt-manager</application> "
3403
#: serverguide/C/virtualization.xml:442(para)
3481
#: serverguide/C/virtualization.xml:456(para)
3405
3483
"Also, stop by the <emphasis>#ubuntu-virt</emphasis> IRC channel on <ulink "
3406
3484
"url=\"http://freenode.net/\">freenode</ulink> to discuss virtualization "
3407
3485
"technology in Ubuntu."
3410
#: serverguide/C/virtualization.xml:448(para)
3488
#: serverguide/C/virtualization.xml:462(para)
3412
3490
"Another good resource is the <ulink "
3413
3491
"url=\"https://help.ubuntu.com/community/KVM\">Ubuntu Wiki KVM</ulink> page."
3416
#: serverguide/C/virtualization.xml:454(para)
3494
#: serverguide/C/virtualization.xml:468(para)
3418
3496
"For information on Xen, including using Xen with libvirt, please see the "
3419
3497
"<ulink url=\"https://help.ubuntu.com/community/Xen\">Ubuntu Wiki Xen</ulink> "
3423
#: serverguide/C/virtualization.xml:464(title)
3501
#: serverguide/C/virtualization.xml:478(title)
3505
#: serverguide/C/virtualization.xml:479(para)
3507
"<ulink url=\"http://wiki.qemu.org/Main_Page\">Qemu</ulink> is a machine "
3508
"emulator that can run operating systems and programs for one machine on a "
3509
"different machine. Mostly it is not used as emulator but as virtualizer in "
3510
"collaboration with KVM or XEN kernel components. In that case it utilizes "
3511
"the virtualization technology of the hardware to virtualize guests."
3514
#: serverguide/C/virtualization.xml:483(para)
3516
"While qemu has a <ulink url=\"http://wiki.qemu.org/download/qemu-"
3517
"doc.html#sec_005finvocation\">command line interface</ulink> and a <ulink "
3518
"url=\"http://wiki.qemu.org/download/qemu-"
3519
"doc.html#pcsys_005fmonitor\">monitor</ulink> to interact with running guests "
3520
"those is rarely used that way for other means than development purposes. "
3521
"<link linkend=\"libvirt\">Libvirt</link> provides an abstraction from "
3522
"specific versions and hiperviors and encapsulates some workarounds and best "
3526
#: serverguide/C/virtualization.xml:488(title)
3527
msgid "Upgrading the machine type"
3530
#: serverguide/C/virtualization.xml:489(para)
3532
"This also is documented along some more constraints and considerations at "
3534
"url=\"https://wiki.ubuntu.com/QemuKVMMigration#Upgrade_machine_type\">Ubuntu "
3538
#: serverguide/C/virtualization.xml:490(para)
3540
"You might want to update your machine type of an existing defined guest to:"
3543
#: serverguide/C/virtualization.xml:492(para)
3544
msgid "to pick up latest security fixes and features"
3547
#: serverguide/C/virtualization.xml:493(para)
3548
msgid "continue using a guest created on a now unsupported release"
3551
#: serverguide/C/virtualization.xml:495(para)
3553
"In general it is recommended to update machine types when upgrading qemu/kvm "
3554
"to a new major version. But this can likely never be an automated task as "
3555
"this change is guest visible. The guest devices might change in appearance, "
3556
"new features will be announced to the guest and so on. Linux is usually very "
3557
"good at tolerating such changes, but it depends so much on the setup and "
3558
"workload of the guest that this has to be evaluated by the owner/admin of "
3559
"the system. Other operating systems where known to often have severe impacts "
3560
"by changing the hardware. Consider a machine type change similar to "
3561
"replacing all devices and firmware of a physical machine to the latest "
3562
"revision - all considerations that apply there apply to evaluating a machine "
3563
"type upgrade as well."
3566
#: serverguide/C/virtualization.xml:496(para)
3568
"As usual with major configuration changes it is wise to back up your guest "
3569
"definition and disk state to be able to do a rollback just in case. There is "
3570
"no integrated single command to update the machine type via virsh or similar "
3571
"tools. It is a normal part of your machine definition. And therefore updated "
3572
"the same way as most others."
3575
#: serverguide/C/virtualization.xml:498(para)
3576
msgid "First shutdown your machine and wait until it has reached that state."
3579
#: serverguide/C/virtualization.xml:499(screen)
3583
"virsh shutdown <yourmachine>\n"
3585
"virsh list --inactive\n"
3586
"# should now list your machine as \"shut off\"\n"
3590
#: serverguide/C/virtualization.xml:505(para)
3592
"Then edit the machine definition and find the type in the type tag at the "
3593
"machine attribute."
3596
#: serverguide/C/virtualization.xml:506(screen)
3600
"virsh edit <yourmachine>\n"
3601
"<type arch='x86_64' machine='pc-i440fx-xenial'>hvm</type>\n"
3605
#: serverguide/C/virtualization.xml:510(para)
3607
"Change this to the value you want. If you need to check what types are "
3608
"available via \"-M ?\" Note that while providing upstream types as "
3609
"convenience only Ubuntu types are supported. There you can also see what the "
3610
"current default would be. In general it is strongly recommended that you "
3611
"change to newer types if possible to exploit newer features, but also to "
3612
"benefit of bugfixes that only apply to the newer device virtualization."
3615
#: serverguide/C/virtualization.xml:511(screen)
3620
"# lists machine types, e.g.\n"
3621
"pc-i440fx-xenial Ubuntu 16.04 PC (i440FX + PIIX, 1996) (default)\n"
3626
#: serverguide/C/virtualization.xml:517(para)
3628
"After this you can start your guest again. You can check the current machine "
3629
"type from guest and host depending on your needs."
3632
#: serverguide/C/virtualization.xml:518(screen)
3636
"virsh start <yourmachine>\n"
3637
"# check from host, via dumping the active xml definition\n"
3638
"virsh dumpxml <yourmachine> | xmllint --xpath "
3639
"\"string(//domain/os/type/@machine)\" -\n"
3640
"# or from the guest via dmidecode\n"
3641
"sudo dmidecode | grep Product -A 1\n"
3642
" Product Name: Standard PC (i440FX + PIIX, 1996)\n"
3643
" Version: pc-i440fx-xenial\n"
3647
#: serverguide/C/virtualization.xml:527(para)
3649
"If you keep non-live definitions around like xml files remember to update "
3653
#: serverguide/C/virtualization.xml:532(title)
3424
3654
msgid "Cloud images and uvtool"
3427
#: serverguide/C/virtualization.xml:467(title) serverguide/C/security.xml:366(title) serverguide/C/samba.xml:23(title) serverguide/C/remote-administration.xml:18(title) serverguide/C/package-management.xml:18(title) serverguide/C/introduction.xml:11(title) serverguide/C/installation.xml:1374(title)
3657
#: serverguide/C/virtualization.xml:535(title) serverguide/C/security.xml:366(title) serverguide/C/samba.xml:23(title) serverguide/C/remote-administration.xml:18(title) serverguide/C/package-management.xml:18(title) serverguide/C/introduction.xml:11(title) serverguide/C/installation.xml:1374(title)
3428
3658
msgid "Introduction"
3431
#: serverguide/C/virtualization.xml:469(para)
3661
#: serverguide/C/virtualization.xml:537(para)
3433
3663
"With Ubuntu being one of the most used operating systems on many cloud "
3434
3664
"platforms, the availability of stable and secure cloud images has become "
3694
#: serverguide/C/virtualization.xml:639(title)
3924
#: serverguide/C/virtualization.xml:707(title)
3695
3925
msgid "Get the list of running VMs"
3698
#: serverguide/C/virtualization.xml:640(para)
3928
#: serverguide/C/virtualization.xml:708(para)
3699
3929
msgid "You can get the list of VMs running on your system with this command:"
3702
#: serverguide/C/virtualization.xml:642(programlisting)
3932
#: serverguide/C/virtualization.xml:710(programlisting)
3705
3935
"$ uvt-kvm list\n"
3709
#: serverguide/C/virtualization.xml:647(title)
3939
#: serverguide/C/virtualization.xml:715(title)
3710
3940
msgid "Destroy your VM"
3713
#: serverguide/C/virtualization.xml:648(para)
3943
#: serverguide/C/virtualization.xml:716(para)
3714
3944
msgid "Once you are done with your VM, you can destroy it with:"
3717
#: serverguide/C/virtualization.xml:650(programlisting)
3947
#: serverguide/C/virtualization.xml:718(programlisting)
3719
3949
msgid "$ uvt-kvm destroy secondtest"
3722
#: serverguide/C/virtualization.xml:652(title)
3952
#: serverguide/C/virtualization.xml:720(title)
3723
3953
msgid "More uvt-kvm options"
3726
#: serverguide/C/virtualization.xml:654(para)
3956
#: serverguide/C/virtualization.xml:722(para)
3728
3958
"The following options can be used to change some of the characteristics of "
3729
3959
"the VM that you are creating:"
3732
#: serverguide/C/virtualization.xml:657(para)
3962
#: serverguide/C/virtualization.xml:725(para)
3733
3963
msgid "--memory : Amount of RAM in megabytes. Default: 512."
3736
#: serverguide/C/virtualization.xml:658(para)
3966
#: serverguide/C/virtualization.xml:726(para)
3737
3967
msgid "--disk : Size of the OS disk in gigabytes. Default: 8."
3740
#: serverguide/C/virtualization.xml:659(para)
3970
#: serverguide/C/virtualization.xml:727(para)
3741
3971
msgid "--cpu : Number of CPU cores. Default: 1."
3744
#: serverguide/C/virtualization.xml:662(para)
3974
#: serverguide/C/virtualization.xml:730(para)
3746
3976
"Some other parameters will have an impact on the cloud-init configuration:"
3749
#: serverguide/C/virtualization.xml:664(para)
3979
#: serverguide/C/virtualization.xml:732(para)
3751
3981
"--password password : Allow login to the VM using the Ubuntu account and "
3752
3982
"this provided password."
3755
#: serverguide/C/virtualization.xml:665(para)
3985
#: serverguide/C/virtualization.xml:733(para)
3757
3987
"--run-script-once script_file : Run script_file as root on the VM the first "
3758
3988
"time it is booted, but never again."
3761
#: serverguide/C/virtualization.xml:666(para)
3991
#: serverguide/C/virtualization.xml:734(para)
3763
3993
"--packages package_list : Install the comma-separated packages specified in "
3764
3994
"package_list on first boot."
3767
#: serverguide/C/virtualization.xml:669(para)
3997
#: serverguide/C/virtualization.xml:737(para)
3769
3999
"A complete description of all available modifiers is available in the "
3770
4000
"manpage of uvt-kvm."
3773
#: serverguide/C/virtualization.xml:676(para)
4003
#: serverguide/C/virtualization.xml:744(para)
3775
4005
"If you are interested in learning more, have questions or suggestions, "
3776
4006
"please contact the Ubuntu Server Team at:"
3779
#: serverguide/C/virtualization.xml:681(para)
4009
#: serverguide/C/virtualization.xml:749(para)
3780
4010
msgid "IRC: #ubuntu-server on freenode"
3783
#: serverguide/C/virtualization.xml:685(para)
4013
#: serverguide/C/virtualization.xml:753(para)
3785
4015
"Mailing list: <ulink url=\"https://lists.ubuntu.com/mailman/listinfo/ubuntu-"
3786
4016
"server\">ubuntu-server at lists.ubuntu.com</ulink>"
3789
#: serverguide/C/virtualization.xml:694(title)
4019
#: serverguide/C/virtualization.xml:762(title)
3790
4020
msgid "Ubuntu Cloud"
3793
#: serverguide/C/virtualization.xml:696(para)
4023
#: serverguide/C/virtualization.xml:764(para)
3795
4025
"<application>Cloud computing</application> is a computing model that allows "
3796
4026
"vast pools of resources to be allocated on-demand. These resources such as "
4084
4314
"the desired architecture:"
4087
#: serverguide/C/virtualization.xml:988(command)
4317
#: serverguide/C/virtualization.xml:1056(command)
4088
4318
msgid "lxc image info ubuntu:lts/arm64"
4091
#: serverguide/C/virtualization.xml:993(para)
4321
#: serverguide/C/virtualization.xml:1061(para)
4092
4322
msgid "Now, let's start our first container:"
4095
#: serverguide/C/virtualization.xml:998(command)
4325
#: serverguide/C/virtualization.xml:1066(command)
4096
4326
msgid "lxc launch ubuntu:xenial x1"
4099
#: serverguide/C/virtualization.xml:1003(para)
4329
#: serverguide/C/virtualization.xml:1071(para)
4101
4331
"This will download the official current Xenial cloud image for your current "
4102
4332
"architecture, then create a container using that image, and finally start "
4103
4333
"it. Once the command returns, you can see it using:"
4106
#: serverguide/C/virtualization.xml:1010(command)
4336
#: serverguide/C/virtualization.xml:1078(command)
4107
4337
msgid "lxc list lxc info x1"
4110
#: serverguide/C/virtualization.xml:1016(para)
4340
#: serverguide/C/virtualization.xml:1084(para)
4111
4341
msgid "and open a shell in it using:"
4114
#: serverguide/C/virtualization.xml:1021(command)
4344
#: serverguide/C/virtualization.xml:1089(command)
4115
4345
msgid "lxc exec x1 bash"
4118
#: serverguide/C/virtualization.xml:1026(para)
4348
#: serverguide/C/virtualization.xml:1094(para)
4120
4350
"The try-it page gives a full synopsis of the commands you can use to "
4121
4351
"administer containers."
4124
#: serverguide/C/virtualization.xml:1031(para)
4354
#: serverguide/C/virtualization.xml:1099(para)
4126
4356
"Now that the 'xenial' image has been downloaded, it will be kept in sync "
4127
4357
"until no new containers have been created based on it for (by default) 10 "
4128
4358
"days. After that, it will be deleted."
4131
#: serverguide/C/virtualization.xml:1039(title)
4361
#: serverguide/C/virtualization.xml:1107(title)
4132
4362
msgid "LXD Server Configuration"
4135
#: serverguide/C/virtualization.xml:1041(para)
4365
#: serverguide/C/virtualization.xml:1109(para)
4137
4367
"By default, LXD is socket activated and configured to listen only on a local "
4138
4368
"UNIX socket. While LXD may not be running when you first look at the process "
4139
4369
"listing, any LXC command will start it up. For instance:"
4142
#: serverguide/C/virtualization.xml:1048(command)
4372
#: serverguide/C/virtualization.xml:1116(command)
4143
4373
msgid "lxc list"
4146
#: serverguide/C/virtualization.xml:1053(para)
4376
#: serverguide/C/virtualization.xml:1121(para)
4148
4378
"This will create your client certificate and contact the LXD server for a "
4149
4379
"list of containers. To make the server accessible over the network you can "
4150
4380
"set the http port using:"
4153
#: serverguide/C/virtualization.xml:1060(command)
4383
#: serverguide/C/virtualization.xml:1128(command)
4154
4384
msgid "lxc config set core.https_address :8443"
4157
#: serverguide/C/virtualization.xml:1065(para)
4387
#: serverguide/C/virtualization.xml:1133(para)
4158
4388
msgid "This will tell LXD to listen to port 8843 on all addresses."
4161
#: serverguide/C/virtualization.xml:1069(title)
4391
#: serverguide/C/virtualization.xml:1137(title)
4162
4392
msgid "Authentication"
4165
#: serverguide/C/virtualization.xml:1071(para)
4395
#: serverguide/C/virtualization.xml:1139(para)
4167
4397
"By default, LXD will allow all members of group 'lxd' (which by default "
4168
4398
"includes all members of group admin) to talk to it over the UNIX socket. "
4373
4603
"must be set to true:"
4376
#: serverguide/C/virtualization.xml:1289(command)
4606
#: serverguide/C/virtualization.xml:1357(command)
4377
4607
msgid "lxc config set container1 security.nesting true"
4380
#: serverguide/C/virtualization.xml:1294(para)
4610
#: serverguide/C/virtualization.xml:1362(para)
4381
4611
msgid "Once this is done, container1 will be able to start sub-containers."
4384
#: serverguide/C/virtualization.xml:1298(para)
4614
#: serverguide/C/virtualization.xml:1366(para)
4386
4616
"In order to run unprivileged (the default in LXD) containers nested under an "
4387
4617
"unprivileged container, you will need to ensure a wide enough UID mapping. "
4388
4618
"Please see the 'UID mapping' section below."
4391
#: serverguide/C/virtualization.xml:1304(title)
4621
#: serverguide/C/virtualization.xml:1372(title)
4395
#: serverguide/C/virtualization.xml:1306(para)
4625
#: serverguide/C/virtualization.xml:1374(para)
4397
4627
"In order to facilitate running docker containers inside a LXD container, a "
4398
4628
"'docker' profile is provided. To launch a new container with the docker "
4399
4629
"profile, you can run:"
4402
#: serverguide/C/virtualization.xml:1313(command)
4632
#: serverguide/C/virtualization.xml:1381(command)
4403
4633
msgid "lxc launch xenial container1 -p default -p docker"
4406
#: serverguide/C/virtualization.xml:1318(para)
4636
#: serverguide/C/virtualization.xml:1386(para)
4408
4638
"Note that currently the docker package in Ubuntu 16.04 is patched to "
4409
4639
"facilitate running in a container. This support is expected to land upstream "
4413
#: serverguide/C/virtualization.xml:1324(para)
4643
#: serverguide/C/virtualization.xml:1392(para)
4415
4645
"Note that 'cgroup namespace' support is also required. This is available in "
4416
4646
"the 16.04 kernel as well as in the 4.6 upstream source."
4419
#: serverguide/C/virtualization.xml:1333(title)
4649
#: serverguide/C/virtualization.xml:1401(title)
4423
#: serverguide/C/virtualization.xml:1335(para)
4653
#: serverguide/C/virtualization.xml:1403(para)
4425
4655
"LXD supports flexible constraints on the resources which containers can "
4426
4656
"consume. The limits come in the following categories:"
4429
#: serverguide/C/virtualization.xml:1342(para)
4659
#: serverguide/C/virtualization.xml:1410(para)
4430
4660
msgid "CPU: limit cpu available to the container in several ways."
4433
#: serverguide/C/virtualization.xml:1345(para)
4663
#: serverguide/C/virtualization.xml:1413(para)
4434
4664
msgid "Disk: configure the priority of I/O requests under load"
4437
#: serverguide/C/virtualization.xml:1348(para)
4667
#: serverguide/C/virtualization.xml:1416(para)
4438
4668
msgid "RAM: configure memory and swap availability"
4441
#: serverguide/C/virtualization.xml:1351(para)
4671
#: serverguide/C/virtualization.xml:1419(para)
4442
4672
msgid "Network: configure the network priority under load"
4445
#: serverguide/C/virtualization.xml:1354(para)
4675
#: serverguide/C/virtualization.xml:1422(para)
4446
4676
msgid "Processes: limit the number of concurrent processes in the container."
4449
#: serverguide/C/virtualization.xml:1358(para)
4679
#: serverguide/C/virtualization.xml:1426(para)
4451
4681
"For a full list of limits known to LXD, see <ulink "
4452
4682
"url=\"https://github.com/lxc/lxd/blob/master/doc/configuration.md\"> the "
4453
4683
"configuration documentation</ulink>."
4456
#: serverguide/C/virtualization.xml:1366(title)
4686
#: serverguide/C/virtualization.xml:1434(title)
4457
4687
msgid "UID mappings and Privileged containers"
4460
#: serverguide/C/virtualization.xml:1368(para)
4690
#: serverguide/C/virtualization.xml:1436(para)
4462
4692
"By default, LXD creates unprivileged containers. This means that root in the "
4463
4693
"container is a non-root UID on the host. It is privileged against the "
4546
4776
".html\"> the lxc.container.conf(5) manual page</ulink>."
4549
#: serverguide/C/virtualization.xml:1457(title)
4779
#: serverguide/C/virtualization.xml:1525(title)
4550
4780
msgid "Images and containers"
4553
#: serverguide/C/virtualization.xml:1459(para)
4783
#: serverguide/C/virtualization.xml:1527(para)
4555
4785
"LXD is image based. When you create your first container, you will generally "
4556
4786
"do so using an existing image. LXD comes pre-configured with three default "
4557
4787
"image remotes:"
4560
#: serverguide/C/virtualization.xml:1467(para)
4790
#: serverguide/C/virtualization.xml:1535(para)
4562
4792
"ubuntu: This is a <ulink "
4563
4793
"url=\"https://launchpad.net/simplestreams\">simplestreams-based</ulink> "
4564
4794
"remote serving released ubuntu cloud images."
4567
#: serverguide/C/virtualization.xml:1472(para)
4797
#: serverguide/C/virtualization.xml:1540(para)
4569
4799
"ubuntu-daily: This is another simplestreams based remote which serves "
4570
4800
"'daily' ubuntu cloud images. These provide quicker but potentially less "
4571
4801
"stable images."
4574
#: serverguide/C/virtualization.xml:1478(para)
4804
#: serverguide/C/virtualization.xml:1546(para)
4576
4806
"images: This is a remote publishing best-effort container images for many "
4577
4807
"distributions, created using community-provided build scripts."
4580
#: serverguide/C/virtualization.xml:1483(para)
4810
#: serverguide/C/virtualization.xml:1551(para)
4581
4811
msgid "To view the images available on one of these servers, you can use:"
4584
#: serverguide/C/virtualization.xml:1493(para)
4814
#: serverguide/C/virtualization.xml:1561(para)
4586
4816
"Most of the images are known by several aliases for easier reference. To see "
4587
4817
"the full list of aliases, you can use"
4590
#: serverguide/C/virtualization.xml:1499(command)
4820
#: serverguide/C/virtualization.xml:1567(command)
4591
4821
msgid "lxc image alias list images:"
4594
#: serverguide/C/virtualization.xml:1504(para)
4824
#: serverguide/C/virtualization.xml:1572(para)
4596
4826
"Any alias or image fingerprint can be used to specify how to create the new "
4597
4827
"container. For instance, to create an amd64 Ubuntu 14.04 container, some "
4601
#: serverguide/C/virtualization.xml:1511(command)
4831
#: serverguide/C/virtualization.xml:1579(command)
4603
4833
"lxc launch ubuntu:14.04 trusty1 lxc launch ubuntu:trusty trusty1 lxc launch "
4604
4834
"ubuntu:trusty/amd64 trusty1 lxc launch ubuntu:lts trusty1"
4607
#: serverguide/C/virtualization.xml:1519(para)
4837
#: serverguide/C/virtualization.xml:1587(para)
4608
4838
msgid "The 'lts' alias always refers to the latest released LTS image."
4611
#: serverguide/C/virtualization.xml:1523(title) serverguide/C/virtualization.xml:2352(title)
4841
#: serverguide/C/virtualization.xml:1591(title) serverguide/C/virtualization.xml:2420(title)
4612
4842
msgid "Snapshots"
4615
#: serverguide/C/virtualization.xml:1525(para)
4845
#: serverguide/C/virtualization.xml:1593(para)
4617
4847
"Containers can be renamed and live-migrated using the 'lxc move' command:"
4620
#: serverguide/C/virtualization.xml:1530(command)
4850
#: serverguide/C/virtualization.xml:1598(command)
4621
4851
msgid "lxc move c1 final-beta"
4624
#: serverguide/C/virtualization.xml:1535(para)
4854
#: serverguide/C/virtualization.xml:1603(para)
4625
4855
msgid "They can also be snapshotted:"
4628
#: serverguide/C/virtualization.xml:1540(command)
4858
#: serverguide/C/virtualization.xml:1608(command)
4629
4859
msgid "lxc snapshot c1 YYYY-MM-DD"
4632
#: serverguide/C/virtualization.xml:1545(para)
4862
#: serverguide/C/virtualization.xml:1613(para)
4633
4863
msgid "Later changes to c1 can then be reverted by restoring the snapshot:"
4636
#: serverguide/C/virtualization.xml:1550(command)
4866
#: serverguide/C/virtualization.xml:1618(command)
4637
4867
msgid "lxc restore u1 YYYY-MM-DD"
4640
#: serverguide/C/virtualization.xml:1555(para)
4870
#: serverguide/C/virtualization.xml:1623(para)
4642
4872
"New containers can also be created by copying a container or snapshot:"
4645
#: serverguide/C/virtualization.xml:1560(command)
4875
#: serverguide/C/virtualization.xml:1628(command)
4646
4876
msgid "lxc copy u1/YYYY-MM-DD testcontainer"
4649
#: serverguide/C/virtualization.xml:1567(title)
4879
#: serverguide/C/virtualization.xml:1635(title)
4650
4880
msgid "Publishing images"
4653
#: serverguide/C/virtualization.xml:1569(para)
4883
#: serverguide/C/virtualization.xml:1637(para)
4655
4885
"When a container or container snapshot is ready for consumption by others, "
4656
4886
"it can be published as a new image using;"
4659
#: serverguide/C/virtualization.xml:1575(command)
4889
#: serverguide/C/virtualization.xml:1643(command)
4660
4890
msgid "lxc publish u1/YYYY-MM-DD --alias foo-2.0"
4663
#: serverguide/C/virtualization.xml:1580(para)
4893
#: serverguide/C/virtualization.xml:1648(para)
4665
4895
"The published image will be private by default, meaning that LXD will not "
4666
4896
"allow clients without a trusted certificate to see them. If the image is "
15579
15877
"installation\" at the end of this document for more."
15582
#: serverguide/C/network-config.xml:1654(para)
15880
#: serverguide/C/network-config.xml:1692(para)
15584
15882
"As usual with tunings you have to know your system and workload really well -"
15585
15883
" so please verify any tunings with workloads matching your real use case."
15588
#: serverguide/C/network-config.xml:1661(para)
15886
#: serverguide/C/network-config.xml:1699(para)
15590
15888
"DPDK is a fast evolving project. In any case of a search for support and "
15591
15889
"further guides it is highly recommended to first check if they apply to the "
15592
15890
"current version."
15595
#: serverguide/C/network-config.xml:1668(ulink)
15893
#: serverguide/C/network-config.xml:1707(ulink)
15596
15894
msgid "DPDK Mailing Lists"
15599
#: serverguide/C/network-config.xml:1672(para)
15897
#: serverguide/C/network-config.xml:1711(para)
15601
15899
"For OpenVswitch-DPDK <ulink url=\"http://openvswitch.org/mlists\">OpenStack "
15602
15900
"Mailing Lists</ulink>"
15605
#: serverguide/C/network-config.xml:1677(para)
15903
#: serverguide/C/network-config.xml:1716(para)
15607
15905
"Known issues in <ulink "
15608
15906
"url=\"https://bugs.launchpad.net/ubuntu/+source/dpdk\">DPDK Launchpad "
15609
15907
"Area</ulink>"
15612
#: serverguide/C/network-config.xml:1682(para)
15910
#: serverguide/C/network-config.xml:1721(para)
15613
15911
msgid "Join the IRC channels #DPDK or #openvswitch on freenode."
15616
#: serverguide/C/network-config.xml:1696(ulink)
15914
#: serverguide/C/network-config.xml:1727(para)
15916
"Issues are often due to missing small details in the general setup. Later "
15917
"on, these missing details cause problems which can be hard to track down to "
15918
"their root cause. A common case seems to be the \"could not open network "
15919
"device dpdk0 (No such device)\" issue. This occurs rather late when setting "
15920
"up a port in Open vSwitch with DPDK. But the root cause most of the time is "
15921
"very early in the setup and initialization. Here an example how a proper "
15922
"initialization of a device looks - this can be found in the syslog/journal "
15923
"when starting Open vSwitch with DPDK enabled."
15926
#: serverguide/C/network-config.xml:1738(programlisting)
15930
"ovs-ctl[3560]: EAL: PCI device 0000:04:00.1 on NUMA socket 0\n"
15931
"ovs-ctl[3560]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
15932
"ovs-ctl[3560]: EAL: PCI memory mapped at 0x7f2140000000\n"
15933
"ovs-ctl[3560]: EAL: PCI memory mapped at 0x7f2140200000\n"
15937
#: serverguide/C/network-config.xml:1745(para)
15939
"If this is missing, either by ignored cards, failed initialization or other "
15940
"reasons, later on there will be no DPDK device to refer to. Unfortunately "
15941
"the logging is spread across syslog/journal and the openvswitch log. To "
15942
"allow some cross checking here an example what can be found in these logs, "
15943
"relative to the entered command."
15946
#: serverguide/C/network-config.xml:1753(programlisting)
15950
"#Note: This log was taken with dpdk 2.2 and openvswitch 2.5\n"
15952
"CMD: that you enter\n"
15953
"SYSLOG: (Inlcuding EAL and OVS Messages)\n"
15954
"OVS-LOG: (Openvswitch messages)\n"
15957
"Bind an interface to DPDK UIO drivers, make Hugepages available, enable DPDK "
15960
"CMD: sudo service openvswitch-switch restart\n"
15963
"2016-01-22T08:58:31.372Z|00003|daemon_unix(monitor)|INFO|pid 3329 died, "
15964
"killed (Terminated), exiting\n"
15965
"2016-01-22T08:58:33.377Z|00002|vlog|INFO|opened log file "
15966
"/var/log/openvswitch/ovs-vswitchd.log\n"
15967
"2016-01-22T08:58:33.381Z|00003|ovs_numa|INFO|Discovered 12 CPU cores on NUMA "
15969
"2016-01-22T08:58:33.381Z|00004|ovs_numa|INFO|Discovered 1 NUMA nodes and 12 "
15972
"22T08:58:33.381Z|00005|reconnect|INFO|unix:/var/run/openvswitch/db.sock: "
15975
"22T08:58:33.383Z|00006|reconnect|INFO|unix:/var/run/openvswitch/db.sock: "
15977
"2016-01-22T08:58:33.386Z|00007|bridge|INFO|ovs-vswitchd (Open vSwitch) "
15981
"systemd[1]: Stopping Open vSwitch...\n"
15982
"systemd[1]: Stopped Open vSwitch.\n"
15983
"systemd[1]: Stopping Open vSwitch Internal Unit...\n"
15984
"ovs-ctl[3541]: * Killing ovs-vswitchd (3329)\n"
15985
"ovs-ctl[3541]: * Killing ovsdb-server (3318)\n"
15986
"systemd[1]: Stopped Open vSwitch Internal Unit.\n"
15987
"systemd[1]: Starting Open vSwitch Internal Unit...\n"
15988
"ovs-ctl[3560]: * Starting ovsdb-server\n"
15989
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl --no-wait -- init -- set "
15990
"Open_vSwitch . db-version=7.12.1\n"
15991
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl --no-wait set "
15992
"Open_vSwitch . ovs-version=2.5.0 \"external-ids:system-id=\\\"e7c5ba80-bb14-"
15993
"45c1-b8eb-628f3ad03903\\\"\" \"system-type=\\\"Ubuntu\\\"\" \"system-"
15994
"version=\\\"16.04-xenial\\\"\"\n"
15995
"ovs-ctl[3560]: * Configuring Open vSwitch system IDs\n"
15996
"ovs-ctl[3560]: 2016-01-22T08:58:31Z|00001|dpdk|INFO|No -vhost_sock_dir "
15997
"provided - defaulting to /var/run/openvswitch\n"
15998
"ovs-vswitchd: ovs|00001|dpdk|INFO|No -vhost_sock_dir provided - defaulting "
15999
"to /var/run/openvswitch\n"
16000
"ovs-ctl[3560]: EAL: Detected lcore 0 as core 0 on socket 0\n"
16001
"ovs-ctl[3560]: EAL: Detected lcore 1 as core 1 on socket 0\n"
16002
"ovs-ctl[3560]: EAL: Detected lcore 2 as core 2 on socket 0\n"
16003
"ovs-ctl[3560]: EAL: Detected lcore 3 as core 3 on socket 0\n"
16004
"ovs-ctl[3560]: EAL: Detected lcore 4 as core 4 on socket 0\n"
16005
"ovs-ctl[3560]: EAL: Detected lcore 5 as core 5 on socket 0\n"
16006
"ovs-ctl[3560]: EAL: Detected lcore 6 as core 0 on socket 0\n"
16007
"ovs-ctl[3560]: EAL: Detected lcore 7 as core 1 on socket 0\n"
16008
"ovs-ctl[3560]: EAL: Detected lcore 8 as core 2 on socket 0\n"
16009
"ovs-ctl[3560]: EAL: Detected lcore 9 as core 3 on socket 0\n"
16010
"ovs-ctl[3560]: EAL: Detected lcore 10 as core 4 on socket 0\n"
16011
"ovs-ctl[3560]: EAL: Detected lcore 11 as core 5 on socket 0\n"
16012
"ovs-ctl[3560]: EAL: Support maximum 128 logical core(s) by configuration.\n"
16013
"ovs-ctl[3560]: EAL: Detected 12 lcore(s)\n"
16014
"ovs-ctl[3560]: EAL: VFIO modules not all loaded, skip VFIO support...\n"
16015
"ovs-ctl[3560]: EAL: Setting up physically contiguous memory...\n"
16016
"ovs-ctl[3560]: EAL: Ask a virtual area of 0x100000000 bytes\n"
16017
"ovs-ctl[3560]: EAL: Virtual area found at 0x7f2040000000 (size = "
16019
"ovs-ctl[3560]: EAL: Requesting 4 pages of size 1024MB from socket 0\n"
16020
"ovs-ctl[3560]: EAL: TSC frequency is ~2397202 KHz\n"
16021
"ovs-vswitchd[3592]: EAL: TSC frequency is ~2397202 KHz\n"
16022
"ovs-vswitchd[3592]: EAL: Master lcore 0 is ready (tid=fc6cbb00;cpuset=[0])\n"
16023
"ovs-vswitchd[3592]: EAL: PCI device 0000:04:00.0 on NUMA socket 0\n"
16024
"ovs-vswitchd[3592]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
16025
"ovs-vswitchd[3592]: EAL: Not managed by a supported kernel driver, "
16027
"ovs-vswitchd[3592]: EAL: PCI device 0000:04:00.1 on NUMA socket 0\n"
16028
"ovs-vswitchd[3592]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
16029
"ovs-vswitchd[3592]: EAL: PCI memory mapped at 0x7f2140000000\n"
16030
"ovs-vswitchd[3592]: EAL: PCI memory mapped at 0x7f2140200000\n"
16031
"ovs-ctl[3560]: EAL: Master lcore 0 is ready (tid=fc6cbb00;cpuset=[0])\n"
16032
"ovs-ctl[3560]: EAL: PCI device 0000:04:00.0 on NUMA socket 0\n"
16033
"ovs-ctl[3560]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
16034
"ovs-ctl[3560]: EAL: Not managed by a supported kernel driver, skipped\n"
16035
"ovs-ctl[3560]: EAL: PCI device 0000:04:00.1 on NUMA socket 0\n"
16036
"ovs-ctl[3560]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
16037
"ovs-ctl[3560]: EAL: PCI memory mapped at 0x7f2140000000\n"
16038
"ovs-ctl[3560]: EAL: PCI memory mapped at 0x7f2140200000\n"
16039
"ovs-vswitchd[3592]: PMD: eth_ixgbe_dev_init(): MAC: 4, PHY: 3\n"
16040
"ovs-vswitchd[3592]: PMD: eth_ixgbe_dev_init(): port 0 vendorID=0x8086 "
16041
"deviceID=0x1528\n"
16042
"ovs-ctl[3560]: PMD: eth_ixgbe_dev_init(): MAC: 4, PHY: 3\n"
16043
"ovs-ctl[3560]: PMD: eth_ixgbe_dev_init(): port 0 vendorID=0x8086 "
16044
"deviceID=0x1528\n"
16045
"ovs-ctl[3560]: Zone 0: name:<RG_MP_log_history>, phys:0x83fffdec0, "
16046
"len:0x2080, virt:0x7f213fffdec0, socket_id:0, flags:0\n"
16047
"ovs-ctl[3560]: Zone 1: name:<MP_log_history>, phys:0x83fd73d40, "
16048
"len:0x28a0c0, virt:0x7f213fd73d40, socket_id:0, flags:0\n"
16049
"ovs-ctl[3560]: Zone 2: name:<rte_eth_dev_data>, phys:0x83fd43380, "
16050
"len:0x2f700, virt:0x7f213fd43380, socket_id:0, flags:0\n"
16051
"ovs-ctl[3560]: * Starting ovs-vswitchd\n"
16052
"ovs-ctl[3560]: * Enabling remote OVSDB managers\n"
16053
"systemd[1]: Started Open vSwitch Internal Unit.\n"
16054
"systemd[1]: Starting Open vSwitch...\n"
16055
"systemd[1]: Started Open vSwitch.\n"
16058
"CMD: sudo ovs-vsctl add-br ovsdpdkbr0 -- set bridge ovsdpdkbr0 "
16059
"datapath_type=netdev\n"
16062
"2016-01-22T08:58:56.344Z|00008|memory|INFO|37256 kB peak resident set size "
16063
"after 24.5 seconds\n"
16064
"2016-01-22T08:58:56.346Z|00009|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
16065
"supports recirculation\n"
16066
"2016-01-22T08:58:56.346Z|00010|ofproto_dpif|INFO|netdev@ovs-netdev: MPLS "
16067
"label stack length probed as 3\n"
16068
"2016-01-22T08:58:56.346Z|00011|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
16069
"supports unique flow ids\n"
16070
"2016-01-22T08:58:56.346Z|00012|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
16071
"does not support ct_state\n"
16072
"2016-01-22T08:58:56.346Z|00013|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
16073
"does not support ct_zone\n"
16074
"2016-01-22T08:58:56.346Z|00014|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
16075
"does not support ct_mark\n"
16076
"2016-01-22T08:58:56.346Z|00015|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
16077
"does not support ct_label\n"
16078
"2016-01-22T08:58:56.360Z|00016|bridge|INFO|bridge ovsdpdkbr0: added "
16079
"interface ovsdpdkbr0 on port 65534\n"
16080
"2016-01-22T08:58:56.361Z|00017|bridge|INFO|bridge ovsdpdkbr0: using datapath "
16081
"ID 00005a4a1ed0a14d\n"
16082
"2016-01-22T08:58:56.361Z|00018|connmgr|INFO|ovsdpdkbr0: added service "
16083
"controller \"punix:/var/run/openvswitch/ovsdpdkbr0.mgmt\"\n"
16086
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl add-br ovsdpdkbr0 -- set "
16087
"bridge ovsdpdkbr0 datapath_type=netdev\n"
16088
"systemd-udevd[3607]: Could not generate persistent MAC address for ovs-"
16089
"netdev: No such file or directory\n"
16090
"kernel: [50165.886554] device ovs-netdev entered promiscuous mode\n"
16091
"kernel: [50165.901261] device ovsdpdkbr0 entered promiscuous mode\n"
16094
"CMD: sudo ovs-vsctl add-port ovsdpdkbr0 dpdk0 -- set Interface dpdk0 "
16098
"2016-01-22T08:59:06.369Z|00019|memory|INFO|peak resident set size grew 155% "
16099
"in last 10.0 seconds, from 37256 kB to 95008 kB\n"
16100
"2016-01-22T08:59:06.369Z|00020|memory|INFO|handlers:4 ports:1 revalidators:2 "
16102
"2016-01-22T08:59:30.989Z|00021|dpdk|INFO|Port 0: 8c:dc:d4:b3:6d:e9\n"
16103
"2016-01-22T08:59:31.520Z|00022|dpdk|INFO|Port 0: 8c:dc:d4:b3:6d:e9\n"
16104
"2016-01-22T08:59:31.521Z|00023|dpif_netdev|INFO|Created 1 pmd threads on "
16106
"2016-01-22T08:59:31.522Z|00001|dpif_netdev(pmd16)|INFO|Core 0 processing "
16108
"2016-01-22T08:59:31.522Z|00024|bridge|INFO|bridge ovsdpdkbr0: added "
16109
"interface dpdk0 on port 1\n"
16110
"2016-01-22T08:59:31.522Z|00025|bridge|INFO|bridge ovsdpdkbr0: using datapath "
16111
"ID 00008cdcd4b36de9\n"
16112
"2016-01-22T08:59:31.523Z|00002|dpif_netdev(pmd16)|INFO|Core 0 processing "
16116
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl add-port ovsdpdkbr0 "
16117
"dpdk0 -- set Interface dpdk0 type=dpdk\n"
16118
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a79ebc0 "
16119
"hw_ring=0x7f211a7a6c00 dma_addr=0x81a7a6c00\n"
16120
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16121
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16122
"ovs-vswitchd[3595]: PMD: ixgbe_dev_rx_queue_setup(): sw_ring=0x7f211a78a6c0 "
16123
"sw_sc_ring=0x7f211a786580 hw_ring=0x7f211a78e800 dma_addr=0x81a78e800\n"
16124
"ovs-vswitchd[3595]: PMD: ixgbe_set_rx_function(): Vector rx enabled, please "
16125
"make sure RX burst size no less than 4 (port=0).\n"
16126
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a79ebc0 "
16127
"hw_ring=0x7f211a7a6c00 dma_addr=0x81a7a6c00\n"
16128
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16129
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16130
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a76e4c0 "
16131
"hw_ring=0x7f211a776500 dma_addr=0x81a776500\n"
16132
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16133
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16134
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a756440 "
16135
"hw_ring=0x7f211a75e480 dma_addr=0x81a75e480\n"
16136
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16137
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16138
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a73e3c0 "
16139
"hw_ring=0x7f211a746400 dma_addr=0x81a746400\n"
16140
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16141
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16142
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a726340 "
16143
"hw_ring=0x7f211a72e380 dma_addr=0x81a72e380\n"
16144
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16145
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16146
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a70e2c0 "
16147
"hw_ring=0x7f211a716300 dma_addr=0x81a716300\n"
16148
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16149
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16150
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a6f6240 "
16151
"hw_ring=0x7f211a6fe280 dma_addr=0x81a6fe280\n"
16152
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16153
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16154
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a6de1c0 "
16155
"hw_ring=0x7f211a6e6200 dma_addr=0x81a6e6200\n"
16156
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16157
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16158
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a6c6140 "
16159
"hw_ring=0x7f211a6ce180 dma_addr=0x81a6ce180\n"
16160
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16161
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16162
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a6ae0c0 "
16163
"hw_ring=0x7f211a6b6100 dma_addr=0x81a6b6100\n"
16164
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16165
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16166
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a696040 "
16167
"hw_ring=0x7f211a69e080 dma_addr=0x81a69e080\n"
16168
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16169
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16170
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a67dfc0 "
16171
"hw_ring=0x7f211a686000 dma_addr=0x81a686000\n"
16172
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16173
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16174
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a665e40 "
16175
"hw_ring=0x7f211a66de80 dma_addr=0x81a66de80\n"
16176
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
16177
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
16178
"ovs-vswitchd[3595]: PMD: ixgbe_dev_rx_queue_setup(): sw_ring=0x7f211a78a6c0 "
16179
"sw_sc_ring=0x7f211a786580 hw_ring=0x7f211a78e800 dma_addr=0x81a78e800\n"
16180
"ovs-vswitchd[3595]: PMD: ixgbe_set_rx_function(): Vector rx enabled, please "
16181
"make sure RX burst size no less than 4 (port=0).\n"
16184
"CMD: sudo ovs-vsctl add-port ovsdpdkbr0 vhost-user-1 -- set Interface vhost-"
16185
"user-1 type=dpdkvhostuser\n"
16188
"2016-01-22T09:00:35.145Z|00026|dpdk|INFO|Socket /var/run/openvswitch/vhost-"
16189
"user-1 created for vhost-user port vhost-user-1\n"
16190
"2016-01-22T09:00:35.145Z|00003|dpif_netdev(pmd16)|INFO|Core 0 processing "
16192
"2016-01-22T09:00:35.145Z|00004|dpif_netdev(pmd16)|INFO|Core 0 processing "
16193
"port 'vhost-user-1'\n"
16194
"2016-01-22T09:00:35.145Z|00027|bridge|INFO|bridge ovsdpdkbr0: added "
16195
"interface vhost-user-1 on port 2\n"
16198
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl add-port ovsdpdkbr0 "
16199
"vhost-user-1 -- set Interface vhost-user-1 type=dpdkvhostuser\n"
16200
"ovs-vswitchd[3595]: VHOST_CONFIG: socket created, fd:46\n"
16201
"ovs-vswitchd[3595]: VHOST_CONFIG: bind to /var/run/openvswitch/vhost-user-1\n"
16203
"Eventually we can see the poll thread in top\n"
16204
" PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND\n"
16205
" 3595 root 10 -10 4975344 103936 9916 S 100.0 0.3 33:13.56 ovs-"
16210
#: serverguide/C/network-config.xml:1950(ulink)
15617
16211
msgid "DPDK Documentation"
15620
#: serverguide/C/network-config.xml:1701(ulink)
16214
#: serverguide/C/network-config.xml:1955(ulink)
15621
16215
msgid "Release Notes matching the version packages in Ubuntu 16.04"
15624
#: serverguide/C/network-config.xml:1706(ulink)
16218
#: serverguide/C/network-config.xml:1960(ulink)
15625
16219
msgid "Linux DPDK User Getting Started"
15628
#: serverguide/C/network-config.xml:1711(ulink)
16222
#: serverguide/C/network-config.xml:1965(ulink)
15629
16223
msgid "EAL Command-line Options"
15632
#: serverguide/C/network-config.xml:1716(ulink)
16226
#: serverguide/C/network-config.xml:1970(ulink)
15633
16227
msgid "DPDK Api Documentation"
15636
#: serverguide/C/network-config.xml:1721(ulink)
16230
#: serverguide/C/network-config.xml:1975(ulink)
15637
16231
msgid "OpenVswitch DPDK installation"
15640
#: serverguide/C/network-config.xml:1726(ulink)
16234
#: serverguide/C/network-config.xml:1980(ulink)
15641
16235
msgid "Wikipedias definition of DPDK"
24424
25007
#: serverguide/C/lamp-applications.xml:278(title)
24428
25011
#: serverguide/C/lamp-applications.xml:280(para)
24430
"MediaWiki is an web based Wiki software written in the PHP language. It can "
24431
"either use <application>MySQL</application> or "
24432
"<application>PostgreSQL</application> Database Management System."
24434
"미디어위키는 PHP 언어로 작성된 웹 기반의 위키 소프트웨어입니다. 미디어위키는 "
24435
"<application>MySQL</application> 혹은 <application>PostgreSQL</application> "
24436
"데이터베이스 관리 시스템을 사용할 수 있습니다."
24438
#: serverguide/C/lamp-applications.xml:290(para)
24440
"Before installing <application>MediaWiki</application> you should also "
24441
"install <application>Apache2</application>, the "
24442
"<application>PHP</application> scripting language and a Database Management "
24443
"System. <application>MySQL</application> or "
24444
"<application>PostgreSQL</application> are the most common, choose one "
24445
"depending on your need. Please refer to those sections in this manual for "
24446
"installation instructions."
24449
#: serverguide/C/lamp-applications.xml:298(para)
24451
"To install <application>MediaWiki</application>, run the following command "
24452
"in the command prompt:"
24453
msgstr "<application>MediaWiki</application>를 설치하려면, 명령행에서 다음을 실행하세요:"
24455
#: serverguide/C/lamp-applications.xml:304(command)
24456
msgid "sudo apt install mediawiki php-gd"
24459
#: serverguide/C/lamp-applications.xml:307(para)
24461
"For additional <application>MediaWiki</application> functionality see the "
24462
"<application>mediawiki-extensions</application> package."
24465
#: serverguide/C/lamp-applications.xml:317(para)
24467
"The Apache configuration file <filename>mediawiki.conf</filename> for "
24468
"<application>MediaWiki</application> is installed in "
24469
"<filename>/etc/apache2/conf-available/</filename> directory. To access "
24470
"<application>MediaWiki</application>, uncomment the following line in the "
24474
#: serverguide/C/lamp-applications.xml:324(screen)
24478
"# Alias /mediawiki /var/lib/mediawiki\n"
24481
#: serverguide/C/lamp-applications.xml:328(para)
24483
"The <application>MediaWiki</application> configuration also needs to be "
24487
#: serverguide/C/lamp-applications.xml:332(command)
24488
msgid "sudo a2enconf mediawiki.conf"
24491
#: serverguide/C/lamp-applications.xml:335(para)
24492
msgid "Restart Apache server."
24495
#: serverguide/C/lamp-applications.xml:342(para)
24497
"Access <application>MediaWiki</application> by visiting <ulink "
24498
"url=\"http://localhost/mediawiki/mw-"
24499
"config/index.php\">http://localhost/mediawiki/mw-config/index.php</ulink>. "
24500
"(Or <ulink url=\"http://NAME_OF_YOUR_VIRTUAL_HOST/mediawiki/mw-"
24501
"config/index.php\">http://NAME_OF_YOUR_VIRTUAL_HOST/mediawiki/mw-"
24502
"config/index.php</ulink> if your server has no GUI.)"
24505
#: serverguide/C/lamp-applications.xml:350(para)
24507
"Please read the <quote>Environmental checks</quote> section of the "
24508
"configuration page. You should be able to fix many issues by carefully "
24509
"reading this section."
24512
#: serverguide/C/lamp-applications.xml:357(para)
24514
"Once the configuration is complete, you should copy the "
24515
"<filename>LocalSettings.php</filename> file to "
24516
"<filename>/etc/mediawiki</filename> directory:"
24519
#: serverguide/C/lamp-applications.xml:364(command)
24520
msgid "sudo mv /var/lib/mediawiki/config/LocalSettings.php /etc/mediawiki/"
24523
#: serverguide/C/lamp-applications.xml:367(para)
24525
"You may also want to edit "
24526
"<filename>/etc/mediawiki/LocalSettings.php</filename> in order to set the "
24527
"memory limit (disabled by default):"
24530
#: serverguide/C/lamp-applications.xml:372(programlisting)
24534
"ini_set( 'memory_limit', '64M' );\n"
24537
#: serverguide/C/lamp-applications.xml:379(title)
24541
#: serverguide/C/lamp-applications.xml:380(para)
24543
"The extensions add new features and enhancements for the MediaWiki "
24544
"application. The extensions give wiki administrators and end users the "
24545
"ability to customize MediaWiki to their requirements."
24548
#: serverguide/C/lamp-applications.xml:386(para)
24550
"You can download MediaWiki extensions as an archive file or checkout from "
24551
"the Subversion repository. You should copy it to "
24552
"<filename>/var/lib/mediawiki/extensions</filename> directory. You should "
24553
"also add the following line at the end of file: "
24554
"<filename>/etc/mediawiki/LocalSettings.php</filename>."
24557
#: serverguide/C/lamp-applications.xml:394(programlisting)
24561
"require_once \"$IP/extensions/ExtentionName/ExtentionName.php\";\n"
24564
#: serverguide/C/lamp-applications.xml:404(para)
24566
"For more details, please refer to the <ulink "
24567
"url=\"http://www.mediawiki.org\">MediaWiki</ulink> web site."
24569
"자세한 사항은 <ulink url=\"http://www.mediawiki.org\">MediaWiki</ulink> 웹사이트를 방문해 "
24572
#: serverguide/C/lamp-applications.xml:410(para)
24574
"The <ulink url=\"http://www.packtpub.com/Mediawiki/book\">MediaWiki "
24575
"Administrators' Tutorial Guide</ulink> contains a wealth of information for "
24576
"new MediaWiki administrators."
24579
#: serverguide/C/lamp-applications.xml:416(para)
24581
"Also, the <ulink url=\"https://help.ubuntu.com/community/MediaWiki\">Ubuntu "
24582
"Wiki MediaWiki</ulink> page is a good resource."
24585
#: serverguide/C/lamp-applications.xml:426(title)
24589
#: serverguide/C/lamp-applications.xml:428(para)
24591
25013
"<application>phpMyAdmin</application> is a LAMP application specifically "
24592
25014
"written for administering <application>MySQL</application> servers. Written "
24593
25015
"in <application>PHP</application>, and accessed through a web browser, "
24594
25016
"phpMyAdmin provides a graphical interface for database administration tasks."
24597
#: serverguide/C/lamp-applications.xml:437(para)
25019
#: serverguide/C/lamp-applications.xml:289(para)
24599
25021
"Before installing <application>phpMyAdmin</application> you will need access "
24600
25022
"to a <application>MySQL</application> database either on the same host as "