Open Access 机构仓储开源软件Dspace安装手册(转)
1、安装前提: 本节所描述的是成功安装 DSpace Server 所要用到的第三方组件和工具的配置。由于 DSpace 本身是建立在开源软件的标准工具集之上的,所以可能会有许多种安装方式。而我们所讲得只是一种推荐安装。 1.1 类 Unix 操作系统: Linux、HP/UX 等等。 1.2 Java 1.4 或者是更高版本: 只需要 J2SE 就可以了,不必安装 J2EE。 1.3 Apache Ant 1.5 或者是更高版本: Java 中类似 make 的工具。 1.4 PostgreSQL 7.3 或是更高版本: 开放源码的关系数据库服务器。 确保在运行 configure 命令时,加入以下参数: --enable-multibyte --enable-unicode --with-java 而在安装的时候,我们需要启用 TCP/IP 连接(DSpace 使用的是 JDBC)。编辑 postgresql.conf 文件,(该文件通常在 PostgreSQL 的数据文件目录中,例如:/usr/local/pgsql/data),加入下面的一行: tcpip_socket = true 然后编辑 pg_hda.conf 并加入一面一行: host dspace dspace 127.0.0.1 255.255.255.255 md5 这是为了增加一些安全性。 最后重启一下 PostgreSQL 就可以了。 1.5 Jakarta Tomcat 4.x/5.x 或者是其等价的工具例如 Jetty 或 Caucho Resin。 这里要注意的是,DSpace 需要和 Tomcat 用同一个用户来运行。所以你可能需要让 Tomcat 以 "dspace" 用户身份来运行。 同时,我们必须保证 Tomcat 有足够的内存来运行 DSpace 并且使用 UTF-8 作为其默认文件编码格式来提供国际化字符支持。所以,确保在操作系统启动脚本中加入以下环境变量的设置: JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8" 2、安装步骤: 首先,我们要了解一下"目录名称": DSpace 使用三个不同的目录树。虽然在安装过程中你不需要了解它们的细节,但是你应该知道有它们存在,并且知道在本文档中如何表示它们: *源文件目录,用 [dspace-source] 来表示; *安装目录,用 [dspace] 来表示; *web配置目录,如果你是用 Tomcat,这个目录是 [tomcat]/webapps/dspace; [tomcat]是 Tomcat 的安装目录,也可以从 $CATALINA_HOME 中获得。 web配置目录是 web服务器在解包 dspace.war 之后生成的。请不要去改动它。 2.1 创建 DSpace 的用户: 使用 root 登陆,运行 #useradd -m dspace 注意:Tomcat (或是 Jetty 等)也许要以该用户身份运行。 2.2 下载最新的 DSpace 源码并解压缩: http://sourceforge.net/projects/dspace/ 下载之后,运行: $tar xzf dspace-source-x.x.tar.gz 2.3 将 PostgreSQL JDBC 驱动程序(.jar 文件)复制到 [dspace-source]/lib 目录下。 如果你是自己通过编译源码安装 PostgreSQL 的话,驱动程序应该在 postgresql-x.x.x/src/interfaces/jdbc/jars/postgresql.jar 或者,你可以直接从 http://jdbc.postgresql.org/download.html 下载。 但要确保你所获得的驱动程序和系统上所运行的 PostgreSQL 版本一致并且是 JDBC2 的。 2.4 创建一个 PostgreSQL 帐户,并用其创建一个 dspace 数据库: $createuser -U postgres -d -A -P dspace $createdb -U dspace -E UNICODE dspace 输入 DSpace 数据库的密码。 2.5 编辑 [dspace-source]/config/dspace.cfg 文件: 通常,你需要设置下面这些属性: dspace.url dspace.hostname dspace.name db.password (我们在上一步中输入的密码) mail.server mail.from.address feedback.recipient mail.admin alert.recipient (不是很重要但很有用!) 注意:如果你改变了 dspace.dir,则你必须相应的修改以 /dspace 开始的属性,例如:assetstore.dir,log.dir 等等。 2.6 创建 DSpace 的安装目录: 以 root 身份运行: #mkdir [dspace] #chown dspace [dspace] 这里假设 dspace 是我们为 DSpace 创建的系统用户。 2.7 以 dspace 用户的身份编译和安装 DSpace: $cd [dspace-source] $ant fresh_install 这里最可能出现的错误提示应该是数据库连接!:) 2.8 将 DSpace Web 应用包(.war 文件)复制到 Tomcat/Jetty/Resin 安装目录的相应位置下,例如: $cp [dspace-source]/build/*.war [tomcat]/webapps 2.9 创建初始管理员帐户: $[dspace]/bin/create-administrator 2.10 现在是验收成果的时候了: 启动(或重启)Tomcat 。 访问服务器,例如: http://dspace.myu.edu:8080/dspace 你将看到 DSpace 的主页。恭喜! 为了配置社区,你会需要经常访问管理员界面,只需要在服务器的 URL 后面跟上 admin 即可,例如: http://dspace.myu.edu:8080/dspace/dspace-admin 3、高级安装: 上面的步骤足够安装并配置起一个用来玩耍的测试服务器:)。但是如果你想要的是一个产品级的站点的话,我们还需要额外做一些工作。 3.1 计划任务: DSpace 的两项功能需要周期性地执行一个脚本: *电子邮件订阅功能; 通知用户有新的项目已经提交了。 *"媒体过滤器"工具; 为图像生成缩略图、将文档解包为全文以建立索引。 我们需要做的是,以 dspace 用户身份运行下面的命令: $crontab -e 然后添加以下的几行: # Send out subscription e-mails at 01:00 every day 0 1 * * * [dspace]/bin/sub-daily # Run the media filter at 02:00 every day 0 2 * * * [dspace]/bin/filter-media 当然了,你应该根据自己的情况来调整上面的设置。 PostgreSQL 也可以通过周期性的执行一些清理工作而使性能得到改善。比如优化索引和清除已经被删除的数据。以 postgres 的系统用户身份运行: $crontab -e 加入下面一行: # Clean up the database nightly at 2.40am 40 2 * * * vacuumdb --analyze dspace > /dev/null 2>&1 3.2 通过 HTTPS 使用 DSpace 老式的普通 HTTP 访问是不安全的。如果你的 DSpace 系统使用"用户名/密码"方式验证,或者是保存了一些敏感的内容,通过 HTTPS 方式访问是非常明智的决定。我们有两种选择: *Apache HTTPD; *Tomcat 或 Jetty 的内建 HTTPS 支持; 3.3 句柄服务器(The Handle Server) 未完待续...... |