SYSTEM TRAINING

System Administration Basic concepts Focus primarily on ALEPH server. Activities pertaining to ALEPH system administration. Node management. Libraries management.

SYSTEM TRAINING Node Management Directories Structure & aliases aleph_start_505 Other configuration files aleph_startup_505 path_convert Job Daemon (UTIL E)

SYSTEM TRAINING Libraries Management A50.. Versus U50.. Directories Structure & aliases Batch Queue (UTIL C)

SYSTEM TRAINING Node Management Directories Structure & aliases Aleph root aleph alephe alephmoracletmp Software executables, scripts Node management - tables, parameters files Software - development & maintenance programs Oracle Installation files temporary directory ap, aeam, apm, ac$TMPDIR$alephe_root

SYSTEM TRAINING Node Management aleph_start_505 - THE core config file - Placed in $alephe_root - aleph_start_505.private - /etc/aleph_start_505 is a symbolic link to alephe/aleph_start_505 - Invoked by every ALEPH process. - Contains definitions of libraries. - Contains environment variables

SYSTEM TRAINING aleph_start_505 - example (1) # aleph_start: # ### Version and/or platform dependent setting ################################## # # Hostnames # setenv ORA_HOST ram36 setenv IO_HOST ram36 setenv Z39_HOST ram36 # # Directories: ALEPH_MOUNT - software + demo libraries # USER_MOUNT - user libraries # setenv ALEPH_MOUNT /aleph setenv USER_MOUNT /aleph3 # setenv ALEPH_VERSION 505 setenv PATCH_NUMBER 14 setenv SUB_PATCH_NUMBER 2 setenv VERSION_NUMBER 0 # setenv usm01_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5 setenv usm02_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5

SYSTEM TRAINING aleph_start_505 - example (2) setenv usm01_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5 setenv usm02_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5 setenv usm10_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5 setenv usm11_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5 setenv usm12_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5 setenv usm20_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5 setenv usm30_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5 setenv usm50_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5 setenv usm60_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5

SYSTEM TRAINING aleph_start_505 - example (3) setenv ALEPH_LIBS "$DEMO_LIBS" # setenv set_library USM01 setenv pw_library USM50 # setenv QUE_STARTUP_LIBS "usm01 usm50" setenv WORD_STARTUP_LIBS "usm01 usm10 usm20 usm30 usm50" setenv REQUEST_STARTUP_LIBS "usm50" setenv ACC_AUT_STARTUP_LIBS "usm01" setenv MESSAGE_STARTUP_LIBS "usm01 usm10 usm50" # # If you want Aleph to connect to a remote Oracle DataBase # setenv BOTH 'aleph_db' and 'TWO_TASK' to the SAME service # setenv ORACLE_SID aleph2 setenv ORACLE_OWNER oracle setenv ORACLE_VERSION 80 setenv ORACLE_CONF ${ALEPH_MOUNT}/ora_aleph setenv EPC_DISABLED TRUE # setenv aleph_db ${ORA_HOST}.${ORACLE_SID}

SYSTEM TRAINING -10- aleph_start_505.private - example setenv acc01_dev /aleph4/u5${VERSION_NUMBER}_5 setenv acc10_dev /aleph4/u5${VERSION_NUMBER}_5 setenv acc11_dev /aleph4/u5${VERSION_NUMBER}_5 setenv acc12_dev /aleph4/u5${VERSION_NUMBER}_5 setenv acc60_dev /aleph4/u5${VERSION_NUMBER}_5 # Add customer libraries to ALEPH_LIBS # # setenv ALEPH_LIBS "$ALEPH_LIBS xxxxx" setenv ALEPH_LIBS "$ALEPH_LIBS acc01 acc10 acc12 acc11 acc60 ” # # Add customer libraries to STARTUP_LIBS # # setenv QUE_STARTUP_LIBS "$QUE_STARTUP_LIBS xxxxx" # setenv WORD_STARTUP_LIBS "$WORD_STARTUP_LIBS xxxxx" # setenv REQUEST_STARTUP_LIBS "$REQUEST_STARTUP_LIBS xxxxx" # setenv ACC_AUT_STARTUP_LIBS "$ACC_AUT_STARTUP_LIBS xxxxx" # setenv MESSAGE_STARTUP_LIBS "$MESSAGE_STARTUP_LIBS xxxxx"

