Enabling hgLogin

From genomewiki
Revision as of 22:13, 18 June 2012 by Greg (talk | contribs)
Jump to navigationJump to search

Here are the steps necessary to enable the hgLogin CGI on a Genome Browser mirror:

  1. Locate the genome browser configuration file "hg.conf" in your /cgi-bin directory.
  2. Add the statement "login.systemName=hgLogin CGI" to the hg.conf file.
  3. Also in the hg.conf file, change the host value in the "wiki.host" entry to point to your mirror browser.
  4. As an example, the two entries in the hg.conf file for the Genome Browser are: login.systemName=hgLogin CGI wiki.host=genome.ucsc.edu
  5. Since the hgLogin CGI uses the same cookies as mediawiki used to, please do not modify these two configuration parameters:
  6. wiki.userNameCookie=wikidb_mw1_UserName wiki.loggedInCookie=wikidb_mw1_UserID

The fact that the hgSession and hgLogin CGIs use the same cookies that used to be used by mediawiki provides complete backwards compatibility to current mirror sites with sign-in function (via a simulated- or locally-installed mediawiki server).

As long as hgLogin is not enabled, all browser functions and current sign-in functions will work as before.

As always, if you run into difficulties, please do not hesitate to contact our mirror site mail list at genome-mirror@soe.ucsc.edu.