sakai安装配置4

6. 开始使用 sakai

到此为止，你的安装已经和配置已经基本完成，现在可以开始使用 sakai 了，在这里不打算详细讲解 sakai 的使用细节，只是做一个入门的说明，详细使用细节可以参考其他文档。

6.1. Gateway 页（ The Gateway page ）

tomcat 成功启动后，通过 http://localhost:8080/portal ，你可以访问到 sakai 的 gateway 页面，通过 gateway 页，你可以注册一个新的账号，或者浏览公共站点内容。你可以用刚刚注册的账号登录，也可以用一个管理员的账号登录进行操作， sakai 提供一个缺省的管理员账号： admin ，密码也是 admin 。

6.2. 我的工作区（ My Workspace ）

每个用户（包括 admin ）都有一个私人工作区（ site ）叫我的工作区（ My Workspace ），在左上角可以看到这个 tab ，在这个 tab 下面（左边）是去到各种不同工具页的链接， admin 的 My Workspace 比其他类型的账号有更多不同的选项，但是不同类型的账号都可以通过不同的模版来自定义不同的工具页链接。详见以下的说明。

6.3. 其他站点（ Other Sites ）

如果用户还有其他站点（可访问的），将在顶部的 tab 中， My Workspace 的右边依次显示出来。对大多数用户而言，初始只有一个站点— My Workspace ，管理员用户有两个站点，除了自己的 My Workspace 外，还有一个 Administration Workspace 。但是这个站点看上去和 My Workspace 的内容完全相同。这是因为你有可能会想让其他一些特定用户可以使用某些管理工具，但不能让他访问 admin 用户的个人工作区（ My Workspace ），所以，为了容许特定用户使用管理工具时，只需将该用户加入 Administration Workspace 的用户列表中，然后授予他们“ admin ”的角色即可。

6.4. 管理工具（ Admin Tools ）

6.4.1 . 创建用户

你想做的第一件事可能就是修改 admin 用户的密码，并在你的系统中创建一些示例用户。你能在 Users 工具中做这些事情。为了修改 admin 用户的密码，只需点击用户列表中的“ admin ”用户名，在随后出现的页面中修改即可。为了创建用户，只需点击这个页面顶端的“ New User ”链接。

6.4.2 . 创建站点（ Creating Sites ）

Sites 工具是一个功能非常强大的建站工具，利用 Sites 工具，可以从头开始建立一个站点，包括对其中每个页面、工具的控制粒度以及细节方面的配置。但是强大的功能是有代价的，因此 Sites 工具最好是用来对一个已经存在的站点进行调整。而不是从头开始创建一个全新的站点。

这里简单介绍一下如何创建一个站点。点击左边的 Worksite Setup 工具，然后点击这个工具页顶部的 New 链接，为了简单起见，我们选择“ Project ”类型，然后跟随下一步的操作提示选择自己喜欢的配置，最后点击 Create Site 按钮，一个新的站点就创建完了，在页面顶部的 tab 中将显示这个新站点的标签。

6.4.3 . 增加用户到站点

刚刚你以 admin 的身份创建了一个新的站点，目前这个站点只有一个 admin 用户，如果你想增加其他具有不同角色的用户，可以通过该站点的 Site Info 工具中的 Add Participants 功能来完成这项工作。注意，这里只能增加已经注册或者创建好的用户。

7. Troubleshooting

以下是在安装和运行 sakai 的过程中遇到的一些常见的问题。

7.1. Build 主题

7.1.1 . JAR download failures

当你第一次用 maven 来进行编译和发布时，可能会碰到很多 jar download failures 的提示，因为你在脚本中包含了 clean 步骤，因为在第一次编译和发布时，你的存储区还没有那些相关的 jar 文件，所以在 clean 阶段将会出现这些错误提示，这些提示无关紧要，第二次用 maven 的时候，这些问题就没有了。所以建议当你第一次编译的时候，不要执行 clean 阶段。如果仍然没有解决这个问题，你就要看看你的 build 属性文件中的 maven.remote.repo 参数是否设置正确了。

7.1.2 . Out of Memory errors

在 build sakai 的时候，你可能会发现 out of memory 的错误，这说明 maven 启动的时候没有读到 JAVA_OPTS 参数或者没有配置该参数，这时候你需要配置名为 MAVEN_OPTS 的参数，在 Unix 下的配置如下：

      

        

           export MAVEN_OPTS="-Xmx384m -XX:PermSize=48m"

        

      

    

