Annotation of doc/packaging/whitepaper.html, revision 1.1

1.1     ! harris41    1: <HTML>
        !             2: <HEAD>
        !             3: <TITLE>Packaging, the whole nine yards, White Paper</TITLE>
        !             4: </HEAD>
        !             5: <BODY BGCOLOR=#FFFFFF>
        !             6: <H1>Packaging, the whole nine yards, White Paper</H1>
        !             7: <P>
        !             8: This document is in doc/packaging/whitepaper.html.  First
        !             9: generated by Scott Harrison, September 29, 2000.
        !            10: <P>
        !            11: This document is an overview of what needs to be considered
        !            12: in terms of a software development process, from source code
        !            13: creation to CD installation.  Suffice it to say, if any of
        !            14: these issues <B>are not</B> resolved, there really is not
        !            15: a sustainable packaging effort that can continue in the future.
        !            16: Shown below is a list of needs and solutions.  Hopefully
        !            17: this motivates dialogue, suggestions, and some level of common
        !            18: awareness as to what has been going on.  Perhaps there is some
        !            19: disagreement, but hopefully this is somewhat of good start on
        !            20: all of this.. shrug.  This is meant to focus and clarify things,
        !            21: not confuse them.  I think many of these things have been worked out
        !            22: on many different fronts.  However, the name of the game now is to
        !            23: make sure things are going forward to be finished without generating
        !            24: new cans of worms.
        !            25: <P>
        !            26: <CAPTION>Packaging needs, suggested solutions, current status, what remains to do</CAPTION>
        !            27: <TABLE BORDER=2>
        !            28: <TR BGCOLOR=#000000>
        !            29: <TH><FONT COLOR=#FFFFFF>Need</FONT></TH>
        !            30: <TH><FONT COLOR=#FFFFFF>Solution</FONT></TH>
        !            31: <TH><FONT COLOR=#FFFFFF>Status</FONT></TH>
        !            32: <TH><FONT COLOR=#FFFFFF>To do</FONT></TH>
        !            33: <TR BGCOLOR=#DDDDDD>
        !            34: <TD COLSPAN=4><B>Internal Source Code</B>
        !            35: <BR>The code created and overseen by the development team.  Generally as relates to
        !            36: code that implements the LON-CAPA network, instructional content handling, and student
        !            37: evaluation.</TD>
        !            38: <TR>
        !            39: <TD>Internal source code submission</TD>
        !            40: <TD>CVS</TD>
        !            41: <TD>implemented on zaphod</TD>
        !            42: <TD>Eventually port to www.lon-capa.org.  Also need to specify process by which users are added/removed from CVS-submission group</TD>
        !            43: </TR>
        !            44: <TR>
        !            45: <TD>Internal source code distribution</TD>
        !            46: <TD>CVS</TD>
        !            47: <TD>implemented on zaphod</TD>
        !            48: <TD>Eventually port to www.lon-capa.org.  Need to distribute two versions: LAST-WORKING; and MOST-UP-TO-DATE</TD>
        !            49: </TR>
        !            50: <TR>
        !            51: <TD>Internal source code versioning</TD>
        !            52: <TD>CVS</TD>
        !            53: <TD>implemented on zaphod</TD>
        !            54: <TD>Eventually port to www.lon-capa.org.</TD>
        !            55: </TR>
        !            56: <TR>
        !            57: <TD>Internal source code building</TD>
        !            58: <TD>CVS</TD>
        !            59: <TD>a number of "commands", "Makefile" scripts written with some documentation</TD>
        !            60: <TD>Have a working and understandable set of "commands", "Makefile" 
        !            61: scripts written with some documentation.
        !            62: <BR>Installation should be done through an RPM
        !            63: <BR>LON-CAPA-base.rpm should be generated, and be the
        !            64: basis for an install.
        !            65: <BR>Other OS-specific install options could be considered (ie Debian).
        !            66: </TD>
        !            67: </TR>
        !            68: <TR BGCOLOR=#DDDDDD>
        !            69: <TD COLSPAN=4><B>External Source Code</B>
        !            70: <BR>The code created and development overseen by others.  Generally as relates to "modular"
        !            71: necessary software packages like kerberos and MySQL, as well as multiple perl
        !            72: modules</TD>
        !            73: </TR>
        !            74: <TR>
        !            75: <TD>External source code distribution</TD>
        !            76: <TD>Anonymous FTP site (www.lon-capa.org)</TD>
        !            77: <TD>External packages have been gathered into directory as source tarballs</TD>
        !            78: <TD>Where/how can I post packages?</TD>
        !            79: </TR>
        !            80: <TR>
        !            81: <TD>External source code submission</TD>
        !            82: <TD>someone with access to www.lon-capa.org</TD>
        !            83: <TD>not done</TD>
        !            84: <TD>Who should do this? shall we do this soon?</TD>
        !            85: </TR>
        !            86: <TR>
        !            87: <TD>External source code versioning</TD>
        !            88: <TD>Use the most up-to-date version that works with LON-CAPA.</TD>
        !            89: <TD>Currently have the most up-to-date versions.</TD>
        !            90: <TD>How often should we update available external source code versions?</TD>
        !            91: </TR>
        !            92: <TR>
        !            93: <TD>External source code building</TD>
        !            94: <TD>Have a README for each software bundle and an automated build script.  Generate an RPM.</TD>
        !            95: <TD>RPMs generated.  README's and build scripts are currently dispersed in lon-capa mail archives.</TD>
        !            96: <TD>Post README, RPMs, and build scripts on anonymous FTP server.</TD>
        !            97: </TR>
        !            98: <TR BGCOLOR=#DDDDDD>
        !            99: <TD COLSPAN=4><B>Communication between developers</B>
        !           100: <BR>History has shown that there are a host of issues that occur when integrating software applications together with LON-CAPA
        !           101: and the linux distribution.  As with most software development projects, the various questions and solutions must not be lost, and
        !           102: there needs to be a system for passing communications between interested developers.</TD>
        !           103: </TR>
        !           104: <TR>
        !           105: <TD>Communication distribution</TD>
        !           106: <TD>Mailman, list@lon-capa.org</TD>
        !           107: <TD>There are archives (including Scott-created search engine) currently for lon-capa@hobbes.lite.msu.edu.</TD>
        !           108: <TD>Need to port to lon-capa.org.</TD>
        !           109: </TR>
        !           110: <TR BGCOLOR=#DDDDDD>
        !           111: <TD COLSPAN=4><B>Operating System and Installation CD generation</B>
        !           112: <BR>The components and installation details of LON-CAPA plus linux operating system to be made available.
        !           113: </TD>
        !           114: </TR>
        !           115: <TR>
        !           116: <TD>Customized Redhat CD image</TD>
        !           117: <TD>Specify RPM sets; synchronize installation indices of RPM sets.</TD>
        !           118: <TD>RPM sets have been well specified; both for LON-CAPA runtime systems, and LON-CAPA development systems.  CD images have been compiled and burned.  I have a number of HOW-TO's I wrote available on spock.lite.msu.edu web site and CVS.</TD>
        !           119: <TD>Need to post RPM sets to be accessible as updated versions from lon-capa.org.  Need to automate and better document CD image generation from internal source, external source, and "original" Redhat CD image.</TD>
        !           120: </TR>
        !           121: <TR>
        !           122: <TD>Installation, Reconfiguration, Updating Software</TD>
        !           123: <TD>Defined interfaces for both text-based and graphical sessions.  Must be scripted together to synchronize entire system.</TD>
        !           124: <TD>Interfaces are defined (see CVS repository doc/anaconda_interfaces).  Much of the scripting is in place.</TD>
        !           125: <TD>Significantly buggy.  <IMG SRC="bug.gif">.  Also need some solid documentation.</TD>
        !           126: </TR>
        !           127: <TR>
        !           128: <TD>Operating System HOW-TO & Mechanics</TD>
        !           129: <TD>Specify configuration details about various system services (netatalk, samba, nfs).  Have auxiliary scripts available (setuid password synchronization script).</TD>
        !           130: <TD>Much of how to do this is mentioned in the mail archives.</TD>
        !           131: <TD>Need to do it.  Also needs to be officially documented and posted on www.lon-capa.org.</TD>
        !           132: </TR>
        !           133: <TR>
        !           134: <TD>Boot everything and continuously monitor: loncron and /etc/rc.d/init.d/</TD>
        !           135: <TD>Run loncron under some random cron scenario (25% chance of being run every hour?) Have all internal package, external package, and operating system services start automatically upon boot (/etc/rc.d/init.d; chkconfig).</TD>
        !           136: <TD>Much of how to do this is mentioned in the mail archives.</TD>
        !           137: <TD>Need to do it.  Also need to officially document and post on www.lon-capa.org.</TD>
        !           138: </TR>
        !           139: </TABLE>
        !           140: </BODY>
        !           141: </HTML>
        !           142: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>