Annotation of doc/install/redhat7.3/new_install_rh73.html, revision 1.2

1.1       matthew     1: <html><head><title>Setting up a Red Hat7.3 LON-CAPA Server</title></head><body>
1.2     ! matthew     2: <!-- $Id: new_install_rh73.html,v 1.1 2002/05/22 22:02:59 matthew Exp $ -->
1.1       matthew     3: <h1>Setting up a Red Hat7.3 LON-CAPA Server</h1>
                      4: 
                      5: <h2>Before you begin</h2>
                      6: <p>
                      7: Installing Linux is getting easier and easier.  However, it is still a
                      8: non-trivial undertaking and experience with Red Hat Linux will make this 
                      9: process easier.  You will be required to log in to the machine and execute
                     10: some routine Unix commands.  Some familiarity with Linux is assumed.
                     11: </p>
                     12: 
                     13: <h2>Installation Overview</h2>
                     14: <p>
                     15: The installation process takes the following steps:
                     16: <ol>
1.2     ! matthew    17:   <li> Obtain Red Hat 7.3 </li>
        !            18:   <li> Gather information for installing Red Hat </li>
        !            19:   <li> Install Red Hat 7.3 </li>
        !            20:   <li> Determine your LON-CAPA Settings </li>
        !            21:   <li> Install LON-CAPA </li>
        !            22:   <li> Configure LON-CAPA </li>
        !            23:   <li> Pick a hosts.tab file </li>
        !            24:   <li> Create a Domain Coordinator </li>
        !            25:   <li> Start/Restart services </li>
        !            26:   <li> Log in to LON-CAPA </li>
1.1       matthew    27: </ol>
                     28: </p>
                     29: 
                     30: <h2>Obtain the Red Hat 7.3 installation CDs</h2>
                     31: <p>
                     32: If you like, you may contact the LON-CAPA development staff and we can
                     33: mail the CDs to you.  Another option is to download the cd images and 
                     34: burn them yourself.
                     35: </p>
                     36: 
1.2     ! matthew    37: <h2>Determine Network settings for your site</h2>
1.1       matthew    38: <p>
1.2     ! matthew    39: You will need to have the following information for your site.  You must
        !            40: have a static IP address (do not use DHCP).
1.1       matthew    41: <ul>
1.2     ! matthew    42:   <li>ip address </li>
        !            43:   <li>netmask </li>
        !            44:   <li>network </li>
        !            45:   <li>broadcast </li>
        !            46:   <li>hostname </li>
        !            47:   <li>gateway </li>
        !            48:   <li>domain name server(s) </li>
1.1       matthew    49: </ul>
                     50: </p>
                     51: 
                     52: <h2>Install Red Hat 7.3</h2>
                     53: <p>
                     54: When you install RedHat you will need to ensure the following (the list below
                     55: is in the order the issues appear in the installation of Red Hat 7.3):
                     56: <dl>
                     57:    <dt>Installation Type
                     58:    <dd>You should definitely do a "Server" install.  We do not recommend
                     59:        Trying to install LON-CAPA with a different installation type.
                     60:    <dt>Partitioning your Drive
                     61:    <dd>You may want to use the automatic partitioning feature of Red Hat,
                     62:        however you should review the results and be prepared to modify them.
                     63:        LON-CAPA resource files are stored in the /home directory, so the
                     64:        lion's share of the drive should be allocated here.  If you have 8 GB 
                     65:        of space for Red Hat, /home should receive 4 to 6 gigs.  Be sure to 
                     66:        include adequate swap space.  A minimum is 512 Megs, but you should
                     67:        typically have 1 or 2x as much swap space as you do physical RAM.
                     68:    <dt>Network Configuration
                     69:    <dd>LON-CAPA will <b>not</b> work with a machine set up to use a dynamic 
                     70:        IP address.  When configuring your network card, be sure to unselect
                     71:        the DHCP option and enter in your network information.
                     72:    <dt>Firewall Configuration
                     73:    <dd>The installation script will remove and disable your firewall.
                     74:    <dt>Package Group Selection
                     75:    <dd>At a minimum, install the following packages:
                     76:       <ul>
1.2     ! matthew    77:         <li>NFS File Server </li>
        !            78:         <li>Windows File Server </li>
        !            79:         <li>Web Server </li>
