machinery-tool 1.18.0 → 1.19.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (122) hide show
  1. checksums.yaml +4 -4
  2. data/.git_revision +1 -1
  3. data/NEWS +17 -0
  4. data/bin/machinery +10 -2
  5. data/html/comparison.html.haml +1 -1
  6. data/html/index.html.haml +2 -2
  7. data/html/partials/{config_files.html.haml → changed_config_files.html.haml} +10 -10
  8. data/html/partials/compare/changed_config_files.html.haml +48 -0
  9. data/html/partials/compare/{config_file_list.html.haml → changed_config_files_list.html.haml} +0 -0
  10. data/html/partials/compare/unmanaged_file_list.html.haml +1 -1
  11. data/html/partials/compare/unmanaged_files.html.haml +2 -2
  12. data/html/partials/patterns.html.haml +5 -0
  13. data/html/upgrade.html.haml +49 -0
  14. data/lib/{analyze_config_file_diffs_task.rb → analyze_changed_config_files_diffs_task.rb} +8 -8
  15. data/lib/autoyast.rb +12 -13
  16. data/lib/build_task.rb +2 -2
  17. data/lib/cli.rb +39 -32
  18. data/lib/compare_task.rb +1 -1
  19. data/lib/config_base.rb +1 -1
  20. data/lib/deploy_task.rb +4 -4
  21. data/lib/docker_system.rb +1 -1
  22. data/lib/element_filter.rb +3 -3
  23. data/lib/export_task.rb +3 -3
  24. data/lib/file_validator.rb +8 -5
  25. data/lib/filter.rb +5 -5
  26. data/lib/filter_option_parser.rb +3 -3
  27. data/lib/hint.rb +9 -4
  28. data/lib/html.rb +3 -3
  29. data/lib/inspect_task.rb +3 -3
  30. data/lib/json_schema_monkey_patch.rb +2 -2
  31. data/lib/json_validation_error_cleaner.rb +1 -1
  32. data/lib/json_validator.rb +2 -2
  33. data/lib/kiwi_config.rb +39 -14
  34. data/lib/list_task.rb +1 -1
  35. data/lib/local_system.rb +4 -4
  36. data/lib/machinery.rb +1 -1
  37. data/lib/machinery_logger.rb +4 -4
  38. data/lib/manifest.rb +5 -5
  39. data/lib/migration.rb +4 -4
  40. data/lib/object.rb +6 -10
  41. data/lib/remove_task.rb +1 -1
  42. data/lib/renderer.rb +5 -5
  43. data/lib/scope_file_access_archive.rb +2 -2
  44. data/lib/scope_file_access_flat.rb +3 -3
  45. data/lib/scope_file_store.rb +3 -3
  46. data/lib/serve_html_task.rb +15 -2
  47. data/lib/server.rb +32 -12
  48. data/lib/system.rb +1 -1
  49. data/lib/system_description.rb +16 -14
  50. data/lib/system_description_store.rb +5 -6
  51. data/lib/ui.rb +1 -1
  52. data/lib/upgrade_format_task.rb +2 -2
  53. data/lib/version.rb +1 -1
  54. data/lib/workload_mapper.rb +11 -11
  55. data/lib/zypper.rb +1 -1
  56. data/machinery-helper/Rakefile +1 -1
  57. data/machinery-helper/version.go +1 -1
  58. data/man/generated/machinery.1.gz +0 -0
  59. data/manual/docs/machinery-analyze.1.md +3 -3
  60. data/manual/docs/machinery-compare.1.md +2 -2
  61. data/manual/docs/machinery-inspect-docker.1.md +1 -1
  62. data/manual/docs/machinery-inspect.1.md +4 -1
  63. data/manual/docs/machinery-show.1.md +2 -2
  64. data/manual/docs/machinery_main_general.1.md +1 -1
  65. data/manual/docs/machinery_main_scopes.1.md +8 -6
  66. data/manual/site/machinery-analyze.1/index.html +3 -3
  67. data/manual/site/machinery-compare.1/index.html +2 -2
  68. data/manual/site/machinery-inspect-docker.1/index.html +1 -1
  69. data/manual/site/machinery-inspect.1/index.html +3 -1
  70. data/manual/site/machinery-show.1/index.html +2 -2
  71. data/manual/site/machinery_main_general.1/index.html +1 -1
  72. data/manual/site/machinery_main_scopes.1/index.html +8 -6
  73. data/manual/site/mkdocs/search_index.json +17 -17
  74. data/manual/site/sitemap.xml +23 -23
  75. data/plugins/{config_files/config_files.yml → changed_config_files/changed_config_files.yml} +3 -3
  76. data/plugins/{config_files/config_files_inspector.rb → changed_config_files/changed_config_files_inspector.rb} +14 -10
  77. data/plugins/{config_files/config_files_model.rb → changed_config_files/changed_config_files_model.rb} +1 -1
  78. data/plugins/{config_files/config_files_renderer.rb → changed_config_files/changed_config_files_renderer.rb} +9 -9
  79. data/plugins/{config_files/schema/system-description-config-files.schema-v1.json → changed_config_files/schema/system-description-changed-config-files.schema-v1.json} +0 -0
  80. data/plugins/{config_files/schema/system-description-config-files.schema-v2.json → changed_config_files/schema/system-description-changed-config-files.schema-v2.json} +0 -0
  81. data/plugins/{config_files/schema/system-description-config-files.schema-v3.json → changed_config_files/schema/system-description-changed-config-files.schema-v3.json} +0 -0
  82. data/plugins/{config_files/schema/system-description-config-files.schema-v4.json → changed_config_files/schema/system-description-changed-config-files.schema-v4.json} +0 -0
  83. data/plugins/{config_files/schema/system-description-config-files.schema-v5.json → changed_config_files/schema/system-description-changed-config-files.schema-v5.json} +0 -0
  84. data/plugins/{config_files/schema/system-description-config-files.schema-v6.json → changed_config_files/schema/system-description-changed-config-files.schema-v6.json} +0 -0
  85. data/plugins/{config_files/schema/system-description-config-files.schema-v7.json → changed_config_files/schema/system-description-changed-config-files.schema-v7.json} +0 -0
  86. data/plugins/changed_config_files/schema/system-description-changed-config-files.schema-v8.json +160 -0
  87. data/plugins/changed_managed_files/changed_managed_files_inspector.rb +6 -2
  88. data/plugins/changed_managed_files/changed_managed_files_renderer.rb +1 -1
  89. data/plugins/changed_managed_files/schema/system-description-changed-managed-files.schema-v8.json +160 -0
  90. data/plugins/environment/schema/system-description-environment.schema-v8.json +17 -0
  91. data/plugins/groups/groups_inspector.rb +1 -1
  92. data/plugins/groups/groups_renderer.rb +1 -1
  93. data/plugins/groups/schema/system-description-groups.schema-v8.json +49 -0
  94. data/plugins/os/os_inspector.rb +6 -6
  95. data/plugins/os/os_renderer.rb +1 -1
  96. data/plugins/os/schema/system-description-os.schema-v8.json +21 -0
  97. data/plugins/packages/packages_inspector.rb +1 -1
  98. data/plugins/packages/schema/system-description-packages.schema-v8.json +115 -0
  99. data/plugins/patterns/patterns.yml +5 -3
  100. data/plugins/patterns/patterns_inspector.rb +4 -3
  101. data/plugins/patterns/patterns_renderer.rb +5 -1
  102. data/plugins/patterns/schema/system-description-patterns.schema-v8.json +58 -0
  103. data/plugins/repositories/repositories_inspector.rb +2 -1
  104. data/plugins/repositories/schema/system-description-repositories.schema-v8.json +165 -0
  105. data/plugins/services/schema/system-description-services.schema-v8.json +93 -0
  106. data/plugins/services/services.yml +1 -1
  107. data/plugins/services/services_inspector.rb +1 -1
  108. data/plugins/unmanaged_files/schema/system-description-unmanaged-files.schema-v8.json +124 -0
  109. data/plugins/unmanaged_files/unmanaged_files_inspector.rb +9 -4
  110. data/plugins/unmanaged_files/unmanaged_files_model.rb +12 -5
  111. data/plugins/unmanaged_files/unmanaged_files_renderer.rb +1 -1
  112. data/plugins/users/schema/system-description-users.schema-v8.json +86 -0
  113. data/plugins/users/users_inspector.rb +7 -7
  114. data/schema/migrations/migrate1to2.rb +4 -4
  115. data/schema/migrations/migrate2to3.rb +1 -1
  116. data/schema/migrations/migrate3to4.rb +9 -9
  117. data/schema/migrations/migrate7to8.rb +47 -0
  118. data/schema/system-description-global.schema-v8.json +43 -0
  119. data/workload_mapper/rails/setup/setup.rb.erb +1 -1
  120. data/workload_mapper/wordpress/setup/setup.rb.erb +1 -1
  121. metadata +31 -17
  122. data/html/partials/compare/config_files.html.haml +0 -48
@@ -3,7 +3,7 @@
3
3
 
4
4
  ## SYNOPSIS
5
5
 
6
- `machinery show` [-s SCOPE | --scope=SCOPE] [-e EXCLUDE-SCOPE | --exclude-scope=EXCLUDE-SCOPE] [--no-pager] [--show-diffs] [--html] NAME
6
+ `machinery show` [-s SCOPE | --scope=SCOPE] [-e IGNORE-SCOPE | --ignore-scope=IGNORE-SCOPE] [--no-pager] [--show-diffs] [--html] NAME
7
7
 
8
8
  `machinery` help show
9
9
 
@@ -30,7 +30,7 @@ in local time are shown in the title of each scope section.
30
30
  If displaying information related to a scope fails, `show` will print an error message what has failed.
31
31
  In case of an error, no content is displayed.
32
32
 
33
- * `-e EXCLUDE-SCOPE`, `--exclude-scope=EXCLUDE-SCOPE` (optional):
33
+ * `-e IGNORE-SCOPE`, `--ignore-scope=IGNORE-SCOPE` (optional):
34
34
  Skip output of the specified scope.
