Zentyal Forum, Linux Small Business Server

Zentyal Server => Installation and Upgrades => Topic started by: isaac on August 18, 2009, 12:14:29 pm

Title: Official documentation for eBox 1.2 available (yay!)
Post by: isaac on August 18, 2009, 12:14:29 pm
Dear users! We are happy to announce the immediate availability of our official documentation for eBox 1.2.

We hope that you find it useful and it improves your eBox experience :)

We would also like to ask you for your help. If you see any part that can be improved, either because concepts can be explained better or you think a more appropriate example can be provided or the English is plain wrong, let us know in this post and we'll do something about it :)

Well, enough with the talk, doc is at http://doc.ebox-platform.com/en/ and other documentation and other languages available at http://trac.ebox-platform.com/wiki/Document/Index.

Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: SamK on August 18, 2009, 12:30:30 pm
We are happy to announce the immediate availability of our official documentation for eBox 1.2.
A very welcome addition.

We would also like to ask you for your help. If you see any part that can be improved, either because concepts can be explained better or you think a more appropriate example can be provided or the English is plain wrong, let us know in this post and we'll do something about it :)
According to the Cambridge English Dictionary functionalities (opening page) is not an English word, perhaps functions might be more appropriate.
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: isaac on August 18, 2009, 12:57:06 pm
I am more of a Merriam-Webster guy, and functionality appears there as:
"the particular set of functions or capabilities associated with computer software or hardware or an electronic device"
and as far as I know is widely used in technology, e.g.: http://java.sun.com/developer/technicalArticles/J2SE/Desktop/javase6/systemtray/
"New System Tray Functionality in Java SE 6"
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: SamK on August 18, 2009, 01:10:39 pm
I am more of a Merriam-Webster guy...
Each to his own.

functionality appears there...
"functionality" (singular) appears in both the Oxford and Cambridge Dictionaries but "functionalities" (as plural) does not.  Its just an example of the mangling of English.

Does it help to consider it from the following perspective?

Either way its not a major issue, just a case of 'tidying up'.
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: SamK on August 18, 2009, 01:21:29 pm
It will make it easier to understand if all the notes ([1], [2]...) are grouped together at the foot of the page rather than appearing within the main body of the text.

Do the notes need to be numbered?  Could the text itself be made into a link to the appropriate note?
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: Sam Graf on August 18, 2009, 02:53:34 pm
Good work!

In the first paragraph under Installation, should the second sentence read, "This does not prevent you from installing other unmanaged services, but these must be manually configured" (change in bold)?
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: ram on August 19, 2009, 11:13:17 am
 ;) Fantastic documentation!

Thanks for taking the time and effort to prepare and share this!

Will def help me and others a lot who are beginning to use ebox/ubuntu for various scenarios.

Well done again.
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: SamK on August 19, 2009, 03:31:44 pm
On the page http://doc.ebox-platform.com/en/intro.html#installation the paragraph "In the second case, you need to add the official eBox Platform repositories and to install the packages you are interested in." is incorrect as /etc/apt/sources.list contains the required entries by default.
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: J. A. Calvo on August 19, 2009, 06:34:40 pm
Quote
"In the second case, you need to add the official eBox Platform repositories and to install the packages you are interested in." is incorrect as /etc/apt/sources.list contains the required entries by default.

It means that if you are using a standard Ubuntu Server, not the eBox installer, you have to add the eBox repositories manually...
(Unless you want to use ebox 0.12 that is the one included in the official Ubuntu repositories)

Regards,

J. A. Calvo
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: SamK on August 19, 2009, 08:07:12 pm
...ebox 0.12 that is the one included in the official Ubuntu repositories)
I thought (wrongly) that as eBox is based on the LTS version of Ubuntu that newer releases of eBox made it into the official Ubuntu repositories. 

I recall an earlier release of eBox (1.0?) did not have a full /etc/apt/sources.list and that this comment in the doc referred to this.
Edit by SamK 22:14 19-Aug-2009
I'm talking nonsense here by mixing up two unrelated matters.  I apologize for any confusion this may have caused.

