Courier-Cygwin - Revision history

PhilippeTeuwen: Reverted edits by Etegohy (Talk) to last revision by Fuujuhi

2010-11-24T20:38:27Z

Reverted edits by Etegohy (Talk) to last revision by Fuujuhi

Can't load revision 6895

at 08:22, 24 November 2010

2010-11-24T08:22:32Z

Can't load revision 6747

Fuujuhi: Master was not happy... Let's roll back first to previous version

2008-11-07T15:14:09Z

Master was not happy... Let's roll back first to previous version

Show changes

Fuujuhi: /* Installing as a Windows Service */

2008-11-07T10:40:45Z

Installing as a Windows Service

← Older revision		Revision as of 10:40, 7 November 2008
Line 417:		Line 417:
	=Installing as a Windows Service=		=Installing as a Windows Service=

			If everything works fine you can install ''Courier'' as a Windows Service. Create the [{{#file:imapd-srv.sh}} service script]
	==Startup Script==

	If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.

⚫	<source lang=bash>
	#! /bin/sh
	#
	# Courier imap daemon startup script.

	authlib=/usr/local/sbin/authdaemond
	imapd=/usr/lib/courier-imap/libexec/imapd.rc

	test ! -f $authlib && echo "File not found: $authlib" && exit 1;
	test ! -f $imapd && echo "File not found: $imapd" && exit 1;

	case $1 in
	start)
	$authlib start
	$imapd start
	;;
	stop)
	$imapd stop
	$authlib stop
	;;
	*)
	echo "Usage: $0 <start\|stop>"
	;;
	esac
