[Axiom-developer] [DoyenCD] (new)

[alfredo]

Changes http://wiki.axiom-developer.org/DoyenCD/diff
--
\documentclass{article}
\usepackage{axiom}
\usepackage{graphics}
\begin{document}
\title{Doyen Build Instructions}
\author{Tim Daly, Jose Alfredo Perez,  Wilken Rivera}
\maketitle
\begin{abstract}

This document shows the explicit steps necessary to create a
Doyen LiveCD from Red Hat's Fedora Core 3 distribution. 

The Doyen CD is a scientific platform which can be distributed
at various science conferences. It enables scientific software
to be distributed as literate programs.

The Doyen CD has a local wiki and a set of scientific packages
which can be scripted from the wiki pages. The scientific packages
can be tailor to the specific conference.

\end{abstract}

\section{Prepare a clean Fedora Core 3 System}
\subsection{Overview}

\begin{itemize}

\item Obtain Fedora Core 3 iso images from the Fedora Website. 
\item Disk 1 and Disk 2 should be enough for a basic installation. 
\item Create installation CDs from the iso images downloaded.
\item Boot up you system with the installation disk 1 to begin the Fedora
installation process.

\end{itemize}

In the first screen, you will be presesented with some bootoptions. Press Enter 
to continue.

\subsection{CD Media test}

For the option to test the media CD before installation, select skip. Once the 
welcome screen comes up, proceed to click next.

\subsection{Language Selection}

In the language selection, select your prefered language and click next.

\subsection{Keyboard Configuration}

In the keyboard configuration, select your keyboard configuration.

\subsubsection{Special Case}

At this point depending if your system is not clean, an upgrade examine window 
will appear. Please select "Install Fedora Core"

\subsection{Installation Type}

In the installation type window, select "Custom".

\subsection{Disk Partioning Setup}

In the Disk Partioning Setup, select Manually partition with Disk Druid.

\subsection{Disk Setup}

Note: For our base distribution, only three partitions should be created.
A boot partition of 100 MB, a swap space generally the double of your amount of 
RAM,
and a root partition which size depends on the programs to be installed in the 
system.

\subsubsection{Boot Partition}

In the Disk setup, select new. In mount point select /boot. File system type 
ext3. Size 100 MB. 

\subsubsection{Swap Partition}

Create a swap partition. Select new. Select file system type swap, and size 512 
MB.

\subsubsection{Root Partition}

Select new. Select mount point /. Select the file system type to be: ext3. 
Select "Fill to maximum allowable size" or the size you would like for the root 
partition. 2GB should be enough. Click Ok. Click Next to finish with the Disk 
Setup menu.

\subsection{Boot Loader Configuration}

Leave the default boot loader configuration.

\subsection{Network Configuration}

Leave the DHCP option for the eth0 by default. For the Hostname, select 
manually and in the text box type doyen.

\subsection{Firewall Configuration}

Select enable firewall and enable Remote Login (SSH) and Web Server(HTTP, 
HTTPS). Also, select disable for SELinux.

\subsection{Additional Language Support}

Select your prefer language.

\subsection{Time Zone Selection}

Select your time zone location.

\subsection{Set Root Password}

Select the desire password for the root account. In our base CD the password by 
default is address@hidden

\subsection{Package Group Selection}

\begin{itemize}

\item Select default selections for X Window System section and the Gnome 
section.

\item In the editors section, select Emacs and Vim-Enhanced.

\item Select Graphical Internet and remove all packages except Firefox.

\item Select and remove all packages in text-based internet.

\item Remove all Office/Productivity packages.

\item In the Sound and video packages remove everything except cdrecord and 
mkisofs packages.

\item Remove all packages in the Graphics section.

\item Leave all the other sections unchanged and click next.

\end{itemize}

Click next to begin installation. Follow the proper prompts when asked to 
insert other media CDs. When the installation is complete, remove the CD and 
reboot your computer.

\subsection{Finishing System Installation}

\subsubsection{Welcome}

At the new Welcome screen, click next.

\subsubsection{License Agreement}

Proceed to accept the license agreement. Click next.

\subsubsection{Date and Time}

Set the proper date and time. Click next.

\subsubsection{Display}

In Display configuration, click configure and select "Generic CRT Display" with 
1024x768 resolution and color depth of Millions of colors. Click next.

\subsubsection{System User}

For the System User options, provide this information:

\begin{itemize}

\item Username: doyen.
\item Full name: Doyen user.
\item Password: address@hidden
\item Confirm Password: address@hidden

