MetaLib日常维护工作 李珍 艾利贝斯有限公司北京代表处 CCEU 培训 6.25-27,2014
内容提要 MetaLib系统维护 MetaLib新版界面配置 Ex Libris Ltd., 2014 Internal and Confidential
MetaLib系统维护 Ex Libris Ltd., 2014 Internal and Confidential
MetaLib系统维护 创建馆员及读者帐号 MetaLib 常用快捷命令 MetaLib运行日志 MetaLib系统状态监测 临时库和文件清理 更新CKB 安装MetaLib Service Pack 软件升级包 MetaLib 系统备份 MetaLib 系统恢复 建立Cron job
创建馆员及读者帐号 馆员帐号 /M管理界面 Staff Administration ->Create a New Staff Member Super User General Administrator Statistics & Reports User View Only User X-server User 读者帐号 /M管理界面 User Administration -> Register Users
MetaLib 常用快捷命令
MetaLib 命令——重建dat01索引 csh -f $aleph_proc/p_index_database dat01 >& $LOGDIR/index_dat01_yyyymmdd.log & 上述内容在一行完成,其中>&后面的内容是把重建索引的过程写到log目录下的一个文件里,并非必需。最后的&是为了让命令在后台执行,以免终端连接因故中断后导致索引不能成功完成。 然后可以用tail命令检查index_dat01_yyyymmdd.log 文件,如tail -f index_dat01_yyyymmdd.log(这里的yyyymmdd需换成实际的日期),如果出现end Library DAT01 unlocked字样,表示索引成功建完。另外,也可以ps -ef | grep p_index_database 看看还有没有索引进程,没有的话也可以判断索引已经建完。 当意外操作导致/M管理界面出现无法查找到数据库时,需要重建dat01索引,或者执行过import library后(恢复系统时),也需要重建dat01索引。
MetaLib运行日志 通过metalib用户登录服务器,输入cd $LOGDIR,就进入了MetaLib的日志目录(m4_1/log)。 其中,z39_gate_7331.log是检索z39 资源时的日志,search_server_4331.log是检索其它类型资源的时候的日志,www_server_m_4331.log是读者使用系统时的日志。 输入tail –f 日志名,当读者界面有访问时,可以跟踪日志内容的变化。 日志详略级别设置:$metalib_conf/www_server.conf 系统参数文件中的log level变量。 setenv log_level INFO (详细日志) setenv log_level ERROR (简单日志)
MetaLib系统状态监测 查看各服务是否启动 查看服务器空间是否足够 查看Oracle表空间是否足够 查看重要表数据是否异常
MetaLib检索状态监测 检索故障时,可先用perl –MLWP::Simple “getprint ‘数据库http地址’” 命令检查服务器是否可以连接上数据库。 查看有关search server日志(输入slog命令)
Metalib服务的启动和关闭(1) MetaLib的服务分三种 Oracle server; Apache httpd; MetaLib的www server和 search server及z39_gate。 启动和关闭MetaLib服务,就是要分别启动和关闭Oracle, Apache和MetaLib 自身服务。
Metalib服务的启动和关闭(2)——自身服务 用metalib登录服务器: >cd $metalib_conf >metalib_shutdown (关闭所有www server, search server, z39_gate) >metalib_startup (启动所有www server, search server, z39_gate) 此外: 在任何目录输入start_w 可重启www server。 在任何目录输入start_s 可重启search server。
Metalib服务的启动和关闭(3)——Apache服务 用metalib登录服务器: 输入:apcb 输入:./apachectl start (启动) ./apachectl stop (关闭) ./apachectl restart (重启) 此外,在任何目录输入start_apache 可重启apache server。 注:当系统服务端口小于1024时,需要用root用户登录,在同样目录执行上述命令。
Metalib服务的启动和关闭(4)——Oracle服务 用metalib登录服务器: 输入:dlib dat01 输入:util o 选择1,再选择2 为关闭Oracle,选择1 为启动Oracle。 此时需要Oracle 管理帐号/密码。
Metalib服务的启动和关闭(5)——总结 一般情况下,不需要重启Oracle 修改参数文件,需要重启www server:start_w 修改配置程序、检索地址等,需要重启search server: start_s 修改及复制z39配置,需要重启z39 gate: dlib dat01->util w 修改apache config 文件,需要重启apache server: start_apache
MetaLib系统参数文件及路径 系统基本参数文件 $metalib_conf/metalib_start (IP地址,server个数) $metalib_conf/www_server.conf (检索及显示整体控制) 界面参数文件 ins01/js/userchi.js (检索首页显示控制) ins01/js/info.ini (数据库导航默认显示字段) ins01/tab/www_const.chi (页面文字映射) ins01/tab/www_heading.chi (页面交互信息和提示) ins01/tab/tab_info.chi (数据库详细信息配置) ins01/tab/edit_doc_999.chi (检索结果详细格式配置) 修改后需重启www server,js目录下info.ini修改后,需运行预处理./pre ins01/js目录下文件还可通过http://serverip:port/cgi-bin/mng/ejconf.cgi?file=userchi.js 界面修改
>>/exlibris/metalib/m4_1/aleph/proc/clean_apache_logs 临时库和文件清理 MetaLib相关临时文件、日志文件和临时库vir01 >>dlib dat01 >>util x Apache日志清理 >>/exlibris/metalib/m4_1/aleph/proc/clean_apache_logs
更新CKB 在/M管理界面,点击Export-Import Procedures
安装MetaLib Service Pack 软件升级包 公司不定期提供MetaLib Service Pack软件升级包(补丁包)来修正MetaLib的bug和升级系统功能。 升级包可以从总部文档中心下载,也可以从国内FTP的metalib_servicepack目录下载。升级包命名规则为:METALIB-版本号- ServicePackItem –补丁号.tar.gz,例如:METALIB-4.3.3-ServicePackItem-1-641.tar.gz,只需要下载最近日期也就是补丁号最大的的更新包即可。 查看当前版本命令:ver LINUX, e6900a, Metalib 4.3.0 (548) copy 2, 21-Aug-2008 Oracle 102 PDS version: 1.3.20098 显示系统是V4.3版,service pack包的最新序号是548。
MetaLib 系统备份 完整备份(包括oracle数据和其他第三方软件) csh –f $aleph_proc/backup_metalib 备份文件名: m4_1_yymmdd.tar.gz 部分备份(只包括metalib运行软件和oracle数据) csh –f $aleph_proc/backup_metalib_no_product 备份文件名: m4_1_np_yymmdd.tar.gz 缺省备份路径 $metalib_conf下的metalib_start文件中的 setenv backup_dev ${ML_MOUNT}/back_temp 注意:以上备份都不包括Oracle软件本身
MetaLib 系统备份——仅导出数据文件 导出各库数据 >dlib dat01 (vir00,vir01) >csh –f $aleph_proc/exp_current_library 或 >csh –f $aleph_proc/oracle_exp_library 导出全部数据 >csh –f $aleph_proc/exp_all_library 或>csh –f $aleph_proc/oracle_exp_all_libraries 数据文件及其路径 m4_1/dat01/files/dat01.exportSEQ.tar.Z 或dat01.export.gz_aa m4_1/vir00/files/vir00.exportSEQ.tar.Z 或vir00.export.gz_aa m4_1/vir01/files/vir01.exportSEQ.tar.Z 或vir01.export.gz_aa
MetaLib 系统备份——新通用备份脚本(1) 用root帐户登录服务器,输入: >cd /exlibris/backup/scripts >./exec_backup_main m4 注意,exec_backup_main 是一个通用的备份脚本,空格后的m4是参数,不同参数表示备份不同的内容。其含义可以参考/exlibris/backup/conf 目录下的bkp_init.dat 文件,跟MetaLib相关的有: m1:metalib:metalib:/exlibris/metalib/m4_1:ora_cold (Oracle冷备份) m2:metalib:metalib:/exlibris/metalib/m4_1:ora_hot (Oracle热备份) m3:metalib:metalib:/exlibris/metalib/m4_1:ora_archive (Oracle归档模式备份) m4:metalib:metalib:/exlibris/metalib/m4_1:prd_software (MetaLib软件及数据备份) m5:metalib:metalib:/exlibris/metalib/m4_1:user_data (MetaLib数据备份) m6:metalib:metalib:/exlibris/metalib/m4_1:exp_user_data (MetaLib数据导出备份)
MetaLib 系统备份——新通用备份脚本(2) 另外,还可以在/exlibris/backup/conf 目录下的bkp_param.conf 文件中修改备份的路径等参数。例如: setenv BKP_DIR /exlibris/backup_files/ (这个就是默认的备份文件存放目录) setenv SUCCESS_BKPS 3 (这是oracle数据备份文件的保存周期) setenv BKP_MAIL zhen.li@exlibrisgroup.com(这个是备份完成后发送邮件通知的邮件地址)
MetaLib系统恢复(1) 关闭MetaLib服务(包含apache) 展开备份文件:tar zxvf m4_1_yymmdd.tar.gz 导入oracle数据 csh -f $aleph_proc/imp_all_libraries 或 csh -f $aleph_proc/oracle_imp_all_libraries 重建dat01索引 csh -f $aleph_proc/p_index_database dat01 清理vir01库 util x 9 启动Metalib 服务(包含apache)
MetaLib系统恢复(2) 为预防操作系统故障、硬盘故障,或需移植系统到新服务器,除日常MetaLib备份之外,最好定期备份整个/exlibris目录(包含metalib及oracle目录)。 需要时将文件恢复到新服务器,启动oracle,恢复metalib系统,并恢复操作系统相关文件。
建立cron job Sun setenv EDITOR vi crontab -e Linux crontab –e –u metalib 注意用metalib的帐号编辑cronjob
MetaLib新版界面配置 Ex Libris Ltd., 2014 Internal and Confidential
新界面目录结构(数据库整合检索) 图片:<instance>/icon_chi/* 新图片有guide.gif 页面文件:<instance>/ www_v_chi/*-lcl* 样式表: <instance>/js/userchi.css 参数文件:<instance>/js/userchi.js
新界面目录结构(数据库导航) MetaLib新版界面的数据库导航页面是由一些独立的静态的文件组成,可以部署到其他服务器上进行发布。 这些文件默认的位置: /exlibris/metalib/m4_1/apache/htdocs/db/ 包括db.htm, db.css, db.js 图片:db/pic/目录(注意:如有自定义图片,需分别放到ins01/icon_chi/和db/pic目录,以保证图片同步) 数据库导航页面的数据库列表根据MetaLib中的IRD数据生成(active status),与数据库整合检索页面的列表一致,显示详略和布局不同。
新界面默认检索首页配置 打开浏览器,输入如下格式的地址 show_pop=1; //1: 默认显示常用数据库,0: 默认显示可检数据库 http://serverip:port/cgi-bin/mng/ejconf.cgi?file=userchi.js 在编辑窗口中可以设置 show_pop=1; //1: 默认显示常用数据库,0: 默认显示可检数据库 show_able=1; //只在show_pop=1时有用。1: 显示可检数据库按钮,0: 隐藏可检数据库按钮 show_all=1; //1:默认显示所有数据库,0:默认显示可检数据库 默认首页地址:http://serverip:port/V?func=find-db-1-lcl, 如果想把快速检索集作为首页,地址为http://serverip:port/V?func=find-db-1-lcl&func=quick-1-check1-lcl
检索首页数据库列表显示方式配置 godown=0;//取消一个数据库的选择时是否将其下移 ce=1;//1: 中、外文数据库按左右列显示,0: 中、外文数据库上下显示 ce2=1;//1: 上(左)方为外文库,下(右)方为中文库,0: 上(左)方为中文库,下(右)方为外文库 nosub=0; //1: 强制不使用二级学科分类,0: 系统自动判断是否使用二级学科分类 show_abs=1; //1: 数据库列表中,点击数据库名称打开摘要信息 0: 点击数据库名称直接跳到数据库原地址 archive=1; //1:在常用数据库中仅显示上层数据库,点击后再展开显示, 0:不显示为上下层数据库关系
中外文数据库按左右或者上下顺序排列
检索首页显示图片配置 在数据库IRD编目界面“Presentation:Primary” 页下的Resource Icons字段中填入图片名(不要后缀),多个图片用逗号隔开 系统自动将IRD编目界面“Presentation:Secondary” 页Link to Database Guide 字段的url变成图片超链,该图片名称可以在userchi.js中定义 "guide":"<img src="+icon_path+"/guide.gif>“ 将所需图片传到/exlibris/metalib/m4_1/<instance>/icon_chi目录下(如果同时要在数据库导航中使用,也需传到/exlibris/metalib/m4_1/apache/htdocs/db/pic目录下 )
检索首页显示图片配置
“常用数据库”配置(数据库检索和导航都适用) 如果想把某个数据设置为“常用数据库”,有两种方法: 一是在Local页面的Local Field 5 字段中填入“+”号(推荐使用); 二是在Presentation:Secondary页面的Keywords字段中填入“popular ”这个关键词。 保存后记得进行“数据库pre预处理”(参考维护部分)。 如果想在MetaLib检索首页默认显示“常用数据库”列表,那么可以参考前面介绍修改userchi.js参数文件 show_all=0; show_pop=1;
“常用数据库”配置(数据库检索和导航都适用)
“试用数据库”配置(数据库检索和导航都适用) 在IRD的Presentation:Primary页面的Expiry Date for NEW Resource字段里,填入该数据库的试用截止时间,格式是YYYYMMDD 。 设置完成后,进行“数据库pre预处理”,所有Expiry Date for NEW Resource字段有时间的数据库就会在“试用数据库”中显示。并且在超过了设置的到期时间后,该数据库会自动消失在读者界面的数据库列表中(在管理界面依旧可以查到)。
“试用数据库”配置(数据库检索和导航都适用)
“上下层数据库合并显示”配置 首先在管理界面新增同一平台所有子库的共同上层数据库(如果已经增添过上层数据库IRD信息,可忽略),记录其Resource ID,然后在其它所有属于该平台或父库下的数据库的Local Field 4字段填上父库的Resource ID。 填写完毕后,经过“数据库pre预处理”,在数据库导航页面自动进行上下层数据库合并显示。 在数据库检索首页的“常用数据库”列表下也可合并显示,但是,要在userchi.js中增加参数: archive=1
“上下层数据库合并显示”配置
数据库导航中的数据库排序配置 新版界面的排序方式是“排序因子”+“数据库名”,排序因子字段是Local Field 5。只需要在Local Field 5字段中加上排序因子(2-3位数字,建议按10,20,30递增)即可手工排序。数字小的将排在前面。 如果Local Field 5为空,系统在排序时默认赋值为999。
“中文科技期刊数据库如果按拼音“Z”开头应该排在较末尾,现在加上排序因子,排在第三位。 数据库导航中的数据库排序配置 “中文科技期刊数据库如果按拼音“Z”开头应该排在较末尾,现在加上排序因子,排在第三位。
数据库导航页面的显示字段配置
数据库导航页面的显示字段配置 http://serverip:port/cgi-bin/mng/ejconf.cgi?file=info.ini 85641 u Y 访问地址 *655 a Y 文献类型 *513 a Y 访问年限 500 a Y 覆盖范围 subj Y 学科分类 520 a Y 内容简介 546 a Y 语种 *85649 u Y 使用指南 *270 p Y 联系人 LCL4 a 上层数据库 LCL5 a 重要性排序
数据库导航页面的显示字段配置 该文件列出了IRD 编目界面的主要字段,可以修改其名称及顺序,不要动第一列的字段名和第二列的子字段名,第3列为Y表示要显示在详细信息页(点击数据库名称即可显示详细信息),为空表示不在详细信息页显示。字段名前面标注“*”号表示该字段显示在简明信息页,默认可显示2个(数据库名称无需指定,默认一直显示)。 如果想在简明信息页显示2个以上字段,除了在info.ini中标注*号之外,还需要修改htdocs/db/db.js文件,增加语句<script>var fields=4</script> ,fields=4表示显示按顺序显示标注了*号的4个字段。
新界面字体、布局、颜色等配置 数据库检索界面 沿用了MetaLib旧版界面的样式文件metalib.css 修改或新增可通过ins01/js/userchi.css文件定义 数据库导航界面 htdocs/db/db.css htdocs/db/db.htm
新界面字体、布局、颜色等配置 推荐使用Firefox浏览器的firedug工具,可以很方便地定位想要修改的位置,可以直接在浏览器中修改实时查看结果,等到满意了,再复制到css文件中实际修改。
数据库检索及导航新界面的日常维护 新界面的数据库名称及内容显示,采取预处理的方式,节省了动态查询时间。所以在管理界面进行了修改操作之后,都需要重新预处理,才能反映到新界面。称为数据库pre预处理。 方法是cd /exlibris/metalib/m4_1/ins01/js 目录 ./pre 也可以把脚本放到crontab里定期执行。 例如: 30 12 * * * cd /exlibris/metalib/m4_1/ins01/js && ./pre > /dev/null 上例表示,每天中午12点30分,执行一次预处理。
MetaLib系统维护 创建馆员及读者帐号 MetaLib 常用快捷命令 MetaLib运行日志 MetaLib系统状态监测 临时库和文件清理 更新CKB 安装MetaLib Service Pack 软件升级包 MetaLib 系统备份 MetaLib 系统恢复 建立Cron job
MetaLib新版界面配置 界面目录结构 数据库检索首页配置 数据库列表显示方式 数据库图片 常用数据库配置 试用数据库配置 上下层数据库配置 数据库排序配置 数据库导航显示字段 字体、颜色等 数据库pre预处理 Ex Libris Ltd., 2014 Internal and Confidential
谢谢! zhen.li@exlibrisgroup.com