[1] | 1 | Open WebMail Frequently Asked Questions
|
---|
| 2 |
|
---|
| 3 | 0. SPECIAL NOTE FOR SPEEDYCGI
|
---|
| 4 | 1. INSTALLATION & STARTUP PROBLEMS
|
---|
| 5 | 2. LOGIN PROBLEMS
|
---|
| 6 | 3. RUNTIME ERRORS
|
---|
| 7 | 4. CONFIGURATION OPTIONS
|
---|
| 8 | 5. CHANGE PASSWORD
|
---|
| 9 | 6. READ MESSAGE
|
---|
| 10 | 7. COMPOSE MESSAGE
|
---|
| 11 | 8. MAIL FILTERING
|
---|
| 12 | 9. VIRUSCHECK/SPAMCHECK
|
---|
| 13 | 10. SEND MESSAGE
|
---|
| 14 | 11. AUTOREPLY
|
---|
| 15 | 12. SPELLCHECK
|
---|
| 16 | 13. ADDRESSBOOK
|
---|
| 17 | 14. CALENDAR
|
---|
| 18 | 15. SSL RELATED
|
---|
| 19 | 16. MISC PROBLEMS
|
---|
| 20 | 17. SPEED TUNING
|
---|
| 21 | 18. SOME CONCEPT
|
---|
| 22 | 19. HOW CAN I...
|
---|
| 23 |
|
---|
| 24 |
|
---|
| 25 | ========================================================================
|
---|
| 26 | SPECIAL NOTE FOR SPEEDYCGI
|
---|
| 27 | ========================================================================
|
---|
| 28 |
|
---|
| 29 | We highly recommend using SpeedyCGI with Open WebMail.
|
---|
| 30 | Open WebMail gets almost 5x to 10x speedup when running with SpeedyCGI.
|
---|
| 31 |
|
---|
| 32 | Please refer to section "PERSISTENT RUNNING through SpeedyCGI" in
|
---|
| 33 | readme.txt for how to install SpeedyCGI on your system.
|
---|
| 34 |
|
---|
| 35 | If you are using SpeedyCGI with Open WebMail
|
---|
| 36 | and you have modified any file other than etc/openwebmail.conf...
|
---|
| 37 |
|
---|
| 38 | Don't forget to do 'touch openwebmail*.pl'
|
---|
| 39 | so SpeedyCGI knows to reload the scripts to see your modification.
|
---|
| 40 |
|
---|
| 41 | ========================================================================
|
---|
| 42 | INSTALLATION & STARTUP PROBLEMS
|
---|
| 43 | ========================================================================
|
---|
| 44 |
|
---|
| 45 | Q: I got "SCRIPT_DIR not set in /etc/openwebmail_path.conf !" error?
|
---|
| 46 | A: On systems not passing perl script name as $0, openwebmail relies
|
---|
| 47 | on /etc/openwebmail_path.conf to know the directory it locates.
|
---|
| 48 |
|
---|
| 49 | Please put 'the path of your openwebmail cgi directory' in the first
|
---|
| 50 | line of file /etc/openwebmail_path.conf.
|
---|
| 51 |
|
---|
| 52 | For example, if the script is located at
|
---|
| 53 |
|
---|
| 54 | /usr/local/apache/share/cgi-bin/openwebmail/openwebmail.pl,
|
---|
| 55 |
|
---|
| 56 | then the content of /etc/openwebmail_path.conf should be:
|
---|
| 57 |
|
---|
| 58 | /usr/local/apache/share/cgi-bin/openwebmail
|
---|
| 59 |
|
---|
| 60 | Q: I got the script content instead of the openwebmail login screen?
|
---|
| 61 | I got "You don't have permission to access openwebmail.pl on this
|
---|
| 62 | server" error?
|
---|
| 63 | A: Your apache is not properly configured to execute CGI program.
|
---|
| 64 | Please edit the httpd.conf for your apache and modify it as follow:
|
---|
| 65 |
|
---|
| 66 | <Directory /var/www/cgi-bin>
|
---|
| 67 | AllowOverride All
|
---|
| 68 | Options ExecCGI
|
---|
| 69 | Order allow,deny
|
---|
| 70 | Allow from all
|
---|
| 71 | </Directory>
|
---|
| 72 |
|
---|
| 73 | You will notice "Order allow,deny" and "Allow from all" lines are
|
---|
| 74 | missing in default.
|
---|
| 75 |
|
---|
| 76 | Then reload httpd.
|
---|
| 77 |
|
---|
| 78 | (thanks to Thomas Chung, tchung.AT.openwebmail.org)
|
---|
| 79 |
|
---|
| 80 | ps: If you are using Mandrake:
|
---|
| 81 | httpd config file is located at /etc/httpd/conf/commonhttpd.conf
|
---|
| 82 | httpd reload command is "service httpd reload"
|
---|
| 83 |
|
---|
| 84 | If you are using FreeBSD:
|
---|
| 85 | httpd config file is located at /usr/local/etc/apache/httpd.conf
|
---|
| 86 | httpd reload command is "/usr/local/sbin/apachectl restart"
|
---|
| 87 |
|
---|
| 88 | Q: I got "Internal server error" when running Open WebMail?
|
---|
| 89 | I got "can not do setuid" error?
|
---|
| 90 | I got "Software error: Can't locate etc/openwebmail.conf in @INC" error?
|
---|
| 91 | A: There are many possible answers...
|
---|
| 92 |
|
---|
| 93 | 1. Please check if you have installed a complete set of perl 5.005 or above.
|
---|
| 94 | and You have uncompressed the openwebmail-1.xx.tar.gz with proper parameter.
|
---|
| 95 | It should be "tar -zxvBpf openwebmail-1.xx.tar.gz"
|
---|
| 96 |
|
---|
| 97 | 2. Your openwebmail scripts may have wrong owner or mode.
|
---|
| 98 | The permission of all openwebmail*.pl should be
|
---|
| 99 |
|
---|
| 100 | mode=4555
|
---|
| 101 | owner=root
|
---|
| 102 | group=mail
|
---|
| 103 |
|
---|
| 104 | 3. The suid support of your perl may be not correctly enabled.
|
---|
| 105 |
|
---|
| 106 | a. su to a regular user, then run openwebmail.pl form command line.
|
---|
| 107 | b. if it shows 'Can't do setuid', su to root,
|
---|
| 108 | have suidperl owner=root, node=4555, then try step a again
|
---|
| 109 | c. if it shows the following WARNING, su to root,
|
---|
| 110 | have suidperl owner=root, mode=555, then try step a again
|
---|
| 111 |
|
---|
| 112 | YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!
|
---|
| 113 | FIX YOUR KERNEL, OR PUT A C WRAPPER AROUND THIS SCRIPT!
|
---|
| 114 |
|
---|
| 115 | d. if it shows a long html text content, which means the suid
|
---|
| 116 | support of your suidperl is enabled.
|
---|
| 117 | e. if step b or c doesn't help, please goto step 4
|
---|
| 118 |
|
---|
| 119 | ps: If you are using Suse Linux 9.0 Professional, please note that the
|
---|
| 120 | permissions of suidperl is changed at each time SuSEconfig is run.
|
---|
| 121 | To avoid having to change these permissions manually each time,
|
---|
| 122 | please modify /etc/permissions.easy (or what permissions file used ever)
|
---|
| 123 | to set the proper permissions.
|
---|
| 124 | (thanks to dialsc.AT.t-online.de, Schaefer, Dirk Alexander)
|
---|
| 125 |
|
---|
| 126 | 4. if executing openwebmail.pl with regular user always complains
|
---|
| 127 | 'Can't do suid' or 'YOU HAVEN'T DISABLE SET-ID SCRIPTS IN THE KERNEL..'
|
---|
| 128 | then your perl executable was compiled without SUID support
|
---|
| 129 |
|
---|
| 130 | Here are the steps to recompile your perl with suid enabled:
|
---|
| 131 |
|
---|
| 132 | a. grab the perl source tar ball
|
---|
| 133 | b. sh Configure -de (de means default perl config)
|
---|
| 134 | c. edit config.sh and set this :
|
---|
| 135 | d_dosuid='define'
|
---|
| 136 | d_suidsafe='undef'
|
---|
| 137 |
|
---|
| 138 | ps: If you run './Configure' to configure the perl interactively,
|
---|
| 139 | then don't forget to answer 'yes' for question
|
---|
| 140 | "Do you want to do setuid/setgid emulation? "
|
---|
| 141 | Or you won't be able to execute openwebmail
|
---|
| 142 |
|
---|
| 143 | d. then make, make install (make suidperl if needed)
|
---|
| 144 | e. if you have compiled suidperl, then chmod 4555 suidperl
|
---|
| 145 | if you don't have suidperl, change #!/usr/bin/suidperl to
|
---|
| 146 | the path of your perl
|
---|
| 147 | (thanks to Nemo Kaiser, nemoo.AT.users.sourceforge.net)
|
---|
| 148 |
|
---|
| 149 | ps: If you are using FreeBSD and your perl is compiled from port,
|
---|
| 150 | then please note that the SUID support is disabled by default
|
---|
| 151 | since the port for perl 5.8.1
|
---|
| 152 |
|
---|
| 153 | You need to do 'make -DENABLE_SUIDPERL' in making port
|
---|
| 154 |
|
---|
| 155 | ps: If you don't want to recompile perl, you choose to may use
|
---|
| 156 | misc/tools/suidwrap.pl to generate C wrappers for all suid scripts.
|
---|
| 157 |
|
---|
| 158 | However, this is not recommended at all, as you will not be able
|
---|
| 159 | to use SpeedyCGI with the openwebmail system.
|
---|
| 160 |
|
---|
| 161 | Here are the steps:
|
---|
| 162 | 1. cd cgi-bin/openwebmail
|
---|
| 163 | 2. perl misc/tool/wrapsuid/wrapsuid.pl /fullpath/cgi-bin/openwebmail
|
---|
| 164 | 3. change #!/usr/bin/suidperl to the path of your perl
|
---|
| 165 |
|
---|
| 166 | All suid scripts will be renamed to .scriptname.pl and
|
---|
| 167 | the C wrapper will be generated and named as script.pl
|
---|
| 168 | (thanks to Chris Heegard, heegard.AT.NativeI.com)
|
---|
| 169 |
|
---|
| 170 | The spellcheck may not work on Solaris when using C wrappers.
|
---|
| 171 | (thanks to Isam Ishaq, isam.AT.planet.edu)
|
---|
| 172 |
|
---|
| 173 | 5. If you are using SpeedyCGI, and openwebmail always shows Internal error,
|
---|
| 174 | then your SpeedyCGI may be compiled without SUID support.
|
---|
| 175 | a. please be sure the speedycgi executable is owned by root with
|
---|
| 176 | permission 4555
|
---|
| 177 | b. please be sure you are using SpeedyCGI 2.22 or above
|
---|
| 178 | c. please be sure your perl is compiled with SUID support enabled
|
---|
| 179 | before compiling SpeedyCGI
|
---|
| 180 | d. please refer to section "PERSISTENT RUNNING through SpeedyCGI"
|
---|
| 181 | in readme.txt for how to compile SpeedyCGI.
|
---|
| 182 |
|
---|
| 183 | 6. If you are using SpeedyCGI, openwebmail seems be okay at the beginning,
|
---|
| 184 | but it shows "Internal Server Error" sometimes ...
|
---|
| 185 |
|
---|
| 186 | Please check the apache log to see if there is error messages like
|
---|
| 187 |
|
---|
| 188 | "unable to open tmp file ..."
|
---|
| 189 |
|
---|
| 190 | If yes, you system may not have the savedsuid support,
|
---|
| 191 | please set have_savedsuid_support to 'no' in etc/suid.conf
|
---|
| 192 |
|
---|
| 193 | 7. Some perl modules may be too old or not exist on your system
|
---|
| 194 | a. install MIME-Base64-3.01.tar.gz or above
|
---|
| 195 | b. install CGI.pm-3.05.tar.gz or above
|
---|
| 196 | c. install the libnet-1.19.tar.gz or above
|
---|
| 197 |
|
---|
| 198 | ps: In most cases, you can run the './openwebmail.pl' in text terminal
|
---|
| 199 | to get more information about the error.
|
---|
| 200 |
|
---|
| 201 | Q: I got "Can't check filesystem of script ./openwebmail.pl for nosuid"?
|
---|
| 202 | A: Your openwebmail may be installed on a filesystem mounted nosuid.
|
---|
| 203 | Please remove the nosuid parameter from /etc/fstab or install openwebmail
|
---|
| 204 | to other filesystem.
|
---|
| 205 |
|
---|
| 206 | ps: 'man mount' for more information about nosuid
|
---|
| 207 |
|
---|
| 208 | Q: I got "Please execute '.../cgi-bin/openwebmail-tool.pl --init' on
|
---|
| 209 | server first!"?
|
---|
| 210 | A: This is to init the mapping tables used by openwebmail, you need to
|
---|
| 211 |
|
---|
| 212 | telnet to your server
|
---|
| 213 | su root
|
---|
| 214 | cd the_cgi_bin_dir_for_openwebmail
|
---|
| 215 | ./openwebmail-tool.pl --init
|
---|
| 216 |
|
---|
| 217 | Q: I got "Please execute script openwebmail-tool.pl with full path!"
|
---|
| 218 | in executing 'openwebmail-tool.pl --init' with full path?
|
---|
| 219 | A: This may happens on platforms that run suid scripts through /dev/fd/.
|
---|
| 220 | Please run the script from where it is located.
|
---|
| 221 |
|
---|
| 222 | cd the_dir_of_your_openwebmail_cgi
|
---|
| 223 | ./openwebmail-tool.pl --init
|
---|
| 224 |
|
---|
| 225 | Q: I got "Please change /openwebmail_scripts_dir/etc/dbm.conf from xxx to yyy"
|
---|
| 226 | in executing 'openwebmail-tool.pl --init' ?
|
---|
| 227 | A: You may has wrong settings in your etc/dbm.conf.
|
---|
| 228 | Please modify the etc/dbm.conf as openwebmail suggested
|
---|
| 229 | and don't forget to redo 'openwebmail-tool.pl --init' again.
|
---|
| 230 |
|
---|
| 231 | Q: --init complains the dbm options after I upgrade OS?
|
---|
| 232 | --init complains the dbm options after I upgrade perl?
|
---|
| 233 | --init complains the dbm options when I copy openwebmail.conf to another
|
---|
| 234 | machine?
|
---|
| 235 | A: The perl system may use different dbm format depending on what packages
|
---|
| 236 | have been installed in your server. These dbm format may be not compatible.
|
---|
| 237 | To know what dbm packages are used by your perl, please execute:
|
---|
| 238 |
|
---|
| 239 | perl misc/test/dbmtest.pl
|
---|
| 240 |
|
---|
| 241 | And you will see output like below:
|
---|
| 242 |
|
---|
| 243 | ------------------------------------------------------------------
|
---|
| 244 | You perl uses the following packages for dbm::
|
---|
| 245 |
|
---|
| 246 | AnyDBM_File.pm /usr/libdata/perl/5.00503/AnyDBM_File.pm
|
---|
| 247 | NDBM_File.pm /usr/libdata/perl/5.00503/mach/NDBM_File.pm
|
---|
| 248 |
|
---|
| 249 |
|
---|
| 250 | The dbm options in dbm.conf should be set as follows:
|
---|
| 251 |
|
---|
| 252 | dbm_ext .db
|
---|
| 253 | dbmopen_ext none
|
---|
| 254 | dbmopen_haslock no
|
---|
| 255 | ----------------------------------------------------------------------
|
---|
| 256 |
|
---|
| 257 | AnyDBM_File.pm is a "pure virtual base class", it has nothing of its own.
|
---|
| 258 | It's just there to inherit from one of the various DBM packages in the
|
---|
| 259 | following order: NDBM_File, DB_File, GDBM_File, SDBM_File, ODBM_File
|
---|
| 260 | (you may type 'perldoc AnyDBM_File' to see comparison of these packages)
|
---|
| 261 |
|
---|
| 262 | In the above example, the system uses NBDM package for dbm.
|
---|
| 263 | when you upgrade OS, perl or migrate openwebmail to other machine,
|
---|
| 264 | you should run dbmtest.pl on both system to ensure that they use same
|
---|
| 265 | underlying dbm package.
|
---|
| 266 |
|
---|
| 267 | Q: ok, my two machines use different DBM systems, what can I do next?
|
---|
| 268 | A: you can enforce the new one to use the same dbm package as the old one by
|
---|
| 269 | putting the 'use XXX_File.pm' after the 'use strict;' in all openwebmail*pl.
|
---|
| 270 | then try to run 'openwebmail-tool.pl --test' to see if the XXX_File.pm is
|
---|
| 271 | really used.
|
---|
| 272 |
|
---|
| 273 | where XXX_File.pm is the value you get by running dbmtest.pl on old machine.
|
---|
| 274 |
|
---|
| 275 | Q: When I installed Open WebMail on Fedora 3, --init generated no output?
|
---|
| 276 | A: Please turn the selinux feature off by
|
---|
| 277 | setting "SELINUX=disabled" in /etc/selinux/config,
|
---|
| 278 | then try to execute openwebmail-tool.pl --init again.
|
---|
| 279 |
|
---|
| 280 | ========================================================================
|
---|
| 281 | LOGIN PROBLEMS
|
---|
| 282 | ========================================================================
|
---|
| 283 |
|
---|
| 284 | Q: The login menu showed okay, but I always got login failure?
|
---|
| 285 | A: Check auth_module option in openwebmail.conf:
|
---|
| 286 |
|
---|
| 287 | If it is 'auth_unix.pl',
|
---|
| 288 | check if passwdfile_encrypted and passwdmkdb in auth_unix.conf are correct
|
---|
| 289 |
|
---|
| 290 | If it is 'auth_pam.pl',
|
---|
| 291 | make sure you have followed the instructions of 'PAM SUPPORT' in readme.txt.
|
---|
| 292 |
|
---|
| 293 | If you still got login failure, you can debug the pam module by:
|
---|
| 294 | 1. modify auth_pam.pl
|
---|
| 295 | uncomment all the lines of main::log_time(...)
|
---|
| 296 | 2. login to openwebmail
|
---|
| 297 | 3. check the /tmp/openwebmail.debug for more information.
|
---|
| 298 |
|
---|
| 299 | ps: If you are running openwebmail under SpeedyCGI, don't forget to do a
|
---|
| 300 | 'touch openwebmail*pl' after you complete the modification to
|
---|
| 301 | auth module or auth conf file.
|
---|
| 302 |
|
---|
| 303 | Q: It took a long time in the first login?
|
---|
| 304 | A: Openwebmail has to initialize some mapping tables for future use,
|
---|
| 305 | it creates these tables in the first successful login, this guarantees
|
---|
| 306 | that openwebmail creates files only if it is correctly installed.
|
---|
| 307 |
|
---|
| 308 | ps: This automatic table initialization has been removed since openwebmail-1.80.
|
---|
| 309 | The sysadm have to initialize the db by himself explicitly with the command
|
---|
| 310 |
|
---|
| 311 | './openwebmail-tool.pl --init'
|
---|
| 312 |
|
---|
| 313 | Q: It took a long time in every login?
|
---|
| 314 | Q: Openwebmail hangs at every login after I saved the preference in the first
|
---|
| 315 | time?
|
---|
| 316 | A: You probably have wrong settings in the dbm.conf,
|
---|
| 317 | please execute 'perl misc/test/dbmtest.pl' to find correct settings.
|
---|
| 318 |
|
---|
| 319 | Q: Some of my users login okay, but others don't, why?
|
---|
| 320 | A: It is possible that you are upgrading from version prior to 1.41
|
---|
| 321 | to the newer version. The virtual user support is totally reimplemented.
|
---|
| 322 | It uses virtusertable instead of genericstable for user mapping now.
|
---|
| 323 | Please refer to
|
---|
| 324 | http://www.sendmail.org/virtual-hosting.html to know how to translate
|
---|
| 325 | entries in genericstable to virtusertable.
|
---|
| 326 |
|
---|
| 327 | Q: Some of my user with invalid shell couldn't login since upgrade to 1.80?
|
---|
| 328 | A: A new variable check_shell option has been added to the auth_unix.conf
|
---|
| 329 | If it is set to yes, which means only users with valid shell can login.
|
---|
| 330 | If it is set to no, then openwebmail won't do valid shell checking.
|
---|
| 331 |
|
---|
| 332 | Q: A string 'Sessions : 5, 10, 20' appeared at the bottom of the copyright
|
---|
| 333 | page after successful login, what does this string mean?
|
---|
| 334 | A: It means the number of users that were active in the last 1, 5 and 15
|
---|
| 335 | minutes, which gives a rough estimation of the webmail usage state.
|
---|
| 336 |
|
---|
| 337 | Q: How does autologin work? Will my password be stored somewhere?
|
---|
| 338 | A: Whenever you have successfully logined openwebmail,
|
---|
| 339 | openwebmail will store your loginanme/logindomain as cookies in your browser.
|
---|
| 340 | If you didn't logout the session, then openwebmail will bring you into
|
---|
| 341 | main screen at your next login if the session is still not timeouted.
|
---|
| 342 |
|
---|
| 343 | Openwebmail does this by checking if you have a valid session file on server,
|
---|
| 344 | so your password is not required or stored in either server or client side.
|
---|
| 345 |
|
---|
| 346 | Q: Is it safe to use autologin feature?
|
---|
| 347 | A: It depends. You can enable it on your private computer if the computer is secure.
|
---|
| 348 | And if you are using a public computer, please don't enable autologin,
|
---|
| 349 | or be sure to do a logout before leaving that public computer.
|
---|
| 350 |
|
---|
| 351 | Q: I have enabled autologin on some public computer and forget to logout,
|
---|
| 352 | what can I do to prevent others to autologin my account?
|
---|
| 353 | A: 1. go to that computer and do logout explicitly :)
|
---|
| 354 | 2. If 1 is not possible, then you may login openwebmail, switch to webdisk,
|
---|
| 355 | turn on the checkbox of ShowHidden at the up-right corner,
|
---|
| 356 | then chdir to subdir .openwebmail, and remove the autologin.check.db
|
---|
| 357 | ps: this will remove all old remembered autologin sessions.
|
---|
| 358 | 3. If you don't do anything, the old session will be finally timeouted anyway.
|
---|
| 359 |
|
---|
| 360 | Q: Can I limit the use of autologin feature?
|
---|
| 361 | A: Yes, option allowed_autologinip can be used to control which subnets are
|
---|
| 362 | allowed to use the autologin, or even disable it at all.
|
---|
| 363 | Please refer to openwbemail.conf.help for more detail.
|
---|
| 364 |
|
---|
| 365 |
|
---|
| 366 | ========================================================================
|
---|
| 367 | RUNTIME ERRORS
|
---|
| 368 | ========================================================================
|
---|
| 369 |
|
---|
| 370 | Q: I got "Couldn't open XXX-session-0.370606494136155!" error after login?
|
---|
| 371 | A: You openwebmail-1.xx.tar.gz was uncompressed with improper parameter.
|
---|
| 372 | It should be "tar -zxvBpf openwebmail-1.xx.tar.gz"
|
---|
| 373 | Or you can refer to the file permission list in the end of readme.txt
|
---|
| 374 | ps: you may check the permission cgi-bin/openwebmail/etc/sessions first,
|
---|
| 375 | it should be owner=root, group=mail, mode=771
|
---|
| 376 |
|
---|
| 377 | Q: I got "Software error: Can't locate MIME/Base64.pm in @INC"?
|
---|
| 378 | A: Please install the MIME-Base64-3.01.tar.gz.
|
---|
| 379 |
|
---|
| 380 | Q: I got "Too many arguments for MIME::QuotedPrint::encode_qp"?
|
---|
| 381 | A: Your MIME module is too old, please install the MIME-Base64-3.01.tar.gz.
|
---|
| 382 |
|
---|
| 383 | Q: I got "Software error: Can't locate Text/Iconv.pm in @INC"?
|
---|
| 384 | A: Please install the Text-Iconv-1.2.tar.gz, this is required since
|
---|
| 385 | openwebmail-1.80
|
---|
| 386 |
|
---|
| 387 | Q: First login was okay and openwebmail told me to setup preference,
|
---|
| 388 | then I got "Internal Server Error" ?
|
---|
| 389 | A: You may forget to install Text-Iconv-1.2.tar.gz,
|
---|
| 390 | or you may compile Text-Iconv with wrong parameter in Makefile.PL.
|
---|
| 391 | Please check readme.txt with keyword Text-Iconv to see
|
---|
| 392 | if any special modification is required for your platform
|
---|
| 393 |
|
---|
| 394 | Q: First login was okay and I can setup preference without problem,
|
---|
| 395 | then I got "Couldn't get write lock on INBOX!" immediately ?
|
---|
| 396 | A: You may have wrong setting for option mailspooldir in openwebmail.conf
|
---|
| 397 |
|
---|
| 398 | Q: I got "Use of uninitialized value in subroutine entry at /xxx/DB_File.pm
|
---|
| 399 | line yyy" error ?
|
---|
| 400 | A: The line you got error should be inside the sub routine tie_hash_or_array.
|
---|
| 401 | Please find the following comment line in DB_File.pm:
|
---|
| 402 |
|
---|
| 403 | # make recno in Berkeley DB version 2 work like recno in version 1
|
---|
| 404 |
|
---|
| 405 | And add the following line just before the above line:
|
---|
| 406 |
|
---|
| 407 | $arg[3] = 0666 unless defined $arg[3] ;
|
---|
| 408 |
|
---|
| 409 | (thanks to Paul Marquess, Paul.Marquess.AT.btinternet.com
|
---|
| 410 | and mainely_linux.AT.users.sourceforge.net)
|
---|
| 411 |
|
---|
| 412 | Q: I got "can't open /var/log/openwebmail.log" error?
|
---|
| 413 | A: Please check the openwebmail.log permission, it should be
|
---|
| 414 | owner=root, group=mail, mode=660
|
---|
| 415 |
|
---|
| 416 | ps: If you get this error periodicly and your are using Mandrake Linux,
|
---|
| 417 | You may have to move the logfile somewhere else.
|
---|
| 418 | The Mandrake's (8.2 and 9.0) security system periodically scans the
|
---|
| 419 | /var/log directory and changes ownerships/permissions.
|
---|
| 420 | (thanks to Karl Schricker, karl_schricker.AT.gmx.net)
|
---|
| 421 |
|
---|
| 422 | Q: I got "Software error: ndbm store returned -1, errno XX, ..."?
|
---|
| 423 | A: The meaning of errno XX could be found in errno.h
|
---|
| 424 |
|
---|
| 425 | If your OS is FreeBSD, please check /usr/include/sys/errno.h
|
---|
| 426 | If your OS is Linux, please check /usr/include/asm/errno.h
|
---|
| 427 | If your OS is Solaris, please check /usr/include/sys/errno.h
|
---|
| 428 |
|
---|
| 429 | Most of the time, the error is due to exceeded user quota.
|
---|
| 430 | Please remove unwanted files or increase the quota for user.
|
---|
| 431 |
|
---|
| 432 | ps: Since openwebmail 20031128, you may set the option
|
---|
| 433 | use_syshomedir_for_dotdir to no to have openwebmail put index db
|
---|
| 434 | in ow_usersdir instead of user homedir, thus creating db won't be
|
---|
| 435 | limited by user quota.
|
---|
| 436 |
|
---|
| 437 | Q: My SENT folder shows -1 or other negative message size rather then
|
---|
| 438 | regular message size?
|
---|
| 439 | A: This problem occurs if you installed Open WebMail on the same partition
|
---|
| 440 | where quota is enabled. Open WebMail uses temp files in
|
---|
| 441 | cgi-bin/openwebmail/etc/sessions folders.
|
---|
| 442 | Solution is to move sessions folder to another partition with no Quota.
|
---|
| 443 |
|
---|
| 444 | Please read RedHat-README.txt for detailed explanation on setting up
|
---|
| 445 | this, since this problem mostly occurs on RedHat Linux 6.2 and bellow.
|
---|
| 446 | (thanks to Emir Litric, elitric.AT.yahoo.com)
|
---|
| 447 |
|
---|
| 448 | Q: I got "db warning - msg xxx index missing in INBOX" in log?
|
---|
| 449 | What does this mean?
|
---|
| 450 | A: It may have two possible meanings.
|
---|
| 451 |
|
---|
| 452 | 1. Your message is moved to other folder by the openwebmail filter module
|
---|
| 453 |
|
---|
| 454 | While openwebmail always maintains the index consistent with the folder
|
---|
| 455 | content, openwebmail only calls the mailfilter in the following two
|
---|
| 456 | condition:
|
---|
| 457 | a. before browsing the message list of a folder
|
---|
| 458 | b. before reading a message of the INBOX
|
---|
| 459 |
|
---|
| 460 | If a message(aaa) matching the filter rule comes to INBOX folder, this
|
---|
| 461 | message will become the neighbor of one of the existing messages(bbb)
|
---|
| 462 | in the index db. If the user is reading message bbb, then aaa will
|
---|
| 463 | become the target linked by the right or left arrows in the bottom of
|
---|
| 464 | the readmessage webpage. Now if user clicks the arrow for next page,
|
---|
| 465 | you will get the db index missing error since the message(aaa) is
|
---|
| 466 | moved to other folder by the filter before being accessed..
|
---|
| 467 |
|
---|
| 468 | 2. Your message is removed by other pop3/imap client.
|
---|
| 469 | Do you use outlook and openwebmail at the same time?
|
---|
| 470 |
|
---|
| 471 | Q: I got "db warning - msg yyy index inconsistence in INBOX" in the log?
|
---|
| 472 | Does it mean my message were lost?
|
---|
| 473 | A: No, you message were not lost, it just means the index db was not
|
---|
| 474 | reflecting the newest state of your mail folder, openwebmail did the
|
---|
| 475 | reindex automatically after logging this message.
|
---|
| 476 |
|
---|
| 477 | Q: I got "Your request didn't contain the proper session ID cookie --
|
---|
| 478 | access denied!" error?
|
---|
| 479 | A: Please enable the cookie function of your browser.
|
---|
| 480 | Or you can set the option session_checkcookie to 'no' to disable
|
---|
| 481 | the check of cookie in openwebmail, but this may put the user
|
---|
| 482 | session in danger that it could be hijacked by others.
|
---|
| 483 |
|
---|
| 484 | Q: I got "Your request didn't come from the same ip of this session --
|
---|
| 485 | access denied!" error?
|
---|
| 486 | A: The client may access the webmail server through a gateway which may
|
---|
| 487 | dynamicly change it IP address, please set the option
|
---|
| 488 | session_checksameip to 'no' to disable the IP check.
|
---|
| 489 |
|
---|
| 490 | Q: My openwebmail was okay, but I got "Your request didn't contain the
|
---|
| 491 | proper session ID cookie -- access denied!" in these days?
|
---|
| 492 | A: Openwebmail puts user uploaded attachments in
|
---|
| 493 | cgi-bin/openwebmail/etc/sessions/ temporarily.
|
---|
| 494 | User will get error if there is no space left on the partition where
|
---|
| 495 | cgi-bin/openwebmail/etc/sessions/ lives or user has exceeded his disk quota.
|
---|
| 496 |
|
---|
| 497 | Please move cgi-bin/openwebmail/etc/sessions to a larger partition with
|
---|
| 498 | diskquota disabled, then create a symbolic link to that new directory
|
---|
| 499 |
|
---|
| 500 | cd /new_place
|
---|
| 501 |
|
---|
| 502 | mkdir sessions
|
---|
| 503 | chmod 771 sessions
|
---|
| 504 | chown 0 sessions
|
---|
| 505 | chgrp mail sessions
|
---|
| 506 |
|
---|
| 507 | cd yourweb_cgi-bin/openwebmail/etc/
|
---|
| 508 | rm -Rf sessions
|
---|
| 509 | ln -s /new_place/sessions .
|
---|
| 510 |
|
---|
| 511 | Q: I got 'Couldn't get read lock on ....' error?
|
---|
| 512 | 'Couldn't get write lock on ....' error?
|
---|
| 513 | A: If the error message appears immediately after you submit the CGI request,
|
---|
| 514 | then it may be due to the user doesn't has enough privilege to lock the
|
---|
| 515 | file or the directory for the file even doesn't exist.
|
---|
| 516 |
|
---|
| 517 | If the error message appears after the cgi request submission for more
|
---|
| 518 | than 30 seconds, then the folder openwebmail want to access may be locked
|
---|
| 519 | by other process.
|
---|
| 520 |
|
---|
| 521 | Most of the time, it is due to the concurrent accesses to the folder by
|
---|
| 522 | other mail client through the pop3/imap daemons.
|
---|
| 523 | This is okay, just back to previous page and try again later.
|
---|
| 524 |
|
---|
| 525 | To know where the error happened exactly, you may try to set option
|
---|
| 526 | error_with_debuginfo to yes in openwebmail.conf. This would give you
|
---|
| 527 | more detailed information in case openwebmailerror() happens.
|
---|
| 528 |
|
---|
| 529 | If you are running openwebmail in persistent mode,
|
---|
| 530 | there could be openwebmail processes locking the folder file for indexing.
|
---|
| 531 | To release the lock, you may kill the openwebmail speedy_backend process.
|
---|
| 532 |
|
---|
| 533 | Since openwebmail 20041129, you may use 'openwebmail-tool.pl -u username'
|
---|
| 534 | to find the processes holding the filelocks, and kill the processes after
|
---|
| 535 | confirmation.
|
---|
| 536 | If the locks couldn't be released after killing the related processes,
|
---|
| 537 | you may solve the problem in a quick and dirty way...
|
---|
| 538 |
|
---|
| 539 | rename the file, copy it to original name, then remove the renamed one.
|
---|
| 540 | This would have the file a new inode and thus release all old locks.
|
---|
| 541 |
|
---|
| 542 | ps: The 'openwebmail-tool.pl -u requires the lsof package.
|
---|
| 543 | it is available at http://freshmeat.net/projects/lsof/
|
---|
| 544 |
|
---|
| 545 | ps: Killing the openwebmail process may leave an incomplete index db
|
---|
| 546 | on disk. It is okay, the folder index db will be fixed or rebuild
|
---|
| 547 | in the next access.
|
---|
| 548 |
|
---|
| 549 | ========================================================================
|
---|
| 550 | CONFIGURATION OPTIONS
|
---|
| 551 | ========================================================================
|
---|
| 552 |
|
---|
| 553 | Q: The 'From' field of my message contained only 'username@'?
|
---|
| 554 | A: You may has wrong setting for option domainnames in openwebmail.conf
|
---|
| 555 | please list all domainnames separated with comma, or
|
---|
| 556 | use auto for this setting, openwebmail will use the hostname in the url
|
---|
| 557 | or call '/bin/hostname' to get the FQDN (fully qualified domain name)
|
---|
| 558 | of your host.
|
---|
| 559 |
|
---|
| 560 | Q: The domainname detected by openwebmail is not what I want,
|
---|
| 561 | how can I specified the outgoing mail domain for all my users?
|
---|
| 562 | A: Please set the domainnames option in openwebmail.conf from 'auto' to
|
---|
| 563 | the domainname you want. Multiple domainnames can be specified only
|
---|
| 564 | if separated by comma
|
---|
| 565 |
|
---|
| 566 | Q: How can I use LDAP to authenticate user in openwebmail?
|
---|
| 567 | A: You have 2 ways to do this:
|
---|
| 568 | 1. use the auth_ldap.pl written by Ivan Cerrato, pengus.AT.libero.it
|
---|
| 569 | 2. use auth_pam module and let pam to talk with ldap server.
|
---|
| 570 |
|
---|
| 571 | Below is an article posted at sourceforge by ispman.AT.user.sourceforge.net
|
---|
| 572 | (http://sourceforge.net/forum/message.php?msg_id=1462314)
|
---|
| 573 |
|
---|
| 574 | ---------------- begin ----------------
|
---|
| 575 | I hope this is useful to someone:
|
---|
| 576 |
|
---|
| 577 | I was able to get openwebmail to authenticate using ldap/pam on a system
|
---|
| 578 | with Redhat 7.1, pam_ldap135, and OpenLDAP 2.0.18.
|
---|
| 579 |
|
---|
| 580 | In openwebmail.conf ~
|
---|
| 581 |
|
---|
| 582 | auth_module auth_pam.pl
|
---|
| 583 |
|
---|
| 584 | In auth_pam.conf ~
|
---|
| 585 |
|
---|
| 586 | servicename openwebmail
|
---|
| 587 | passwdfile_plaintext /etc/passwd
|
---|
| 588 |
|
---|
| 589 | vi /etc/pam.d/openwebmail:
|
---|
| 590 |
|
---|
| 591 | #%PAM-1.0
|
---|
| 592 | auth required /lib/security/pam_unix.so
|
---|
| 593 | auth sufficient /lib/security/pam_ldap.so
|
---|
| 594 | account required /lib/security/pam_unix.so
|
---|
| 595 | account sufficient /lib/security/pam_ldap.so
|
---|
| 596 |
|
---|
| 597 | That's it. LDAP users will authenticate with the pam_ldap module and
|
---|
| 598 | system users with pam_unix.
|
---|
| 599 | ---------------- end ----------------
|
---|
| 600 |
|
---|
| 601 | Q: How can I use multiple virtual domains with openwebmail?
|
---|
| 602 | A: First, you have to decide whether to use real virtual hosting or
|
---|
| 603 | just user alias.
|
---|
| 604 |
|
---|
| 605 | 1. The User Alias
|
---|
| 606 |
|
---|
| 607 | User alias is much simpler, your system is actually a one domain machine.
|
---|
| 608 | You only have to define the user alias in virtusertable.
|
---|
| 609 |
|
---|
| 610 | For example, you have 1 real domain server.com and
|
---|
| 611 | 2 virtual domain virtual_1.com, virtual_2.com
|
---|
| 612 | for your server.
|
---|
| 613 |
|
---|
| 614 | You already have tom and john on this server.
|
---|
| 615 | And now you want 2 more tom and john for each virtual domain.
|
---|
| 616 |
|
---|
| 617 | Define the following entries in your virtusertable will make it.
|
---|
| 618 |
|
---|
| 619 | tom@virtual_1.com tom1
|
---|
| 620 | tom@virtual_2.com tom2
|
---|
| 621 | john@virtual_1.com john1
|
---|
| 622 | john@virtual_2.com john2
|
---|
| 623 |
|
---|
| 624 | And how these users are used?
|
---|
| 625 |
|
---|
| 626 | If the user logins as tom and the webmail url is http://virtual_1.com/....
|
---|
| 627 | then alias tom@virtual_1.com will be matched, real user tom1 will be used.
|
---|
| 628 | If the user logins as tom and the webmail url is http://virtual_2.com/....
|
---|
| 629 | then alias tom@virtual_2.com will be matched, real user tom2 will be used.
|
---|
| 630 |
|
---|
| 631 | If the user logins as tom and the webmail url is http://server.com/....
|
---|
| 632 | then real user tom will be authenticated.
|
---|
| 633 |
|
---|
| 634 | If the user logins as tom@virtual_1.com, then no matter what the url is,
|
---|
| 635 | the alias tom@virtual_1.com will be matched, user tom1 will be used.
|
---|
| 636 |
|
---|
| 637 | In the user alias mapping, users of different virtualdomains are actually
|
---|
| 638 | mapped to the real domain and then passed to same authentication module.
|
---|
| 639 |
|
---|
| 640 |
|
---|
| 641 | 2. Real Virtual Hosting
|
---|
| 642 |
|
---|
| 643 | The real virtual hosting means your system is configured to a multiple
|
---|
| 644 | domain machine in either smtpd, pop3d, webmail and authentication module.
|
---|
| 645 |
|
---|
| 646 | You will need to use the per domain config file in openwebmail for each
|
---|
| 647 | of your virtual domain. These config files will be loaded based on
|
---|
| 648 |
|
---|
| 649 | 1. the domainname part in loginname, or
|
---|
| 650 | 2. the hostname in the url of the webmail
|
---|
| 651 |
|
---|
| 652 | ps: You may need to use the domainname_equiv option to ensure no matter
|
---|
| 653 | which domainname is used by user or in URL, they will be mapped to
|
---|
| 654 | a consistent one.
|
---|
| 655 |
|
---|
| 656 | For example:
|
---|
| 657 |
|
---|
| 658 | If the user login as tom and the webmail url is http://virtual_1.com/...,
|
---|
| 659 | config file for virtual_1.com will be loaded
|
---|
| 660 | If the user login as tom and the webmail url is http://virtual_2.com/...,
|
---|
| 661 | config file for virtual_2.com will be loaded
|
---|
| 662 | If the user logins as tom@virtual_1.com, then no matter what the url is,
|
---|
| 663 | config file for virtual_1.com will be loaded
|
---|
| 664 |
|
---|
| 665 | Each domain can have its own set of options in its config file,
|
---|
| 666 | including domainname, authentication module, quota limit, mailspooldir ...
|
---|
| 667 |
|
---|
| 668 | A more detailed example is described in the Kevin Ellis's webpage:
|
---|
| 669 | "How to setup virtual users on Open WebMail using Postfix & vm-pop3d"
|
---|
| 670 | http://www.bluelavalamp.net/owmvirtual/
|
---|
| 671 |
|
---|
| 672 | Q: Could I have configuration file on per user basis?
|
---|
| 673 | A: Yes, let us use tom@virtual_1.com as example.
|
---|
| 674 |
|
---|
| 675 | If option auth_withdomain is set to yes,
|
---|
| 676 | the user conf is cgi-bin/openwebmail/etc/users.conf/virtual_1.com/tom
|
---|
| 677 |
|
---|
| 678 | If option auth_withdomain is set to no,
|
---|
| 679 | the user conf is cgi-bin/openwebmail/etc/users.conf/tom
|
---|
| 680 |
|
---|
| 681 | Q: The default mail domain for my user is always wrong, how can I set it?
|
---|
| 682 | A: To have openwebmail find the correct mail domain for the user,
|
---|
| 683 | you'd give it some hint.
|
---|
| 684 |
|
---|
| 685 | For example, if the webmail url is
|
---|
| 686 |
|
---|
| 687 | http://mail.server_1.com/cgi-bin/.....,
|
---|
| 688 |
|
---|
| 689 | and you want the email for tom to be tom@virtual_1.com.
|
---|
| 690 |
|
---|
| 691 | You can achieve this in either the following 2 ways:
|
---|
| 692 |
|
---|
| 693 | 1. create per user config file etc/users.conf/tom
|
---|
| 694 | and set option domainnames to virtual_1.com
|
---|
| 695 | 2. create per domain config file etc/sites.cof/mail1.server_1.com
|
---|
| 696 | and set option domainnames to virtual_1.com
|
---|
| 697 |
|
---|
| 698 | While 1 is only for the user tom, the method 2 has effect for all users
|
---|
| 699 | who logins with the url http://mail.server_1.com/cgi-bin/....
|
---|
| 700 |
|
---|
| 701 | Q: I want to change not only the domainname part but also the username part
|
---|
| 702 | of the default email address?
|
---|
| 703 | A: You can use the virtusertable or the per user config file
|
---|
| 704 |
|
---|
| 705 | 1. virtusertable:
|
---|
| 706 | One or more email address can be defined in virtusertable for same user,
|
---|
| 707 | all those email addresses will be used as the default email address for
|
---|
| 708 | that user
|
---|
| 709 | 2. per user config file:
|
---|
| 710 | You can set the default_fromemails option in the per user config file.
|
---|
| 711 | Multiple default email addresses can be specified only if you separate
|
---|
| 712 | them with comma.
|
---|
| 713 |
|
---|
| 714 | ps: While virtusertable is convenient in setting default email addresses
|
---|
| 715 | for many users, per user config file let sysadm control many properties
|
---|
| 716 | for a specific user.
|
---|
| 717 |
|
---|
| 718 | Q: How can I disallow the user to set their from email address or realname?
|
---|
| 719 | A: set option enable_loadfrombook to 'no'
|
---|
| 720 | in either openwebmail.conf or per user config.
|
---|
| 721 |
|
---|
| 722 | Q: How can I allow user to change their realname
|
---|
| 723 | but disallow the user to set their from email address?
|
---|
| 724 | A: set option enable_loadfrombook to 'yes' and
|
---|
| 725 | set option frombook_for_realname_only to 'yes'
|
---|
| 726 | in either openwebmail.conf or per user config.
|
---|
| 727 |
|
---|
| 728 | Q: Can I install openwebmail without iconv() support?
|
---|
| 729 | A: Yes, you may copy the misc/patches/iconv.pl.fake over the shares/iconv.pl,
|
---|
| 730 | which doesn't use iconv() at all but still support charset conversion for
|
---|
| 731 | Chinese and Japanese.
|
---|
| 732 |
|
---|
| 733 | Q: Can I setup mail account for user without creating the unix account?
|
---|
| 734 | A: Yes, you need postfix + vm-pop3d + openwebmail.
|
---|
| 735 | Kevin Ellis(kevin.AT.bluelavalamp.net) has made a webpage for this,
|
---|
| 736 | it is available at http://www.bluelavalamp.net/owmvirtual/
|
---|
| 737 |
|
---|
| 738 | Q: I have set openwebmail for virtual user with vm-pop3d, but I got
|
---|
| 739 | "Sorry, root login is disabled for security's sake" at login?
|
---|
| 740 | A: Please check the descriptions in auth_vdomain.pl/auth_pop3.pl and
|
---|
| 741 | find which case you are using. If you are using case b, don't forget
|
---|
| 742 | to set the $local_uid to the uid used by your vm-pop3d for all virtual
|
---|
| 743 | users.
|
---|
| 744 | ps: We suggest you use the auth_vdomain.pl for system running vm-pop3d+postfix
|
---|
| 745 | Please refer to descriptions in auth_vdomain.pl for more detail.
|
---|
| 746 |
|
---|
| 747 | ========================================================================
|
---|
| 748 | CHANGE PASSWORD
|
---|
| 749 | ========================================================================
|
---|
| 750 |
|
---|
| 751 | Q: The login is okay, but I can't change by my password with openwebmail?
|
---|
| 752 | A: There are 2 possible answers for this:
|
---|
| 753 |
|
---|
| 754 | 1. Your passwdfile is not local accessible.
|
---|
| 755 |
|
---|
| 756 | If you use auth_unix.pl for authentication
|
---|
| 757 | and your passwdfile_encrypted file is not a local accessible
|
---|
| 758 | (ex: examples in auth_unix.pl that are terminated with |),
|
---|
| 759 | the changepassword feature won't be available.
|
---|
| 760 |
|
---|
| 761 | If your system uses NIS, then you may try auth_nis.pl instead,
|
---|
| 762 | or you have to use auth_pam.pl to get the changepassword to work.
|
---|
| 763 |
|
---|
| 764 | 2. Your system doesn't support saved set-user-ID, so openwebmail won't get
|
---|
| 765 | enough privilege to change the passwd file.
|
---|
| 766 | Try to set option has_savedsuid_support to 'no' in etc/suid.conf
|
---|
| 767 | to solve this problem.
|
---|
| 768 |
|
---|
| 769 | 3. The authentication module which you used doesn't support password
|
---|
| 770 | changing, ex: auth_pop3.pl
|
---|
| 771 |
|
---|
| 772 | Q: I use openwebmail with NIS/YP system, the user can login but can not
|
---|
| 773 | change their password?
|
---|
| 774 | A: The NIS/YP password can not be changed with auth_unix.pl,
|
---|
| 775 | you need to use the auth_nis.pl or auth_pam.pl as the authentication module.
|
---|
| 776 |
|
---|
| 777 | ========================================================================
|
---|
| 778 | READ MESSAGE
|
---|
| 779 | ========================================================================
|
---|
| 780 |
|
---|
| 781 | Q: Everything seems be fine at the beginning, but if I tried to open a
|
---|
| 782 | message after a period of time, the content of other message was showed
|
---|
| 783 | instead of the one I clicked?
|
---|
| 784 | A: This is due to a bug of tell() in perl 5.8. And RedHat 8.0 bundles Perl
|
---|
| 785 | 5.8 by default. Please upgrade your openwebmail to 1.81 or higher.
|
---|
| 786 | And you should try to find a bug fix for your perl since other applications
|
---|
| 787 | written by perl may operate improperly due to this bug
|
---|
| 788 |
|
---|
| 789 | Q: Some mails were not displayed right....
|
---|
| 790 | A: please check
|
---|
| 791 | http://openwebmail.org/openwebmail/download/doc/changes.txt
|
---|
| 792 | to see if any update fixes your problem and download the
|
---|
| 793 | openwebmail-current.tar.gz
|
---|
| 794 |
|
---|
| 795 | Q: I got some messages that have attachment with filename "Unknown.tnef"
|
---|
| 796 | and contenttype "application/ms-tnef",
|
---|
| 797 | how can I extract files from this attachment?
|
---|
| 798 | A: Solution 1:
|
---|
| 799 |
|
---|
| 800 | You need to install tnef viewer in the user computer,
|
---|
| 801 | the viewer is available at http://www.ericphelps.com/tnef/
|
---|
| 802 |
|
---|
| 803 | Solution 2:
|
---|
| 804 |
|
---|
| 805 | You have to install the tnef extractor on the openwebmail server,
|
---|
| 806 | it is available at http://sourceforge.net/projects/tnef/.
|
---|
| 807 |
|
---|
| 808 | To extract the files inside a tnef attachment, the user can save the
|
---|
| 809 | attachment into openwebmail webdisk, than extract files through webdisk
|
---|
| 810 | interface.
|
---|
| 811 |
|
---|
| 812 | ps: Open WebMail has supported tnef extraction since 2.32 20040719,
|
---|
| 813 | you may see the files encapsulated in tnef attachment directly
|
---|
| 814 | without extract them in webdisk by yourself
|
---|
| 815 |
|
---|
| 816 | ========================================================================
|
---|
| 817 | COMPOSE MESSAGE
|
---|
| 818 | ========================================================================
|
---|
| 819 |
|
---|
| 820 | Q: I could not add attachments?
|
---|
| 821 | Open WebMail was hanged when I pressed the 'add' button to add attachments?
|
---|
| 822 | A: 1. Your CGI or MIME-Base64 module may be too old,
|
---|
| 823 | Please download CGI.pm-3.05.tar.gz and MIME-Base64-3.01.tar.gz in
|
---|
| 824 | http://openwebmail.org/openwebmail/download/packages/
|
---|
| 825 | and install them to your system.
|
---|
| 826 | 2. Your proxy may limit the size of a POST request.
|
---|
| 827 | Try to add attachments with no proxy setting in your browser.
|
---|
| 828 | If you are the administrator of the squid proxy server,
|
---|
| 829 | please set the request_body_max_size option to a larger value.
|
---|
| 830 |
|
---|
| 831 | Q: Attachments disappeared when I forwarded a message?
|
---|
| 832 | A: Check permission of the following directories
|
---|
| 833 | cgi-bin/openwebmail/etc - owner=root, group=mail, mode=755
|
---|
| 834 | cgi-bin/openwebmail/etc/sessions - owner=root, group=mail, mode=771
|
---|
| 835 | cgi-bin/openwebmail/etc/users - owner=root, group=mail, mode=771
|
---|
| 836 |
|
---|
| 837 | Q: The permission of cgi-bin/openwebmail/etc is correct but attachments
|
---|
| 838 | still disappeared in message forwarding?
|
---|
| 839 | A: Hmmm, please upgrade to the latest version.
|
---|
| 840 | Some very old version(1.03,1.04) has little problem in attachment handling.
|
---|
| 841 |
|
---|
| 842 | Q: I can not choose to compose HTML messages?
|
---|
| 843 | A: The HTML editor requires
|
---|
| 844 | 1. IE5.5+ on windows platform, or
|
---|
| 845 | 2. Mozilla 1.3b+ on all platforms
|
---|
| 846 |
|
---|
| 847 | Q: Is it possible to use openwebmail with browser other than IE5.5+
|
---|
| 848 | and Mozilla 1.3b+, e.g.: Opera or old Netscape?
|
---|
| 849 | A: If you are using windows platform, then you may install neadroid
|
---|
| 850 | Neptune plug-in, which will add support for IE DHTML to your browser.
|
---|
| 851 | The URL is http://www.meadroid.com/neptune/download/index.htm
|
---|
| 852 |
|
---|
| 853 | Some discussion of this plug-in is available at
|
---|
| 854 | http://www.interactivetools.com/forum/gforum.cgi?post=14116;sb=post_latest_reply;so=ASC;forum_view=forum_view_collapsed
|
---|
| 855 |
|
---|
| 856 | Q: The InserImage, InsertTable popup window don't show with correct charset?
|
---|
| 857 | A: This mostly happens with apache web server 2.0 or later.
|
---|
| 858 | Please edit your Apache Configuration file, replace
|
---|
| 859 |
|
---|
| 860 | AddDefaultCharset ISO-8859-1
|
---|
| 861 |
|
---|
| 862 | with
|
---|
| 863 |
|
---|
| 864 | AddDefaultCharset off
|
---|
| 865 |
|
---|
| 866 | Q: The InserImage, InsertTable popup window still show with correct charset
|
---|
| 867 | after I set AddDefaultCharset to off?
|
---|
| 868 | A: This is due to the web page cache of your browser.
|
---|
| 869 | Please clean the cache of your browser and try again.
|
---|
| 870 |
|
---|
| 871 | ========================================================================
|
---|
| 872 | MAIL FILTERING
|
---|
| 873 | ========================================================================
|
---|
| 874 |
|
---|
| 875 | Q: Some of my messages were moved to trash/virus/spam folder automatically?
|
---|
| 876 | A: Your messages were either filtered by 'global filter',
|
---|
| 877 | 'per user filter' or 'smart filters'.
|
---|
| 878 |
|
---|
| 879 | Global filter are rules defined in the file global_filterbook
|
---|
| 880 | (global_filterbook is defined as %ow_etcdir%/global_filterbook in
|
---|
| 881 | openwebmail.conf). By default, we will put rules that filters
|
---|
| 882 | know spammer or virus attachments in the global filter file.
|
---|
| 883 |
|
---|
| 884 | Per user filter are filter rules defined by users themselves.
|
---|
| 885 |
|
---|
| 886 | Smart filters includes repeatness filter, bad format from filter,
|
---|
| 887 | faked smtp filter, faked from filter and faked exe contenttype filter.
|
---|
| 888 |
|
---|
| 889 | The 'repeatness filter' will filter messages with same from and subject for
|
---|
| 890 | more than certain times, those messages are often from spammers or virus.
|
---|
| 891 |
|
---|
| 892 | The 'bad format from filter' will filter messages that have bad-format from
|
---|
| 893 | email address. A from email address is in bad format if
|
---|
| 894 | 1. it is started with digits
|
---|
| 895 | 2. it contains both digits and dot
|
---|
| 896 | 3. it contains characters other than alphabets, digits, dot, dash,
|
---|
| 897 | underline.
|
---|
| 898 |
|
---|
| 899 | The 'faked smtp filter' will filter messages that have a faked smtp
|
---|
| 900 | source, those messages are often from spammers.
|
---|
| 901 |
|
---|
| 902 | The 'faked from filter' will filter messages whose From: field is different
|
---|
| 903 | than the email address in the SMTP envelope address, those messages are
|
---|
| 904 | often generated from virus.
|
---|
| 905 |
|
---|
| 906 | The 'faked exe contenttype filter' will filter messages that have
|
---|
| 907 | executable attachment with faked contenttype, eg: audio, midi...
|
---|
| 908 | These messages are often generated by viruses, the browser will download
|
---|
| 909 | the attachment because its contenttype is audio and then execute the
|
---|
| 910 | downloaded file because it file extension is exe/com/bat/scr/pif/lnk.
|
---|
| 911 |
|
---|
| 912 | The three faked xxx filters are default disabled and the default can be
|
---|
| 913 | changed in openwebmail.conf. The user can also enable/disable it in
|
---|
| 914 | the user preference.
|
---|
| 915 |
|
---|
| 916 | Q: What are "messages with faked smtp"?
|
---|
| 917 | A: In short, they are messages coming from mail servers that fake their
|
---|
| 918 | name from other machines.
|
---|
| 919 |
|
---|
| 920 | Where is a message coming from?
|
---|
| 921 |
|
---|
| 922 | A message sent from machine A to machine B may have 2 cases:
|
---|
| 923 | a. A ---> M1 ---> M2 ---> B (M1, M2 are mail servers)
|
---|
| 924 | In this case, openwebmail use M1 as the from server.
|
---|
| 925 | Since most of the time, A is windows machine using outlook.
|
---|
| 926 | b A -------------------> B
|
---|
| 927 | In this case, openwebmail use A as the from server.
|
---|
| 928 |
|
---|
| 929 | How do we know if a from server fakes his name?
|
---|
| 930 |
|
---|
| 931 | Each host may have 3 names in the mail header:
|
---|
| 932 | $byas - name used by this server when saying hello to incoming connection
|
---|
| 933 | $relay - name used by this server when relaying mail through other host
|
---|
| 934 | $connectfrom - ip and name detected by other hosts resolved from DNS system
|
---|
| 935 | when receiving connection from this server
|
---|
| 936 |
|
---|
| 937 | A from host is faking his name if
|
---|
| 938 | a. $byas doesn't equal to $relay, and
|
---|
| 939 | b. $connectfrom doesn't equal to $relay, and
|
---|
| 940 | c. $connectfrom has different domain than the destitution server B, and
|
---|
| 941 | d. $connectfrom is not private IP
|
---|
| 942 |
|
---|
| 943 | Q: I still want the filtered messages, how can I disable faked smtp filter
|
---|
| 944 | and faked exe contenttype filter completely?
|
---|
| 945 | A: 1. Set default_filter_fakedsmtp and default_filter_fakedexecontenttype
|
---|
| 946 | to 'no' in openwebmail.conf. This will turn off the two filter for
|
---|
| 947 | all newly created user
|
---|
| 948 | 2. Uncheck the faked smtp filter and faked exe contenttype filter option
|
---|
| 949 | in user preference. This will disable the two filters for a specific
|
---|
| 950 | user
|
---|
| 951 | 3. you may set 'enable_smartfilter' to 'no' in openwebmail.conf
|
---|
| 952 |
|
---|
| 953 | Q: How can I disable the global filters?
|
---|
| 954 | How can I disable the per user filters?
|
---|
| 955 | How can I disable the smart filters?
|
---|
| 956 | A: You may set options like enable_globalfilter, enable_userfilter,
|
---|
| 957 | enable_smartfilter to 'no' in openwebmail.conf.help
|
---|
| 958 |
|
---|
| 959 | Q: How can I know which filter rule move my messages?
|
---|
| 960 | How to debug the mailfilter message movement?
|
---|
| 961 | A: An option debug_mailfilter is available since openwebmail20050201,
|
---|
| 962 | please set it to yes in openwebmail.conf, and you will see message
|
---|
| 963 | movement detail in logfile
|
---|
| 964 |
|
---|
| 965 | Q: Some of my messages disappeared?
|
---|
| 966 | A: Your messages may be removed by the delmail_ifquota feature.
|
---|
| 967 |
|
---|
| 968 | Q: How does the delmail_ifquotahit option work?
|
---|
| 969 | Which message will be removed first?
|
---|
| 970 | A: It will clean trash and draft first,
|
---|
| 971 | then remove oldest messages in other folders.
|
---|
| 972 | The removal will stop if the quota size is download to the 90% of user
|
---|
| 973 | quota limit.
|
---|
| 974 | ps: The messages in INBOX and user defined folders will be removed only if
|
---|
| 975 | these folders occupy the majority of the mailfolder space.
|
---|
| 976 |
|
---|
| 977 | Please refer to routine cutfolders in ow-shared.pl for detail
|
---|
| 978 |
|
---|
| 979 | Q: There were strange characters in the mail filter menu and those rules
|
---|
| 980 | could not be deleted?
|
---|
| 981 | A: This is due to the dbmopen() of your perl didn't add the ".db" extension
|
---|
| 982 | automatically, so the ~/.filter.book and its index were written to the same
|
---|
| 983 | file. This problem can be fixed by properly setting dbm options.
|
---|
| 984 |
|
---|
| 985 | perl cgi-bin/openwebmail/misc/test/dbmtest.pl [enter]
|
---|
| 986 |
|
---|
| 987 | and you will get output like this:
|
---|
| 988 |
|
---|
| 989 | dbm_ext .db
|
---|
| 990 | dbmopen_ext none
|
---|
| 991 | dbmopen_haslock no
|
---|
| 992 |
|
---|
| 993 | Then put the three lines into your etc/dbm.conf.
|
---|
| 994 |
|
---|
| 995 | ========================================================================
|
---|
| 996 | SPAMCHECK/VIRUSCHECK
|
---|
| 997 | ========================================================================
|
---|
| 998 |
|
---|
| 999 | Q: Why do I need spamcheck/viruscheck in openwebmail?
|
---|
| 1000 | Isn't it better to do these checks in MTA or mail deliver?
|
---|
| 1001 | A: You may need spamcheck/viruscheck in openwebmail for two reasons:
|
---|
| 1002 | 1. filter mechanism in MTA or mail deliver won't check messages that
|
---|
| 1003 | are fetched from remote pop3 servers
|
---|
| 1004 | 2. Spam filters in MTA won't do personalized filtering.
|
---|
| 1005 |
|
---|
| 1006 | ps: While Spam filters in local deliver can do personalized filtering,
|
---|
| 1007 | it won't check outgoing messages.
|
---|
| 1008 | So we suggest install the Spam and Virus filter in MTA level,
|
---|
| 1009 | (so both incoming and outgoing will be checked for spam and virus)
|
---|
| 1010 | then enable the spamcheck for all messages in openwebmail
|
---|
| 1011 | (so user can train the spam filter according to his own preference)
|
---|
| 1012 | and enable viruscheck for pop3 messages in openwebmail
|
---|
| 1013 | (so user won't get infected messages from remote pop3 servers)
|
---|
| 1014 |
|
---|
| 1015 | Q: What is the difference between pop3 and all when setting option
|
---|
| 1016 | viruscheck_source and spamcheck_source?
|
---|
| 1017 | A: If check source is set to pop3, pop3 messages are checked after fetching
|
---|
| 1018 | and the result is append as X-OWM-... in message header.
|
---|
| 1019 |
|
---|
| 1020 | If check source is set to all, pop3 messages are checked after fetching,
|
---|
| 1021 | and the result is append as X-OWM-... in message header.
|
---|
| 1022 |
|
---|
| 1023 | For messages without the X-OWM-... headers, which means they are not
|
---|
| 1024 | fetched from pop3 servers, and they will be checked when user want
|
---|
| 1025 | to browse the message list of the INBOX folder.
|
---|
| 1026 |
|
---|
| 1027 | Q: What is the order of the processing of viruscheck, spamcheck, global filter,
|
---|
| 1028 | perl user filter and smart filter?
|
---|
| 1029 | A: viruscheck -> filter rules (including global and user filter rules) -> spamcheck -> smart filters
|
---|
| 1030 |
|
---|
| 1031 | Q: The spamcheck is very slow, even there are only few messages in INBOX?
|
---|
| 1032 | A: Please be sure you have start the spamd with --local option
|
---|
| 1033 |
|
---|
| 1034 | Q: The spamcheck is still slow even with --local option?
|
---|
| 1035 | A: Your server may be not fast enough to do the viruschecking or spamchecking
|
---|
| 1036 | for all messages, please change the viruscheck_source_allowed and
|
---|
| 1037 | spamcheck_source_allowed to pop3, and try to add viruscheck/spamcheck
|
---|
| 1038 | to your mail system in MTA level or mail deliver.
|
---|
| 1039 |
|
---|
| 1040 | Q: My spamcheck/viruscheck/learnspam doesn't work?
|
---|
| 1041 | I see spamcheck/viruscheck/learnspam error in openwebmail.log?
|
---|
| 1042 | A: Please be sure your system has installed the spamassassin and clamav,
|
---|
| 1043 | then test spamc, sa-lean, clamdscan with the argument defined in pipecmd
|
---|
| 1044 | in openwebmail.conf.
|
---|
| 1045 | ps:You should do the test in both root and non-root account.
|
---|
| 1046 |
|
---|
| 1047 | Q: I have disabled spamcheck/viruscheck feature,
|
---|
| 1048 | but the Virus and Spam folder exist in my folder list?
|
---|
| 1049 | A: you have to set option has_virusfolder_by_default and
|
---|
| 1050 | has_spamfolder_by_default to 'no'
|
---|
| 1051 |
|
---|
| 1052 | Q: I have set option has_virusfolder_by_default and has_spamfolder_by_default
|
---|
| 1053 | to 'no', the Virus and Spam folders still exist.
|
---|
| 1054 | A: When the two options are set to 'no', it only means openwebmail doesn't
|
---|
| 1055 | treat them as default folders. (In other words, openwebmail won't creat
|
---|
| 1056 | them automatically if they doesn't exist)
|
---|
| 1057 | However, openwebmail will still list them if they already exist in
|
---|
| 1058 | ~user/mail/ after you change the options to 'no', so you may have to remove
|
---|
| 1059 | the ~user/mail/spam-mail and ~user/mail/virus-mail manually.
|
---|
| 1060 |
|
---|
| 1061 | ========================================================================
|
---|
| 1062 | SEND MESSAGE
|
---|
| 1063 | ========================================================================
|
---|
| 1064 |
|
---|
| 1065 | Q: Most functions work fine, but I could not send message.
|
---|
| 1066 | I got "Can't locate Net/SMTP.pm in @INC ..." error?
|
---|
| 1067 | I got "Internal server error"?
|
---|
| 1068 | A: Please install the libnet-1.19.tar.gz, this is required since
|
---|
| 1069 | openwebmail 1.60.
|
---|
| 1070 |
|
---|
| 1071 | Q: I am sure the sendmail was running up on my mail server, but I got
|
---|
| 1072 | "Couldn't open SMTP server 127.0.0.1" error when sending messages?
|
---|
| 1073 | A: Your sendmail may be configured to listen on the server_ip:25 only,
|
---|
| 1074 | it didn't listen on 127.0.0.1:25
|
---|
| 1075 | You can either
|
---|
| 1076 |
|
---|
| 1077 | a. override the option smtpserver in openwebmail.conf and
|
---|
| 1078 | set it to your server_ip
|
---|
| 1079 |
|
---|
| 1080 | b. modify the sendmail.cf and find the following line
|
---|
| 1081 |
|
---|
| 1082 | O DaemonPortOptions=Port=smtp,Addr=x.x.x.x, Name=MTA
|
---|
| 1083 | (where x.x.x.x is the server_ip)
|
---|
| 1084 |
|
---|
| 1085 | Please change the x.x.x.x to 0.0.0.0 to make sendmail
|
---|
| 1086 | listen on all IPs binding on the server network interfaces.
|
---|
| 1087 |
|
---|
| 1088 | Q: I still got the "Couldn't open SMTP server 127.0.0.1" error?
|
---|
| 1089 | A: Please check the permission of your /etc/protocols and /etc/services,
|
---|
| 1090 | it should be 0644. (-rw-r--r--)
|
---|
| 1091 |
|
---|
| 1092 | Q: I got 'Sorry, there was a problem sending your message' error?
|
---|
| 1093 | A: a. Please check if smtpserver option in openwebmail.conf points to valid
|
---|
| 1094 | SMTP server, its default is '127.0.0.1'. If you set it to name of some
|
---|
| 1095 | other SMTP server, please be sure the SMTP server allows mails relayed
|
---|
| 1096 | from your host.
|
---|
| 1097 | b. When SMTP server is set to 127.0.0.1, please be sure the hosts.allow
|
---|
| 1098 | has the following entry
|
---|
| 1099 |
|
---|
| 1100 | sendmail : localhost 127.0.0.1 : allow
|
---|
| 1101 |
|
---|
| 1102 | Q: Does openwebmail support SASL authentication on SMTP?
|
---|
| 1103 | A: Yes, but only the PLAIN type authentication is supported.
|
---|
| 1104 | The username/password will be encoded with base64, so it is not very secure.
|
---|
| 1105 | To enable the SASL authentication:
|
---|
| 1106 | 1. set option smtpauth to yes in openwebmail.conf
|
---|
| 1107 | 2. set the smtpauth_username, smtpauth_password in smtpauth.conf
|
---|
| 1108 |
|
---|
| 1109 | ========================================================================
|
---|
| 1110 | AUTOREPLY
|
---|
| 1111 | ========================================================================
|
---|
| 1112 |
|
---|
| 1113 | Q: The autoreply function doesn't work?
|
---|
| 1114 | A: An incoming message won't be replied by vacation.pl if
|
---|
| 1115 | 1. the destinated username has entries defined in /etc/alias which causes
|
---|
| 1116 | the mail routed to another account without calling vacation.pl
|
---|
| 1117 | 2. the destinated username doesn't not appear as an recipient in To: or Cc:
|
---|
| 1118 | 3. this message is sent by the destinated username himself
|
---|
| 1119 |
|
---|
| 1120 | If your message is not in the above 3 cases, please be sure that
|
---|
| 1121 | vacationinit and vacationpipe in openwebmail.conf have pointed to the
|
---|
| 1122 | path where the vacation program is.
|
---|
| 1123 |
|
---|
| 1124 | If the path is correct, you can do debug with the -d option
|
---|
| 1125 |
|
---|
| 1126 | 1. add the '-d' parameter to the vacationpipe in openwebmail.conf
|
---|
| 1127 | like below
|
---|
| 1128 |
|
---|
| 1129 | vacationpipe /usr/local/www/cgi-bin/openwebmail/vacation.pl -d -t60s
|
---|
| 1130 |
|
---|
| 1131 | 2. choose a user, enable his autoreply in openwebmail user preference
|
---|
| 1132 | 3. check the ~user/.forward file, the '-d' option should appear after
|
---|
| 1133 | vacation.pl
|
---|
| 1134 | 4. send a message to this user to test the autoreply
|
---|
| 1135 | 5. check the /tmp/vacation.debug for possible error information
|
---|
| 1136 |
|
---|
| 1137 | Q: When I enable autoreply feature, others get "Returned mail: see
|
---|
| 1138 | transcript for details" instead of my autoreply message?
|
---|
| 1139 | A: Your sendmail may be configured with Sendmail Restricted SHell or smrsh.
|
---|
| 1140 | vacation.pl file needs to be added to smrsh.
|
---|
| 1141 |
|
---|
| 1142 | If you are using RedHat 7.1, you may link vacation.pl to /etc/smrsh/
|
---|
| 1143 |
|
---|
| 1144 | cd /etc/smrsh
|
---|
| 1145 | ln -s /var/www/cgi-bin/openwebmail/vacation.pl /etc/smrsh/vacation.pl
|
---|
| 1146 | (thanks to Emir Litric, elitric.AT.yahoo.com)
|
---|
| 1147 |
|
---|
| 1148 | ========================================================================
|
---|
| 1149 | SPELLCHECK
|
---|
| 1150 | ========================================================================
|
---|
| 1151 |
|
---|
| 1152 | Q: When I clicked 'spell check' button, I got "Internal Server error" in new
|
---|
| 1153 | window?
|
---|
| 1154 | A: 1. Please upgrade your openwebmail to 2003/11/16 or later.
|
---|
| 1155 | 2. If you are using C wrappers for suid scripts on Solaris,
|
---|
| 1156 | please recompile you perl with suid enabled instead of using
|
---|
| 1157 | the C wrappers.
|
---|
| 1158 | (thanks to Isam Ishaq, isam.AT.planet.edu)
|
---|
| 1159 | 3. Please check the apache error log for more information
|
---|
| 1160 |
|
---|
| 1161 | Q: I can use aspell for spelling check, but personal dictionary doesn't work?
|
---|
| 1162 | A: 1. Please upgrade your openwebmail to 2003/11/16 or later.
|
---|
| 1163 | 2. If you are using aspell, please be sure your homedir is group readable.
|
---|
| 1164 | Yes, this is strange, but it seems aspell need this.
|
---|
| 1165 | (thanks Scott A. Mazur, scott.AT.littlefish.ca)
|
---|
| 1166 | 3. If you don't want to change the directory permission.
|
---|
| 1167 | Please set option has_savedsuid_support to 'no' in etc/suid.conf
|
---|
| 1168 | 4. If you don't want to set option either, you may try to use ispell
|
---|
| 1169 | instead of aspell
|
---|
| 1170 |
|
---|
| 1171 | Q: Why is openwebmail-spell.pl a suid root program?
|
---|
| 1172 | A: Because it needs to read the preference file, ~/.openwebmai/openwebmailrc
|
---|
| 1173 | of different users to get their language and dictionary setting.
|
---|
| 1174 |
|
---|
| 1175 | ========================================================================
|
---|
| 1176 | ADDRESSBOOK
|
---|
| 1177 | ========================================================================
|
---|
| 1178 | Q: I got "Too many arguments for MIME::QuotedPrint::encode_qp"?
|
---|
| 1179 | A: Your MIME module is too old, please install the MIME-Base64-3.01.tar.gz.
|
---|
| 1180 |
|
---|
| 1181 | Q: The content of my global addressbook is gone after I upgrade my openwebmail?
|
---|
| 1182 | A: No, it is still there.
|
---|
| 1183 |
|
---|
| 1184 | The filename, location and format of openwebmail addressbook has been changes
|
---|
| 1185 | since 2.41-20041030. While user personal addressbooks will be converted
|
---|
| 1186 | automatically at user login, the global addressbook will be converted only if
|
---|
| 1187 | it is specified by sysadm explicitly.
|
---|
| 1188 |
|
---|
| 1189 | To convert the global addressbook:
|
---|
| 1190 |
|
---|
| 1191 | cd your_cgi-bin/openwebmail
|
---|
| 1192 | openwebmail-tool.pl -c
|
---|
| 1193 |
|
---|
| 1194 | Q: Can I have multiple personal addressbooks?
|
---|
| 1195 | A: Yes, each user can create as many addressbooks as he want through the
|
---|
| 1196 | addressbooks web management menu
|
---|
| 1197 |
|
---|
| 1198 | Q: Can I have multiple global addressbooks?
|
---|
| 1199 | A: Yes, but this could not be done in web interface,
|
---|
| 1200 | you have to goto directory specified by option ow_addressbooksdir
|
---|
| 1201 | (eg: cgi-bin/openwebmail/etc/addressbooks)
|
---|
| 1202 | then use 'touch new_addressbooks_filename' to create empty global addressbook.
|
---|
| 1203 | Be sure the permission is right so other users can read it.
|
---|
| 1204 |
|
---|
| 1205 | Q: Can I edit the global addressbooks?
|
---|
| 1206 | Which user can edit global addressbooks?
|
---|
| 1207 | A: Yes, if the option abook_globaleditable is set to yes
|
---|
| 1208 | and the user has enough privilege to write the global addressbook file,
|
---|
| 1209 | then he can add, delete or modify the contacts within that gobal addressbook.
|
---|
| 1210 |
|
---|
| 1211 | ========================================================================
|
---|
| 1212 | CALENDAR
|
---|
| 1213 | ========================================================================
|
---|
| 1214 |
|
---|
| 1215 | Q: Everything works fine, but I got timeout when clicking the calendar button?
|
---|
| 1216 | A: Please check your apache error log if it has lines like below:
|
---|
| 1217 |
|
---|
| 1218 | [...] openwebmail-cal.pl: Use of uninitialized value in subroutine entry
|
---|
| 1219 | at /usr/lib/perl5/5.8.0/i386-linux-thread-multi/DB_File.pm line xxx.
|
---|
| 1220 |
|
---|
| 1221 | If yes, please search the RUNTIME ERROR section with keyword DB_File.pm
|
---|
| 1222 |
|
---|
| 1223 | Q: The email notification for calendar event doesn't work?
|
---|
| 1224 | A: You need to use openwebmail-tool.pl in crontab to check the calendar
|
---|
| 1225 | events for sending the notification emails. For example:
|
---|
| 1226 |
|
---|
| 1227 | 0 */2 * * * /usr/local/www/cgi-bin/openwebmail/openwebmail-tool.pl -a -n -q
|
---|
| 1228 |
|
---|
| 1229 | The above line will use openwebmail-tool.pl to check the calendar
|
---|
| 1230 | events for all users every two hours. Please note we use this
|
---|
| 1231 | frequency because the default value of option calendar_email_notifyinterval
|
---|
| 1232 | is 120 (minute). You have to set the crontab according to your
|
---|
| 1233 | calendar_email_notifyinterval.
|
---|
| 1234 |
|
---|
| 1235 | ========================================================================
|
---|
| 1236 | SSL RELATED
|
---|
| 1237 | ========================================================================
|
---|
| 1238 |
|
---|
| 1239 | Q: Can I use openwebmail with SSL?
|
---|
| 1240 | A: yes. just https:// instead of http:// for the URL of webmail
|
---|
| 1241 |
|
---|
| 1242 | Q: I got "site not found" or "could not connect to the server" error?
|
---|
| 1243 | A: Yes, openwebmail can work with SSL.
|
---|
| 1244 | The error is due to IE doesn't do keepalives correctly when using SSL.
|
---|
| 1245 |
|
---|
| 1246 | Please add the following line to your Apache configuration for SSL
|
---|
| 1247 | (or VirtualHost container)
|
---|
| 1248 |
|
---|
| 1249 | SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown
|
---|
| 1250 | (thanks to Happy Camper, hcamper.AT.users.sourceforge.net)
|
---|
| 1251 |
|
---|
| 1252 | Q: Can I use openwebmail with SSL on multiple virtual domains on one server?
|
---|
| 1253 | A: Since apache only allow SSL for one virtual domain, you can have only one
|
---|
| 1254 | https url. To use virtual domain other than the one specified in https,
|
---|
| 1255 | you have to specify the virtual domain in URL when link to login webpage
|
---|
| 1256 |
|
---|
| 1257 | https://sample.com/openwebmail/openwebmail.pl?logindomain=vdomain1.com
|
---|
| 1258 | (thanks to scott.AT.littlefish.ca for his code)
|
---|
| 1259 |
|
---|
| 1260 | ========================================================================
|
---|
| 1261 | MISC PROBLEMS
|
---|
| 1262 | ========================================================================
|
---|
| 1263 |
|
---|
| 1264 | Q: The help tutorial doesn't show with correct charset?
|
---|
| 1265 | A: This mostly happens with apache web server 2.0 or later.
|
---|
| 1266 | Please edit your Apache Configuration file, replace
|
---|
| 1267 |
|
---|
| 1268 | AddDefaultCharset ISO-8859-1
|
---|
| 1269 |
|
---|
| 1270 | with
|
---|
| 1271 |
|
---|
| 1272 | AddDefaultCharset off
|
---|
| 1273 |
|
---|
| 1274 | Q: The DayLight Saving option in user preference doesn't work,
|
---|
| 1275 | messages in folders still have wrong date in folderlist view?
|
---|
| 1276 | A: This is due to those messages were parsed at the time that DST option
|
---|
| 1277 | was set to wrong value, the problem could be solved by
|
---|
| 1278 |
|
---|
| 1279 | 1. set DST to auto
|
---|
| 1280 | 2. goto folder management
|
---|
| 1281 | 3. choose 'recreate index' for your folders.
|
---|
| 1282 |
|
---|
| 1283 | ps: This could be quite time-consuming if you have large folder,
|
---|
| 1284 | you may do it with openwebmail-tools.pl in background.
|
---|
| 1285 |
|
---|
| 1286 | Q: Is the 'filename search' in webdisk case sensitive or case insensitive?
|
---|
| 1287 | A: If the 'find' command in your unix supports -iname, the search will be
|
---|
| 1288 | case insensitive. Or it will be case sensitive.
|
---|
| 1289 |
|
---|
| 1290 | Q: Why the 'content search' in webdisk searches files in current directory
|
---|
| 1291 | only?
|
---|
| 1292 | A: The file content search is done with the unix command 'grep'.
|
---|
| 1293 | If the 'grep' in your unix supports -r, the search will search current
|
---|
| 1294 | directory and all its sub directories recursively. Or it will search files
|
---|
| 1295 | in current directory only.
|
---|
| 1296 |
|
---|
| 1297 | Q: The ssh terminal in openwebmail supports SSH1 only?
|
---|
| 1298 | A: Yes. The ssh terminal support in openwebmail is actually done with the
|
---|
| 1299 | MindTerm package from www.appgate.com. The bundled MindTerm is 1.21,
|
---|
| 1300 | which is the latest GPLed release but quite old.
|
---|
| 1301 |
|
---|
| 1302 | You may install MindTerm version 2.3.1 from www.appgate.com, which
|
---|
| 1303 | supports both SSH1 and SSH2. Please refer to
|
---|
| 1304 | data/openwebmail/applet/mindterm2/INSTALL.MINDTERM2 for more detail.
|
---|
| 1305 |
|
---|
| 1306 | ========================================================================
|
---|
| 1307 | SPEED TUNING
|
---|
| 1308 | ========================================================================
|
---|
| 1309 |
|
---|
| 1310 | Q: Will it speedup the login if the GNU copyright page is removed?
|
---|
| 1311 | A: The GNU copyright page should be displayed for less than 1 second.
|
---|
| 1312 | if you see it for a very long time after you login, then openwebmail
|
---|
| 1313 | is busy in processing your INBOX folder (eg: mail indexing, filtering,
|
---|
| 1314 | trash cleaning..)
|
---|
| 1315 |
|
---|
| 1316 | Q: My openwebmail is slow, how can I make it faster?
|
---|
| 1317 | A: You may try to use Open WebMail with the SpeedyCGI package, you will
|
---|
| 1318 | get about 5x-10x speedup. Please refer to the readme.txt with keyword
|
---|
| 1319 | SpeedyCGI for more detail.
|
---|
| 1320 |
|
---|
| 1321 | Q: How SpeedyCGI speeds up Open WebMail?
|
---|
| 1322 | A: SpeedyCGI makes Open WebMail resident in memory at the first request,
|
---|
| 1323 | then the following requests will be served immediately without the
|
---|
| 1324 | overhead of starting perl CGI.
|
---|
| 1325 |
|
---|
| 1326 | This resident copy will terminate if it is idle for a certain time,
|
---|
| 1327 | the default is 3600 seconds (1 hour)
|
---|
| 1328 | You can set this with -t option in the Open WebMail scripts.
|
---|
| 1329 |
|
---|
| 1330 | eg: #!/usr/bin/speedy -T -- -t7200
|
---|
| 1331 |
|
---|
| 1332 | Q: Will the resident Open Webmail become larger and larger and finally
|
---|
| 1333 | a memory hog?
|
---|
| 1334 | A: No. We have tried our best to remove any memory leak from Open WebMail.
|
---|
| 1335 | And a resident CGI will be restarted after it has served certain
|
---|
| 1336 | number of requests. The default maxrun number is 500.
|
---|
| 1337 | You can set this with -r option in the Open WebMail scripts.
|
---|
| 1338 |
|
---|
| 1339 | eg: #!/usr/bin/speedy -T -- -t7200 -r250
|
---|
| 1340 |
|
---|
| 1341 | Q: Some files of name like 'speedy.10.0.50.S' appear in my system /tmp?
|
---|
| 1342 | A: They are the temporary files used by speedy and its backend program.
|
---|
| 1343 | Please don't remove them. If you hope to put them in other location,
|
---|
| 1344 | You can set the prefix of temporary files with -T option
|
---|
| 1345 |
|
---|
| 1346 | eg: #!/usr/bin/speedy -T -- -t7200 -r250 -T/var/tmp/.speedy
|
---|
| 1347 |
|
---|
| 1348 | Q: Open WebMail is fast when it is resident in memory, but the firsttime
|
---|
| 1349 | startup delay is still long, is it possible to hide that delay from user?
|
---|
| 1350 | A: You can use the script preload.pl to preload openwebmail scripts,
|
---|
| 1351 | so the webmail user won't see the startup delay.
|
---|
| 1352 |
|
---|
| 1353 | 1. through web interface
|
---|
| 1354 | http://your_server/cgi-bin/openwebmail/preload.pl
|
---|
| 1355 | Please refer to preload.pl for default password and how to change it.
|
---|
| 1356 |
|
---|
| 1357 | 2. through command line or you can put the following line in crontab
|
---|
| 1358 | to preload the most frequently used scripts into memory
|
---|
| 1359 |
|
---|
| 1360 | 0 * * * * /usr/local/www/cgi-bin/openwebmail/preload.pl -q openwebmail.pl openwebmail-main.pl openwebmail-read.pl
|
---|
| 1361 |
|
---|
| 1362 | If your machine has a lot of memory, you may choose to preload all
|
---|
| 1363 | openwebmail scripts
|
---|
| 1364 |
|
---|
| 1365 | 0 * * * * /usr/local/www/cgi-bin/openwebmail/preload.pl -q --all
|
---|
| 1366 |
|
---|
| 1367 | Q: I got "connect error" when using preload.pl?
|
---|
| 1368 | A: The preload.pl tries to connect the webmail server on localhost.
|
---|
| 1369 | Please check if your webserver is binding on localhost or
|
---|
| 1370 | change the variable $httphost in preload.pl
|
---|
| 1371 |
|
---|
| 1372 | Q: How do I know if my Open WebMail is running under SpeedyCGI?
|
---|
| 1373 | A: 1. Goto the user preference and click the 'about' button,
|
---|
| 1374 | if you see word 'Persistence' appear in the line of webmail,
|
---|
| 1375 | then your openwebmail is running under SpeedyCGI
|
---|
| 1376 | 2. Check the top of webmail page window border,
|
---|
| 1377 | if you see a '+' appear after the 'Open WebMail' string,
|
---|
| 1378 | then the page is generated under SpeedyCGI.
|
---|
| 1379 |
|
---|
| 1380 | Q: I saw a HTTP compression checkbox in login screen, what is it used for?
|
---|
| 1381 | A: When it is checked, web pages generated by Open WebMail will be
|
---|
| 1382 | transmitted in gzip compressed format, this greatly reduces the time
|
---|
| 1383 | required for page download.
|
---|
| 1384 |
|
---|
| 1385 | This is very useful for users with slow connection. An rough experiment
|
---|
| 1386 | showed that the compressed format is about only 10% in size compared with
|
---|
| 1387 | the original web page.
|
---|
| 1388 |
|
---|
| 1389 | Q: I could not check the HTTP compression checkbox, it is always disabled?
|
---|
| 1390 | A: The HTTP compression feature won't be available if any one of the three
|
---|
| 1391 | components (web server, web proxy, web browser) doesn't support HTTP
|
---|
| 1392 | compression.
|
---|
| 1393 |
|
---|
| 1394 | To enable the HTTP compression support:
|
---|
| 1395 |
|
---|
| 1396 | 1. Please install the Compress-Zlib-1.33.tar.gz on openwebmail server
|
---|
| 1397 | 2. Please enable "HTTP 1.1 support for direct connection" in your browser
|
---|
| 1398 | 3. If your connect to openwebmail server through proxy server,
|
---|
| 1399 | please enable "HTTP 1.1 support over proxy" in your browser.
|
---|
| 1400 | 4. If the proxy server doesn't support HTTP 1.1,
|
---|
| 1401 | please list your openwebmail server in exclusion table of proxy setting
|
---|
| 1402 | in your browser.
|
---|
| 1403 |
|
---|
| 1404 | Q: How do I know if my Open WebMail is running with HTTP compression enabled?
|
---|
| 1405 | A: 1. Goto the user preference and click the 'about' button,
|
---|
| 1406 | if you see word 'HTTP Compression' appear in the line of webmail,
|
---|
| 1407 | then your openwebmail is running with HTTP compression enabled
|
---|
| 1408 | 2. Check the top of webmail page window border,
|
---|
| 1409 | if you see a 'z' appear after the 'Open WebMail' string,
|
---|
| 1410 | then the page is generated with HTTP compression enabled.
|
---|
| 1411 |
|
---|
| 1412 | Q: Openwebmail uses lot of static images.
|
---|
| 1413 | How can I avoid them being loaded frequently?
|
---|
| 1414 | How can I extend the cache expire time for the static images?
|
---|
| 1415 | A: Most web servers will set expire time in http header for static objects
|
---|
| 1416 | based on their file date and the time the files are accessed.
|
---|
| 1417 |
|
---|
| 1418 | If you would like to set the expire time explicitly:
|
---|
| 1419 |
|
---|
| 1420 | Please add the following line to the end of your Apache configuration
|
---|
| 1421 |
|
---|
| 1422 | <Directory "/usr/local/www/data/openwebmail">
|
---|
| 1423 | ExpiresActive On
|
---|
| 1424 | ExpiresByType image/gif A86400
|
---|
| 1425 | ExpiresByType image/png A86400
|
---|
| 1426 | ExpiresByType image/jpg A86400
|
---|
| 1427 | ExpiresByType application/x-javascript A86400
|
---|
| 1428 | </Directory>
|
---|
| 1429 |
|
---|
| 1430 | The above lines set an expire time to one day for jpg, gif, png and
|
---|
| 1431 | javascript files under openwebmail from the time they are accessed.
|
---|
| 1432 |
|
---|
| 1433 | ps: Don't forget to change the above /usr/local/www/data/openwebmail
|
---|
| 1434 | to where your openwebmail data locates.
|
---|
| 1435 |
|
---|
| 1436 | Q: Any other way to get more speedup?
|
---|
| 1437 | A: You may try the thttpd at http://www.acme.com/software/thttpd/,
|
---|
| 1438 | here are some words from their web site :)
|
---|
| 1439 |
|
---|
| 1440 | "thttpd is a simple, small, portable, fast, and secure HTTP server"
|
---|
| 1441 |
|
---|
| 1442 | "It also has a very small run-time size, since it does not fork and
|
---|
| 1443 | is very careful about memory allocation. "
|
---|
| 1444 |
|
---|
| 1445 | "In typical use it's about as fast as the best full-featured servers
|
---|
| 1446 | (Apache, NCSA, Netscape). Under extreme load it's much faster."
|
---|
| 1447 |
|
---|
| 1448 | Please refer to doc/thttpd.txt for some installation tips.
|
---|
| 1449 |
|
---|
| 1450 |
|
---|
| 1451 | ========================================================================
|
---|
| 1452 | SOME CONCEPT
|
---|
| 1453 | ========================================================================
|
---|
| 1454 |
|
---|
| 1455 | Q: What will happen at webmail server if I click the stop key in browser?
|
---|
| 1456 | A: When the stop key is pressed, the browser will close its connection to
|
---|
| 1457 | the httpd on webmail server. While httpd detects this immediately,
|
---|
| 1458 | what will httpd do to the CGI process is implementation dependent.
|
---|
| 1459 | Basically, httpd will close the pipes to CGI process and terminate the
|
---|
| 1460 | CGI process.
|
---|
| 1461 |
|
---|
| 1462 | Below is our observation on apache 1.3.26 on FreeBSD.
|
---|
| 1463 |
|
---|
| 1464 | The apache httpd won't terminate nor close the connection to the CGI
|
---|
| 1465 | process until the CGI process sends output to its stdout. This gives
|
---|
| 1466 | the chance to CGI process to finish its job in a more graceful way.
|
---|
| 1467 |
|
---|
| 1468 | When httpd receives some data from CGI process stdout (which actually
|
---|
| 1469 | pipes to stdin of httpd), the httpd will send a 'TERM' signal to CGI
|
---|
| 1470 | process, close the pipes to CGI process, then kill the CGI process.
|
---|
| 1471 |
|
---|
| 1472 | The situation is a little bit different if the CGI program is running
|
---|
| 1473 | with SpeedyCGI. From the point of view of httpd, the speedycgi frontend
|
---|
| 1474 | is the CGI process, so the frontend will be terminated as the above
|
---|
| 1475 | when it tries to pass the data coming from the speedy_backend to httpd.
|
---|
| 1476 | The data is result generated by real CGI process forked by speedy_backend.
|
---|
| 1477 |
|
---|
| 1478 | When the speedy_backend detects the termination of the speedy frontend,
|
---|
| 1479 | it will close the pipes to the real CGI process, but won't send TERM
|
---|
| 1480 | signal to it nor kill it.
|
---|
| 1481 |
|
---|
| 1482 | In both case (without or with speedycgi), the CGI process will get a
|
---|
| 1483 | signal PIPE if it tries to output data to stdout after the related
|
---|
| 1484 | pipe has been closed.
|
---|
| 1485 |
|
---|
| 1486 | Now, what openwebmail do with this?
|
---|
| 1487 | Since version 2.00, all stdout output code has been move to the end of the
|
---|
| 1488 | request processing in openwebmail, this ensures the data being processed
|
---|
| 1489 | will be always in a complete state and not terminated because of PIPE error.
|
---|
| 1490 |
|
---|
| 1491 | Q: How is the domain of a login user determined?
|
---|
| 1492 | A: It is determined in the following order
|
---|
| 1493 | (the earlier one has higher precedence)
|
---|
| 1494 | 1. from the login name
|
---|
| 1495 | eg: the user logined with username@virtualdomain
|
---|
| 1496 | 2. from the parameter 'logindomain' specified in login page url
|
---|
| 1497 | eg: the login page was linked with
|
---|
| 1498 | http://server/cgi-bin/openwebmail/openwebmail.pl?logindomain=virtualdomain
|
---|
| 1499 | 3. from the servername specified in the login page url
|
---|
| 1500 | eg: the login page was linked with
|
---|
| 1501 | http://virtualdomain/cgi-bin/openwebmail/openwebmail.pl
|
---|
| 1502 |
|
---|
| 1503 | Q: How does the delfile_ifquotahit option work?
|
---|
| 1504 | Which file will be removed first?
|
---|
| 1505 | A: It will remove the oldest files or directories under the webdiskrootdir
|
---|
| 1506 | (webdiskrootdir is default to / of user homedir, but you can change it).
|
---|
| 1507 | The removal will stop if the quota size is download to the 90% of user
|
---|
| 1508 | quota limit.
|
---|
| 1509 |
|
---|
| 1510 | Q: What is the difference between 'Forward', 'ForwardAsAtt', 'ForwardAsOrig'
|
---|
| 1511 | A: If A send msg1 to B,
|
---|
| 1512 | and B forward this msg as msg2 to B
|
---|
| 1513 |
|
---|
| 1514 | forward:
|
---|
| 1515 | the subject of msg2 will be the subject of msg1 with a prefix "Fw:".
|
---|
| 1516 | msg2 will have all attachments and content of msg1,
|
---|
| 1517 | and headers of msg1 will be put into the body msg2 as content
|
---|
| 1518 |
|
---|
| 1519 | forwardasatt:
|
---|
| 1520 | the subject of msg2 will be the subject of msg1 with a prefix "Fw:".
|
---|
| 1521 | msg2 body will be empty
|
---|
| 1522 | and the raw format of msg1 will be become an attachment of msg2.
|
---|
| 1523 |
|
---|
| 1524 | forwardasorig:
|
---|
| 1525 | the subject, body and attachments of msg2 will exactly the same as msg1.
|
---|
| 1526 | the replyto header of msg2 will be set to A.
|
---|
| 1527 | So in case C replies the msg2, the reply will go back to A
|
---|
| 1528 |
|
---|
| 1529 | Q: When I checked 'edit folder menu', I found some folders were empty but
|
---|
| 1530 | took disk space?
|
---|
| 1531 | A: The disk space occupied by a folder shown in 'edit folder menu' includes
|
---|
| 1532 | the size of a folder and its index. Though folder is empty, the folder
|
---|
| 1533 | index still has some data structure to maintain.
|
---|
| 1534 |
|
---|
| 1535 | ========================================================================
|
---|
| 1536 | HOW CAN I...
|
---|
| 1537 | ========================================================================
|
---|
| 1538 |
|
---|
| 1539 | Q: How can I move old messages in my mail client into openwebmail folders?
|
---|
| 1540 | A: a. If your mail client program supports IMAP and your mail server has
|
---|
| 1541 | imapd installed, you may move old messages in the mail client to
|
---|
| 1542 | remote folders on mail server through the IMAP protocol.
|
---|
| 1543 | Be sure to put the folders under ~/mail so openwebmail can find them
|
---|
| 1544 | automatically.
|
---|
| 1545 | b. Some mail client stores or can export messages into unix mbox format
|
---|
| 1546 | folder file.(eg: Eudora) You can just upload the mbox file to the
|
---|
| 1547 | ~/mail/ and openwebmail will find them automatically.
|
---|
| 1548 |
|
---|
| 1549 | ps: If your folder file is in dos text format, you may need use the
|
---|
| 1550 | following command to stripe out the \r at each end of line.
|
---|
| 1551 |
|
---|
| 1552 | perl -pi -e "s/\r\n/\n/" folderfile
|
---|
| 1553 |
|
---|
| 1554 | Q: How can I upgrade from old version of Open Webmail?
|
---|
| 1555 | A: Each version of openwebmail is made to be backward compatible with
|
---|
| 1556 | old ones, no user setting or mail message will be lost after upgrade.
|
---|
| 1557 | The upgrade steps:
|
---|
| 1558 | 1. make a copy of your old openwebmail.conf
|
---|
| 1559 | 2. install new openwebmail in the same location as old version
|
---|
| 1560 | 3. update the new openwebmail.conf with the setting in old one.
|
---|
| 1561 |
|
---|
| 1562 | Q: How can I report problem?
|
---|
| 1563 | A: If your Open WebMail doesn't work, please post your problem on
|
---|
| 1564 | openwebmail forum http://sourceforge.net/forum/forum.php?forum_id=108433
|
---|
| 1565 | with the following information
|
---|
| 1566 |
|
---|
| 1567 | OS
|
---|
| 1568 | Perl Version
|
---|
| 1569 | your openwebmail.conf
|
---|
| 1570 | the ls -l of the perl executable used in your openwebmail.pl
|
---|
| 1571 | the ls -l of your cgi-bin/openwebmail and cgi-bin/openwebmail/etc
|
---|
| 1572 | the ls -la of the ~user/mail/
|
---|
| 1573 | the error message in your browser
|
---|
| 1574 | the error message in your http server error log
|
---|
| 1575 | the error message in openwebmail.log
|
---|
| 1576 | you browser name & version
|
---|
| 1577 | do you enable speedycgi?
|
---|
| 1578 | do you set any proxy server in browser?
|
---|
| 1579 |
|
---|
| 1580 | If your Open WebMail works but it shows strange output for some messages,
|
---|
| 1581 | please forward the message as an attachment to us
|
---|
| 1582 | (openwebmail.AT.turtle.ee.ncku.edu.tw)
|
---|
| 1583 | ps: clicking the 'forward as attachment' icon in message reading menu
|
---|
| 1584 |
|
---|
| 1585 | Q: How can I debug the Open WebMail by myself?
|
---|
| 1586 | A: First, you can try to set option error_with_debuginfo to yes in
|
---|
| 1587 | openwebmail.conf. This would give you more detailed information in case
|
---|
| 1588 | openwebmailerror() happens.
|
---|
| 1589 |
|
---|
| 1590 | Second, if you want to have a stack trace of how openwebmail is running,
|
---|
| 1591 | you may use the misc/test/debugadd.pl to add debugging code to openwebmail
|
---|
| 1592 | scripts
|
---|
| 1593 |
|
---|
| 1594 | 1. cd cgi-bin/openwebmail/
|
---|
| 1595 | 2. perl misc/test/debugadd.pl *pl
|
---|
| 1596 |
|
---|
| 1597 | Then use openwebmail as normal, all sub routine calls will be logged into
|
---|
| 1598 | /tmp/openwebmail.debug with timestamp. It should be helpful in debugging.
|
---|
| 1599 |
|
---|
| 1600 | While you finish the debugging, you have to use misc/test/debugdel.pl to
|
---|
| 1601 | remove debugging code from those scripts
|
---|
| 1602 | 1. cd cgi-vin/openwebmail/
|
---|
| 1603 | 2. perl misc/test/debugdel.pl *pl
|
---|
| 1604 |
|
---|
| 1605 | Third, you may try to add lines like below to openwebmail scripts to log
|
---|
| 1606 | some runtime information to /tmp/openwebmail.debug
|
---|
| 1607 |
|
---|
| 1608 | ow::tool::log_time("$variablename");
|
---|
| 1609 | ow::tool::log_time(ow::tool::stacktrace("$variablename and some other string"));
|
---|
| 1610 |
|
---|
| 1611 | Q: Can I specify the composemessage menu as the openwebmail default?
|
---|
| 1612 | A: You can call the openwebmail with url
|
---|
| 1613 | http://server/openwebmail.pl?action=composemessage&to=EMAIL&subject=SUBJECT
|
---|
| 1614 |
|
---|
| 1615 | Q: Can I specify the calendar month view as the openwebmail default?
|
---|
| 1616 | A: You can call the openwebmail with url
|
---|
| 1617 | http://server/openwebmail.pl?action=calmonth
|
---|
| 1618 |
|
---|
| 1619 | Q: Can I specify the calendar day view as the openwebmail default?
|
---|
| 1620 | A: You can call the openwebmail with url
|
---|
| 1621 | http://server/openwebmail.pl?action=calday
|
---|
| 1622 |
|
---|
| 1623 | Q: Can I specify the webdisk as the openwebmail default?
|
---|
| 1624 | A: You can call the openwebmail with url
|
---|
| 1625 | http://server/openwebmail.pl?action=showdir
|
---|
| 1626 |
|
---|
| 1627 | Q: Can I call openwebmail from my programs with username/password specified?
|
---|
| 1628 | A: this is a little dangerous since the loginname and password will
|
---|
| 1629 | be displayed on the URL line of the user's browser.
|
---|
| 1630 |
|
---|
| 1631 | You can call the openwebmail with url
|
---|
| 1632 | http://server/openwebmail.pl?loginname=USER&password=PASS
|
---|
| 1633 | or even with action specified
|
---|
| 1634 | http://server/openwebmail.pl?action=calmonth&loginname=USER&password=PASS
|
---|
| 1635 |
|
---|
| 1636 | ps: Openwebmail supports autologin since 2004/06/01, users doesn't have to
|
---|
| 1637 | input username/password at login if he didn't logout his previous session
|
---|
| 1638 | and that previous session is not timeouted.
|
---|
| 1639 |
|
---|
| 1640 | Q: Can I get the mail/event status of a user before he logins openwebmail?
|
---|
| 1641 | How can I get the username before user really types it?
|
---|
| 1642 | A: If a user has ever successfully logined into openwebmail, the loginname
|
---|
| 1643 | will be stored to cookie "ow-loginname" at the browser side.
|
---|
| 1644 | The following CGI script demonstrates how to use this information.
|
---|
| 1645 | -----------------------------------------
|
---|
| 1646 | #!/usr/bin/perl
|
---|
| 1647 | use CGI qw(-private_tempfiles :standard);
|
---|
| 1648 | print "Content-type: text/html\n\n";
|
---|
| 1649 | my $info;
|
---|
| 1650 | my $loginname = cookie("ow-loginname");
|
---|
| 1651 | $loginname=~s/[^\w\d\.\-\%\@]//g; # remove dangerous char
|
---|
| 1652 | if ($loginname ne "") {
|
---|
| 1653 | $info=`/usr/local/www/cgi-bin/openwebmail/openwebmail-tool.pl -m -e $loginname`;
|
---|
| 1654 | }
|
---|
| 1655 | print $info;
|
---|
| 1656 | ------------------------------------------
|
---|
| 1657 |
|
---|
| 1658 | Q: I already have a web application XYZ which would do authentication on user,
|
---|
| 1659 | how can I integrate openwebmail with it so the user of XYZ doesn't need to
|
---|
| 1660 | login again when click the openwebmail link?
|
---|
| 1661 | A: All you have to do is writing an auth_XYZ.pl for openwebmail.
|
---|
| 1662 |
|
---|
| 1663 | The auth_XYZ.pl should check if the user USERNAME has already logined into
|
---|
| 1664 | application XYZ by verifying related session file or cookies.
|
---|
| 1665 | If yes, routine check_userpassword() in auth_XYZ.pl should return 1;
|
---|
| 1666 | if not, the routine should return 0
|
---|
| 1667 |
|
---|
| 1668 | Then you specify auth_XYZ,pl as authentication module in openwebmail.conf
|
---|
| 1669 | And the link to call the openwebmail.pl should be
|
---|
| 1670 | http:/xxxx/openwebmail.pl?loginname=USERNAME&password=dummy
|
---|
| 1671 |
|
---|
| 1672 | ps: you may modify the check_userpassword() in auth module that you already
|
---|
| 1673 | use in openwebmail as a start.
|
---|
| 1674 |
|
---|
| 1675 | Q: How can I setup IE to trigger Open WebMail compose window when I click
|
---|
| 1676 | a "mailto:someone@somehost" link?
|
---|
| 1677 | How can I set Open Webmail as the default mail client?
|
---|
| 1678 | A: In Windows Explorer, if you go to Tools -> Folder Options, click on the
|
---|
| 1679 | File Types tab. In the window that appears, scroll down the list to the
|
---|
| 1680 | entry for "URL:MailTo Protocol". Highlight URL:MailTo and click edit.
|
---|
| 1681 |
|
---|
| 1682 | Choose to edit the action for open. By default it probably has a
|
---|
| 1683 | command to open Outlook Express (or your default email client).
|
---|
| 1684 | Change the Application to read:
|
---|
| 1685 | "C:\program files\internet explorer\iexplore.exe" http://your_server/cgi-bin/openwebmail/openwebmail.pl?loginname=NAME&password=PASSWORD
|
---|
| 1686 |
|
---|
| 1687 | This will make Windows open Internet Explorer and go directly to the .pl
|
---|
| 1688 | page and login with the specified user and pass.
|
---|
| 1689 |
|
---|
| 1690 | (Thanks to Mike Andrews, mike.AT.lcso.org)
|
---|
| 1691 |
|
---|
| 1692 | If you hope to goto the compose window directly
|
---|
| 1693 | with the email address put in the To field,
|
---|
| 1694 | please use the following open string instead
|
---|
| 1695 |
|
---|
| 1696 | "C:\Program Files\Internet Explorer\iexplore.exe" http://your_server/cgi-bin/openwebmail/openwebmail.pl?loginname=USER&password=PASSWORD&action=composemessage&to=%1
|
---|
| 1697 |
|
---|
| 1698 | (Thanks to Sergiy Zubatiy, sergey_sd.AT.users.sourceforge.net)
|
---|
| 1699 |
|
---|
| 1700 | Q: How can I set an alias/redirection/link to the openwebmail script so users
|
---|
| 1701 | can use openwebmail with a shorter url?
|
---|
| 1702 | A: Please create a file, index.html, like below. Either a or b is okay.
|
---|
| 1703 | Then put this index.html to the location mapped by the url you want.
|
---|
| 1704 | a.
|
---|
| 1705 | ----------------------------------------
|
---|
| 1706 | <html><head>
|
---|
| 1707 | <meta http-equiv="Refresh"
|
---|
| 1708 | content="0;URL=http://your_server/cgi-bin/openwebmail/openwebmail.pl">
|
---|
| 1709 | </head></html>
|
---|
| 1710 | ----------------------------------------
|
---|
| 1711 | b.
|
---|
| 1712 | ---------------------------------------
|
---|
| 1713 | <html>
|
---|
| 1714 | <body onload=
|
---|
| 1715 | "window.open('http://your_server/cgi-bin/openwebmail/openwebmail.pl','_top')">
|
---|
| 1716 | </body>
|
---|
| 1717 | </html>
|
---|
| 1718 | ----------------------------------------
|
---|
| 1719 |
|
---|
| 1720 | ps: An example redirect html is available at the
|
---|
| 1721 | data/openwebmail/redirect.html
|
---|
| 1722 |
|
---|
| 1723 | Q: Can I install openwebmail without root privilege?
|
---|
| 1724 | A: Yes, try the auth_pop3.pl. Some information is available in it.
|
---|
| 1725 |
|
---|
| 1726 | Q: Can Open WebMail be used with mod_perl?
|
---|
| 1727 | A: No, the most reason is mod_perl can't be used for setuid program.
|
---|
| 1728 | But Open Webmail works great in persistent mode with SpeedyCGI.
|
---|
| 1729 | It is very fast too.
|
---|
| 1730 |
|
---|
| 1731 | Q: Does Open WebMail support maildir and vpop3mail user by Qmail?
|
---|
| 1732 | A: The official release does still not support maildir, however,
|
---|
| 1733 | Laurent Frigault, lfrigault.AT.users.sourceforge.net has made patched
|
---|
| 1734 | Open WebMail 2.01 to support maildir. It is available at
|
---|
| 1735 | http://www.agneau.org/openwebmail/openwebmail-2.01-storage-20031027.tgz
|
---|
| 1736 |
|
---|
| 1737 | Q: Will maildir be merged to official release of Open WebMail?
|
---|
| 1738 | A: Yes, but we need to reorganization the code of openwebmail first
|
---|
| 1739 | so the maildir patch could be merged into smoothly.
|
---|
| 1740 | This would take some time...
|
---|
| 1741 |
|
---|
| 1742 | Q: Can Openwebmail do xxx function or have yyy control option?
|
---|
| 1743 | A: The best way to know all features of openwebmail is to check the
|
---|
| 1744 | cgi-bin/openwebmail/etc/openwebmail.conf.help. Please check it.
|
---|
| 1745 |
|
---|
| 1746 | Q: Can I use Open WebMail in a commercial web site?
|
---|
| 1747 | A: Yes. Open WebMail is GPLed software (please see copyright.txt for
|
---|
| 1748 | detail of GPL). You can distribute/use/modify/sell it freely ONLY IF
|
---|
| 1749 |
|
---|
| 1750 | a. The GPL Copyright page must be kept untouched.
|
---|
| 1751 | b. Any improvement of Open WebMail or any product based on Open WebMail
|
---|
| 1752 | must be released to the public for free in source form if it is not for
|
---|
| 1753 | internal use.
|
---|
| 1754 | c. Products based on Open Webmail must be also distributed under GPL.
|
---|
| 1755 |
|
---|
| 1756 |
|
---|
| 1757 | Jan/06/2005
|
---|
| 1758 |
|
---|
| 1759 | openwebmail.AT.turtle.ee.ncku.edu.tw
|
---|