File: sysprep-operations.pod

package info (click to toggle)
guestfs-tools 1.52.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 69,236 kB
  • sloc: ansic: 15,698; ml: 15,621; sh: 7,396; xml: 5,478; makefile: 3,601; perl: 1,535; lex: 135; yacc: 128; python: 80
file content (622 lines) | stat: -rw-r--r-- 12,842 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622

=head2 B<abrt-data> *

ABRT により生成されたクラッシュデータを削除します。

C</var/spool/abrt/> に自動的に生成された ABRT クラッシュデータを削除します。

=head2 B<backup-files> *

Remove editor backup files from the guest.

The following files are removed from anywhere in the guest filesystem:

=over 4

=item ·

*.bak

=item ·

*~

=back

On Linux and Unix operating systems, only the following filesystems will be examined:

=over 4

=item ·

/etc

=item ·

/root

=item ·

/srv

=item ·

/tmp

=item ·

/var

=back

=head2 B<bash-history> *

仮想マシンにおいて bash 履歴を削除します。

ユーザー "root" および他のあらゆるユーザーのホームディレクトリーに C<.bash_history> ファイルを持つユーザーの bash 履歴を削除します。

=head3 Notes on bash-history

Currently this only looks in C</root> and C</home/*> for home directories, so users with home directories in other locations won't have the bash history removed.

=head2 B<blkid-tab> *

ゲストにある blkid テーブルを削除します。

=head2 B<ca-certificates>

仮想マシンにおいて CA 証明書を削除します。

In case any certificate is removed, the system CA store is updated.

=head2 B<crash-data> *

kexec-tools により生成されたクラッシュデータを削除します。

自動的に生成された kdump カーネルクラッシュデータを削除します。

=head2 B<cron-spool> *

ユーザーの at ジョブおよび cron ジョブを削除します。

=head2 B<customize> *

Customize the guest.

Customize the guest by providing L<virt-customize(1)> options for installing packages, editing files and so on.

=head2 B<dhcp-client-state> *

DHCP クライアントのリースを削除します。

=head2 B<dhcp-server-state> *

DHCP サーバーのリースを削除します。

=head2 B<dovecot-data> *

Dovecot (メールサーバー) のデータを削除します。

=head2 B<firewall-rules>

ファイアウォールルールを削除します。

This removes custom firewall rules by removing C</etc/sysconfig/iptables> or custom firewalld configuration in C</etc/firewalld/*/*>.

Note this is I<not> enabled by default since it may expose guests to exploits.  Use with care.

=head2 B<flag-reconfiguration>

Flag the system for reconfiguration.

For Linux guests, this touches C</.unconfigured>, which causes the first boot to interactively query the user for settings such as the root password and timezone.

=head2 B<fs-uuids>

Change filesystem UUIDs.

On guests and filesystem types where this is supported, new random UUIDs are generated and assigned to filesystems.

=head3 Notes on fs-uuids

The fs-uuids operation is disabled by default because it does not yet find and update all the places in the guest that use the UUIDs.  For example C</etc/fstab> or the bootloader.  Enabling this operation is more likely than not to make your guest unbootable.

参照: L<https://bugzilla.redhat.com/show_bug.cgi?id=991641>

=head2 B<ipa-client> *

Remove the IPA files.

Remove all the files related to an IPA (Identity, Policy, Audit) system. This effectively unenrolls the guest from an IPA server without interacting with it.

This operation does not run C<ipa-client>.

=head2 B<kerberos-data>

仮想マシンにおいて Kerberos のデータを削除します。

=head2 B<kerberos-hostkeytab> *

Remove the Kerberos host keytab file in the guest.

=head2 B<logfiles> *

仮想マシンから多くのログファイルを削除します。

Linux においては以下のファイルが削除されます:

=over 4

=item ·

