JAWmail

Appendix A. Frequently Asked Questions

1. Troubleshooting
1.1. Every time that someone uses JAWmail, I get such errors in the httpd's error log:
1.2. Installer says that Net/Socket.php is missing! Where can I get it?
1.3. I cannot log in! I'm 100% sure that my username and password are correct!
2. Gettext
2.1. No matter which language I choose, everything is still in English!
3. Helping
3.1. This project is so cool! How can I help?

1. Troubleshooting

1.1. Every time that someone uses JAWmail, I get such errors in the httpd's error log: 

[Wed Jul 17 14:47:11 2002] [notice] child pid 18543 exit signal Segmentation fault (11)

What is this?

Unfortunatelly, PHP or one of it's underlying libraries crashed. Please report this bug to the PHP team. You'll have to generate a backtrace of the segfault!

1.2. Installer says that Net/Socket.php is missing! Where can I get it?

This is a missing PEAR module. You can try installing it by using the PEAR command line interface, like this: 

[root@blisk jaw]# pear install Net_Socket

If that doesn't work, download the tarball from here and copy the Socket.php file into your PEAR library directory (usually /usr/local/lib/php/) into the Net subdirectory.

1.3. I cannot log in! I'm 100% sure that my username and password are correct!

Most probably, this is an IMAP/SSL problem.

First, try using the IMAP testing page. Open the page apps/mail/test-ima.php in your browser (so, if JAWmail is installed in http://server.lan/jawmail/, load http://server.lan/jawmail/apps/mail/test-imap.php).

Now, enter your IMAP username and password and enter the hostname of your IMAP server. In case that the connection will fail, try choosing another IMAP protocol. Most probably, imap/notls will work. If it does, reinstall JAWmail and select the appropriate IMAP protocol during installation.

2. Gettext

2.1. No matter which language I choose, everything is still in English!

The most common problem is that some system locale files are missing. Here is the long method to identify this problem: 

[root@blisk jaw]# export TEXTDOMAINDIR=/www/htdocs/jaw/locale/
Set this variable to the path to your locale directory of installation of JAW. 
[root@blisk jaw]# (LANG=sl_SI; gettext jaw "Login")
Replace sl_SI with the locale that bugs you. Now, in case that the string doesn't get translated, check your system locale directory for this locale, which is probably /usr/lib/locale/sl_SI/ for the Slovenian locale. Now, in case that any of the files in that directory have size of zero bytes (or there are no files!), you'll have to obtain the proper locale files. They are probably in the glibc-common package and they should already be there. This is still a bit weird, but it worked for me.

In case that this doesn't help... 

[root@blisk jaw]# (LANG=sl_SI; strace gettext jaw "Login")
... have fun! :-)

3. Helping

3.1. This project is so cool! How can I help?

Oh, there is a lot of work where you can help!

  • You can write or maintain a translation.

  • You can write a new application or a plugin.

  • You can find bugs and report them on the mailing list.

  • Spread the word about it to your friends, co-workers, sales department ... :)

  • You can write documentation and fix spelling errors!

  • You can donate stuff!

JAWmail  

SourceForge Logo