Parent Directory
| 
Revision Log
documentation for webwork 1.8
1 <html> 2 <head> 3 <title>Installing WeBWorK on a Red Hat Linux 8.0 System</title> 4 </head> 5 <body> 6 <h1>Installing WeBWorK on a Red Hat Linux 8.0 System</h1> 7 <p> 8 For WeBWorK version 1.8<br> 9 Samuel Hathaway <sh002i@math.rochester.edu><br> 10 Arnold Pizer <apizer@math.rochester.edu> 11 </p> 12 <hr> 13 <p>This document details the setup and configuration of Red Hat 8.0 for use with 14 WeBWorK. Use it along with the <em>Installing WeBWorK on a Linux System</em> 15 document. Before beginning the installation, you should also consult the Red Hat 16 8.0 Installation Guide at <a href="http://www.redhat.com/docs/">http://www.redhat.com/docs/</a>.</p> 17 <hr> 18 <h2>Step 1: During the Red Hat installation</h2> 19 <p>While installing Red Hat Linux, there are several options that are important 20 to WeBWorK. These are listed below with recommended settings.</p> 21 <p><strong>Install Type:</strong> This affects which packages we will need to 22 install later. We recommend "Server".</p> 23 <p><strong>Firewall Configuration:</strong> If you choose to install a firewall, 24 keep in mind that WeBWorK requires incoming HTTP connections, and you may 25 benefit from allowing other types of inconming connections (such as telnet, SSH, 26 FTP, or SCP) for professors. SSH and SCP servers are installed by default on the 27 "Server System" install type, so opening those ports in your firewall 28 configuration will enable those services.</p> 29 <p><strong>Account Configuration:</strong> Make sure you create at least one 30 user account, in addition to the root account. You can use this user account as 31 the "regular user account" in the setup of WeBWorK.</p> 32 <p><strong>Package Group Selection:</strong> This option is only shown if you 33 choose the "Server System" install type. Here are our recommended selections: 34 <ul> 35 <li>the "X Window System" package</li> 36 <li>the "GNOME Desktop Environment" package</li> 37 <li>the "Editors" package</li> 38 <li>mozilla in the "Graphical internet" package</li> 39 <li>the "Authoring and Publishing" package</li> 40 <li>the "Server Configuration Tools" package</li> 41 <li>the "Web Server" package</li> 42 <li> the "Development Tools" package</li> 43 <li> the "Administration Tools" package</li> 44 </ul> 45 Also check "Select individual packages" at the bottom. Install the following 46 individual package.<br><br> 47 48 <table border="1"> 49 <tr><th>package</th><th>directory</th><th>package names</th></tr> 50 <tr><td>gd-devel</td><td nowrap>Development->Libraries</td><td><code>gd-devel</code></td></tr> 51 </table> 52 <p>Also select any other packages you want to install at this time (e.g. your 53 favorite editor if it wasn't listed in the "Editors" package). When RedHat checks for dependencies, accept the default of 54 installing additional packages to resolve all dependencies (if any). 55 </p> 56 57 58 <h2>Step 2: system configuration</h2> 59 60 <p>You can use RedHat's system configuration tools to replace several of the 61 command-line operations in the <em>Installing WeBWorK on a Linux System</em> 62 document. To access these tools, click Main Menu and then System or Server Settings (you will 63 be asked for the root password). In the Red Hat User Manager, under Preferences, uncheck 64 "Filter system users and groups" so you can see all users, e.g. apache. 65 <table border="1"> 66 <tr><th>shell task</th><th>configuration tool</th></tr> 67 <tr><td><code>useradd</code>, <code>usermod</code>, <code>userdel</code></td><td>System Settings->Users and Groups->Add User</td></tr> 68 <tr><td><code>groupadd</code>, <code>groupmod</code>, <code>groupdel</code></td><td>System Settings->Users and Groups->Add Group</td></tr> 69 <tr><td><code>/etc/init.d/httpd</code>, adding apache to rc files</td><td>Server Settings->Services</td></tr> 70 </table> 71 72 <h2>Step 3: Starting apache</h2> 73 <ol> 74 <li>Click Main Menu, Server Settings, Services (you will 75 be asked for the root password).</li> 76 <li>Select <code>httpd</code> from the list of services. </li> 77 <li>Click "Start". It is at the top of the panel. After a moment, there should be a message that apache has started.</li> 78 <li>Check the "Start at Boot" checkbox.</li> 79 <li>Click "Save" and then close Service Configuration</li> 80 </ol> 81 <p>Apache is now started, and will start whenever the computer is rebooted. To 82 verify that apache is working, open Mozilla and open 83 <code>http://localhost/</code>. You should see a page titled "Test Page".</p> 84 85 <h2>Step 4: Read <em>Installing WeBWorK on a Linux System</em></h2> 86 <p>At this point, begin reading the <em>Installing WeBWorK on a Linux 87 System</em> document. Keep the following in mind:</p> 88 <ul> 89 <li>Perl is already compiled with GDBM database support.</li> 90 <li>See Step 5. for instructions for installing CGI.pm and Step 6. for instructions on installing GD.pm.</li> 91 <li>The full path to perl is <code>/usr/bin/perl</code> which you will need to enter when 92 running the WeBWorK set up script. </li> 93 <li>You still have to configure LaTeX2HTML. The configuration file is: 94 <code>/usr/share/latex2html/l2hconf.pm</code>. 95 Edit it by setting 96 <pre> 97 $PK_GENERATION = 1 98 $DVIPS_MODE = 'toshiba' 99 $METAFONT_DPI = 180 100 </pre> 101 </li> 102 <li>You need to install TTH.<br> 103 Get the linux version, untar it<br> 104 <code>> tar -xzf tth_linux.tar.gz</code><br> 105 and then as root copy it to <code>/usr/bin/</code><br> 106 <code># cp tth_linux/tth /usr/bin</code> 107 </li> 108 <li>See Step 7. for instructions for installing dvipng.</li> 109 <li>Apache on Red Hat 8.0 runs as the user <code>apache</code> in the group <code>apache</code>. When the installaton instructions refer to the user <code>wwserver</code> and the group <code>wwserver</code>, you can substitute <code>apache</code>.</li> 110 <li>Apache's configuration file <code>httpd.conf</code> is located in the directory <code>/etc/httpd/conf/</code> .</li> 111 <li>Apache's DocumentRoot is <code>/var/www/html/</code> and cgi-bin directory is <code>/var/www/cgi-bin/</code> .</li> 112 <li>You will want to use the "ScriptAlias" method of linking WeBWorK's cgi directory to the web server, rather than the symlink method. Be careful to put the <code>ScriptAlias</code> for WeBWorK before the <code>ScriptAlias</code> for <code>cgi-bin</code> in <code>httpd.conf</code>.</li> 113 </ul> 114 115 116 <h2>Step 5: Install CGI.pm</h2> 117 CGI.pm is a core module and is supposed to be contained in a stardard perl installation 118 but it is not part of Red Hat's perl. To install it simply add CGI to the list of modules 119 CPAN installs: 120 <pre> 121 # perl -MCPAN -e shell 122 cpan> install HTML::Parser Net::SMTP MIME::Base64 CGI 123 </pre> 124 125 <h2>Step 6: Install GD.pm</h2> 126 First if you missed installing <code>gd-devel-1.8.4-9.i386.rpm</code> in the initial set up, install it now. It's on the second installation diskette 127 psyche-i386-disc2. Next link <code>libpng</code> and <code>libjpeg</code>. As root 128 <pre> 129 # cd /usr/lib 130 # ln -s libpng.so.3 libpng.so 131 # ln -s libjpeg.so.62.0.0 libjpeg.so 132 </pre> 133 134 Now we are ready to install the GD module. Currently (Fall 2002) if you use CPAN to install GD, it will 135 install the 2.01 version of GD.pm which requires the beta 2.0.1 version of gd. 136 Unfortunately there is a known bug in gd 2.0.1 which prevents it from drawing horizontal dashed 137 lines. We recommend using gd 1.8.4 and GD 1.33. gd 1.8.4 is on your system. For GD, go to 138 <a href="http://stein.cshl.org/WWW/software/GD/">http://stein.cshl.org/WWW/software/GD/</a>. 139 <p>As a normal user, download the tar/gzip archive for version 1.33 (or 1.29) and untar it:</p> 140 <pre> 141 > tar -xzf GD.pm.tar.gz 142 </pre> 143 then cd to the <code>GD-1.33</code> subdirectory, make a copy of <code>Makefile.PL</code>, and then edit 144 <code>Makefile.PL</code> replacing lines 6 and 7 145 <pre> 146 my @INC = qw(-I/usr/local/include -I/usr/local/include/gd); 147 my @LIBPATH = qw(-L/usr/lib/X11 -L/usr/X11R6/lib -L/usr/X11/lib -L/usr/local/lib ); 148 </pre> 149 by 150 <pre> 151 my @INC = qw(-I/usr/local/include -I/usr/include -I/usr/local/include/gd); 152 my @LIBPATH = qw(-L/usr/lib/X11 -L/usr/X11R6/lib -L/usr/X11/lib -L/usr/local/lib -L/usr/lib); 153 </pre> 154 155 Now run the commands:</p> 156 <pre> 157 > perl Makefile.PL (select JPEG but not FreeType or XPM support for WeBWorK)) 158 > make 159 </pre> 160 <p>Then, as root, install it. 161 <pre> 162 # make install 163 </pre> 164 Note that we suggest you do not run <code>make test</code> as this will 165 show all tests failing, but the installation is OK. You can test this by 166 viewing graphs in WeBWorK or by running one of the sample 167 perl scripts contained in the GD documentation. 168 169 <h2>Step 7: Install dvipng</h2> 170 First download <code>dvipng</code> from John Jones's site 171 <a 172 href="http://hobbes.la.asu.edu/webwork-stuff">http://hobbes.la.asu.edu/webwork-stuff 173 </a>. 174 Then install it by running the following commands as root: 175 <pre> 176 # tar -xzf for-dvipng.tar.gz 177 # cd for-dvipng/ 178 # cd preview 179 # make install 180 # cd ../dvipng/ 181 # cp dvipng /usr/bin/ 182 # cd /usr/bin 183 # ldd dvipng 184 </pre> 185 186 <p>Good luck!</p> 187 188 </body> 189 </html>
| aubreyja at gmail dot com | ViewVC Help |
| Powered by ViewVC 1.0.9 |