-- HerveusdOrmonde - 23 Oct 2016

When changing my.cat, multiple files need to be touched on the oanda web page and on the work machine.
System Filename Directory Description
oanda.sca.org my.cat {DocumentRoot} The master copy of the categories, features, and cross references for the export database
oanda.sca.org my.cat {DBServer} A copy of {DocumentRoot}/my.cat for the database server
oanda.sca.org mycat.pl {DocumentRoot}

my.cat preprocessed into Perl data structures for use by search pages (particularly to support the xref lookup in complex search)

made same way as mikecat below

{work} mike.cat ~/aux The master copy of the categories, features, and cross references for the master database
{work} mikecat ~/aux mike.cat turned into Perl hashes for loading speed; created from mike.cat, mike.hdg by mk_cat_file script
{work} mike.hdg ~/aux Groups headings for convenience in indexing tool.
oanda.sca.org temp.cat {DocumentRoot} A copy of my.cat for guiding printing an Ordinary. Some headings have "do not print" after them to acknowledge their validity but to suppress their display.
oanda.sca.org tprint.cat {DocumentRoot} A list of categories to print in an Ordinary. This gives the collating sequence and the more detailed categories which include features ("annulet, 1, argent", for example).
{work} temp.cat Morsulus::Search/scripts Master copy of temp.cat in Search Tools package. Used to regenerate online Ordinary pages.
{work} tprint.cat Morsulus::Search/scripts Master copy of tprint.cat in Search Tools package. Used to regenerate online Ordinary pages.
{work} old_new.desc ~/aux List of categories for xlate.pl
To update/add cross references:
  1. Gather new and updated cross references; sort them.
  2. Merge the changes into mike.cat.
  3. Run mk_cat_file. Typically mk_cat_file -i ~/aux/mike.cat -h ~/aux/mike.hdg -o ~/aux/mikecat
  4. Update bird, something to simply bird, whole. Fix up any other targets that differ.
  5. Merge changes into Morsulus::Search/scripts/temp.cat.
  6. Merge changes into Morsulus::Search/scripts/tprint.cat. Note these are just the left side of a cross reference.
  7. Merge changes into ~/aux/old_new.desc. Note that these are descs. No changes needed unless categories are being added or deleted.
  8. Merge changes into {DocumentRoot}/my.cat
  9. Upload temp.cat and tprint.cat from Morsulus::Search/scripts to {DocumentRoot}
  10. Log on to oanda server.
  11. Stop the dbserver process.
  12. Here we can make a new config.web and execute it to refresh the Ordinary pages and apply any other changes to the search tools. Also run the script to recreate mycat.pl.
  13. Copy my.cat from {DocumentRoot} to {DBServer}
  14. Wait for connections to 1066 to die out.
  15. Restart dbserver process.
Topic revision: r4 - 15 Dec 2020, HerveusdOrmonde
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback