SFX System Administration SFX Training 2005 SFX File

SFX System Administration SFX Training, 2005

SFX File Structure • The SFX installation is contained in one directory: /exlibris/sfx_version_3 • This directory contains: • One applications directory • Separate trees which hold separate SFX instances 2

SFX File Structure • /exlibris/sfx_version_3 contains all supporting software needed to run SFX: • My. SQL [v. 4. 1. 8] • Apache Web server [v. 2. 0. 50] • Perl [v. 5. 8. 5] 3

SFX Package – Standard Installation exlibris sfx_version_3 app sfxglb 3 My. SQL sfxlcl 3 sfxtst 3 symbolic link data sfxglb 3 sfxlc 3 l sfxtst 3 4

sfxglb 3 instance ("sfx_global(" • sfxglb 3 instance provides the customer with the most up-to-date Knowledge. Base, consisting of a database, programs, and configuration files • The files in the local filesystem use UNIX symbolic links to point to the same files in the sfxglb 3 instance • Ex Libris regularly updates the files on the sfxglb 3 instance and because of the relationship between the local and the sfxglb 3 instance, the local instance immediately picks up any changes 5

exlibris sfx_version_3 cv sfxglb 3 app symbolic links apach e ah da admin mys ql mh cgi perl ph cn config aztools core source backup _scripts public target categor y diagnosti cs server_ admin_ut il startup _ scripts utils sfxlcl 3 sfxtst 3 sx dbs sqltab scratch ds files base_export curr_exp ort home lib parsers tp, sp, td logs apache sfxadm in tm template s a-z citation css e- coll ecti on -html img reports sfxmenu

Mod_perl • What? A persistent Perl interpreter embedded in SFX web server. • Advantage? Performance, by avoiding overhead of starting external interpreter and penalty of Perl start-up time. • Note: • first request to SFX server is slower since this is when initial compilation takes place. • if changes are made to Perl modules (example: target parsers), it is necessary to restart the instance's Apache 7

Reverse proxy (1( Different SFX instances on the same server share the same binaries of Apache, but each instance has its own Apache daemon. port 3210 8

Reverse Proxy (2( How does this work? 1. In sfx_global instance, the following configuration file lists the apache configuration of the different instances: /exlibris/sfx_version_3/sfx_global/config/reverse_proxy_httpd. config 2. In the local SFX instances, the following configuration files contain apache demon information: /exlibris/sfx_version_3/<instance>/config/httpd. conf /exlibris/sfx_version_3/<instance>/config/local_httpd. config To the outside world, all SFX instances have the same port (e. g. 3210). 9

SFX Users • Each instance has two "main" users: • UNIX user: administrates the unix level of the instance, used to access the file system • My. SQL user: used by programs to access the database associated with the instance; needed in those scripts and programs where database access is required, e. g. KBManager, Data. Loader, etc. • And a third "type" of user: • SFXAdmin access: listed in USERS table in db • Different SFXAdmin users may have different privileges in KBManager (but all use the same My. SQL user to accomplish tasks…) 10

Server Admin Utility • A command-line utility used to accomplish various server-related tasks • • Start/stop Apache & My. SQL Change My. SQL and UNIX user passwords Copy one instance to another (db and files) Export/import data Clean SFX directories Manage statistical data (on 2 off, archive) Run and schedule A-Z index build Diagnostics 11

Startup Scripts • One script to handle My. SQL and Apache startup: sfxd • Located at: /etc/rc. d/init. d • Symbolic links created in appropriate /etc/rc*. d/ directory, for init program to load at server startup • When starting Apache, reverse proxy server is started first, then individual Apache servers for each instance 12

SFX Backup • Ex Libris recommendation: • Daily backup with no downtime; full backup with downtime once a week • Backup scripts included in /sfxglbl 3/admin/backup_scripts • Backup with downtime: server must go down to run backup but recovery is straightforward • Backup with no downtime: no downtime for server but recovery requires more manual work • Tar archive includes backup of SFX files and My. SQL databases 13

Security issues • Change SFXAdmin and unix passwords • Using User Administration tool in SFXAdmin and server_admin_util program in unix admin directory • Change My. SQL password • Using server_admin_util program in unix admin directory • Can restrict access to SFXAdmin: • connection_admin. config [for each instance] • Can restrict access to SFX Menu: • connection_user. config [for each instance] 14

Changing the name of an SFX instance http: //sfx. myserver. edu: 3210/sfxlcl 3 http: //sfx. myserver. edu: 3210/sfxadmin/sfxlcl 3 • reverse_proxy_httpd. config__ • httpd. conf for reverse proxy server http: //sfx. myserver. edu: 8800/caltech http: //sfx. myserver. edu: 8800/sfxadmin/caltech 15

Debugging Apache logs: /app/apache/logs • Error_log • Access_log 16

www. exlibrisgroup. com/sfx. htm sfx_help@exlibris-usa. com