SYSTEM TRAINING -1--1-. -2--2- System Administration Basic concepts Focus primarily on ALEPH server. Activities pertaining to ALEPH system administration

SYSTEM TRAINING

-1-

SYSTEM TRAINING

-2-

System AdministrationBasic conceptsFocus primarily on ALEPH server.Activities pertaining to ALEPH

system administration.Node management.Libraries management.

SYSTEM TRAINING

-3-

Node ManagementDirectories Structure & aliasesaleph_start_505Other configuration filesaleph_startup_505path_convertJob Daemon (UTIL E)

SYSTEM TRAINING

-4-

Libraries ManagementA50.. Versus U50..Directories Structure & aliasesBatch Queue (UTIL C)

SYSTEM TRAINING

-5-

Node Management Directories Structure & aliases

Aleph root

aleph alephe alephm oracle tmp

Software executables,

scripts

Node management -

tables, parameters files

Software -development & maintenance

programs

Oracle Installation

files

temporary directory

ap, ae am, apm, ac $TMPDIR$alephe_root

SYSTEM TRAINING

-6-

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

-7-

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

-8-

aleph_start_505 - example (2) setenv usm01_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5

setenv usm02_dev ${ALEPH_MOUNT}/a5${VERSION_NUMBER}_5








SYSTEM TRAINING

-9-

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}_5setenv acc10_dev /aleph4/u5${VERSION_NUMBER}_5setenv acc11_dev /aleph4/u5${VERSION_NUMBER}_5setenv acc12_dev /aleph4/u5${VERSION_NUMBER}_5setenv 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_masterPlaced in $alephm_root/prof_masterDefines 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 directoriessetenv data_root $usm01_dev/usm01setenv data_tab $usm01_dev/usm01/tabsetenv data_pc_tab $usm01_dev/usm01/pc_tabsetenv data_scratch $usm01_dev/usm01/scratch

setenv active_library USM01

source $aleph_proc/def_lib_env

set_symbol CON_START ENGset_symbol ACTIVE_LIBRARY USM01

SYSTEM TRAINING

-15-

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 . . .

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_convertre-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) -------------------------------- 0. 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 --------------------- 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.


SYSTEM TRAINING

-23-

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_c1501)


SYSTEM TRAINING

-24-

Node Management Job daemonJobs 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 ----------------------- 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


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

16936 /aleph/a55_5/aleph/exe/jobdEnter CR to continue...

Loading: /aleph/a55_5/alephe/tab/job_list.confLoading: /aleph/a55_5/alephe/tab/job_list

Current time: Friday 05 February 1999 10:29:57 [918203397]Wait for: 41403 secondsjobd.log: END

SYSTEM TRAINING

-27-

Job daemon UTIL E 15

Monitor background jobs - util_e_15

0. Quit from procedure1. Edit job_list (using vi editor)2.3. Display job_list4.5. Edit job_list.conf (using vi editor)6.7. Display job_list.conf8.9. 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:!! 2 3 4 5!!----!-!!!!!-!!!!!-!!!!!D1 D 09:00 17:00 01:00

Job daemon UTIL E 15 7 (job_list.conf)

SYSTEM TRAINING

-29-

00 23:00:00 Y USM01 util_a_10_b USM0100 23:00:00 Y USM01 util_a_11_b USM0100 23:00:00 Y USM01 util_a_12_b USM0100 23: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-


Library root

files tab pc_tab print

file_list prof_library

Export file,dump files,batch queue, batch logs

Libraryparameter andconfiguration

tables.

Clients parameter andconfiguration

tables

Print files

dr dt dpdf1

SYSTEM TRAINING

-33-

source scratch www_x_lng form_lng

Source datafor conversion

Intermediateand log files

HTML files, per language

for WWW/ALEPH server

Forms patternsper language,created fromALEPH server

ds


Library root

SYSTEM TRAINING

-34-

Libraries Management Batch QueueEach 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 Queuebatch_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 ------------------ 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]


SYSTEM TRAINING

-37-

C / 1

30534 /aleph/a55_5/aleph/exe/lib_batch USM01Enter to continue

C / 7

Jobname Target Entry Status------------------------------ ---------- ----- ------p_manage_05 00036 Holding until 19990205 00p_manage_06 00037 Holding until 19990206 20

press return for main menu


SYSTEM TRAINING

-38-


C / 8

Jobname Target Entry Status----------------------- ---------- ----- ------p_manage_05 00036 Holding until 19990205 00p_manage_06 00037 Holding until 19990206 20

Enter entry number to delete,Q = QUIT,S = SHOW:00036

Entry 36 was deleted

SYSTEM TRAINING

-39-


C / 9Jobname Target Entry Status------------------------------ ---------- ----- ------p_manage_06 00037 Holding until 19990206 20

Enter entry number to change time, Q = QUIT, S = SHOW:37Enter requested delay time (starting 00 today)01Confirm change run-time of entry 37 to 1 (Y/N):yEntry 37 was changed

Enter entry number to change time, Q = QUIT, S = SHOW:sJobname Target Entry Status------------------------------ ---------- ----- ------p_manage_06 00037 Holding until 19990205 01

SYSTEM TRAINING

-40-

Libraries Management UTIL C C / 10enter number of process in dayfile,"d" for all dayfiles, "q" to exit - d

/aleph/a55_5/alephe/scratch/usm01_p_manage_01.00033/aleph/a55_5/alephe/scratch/usm01_p_manage_10.00032/aleph/a55_5/alephe/scratch/usm01_p_print_04.00034.duxx

Standard input: END

C / 1122-01-1999 11:31:36 p_manage_10 start USM01,00000000,0,0022-01-1999 11:31:38 p_manage_10 Library USM01 locked in param22-01-1999 11:32:00 p_manage_10 end22-01-1999 11:32:01 p_manage_10 Library USM01 unlocked27-01-1999 16:16:20 p_manage_01 start USM01,N,0000000,9999999,0,0027-01-1999 16:16:21 p_manage_01 Library USM01 locked in param27-01-1999 16:20:55 p_manage_01 end27-01-1999 16:20:56 p_manage_01 Library USM01 unlocked

Documents

SYSTEM TRAINING -1--1-. -2--2- System Administration Basic concepts Focus primarily on ALEPH server. Activities pertaining to ALEPH system administration