DaemonAdmin/Portal262018-12-01 22:19:39ClintonEbadiLD_LIBRARY_PATH gunk is no longer needed, multiarch works fine nowadays252018-03-04 20:39:55ClintonEbadinote which server to publish on242018-03-04 20:38:26ClintonEbaditypo232018-03-04 20:34:35ClintonEbadiupdate commands for portal3222015-05-24 22:16:44ClintonEbadithe portal crons are in a crontab file now and should be installed with the user instead of scattered around /etc/212015-05-24 22:12:36ClintonEbadiupdate a bit, we're using portal3 in production now202014-04-29 05:21:04ClintonEbadimention activewebnodes192014-02-25 06:09:01ClintonEbadiso that182014-02-25 01:01:31ClintonEbadiapg is required too!172014-02-24 21:42:29ClintonEbadinote the LD_LIBRARY_PATH162014-02-21 20:17:25ClintonEbadiprobably should rename portal-tools to portal-support152014-02-21 19:09:19ClintonEbadiUpdating for navajos installation of the portal142012-12-30 23:02:22ClintonEbadiadd webnode132012-03-30 05:48:31ClintonEbadi122010-12-09 00:06:01ClintonEbadi112010-12-09 00:01:43ClintonEbadiInformation on sub apps102010-12-08 23:48:42ClintonEbadirebuilding the join script92010-03-13 13:10:47AdamChlipalaMention that wrappers are built automatically82010-03-12 23:22:18RichardDarstadjust header/footer file stuff72010-03-12 23:16:10RichardDarstupdate with more building instructions62008-07-07 04:28:14localhostconverted to 1.6 markup52007-12-08 16:02:03AdamChlipalaSubdirectories42007-12-05 01:38:08AdamChlipalaMention building header and footer32007-12-05 01:29:14AdamChlipalaNo other portal pages around22007-12-05 01:26:37AdamChlipalaAdd real content12007-12-04 22:48:21MichaelOlsonInitial contents, copied from DomTool/BuildingThe HCoop portal runs and , generates the member directory, and manages the vmail user database. Build RequirementsThe portal requires mlt (an html templating system for smlnj) and smlsql (postgresql bindings for smlnj). They are managed in the standard hcoop git repositories. The password generating tool also relies upon apg (automatic password generator). The portal build utilities stored in and installed to ~hcoop/portal-tools/...
.../src
: checkouts of mlt and smlsql (portal build file references smlsql from here) .../etc
: location of default mlt.conf
, hcoop.header
, hcoop.footer
.../bin
: mlt
and hcoop_header
binaries .../lib32
: 32-bit libraries needed by the smlsql .../cgi
: portal cgi binaries mlt and smlsql licensed under the LGPL version 2.1 or any later version. SourceThe portal source lives in module portal
of our git server. The main check-out is in /afs/hcoop.net/user/h/hc/hcoop/portal3
. The portal source is available under the GPLv3 or any later version. BuildingRun /afs/hcoop.net/common/etc/scripts/become-hcoop
before modifying files in the main check-out or running any git commands that would modify it. There are small CGI wrappers which just run compiled binaries in ~hcoop/portal-tools/cgi/
. The file mlt.conf
contains the CGI installation path (modify this to suit your system if building locally). These wrappers are generated automatically by mlt
. PublishingTo recompile and publish, login to the webserver hosting the portal (navajos
as of 2018-03, but verify in the hcoop.net
domtool configuration), enter the portal source directory, and run ~hcoop/portal-tools/bin/mlt
: Regenerating Page Headerheader.mlt
and footer.mlt
are built from assorted other files. Running make
in a check-out directory should build them. See the Makefile for how they're built. Note that make
won't publish changes that you make onto the real web sites; you must use mlt
for that. Needed files for building: hcoop_header is the one line script cat $prefix/etc/hcoop.header | sed "s/TITLE/$1/g"
hcoop_footer is the one line script cat $prefix/etc/hcoop.footer
You need ~hcoop/portal-tools/etc/hcoop.{header,footer}
(currently not tracked in git) Other Applications Within the PortalThere are some subdirectories of portal
that contain different web apps, like app
(the source for join.hcoop.net). You must run mlt
separately in any of these directories to publish changes in it. These include: app/
The Join script contact/
Emergency contact directory for admins listaddrs/
Lists all hcoop member email addresses mailman/
portal subscription helper program passgen/
Password reset tool remind/
Low balance reminder static/
Public member directory generator vmailpasswd
Vmail password changing MaintenanceCron JobsThe portal source contains a crontab which should be installed and run under the hcoop
user. This sends out monthly dues reminders and periodically generates semi-static pages. Adding MachineTo support user requests for a machine, insert a WebNode
into the database. The Debian version should be the release name (e.g. "squeeze"). If the machine should show up in the portal for members to request permissions or packages on, add it to ActiveWebNodes
. CategorySystemAdministration