Page tree
Skip to end of metadata
Go to start of metadata
This page contains macros or features from a plugin which requires a valid license.

You will need to contact your administrator.

1.0 获取 Sakai 源代码

有2种方式可以获取Sakai源文件

  1. 在Sakai发布页面中下载打包好的 zip 或 tar.gz 文件。
  2. 使用 Subversion (SVN) 直接从Sakai代码库中签出。
 
打包的Sakai可以从 http://source.sakaiproject.org/release/ 下载。
 
Sakai的源文件可以匿名从SVN代码库中签出。最新的开发代码在 /trunk 目录;稳定版在 /tags 目录,维护版在 /branches 目录。

从 Sakai 2.6 开始,Sakai的通用服务(例如认证、文件存储、事件、站点、工具、用户等)以Sakai Kernel(K1)的形式重新打包。在签出时,Kernel代码不包含在其中,需要额外签出。

从 Sakai 10 开始,Kernel的代码又重新体现在签出的代码中。

Sakai 10 发表版存档

您可以直接下载Sakai 10发布版存档:

Sakai 10 发布标签

通过下面的SVN命令,可以从代码库中签出稳定版的源代码:

svn co https://source.sakaiproject.org/svn/sakai/tags/sakai-10.0/ sakai-10.0

Sakai 10.x 维护分支

对代码的最新更新代码可以在维护分支中找到。请注意,有些更新可能需要修改数据库结构。通过下面命令可以签出维护分支的代码:

svn co https://source.sakaiproject.org/svn/sakai/branches/sakai-10.x/ sakai-10.x

2.0 安装 Java 1.7 

Oracle Sun Java SE 7(Java 1.7) 是Sakai推荐使用的版本,也是被测试最彻底的版本。Sakai 10也应该可以运行在Java 6上。由于包含了 jsp 和 jws 文件,所以仅安装JRE是不够的。Mac OS X 10.7及之后的版本默认不安装Java。

Java 7

2013年6月19日,报告了Java 7的一个兼容性问题。问题出在Comparators中,解决的方案是使用下面的JVM属性

-Djava.util.Arrays.useLegacyMergeSort=true

详细信息请参考 - http://sakai-project-mail-list-archives.1343168.n2.nabble.com/Building-Sakai-Java-7-and-Sakai-comparators-tt7589944.html 以及 KNL-1083 - Getting issue details... STATUS

 

请将JDK安装在默认目录下,或者安装在 /opt 目录中(如/opt/java)。否则,在运行时可能会遇到一些问题。

2.1 设置 Java 环境变量 

在Java运行环境中必须设置一些变量和属性。对于UNIX/Linux操作系统,可以在启动文件(例如~/.bash_login)中进行设置;Mac用户可以设置在 .bash_profile中;对于Windows用户,可以在 开始 -> 控制面板 -> 系统 -> 高级 -> 环境变量 中设置 JAVA_HOME

JAVA_HOME设置为Java的安装目录,并将/bin目录添加到环境变量PATH中。

(info) 如果已经设置了环境变量JRE_HOME,或者您希望在安装的多个JRE中使用特定版本,您也可以试着JRE_HOME变量。这是Apache Tomcat启动时使用的JRE。如果JRE_HOME没有设置,将默认使用JAVA_HOME。所以,只设置JAVA_HOME会更加方便。

环境变量

Unix/Linux

Mac

Windows

JAVA_HOME

export JAVA_HOME=/usr/java/java-current

export JAVA_HOME=/Library/Java/Home

JAVA_HOME=C:\jdk1.6.0_24

PATH

export PATH=$PATH:$JAVA_HOME/bin/

export PATH=$PATH:$JAVA_HOME/bin/

;C:\jdk1.6.0_24\bin

(warning) Windows: 在系统变量Path后进行添加

设置 JAVA_OPTS

默认的JVM设置不能满足Sakai的需要,所以,必须对JVM参数进行调整。以下是在JAVA_OPTS中至少要调整的内容。

(tick) 我们推荐您将这些设置防止在Tomcat的 /bin 目录中的setenv.sh(Unix/Linux/Mac)或setenv.bat(Windows)文件中。参加下面的Tomcat部分获取更多信息。

Unix/Mac:

export JAVA_OPTS='-server -Xms512m -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=512m -XX:NewSize=192m -XX:MaxNewSize=384m -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true -Djava.util.Arrays.useLegacyMergeSort=true'

Windows:

set JAVA_OPTS=-server -Xms512m -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=512m -XX:NewSize=192m -XX:MaxNewSize=384m -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true -Djava.util.Arrays.useLegacyMergeSort=true

(minus) 其它设置

某些JSF工具(如聊天室、学档、练习与测验)没法在Java 1.6中正常编译,解决的方案是设置allowArraySyntax参数,具体参考( SAK-17578 - Getting issue details... STATUS )。从Tomcat 5.5.27开始增加了强制引号转译符,在学档等工具中出现了jsp相关问题( SAK-15736 - Getting issue details... STATUS )。最后,设定非“Java/xxxx” HTTP user agent来解析Google或其它RSS feeds (参考 SAK-10159 - Getting issue details... STATUS SAK-13353 - Getting issue details... STATUS SAK-18044 - Getting issue details... STATUS ).

-Dsun.lang.ClassLoader.allowArraySyntax=true
-Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false
-Dhttp.agent=Sakai

设定语言和地区(可选)

通过设置系统变量 -Duser.language-Duser.region 可以定义默认语言和地区。更多的语言支持信息请参考 I18N 页面。

-Duser.language=zh
-Duser.region=CN

设定HTTP代理(可选)

如果需要在Sakai中设置HTTP代理,可以参考下面的例子进行设置。如果不进行这些设置,一些功能(如新闻工具的RSS抓取)将无法获取外部地址的信息。

-Dhttp.proxyHost=cache.some.domain 
-Dhttp.proxyPort=8080

3.0 安装 Subversion 1.6 或更新版本 

Sakai使用Subversion (SVN) 作为版本控制系统,如果需要从版本库中签出代码的话,就必须安装SVN。我们建议使用1.6.5或更新的SVN。您可以从官方网站上下载相应操作系统的安装文件,多数的Linux发行版的包管理软件中都包含了SVN。具体可以参考

http://subversion.apache.org/

如果没有对应您操作系统的安装文件,也可以从源文件进行安装,安装是请设置下面两个参数:--with-ssl 和 --with-libs。

为了确认您安装的SVN版本,可以通过下面的命令进行检查

svn --version
svn, version 1.6.9 (r901367)
   compiled Jan 25 2010, 22:25:43
. . . .

3.1 设置 Subversion 环境变量 

将环境变量SUBVERSION_HOME指向SVN的安装目录,并将/bin目录加入到环境变量PATH中。

如果是通过安装包进行安装,一般不需要设置下面参数。

环境变量

Unix/Linux/Mac

Windows

SUBVERSION_HOME

export SUBVERSION_HOME=/opt/subversion

set SUBVERSION_HOME=C:\subversion

PATH

export PATH=$PATH:$SUBVERSION_HOME/bin

;C:\subversion\bin

(warning) Windows: 将内容添加到环境变量Path最后

4.0 安装 Maven 3.0 或更新版本 

Apache Maven为Sakai提供了“一组编译标准,统一第三方类库以及管理、描述项目”(Better Builds, p. 22)。作为安装过程的一部分,您将使用Maven来编译、测试、部署Sakai。

(warning) Sakai 2.9以后的版本需要Maven 3.0或更新版本

您可以从下面地址下载Maven

http://maven.apache.org/download.html

解压缩下载的文件到本地目录,例如 /opt/maven/apache-maven-3.0.3,通过命令 mvn --version 确认安装版本。

注意:对于多数Linux发行版,可以在包管理软件中安装Maven。

mvn --version
Apache Maven 3.0.3 (r1075438; 2011-02-28 12:31:09-0500)
Java version: 1.6.0_20
Java home: /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home
Default locale: en_US, platform encoding: MacRoman
OS name: "mac os x" version: "10.6.3" arch: "x86_64" Family: "mac"

4.1 设置 Maven 环境变量 

