Usage
instructions
Requirements:
- original Fedora Core 3 installation DVD
- PC with FC3 installed having at least 10 GB of free HDD space
- installed anaconda and anaconda-runtime RPM packages
- optionally installed apt,
yum and createrepo packages (for repository
generation)
Preparation
- Unpack distort scripts to the hard disk
- Copy entire FC3 DVD into a single directory (make sure "hidden"
files like ".discinfo" are copied) - source dir
- Create another directory with FC3 DVD contents (whe one which is
going to be tweaked) - destination dir
- Edit "base.inc" file of distort project to define your personal
data like publisher, email , ...
- Create your subproject configuration directory by copying sample
"FC3_tweak" subdirectory under another name
- In new subdirectory edit config.inc file to define differnt
directories
- In new subdirectory edit create files named "rm_*.txt" which list
RPMs that are going to be removed from distribution
- You can create "add_*.txt" list file if you prefer add logic
instead of remove logic (only one type of logic can be used in the
single project)
- Create/define your "add" directory containing new RPM files that
are going to be added in the distro
- Start the script with config file as a parameter "./distort.sh
./pr_fc3_tweak/config.inc"
Usage
Scripts can be configured to run in menu mode
or in automatic mode (by setting exec_auto=1)
Menu provides following steps in editing
distribution:
- Checking the Build Environment
- Add/Remove RPMs using configuration lists
- Add new (local) RPMs
- Update RPMs to latest version from FTP repository
- Check RPM dependencies
- Check duplicate RPM versions
- Update comps.xml
- Rebuild comps RPM
- Rebuild rpmdb RPM
- Generate apt/yum repository metadata
- Generate metadata and DVD ISO
- Generate distribution statistics (rpms list, ...)
1. Checking the Build Environment
- checks if the anaconda and anaconda-runtime are
installed
2. Add/Remove RPMs using configuration lists
- this step removes all RPMs listed in "rm_*.txt"
files
3. Add new (local) RPMs
- copies all RPMs from "add" directory into the
distro destination directory
4. Update RPMs to latest version from FTP repository
- this step is not tested yet,
and it uses apt-get to update all present RPM
packages to a newer version
5. Check RPM dependencies
- this is important step that verifies if your
distro has RPM dependency problems.
You should read the printouts and
resolve any dependency problem (like to add new package that other
package depends of). After any changes repeat this step, until all the
dependency problems are being resolved.
6. Check duplicate RPM versions
- here you can check if your new distro has any
duplicate RPMs (like multiple versions of the same RPM or multiple
builds like i386 and i686)
7. Update comps.xml
- this step currently removes package entries from
comps.xml, for each package that was removed from the distribution
8. Rebuild comps RPM
- here you rebuild comps RPM to put latest
coms.xml file into the RPM
9. Rebuild rpmdb RPM
- here you rebuild rpmdb to make its database
up to date (to contain only packages that are present in your new
distro)
10. Generate apt/yum repository metadata
- generate data needed to enable DVD media to act
like apt and yum repository
11. Generate metadata and DVD ISO
- this is final step, it actually generates
new distribution ISO file that can be burned on to DVD media.
12. Generate distribution statistics (rpms list, ...)
- this is a helper step to generate text file with
list and description of all RPM files present in the new distribution.