Oracle eMail Server Administrator's Guide Release 5.2 A86653-01 |
|
The protocol server processes transfer e-mail from the eMail Server database to the user's e-mail client or browser. When you install a node or protocol server tier, you can run the Configuration Assistant to set up the initial configuration. If you do not want to use the Configuration Assistant, then you can use the following procedures discussed in this chapter to modify the configuration manually:
To use the protocol server processes, you must configure the number of Net8 connections between each registered protocol server process and the database. To do this, you must edit the protocol server configuration files manually. There are separate configuration files for POP3 and IMAP4 protocol servers. These configuration files are created during the installation using default parameters.
This task can be done either automatically by using the Configuration Assistant, or manually by using a text editor. For instructions on how to use the Configuration Assistant, refer to the Oracle eMail Server Installation Guide.
The name of the configuration file is specified with the confm
parameter in the protocol server process parameters. The default file names are:
$ORACLE_HOME/office/config/node_sid/iosps23.cfg for the POP3SRV process
$ORACLE_HOME/office/config/node_sid/iosps27.cfg for the IMAP4SRV process
See Also:
"SPS Process Parameters (Common to both IMAP4 and POP3)" for more information about the |
<connect_string
> <minimum_connections
> <maximum_connections
> <increment
> <timeout
> <domain>
See Also:
"Variables for Configuring the Protocol Server Database Connections" for more information about the parameters in this file |
confm
process parameter for that registered protocol server process instance.
See Also:
confm
parameter
Variable | Description |
---|---|
|
Connect string used to access database. |
|
Number of new database connections to start when the existing connections are all used. For example, an increment of 3 means that three new connections will be started each time the server needs additional connections. New connections cannot exceed the number specified for the |
|
Maximum number of Net8 connections from the protocol server to the database. On Solaris, the value for this parameter plus the
"SPS Process Parameters (Common to both IMAP4 and POP3)" for more information about the |
|
Minimum number of Net8 connections from the protocol server to the database. |
|
Amount of time (in seconds) to wait before releasing a connection that is not being used. |
domain |
Used as the users home node for that domain. This enables the IMAP server to service multiple domains. |
The following example shows a file with a line added at the bottom using the SFNode1 connect string with a minimum of 10 connections, maximum of 100 connections, increments of 2 new connections at a time, and a timeout after 120 seconds (this information appears in the last line of the file displayed in bold):
# This is the default configuration file for SPS connect strings. # Line started with "#" is comment. # Spaces and tabs are used as delimiters between fields in a line. # Parameters for one connect string have to be in the same line. # The format of parameters of a connect string is: # connect_string minimum_connections maximum_connections increment timeout # For example: # im-sun.world 10 100 5 100 # Add real connect strings and their parameters after this. SFNode1 10 100 2 120
You must specify the gateways that are registered in the system so that the protocol server processes know how to forward messages. You must add the gateway information to a configuration file that is created during the installation process.
This task can be done either automatically by using the Configuration Assistant, or manually by using a text editor. For instructions on how to use the Configuration Assistant, refer to the Oracle eMail Server Installation Guide.
unixgwy=<gateway_name
> unixgwy=<gateway_name
>
See Also:
"Parameters for Specifying Gateways for the Protocol Servers" for more information about the parameters available for this file |
Parameter | Description |
---|---|
|
Gateway name to strip from message header addresses. You can repeat this entry as many times as needed for all your gateways. |
If you configure protocol server process for SSL encryption, all messages transferred from the server to the client will be encrypted.
This task can be done either automatically by using the Configuration Assistant, or manually by using the Administration Tool GUI or the OOMGR command-line interface. For instructions on how to use the Configuration Assistant, refer to the Oracle eMail Server Installation Guide.
Parameter | Value |
---|---|
|
Enter 64 to set the SSL bit.See Also::
"IMAP4SRV Process Parameters (IMAP4-Specific)" or "POP3SRV Process Parameters (POP3-Specific)" for more information about the |
Refer to "Setting a Parameter for a Registered Process" for instructions.
Before you can begin sending messages encrypted in SSL, you must use the eMail Server Wallet Manager to generate a public/private key pair and then obtain a trusted certificate. To obtain the certificate, you must send a certificate request file to a Certification Authority. When you receive the certificate, you must store it with the private key in the database. Once this is done, any SSL-enabled client can send and receive secure messages from the certified server.
This task can be done either automatically by using the Configuration Assistant, or manually by using a text editor and a shell tool. For instructions on how to use the Configuration Assistant, refer to the Oracle eMail Server Installation Guide.
The Wallet Manager uses the information in this file to generate a certificate request file later.
Common-Name: acme.com Organization: Acme Corp. Organization Unit: eMail Server Country: US State: California Webmaster: C Kent <ckent@acme.com> Phone: 800-555-5555 |
Enter the following command at the shell prompt:
$ORACLE_HOME/bin/mhzwalletmgr -gc
Oracle eMail Server Wallet Manager Version 4.3 Production Please input certificate password: Please input the password again: Wallet manager finished successfully
The Wallet Manager generates two files:
http://digitalid.verisign.com/
and request a trial Server ID (trusted certificate) that you can use to test your system. To obtain your trusted certificate, follow the instructions provided by your Certificate Authority.
Enter one of the following commands at the shell prompt:
Parameter | Description |
---|---|
|
Connect string used to access database. See Also:: "Configuring the Protocol Server Database Connections" for more information. |
|
$ORACLE_HOME/office/admin/sslcerts.txt |
The Wallet Manager will prompt you for the eMail Server ADMIN
user password and for the password used to encrypt the private key (the private key password was specified in step 4).
After storing the sslcerts.txt file in the database, the Wallet Manager will rewrite the file located in $ORACLE_HOME/office/admin to be empty. This will destroy the unprotected versions of the private key and trusted certificate for added security.
certificate
parameter for the POP3SRV and IMAP4SRV processes refers to the sslcerts.txt text file that you created in step 6.
$ $ORACLE_HOME/bin/mhzwalletmgr -sp [POP3 | IMAP4] <connect_string
>
See Also:
"SPS Process Parameters (Common to both IMAP4 and POP3)" for more information about the |
|
Copyright © 2001 Oracle Corporation. All Rights Reserved. |
|