As the only way to install eBox from the Ubuntu official CD-ROM requires the manual additions might it be worthwhile showing the details in the official eBox doc?
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: J. A. Calvo on August 19, 2009, 09:56:01 pm
The official doc for installing eBox is here: http://trac.ebox-platform.com/wiki/Document/Documentation/InstallationGuide (http://trac.ebox-platform.com/wiki/Document/Documentation/InstallationGuide)

In the manual it only appears in an introductorial way. But yes, maybe you are right and we should add it. But I don't like to have repeated information in several places. It's harder to maintain.

Regards,

J. A. Calvo
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: SamK on August 19, 2009, 11:47:34 pm
...I don't like to have repeated information in several places. It's harder to maintain.
I fully agree with this.  Perhaps this raises a question about the relationship between the Official Documentation for v 1.2 and the other guides in the wiki.
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: gsaldivar on August 19, 2009, 11:53:47 pm
Is it possible to display the entire manual in one page, so it can be easily printed?

Thanks.
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: dragonslayr on August 28, 2009, 02:38:13 am
Giminy Christmas!

Good job!  I'm going thru it right now. The backup section even goes so far as to explain how to install the second disk..  Very extensive. I'm impressed!


Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: dragonslayr on August 28, 2009, 06:51:07 am
Just some things I noticed. You did ask to let you know..  ;)

Web data publication service - May want to change Cliente to Client

routing says - destinatino instead of destination

The picture in Ebox security model is not in english http://doc.ebox-platform.com/en/_images/filter-combo.png

Not in english http://doc.ebox-platform.com/en/_images/15-windows-partition.png
Not in english http://doc.ebox-platform.com/en/_images/pidgin-02-conf-basica.png
Not in english http://doc.ebox-platform.com/en/_images/pidgin-03-conf-avanzada.png
Not in english http://doc.ebox-platform.com/en/_images/pidgin-01-cuentas.png
Not in english http://doc.ebox-platform.com/en/_images/user-jabber.png

Is the below statement true? I've not used postgrey in quite some time.., but did not think it blacklisted them, just whitelisted good guys.. 
"However, the servers that send spam do not usually follow the standard. They will not try to send the email again and eBox will include them in a black list."

Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: isaac on August 28, 2009, 09:43:45 am
gsaldivar: I have uploaded a version in pdf to http://doc.ebox-platform.com/en/eBox-for-Network-Administrators.pdf

We will add it officially to the documentation pages with a 'Download in PDF' link or something like that soon.
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: SamK on August 28, 2009, 11:32:22 am
I must declare a degree of self interest here...

I suggest the inclusion of the following in this documentation:
http://trac.ebox-platform.com/wiki/Document/Documentation/ThePerfectEboxSetup/StorageConfiguration
http://trac.ebox-platform.com/wiki/Document/Documentation/ThePerfectEboxSetup/StorageLiveVolumeResize
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: sixstone on August 28, 2009, 04:33:53 pm
Hello,
Not in english http://doc.ebox-platform.com/en/_images/15-windows-partition.png
Not in english http://doc.ebox-platform.com/en/_images/pidgin-02-conf-basica.png
Not in english http://doc.ebox-platform.com/en/_images/pidgin-03-conf-avanzada.png
Not in english http://doc.ebox-platform.com/en/_images/pidgin-01-cuentas.png
Not in english http://doc.ebox-platform.com/en/_images/user-jabber.png
I have opened a ticket addressing this issue [1].
Quote
Is the below statement true? I've not used postgrey in quite some time.., but did not think it blacklisted them, just whitelisted good guys.. 
"However, the servers that send spam do not usually follow the standard. They will not try to send the email again and eBox will include them in a black list."
That statement is not true. The server is not blacklisted. If it tries too early to send the mail, it will be greylisted again.

Thanks very much for your suggestions! ;)

Best regards,
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: SamK on August 28, 2009, 05:20:10 pm
@issac, @sixstone

Now the PDF version of the document is available it could be used as a means of submitting suggestions for change/improvements in context to the document. 

