1c52aaa92828b6ecc18dd5800fe6650b91daf696
max
  Fri Sep 18 07:22:10 2026 -0700
hgSession: the new Sessions page also lists the sessions saved on our other servers

#Preview2 week - bugs introduced now will need a build patch to fix
Every geo mirror node keeps its own namedSessionDb, so a session saved on
genome-euro is invisible on genome.ucsc.edu and people do not find it again.
The table now holds the sessions from every node, with a new Server column
saying where each one lives, and the session name links to the server that
holds it.

Two new hgSession actions, both answered in main() before the cart is built,
so that a request from another node leaves no cart, userDb or sessionDb row
behind:

hgS_doSessionListJson  returns this server's sessions for the user named by
the login cookie, as JSON.  This is what the other
nodes call.
hgS_doMirrorSessions   asks every other gbNode for that list and returns
what came back.  It sends all of the requests before
reading any of the answers, so the wait is the
slowest node rather than the sum of them.

The fetch goes through our own server rather than from the browser to the
other nodes, which keeps cross-origin requests out of it: apache handles the
CORS headers differently on every node, and the two mirrors are administered
by Bielefeld and RIKEN, while CGI code reaches them with the release.  The
user's login cookies, and only those, are passed on (wikiLinkLoginCookieHeader),
which works because the nodes share a cookie salt.

The page never waits for any of this: the table is drawn from this server's
own sessions and the rows from the other servers are merged in as they
arrive, keeping the current sort, search and page.  A node that does not
answer, times out, or runs a release without the endpoint is named in a line
under the toolbar instead, and costs nothing else.

Sessions from another server are shown but not managed here: no Share, Edit,
Overwrite or Delete, no bulk-select checkbox, and the Update now shortcut
keeps ignoring them.  Table rows are keyed by a new uid rather than by the
session name, since the same name can now be in the table twice, once per
server.

geoMirrorThisNode() and geoMirrorOtherNodes() read the node list from the
hgcentral gbNode table, so nothing new has to be configured: browser.node
already says which node a server is.

diff --git src/hg/hgSession/hgSession.h src/hg/hgSession/hgSession.h
index 691f0b354b1..3afb807b491 100644
--- src/hg/hgSession/hgSession.h
+++ src/hg/hgSession/hgSession.h
@@ -1,120 +1,126 @@
 /* hgSession - Manage information associated with a user identity. */
 
 /* Copyright (C) 2008 The Regents of the University of California 
  * See kent/LICENSE or http://genome.ucsc.edu/license/ for licensing information. */
 
 #ifndef HGSESSION_H
 #define HGSESSION_H
 
 /* NOTE: some of the original contents have been moved up to cart.h for 
  * sharing with hgTracks. */
 
 #include "cart.h"
 
 /* Global variables - generally set during initialization and then read-only. */
 extern struct cart *cart;	/* This holds cgi and other variables between clicks. */
 extern char *database;		/* Current database, often but not always dbDatabase. */
 
 /* hgSession form inputs */
 #define hgsNewSessionName hgSessionPrefix "newSessionName"
 #define hgsNewSessionShare hgSessionPrefix "newSessionShare"
 #define hgsNewSessionDescription hgSessionPrefix "newSessionDescription"
 #define hgsDoNewSession hgSessionPrefix "doNewSession"
 
 // AJAX endpoint behind the "Share a link" menu button (see topLinks.js).  hgsShareAnon (when
 // set, or when no user is logged in) saves under the reserved anonymous user "l".
 #define hgsDoSaveSessionJson hgSessionPrefix "doSaveSessionJson"
 #define hgsShareAnon hgSessionPrefix "shareAnon"
 // AJAX endpoint that reserves (server-generates) a unique anonymous snapshot name and returns it as
 // JSON without saving, so the Share dialog can preview the exact link before the user commits.
 #define hgsDoAnonName hgSessionPrefix "doAnonName"
 // When set, doSaveSessionJson returns {"exists": true} instead of overwriting a session the logged-in
 // user already has under the requested name, so the Share dialog can warn before clobbering it.
 #define hgsFailIfExists hgSessionPrefix "failIfExists"
 // When set to a registered snapshotType (e.g. "blat"), doSaveSessionJson saves a lightweight
 // "snapshot" session holding only that feature's declared cart vars (see lib/snapshotSession.c)
 // instead of the whole cart.  The stored name is forced to the "__" snapshot prefix.
 #define hgsSnapshotType hgSessionPrefix "snapshotType"
 // Rename an existing session (hgsOldSessionName -> hgsNewSessionName) for the "Specify name" step.
 #define hgsDoRenameSessionJson hgSessionPrefix "doRenameSessionJson"
 
 // AJAX endpoints for the experimental client-rendered Sessions page (hgSession.js).  Each acts on
 // the session named by hgsOldSessionName (decoded) under the current user and returns JSON instead
 // of re-rendering the whole page.  All are covered by the hgsDo prefix in cleanHgSessionFromCart.
 #define hgsDoDeleteJson hgSessionPrefix "doDeleteJson"
 #define hgsDoShareJson hgSessionPrefix "doShareJson"
 #define hgsDoGalleryJson hgSessionPrefix "doGalleryJson"
 #define hgsDoOverwriteJson hgSessionPrefix "doOverwriteJson"
 #define hgsDoDescribeJson hgSessionPrefix "doDescribeJson"