35
35
  See the [Scope section](#Scopes) for more information.
36
36
 
@@ -105,7 +105,7 @@ name which can be used by all subcommands.
105
105
 
106
106
  The system description is structured into "scopes". A scope covers a specific
107
107
  part of the configuration of the inspected system such as installed packages,
108
- repositories, or configuration files.
108
+ repositories, or changed configuration files.
109
109
 
110
110
  For example, if you are only interested in the installed packages, limit the
111
111
  scope to `packages`. This will output only the requested information.
@@ -10,11 +10,13 @@ inspected system.
10
10
 
11
11
  * patterns
12
12
 
13
- Contains all patterns installed on the inspected system. A pattern is a
14
- collection of software packages.
13
+ Contains all patterns or tasks installed on the inspected system. A pattern is a
14
+ collection of software packages, similar to the idea of tasks on Debian/Ubuntu-
15
+ like systems.
15
16
  The meaning of software patterns depends on the package manager of the
16
17
  distribution. Therefore, the pattern scope on SUSE based systems uses the
17
- `zypper` command to obtain the information about installed pattern names.
18
+ `zypper` command to obtain the information about installed pattern names, whereas
19
+ on Debian based systems the `tasksel` tool is necessary to list installed tasks.
18
20
 
19
21
  * repositories
20
22
 
@@ -61,13 +63,13 @@ or waiting for requests to do work.
61
63
  The scope determines which services are configured to be started in which
62
64
  runlevel. It uses the `chkconfig` command to obtain that information.
63
65
  The xinetd services that are also displayed by `chkconfig` are switched
64
- on/off by editing config files and are ignored in this context.
66
+ on/off by editing configuration files and are ignored in this context.
65
67
 
66
- * config_files
68
+ * changed_config_files
67
69
 
68
70
  Contains all configuration files which have been changed since they were
69
71
  installed.
70
- Configuration files are all those files which are marked as such in the
72
+ Changed configuration files are all those files which are marked as such in the
71
73
  package which has installed them. A configuration file change is reported
72
74
  if its content or its attributes like Linux permission bits or ownership
73
75
  have changed.
@@ -139,8 +139,8 @@
139
139
  <p>The <code>analyze</code> subcommand analyzes an existing system description and enriches
140
140
  it with additional information. Supported operations are:</p>
141
141
  <ul>
142
- <li><code>config-file-diffs</code>:
143
- Generates the diffs between the extracted changed config files from the
142
+ <li><code>changed-config-files-diffs</code>:
143
+ Generates the diffs between the extracted changed configuration files from the
144
144
  system and the original versions from the RPM packages.
145
145
  The diffs can be shown using <code>machinery show --show-diffs</code></li>
146
146
  </ul>
@@ -158,7 +158,7 @@ it with additional information. Supported operations are:</p>
158
158
  <ul>
159
159
  <li>
160
160
  <p>Analyze the config file diffs for the <code>myhost</code> system description:</p>
161
- <p>$ <code>machinery</code> analyze myhost --operation=config-file-diffs</p>
161
+ <p>$ <code>machinery</code> analyze myhost --operation=changed-config-files-diffs</p>
162
162
  </li>
163
163
  </ul>
164
164
  </div>
@@ -133,7 +133,7 @@
133
133
  <div class="content">
134
134
  <h1 id="compare-compare-system-descriptions">compare — Compare System Descriptions</h1>
135
135
  <h2 id="synopsis">SYNOPSIS</h2>
136
- <p><code>machinery compare</code> [-s SCOPE | --scope=SCOPE] [-e EXCLUDE-SCOPE | --exclude-scope=EXCLUDE-SCOPE] [--no-pager] [--show-all] [--html] NAME1 NAME2</p>
136
+ <p><code>machinery compare</code> [-s SCOPE | --scope=SCOPE] [-e IGNORE-SCOPE | --ignore-scope=IGNORE-SCOPE] [--no-pager] [--show-all] [--html] NAME1 NAME2</p>
137
137
  <p><code>machinery</code> help compare</p>
138
138
  <h2 id="description">DESCRIPTION</h2>
139
139
  <p>The <code>compare</code> command compares stored system descriptions. The scope option can
@@ -157,7 +157,7 @@ be used to limit the output to the given scopes.</p>
157
157
  See the <a href="#Scopes">Scope section</a> for more information.</p>
158
158
  </li>
159
159
  <li>
160
- <p><code>-e SCOPE</code>, <code>--exclude-scope=EXCLUDE-SCOPE</code> (optional):
160
+ <p><code>-e SCOPE</code>, <code>--ignore-scope=IGNORE-SCOPE</code> (optional):
161
161
  Skip output of the specified scope.
162
162
  See the <a href="#Scopes">Scope section</a> for more information.</p>
163
163
  </li>
@@ -165,7 +165,7 @@ trigger errors.</p>
165
165
  See the <a href="#Scopes">Scope section</a> for more information.</p>
166
166
  </li>
167
167
  <li>
168
- <p><code>-e SCOPE</code>, <code>--exclude-scope=EXCLUDE-SCOPE</code> (optional):
168
+ <p><code>-e SCOPE</code>, <code>--ignore-scope=IGNORE-SCOPE</code> (optional):
169
169
  Inspect image for all scopes except the specified scope.
170
170
  See the <a href="#Scopes">Scope section</a> for more information.</p>
171
171
  </li>
@@ -143,6 +143,8 @@ description from the gathered data.</p>
143
143
  <p><strong>Note</strong>:
144
144
  Machinery will always inspect all specified scopes, and skip scopes which
145
145
  trigger errors.</p>
146
+ <p><strong>Note</strong>:
147
+ Tasks on Debian-like systems are treated as patterns.</p>
146
148
  <h2 id="arguments">ARGUMENTS</h2>
147
149
  <ul>
148
150
  <li><code>HOSTNAME</code> (required):
@@ -162,7 +164,7 @@ trigger errors.</p>
162
164
  See the <a href="../machinery_main_scopes.1/index.html">Scope section</a> for more information.</p>
163
165
  </li>
164
166
  <li>
165
- <p><code>-e SCOPE</code>, <code>--exclude-scope=EXCLUDE-SCOPE</code> (optional):
167
+ <p><code>-e SCOPE</code>, <code>--ignore-scope=IGNORE-SCOPE</code> (optional):
166
168
  Inspect system for all scopes except the specified scope.
167
169
  See the <a href="../machinery_main_scopes.1/index.html">Scope section</a> for more information.</p>
168
170
  </li>
@@ -133,7 +133,7 @@
133
133
  <div class="content">
134
134
  <h1 id="show-show-system-description">show — Show System Description</h1>
135
135
  <h2 id="synopsis">SYNOPSIS</h2>
136
- <p><code>machinery show</code> [-s SCOPE | --scope=SCOPE] [-e EXCLUDE-SCOPE | --exclude-scope=EXCLUDE-SCOPE] [--no-pager] [--show-diffs] [--html] NAME</p>
136
+ <p><code>machinery show</code> [-s SCOPE | --scope=SCOPE] [-e IGNORE-SCOPE | --ignore-scope=IGNORE-SCOPE] [--no-pager] [--show-diffs] [--html] NAME</p>
137
137
  <p><code>machinery</code> help show</p>
138
138
  <h2 id="description">DESCRIPTION</h2>
139
139
  <p>The <code>show</code> command displays a stored system description.
@@ -155,7 +155,7 @@ in local time are shown in the title of each scope section.</p>
155
155
  In case of an error, no content is displayed.</p>
156
156
  </li>
157
157
  <li>
158
- <p><code>-e EXCLUDE-SCOPE</code>, <code>--exclude-scope=EXCLUDE-SCOPE</code> (optional):
158
+ <p><code>-e IGNORE-SCOPE</code>, <code>--ignore-scope=IGNORE-SCOPE</code> (optional):
159
159
  Skip output of the specified scope.
160
160
  See the <a href="#Scopes">Scope section</a> for more information.</p>
161
161
  </li>
@@ -226,7 +226,7 @@ name which can be used by all subcommands.</p>
226
226
  <h2 id="scopes">Scopes</h2>
227
227
  <p>The system description is structured into "scopes". A scope covers a specific
228
228
  part of the configuration of the inspected system such as installed packages,
229
- repositories, or configuration files.</p>
229
+ repositories, or changed configuration files.</p>
230
230
  <p>For example, if you are only interested in the installed packages, limit the
231
231
  scope to <code>packages</code>. This will output only the requested information.</p>
232
232
  <p>The the <a href="../machinery_main_scopes.1">scopes documentation</a> for a list of all supported scopes.</p>
@@ -144,11 +144,13 @@ inspected system.</p>
144
144
  <ul>
145
145
  <li>patterns</li>
146
146
  </ul>
147
- <p>Contains all patterns installed on the inspected system. A pattern is a
148
- collection of software packages.
147
+ <p>Contains all patterns or tasks installed on the inspected system. A pattern is a
148
+ collection of software packages, similar to the idea of tasks on Debian/Ubuntu-
149
+ like systems.
149
150
  The meaning of software patterns depends on the package manager of the
150
151
  distribution. Therefore, the pattern scope on SUSE based systems uses the
151
- <code>zypper</code> command to obtain the information about installed pattern names.</p>
152
+ <code>zypper</code> command to obtain the information about installed pattern names, whereas
153
+ on Debian based systems the <code>tasksel</code> tool is necessary to list installed tasks.</p>
152
154
  <ul>
153
155
  <li>repositories</li>
154
156
  </ul>
@@ -204,13 +206,13 @@ or waiting for requests to do work.
204
206
  The scope determines which services are configured to be started in which
205
207
  runlevel. It uses the <code>chkconfig</code> command to obtain that information.
206
208
  The xinetd services that are also displayed by <code>chkconfig</code> are switched
207
- on/off by editing config files and are ignored in this context.</p>
209
+ on/off by editing configuration files and are ignored in this context.</p>
208
210
  <ul>
209
- <li>config_files</li>
211
+ <li>changed_config_files</li>
210
212
  </ul>
211
213
  <p>Contains all configuration files which have been changed since they were
212
214
  installed.
213
- Configuration files are all those files which are marked as such in the
215
+ Changed configuration files are all those files which are marked as such in the
214
216
  package which has installed them. A configuration file change is reported
215
217
  if its content or its attributes like Linux permission bits or ownership
216
218
  have changed.</p>
@@ -12,7 +12,7 @@
12
12
  },