SYSTEM TRAINING -11- Node Management def_local_env Placed in $aleph_proc/def_local_env Executed on every process and user login. alias pc_server 'csh -f $aleph_proc/pc_server ’ alias www_server 'csh -f $aleph_proc/www_server' switch ($unix_name) case 'ALPHA': if ($gsort_exist == 1) then setenv aleph_sort "gsort -y -T $TMPDIR" else setenv aleph_sort "sort -y -T $TMPDIR" endif breaksw

SYSTEM TRAINING -12- Node Management def_lib_env Placed in $aleph_proc/def_lib_env Defines library environment. alias dr 'cd $data_root/\!* ’ alias ds 'cd $data_scratch ’ alias dt 'cd $data_tab ’ alias df1 'cd $data_files ’ alias dp 'cd $data_print ’ alias util 'csh -f $aleph_proc/util'

SYSTEM TRAINING -13- Node Management prof_master Placed in $alephm_root/prof_master Defines profile for Unix user m505. alias am 'cd $alephm_root ’ alias apm 'cd $alephm_proc' alias ae 'cd $aleph_exe' alias ap 'cd $aleph_proc' alias wa 'cd $alephe_root/www_a_eng ’ switch ($unix_name) case " SUN_OS_2 " set prompt = "`hostname`= M$ALEPH_VERSION>>" breaksw

SYSTEM TRAINING -14- Node Management prof_library Placed in the library root directory. Defines profile for Unix user of the library. # define usm01 directories setenv data_root $usm01_dev/usm01 setenv data_tab $usm01_dev/usm01/tab setenv data_pc_tab $usm01_dev/usm01/pc_tab setenv data_scratch $usm01_dev/usm01/scratch setenv active_library USM01 source $aleph_proc/def_lib_env set_symbol CON_START ENG set_symbol ACTIVE_LIBRARY USM01

SYSTEM TRAINING -15- Node Management a leph_startup_505 - Placed in $alephe_root/aleph_startup_505 - an ALEPH script. - Can be used for starting the ALEPH servers and daemons. - Aleph_shutdown_505 - backup, oracle operation...

SYSTEM TRAINING -16- aleph_startup_505 - example (1) #******************************************* # servers #******************************************* echo -n "starting pc_server " csh -f $aleph_proc/pc_server 65${VERSION_NUMBER}5 & echo " ” #******************************************* # lib_batch #******************************************* foreach lib ($que_startup_libs) start_proc00 $lib echo -n "$lib " start_library_batch echo "" end

SYSTEM TRAINING -17- aleph_startup_505 - example (2) #******************************************* # UE_01 #******************************************* foreach lib ($word_startup_libs) start_proc00 $lib echo -n "$lib " source $aleph_proc/util_e_01 echo "" end #******************************************* # UE_11 #******************************************* foreach lib ($message_startup_libs) start_proc00 $lib echo -n "$lib " source $aleph_proc/util_e_11 echo "" end

SYSTEM TRAINING -18- Node Management path_convert Placed in $alephe_tab/path_convert re-direction of files, tables and directories. Uses aleph_start_505 logical assignment. Infinite loop is not allowed.

SYSTEM TRAINING -19- path_convert - example $usm01_dev/usm01/www_a_eng $alephe_root/www_a_eng $usm50_dev/usm50/www_a_eng $alephe_root/www_a_eng $usm50_dev/usm50/www_b_eng $usm01_dev/usm01/www_b_eng $usm50_dev/usm50/www_b_fre $usm01_dev/usm01/www_b_fre $usm50_dev/usm50/form_eng $usm01_dev/usm01/form_eng $usm50_dev/usm50/form_ger $usm01_dev/usm01/form_ger $usm50_dev/usm50/form_fre $usm01_dev/usm01/form_fre $usm50_dev/usm50/tab/rep_col $usm01_dev/usm01/tab/rep_col $ndu01_dev/ndu01/www_a_eng $alephe_root/www_a_eng $ndu01_dev/ndu01/www_b_eng $usm01_dev/usm01/www_b_eng $ndu01_dev/ndu01/www_c_eng $usm01_dev/usm01/www_c_eng $ndu01_dev/ndu01/form_eng $usm01_dev/usm01/form_eng $ndu01_dev/ndu01/head_foot $usm01_dev/usm01/head_foot $ndu01_dev/ndu01/tab/rep_col $usm01_dev/usm01/tab/rep_col

