[LON-CAPA-cvs] cvs: doc /build RHEL5_install.frag RHEL6_install.frag scientific5_install.frag scientific6_install.frag
bisitz
bisitz at source.lon-capa.org
Fri Dec 13 13:10:12 EST 2013
bisitz Fri Dec 13 18:10:12 2013 EDT
Modified files:
/doc/build scientific5_install.frag scientific6_install.frag
RHEL5_install.frag RHEL6_install.frag
Log:
- Better highlight SELinux settings (found to be overseen repeatedly)
- Valid HTML code/nested tags; W3C HTML validity
- Fixed typo ("This should tool be used ..." -> "This tool should be used ...")
-------------- next part --------------
Index: doc/build/scientific5_install.frag
diff -u doc/build/scientific5_install.frag:1.3 doc/build/scientific5_install.frag:1.4
--- doc/build/scientific5_install.frag:1.3 Sat Nov 26 20:51:00 2011
+++ doc/build/scientific5_install.frag Fri Dec 13 18:10:11 2013
@@ -33,10 +33,10 @@
<li><a href="#log">Log in to LON-CAPA</a></li>
</ol>
-<hr />
+<hr>
<h2>1. <a name="obt">Obtain Scientific Linux 5 CDs</a></h2>
<p>
-Scientific Linux isos can be obtained from links included on the <a href="http://www.scientificlinux.org/download/">Scientific Linux download page</a><br />
+Scientific Linux isos can be obtained from links included on the <a href="http://www.scientificlinux.org/download/">Scientific Linux download page</a><br>
For the minimal install on both 32-bit and 64 bit architecture you will need only the first CD.
</p>
@@ -88,23 +88,26 @@
<dd>Click the "Customize Now" radio button and for a minimal install uncheck all packages except "Base" in the Base System category. If you leave other packages checked in any of the other categories, you'll need additional ISO CDs.</dd>
</dl>
<p>
-
-Finish installing your server, reboot it, and log in as root. The
-first time you log-in, the Setup Agent will be displayed. (If you exit it early you can enter it again buy running the command
+Finish installing your server, reboot it, and log in as root.
+</p>
+<h3>Firewall and SELinux Configuration</h3>
+<p>
+The first time you log-in, the Setup Agent will be displayed. (If you exit it early you can enter it again buy running the command
+</p>
<pre>
setup
</pre>
- This should tool be used to configure the Firewall and SELinux.
-
- <dt>Firewall Configuration</dt>
-
- <dd>Select Security Level: Enabled, and Customize, to allow
- incoming: SSH (remote login), WWW (HTTP) and secure WWW
- (HTTPS).
- </dd>
- <dd> Set SELinux to Disabled.</dd>
- <dd> Select OK, and then Quit</dd>
+<p>
+This tool should be used to configure the Firewall and SELinux.
</p>
+<ol>
+ <li>Select Security Level: Enabled, and Customize, to allow
+ incoming: SSH (remote login), WWW (HTTP) and secure WWW
+ (HTTPS).
+ </li>
+ <li>Set SELinux to Disabled.</li>
+ <li>Select OK, and then Quit</li>
+</ol>
<h2>4. <a name="upd">Update your system</a></h2>
<p>
@@ -125,13 +128,12 @@
<p>
Install the scientific_loncapa_yum.conf
</p>
-<p>
<pre>
mv /etc/yum.conf /etc/yum.conf.backup
cp scientific5_loncapa_yum.conf /etc/yum.conf
yum update
</pre>
-</p>
+
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2>
<h3>Import the LON-CAPA encryption key</h3>
<pre>rpm --import http://install.loncapa.org/versions/scientific/RPM-GPG-KEY-loncapa</pre>
@@ -171,7 +173,7 @@
The script will analyze your system to determine which actions are recommended. The script will then prompt you to choose the actions you would like taken.
Once a choice has been entered for all nine possible actions, required changes will be made.
</p>
-<p>The possible actions are:
+<p>The possible actions are:</p>
<ul>
<li>Create the www user/group</li>
<li>Install the package LON-CAPA uses to authenticate users.</li>
@@ -180,11 +182,10 @@
<li>Configure Apache web server</li>
<li>Configure start-up of services</li>
<li>Check firewall settings</li>
-<li>Stop services not used by LON-CAPA,<br />
+<li>Stop services not used by LON-CAPA,<br>
e.g., services for a print server: cups daemon</li>
<li>Download LON-CAPA source code in readiness for installation</li>
</ul>
-</p>
<h3>Determine LON-CAPA Settings</h3>
<p>
LON-CAPA requires a number of identifying parameters to be set in order
@@ -202,7 +203,7 @@
<dd>Each site or school which installs LON-CAPA needs its own domain.
Here at MSU we use 'msu'. You should choose something short but
meaningful. <i>Restriction: One word, no hyphens, underscores, or
- special characters.</i><br />Domain names which include a departmental
+ special characters.</i><br>Domain names which include a departmental
abbreviation are not recommended as although LON-CAPA may start in
a single department, other departments frequently join subsequently.
For a domain name: 'msu' is a superior choice to 'msuphys' for example.
@@ -277,7 +278,7 @@
coordinator. Congratulations!
</p>
-<hr />
+<hr>
<h2>If things aren't working right</h2>
<p>
If you've followed the steps above and the server doesn't start or you think
Index: doc/build/scientific6_install.frag
diff -u doc/build/scientific6_install.frag:1.4 doc/build/scientific6_install.frag:1.5
--- doc/build/scientific6_install.frag:1.4 Sat Nov 26 20:50:29 2011
+++ doc/build/scientific6_install.frag Fri Dec 13 18:10:11 2013
@@ -33,10 +33,10 @@
<li><a href="#log">Log in to LON-CAPA</a></li>
</ol>
-<hr />
+<hr>
<h2>1. <a name="obt">Obtain Scientific Linux 6 CDs</a></h2>
<p>
-Scientific Linux isos can be obtained from links included on the <a href="http://www.scientificlinux.org/download/">Scientific Linux download page</a><br />
+Scientific Linux isos can be obtained from links included on the <a href="http://www.scientificlinux.org/download/">Scientific Linux download page</a><br>
For the minimal install on both 32-bit and 64 bit architecture you will need only the first CD.
</p>
@@ -88,23 +88,26 @@
<dd>Click the "Customize Now" radio button and for a minimal install uncheck all packages except "Base" in the Base System category. If you leave other packages checked in any of the other categories, you'll need additional ISO CDs.</dd>
</dl>
<p>
-
-Finish installing your server, reboot it, and log in as root. The
-first time you log-in, the Setup Agent will be displayed. (If you exit it early you can enter it again by running the command
+Finish installing your server, reboot it, and log in as root.
+</p>
+<h3>Firewall and SELinux Configuration</h3>
+<p>
+The first time you log-in, the Setup Agent will be displayed. (If you exit it early you can enter it again by running the command
+</p>
<pre>
setup
</pre>
- This tool should be used to configure the Firewall and SELinux.
-
- <dt>Firewall Configuration</dt>
-
- <dd>Select Security Level: Enabled, and Customize, to allow
- incoming: SSH (remote login), WWW (HTTP) and secure WWW
- (HTTPS).
- </dd>
- <dd> Set SELinux to Disabled.</dd>
- <dd> Select OK, and then Quit</dd>
+<p>
+This tool should be used to configure the Firewall and SELinux.
</p>
+<ol>
+ <li>Select Security Level: Enabled, and Customize, to allow
+ incoming: SSH (remote login), WWW (HTTP) and secure WWW
+ (HTTPS).
+ </li>
+ <li>Set SELinux to Disabled.</li>
+ <li>Select OK, and then Quit</li>
+</ol>
<h2>4. <a name="upd">Update your system</a></h2>
<p>
@@ -125,13 +128,12 @@
<p>
Install the scientific_loncapa_yum.conf
</p>
-<p>
<pre>
mv /etc/yum.conf /etc/yum.conf.backup
cp scientific6_loncapa_yum.conf /etc/yum.conf
yum update
</pre>
-</p>
+
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2>
<h3>Import the LON-CAPA encryption key</h3>
<pre>rpm --import http://install.loncapa.org/versions/scientific/RPM-GPG-KEY-loncapa</pre>
@@ -180,7 +182,7 @@
<li>Configure Apache web server</li>
<li>Configure start-up of services</li>
<li>Check firewall settings</li>
-<li>Stop services not used by LON-CAPA,<br />
+<li>Stop services not used by LON-CAPA,<br>
e.g., services for a print server: cups daemon</li>
<li>Download LON-CAPA source code in readiness for installation</li>
</ul>
@@ -203,7 +205,7 @@
<dd>Each site or school which installs LON-CAPA needs its own domain.
Here at MSU we use 'msu'. You should choose something short but
meaningful. <i>Restriction: One word, no hyphens, underscores, or
- special characters.</i><br />Domain names which include a departmental
+ special characters.</i><br>Domain names which include a departmental
abbreviation are not recommended as although LON-CAPA may start in
a single department, other departments frequently join subsequently.
For a domain name: 'msu' is a superior choice to 'msuphys' for example.
@@ -278,7 +280,7 @@
coordinator. Congratulations!
</p>
-<hr />
+<hr>
<h2>If things aren't working right</h2>
<p>
If you've followed the steps above and the server doesn't start or you think
Index: doc/build/RHEL5_install.frag
diff -u doc/build/RHEL5_install.frag:1.7 doc/build/RHEL5_install.frag:1.8
--- doc/build/RHEL5_install.frag:1.7 Sun Nov 27 00:47:14 2011
+++ doc/build/RHEL5_install.frag Fri Dec 13 18:10:11 2013
@@ -32,14 +32,14 @@
<li><a href="#sts">Start/Restart services</a></li>
<li><a href="#log">Log in to LON-CAPA</a></li>
</ol>
-<hr />
+
+<hr>
<h2>1. <a name="obt">Obtain Red Hat Enterprise Linux 5 CDs</a></h2>
<p>
RHEL5 CDs can be purchased from Red Hat:
<a href="http://redhat.com/">http://redhat.com/</a>.
For the minimal install on 32-bit architecture you will need only the first CD.
For the minimal install on 64-bit architecture you will need CDs 1, 2, and 4.
-
</p>
<h2>2. <a name="net">Determine Network Settings</a></h2>
@@ -90,23 +90,24 @@
<dd>Click the "Customize Now" radio button and for a minimal install uncheck all packages except "Base" in the Base System category. If you leave other packages checked in any of the other categories, you'll need additional ISO CDs.</dd>
</dl>
<p>
-
Finish installing your server, reboot it, and log in as root. The
first time you log-in, the Setup Agent will be displayed. (If you exit it early you can enter it again buy running the command
+</p>
<pre>
setup
</pre>
- This should tool be used to configure the Firewall and SELinux.
-
- <dt>Firewall Configuration</dt>
-
- <dd>Select Security Level: Enabled, and Customize, to allow
- incoming: SSH (remote login), WWW (HTTP) and secure WWW
- (HTTPS).
- </dd>
- <dd> Set SELinux to Disabled.</dd>
- <dd> Select OK, and then Quit</dd>
+<h3>Firewall and SELinux Configuration</h3>
+<p>
+This tool should be used to configure the Firewall and SELinux.
</p>
+<ol>
+ <li>Select Security Level: Enabled, and Customize, to allow
+ incoming: SSH (remote login), WWW (HTTP) and secure WWW
+ (HTTPS).
+ </li>
+ <li>Set SELinux to Disabled.</li>
+ <li>Select OK, and then Quit</li>
+</ol>
<h2>4. <a name="upd">Update your system</a></h2>
<p>
@@ -127,13 +128,12 @@
<p>
Install the rhel5_loncapa_yum.conf
</p>
-<p>
<pre>
mv /etc/yum.conf /etc/yum.conf.backup
cp rhel5_loncapa_yum.conf /etc/yum.conf
yum update
</pre>
-</p>
+
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2>
<h3>Install prerequisites</h3>
<p> Execute: </p>
@@ -180,7 +180,7 @@
<li>Configure Apache web server</li>
<li>Configure start-up of services</li>
<li>Check firewall settings</li>
-<li>Stop services not used by LON-CAPA,<br />
+<li>Stop services not used by LON-CAPA,<br>
e.g., services for a print server: cups daemon</li>
<li>Download LON-CAPA source code in readiness for installation</li>
</ul>
@@ -203,7 +203,7 @@
<dd>Each site or school which installs LON-CAPA needs its own domain.
Here at MSU we use 'msu'. You should choose something short but
meaningful. <i>Restriction: One word, no hyphens, underscores, or
- special characters.</i><br />Domain names which include a departmental
+ special characters.</i><br>Domain names which include a departmental
abbreviation are not recommended as although LON-CAPA may start in
a single department, other departments frequently join subsequently.
For a domain name: 'msu' is a superior choice to 'msuphys' for example.
@@ -271,13 +271,14 @@
<b>Installing LON-CAPA Dependencies</b>. If you still have errors, please
contact the MSU LON-CAPA group.
</p>
+
<h2>8. <a name="log">Log in to your LON-CAPA Machine</a></h2>
<p>
Point a web browser at your new machine and log in as the domain
coordinator. Congratulations!
</p>
-<hr />
+<hr>
<h2>If things aren't working right</h2>
<p>
If you've followed the steps above and the server doesn't start or you think
Index: doc/build/RHEL6_install.frag
diff -u doc/build/RHEL6_install.frag:1.3 doc/build/RHEL6_install.frag:1.4
--- doc/build/RHEL6_install.frag:1.3 Sun Nov 27 00:45:57 2011
+++ doc/build/RHEL6_install.frag Fri Dec 13 18:10:11 2013
@@ -32,14 +32,14 @@
<li><a href="#sts">Start/Restart services</a></li>
<li><a href="#log">Log in to LON-CAPA</a></li>
</ol>
-<hr />
+
+<hr>
<h2>1. <a name="obt">Obtain Red Hat Enterprise Linux 6 CDs</a></h2>
<p>
RHEL6 CDs can be purchased from Red Hat:
<a href="http://redhat.com/">http://redhat.com/</a>.
For the minimal install on 32-bit architecture you will need only the first CD.
For the minimal install on 64-bit architecture you will need CDs 1, 2, and 4.
-
</p>
<h2>2. <a name="net">Determine Network Settings</a></h2>
@@ -90,23 +90,24 @@
<dd>Click the "Customize Now" radio button and for a minimal install uncheck all packages except "Base" in the Base System category. If you leave other packages checked in any of the other categories, you'll need additional ISO CDs.</dd>
</dl>
<p>
-
Finish installing your server, reboot it, and log in as root. The
first time you log-in, the Setup Agent will be displayed. (If you exit it early you can enter it again buy running the command
+</p>
<pre>
setup
</pre>
- This should tool be used to configure the Firewall and SELinux.
-
- <dt>Firewall Configuration</dt>
-
- <dd>Select Security Level: Enabled, and Customize, to allow
- incoming: SSH (remote login), WWW (HTTP) and secure WWW
- (HTTPS).
- </dd>
- <dd> Set SELinux to Disabled.</dd>
- <dd> Select OK, and then Quit</dd>
+<h3>Firewall and SELinux Configuration</h3>
+<p>
+This tool should be used to configure the Firewall and SELinux.
</p>
+<ol>
+ <li>Select Security Level: Enabled, and Customize, to allow
+ incoming: SSH (remote login), WWW (HTTP) and secure WWW
+ (HTTPS).
+ </li>
+ <li>Set SELinux to Disabled.</li>
+ <li>Select OK, and then Quit</li>
+</ol>
<h2>4. <a name="upd">Update your system</a></h2>
<p>
@@ -127,13 +128,12 @@
<p>
Install the rhel6_loncapa_yum.conf
</p>
-<p>
<pre>
mv /etc/yum.conf /etc/yum.conf.backup
cp rhel6_loncapa_yum.conf /etc/yum.conf
yum update
</pre>
-</p>
+
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2>
<h3>Install prerequisites</h3>
<p> Execute: </p>
@@ -202,7 +202,7 @@
<dd>Each site or school which installs LON-CAPA needs its own domain.
Here at MSU we use 'msu'. You should choose something short but
meaningful. <i>Restriction: One word, no hyphens, underscores, or
- special characters.</i><br />Domain names which include a departmental
+ special characters.</i><br>Domain names which include a departmental
abbreviation are not recommended as although LON-CAPA may start in
a single department, other departments frequently join subsequently.
For a domain name: 'msu' is a superior choice to 'msuphys' for example.
@@ -270,13 +270,14 @@
<b>Installing LON-CAPA Dependencies</b>. If you still have errors, please
contact the MSU LON-CAPA group.
</p>
+
<h2>8. <a name="log">Log in to your LON-CAPA Machine</a></h2>
<p>
Point a web browser at your new machine and log in as the domain
coordinator. Congratulations!
</p>
-<hr />
+<hr>
<h2>If things aren't working right</h2>
<p>
If you've followed the steps above and the server doesn't start or you think
More information about the LON-CAPA-cvs
mailing list