13
13
  {
14
14
  "location": "/machinery_main_general.1/",
15
- "text": "Machinery \u2014 A Systems Management Toolkit for Linux\n\n\nSYNOPSIS\n\n\nmachinery\n SUBCOMMAND [options] \n\n\nmachinery\n help [SUBCOMMAND]\n\n\nDESCRIPTION\n\n\nMachinery is a systems management toolkit for Linux. It supports configuration\ndiscovery, system validation, and service migration. Machinery is based on the\nidea of an universal system description. Machinery has a set of commands which\nwork with this system description. These commands can be combined to form work\nflows. Machinery is targeted at the system administrator of the data center.\n\n\nWORK FLOW EXAMPLES\n\n\nInspect a System and Show Results\n\n\n\n\nmachinery inspect --extract-files --name=NAME HOSTNAME\n\n\nmachinery show NAME\n\n\n\n\nInspect Two Systems and Compare Them\n\n\n\n\nmachinery inspect HOSTNAME1\n\n\nmachinery inspect HOSTNAME2\n\n\nmachinery compare HOSTNAME1 HOSTNAME2\n\n\n\n\nFully Inspect a System and Export a Kiwi Description\n\n\n\n\nmachinery inspect --extract-files HOSTNAME\n\n\nmachinery export-kiwi --kiwi-dir=~/kiwi HOSTNAME\n\n\n\n\nFully Inspect a System and Export an AutoYaST Profile\n\n\n\n\nmachinery inspect --extract-files HOSTNAME\n\n\nmachinery export-autoyast --autoyast-dir=~/autoyast HOSTNAME\n\n\n\n\nFully Inspect a System and Deploy a Replicate to the Cloud\n\n\n\n\nmachinery inspect --extract-files HOSTNAME\n\n\nmachinery deploy --cloud-config=~/openrc.sh HOSTNAME\n\n\n\n\nHow to upgrade a SLES 11 SP3 system to SLES 12\n\n\n\n\nMachinery can help you to upgrade without affecting the original system.\n For more details please read the Wiki Page: \n\n https://github.com/SUSE/machinery/wiki/How-to-upgrade-a-SLES-11-SP3-system-to-SLES-12\n\n\n\n\nCONCEPTUAL OVERVIEW\n\n\nMachinery's core concept is the complete representation of a system by a\nuniversal system description.\nSystem descriptions are managed independently of the described\nsystems which allows for system state conservation and offline preparation of\nmodifications.\n\n\nMachinery's subcommands work on the system description as the connecting\nelement.\nSystem descriptions are obtained by inspecting systems, importing from other\nformats, manual creation or merging other descriptions.\nMachinery can store and modify system descriptions to allow changes to\ndescribed state of the system.\nSystem descriptions can be compared to find similarities and differences\nbetween them or analyzed to deepen the knowledge about particular aspects of\nthe system.\nSystem descriptions may be exported to other formats and can be used to\nmigrate or replicate systems.\n\n\nSubcommands can be combined in different ways to accomodate higher-level work\nflows and use cases.\nThese are some implemented and planned use cases:\n\n\nMigrate a physical system to a virtual environment:\n\n\n\n\nInspect a system to obtain a system description\n\n\nExport the system description to a Kiwi configuration\n\n\nBuild a cloud image from the configuration\n\n\nDeploy the image to the cloud\n\n\n\n\nMigrate a system while changing the configuration:\n\n\n\n\nInspect a system to obtain a system description\n\n\nModify the system description\n\n\nBuild image for deployment\n\n\n\n\nUsing Machinery as an extension from other formats:\n\n\n\n\nImport AutoYaST profile as system description\n\n\nBuild image for deployment\n\n\n\n\nMachinery provides an extensible set of tools which can be combined to create\nhigher-level work flows.\nIt is designed for environments which focus on automation, integration\nof diverse tools and accountable management.\nMachinery integrates with existing configuration management solutions to\naddress use cases currently not covered by them.\n\n\nThe machinery Command\n\n\nMachinery is implemented as a command line tool named \nmachinery\n. The\n\nmachinery\n command has several subcommands for specific tasks. All\nsubcommands work with the same system description identified by an optional\nname which can be used by all subcommands.\n\n\nScopes\n\n\nThe system description is structured into \"scopes\". A scope covers a specific\npart of the configuration of the inspected system such as installed packages,\nrepositories, or configuration files.\n\n\nFor example, if you are only interested in the installed packages, limit the\nscope to \npackages\n. This will output only the requested information.\n\n\nThe the \nscopes documentation\n for a list of all supported scopes.\n\n\nFILES AND DEVICES\n\n\n\n\n\n\n~/.machinery/machinery.config\n:\n\n\nConfiguration file.\n\n\n\n\n\n\n~/.machinery/machinery.log\n:\n\n\nCentral log file, in the format date, time, process id, and log message.\n\n\n\n\n\n\neth0\n (SLE11) and \nlan0\n (SLE12):\n\n\nFirst network device is used when DHCP in built image is enabled.\n\n\n\n\n\n\nENVIRONMENT\n\n\n\n\n\n\nMACHINERY_LOG_FILE\n:\n\n\nLocation of Machinery's log file (defaults to \n~/.machinery/machinery.log\n)\n\n\n\n\n\n\nCOPYRIGHT\n\n\nCopyright (c) 2013-2016 \nSUSE LLC",
15
+ "text": "Machinery \u2014 A Systems Management Toolkit for Linux\n\n\nSYNOPSIS\n\n\nmachinery\n SUBCOMMAND [options] \n\n\nmachinery\n help [SUBCOMMAND]\n\n\nDESCRIPTION\n\n\nMachinery is a systems management toolkit for Linux. It supports configuration\ndiscovery, system validation, and service migration. Machinery is based on the\nidea of an universal system description. Machinery has a set of commands which\nwork with this system description. These commands can be combined to form work\nflows. Machinery is targeted at the system administrator of the data center.\n\n\nWORK FLOW EXAMPLES\n\n\nInspect a System and Show Results\n\n\n\n\nmachinery inspect --extract-files --name=NAME HOSTNAME\n\n\nmachinery show NAME\n\n\n\n\nInspect Two Systems and Compare Them\n\n\n\n\nmachinery inspect HOSTNAME1\n\n\nmachinery inspect HOSTNAME2\n\n\nmachinery compare HOSTNAME1 HOSTNAME2\n\n\n\n\nFully Inspect a System and Export a Kiwi Description\n\n\n\n\nmachinery inspect --extract-files HOSTNAME\n\n\nmachinery export-kiwi --kiwi-dir=~/kiwi HOSTNAME\n\n\n\n\nFully Inspect a System and Export an AutoYaST Profile\n\n\n\n\nmachinery inspect --extract-files HOSTNAME\n\n\nmachinery export-autoyast --autoyast-dir=~/autoyast HOSTNAME\n\n\n\n\nFully Inspect a System and Deploy a Replicate to the Cloud\n\n\n\n\nmachinery inspect --extract-files HOSTNAME\n\n\nmachinery deploy --cloud-config=~/openrc.sh HOSTNAME\n\n\n\n\nHow to upgrade a SLES 11 SP3 system to SLES 12\n\n\n\n\nMachinery can help you to upgrade without affecting the original system.\n For more details please read the Wiki Page: \n\n https://github.com/SUSE/machinery/wiki/How-to-upgrade-a-SLES-11-SP3-system-to-SLES-12\n\n\n\n\nCONCEPTUAL OVERVIEW\n\n\nMachinery's core concept is the complete representation of a system by a\nuniversal system description.\nSystem descriptions are managed independently of the described\nsystems which allows for system state conservation and offline preparation of\nmodifications.\n\n\nMachinery's subcommands work on the system description as the connecting\nelement.\nSystem descriptions are obtained by inspecting systems, importing from other\nformats, manual creation or merging other descriptions.\nMachinery can store and modify system descriptions to allow changes to\ndescribed state of the system.\nSystem descriptions can be compared to find similarities and differences\nbetween them or analyzed to deepen the knowledge about particular aspects of\nthe system.\nSystem descriptions may be exported to other formats and can be used to\nmigrate or replicate systems.\n\n\nSubcommands can be combined in different ways to accomodate higher-level work\nflows and use cases.\nThese are some implemented and planned use cases:\n\n\nMigrate a physical system to a virtual environment:\n\n\n\n\nInspect a system to obtain a system description\n\n\nExport the system description to a Kiwi configuration\n\n\nBuild a cloud image from the configuration\n\n\nDeploy the image to the cloud\n\n\n\n\nMigrate a system while changing the configuration:\n\n\n\n\nInspect a system to obtain a system description\n\n\nModify the system description\n\n\nBuild image for deployment\n\n\n\n\nUsing Machinery as an extension from other formats:\n\n\n\n\nImport AutoYaST profile as system description\n\n\nBuild image for deployment\n\n\n\n\nMachinery provides an extensible set of tools which can be combined to create\nhigher-level work flows.\nIt is designed for environments which focus on automation, integration\nof diverse tools and accountable management.\nMachinery integrates with existing configuration management solutions to\naddress use cases currently not covered by them.\n\n\nThe machinery Command\n\n\nMachinery is implemented as a command line tool named \nmachinery\n. The\n\nmachinery\n command has several subcommands for specific tasks. All\nsubcommands work with the same system description identified by an optional\nname which can be used by all subcommands.\n\n\nScopes\n\n\nThe system description is structured into \"scopes\". A scope covers a specific\npart of the configuration of the inspected system such as installed packages,\nrepositories, or changed configuration files.\n\n\nFor example, if you are only interested in the installed packages, limit the\nscope to \npackages\n. This will output only the requested information.\n\n\nThe the \nscopes documentation\n for a list of all supported scopes.\n\n\nFILES AND DEVICES\n\n\n\n\n\n\n~/.machinery/machinery.config\n:\n\n\nConfiguration file.\n\n\n\n\n\n\n~/.machinery/machinery.log\n:\n\n\nCentral log file, in the format date, time, process id, and log message.\n\n\n\n\n\n\neth0\n (SLE11) and \nlan0\n (SLE12):\n\n\nFirst network device is used when DHCP in built image is enabled.\n\n\n\n\n\n\nENVIRONMENT\n\n\n\n\n\n\nMACHINERY_LOG_FILE\n:\n\n\nLocation of Machinery's log file (defaults to \n~/.machinery/machinery.log\n)\n\n\n\n\n\n\nCOPYRIGHT\n\n\nCopyright (c) 2013-2016 \nSUSE LLC",
16
16
  "title": "General"
17
17
  },
18
18
  {
@@ -77,7 +77,7 @@
77
77
  },
78
78
  {
79
79
  "location": "/machinery_main_general.1/#scopes",
80
- "text": "The system description is structured into \"scopes\". A scope covers a specific\npart of the configuration of the inspected system such as installed packages,\nrepositories, or configuration files. For example, if you are only interested in the installed packages, limit the\nscope to packages . This will output only the requested information. The the scopes documentation for a list of all supported scopes.",
80
+ "text": "The system description is structured into \"scopes\". A scope covers a specific\npart of the configuration of the inspected system such as installed packages,\nrepositories, or changed configuration files. For example, if you are only interested in the installed packages, limit the\nscope to packages . This will output only the requested information. The the scopes documentation for a list of all supported scopes.",
81
81
  "title": "Scopes"
82
82
  },
83
83
  {
@@ -97,7 +97,7 @@
97
97
  },
