Ubuntu Server Guide

Debugging and troubleshooting
Here are some tips to help troubleshoot sssd.
debug_level
The debug level of sssd can be changed on-the-fly via sssctl , from the sssd−tools package:
sudo apt i n s t a l l s s s d −t o o l s
s s s c t l debug−l e v e l 
Or change add it to the config file and restart sssd:
[ s s s d ]
c o n f i g _ f i l e _ v e r s i o n = 2
domains = example . com
[ domain / example . com ]
d e b u g _ l e v e l = 6
. . .
Either will yield more logs in /var/log/sssd/*.log and can help identify what is going on. The sssctl approach
has the clear advantage of not having to restart the service.
Caching
Caching is useful to speed things up, but it can get in the way big time when troubleshooting. It’s useful to
be able to remove the cache while chasing down a problem. This can also be done with the sssctl tool from
the sssd−tools package.
You can either remove the whole cache:
# s s s c t l cache−remove
C r e a t i n g backup o f l o c a l data . . .
SSSD backup o f l o c a l data a l r e a d y e x i s t s , o v e r r i d e ? ( y e s /no ) [ no ] y e s
Removing c a c h e f i l e s . . .
SSSD= n e e d s t o be r u n ni n g . S t a r t SSSD now? ( y e s /no ) [ y e s ] y e s
Or just one element:
s s s c t l cache−e x p i r e −u john
Or expire everything:
s s s c t l cache−e x p i r e −E
236

---

Dovecot Server
Dovecot is a Mail Delivery Agent, written with security primarily in mind. It supports the major mailbox
formats: mbox or Maildir. This section explains how to set it up as an IMAP or POP3 server.
Installation
To install a basic Dovecot server with common POP3 and IMAP functions, run the following command:
sudo apt i n s t a l l dovecot−imapd dovecot−pop3d
There are various other Dovecot modules including dovecot-sieve (mail filtering), dovecot-solr (full text
search), dovecot-antispam (spam filter training), dovecot-ldap (user directory).
Configuration
To configure Dovecot, edit the file /etc/dovecot/dovecot.conf and its included config files in /etc/dovecot/conf
.d/. By default all installed protocols will be enabled via an include directive in /etc/dovecot/dovecot.conf.
! i n c l u d e _ t r y / u s r / s h a r e / d o v e c o t / p r o t o c o l s . d / * . p r o t o c o l
IMAPS and POP3S are more secure because they use SSL encryption to connect. A basic self-signed ssl
certificate is automatically set up by package ssl-cert and used by Dovecot in /etc/dovecot/conf.d/10−ssl.
conf.
By default mbox format is configured, if required you can also use Maildir. More about that can be found in
the comments in /etc/dovecot/conf.d//10−mail.conf. Also see the Dovecot web site to learn about further
benefits and details.
Make sure to also configure your Mail Transport Agent (MTA) to transfer the incoming mail to the selected
type of mailbox.
Once you have configured Dovecot, restart its daemon in order to test your setup:
sudo s e r v i c e d o v e c o t r e s t a r t
Try to log in with the commands telnet localhost pop3 (for POP3) or telnet localhost imap2 (for IMAP).
You should see something like the following:
bhuvan@rainbow : ~ $ t e l n e t l o c a l h o s t pop3
Trying 1 2 7 . 0 . 0 . 1 . . .
Connected t o l o c a l h o s t . l o c a l d o m a i n .
Escape c h a r a c t e r i s
’ ^ ] ’ .
+OK Dovecot ready .