Embed Size (px)
Citation preview
SFX KnowledgeBase Update
SFX Training, 2004
SFX KBUpdate Overview
• Released at the beginning of each month; update package available on Ex Libris FTP site
• Announcement on SFX customer mailing list with overview of update changes and any special instructions
• Applied by customer on local SFX server, when desired (but for ASP customers, Ex Libris applies the update)
SFX KBUpdate Overview
• SFX KnowledgeBase update consists of two parts; both parts will be applied when using the 'revision_update' program:
• Software update• Updates files in sfxglb3 instance• Creates symbolic links from the local instances
to new files in the sfxglb3 instance
• Database update• Updates database of all local instances (sfxlcl3,
sfxtst3, etc.) in succession• Updates sfxglb3 database, to be ready for next
month's update program
SFX Package – Standard Installation
sfxlcl3app
MySQL
data
sfxglb3 sfxtst3
sfx_version_3
sfx_ver
symbolic link
sfxglb3 sfxlc3l sfxtst3
exlibris
How the Database Package is created
MASTER1 MASTER2(from last month)
• MASTER1 contains all the changes made to the database up until the point at which we create the kb package
• MASTER2 contains all the changes made to the database from LAST MONTH’s package
How the Database Package is created
MASTER1 MASTER2(from last month)
‘delta’ file
Database Update: Step 1
• Updating the local databases• For each table, field by field comparison using
three databases• New, updated and deleted items acted upon
(or not) and noted
New changes in delta file(package
from Ex Libris)
sfxglb3DATABASE
(no localization)
sfxlcl3DATABASE
(localization)
Database Update: Step 2
• Updating the sfx_global database; replace sfx_global database with new database
• Installation is then ready to run next month's update
New changes in delta file
(package from Ex Libris)
sfxglb3DATABASE
(no localization)
9
Database Update Rules
• KB content in local database is automatically updated if no local changes were made to the database field which should be updated
• KB content in local database is automatically deleted if no local changes were made to the database item which should be deleted
• New KB content (Targets, Target Services and Object Portfolios) is added as inactive by default
• Customer may choose to override update rules by applying setting at Target Service level:
10
Database Update Reports
• Two formats: HTML and text (tab-delimited)
• Information about:• Changed (and not changed) database items• Deleted (and not deleted) database items• New database items
• Note: When items in the database were not changed or deleted automatically because of local changes: check reports and change/delete manually if necessary
Database Update Reports: Text
• Report on ACTIVE and INACTIVE material
Database Update Reports: HTML
• Report on ACTIVE material only
13
Revision short-cuts
• Step 1: set up your targets with ‘AutoActive’ and ‘Autoupdate’ using KBManager
• Step 2: set up the revision_update program as a background task (cron job)
• Step 3: minimal work required when checking the revision reports
14
• 'AutoActive' overrides the rule in the standard update which states that new Portfolios added to the SFX KB during the update will be added as inactive.
• 'Automatic Update' overrides the rule in the standard update, which states that database items with local changes will not be updated or deleted automatically.
Step 1: AutoActive and AutoUpdate
15
Step 1: AutoActive and AutoUpdate1. Set all aggregator databases you subscribe
to, such as EbscoHOST or Gale (where you subscribe to the whole package) to ‘AutoActive’ to reduce the amount of manual work necessary after the KBupdate.
2. Set other full text packages to ‘AutoUpdate’ depending on how strongly you want to monitor changes and deletions in your local SFX KnowledgeBase.
16
Step 2: run revision_update as background task
Needed: • unix root password• database passwords of all instances
in txt file
Two options:• Cron job• Run revision_update process in
background
17
Step 3: minimal revision reports checking: HTML reports
• Check the ‘not changed’ and ‘not deleted’ sections for all tables.
• Use ‘KB’ button to make the change/deletion in the database if necessary
NOTE: • You should see only a few items in these
sections of the report. If you get a lot, contact sfx_help for advice
• Target Service parse_params are the most likely candidates in these categories, and the most important to keep an eye on.
19
Step 3: minimal revision reports checking: TEXT reports
Use Microsoft Excel to open the files and use the ‘Sort’ option to filter on:
• ‘Availability’ to view items which are ACTIVE
• ‘ Target’ or ‘Target Service’ to look for specific collections where items were added/changed/deleted