98
98
  {
99
99
  "location": "/machinery_main_scopes.1/",
100
- "text": "os\n\n\n\n\nContains information about the operating system, name, version, and\narchitecture of the inspected system.\n\n\n\n\npackages\n\n\n\n\nContains information on all installed RPM packages installed on the\ninspected system.\n\n\n\n\npatterns\n\n\n\n\nContains all patterns installed on the inspected system. A pattern is a\ncollection of software packages.\nThe meaning of software patterns depends on the package manager of the\ndistribution. Therefore, the pattern scope on SUSE based systems uses the\n\nzypper\n command to obtain the information about installed pattern names.\n\n\n\n\nrepositories\n\n\n\n\nContains all information about software repositories configured on the\ninspected system. The information about repositories depends on the package\nmanager of the distribution. Thus on SUSE-based systems the \nzypper\n command\nis used. Machinery collects the following information from each configured repository:\n\n\n\n\n\n\nThe alias name of the repository.\n\n\n\n\n\n\nThe repository type, rpm-md and YaST types that are used on SUSE systems.\n\n\n\n\n\n\nThe path to the repository. This could be a local path, a remote location,\n a device, or a file.\n\n\n\n\n\n\nA boolean flag that indicates if this repository is in use or not.\n\n\n\n\n\n\nA boolean flag that indicates if this repository should update the locally\n stored metadata files with metadata files from the origin automatically or\n not.\n\n\n\n\n\n\nA boolean flag that indicates if packages which would be installed from\n this repository should be checked by their gpg key or not.\n\n\n\n\n\n\nA numeric value for a priority. The priority of a repository is compared\n to the priorities of all other activated repositories. Values can\n range from 1 (highest) to 99 (lowest, default).\n\n\n\n\n\n\nusers\n\n\n\n\n\n\nContains information about the system users including user and group ids,\nlogin information, such as password hashes and - if available - additional\npassword properties.\n\n\n\n\ngroups\n\n\n\n\nContains information about the system groups such as group attributes and the\nlist of group members.\n\n\n\n\nservices\n\n\n\n\nServices are applications running in the background doing continuous work\nor waiting for requests to do work.\nThe scope determines which services are configured to be started in which\nrunlevel. It uses the \nchkconfig\n command to obtain that information.\nThe xinetd services that are also displayed by \nchkconfig\n are switched\non/off by editing config files and are ignored in this context.\n\n\n\n\nconfig_files\n\n\n\n\nContains all configuration files which have been changed since they were\ninstalled.\nConfiguration files are all those files which are marked as such in the\npackage which has installed them. A configuration file change is reported\nif its content or its attributes like Linux permission bits or ownership\nhave changed.\n\n\n\n\nchanged_managed_files\n\n\n\n\nContains the names and contents of all non-configuration files which have\nbeen changed compared to the files in the package. A file change is reported\nif its content or its attributes like Linux permission bits or ownership\nhave changed.\n\n\n\n\nunmanaged_files\n\n\n\n\nContains the names and contents of all files which are not part of any RPM\npackage. The list of unmanaged files contains only plain files and\ndirectories. Special files like device nodes, named pipes and Unix domain\nsockets are ignored. The directories \n/tmp\n, \n/var/tmp\n, \n/.snapshots/\n,\n\n/var/run\n and special mounts like procfs and sysfs are ignored, too.\nIf a directory is in this list, no file or directory below it belongs to a\nRPM package.\n\n\nMeta data information of unmanaged files is only available if the files were\nextracted during inspection.\n\n\nUsing the \n--extract-unmanaged-files\n option, the files are transferred from\nthe system and stored in the system description. Depending on the content of\nthe inspected system, the amount of data stored may be huge.",
100
+ "text": "os\n\n\n\n\nContains information about the operating system, name, version, and\narchitecture of the inspected system.\n\n\n\n\npackages\n\n\n\n\nContains information on all installed RPM packages installed on the\ninspected system.\n\n\n\n\npatterns\n\n\n\n\nContains all patterns or tasks installed on the inspected system. A pattern is a\ncollection of software packages, similar to the idea of tasks on Debian/Ubuntu-\nlike systems.\nThe meaning of software patterns depends on the package manager of the\ndistribution. Therefore, the pattern scope on SUSE based systems uses the\n\nzypper\n command to obtain the information about installed pattern names, whereas\non Debian based systems the \ntasksel\n tool is necessary to list installed tasks.\n\n\n\n\nrepositories\n\n\n\n\nContains all information about software repositories configured on the\ninspected system. The information about repositories depends on the package\nmanager of the distribution. Thus on SUSE-based systems the \nzypper\n command\nis used. Machinery collects the following information from each configured repository:\n\n\n\n\n\n\nThe alias name of the repository.\n\n\n\n\n\n\nThe repository type, rpm-md and YaST types that are used on SUSE systems.\n\n\n\n\n\n\nThe path to the repository. This could be a local path, a remote location,\n a device, or a file.\n\n\n\n\n\n\nA boolean flag that indicates if this repository is in use or not.\n\n\n\n\n\n\nA boolean flag that indicates if this repository should update the locally\n stored metadata files with metadata files from the origin automatically or\n not.\n\n\n\n\n\n\nA boolean flag that indicates if packages which would be installed from\n this repository should be checked by their gpg key or not.\n\n\n\n\n\n\nA numeric value for a priority. The priority of a repository is compared\n to the priorities of all other activated repositories. Values can\n range from 1 (highest) to 99 (lowest, default).\n\n\n\n\n\n\nusers\n\n\n\n\n\n\nContains information about the system users including user and group ids,\nlogin information, such as password hashes and - if available - additional\npassword properties.\n\n\n\n\ngroups\n\n\n\n\nContains information about the system groups such as group attributes and the\nlist of group members.\n\n\n\n\nservices\n\n\n\n\nServices are applications running in the background doing continuous work\nor waiting for requests to do work.\nThe scope determines which services are configured to be started in which\nrunlevel. It uses the \nchkconfig\n command to obtain that information.\nThe xinetd services that are also displayed by \nchkconfig\n are switched\non/off by editing configuration files and are ignored in this context.\n\n\n\n\nchanged_config_files\n\n\n\n\nContains all configuration files which have been changed since they were\ninstalled.\nChanged configuration files are all those files which are marked as such in the\npackage which has installed them. A configuration file change is reported\nif its content or its attributes like Linux permission bits or ownership\nhave changed.\n\n\n\n\nchanged_managed_files\n\n\n\n\nContains the names and contents of all non-configuration files which have\nbeen changed compared to the files in the package. A file change is reported\nif its content or its attributes like Linux permission bits or ownership\nhave changed.\n\n\n\n\nunmanaged_files\n\n\n\n\nContains the names and contents of all files which are not part of any RPM\npackage. The list of unmanaged files contains only plain files and\ndirectories. Special files like device nodes, named pipes and Unix domain\nsockets are ignored. The directories \n/tmp\n, \n/var/tmp\n, \n/.snapshots/\n,\n\n/var/run\n and special mounts like procfs and sysfs are ignored, too.\nIf a directory is in this list, no file or directory below it belongs to a\nRPM package.\n\n\nMeta data information of unmanaged files is only available if the files were\nextracted during inspection.\n\n\nUsing the \n--extract-unmanaged-files\n option, the files are transferred from\nthe system and stored in the system description. Depending on the content of\nthe inspected system, the amount of data stored may be huge.",
101
101
  "title": "Scopes"
102
102
  },
103
103
  {
@@ -197,7 +197,7 @@
197
197
  },
198
198
  {
199
199
  "location": "/machinery-analyze.1/",
200
- "text": "analyze \u2014 Analyze System Description\n\n\nSYNOPSIS\n\n\nmachinery analyze\n NAME -o | --operation=OPERATION\n\n\nmachinery\n help analyze\n\n\nDESCRIPTION\n\n\nThe \nanalyze\n subcommand analyzes an existing system description and enriches\nit with additional information. Supported operations are:\n\n\n\n\nconfig-file-diffs\n:\n Generates the diffs between the extracted changed config files from the\n system and the original versions from the RPM packages.\n The diffs can be shown using \nmachinery show --show-diffs\n\n\n\n\nARGUMENTS\n\n\n\n\nNAME\n (required):\n Name of the system description.\n\n\n\n\nOPTIONS\n\n\n\n\n-o OPERATION\n, \n--operation=OPERATION\n (required):\n The analyze operation to perform.\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nAnalyze the config file diffs for the \nmyhost\n system description:\n\n\n$ \nmachinery\n analyze myhost --operation=config-file-diffs",
200
+ "text": "analyze \u2014 Analyze System Description\n\n\nSYNOPSIS\n\n\nmachinery analyze\n NAME -o | --operation=OPERATION\n\n\nmachinery\n help analyze\n\n\nDESCRIPTION\n\n\nThe \nanalyze\n subcommand analyzes an existing system description and enriches\nit with additional information. Supported operations are:\n\n\n\n\nchanged-config-files-diffs\n:\n Generates the diffs between the extracted changed configuration files from the\n system and the original versions from the RPM packages.\n The diffs can be shown using \nmachinery show --show-diffs\n\n\n\n\nARGUMENTS\n\n\n\n\nNAME\n (required):\n Name of the system description.\n\n\n\n\nOPTIONS\n\n\n\n\n-o OPERATION\n, \n--operation=OPERATION\n (required):\n The analyze operation to perform.\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nAnalyze the config file diffs for the \nmyhost\n system description:\n\n\n$ \nmachinery\n analyze myhost --operation=changed-config-files-diffs",
201
201
  "title": "Analyze"
202
202
  },
203
203
  {
@@ -212,7 +212,7 @@
212
212
  },
213
213
  {
214
214
  "location": "/machinery-analyze.1/#description",
215
- "text": "The analyze subcommand analyzes an existing system description and enriches\nit with additional information. Supported operations are: config-file-diffs :\n Generates the diffs between the extracted changed config files from the\n system and the original versions from the RPM packages.\n The diffs can be shown using machinery show --show-diffs",
215
+ "text": "The analyze subcommand analyzes an existing system description and enriches\nit with additional information. Supported operations are: changed-config-files-diffs :\n Generates the diffs between the extracted changed configuration files from the\n system and the original versions from the RPM packages.\n The diffs can be shown using machinery show --show-diffs",
216
216
  "title": "DESCRIPTION"
217
217
  },
218
218
  {
@@ -227,7 +227,7 @@
227
227
  },
228
228
  {
229
229
  "location": "/machinery-analyze.1/#examples",
230
- "text": "Analyze the config file diffs for the myhost system description: $ machinery analyze myhost --operation=config-file-diffs",
230
+ "text": "Analyze the config file diffs for the myhost system description: $ machinery analyze myhost --operation=changed-config-files-diffs",
231
231
  "title": "EXAMPLES"
232
232
  },
233
233
  {
@@ -272,7 +272,7 @@
272
272
  },
