System Architecture Updated: 27-Jan-2006

System Architecture 2 Verde Components These are the processes that constitute the Verde software product. Verde Application Server Oracle Database Background Indexing Utility Background Jobs Utility

System Architecture 3 Upper Level Structure V2_1/verde – the base directory under which all Verde components are installed. Shortcut: $VERDE_BASE /exlibris verde V2_1 home proc verde

System Architecture 4 Upper Level Structure (2) oradata – Oracle database installation. /exlibris verde ora_verde V2_1 verde app oradata home proc

System Architecture 5 Key to Directories /exlibris/verde/v2_1/verde/home – Verde application server and batch processes Shortcut: vhome home/system/bin – Verde utilities and programs, such as starting up and shutting Verde down, start the indexing process, task manager etc. Shortcut: vbin

System Architecture 6 Key to Directories (2) home/system/log – log files written by batch processes and utilities. Shortcut: vclog home/system/thirdparty/openserver/server /default/log – log files written by Verde. Shortcut: vlog

System Architecture 7 Key to Directories (3) /exlibris/verde/v2_1/verde/examples_an d_templates – templates and example files (such as loader sample files) …/profile/reportsCustomization – configurable templates for the different jobs (reports, loaders and tasks) output format.../profile/workflowCustomization – images used by the system to display the current step in the workflow.

System Architecture 8 Key to Directories (4)../home/system/conf – keeps application configuration Shortcut: vconf../home/profile – also keeps application configuration. Shortcut: vprof Type alias to find the full list of Verde shortcuts. Next: Logs & Processes

System Architecture 9 System Logs server.log – keeps track of server activity (under vlog) web.log – records connections to ILS and SFX (under vlog) client.log – records client activities (under vclog) tasks.log – tracks the execution of the different tasks (under vclog). Other log files under vclog contain subsets of the information in client.log.

System Architecture 10 Logs Lifecycle The logs under home/system/thirdparty/openserver/serv er/default/log ( vlog) do not overwrite themselves and therefore need to be backed up and cleaned On the other hand, logs under home/system/log ( vclog) have a cycle of 5 logs of the same type, and then they begin to overwrite the oldest log.

System Architecture 11 Verde Processes 3 processes should be running simultaneously: verde, task_manager and indexing. The processes can be run and stopped through the Verde utilities (util.v). In addition, the following scripts can be run in vbin: run.sh run_task_manager.sh run_indexing.sh To see the running processes: ps –ef | grep java Shortcut: vgrep Next: Preventive Maintenance

System Architecture 12 Preventive Maintenance

System Architecture 13 Verde Administrative Tasks Verde comes with several administrative scheduled tasks. For example: Cleanup – runs once a day and cleans old (over 30 days) output files generated as part of tasks/reports functionality Index Optimization – runs once a week at midnight, and run Oracle indexing optimization that improves the DB work Resend – runs every 5 minutes and resends unsuccessfully sent mails.

System Architecture 14 Verde Tasks (2) All maintenance tasks, except backup, are configured to run automatically when the system is installed. NOTE: Details of executing these tasks manually can be found in Verde’s System Administrator’s Guide – Preventive Maintenance.

System Architecture 15 System Utils System utils can be accessed by the util command. It includes: Cleanup (c) Export / Import (i) Oracle Utilities (o) Verde Administration (v) Next: System Backups

System Architecture 16 What Should be Backed Up? /exlibris /app /oradata/verde /arch Verde software – under /exlibris/verde Oracle software – under /exlibris/app Oracle database – under /oradata/{ORACLE_SID} Oracle archiving – under /oradata/{ORACLE_SID}/arch

System Architecture 17 What Should be Backed Up? (2) Archive the redo files Make a Logical backup of the data of the Oracle database. You can do this by using the Oracle export utility or via export utilities provided by Verde. Note that logical backup does not contain the Oracle Text – recovery will require re-indexing Backup the Verde software and the Orcale software Backup the library file structure.

System Architecture 18 System Backup Strategy Cold backup – unless downtime is a major issue, this can be run daily Hot – any day that cold backup is not run. In order to run hot backups, the DB must be in Archive mode Archive – run daily Application configuration – run weekly Export – as frequent as possible Verde + Oracle Application – every 2 months and after each upgrade or patch.

System Architecture 19 Oracle Trace Files and Alert Logs Each error detected by the server/background Oracle processes is dumped to a trace file. Each database also has an alert file - alert_.log - which contains a chronological log of errors and messages. Both are placed under the directory $ORACLE_BASE/admin/$ORACLE_SID, and can be reviewed using util.o.

System Architecture 20 Database Recovery Sufficient backup of the application components is crucial for recovery scenarios. Customers are recommended to use Third-party tools or custom-made scripts to handle their backups Cold backups require shutting the system down completely, but they allow an easier and faster recovery from database failures.

System Architecture 21 Database Recovery (2) Create a Cold backup of all database files to external tape/disk while the database is down Complete recovery will be done only when the system is down Hot backup will not include the redo recovery files, while the system is running.

System Architecture 22 Recovery Policy Recovering from crash is a very complex issue which requires deep knowledge and extensive expertise, and should be done by a skilled DBA As a policy, it is in the best interest of both the customer and Ex Libris for the customer to consult Ex Libris in any case of database recovery.

System Architecture 23 Further reading… See the System Administrator’s Guide for more information.