SYSTEM TRAINING -20- More Configuration files …. $alephe_root/www_server_defauls $alephe_root/pc_server_defauls …. $alephe_tab/ …. $aelphe_tab/license ….

SYSTEM TRAINING -21- Util w - Servers Management W. Server Management (WWW,PC,Z39) Exit procedure 1. Monitor servers 2. Stop servers 3. Start servers 4. View log file Please select [exit]:

SYSTEM TRAINING -22- Util X - Clean Up X. Clean Up Exit procedure 1. Clean alephe_scratch 2. Clean data_scratch 3. Clean data_files 4. Clean TMPDIR 5. Clean server log files 6. Clean TMPMEDIA 7. Clean utf_files directory Please select [exit]:

SYSTEM TRAINING -23- Util y - Node Management Y. Node Management Exit procedure 1. Define months for Short Loans (tab_month) 2. Define days of the week for Short Loans (tab_days) 3. Update base table (tab_base) 4. Update table of sublibraries (tab_sub_library) 5. Update user functions (user_function) 6. Update path conversion file (path_convert) 7. Update table of library relations (library_relation) 8. Update Oracle passwords of Aleph users (ora_passwd) 10. Definition of system links for Union Catalog (tab_net_sid.lng) 11. Display license status. 12. Unicode tables are to be found in UTIL/P or under../alephe/unicode 13. Update circulation/cash authorizations (tab_attr_sub_library) 14. Define ALEPH environment (aleph_start_505 & aleph_start_505.private) 15. Define startup defaults (aleph_startup_505) 16. IP addresses for server to server connection (tab_net) 17. Addresses of sublibraries for printouts (tab_sub_library_address.lng) 18. Table names for ALEPHADM module (tab_alephadm.lng) 19. List of tree view programs for Navigation windows (tab_tree_view) 20. Define headings for tree view (pc_tree_c1501) Please select [exit]:

SYSTEM TRAINING -24- Node Management Job daemon Jobs management, done by ALEPH. The daemon file is $alephe_tab/job_list. $alephe_tab/job_list.conf hold job patterns. $TMPDIR/jobs.log is the daemon log file. UTIL E used to handle the daemon.

SYSTEM TRAINING -25- E. Monitor background jobs Exit procedure 1. Start update doc index 2. Stop update doc index 3. Start Rlin Loader 4. Stop Rlin Loader Start request handling (ADM library only) 7. Stop request handling (ADM library only) 8. Start update BIB Acc from aut (acc + doc) 10. Stop update BIB Acc from aut 11. Start messaging update 12. Stop messaging update Managing job daemon 15. Update daemon job list Please select [exit]: Job daemon UTIL E

SYSTEM TRAINING -26- Job daemon UTIL E 14 Managing job daemon(e 14) 0. Exit procedure 1. activate job daemon 2. kill job daemon 3. show running job daemon 4. show job daemon log /aleph/a55_5/aleph/exe/jobd Enter CR to continue... Loading: /aleph/a55_5/alephe/tab/job_list.conf Loading: /aleph/a55_5/alephe/tab/job_list Current time: Friday 05 February :29:57 [ ] Wait for: seconds jobd.log: END

SYSTEM TRAINING -27- Job daemon UTIL E 15 Monitor background jobs - util_e_15 0. Quit from procedure 1. Edit job_list (using vi editor) Display job_list Edit job_list.conf (using vi editor) Display job_list.conf Reload job_list/job_list.conf in jobd Enter number [0]

SYSTEM TRAINING -28- ! ! Define weekly procedure slots: ! !1 2 3 !!----!-!!!!!!! W1 W NYYYYYN ! ! Define daily procedure slot: ! ! !!----!-!!!!!-!!!!!-!!!!! D1 D 09:00 17:00 01:00 Job daemon UTIL E 15 7 (job_list.conf)

