HOWTO: Open-Xchange on Gentoo

[bitwh0re]

Good day all,

I've finished a rough draft outlining how to get OX installed on Gentoo using:

- Postfix / Cyrus / SASL
- OpenLDAP
- Apache 2 / Tomcat 5
- PostgreSQL

As I said, it's a rough draft, so I don't go into detail on each services but it should give you enough info to get the basics for OX up and running. I welcome any comments, suggestions, fixes, and additions. You can currently find it in PDF here:

http://www.mikefetherston.ca/OX/OX_Install.pdf

[rojaro]

Thanks for the tutorial. But one question: Is it really nessacary to use postgres? I would like to use MySQL instead.

[bitwh0re]

This is from the Open Xchange website:

Code: Select all

Database
(The database server should provide JDBC functionallity
and should provide sub-selects, timestamps with timezones
and sequences. Tested successfully
with PostgreSQL.)

If MySQL can do that, then I don't really see a problem doing it.

[nsahoo]

Very nice.

It'd be useful if you can post it in text format along with link to pdf in the head post. That way even the console users can read it.

Cheers

[rojaro]

Code: Select all

Database
(The database server should provide JDBC functionallity
and should provide sub-selects, timestamps with timezones
and sequences. Tested successfully
with PostgreSQL.)

If MySQL can do that, then I don't really see a problem doing it.

