5.2 Scripts

The SCRIPTS activity gather system level operations MEDIATEX is using. This activity provides basic fonctions on BASH files that are not describe in this documentation. This activity is divided into 11 process:

• Events in

  # /etc/init.d/mediatexd start

  # /etc/init.d/mediatexd stop

  # /etc/init.d/mediatexd status

  # /etc/init.d/mediatexd reload

  from ADMIN (see Who) to init.d (see init.d): start/stop the MEDIATEX daemon.

  <cgiClt-get-query>

  <cgiClt-post-query>

  from Apache (see Apache) to cgiClient (see cgiClient): USER’s HTTP forwarded query.

  # bash -i /usr/share/mediatex/scripts/cron_hourly.sh

  # bash -i /usr/share/mediatex/scripts/cron_daily.sh

  # bash -i /usr/share/mediatex/scripts/cron_monthly.sh

  from Cron (see Cron) to conrHourly-cronDaily (see cronHourly-cronDaily): scheduled tasks.

  # /usr/share/mediatex/scripts/init.sh

  # /usr/share/mediatex/scripts/remove.sh

  # /usr/share/mediatex/scripts/purge.sh

  from misc (see misc) to init-remove-purge (see init-remove-purge): initialise, remove and purge MEDIATEX software.

  # /usr/share/mediatex/scripts/add-user.sh

  # /usr/share/mediatex/scripts/del-user.sh

  from serv (see serv) to addUser-delUser (see addUser-delUser): manage PUBLISHER users.

  # /usr/share/mediatex/scripts/new.sh

  # /usr/share/mediatex/scripts/free.sh

  from conf (see conf) to new-free-clean (see new-free-clean): create/subscribe or destroy/unsubscribe a collection.

  # /usr/share/mediatex/scripts/clean.sh

  from misc (see misc) to new-free-clean (see new-free-clean): clean the local HTML catalogue.

  $ /usr/share/mediatex/scripts/upgrade.sh

  $ /usr/share/mediatex/scripts/commit.sh

  $ /usr/share/mediatex/scripts/commit.sh

  $ /usr/share/mediatex/scripts/commit.sh

  from CLIENT (see Client) to upgrade-commit-pull-push (see upgrade-commit-pull-push): manage GIT synchronisation.

  # /usr/share/mediatex/scripts/bind.sh

  # /usr/share/mediatex/scripts/unbind.sh

  from misc (see misc) to bind-unbind (see bind-unbind): manage collection repository binding on the chrooted jail for SSH remote access.

  # /usr/share/mediatex/scripts/mount.sh

  # /usr/share/mediatex/scripts/umount.sh

  from supp (see supp) to mount-umount (see mount-umount): manage mounting ISO devices.

  $ /usr/share/mediatex/scripts/deliver.sh

  from delivering (see delivering) to deliver (see deliver): manage archive availability notification.

  $ /usr/share/mediatex/scripts/audit.sh

  from delivering (see delivering) to audit (see audit): audit an archive.

• Processing

  Provide a BASH library.

• Events out

  # nohup mediatexd

  # kill -s TERM PID

  # kill -s HUP PID

  from init.d (see init.d) or init-remove-purge (see init-remove-purge) to SERVER (see Server): standard UNIX process management (HUP signal for reload...).

  # /etc/init.d/apache2 restart

  from init-remove-purge (see init-remove-purge) to Apache (see Apache): re-configure APACHE.

  # /etc/init.d/apache2 reload

  from new-free-clean (see new-free-clean) to Apache (see Apache): make APACHE aware of changes into its configuration.

  <cgiSrv-query>

  from cgiClient (see cgiClient) to cgiServer (see cgiServer): socket query asking for an archive.

  $ git init --bare

  $ git config

  from init-remove-purge (see init-remove-purge) or new-free-clean (see new-free-clean) to Git (see Git): initialise a GIT repository.

  $ git clone

  from new-free-clean (see new-free-clean) to Git (see Git): checkout a GIT collection module.

  $ git config

  $ git commit

  $ git pull

  $ git push

  from upgrade-commit-pull-push (see upgrade-commit-pull-push) to Git (see Git): synchronise a GIT module.

  $ mail

  from deliver (see deliver) or audit (see audit) to Sendmail (see Exim): send a mail.

  $ mediatex upload[+] [file file [as target]]* [catalog file] [rules file] to coll coll

  from conrHourly-cronDaily (see cronHourly-cronDaily) or audit (see audit) to uploadClient (see uploadClient): upload an incoming archive into the cache.

  $ mediatex srv extract

  $ mediatex srv notify

  $ mediatex make [coll coll]

  $ mediatex motd

  from conrHourly-cronDaily (see cronHourly-cronDaily) respectively to CLIENT (see Client), misc (see misc) and motd (see motd): scheduled tasks.

  (motd)

  from conrHourly-cronDaily (see cronHourly-cronDaily) to PUBLISHER (see Who): update the (above generated) message of the day.

• Data in or creation
  • /etc/mediatex/mdtx.conf (see mdtx.conf)
  • ~mdtx/git/mdtx/supports.txt (see supports.txt)
  • /etc/mediatex/mdtx-COLL/catalogXXX.txt (see catalog.txt)
  • /etc/mediatex/mdtx-COLL/servers.txt (see servers.txt)
  • /etc/mediatex/mdtx-COLL/extractXXX.txt (see extract.txt)
• Data out

  /var/run/mediatex/mdtxd.pid

  /etc/motd

  ~mdtx/

  ~mdtx-COLL/

To debug a script, you have to launch it using at least the MDTX environment variable:

# cd /usr/share/mediatex/scripts
# MDTX_MDTXUSER=mdtx MDTX_LOG_SEVERITY_SCRIPT=debug ./bind.sh 

Codes:

scripts/lib/git.sh

scripts/lib/htdocs.sh

scripts/lib/include.sh

scripts/lib/jails.sh

scripts/lib/log.sh

scripts/lib/ssh.sh

scripts/lib/users.sh