⚫	</source>

	==Cygwin Service==

	Create the [{{#file:imapd-srv.sh}} service script]

	<source lang=bash>		<source lang=bash>
Line 464:		Line 432:
	function handleQuit		function handleQuit
	{		{
	echo "STOPPING: /~~usr~~/~~local~~/~~sbin~~/~~imapd~~"		echo "STOPPING: /etc/rc.d/init.d/courier-authdaemon"
	su $username -c "/~~usr~~/~~local~~/~~sbin~~/~~imapd~~ stop"		su $username -c "/etc/rc.d/init.d/courier-authdaemon stop"
			echo "STOPPING: /etc/rc.d/init.d/courier-imap"
			su $username -c "/etc/rc.d/init.d/courier-imap stop"
	test -n "$pidsleep" && kill -9 $pidsleep		test -n "$pidsleep" && kill -9 $pidsleep
	exit		exit
Line 480:		Line 450:
	}		}

	echo "STARTING: /~~usr~~/~~local~~/~~sbin~~/~~imapd~~ as $username at "`date`		echo "STARTING: /etc/rc.d/init.d/courier-authdaemon as $username at "`date`
	su $username -c "/~~usr~~/~~local~~/~~sbin~~/~~imapd~~ start"		su $username -c "/etc/rc.d/init.d/courier-authdaemon start"
			echo "STARTING: /etc/rc.d/init.d/courier-imap as $username at "`date`
			su $username -c "/etc/rc.d/init.d/courier-imap start"

	trap "handleQuit" SIGQUIT		trap "handleQuit" SIGQUIT
Line 489:		Line 461:
	</source>		</source>

	Change username and save it to your favorite location, ~~says~~ /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.		Change ''username'' and save it to your favorite location, say <tt>/usr/local/sbin</tt>. The service script must be executable by ''SYSTEM'', ie: the user that run the windows services.

		⚫	<source lang="bash">
	$ chmod +rx /usr/local/sbin/imapd-service.sh		$ chmod +rx /usr/local/sbin/imapd-service.sh
		⚫	</source>

	Install the new service with the following command.		Install the new service with the following command.

			<source lang="bash">
	$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \		$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \
	--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown		--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown
			</source>

	Finally, just start the service		Finally, just start the service

			<source lang="bash">
	$ cygrunsrv --start imapd		$ cygrunsrv --start imapd
	or		# or
	$ net start imapd		$ net start imapd
			</source>

	You should now have couple of processes related to courier-imap		You should now have couple of processes related to courier-imap

			<source lang="bash">
	$ ps -a		$ ps -a
			</source>

	'''NOTES''':		'''NOTES''':
	* If the service could not be started, it's probably because the service script is not executable by SYSTEM		* If the service could not be started, it's probably because the service script is not executable by SYSTEM

			<source lang="bash">
	$ net start imapd		$ net start imapd
	The CYGWIN imapd service is starting.		The CYGWIN imapd service is starting.
Line 518:		Line 499:

	More help is available by typing NET HELPMSG 3534.		More help is available by typing NET HELPMSG 3534.
			</source>

	* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.		* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.


	=Other Interesting Packages=		=Other Interesting Packages=

Fuujuhi: /* Testing */

2008-11-07T10:32:09Z

Testing

@@ Line 334: / Line 334: @@
 =Testing=
  Authentication succeeded.
@@ Line 344: / Line 373: @@
  Cleartext Password: CCCCCC
             Options: (none)
 '''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.
 ==Troubleshooting==
-Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:
+Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using '''strace''', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:
-     # This will open a dialog box to complain about DLL.
+$ strace /usr/local/sbin/authtest             # This will open a dialog box to complain about DLL.
- $ export PATH=$PATH:/usr/local/lib/bin
+$ export PATH=$PATH:/usr/local/lib/bin
- $ /usr/local/sbin/authtest ausername
+$ /usr/local/sbin/authtest ausername
 =Installing as a Windows Service=

Fuujuhi: /* Running */

2008-11-07T10:07:05Z

Running

@@ Line 318: / Line 318: @@
 =Running=
-Start the authlib daemon with the following command:
+Stop the daemons with the following commands:
 =Testing=

Fuujuhi: /* Configuring Courier */ Too much subtitles... why not a subtitle for each sentence ;-)

2008-11-07T10:03:39Z

Configuring Courier: Too much subtitles... why not a subtitle for each sentence ;-)

← Older revision		Revision as of 10:03, 7 November 2008
Line 246:		Line 246:

	=Configuring Courier=		=Configuring Courier=

			== Configuration Files and Scripts ==

	If not present yet, add <tt>/usr/local/bin</tt> and <tt>/usr/local/sbin</tt> to your path (ideally in <tt>/etc/bash.bashrc</tt>):		If not present yet, add <tt>/usr/local/bin</tt> and <tt>/usr/local/sbin</tt> to your path (ideally in <tt>/etc/bash.bashrc</tt>):
Line 252:		Line 254:
	PATH=/usr/local/bin:/usr/local/sbin:$PATH		PATH=/usr/local/bin:/usr/local/sbin:$PATH
	</source>		</source>

	==courier-authlib==

	Create configuration file for '''authdaemond''' (<tt>/usr/local/etc/authlib/authdaemonrc</tt>)		Create configuration file for '''authdaemond''' (<tt>/usr/local/etc/authlib/authdaemonrc</tt>)
Line 265:		Line 265:
	daemons=3		daemons=3
	</source>		</source>

	==courier-imap==

	Edit the file <tt>/usr/lib/courier-imap/etc/imapd</tt>, taking care to adapt '''IMAP_ULIMITD''' accordingly:		Edit the file <tt>/usr/lib/courier-imap/etc/imapd</tt>, taking care to adapt '''IMAP_ULIMITD''' accordingly:
Line 274:		Line 272:
	IMAP_ULIMITD=2097152 #Set same value as returned by 'ulimit -v' or imapd.rc will complain		IMAP_ULIMITD=2097152 #Set same value as returned by 'ulimit -v' or imapd.rc will complain
	</source>		</source>

	==Start-up Scripts==

	Create link to authlib and imap daemon in <tt>/etc/rc.d/init.d</tt>		Create link to authlib and imap daemon in <tt>/etc/rc.d/init.d</tt>
Line 283:		Line 279:
	</source>		</source>

	==IMAP ~~accounts~~==		== IMAP Accounts ==

	User accounts and settings are managed by ''userdb''. <tt>[http://linux.die.net/man/8/makeuserdb man makeuserdb]</tt> for details.		User accounts and settings are managed by ''userdb''. <tt>[http://linux.die.net/man/8/makeuserdb man makeuserdb]</tt> for details.

Fuujuhi: /* Configuring Courier */

2008-11-07T09:58:08Z

Configuring Courier

@@ Line 246: / Line 246: @@
 =Configuring Courier=
 ==courier-authlib==
-Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc
+Create configuration file for '''authdaemond''' (<tt>/usr/local/etc/authlib/authdaemonrc</tt>)
  $ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc
-Change number of daemons (I use three) and enable DEBUG_LOGIN
+And edit its content to change number of daemons (I use three):
 <source lang=text>
 # The number of daemon processes that are started.
 daemons=3
 </source>
 ==courier-imap==
 ==IMAP accounts==
-User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb
+User accounts and settings are managed by ''userdb''. <tt>[http://linux.die.net/man/8/makeuserdb man makeuserdb]</tt> for details.
 </source>
 You should now have the following files created:

Fuujuhi: /* Building and Installing Courier-IMAP */

2008-11-07T09:39:36Z

Building and Installing Courier-IMAP

← Older revision		Revision as of 09:39, 7 November 2008
Line 123:		Line 123:
	Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.		Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.
	Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]		Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]

			<source lang="bash">
		⚫	$ tar -xvjf courier-imap-4.4.1.tar.bz2
			$ cd courier-imap-4.4.1
			</source>

	Apply the [{{#file:courier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:		Apply the [{{#file:courier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:
Line 222:		Line 227:
	Install the patch		Install the patch

			<source lang="bash">
⚫	$ ~~patch~~ -~~Np1 <~~ courier-imap-4.4.1~~-cygwin~~.~~patch~~
			$ patch -Np1 < courier-imap-4.4.1-cygwin.patch
			</source>

	Configure the package		Configure the package

			<source lang="bash">
	$ ./configure --disable-root-check --with-waitfunc=wait		$ ./configure --disable-root-check --with-waitfunc=wait
			</source>

	Take a walk... and when ready ~~execute~~ the ~~following~~ ~~command~~ to ~~build the package~~.		Take a walk or some coffee... and when ready build the package and install it.

			<source lang="bash">
	$ make		$ make

		⚫	$ make install
	Time to go for some coffee... and then install the package with the usual
		⚫	$ make install-configure

			</source>
⚫	$ make install
⚫	$ make install-configure

	=Configuring Courier=		=Configuring Courier=

Fuujuhi: /* Building and Installing Courier Authentication Library */

2008-11-07T09:35:20Z

Building and Installing Courier Authentication Library

← Older revision		Revision as of 09:35, 7 November 2008
Line 14:		Line 14:
	=Building and Installing Courier Authentication Library=		=Building and Installing Courier Authentication Library=

	Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.		Installation of ''Courier Authentication Library'' using the module '''userdb''' to manage mail accounts. All other modules are disabled.

	Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.		Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.
	Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]		Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]

			<source lang="bash">
		⚫	$ tar -xvjf courier-authlib-0.61.0.tar.bz2
			$ cd courier-authlib-0.61.0
			</source>

	Apply the [{{#file:courier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:		Apply the [{{#file:courier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:

	# incorrect usage of EXEEXT in ''makedat/Makefile''		# incorrect usage of EXEEXT in ''makedat/Makefile''
	# add libtool flag (-no-undefined) required for DLL creation		# add libtool flag (-no-undefined) required for DLL creation ([http://lists.cairographics.org/archives/cairo/2004-April/001125.html])
	# add missing dependencies		# add missing dependencies
	# add PATH in start script to access new DLL (installed in a different directory)		# add PATH in start script to access new DLL (installed in a different directory)

	Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html

	<source lang=diff>		<source lang=diff>
Line 93:		Line 96:
	Install the patch		Install the patch

			<source lang="bash">
⚫	$ ~~patch~~ -~~Np1 <~~ courier-authlib-0.61.0~~-cygwin~~.~~patch~~
			$ patch -Np1 < courier-authlib-0.61.0-cygwin.patch
			</source>

	Configure the package without most authentication modules, keeping only ''userdb''.		Configure the package without most authentication modules, keeping only '''userdb'''. Replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.

			<source lang="bash">
	'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.
		⚫	$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \
		⚫	--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \
		⚫	--with-mailgroup=mkgroup-l-d
			</source>

		⚫	Take a long pause... and when ready build, check the result and install the libraries.
⚫	$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \
⚫	--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \
⚫	--with-mailgroup=mkgroup-l-d

			<source lang="bash">
	Take a long pause... and when ready execute the following command.
		⚫	$ make

	$ make		$ make check
		⚫	$ make install

			</source>
⚫	Take ~~again~~ a long pause... ~~then~~ check the result and install the libraries

⚫	$ make ~~check~~
⚫	$ make install

	'''NOTES''': list of related topics found during investigation for compilation		'''NOTES''': list of related topics found during investigation for compilation