3067
3093
"connect via VNC to complete the installation."
3070
#: serverguide/C/virtualization.xml:189(para)
3096
#: serverguide/C/virtualization.xml:192(para)
3072
3098
"<emphasis>--noautoconsole:</emphasis> will not automatically connect to the "
3073
3099
"virtual machine's console."
3076
#: serverguide/C/virtualization.xml:194(para)
3102
#: serverguide/C/virtualization.xml:197(para)
3077
3103
msgid "<emphasis>-v:</emphasis> creates a fully virtualized guest."
3080
#: serverguide/C/virtualization.xml:199(para)
3106
#: serverguide/C/virtualization.xml:202(para)
3082
3108
"After launching <application>virt-install</application> you can connect to "
3083
3109
"the virtual machine's console either locally using a GUI (if your server has "
3084
3110
"a GUI), or via a remote VNC client from a GUI-based computer."
3087
#: serverguide/C/virtualization.xml:206(title)
3113
#: serverguide/C/virtualization.xml:209(title)
3088
3114
msgid "virt-clone"
3091
#: serverguide/C/virtualization.xml:208(para)
3117
#: serverguide/C/virtualization.xml:211(para)
3093
3119
"The <application>virt-clone</application> application can be used to copy "
3094
3120
"one virtual machine to another. For example:"
3097
#: serverguide/C/virtualization.xml:212(command)
3123
#: serverguide/C/virtualization.xml:215(command)
3099
"sudo virt-clone -o web_devel -n database_devel -f "
3100
"/path/to/database_devel.img \\ --connect=qemu:///system"
3125
"sudo virt-clone -o web_devel -n database_devel -f /path/to/database_devel.img"
3103
#: serverguide/C/virtualization.xml:218(para)
3128
#: serverguide/C/virtualization.xml:220(para)
3104
3129
msgid "<emphasis>-o:</emphasis> original virtual machine."
3107
#: serverguide/C/virtualization.xml:222(para)
3132
#: serverguide/C/virtualization.xml:224(para)
3108
3133
msgid "<emphasis>-n:</emphasis> name of the new virtual machine."
3111
#: serverguide/C/virtualization.xml:227(para)
3136
#: serverguide/C/virtualization.xml:229(para)
3113
3138
"<emphasis>-f:</emphasis> path to the file, logical volume, or partition to "
3114
3139
"be used by the new virtual machine."
3117
#: serverguide/C/virtualization.xml:232(para)
3119
"<emphasis>--connect:</emphasis> specifies which hypervisor to connect to."
3122
#: serverguide/C/virtualization.xml:237(para)
3142
#: serverguide/C/virtualization.xml:234(para)
3124
3144
"Also, use <emphasis>-d</emphasis> or <emphasis>--debug</emphasis> option to "
3125
3145
"help troubleshoot problems with <application>virt-clone</application>."
3128
#: serverguide/C/virtualization.xml:242(para)
3148
#: serverguide/C/virtualization.xml:239(para)
3130
3150
"Replace <emphasis>web_devel</emphasis> and "
3131
3151
"<emphasis>database_devel</emphasis> with appropriate virtual machine names."
3154
#: serverguide/C/virtualization.xml:246(title)
3155
msgid "Virtual Machine Management"
3134
3158
#: serverguide/C/virtualization.xml:249(title)
3135
msgid "Virtual Machine Management"
3138
#: serverguide/C/virtualization.xml:252(title)
3142
#: serverguide/C/virtualization.xml:254(para)
3162
#: serverguide/C/virtualization.xml:251(para)
3144
3164
"There are several utilities available to manage virtual machines and "
3145
3165
"<application>libvirt</application>. The <application>virsh</application> "
3146
3166
"utility can be used from the command line. Some examples:"
3149
#: serverguide/C/virtualization.xml:261(para)
3169
#: serverguide/C/virtualization.xml:258(para)
3150
3170
msgid "To list running virtual machines:"
3153
#: serverguide/C/virtualization.xml:264(command)
3154
msgid "virsh -c qemu:///system list"
3173
#: serverguide/C/virtualization.xml:261(command)
3157
#: serverguide/C/virtualization.xml:269(para)
3177
#: serverguide/C/virtualization.xml:266(para)
3158
3178
msgid "To start a virtual machine:"
3161
#: serverguide/C/virtualization.xml:272(command)
3162
msgid "virsh -c qemu:///system start web_devel"
3181
#: serverguide/C/virtualization.xml:269(command)
3182
msgid "virsh start web_devel"
3165
#: serverguide/C/virtualization.xml:277(para)
3185
#: serverguide/C/virtualization.xml:274(para)
3166
3186
msgid "Similarly, to start a virtual machine at boot:"
3169
#: serverguide/C/virtualization.xml:280(command)
3170
msgid "virsh -c qemu:///system autostart web_devel"
3189
#: serverguide/C/virtualization.xml:277(command)
3190
msgid "virsh autostart web_devel"
3173
#: serverguide/C/virtualization.xml:285(para)
3193
#: serverguide/C/virtualization.xml:282(para)
3174
3194
msgid "Reboot a virtual machine with:"
3177
#: serverguide/C/virtualization.xml:288(command)
3178
msgid "virsh -c qemu:///system reboot web_devel"
3197
#: serverguide/C/virtualization.xml:285(command)
3198
msgid "virsh reboot web_devel"
3181
#: serverguide/C/virtualization.xml:293(para)
3201
#: serverguide/C/virtualization.xml:290(para)
3183
3203
"The <emphasis>state</emphasis> of virtual machines can be saved to a file in "
3184
3204
"order to be restored later. The following will save the virtual machine "
3185
3205
"state into a file named according to the date:"
3188
#: serverguide/C/virtualization.xml:299(command)
3189
msgid "virsh -c qemu:///system save web_devel web_devel-022708.state"
3208
#: serverguide/C/virtualization.xml:296(command)
3209
msgid "virsh save web_devel web_devel-022708.state"
3192
#: serverguide/C/virtualization.xml:302(para)
3212
#: serverguide/C/virtualization.xml:299(para)
3193
3213
msgid "Once saved the virtual machine will no longer be running."
3196
#: serverguide/C/virtualization.xml:307(para)
3216
#: serverguide/C/virtualization.xml:304(para)
3197
3217
msgid "A saved virtual machine can be restored using:"
3200
#: serverguide/C/virtualization.xml:310(command)
3201
msgid "virsh -c qemu:///system restore web_devel-022708.state"
3220
#: serverguide/C/virtualization.xml:307(command)
3221
msgid "virsh restore web_devel-022708.state"
3204
#: serverguide/C/virtualization.xml:315(para)
3224
#: serverguide/C/virtualization.xml:312(para)
3205
3225
msgid "To shutdown a virtual machine do:"
3208
#: serverguide/C/virtualization.xml:318(command)
3209
msgid "virsh -c qemu:///system shutdown web_devel"
3228
#: serverguide/C/virtualization.xml:315(command)
3229
msgid "virsh shutdown web_devel"
3212
#: serverguide/C/virtualization.xml:323(para)
3232
#: serverguide/C/virtualization.xml:320(para)
3213
3233
msgid "A CDROM device can be mounted in a virtual machine by entering:"
3216
#: serverguide/C/virtualization.xml:327(command)
3217
msgid "virsh -c qemu:///system attach-disk web_devel /dev/cdrom /media/cdrom"
3236
#: serverguide/C/virtualization.xml:324(command)
3237
msgid "virsh attach-disk web_devel /dev/cdrom /media/cdrom"
3220
#: serverguide/C/virtualization.xml:333(para)
3240
#: serverguide/C/virtualization.xml:330(para)
3222
3242
"In the above examples replace <emphasis>web_devel</emphasis> with the "
3223
3243
"appropriate virtual machine name, and <filename>web_devel-"
3224
3244
"022708.state</filename> with a descriptive file name."
3247
#: serverguide/C/virtualization.xml:334(para)
3249
"If virsh (or other vir* tools) shall connect to something else than the "
3250
"default qemu-kvm/system hipervisor one can find alternatives for the "
3251
"<emphasis>connect</emphasis> option in <emphasis>man virsh</emphasis> or "
3252
"<ulink url=\"http://libvirt.org/uri.html\">libvirt doc</ulink>"
3227
3255
#: serverguide/C/virtualization.xml:341(title)
3259
#: serverguide/C/virtualization.xml:342(para)
3261
"There are different types of migration available depending on the versions "
3262
"of libvirt and the hipervisor being used. In general those types are:"
3265
#: serverguide/C/virtualization.xml:345(ulink)
3266
msgid "offline migration"
3269
#: serverguide/C/virtualization.xml:346(ulink)
3270
msgid "live migration"
3273
#: serverguide/C/virtualization.xml:347(ulink)
3274
msgid "postcopy migration"
3277
#: serverguide/C/virtualization.xml:349(para)
3279
"There are various options to those methods, but the entry point for all of "
3280
"them is <emphasis>virsh migrate</emphasis>. Read the integrated help for "
3284
#: serverguide/C/virtualization.xml:350(command)
3285
msgid "virsh migrate --help"
3288
#: serverguide/C/virtualization.xml:351(para)
3290
"Some useful documentation on constraints and considerations about live "
3291
"migration can be found at the <ulink "
3292
"url=\"https://wiki.ubuntu.com/QemuKVMMigration\">Ubuntu Wiki</ulink>"
3295
#: serverguide/C/virtualization.xml:355(title)
3228
3296
msgid "Virtual Machine Manager"
3231
#: serverguide/C/virtualization.xml:343(para)
3299
#: serverguide/C/virtualization.xml:357(para)
3233
3301
"The <application>virt-manager</application> package contains a graphical "
3234
3302
"utility to manage local and remote virtual machines. To install virt-manager "
3238
#: serverguide/C/virtualization.xml:348(command)
3306
#: serverguide/C/virtualization.xml:362(command)
3239
3307
msgid "sudo apt install virt-manager"
3242
#: serverguide/C/virtualization.xml:351(para)
3310
#: serverguide/C/virtualization.xml:365(para)
3244
3312
"Since <application>virt-manager</application> requires a Graphical User "
3245
3313
"Interface (GUI) environment it is recommended to be installed on a "
3287
#: serverguide/C/virtualization.xml:390(para)
3355
#: serverguide/C/virtualization.xml:404(para)
3289
3357
"To install <application>virt-viewer</application> from a terminal enter:"
3292
#: serverguide/C/virtualization.xml:394(command)
3360
#: serverguide/C/virtualization.xml:408(command)
3293
3361
msgid "sudo apt install virt-viewer"
3296
#: serverguide/C/virtualization.xml:397(para)
3364
#: serverguide/C/virtualization.xml:411(para)
3298
3366
"Once a virtual machine is installed and running you can connect to the "
3299
3367
"virtual machine's console by using:"
3302
#: serverguide/C/virtualization.xml:401(command)
3303
msgid "virt-viewer -c qemu:///system web_devel"
3370
#: serverguide/C/virtualization.xml:415(command)
3371
msgid "virt-viewer web_devel"
3306
#: serverguide/C/virtualization.xml:404(para)
3374
#: serverguide/C/virtualization.xml:418(para)
3308
3376
"Similar to <application>virt-manager</application>, <application>virt-"
3309
3377
"viewer</application> can connect to a remote host using "
3310
3378
"<emphasis>SSH</emphasis> with key authentication, as well:"
3313
#: serverguide/C/virtualization.xml:409(command)
3381
#: serverguide/C/virtualization.xml:423(command)
3314
3382
msgid "virt-viewer -c qemu+ssh://virtnode1.mydomain.com/system web_devel"
3317
#: serverguide/C/virtualization.xml:412(para)
3385
#: serverguide/C/virtualization.xml:426(para)
3319
3387
"Be sure to replace <emphasis role=\"italic\">web_devel</emphasis> with the "
3320
3388
"appropriate virtual machine name."
3323
#: serverguide/C/virtualization.xml:415(para)
3391
#: serverguide/C/virtualization.xml:429(para)
3325
3393
"If configured to use a <emphasis>bridged</emphasis> network interface you "
3326
3394
"can also setup <application>SSH</application> access to the virtual machine."
3329
#: 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)
3397
#: 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)
3330
3398
msgid "Resources"
3333
#: serverguide/C/virtualization.xml:425(para)
3401
#: serverguide/C/virtualization.xml:439(para)
3335
3403
"See the <ulink url=\"http://www.linux-kvm.org/\">KVM</ulink> home page for "
3336
3404
"more details."
3339
#: serverguide/C/virtualization.xml:430(para)
3407
#: serverguide/C/virtualization.xml:444(para)
3341
3409
"For more information on <application>libvirt</application> see the <ulink "
3342
3410
"url=\"http://libvirt.org/\">libvirt home page</ulink>"
3345
#: serverguide/C/virtualization.xml:436(para)
3413
#: serverguide/C/virtualization.xml:450(para)
3347
3415
"The <ulink url=\"http://virt-manager.org/\">Virtual Machine Manager</ulink> "
3348
3416
"site has more information on <application>virt-manager</application> "
3352
#: serverguide/C/virtualization.xml:442(para)
3420
#: serverguide/C/virtualization.xml:456(para)
3354
3422
"Also, stop by the <emphasis>#ubuntu-virt</emphasis> IRC channel on <ulink "
3355
3423
"url=\"http://freenode.net/\">freenode</ulink> to discuss virtualization "
3356
3424
"technology in Ubuntu."
3359
#: serverguide/C/virtualization.xml:448(para)
3427
#: serverguide/C/virtualization.xml:462(para)
3361
3429
"Another good resource is the <ulink "
3362
3430
"url=\"https://help.ubuntu.com/community/KVM\">Ubuntu Wiki KVM</ulink> page."
3365
#: serverguide/C/virtualization.xml:454(para)
3433
#: serverguide/C/virtualization.xml:468(para)
3367
3435
"For information on Xen, including using Xen with libvirt, please see the "
3368
3436
"<ulink url=\"https://help.ubuntu.com/community/Xen\">Ubuntu Wiki Xen</ulink> "
3372
#: serverguide/C/virtualization.xml:464(title)
3440
#: serverguide/C/virtualization.xml:478(title)
3444
#: serverguide/C/virtualization.xml:479(para)
3446
"<ulink url=\"http://wiki.qemu.org/Main_Page\">Qemu</ulink> is a machine "
3447
"emulator that can run operating systems and programs for one machine on a "
3448
"different machine. Mostly it is not used as emulator but as virtualizer in "
3449
"collaboration with KVM or XEN kernel components. In that case it utilizes "
3450
"the virtualization technology of the hardware to virtualize guests."
3453
#: serverguide/C/virtualization.xml:483(para)
3455
"While qemu has a <ulink url=\"http://wiki.qemu.org/download/qemu-"
3456
"doc.html#sec_005finvocation\">command line interface</ulink> and a <ulink "
3457
"url=\"http://wiki.qemu.org/download/qemu-"
3458
"doc.html#pcsys_005fmonitor\">monitor</ulink> to interact with running guests "
3459
"those is rarely used that way for other means than development purposes. "
3460
"<link linkend=\"libvirt\">Libvirt</link> provides an abstraction from "
3461
"specific versions and hiperviors and encapsulates some workarounds and best "
3465
#: serverguide/C/virtualization.xml:488(title)
3466
msgid "Upgrading the machine type"
3469
#: serverguide/C/virtualization.xml:489(para)
3471
"This also is documented along some more constraints and considerations at "
3473
"url=\"https://wiki.ubuntu.com/QemuKVMMigration#Upgrade_machine_type\">Ubuntu "
3477
#: serverguide/C/virtualization.xml:490(para)
3479
"You might want to update your machine type of an existing defined guest to:"
3482
#: serverguide/C/virtualization.xml:492(para)
3483
msgid "to pick up latest security fixes and features"
3486
#: serverguide/C/virtualization.xml:493(para)
3487
msgid "continue using a guest created on a now unsupported release"
3490
#: serverguide/C/virtualization.xml:495(para)
3492
"In general it is recommended to update machine types when upgrading qemu/kvm "
3493
"to a new major version. But this can likely never be an automated task as "
3494
"this change is guest visible. The guest devices might change in appearance, "
3495
"new features will be announced to the guest and so on. Linux is usually very "
3496
"good at tolerating such changes, but it depends so much on the setup and "
3497
"workload of the guest that this has to be evaluated by the owner/admin of "
3498
"the system. Other operating systems where known to often have severe impacts "
3499
"by changing the hardware. Consider a machine type change similar to "
3500
"replacing all devices and firmware of a physical machine to the latest "
3501
"revision - all considerations that apply there apply to evaluating a machine "
3502
"type upgrade as well."
3505
#: serverguide/C/virtualization.xml:496(para)
3507
"As usual with major configuration changes it is wise to back up your guest "
3508
"definition and disk state to be able to do a rollback just in case. There is "
3509
"no integrated single command to update the machine type via virsh or similar "
3510
"tools. It is a normal part of your machine definition. And therefore updated "
3511
"the same way as most others."
3514
#: serverguide/C/virtualization.xml:498(para)
3515
msgid "First shutdown your machine and wait until it has reached that state."
3518
#: serverguide/C/virtualization.xml:499(screen)
3522
"virsh shutdown <yourmachine>\n"
3524
"virsh list --inactive\n"
3525
"# should now list your machine as \"shut off\"\n"
3529
#: serverguide/C/virtualization.xml:505(para)
3531
"Then edit the machine definition and find the type in the type tag at the "
3532
"machine attribute."
3535
#: serverguide/C/virtualization.xml:506(screen)
3539
"virsh edit <yourmachine>\n"
3540
"<type arch='x86_64' machine='pc-i440fx-xenial'>hvm</type>\n"
3544
#: serverguide/C/virtualization.xml:510(para)
3546
"Change this to the value you want. If you need to check what types are "
3547
"available via \"-M ?\" Note that while providing upstream types as "
3548
"convenience only Ubuntu types are supported. There you can also see what the "
3549
"current default would be. In general it is strongly recommended that you "
3550
"change to newer types if possible to exploit newer features, but also to "
3551
"benefit of bugfixes that only apply to the newer device virtualization."
3554
#: serverguide/C/virtualization.xml:511(screen)
3559
"# lists machine types, e.g.\n"
3560
"pc-i440fx-xenial Ubuntu 16.04 PC (i440FX + PIIX, 1996) (default)\n"
3565
#: serverguide/C/virtualization.xml:517(para)
3567
"After this you can start your guest again. You can check the current machine "
3568
"type from guest and host depending on your needs."
3571
#: serverguide/C/virtualization.xml:518(screen)
3575
"virsh start <yourmachine>\n"
3576
"# check from host, via dumping the active xml definition\n"
3577
"virsh dumpxml <yourmachine> | xmllint --xpath "
3578
"\"string(//domain/os/type/@machine)\" -\n"
3579
"# or from the guest via dmidecode\n"
3580
"sudo dmidecode | grep Product -A 1\n"
3581
" Product Name: Standard PC (i440FX + PIIX, 1996)\n"
3582
" Version: pc-i440fx-xenial\n"
3586
#: serverguide/C/virtualization.xml:527(para)
3588
"If you keep non-live definitions around like xml files remember to update "
3592
#: serverguide/C/virtualization.xml:532(title)
3373
3593
msgid "Cloud images and uvtool"
3376
#: 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)
3596
#: 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)
3377
3597
msgid "Introduction"
3380
#: serverguide/C/virtualization.xml:469(para)
3600
#: serverguide/C/virtualization.xml:537(para)
3382
3602
"With Ubuntu being one of the most used operating systems on many cloud "
3383
3603
"platforms, the availability of stable and secure cloud images has become "
3643
#: serverguide/C/virtualization.xml:639(title)
3863
#: serverguide/C/virtualization.xml:707(title)
3644
3864
msgid "Get the list of running VMs"
3647
#: serverguide/C/virtualization.xml:640(para)
3867
#: serverguide/C/virtualization.xml:708(para)
3648
3868
msgid "You can get the list of VMs running on your system with this command:"
3651
#: serverguide/C/virtualization.xml:642(programlisting)
3871
#: serverguide/C/virtualization.xml:710(programlisting)
3654
3874
"$ uvt-kvm list\n"
3658
#: serverguide/C/virtualization.xml:647(title)
3878
#: serverguide/C/virtualization.xml:715(title)
3659
3879
msgid "Destroy your VM"
3662
#: serverguide/C/virtualization.xml:648(para)
3882
#: serverguide/C/virtualization.xml:716(para)
3663
3883
msgid "Once you are done with your VM, you can destroy it with:"
3666
#: serverguide/C/virtualization.xml:650(programlisting)
3886
#: serverguide/C/virtualization.xml:718(programlisting)
3668
3888
msgid "$ uvt-kvm destroy secondtest"
3671
#: serverguide/C/virtualization.xml:652(title)
3891
#: serverguide/C/virtualization.xml:720(title)
3672
3892
msgid "More uvt-kvm options"
3675
#: serverguide/C/virtualization.xml:654(para)
3895
#: serverguide/C/virtualization.xml:722(para)
3677
3897
"The following options can be used to change some of the characteristics of "
3678
3898
"the VM that you are creating:"
3681
#: serverguide/C/virtualization.xml:657(para)
3901
#: serverguide/C/virtualization.xml:725(para)
3682
3902
msgid "--memory : Amount of RAM in megabytes. Default: 512."
3685
#: serverguide/C/virtualization.xml:658(para)
3905
#: serverguide/C/virtualization.xml:726(para)
3686
3906
msgid "--disk : Size of the OS disk in gigabytes. Default: 8."
3689
#: serverguide/C/virtualization.xml:659(para)
3909
#: serverguide/C/virtualization.xml:727(para)
3690
3910
msgid "--cpu : Number of CPU cores. Default: 1."
3693
#: serverguide/C/virtualization.xml:662(para)
3913
#: serverguide/C/virtualization.xml:730(para)
3695
3915
"Some other parameters will have an impact on the cloud-init configuration:"
3698
#: serverguide/C/virtualization.xml:664(para)
3918
#: serverguide/C/virtualization.xml:732(para)
3700
3920
"--password password : Allow login to the VM using the Ubuntu account and "
3701
3921
"this provided password."
3704
#: serverguide/C/virtualization.xml:665(para)
3924
#: serverguide/C/virtualization.xml:733(para)
3706
3926
"--run-script-once script_file : Run script_file as root on the VM the first "
3707
3927
"time it is booted, but never again."
3710
#: serverguide/C/virtualization.xml:666(para)
3930
#: serverguide/C/virtualization.xml:734(para)
3712
3932
"--packages package_list : Install the comma-separated packages specified in "
3713
3933
"package_list on first boot."
3716
#: serverguide/C/virtualization.xml:669(para)
3936
#: serverguide/C/virtualization.xml:737(para)
3718
3938
"A complete description of all available modifiers is available in the "
3719
3939
"manpage of uvt-kvm."
3722
#: serverguide/C/virtualization.xml:676(para)
3942
#: serverguide/C/virtualization.xml:744(para)
3724
3944
"If you are interested in learning more, have questions or suggestions, "
3725
3945
"please contact the Ubuntu Server Team at:"
3728
#: serverguide/C/virtualization.xml:681(para)
3948
#: serverguide/C/virtualization.xml:749(para)
3729
3949
msgid "IRC: #ubuntu-server on freenode"
3732
#: serverguide/C/virtualization.xml:685(para)
3952
#: serverguide/C/virtualization.xml:753(para)
3734
3954
"Mailing list: <ulink url=\"https://lists.ubuntu.com/mailman/listinfo/ubuntu-"
3735
3955
"server\">ubuntu-server at lists.ubuntu.com</ulink>"
3738
#: serverguide/C/virtualization.xml:694(title)
3958
#: serverguide/C/virtualization.xml:762(title)
3739
3959
msgid "Ubuntu Cloud"
3742
#: serverguide/C/virtualization.xml:696(para)
3962
#: serverguide/C/virtualization.xml:764(para)
3744
3964
"<application>Cloud computing</application> is a computing model that allows "
3745
3965
"vast pools of resources to be allocated on-demand. These resources such as "
4033
4253
"the desired architecture:"
4036
#: serverguide/C/virtualization.xml:988(command)
4256
#: serverguide/C/virtualization.xml:1056(command)
4037
4257
msgid "lxc image info ubuntu:lts/arm64"
4040
#: serverguide/C/virtualization.xml:993(para)
4260
#: serverguide/C/virtualization.xml:1061(para)
4041
4261
msgid "Now, let's start our first container:"
4044
#: serverguide/C/virtualization.xml:998(command)
4264
#: serverguide/C/virtualization.xml:1066(command)
4045
4265
msgid "lxc launch ubuntu:xenial x1"
4048
#: serverguide/C/virtualization.xml:1003(para)
4268
#: serverguide/C/virtualization.xml:1071(para)
4050
4270
"This will download the official current Xenial cloud image for your current "
4051
4271
"architecture, then create a container using that image, and finally start "
4052
4272
"it. Once the command returns, you can see it using:"
4055
#: serverguide/C/virtualization.xml:1010(command)
4275
#: serverguide/C/virtualization.xml:1078(command)
4056
4276
msgid "lxc list lxc info x1"
4059
#: serverguide/C/virtualization.xml:1016(para)
4279
#: serverguide/C/virtualization.xml:1084(para)
4060
4280
msgid "and open a shell in it using:"
4063
#: serverguide/C/virtualization.xml:1021(command)
4283
#: serverguide/C/virtualization.xml:1089(command)
4064
4284
msgid "lxc exec x1 bash"
4067
#: serverguide/C/virtualization.xml:1026(para)
4287
#: serverguide/C/virtualization.xml:1094(para)
4069
4289
"The try-it page gives a full synopsis of the commands you can use to "
4070
4290
"administer containers."
4073
#: serverguide/C/virtualization.xml:1031(para)
4293
#: serverguide/C/virtualization.xml:1099(para)
4075
4295
"Now that the 'xenial' image has been downloaded, it will be kept in sync "
4076
4296
"until no new containers have been created based on it for (by default) 10 "
4077
4297
"days. After that, it will be deleted."
4080
#: serverguide/C/virtualization.xml:1039(title)
4300
#: serverguide/C/virtualization.xml:1107(title)
4081
4301
msgid "LXD Server Configuration"
4084
#: serverguide/C/virtualization.xml:1041(para)
4304
#: serverguide/C/virtualization.xml:1109(para)
4086
4306
"By default, LXD is socket activated and configured to listen only on a local "
4087
4307
"UNIX socket. While LXD may not be running when you first look at the process "
4088
4308
"listing, any LXC command will start it up. For instance:"
4091
#: serverguide/C/virtualization.xml:1048(command)
4311
#: serverguide/C/virtualization.xml:1116(command)
4092
4312
msgid "lxc list"
4095
#: serverguide/C/virtualization.xml:1053(para)
4315
#: serverguide/C/virtualization.xml:1121(para)
4097
4317
"This will create your client certificate and contact the LXD server for a "
4098
4318
"list of containers. To make the server accessible over the network you can "
4099
4319
"set the http port using:"
4102
#: serverguide/C/virtualization.xml:1060(command)
4322
#: serverguide/C/virtualization.xml:1128(command)
4103
4323
msgid "lxc config set core.https_address :8443"
4106
#: serverguide/C/virtualization.xml:1065(para)
4326
#: serverguide/C/virtualization.xml:1133(para)
4107
4327
msgid "This will tell LXD to listen to port 8843 on all addresses."
4110
#: serverguide/C/virtualization.xml:1069(title)
4330
#: serverguide/C/virtualization.xml:1137(title)
4111
4331
msgid "Authentication"
4114
#: serverguide/C/virtualization.xml:1071(para)
4334
#: serverguide/C/virtualization.xml:1139(para)
4116
4336
"By default, LXD will allow all members of group 'lxd' (which by default "
4117
4337
"includes all members of group admin) to talk to it over the UNIX socket. "
4322
4542
"must be set to true:"
4325
#: serverguide/C/virtualization.xml:1289(command)
4545
#: serverguide/C/virtualization.xml:1357(command)
4326
4546
msgid "lxc config set container1 security.nesting true"
4329
#: serverguide/C/virtualization.xml:1294(para)
4549
#: serverguide/C/virtualization.xml:1362(para)
4330
4550
msgid "Once this is done, container1 will be able to start sub-containers."
4333
#: serverguide/C/virtualization.xml:1298(para)
4553
#: serverguide/C/virtualization.xml:1366(para)
4335
4555
"In order to run unprivileged (the default in LXD) containers nested under an "
4336
4556
"unprivileged container, you will need to ensure a wide enough UID mapping. "
4337
4557
"Please see the 'UID mapping' section below."
4340
#: serverguide/C/virtualization.xml:1304(title)
4560
#: serverguide/C/virtualization.xml:1372(title)
4344
#: serverguide/C/virtualization.xml:1306(para)
4564
#: serverguide/C/virtualization.xml:1374(para)
4346
4566
"In order to facilitate running docker containers inside a LXD container, a "
4347
4567
"'docker' profile is provided. To launch a new container with the docker "
4348
4568
"profile, you can run:"
4351
#: serverguide/C/virtualization.xml:1313(command)
4571
#: serverguide/C/virtualization.xml:1381(command)
4352
4572
msgid "lxc launch xenial container1 -p default -p docker"
4355
#: serverguide/C/virtualization.xml:1318(para)
4575
#: serverguide/C/virtualization.xml:1386(para)
4357
4577
"Note that currently the docker package in Ubuntu 16.04 is patched to "
4358
4578
"facilitate running in a container. This support is expected to land upstream "
4362
#: serverguide/C/virtualization.xml:1324(para)
4582
#: serverguide/C/virtualization.xml:1392(para)
4364
4584
"Note that 'cgroup namespace' support is also required. This is available in "
4365
4585
"the 16.04 kernel as well as in the 4.6 upstream source."
4368
#: serverguide/C/virtualization.xml:1333(title)
4588
#: serverguide/C/virtualization.xml:1401(title)
4372
#: serverguide/C/virtualization.xml:1335(para)
4592
#: serverguide/C/virtualization.xml:1403(para)
4374
4594
"LXD supports flexible constraints on the resources which containers can "
4375
4595
"consume. The limits come in the following categories:"
4378
#: serverguide/C/virtualization.xml:1342(para)
4598
#: serverguide/C/virtualization.xml:1410(para)
4379
4599
msgid "CPU: limit cpu available to the container in several ways."
4382
#: serverguide/C/virtualization.xml:1345(para)
4602
#: serverguide/C/virtualization.xml:1413(para)
4383
4603
msgid "Disk: configure the priority of I/O requests under load"
4386
#: serverguide/C/virtualization.xml:1348(para)
4606
#: serverguide/C/virtualization.xml:1416(para)
4387
4607
msgid "RAM: configure memory and swap availability"
4390
#: serverguide/C/virtualization.xml:1351(para)
4610
#: serverguide/C/virtualization.xml:1419(para)
4391
4611
msgid "Network: configure the network priority under load"
4394
#: serverguide/C/virtualization.xml:1354(para)
4614
#: serverguide/C/virtualization.xml:1422(para)
4395
4615
msgid "Processes: limit the number of concurrent processes in the container."
4398
#: serverguide/C/virtualization.xml:1358(para)
4618
#: serverguide/C/virtualization.xml:1426(para)
4400
4620
"For a full list of limits known to LXD, see <ulink "
4401
4621
"url=\"https://github.com/lxc/lxd/blob/master/doc/configuration.md\"> the "
4402
4622
"configuration documentation</ulink>."
4405
#: serverguide/C/virtualization.xml:1366(title)
4625
#: serverguide/C/virtualization.xml:1434(title)
4406
4626
msgid "UID mappings and Privileged containers"
4409
#: serverguide/C/virtualization.xml:1368(para)
4629
#: serverguide/C/virtualization.xml:1436(para)
4411
4631
"By default, LXD creates unprivileged containers. This means that root in the "
4412
4632
"container is a non-root UID on the host. It is privileged against the "
4495
4715
".html\"> the lxc.container.conf(5) manual page</ulink>."
4498
#: serverguide/C/virtualization.xml:1457(title)
4718
#: serverguide/C/virtualization.xml:1525(title)
4499
4719
msgid "Images and containers"
4502
#: serverguide/C/virtualization.xml:1459(para)
4722
#: serverguide/C/virtualization.xml:1527(para)
4504
4724
"LXD is image based. When you create your first container, you will generally "
4505
4725
"do so using an existing image. LXD comes pre-configured with three default "
4506
4726
"image remotes:"
4509
#: serverguide/C/virtualization.xml:1467(para)
4729
#: serverguide/C/virtualization.xml:1535(para)
4511
4731
"ubuntu: This is a <ulink "
4512
4732
"url=\"https://launchpad.net/simplestreams\">simplestreams-based</ulink> "
4513
4733
"remote serving released ubuntu cloud images."
4516
#: serverguide/C/virtualization.xml:1472(para)
4736
#: serverguide/C/virtualization.xml:1540(para)
4518
4738
"ubuntu-daily: This is another simplestreams based remote which serves "
4519
4739
"'daily' ubuntu cloud images. These provide quicker but potentially less "
4520
4740
"stable images."
4523
#: serverguide/C/virtualization.xml:1478(para)
4743
#: serverguide/C/virtualization.xml:1546(para)
4525
4745
"images: This is a remote publishing best-effort container images for many "
4526
4746
"distributions, created using community-provided build scripts."
4529
#: serverguide/C/virtualization.xml:1483(para)
4749
#: serverguide/C/virtualization.xml:1551(para)
4530
4750
msgid "To view the images available on one of these servers, you can use:"
4533
#: serverguide/C/virtualization.xml:1493(para)
4753
#: serverguide/C/virtualization.xml:1561(para)
4535
4755
"Most of the images are known by several aliases for easier reference. To see "
4536
4756
"the full list of aliases, you can use"
4539
#: serverguide/C/virtualization.xml:1499(command)
4759
#: serverguide/C/virtualization.xml:1567(command)
4540
4760
msgid "lxc image alias list images:"
4543
#: serverguide/C/virtualization.xml:1504(para)
4763
#: serverguide/C/virtualization.xml:1572(para)
4545
4765
"Any alias or image fingerprint can be used to specify how to create the new "
4546
4766
"container. For instance, to create an amd64 Ubuntu 14.04 container, some "
4550
#: serverguide/C/virtualization.xml:1511(command)
4770
#: serverguide/C/virtualization.xml:1579(command)
4552
4772
"lxc launch ubuntu:14.04 trusty1 lxc launch ubuntu:trusty trusty1 lxc launch "
4553
4773
"ubuntu:trusty/amd64 trusty1 lxc launch ubuntu:lts trusty1"
4556
#: serverguide/C/virtualization.xml:1519(para)
4776
#: serverguide/C/virtualization.xml:1587(para)
4557
4777
msgid "The 'lts' alias always refers to the latest released LTS image."
4560
#: serverguide/C/virtualization.xml:1523(title) serverguide/C/virtualization.xml:2352(title)
4780
#: serverguide/C/virtualization.xml:1591(title) serverguide/C/virtualization.xml:2420(title)
4561
4781
msgid "Snapshots"
4564
#: serverguide/C/virtualization.xml:1525(para)
4784
#: serverguide/C/virtualization.xml:1593(para)
4566
4786
"Containers can be renamed and live-migrated using the 'lxc move' command:"
4569
#: serverguide/C/virtualization.xml:1530(command)
4789
#: serverguide/C/virtualization.xml:1598(command)
4570
4790
msgid "lxc move c1 final-beta"
4573
#: serverguide/C/virtualization.xml:1535(para)
4793
#: serverguide/C/virtualization.xml:1603(para)
4574
4794
msgid "They can also be snapshotted:"
4577
#: serverguide/C/virtualization.xml:1540(command)
4797
#: serverguide/C/virtualization.xml:1608(command)
4578
4798
msgid "lxc snapshot c1 YYYY-MM-DD"
4581
#: serverguide/C/virtualization.xml:1545(para)
4801
#: serverguide/C/virtualization.xml:1613(para)
4582
4802
msgid "Later changes to c1 can then be reverted by restoring the snapshot:"
4585
#: serverguide/C/virtualization.xml:1550(command)
4805
#: serverguide/C/virtualization.xml:1618(command)
4586
4806
msgid "lxc restore u1 YYYY-MM-DD"
4589
#: serverguide/C/virtualization.xml:1555(para)
4809
#: serverguide/C/virtualization.xml:1623(para)
4591
4811
"New containers can also be created by copying a container or snapshot:"
4594
#: serverguide/C/virtualization.xml:1560(command)
4814
#: serverguide/C/virtualization.xml:1628(command)
4595
4815
msgid "lxc copy u1/YYYY-MM-DD testcontainer"
4598
#: serverguide/C/virtualization.xml:1567(title)
4818
#: serverguide/C/virtualization.xml:1635(title)
4599
4819
msgid "Publishing images"
4602
#: serverguide/C/virtualization.xml:1569(para)
4822
#: serverguide/C/virtualization.xml:1637(para)
4604
4824
"When a container or container snapshot is ready for consumption by others, "
4605
4825
"it can be published as a new image using;"
4608
#: serverguide/C/virtualization.xml:1575(command)
4828
#: serverguide/C/virtualization.xml:1643(command)
4609
4829
msgid "lxc publish u1/YYYY-MM-DD --alias foo-2.0"
4612
#: serverguide/C/virtualization.xml:1580(para)
4832
#: serverguide/C/virtualization.xml:1648(para)
4614
4834
"The published image will be private by default, meaning that LXD will not "
4615
4835
"allow clients without a trusted certificate to see them. If the image is "
15145
15435
"installation\" at the end of this document for more."
15148
#: serverguide/C/network-config.xml:1654(para)
15438
#: serverguide/C/network-config.xml:1692(para)
15150
15440
"As usual with tunings you have to know your system and workload really well -"
15151
15441
" so please verify any tunings with workloads matching your real use case."
15154
#: serverguide/C/network-config.xml:1661(para)
15444
#: serverguide/C/network-config.xml:1699(para)
15156
15446
"DPDK is a fast evolving project. In any case of a search for support and "
15157
15447
"further guides it is highly recommended to first check if they apply to the "
15158
15448
"current version."
15161
#: serverguide/C/network-config.xml:1668(ulink)
15451
#: serverguide/C/network-config.xml:1707(ulink)
15162
15452
msgid "DPDK Mailing Lists"
15165
#: serverguide/C/network-config.xml:1672(para)
15455
#: serverguide/C/network-config.xml:1711(para)
15167
15457
"For OpenVswitch-DPDK <ulink url=\"http://openvswitch.org/mlists\">OpenStack "
15168
15458
"Mailing Lists</ulink>"
15171
#: serverguide/C/network-config.xml:1677(para)
15461
#: serverguide/C/network-config.xml:1716(para)
15173
15463
"Known issues in <ulink "
15174
15464
"url=\"https://bugs.launchpad.net/ubuntu/+source/dpdk\">DPDK Launchpad "
15175
15465
"Area</ulink>"
15178
#: serverguide/C/network-config.xml:1682(para)
15468
#: serverguide/C/network-config.xml:1721(para)
15179
15469
msgid "Join the IRC channels #DPDK or #openvswitch on freenode."
15182
#: serverguide/C/network-config.xml:1696(ulink)
15472
#: serverguide/C/network-config.xml:1727(para)
15474
"Issues are often due to missing small details in the general setup. Later "
15475
"on, these missing details cause problems which can be hard to track down to "
15476
"their root cause. A common case seems to be the \"could not open network "
15477
"device dpdk0 (No such device)\" issue. This occurs rather late when setting "
15478
"up a port in Open vSwitch with DPDK. But the root cause most of the time is "
15479
"very early in the setup and initialization. Here an example how a proper "
15480
"initialization of a device looks - this can be found in the syslog/journal "
15481
"when starting Open vSwitch with DPDK enabled."
15484
#: serverguide/C/network-config.xml:1738(programlisting)
15488
"ovs-ctl[3560]: EAL: PCI device 0000:04:00.1 on NUMA socket 0\n"
15489
"ovs-ctl[3560]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
15490
"ovs-ctl[3560]: EAL: PCI memory mapped at 0x7f2140000000\n"
15491
"ovs-ctl[3560]: EAL: PCI memory mapped at 0x7f2140200000\n"
15495
#: serverguide/C/network-config.xml:1745(para)
15497
"If this is missing, either by ignored cards, failed initialization or other "
15498
"reasons, later on there will be no DPDK device to refer to. Unfortunately "
15499
"the logging is spread across syslog/journal and the openvswitch log. To "
15500
"allow some cross checking here an example what can be found in these logs, "
15501
"relative to the entered command."
15504
#: serverguide/C/network-config.xml:1753(programlisting)
15508
"#Note: This log was taken with dpdk 2.2 and openvswitch 2.5\n"
15510
"CMD: that you enter\n"
15511
"SYSLOG: (Inlcuding EAL and OVS Messages)\n"
15512
"OVS-LOG: (Openvswitch messages)\n"
15515
"Bind an interface to DPDK UIO drivers, make Hugepages available, enable DPDK "
15518
"CMD: sudo service openvswitch-switch restart\n"
15521
"2016-01-22T08:58:31.372Z|00003|daemon_unix(monitor)|INFO|pid 3329 died, "
15522
"killed (Terminated), exiting\n"
15523
"2016-01-22T08:58:33.377Z|00002|vlog|INFO|opened log file "
15524
"/var/log/openvswitch/ovs-vswitchd.log\n"
15525
"2016-01-22T08:58:33.381Z|00003|ovs_numa|INFO|Discovered 12 CPU cores on NUMA "
15527
"2016-01-22T08:58:33.381Z|00004|ovs_numa|INFO|Discovered 1 NUMA nodes and 12 "
15530
"22T08:58:33.381Z|00005|reconnect|INFO|unix:/var/run/openvswitch/db.sock: "
15533
"22T08:58:33.383Z|00006|reconnect|INFO|unix:/var/run/openvswitch/db.sock: "
15535
"2016-01-22T08:58:33.386Z|00007|bridge|INFO|ovs-vswitchd (Open vSwitch) "
15539
"systemd[1]: Stopping Open vSwitch...\n"
15540
"systemd[1]: Stopped Open vSwitch.\n"
15541
"systemd[1]: Stopping Open vSwitch Internal Unit...\n"
15542
"ovs-ctl[3541]: * Killing ovs-vswitchd (3329)\n"
15543
"ovs-ctl[3541]: * Killing ovsdb-server (3318)\n"
15544
"systemd[1]: Stopped Open vSwitch Internal Unit.\n"
15545
"systemd[1]: Starting Open vSwitch Internal Unit...\n"
15546
"ovs-ctl[3560]: * Starting ovsdb-server\n"
15547
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl --no-wait -- init -- set "
15548
"Open_vSwitch . db-version=7.12.1\n"
15549
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl --no-wait set "
15550
"Open_vSwitch . ovs-version=2.5.0 \"external-ids:system-id=\\\"e7c5ba80-bb14-"
15551
"45c1-b8eb-628f3ad03903\\\"\" \"system-type=\\\"Ubuntu\\\"\" \"system-"
15552
"version=\\\"16.04-xenial\\\"\"\n"
15553
"ovs-ctl[3560]: * Configuring Open vSwitch system IDs\n"
15554
"ovs-ctl[3560]: 2016-01-22T08:58:31Z|00001|dpdk|INFO|No -vhost_sock_dir "
15555
"provided - defaulting to /var/run/openvswitch\n"
15556
"ovs-vswitchd: ovs|00001|dpdk|INFO|No -vhost_sock_dir provided - defaulting "
15557
"to /var/run/openvswitch\n"
15558
"ovs-ctl[3560]: EAL: Detected lcore 0 as core 0 on socket 0\n"
15559
"ovs-ctl[3560]: EAL: Detected lcore 1 as core 1 on socket 0\n"
15560
"ovs-ctl[3560]: EAL: Detected lcore 2 as core 2 on socket 0\n"
15561
"ovs-ctl[3560]: EAL: Detected lcore 3 as core 3 on socket 0\n"
15562
"ovs-ctl[3560]: EAL: Detected lcore 4 as core 4 on socket 0\n"
15563
"ovs-ctl[3560]: EAL: Detected lcore 5 as core 5 on socket 0\n"
15564
"ovs-ctl[3560]: EAL: Detected lcore 6 as core 0 on socket 0\n"
15565
"ovs-ctl[3560]: EAL: Detected lcore 7 as core 1 on socket 0\n"
15566
"ovs-ctl[3560]: EAL: Detected lcore 8 as core 2 on socket 0\n"
15567
"ovs-ctl[3560]: EAL: Detected lcore 9 as core 3 on socket 0\n"
15568
"ovs-ctl[3560]: EAL: Detected lcore 10 as core 4 on socket 0\n"
15569
"ovs-ctl[3560]: EAL: Detected lcore 11 as core 5 on socket 0\n"
15570
"ovs-ctl[3560]: EAL: Support maximum 128 logical core(s) by configuration.\n"
15571
"ovs-ctl[3560]: EAL: Detected 12 lcore(s)\n"
15572
"ovs-ctl[3560]: EAL: VFIO modules not all loaded, skip VFIO support...\n"
15573
"ovs-ctl[3560]: EAL: Setting up physically contiguous memory...\n"
15574
"ovs-ctl[3560]: EAL: Ask a virtual area of 0x100000000 bytes\n"
15575
"ovs-ctl[3560]: EAL: Virtual area found at 0x7f2040000000 (size = "
15577
"ovs-ctl[3560]: EAL: Requesting 4 pages of size 1024MB from socket 0\n"
15578
"ovs-ctl[3560]: EAL: TSC frequency is ~2397202 KHz\n"
15579
"ovs-vswitchd[3592]: EAL: TSC frequency is ~2397202 KHz\n"
15580
"ovs-vswitchd[3592]: EAL: Master lcore 0 is ready (tid=fc6cbb00;cpuset=[0])\n"
15581
"ovs-vswitchd[3592]: EAL: PCI device 0000:04:00.0 on NUMA socket 0\n"
15582
"ovs-vswitchd[3592]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
15583
"ovs-vswitchd[3592]: EAL: Not managed by a supported kernel driver, "
15585
"ovs-vswitchd[3592]: EAL: PCI device 0000:04:00.1 on NUMA socket 0\n"
15586
"ovs-vswitchd[3592]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
15587
"ovs-vswitchd[3592]: EAL: PCI memory mapped at 0x7f2140000000\n"
15588
"ovs-vswitchd[3592]: EAL: PCI memory mapped at 0x7f2140200000\n"
15589
"ovs-ctl[3560]: EAL: Master lcore 0 is ready (tid=fc6cbb00;cpuset=[0])\n"
15590
"ovs-ctl[3560]: EAL: PCI device 0000:04:00.0 on NUMA socket 0\n"
15591
"ovs-ctl[3560]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
15592
"ovs-ctl[3560]: EAL: Not managed by a supported kernel driver, skipped\n"
15593
"ovs-ctl[3560]: EAL: PCI device 0000:04:00.1 on NUMA socket 0\n"
15594
"ovs-ctl[3560]: EAL: probe driver: 8086:1528 rte_ixgbe_pmd\n"
15595
"ovs-ctl[3560]: EAL: PCI memory mapped at 0x7f2140000000\n"
15596
"ovs-ctl[3560]: EAL: PCI memory mapped at 0x7f2140200000\n"
15597
"ovs-vswitchd[3592]: PMD: eth_ixgbe_dev_init(): MAC: 4, PHY: 3\n"
15598
"ovs-vswitchd[3592]: PMD: eth_ixgbe_dev_init(): port 0 vendorID=0x8086 "
15599
"deviceID=0x1528\n"
15600
"ovs-ctl[3560]: PMD: eth_ixgbe_dev_init(): MAC: 4, PHY: 3\n"
15601
"ovs-ctl[3560]: PMD: eth_ixgbe_dev_init(): port 0 vendorID=0x8086 "
15602
"deviceID=0x1528\n"
15603
"ovs-ctl[3560]: Zone 0: name:<RG_MP_log_history>, phys:0x83fffdec0, "
15604
"len:0x2080, virt:0x7f213fffdec0, socket_id:0, flags:0\n"
15605
"ovs-ctl[3560]: Zone 1: name:<MP_log_history>, phys:0x83fd73d40, "
15606
"len:0x28a0c0, virt:0x7f213fd73d40, socket_id:0, flags:0\n"
15607
"ovs-ctl[3560]: Zone 2: name:<rte_eth_dev_data>, phys:0x83fd43380, "
15608
"len:0x2f700, virt:0x7f213fd43380, socket_id:0, flags:0\n"
15609
"ovs-ctl[3560]: * Starting ovs-vswitchd\n"
15610
"ovs-ctl[3560]: * Enabling remote OVSDB managers\n"
15611
"systemd[1]: Started Open vSwitch Internal Unit.\n"
15612
"systemd[1]: Starting Open vSwitch...\n"
15613
"systemd[1]: Started Open vSwitch.\n"
15616
"CMD: sudo ovs-vsctl add-br ovsdpdkbr0 -- set bridge ovsdpdkbr0 "
15617
"datapath_type=netdev\n"
15620
"2016-01-22T08:58:56.344Z|00008|memory|INFO|37256 kB peak resident set size "
15621
"after 24.5 seconds\n"
15622
"2016-01-22T08:58:56.346Z|00009|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
15623
"supports recirculation\n"
15624
"2016-01-22T08:58:56.346Z|00010|ofproto_dpif|INFO|netdev@ovs-netdev: MPLS "
15625
"label stack length probed as 3\n"
15626
"2016-01-22T08:58:56.346Z|00011|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
15627
"supports unique flow ids\n"
15628
"2016-01-22T08:58:56.346Z|00012|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
15629
"does not support ct_state\n"
15630
"2016-01-22T08:58:56.346Z|00013|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
15631
"does not support ct_zone\n"
15632
"2016-01-22T08:58:56.346Z|00014|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
15633
"does not support ct_mark\n"
15634
"2016-01-22T08:58:56.346Z|00015|ofproto_dpif|INFO|netdev@ovs-netdev: Datapath "
15635
"does not support ct_label\n"
15636
"2016-01-22T08:58:56.360Z|00016|bridge|INFO|bridge ovsdpdkbr0: added "
15637
"interface ovsdpdkbr0 on port 65534\n"
15638
"2016-01-22T08:58:56.361Z|00017|bridge|INFO|bridge ovsdpdkbr0: using datapath "
15639
"ID 00005a4a1ed0a14d\n"
15640
"2016-01-22T08:58:56.361Z|00018|connmgr|INFO|ovsdpdkbr0: added service "
15641
"controller \"punix:/var/run/openvswitch/ovsdpdkbr0.mgmt\"\n"
15644
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl add-br ovsdpdkbr0 -- set "
15645
"bridge ovsdpdkbr0 datapath_type=netdev\n"
15646
"systemd-udevd[3607]: Could not generate persistent MAC address for ovs-"
15647
"netdev: No such file or directory\n"
15648
"kernel: [50165.886554] device ovs-netdev entered promiscuous mode\n"
15649
"kernel: [50165.901261] device ovsdpdkbr0 entered promiscuous mode\n"
15652
"CMD: sudo ovs-vsctl add-port ovsdpdkbr0 dpdk0 -- set Interface dpdk0 "
15656
"2016-01-22T08:59:06.369Z|00019|memory|INFO|peak resident set size grew 155% "
15657
"in last 10.0 seconds, from 37256 kB to 95008 kB\n"
15658
"2016-01-22T08:59:06.369Z|00020|memory|INFO|handlers:4 ports:1 revalidators:2 "
15660
"2016-01-22T08:59:30.989Z|00021|dpdk|INFO|Port 0: 8c:dc:d4:b3:6d:e9\n"
15661
"2016-01-22T08:59:31.520Z|00022|dpdk|INFO|Port 0: 8c:dc:d4:b3:6d:e9\n"
15662
"2016-01-22T08:59:31.521Z|00023|dpif_netdev|INFO|Created 1 pmd threads on "
15664
"2016-01-22T08:59:31.522Z|00001|dpif_netdev(pmd16)|INFO|Core 0 processing "
15666
"2016-01-22T08:59:31.522Z|00024|bridge|INFO|bridge ovsdpdkbr0: added "
15667
"interface dpdk0 on port 1\n"
15668
"2016-01-22T08:59:31.522Z|00025|bridge|INFO|bridge ovsdpdkbr0: using datapath "
15669
"ID 00008cdcd4b36de9\n"
15670
"2016-01-22T08:59:31.523Z|00002|dpif_netdev(pmd16)|INFO|Core 0 processing "
15674
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl add-port ovsdpdkbr0 "
15675
"dpdk0 -- set Interface dpdk0 type=dpdk\n"
15676
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a79ebc0 "
15677
"hw_ring=0x7f211a7a6c00 dma_addr=0x81a7a6c00\n"
15678
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15679
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15680
"ovs-vswitchd[3595]: PMD: ixgbe_dev_rx_queue_setup(): sw_ring=0x7f211a78a6c0 "
15681
"sw_sc_ring=0x7f211a786580 hw_ring=0x7f211a78e800 dma_addr=0x81a78e800\n"
15682
"ovs-vswitchd[3595]: PMD: ixgbe_set_rx_function(): Vector rx enabled, please "
15683
"make sure RX burst size no less than 4 (port=0).\n"
15684
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a79ebc0 "
15685
"hw_ring=0x7f211a7a6c00 dma_addr=0x81a7a6c00\n"
15686
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15687
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15688
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a76e4c0 "
15689
"hw_ring=0x7f211a776500 dma_addr=0x81a776500\n"
15690
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15691
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15692
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a756440 "
15693
"hw_ring=0x7f211a75e480 dma_addr=0x81a75e480\n"
15694
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15695
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15696
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a73e3c0 "
15697
"hw_ring=0x7f211a746400 dma_addr=0x81a746400\n"
15698
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15699
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15700
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a726340 "
15701
"hw_ring=0x7f211a72e380 dma_addr=0x81a72e380\n"
15702
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15703
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15704
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a70e2c0 "
15705
"hw_ring=0x7f211a716300 dma_addr=0x81a716300\n"
15706
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15707
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15708
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a6f6240 "
15709
"hw_ring=0x7f211a6fe280 dma_addr=0x81a6fe280\n"
15710
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15711
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15712
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a6de1c0 "
15713
"hw_ring=0x7f211a6e6200 dma_addr=0x81a6e6200\n"
15714
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15715
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15716
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a6c6140 "
15717
"hw_ring=0x7f211a6ce180 dma_addr=0x81a6ce180\n"
15718
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15719
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15720
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a6ae0c0 "
15721
"hw_ring=0x7f211a6b6100 dma_addr=0x81a6b6100\n"
15722
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15723
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15724
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a696040 "
15725
"hw_ring=0x7f211a69e080 dma_addr=0x81a69e080\n"
15726
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15727
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15728
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a67dfc0 "
15729
"hw_ring=0x7f211a686000 dma_addr=0x81a686000\n"
15730
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15731
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15732
"ovs-vswitchd[3595]: PMD: ixgbe_dev_tx_queue_setup(): sw_ring=0x7f211a665e40 "
15733
"hw_ring=0x7f211a66de80 dma_addr=0x81a66de80\n"
15734
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Using simple tx code path\n"
15735
"ovs-vswitchd[3595]: PMD: ixgbe_set_tx_function(): Vector tx enabled.\n"
15736
"ovs-vswitchd[3595]: PMD: ixgbe_dev_rx_queue_setup(): sw_ring=0x7f211a78a6c0 "
15737
"sw_sc_ring=0x7f211a786580 hw_ring=0x7f211a78e800 dma_addr=0x81a78e800\n"
15738
"ovs-vswitchd[3595]: PMD: ixgbe_set_rx_function(): Vector rx enabled, please "
15739
"make sure RX burst size no less than 4 (port=0).\n"
15742
"CMD: sudo ovs-vsctl add-port ovsdpdkbr0 vhost-user-1 -- set Interface vhost-"
15743
"user-1 type=dpdkvhostuser\n"
15746
"2016-01-22T09:00:35.145Z|00026|dpdk|INFO|Socket /var/run/openvswitch/vhost-"
15747
"user-1 created for vhost-user port vhost-user-1\n"
15748
"2016-01-22T09:00:35.145Z|00003|dpif_netdev(pmd16)|INFO|Core 0 processing "
15750
"2016-01-22T09:00:35.145Z|00004|dpif_netdev(pmd16)|INFO|Core 0 processing "
15751
"port 'vhost-user-1'\n"
15752
"2016-01-22T09:00:35.145Z|00027|bridge|INFO|bridge ovsdpdkbr0: added "
15753
"interface vhost-user-1 on port 2\n"
15756
"ovs-vsctl: ovs|00001|vsctl|INFO|Called as ovs-vsctl add-port ovsdpdkbr0 "
15757
"vhost-user-1 -- set Interface vhost-user-1 type=dpdkvhostuser\n"
15758
"ovs-vswitchd[3595]: VHOST_CONFIG: socket created, fd:46\n"
15759
"ovs-vswitchd[3595]: VHOST_CONFIG: bind to /var/run/openvswitch/vhost-user-1\n"
15761
"Eventually we can see the poll thread in top\n"
15762
" PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND\n"
15763
" 3595 root 10 -10 4975344 103936 9916 S 100.0 0.3 33:13.56 ovs-"
15768
#: serverguide/C/network-config.xml:1950(ulink)
15183
15769
msgid "DPDK Documentation"
15186
#: serverguide/C/network-config.xml:1701(ulink)
15772
#: serverguide/C/network-config.xml:1955(ulink)
15187
15773
msgid "Release Notes matching the version packages in Ubuntu 16.04"
15190
#: serverguide/C/network-config.xml:1706(ulink)
15776
#: serverguide/C/network-config.xml:1960(ulink)
15191
15777
msgid "Linux DPDK User Getting Started"
15194
#: serverguide/C/network-config.xml:1711(ulink)
15780
#: serverguide/C/network-config.xml:1965(ulink)
15195
15781
msgid "EAL Command-line Options"
15198
#: serverguide/C/network-config.xml:1716(ulink)
15784
#: serverguide/C/network-config.xml:1970(ulink)
15199
15785
msgid "DPDK Api Documentation"
15202
#: serverguide/C/network-config.xml:1721(ulink)
15788
#: serverguide/C/network-config.xml:1975(ulink)
15203
15789
msgid "OpenVswitch DPDK installation"
15206
#: serverguide/C/network-config.xml:1726(ulink)
15792
#: serverguide/C/network-config.xml:1980(ulink)
15207
15793
msgid "Wikipedias definition of DPDK"
23841
24416
#: serverguide/C/lamp-applications.xml:278(title)
23845
24420
#: serverguide/C/lamp-applications.xml:280(para)
23847
"MediaWiki is an web based Wiki software written in the PHP language. It can "
23848
"either use <application>MySQL</application> or "
23849
"<application>PostgreSQL</application> Database Management System."
23852
#: serverguide/C/lamp-applications.xml:290(para)
23854
"Before installing <application>MediaWiki</application> you should also "
23855
"install <application>Apache2</application>, the "
23856
"<application>PHP</application> scripting language and a Database Management "
23857
"System. <application>MySQL</application> or "
23858
"<application>PostgreSQL</application> are the most common, choose one "
23859
"depending on your need. Please refer to those sections in this manual for "
23860
"installation instructions."
23863
#: serverguide/C/lamp-applications.xml:298(para)
23865
"To install <application>MediaWiki</application>, run the following command "
23866
"in the command prompt:"
23869
#: serverguide/C/lamp-applications.xml:304(command)
23870
msgid "sudo apt install mediawiki php-gd"
23873
#: serverguide/C/lamp-applications.xml:307(para)
23875
"For additional <application>MediaWiki</application> functionality see the "
23876
"<application>mediawiki-extensions</application> package."
23879
#: serverguide/C/lamp-applications.xml:317(para)
23881
"The Apache configuration file <filename>mediawiki.conf</filename> for "
23882
"<application>MediaWiki</application> is installed in "
23883
"<filename>/etc/apache2/conf-available/</filename> directory. To access "
23884
"<application>MediaWiki</application>, uncomment the following line in the "
23888
#: serverguide/C/lamp-applications.xml:324(screen)
23892
"# Alias /mediawiki /var/lib/mediawiki\n"
23895
#: serverguide/C/lamp-applications.xml:328(para)
23897
"The <application>MediaWiki</application> configuration also needs to be "
23901
#: serverguide/C/lamp-applications.xml:332(command)
23902
msgid "sudo a2enconf mediawiki.conf"
23905
#: serverguide/C/lamp-applications.xml:335(para)
23906
msgid "Restart Apache server."
23909
#: serverguide/C/lamp-applications.xml:342(para)
23911
"Access <application>MediaWiki</application> by visiting <ulink "
23912
"url=\"http://localhost/mediawiki/mw-"
23913
"config/index.php\">http://localhost/mediawiki/mw-config/index.php</ulink>. "
23914
"(Or <ulink url=\"http://NAME_OF_YOUR_VIRTUAL_HOST/mediawiki/mw-"
23915
"config/index.php\">http://NAME_OF_YOUR_VIRTUAL_HOST/mediawiki/mw-"
23916
"config/index.php</ulink> if your server has no GUI.)"
23919
#: serverguide/C/lamp-applications.xml:350(para)
23921
"Please read the <quote>Environmental checks</quote> section of the "
23922
"configuration page. You should be able to fix many issues by carefully "
23923
"reading this section."
23926
#: serverguide/C/lamp-applications.xml:357(para)
23928
"Once the configuration is complete, you should copy the "
23929
"<filename>LocalSettings.php</filename> file to "
23930
"<filename>/etc/mediawiki</filename> directory:"
23933
#: serverguide/C/lamp-applications.xml:364(command)
23934
msgid "sudo mv /var/lib/mediawiki/config/LocalSettings.php /etc/mediawiki/"
23937
#: serverguide/C/lamp-applications.xml:367(para)
23939
"You may also want to edit "
23940
"<filename>/etc/mediawiki/LocalSettings.php</filename> in order to set the "
23941
"memory limit (disabled by default):"
23944
#: serverguide/C/lamp-applications.xml:372(programlisting)
23948
"ini_set( 'memory_limit', '64M' );\n"
23951
#: serverguide/C/lamp-applications.xml:379(title)
23955
#: serverguide/C/lamp-applications.xml:380(para)
23957
"The extensions add new features and enhancements for the MediaWiki "
23958
"application. The extensions give wiki administrators and end users the "
23959
"ability to customize MediaWiki to their requirements."
23962
#: serverguide/C/lamp-applications.xml:386(para)
23964
"You can download MediaWiki extensions as an archive file or checkout from "
23965
"the Subversion repository. You should copy it to "
23966
"<filename>/var/lib/mediawiki/extensions</filename> directory. You should "
23967
"also add the following line at the end of file: "
23968
"<filename>/etc/mediawiki/LocalSettings.php</filename>."
23971
#: serverguide/C/lamp-applications.xml:394(programlisting)
23975
"require_once \"$IP/extensions/ExtentionName/ExtentionName.php\";\n"
23978
#: serverguide/C/lamp-applications.xml:404(para)
23980
"For more details, please refer to the <ulink "
23981
"url=\"http://www.mediawiki.org\">MediaWiki</ulink> web site."
23984
#: serverguide/C/lamp-applications.xml:410(para)
23986
"The <ulink url=\"http://www.packtpub.com/Mediawiki/book\">MediaWiki "
23987
"Administrators' Tutorial Guide</ulink> contains a wealth of information for "
23988
"new MediaWiki administrators."
23991
#: serverguide/C/lamp-applications.xml:416(para)
23993
"Also, the <ulink url=\"https://help.ubuntu.com/community/MediaWiki\">Ubuntu "
23994
"Wiki MediaWiki</ulink> page is a good resource."
23997
#: serverguide/C/lamp-applications.xml:426(title)
24001
#: serverguide/C/lamp-applications.xml:428(para)
24003
24422
"<application>phpMyAdmin</application> is a LAMP application specifically "
24004
24423
"written for administering <application>MySQL</application> servers. Written "
24005
24424
"in <application>PHP</application>, and accessed through a web browser, "
24006
24425
"phpMyAdmin provides a graphical interface for database administration tasks."
24009
#: serverguide/C/lamp-applications.xml:437(para)
24428
#: serverguide/C/lamp-applications.xml:289(para)
24011
24430
"Before installing <application>phpMyAdmin</application> you will need access "
24012
24431
"to a <application>MySQL</application> database either on the same host as "