273
273
  {
274
274
  "location": "/machinery-compare.1/",
275
- "text": "compare \u2014 Compare System Descriptions\n\n\nSYNOPSIS\n\n\nmachinery compare\n [-s SCOPE | --scope=SCOPE] [-e EXCLUDE-SCOPE | --exclude-scope=EXCLUDE-SCOPE] [--no-pager] [--show-all] [--html] NAME1 NAME2\n\n\nmachinery\n help compare\n\n\nDESCRIPTION\n\n\nThe \ncompare\n command compares stored system descriptions. The scope option can\nbe used to limit the output to the given scopes.\n\n\nARGUMENTS\n\n\n\n\n\n\nNAME1\n (required):\n First system description to compare.\n\n\n\n\n\n\nNAME2\n (required):\n Second system description to compare.\n\n\n\n\n\n\nOPTIONS\n\n\n\n\n\n\n-s SCOPE\n, \n--scope=SCOPE\n (optional):\n Limit output to the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-e SCOPE\n, \n--exclude-scope=EXCLUDE-SCOPE\n (optional):\n Skip output of the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n--no-pager\n (optional):\n Do not pipe output into a pager.\n\n\n\n\n\n\n--show-all\n (optional):\n Show also common properties of the descriptions (not only the differences).\n\n\n\n\n\n\n--html\n (optional):\n Shows the comparison of two system descriptions in the web browser.\n\n\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nCompare system descriptions saved as \nearth\n and \nmoon\n:\n\n\n$ \nmachinery\n compare earth moon\n\n\n\n\n\n\nCompare system descriptions, but limit the scope to repositories only:\n\n\n$ \nmachinery\n compare earth moon -s repositories\n\n\n\n\n\n\nCompare lists of changed managed files and include the common ones in the\n list:\n\n\n$ \nmachinery\n compare earth moon --scope=changed-managed-files --show-all\n\n\n\n\n\n\nCompares system descriptions and shows the result in HTML format in your web browser:\n\n\n$ \nmachinery\n compare --html earth moon",
275
+ "text": "compare \u2014 Compare System Descriptions\n\n\nSYNOPSIS\n\n\nmachinery compare\n [-s SCOPE | --scope=SCOPE] [-e IGNORE-SCOPE | --ignore-scope=IGNORE-SCOPE] [--no-pager] [--show-all] [--html] NAME1 NAME2\n\n\nmachinery\n help compare\n\n\nDESCRIPTION\n\n\nThe \ncompare\n command compares stored system descriptions. The scope option can\nbe used to limit the output to the given scopes.\n\n\nARGUMENTS\n\n\n\n\n\n\nNAME1\n (required):\n First system description to compare.\n\n\n\n\n\n\nNAME2\n (required):\n Second system description to compare.\n\n\n\n\n\n\nOPTIONS\n\n\n\n\n\n\n-s SCOPE\n, \n--scope=SCOPE\n (optional):\n Limit output to the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-e SCOPE\n, \n--ignore-scope=IGNORE-SCOPE\n (optional):\n Skip output of the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n--no-pager\n (optional):\n Do not pipe output into a pager.\n\n\n\n\n\n\n--show-all\n (optional):\n Show also common properties of the descriptions (not only the differences).\n\n\n\n\n\n\n--html\n (optional):\n Shows the comparison of two system descriptions in the web browser.\n\n\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nCompare system descriptions saved as \nearth\n and \nmoon\n:\n\n\n$ \nmachinery\n compare earth moon\n\n\n\n\n\n\nCompare system descriptions, but limit the scope to repositories only:\n\n\n$ \nmachinery\n compare earth moon -s repositories\n\n\n\n\n\n\nCompare lists of changed managed files and include the common ones in the\n list:\n\n\n$ \nmachinery\n compare earth moon --scope=changed-managed-files --show-all\n\n\n\n\n\n\nCompares system descriptions and shows the result in HTML format in your web browser:\n\n\n$ \nmachinery\n compare --html earth moon",
276
276
  "title": "Compare"
277
277
  },
278
278
  {
@@ -282,7 +282,7 @@
282
282
  },
283
283
  {
284
284
  "location": "/machinery-compare.1/#synopsis",
285
- "text": "machinery compare [-s SCOPE | --scope=SCOPE] [-e EXCLUDE-SCOPE | --exclude-scope=EXCLUDE-SCOPE] [--no-pager] [--show-all] [--html] NAME1 NAME2 machinery help compare",
285
+ "text": "machinery compare [-s SCOPE | --scope=SCOPE] [-e IGNORE-SCOPE | --ignore-scope=IGNORE-SCOPE] [--no-pager] [--show-all] [--html] NAME1 NAME2 machinery help compare",
286
286
  "title": "SYNOPSIS"
287
287
  },
288
288
  {
@@ -297,7 +297,7 @@
297
297
  },
298
298
  {
299
299
  "location": "/machinery-compare.1/#options",
300
- "text": "-s SCOPE , --scope=SCOPE (optional):\n Limit output to the specified scope.\n See the Scope section for more information. -e SCOPE , --exclude-scope=EXCLUDE-SCOPE (optional):\n Skip output of the specified scope.\n See the Scope section for more information. --no-pager (optional):\n Do not pipe output into a pager. --show-all (optional):\n Show also common properties of the descriptions (not only the differences). --html (optional):\n Shows the comparison of two system descriptions in the web browser.",
300
+ "text": "-s SCOPE , --scope=SCOPE (optional):\n Limit output to the specified scope.\n See the Scope section for more information. -e SCOPE , --ignore-scope=IGNORE-SCOPE (optional):\n Skip output of the specified scope.\n See the Scope section for more information. --no-pager (optional):\n Do not pipe output into a pager. --show-all (optional):\n Show also common properties of the descriptions (not only the differences). --html (optional):\n Shows the comparison of two system descriptions in the web browser.",
301
301
  "title": "OPTIONS"
302
302
  },
303
303
  {
@@ -492,7 +492,7 @@
492
492
  },
493
493
  {
494
494
  "location": "/machinery-inspect.1/",
495
- "text": "inspect \u2014 Inspect Running System\n\n\nSYNOPSIS\n\n\nmachinery inspect\n [OPTIONS] HOSTNAME\n\n\nmachinery\n help inspect\n\n\nDESCRIPTION\n\n\nThe \ninspect\n command inspects a running system and generates a system\ndescription from the gathered data.\n\n\nThe system data is structured into scopes, controlled by the\n\n--scope\n option.\n\n\nNote\n:\nMachinery will always inspect all specified scopes, and skip scopes which\ntrigger errors.\n\n\nARGUMENTS\n\n\n\n\nHOSTNAME\n (required):\n The host name of the system to be inspected. The host name will also be\n used as the name of the stored system description unless another name is\n provided with the \n--name\n option.\n\n\n\n\nOPTIONS\n\n\n\n\n\n\n-n NAME\n, \n--name=NAME\n (optional):\n Store the system description under the specified name.\n\n\n\n\n\n\n-s SCOPE\n, \n--scope=SCOPE\n (optional):\n Inspect system for specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-e SCOPE\n, \n--exclude-scope=EXCLUDE-SCOPE\n (optional):\n Inspect system for all scopes except the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-r USER\n, \n--remote-user=USER\n (optional):\n Defines the user which is used to access the inspected system via SSH.\n This user needs to be allowed to run certain commands using sudo (see\n PREREQUISITES for more information).\n To change the default-user use \nmachinery config remote-user=USER\n\n\n\n\n\n\n-p SSH-PORT\n, \n--ssh-port SSH-PORT\n (optional):\n Specifies the SSH port of the remote SSH server.\n\n\n\n\n\n\n-i SSH-IDENTITY-FILE\n, \n--ssh-identity-file SSH-IDENTITY-FILE\n (optional):\n Specifies the SSH private key what should be used to authenticate with the\n remote SSH server. Keys with a passphrase are not allowed here. Use the ssh-agent\n instead.\n\n\n\n\n\n\n-x\n, \n--extract-files\n (optional):\n Extract changed configuration and unmanaged files from the inspected system.\n Shortcut for the combination of \n--extract-changed-config-files\n,\n \n--extract-unmanaged-files\n, and \n--extract-changed-managed-files\n\n\n\n\n\n\n--extract-changed-config-files\n (optional):\n Extract changed configuration files from the inspected system.\n\n\n\n\n\n\n--extract-unmanaged-files\n (optional):\n Extract unmanaged files from the inspected system.\n\n\n\n\n\n\n--extract-changed-managed-files\n (optional):\n Extract changed managed files from inspected system.\n\n\n\n\n\n\n--skip-files\n (optional):\n Do not consider given files or directories during inspection. Either provide\n one file or directory name or a list of names separated by commas. You can\n also point to a file which contains a list of files to filter (one per line)\n by adding an '@' before the path, e.g.\n\n\n$ \nmachinery\n inspect --skip-files=@/path/to/filter_file myhost\n\n\nIf a filename contains a comma it needs to be escaped, e.g.\n\n\n$ \nmachinery\n inspect --skip-files=/file\\,with_comma myhost\n\n\nNote\n: File or directory names are not expanded, e.g. '../path' is taken\n literally and not expanded.\n\n\n\n\n\n\n--verbose\n (optional):\n Display the filters which are used during inspection.\n\n\n\n\n\n\nPREREQUISITES\n\n\n\n\n\n\nInspecting a local system requires running \nmachinery\n as root.\n\n\n\n\n\n\nInspecting a remote system requires passwordless SSH login as root on the\n inspected system.\n Use \nssh-agent\n or asymmetric keys (you can transfer the current SSH key\n via \nssh-copy-id\n to the inspected host, e.g.: \nssh-copy-id root@HOSTNAME\n)\n\n\n\n\n\n\nThe system to be inspected needs to have the following commands:\n\n\n\n\nrpm\n or \ndpkg\n\n\nzypper\n, \nyum\n, or \napt-cache\n\n\nrsync\n\n\nchkconfig\n, \ninitctl\n, or \nsystemctl\n\n\ncat\n\n\nsed\n\n\nfind\n\n\ntar\n\n\n\n\n\n\n\n\nWhen inspecting as non-root the user needs passwordless sudo rights.\n The following entry in the sudoers file would allow the user \nmachinery\n\n to run sudo without password input:\n\n\nmachinery ALL=(ALL) NOPASSWD: ALL\n\n\n\n\n\n\nTo add a remote \nmachinery\n user run as root:\n\n\n# \nuseradd\n -m machinery -c \"remote user for machinery\"\n\n\nTo configure a password for the new user run:\n\n\n# \npasswd\n machinery\n\n\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nInspect remote system \nmyhost\n and save system description under name\n 'MySystem':\n\n\n$ \nmachinery\n inspect --name=MySystem myhost\n\n\n\n\n\n\nInspect the installed packages of your local system and save system description\n under the name 'localhost' (you need to become root):\n\n\n# \nmachinery\n inspect --scope=\"packages\" localhost\n\n\n\n\n\n\nExtracts changed managed files and saves them in the same way as changed\n configuration files are saved:\n\n\n$ \nmachinery\n inspect --scope=changed-managed-files --extract-files myhost\n\n\n\n\n\n\nTo inspect the remote system \nmyhost\n with the user \nmachinery\n:\n\n\n$ \nmachinery\n inspect --remote-user machinery myhost",
495
+ "text": "inspect \u2014 Inspect Running System\n\n\nSYNOPSIS\n\n\nmachinery inspect\n [OPTIONS] HOSTNAME\n\n\nmachinery\n help inspect\n\n\nDESCRIPTION\n\n\nThe \ninspect\n command inspects a running system and generates a system\ndescription from the gathered data.\n\n\nThe system data is structured into scopes, controlled by the\n\n--scope\n option.\n\n\nNote\n:\nMachinery will always inspect all specified scopes, and skip scopes which\ntrigger errors.\n\n\nNote\n:\nTasks on Debian-like systems are treated as patterns.\n\n\nARGUMENTS\n\n\n\n\nHOSTNAME\n (required):\n The host name of the system to be inspected. The host name will also be\n used as the name of the stored system description unless another name is\n provided with the \n--name\n option.\n\n\n\n\nOPTIONS\n\n\n\n\n\n\n-n NAME\n, \n--name=NAME\n (optional):\n Store the system description under the specified name.\n\n\n\n\n\n\n-s SCOPE\n, \n--scope=SCOPE\n (optional):\n Inspect system for specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-e SCOPE\n, \n--ignore-scope=IGNORE-SCOPE\n (optional):\n Inspect system for all scopes except the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-r USER\n, \n--remote-user=USER\n (optional):\n Defines the user which is used to access the inspected system via SSH.\n This user needs to be allowed to run certain commands using sudo (see\n PREREQUISITES for more information).\n To change the default-user use \nmachinery config remote-user=USER\n\n\n\n\n\n\n-p SSH-PORT\n, \n--ssh-port SSH-PORT\n (optional):\n Specifies the SSH port of the remote SSH server.\n\n\n\n\n\n\n-i SSH-IDENTITY-FILE\n, \n--ssh-identity-file SSH-IDENTITY-FILE\n (optional):\n Specifies the SSH private key what should be used to authenticate with the\n remote SSH server. Keys with a passphrase are not allowed here. Use the ssh-agent\n instead.\n\n\n\n\n\n\n-x\n, \n--extract-files\n (optional):\n Extract changed configuration and unmanaged files from the inspected system.\n Shortcut for the combination of \n--extract-changed-config-files\n,\n \n--extract-unmanaged-files\n, and \n--extract-changed-managed-files\n\n\n\n\n\n\n--extract-changed-config-files\n (optional):\n Extract changed configuration files from the inspected system.\n\n\n\n\n\n\n--extract-unmanaged-files\n (optional):\n Extract unmanaged files from the inspected system.\n\n\n\n\n\n\n--extract-changed-managed-files\n (optional):\n Extract changed managed files from inspected system.\n\n\n\n\n\n\n--skip-files\n (optional):\n Do not consider given files or directories during inspection. Either provide\n one file or directory name or a list of names separated by commas. You can\n also point to a file which contains a list of files to filter (one per line)\n by adding an '@' before the path, e.g.\n\n\n$ \nmachinery\n inspect --skip-files=@/path/to/filter_file myhost\n\n\nIf a filename contains a comma it needs to be escaped, e.g.\n\n\n$ \nmachinery\n inspect --skip-files=/file\\,with_comma myhost\n\n\nNote\n: File or directory names are not expanded, e.g. '../path' is taken\n literally and not expanded.\n\n\n\n\n\n\n--verbose\n (optional):\n Display the filters which are used during inspection.\n\n\n\n\n\n\nPREREQUISITES\n\n\n\n\n\n\nInspecting a local system requires running \nmachinery\n as root.\n\n\n\n\n\n\nInspecting a remote system requires passwordless SSH login as root on the\n inspected system.\n Use \nssh-agent\n or asymmetric keys (you can transfer the current SSH key\n via \nssh-copy-id\n to the inspected host, e.g.: \nssh-copy-id root@HOSTNAME\n)\n\n\n\n\n\n\nThe system to be inspected needs to have the following commands:\n\n\n\n\nrpm\n or \ndpkg\n\n\nzypper\n, \nyum\n, or \napt-cache\n\n\nrsync\n\n\nchkconfig\n, \ninitctl\n, or \nsystemctl\n\n\ncat\n\n\nsed\n\n\nfind\n\n\ntar\n\n\n\n\n\n\n\n\nWhen inspecting as non-root the user needs passwordless sudo rights.\n The following entry in the sudoers file would allow the user \nmachinery\n\n to run sudo without password input:\n\n\nmachinery ALL=(ALL) NOPASSWD: ALL\n\n\n\n\n\n\nTo add a remote \nmachinery\n user run as root:\n\n\n# \nuseradd\n -m machinery -c \"remote user for machinery\"\n\n\nTo configure a password for the new user run:\n\n\n# \npasswd\n machinery\n\n\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nInspect remote system \nmyhost\n and save system description under name\n 'MySystem':\n\n\n$ \nmachinery\n inspect --name=MySystem myhost\n\n\n\n\n\n\nInspect the installed packages of your local system and save system description\n under the name 'localhost' (you need to become root):\n\n\n# \nmachinery\n inspect --scope=\"packages\" localhost\n\n\n\n\n\n\nExtracts changed managed files and saves them in the same way as changed\n configuration files are saved:\n\n\n$ \nmachinery\n inspect --scope=changed-managed-files --extract-files myhost\n\n\n\n\n\n\nTo inspect the remote system \nmyhost\n with the user \nmachinery\n:\n\n\n$ \nmachinery\n inspect --remote-user machinery myhost",
496
496
  "title": "Inspect"
497
497
  },
