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
文件中加上下面这段：
enabled@org.sakaiproject.log.api.LogConfigurationManager = 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
的端口，修改这个端口，改为一个没有被占用的端口即可。