/etc/Pegasus/*.cnf

=item ·

/etc/Pegasus/*.crt

=item ·

/etc/Pegasus/*.csr

=item ·

/etc/Pegasus/*.pem

=item ·

/etc/Pegasus/*.srl

=item ·

/root/anaconda-ks.cfg

=item ·

/root/anaconda-post.log

=item ·

/root/initial-setup-ks.cfg

=item ·

/root/install.log

=item ·

/root/install.log.syslog

=item ·

/root/original-ks.cfg

=item ·

/var/cache/fontconfig/*

=item ·

/var/cache/gdm/*

=item ·

/var/cache/man/*

=item ·

/var/lib/AccountService/users/*

=item ·

/var/lib/fprint/*

=item ·

/var/lib/logrotate.status

=item ·

/var/log/*.log*

=item ·

/var/log/BackupPC/LOG

=item ·

/var/log/ConsoleKit/*

=item ·

/var/log/anaconda.syslog

=item ·

/var/log/anaconda/*

=item ·

/var/log/apache2/*_log

=item ·

/var/log/apache2/*_log-*

=item ·

/var/log/apt/*

=item ·

/var/log/aptitude*

=item ·

/var/log/audit/*

=item ·

/var/log/btmp*

=item ·

/var/log/ceph/*.log

=item ·

/var/log/chrony/*.log

=item ·

/var/log/cron*

=item ·

/var/log/cups/*_log*

=item ·

/var/log/debug*

=item ·

/var/log/dmesg*

=item ·

/var/log/exim4/*

=item ·

/var/log/faillog*

=item ·

/var/log/firewalld*

=item ·

/var/log/gdm/*

=item ·

/var/log/glusterfs/*glusterd.vol.log

=item ·

/var/log/glusterfs/glusterfs.log

=item ·

/var/log/grubby*

=item ·

/var/log/httpd/*log

=item ·

/var/log/installer/*

=item ·

/var/log/jetty/jetty-console.log

=item ·

/var/log/journal/*

=item ·

/var/log/lastlog*

=item ·

/var/log/libvirt/libvirtd.log

=item ·

/var/log/libvirt/libxl/*.log

=item ·

/var/log/libvirt/lxc/*.log

=item ·

/var/log/libvirt/qemu/*.log

=item ·

/var/log/libvirt/uml/*.log

=item ·

/var/log/lightdm/*

=item ·

/var/log/mail/*

=item ·

/var/log/maillog*

=item ·

/var/log/messages*

=item ·

/var/log/ntp

=item ·

/var/log/ntpstats/*

=item ·

/var/log/ppp/connect-errors

=item ·

/var/log/rhsm/*

=item ·

/var/log/sa/*

=item ·

/var/log/secure*

=item ·

/var/log/setroubleshoot/*.log

=item ·

/var/log/spooler*

=item ·

/var/log/squid/*.log

=item ·

/var/log/syslog*

=item ·

/var/log/tallylog*

=item ·

/var/log/tuned/tuned.log

=item ·

/var/log/wtmp*

=item ·

/var/log/xferlog*

=item ·

/var/named/data/named.run

=back

=head2 B<lvm-system-devices> *

Remove LVM2 system.devices file.

On Linux guests, LVM2's scanning for physical volumes (PVs) may be restricted to those block devices whose WWIDs are listed in C</etc/lvm/devices/system.devices>.  When cloning VMs, WWIDs may change, breaking C<lvm pvscan>.  Remove C</etc/lvm/devices/system.devices>.

=head2 B<lvm-uuids> *

LVM2 の PV および VG の UUID を変更します。

LVM2 物理ボリューム (PV) またはボリュームグループ (VG) を持つ Linux 仮想マシンにおいて、新しいランダムな UUID が生成され、これらの PV や VG に割り当てられます。

=head2 B<machine-id> *

ローカルマシン ID を削除します。

The machine ID is usually generated from a random source during system installation and stays constant for all subsequent boots.  Optionally, for stateless systems it is generated during runtime at boot if it is found to be empty.

=head2 B<mail-spool> *

ローカルのメールスプールのディレクトリから電子メールを削除します。

=head2 B<net-hostname> *

Remove HOSTNAME and DHCP_HOSTNAME in network interface configuration.

Fedora および Red Hat Enterprise Linux に対して、これは C<ifcfg-*> ファイルから削除されます。

=head2 B<net-hwaddr> *

HWADDR (ハードコードされた MAC アドレス) 設定を削除します。

Fedora および Red Hat Enterprise Linux に対して、これは C<ifcfg-*> ファイルから削除されます。

=head2 B<net-nmconn> *

Remove system-local NetworkManager connection profiles (keyfiles).

On Fedora and Red Hat Enterprise Linux, remove the C</etc/NetworkManager/system-connections/*.nmconnection> files.

=head2 B<pacct-log> *

プロセス・アカウンティングのログファイルを削除します。

プロセス・アカウンティングが有効になっていると、システム全体のプロセス・アカウンティングが pacct ログファイルに保存されます。

=head2 B<package-manager-cache> *

パッケージマネージャーのキャッシュを削除します。

=head2 B<pam-data> *

ゲストにある PAM データを削除します。

=head2 B<passwd-backups> *

Remove /etc/passwd- and similar backup files.

Linux においては以下のファイルが削除されます:

=over 4

=item ·

/etc/group-

=item ·

/etc/gshadow-

=item ·

/etc/passwd-

=item ·

/etc/shadow-

=item ·

/etc/subgid-

=item ·

/etc/subuid-

=back

=head2 B<puppet-data-log> *

Puppet のデータおよびログファイルを削除します。

=head2 B<rh-subscription-manager> *

Remove the RH subscription manager files.

=head2 B<rhn-systemid> *

RHN システム ID を削除します。

=head2 B<rpm-db> *

Remove host-specific RPM database files.

Remove host-specific RPM database files and locks.  RPM will recreate these files automatically if needed.

=head2 B<samba-db-log> *

Samba のデータベースおよびログファイルを削除します。

=head2 B<script> *

仮想マシンに対して任意のスクリプトを実行します。

The C<script> module lets you run arbitrary shell scripts or programs against the guest.

Note this feature requires FUSE support.  You may have to enable this in your host, for example by adding the current user to the C<fuse> group, or by loading a kernel module.

Use one or more I<--script> parameters to specify scripts or programs that will be run against the guest.

The script or program is run with its current directory being the guest’s root directory, so relative paths should be used.  For example: C<rm etc/resolv.conf> in the script would remove a Linux guest’s DNS configuration file, but C<rm /etc/resolv.conf> would (try to) remove the host’s file.

Normally a temporary mount point for the guest is used, but you can choose a specific one by using the I<--scriptdir> parameter.

B<Note:> This is different from I<--firstboot> scripts (which run in the context of the guest when it is booting first time).  I<--script> scripts run on the host, not in the guest.

=head2 B<smolt-uuid> *

Smolt ハードウェア UUID を削除します。

=head2 B<ssh-hostkeys> *

仮想マシンの SSH ホストキーを削除します。

仮想マシンの次回起動時に(異なる) SSH ホストキーが再生成されます。

クローン後、仮想マシンが同じ IP アドレスを取得すると、ホストキーが変更されたという警告が ssh により表示されます:

 @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
 @    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
 @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
 IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!

=head2 B<ssh-userdir> *

仮想マシンにある ".ssh" ディレクトリーを削除します。

ユーザー "root" 、およびホームディレクトリーに C<.ssh> ディレクトリーがある他のすべてのユーザーの、C<.ssh> ディレクトリーを削除します。

=head3 Notes on ssh-userdir

Currently this only looks in C</root> and C</home/*> for home directories, so users with home directories in other locations won't have the ssh files removed.

=head2 B<sssd-db-log> *

SSSD のデータベースとログファイルを削除します。

=head2 B<tmp-files> *

一時ファイルを削除します。

これは C</tmp> と C</var/tmp> の中にある一時ファイルを削除します。

=head2 B<udev-persistent-net> *

udev persistent net ルールを削除します。

Remove udev persistent net rules which map the guest’s existing MAC address to a fixed ethernet device (eg. eth0).

仮想マシンをクローンした後、通常 MAC アドレスは変わります。古い MAC アドレスは古い名前(たとえば eth0)を占有するため、このことは新しい MAC アドレスが新しい名前(たとえば eth1)に割り当てられることを意味します。それは、一般的に好ましくありません。 udev の永続的な net ルールを削除することにより、これを避けます。

=head2 B<user-account>

仮想マシンにあるユーザーアカウントを削除します。

By default remove all the user accounts and their home directories.  The "root" account is not removed.

See the I<--remove-user-accounts> parameter for a way to specify how to remove only some users, or to not remove some others.

=head2 B<utmp> *

utmp ファイルを削除します。

This file records who is currently logged in on a machine.  In modern Linux distros it is stored in a ramdisk and hence not part of the virtual machine’s disk, but it was stored on disk in older distros.

=head2 B<yum-uuid> *

yum UUID を削除します。

yum は元々の UUID が削除されたことを通知するとき、次の実行時に新しい UUID を作成します。