machinery-tool 1.17.0 → 1.18.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (310) hide show
  1. checksums.yaml +4 -4
  2. data/.git_revision +1 -1
  3. data/NEWS +17 -1
  4. data/bin/machinery +1 -1
  5. data/export_helpers/merge_users_and_groups.pl.erb +1 -1
  6. data/html/comparison.html.haml +14 -9
  7. data/html/index.html.haml +5 -2
  8. data/html/landing_page.html.haml +4 -1
  9. data/html/partials/changed_managed_files.html.haml +2 -0
  10. data/html/partials/compare/alert.html.haml +1 -1
  11. data/html/partials/compare/unmanaged_file_list.html.haml +12 -0
  12. data/html/partials/config_files.html.haml +2 -0
  13. data/html/partials/landing_page/alert.html.haml +1 -1
  14. data/html/partials/unmanaged_files.html.haml +14 -0
  15. data/inspect_helpers/changed_files.sh +1 -1
  16. data/inspect_helpers/dpkg_unmanaged_files.sh +1 -1
  17. data/inspect_helpers/yum_repositories.py +1 -1
  18. data/lib/analyze_config_file_diffs_task.rb +1 -1
  19. data/lib/array.rb +1 -1
  20. data/lib/autoyast.rb +34 -34
  21. data/lib/build_task.rb +1 -1
  22. data/lib/cli.rb +21 -6
  23. data/lib/compare_task.rb +1 -1
  24. data/lib/comparison.rb +1 -1
  25. data/lib/config.rb +1 -1
  26. data/lib/config_base.rb +1 -1
  27. data/lib/config_task.rb +1 -1
  28. data/lib/constants.rb +2 -2
  29. data/lib/containerize_task.rb +1 -1
  30. data/lib/containerized_app.rb +1 -1
  31. data/lib/copy_task.rb +1 -1
  32. data/lib/current_user.rb +1 -1
  33. data/lib/deploy_task.rb +1 -1
  34. data/lib/docker_system.rb +4 -5
  35. data/lib/dpkg_database.rb +2 -2
  36. data/lib/element_filter.rb +1 -1
  37. data/lib/exceptions.rb +2 -2
  38. data/lib/export_task.rb +1 -1
  39. data/lib/exporter.rb +1 -1
  40. data/lib/file_diff.rb +1 -1
  41. data/lib/file_scope.rb +1 -1
  42. data/lib/file_validator.rb +1 -1
  43. data/lib/filter.rb +1 -1
  44. data/lib/filter_option_parser.rb +1 -1
  45. data/lib/helper.rb +1 -1
  46. data/lib/hint.rb +1 -1
  47. data/lib/html.rb +1 -1
  48. data/lib/inspect_task.rb +1 -1
  49. data/lib/inspector.rb +1 -1
  50. data/lib/json_schema_monkey_patch.rb +35 -0
  51. data/lib/json_validation_error_cleaner.rb +1 -1
  52. data/lib/json_validator.rb +1 -1
  53. data/lib/kiwi_config.rb +69 -67
  54. data/lib/list_task.rb +1 -1
  55. data/lib/local_system.rb +1 -1
  56. data/lib/logged_cheetah.rb +1 -1
  57. data/lib/machinery.rb +6 -2
  58. data/lib/machinery_helper.rb +28 -8
  59. data/lib/machinery_logger.rb +1 -1
  60. data/lib/man_task.rb +50 -5
  61. data/lib/managed_files_database.rb +24 -17
  62. data/lib/manifest.rb +3 -2
  63. data/lib/migration.rb +1 -1
  64. data/lib/mountpoints.rb +1 -1
  65. data/lib/move_task.rb +1 -1
  66. data/lib/object.rb +1 -1
  67. data/lib/remote_system.rb +2 -2
  68. data/lib/remove_task.rb +1 -1
  69. data/lib/renderer.rb +1 -1
  70. data/lib/renderer_helper.rb +1 -1
  71. data/lib/rpm.rb +1 -1
  72. data/lib/rpm_database.rb +1 -1
  73. data/lib/scope.rb +1 -1
  74. data/lib/scope_file_store.rb +1 -1
  75. data/lib/serve_html_task.rb +1 -1
  76. data/lib/server.rb +32 -2
  77. data/lib/show_task.rb +1 -1
  78. data/lib/system.rb +1 -1
  79. data/lib/system_description.rb +2 -2
  80. data/lib/system_description_memory_store.rb +1 -1
  81. data/lib/system_description_store.rb +1 -1
  82. data/lib/system_file.rb +1 -1
  83. data/lib/tarball.rb +1 -1
  84. data/lib/tee_io.rb +39 -0
  85. data/lib/try.rb +1 -1
  86. data/lib/ui.rb +1 -1
  87. data/lib/upgrade_format_task.rb +1 -1
  88. data/lib/validate_task.rb +1 -1
  89. data/lib/version.rb +2 -2
  90. data/lib/workload_mapper.rb +1 -1
  91. data/lib/workload_mapper_dsl.rb +1 -1
  92. data/lib/zypper.rb +3 -3
  93. data/machinery-helper/Rakefile +2 -8
  94. data/machinery-helper/file_utils.go +28 -0
  95. data/machinery-helper/file_utils_test.go +21 -0
  96. data/machinery-helper/machinery_helper.go +121 -8
  97. data/machinery-helper/machinery_helper_test.go +102 -0
  98. data/machinery-helper/mountpoints_test.go +33 -33
  99. data/machinery-helper/version.go +1 -1
  100. data/man/generated/machinery.1.gz +0 -0
  101. data/manual/custom_theme/base.html +42 -0
  102. data/manual/docs/CNAME +1 -0
  103. data/manual/docs/README.md +128 -0
  104. data/manual/docs/css/bootstrap.min.css +7 -0
  105. data/manual/docs/css/custom.css +788 -0
  106. data/manual/docs/css/fixed-positioning.css +45 -0
  107. data/manual/docs/custom.css +804 -0
  108. data/manual/docs/docs.md +7 -0
  109. data/manual/docs/favicon.png +0 -0
  110. data/manual/docs/hand3.png +0 -0
  111. data/manual/docs/img/arrow.png +0 -0
  112. data/manual/docs/img/background/1.png +0 -0
  113. data/manual/docs/img/background/2.png +0 -0
  114. data/manual/docs/img/background/3.png +0 -0
  115. data/manual/docs/img/background/4.png +0 -0
  116. data/manual/docs/img/background/5.png +0 -0
  117. data/manual/docs/img/background/6.png +0 -0
  118. data/manual/docs/img/background/7.png +0 -0
  119. data/manual/docs/img/bk-cloud.png +0 -0
  120. data/manual/docs/img/bk-sec-15.png +0 -0
  121. data/manual/docs/img/book.png +0 -0
  122. data/manual/docs/img/configuration-discovery.png +0 -0
  123. data/manual/docs/img/dot-line-left.png +0 -0
  124. data/manual/docs/img/dot-line-right.png +0 -0
  125. data/manual/docs/img/gear.png +0 -0
  126. data/manual/docs/img/gear2.png +0 -0
  127. data/manual/docs/img/gear3.png +0 -0
  128. data/manual/docs/img/hand.png +0 -0
  129. data/manual/docs/img/hand2.png +0 -0
  130. data/manual/docs/img/hand3.png +0 -0
  131. data/manual/docs/img/home2.png +0 -0
  132. data/manual/docs/img/moustache.png +0 -0
  133. data/manual/docs/img/navig.png +0 -0
  134. data/manual/docs/img/philo.png +0 -0
  135. data/manual/docs/img/service-migration.png +0 -0
  136. data/manual/docs/img/system-validation.png +0 -0
  137. data/manual/docs/img/ticket2.png +0 -0
  138. data/manual/docs/img/usecase-default.png +0 -0
  139. data/manual/docs/img/usecase1.png +0 -0
  140. data/manual/docs/img/usecase2.png +0 -0
  141. data/manual/docs/img/usecase3.png +0 -0
  142. data/manual/docs/img/usecase4.png +0 -0
  143. data/manual/docs/img/wheels.png +0 -0
  144. data/manual/docs/index.html +402 -0
  145. data/manual/docs/js/bootstrap.min.js +6 -0
  146. data/manual/docs/js/custom.js +148 -0
  147. data/manual/docs/js/jquery.js +4 -0
  148. data/manual/docs/js/jquery.nicescroll.min.js +116 -0
  149. data/manual/docs/js/jquery.pageslide.min.js +11 -0
  150. data/manual/docs/js/parallaxImg.js +146 -0
  151. data/manual/docs/js/skrollr.min.js +2 -0
  152. data/manual/docs/machinery-analyze.1.md +37 -0
  153. data/manual/docs/machinery-build.1.md +62 -0
  154. data/manual/docs/machinery-compare.1.md +63 -0
  155. data/manual/docs/machinery-config.1.md +45 -0
  156. data/manual/docs/machinery-copy.1.md +31 -0
  157. data/manual/docs/machinery-deploy.1.md +71 -0
  158. data/manual/docs/machinery-export-autoyast.1.md +58 -0
  159. data/manual/docs/machinery-export-kiwi.1.md +38 -0
  160. data/manual/docs/machinery-inspect-docker.1.md +108 -0
  161. data/manual/docs/machinery-inspect.1.md +145 -0
  162. data/manual/docs/machinery-list.1.md +51 -0
  163. data/manual/docs/machinery-man.1.md +16 -0
  164. data/manual/docs/machinery-move.1.md +29 -0
  165. data/manual/docs/machinery-remove.1.md +44 -0
  166. data/manual/docs/machinery-serve.1.md +45 -0
  167. data/manual/docs/machinery-show.1.md +63 -0
  168. data/manual/docs/machinery-upgrade-format.1.md +47 -0
  169. data/manual/docs/machinery-validate.1.md +34 -0
  170. data/manual/docs/machinery.ymp +114 -0
  171. data/manual/docs/machinery_main_general.1.md +139 -0
  172. data/manual/docs/machinery_main_scopes.1.md +98 -0
  173. data/manual/docs/machinery_main_usecases.1.md +49 -0
  174. data/manual/docs/machinery_security_implications.1.md +89 -0
  175. data/manual/docs/subcommand-template.1.md +46 -0
  176. data/manual/docs/wheels.png +0 -0
  177. data/manual/mkdocs.yml +30 -0
  178. data/manual/site/CNAME +1 -0
  179. data/manual/site/base.html +42 -0
  180. data/manual/site/css/bootstrap.min.css +7 -0
  181. data/manual/site/css/custom.css +788 -0
  182. data/manual/site/css/fixed-positioning.css +45 -0
  183. data/manual/site/custom.css +804 -0
  184. data/manual/site/docs/index.html +144 -0
  185. data/manual/site/favicon.png +0 -0
  186. data/manual/site/hand3.png +0 -0
  187. data/manual/site/img/arrow.png +0 -0
  188. data/manual/site/img/background/1.png +0 -0
  189. data/manual/site/img/background/2.png +0 -0
  190. data/manual/site/img/background/3.png +0 -0
  191. data/manual/site/img/background/4.png +0 -0
  192. data/manual/site/img/background/5.png +0 -0
  193. data/manual/site/img/background/6.png +0 -0
  194. data/manual/site/img/background/7.png +0 -0
  195. data/manual/site/img/bk-cloud.png +0 -0
  196. data/manual/site/img/bk-sec-15.png +0 -0
  197. data/manual/site/img/book.png +0 -0
  198. data/manual/site/img/configuration-discovery.png +0 -0
  199. data/manual/site/img/dot-line-left.png +0 -0
  200. data/manual/site/img/dot-line-right.png +0 -0
  201. data/manual/site/img/gear.png +0 -0
  202. data/manual/site/img/gear2.png +0 -0
  203. data/manual/site/img/gear3.png +0 -0
  204. data/manual/site/img/hand.png +0 -0
  205. data/manual/site/img/hand2.png +0 -0
  206. data/manual/site/img/hand3.png +0 -0
  207. data/manual/site/img/home2.png +0 -0
  208. data/manual/site/img/moustache.png +0 -0
  209. data/manual/site/img/navig.png +0 -0
  210. data/manual/site/img/philo.png +0 -0
  211. data/manual/site/img/service-migration.png +0 -0
  212. data/manual/site/img/system-validation.png +0 -0
  213. data/manual/site/img/ticket2.png +0 -0
  214. data/manual/site/img/usecase-default.png +0 -0
  215. data/manual/site/img/usecase1.png +0 -0
  216. data/manual/site/img/usecase2.png +0 -0
  217. data/manual/site/img/usecase3.png +0 -0
  218. data/manual/site/img/usecase4.png +0 -0
  219. data/manual/site/img/wheels.png +0 -0
  220. data/manual/site/index.html +402 -0
  221. data/manual/site/js/bootstrap.min.js +6 -0
  222. data/manual/site/js/custom.js +148 -0
  223. data/manual/site/js/jquery.js +4 -0
  224. data/manual/site/js/jquery.nicescroll.min.js +116 -0
  225. data/manual/site/js/jquery.pageslide.min.js +11 -0
  226. data/manual/site/js/parallaxImg.js +146 -0
  227. data/manual/site/js/skrollr.min.js +2 -0
  228. data/manual/site/machinery-analyze.1/index.html +167 -0
  229. data/manual/site/machinery-build.1/index.html +198 -0
  230. data/manual/site/machinery-compare.1/index.html +200 -0
  231. data/manual/site/machinery-config.1/index.html +175 -0
  232. data/manual/site/machinery-copy.1/index.html +164 -0
  233. data/manual/site/machinery-deploy.1/index.html +200 -0
  234. data/manual/site/machinery-export-autoyast.1/index.html +188 -0
  235. data/manual/site/machinery-export-kiwi.1/index.html +169 -0
  236. data/manual/site/machinery-inspect-docker.1/index.html +242 -0
  237. data/manual/site/machinery-inspect.1/index.html +283 -0
  238. data/manual/site/machinery-list.1/index.html +180 -0
  239. data/manual/site/machinery-man.1/index.html +148 -0
  240. data/manual/site/machinery-move.1/index.html +162 -0
  241. data/manual/site/machinery-remove.1/index.html +175 -0
  242. data/manual/site/machinery-serve.1/index.html +174 -0
  243. data/manual/site/machinery-show.1/index.html +199 -0
  244. data/manual/site/machinery-upgrade-format.1/index.html +173 -0
  245. data/manual/site/machinery-validate.1/index.html +161 -0
  246. data/manual/site/machinery.ymp +114 -0
  247. data/manual/site/machinery_main_general.1/index.html +260 -0
  248. data/manual/site/machinery_main_scopes.1/index.html +242 -0
  249. data/manual/site/machinery_main_usecases.1/index.html +182 -0
  250. data/manual/site/machinery_security_implications.1/index.html +223 -0
  251. data/manual/site/mkdocs/js/lunr-0.5.7.min.js +7 -0
  252. data/manual/site/mkdocs/js/mustache.min.js +1 -0
  253. data/manual/site/mkdocs/js/require.js +36 -0
  254. data/manual/site/mkdocs/js/search-results-template.mustache +4 -0
  255. data/manual/site/mkdocs/js/search.js +88 -0
  256. data/manual/site/mkdocs/js/text.js +390 -0
  257. data/manual/site/mkdocs/search_index.json +824 -0
  258. data/manual/site/sitemap.xml +152 -0
  259. data/manual/site/wheels.png +0 -0
  260. data/plugins/changed_managed_files/changed_managed_files_inspector.rb +1 -1
  261. data/plugins/changed_managed_files/changed_managed_files_model.rb +1 -1
  262. data/plugins/changed_managed_files/changed_managed_files_renderer.rb +1 -1
  263. data/plugins/changed_managed_files/schema/system-description-changed-managed-files.schema-v7.json +160 -0
  264. data/plugins/config_files/config_files_inspector.rb +1 -1
  265. data/plugins/config_files/config_files_model.rb +1 -1
  266. data/plugins/config_files/config_files_renderer.rb +1 -1
  267. data/plugins/config_files/schema/system-description-config-files.schema-v7.json +160 -0
  268. data/plugins/environment/environment_inspector.rb +1 -1
  269. data/plugins/environment/environment_model.rb +1 -1
  270. data/plugins/environment/schema/system-description-environment.schema-v7.json +17 -0
  271. data/plugins/groups/groups_inspector.rb +1 -1
  272. data/plugins/groups/groups_model.rb +1 -1
  273. data/plugins/groups/groups_renderer.rb +1 -1
  274. data/plugins/groups/schema/system-description-groups.schema-v7.json +49 -0
  275. data/plugins/os/os_inspector.rb +1 -1
  276. data/plugins/os/os_model.rb +1 -1
  277. data/plugins/os/os_renderer.rb +1 -1
  278. data/plugins/os/schema/system-description-os.schema-v7.json +21 -0
  279. data/plugins/packages/packages_inspector.rb +1 -1
  280. data/plugins/packages/packages_model.rb +1 -1
  281. data/plugins/packages/packages_renderer.rb +1 -1
  282. data/plugins/packages/schema/system-description-packages.schema-v7.json +115 -0
  283. data/plugins/patterns/patterns_inspector.rb +6 -6
  284. data/plugins/patterns/patterns_model.rb +1 -1
  285. data/plugins/patterns/patterns_renderer.rb +1 -1
  286. data/plugins/patterns/schema/system-description-patterns.schema-v7.json +58 -0
  287. data/plugins/repositories/repositories_inspector.rb +16 -16
  288. data/plugins/repositories/repositories_model.rb +1 -1
  289. data/plugins/repositories/repositories_renderer.rb +1 -1
  290. data/plugins/repositories/schema/system-description-repositories.schema-v7.json +165 -0
  291. data/plugins/services/schema/system-description-services.schema-v7.json +93 -0
  292. data/plugins/services/services_inspector.rb +1 -1
  293. data/plugins/services/services_model.rb +1 -1
  294. data/plugins/services/services_renderer.rb +1 -1
  295. data/plugins/unmanaged_files/schema/system-description-unmanaged-files.schema-v6.json +19 -61
  296. data/plugins/unmanaged_files/schema/system-description-unmanaged-files.schema-v7.json +124 -0
  297. data/plugins/unmanaged_files/unmanaged_files_inspector.rb +21 -436
  298. data/plugins/unmanaged_files/unmanaged_files_model.rb +2 -2
  299. data/plugins/unmanaged_files/unmanaged_files_renderer.rb +2 -2
  300. data/plugins/users/schema/system-description-users.schema-v7.json +86 -0
  301. data/plugins/users/users_inspector.rb +1 -1
  302. data/plugins/users/users_model.rb +1 -1
  303. data/plugins/users/users_renderer.rb +1 -1
  304. data/schema/migrations/migrate1to2.rb +1 -1
  305. data/schema/migrations/migrate6to7.rb +38 -0
  306. data/schema/system-description-global.schema-v7.json +43 -0
  307. data/tools/go.rb +92 -0
  308. data/tools/helper_builder.rb +16 -49
  309. metadata +182 -6
  310. data/man/generated/machinery.1.html +0 -1399