\end{itemize}

\subsubsection{Sound Card}

You can skip the sound card testing and click next.

\subsubsection{Additional CDs}

Leave this section unchanged and click next.

\subsection{Finish Setup}

Click next to complete the installation.

\subsubsection{Login Screen}

Login as root user.

\subsubsection{Services Configuration}

You need to disable unwanted system services from autoloading.

\begin{verbatim}
Click on Applications -->  System Settings --> Server Settings --> Services
\end{verbatim}

Uncheck all except: 

\begin{itemize}
\item acpid
\item anacron 
\item apmd
\item atd
\item autofs
\item crond
\item gpm
\item hadaemon
\item iptables
\item netfs
\item netplugd
\item network
\item pcmcia
\item sshd
\item syslog
\item xinetd
\end{itemize}

Click save and close the window.

\section{Customizing Live CD}
\subsection{Software Installation}

The package installation for the Doyen distribution are done by using Yum and 
Wget to obtain all the required rpm files from various locations.
The next step configures a file required for yum to search and install 
packages. Do not skip this step.
Open a terminal window.

<<step>>=

rpm --import /usr/share/rhn/RPM-GPG-KEY-fedora

@

\subsection{Update System}

You need to update the current packages installed in your system. Proceed to do 
a yum update. This step may take a while.

<<step>>=

yum -y update

@

\subsubsection{Latex}

To install the Latex software package you need to use yum and install tetex, 
tetex-latex, and tetex-xdvi packages.

<<step>>=

yum -y install tetex

yum -y install tetex-latex

yum -y install tetex-xdvi

@

\subsubsection{Noweb Software Package}

Create a /tmp/pkgs directory which will contain those packages that are not 
available using Yum, but that are going to be obtained using Wget.

<<step>>=

mkdir /tmp/pkgs

cd /tmp/pkgs

wget ftp://ftp.sylvan.com/pub/noweb/noweb-2.10a-1.i386.rpm

wget ftp://ftp.sylvan.com/pub/noweb/Icon2-9.3.2-7.i386.rpm

rpm -ivh Icon2-9.3.2-7.i386.rpm

rpm -ivh noweb-2.10a-1.i386.rpm

@

\subsubsection{Installing Zope, Python-Imaging, and ZWiki}

In this section you will install and configure the ZWiki server. First,  
download the Zope 2.8 rpm package from the rpmfind.net server and the zwiki 
package.

<<step>>=

wget 
ftp://rpmfind.net/linux/fedora/extras/3/i386/python-imaging-1.1.4-7.i386.rpm

wget ftp://rpmfind.net/linux/fedora/extras/3/i386/zope-2.8.0-2.fc3.i386.rpm

wget http://zwiki.org/releases/ZWiki-0.43.0.tgz

@

Next, proceed to install the Zope and Python-imaging rpm packages.

<<step>>=

rpm -ivh python-imaging-1.1.4-7.i386.rpm
rpm -ivh zope-2.8.0-2.fc3.i386.rpm

@

Add Zwiki to Zope server.

<<step>>=

tar -xzf ZWiki-0.43.0.tgz -C /usr/lib/zope/lib/python/Products/

@

Configure root user for Zwiki access.

<<step>>=

/usr/bin/zopectl adduser root address@hidden

@

Test and deploy Zwiki server.

<<step>>=

/etc/init.d/zope start

@

\subsubsection{Axiom}

Download the Axiom software package from axiom.developer server.

<<step>>=

wget 
http://axiom.axiom-developer.org/axiom-website/DOWNLOADS/axiom-Feb2005-Fedora3.bin.tgz

tar -xzf axiom-Feb2005-Fedora3.bin.tgz -C /etc/

@

In order to use Axiom, you  must include Axiom in the user path. Open the Vi 
editor and edit the .bash\_profile file in the root directory and the doyen 
user home directory with the next set of changes. You can also copy the 
.bash\_profile provided in the appendix of this document into the /root and 
/home/doyen directories.

<<step>>=

vi .bash_profile
export AXIOM=/etc/axiom/mnt/fedora3
append AXIOM to PATH:
PATH=\$PATH:\$HOME/bin:\$AXIOM/bin

@

Activate the changes to the current session.

<<step>>=

source ~/.bashrc
source ~/.bash_profile

@

\subsubsection{LatexWiki}

Download the LatexWiki package from mcelrath.org webpage. LatexWiki is a patch 
to the ZWiki package that allows rendering of in-line Latex.