Hmm ... i believe MySQL 4.1 provides all that, but it isnt in Portage yet :(

[bitwh0re]

Very nice.

It'd be useful if you can post it in text format along with link to pdf in the head post. That way even the console users can read it.

Cheers

Thanks! It's currently in .pdf because I've been writing it in Word & Writer. In the first page you'll see that I ask for help to convert the file to HTML readable by a text-based web browser.

[HCPawel]

Hi bitwh0re, nice tutorial - tomorrow, I will work it througt. Did you also try the installation with the open-xchange ebuild? This is what I've done, but it did not work.

[bitwh0re]

No, I'm aware of it from the other OX thread but didn't try it out. I understand it's in a very early stage and only found out about it after I had started my HOWTO.

OX is a pretty neat program, I must say.

[HCPawel]

I tried it and my experiences were not the best ...

The "emerge" was only thing that worked

I' m currently working with your tutorial and I will post my experience with it later.

[playworker]

Superb bit of documentation mate, very useful - Cheers!

[bitwh0re]

Thanks playworker! I plan to make it even better in the future. You may have noticed the unfinished section at the end..

Is there anything that you didn't see in the doc but would have like to have seen?

[peace]

emerge cyrus_imap-admin

should read:

emerge cyrus-imap-admin

i.e. dash - not underscore _

I'll post anything else I find. It's taking awhile to get the deps installed.

Also, could you post a link to the .doc or whatever the source file is so someone, maybe me, can do an html version?

[bitwh0re]

Thanks for catching that.. somehow that error snuck back in because I can remember fixing that before!

[peace]

To anyone who might be hanging on the "rhino" emerge at the line:

Code: Select all

compile:
    [javac] Compiling 109 source files to /var/tmp/portage/rhino-1.5_rc5/work/rhino1_5R5/build/classes

You will need to configure your JAVA_HOME and CLASSPATH env. vars using java-config.

See this thread for the rhino fix:

http://forums.gentoo.org/viewtopic.php? ... ight=rhino

See this for java-config docs:

http://www.gentoo.org/doc/en/java.xml

Don't forget to set your system classpath using --set-system-classpath further down in the java-config docs. I just added all the packages available on my system to the classpath. Probobly not nceccesary but, ya know. also, make sure you install all the java deps first, e.g. java mail, etc. Especialy the deps that require you to download specific versions from Sun and place the zip files in /usr/portage/distfiles.

There may need to be a step added to the OX docs where you configure the system java vm using java-config.

Kind Regards

[peace]

When ensuring entries in /etc/services, one entry that I needed to make was:

Code: Select all

imap 143/tcp

The stock /etc/services lists imap2 as the service for port 143. Either the OX docs should reflect the stock services or you will need to update services with the imap line above in order for the test to succeed.

netkit-telnetd is the ebuild for telnet, btw.

Kind Regards

[peace]

I think the lines:

Code: Select all

chown ldap /usr/lib/openldap-data/*
chgrp ldap /usr/lib/openldap-data/*

should read:

Code: Select all

chown ldap /var/lib/openldap-data/*
chgrp ldap /var/lib/openldap-data/*

Also, when moving the modules after extracting Fedora-Core-1-i386.tar.gz, might want to remove the /root from the beginning of the path incase the reader is not in root's home dir.

[peace]

Ox is installed and running! Thanks for the HOWTO!

I needed to fix a syntax error (my own fault) in webapps/servlet/WEB-INF/web.xml that was causing the servlet start to fail with a huge catalina stack trace. Once that was fixed everything ran perfectly.

Kind Regards

[pjp]

Moved from Documentation, Tips & Tricks.

[verdandi]

I just don't understand why you don't just use the ebuild in bugzilla.gentoo.org.
The ebuild is working and make uninstalling/updateing very easy. I would not say that it is in an early stage, it is as good as it gets for the moment. I have used it from OX version 0.7.1 with success every time.

[playworker]

Hmmm, I'm having some problems emerging all the required software, some packages require Ant which insists on pulling in Ant-tasks which in turn pulls in a package called Rhino, this fails to compile on my system

It's not a waiting forever problem, it just crashes out with a blank compile error.

Code: Select all

build.xml:51
toolsrc/build.xml:69
src_compile Line 35

Doesn't give any error details and there are no errors in the output, just a lot of semantic warnings.

Any ideas?

Also WRT the doc itself, should the line that you add to the OpenLDAP ebuild be

Code: Select all

myconf="${myconf} --enable-aci"

and not

Code: Select all

myconf="$(myconf) -enable-aci"

??

[playworker]

Alrighty, here's a quick rundown of my progress so far:

o New system bootstrapped with kernel 2.6.8 and nptl support (~x86)
o Added all the USE flags
o Changed the line in OpenLDAP ebuild as per my post above
o Berkeley DB is present
o emerged all packages as per your list but excluding ant-tasks as Rhino kept failing to build properly
o Grabbed all the Perl stuff
o Added all services to default runlevel
o Setup and started Postfix
o Setup and started Cyrus
o Setup SASL as per HOWTO but it won't start - message "Unknown Authentication Mechanism: ldap" FIXED: Re-emerged cyrus-sasl and it included the ldap stuff this time
o Added cyrus user but the cyradm command in the HOWTO just hangs FIXED: I wasn't using the full server name
o Setup LDAP as per HOWTO but it won't start - message "inetorgperson.schema: AttributeType not found "audio"" FIXED: Had missed out cosine.schema
o Initialised the LDAP tree but can't do the slapadd command because of the above error FIXED
o Setup and started Apache
o Setup and started PostgreSQL
o Setup and started Tomcat
o Configured and built Open-Xchange, seemed to build fine without ant-tasks package...
o Copied over the perl bits and now get an Open-Xchange login screen
o Tried to add the open-xchange PostgreSQL user but to no avail, doesn't seem to be able to see the PostgreSQL service even though it is running FIXED: Your HOWTO is missing a "-" line should read "createuser --pwprompt"

Installation is proceeding as planned now - I'll post again if I have any more ridiculously simple issues that I can solve myself

Cheers!

Matt

[peace]

Thanks Playworker! I will give the ebuild a try. I saw the OX ebuild bug just after starting the install via the HOWTO here. I figured I may as well finish the "manual" install as the HOWTO is really quite good and at the time the ebuild looked like it might be more trouble.

OX for gentoo is huge for us here. We have been strugling with our groupware solution and hope that this can slot nicely into that role. With a maintained ebuild present it looks like the right track.

Kind Regards

[BlackEdder]

Thanks! It's currently in .pdf because I've been writing it in Word & Writer. In the first page you'll see that I ask for help to convert the file to HTML readable by a text-based web browser.

Might be doable with:
* app-text/pdf2html
Latest version available: 1.4
Size of downloaded files: 22 kB
Homepage: http://atrey.karlin.mff.cuni.cz/~clock/ ... /pdf2html/
Description: Converts pdf files to html files
License: GPL-2

[playworker]

OX is now installed and running fine apart from the webmail bit, specifically there seems to be a problem with Open-Xchange talking to my Cyrus IMAP server, not sure what the issue is exactly but could someone confirm what the relationship is between Open-Xchange users and the IMAP users?

Do I just need a mailbox for each OX user and if so what do they need to be called?

The error I get on the server is : Login only available under a layer

[bitwh0re]

OX is now installed and running fine apart from the webmail bit, specifically there seems to be a problem with Open-Xchange talking to my Cyrus IMAP server, not sure what the issue is exactly but could someone confirm what the relationship is between Open-Xchange users and the IMAP users?

Do I just need a mailbox for each OX user and if so what do they need to be called?

Cyrus and OX both authenticate against LDAP but there needs to be a mailbox for the user. Just make the mailbox name the same as the username. You can automate this process, although I haven't tried it (yet), by reading this:

http://www.open-xchange.org/pipermail/u ... 15492.html

Thanks to all for catching my silly mistakes! They will be corrected and posted soon!