Archived UBLinux Files and Build Notes for UBLinux 4

Reference to backed up files on cithome and a general outline and note set on how UBLinux 4 is built, and also contains information on packaging the upgrade tarballs containing the UBLinux specific RPMS.

Archived files

All pertinent UBLinux data/script files are archived on UBFS. They are accessible from the 'citlinux' UBUNIX account:
cd ~/ubfs_data/mm238_archive

Archive directory descriptions

• docs
  Any drafts of Linux documentation, as well as internal notes, writeups, and other statistics

• perl
  Perl and shell scripts written both for distro as well as customers who requested them. See 'README' file in that directory for a description of these scripts

• ub_disc1_files
  All UBLinux specific build files needed to complete the customized ISO set from RHEL WS. It contains kickstart files, customized isolinux, as well as the postconfig scripts and packages

• upgrade_tarball_files
  Scripts/RPM tree to create upgrade tarballs. The upgrade_tarball.sh script creates a tarball to use to add UBLinux packages to RHEL. It depends on the UBLinux4_upgrade_files and disc1 dir. The UBLinux4.0-4.5 dir is used to create an updater to update to the current UBLinux version from version 4.0

Building UBLinux

• 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 and repackage
• On build system, follow instructions to build distro
  • Build Guide
  • 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 - as per guide
  • Customizing Anaconda
  
  
  • Modify dhcp.ks.cfg and ppp.ks.cfg
    • Currently reside in the ub_disc1_files dir
    • ensure that UB specific packages are listed to be installed (or else installer skips them!)
    • See kickstart section of guide
  
  
  • Modify the isolinux files in the ub_disc1_files/isolinux/ dir to reflect UBLinux versions, kickstarts, and authors, as per the guide
  • Editing the Boot Image


• Copy kickstart & isolinux files to the disc1 dir
  cp ub_disc1_files/*.ks.cfg disc1/
  cp -fr ub_disc1_files/isolinux disc1/


• Build ISO files and implant checksum as per the guide
  • Making the ISOs

Building Upgrade Tarballs

RHEL WS to UBlinux 4 Upgrade

• This upgrade tarball installs the RPMs via the postinstall scripts

  • RPM tree stored in upgrade_tarball_files/disc1/ub-postconfig/RPMs
  • Add upgraded/new RPMs to RPMs/package_name
  • Ensure that the "install" file in each package dir will install the desired package

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

• Run build script to generate the tarball:
  sh upgrade_tarball_files/upgrade_tarball.sh

UBLinux 4.0 to 4.x Upgrade

• This tarball is for users who have an older version of UBLinux, and want to upgrade without a full re-install. This tarball will install any packages that have been added to the distro since the original release

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

• Rename DIR to appropriate new UBlinux version
  mv UBLinux4.0-4.5 UBLinux4.0-4.x

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

  • Also make sure all rpms carried over from last updater are of the latest/current versions

• Edit UBLinux4.0-4.x/upgrade.sh to reflect new version # and new packages

  • Any command in script should be followed by | tee -a $LOGFILE to ensure proper logging
    

    
    ...
    echo "" |tee -a $LOGFILE
    echo "Installing Inkscape vector graphics program" |tee -a $LOGFILE
    echo "" |tee -a $LOGFILE
    
    rpm -Uvh rpms/inkscape*.rpm | tee -a $LOGFILE
    ...
    
    

  • TODO: convert to script utility for logging instead of using tee for each command

• Compress entire dir into tarball:
  tar zcvf UBLinux4.0-4.x-upgrade.tar.gz UBLinux4.0-4.x

Adding RHEL ISO images to download site

• All ISO images stored on redhat1.buffalo.edu

  • /var/www/html/pub/rhel/

• Create appropriate directory structure for new version. e.g.:
  cd /var/www/html/pub/rhel
  mkdir -p rhel5client/x86_64

• Use curl or wget to download ISO files. e.g.:
  cd rhel5client/x86_64
  wget -c 'http://URL_TO_FILE_COPIED_FROM_RHN_WEBSITE.iso'

• Verify file integrity using the gen_md5s.sh script.

  • Will ask for MD5 checksum for each ISO file in the directory, and generate a single checksum file.
  • If any fail, can rerun and give filename as parameter
  • sh ~/gen_md5s.sh
  • sh ~/gen_md5s.sh FILENAME.iso

• Generate HTML code: use the rhd_indiv.pl script

  • Stored in perl/rhd_indiv.pl
  • Will create a HTML file rhd_indiv.html - copy/paste the code generated into rheldownload.html
  • NOTE: This script needs to be modified to be compatible for RHEL5 ISO's, as naming structure is different
  • Can copy/paste file size and checksums manually if you don't want to use the script

---

Technical Documentation Index
Send questions or comments to ublinux-support@buffalo.edu

Last Modified 4/25/07