\documentclass{article} \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. <>= rpm --import /usr/share/rhn/RPM-GPG-KEY-fedora @ \subsection{Upgrade Mozilla Firefox Browser} <>= yum -y update firefox @ \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. <>= cd /tmp/ wget http://alfredo.axiom-developer.org/doyen/livecd/doyen.tar.gz tar -xzf doyen.tar.gz cd doyen @ \subsection{Desktop Configuration} Creates the default Doyen desktop configuration. Installs other various CCNY Software. <>= tar -xzpf doyenHome.tar.gz -C / @ \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 @ \subsubsection{Latex} To install the Latex software package you need to use yum and install tetex, tetex-latex, and tetex-xdvi packages. <>= yum -y install tetex yum -y install tetex-latex yum -y install tetex-xdvi @ \subsubsection{Noweb Software Package} Install the Noweb software used for notangle and noweave support. <>= rpm -ivh Icon2-9.3.2-7.i386.rpm rpm -ivh noweb-2.10a-4.i386.rpm @ \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. <>= rpm -ivh python-imaging-1.1.4-7.i386.rpm rpm -ivh zope-2.8.0-2.fc3.i386.rpm @ Configure root user for access to the Zope server. <>= /usr/bin/zopectl adduser root doyen@org @ \subsubsection{LatexWiki} Extract the Doyen Wiki Database <>= tar -xzpf doyenWiki.tar.gz -C /var/lib/zope/ @ Upgrade the Python interpreter. <>= yum -y update python @ Install the Python development tools. <>= yum -y install python-devel @ Install GraphViz. <>= rpm -ivh graphviz-2.2-3.i386.rpm @ Install Latex Packages. <>= cp axiom.sty /usr/share/texmf/tex/latex/base/ texhash @ Install DVIPNG <>= yum -y install gd rpm -ivh dvipng-1.4-1.rhfc2.i386.rpm @ Test and deploy Zope server. >= chmod 777 /var/lib/zope /etc/init.d/zope start @ \subsubsection{Xorg file configuration} For multiple video card support the driver "vesa" was used. <>= cp --reply=yes xorg.conf /etc/X11/ @ \subsubsection{Generic mouse configuration} Place the moused script in the /etc/init.d directory <>= cp moused /etc/init.d/ @ Add the script to the run levels 3, 4, and 5. <>= 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 @ \subsection{Shutdown Scripts} <>= mv /sbin/shutdown /sbin/sysshutdown cp shutdown /sbin/ @ \subsubsection{Reboot Scripts} <>= rm -f /usr/bin/reboot cp reboot /usr/bin/ @ \subsection{Wireless Tools} <>= rpm -ivh wifi-radar-1.9.4-1.mr.i386.rpm @ \subsection{Grant Sudo Permission to Doyen User} <>= echo "doyen ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers @ \subsubsection{Build Live CD scritps} <>= 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/ @ Create module dependecies for newly installed kernel. <>= depmod -b / 2.6.13.2 @ \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. <>= yum clean all sh runme.sh @ \section{Makefile} <<*>>= 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 @ \end{document}