diff website/README.txt @ 6343:bea4a6956c89

Moved roundup-tracker.org infrastructure docs to website/README.txt This change makes developers.txt as the place for people contributing to the code base and README.txt to those maintaining the infrastructure. The old state was website/README.txt had reference to doc/developers.txt for updating issues.roundup-tracker.org. Removed reference and move docs to website/README.txt. doc/developers.txt had a section on updating website and wiki that referenced website/README.txt. Removed section, replaced with sentence that references website/README.txt for all infrastructure.
author John Rouillard <rouilj@ieee.org>
date Sun, 14 Mar 2021 20:52:11 -0400
parents 53e968351250
children 53da2c697fab
line wrap: on
line diff
--- a/website/README.txt	Sat Mar 13 21:48:59 2021 -0500
+++ b/website/README.txt	Sun Mar 14 20:52:11 2021 -0400
@@ -1,37 +1,11 @@
 Roundup has three web sites:
 
  * https://www.roundup-tracker.org/
+ * https://issues.roundup-tracker.org/
  * https://wiki.roundup-tracker.org/
- * https://issues.roundup-tracker.org/
-
-www and wiki are hosted on SourceForge.
-
-
-updating issues.roundup-tracker.org
-===================================
-See doc/developers.txt for details on accessing the new location.
-
-
-updating wiki.roundup-tracker.org
-=================================
-Wiki isn't hosted on sourceforge anymore. See:
 
- https://issues.roundup-tracker.org/issue2551045
-
-for details on Implementing wiki move to Waldmann-EDV.
-
-Contact Thomas Waldmann. Web site: https://www.waldmann-edv.de/
-email: info AT waldmann-edv DOT de.
-
-The sites theme is under wiki/wiki/data/plugin/theme/roundup.py.  Last
-updated by emailing Thomas 2/2021. Images/icons and css under
-wiki/_static.
-
-Backups are assumed to be done by Waldmann-edv. There does not appear
-to be a way to get access to the underlying filesystem via ssh or to
-do a backup/tarball via with web.
-
-==============
+www is hosted on SourceForge, issues is hosted on a python software
+foundation host and wiki is hosted at waldman-edv.
 
 updating services hosted on sf.net (www)
 =================================================
@@ -56,8 +30,6 @@
     project_home=/home/project-web/roundup
 
     # pull latest Roundup source with www and wiki
-    # (the warning about "Not trusting file ... " can be ignored
-    #  for now https://sourceforge.net/p/forge/site-support/8217/)
     hg pull -u --cwd ${project_home}/src/roundup
     # see below if this fails with: not trusting file
       # /home/project-web/roundup/src/roundup/.hg/hgrc from untrusted
@@ -124,3 +96,77 @@
   https://www.roundup-tracker.org/dev-docs/docs.html?foo=1
 
 to cache bust.
+
+Updating issues.roundup-tracker.org
+===================================
+
+The tracker resides on bugs.ams1.psf.io (188.166.48.69). You can also
+ssh to issues.roundup-tracker.org. They have the same fingerprint:
+
+    ED25519 key fingerprint is f1:f7:3d:bf:3b:01:8d:e1:4e:30:b3:0f:6e:98:b8:9b.
+
+The roundup installation belongs to the user roundup. 
+The setup uses virtualenv. Use the python version:
+
+  /srv/roundup/env/bin/python2.7
+
+to get a python with roundup on the PYTHONPATH.
+
+The Roundup tracker https://issues.roundup-tracker.org/ is in
+/srv/roundup/trackers/roundup/ with the database set to
+/srv/roundup/data/roundup/. Note that postgres is used for the
+backend, so the database directory above is used for msgs and files.
+
+Source is in: /srv/roundup/src/
+
+Roundup is run using gunicorn and wsgi.
+
+You have 'sudo -u roundup' access if you need to run things as the
+roundup user.
+
+The configuration is in the "website/issues" section of Roundup's
+Mercurical SCM repository and copied manually to the live tracker.
+
+  * get a working copy of roundup/website/issues from the SCM, either via
+        hg clone https://hg.code.sf.net/p/roundup/code
+    or download a snapshot:
+        https://sourceforge.net/p/roundup/code/ci/default/tarball
+
+  * check the differences
+      diff -ur /srv/roundup/trackers/roundup/ roundup/website/issues/
+
+Copy differences using 'sudo -u roundup ...'.
+
+Getting a user account
+~~~~~~~~~~~~~~~~~~~~~~
+
+To get access to the host, submit a pull request for:
+
+    https://github.com/python/psf-salt
+
+by forking the repo, make a change similar to:
+
+    https://github.com/rouilj/psf-salt/commit/2aa55d0fc5a343f45f5507437d3fba077cbaf852
+
+and submit it as a pull request. Contact ewdurbin via #roundup IRC or by
+adding an issue to the master psf-salt repo.
+
+
+updating wiki.roundup-tracker.org
+=================================
+Wiki isn't hosted on sourceforge anymore. See:
+
+ https://issues.roundup-tracker.org/issue2551045
+
+for details on Implementing wiki move to Waldmann-EDV.
+
+Contact Thomas Waldmann. Web site: https://www.waldmann-edv.de/
+email: info AT waldmann-edv DOT de.
+
+The sites theme is under wiki/wiki/data/plugin/theme/roundup.py.  Last
+updated by emailing Thomas 2/2021. Images/icons and css under
+wiki/_static.
+
+Backups are assumed to be done by Waldmann-edv. There does not appear
+to be a way to get access to the underlying filesystem via ssh or to
+do a backup/tarball via with web.

Roundup Issue Tracker: http://roundup-tracker.org/