Zentyal Forum, Linux Small Business Server

News and Announcements => News and Announcements => Topic started by: mburillo on April 20, 2012, 07:58:06 pm

Title: Zentyal doc for advanced users [planning]
Post by: mburillo on April 20, 2012, 07:58:06 pm
Hello everyone,

In our last Zentyal Community Council, we discussed about the need of some "advanced user" documentation. This documents and how-tos are supposed to fill the existing gap between the current Zentyal doc (kind of cookbook, easy-to-follow step-by-step GUI guide) and the development guides (how to develop new Zentyal modules using perl and Zentyal framework).
The target person is someone used to hack his way around using the CLI, that wants to go a couple
of steps beyond what is possible using only the web interface.

Based on the most frequent requests and what we consider interesting for this target public,
we have put together the following list:

- Troubleshooting and debugging Zentyal, main log files for Zentyal and each one of the services, how to reproduce and catch the errors on the fly, verbose description.
- How to integrate third party applications with Zentyal's LDAP (moodle, openerp, subsonic, whatever...)
- How to adjust the service templates to modify the translation between the web GUI and the resulting
configuration files in a permanent fashion.
- Proper partitioning, RAID0, RAID1 and RAID5 and LVM, how to do it, why and when to do it and good
practices.
- Possible documentation appendix covering /etc/zentyal parameters, description, justification and possible tweaks.

We really think this will make a great difference  :D. Are you missing any other topic? Would you like to contribute with some howto?

Regards,
Title: Re: Zentyal doc for advanced users [planning]
Post by: christian on April 21, 2012, 12:34:35 pm
Excellent news  :)
I'll try to provide some inputs here later.
Title: Re: Zentyal doc for advanced users [planning]
Post by: jsalamero on April 22, 2012, 09:20:01 pm
Über cool!! I think those points are a very good choice for starting with the advanced documentation :)
Title: Re: Zentyal doc for advanced users [planning]
Post by: Escorpiom on April 23, 2012, 06:49:19 am
That would be a good step forward, it will be useful for people like myself, with only some basic understanding of Zentyal.

Cheers.
Title: Re: Zentyal doc for advanced users [planning]
Post by: robb on April 23, 2012, 09:51:15 am
It would be even more cool when a few 'advanced' community members get together to do this project. When community documentation team meets the Zentyal documentation team, we will get best of both worlds...
Title: Re: Zentyal doc for advanced users [planning]
Post by: majestyx on April 23, 2012, 11:55:54 am
thumb up !!!  8)
Title: Re: Zentyal doc for advanced users [planning]
Post by: juanmarquez on April 30, 2012, 06:37:05 pm
Ale lu ya. Congratulation for good intention
Title: Re: Zentyal doc for advanced users [planning]
Post by: mburillo on May 10, 2012, 01:13:36 pm
Ok, apparently the list has had good reception, very good  :). Unless someone complains the next few days, we can consider it closed and start the real work  :D

Thanks for your feedback everyone!
Title: Re: Zentyal doc for advanced users [planning]
Post by: linuxmaniac on May 14, 2012, 03:27:45 pm
That's good news.
An API list or code structure/hierarchy would be great.

Cheers.
Title: Re: Zentyal doc for advanced users [planning]
Post by: mburillo on July 12, 2012, 07:53:45 pm
Hello everyone,

A first draft of

- Possible documentation appendix covering /etc/zentyal parameters, description, justification and possible tweaks.

is already available at:

http://trac.zentyal.org/wiki/Documentation/Community/Advanced/MainFiles

Still needs some polishing and some details, but could be a starting point. What do you think? Should we continue the effort
together  ;)?

Regards,
Title: Re: Zentyal doc for advanced users [planning]
Post by: robb on July 12, 2012, 11:52:33 pm
Thanks a lot for the effort Matteo....
Good idea... lets's pick it up together with the community from here...
Title: Re: Zentyal doc for advanced users [planning]
Post by: Escorpiom on July 13, 2012, 08:29:39 am
Yes please! This was the part that we needed, I just took a peek and there are a lot of things I didn't know about.
Very nice.

Cheers.
Title: Re: Zentyal doc for advanced users [planning]
Post by: ian on July 13, 2012, 11:08:58 am
Hello,

This is already a very good start.
Maybe it is also good to document the configuration scripts ( backup and restore scripts of the defined users groups shares computer accounts etc ).

Thanks for the effort.

Best regards,
Ian
Title: Re: Zentyal doc for advanced users [planning]
Post by: zahadom on July 13, 2012, 04:51:29 pm
This is a very good idea!!
Is a great information!!!
If I can provide some information, for sure I will. I am currently trying to set up Jabber for publishing LDAP groups, and not have to search users.
Title: Re: Zentyal doc for advanced users [planning]
Post by: linuxmaniac on July 14, 2012, 08:52:54 am
That's a walk on the right path mates.
Cheers.