Difference between revisions of "WeBWorK Databases and Map"

From WeBWorK_wiki
Jump to navigation Jump to search
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
''{{UnderConstruction}}
+
{{UnderConstruction}}
'''These instructions should be usable and complete for most users. There are a few sections with comments such as "Note to Pizer --- Update this". If you want to do the things in these sections you are on your own for now but most people don't need these things.'''
+
   
 
<!--
 
<!--
''{{UnderConstruction}}
+
{{UnderConstruction}}
'''These instructions should be usable and complete for most users. There are a few sections with comments such as "Note to Pizer --- Update this". If you want to do the things in these sections you are on your own for now but most people don't need these things.'''
+
 
-->
 
-->
   
These instructions cover the installation of the Ubuntu Linux 18.04 LTS operating system and WeBWorK 2.13 from scratch.
+
These instructions cover the maintenance of the WeBWorK Databases and Map.
  +
  +
  +
== Overview ==
   
Other installation methods (which are faster and easier) include using the WeBWorK install script ww_install (see https://github.com/openwebwork/ww_install), the WeBWorK Live DVD (see [[Installing_from_WW2.13_Ubuntu16.04_Vanilla_LiveDVD]]) or the WeBWorK Virtual Machine Image (see [[Installing_from_WW2.13_Ubuntu16.04_Vanilla_Virtual_Machine_Image]]).
 
  +
There are three WeBWorK databases: "WebWork", "WeBWorK Trial" and "WW Software" and one map "http://webwork.maa.org/wiki/WeBWorK_Sites" together with a listing of WeBWorK sites. To access the databases login at http://forms.maa.org/login.aspx. The login gives one access to many MAA databases so be very careful to only look at and work on the WeBWorK databases. A script (which we have never seen and do not have access to) reads the three databases and using that information generates the map and accompanying list of WeBWorK sites every time the above map page is accessed. If a database gets "corrupted" the script may die and the map will not be generated although usually the list of WeBWorK sites will be generated. If the map is not generated usually the problem is that a recent entry in the "WW Software" databases has an invalid lat/long entry. Other problems such as bad information in the list of WeBWorK sites is usually due to conflicting information in the three databases (it's not clear how the script handles conflicting information). Usually this occurs when a school that was previously hosted at MAA decides to run WeBWorK on their own server. The solution is to inactivate all entries except the correct one which usually means inactivating entries in the "WebWork" and/or "WeBWorK Trial" databases and having one active correct entry in the "WW Software" database. Details on this and on how to keep the lists current are given below.
   
If you are just upgrading WeBWorK, especially if you already have existing WeBWorK courses, see [[Upgrading_WeBWorK_with_Github]].
 
   
== Notation ==
 
   
First some short comments on notation we will be using. We will use <code>&lt;key&gt;</code> to indicate that you should press a specific key (e.g. <code>&lt;Enter&gt;</code>, <code>&lt;Tab&gt;</code>, <code>&lt;F12&gt;</code>, etc.). Sometimes we will also use e.g. <code>&lt;wwadmin password&gt;</code> to indicate you have to enter the wwadmin password.
 
  +
===WW Software Database ===
   
<code>^</code> will indicate the <code>&lt;Ctrl&gt;</code> key so e.g. <code>^X</code> is really shorthand for <code>&lt;Ctrl&gt; &lt;X&gt;</code>, i.e. press the Ctrl key and hit the X key.
 
  +
Once or twice a year I will go through the whole database looking for errors, missing information, etc.
   
== Installing the Ubuntu 18.04 Linux Operating System ==
 
  +
Select the WW Software database and then "View All". The URL ends with "&viewby=50" meaning you are viewing 50 entries. I usually change this to "&viewby=5000" so all entries are displayed. Click on "Date" at the top of the column and the entries will be sorted by date. Scroll to the bottom to see the latest entries. Here you will often find problems. For example if the map is not being displayed, look for bad entries, especially errors in the Lat/Long field. Typically bad entries are entries with non-numerical characters, e.g quotes or letters such as N, S E, W. Also you will probably see a lot of entries with missing Lat/Long entries. You can add them now (more on this below) but what I usually do is to first click on "University" at the top of the column to sort entries alphabetically. Then slowly scroll down. Often people setting up a new version of WeBWorK will register which will create multiple entries. If you see multiple entries you can delete all but one (I often keep the oldest checking that the info is still correct). Also you can enter any missing Lat/Long's. To edit an entry click on the row, then select "edit".
   
===Installation DVD ===
 
Obtain the <code>Desktop Edition</code> installation DVD/CD set. Connect to http://www.ubuntu.com/ for information. For example you can download an ISO image of the installation DVD and then burn your own installation DVD. You want the file <code>ubuntu-18.04-desktop-amd64.iso</code>. '''Note 1:''' We recommend you use the "Long Term Support" (LTS) version of Ubuntu which is currently version 18.04; the next LTS release will be version 20.04 to be released in April, 2020. '''Note 2:''' We recommend you actually use the latest 18.04 iso file which is currently <code>ubuntu-18.04-desktop-amd64.iso</code>. Choose which ever download site works best for you; I have had good luck with http://mirrors.kernel.org/ubuntu-releases/ If you download the ISO image, make sure that you verify the integrity of the downloaded file by comparing the MD5 checksum of the downloaded file with the MD5 checksum listed at https://help.ubuntu.com/community/UbuntuHashes or at the download site (e.g. http://mirrors.kernel.org/ubuntu-releases/18.04). These instructions will assume you have the <code>ubuntu-18.04-desktop-amd64.iso</code> installation DVD but installing from an alternate DVD, a commercial DVD/CD set or from the net should be essentially identical.
 
   
You will want to have you computer connected by ethernet to the internet for the installation. Place the installation CD in your DVD/CD drive and reboot your computer from the DVD drive. You may have to press a key (e.g. <code>&lt;F12&gt;</code>) during the boot process to bring up a boot menu which will allow you to select booting from the DVD. Or you many have to edit the BIOS to select the DVD as the first boot device. See https://help.ubuntu.com/community/BootFromCD for help.
 
  +
===Hint if the map does not display ===
   
After the system boots you will be presented with a series of 7 steps.
 
  +
Select the WW Software database and then "View All". The URL ends with "&viewby=50" and change this to "&viewby=5000" so all entries are displayed.
  +
The click on "Latitude/Longitude" and scroll down through the listing looking for bad entries as described above.
   
;Step 1
 
  +
====Finding Lat/Long's====
: On the first install panel keep English as the selected language and click <code>Install Ubuntu</code>, the second (to the right) option.
 
  +
For "Latitude/Longitude" enter the Latitude and Longitude of the institution using the format 43.112889,-77.633944. The best way to find this is to search on Google Maps for the institution, right click on the resulting pin and select "What's here". Under the search box, an info card with coordinates will appear (Or you may have to click on the coordinates for an info box with a copyable version of the coordinates to appear). Then copy the numbers that appear. Note that on older versions of Google Maps, the coordinates will appear in the search box at the top of the page.
;Step 2
 
: Just hit <code>Continue</code> on the next page
 
   
 
===Optional Configurations===
 
===Optional Configurations===

Latest revision as of 15:04, 22 September 2019

Construction.png This article is under construction. Use the information herein with caution until this message is removed.


These instructions cover the maintenance of the WeBWorK Databases and Map.


Overview

There are three WeBWorK databases: "WebWork", "WeBWorK Trial" and "WW Software" and one map "http://webwork.maa.org/wiki/WeBWorK_Sites" together with a listing of WeBWorK sites. To access the databases login at http://forms.maa.org/login.aspx. The login gives one access to many MAA databases so be very careful to only look at and work on the WeBWorK databases. A script (which we have never seen and do not have access to) reads the three databases and using that information generates the map and accompanying list of WeBWorK sites every time the above map page is accessed. If a database gets "corrupted" the script may die and the map will not be generated although usually the list of WeBWorK sites will be generated. If the map is not generated usually the problem is that a recent entry in the "WW Software" databases has an invalid lat/long entry. Other problems such as bad information in the list of WeBWorK sites is usually due to conflicting information in the three databases (it's not clear how the script handles conflicting information). Usually this occurs when a school that was previously hosted at MAA decides to run WeBWorK on their own server. The solution is to inactivate all entries except the correct one which usually means inactivating entries in the "WebWork" and/or "WeBWorK Trial" databases and having one active correct entry in the "WW Software" database. Details on this and on how to keep the lists current are given below.


WW Software Database

Once or twice a year I will go through the whole database looking for errors, missing information, etc.

Select the WW Software database and then "View All". The URL ends with "&viewby=50" meaning you are viewing 50 entries. I usually change this to "&viewby=5000" so all entries are displayed. Click on "Date" at the top of the column and the entries will be sorted by date. Scroll to the bottom to see the latest entries. Here you will often find problems. For example if the map is not being displayed, look for bad entries, especially errors in the Lat/Long field. Typically bad entries are entries with non-numerical characters, e.g quotes or letters such as N, S E, W. Also you will probably see a lot of entries with missing Lat/Long entries. You can add them now (more on this below) but what I usually do is to first click on "University" at the top of the column to sort entries alphabetically. Then slowly scroll down. Often people setting up a new version of WeBWorK will register which will create multiple entries. If you see multiple entries you can delete all but one (I often keep the oldest checking that the info is still correct). Also you can enter any missing Lat/Long's. To edit an entry click on the row, then select "edit".


Hint if the map does not display

Select the WW Software database and then "View All". The URL ends with "&viewby=50" and change this to "&viewby=5000" so all entries are displayed. The click on "Latitude/Longitude" and scroll down through the listing looking for bad entries as described above.

Finding Lat/Long's

For "Latitude/Longitude" enter the Latitude and Longitude of the institution using the format 43.112889,-77.633944. The best way to find this is to search on Google Maps for the institution, right click on the resulting pin and select "What's here". Under the search box, an info card with coordinates will appear (Or you may have to click on the coordinates for an info box with a copyable version of the coordinates to appear). Then copy the numbers that appear. Note that on older versions of Google Maps, the coordinates will appear in the search box at the top of the page.

Optional Configurations