1.1       matthew    80:       </ul>
                     81:        Other packages can be installed as you like.
                     82:    <dt>X Windows Configuration
                     83:    <dd>If you chose to install the X-windows packages you will need to 
                     84:        configure them.  If you are unsure of the support for your video
                     85:        card you may wish to skip the configuration.
                     86: </dl>
                     87: Other notes:
                     88: <ul>
                     89:   <li>Use md5 and shadow passwords if you are given the choice (this is
1.2     ! matthew    90:       the default). </li>
1.1       matthew    91: </ul>
                     92: </p>
                     93: 
                     94: <h2>Determine LON-CAPA settings</h2>
                     95: <p>
                     96: LON-CAPA requires a number of identifying parameters be set in order
                     97: for it to function at all.  Below is a list with descriptions.
                     98: <dl>
                     99:   <dt>Host Type (library or access)
                    100:   <dd>The server must be designated a 'library' or an 'access' server.  In
                    101:       general you should have a library server for your instructors to create
                    102:       their course content on and run their courses.  Students should connect
                    103:       to access servers.  If you are doing the first install of LON-CAPA at 
                    104:       your site, or if you are playing with it for your own edification, you
                    105:       should make your machine a 'library' server.
                    106:   <dt>LON-CAPA domain
                    107:   <dd>Each site or school which installs LON-CAPA needs its own domain.
                    108:       Here at MSU we use 'msu'.  You should choose something short but
                    109:       meaningful.
                    110:   <dt>LON-CAPA host id
                    111:   <dd>Each LON-CAPA server requires a unique internal name.  We use names
                    112:       such as "msul1" for the first library server.
                    113:   <dt>Host administrator email
                    114:   <dd>The amount of email sent to this address is relatively minimal.  Messages
                    115:       are sent every time the system starts up.
                    116:   <dt>Root password for SQL database
                    117:   <dd>In order to keep people from corrupting the MYSQL database, a root
                    118:       password is needed.  You'll need to remember this.
                    119: </dl>
                    120: </p>
                    121: 
                    122: <h2>Install LON-CAPA</h2>
                    123: <p>
                    124: Log in as root with the password you provided during the Red Hat 
                    125: installation process.
                    126: <pre>
                    127: wget http://install.loncapa.org/versions/rh73install/loncapa-rh73install.tar
                    128: tar xf loncapa-rh73install.tar
                    129: cd install
                    130: ./install.pl
                    131: </pre>
                    132: </p>
                    133: 
                    134: <h2>Configure LON-CAPA</h2>
                    135: <p>
                    136: Execute the following commands
                    137: <pre>
                    138: cd /root/loncapa/
                    139: ./UPDATE
                    140: </pre>
                    141: You will need to enter the LON-CAPA configuration information you requested
                    142: above.  Additionally, you will need to enter the following information 
                    143: (options 5 and 6 in the menu):
                    144: <dl>
                    145:    <dt>Cache Expiration Time
                    146:    <dd>86400
                    147:    <dt>Server Load
                    148:    <dd>2.0
                    149: </dl>
                    150: </p>
                    151: 
                    152: <h2>Picking a hosts.tab file</h2>
                    153: The "hosts.tab" file controls which LON-CAPA servers your server attempts 
                    154: to access and which servers it will respond to.  If this is your first 
                    155: install of LON-CAPA on your network, we suggest choosing a 'standalone' 
                    156: "hosts.tab".  Please contact the support staff at www.loncapa.org for
                    157: information about adding more hosts to your "hosts.tab" file.
                    158: 
                    159: <h2>Creating a Domain Coordinator</h2>
                    160: <p>
                    161: You will need at least one user at your site who has the role of
                    162: 'domain coordinator'.  This user creates accounts for other users and
                    163: grants them additional privileges.  The make_domain_coordinator.pl script
                    164: invoked below requires that you enter the users password.  The password will
1.2     ! matthew   165: show in plaintext as you type it.  Feel free to use the "passwd username"
1.1       matthew   166: command to change it later.  Replace USERNAME and DOMAIN with an 
                    167: appropriate user name and your domain.
                    168: <pre>
                    169: cd /root/loncapa/loncom/build
                    170: perl make_domain_coordinator.pl USERNAME DOMAIN
                    171: mkdir ~USERNAME/public_html
                    172: chown USERNAME:www ~USERNAME/public_html
                    173: chmod 0775 ~USERNAME/public_html
                    174: </pre>
                    175: </p>
                    176: 
                    177: <h2>Start/Restart Services</h2>
                    178: <p>
                    179: The services take about 10 minutes to start.
                    180: <pre>
                    181: /etc/init.d/loncontrol start
                    182: /etc/init.d/httpd restart
                    183: </pre>
                    184: </p>
                    185: 
                    186: <h2>Log in to your LON-CAPA Machine</h2>
                    187: <p>
                    188: Point a web browser at your new machine and log in as the domain
                    189: coordinator.  Congratulations!
                    190: </p>
                    191: 
                    192: 
                    193: 

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