WILMA: Web Information-List Maintenance Agent (version 1.xMN) ---------------------------------------------------------------------------- Copyright 1997 by Mark Nottingham This is derivative software; see wilma.license for more information. Original Copyright © 1995 by E-Doc WILMA Development Team: Andrew Williams and Daniel K. Appelquist ---------------------------------------------------------------------------- Running WILMA Once the wilma.conf file is set up correctly, and the various directories and files are in the right places, you may begin adding information to the WILMA database. From your web browser, invoke the index URL. Input information into the given form and press the Preview button. You will then see what this item will look like (both the short description and the full description). If you are not satisfied, step back with your browser, edit and preview again. Once you like the preview, submit it to the database by hitting the Submit button. Alternatively, you can add items from the command line; see below. Now, invoke the wilma-admin script in the same way that you invoked the wilma script. You should see the header or header file you defined in your wilma.conf file under $adminHead followed by a summary of the new item you just entered. You may immediately approve or delete the item by clicking the Approve button or the Delete button. You may also view the full description for this item by clicking the Display button. If you want to make changes to this item before it goes into the database, click the Edit / Approve button (see below). You also have the opportunity to approve or delete or edit the new item while looking at the full description. Follow the above directions to enter items into your database. To get a list of items from a specific category out of WILMA, invoke WILMA with that category's abbreviation (wilma/mfi, for example). Because of the structure of Wilma, you can change most of the runtime configurations and any of the template files without effecting the database. ---------------------------------------------------------------------------- Editing Items in the WILMA Database There are two points at which items in the WILMA database may be edited: 1) before approval and 2) after approval. 1. Editing Before Approval To edit an item before it has been approved, click on the Edit / Approve button corresponding to the item in the admin area. You will be presented with a form (much like the WILMA addition form) with all the information already filled in. From here, you can edit the item and approve it into the database (by clicking the Re-Submit / Approve button). 2. Editing After Approval To edit items which have already been posted to the database, click the Edit Currently Posted Items button on the Admin page. You will be presented with a list of categories. Clicking on one of the categories will bring up a list of items in that category. From there, you can edit an item by clicking on its title, or delete an item or items by clicking on the checkboxes to the left of the titles and clicking the "Delete Marked Items" button below the listing. ---------------------------------------------------------------------------- Deleting Items from the WILMA Database Deletion is performed through the WILMA admin script (see above). ---------------------------------------------------------------------------- Searching the WILMA Database The search script currently is set up to take method GET data from an HTML form. An example of this is in the sample.html file. You must have the shellwords.pl library. You must also have Swish installed and running, and have already created a swish index file of all the files in your DATA directory. Swish may be found at http://www.eit.com/software/swish/. ---------------------------------------------------------------------------- Adding Items Interactively from the Command Line wilma-parse now allows you to interactively add items to the database. This makes it much easier to seed a database with entries. Invoke it like this (in the admin/ directory); wilma-parse -i To use this, you must have already configured wilma.conf, and you must have write permission to the data/ directory and dbm files (if they exist). The script will ask you for each field in turn, and then ask whether you wish to approve the item to go in. Once you are done, double check to see that the database, data files and data/ directory are writable and readable by the Web user. If you have user editing turned on, items added in this manner will not be editable from the Web. ---------------------------------------------------------------------------- Recovering the database with wilma-parse Since Wilma 1.3MN, all actions effecting the approved database are logged to a logfile in the data directory. If the database becomes corrupted, you can recover it to its previous state by using wilma-parse. To use wilma-parse, simply invoke it like this; ./wilma-parse -l infile outfile where infile is the name of the logfile and outfile is the name of the database you wish to create. For instance, to recreate a database from approvedSubs.log (assuming you are in the same directory as wilma-parse, and the logfile is also), try ./wilma-parse -l approvedSubs.log temp wilma-parse will tell you if it was successful, and the resulting file will be called temp.db. You can then copy the database to your data directory to use it. Remember that the database file must be both readable and writable by the Web server user.