FAQs

You'll find more FAQs on the reSearcher website.

General

What do the various service levels mean?

See Services in the general CUFTS system documentation.

I can't use IP based mapping for my site. Is there another way?

If you can modify the OpenURLs linking into CUFTS you can add a pid field containing the site key like this: pid=<CUFTSsite>key</CUFTSsite>

CUFTS does not currently support referring URL or cookie site mapping, though it could be added. If you can't modify the OpenURL you could try passing all OpenURLs through a simple script at the site which tacks on the pid information.

I logged into my CUFTS system and some menus (local resources, site settings) are missing''''''

You either have not been associated with a site or you have been associated with multiple sites. Use the "Change Site" menu option to pick which site you are actively editting and the menu items will appear. If you have not been associated with any sites, you'll have to ask the administrator to do that.

How do I change my password?

You can change your password in the "Account Settings". It will appear blank, but if you enter a new password in both the "password" and "password (again)" fields it will change it when you click on submit

What kind of statistics are available?'

CUFTS keeps a live count of the number of requests, what journals are requested, and whether a link was resolved. These statistics can all be found live in the "Statistics" section for each site. CUFTS also keeps complete "offline" logs of all requests with full information about the request, what types of links were found to which resources, etc. These logs could be used for more sophisticated statistics. If you have ideas for other useful live statistics, let us know!

We use EZProxy for off-site students; is there a way to make CUFTS send patrons through EZProxy?

Yes, add your EZProxy prefix (like http://proxy.lib.open.edu/login?url=) to the "proxy prefix" field in your site settings. Then check off the "proxy" option on local resources which should be proxies (probably all of them).

We use some other proxy system for off-site students; will CUFTS work with it?

That depends on the proxy system. If the user is already proxied by the time they get to CUFTS, then they will likely remain proxied when following resolved links. If you use some system like referring URLs when connecting to remote resources, then CUFTS will probably not be able to proxy the resource properly at this time. We will look at other ways to get proxying working as they come up.

What's this DOI thing you keep mentioning?

DOI stands for digital object identifier. In short, it's a unique identifier for a piece of intellectual property (journal article, image, etc.). Much more information can be found at http://www.doi.org.

Local Resources

I activated a subset of titles in a resource, but when I looked at it later, all the titles had been activated'''

You've probably turned on auto-activate in the local resource edit screen. This will activate all the resource when you save it or when the title list is reloaded. Turn it off and activate the individual titles you use again.

What happens to titles I've activated when a title list is updated?'

If auto activate is turned on for the local resource, all of the records will be activated again when the title list is updated - including any new records. Titles which have been dropped from the title list will be deleted.

If auto activate is not turned on then records which have not been modified will have their active/inactive status unchanged. New records and changed records will be marked inactive and will have to be activated if they are available to the site. Dropped titles will be deleted.

This means that extra data about titles in a local resource will be dropped if the underlying global title information changes. For this reason, it's a good idea to export data you've entered through the web forms or keep any files you've used to overlay data. Chances are you need to review the data anyway, since if the vendor's list has changed you may now have access to more/less than you did before.

How does de-duping work?

De-duping works by not attempting to resolve links to the same provider at the same service level if a link has already been resolved. Links are resolved in rank order, so the highest ranked link from a provider should be the one shown. This is so that you don't end up with multiple links to essentially the same content if you subscribe to multiple packages from one provider. De-duping does NOT work across providers since content and quality of linking may vary between them.

We subscribe to a resource which is not in CUFTS. How can we get it to work?

First off, you will need to obtain a title list for the resource. If you are happy with journal (or database) level links, you can then follow these instructions. If you would like deeper linking, you'll have to do some Perl coding and create a new resource module. I will document this process further soon! If you think others may find the resource useful, please consider submitting it to us for including in the global resource database!

What does CUFTS stand for?

Nothing, actually. I needed a title when I started the project so I came up with an acronym that we could expand into a full title later. Nobody's come up with a final title, though... any ideas?

Resolving

Why can I only link to journal (TOC, database, etc.) level in some resources?

Some providers' systems do not support linking at all levels. We link as deeply as we can find a way to, sometimes by faking user searches. If you know a way to link deeper to a particular resources than is currently possible in CUFTS, please contact me.

I've activated Science Direct on Elsevier (or another publisher site) but I'm not getting links to the fulltext of articles'''

Elsevier and many other publisher sites rely on DOIs for linking to the article level. Since many OpenURL links do not contain DOIs, CUFTS will need to look them up in CrossRef?. If you're using a resource which uses DOI linking (there's usually a note in the resource details), you will need to enable CrossRef? and rank it higher than those resources using DOIs. Documentation for this process is available here.