<<step>>=

cd /tmp/pkgs

wget http://www.easyleading.org/Downloads/LocalFS-1.3-andreas.tar.gz

@

Unpack the LatexWiki distribution into the Zope installation's Products 
directory.

<<step>>=

tar -xvf LocalFS-1.3-andreas.tar.gz -C /usr/lib/zope/lib/python/Products/

@

Download and install darcs

<<step>>=

wget 
http://download.fedora.redhat.com/pub/fedora/linux/extras/3/i386/darcs-1.0.3-2.fc3.i386.rpm

rpm -ivh darcs-1.0.3-2.fc3.i386.rpm

@

<<step>>=

darcs get http://bob.mcelrath.org/darcs/latexwiki

@

\subsubsection{Xorg file configuration}

Use Vi to properly configure the video support.

<<step>>=

vi /etc/X11/xorg.conf

@

For multiple video card support change the driver name for the video card 
indentifier. Set driver value to "vesa".

\subsubsection{Generic mouse configuration}

Create the moused file that is in the appendix or copy the one generated for 
you by this document and place in the /etc/init.d directory:
Add the script to the run levels 3, 4, and 5.

<<step>>=

ln -s /etc/init.d/moused /etc/rc3.d/S01moused

ln -s /etc/init.d/moused /etc/rc4.d/S01moused

ln -s /etc/init.d/moused /etc/rc5.d/S01moused

ln -s /etc/init.d/moused /etc/rc6.d/K01moused

ln -s /etc/init.d/moused /etc/rc0.d/K01moused

@

\subsubsection{Build Live CD scritps}

Download the scripts necessary to build the CD from the Linux-Live webpage.

<<step>>=

cd /tmp/pkgs

wget http://www.linux-live.org/dl/linux-live-5.0.16.tar.gz

@

Get the precompiled 2.6.11.8 kernel with SquashFS and UnionFS module support.

<<step>>=

wget http://ftp.linux.cz/pub/linux/slax/kernel/linux-kernel-2.6.11.8-i486-4.tgz

tar -xzf linux-kernel-2.6.11.8-i486-4.tgz -C /

tar -xzf linux-live-5.0.16.tar.gz -C /tmp

@

Edit the config file and make these changes: Change KERNEL name to 
KERNEL="2.6.11.8". Save and close the config file.

<<step>>=

cd /tmp/linux-live-5.0.16/

vi config

@

Create module dependecies for newly installed kernel.

<<step>>=

depmod -b / 2.6.11.8

@

\subsubsection{Clean Up and ISO creation and burnning}

Finally, proceed to delete temporary files created by the package installation 
process to reduce the size of the CD to be created. Then, run the runme.sh 
script that will create the ISO image.

<<step>>=