SYSTEM TRAINING :00:00 Y USM01 util_a_10_b USM :00:00 Y USM01 util_a_11_b USM :00:00 Y USM01 util_a_12_b USM :00:00 Y USM01 util_a_13_b USM01 ! 05 00:01:00 Y USM50 p_cir_01 USM50 ! ! job using W1 weekly definition (Mon-Fri) ! W1 22:00:00 Y USM50 p_cir_01 USM50 ! ! job using day definition (every hour 9:00-17:00) ! 02 D1 Y USM50 p_cir_01 USM50 Job daemon UTIL E 15 3 (job_list)

SYSTEM TRAINING -30- Libraries Management A50.. Versus U50.. aleph a50_5 u50_5 …. alephalephm alephe (original) alephe (active) ndu01 ……

SYSTEM TRAINING -31- Libraries Management Directories Structure & aliases Every library has a separate root directory. Contains information relevant to administrating the library. Whereas library ’ s database is implemented within oracle.

SYSTEM TRAINING -32- Libraries Management Directories Structure & aliases Library root filestabpc_tabprint file_list prof_library Export file, dump files, batch queue, batch logs Library parameter and configuration tables. Clients parameter and configuration tables Print files drdtdp df1

SYSTEM TRAINING -33- sourcescratchwww_x_lngform_lng Source data for conversion Intermediate and log files HTML files, per language for WWW/ ALEPH server Forms patterns per language, created from ALEPH server ds Libraries Management Directories Structure & aliases Library root

SYSTEM TRAINING -34- Libraries Management Batch Queue Each library has its own batch jobs queue, administrated by the process lib_batch. Requested jobs are written to the file que_batch in the library ’ s data_files directory. run_b.nnnn lists each batch job that was executed by the process. its written in the library ’ s data_scratch directory.

SYSTEM TRAINING -35- Libraries Management Batch Queue batch_log lists all batch jobs that ever requested, not necessarily through queue. Written in library ’ s data_files directory. lib_batch_log shows transaction that done in all lib_batch processes UTIL C used to handle the process and the queue.

SYSTEM TRAINING -36- Libraries Management UTIL C C. Monitor batch jobs Exit procedure 1. Check library running process [10-12] 2. Start library batch queue [10-10] 3. Stop library batch queue [10-11] 4. Check library lock status [10-1] 5. Lock library [18] 6. Unlock library [19] 7. Show queue of jobs waiting execution [10-3] 8. Delete entry from queue of jobs waiting execution [10-7] 9. Alter run-time of job waiting execution [10-8] 10. Display logfile of a batch job [10-4] 11. Display log list of batch jobs [10-5] Please select [exit]:

SYSTEM TRAINING -37- C / /aleph/a55_5/aleph/exe/lib_batch USM01 Enter to continue C / 7 Jobname Target Entry Status p_manage_ Holding until p_manage_ Holding until press return for main menu Libraries Management UTIL C

SYSTEM TRAINING -38- Libraries Management UTIL C C / 8 Jobname Target Entry Status p_manage_ Holding until p_manage_ Holding until Enter entry number to delete,Q = QUIT,S = SHOW: Entry 36 was deleted

SYSTEM TRAINING -39- Libraries Management UTIL C C / 9 Jobname Target Entry Status p_manage_ Holding until Enter entry number to change time, Q = QUIT, S = SHOW: 37 Enter requested delay time (starting 00 today) 01 Confirm change run-time of entry 37 to 1 (Y/N): y Entry 37 was changed Enter entry number to change time, Q = QUIT, S = SHOW: s Jobname Target Entry Status p_manage_ Holding until

SYSTEM TRAINING -40- Libraries Management UTIL C C / 10 enter number of process in dayfile, "d" for all dayfiles, "q" to exit - d /aleph/a55_5/alephe/scratch/usm01_p_manage_ /aleph/a55_5/alephe/scratch/usm01_p_manage_ /aleph/a55_5/alephe/scratch/usm01_p_print_ duxx Standard input: END C / :31:36 p_manage_10 start USM01, ,0, :31:38 p_manage_10 Library USM01 locked in param :32:00 p_manage_10 end :32:01 p_manage_10 Library USM01 unlocked :16:20 p_manage_01 start USM01,N, , ,0, :16:21 p_manage_01 Library USM01 locked in param :20:55 p_manage_01 end :20:56 p_manage_01 Library USM01 unlocked