+/* Asked for by hgSession.js on another mirror node; answered without a cart, see
+ * doSessionListJson(). */
+#define hgsDoSessionListJson hgSessionPrefix "doSessionListJson"
+/* Asked for by this server's own hgSession.js; fetches the above from every other node, see
+ * doMirrorSessionsJson(). */
+#define hgsDoMirrorSessions hgSessionPrefix "doMirrorSessions"
 
 #define hgsSharePrefix hgSessionPrefix "share_"
 #define hgsGalleryPrefix hgSessionPrefix "gallery_"
 #define hgsEditPrefix hgSessionPrefix "edit_"
 #define hgsLoadPrefix hgSessionPrefix "load_"
 #define hgsDeletePrefix hgSessionPrefix "delete_"
 
 #define hgsShowDownloadPrefix hgSessionPrefix "showDownload_"
 #define hgsMakeDownloadPrefix hgSessionPrefix "makeDownload_"
 #define hgsDoDownloadPrefix hgSessionPrefix "doDownload_"
 
 #define hgsSaveLocalBackupFileName hgSessionPrefix "saveLocalBackupFileName"
 #define hgsSaveLocalFileName hgSessionPrefix "saveLocalFileName"
 #define hgsSaveLocalFileCompress hgSessionPrefix "saveLocalFileCompress"
 #define hgsDoSaveLocal hgSessionPrefix "doSaveLocal"
 
 #define hgsLoadLocalFileName hgSessionPrefix "loadLocalFileName"
 #define hgsDoLoadLocal hgSessionPrefix "doLoadLocal"
 
 #define hgsLoadUrlName hgSessionPrefix "loadUrlName"
 #define hgsDoLoadUrl hgSessionPrefix "doLoadUrl"
 
 #define hgsDoMainPage hgSessionPrefix "doMainPage"
 
 #define hgsDoSessionDetail hgSessionPrefix "doSessionDetail"
 #define hgsOldSessionName hgSessionPrefix "oldSessionName"
 #define hgsDoSessionChange hgSessionPrefix "doSessionChange"
 
 #define hgsCancel hgSessionPrefix "cancel"
 
 #define hgsDo hgSessionPrefix "do"
 
 // Non-UI reachable function to load a session and save it, for the purpose of moving files
 // and tables out of trash/customTrash into userdata/customData after sessionData* params are
 // added to hg.conf.
 #define hgsDoReSaveSession hgSessionPrefix "doReSaveSession"
 
 // Back-door CGI param to randomize the suffix (usually day of month) for sessionDataDbPrefix.
 // This is for bulk re-saving old sessions to move files and tables to safe storage;
 // we don't want all of the old sessions' tables to end up in the same day-of-month database.
 #define hgsSessionDataDbSuffix hgSessionPrefix "sessionDataDbSuffix"
 
 char *cgiDecodeClone(char *encStr);
 /* Allocate and return a CGI-decoded copy of encStr. */
 
 void startBackgroundWork(char *exec, char **pWorkUrl);
 /* deal with forking off child for background work
  * and setting up the trash file for communicating
  * from the child to the browser */
 
 void getBackgroundStatus(char *url);
 /* fetch status as the latest complete html block available.
  * fetch progress info instead if background proc still running. */
 
 // -----  htmlOpen 
 
 void htmlOpen(char *format, ...);
 /* Start up a page that will be in html format. */
 
 void htmlClose();
 /* Close down html format page. */
 
 void showDownloadSessionCtData(struct hashEl *downloadList);
 /* Show download page for the given session */
 
 void makeDownloadSessionCtData(char *param1, char *backgroundProgress);
 /* Download tables and data to save save in compressed archive. */
 
 void doDownloadSessionCtData(struct hashEl *downloadPathList);
 /* Download given table to browser to save. */
 
 #endif /* HGSESSION_H */