1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
|
<html>
<!--http://www.phys.ethz.ch/~franklin/Projects/dphys-config/index.html.en-->
<head>
<title>dphys-config Configuration Manager</title>
<meta name="keywords"
content="neil franklin, ETH, dphys-config, Linux, configuration">
<meta name="description"
content="dphys-config configuration manager">
</head>
<body>
<a href="../../index.html.en">Home</a> |
<a href="../index.html.en">Projects</a> | dphys-config
<hr>
<h2>dphys-config Configuration Manager</h2>
<a href="#basics">Project Basics</a><br>
<a href="#status">Project Status</a><br>
<a href="#download">Code Download</a><br>
<a href="#links">External Stuff (Links)</a><br>
<a name=basics></a>
<h3>Project Basics</h3>
This project is aimed at installing (and keeping update) the site specific
config files we want, after preprocessing them (conditional content and
include files and include sections). It also triggers an postinstall script
whenever its associated config file has been changed. It can also remove
config files, including running an preremove script before doing so. All
this is driven by an simple config file list.
<p>
This project has produced an <a href="dphys-config">dphys-config</a> script
for doing the work. And an <a href="cron.d.example">cron job</a> and an
<a href="init.d.example">init.d script</a> that run this script nightly and
at boot time.
<p>
This project was spawned from the <a href="../dphys-admin/">dphys-admin
project</a>, aimed at automatically installing Debian packages onto our
systems, but is itsself independant of dphys-admin or any other Debian
stuff. It should work on any Unix system, but has only been tested on our
Debian Linux 3.1 (sarge) systems and on FreeBSD 6.1.
<a name=status></a>
<h3>Project Status</h3>
For the full details of done/doing/todo of the project best read the
<a href="Logfile">Logfile</a>. A short excerpt from it is here:
<p>
<h4>Done are:</h4>
Milestone/Release 1 (2006.09.15):
<ul>
<li>Fetch config file list, host dependant</li>
<li>Fetch config files driven by above, host dependant</li>
<li>Merge in host or group dependant "include" files or "if" lines to
files</li>
<li>Install/update config file where it belongs, if it is new or has
changed</li>
<li>Run an postinstall script if config file was installed/updated</li>
<li>Run an preremove script if a config file shall disappear</li>
<li>Remove unwanted config files</li>
<li>Allow non-root to use dphys-config to distribute dot files</li>
</ul>
Milestone/Release 2 (2006.10.20):
<ul>
<li>Bugfix non-root mode to actually work, no writing into /etc/</li>
<li>Changed to also work with newer sed comming with in Debian sid</li>
<li>Linked to official Debian package in sid (will become etch)</li>
<li>Code and documentation tidy ups, some from early feedback</li>
<li>Extensive quoting improvements against possible escaping bugs</li>
<li>Path handling and other changes to work also on FreeBSD 6.1</li>
</ul>
Current (= development, = may be broken):
<ul>
<li>Nothing yet</li>
</ul>
<h4>Todo are:</h4>
<ul>
<li>Nothing planned</li>
</ul>
<a name=download></a>
<h3>Code Download</h3>
Current (= development, = may be broken):
<ul>
<li><a href="INSTALL">
Installation Guide</a></li>
<li>entire project: <a href="../dphys-config.tar.gz">
dphys-config.tar.gz</a></li>
<li>single files:<ul>
<li><a href="Makefile">
Makefile</a>, control process</li>
<li><a href="dphys-config">
dphys-config</a>, automatically install/update config files and run
scripts, run by cron or init</li>
<li><a href="dphys-config.1">
dphys-config.1</a>, man page for dphys-config</li>
<li><a href="dphys-config.example">
dphys-config.example</a>, example config file, containing only the
default settings as comments, to adapt to your site</li>
<li><a href="site.example">
site.example</a>, example site config, containing an <a
href="site.example/dphys-config.list"
>list of files to process</a>, together with example files used in
this list, some of which are quite usefull scripts (<a
href="site.example/dphys-config-filesys.list"
>expand /etc/fstab</a>, <a
href="site.example/local/sbin/dphys-config-exports"
>generate /etc/exports from fstab</a>, <a
href="site.example/local/sbin/dphys-config-quota"
>setup quota from fstab</a>, <a
href="site.example/local/sbin/dphys-config-usb-storage"
>expand /etc/modules for USB storage</a>, <a
href="site.example/local/sbin/dphys-config-x"
>generate XFree config from simple description</a>)</li>
<li><a href="cron.d.example">
cron.d.example</a>, example cron job to run dphys-config every night,
for automatic updates</li>
<li><a href="init.d.example">
init.d.example</a>, example init.d script to run dphys-config every
boot, to catchup on missed automatic updates</li>
</ul></li>
</ul>
Milestone/Release 2 (2006.10.20):
<ul>
<li><a href="../dphys-config-20061020/INSTALL">
Installation Guide</a></li>
<li>entire project: <a href="../dphys-config-20061020.tar.gz">
dphys-config.tar.gz</a></li>
<li>single files:<ul>
<li><a href="../dphys-config-20061020/Makefile">
Makefile</a>, control process</li>
<li><a href="../dphys-config-20061020/dphys-config">
dphys-config</a>, automatically install/update config files and run
scripts, run by cron or init</li>
<li><a href="../dphys-config-20061020/dphys-config.1">
dphys-config.1</a>, man page for dphys-config</li>
<li><a href="../dphys-config-20061020/dphys-config.example">
dphys-config.example</a>, example config file, containing only the
default settings as comments, to adapt to your site</li>
<li><a href="../dphys-config-20061020/site.example">
site.example</a>, example site config, containing an <a
href="../dphys-config-20061020/site.example/dphys-config.list"
>list of files to process</a>, together with example files used in
this list, some of which are quite usefull scripts (<a
href="../dphys-config-20061020/site.example/dphys-config-filesys.list"
>expand /etc/fstab</a>, <a
href="../dphys-config-20061020/site.example/local/sbin/dphys-config-exports"
>generate /etc/exports from fstab</a>, <a
href="../dphys-config-20061020/site.example/local/sbin/dphys-config-quota"
>setup quota from fstab</a>, <a
href="../dphys-config-20061020/site.example/local/sbin/dphys-config-usb-storage"
>expand /etc/modules for USB storage</a>, <a
href="../dphys-config-20061020/site.example/local/sbin/dphys-config-x"
>generate XFree config from simple description</a>)</li>
<li><a href="../dphys-config-20061020/cron.d.example">
cron.d.example</a>, example cron job to run dphys-config every night,
for automatic updates</li>
<li><a href="../dphys-config-20061020/init.d.example">
init.d.example</a>, example init.d script to run dphys-config every
boot, to catchup on missed automatic updates</li>
</ul></li>
</ul>
Milestone/Release 1 (2006.09.15):
<ul>
<li><a href="../dphys-config-20060915/INSTALL">
Installation Guide</a></li>
<li>entire project: <a href="../dphys-config-20060915.tar.gz">
dphys-config-20060915.tar.gz</a></li>
<li>single files:<ul>
<li><a href="../dphys-config-20060915/Makefile">
Makefile</a>, control process</li>
<li><a href="../dphys-config-20060915/dphys-config">
dphys-config</a>, automatically install/update config files and run
scripts, run by cron or init</li>
<li><a href="../dphys-config-20060915/dphys-config.1">
dphys-config.1</a>, man page for dphys-config</li>
<li><a href="../dphys-config-20060915/dphys-config.example">
dphys-config.example</a>, example config file, containing only the
default settings as comments, to adapt to your site</li>
<li><a href="../dphys-config-20060915/site.example">
site.example</a>, example site config, containing an <a
href="../dphys-config-20060915/site.example/dphys-config.list"
>list of files to process</a>, together with example files used in
this list, some of which are quite usefull scripts (<a
href="../dphys-config-20060915/site.example/dphys-config-filesys.list"
>expand /etc/fstab</a>, <a
href="../dphys-config-20060915/site.example/local/sbin/dphys-config-quota"
>setup quota</a>, <a
href="../dphys-config-20060915/site.example/local/sbin/dphys-config-usb-storage"
>expand /etc/modules for USB storage</a>, <a
href="../dphys-config-20060915/site.example/local/sbin/dphys-config-x"
>generate XFree config from simple description</a>)</li>
<li><a href="../dphys-config-20060915/cron.d.example">
cron.d.example</a>, example cron job to run dphys-config every night,
for automatic updates</li>
<li><a href="../dphys-config-20060915/init.d.example">
init.d.example</a>, example init.d script to run dphys-config every
boot, to catchup on missed automatic updates</li>
</ul></li>
</ul>
<a name=links></a>
<h3>External Stuff (Links)</h3>
Various links that may be usefull:
<ul>
<li><a href="http://www.phys.ethz.ch/~franklin/Projects/dphys-admin/">
dphys-admin project this project was spawned from</a></li>
<li><a href="http://packages.debian.org/dphys-config">
official Debian Package of dphys-config</a></li>
</ul>
<hr>
<a href="../../index.html.en">Home</a> |
<a href="../index.html.en">Projects</a> | dphys-config
<p>
This page is by Neil Franklin, last modification 2006.10.20
</body>
</html>
|
