1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
|
<section id="features">
<title>Features</title>
<para>&aoc; features can be divided into two main categories. Basically, the <emphasis>Create</emphasis> category is used to create
a CD/DVD repository with packages previously downloaded with apt-get tools while the <emphasis>Restore</emphasis> category has functions related
to restoring packages using the previously created &aoc; media (as a local repository).</para>
<itemizedlist>
<listitem><para>Create</para>
<itemizedlist>
<listitem><para><link linkend="create">Create &aoc;</link></para></listitem>
<listitem><para><link linkend="download">Download repositories</link></para></listitem>
</itemizedlist>
</listitem>
<listitem><para>Restore</para>
<itemizedlist>
<listitem><para><link linkend="restore-aoc">Restore from APTonCD</link></para></listitem>
<listitem><para><link linkend="restore-iso">Restore .iso image</link></para></listitem>
<listitem><para><link linkend="restore-repo">Add CD/DVD</link></para></listitem>
</itemizedlist>
</listitem>
</itemizedlist>
<!-- -->
<section id="create">
<title>Create &aoc;</title>
<sec2>
<title>Action</title>
<para>Create a removable repository with all packages downloaded with Synaptic, apt-get or aptitude.</para>
</sec2>
<sec2>
<title>Features</title>
<para>
<varlistentry>
<term><guimenuitem>Select packages</guimenuitem></term>
<listitem><para>By default, all packages saved in the /var/cache/apt/archives/ directory are listed and the latest versions are checked.
You can choose which packages won't be saved on the &aoc; media by just un-checking them from this list.
When you remove a package the total file size is automatically updated.</para>
<para> When in the package list screen, a right mouse click will bring up options for quick manipulation of the selections.
All of the packages may be selected or deselected and the current selection list can be inverted.
'Remove package' tidies up the list by no longer displaying that package.
Control-click and shift click are not supported. </para>
<para>To find a package, to save having to scroll through a long list of packages, a search box is provided. This will
pop-up when you start typing in the package list window and will show the first partial match. To find
the next matching occurence press the down arrow.</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Add packages</guimenuitem></term>
<listitem><para>It's possible to add other deb packages inside the &aoc; media, even those that weren't installed using
the apt-get tools. There are two ways to do this: </para>
<para>You can use the <guibutton>Add Package...</guibutton> button,
then find and open the deb package you want to add. Within the 'Add package' window, you can use Ctrl-click and Shift-click
to select multiple packages.</para>
<para>The other way to add packages is to simply drag-and-drop the package from <application>Nautilus</application> to the &aoc; window.
It's possible to add multiple packages at same time using either method.
</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Destination folder</guimenuitem></term>
<listitem><para>The image generated by &aoc; is saved in the /home/USER directory by default. You can change
this using the 'destination folder' option to select another place to save the files.
APTonCD doesn't allow you to select a directory where you have not permission to write.</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Burn image</guimenuitem></term>
<listitem><para>When an &aoc; image is successfully created, an option is displayed to burn this image onto the previously
selected media. If you prefer, you can burn it later using your favorite program.</para></listitem>
</varlistentry>
</para>
</sec2>
<sec2>
<title>Options</title>
<para>
<varlistentry>
<term><guimenuitem>Media Type</guimenuitem></term>
<listitem><para>You can choose what type of media is created. The options are CD (690 MB) and DVD (4500MB).
If the total size of the packages is bigger than the media capacity,
&aoc; will automatically split it up into the necessary number of files (you can see this number above
the package box, along with the total number of files and total file size).</para>
<para>The required number of CDs (or DVDs) is shown below the package list screen. This switches between CD
or DVD count based on the option selected.
</para>
<!-- Insert file screenshot-create_APTonCD.png here
<mediaobject>
<imageobject>
<imagedata fileref="images/screenshot-create_APTonCD.png" format="PNG"/>
</imageobject>
<textobject>Creating package screen</textobject>
</mediaobject> -->
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Filename</guimenuitem></term>
<listitem><para>If the filename is left blank, by default &aoc; images are named using the the follow format: 'aptoncd-yyyymmdd-MMX.iso' where (yyyy)
is the year, (mm) the month and (dd) the day. (MM) denotes the chosen media, which can be 'CD' or 'DVD' and X stands for
the number of the image if more than one media is created. For example: aptoncd-20061030-CD1.
You can choose a different filename for the image(s) using the file box - this replaces the
'aptoncd' part of the name.</para>
<para></para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Metapackage</guimenuitem></term>
<listitem><para>The Metapackage option creates a package named 'aptoncd-metapackage' that includes all of the other packages on
the APTonCD media as dependencies. It's useful for easily restoring all packages along with their dependencies,
so you can just install the metapackage instead of installing
each package by hand. The default is to have this selected.</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry id="autodependencies">
<term><guimenuitem>Auto-select dependencies</guimenuitem></term>
<listitem><para>This option guarantees that all dependencies of a package are selected.
The default is selected.</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry id="oldversions">
<term><guimenuitem>Insert old versions of the same same package</guimenuitem></term>
<listitem><para>This option enables &aoc; to include several versions of same package on the media.
If it is selected together with the 'Metapackage' option, just the newer version of each
package is included in the metapackage.</para>
<para> </para>
</listitem>
</varlistentry>
</para>
</sec2>
<para>(<link linkend="features">back to top</link>)</para>
</section>
<!-- -->
<!-- -->
<section id="download">
<title>Download repositories (Unstable!)</title>
<emphasis>The Download Repository module is a little unstable in this release. It was
disabled in the APTonCD GUI and only can be called by command line (--download). Use with your own risk.</emphasis>
<sec2>
<title>Action</title>
<para>This downloads complete Ubuntu repositories from the internet,
creating locally stored versions on CD, DVD or iso image files.</para>
<para>Given the size of some of the repositories this may take
a long time, even with a fast internet connection. It is not recommended from a dial-up modem connection.</para>
<para>Any of the standard Ubuntu repositories may be downloaded - Main, Restricted, Universe or Multiverse.
At the moment, &aoc; does not support downloading unofficial repositories</para>
</sec2>
<sec2 id="download-features">
<title>Features</title>
<para>
<varlistentry>
<term><guimenuitem>Autodetection</guimenuitem></term>
<listitem><para> &aoc; detects automatically the distribution and version of your operational system
and also the architecture of your computer. This information will be used as option defaults,
but you can easily change them if you want to.</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Download resume</guimenuitem></term>
<listitem><para> If the repository download is interrupted for whatever reason,
if you run it again, the download will resume from where it left off.
Packages that were successfully downloaded before the interruption won't be downloaded again.</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Download progress</guimenuitem></term>
<listitem><para> During the download a progress window is displayed
showing the total file size of the download, the number of files downloaded (including the file currently being
downloaded, total number of files in the download and the estimated time remaining. The progress of individual
files can also be shown.</para></listitem>
</varlistentry>
</para>
</sec2>
<sec2>
<title>Options</title>
<para>
<varlistentry>
<term><guimenuitem>Distribution</guimenuitem></term>
<listitem><para> &aoc; can download Ubuntu or Debian repositories
(the default option is the system you're using).</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Version</guimenuitem></term>
<listitem><para>You can select the Ubuntu (or Debian) version you want to download.
All Ubuntu versions that are officially supported are listed.</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Architecture</guimenuitem></term>
<listitem><para> &aoc; allows you to download repositories available for
several architectures: i386, amd64, powerpc and sparc.
You don't need to change any of the selections, unless you know exactly what you're doing :-).</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Sections</guimenuitem></term>
<listitem><para>You can choose multiples repositories to download. If you're using Ubuntu
the options are: main, restricted, universe and multiverse.</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Advanced options - Method</guimenuitem></term>
<listitem><para>&aoc; can download repositories using two methods: http or ftp. Http is the default
and unless you experience some connection problems you don't need to change this option.</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Advanced options - Mirror</guimenuitem></term>
<listitem><para>Ubuntu and Debian repositories are distributed among several mirrors.
By default Universal is selected but you can choose a closer mirror (and the download will probably
be faster). Once you select a different mirror &aoc; stores your preference for
future downloads.</para> <para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Advanced options - Media Type</guimenuitem></term>
<listitem><para>You can choose what type of media is created.
The options are CD (690 MB) and DVD (4500MB). If the total size of the packages
is bigger than the media capacity, APTonCD will automatically split it up into
the necessary number of files.</para>
<para>As the package sizes are in the Gigabytes, it's recommended that you use DVD's.</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Advanced options - Temp directory</guimenuitem></term>
<listitem><para>The temp directory is used by &aoc; to store the downloaded files.
</para>
<para> </para>
</listitem>
</varlistentry>
</para>
</sec2>
<para>(<link linkend="features">back to top</link>)</para>
</section>
<!-- -->
<section id="restore-aoc">
<title>Restore APTonCD</title>
<sec2>
<title>Action</title>
<para>Restore from media (CD or DVD) created by &aoc;</para>
<para>
<para><emphasis>Notes:</emphasis></para>
<itemizedlist>
<listitem><para>This action requires administrative privileges.</para></listitem>
<listitem><para>It's not possible to restore from an &aoc; media created using a different distribution/version
from the one you're using now. If the media is a downloaded repository, the version downloaded must match the operating system version
you are using.</para></listitem>
</itemizedlist>
</para>
</sec2>
<sec2>
<title>Features</title>
<para>
<varlistentry>
<term><guimenuitem>Open media</guimenuitem></term>
<listitem><para>The first step is to put the CD/DVD created by &aoc; in the drive.</para>
<para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Select packages</guimenuitem></term>
<listitem><para>When the media is read, a list showing all available packages that can be restored is displayed.
By default all packages are selected, but you can just un-check the packages you don't want to restore. If you just
wish to restore one package, right click in the package window and select uncheck all, then select the package you want.</para>
<para>To find a particular package, to save having to scroll through a long list of packages, a search box is provided. This will
pop-up when you start typing in the package list window and will show the first partial match. To find
the next matching occurence press the down arrow.</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Copy files</guimenuitem></term>
<listitem><para>The selected packages are copied from the &aoc; media to the /var/cache/apt/archives/ directory.
This way the packages are available and can be installed using apt-get, aptitude or synaptic without needing to download them.</para>
<para> </para>
</listitem>
</varlistentry>
</para>
</sec2>
<sec2>
<title>Options</title>
<para>
<varlistentry>
<term><guimenuitem>Insert old versions of the same same package</guimenuitem></term>
<listitem><para>By default just the newer versions of packages are restored. If you want to include old versions, just check
the option below the packages' list.
<para>Refer to how to put old versions on an &aoc; media <link linkend="oldversions">here</link>.</para>
</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Auto-select dependencies</guimenuitem></term>
<listitem><para>This option guarantees that all dependencies of the selected packages are also selected to be restored.
<para>To see how to auto-select dependencies when creating an &aoc; media, refer <link linkend="autodependencies">here</link>.</para>
</para>
</listitem>
</varlistentry>
</para>
</sec2>
<para>(<link linkend="features">back to top</link>)</para>
</section>
<!-- -->
<section id="restore-iso">
<title>Restore .iso image</title>
<sec2>
<title>Action</title>
<para>Restore an ISO image created by &aoc;, similar to <link linkend="restore-aoc">Restore APTonCD</link> option.</para>
<para>
<para><emphasis>Notes:</emphasis></para>
<itemizedlist>
<listitem><para>This action requires administrative privileges.</para></listitem>
<listitem><para>It's not possible to restore from an &aoc; image created using a different distribution/version
from the one you're using now. If the image is a downloaded repository, the version downloaded must match the operating system version
you are using.</para></listitem>
</itemizedlist>
</para>
</sec2>
<sec2>
<title>Features</title>
<para>
<varlistentry>
<term><guimenuitem>Open image</guimenuitem></term>
<listitem><para>The first step is to find and select the .iso file you want to restore.</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Select packages</guimenuitem></term>
<listitem><para>When you select and open an image it's shown as a list of all packages available to restore.
By default all packages are selected, but you can just un-check the packages you don't want to restore.
If you just wish to restore one package, right click in the package window and select uncheck all, then select the package you want.</para>
<para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Copy files</guimenuitem></term>
<listitem><para>When you restore an ISO image created by &aoc; the image is mounted and then all the selected packages
are copied back to the /var/cache/apt/archives/ directory. This way the packages are available and you can install
them using apt-get, aptitude or synaptic without needing to download them.</para></listitem>
</varlistentry>
</para>
</sec2>
<sec2>
<title>Options</title>
<para>
<varlistentry>
<term><guimenuitem>Insert old versions of the same same package</guimenuitem></term>
<listitem><para>By default just the newer versions of packages are restored. If you want to include old versions just check
the option above the packages' list.
<para>See also how to put old versions inside an &aoc; media <link linkend="oldversions">here</link>.</para>
</para>
<para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Auto-select dependencies</guimenuitem></term>
<listitem><para>This option guarantees that all dependencies of the selected packages are also selected for restoration.
<para>Also see how to auto-select dependencies when creating an &aoc; media <link linkend="autodependencies">here</link>.</para>
</para>
</listitem>
</varlistentry>
</para>
</sec2>
<para>(<link linkend="features">back to top</link>)</para>
</section>
<!-- -->
<section id="restore-repo">
<title>Add CD/DVD</title>
<sec2>
<title>Action</title>
<para>Add a CD/DVD created by &aoc; as a repository for apt-get tools. This adds the CD/DVD so that it can
subsequently be used as an off-line software source.
<para></para>
<para><emphasis>Note:</emphasis> This action requires administrative privileges.</para>
</para>
</sec2>
<sec2>
<title>Features</title>
<para>
<varlistentry>
<term><guimenuitem>Add as repository v's Restore &aoc; or .iso image</guimenuitem></term>
<listitem><para>The main difference between "Add a CD/DVD as repository" and <link linkend="restore-aoc">restore &aoc;
</link> (or<link linkend="restore-iso"> restore .iso image</link>) is that using either of the restore options, all packages are copied back to
the hard disk while, in the first case (Add CD/DVD), the packages are read directly from the CD/DVD when you use an apt-tool to install
packages.
</para>
<para> </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Open media</guimenuitem></term>
<listitem><para>The first step is to put the CD/DVD created by &aoc; in the drive.</para>
<para> </para></listitem>
</varlistentry>
</para>
</sec2>
<para>(<link linkend="features">back to top</link>)</para>
</section>
<!-- -->
<!--
-->
</section>
|
