56a991e6955fd5893f29a4e215dd0cb1042a14c4
brianlee
  Mon Nov 4 13:41:40 2024 -0800
Adding note about SSPsyGene server SetEnvIf Authorization step, requested by Max 11/4/24

diff --git src/hg/cirm/cdw/README src/hg/cirm/cdw/README
index 7bb8373..cdd6a7e 100644
--- src/hg/cirm/cdw/README
+++ src/hg/cirm/cdw/README
@@ -75,30 +75,54 @@
         ./restartDaemons
 
 At this point they'll be restarted.  If the daemons are working, the next thing to do is look at the recent entries in the cdwSubmit, cdwSubmitJob and cdwJob tables.   Look in the errorMessage and stderr fields.
 
 SETTING UP THINGS FOR WEB BROWSER APP
 ---------------------------------------
 There's some things that need to happen after the majority of the database is made by the validation
 daemon and cdwSubmit.  
 
 o - Run cdwMakeFileTags now to create cdwFileTags table
 o - Run cdwTextForIndex in /gbdb/cdw to create full text for free index search
 o - Run ixIxx to make the full text index in /gbdb
 o - You *might* need to run cdwChangeAccess to update the accessibility to make things
     group readable, (or if the access all tag is intended but left off, world readable)
 
+TROUBLE_SHOOTING SETTING UP LOGIN
+---------------------------------
+The site requires HTTP login to access, and the first step is to put the same type
+of basicAuth apache config statements for a new server as the last server. In
+the apache config on the previous server there is a user/password file. An easy approach
+is to copy the existing username/password file to the new server. A script called
+cdwWebsiteAcess, a wrapper around htpasswd, can be used with the user/password file.
+
+Or you can use these commands to add a user to the file  /etc/httpd/passwords on the new machine.
+
+htpasswd passwordfile username
+
+         htpasswd /etc/httpd/passwords -n bob
+         New password:
+         Re-type new password:
+
+A line like this will be added to /etc/httpd/passwords where that password is encrypted.
+bob:$apr1$Xd2b1SuY$T17QLQnFyaH1fQrcVjDjg0
+
+Once the user exists the Apache settings also have to be enabled feeding the
+authorization back into the site. Request the following edit to httpd.conf:
+
+        SetEnvIf Authorization .+ HTTP_AUTHORIZATION=$0
+
 
 COMMAND LINE USAGE
 
 SUBMITTING NEW DATA FILES
 --------------------------------------------------------------------------------
 $ cdwSubmit 
 
 cdwSubmit - Submit URL with validated.txt to warehouse.
 usage:
    cdwSubmit email /path/to/manifest.tab meta.tag
 options:
    -update  If set, will update metadata on file it already has. The default behavior is to
             report an error if metadata doesn't match.
    -noRevalidate - if set don't run revalidator on update
    -md5=md5sum.txt Take list of file MD5s from output of md5sum command on list of files