7.1.3 . Uninformative failure messages

如果你需要更多的细节信息来跟踪一个 build 错误， maven 能以 debug 的模式运行，只需要加上 -x 的参数即可，如： maven -x .

7.1.4 . Building only a single module

If you'd like to have the Sakai build targets and goals available for building only a single module (i.e. instead of rebuilding the entire source tree again to accomplish this), then you'll want to have the maven plugin for Sakai installed. Installing the plugin makes it available whenever you use maven, not just for those projects that declare a dependency on the plugin. You will need to do this once each time you upgrade a minor point version of sakai.

      

        

           maven plugin:download -DgroupId=sakaiproject -DartifactId=sakai -Dversion=2.2

        

      

    

Note that the version you should use in the above command is the one found as the value of the sakai.plugin.version property in the sakai/master/project.properties file. It is not necessarily (and in fact often isn't) the same as the version of Sakai you're using.

7.2. Tomcat 启动主题

7.2.1 . 找到 tomcat 日志

sakai 安装配置并启动后，我们可以通过查看日志来监测 sakai 的运行。 Sakai 源代码和 demo 版的日志级别是 info 和 warnings ，因此会有相当多的“正常”的信息输出到日志。你可能想屏蔽掉这些信息，而保留所有的警告信息。

修改日志的配置

为了改变 sakai 的日志配置，你必须改变 sakai 源代码并重新发布 sakai ，你需要改动的文件是： sakai-src/kernel/log-configure/src/conf/log4j.properties ， 要改动的相关内容是：

      

        

           log4j.logger.org.sakaiproject=INFO

 

为了打开 debug 功能，可以将上面的 INFO 改为 DEBUG ，如果只是想输出某一个组件的 debug 信息，可以增加一行配置，下面的例子表明 sakai 的所有其他组件都是输出 INFO 级别的信息，只是 SQL service 这个组件输出 debug 信息：

 

           log4j.logger.org.sakaiproject=INFO

 

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

 

日志控制功能是新的 LogConfigurationManager 的一个部分，作为 Log4jConfigurationManager 的 一个组件实现的。可以被 disable ，如果我们真的不想它起作用，可以在 sakai.properties 文件中加上下面这段：

 

          [e-mail] = false

 

日志级别的设置是 jog4j 的一个基本配置，源文件位于 sakai/util/util-impl/log/src/conf/log4j.properties ，编译的时候会打成一个 jar 包，发布到 common 目录（这是 tomcat 中 log4j 的一个要求），我们能在这个文件中设置 log 的级别，例如：

  

           # Application logging options

 

           log4j.logger.org.sakaiproject=INFO

 

           # Ignore erroneous MyFaces variable resolver warnings

 

           log4j.logger.org.apache.myfaces.el.VariableResolverImpl=ERROR

 

这设置了 org.sakaiproject.* 的日志级别为 INFO 级，设置了 org.apache.myfaces.el.VariableResolverImpl 的日志级别是 ERROR 级。这种设置的一个麻烦在于必须对源文件做修改，并重新发布。很不方便。

幸运的是，现在日志级别的设置可以在 sakai.properties . 文件中进行，在该文件中的设置将重载缺省文件中的配置，例如：

      

        

           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

 

T 这种用法是一种基本用法（但是很笨），通过 name.count 的方式，形成一个数组，在这个例子里面， name 是“ log.config ”，其值是“ LEVEL.logger ”，后面的 1/2/3 值的是预设好的 Level 值，包括： OFF TRACE DEBUG INFO WARN ERROR FATAL ALL. 。

Sakai 用 log4j 来处理日志，如果想了解更多关于日志配置的信息，请参阅 log4j 的官方文档。

其他日志

Sakai 中 SMTP 服务器的日志将记录在 $CATALINA_HOME/sakai/logs 目录下。

7.2.2 . "Unsupported major.minor version 49.0"

如果启动过程中，在日志文件里出现这样的信息，意味着你是用 java1.5 来编译的 sakai ，而运行的 JRE 是 1.4 的版本。可以参看第二部分，看看你的 java 的版本和环境变量的配置。

7.2.3 . "java.net.BindException: Address already in use"

如果启动过程中，在日志文件里出现这样的信息，意味着一些其他的应用已经占用了你分配给 sakai 所在 tomcat 的端口，修改这个端口，改为一个没有被占用的端口即可。