1 SYSTEM TRAINING System Administration Basic concepts Focus
1 SYSTEM TRAINING
System Administration Basic concepts Focus primarily on ALEPH server. Activities pertaining to ALEPH system administration. Node management. Libraries management. 2 SYSTEM TRAINING
Node Management Directories Structure & aliases aleph_start_505 Other configuration files aleph_startup_505 path_convert Job Daemon (UTIL E) 3 SYSTEM TRAINING
Libraries Management A 50. . Versus U 50. . Directories Structure & aliases Batch Queue (UTIL C) 4 SYSTEM TRAINING
Node Management Directories Structure & aliases Aleph root aleph Software executables, scripts ap, ae alephm Node management tables, parameters files Softwaredevelopment& maintenance programs $alephe_root am, apm, ac oracle Oracle Installation files tmp temporary directory $TMPDIR 5 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 6 SYSTEM TRAINING
aleph_start_505 - example (1) #aleph_start: # ### Version and/or platform dependent setting ################# # # Hostnames # setenv ORA_HOST ram 36 setenv IO_HOST ram 36 setenv Z 39_HOST ram 36 # # Directories: ALEPH_MOUNT - software + demo libraries # USER_MOUNT - user libraries # setenv ALEPH_MOUNT /aleph setenv USER_MOUNT /aleph 3 # setenv ALEPH_VERSION 505 setenv PATCH_NUMBER 14 setenv SUB_PATCH_NUMBER 2 setenv VERSION_NUMBER 0 # setenv usm 01_dev ${ALEPH_MOUNT}/a 5${VERSION_NUMBER}_5 setenv usm 02_dev ${ALEPH_MOUNT}/a 5${VERSION_NUMBER}_5 7 SYSTEM TRAINING
aleph_start_505 - example (2) setenv setenv setenv usm 01_dev usm 02_dev usm 10_dev usm 11_dev usm 12_dev usm 20_dev usm 30_dev usm 50_dev usm 60_dev ${ALEPH_MOUNT}/a 5${VERSION_NUMBER}_5 ${ALEPH_MOUNT}/a 5${VERSION_NUMBER}_5 ${ALEPH_MOUNT}/a 5${VERSION_NUMBER}_5 8 SYSTEM TRAINING
aleph_start_505 - example (3) setenv ALEPH_LIBS "$DEMO_LIBS" setenv set_library pw_library setenv setenv QUE_STARTUP_LIBS "usm 01 usm 50" WORD_STARTUP_LIBS "usm 01 usm 10 usm 20 usm 30 usm 50" REQUEST_STARTUP_LIBS "usm 50" ACC_AUT_STARTUP_LIBS "usm 01" MESSAGE_STARTUP_LIBS "usm 01 usm 10 usm 50" # USM 01 USM 50 # 9 # #If you want Aleph to connect to a remote Oracle Data. Base #setenv BOTH 'aleph_db' and 'TWO_TASK' to the SAME service # setenv ORACLE_SID aleph 2 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
aleph_start_505. private - example setenv setenv acc 01_dev acc 10_dev acc 11_dev acc 12_dev acc 60_dev /aleph 4/u 5${VERSION_NUMBER}_5 /aleph 4/u 5${VERSION_NUMBER}_5 #Add customer libraries to ALEPH_LIBS # #setenv ALEPH_LIBS "$ALEPH_LIBS xxxxx" setenv ALEPH_LIBS "$ALEPH_LIBS acc 01 acc 10 acc 12 acc 11 acc 60” # #Add customer libraries to STARTUP_LIBS # #setenv #setenv QUE_STARTUP_LIBS "$QUE_STARTUP_LIBS xxxxx" WORD_STARTUP_LIBS "$WORD_STARTUP_LIBS xxxxx" REQUEST_STARTUP_LIBS "$REQUEST_STARTUP_LIBS xxxxx" ACC_AUT_STARTUP_LIBS "$ACC_AUT_STARTUP_LIBS xxxxx" MESSAGE_STARTUP_LIBS "$MESSAGE_STARTUP_LIBS xxxxx" 10 SYSTEM TRAINING
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' 11 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
Node Management def_lib_env Placed in $aleph_proc/def_lib_env Defines library environment. alias dr alias ds alias dt alias df 1 alias dp 'cd $data_root/!*’ 'cd $data_scratch’ 'cd $data_tab’ 'cd $data_files’ 'cd $data_print’ alias util 'csh -f $aleph_proc/util' 12 SYSTEM TRAINING
Node Management prof_master Placed in $alephm_root/prof_master Defines profile for Unix user m 505. alias am alias apm alias ae alias ap alias wa 'cd $alephm_root’ 'cd $alephm_proc' 'cd $aleph_exe' 'cd $aleph_proc' 'cd $alephe_root/www_a_eng’ switch ($unix_name) case "SUN_OS_2" set prompt = "`hostname`=M$ALEPH_VERSION>>" breaksw 13 SYSTEM TRAINING
Node Management prof_library Placed in the library root directory. Defines profile for Unix user of the library. #define usm 01 directories setenv data_root $usm 01_dev/usm 01 setenv data_tab $usm 01_dev/usm 01/tab setenv data_pc_tab $usm 01_dev/usm 01/pc_tab setenv data_scratch $usm 01_dev/usm 01/scratch setenv active_library USM 01 source $aleph_proc/def_lib_env 14 set_symbol CON_START ENG set_symbol ACTIVE_LIBRARY USM 01 SYSTEM TRAINING
Node Management aleph_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. . . 15 SYSTEM TRAINING
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_proc 00 $lib echo -n "$lib" start_library_batch echo"" end 16 SYSTEM TRAINING
aleph_startup_505 - example (2) **********************# #UE_01 **********************# foreach lib ($word_startup_libs( start_proc 00 $lib echo -n "$lib" source $aleph_proc/util_e_01 echo"" end **********************# #UE_11 **********************# foreach lib ($message_startup_libs( start_proc 00 $lib echo -n "$lib" source $aleph_proc/util_e_11 echo"" end 17 SYSTEM TRAINING
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. 18 SYSTEM TRAINING
path_convert - example $usm 01_dev/usm 01/www_a_eng $alephe_root/www_a_eng $usm 50_dev/usm 50/www_b_eng $usm 50_dev/usm 50/www_b_fre $usm 50_dev/usm 50/form_eng $usm 50_dev/usm 50/form_ger $usm 50_dev/usm 50/form_fre $usm 50_dev/usm 50/tab/rep_col $alephe_root/www_a_eng $usm 01_dev/usm 01/www_b_fre $usm 01_dev/usm 01/form_eng $usm 01_dev/usm 01/form_ger $usm 01_dev/usm 01/form_fre $usm 01_dev/usm 01/tab/rep_col $ndu 01_dev/ndu 01/www_a_eng $ndu 01_dev/ndu 01/www_b_eng $ndu 01_dev/ndu 01/www_c_eng $ndu 01_dev/ndu 01/form_eng $ndu 01_dev/ndu 01/head_foot $ndu 01_dev/ndu 01/tab/rep_col $alephe_root/www_a_eng $usm 01_dev/usm 01/www_b_eng $usm 01_dev/usm 01/www_c_eng $usm 01_dev/usm 01/form_eng $usm 01_dev/usm 01/head_foot $usm 01_dev/usm 01/tab/rep_col 19 SYSTEM TRAINING
More Configuration files…. $alephe_root/www_server_defauls $alephe_root/pc_server_defauls …. $alephe_tab/…. $aelphe_tab/license …. 20 SYSTEM TRAINING
Util w - Servers Management W. Server Management (WWW, PC, Z 39( ----------------. 0 Exit procedure. 1 Monitor servers. 2 Stop servers. 3 Start servers. 4 View log file Please select [exit: [ 21 SYSTEM TRAINING
Util X - Clean Up X. Clean Up ----------. 0 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. 8. 9 Please select [exit: [ 22 SYSTEM TRAINING
Util y - Node Management Y. Node Management ----------. 0 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_c 1501( 23 Please select [exit: [ SYSTEM TRAINING
Node Management Job daemon Jobs management, done by ALEPH. The daemon file is $alephe_tab/job_list. conf hold job patterns. $TMPDIR/jobs. log is the daemon log file. UTIL E used to handle the daemon. 24 SYSTEM TRAINING
Job daemon UTIL E E. Monitor background jobs -----------. 0 Exit procedure. 1 Start update doc index. 2 Stop update doc index. 3 Start Rlin Loader. 4 Stop Rlin Loader. 5. 6 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. 13. 14 Managing job daemon. 15 Update daemon job list Please select [exit: [ 25 SYSTEM TRAINING
Job daemon UTIL E 14 Managing job daemon 0. 1. 2. 3. 4. (e 14) Exit procedure activate job daemon kill job daemon show running job daemon show job daemon log / 16936 aleph/a 55_5/aleph/exe/jobd Enter CR to continue. . . Loading: /aleph/a 55_5/alephe/tab/job_list. conf Loading: /aleph/a 55_5/alephe/tab/job_list Current time: Friday 05 February 1999 10: 29: 57 [918203397] Wait for: 41403 seconds jobd. log: END 26 SYSTEM TRAINING
Job daemon UTIL E 15 Monitor background jobs - util_e_15. 0 Quit from procedure. 1 Edit job_list (using vi editor(. 2. 3 Display job_list. 4. 5 Edit job_list. conf (using vi editor(. 6. 7 Display job_list. conf. 8. 9 Reload job_list/job_list. conf in jobd Enter number [0[ 27 SYSTEM TRAINING
Job daemon UTIL E 15 7 (job_list. conf) --------------------! !Define weekly procedure slots: ! 3 2 1! !!!!!!!-!----!! W 1 W NYYYYYN --------------------! !Define daily procedure slot: ! 5 4 3 2 ! !!!!!-!!!!!-!----!! D 1 D 09: 00 17: 00 01: 00 28 SYSTEM TRAINING
Job daemon UTIL E 15 3 (job_list) 23: 00 00 Y USM 01 util_a_10_b USM 01 23: 00 00 Y USM 01 util_a_11_b USM 01 23: 00 00 Y USM 01 util_a_12_b USM 01 23: 00 00 Y USM 01 util_a_13_b USM 01 ! 00: 01: 00 05 Y USM 50 p_cir_01 USM 50 ! !job using W 1 weekly definition (Mon-Fri( ! W 1 22: 00 Y USM 50 p_cir_01 USM 50 ! !job using day definition (every hour 9: 00 -17: 00( ! 02 D 1 Y USM 50 p_cir_01 USM 50 29 SYSTEM TRAINING
Libraries Management Versus U 50. . A 50. aleph u 50_5 a 50_5 . …alephm alephe (original) (active) ndu 01 …… 30 SYSTEM TRAINING
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. 31 SYSTEM TRAINING
Libraries Management Directories Structure & aliases Library root files file_list prof_library dr tab Export file, dump files, batch queue, batch logs Library parameter and configuration tables. df 1 dt pc_tab Clients parameter and configuration tables print Print files dp 32 SYSTEM TRAINING
Libraries Management Directories Structure & aliases Library root source Source data for conversion scratch www_x_lng Intermediate and log files HTML files , per language for WWW/ ALEPH server form_lng Forms patterns per language, created from ALEPH server ds 33 SYSTEM TRAINING
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. 34 SYSTEM TRAINING
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. 35 SYSTEM TRAINING
Libraries Management C C. Monitor batch jobs ---------0. 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]: 36 SYSTEM TRAINING UTIL
Libraries Management C UTIL C/1 30534 /aleph/a 55_5/aleph/exe/lib_batch USM 01 Enter to continue C/7 Jobname Target Entry Status --------------- -----p_manage_05 00036 Holding until 19990205 00 p_manage_06 00037 Holding until 19990206 20 press return for main menu 37 SYSTEM TRAINING
Libraries Management C UTIL C/8 Jobname Target Entry Status ------------ -----p_manage_05 00036 Holding until 19990205 00 p_manage_06 00037 Holding until 19990206 20 Enter entry number to delete, Q = QUIT, S = SHOW: 00036 Entry 36 was deleted 38 SYSTEM TRAINING
Libraries Management C UTIL C/9 Jobname Target Entry Status --------------- -----p_manage_06 00037 Holding until 19990206 20 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_06 00037 Holding until 19990205 01 39 SYSTEM TRAINING
Libraries Management C UTIL C / 10 enter number of process in dayfile, "d" for all dayfiles, "q" to exit - d /aleph/a 55_5/alephe/scratch/usm 01_p_manage_01. 00033 /aleph/a 55_5/alephe/scratch/usm 01_p_manage_10. 00032 /aleph/a 55_5/alephe/scratch/usm 01_p_print_04. 00034. duxx Standard input: END C / 11 40 22 -01 -1999 11: 36 p_manage_10 22 -01 -1999 11: 38 p_manage_10 22 -01 -1999 11: 32: 00 p_manage_10 22 -01 -1999 11: 32: 01 p_manage_10 27 -01 -1999 16: 20 p_manage_01 USM 01, N, 0000000, 9999999, 0, 00 27 -01 -1999 16: 21 p_manage_01 27 -01 -1999 16: 20: 55 p_manage_01 27 -01 -1999 16: 20: 56 p_manage_01 start USM 01, 0000, 0, 00 Library USM 01 locked in param end Library USM 01 unlocked start Library USM 01 locked in param end Library USM 01 unlocked SYSTEM TRAINING
- Slides: 40