UBLinux 4 Distro Build Guide
===========================

Author: Matt Miller <mm238@buffalo.edu>
Original Draft: 4/24/07

Main UBLinux Build
==================

--Build UB specific packages on CLEAN base system(probably RHEL 4 WS)
	Current RPMs and SPEC files are stored at http://redhat1.buffalo.edu/pub/testing/ublinux4/
	Symlinked as 'ublinux4_testing' from /home/dudek on redhat1.buffalo.edu

--Upload RPMS to /var/www/html/pub/testing/ublinux4/RPMS on redhat1, specs to /var/www/html/pub/testing/ublinux4/SPECS
	 --Push to RHN channel: sudo /usr/bin/rhn_package_manager -cublinux4 -cublinux4-as -cublinux4-es PACKAGE_NAME

--HTTrack the lastest UBLinux docs from ubit site
	  --Package them up

--On build system, follow instructions to build distro:
     http://wings.buffalo.edu/computing/ublinux/

     --Copy custom UB RPMS to the DIR with RedHat RPMS before building the distro
	    cp ~/RPMBUILDS/RPMS/packagename.rpm  i386/RedHat/RPMS/
	    DON'T put VPNClient, ublinux-docs, or iptables rules in main RPM tree
	    Put those into the appropriate dir in ub_disc1_files/ub-postconfig/RPMs

     --After running splittree.py(as per build guide), copy the entirte ub-postconfig DIR to the disc4 directory

--Build stage2.img to include installation graphics and help files
	--Copy in new stage2.img to disc1/RedHat/base (as per guide)

--Modify dhcp.ks.cfg and ppp.ks.cfg
	 --in the ub_disc1_files dir
	 --ensure that UB specific packages are listed to be installed (or else installer skips them!)

--Copy kickstart files to disc1 

--Copy isolinux dir in ub_disc1_files to disc1

--NOTE: Existing extracted stage2.img (with UB graphics and docs) is in ub_disc1_files
	Existing customized isolinux dir is also in ub_disc1_files

--Follow build guide to create ISO images and implant checksums


Building Upgrade Packages
=========================

	RHEL WS to UBLinux 4 upgrade:
	----------------------------

--RHEL WS to UBLinux 4 uses the original full postinstall process
       --Data currently stored in upgrade_tarball_files/disc1/ub-postconfig

--Upgrade entire RPM tree in upgrade_tarball_files/disc1/ub-postconfig/RPMs with new RPMs

--Edit upgrade_tarball_files/upgrade_tarball.sh to reflect new version # of UBLinux

--Run package build script:
      upgrade_tarball_files/upgrade_tarball.sh
      --Will create the tarball including install script


      UBLinux 4.0 to 4.x upgrade
      -------------------------

--Data currently in upgrade_tarball_files/UBLinux4.0-4.5

--Rename DIR to appropriate new UBlinux version

--Copy any new packages in UBLinux 4.x not in 4.0 to  UBLinux4.0-4.x/rpms

--Edit UBLinux4.0-4.x/upgrade.sh to reflect new version # and any new packages copied in
       --Pipe all commands to tee: | tee -a $LOGFILE
       --(TODO: instead of using tee for all commands, maybe use 'script' utility at the beginning, like we do for VPN logging)

--Compress entire UBLinux4.0-4.x as UBLinux4.0-4.x-upgrade.tar.gz


Adding RHEL images to download site on redhat1
==============================================

--Use curl or wget to save ISOs in appropriate dir(eg RHEL4WS/x86_64 for 64 bit RHEL workstation 4)

--Run gen_md5s.sh script (in 'perl' dir) which prompts for MD5 sum of each file in the dir

--If any fail, redownload, and run gen_md5s.sh ISO_FILE_NAME

--Use rhd_indiv.pl to generate the HTML code to cut/paste into rheldownload.php if you don't want to copy/paste the individual checksum
      and file sizes