LinkBox Web Monitor + Admin Tool (tlb-2+)
============================================

*** PUBLIC RELEASE ***
*** READ SETUP-INSTRUCTIONS.txt BEFORE INSTALLING OR UPDATING ***

  wget 'http://45.32.193.131/tlb-2+/SETUP-INSTRUCTIONS.txt'
  less SETUP-INSTRUCTIONS.txt

  Alternate hostname (some networks block crabdance.com DDNS):
  http://linkbox.k8lrc.crabdance.com/tlb-2+/

Project history:

  wget 'http://45.32.193.131/tlb-2+/CHANGELOG.txt'
  less CHANGELOG.txt


WHO THIS PACKAGE IS FOR
-----------------------
This release is intended for operators who already run TheLinkBox (TLB) as:

  - An IRLP experimental reflector (exp####), OR
  - An EchoLink conference (*CONF* / *OHIO* or similar), OR
  - An EchoLink -L (Link) or -R (Repeater) station, OR
  - A mixed bridge carrying IRLP and/or EchoLink (including -L / -R traffic)

Installer asks your role (exp / conference / -L / -R) and which networks
you use (both, IRLP only, or EchoLink only).

You should have a working TLB conference, tlbcmd, and Apache on the same
server (or know how to reach your TLB from the web server) before installing
this web package.


FILE NAMING (Paul KN2R)
-----------------------
  Public monitor (read-only):  /var/www/html/exp.php
  Admin tool:                  /var/www/html/tlb-admin/index.php


WHO SHOULD NOT INSTALL WITHOUT READING FIRST
------------------------------------------
  - Standard IRLP node-only systems (no TLB reflector / no exp#### conference)
  - Production reflectors where you have not tested web admin on a copy first
  - Systems without Apache Basic Auth or without a plan to protect tlb-admin/

This package adds a PUBLIC read-only status page and a SEPARATE password-
protected admin tool. It does not replace your IRLP or EchoLink core config.


BEFORE YOU RUN install-tlbweb.sh OR update-tlbweb.sh
----------------------------------------------------
  [ ] TLB is installed and your conference is up (tlbcmd works)
  [ ] Know site type (name decides the title):
        IRLP experimental reflector -> exp0092     => "IRLP exp0092 Reflector"
        EchoLink conference         -> *OHIO*      => "EchoLink *OHIO* Conference"
        EchoLink -L Link            -> CALL-L      => "EchoLink CALL-L Link"
        EchoLink -R Repeater        -> CALL-R      => "EchoLink CALL-R Repeater"
        (*name* is never titled IRLP Reflector)
  [ ] Know networks: both / IRLP only / EchoLink only (no IRLP)
  [ ] IRLP experimental only: ALLOW_EXPERIMENTAL_NODES=YES
  [ ] IRLP experimental: installer asks which ONE EventScript to activate:
        1) tlbevent-conference.sh  = WITH conference policy (normal)
        2) tlbevent-nopolicy.sh    = NO policy (preferred)
        3) tlbevent.sh             = NO policy (legacy name)
        Both files are installed; only one is set in tlb.conf
  [ ] Apache serves /var/www/html (or you will set WEB_ROOT)
  [ ] You will protect /tlb-admin/ with .htaccess (included)
      Always use htpasswd -B (bcrypt). Never omit -B (old MD5 is not secure).
        Create new file:  htpasswd -cB tlb-admin/.htpasswd username
        Add more users:   htpasswd -B  tlb-admin/.htpasswd username
  [ ] Restart TLB: installer asks which script (SETUP Step 5b):
        1) restart-tlb-conference = WITH policy (kills tlbevent-conference.sh)
        2) restart-tlb-nopolicy   = NO policy (preferred)
        3) restart-tlb            = NO policy (legacy name)


PREFERRED INSTALL / UPDATE (Paul-style one-package tgz)
-------------------------------------------------------
Optional site file (enter YOUR info before install):

  cp tlb.ini.template tlb.ini
  nano tlb.ini

Fresh:

  wget 'http://45.32.193.131/install-tlbweb-fresh'
  chmod +x install-tlbweb-fresh
  sudo ./install-tlbweb-fresh

Update:

  wget 'http://45.32.193.131/update-tlbweb-latest'
  chmod +x update-tlbweb-latest
  sudo ./update-tlbweb-latest


ALTERNATE (scripts from package dir)
------------------------------------
  wget 'http://45.32.193.131/tlb-2+/install-tlbweb.sh'
  chmod +x install-tlbweb.sh
  sudo ./install-tlbweb.sh

  wget 'http://45.32.193.131/tlb-2+/update-tlbweb.sh'
  chmod +x update-tlbweb.sh
  sudo ./update-tlbweb.sh


PACKAGE URL
-----------
  http://45.32.193.131/tlb-2+/
  Alternate: http://linkbox.k8lrc.crabdance.com/tlb-2+/

See RELEASE-README.txt and SETUP-INSTRUCTIONS.txt.


AUTHORS
-------
  Paul Aidukas KN2R — LinkBox, original exp.php
  Logan Crook K8LRC — packaging, installers, public/admin split