A page(s) can be extracted from the official version, comment/markups embedded in it and then returned to you for consideration.  If you wanted to let the community know what changes you decide to make (and those you reject) they could be posted in the forum in a similar manner to reply #17 (sixstone replying to dragonslayer).

Posting suggestions directly to the thread will still be available for those wanting to use the existing route.

What do you think?
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: dragonslayr on August 29, 2009, 04:38:57 am
gsaldivar: I have uploaded a version in pdf to http://doc.ebox-platform.com/en/eBox-for-Network-Administrators.pdf

We will add it officially to the documentation pages with a 'Download in PDF' link or something like that soon.

Now we'll how bad he REALLY wants to print it.  :)  Big document..
Though, it'd be nice to have laying there..
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: sixstone on August 30, 2009, 11:14:14 pm
A page(s) can be extracted from the official version, comment/markups embedded in it and then returned to you for consideration.  If you wanted to let the community know what changes you decide to make (and those you reject) they could be posted in the forum in a similar manner to reply #17 (sixstone replying to dragonslayer).

Posting suggestions directly to the thread will still be available for those wanting to use the existing route.

What do you think?
You may use the most comfortable way for you to send us patches. Indeed, the web version has a source in RST format to modify and send us the patches...

By the way, I have fixed one of the typos that you have found in intro page. ;)

Thanks very much for your effort and help and best regards,
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: ndra on September 02, 2009, 07:26:04 am
I have installed this newer version and success.

But, when I want to save the settings that I have made in eBox via Firefox browser, I got this message:

Some modules reported error when saving changes. More information on the logs in /var/log/ebox
id serv3192 does not exist


Please help me to solve this problem. Thanks.
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: sixstone on September 02, 2009, 07:25:16 pm
ndra use a new topic to talk about it.

To fix your migration, go to firewall rules and check those rules that the service is missing and configure it to a real service.

Cheers,
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: gsaldivar on September 15, 2009, 09:49:08 am
gsaldivar: I have uploaded a version in pdf to http://doc.ebox-platform.com/en/eBox-for-Network-Administrators.pdf

We will add it officially to the documentation pages with a 'Download in PDF' link or something like that soon.

Now we'll how bad he REALLY wants to print it.  :)  Big document..
Though, it'd be nice to have laying there..

Already printed & bound!  Many thanks for making that possible guys!  For some of us, there is no substitute for a well-used, highlighted, dogeared, manual with notes scribbled in the margins.  :)
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: HANNES1985 on November 30, 2009, 10:13:01 pm
gsaldivar: I have uploaded a version in pdf to http://doc.ebox-platform.com/en/eBox-for-Network-Administrators.pdf

We will add it officially to the documentation pages with a 'Download in PDF' link or something like that soon.

I tried to download all links but it keeps on telling me that the file is corrupted or damaged and cannot be repaired could you please post a link that works I ve got some questions that you mabe handled in this document please
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: dragonslayr on December 01, 2009, 01:37:13 am
I just downloaded it with the same result. Damaged..   
Just confirming..
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: J. A. Calvo on December 01, 2009, 01:54:24 am
I've just downloaded and viewed it without problem. But I am using evince as PDF viewer, maybe the problem occurs only with acrobat reader or others.
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: dragonslayr on December 01, 2009, 02:06:07 am
Was using KPDF
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: sixstone on December 18, 2009, 11:22:36 am
Hello,

I have just tried again and the PDF is shown fine in my desktop using evince.

Cheers,
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: dr.bobo on January 22, 2010, 10:11:32 am
Dont know for who that was written. Examples are simple, not connected to real situations. Unusable. Nothing interesting, nothing useful
Title: Re: Official documentation for eBox 1.2 available (yay!)
Post by: J. A. Calvo on January 22, 2010, 12:38:38 pm
Dont know for who that was written. Examples are simple, not connected to real situations. Unusable. Nothing interesting, nothing useful

Maybe you are interested in our Certified Training if you want to learn to deal with "real situations" and get direct support from the development team?

http://www.ebox-technologies.com/training/