# sakai.properties - documentation version provided as a reference # for the default configuration you may examine kernel/component/src/config/org/sakaiproject/config/sakai.properties # for fuller explanations of settings, see docs/architecture/sakai_properties.doc # INSTITUTION "PERSONALIZATION" # identify your application server with a short name, unique among the servers in your cluster. # choose a server id even if you are running a single app server serverId=localhost # the URL to the server, including transport, DNS name, and port, if any serverUrl=http://localhost:8080 # the DNS name of the server serverName=localhost # the default skin name, and the URL path (relative is ok) to the collection of skins skin.default=default skin.repo=/library/skin # locations of info pages to display for server, myworkspace, and unconfigured web content server.info.url=/library/content/server_info.html myworkspace.info.url=/library/content/myworkspace_info.html webcontent.instructions.url=/library/content/webcontent_instructions.html webdav.instructions.url=/library/content/webdav_instructions.html # enable/disable presence display in the portal display.users.present=false # links placed on the bottom nav - set the .count to the number of items, then add each item bottomnav.count = 2 bottomnav.1 = Gateway bottomnav.2 = The Sakai Project # some fill-ins for the css/vm ui (Worksite Setup, Digest Service, Email notification, Worksite Setup, Contact Support, Portal) ui.institution = Your Institution ui.service = LocalSakaiName #copyright text to appear in the bottom area of each web page. bottom.copyrighttext=Copyright 2003-2006 The Sakai Foundation. All rights reserved. Portions of Sakai are copyrighted by other parties as described in the Acknowledgments screen. #the location (url) of the accessibility info #accessibility.url= # to disable list of appearance/icon with "edit site information" for course sites. (set as true to display only default appearance) #disable.course.site.skin.select=true # Supported language locales for user preferences # Use the component/.../sakai.properties as a template when adding/deleting #locales = en_US, en_GB, ja_JP, ko_KR, nl_NL, zh_CN, es_ES, fr_CA, ca_ES, sv_SE, ar # default title and feed URL for the news tool news.title = Sakai News news.feedURL = http://sakaiproject.org/news-rss-feed # root of archive file system area - used to write archive files and to read them # when clustering app servers, this should be a shared network location storagePath@org.sakaiproject.archive.api.ArchiveService = ${sakai.home}/archive/ # LOGIN/LOGOUT # to include the user id and password for login on the gateway site top.login=true # to let the container handle login or not (set to true for single-signon type setups, false for just internal login) container.login = false # the URL to send folks to after they logout loggedOutUrl=/portal # DATABASE CONFIGURATION - make sure to modify details to match your particular setup # The username and password. The defaults are for the out-of-the-box HSQLDB. Change to match your setup. username@javax.sql.BaseDataSource=sa password@javax.sql.BaseDataSource= # establish auto.ddl - on by default auto.ddl=true #auto.ddl=false ## HSQLDB settings - on by default vendor@org.sakaiproject.db.api.SqlService=hsqldb driverClassName@javax.sql.BaseDataSource=org.hsqldb.jdbcDriver hibernate.dialect=org.hibernate.dialect.HSQLDialect validationQuery@javax.sql.BaseDataSource=select 1 from INFORMATION_SCHEMA.SYSTEM_USERS # two hsqldb storage options: first for in-memory (no persistence between runs), second for disk based #url@javax.sql.BaseDataSource=jdbc:hsqldb:mem:sakai url@javax.sql.BaseDataSource=jdbc:hsqldb:file:${sakai.home}db/sakai.db ## MySQL settings - make sure to alter as appropriate #vendor@org.sakaiproject.db.api.SqlService=mysql #driverClassName@javax.sql.BaseDataSource=com.mysql.jdbc.Driver #hibernate.dialect=org.hibernate.dialect.MySQLDialect #url@javax.sql.BaseDataSource=jdbc:mysql://127.0.0.1:3306/sakai?useUnicode=true&characterEncoding=UTF-8 #validationQuery@javax.sql.BaseDataSource=select 1 from DUAL #defaultTransactionIsolationString@javax.sql.BaseDataSource=TRANSACTION_READ_COMMITTED ## Oracle settings - make sure to alter as appropriate #vendor@org.sakaiproject.db.api.SqlService=oracle #driverClassName@javax.sql.BaseDataSource=oracle.jdbc.driver.OracleDriver #hibernate.dialect=org.hibernate.dialect.Oracle9Dialect #url@javax.sql.BaseDataSource=jdbc:oracle:thin:@your.oracle.dns:1521:SID #validationQuery@javax.sql.BaseDataSource=select 1 from DUAL #defaultTransactionIsolationString@javax.sql.BaseDataSource=TRANSACTION_READ_COMMITTED # For improved Oracle performance, implementers using Oracle should strongly consider # enabling all the following settings just as they appear (suggestion from the University of Michigan). #validationQuery@javax.sql.BaseDataSource= #defaultTransactionIsolationString@javax.sql.BaseDataSource= #testOnBorrow@javax.sql.BaseDataSource=false # enable hibernate SQL debugging output hibernate.show_sql=false # EMAIL CONFIGURATION # smtp server for outgoing emails smtp@org.sakaiproject.email.api.EmailService=some.smtp.org # 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. Default is 25. Recommend running on 8025, and using a standard mailer on 25 to forward mail to Sakai. smtp.port = 8025 # flag to enable or disable James for incoming email (true | false) smtp.enabled = false # email support address used in incoming email rejection messages #mail.support= # email address to send errors caught by the portal, and user bug reports in response #portal.error.email= # email address used as the "from" address for any email sent by Worksite Setup tool or Site Info tool setup.request= # enable/disable javax.mail.Session debugging. Currently only supported by Mailtool, but # is intended as a global configuration flag, hence the lack of bean property syntax. Not # coincidentally, this property name corresponds to the actual javax.mail property name. # mail.debug=true # SECURITY # force all URLs out of Sakai back to Sakai to be secure, i.e. to use https, on this port. Leave out to respond with the same transport as the request. # Otherwise, the URLs will reflect the attributes of the request URL. (443 | 8443 | or any other port) [defaults to missing] #force.url.secure=443 # RESOURCES/COLLECTIONS CONFIGURATION # upload limit per request, in megs content.upload.max=20 # File name expressions to ignore in WebDav - Dav will not allow files # which have these strings in them to be created. # This is primarily used to ignore files generated by Apple of the form # /access/content/user/zt10/.DS_Store and the files for Resource "forks" # which start with "._" webdav.ignore.count=2 webdav.ignore.1=/.DS_Store webdav.ignore.2=/._ # indicates whether users should see "Show Other Sites" twiggle in list mode of resources tool resources.show_all_collections.tool = true # indicates whether users should see "Show Other Sites" twiggle in list mode of dropbox tool resources.show_all_collections.dropbox = false # indicates whether users should see "Show Other Sites" twiggle in list mode of file picker resources.show_all_collections.helper = true # the copyright options for the resources tool copyrighttype.count=6 copyrighttype.1=Material is in public domain. copyrighttype.2=I hold copyright. copyrighttype.3=Material is subject to fair use exception. copyrighttype.4=I have obtained permission to use this material. copyrighttype.5=Copyright status is not yet determined. copyrighttype.6=Use copyright below. copyrighttype.own=I hold copyright. copyrighttype.new=Use copyright below. default.copyright=Copyright status is not yet determined. default.copyright.alert=true fairuse.url=http://fairuse.stanford.edu newcopyrightinput=true # the file system root for content hosting's external stored files (default is null, i.e. store them in the db) # see the readme file (2.2.7 File Based Content Hosting) for more details #bodyPath@org.sakaiproject.content.api.ContentHostingService = /someplace/ # when storing content hosting's body bits in files, an optional set of folders just within the bodyPath - # to act as volumes to distribute the files among - a comma separate list of folders. If left out, no volumes will be used. # see the readme file (2.2.7 File Based Content Hosting) for more details #bodyVolumes@org.sakaiproject.content.api.ContentHostingService = vol1, vol2, vol3 # set to true to enable the release/retract and hiding of resources in ContentHostingService availabilityChecksEnabled@org.sakaiproject.content.api.ContentHostingService = true # set to true to enable custom sorts within folders in ContentHostingService and the Resources tool prioritySortEnabled@org.sakaiproject.content.api.ContentHostingService = true # CACHE SETTINGS # minutes to cache each security question in the SecurityService - set to 0 to disable caching. cacheMinutes@org.sakaiproject.authz.api.SecurityService = 3 # minutes to cache each site (site, page, tool) access in the SiteService - set to 0 to disable caching. cacheMinutes@org.sakaiproject.site.api.SiteService = 3 # minutes to cache each user access in the UserDirectoryService - set to 0 to disable caching. cacheMinutes@org.sakaiproject.user.api.UserDirectoryService = 5 # minutes between checks of the user cache for cleaning expired entries - set to 0 to disable caching, cacheCleanerMinutes@org.sakaiproject.user.api.UserDirectoryService = 15 # SESSION EXPIRATION # sessions expire if nothing happens in this many seconds (1 hour) inactiveInterval@org.sakaiproject.tool.api.SessionManager=3600 # presence expires if not refreshed in this many seconds timeoutSeconds@org.sakaiproject.presence.api.PresenceService=60 # STEALTH TOOLS. A stealth tool is a tool that is running in Sakai, but is not available to be added to a site in Worksite Setup. # A stealth tool can be added to a site using the Admin site tool. # List any tools to be stealthed, using their tool ids, in a comma-separated string (no spaces). # In this example, the rwiki tool, su tool, roster tool, and the assignment tool w/o grading are stealthed: #stealthTools@org.sakaiproject.tool.api.ActiveToolManager=sakai.rwiki,sakai.su,sakai.site.roster,sakai.assignment # SAMIGO CONFIGURATION # ** Samigo File Upload question type settings ** # the following default settings: # com.corejsf.UploadFilter.repositoryPath, # com.corejsf.UploadFilter.sizeThreshold, # com.corejsf.UploadFilter.sizeMax and # com.corejsf.UploadFilter.saveMediaToDb # in Samigo web.xml can be overidden with the following settings in sakai.properties: samigo.answerUploadRepositoryPath=/tmp/ samigo.sizeThreshold=512 samigo.sizeMax=20480 samigo.saveMediaToDb=false # The e-mail settings are for Samigo only. They are used because Sakai # doesn't support real attachments. Samigo looks to these settings # instead of the regular Sakai e-mail settings. Also, these settings # do not override the usual Sakai settings. # # outgoing SMTP server (required) samigo.smtp.server=smtp.somewhere.edu # # Bypass SMTP AUTH for outgoing mail (default: false) # if false, specify username/password samigo.email.bypassAuth=false samigo.email.username=SMTP_AUTH_USER samigo.email.password=SMTP_AUTH_PASSWORD # # Temp directory for handling attachment files. samigo.email.prefixedPath=/tmp/ # This is for Samlite, the word-2-QTI converter (default: false) samigo.samliteEnabled=true # SECTION MANAGER CONFIGURATION (Options include MANUAL_DEFAULT, MANUAL_MANDATORY, AUTOMATIC_DEFAULT, and AUTOMATIC_MANDATORY. See https://source.sakaiproject.org/svn/sections/tags/sakai_2-4-0/xdocs/README.txt) #config@org.sakaiproject.section.api.SectionManager=AUTOMATIC_DEFAULT