I don't like the standard resolver screen. Can I use something else instead?

You're welcome to modify the "main" template in the "CUFTS/templates" directory however you want, however it will change the resolver screen for all CUFTS sites using the system. The next CUFTS version will have site specific templates and use a more sophisticated templating system (Template::Toolkit).

Another option is to write your own display system and have your OpenURLs link to that. You can then pass the OpenURL on to CUFTS and add a pid field asking for the results in XML: pid=<CUFTStemplate>XML</CUFTStemplate>. Parse the XML results from CUFTS and display it however you want!

Title Lists

How can I keep my CUFTS resources up to date?

As we refresh title lists in the main system, we will be posting the title lists we use. You can update your system by downloading the title lists of interest to your sites and loading them into your sytem. We will also periodically release the full global database which you can replace your existing global database with IF you have not made any global resource changes yourself. We will also be investigating better methods of keeping the data synced for future releases.

How often are title lists updated?

As often as we can get to them... however, we are biased towards title lists that COPPUL members will benefit from as they are currently funding development. Aggregator lists tend to be better and loaded more often. Our hope is that as more sites begin using CUFTS, they will be willing to help with securing title lists.

Who is responsible for getting title lists?

For now, Simon Fraser University is collecting and loading title lists with funding from COPPUL. Our hope is that the community will step up and help out with either funding or by taking responsibility for certain title lists

Why does ??? resource not have ISSNs or is missing coverage information?

Some providers cannot provide comprehensive title lists including ISSNs and coverage information. This truly baffles me.

What format are title lists in?

Title lists are in tab delimited format with the first row consisting of field headings.

What are the standard field headings?

The standard headings when using the GenericJournal?, GenericJournalDOI modules or when uploading a local title list to overlay are:

  • title
  • issn
  • e_issn
  • ft_start_date
  • ft_end_date
  • cit_start_date
  • cit_end_date
  • vol_ft_start
  • vol_ft_end
  • iss_ft_start
  • iss_ft_end
  • db_identifier
  • journal_url
  • embargo_days
  • embargo_months
  • publisher
  • abbreviation
  • current_months

System

I prefer MySQL (or some other database) to PostgreSQL, can I use it instead?

Not out of the box, but with some work you could probably port it. There's a couple of PostgreSQL specific things in the code to look at - a view for showing just active resources, and the IP network mapping to sites uses some PostgreSQL specific database types and operators.

I upgraded Class::DBI to a version newer than 0.96 and everything broke'''

Some of the CUFTS code does things specific to the internals of Class::DBI. I've tried to reduce it, but there's still a few things left that could break.

Installation

When I try to view maint.cgi or resolve.cgi, the web browser just shows a bunch of code.

For some reason your web server is not handling .cgi files properly. The most likely problem is that the AddHandler cgi-script .cgi line in your Apache configuration file is commented out. When I try to view maint.cgi or resolve.cgi, I get a forbidden error. Make sure ExecCGI is turned on for the directory. FollowSymLinks? should also be on. Both of these should be set properly in the httpd.conf file which is generated by the install script. Also check that the CUFTS web tree is world readable, and the directories are "executable".

I try to log in, but I just get kicked back to the login prompt

This happens when CUFTS is unable to create a session for the connection and is usually a permissions error. Check the Apache error_log file for more detailed information. The sessions and sessions/lock directories must be writable by the web server. The installation script should have either changed the owner or made them world writable, depending on whether you installed while logged in as root or not. If the owner was changed, make sure that it really matches what Apache is running as (usually nobody or apache). How do I create a PostgreSQL user for CUFTS?

You don't need to create a new PostgreSQL user if you already have a usable account with database creating rights. However, if you want to create one, full documentation can be found here on the PostgreSQL site, but here's a quick rundown.

As root:

  • $ su - postgres
  • $ createuser cuftsuser
  • Shall the new user be allowed to create databases? (y/n) y
  • Shall the new user be allowed to create more new users? (y/n) n
  • CREATE USER
  • $ exit

If you want to use a password for the database user, add a -P after createuser.