498
498
  {
@@ -507,7 +507,7 @@
507
507
  },
508
508
  {
509
509
  "location": "/machinery-inspect.1/#description",
510
- "text": "The inspect command inspects a running system and generates a system\ndescription from the gathered data. The system data is structured into scopes, controlled by the --scope option. Note :\nMachinery will always inspect all specified scopes, and skip scopes which\ntrigger errors.",
510
+ "text": "The inspect command inspects a running system and generates a system\ndescription from the gathered data. The system data is structured into scopes, controlled by the --scope option. Note :\nMachinery will always inspect all specified scopes, and skip scopes which\ntrigger errors. Note :\nTasks on Debian-like systems are treated as patterns.",
511
511
  "title": "DESCRIPTION"
512
512
  },
513
513
  {
@@ -517,7 +517,7 @@
517
517
  },
518
518
  {
519
519
  "location": "/machinery-inspect.1/#options",
520
- "text": "-n NAME , --name=NAME (optional):\n Store the system description under the specified name. -s SCOPE , --scope=SCOPE (optional):\n Inspect system for specified scope.\n See the Scope section for more information. -e SCOPE , --exclude-scope=EXCLUDE-SCOPE (optional):\n Inspect system for all scopes except the specified scope.\n See the Scope section for more information. -r USER , --remote-user=USER (optional):\n Defines the user which is used to access the inspected system via SSH.\n This user needs to be allowed to run certain commands using sudo (see\n PREREQUISITES for more information).\n To change the default-user use machinery config remote-user=USER -p SSH-PORT , --ssh-port SSH-PORT (optional):\n Specifies the SSH port of the remote SSH server. -i SSH-IDENTITY-FILE , --ssh-identity-file SSH-IDENTITY-FILE (optional):\n Specifies the SSH private key what should be used to authenticate with the\n remote SSH server. Keys with a passphrase are not allowed here. Use the ssh-agent\n instead. -x , --extract-files (optional):\n Extract changed configuration and unmanaged files from the inspected system.\n Shortcut for the combination of --extract-changed-config-files ,\n --extract-unmanaged-files , and --extract-changed-managed-files --extract-changed-config-files (optional):\n Extract changed configuration files from the inspected system. --extract-unmanaged-files (optional):\n Extract unmanaged files from the inspected system. --extract-changed-managed-files (optional):\n Extract changed managed files from inspected system. --skip-files (optional):\n Do not consider given files or directories during inspection. Either provide\n one file or directory name or a list of names separated by commas. You can\n also point to a file which contains a list of files to filter (one per line)\n by adding an '@' before the path, e.g. $ machinery inspect --skip-files=@/path/to/filter_file myhost If a filename contains a comma it needs to be escaped, e.g. $ machinery inspect --skip-files=/file\\,with_comma myhost Note : File or directory names are not expanded, e.g. '../path' is taken\n literally and not expanded. --verbose (optional):\n Display the filters which are used during inspection.",
520
+ "text": "-n NAME , --name=NAME (optional):\n Store the system description under the specified name. -s SCOPE , --scope=SCOPE (optional):\n Inspect system for specified scope.\n See the Scope section for more information. -e SCOPE , --ignore-scope=IGNORE-SCOPE (optional):\n Inspect system for all scopes except the specified scope.\n See the Scope section for more information. -r USER , --remote-user=USER (optional):\n Defines the user which is used to access the inspected system via SSH.\n This user needs to be allowed to run certain commands using sudo (see\n PREREQUISITES for more information).\n To change the default-user use machinery config remote-user=USER -p SSH-PORT , --ssh-port SSH-PORT (optional):\n Specifies the SSH port of the remote SSH server. -i SSH-IDENTITY-FILE , --ssh-identity-file SSH-IDENTITY-FILE (optional):\n Specifies the SSH private key what should be used to authenticate with the\n remote SSH server. Keys with a passphrase are not allowed here. Use the ssh-agent\n instead. -x , --extract-files (optional):\n Extract changed configuration and unmanaged files from the inspected system.\n Shortcut for the combination of --extract-changed-config-files ,\n --extract-unmanaged-files , and --extract-changed-managed-files --extract-changed-config-files (optional):\n Extract changed configuration files from the inspected system. --extract-unmanaged-files (optional):\n Extract unmanaged files from the inspected system. --extract-changed-managed-files (optional):\n Extract changed managed files from inspected system. --skip-files (optional):\n Do not consider given files or directories during inspection. Either provide\n one file or directory name or a list of names separated by commas. You can\n also point to a file which contains a list of files to filter (one per line)\n by adding an '@' before the path, e.g. $ machinery inspect --skip-files=@/path/to/filter_file myhost If a filename contains a comma it needs to be escaped, e.g. $ machinery inspect --skip-files=/file\\,with_comma myhost Note : File or directory names are not expanded, e.g. '../path' is taken\n literally and not expanded. --verbose (optional):\n Display the filters which are used during inspection.",
521
521
  "title": "OPTIONS"
522
522
  },
523
523
  {
@@ -532,7 +532,7 @@
532
532
  },