rm -rf /tmp/pkgs
rm -rf /var/cache/yum/base/pakcages/*
rm -rf /var/cache/yum/updates-released/packages/*

@

Run the runme.sh script, which will create the distribution iso.

<<step>>=

sh runme.sh

@

If you have a CD recorder unit, you can create the Doyen CD by running:

\section{Appendix}

\subsection{MOUSED}

<<moused>>=
                                                                                
                                                                             
#!/bin/sh
# Linux
                                                                                
                                                                             
DAEMON=moused
KERNEL=`uname -r`
MODULE=psmouse.ko
prog=mouse
config () {
        # Is this a printconf system?
        if [ -f /lib/modules/\$KERNEL/kernel/drivers/input/mouse/\$MODULE ]
        then
               \# run printconf-backend to set up the configuration.
                /sbin/modprobe psmouse
        fi
}
                                                                                
                                                                             
start () {
        echo -n $"Starting $prog: "
        config
}
stop () {
        \# stop daemon
        echo -n $"Stopping $prog: "
        rmmod psmouse
}
                                                                                
                                                                             
case $1 in
        start)
                start
        ;;
        stop)
                stop
        ;;
 *)
                                                                                
                                                                             
        echo $"Usage: $prog {start|stop|restart|condrestart|reload|status}"
        exit 1
esac
                                                                                
                                                                             
@

\subsection{XORG.CONF}

<<xorg>>=

# XFree86 4 configuration created by pyxf86config

Section "ServerLayout"
        Identifier     "Default Layout"
        Screen      0  "Screen0" 0 0
        InputDevice    "Mouse0" "CorePointer"
        InputDevice    "Keyboard0" "CoreKeyboard"
EndSection

Section "Files"

# RgbPath is the location of the RGB database.  Note, this is the name of the 
# file minus the extension (like ".txt" or ".db").  There is normally
# no need to change the default.
# Multiple FontPath entries are allowed (they are concatenated together)
# By default, Red Hat 6.0 and later now use a font server independent of
# the X server to render fonts.
        RgbPath      "/usr/X11R6/lib/X11/rgb"
        FontPath     "unix/:7100"
EndSection

Section "Module"
        Load  "dbe"
        Load  "extmod"
        Load  "fbdevhw"
        Load  "glx"
        Load  "record"
        Load  "freetype"
        Load  "type1"
        Load  "dri"
EndSection

Section "InputDevice"

# Specify which keyboard LEDs can be user-controlled (eg, with xset(1))
#       Option  "Xleds"         "1 2 3"
# To disable the XKEYBOARD extension, uncomment XkbDisable.
#       Option  "XkbDisable"
# To customise the XKB settings to suit your keyboard, modify the
# lines below (which are the defaults).  For example, for a non-U.S.
# keyboard, you will probably want to use:
#       Option  "XkbModel"      "pc102"
# If you have a US Microsoft Natural keyboard, you can use:
#       Option  "XkbModel"      "microsoft"
#
# Then to change the language, change the Layout setting.
# For example, a german layout can be obtained with:
#       Option  "XkbLayout"     "de"
# or:
#       Option  "XkbLayout"     "de"
#       Option  "XkbVariant"    "nodeadkeys"
#
# If you'd like to switch the positions of your capslock and
# control keys, use:
#       Option  "XkbOptions"    "ctrl:swapcaps"
# Or if you just want both to be control, use:
#       Option  "XkbOptions"    "ctrl:nocaps"
#
        Identifier  "Keyboard0"
        Driver      "keyboard"
        Option      "XkbModel" "pc105"
        Option      "XkbLayout" "us"
EndSection

Section "InputDevice"
        Identifier  "Mouse0"
        Driver      "mouse"
        Option      "Protocol" "IMPS/2"
        Option      "Device" "/dev/input/mice"
        Option      "ZAxisMapping" "4 5"
        Option      "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
        Identifier   "Monitor0"
        VendorName   "Monitor Vendor"
        ModelName    "ViewSonic E70"
        HorizSync    30.0 - 70.0
        VertRefresh  50.0 - 120.0
        Option      "dpms"
EndSection

Section "Device"
        Identifier  "Videocard0"
        Driver      "radeon"
        VendorName  "Videocard vendor"
        BoardName   "ATI Radeon 9200SE"
EndSection

Section "Screen"
        Identifier "Screen0"
        Device     "Videocard0"
        Monitor    "Monitor0"
        DefaultDepth     24
        SubSection "Display"
                Viewport   0 0
                Depth     24
                Modes    "1280x1024" "1280x960" "1152x864" "1024x768" "800x600" 
"640x480"
        EndSubSection
EndSection

Section "DRI"
        Group        0
        Mode         0666
EndSection

@

<<bashprofile>>=

# .bash_profile
                                                                                
                                                                             
# Get the aliases and functions
if [ -f ~/.bashrc ]; then
        . ~/.bashrc
fi
                                                                                
                                                                             
# User specific environment and startup programs
                                                                                
                                                                             
export AXIOM=/etc/axiom/mnt/fedora3
                                                                                
                                                                             
PATH=$PATH:$HOME/bin:$AXIOM/bin
                                                                                
                                                                             
export PATH
unset USERNAME

@


\section{Makefile}

<<*>>=
notangle=/usr/bin/notangle
noweave=/usr/bin/noweave

all: extract do latex
        @echo done

extract: steps.pamphlet
        ${notangle} -Rstep steps.pamphlet >steps.sh
        ${notangle} -Rmoused steps.pamphlet >moused
        ${notangle} -Rxorg steps.pamphlet >xorg.conf
        ${notangle} -Rbashprofile steps.pamphlet >.bash_profile
        ${noweave} -delay steps.pamphlet >steps.tex
        
do: steps.pamphlet
        @echo executing

latex: steps.tex
        @echo making steps.dvi from steps.tex
        latex steps.tex
        latex steps.tex
        pdflatex steps.tex

remake: steps.pamphlet
        @echo extracting makefile
        ${notangle} -t8 steps.pamphlet >Makefile

@
\end{document}

--
forwarded from http://wiki.axiom-developer.org/address@hidden