Working sakai.properties file

134 views
Skip to first unread message

Danton Barnes

unread,
May 26, 2015, 2:23:42 PM5/26/15
to saka...@apereo.org
hello all.  Does anyone have a working sakai.properties file that you could send me?  I've tried altering the default one but I just don't know what to change.  I'm shooting from the hip here.  

Brian Jones

unread,
May 26, 2015, 2:25:45 PM5/26/15
to saka...@apereo.org
The default one is all you need; the only modifications you need to make
are in the database section, depending on the database you set up during
the set up process outlined on the Confluence page(s).

If you don't provide a sakai.properties file, it will use an HSQLDB by
default; there is no set-up necessary for this.

You only need to modify sakai.properties if you're pointing to a MySQL
or Oracle database.

Brian Jones
Programmer/Analyst
Information Technology Services
Support Services Building, Suite 4300
Western University
(519) 661-2111 x86969
bjon...@uwo.ca
> --
> You received this message because you are subscribed to the Google
> Groups "Sakai Development" group.
> To unsubscribe from this group and stop receiving emails from it, send
> an email to sakai-dev+...@apereo.org
> <mailto:sakai-dev+...@apereo.org>.
> To post to this group, send email to saka...@apereo.org
> <mailto:saka...@apereo.org>.
> Visit this group at http://groups.google.com/a/apereo.org/group/sakai-dev/.

Matthew Jones

unread,
May 26, 2015, 2:28:47 PM5/26/15
to Brian Jones, sakai-dev
Yup, all of the defaults are in the code. The only reason you need a properties file is if you want to change the default (from true to false, or other settings as documented in the default file)

It's a huge file mostly because almost every feature in Sakai can be disabled or changed. But the defaults are good for the majority of installations and are what are tested against. 

The database section is important though. HSQLDB isn't recommended for use and I don't even think it starts up in trunk anymore with HSQLDB.



To unsubscribe from this group and stop receiving emails from it, send an email to sakai-dev+...@apereo.org.
To post to this group, send email to saka...@apereo.org.

Charles Severance

unread,
May 26, 2015, 4:46:15 PM5/26/15
to Brian Jones, dev sakai, Matthew Jones
I have a set of scripts that includes a more typical sakai.properties and the scripts make you a good dev sakai.properties when you wun them - setting up the MySQL database and all.


/Chuck

Steve Swinsburg

unread,
May 26, 2015, 5:18:50 PM5/26/15
to Severance Charles, Matthew Jones, sakai-dev, Brian Jones

Not sure if you have been getting my posts helping you out, but you don't need a properties file. Given your problems getting it up and running you need to get it running with all defaults before you start modifying.

Laura Gekeler

unread,
May 27, 2015, 8:36:21 AM5/27/15
to Danton Barnes, sakai-dev
Danton, 

I'd be interested in a latest copy of a sakai.properties file myself. This one is a few years old.

Hang in there. Are you documenting your process? Your point of view as a first time installer is invaluable to correcting and updating the process. A working install cookbook would be awesome!

We have a Sakai bootcamp in Baltimore Sunday May 31st (I am not the marketing dept!). If you're anywhere near there, you'd get to meet up with folks with serious expertise: Earle Nietzel, Matthew Jones, Robert Long. Deets are here: http://lanyrd.com/2015/apereo/sdmmft/    I'm sure they'd appreciate your comments and input if you email this list before then... it's hard to remember which things are a challenge to a first-timer when you can do it in your sleep.


Laura Gekeler
LMS Administrator
Teaching and Learning Technologies
University of Notre Dame


On 26 May 2015 at 14:23, Danton Barnes <dbarn...@gmail.com> wrote:
hello all.  Does anyone have a working sakai.properties file that you could send me?  I've tried altering the default one but I just don't know what to change.  I'm shooting from the hip here.  

20131113sakaiproperties_sample.txt

Laura Gekeler

unread,
May 27, 2015, 8:37:45 AM5/27/15
to Charles Severance, Brian Jones, dev sakai, Matthew Jones
It is good to see what such a file looks like, includes, syntax and such...

LG


Laura Gekeler
LMS Administrator
Teaching and Learning Technologies
University of Notre Dame


Neal Caidin

unread,
May 27, 2015, 8:42:07 AM5/27/15
to Laura Gekeler, Charles Severance, Brian Jones, dev sakai, Matthew Jones
The latest version can always be found at


look at the default.sakai.properties

Cheers,
Neal

Steve Swinsburg

unread,
May 28, 2015, 8:56:26 AM5/28/15
to Neal Caidin, Laura Gekeler, Charles Severance, Brian Jones, dev sakai, Matthew Jones
It should be pointed out though that when creating your own sakai.properties file, the recommended approach is not to take this file and customise it, it is to provide overrides in your own file, ie find the property you want in the default file, then copy it into your own file and edit. There is a hierarchy of override files that you can perform including local deployment specific overrides (local.properties), locked down sensitive properties (security.properties) as well as the general sakai.props.