533
533
  {
534
534
  "location": "/machinery-inspect-docker.1/",
535
- "text": "inspect-container \u2014 Inspect Container\n\n\nSYNOPSIS\n\n\nmachinery inspect-container\n [OPTIONS] IMAGENAME\n\n\nmachinery inspect-container\n [OPTIONS] IMAGEID\n\n\nmachinery\n help inspect-container\n\n\nDESCRIPTION\n\n\nThe \ninspect-container\n command inspects a container image. It creates and starts the container from the provided image before inspection\nand generates a system description from the gathered data. After the inspection the container will be killed and removed again.\nThis approach ensures that no containers and images are affected by the inspection.\n\n\nRight now the container inspection only supports Docker images.\n\n\nThe system data is structured into scopes, controlled by the\n\n--scope\n option.\n\n\nNote\n:\nMachinery will always inspect all specified scopes, and skip scopes which\ntrigger errors.\n\n\nARGUMENTS\n\n\n\n\nIMAGENAME / IMAGEID\n (required):\n The name or id of the image to be inspected. The provided name or id will also be\n used as the name of the stored system description unless another name is\n provided with the \n--name\n option.\n\n\n\n\nOPTIONS\n\n\n\n\n\n\n-n NAME\n, \n--name=NAME\n (optional):\n Store the system description under the specified name.\n\n\n\n\n\n\n-s SCOPE\n, \n--scope=SCOPE\n (optional):\n Inspect image for specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-e SCOPE\n, \n--exclude-scope=EXCLUDE-SCOPE\n (optional):\n Inspect image for all scopes except the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-x\n, \n--extract-files\n (optional):\n Extract changed configuration and unmanaged files from the inspected container.\n Shortcut for the combination of \n--extract-changed-config-files\n,\n \n--extract-unmanaged-files\n, and \n--extract-changed-managed-files\n\n\n\n\n\n\n--extract-changed-config-files\n (optional):\n Extract changed configuration files from the inspected image.\n\n\n\n\n\n\n--extract-unmanaged-files\n (optional):\n Extract unmanaged files from the inspected image.\n\n\n\n\n\n\n--extract-changed-managed-files\n (optional):\n Extract changed managed files from inspected image.\n\n\n\n\n\n\n--skip-files\n (optional):\n Do not consider given files or directories during inspection. Either provide\n one file or directory name or a list of names separated by commas. You can\n also point to a file which contains a list of files to filter (one per line)\n by adding an '@' before the path, e.g.\n\n\n$ \nmachinery\n inspect-container --skip-files=@/path/to/filter_file myimage\n\n\nIf a filename contains a comma it needs to be escaped, e.g.\n\n\n$ \nmachinery\n inspect-container --skip-files=/file\\,with_comma myimage\n\n\nNote\n: File or directory names are not expanded, e.g. '../path' is taken\n literally and not expanded.\n\n\n\n\n\n\n--verbose\n (optional):\n Display the filters which are used during inspection.\n\n\n\n\n\n\nPREREQUISITES\n\n\n\n\n\n\nInspecting a container requires an image specified by the name or id.\n\n\n\n\n\n\nThe image to be inspected needs to have the following commands:\n\n\n\n\nrpm\n or \ndpkg\n\n\nzypper\n, \nyum\n or \napt-cache\n\n\nrsync\n\n\ncat\n\n\nsed\n\n\nfind\n\n\n\n\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nInspect Docker container \nmyimage\n and save system description under name 'MyContainer':\n\n\n$ \nmachinery\n inspect-container --name=MyContainer myimage\n\n\n\n\n\n\nInspect Docker container \n076f46c1bef1\n and save system description under name 'MySecondContainer':\n\n\n$ \nmachinery\n inspect-container --name=MySecondContainer 076f46c1bef1\n\n\n\n\n\n\nExtract changed managed files and save them:\n\n\n$ \nmachinery\n inspect-container --scope=changed-managed-files --extract-files myimage",
535
+ "text": "inspect-container \u2014 Inspect Container\n\n\nSYNOPSIS\n\n\nmachinery inspect-container\n [OPTIONS] IMAGENAME\n\n\nmachinery inspect-container\n [OPTIONS] IMAGEID\n\n\nmachinery\n help inspect-container\n\n\nDESCRIPTION\n\n\nThe \ninspect-container\n command inspects a container image. It creates and starts the container from the provided image before inspection\nand generates a system description from the gathered data. After the inspection the container will be killed and removed again.\nThis approach ensures that no containers and images are affected by the inspection.\n\n\nRight now the container inspection only supports Docker images.\n\n\nThe system data is structured into scopes, controlled by the\n\n--scope\n option.\n\n\nNote\n:\nMachinery will always inspect all specified scopes, and skip scopes which\ntrigger errors.\n\n\nARGUMENTS\n\n\n\n\nIMAGENAME / IMAGEID\n (required):\n The name or id of the image to be inspected. The provided name or id will also be\n used as the name of the stored system description unless another name is\n provided with the \n--name\n option.\n\n\n\n\nOPTIONS\n\n\n\n\n\n\n-n NAME\n, \n--name=NAME\n (optional):\n Store the system description under the specified name.\n\n\n\n\n\n\n-s SCOPE\n, \n--scope=SCOPE\n (optional):\n Inspect image for specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-e SCOPE\n, \n--ignore-scope=IGNORE-SCOPE\n (optional):\n Inspect image for all scopes except the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n-x\n, \n--extract-files\n (optional):\n Extract changed configuration and unmanaged files from the inspected container.\n Shortcut for the combination of \n--extract-changed-config-files\n,\n \n--extract-unmanaged-files\n, and \n--extract-changed-managed-files\n\n\n\n\n\n\n--extract-changed-config-files\n (optional):\n Extract changed configuration files from the inspected image.\n\n\n\n\n\n\n--extract-unmanaged-files\n (optional):\n Extract unmanaged files from the inspected image.\n\n\n\n\n\n\n--extract-changed-managed-files\n (optional):\n Extract changed managed files from inspected image.\n\n\n\n\n\n\n--skip-files\n (optional):\n Do not consider given files or directories during inspection. Either provide\n one file or directory name or a list of names separated by commas. You can\n also point to a file which contains a list of files to filter (one per line)\n by adding an '@' before the path, e.g.\n\n\n$ \nmachinery\n inspect-container --skip-files=@/path/to/filter_file myimage\n\n\nIf a filename contains a comma it needs to be escaped, e.g.\n\n\n$ \nmachinery\n inspect-container --skip-files=/file\\,with_comma myimage\n\n\nNote\n: File or directory names are not expanded, e.g. '../path' is taken\n literally and not expanded.\n\n\n\n\n\n\n--verbose\n (optional):\n Display the filters which are used during inspection.\n\n\n\n\n\n\nPREREQUISITES\n\n\n\n\n\n\nInspecting a container requires an image specified by the name or id.\n\n\n\n\n\n\nThe image to be inspected needs to have the following commands:\n\n\n\n\nrpm\n or \ndpkg\n\n\nzypper\n, \nyum\n or \napt-cache\n\n\nrsync\n\n\ncat\n\n\nsed\n\n\nfind\n\n\n\n\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nInspect Docker container \nmyimage\n and save system description under name 'MyContainer':\n\n\n$ \nmachinery\n inspect-container --name=MyContainer myimage\n\n\n\n\n\n\nInspect Docker container \n076f46c1bef1\n and save system description under name 'MySecondContainer':\n\n\n$ \nmachinery\n inspect-container --name=MySecondContainer 076f46c1bef1\n\n\n\n\n\n\nExtract changed managed files and save them:\n\n\n$ \nmachinery\n inspect-container --scope=changed-managed-files --extract-files myimage",
536
536
  "title": "Inspect Docker"
537
537
  },
538
538
  {
@@ -557,7 +557,7 @@
557
557
  },
558
558
  {
559
559
  "location": "/machinery-inspect-docker.1/#options",
560
- "text": "-n NAME , --name=NAME (optional):\n Store the system description under the specified name. -s SCOPE , --scope=SCOPE (optional):\n Inspect image for specified scope.\n See the Scope section for more information. -e SCOPE , --exclude-scope=EXCLUDE-SCOPE (optional):\n Inspect image for all scopes except the specified scope.\n See the Scope section for more information. -x , --extract-files (optional):\n Extract changed configuration and unmanaged files from the inspected container.\n Shortcut for the combination of --extract-changed-config-files ,\n --extract-unmanaged-files , and --extract-changed-managed-files --extract-changed-config-files (optional):\n Extract changed configuration files from the inspected image. --extract-unmanaged-files (optional):\n Extract unmanaged files from the inspected image. --extract-changed-managed-files (optional):\n Extract changed managed files from inspected image. --skip-files (optional):\n Do not consider given files or directories during inspection. Either provide\n one file or directory name or a list of names separated by commas. You can\n also point to a file which contains a list of files to filter (one per line)\n by adding an '@' before the path, e.g. $ machinery inspect-container --skip-files=@/path/to/filter_file myimage If a filename contains a comma it needs to be escaped, e.g. $ machinery inspect-container --skip-files=/file\\,with_comma myimage Note : File or directory names are not expanded, e.g. '../path' is taken\n literally and not expanded. --verbose (optional):\n Display the filters which are used during inspection.",
560
+ "text": "-n NAME , --name=NAME (optional):\n Store the system description under the specified name. -s SCOPE , --scope=SCOPE (optional):\n Inspect image for specified scope.\n See the Scope section for more information. -e SCOPE , --ignore-scope=IGNORE-SCOPE (optional):\n Inspect image for all scopes except the specified scope.\n See the Scope section for more information. -x , --extract-files (optional):\n Extract changed configuration and unmanaged files from the inspected container.\n Shortcut for the combination of --extract-changed-config-files ,\n --extract-unmanaged-files , and --extract-changed-managed-files --extract-changed-config-files (optional):\n Extract changed configuration files from the inspected image. --extract-unmanaged-files (optional):\n Extract unmanaged files from the inspected image. --extract-changed-managed-files (optional):\n Extract changed managed files from inspected image. --skip-files (optional):\n Do not consider given files or directories during inspection. Either provide\n one file or directory name or a list of names separated by commas. You can\n also point to a file which contains a list of files to filter (one per line)\n by adding an '@' before the path, e.g. $ machinery inspect-container --skip-files=@/path/to/filter_file myimage If a filename contains a comma it needs to be escaped, e.g. $ machinery inspect-container --skip-files=/file\\,with_comma myimage Note : File or directory names are not expanded, e.g. '../path' is taken\n literally and not expanded. --verbose (optional):\n Display the filters which are used during inspection.",
561
561
  "title": "OPTIONS"
562
562
  },
563
563
  {
@@ -722,7 +722,7 @@
722
722
  },
723
723
  {
724
724
  "location": "/machinery-show.1/",
725
- "text": "show \u2014 Show System Description\n\n\nSYNOPSIS\n\n\nmachinery show\n [-s SCOPE | --scope=SCOPE] [-e EXCLUDE-SCOPE | --exclude-scope=EXCLUDE-SCOPE] [--no-pager] [--show-diffs] [--html] NAME\n\n\nmachinery\n help show\n\n\nDESCRIPTION\n\n\nThe \nshow\n command displays a stored system description.\nScopes are supported and limit the output to the given scope.\nThe hostname of the inspected system and the last modification\nin local time are shown in the title of each scope section.\n\n\nARGUMENTS\n\n\n\n\nNAME\n (required):\n Use specified system description.\n\n\n\n\nOPTIONS\n\n\n\n\n\n\n-s SCOPE\n, \n--scope=SCOPE\n (optional):\n Limit output to the specified scope.\n See the \nScope section\n for more information.\n If displaying information related to a scope fails, \nshow\n will print an error message what has failed.\n In case of an error, no content is displayed.\n\n\n\n\n\n\n-e EXCLUDE-SCOPE\n, \n--exclude-scope=EXCLUDE-SCOPE\n (optional):\n Skip output of the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n--no-pager\n (optional):\n Do not pipe output into a pager.\n\n\n\n\n\n\n--show-diffs\n (optional):\n Include the generated diffs in the output if available (see \nmachinery help analyze\n\n for more information).\n\n\n\n\n\n\n--html\n (optional):\n Run a web server and open the system description in HTML format in your web browser using the\n \nxdg-open\n command.\n\n\n\n\n\n\n--verbose\n (optional):\n Display the filters which were applied before showing the system description.\n\n\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nShow the system description taken from the last inspection, saved as \nearth\n:\n\n\n$ \nmachinery\n show earth\n\n\n\n\n\n\nShow the system description, but limit the scope to repositories only:\n\n\n$ \nmachinery\n show earth -s repositories\n\n\n\n\n\n\nShow the list of changed managed files:\n\n\n$ \nmachinery\n show earth --scope=changed-managed-files",
725
+ "text": "show \u2014 Show System Description\n\n\nSYNOPSIS\n\n\nmachinery show\n [-s SCOPE | --scope=SCOPE] [-e IGNORE-SCOPE | --ignore-scope=IGNORE-SCOPE] [--no-pager] [--show-diffs] [--html] NAME\n\n\nmachinery\n help show\n\n\nDESCRIPTION\n\n\nThe \nshow\n command displays a stored system description.\nScopes are supported and limit the output to the given scope.\nThe hostname of the inspected system and the last modification\nin local time are shown in the title of each scope section.\n\n\nARGUMENTS\n\n\n\n\nNAME\n (required):\n Use specified system description.\n\n\n\n\nOPTIONS\n\n\n\n\n\n\n-s SCOPE\n, \n--scope=SCOPE\n (optional):\n Limit output to the specified scope.\n See the \nScope section\n for more information.\n If displaying information related to a scope fails, \nshow\n will print an error message what has failed.\n In case of an error, no content is displayed.\n\n\n\n\n\n\n-e IGNORE-SCOPE\n, \n--ignore-scope=IGNORE-SCOPE\n (optional):\n Skip output of the specified scope.\n See the \nScope section\n for more information.\n\n\n\n\n\n\n--no-pager\n (optional):\n Do not pipe output into a pager.\n\n\n\n\n\n\n--show-diffs\n (optional):\n Include the generated diffs in the output if available (see \nmachinery help analyze\n\n for more information).\n\n\n\n\n\n\n--html\n (optional):\n Run a web server and open the system description in HTML format in your web browser using the\n \nxdg-open\n command.\n\n\n\n\n\n\n--verbose\n (optional):\n Display the filters which were applied before showing the system description.\n\n\n\n\n\n\nEXAMPLES\n\n\n\n\n\n\nShow the system description taken from the last inspection, saved as \nearth\n:\n\n\n$ \nmachinery\n show earth\n\n\n\n\n\n\nShow the system description, but limit the scope to repositories only:\n\n\n$ \nmachinery\n show earth -s repositories\n\n\n\n\n\n\nShow the list of changed managed files:\n\n\n$ \nmachinery\n show earth --scope=changed-managed-files",
726
726
  "title": "Show"
727
727
  },
