Administering Evergreen Through the Command Line Documentation Interest Group Administering Evergreen Through the Command Line Documentation Interest Group
Total Page:16
File Type:pdf, Size:1020Kb
Administering Evergreen through the Command Line Documentation Interest Group Administering Evergreen through the Command Line Documentation Interest Group Report errors in this documentation using Launchpad. Table of Contents I. Introduction ............................................................................................................................................................. 7 1. About This Documentation ............................................................................................................................... 9 2. About Evergreen ............................................................................................................................................ 10 II. Installing Evergreen ............................................................................................................................................... 11 3. System Requirements ..................................................................................................................................... 14 Server Minimum Requirements .................................................................................................................... 14 Web Client Requirements ........................................................................................................................... 14 Staff Client Requirements ........................................................................................................................... 14 4. Installing the Evergreen server ......................................................................................................................... 15 Preamble: referenced user accounts .............................................................................................................. 15 Preamble: developer instructions .................................................................................................................. 15 Installing prerequisites ................................................................................................................................ 16 Extra steps for web staff client .................................................................................................................... 17 Configuration and compilation instructions .................................................................................................... 18 Installation instructions ............................................................................................................................... 18 Change ownership of the Evergreen files ....................................................................................................... 18 Run ldconfig ............................................................................................................................................. 18 Additional Instructions for Developers .......................................................................................................... 18 Configure the Apache Web server ................................................................................................................ 19 Configure OpenSRF for the Evergreen application .......................................................................................... 21 Configure action triggers for the Evergreen application .................................................................................... 21 Creating the Evergreen database .................................................................................................................. 21 Starting Evergreen ..................................................................................................................................... 23 Testing connections to Evergreen ................................................................................................................. 24 Getting help .............................................................................................................................................. 24 License .................................................................................................................................................... 25 5. Upgrading the Evergreen Server ....................................................................................................................... 26 Software Prerequisites ................................................................................................................................ 26 Upgrade the Evergreen code ........................................................................................................................ 26 Upgrade the Evergreen database schema ....................................................................................................... 28 Restart Evergreen and Test ......................................................................................................................... 31 Review Release Notes ................................................................................................................................ 31 6. Setting Up EDI Acquisitions ........................................................................................................................... 32 Introduction .............................................................................................................................................. 32 Installation ................................................................................................................................................ 32 Configuration ............................................................................................................................................ 33 Troubleshooting ........................................................................................................................................ 34 7. Migrating from a legacy system ....................................................................................................................... 36 Introduction .............................................................................................................................................. 36 Making electronic resources visible in the catalog ........................................................................................... 36 Migrating your bibliographic records ............................................................................................................ 37 Migrating your call numbers, copies, and parts ............................................................................................... 38 Migrating Patron Data ................................................................................................................................ 41 III. Individual Evergreen Components ........................................................................................................................... 45 8. Easing gently into OpenSRF ............................................................................................................................ 47 Abstract ................................................................................................................................................... 47 Introducing OpenSRF ................................................................................................................................. 47 Enough jibber-jabber: writing an OpenSRF service ......................................................................................... 52 Getting under the covers with OpenSRF ........................................................................................................ 64 Evergreen-specific OpenSRF services ........................................................................................................... 67 Evergreen after one year: reflections on OpenSRF .......................................................................................... 68 Administering Evergreen through the Command Line 3 Summary .................................................................................................................................................. 70 Appendix: Python client ............................................................................................................................. 70 9. Support Scripts .............................................................................................................................................. 72 marc_export: Exporting Bibliographic Records into MARC files ....................................................................... 73 Importing Authority Records from Command Line ......................................................................................... 74 Juvenile-to-adult batch script ....................................................................................................................... 75 MARC Stream Importer ............................................................................................................................. 75 Processing Action Triggers ......................................................................................................................... 75 10. Daemons and services ................................................................................................................................... 77 Starting and Stopping the Reporter Daemon ..................................................................................................