data/manual/site/machinery_main_general.1/index.html ADDED
@@ -0,0 +1,260 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta charset="utf-8"/>
5
+ <link href="../custom.css" rel="stylesheet">
6
+ </head>
7
+ <body id="manpage">
8
+ <div id="back">
9
+ <a href="..">
10
+ <img src="../hand3.png" class="hand3"/>
11
+ <div class="goback">Go back to the web site</div>
12
+ </a>
13
+ </div>
14
+ <div class="mp">
15
+ <div class="nav">
16
+ <ul>
17
+
18
+
19
+ <li class="">
20
+ <a href="../docs/">Welcome</a>
21
+ </li>
22
+
23
+
24
+
25
+
26
+ <li>Home
27
+ <ul>
28
+
29
+ <li class="current">
30
+ <a href="./">General</a>
31
+ </li>
32
+
33
+ <li class="">
34
+ <a href="../machinery_main_scopes.1/">Scopes</a>
35
+ </li>
36
+
37
+ <li class="">
38
+ <a href="../machinery_main_usecases.1/">Use cases</a>
39
+ </li>
40
+
41
+ <li class="">
42
+ <a href="../machinery_security_implications.1/">Security Implications</a>
43
+ </li>
44
+
45
+ </ul>
46
+ </li>
47
+
48
+
49
+
50
+
51
+ <li>Commands
52
+ <ul>
53
+
54
+ <li class="">
55
+ <a href="../machinery-analyze.1/">Analyze</a>
56
+ </li>
57
+
58
+ <li class="">
59
+ <a href="../machinery-build.1/">Build</a>
60
+ </li>
61
+
62
+ <li class="">
63
+ <a href="../machinery-compare.1/">Compare</a>
64
+ </li>
65
+
66
+ <li class="">
67
+ <a href="../machinery-config.1/">Config</a>
68
+ </li>
69
+
70
+ <li class="">
71
+ <a href="../machinery-copy.1/">Copy</a>
72
+ </li>
73
+
74
+ <li class="">
75
+ <a href="../machinery-deploy.1/">Deploy</a>
76
+ </li>
77
+
78
+ <li class="">
79
+ <a href="../machinery-export-autoyast.1/">Export AutoYaST</a>
80
+ </li>
81
+
82
+ <li class="">
83
+ <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
84
+ </li>
85
+
86
+ <li class="">
87
+ <a href="../machinery-inspect.1/">Inspect</a>
88
+ </li>
89
+
90
+ <li class="">
91
+ <a href="../machinery-inspect-docker.1/">Inspect Docker</a>
92
+ </li>
93
+
94
+ <li class="">
95
+ <a href="../machinery-list.1/">List</a>
96
+ </li>
97
+
98
+ <li class="">
99
+ <a href="../machinery-man.1/">Man</a>
100
+ </li>
101
+
102
+ <li class="">
103
+ <a href="../machinery-move.1/">Move</a>
104
+ </li>
105
+
106
+ <li class="">
107
+ <a href="../machinery-remove.1/">Remove</a>
108
+ </li>
109
+
110
+ <li class="">
111
+ <a href="../machinery-serve.1/">Serve</a>
112
+ </li>
113
+
114
+ <li class="">
115
+ <a href="../machinery-show.1/">Show</a>
116
+ </li>
117
+
118
+ <li class="">
119
+ <a href="../machinery-upgrade-format.1/">Upgrade Format</a>
120
+ </li>
121
+
122
+ <li class="">
123
+ <a href="../machinery-validate.1/">Validate</a>
124
+ </li>
125
+
126
+ </ul>
127
+ </li>
128
+
129
+
130
+
131
+ </ul>
132
+ </div>
133
+ <div class="content">
134
+ <h1 id="machinery-a-systems-management-toolkit-for-linux">Machinery — A Systems Management Toolkit for Linux</h1>
135
+ <h1 id="synopsis">SYNOPSIS</h1>
136
+ <p><code>machinery</code> SUBCOMMAND [options] <br>
137
+ <code>machinery</code> help [SUBCOMMAND]</p>
138
+ <h1 id="description">DESCRIPTION</h1>
139
+ <p>Machinery is a systems management toolkit for Linux. It supports configuration
140
+ discovery, system validation, and service migration. Machinery is based on the
141
+ idea of an universal system description. Machinery has a set of commands which
142
+ work with this system description. These commands can be combined to form work
143
+ flows. Machinery is targeted at the system administrator of the data center.</p>
144
+ <h1 id="work-flow-examples">WORK FLOW EXAMPLES</h1>
145
+ <h2 id="inspect-a-system-and-show-results">Inspect a System and Show Results</h2>
146
+ <ul>
147
+ <li><code>machinery inspect --extract-files --name=NAME HOSTNAME</code></li>
148
+ <li><code>machinery show NAME</code></li>
149
+ </ul>
150
+ <h2 id="inspect-two-systems-and-compare-them">Inspect Two Systems and Compare Them</h2>
151
+ <ul>
152
+ <li><code>machinery inspect HOSTNAME1</code></li>
153
+ <li><code>machinery inspect HOSTNAME2</code></li>
154
+ <li><code>machinery compare HOSTNAME1 HOSTNAME2</code></li>
155
+ </ul>
156
+ <h2 id="fully-inspect-a-system-and-export-a-kiwi-description">Fully Inspect a System and Export a Kiwi Description</h2>
157
+ <ul>
158
+ <li><code>machinery inspect --extract-files HOSTNAME</code></li>
159
+ <li><code>machinery export-kiwi --kiwi-dir=~/kiwi HOSTNAME</code></li>
160
+ </ul>
161
+ <h2 id="fully-inspect-a-system-and-export-an-autoyast-profile">Fully Inspect a System and Export an AutoYaST Profile</h2>
162
+ <ul>
163
+ <li><code>machinery inspect --extract-files HOSTNAME</code></li>
164
+ <li><code>machinery export-autoyast --autoyast-dir=~/autoyast HOSTNAME</code></li>
165
+ </ul>
166
+ <h2 id="fully-inspect-a-system-and-deploy-a-replicate-to-the-cloud">Fully Inspect a System and Deploy a Replicate to the Cloud</h2>
167
+ <ul>
168
+ <li><code>machinery inspect --extract-files HOSTNAME</code></li>
169
+ <li><code>machinery deploy --cloud-config=~/openrc.sh HOSTNAME</code></li>
170
+ </ul>
171
+ <h2 id="how-to-upgrade-a-sles-11-sp3-system-to-sles-12">How to upgrade a SLES 11 SP3 system to SLES 12</h2>
172
+ <ul>
173
+ <li>Machinery can help you to upgrade without affecting the original system.
174
+ For more details please read the Wiki Page: <br>
175
+ https://github.com/SUSE/machinery/wiki/How-to-upgrade-a-SLES-11-SP3-system-to-SLES-12</li>
176
+ </ul>
177
+ <h1 id="conceptual-overview">CONCEPTUAL OVERVIEW</h1>
178
+ <p>Machinery's core concept is the complete representation of a system by a
179
+ universal system description.
180
+ System descriptions are managed independently of the described
181
+ systems which allows for system state conservation and offline preparation of
182
+ modifications.</p>
183
+ <p>Machinery's subcommands work on the system description as the connecting
184
+ element.
185
+ System descriptions are obtained by inspecting systems, importing from other
186
+ formats, manual creation or merging other descriptions.
187
+ Machinery can store and modify system descriptions to allow changes to
188
+ described state of the system.
189
+ System descriptions can be compared to find similarities and differences
190
+ between them or analyzed to deepen the knowledge about particular aspects of
191
+ the system.
192
+ System descriptions may be exported to other formats and can be used to
193
+ migrate or replicate systems.</p>
194
+ <p>Subcommands can be combined in different ways to accomodate higher-level work
195
+ flows and use cases.
196
+ These are some implemented and planned use cases:</p>
197
+ <p>Migrate a physical system to a virtual environment:</p>
198
+ <ul>
199
+ <li>Inspect a system to obtain a system description</li>
200
+ <li>Export the system description to a Kiwi configuration</li>
201
+ <li>Build a cloud image from the configuration</li>
202
+ <li>Deploy the image to the cloud</li>
203
+ </ul>
204
+ <p>Migrate a system while changing the configuration:</p>
205
+ <ul>
206
+ <li>Inspect a system to obtain a system description</li>
207
+ <li>Modify the system description</li>
208
+ <li>Build image for deployment</li>
209
+ </ul>
210
+ <p>Using Machinery as an extension from other formats:</p>
211
+ <ul>
212
+ <li>Import AutoYaST profile as system description</li>
213
+ <li>Build image for deployment</li>
214
+ </ul>
215
+ <p>Machinery provides an extensible set of tools which can be combined to create
216
+ higher-level work flows.
217
+ It is designed for environments which focus on automation, integration
218
+ of diverse tools and accountable management.
219
+ Machinery integrates with existing configuration management solutions to
220
+ address use cases currently not covered by them.</p>
221
+ <h2 id="the-machinery-command">The machinery Command</h2>
222
+ <p>Machinery is implemented as a command line tool named <code>machinery</code>. The
223
+ <code>machinery</code> command has several subcommands for specific tasks. All
224
+ subcommands work with the same system description identified by an optional
225
+ name which can be used by all subcommands.</p>
226
+ <h2 id="scopes">Scopes</h2>
227
+ <p>The system description is structured into "scopes". A scope covers a specific
228
+ part of the configuration of the inspected system such as installed packages,
229
+ repositories, or configuration files.</p>
230
+ <p>For example, if you are only interested in the installed packages, limit the
231
+ scope to <code>packages</code>. This will output only the requested information.</p>
232
+ <p>The the <a href="../machinery_main_scopes.1">scopes documentation</a> for a list of all supported scopes.</p>
233
+ <h1 id="files-and-devices">FILES AND DEVICES</h1>
234
+ <ul>
235
+ <li>
236
+ <p><code>~/.machinery/machinery.config</code>:</p>
237
+ <p>Configuration file.</p>
238
+ </li>
239
+ <li>
240
+ <p><code>~/.machinery/machinery.log</code>:</p>
241
+ <p>Central log file, in the format date, time, process id, and log message.</p>
242
+ </li>
243
+ <li>
244
+ <p><code>eth0</code> (SLE11) and <code>lan0</code> (SLE12):</p>
245
+ <p>First network device is used when DHCP in built image is enabled.</p>
246
+ </li>
247
+ </ul>
248
+ <h1 id="environment">ENVIRONMENT</h1>
249
+ <ul>
250
+ <li>
251
+ <p><code>MACHINERY_LOG_FILE</code>:</p>
252
+ <p>Location of Machinery's log file (defaults to <code>~/.machinery/machinery.log</code>)</p>
253
+ </li>
254
+ </ul>
255
+ <h1 id="copyright">COPYRIGHT</h1>
256
+ <p>Copyright (c) 2013-2016 <a href="http://www.suse.com">SUSE LLC</a></p>
257
+ </div>
258
+ </div>
259
+ </body>
260
+ </html>
data/manual/site/machinery_main_scopes.1/index.html ADDED
@@ -0,0 +1,242 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta charset="utf-8"/>
5
+ <link href="../custom.css" rel="stylesheet">
6
+ </head>
7
+ <body id="manpage">
8
+ <div id="back">
9
+ <a href="..">
10
+ <img src="../hand3.png" class="hand3"/>
11
+ <div class="goback">Go back to the web site</div>
12
+ </a>
13
+ </div>
14
+ <div class="mp">
15
+ <div class="nav">
16
+ <ul>
17
+
18
+
19
+ <li class="">
20
+ <a href="../docs/">Welcome</a>
21
+ </li>
22
+
23
+
24
+
25
+
26
+ <li>Home
27
+ <ul>
28
+
29
+ <li class="">
30
+ <a href="../machinery_main_general.1/">General</a>
31
+ </li>
32
+
33
+ <li class="current">
34
+ <a href="./">Scopes</a>
35
+ </li>
36
+
37
+ <li class="">
38
+ <a href="../machinery_main_usecases.1/">Use cases</a>
39
+ </li>
40
+
41
+ <li class="">
42
+ <a href="../machinery_security_implications.1/">Security Implications</a>
43
+ </li>
44
+
45
+ </ul>
46
+ </li>
47
+
48
+
49
+
50
+
51
+ <li>Commands
52
+ <ul>
53
+
54
+ <li class="">
55
+ <a href="../machinery-analyze.1/">Analyze</a>
56
+ </li>
57
+
58
+ <li class="">
59
+ <a href="../machinery-build.1/">Build</a>
60
+ </li>
61
+
62
+ <li class="">
63
+ <a href="../machinery-compare.1/">Compare</a>
64
+ </li>
65
+
66
+ <li class="">
67
+ <a href="../machinery-config.1/">Config</a>
68
+ </li>
69
+
70
+ <li class="">
71
+ <a href="../machinery-copy.1/">Copy</a>
72
+ </li>
73
+
74
+ <li class="">
75
+ <a href="../machinery-deploy.1/">Deploy</a>
76
+ </li>
77
+
78
+ <li class="">
79
+ <a href="../machinery-export-autoyast.1/">Export AutoYaST</a>
80
+ </li>
81
+
82
+ <li class="">
83
+ <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
84
+ </li>
85
+
86
+ <li class="">
87
+ <a href="../machinery-inspect.1/">Inspect</a>
88
+ </li>
89
+
90
+ <li class="">
91
+ <a href="../machinery-inspect-docker.1/">Inspect Docker</a>
92
+ </li>
93
+
94
+ <li class="">
95
+ <a href="../machinery-list.1/">List</a>
96
+ </li>
97
+
98
+ <li class="">
99
+ <a href="../machinery-man.1/">Man</a>
100
+ </li>
101
+
102
+ <li class="">
103
+ <a href="../machinery-move.1/">Move</a>
104
+ </li>
105
+
106
+ <li class="">
107
+ <a href="../machinery-remove.1/">Remove</a>
108
+ </li>
109
+
110
+ <li class="">
111
+ <a href="../machinery-serve.1/">Serve</a>
112
+ </li>
113
+
114
+ <li class="">
115
+ <a href="../machinery-show.1/">Show</a>
116
+ </li>
117
+
118
+ <li class="">
119
+ <a href="../machinery-upgrade-format.1/">Upgrade Format</a>
120
+ </li>
121
+
122
+ <li class="">
123
+ <a href="../machinery-validate.1/">Validate</a>
124
+ </li>
125
+
126
+ </ul>
127
+ </li>
128
+
129
+
130
+
131
+ </ul>
132
+ </div>
133
+ <div class="content">
134
+ <ul>
135
+ <li>os</li>
136
+ </ul>
137
+ <p>Contains information about the operating system, name, version, and
138
+ architecture of the inspected system.</p>
139
+ <ul>
140
+ <li>packages</li>
141
+ </ul>
142
+ <p>Contains information on all installed RPM packages installed on the
143
+ inspected system.</p>
144
+ <ul>
145
+ <li>patterns</li>
146
+ </ul>
147
+ <p>Contains all patterns installed on the inspected system. A pattern is a
148
+ collection of software packages.
149
+ The meaning of software patterns depends on the package manager of the
150
+ 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
+ <ul>
153
+ <li>repositories</li>
154
+ </ul>
155
+ <p>Contains all information about software repositories configured on the
156
+ inspected system. The information about repositories depends on the package
157
+ manager of the distribution. Thus on SUSE-based systems the <code>zypper</code> command
158
+ is used. Machinery collects the following information from each configured repository:</p>
159
+ <ul>
160
+ <li>
161
+ <p>The alias name of the repository.</p>
162
+ </li>
163
+ <li>
164
+ <p>The repository type, rpm-md and YaST types that are used on SUSE systems.</p>
165
+ </li>
166
+ <li>
167
+ <p>The path to the repository. This could be a local path, a remote location,
168
+ a device, or a file.</p>
169
+ </li>
170
+ <li>
171
+ <p>A boolean flag that indicates if this repository is in use or not.</p>
172
+ </li>
173
+ <li>
174
+ <p>A boolean flag that indicates if this repository should update the locally
175
+ stored metadata files with metadata files from the origin automatically or
176
+ not.</p>
177
+ </li>
178
+ <li>
179
+ <p>A boolean flag that indicates if packages which would be installed from
180
+ this repository should be checked by their gpg key or not.</p>
181
+ </li>
182
+ <li>
183
+ <p>A numeric value for a priority. The priority of a repository is compared
184
+ to the priorities of all other activated repositories. Values can
185
+ range from 1 (highest) to 99 (lowest, default).</p>
186
+ </li>
187
+ <li>
188
+ <p>users</p>
189
+ </li>
190
+ </ul>
191
+ <p>Contains information about the system users including user and group ids,
192
+ login information, such as password hashes and - if available - additional
193
+ password properties.</p>
194
+ <ul>
195
+ <li>groups</li>
196
+ </ul>
197
+ <p>Contains information about the system groups such as group attributes and the
198
+ list of group members.</p>
199
+ <ul>
200
+ <li>services</li>
201
+ </ul>
202
+ <p>Services are applications running in the background doing continuous work
203
+ or waiting for requests to do work.
204
+ The scope determines which services are configured to be started in which
205
+ runlevel. It uses the <code>chkconfig</code> command to obtain that information.
206
+ 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>
208
+ <ul>
209
+ <li>config_files</li>
210
+ </ul>
211
+ <p>Contains all configuration files which have been changed since they were
212
+ installed.
213
+ Configuration files are all those files which are marked as such in the
214
+ package which has installed them. A configuration file change is reported
215
+ if its content or its attributes like Linux permission bits or ownership
216
+ have changed.</p>
217
+ <ul>
218
+ <li>changed_managed_files</li>
219
+ </ul>
220
+ <p>Contains the names and contents of all non-configuration files which have
221
+ been changed compared to the files in the package. A file change is reported
222
+ if its content or its attributes like Linux permission bits or ownership
223
+ have changed.</p>
224
+ <ul>
225
+ <li>unmanaged_files</li>
226
+ </ul>
227
+ <p>Contains the names and contents of all files which are not part of any RPM
228
+ package. The list of unmanaged files contains only plain files and
229
+ directories. Special files like device nodes, named pipes and Unix domain
230
+ sockets are ignored. The directories <code>/tmp</code>, <code>/var/tmp</code>, <code>/.snapshots/</code>,
231
+ <code>/var/run</code> and special mounts like procfs and sysfs are ignored, too.
232
+ If a directory is in this list, no file or directory below it belongs to a
233
+ RPM package.</p>
234
+ <p>Meta data information of unmanaged files is only available if the files were
235
+ extracted during inspection.</p>
236
+ <p>Using the <code>--extract-unmanaged-files</code> option, the files are transferred from
237
+ the system and stored in the system description. Depending on the content of
238
+ the inspected system, the amount of data stored may be huge.</p>
239
+ </div>
240
+ </div>
241
+ </body>
242
+ </html>