728
728
  {
@@ -732,7 +732,7 @@
732
732
  },
733
733
  {
734
734
  "location": "/machinery-show.1/#synopsis",
735
- "text": "machinery show [-s SCOPE | --scope=SCOPE] [-e EXCLUDE-SCOPE | --exclude-scope=EXCLUDE-SCOPE] [--no-pager] [--show-diffs] [--html] NAME machinery help show",
735
+ "text": "machinery show [-s SCOPE | --scope=SCOPE] [-e IGNORE-SCOPE | --ignore-scope=IGNORE-SCOPE] [--no-pager] [--show-diffs] [--html] NAME machinery help show",
736
736
  "title": "SYNOPSIS"
737
737
  },
738
738
  {
@@ -747,7 +747,7 @@
747
747
  },
748
748
  {
749
749
  "location": "/machinery-show.1/#options",
750
- "text": "-s SCOPE , --scope=SCOPE (optional):\n Limit output to the specified scope.\n See the Scope section for more information.\n If displaying information related to a scope fails, show will print an error message what has failed.\n In case of an error, no content is displayed. -e EXCLUDE-SCOPE , --exclude-scope=EXCLUDE-SCOPE (optional):\n Skip output of the specified scope.\n See the Scope section for more information. --no-pager (optional):\n Do not pipe output into a pager. --show-diffs (optional):\n Include the generated diffs in the output if available (see machinery help analyze \n for more information). --html (optional):\n Run a web server and open the system description in HTML format in your web browser using the\n xdg-open command. --verbose (optional):\n Display the filters which were applied before showing the system description.",
750
+ "text": "-s SCOPE , --scope=SCOPE (optional):\n Limit output to the specified scope.\n See the Scope section for more information.\n If displaying information related to a scope fails, show will print an error message what has failed.\n In case of an error, no content is displayed. -e IGNORE-SCOPE , --ignore-scope=IGNORE-SCOPE (optional):\n Skip output of the specified scope.\n See the Scope section for more information. --no-pager (optional):\n Do not pipe output into a pager. --show-diffs (optional):\n Include the generated diffs in the output if available (see machinery help analyze \n for more information). --html (optional):\n Run a web server and open the system description in HTML format in your web browser using the\n xdg-open command. --verbose (optional):\n Display the filters which were applied before showing the system description.",
751
751
  "title": "OPTIONS"
752
752
  },
753
753
  {
@@ -4,7 +4,7 @@
4
4
 
5
5
  <url>
6
6
  <loc>None/docs/</loc>
7
- <lastmod>2016-03-01</lastmod>
7
+ <lastmod>2016-04-04</lastmod>
8
8
  <changefreq>daily</changefreq>
9
9
  </url>
10
10
 
@@ -13,25 +13,25 @@
13
13
 
14
14
  <url>
15
15
  <loc>None/machinery_main_general.1/</loc>
16
- <lastmod>2016-03-01</lastmod>
16
+ <lastmod>2016-04-04</lastmod>
17
17
  <changefreq>daily</changefreq>
18
18
  </url>
19
19
 
20
20
  <url>
21
21
  <loc>None/machinery_main_scopes.1/</loc>
22
- <lastmod>2016-03-01</lastmod>
22
+ <lastmod>2016-04-04</lastmod>
23
23
  <changefreq>daily</changefreq>
24
24
  </url>
25
25
 
26
26
  <url>
27
27
  <loc>None/machinery_main_usecases.1/</loc>
28
- <lastmod>2016-03-01</lastmod>
28
+ <lastmod>2016-04-04</lastmod>
29
29
  <changefreq>daily</changefreq>
30
30
  </url>
31
31
 
32
32
  <url>
33
33
  <loc>None/machinery_security_implications.1/</loc>
34
- <lastmod>2016-03-01</lastmod>
34
+ <lastmod>2016-04-04</lastmod>
35
35
  <changefreq>daily</changefreq>
36
36
  </url>
37
37
 
@@ -41,109 +41,109 @@
41
41
 
42
42
  <url>
43
43
  <loc>None/machinery-analyze.1/</loc>
44
- <lastmod>2016-03-01</lastmod>
44
+ <lastmod>2016-04-04</lastmod>
45
45
  <changefreq>daily</changefreq>
46
46
  </url>
47
47
 
48
48
  <url>
49
49
  <loc>None/machinery-build.1/</loc>
50
- <lastmod>2016-03-01</lastmod>
50
+ <lastmod>2016-04-04</lastmod>
51
51
  <changefreq>daily</changefreq>
52
52
  </url>
53
53
 
54
54
  <url>
55
55
  <loc>None/machinery-compare.1/</loc>
56
- <lastmod>2016-03-01</lastmod>
56
+ <lastmod>2016-04-04</lastmod>
57
57
  <changefreq>daily</changefreq>
58
58
  </url>
59
59
 
60
60
  <url>
61
61
  <loc>None/machinery-config.1/</loc>
62
- <lastmod>2016-03-01</lastmod>
62
+ <lastmod>2016-04-04</lastmod>
63
63
  <changefreq>daily</changefreq>
64
64
  </url>
65
65
 
66
66
  <url>
67
67
  <loc>None/machinery-copy.1/</loc>
68
- <lastmod>2016-03-01</lastmod>
68
+ <lastmod>2016-04-04</lastmod>
69
69
  <changefreq>daily</changefreq>
70
70
  </url>
71
71
 
72
72
  <url>
73
73
  <loc>None/machinery-deploy.1/</loc>
74
- <lastmod>2016-03-01</lastmod>
74
+ <lastmod>2016-04-04</lastmod>
75
75
  <changefreq>daily</changefreq>
76
76
  </url>
77
77
 
78
78
  <url>
79
79
  <loc>None/machinery-export-autoyast.1/</loc>
80
- <lastmod>2016-03-01</lastmod>
80
+ <lastmod>2016-04-04</lastmod>
81
81
  <changefreq>daily</changefreq>
82
82
  </url>
83
83
 
84
84
  <url>
85
85
  <loc>None/machinery-export-kiwi.1/</loc>
86
- <lastmod>2016-03-01</lastmod>
86
+ <lastmod>2016-04-04</lastmod>
87
87
  <changefreq>daily</changefreq>
88
88
  </url>
89
89
 
90
90
  <url>
91
91
  <loc>None/machinery-inspect.1/</loc>
92
- <lastmod>2016-03-01</lastmod>
92
+ <lastmod>2016-04-04</lastmod>
93
93
  <changefreq>daily</changefreq>
94
94
  </url>
95
95
 
96
96
  <url>
97
97
  <loc>None/machinery-inspect-docker.1/</loc>
98
- <lastmod>2016-03-01</lastmod>
98
+ <lastmod>2016-04-04</lastmod>
99
99
  <changefreq>daily</changefreq>
100
100
  </url>
101
101
 
102
102
  <url>
103
103
  <loc>None/machinery-list.1/</loc>
104
- <lastmod>2016-03-01</lastmod>
104
+ <lastmod>2016-04-04</lastmod>
105
105
  <changefreq>daily</changefreq>
106
106
  </url>
107
107
 
108
108
  <url>
109
109
  <loc>None/machinery-man.1/</loc>
110
- <lastmod>2016-03-01</lastmod>
110
+ <lastmod>2016-04-04</lastmod>
111
111
  <changefreq>daily</changefreq>
112
112
  </url>
113
113
 
114
114
  <url>
115
115
  <loc>None/machinery-move.1/</loc>
116
- <lastmod>2016-03-01</lastmod>
116
+ <lastmod>2016-04-04</lastmod>
117
117
  <changefreq>daily</changefreq>
118
118
  </url>
119
119
 
120
120
  <url>
121
121
  <loc>None/machinery-remove.1/</loc>
122
- <lastmod>2016-03-01</lastmod>
122
+ <lastmod>2016-04-04</lastmod>
123
123
  <changefreq>daily</changefreq>
124
124
  </url>
125
125
 
126
126
  <url>
127
127
  <loc>None/machinery-serve.1/</loc>
128
- <lastmod>2016-03-01</lastmod>
128
+ <lastmod>2016-04-04</lastmod>
129
129
  <changefreq>daily</changefreq>
130
130
  </url>
131
131
 
132
132
  <url>
133
133
  <loc>None/machinery-show.1/</loc>
134
- <lastmod>2016-03-01</lastmod>
134
+ <lastmod>2016-04-04</lastmod>
135
135
  <changefreq>daily</changefreq>
136
136
  </url>
137
137
 
138
138
  <url>
139
139
  <loc>None/machinery-upgrade-format.1/</loc>
140
- <lastmod>2016-03-01</lastmod>
140
+ <lastmod>2016-04-04</lastmod>
141
141
  <changefreq>daily</changefreq>
142
142
  </url>
143
143
 
144
144
  <url>
145
145
  <loc>None/machinery-validate.1/</loc>
146
- <lastmod>2016-03-01</lastmod>
146
+ <lastmod>2016-04-04</lastmod>
147
147
  <changefreq>daily</changefreq>
148
148
  </url>
149
149