Usage instructions

Requirements:

Preparation
  1. Unpack distort scripts to the hard disk
  2. Copy entire FC3 DVD into a single directory (make sure "hidden" files like ".discinfo" are copied) - source dir
  3. Create another directory with FC3 DVD contents (whe one which is going to be tweaked) - destination dir
  4. Edit "base.inc" file of distort project to define your personal data like publisher, email , ...
  5. Create your subproject configuration directory by copying sample "FC3_tweak" subdirectory under another name
  6. In new subdirectory edit config.inc file to define differnt directories
  7. In new subdirectory edit create files named "rm_*.txt" which list RPMs that are going to be removed from distribution
  8. 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)
  9. Create/define your "add" directory containing new RPM files that are going to be added in the distro
  10. 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:
  1. Checking the Build Environment
  2. Add/Remove RPMs using configuration lists
  3. Add new (local) RPMs
  4. Update RPMs to latest version from FTP repository
  5. Check RPM dependencies
  6. Check duplicate RPM versions
  7. Update comps.xml
  8. Rebuild comps RPM
  9. Rebuild rpmdb RPM
  10. Generate apt/yum repository metadata
  11. Generate metadata and DVD ISO
  12. 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.


SourceForge.net Logo