\documentclass{article}% ===> this file was generated automatically by noweave --- better not edit it
\usepackage{axiom}
\usepackage{graphics}
\begin{document}
\title{Doyen Build Instructions}
\author{Tim Daly \and  Jose Alfredo Perez \and  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 boot options. 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 {\em "Install Fedora Core"}.

\subsection{Installation Type}

In the installation type window, select {\em "Custom"}.

\subsection{Disk Partioning Setup}

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

\subsection{Disk Setup}

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. Select force to be a primary partition.

\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. 4GB should be the minimum. Click Ok. Click Next to finish with the Disk Setup menu.

\subsection{Boot Loader Configuration}

Preserve the default boot loader configuration.

\subsection{Network Configuration}

Preserve 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 select Remote Login (SSH). Also, select disable for SELinux.

\subsection{Additional Language Support}

Select your prefered language.

\subsection{Time Zone Selection}

Select your time zone location.

\subsection{Set Root Password}

Select the desire password for the root account. In Doyen Live CD the default password is "doyen@org".

\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: doyen@org.
\item Confirm Password: doyen@org.

\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 haldaemon
\item iptables
\item netfs
\item netplugd
\item network
\item pcmcia
\item sshd
\item syslog
\item xinetd
\end{itemize}

Click save and close the window.

\subsection{Auto-login Configuration}

\begin{verbatim}

Clik on Applications --> System Settings --> Login Screen

\end{verbatim}

Select the doyen user in the "Automatic login username" section.

\section{Customizing Live CD}

\subsection{Software Installation}

The package installation for the Doyen distribution is done by using YUM and WGET to obtain all the required packages for The next step configures a file required for yum to search and install packages. Do not skip this step.
Open a terminal window.

\nwfilename{DoyenDocs.pamphlet}\nwbegincode{1}\moddef{step}\endmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

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

\nwendcode{}\nwbegindocs{2}\nwdocspar

\subsection{Upgrade Mozilla Firefox Browser}

\nwenddocs{}\nwbegincode{3}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

yum -y update firefox

\nwendcode{}\nwbegindocs{4}\nwdocspar

\subsubsection{Obtain the required Doyen packages}

Most of the packages used in doyen have been collected and archived into one package. Download the doyen.tar.gz package from axiom-developer.
 
\nwenddocs{}\nwbegincode{5}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

cd /tmp/

wget http://alfredo.axiom-developer.org/doyen/livecd/doyen.tar.gz

tar -xzf doyen.tar.gz 

cd doyen

\nwendcode{}\nwbegindocs{6}\nwdocspar

\subsection{Desktop Configuration}
                                                                                Creates the default Doyen desktop configuration. Installs other various CCNY Software.
                                             
\nwenddocs{}\nwbegincode{7}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup
tar -xzpf doyenHome.tar.gz -C /

\nwendcode{}\nwbegindocs{8}\nwdocspar

\subsection{Computer Algebra Systems}                                                                                                           
tar -xzpf AlgebraSystems.tar.gz -C /usr/local/
                           
cp magnus /usr/bin                                                                                                          
cp caiss-stat /usr/bin

cp axiom /usr/bin                                                                                                         
\nwenddocs{}\nwbegindocs{9}                                                                                                                          
\subsubsection{Latex}

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

\nwenddocs{}\nwbegincode{10}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

yum -y install tetex

yum -y install tetex-latex

yum -y install tetex-xdvi

\nwendcode{}\nwbegindocs{11}\nwdocspar

\subsubsection{Noweb Software Package}

Install the Noweb software used for notangle and noweave support. 

\nwenddocs{}\nwbegincode{12}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

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

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

\nwendcode{}\nwbegindocs{13}\nwdocspar

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

In this section, you will install and configure the ZWiki server. Install the Zope and Python-imaging rpm packages.

\nwenddocs{}\nwbegincode{14}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

rpm -ivh python-imaging-1.1.4-7.i386.rpm

rpm -ivh zope-2.8.0-2.fc3.i386.rpm

\nwendcode{}\nwbegindocs{15}\nwdocspar

Configure root user for access to the Zope server.

\nwenddocs{}\nwbegincode{16}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

/usr/bin/zopectl adduser root doyen@org

\nwendcode{}\nwbegindocs{17}\nwdocspar

\subsubsection{LatexWiki}

Extract the Doyen Wiki Database
                                                                                
\nwenddocs{}\nwbegincode{18}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup
                                                                                
tar -xzpf doyenWiki.tar.gz -C /var/lib/zope/
                                                                                
\nwendcode{}\nwbegindocs{19}\nwdocspar

Upgrade the Python interpreter.

\nwenddocs{}\nwbegincode{20}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

yum -y update python

\nwendcode{}\nwbegindocs{21}\nwdocspar

Install the Python development tools.

\nwenddocs{}\nwbegincode{22}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

yum -y install python-devel

\nwendcode{}\nwbegindocs{23}\nwdocspar

Install GraphViz.

\nwenddocs{}\nwbegincode{24}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

rpm -ivh graphviz-2.2-3.i386.rpm

\nwendcode{}\nwbegindocs{25}\nwdocspar

Install Latex Packages.

\nwenddocs{}\nwbegincode{26}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

cp axiom.sty /usr/share/texmf/tex/latex/base/

texhash

\nwendcode{}\nwbegindocs{27}\nwdocspar

Install DVIPNG

\nwenddocs{}\nwbegincode{28}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

yum -y install gd

rpm -ivh dvipng-1.4-1.rhfc2.i386.rpm

\nwendcode{}\nwbegindocs{29}\nwdocspar

Test and deploy Zope server.

<step>>=

chmod 777 /var/lib/zope

/etc/init.d/zope start                                                                                
\nwenddocs{}\nwbegindocs{30}\nwdocspar

\subsubsection{Xorg file configuration}

For multiple video card support the driver "vesa" was used.

\nwenddocs{}\nwbegincode{31}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

cp --reply=yes xorg.conf /etc/X11/

\nwendcode{}\nwbegindocs{32}\nwdocspar

\subsubsection{Generic mouse configuration}

Place the moused script in the /etc/init.d directory

\nwenddocs{}\nwbegincode{33}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

cp moused /etc/init.d/

\nwendcode{}\nwbegindocs{34}\nwdocspar

Add the script to the run levels 3, 4, and 5.

\nwenddocs{}\nwbegincode{35}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

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

\nwendcode{}\nwbegindocs{36}\nwdocspar

\subsection{Shutdown Scripts}

\nwenddocs{}\nwbegincode{37}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

mv /sbin/shutdown /sbin/sysshutdown

cp shutdown /sbin/

\nwendcode{}\nwbegindocs{38}\nwdocspar

\subsubsection{Reboot Scripts}

\nwenddocs{}\nwbegincode{39}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

rm -f /usr/bin/reboot

cp reboot /usr/bin/

\nwendcode{}\nwbegindocs{40}\nwdocspar

\subsection{Wireless Tools}

\nwenddocs{}\nwbegincode{41}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

rpm -ivh wifi-radar-1.9.4-1.mr.i386.rpm

\nwendcode{}\nwbegindocs{42}\nwdocspar

\subsection{Grant Sudo Permission to Doyen User}

\nwenddocs{}\nwbegincode{43}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

echo "doyen     ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers

\nwendcode{}\nwbegindocs{44}\nwdocspar

\subsubsection{Build Live CD scritps}

\nwenddocs{}\nwbegincode{45}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

tar -xzf linux-kernel-2.6.13.2-i486-1.tgz -C /

tar -xzf doyen-linux-live-5.1.8.tar.gz -C /tmp/

cd /tmp/doyen-linux-live-5.1.8/

\nwendcode{}\nwbegindocs{46}\nwdocspar

Create module dependecies for newly installed kernel.

\nwenddocs{}\nwbegincode{47}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

depmod -b / 2.6.13.2

\nwendcode{}\nwbegindocs{48}\nwdocspar

\subsubsection{ISO Creation}

Run the runme.sh script, which will create the distribution iso. This one will be located in the /tmp directory under the name of livecd.iso.

\nwenddocs{}\nwbegincode{49}\moddef{step}\plusendmoddef\nwstartdeflinemarkup\nwenddeflinemarkup

yum clean all

sh runme.sh

\nwendcode{}\nwbegindocs{50}\nwdocspar

\section{Makefile}

\nwenddocs{}\nwbegincode{51}\moddef{*}\endmoddef\nwstartdeflinemarkup\nwenddeflinemarkup
notangle=/usr/local/bin/notangle
noweave=/usr/local/bin/noweave

all: extract do latex
        @echo done

extract: steps.pamphlet
        $\{notangle\} -Rstep steps.pamphlet >steps.sh
        $\{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

\nwendcode{}\nwbegindocs{52}\nwdocspar
\end{document}
\nwenddocs{}