There are close to 1000 properties. A production environment might only override a handful of them.

I've been saying for years that the install manual sucks. It's unnecessarily complicated and goes into far too much detail (people don't need Sakai to hold their hand installing Maven, that's Maven's job).

It would be far better if we pushed the quickstart a bit more, with the few simple steps I outlined earlier, and then had manuals on performing more advanced things like hooking up another database, skinning etc.

I added that quickstart right into the readme. The move to github made this job easier. We just need the rest of the docs to follow.

cheers,
Steve

Miguel Carro Pellicer

unread,
May 28, 2015, 9:51:31 AM5/28/15
to Steve Swinsburg, Neal Caidin, Laura Gekeler, Charles Severance, Brian Jones, dev sakai, Matthew Jones
Hi all,

What do you think about bundle an installation with Tomcat (Binary installation)? Just contain everything needed to run Sakai, just run the startup file. Don't know if exists any concerns about the Tomcat's license.

I've seen this bundles in other solutions like Liferay, is bundled with Tomcat, Resin, Geronimo, Jboss, Glashfish, Jetty......http://www.liferay.com/downloads/liferay-portal/available-releases

Regards, Miguel
--
Logo

Miguel Carro Pellicer
CTO Entornos de Formación S.L.

Website: http://www.entornosdeformacion.com/
Phone: +34 - 686266485
Email: mca...@entornosdeformacion.com

No me imprimas si no es necesario. Protejamos el medio ambiente


AVISO LEGAL: El contenido de este mensaje de correo electrónico, incluidos los ficheros adjuntos, es confidencial y está protegido por el artículo 18.3 de la Constitución Española, que garantiza el secreto de las comunicaciones.
Si usted recibe este mensaje por error, por favor póngase en contacto con el remitente para informarle de este hecho, y no difunda su contenido ni haga copias.
*** Este mensaje ha sido verificado con herramientas de eliminación de virus y contenido malicioso ***
Este aviso legal ha sido incorporado automáticamente al mensaje.

Laura Gekeler

unread,
May 28, 2015, 10:02:34 AM5/28/15
to Steve Swinsburg, Neal Caidin, Charles Severance, Brian Jones, dev sakai, Matthew Jones
Interesting conversation. I agree with Steve. It's far too hard to build this thing without a basic cookbook, as Danton's questions illustrate.

Roles, permissions (and permission interactions), skinning and customizable default behaviors, in my opinion, are 'need to know' even by those who don't run Sakai themselves. Having a copy of all the defaults helps (thanks Neal).

LG


Laura Gekeler
LMS Administrator
Teaching and Learning Technologies
University of Notre Dame


Steve Swinsburg

unread,
May 28, 2015, 10:46:49 AM5/28/15
to Laura Gekeler, Neal Caidin, Charles Severance, Brian Jones, dev sakai, Matthew Jones
@Miguel, we do this already, it's the demo install. You unzip and go. IMO it's overhead we don't need. Plus it will likely not work in 11 as we are moving away from the embedded database.

The other problem with the binaries is you can't do anything with them in terms of making them yours, so people still need to do the source install if they want anything useful.

IMO we should ditch the demo AND binary install and have one simple set of instructions for everyone.

@Laura, yes definitely need pages on those, this would be pretty simple to put together and means we could move away form the confluence focus.

cheers,
Steve

Diego del Blanco Orobitg

unread,
May 28, 2015, 11:52:39 AM5/28/15
to Steve Swinsburg, Laura Gekeler, Neal Caidin, Charles Severance, Brian Jones, dev sakai, Matthew Jones
I agree. Better instructions for install, config, etc, are absolutely needed (and in parallel we should make all the process easier too)

As I've been translating all these files and instructions to Spanish I think I know them very well, If I can be helpful in that process of creating a new help, I'd be happy to help.  So, please, have me in mind to work on this (I know my english grammar is not the best one... but with some review from your part I can be helpful ) .

I did (in Spanish) a manual for Sakai Properties explaining with more detail most of them or at least the most important ones. No problem to use some of these explanations to make the people understand better what the properties are doing. And I write a lot of other material for that course (in Spanish too, sorry) that we can reuse translating too. I'd be happy to share that.

We can talk about this and create a working group, I'll be happy to participate on it.

Diego
Diego del Blanco Orobitg
Spain & LATAM Regional Manager (ANI Sakai)
Apereo LATAM Representative (Apereo Foundation)
Sk: ddelblanco.ani

Neal Caidin

unread,
May 28, 2015, 4:02:16 PM5/28/15
to Diego del Blanco Orobitg, Steve Swinsburg, Laura Gekeler, Charles Severance, Brian Jones, dev sakai, Matthew Jones
I'm happy to help as well.

-- Neal

Reply all
Reply to author
Forward
0 new messages