262018-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.

The 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.

The 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.

Run /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.

To 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:

header.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)

There 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

The 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.

To 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