sakai properties文件的配置

　　sakai采用maven来管理和部署，每一个功能模块都可以通过添加配置文件的方式部署。而部署完成后，sakai系统的所有属性都可以动态地配置和更改。此时大多数的参数都通过文件sakai.properties来配置。下面对sakai.properties文件的主要配置项做简要说明。需要说明的是，本文档关于 properties这部分的内容以sakai2.4为准，2.5版本会有一些变化，但是不会影响到主要配置，需要对这部分有更深入了解可以参考官方文档。
　　 1、数据库相关配置
　　关于demo的数据库配置是采用的Hsqldb，缺省值在/trunk/sakai/kernel/db-components/src/webapp/WEB-INF/components.xml。其他数据库的配置需要在properties里面改动参数设置。这些参数的设置包括url，defaultTransactionIsolationString，vendor。sakai的持久层采用的是 hibernate，所以在配置文件里hibernate的参数配置包括hibernate.dialect，hibernate.show_sql, validationQuery和auto.ddl。defaultTransactionIsolationString是确定数据库事务操作的等级。auto.ddl的设置是为了确认是否需要当sakai系统启动后在数据库中建立必要的表，设置为 true即建立必要的表。针对每一种不同的数据库，上述参数的配置都不一样。具体的不同配置请参见官方说明。
　　 2、服务器参数的相关配置
　　serverId用来配置你的应用服务器的名字，特别是在集群或多服务器的时候名字应该是唯一的。
　　serverUrl用来配置服务器的url,包括传输协议，dns和端口。这些配置要和服务器的
　　server.xml中的参数保持一致。
　　serverName配置服务器的DNS名。
　　gatewaySiteId用来配置网关站点（gatewaysite)。site作为sakai的特有术语，类似于数页网页和一些工具的集合，为的是完成一种特定的功能和业务逻辑。站点通常可以由管理员添加，删除页面和工具来整合服务。网关站点作为实现登陆功能的站点，gatewaySiteId用来设置该站点的id。
　　loggedOutUrl用来配置当用户退出时转向到的页面。
　　accessPath用来配置访问路径的url。该参数是为访问资源的相对路径而设置的。
　　portalPath用作访问 portal的相对路径的设置，登陆sakai通常都是通过 portal来实现的。
　　top.login确定是否要在gateway site 的顶上方包括进用作登陆的模块。如果系统有其他外部工具来实现安全和认证功能，可以把该项参数设置成false，那样登陆模块就不会再在gatewaysite出现。
　　container.login确定是否需要由容器来操纵登陆。换句话说就是是否需要外部工具来管理认证,默认的设置是false，即一旦登陆后就不需要再在其它的site登陆认证了。
　　xlogin.enable决定是否需要为登陆单设专门的页面，即gateway site顶部不再有用户名和密码的输入框而改做一个链接。该项设置还有两个子参数的设置，一是xlogin.text，一是xlogin.icon，分别是设置链接的显示的文字和图标。该两个参数不能同时设置成true，否则只能显示图标。
　　 3、日志的参数配置
　　enabled:在sakai2.2日志控制是由实现Log4jConfigurationManager接口的LogConfigurationManager来实现的。enable参数用来决定是否需要做日志控制，该 API 可以在运行时动态地改变设置。
　　log.config.count和log.config.n
　　以前日志的参数配置是在其他的配置文件中，参数配置也不同。现在改在sakai.properties中配置这些参数。log.config.count是设置日志记录的个数，比如是 n，那么就有从log.config.1到log.config.n的参数设置用来配置不同的级别的日志信息。比如：
　　log.config.count=3
　　log.config.1=ALL.org.sakaiproject.log.impllog.config.2= OFF.org.sakaiprojectlog.config.3= DEBUG.org.sakaiproject.db.impl
　　这些参数的形式是LEVEL.logger，即日志信息级别.日志类。级别包括OFF,TRACE, DEBUG,INFO,WARN,ERROR,FATAL,ALL。
　　 4、页脚控制
　　bottomnav.count和bottomnav.n在缺省安装下是没有设置的。bottomnav.count设置在页脚会有多少链接，然后从bottomnav.1到bottomnav.n就会依次设置各链接的参数。
　　powered.url，powered.img，powered.alt，bottom.copyrighttext，version.service和version.sakai，这些参数都是在对"power bysakai"的Log做的设置。其中powered.url，Powered.img和powered.alt都分别有count和n的子参数设置。
　　 5、缺省安装信息文件
　　server.info.url，myworkspace.info.url和webcontent.instructions.url，这些参数分别是gatewaysite->welcome，Homepage ofMyWorkspaces->myworkspaces information 和空白的工具(即没有实现或者没有指定功能 )的链接，由sakai.iframe.service来控制显示。
　　 6、用户展示列表
　　display.users.present设置是否需要列出当前在线用户列表，presence.inchat.icon用于展示用户聊天时的图标。
　　 7、外观
　　wysiwyg.twinpeaks设置是否需要添加twinpeaks工具到编辑器的工具栏中。
　　wysiwyg.editor设置编辑器的类型，HTMLarea或者是FCKeditor。FCKeditor的功能要比HTMLarea功能强大一些。
　　skin.default和skin.repo分别设置外观类型和外观资源所在位置。下面几条设置都是同外观设置有关，分别是iconNames.count，iconNames.n，iconUrls.count和iconUrls.n同界面图标的设置有关。
　　iconSkins.count，iconSkins.n同更改外观主题（皮肤）有关。
　　disable.course.site.skin.selection确定是否在建立站点的时候更改外观的功能是可用的。
　　logout.icon设置退出的图标的url。
　　java.beep在用户界面设置一些 beep(启动，声音)是可用的。
　　accessibility.url在门户 portal处设置一个链接，指向自定义的url。
　　 8、指派作业工具控制
　　配置的参数都可以在assignment-impl/pack/src/webapp/WEB-INF/components.xml中找到，但是可以在sakai.properties中重新设置。
　　allowGroupAssignments设置是否可以把作业分派给site下的一个或多个组。
　　allowGroupAssignments@org.sakaiproject.assignment.api.AssignmentService=falseallowGroupAssignmentsInGradebook设置是否可以单独给组作业给分（把分数直接加进gradebook）。allowGroupAssignmentsInGradebook@org.sakaiproject.assignment.api.AssignmentService=true
　　 9、HelpToolcontrol 帮助文档的一些设置helpPathdisplay.help.menudisplay.help.iconhelp.locationhelp.welcomepage
　　 10、资源管理
　　 11、习题管理
　　 12、webdav
　　该参数同样有count和n的子设置，负责设置什么类型的文件不会在webdav中存储。
　　 13、wiki
　　experimental，comments和notification分别负责设置wiki是否可用，可添加评论和可通知。
　　 14、建立站点的管理
　　activeInactiveUser
　　wsetup.group.support
　　site.setup.import.file
　　titleEditableSiteType
　　courseSiteType
　　wsetup.disable.joinable.count
　　wsetup.disable.joinable.n
　　roster.available.weeks.before.term.start
　　termterm
　　新建站点的时候会要求你输入学期的信息，所有关于学期的信息都使用该参数来设置。
　　termterm.counttermterm.n
　　termyear.counttermyear.n
　　termlistabbr.counttermlistabbr.n
　　termiscurrent.counttermiscurrent.n
　　termstarttime.counttermstarttime.n
　　termendtime.counttermendtime.n
　　这些参数设置的是关于在siteinfo -〉add participants的各项输入的提示信息的。
　　noEmailInIdAccountLabel
　　emailInIdAccountLabel
　　emailInIdAccountInstru
　　emailInIdAccount
　　notifyNewUserEmailinvalidEmail
　　InIdAccountString
　　 15、站点工具控制
　　sitebrowser.termsearch.type
　　sitebrowser.termsearch.property
　　sitesearch.noshow.sitetype
　　设置可以被搜索的站点的类型（是否是按学期分），显示的名称和种类（工程project或者课程course）。
　　 16、Email
　　News Tool
　　Automatic User Adds
　　Membershiptool 
　　GradTools
　　WebServices其它各种设置
　　stealthTools
　　秘密工具，其实就是不会显示在 WorksiteSetup's tool lists,但是会显示在Admin Site Editor中的工具。一些更具体的设置需要参考sakai的官方文件说明，本文档不会一一说明。