===== Bay Area Linux Users Group (BALUG) webmaster =====
==== webmaster care and feeding - editing of BALUG web pages - production and non-production, etc. ====

=== the short version :-) ===

One //will// want to also //carefully read the information/documentation further below//, but\\
high-level reminder/synopsis points:
  ***production**:
    *access (e.g. via sudo - shouldn't log into it directly) id **balugwm1** on **webmaster.balug.org**, e.g.:\\ %%$ ssh -atx -l %%//your_login//%% webmaster.balug.org. 'umask 077 && cd / && exec sudo su - balugwm1'%%
    *key production areas:
      */var/www/**www**.balug.org/ (**main production** area, see also **production synchronization** further below, //serves at least//:
        *[[http://www.balug.org/]]
        *[[https://secure.balug.org/]] ([[http://secure.balug.org/]] "forces" (HTTP 301 redirects) to https)\\ )
      */var/www/**www.archive**.balug.org/ (**archival/historical** content - generally also "too big" (at least in total) to replicate across all %%www%%.balug.org server(s))
      */var/www/**www.new**.balug.org/ (**production //staging/preview//** area - does not automagically replicate to production, but very handy for previewing content (e.g. at [[http://www.new.balug.org/]]) before promoting to production
    ***production synchronization** (rsync)
      ***content** from /var/www/**www**.balug.org/ **may or may not** be automagically replicated to http://www.balug.org/ server(s)!
      ***to update**/refresh** http://www.balug.org/ content** from /var/www/**www**.balug.org/:
        ***as user id balugwm1 on webmaster.balug.org, run the command**:\\ $ %%www%%.balug.org_rsync
        *note that:
          *the command referenced above may, or may not, be scheduled to automagically run periodically via crontab (see balugwm1's crontab)
          ***content placed in** /var/www/**www**.balug.org/ **may or may not be visible** or immediately visible **at http://www.balug.org/**, but is **not guaranteed to be visible accross all http://www.balug.org/ until the noted %%www%%.balug.org_rsync command has been successful executed**.
          ***contents** under /var/www/**www**.balug.org/ **must be readable by id balugxfr** (e.g. world readable) **to successfully replicate and be visible across http://www.balug.org/ site(s)**.
  ***non-production**:
    *rather analogous to production, id **balugwm2** has rather to quite full access to most or all //non-production// web areas on **webmaster.balug.org**.  Note also that group balugwm2 may also share much of that access, and other id(s) may also have some or much access to certain non-production areas.
    *access (e.g. via sudo - shouldn't log into it directly) id **balugwm2** on **webmaster.balug.org**, e.g.:\\ %%$ ssh -atx -l %%//your_login//%% webmaster.balug.org. 'umask 077 && cd / && exec sudo su - balugwm2'%%
    *key //non-production// areas:
      */var/www/**www.beta**.balug.org/ - beta test area [[http://www.beta.balug.org/]]
      */var/www/**www.test**.balug.org/ - (alpha / proof-of-concept) test area [[http://www.test.balug.org/]]
      */var/www/**%%www.php.test%%**.balug.org/ PHP test area [[http://www.php.test.balug.org/]]

----

===== CAUTION - THIS IS A WORK-IN-PROGRESS EDIT - MUCH MORE INFORMATION STILL NEEDS TO BE ADDED TO THE ABOVE AND BELOW =====
----


=== production (www.balug.org, etc.) ===

The //normal// way production is edited/updated, one should\\
have sudo access to the id //balugwm1// (access to the group balugwm1 likely also provides much, but probably not all of the needed access)\\
on host balug-sf-lug-v2.balug.org (a.k.a. **webmaster**.balug.org, a.k.a. new.balug.org).\\
On that host, the various [[http://webmaster.balug.org/manual/en/vhosts/name-based.html|Name-based Virtual Host]] [[http://webmaster.balug.org/manual/en/mod/core.html#documentroot|DocumentRoot]]s\\
are located at/under:\\
/var/www/\\
most notably:\\
**/var/www/%%www.%%balug.org/** contains master production for http://www.balug.org/\\
Note that for various reasons (mostly historical and attempts to preserve/retrieve various historical content),\\
balugwm1 //doesn't have absolute full reign over all content// under\\
/var/www/%%www.%%balug.org/\\
but //does// have full reign over //most// content in/under that location.