POP3 Configuration
Consult pop3server.xml in GIT to get some examples and hints.
The POP3 service is controlled by a configuration block in the pop3server.xml.
The pop3server tag defines the boundaries of the configuration block. It encloses
all the relevant configuration for the POP3 server. The behavior of the POP service is
controlled by the attributes and children of this tag.
This tag has an optional boolean attribute - enabled - that defines whether the service is active or not. The value defaults to "true" if
not present.
The standard children of the pop3server tag are:
- bind
- Configure this to bind to a specific inetaddress. This is an optional integer value. This value is the port on which this POP3 server is configured
to listen. If the tag or value is absent then the service
will bind to all network interfaces for the machine If the tag or value is omitted, the value will default to the standard POP3 port, 11
port 995 is the well-known/IANA registered port for POP3S ie over SSL/TLS
port 110 is the well-known/IANA registered port for Standard POP3
- connectionBacklog
- tls
- Set to true to support STARTTLS or SSL for the Socket.
To use this you need to copy sunjce_provider.jar to /path/james/lib directory. To create a new keystore execute:
keytool -genkey -alias james -keyalg RSA -storetype PKCS12 -keystore /path/to/james/conf/keystore
Please note that each POP3 server exposed on different port can specify its own keystore, independently from any other
TLS based protocols.
- handler.helloName
- This is the name used by the server to identify itself in the POP3
protocol. If autodetect is TRUE, the server will discover its
own host name and use that in the protocol. If discovery fails,
the value of 'localhost' is used. If autodetect is FALSE, James
will use the specified value.
- handler.connectiontimeout
- Connection timeout in secconds
- handler.connectionLimit
- Set the maximum simultaneous incoming connections for this service
- handler.connectionLimitPerIP
- Set the maximum simultaneous incoming connections per IP for this service
- handler.handlerchain
- This loads the core CommandHandlers. Only remove this if you really
know what you are doing
- bossWorkerCount
- Set the maximum count of boss threads. Boss threads are responsible for accepting incoming POP3 connections
and initializing associated resources. Optional integer, by default, boss threads are not used and this responsibility is being dealt with
by IO threads
- ioWorkerCount
- Set the maximum count of IO threads. IO threads are responsible for receiving incoming POP3 messages and framing them
(split line by line). IO threads also take care of compression and SSL encryption. Their tasks are short-lived and non-blocking.
Optional integer, defaults to 2 times the count of CPUs.
- maxExecutorCount
- Set the maximum count of worker threads. Worker threads takes care of potentially blocking tasks like executing POP3 requests.
Optional integer, defaults to 16.
- useEpoll
- true or false - If true uses native EPOLL implementation for Netty otherwise uses NIO. Defaults to false.
- gracefulShutdown
- true or false - If true attemps a graceful shutdown, which is safer but can take time. Defaults to true.