为提升Maven性能,需要设置一些环境变量。对于UNIX/Linux操作系统,可以在启动文件(例如~/.bash_login)中进行设置;Mac用户可以设置在.bash_profile中;对于Windows用户,可以在 开始 -> 控制面板 -> 系统 -> 高级 -> 环境变量 中设置。

将环境变量 MAVEN_HOME 指向Maven安装目录,将/bin目录添加到系统变量PATH中:

环境变量

Unix/Linux/Mac

Windows

MAVEN_HOME

export MAVEN_HOME=/opt/maven/apache-maven-3.0.3

set MAVEN_HOME=C:\apache-maven-3.0.3

PATH

export PATH=$PATH:$MAVEN_HOME/bin

;C:\apache-maven-3.0.3\bin

(warning) Windows: 在系统变量Path后进行添加

MAVEN_OPTS

Maven在启动时不会读取JAVA_OPTS中的参数,有时会导致在编译时出现分配内存耗尽的情况。为了保证正常编译,需要在环境变量MAVEN_OPTS中定义下列内容。

export MAVEN_OPTS='-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m'

5.0 安装 Tomcat 7 

 
  • Apache Tomcat - http://tomcat.apache.org/
  • 注意:不要使用已安装的Tomcat,使用新安装的Tomcat
  • 注意:Windows用户在安装时,请不要在Tomcat的绝对路径中使用空格,否则可能会导致Sakai中的JSF工具问题
    好的路径名:C:\opt\tomcat\, C:\sakaistuff\installs\tomcat\
    不好的路径名:C:\program files\tomcat\, C:\opt\apache tomcat 7.0.1\
  1. 下载Tomcat 7 - http://tomcat.apache.org/download-70.cgi
    • 建议Windows用户使用zip版本,而不是安装版
      zip版本可以更方便地查看日志,更容易配置

      Sakai 2.9.1,需要运行在Tomcat 7.0.21或之前的版本中。更好的方案是使用更新版本的Sakai和Tomcat。
      STAT-339 - Getting issue details... STATUS
      SAK-23156 - Getting issue details... STATUS
  2. 解压缩文件到 /opt (解压缩后,通过符号链接的方式,创建tomcat链接并指向apache-tomcat-7.0.x目录)
    • 由于不支持符号链接,Windows用户需用重命名目录名
  3. 修改 conf/server.xml,添加国际化支持
    1. 在Connector元素下添加 URIEncoding="UTF-8" 属性
      • <Connector port="8080" URIEncoding="UTF-8" ...
  4. 设置环境变量: CATALINA_HOME=/opt/tomcat
  5. 添加 $CATALINA_HOME/bin 到环境变量 PATH
  6. 创建 在tomcat/bin目录中创建SETENV 文件,添加JAVA_OPTS (参考 安装 Java 1.7
    1. Mac/Linux: 创建文件 setenv.sh,并输入以下内容(您也可以将这些内容放在.bashrc文件中进行配置):

      export JAVA_OPTS="-server -Xmx1028m -XX:MaxPermSize=320m -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Djava.awt.headless=true -Dcom.sun.management.jmxremote -Dsun.lang.ClassLoader.allowArraySyntax=true"
      
    2. Windows(PC): 创建文件 setenv.bat,并输入以下内容:

      set JAVA_OPTS=-server -Xmx1028m -XX:MaxPermSize=320m  -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Djava.awt.headless=true -Dcom.sun.management.jmxremote -Dsun.lang.ClassLoader.allowArraySyntax=true
      
  7. [可选] 从webapps目录中删除默认的webapps

    rm -rf webapps/*
    
  8. 配置Tomcat 7,定义Tomcat 5.5中的classloader目录
    1. 编辑 conf/catalina.properties
      1. 在行 "common.loader=..." 后添加

        ,${catalina.base}/common/classes/,${catalina.base}/common/lib/*.jar
        
      2. 在行 "shared.loader=..." 后添加

        ${catalina.base}/shared/classes/,${catalina.base}/shared/lib/*.jar
    2. [可选] 创建目录

      mkdir -p shared/classes shared/lib common/classes common/lib
      

 

6.0 配置 Sakai 

1.0 创建 sakai.properties 文件 

sakai.properties 是Sakai的配置文件,一般存放在Tomcat安装目录的/sakai目录中,文件已简单的 键/值 方式存储配置,并通过 java.util.properties 进行加载。所有的配置在启动时读取,所以,对于此文件的修改只有在重启Tomcat之后才会生效。

如果通过源代码安装Sakai,默认的 default.sakai.properties 文件在如下位置,其中也包括了对于这些参数的说明:

sakai-src/config/configuration/bundles/src/bundle/org/sakaiproject/config/bundle/default.sakai.properties

(warning) bin和demo版本不包括此文件。

如果您向覆盖默认值,您必须自己创建 sakai.properties 文件,并在其中进行相应设置。

在设置完成后,将这些文件复制到相应的位置。

在Sakai中,可以通过几个配置文件来进行设置,当这些文件中的配置项不同时,将通过下列顺序进行读取(后面文件中的设置会覆盖前面文件的设置)

  1. 源文件中的default.sakai.properties
  2. ${sakai.home}/sakai.properties  (如果环境变量sakai.home没有额外设置,默认为${CATALINA_HOME/sakai}
  3. ${sakai.home}/local.properties
  4. ${sakai.security}/security.properties

如果需要指定sakai.home的值,可以通过下面的JAVA_OPTS参数进行:

-Dsakai.home=/path/to/desired/sakai/home/
 

2.0 为 我的工作空间 配置工具

每种类型站点主页中的工具可以通过下面的方式进行设置。如果相关属性没有设置,那么默认值为:sakai.iframe.sitesakai.summary.calendarsakai.synoptic.announcementsakai.synoptic.chatsakai.synoptic.messagecenter。如果不存在对应工具,相关部分在显示时会被略去。更多信息参考 SAK-15504 - Getting issue details... STATUS  和  SAK-16747 - Getting issue details... STATUS
wsetup.home.toolids.count=5
wsetup.home.toolids.1=sakai.privacy
wsetup.home.toolids.2=sakai.iframe
wsetup.home.toolids.3=sakai.synoptic.announcement
wsetup.home.toolids.4=sakai.synoptic.chat
wsetup.home.toolids.5=sakai.synoptic.messagecenter

3.0 会话过期警告

Sakai有一个属性 inactiveInterval@org.sakaiproject.tool.api.SessionManager,通过这个属性设定当用户在停止操作后多少时间自动结束会话。当用户会话结束时间小于警告时间(例如10分钟)时,会自动弹出提示窗口。当会话过期时,会自动跳转到登出页面。详细信息参考  SAK-13987 - Getting issue details... STATUS   SAK-8152 - Getting issue details... STATUS

此属性默认开启,您可以通过指定下面参数进行进一步设置:

timeoutDialogEnabled=true
timeoutDialogWarningSeconds=600

4.0 配置email 

如果需要让Sakai收发邮件,需要在 sakai.properties 中进行一系列设置。要让Sakai发送邮件,需要设定SMTP服务器地址:
smtp@org.sakaiproject.email.api.EmailService=some.smtp.org

Sakai's SMTP server is Apache James. Most sys admins prefer running a standard mailer like Postfix on port 25 (rather than James directly) and configuring it to forward requests to Sakai. You may also currently have a mailer service running on port 25 (Linux usually has it running by default). So consider setting James to run on a different port (e.g., 8025) in order to avoid conflicts.

To enable Sakai to receive mail you'll need to set the following properties:

# flag to enable or disable James for incoming email (true | false)
#Default=false.
smtp.enabled=true

# dns addresses used by James for incoming email.
smtp.dns.1=255.255.255.1
smtp.dns.2=255.255.255.2

# SMTP port on which James runs.  
# Recommend running on 8025, and using a standard mailer on 25 to forward mail to Sakai.
# Default=25.
smtp.port=8025

Additional settings can be enabled to add support emails for a variety of tasks.

# Email support address used in incoming email rejection messages.
mail.support=address@somedomain

# Email address to send errors caught by the portal, and user bug reports in response.
portal.error.email=address@somedomain

# Email address used as the "from" address for any email sent by Worksite Setup tool or Site Info tool.
setup.request=address@somedomain

# Send an email to the user when the user is added.
notifyNewUserEmail=true

5.0 配置日志 

Once you have Sakai installed, configured and started, you can monitor Sakai by watching the logs. The log level for the standard Sakai source code and the demo is set to show info and warnings only. Watch for the WARN: messages. There are going to be some "normal" ones at startup, and some will likely slip by at runtime, but any warning is potentially something you might want to check out.

Logging levels can be specified in sakai.properties. This augments and overrides the levels set in the default config file. Example:

log.config.count=3
log.config.1 = ALL.org.sakaiproject.log.impl
log.config.2 = OFF.org.sakaiproject
log.config.3 = DEBUG.org.sakaiproject.db.impl

This uses the established (if awkward) method of having a name.count followed by name.1name.2 etc. to form an array of strings for the value "name". In this case, the name is "log.config". The values are of the form LEVEL.logger, and the possible levels are: OFF TRACE DEBUG INFO WARN ERROR FATAL ALL.

Sakai uses log4j for logging. See the official log4j documentation for more information about how to configure it if you have questions, but a few notes are collected here below.

To change the logging for Sakai in the source modify kernel/kernel-common/src/main/config/log4j.properties the following property:

log4j.logger.org.sakaiproject=INFO

To turn on debug logging for all of Sakai, change the value from INFO to DEBUG. In order to enable debug logging for a single Sakai components, add a line such as in the following example, which will leave most of Sakai at INFO, but generate DEBUG level messages for the SQL service:

log4j.logger.org.sakaiproject=INFO
log4j.logger.org.sakaiproject.component.framework.sql.BasicSqlService=DEBUG

The logging controls are part of the LogConfigurationManager, implemented as a component in the Kernel. It can be disabled, if that's desired, with an entry in sakai.properties:

enabled@org.sakaiproject.log.api.LogConfigurationManager = false

For Mac and *nix systems, the most important log is found in Tomcat's logs/catalina.out. It can be instructive to watch this log as Tomcat is starting up, by using a startup command like the following:

bin/startup.sh; tail -f logs/catalina.out

Tomcat on Windows tends to be a little more puzzling about its logs, and it includes more of them, but its default behavior is to open catalina.out in a new window as soon as you start Tomcat. If you need more information about the logs in Windows, we'll refer you to the official Tomcat documentation.

(info) The SMTP server logs from Sakai will be written to the $CATALINA_HOME/sakai/logs directory.

6.0 管理临时文件

根据不同的使用情况,Sakai可能在系统临时目录(例如 /tmp)中创建大量临时文件。建议周期性地删除存在一天以上的文件,这个方法对大量使用email存档功能的部署尤为重要。注意,请不要将所有的文件都移除,因为其中有的文件可能正在使用中。

6.1 配置数据库 (HSQLDB)

默认配置中,所有的Sakai发布版本 (demo, binary, source) 使用 HSQLDB 作为数据库。HSQLDB 适用于测试以及本地开发,但在可靠性和可扩展性方面仍有不足。许多Sakai开发人员和Sakai部署使用MySQL或Oracle作为生产环境的数据库。

(info) 您不需要创建Sakai数据库的对象(表,索引等)。根据sakai.properties中的autoDDL属性,Sakai可以自动生成相应的内容。

7.0 编译、部署Sakai,在Tomcat中运行 

安装Sakai的master项目

Sakai使用Maven的项目对象模型(Project Object Model)进行项目的组织管理。顶层的master pom.xml在 /master 目录下,用于表示整个Sakai项目的最顶层,在这里定义了整个项目的一些参数和相关信息。如要编译Sakai,既可以在Sakai源文件的根目录执行下面的命令。

注意:英文版文档建议在master目录下执行操作,但其实现在在根目录下执行也可以,并且更加方便。

mvn clean install

安装和部署 Sakai

编译完Sakai之后,在源代码根目录下执行下面的命令部署Sakai到Tomcat。注意下面的命令仅不包含编译过程,只包括部署过程。

(info) -Dmaven.tomcat.home 用来表示Tomcat的位置。

mvn sakai:deploy -Dmaven.tomcat.home=/pathto/tomcathome

如果要将编译和部署都放在一条命令中执行,可以使用下面的命令

mvn clean install sakai:deploy -Dmaven.tomcat.home=/pathto/tomcathome

在第一次编译的过程中,Maven会将依赖的第三方库下载到本地(默认在.m2/repository目录),这是一个非常耗时的过程。这些库在与Sakai代码集成后,将会打包部署到Tomcat的 $CATALINA_HOME/webapps,$CATALINA_HOME/components 和 $CATALINA_HOME/shared/lib 目录。如果操作时发生错误,请仔细阅读出错信息。

您也可以进入特定的Sakai模块目录,并执行上面的命令编译、部署单个Sakai模块。

Maven 命令选项

还有其它通过Maven编译、部署Sakai的方式:

输出调试信息

mvn -X clean install sakai:deploy

在离线模式下编译、部署 

如果您的本地Maven仓库已经包含了Sakai项目的依赖包,您可以通过指定 -o 选项使用离线模式:

mvn -o clean install sakai:deploy

跳过单元测试 

如果您不需要在编译、部署中执行单元测试,可以通过设定 -Dmaven.test.skip=true 进行:

mvn clean install -Dmaven.test.skip=true sakai:deploy

7.1 启动、停止Tomcat 

通过调用 $CATALINA_HOME/bin 目录中的相应脚本,可以启动、停止Tomcat:

Unix/Linux/Mac

sh startup.sh
sh shutdown.sh

Windows

startup.bat
shutdown.bat

8.0 探索 Sakai

至此Sakai的部署已经完成了。下面就要开始在系统中添加用户,创建站点,或者使用Sakai里的工具进行一些操作了。本说明不会把整个用户指南都放在这里, 但这里会提供一些链接转向更详细的内容。

首页

Tomcat成功启动以后,在浏览器中就可以访问这个地址了:http://localhost:8080/portal (或者用服务器主机名代替'localhost')。在首页上可以注册 新用户,也可以浏览公开的网站内容。可以在首页上注册一个新用户而后开始使用Sakai,同样,管理员也可以创建新用户并且能够赋予新用户正确的权限及角色,所以以管理员登录作为使用Sakai的开端会是一个更好的选择,系统默认的超级管理员账号密码均为'admin'。

我的工作空间

每一个系统中的用户包括管理员都有一个叫做‘我的工作空间’的个人站点。登录系统后会默认显示该站点,其选项卡处在站点导航栏的第一个(导航栏的左上角)。左边栏列出了站点中可以使用的各种工具,每种不同的用户类型都可以通过设置模板(Template)来定义我的工作空间的不同的工具集。

其他站点

每一个新的可访问的站点都会成为站点导航栏中的一个选项卡。对大多数用户来说,默认只有一个站点的访问权限-即我的工作空间站点。管理员用户相较于普通用户多了一个管理员工作空间站点(跟管理员的个人工作空间站点极其相似,略有不同)。

这种设定的原因是为了便于让某个不能访问管理员的我的工作空间站点的用户能够使用管理员工具(系统中的我的工作空间站点都是私有的,其他人无法访问)。为了让某个特定用户能够访问管理员工作空间站点(即拥有管理员权限),可以通过领域编辑器赋予其超级管理员权限。

(info) 具体的赋予某一特定用户管理员权限的方法如下:
管理:领域编辑器—选择/site/!admin领域进行编辑—赋予能力—输入用户ID并选择admin角色—保存
然后在该用户登录系统后会在站点导航栏中多出一个‘管理员工作空间’站点。

管理员工具

创建用户

为了确保安全性,首先要更改管理员密码,并且要在系统上创建示例用户,以上两项工作都可以通过左侧的用户工具完成。更改管理员用户的密码,只需在用户列表中点击管理员的用户名,并编辑后续页面上的字段。点击在工具页面顶部的新用户操作的链接可以创建用户。

创建站点

第一次创建工作站最好不要直接使用站点工具。使用站点工具是从头创建整个站点的一个强大的方法,它可以细粒度地控制每个页面、工具盒配置细节,但是这个灵活的功能会导致大量的界面和工作流。因此,最好使用站点工具调整已存在的站点。

创建站点的最佳途径是使用站点设置工具。点击在工具页面顶部的新链接,然后选择项目站点类型,这样可以避免术语等问题。无论哪种类型的站点都能工作,所有类型的站点都会提供可用的工具。

逐步完成其余的站点创建网页,在创建过程结束时一定要点击创建站点按钮。完成后可以在屏幕顶部的新选项卡中看到站点标题。

将用户加入站点

管理员建立了站点之后就是这个站点的所有者和第一个成员。通过站点信息工具可以添加其他用户,并且可以定义不同的角色。

点击新站点的选项卡(现在应该是可见的)进入站点,然后点击站点左侧的站点信息链接。站点信息有很多可用的站点维护功能,如站点顶部的操作链接,允许您将其他用户加入到站点,当然这些用户需要提前创建。

需要注意的是,站点顶部的编辑工具允许删除或添加工具。

测试工具

进入站点后可以看到帮助工具,帮助工具提供各种工具的在线文档和系统其他方面的内容,能帮助你更好地学习软件的功能。

点击工具条右上方的问号图标能使用帮助工具进行上下文相关的帮助,点击问号能找到关于当前所使用的工具的内容。

当你适应了标准工具,可能希望看到更适合Sakai的实验性的工具。Sakai的分布包括临时性工具还不成熟,但是已经能够满足标准工具所不能提供的创新方法。这些额外的工具需要额外的步骤,所以系统使用者不会在不经意的情况下使用到,但是鼓励大家在自己的开发中评价这些工具。

更多内容

关于该项目

可能你已经注意到,sakaiproject.org 提供了项目完整的的背景和情况介绍以及其目标。要看更多关于进度、开发工具和其他方案的详细信息,请看相关的Confluence空间。

参与社区

Sakai 社区提供关于各种主题的电子邮件论坛。列表是开放的,但是非会员的电子邮件会被拒绝接收,所以在发送邮件之前需要加入一个列表。假如你不加入列表,你也可以浏览论坛里的文件。

 Sakai的四大社区为:

公告 (announcements@apereo.org) -社区中与Apereo相关项目,包括Sakai(接收通讯;了解会议和期限;关注即将发布进展;参与社区号召)。这是个小容量的只读列表,每个人都应该加入。

构建 Sakai (sakai-dev@collab.sakaiproject.org) -设计、开发、测试和记录Sakai(了解构建工具和集成服务的技术细节;为工具和服务的设计和开发寻找指导方针;查找技术规范;了解新版本的计划)。适合于设计师、程序员、开发人员和质量保证人员。

教育学(pedagogy@collab.sakaiproject.org) -教学、协作和Sakai的其他用途(学习最佳实践;分享经验;与有相似兴趣的用户社区联系;K- 12;高等教育;档案)。适合于教师、工作人员、学生、研究人员、教学设计师、指导技术人员和终端用户的支持人员。

部署 Sakai (production@collab.sakaiproject.org) -实施、安装、配置和支持Sakai(寻找发布文档;了解性能调优;浏览建议的硬件和软件配置;分享训练的样本、教程和支持材料)。适合于系统管理员、数据库管理人员和技术支持人员。

这里还有各种各样小的、主题明确的工作小组,他们也使用电子邮件列表,你可以参与感兴趣的社区。

加入Sakai 邮件列表可以点击:

http://collab.sakaiproject.org/mailman/listinfo/

并加入你感兴趣的列表。你需要填写一份简式(用户名、密码),并且可以选择是否接收每个列表(默认)或批处理每日摘要。一旦提交了请求会给你发送确认电子邮件,确认您的订阅请求。

关于技术问题

Sakai的版本库或项目的wiki中有各种技术问题的参考资料 (安装文件也存储在其中)。在参考文档模块中可以找到版本中的文档,例如 https://source.sakaiproject.org/svn/reference。特别要注意一个文档/架构文件夹,其中包含一个广泛的技术白皮书的集合。

Confluence wiki是一个非正式的信息源,但是有非常重要的信息,且范围更广泛。特别是新开发人员应该多浏览这些内容,建议您创建账户并参与其中。

最敏锐的信息来自与你的同行直接互动,如上所述,Collabserver就是这样一个地方。交流技术问题最好的(最活跃的)组织是DG:开发,它的别名是“sakai-dev”。

  • No labels