home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / comp / infosyst / gopher / 2036 < prev    next >
Encoding:
Internet Message Format  |  1993-01-21  |  14.1 KB

  1. Path: sparky!uunet!nevada.edu!jimi!equinox!pyramid!foster
  2. From: foster@pyramid.unr.edu (Steve Foster)
  3. Newsgroups: comp.infosystems.gopher
  4. Subject: FAQ for veronica
  5. Message-ID: <5272@equinox.unr.edu>
  6. Date: 22 Jan 93 00:14:42 GMT
  7. Sender: news@equinox.unr.edu
  8. Organization: University of Nevada, Reno  Department of Computer Science
  9. Lines: 314
  10.  
  11. Hello gopher-pholks --
  12.  
  13. We have written a draft FAQ for veronica.  It reflects the questions we
  14. have been getting via email at Nevada, and to a lesser extent the queries
  15. that have been posted to this list.
  16.  
  17. Please send us more questions for the FAQ.
  18.  
  19. Enjoy,
  20. Steve Foster and Fred Barrie
  21.  
  22. FAQ follows:
  23. --------------------------------------------------------------------------
  24.  
  25. Common Questions and Answers about veronica, a title search and retrieval
  26. system for use with the Internet Gopher.
  27.  
  28. The current version of this FAQ can be retrieved through gopher at
  29. veronica.scs.unr.edu, in the veronica directory.
  30.  
  31. Archive-name: veronica-faq
  32. Last-modified:  1993/01/21.
  33. --------------------------------------------------------------------------
  34.  
  35. List of questions in the veronica FAQ:
  36.  
  37. Q0: What is veronica?
  38. Q1: How can I connect to veronica?
  39. Q2: How can I get information about a site?
  40. Q3: Why do I need to use 'item descriptor' to get context and host info?
  41. Q4: How can I get my server into the veronica database?
  42. Q5: How can I keep my server out of the veronica database?
  43. Q6: How often is the database updated?
  44. Q7: Where can I get the software to run veronica?
  45. Q8: Where can I get the veronica dataset?
  46. Q9: Why can't I get a reply from a veronica server?
  47. Q10: What does "veronica" mean?
  48. Q11: Why doesn't my server show up in veronica searches?
  49.  
  50.  
  51. --------------------------------------------------------------------------
  52. Q0:        What is veronica?
  53.  
  54. A0:    veronica is a service that indexes titles of gopher items.  
  55.     veronica servers provide keyword searches of titles of gopher 
  56.     items.  A veronica search typically searches the menus of hundreds
  57.     of gopher servers, perhaps all the gopher servers that are announced
  58.     to the Internet.
  59.  
  60.     At present, there are no "veronica clients" per se;  veronica is 
  61.     accessed through normal gopher clients.   veronica is tightly integrated
  62.     with the gopher protocol.
  63.  
  64.     The veronica service is comprised of two functions:  
  65.     1). Harvesting menu data from gopher servers, and preparing it for use;
  66.     2). Offering searches of that database to gopher clients.   
  67.     These two functions are not necessarily provided by the same host
  68.     computer.  Most users and administrators of veronica search servers
  69.     will not need to be concerned with the first phase of the process.
  70.     Operators of veronica query-engines can obtain a prepared dataset 
  71.     for use with the query server ( Q8 below ).
  72.  
  73.     veronica evolved as a solution to the problem of resource discovery 
  74.     in the rapidly-expanding gopher meta-burrow.  At the University of 
  75.     Nevada, there was an outcry for an easy way to find gopher-based 
  76.     information without doing a menu-by-menu, site-by-site search.
  77.  
  78. --------------------------------------------------------------------------
  79. Q1:    How can I connect to veronica?
  80.  
  81. A1:    veronica must be accessed through a gopher client.  
  82.     Assuming you have a gopher client, use it to connect to a gopher
  83.     server which offers a link to a veronica server.  
  84.  
  85.     If your local gopher server does not already have a link to veronica, 
  86.     use gopher to go to the server at gopher.micro.umn.edu ( port 70 ). 
  87.     Choose the menu item "Other Gopher and Information Servers".  
  88.     Choose veronica from that menu.  In step-by-step form it is like this:
  89.  
  90.     1. gopher to gopher.micro.umn.edu  by typing:
  91.         gopher gopher.micro.umn.edu 70 
  92.        Note that this is a unix-client example. Other clients will 
  93.        have a different way of specifying the server.
  94.     
  95.     2.  go to the directory named 
  96.         "8.  Other Gopher and Information Servers/"
  97.  
  98.     3.  select that item
  99.  
  100.     4.  go to the item named 
  101.         "2.  Search titles in Gopherspace using veronica/"
  102.  
  103.     5.  select that item.  This item is a gopher link to the veronica 
  104.         directory at the University of Nevada.
  105.     
  106.     6.  There are two searches currently (1-21-93) in this directory:
  107.         "1.  Search gopherspace by _SINGLE_ keyword veronica <?>"
  108.         "2.  Search gopherspace by _partial Boolean_ veronica <?>"
  109.     
  110.     When you choose either search item,  you will be prompted to
  111.     enter a keyword or keywords to define your title search.
  112.     There are at present two versions of the veronica search-engine.  
  113.     One version uses the NeXT's Digital Librarian and accepts only a 
  114.     SINGLE word to search for.  The second version uses the WAIS index 
  115.     with Gilbert's Boolean extensions; this version can accept limited 
  116.     Boolean specifications.   The veronica directory contains a 
  117.     help-file about the format of the Boolean queries.  veronica queries
  118.     are not case-sensitive.
  119.  
  120.     The veronica server will return a gopher menu composed of items
  121.     whose titles match your keyword specification.  These items are
  122.     culled from the menus of (potentially) many gopher servers. 
  123.     As with any gopher menu, you access an item of interest by 
  124.     double-clicking it or hitting the <return> key.
  125.  
  126.     If you want to include veronica service on the menu of your local 
  127.     gopher server,  you can find the gopher-item-descriptor for veronica 
  128.     from this menu at Minnesota;  ask the administrator of your local 
  129.     gopher server to include a link to that item on your local menu.
  130.  
  131.  
  132.     If you DO NOT have a gopher client, you may access gopher and
  133.     veronica by telneting to one of the telnet-accessible anonymous
  134.     gopher clients.  This is what the Gopher-FAQ has to say about the
  135.     telnet sites for gopher:
  136.  
  137.     ***
  138.     Here is a short list, use the site closest to you to minimize
  139.          network lag.
  140.  
  141.      Hostname                  IP#              Login   Area
  142.      ------------------------- ---------------  ------  -------------
  143.      consultant.micro.umn.edu  134.84.132.4     gopher  North America
  144.      gopher.uiuc.edu           128.174.33.160   gopher  North America
  145.      panda.uiowa.edu           128.255.40.201   panda   North America
  146.      info.anu.edu.au           150.203.84.20    info    Australia
  147.      gopher.chalmers.se        129.16.221.40    gopher  Sweden
  148.  
  149.      It is recommended that you run the client software instead of
  150.      logging into the public telnet login sites.  A client uses the
  151.      custom features of the local machine (mouse, scroll bars, etc.)  A
  152.      local client is also faster. 
  153.  
  154.     *** end of inclusion from gopher-faq
  155. --------------------------------------------------------------------------
  156. Q2:     So I get a list of titles; How can I get information about 
  157.     the location of items I am interested in?
  158.  
  159. A2:    Most gopher clients offer a "get information" command or an
  160.     "item descriptor" menu choice.  On a macintosh it usually is 
  161.     "command i"; on a unix client it will be an equal sign "="; 
  162.     on a NeXT it also is a "command i".  This key sequence will give 
  163.     information about the current item on the gopher menu.  The item-
  164.     description will include the hostname of the gopher server which
  165.     provides the item.  The item description also includes the 
  166.     path (directory) of the item on its gopher server.
  167.  
  168.  
  169. --------------------------------------------------------------------------
  170. Q3:    Why do I need to use "item descriptor" to get host and context
  171.     information?
  172.  
  173. A3:    One simple answer to this is that three-times as many lines 
  174.     would be needed on the screen to provide host and path information
  175.     as well as title information.  The menus returned by veronica are
  176.     often lengthy, even without this information.  Since the item-
  177.     description function is included in most gopher clients, its use 
  178.     makes for more compact screens.
  179.  
  180.     There is a deeper answer, of course ...
  181.  
  182.     The veronica server is designed to work with the query-type item
  183.     of all gopher clients.  It can only return one set of data 
  184.     in reply to each query, in accord with the gopher protocol.  There
  185.     is no chance for further negotiation between the client and server.
  186.     The veronica-search server could return visible lines about the
  187.     host and context of each item, but it would need to do so for all 
  188.     items, tripling the size of the return as mentioned above.  The 
  189.     only alternative is to design special gopher CLIENTS which  either
  190.     submit a follow-up query to the veronica server, requesting more
  191.     information, or which present the item-descriptor in more palatable
  192.     format.   Work is underway to define a client-server negotiation
  193.     protocol to allow followup queries, using the gopher+ clients and
  194.     servers.  Meanwhile, clients just are not capable of this feature.
  195.  
  196.     And deeper yet ...
  197.  
  198.     Context means many things ...  Is it adequate to know the host, path
  199.     and type of an item, or do you want to know the last update time,
  200.     the number of links to that item in the entire gopher network, 
  201.     a unique internet-id for that data item, the names of veronica servers 
  202.     referencing that item, and so forth?  The gopher+ protocol and other
  203.     emerging protocols will allow us to maintain some of this information.
  204.     The veronica developers at Nevada feel that it is preferable to use
  205.     these standards as they become available, rather than to define
  206.     ad-hoc document identifiers, etc. which are specific only to veronica.
  207.  
  208. --------------------------------------------------------------------------
  209. Q4:    How can I get my server into the veronica database?
  210.  
  211. A4:    Explicit registration is generally not required.  The veronica 
  212.     data-collection software will find your gopher server IF it is
  213.     registered with the Mother Gopher at Minnesota, OR IF it is 
  214.     referenced on the menu of another gopher server which is registered
  215.     at Minnesota.  Of course, the veronica data-harvesting algorithm 
  216.     will not be able to access your server if you have restricted access 
  217.     to your local site.
  218.  
  219. -----------------------------------------------------------------------------
  220. Q5:    How can I keep my server OUT of the veronica database?
  221.  
  222. A5:    Sometimes gopher-administrators do not want their site to be
  223.     indexed. The administrator of such a server will need to mail to
  224.     gophadm@veronica.scs.unr.edu, and request their site not be included.
  225.  
  226.     This design is based on the well-founded assumption that any 
  227.     registered gopher server, or a server accessible via the menu of
  228.     a registered server, is intended to be accessible to users at any
  229.     internet node.  The gopher protocol achieves its utility through
  230.     this sort of sharing; gopher servers are provided with the "-s" 
  231.     option should it be necessary to implement site restrictions.
  232.  
  233.     With the implementation of Gopher+ protocols, the veronica+ 
  234.     protocol will allow gopher administrators to set a
  235.     "veronica-index-off" flag. 
  236.  
  237. -------------------------------------------------------------------------- 
  238. Q6:    How often is the database updated?
  239.  
  240. A6:    Heretofore, the database was updated every two weeks.  A lot of 
  241.     network traffic is generated by the indexing process.  We at U. Nevada
  242.     thought it not optimal to index more frequently.  Most likely, we
  243.     will index more often in future.
  244.  
  245.     The veronica development team is working on a standard protocol
  246.     for locally-generated indexes, and a standardized method for
  247.     collating these indexes at a central data site.  The post-processed
  248.     dataset will then be redistributed to sites running veronica
  249.     query-engines.  This approach will greatly reduce the number of
  250.     gopher-walks and gopher-trees necessary to supply all veronica sites
  251.     with data.
  252.  
  253. --------------------------------------------------------------------------
  254. Q7:    Where can I get the software to run veronica?
  255.  
  256. A7:    The NeXT-specific veronica retrieval software can be obtained
  257.     by anonymous ftp from veronica.scs.unr.edu, in the "veronica"
  258.     subdirectory.
  259.  
  260.     The veronica development team is finishing up the WAIS indexing
  261.     programs and will have the software available via anonymous ftp
  262.     hopefully by the end of January 93.
  263.  
  264.     The WAIS-veronica distribution will include small modifications to
  265.     the WAIS index builder, as well as a WAIS-index query engine.    
  266.  
  267.     The WAIS-indexed version is prefered for three reasons:
  268.     1.  runs on more platforms.
  269.     2.  runs faster. 
  270.     3.  allows partial Boolean searches.
  271.  
  272. --------------------------------------------------------------------------
  273. Q8:    Where can I get the veronica data set?
  274.  
  275. A8:    You can anonymous-ftp the full veronica dataset from 
  276.     veronica.scs.unr.edu, in the "veronica" subdirectory.
  277.  
  278.     This data has been processed to eliminate redundant references,
  279.     to avoid loops in the gopher network, and to remove most data
  280.     that is known to be highly transient.
  281.  
  282.     If you are trying to set up a veronica server, PLEASE take a
  283.     copy of this data, rather than initiating more gopher-tree
  284.     processes.
  285.  
  286. ---------------------------------------------------------------------------
  287. Q9:    Why can't I get a reply from a veronica server?
  288.  
  289. A9:    The most common problem is that the gopher client "hangs" because 
  290.     the  results of the veronica search includes items of some type
  291.     not recognized by the client.
  292.  
  293.     For example, a search will commence and there is some indication 
  294.     that it is working, like a spinning wheel on a Mac or on a Unix client.
  295.     However, when the wheel stops spinning the Gopher client says 
  296.     "Nothing  available".
  297.  
  298.     The problem is that some gopher clients can not handle certain objects
  299.     (e.g., a PC client is unable to understand a Unix sound file).
  300.     Many clients are written to treat as empty any directories containing
  301.     non-standard or unrecognized datatypes.
  302.  
  303.     The solution will be in the Gopher+ protocol.   That protocol
  304.     will allow a client and server to have a "conversation" about
  305.     what types of data the client can and cannot handle.
  306.  
  307. ---------------------------------------------------------------------------
  308. Q10:    What does "veronica" mean?
  309.  
  310. A10:    very easy rodent-oriented net-wide index to computerized archives.
  311.  
  312. ---------------------------------------------------------------------------
  313. Q11:    Why doesn't my server show up in veronica searches?
  314.  
  315. A11:    Most commonly this is because your server was not accessible during
  316.     the time we last collected data.  We will now preserve older data
  317.     files, and use them in lieu of current data for those servers that
  318.     cannot be reached during the data harvest.
  319.  
  320.     Be sure your server is registered with the Mother of Gophers, or is
  321.     referenced on the menu of a server which IS registered.  Be sure you
  322.     have not restricted off-site access.
  323.  
  324.     If these don't work, send mail to gophadm@veronica.scs.unr.edu
  325.