bin版安装说明(2.8)

0. 说明

Sakai复旦共享版的安装方式与Sakai正式版基本一致,因此,可以完全参照Sakai官方安装文档

1. 安装操作系统

Sakai由Java语言开发,理论上任何安装有JVM虚拟机的操作系统都可以安装。从Sakai社区中提供的信息来看,Linux, Windows, Solaris都有相应的安装实例。复旦大学使用Debian Linux 作为操作系统。以下的说明都将以Debian Linux作为范例。

在Debian的官方网站上,有详尽的安装指导

2. 准备运行环境

2.0 安装sudo(可选)

基于安全考量,强烈建议在操作系统安装完毕后,安装sudo 。使用root帐号进行日常操作存在很大的安全隐患。
下文给出的命令中,若以#开始,则表示需要以管理员身份执行,若以$开始则表示可以以一般用户在有权限的目录中执行。一般用户可以通过sudo命令进行权限提升。#与$都是命令行提示符,不属于命令的一部分。

# apt-get install sudo

2.1 安装JVM

Sun JDK 6和Open JDK 6都能够符合Sakai的要求,由于Sun JDK已从最新的Debian软件库中移除,所以可以安装Open JDK

# apt-get install openjdk-6-jdk

2.3 安装MySQL(可选)

按照Sakai官方文档,目前稳定支持的数据库包括Oracle、MySQL、HSQLDB三种,其中不建议在生产环境中使用HSQLDB。复旦大学使用MySQL作为数据库服务器。

# apt-get install mysql-server

为了使MySQL的默认字符编码为UTF-8,需要在MySQL的配置文件(/etc/mysql/my.cnf)中加入如下配置:
在client,mysqld,mysql三段中都加入
default-character-set=utf8

如果不进行任何额外配置,Sakai将使用HSQLDB作为默认数据库。

2.4 安装Apache Tomcat

Sakai 2.8.x目前 只支持 5.5版本的Tomcat。注意: 不要 使用apt-get安装Tomcat,否则配置极其复杂。

请到官方网站下载最新的Apache Tomcat 5.5 。也可以使用wget 命令进行下载。此命令在安装Debian时会自动安装。下面是从apache的北京交通大学镜像站点中进行下载

$ wget http://mirror.bjtu.edu.cn/apache/tomcat/tomcat-5/v5.5.36/bin/apache-tomcat-5.5.36.tar.gz

注意:请下载Core版本的Tomcat。下载后将Tomcat解压到有权限的目录,如/opt/tomcat。以下将以%TOMCAT_HOME%来表示这个目录(注意,为避免歧义,这个目录下应该有bin, commons, conf, webapps等文件夹)。可以使用下面的命令将下载的压缩包解压到当前目录

$ tar xzvf apache-tomcat-5.5.35.tar.gz

删除Tomcat自带的一些示例,即%TOMCAT_HOME%/webapps目录下所有目录

$ rm -rf %TOMCAT_HOME%/webapps/* 

3. 安装复旦共享版Sakai

3.1 下载二进制包

下载页面中下载复旦Sakai共享版的bin版,

3.2 将Sakai部署到Tomcat

3.2.1 增加首页自动跳转页面

由于Sakai的默认首页路径为/portal,所以需要增加首页跳转页面进行自动跳转。
在%TOMCAT_HOME%/webapps目录下创建ROOT目录(注意大小写),然后在ROOT目录下创建文件index.html,内容如下:

<html>
<head>
  <title>Redirecting to /portal</title>
  <meta http-equiv="Refresh" content="0:URL=/portal">
</head>
<body bgcolor="#ffffff" onLoad="javascript:window.location='/portal';">
  <div style="margin:18px;width:288px;background-color:#cccc99;padding:18px;border:thin solid #666600;text-align:justify">
  <p style="margin-top:0px">
    You are being redirected to the Sakai portal. If you are not automatically redirected, use the link below to continue: <br/>
    <a href="/portal">Take me to the Sakai portal</a>
  </p>
</body>
</html>

3.2.2 增加setenv.sh来设定Tomcat运行参数

在%TOMCAT_HOME%/bin目录下新建setenv.sh,内容如下

export JAVA_HOME="/usr/lib/jvm/java-6-openjdk-amd64" 
export JAVA_OPTS="-server -Xms512m -Xmx2048m -XX:PermSize=128m -XX:MaxPermSize=512m -XX:NewSize=192m -XX:MaxNewSize=384m -Djava.net.preferIPv4Stack=true -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true -Duser.language=zh -Duser.region=CN" 

其中JAVA_HOME设定为JDK的安装目录,请根据具体的机器环境进行设置。

3.2.3 修改catalina.sh

修改%CATALINA_HOME%/catalina.sh,在第二行加入如下代码

CATALINA_HOME=%TOMCAT_HOME%

注意将%TOMCAT_HOME%替换为对应的目录绝对路径

3.2.4 修改server.xml

修改%TOMCAT_HOME%/conf/server.xml,增加对于GET方法的UTF-8字符支持
将下面这段

<Connector port="8080" maxHttpHeaderSize="8192" 
           maxThreads="150" minSpareThreads="25" maxSpareThreads="75" 
           enableLookups="false" redirectPort="8443" acceptCount="100" 
           connectionTimeout="20000" disableUploadTimeout="true" />

修改为
<Connector port="8080" maxHttpHeaderSize="8192" URIEncoding="UTF-8" 
           maxThreads="150" minSpareThreads="25" maxSpareThreads="75" 
           enableLookups="false" redirectPort="8443" acceptCount="100" 
           connectionTimeout="20000" disableUploadTimeout="true" />

3.2.5 部署Sakai复旦共享版

将此前下载的bin版压缩包解压缩到%TOMCAT_HOME%下,此操作将合并%TOMCAT_HOME%目录下的若干文件夹。

3.3 安装中文字体

在Sakai中有部分工具支持PDF导出功能,由于PDF格式的一些限制,对中文的默认支持不理想,需要在操作系统中安装相应的中文字体,并指定在PDF导出时使用的字体。在复旦大学的部署中,我们使用的是“AR PL UMing CN”。此功能是Sakai复旦共享版特有的功能,目前Sakai正式版尚未修正此问题。

3.3.1 安装字体

# apt-get install fonts-arphic-uming

3.3.2 为Sakai指定到处PDF文件时的默认字体

在%TOMCAT_HOME%/sakai/目录(此目录可能需要手工创建)下创建sakai.properties文件。
加上如下内容

fop.pdf.default.font=AR PL UMing CN

4 启动/停止Sakai

通过启动/停止Tomcat来启动/停止Sakai

4.1 启动Tomcat

在%TOMCAT_HOME%/bin目录下,运行

$ sh startup.sh

4.2 停止Tomcat

在%TOMCAT_HOME%/bin目录下,运行

$ sh shutdown.sh

5 访问Sakai

打开任意网页浏览器,访问 http://localhost:8080