Oracle eMail Server Installation Guide Release 5.2 Part Number A86742-01 |
|
This chapter describes tasks to be done after Oracle eMail Server has been installed or upgraded.
The chapter contains this topic:
Perform the tasks described in this section after completing an Oracle eMail Server installation.
Task 1: Verifying the Network Services Setup
Task 2: Starting the Oracle eMail Server Service
Task 3: Registering the SMTP Gateway with Sendmail
Task 5: Setting Up the ESPrefs Server
Task 6: Migrating Directory Data to an LDAP Directory
Task 7: Configuring eMail Server Thin Client
Task 8: Configuring Protocol Servers
Task 9: Loading Shipped Statistics File for the Cost Based Optimization (Optional)
Task 10: Configure Oracle Enterprise Manager E-mail Capacity Monitoring Pack (Optional)
The Oracle Universal Installer (OUI) creates a new tnsnames.ora
file in theORACLE_HOME
\network\admin
directory if none exists. If it exists, the OUI appends the contents of the new tnsnames.ora
to the existing one. To use information from the new listener.ora
, edit the existing one and manually add information from the new one.
A copy of the new tnsnames.ora
and listener.ora
is created in theORACLE_HOME
\office\network
directory. Ensure that the files contain the same value for the domain as the sqlnet.ora
file.
To start eMail Server automatically, perform the following procedure:
OracleEmailServer
SID
service. Choose Start > Settings > Control Panel > Services.
OracleEmailServer
SID
in the services list and select Start.
To manually start eMail Server, choose Start > Programs > Command Prompt and enter the following:
C:\>svrmgrl SVRMGR> connect internal SVRMGR> startup SVRMGR> exit C:\>ofcguard start C:\>oomgr admin/password
/
connect_string
/
qualified_domain_name
IOFCMGR> startup all;Started successfullyIOFCMGR> exit;
After creating the gateway configuration file, register the gateway with Sendmail, the standard mail transfer agent that handles all messages traveling to and from the Internet. To register the gateway with Sendmail, specify gateway information in the sendmail.cf
file so that Sendmail can forward messages coming in from the Internet.
Perform the following tasks to register the SMTP gateway with Sendmail.
sendmail.cf
file, usually located in the Sendmail installation directory, by adding the following information about the SMTP/MIME mailer to the end of the file:
Mofcmail, P=ORACLE_HOME\\bin\\ofcuto.exe, F=xrlSsDCFMPpmnA, S=10, R=20,
A=ofcuto - -u SMTP_GATEWAY_NAME -t 10 - \"$g\"\"$a\"$b\"\"$f\" \"$x\" ( $u )
Mlocal, P=ORACLE_HOME\\bin\\ofcuto.exe, F=xrlSsDCFMPpmnA, S=10, R=20,
A=ofcuto - -u SMTP_GATEWAY_NAME -t 10 - \"$g\"\"$a\"$b\"\"$f\" \"$x\" ( $u )
sendmail.cf
file, add one of the following entries to the second-to-last entry of ruleset 0 before the local names line:
## Oracle eMail Server: Hook to Oracle eMail Server mailer ## R$+.ofcmail [tab][tab] $#ofcmail $:$1 [tab][tab] Oracle eMail Server passoff
and
## Oracle eMail Server: Hook to Oracle eMail Server mailer ## R$+.OFCMAIL [tab][tab] $#ofcmail $:$1 [tab][tab] Oracle eMail Server passoff
sendmail.cf
file, add the user name of the owner of the eMail Server ORACLE_HOME
directory.
T root daemon uucp Oracle eMail Server_owner
sendmail.cf
file and the rc.local
file, restart Sendmail.
sendmail.exe
file is in the system environment variable called PATH.
Perform the following steps to set up ESPrefs.
espref
directory located in ORACLE_HOME
\office\admin
to the host where the web server is running. The espref
directory contains the following directories:
espref.jar
file:
C:\>cdORACLE_HOME
\office\admin\espref\beans C:\>jar xvf espref.jar
espref\config
directory. The configuration files are text files, where each entry is separated by a space.
The configuration files are:
The esConnectStrings.cfg
file contains the following connect information for all the nodes in the system:
All entries in the file must be formatted in the following way:
connectstring host SID port
imapmail mail.acme.com mail 1521
The esDomains.cfg
file lists the following domain information:
All entries in the file must be formatted in the following way:
domain host SID port
acme.com mail.acme.com mail 1521
The esPrefs.cfg
file contains an array of key and value pairs the administrator sets to enable subscribers to set the auto-reply and auto-forward templates. This must be set to either Yes or No, depending on the administrator's preference.
Format the values in the following way:
AutoReplySet Yes/No
AutoForwardSet Yes/No
To configure the ESPrefs server, set the path of the configuration directory.
Use a text editor to open the jserv.properties
file located in theORACLE_HOME
\Apache\Jserv\conf
directory and add the following two lines to the end of the file:
wrapper.bin.parameters=-DFILE_LOCATION=ORACLE_HOME
\Apache\Apache\htdocs
\espref\config\ wrapper.classpath=ORACLE_HOME
\Apache\Apache\htdocs\espref
At the command prompt, enter the following commands:
C:\>cd ORACLE_HOME
\Apache\Apache\bin
C:\>.\apachectl stop
C:\>.\apachectl start
From the Start menu, choose Start > Programs > HOME_NAME
- iSuites > Oracle HTTP Server > Start HTTP Server powered by Apache.
http://hostname
:port
/espref/jsp/esLogin.jsp
You should see the logon page.
Export private aliases and distribution lists from the eMail Server directory to an LDAP directory. To replicate data from the eMail Server directory to an LDAP directory, you must run a migration script to create data files that you can import into the LDAP directory.
Use the following procedure to replicate the private aliases, distribution lists, and public data from the eMail Server directory to an LDAP directory:
MigrateIOData.sh
scripts that generate the following two data files in the ORACLE_HOME
\bin
directory:
C:\>cdORACLE_HOME
\office\admin\rsql C:\>ldapadd -hhostname
-D "cn=orcladmin" -w password -p 389 -f add_ldap_ attr.dat C:\>ldapadd -hhostname
-D "cn=orcladmin" -w password -p 389 -f add_ldap_ obj.dat
Replace hostname
with the name of the machine on which Oracle Internet Directory is running.
If you are using a third-party LDAP directory, you must define the eMail Server database schema specified in the add_ldap_attr.dat
and add_ldap_obj.dat
files before importing the data into the directory.
initial
.ldif and domain
.ldif) for the LDAP domain context. This is essential for synchronizing eMail Server database schema with the LDAP server.
initial
.ldif dn: changetype: modify replace: namingcontexts namingcontexts: dc=top_level_domaindomain
.ldif dn: dc=top_level_domain dc: top_level_domain objectclass: domain objectclass: top dn: dc=subdomain,dc=top_level_domain dc: subdomain objectclass: domain objectclass: top
Repeat the last four lines for every subdomain in the hierarchy.
initial.ldif
and domain.ldif
files to the LDAP server using the following commands:
C:\>ldapmodify -h hostname -D "cn=orcladmin" -w password -p 389 -f initial.ldif C:\>ldapadd -h hostname -D "cn=orcladmin" -w password -p 389 -f domain.ldif
replog.log
and private_aliases_and_dls.log
files to the \temp
directory of the LDAP server.
replog.log
file for erroneous data, by running the following command on the LDAP server as the LDAP directory database owner:
C:\>
ORACLE_HOME
\ldap\bin\bulkload.sh -connectservice_name
-check -generate c:\temp\replog.log
Replace service_name
with the LDAP directory database service name in the tnsnames.ora
file.
ORACLE_HOME
\ldap\log
directory show no errors. Bulk load the data on the LDAP server as follows:
C:\>bulkload.sh -connect service_name
-load -generate
c:\temp\replog.log
Replace service_name
with the LDAP directory database service name in the tnsnames.ora
file.
At this point, all directory objects except private aliases and distribution lists are loaded into the directory.
C:\>acl.pl replog.log
C:\>acl.pl replog.log netscape
The command creates a file called replog.log.acl
. The generated Access Control List, ACL, will be for Oracle Internet Directory or Netscape.
The Thin Client is an application that provides access to e-mail functions, directory, and message searching capability from a single web page. You can customize the Thin Client to support your working style. With the Thin Client, you can compose new messages, organize existing messages and message folders, search for messages, create address book aliases and distribution lists, change your password, check mail quotas, change time zones, create mail rules and filters, and customize the look of the Thin Client.
esclient.zip
and escommonjars.zip
files from ORACLE_HOME
\office\admin
(where ORACLE_HOME
is the directory where eMail Server is installed) to ORACLE_HOME\
Apache\Apache\htdocs
(where ORACLE_HOME
is the directory in which Oracle9i Application Server is installed).
esclient.zip
file into the ORACLE_HOME\
Apache\Apache\htdocs
directory. This creates a new directory called esclient
into which all the files from the esclient.zip
file are extracted.
esccommonjars.zip
file into the ORACLE_HOME\
Apache\Apache\htdocs\esclient\lib
directory.
To set up Oracle9i Application Server to run the Thin Client, perform the following steps:
ORACLE_HOME
\Apache\Jserv\conf\jserv.properties
and use a text editor, such as Notepad, to insert the following lines into the file:
wrapper.bin.parameters=-DES_PROPERTIES=ORACLE_HOME
\Apache\Apache\htdocs
\esclient\es.properties wrapper.classpath=ORACLE_HOME
\Apache\Apache\htdocs\esclient\lib\j2ee.jar wrapper.classpath=ORACLE_HOME
\Apache\Apache\htdocs\esclient\lib\jgl.zip wrapper.classpath=ORACLE_HOME
\Apache\Apache\htdocs\esclient\lib\ldap.jar wrapper.classpath=ORACLE_HOME
\Apache\Apache\htdocs\esclient\lib\es.jar
zone.properties
file, located in the ORACLE_HOME
\Apache\Jserv
\servlets
directory:
repositories=ORACLE_HOME
\Apache\Jserv\servlets
*.dat
files as follows:
C:\>ldapadd -hhost
-D 'cn=orcladmin' -wpassword
-f*.dat
Load the oracle.ldif file as follows:
C:\>ldapadd -h host -D 'cn=orcladmin' -w password -f oracle.ldif
es.properties
file located in the ORACLE_HOME
\Apache\esclient
directory using a text editor. Instructions on how to configure the file are located within the es.properties
file.
http://hostname
:port
/esclient/templates/login.jsp
Where hostname
:port
refers to the Oracle9i Application Server hostname and port.
You should see the logon page.
Depending upon how you utilize Oracle eMail Server (such as number of users and number of messages), you may find that the default settings in the scalable protocol server (SPS) files are too low. Monitor the IMAP4 log file,node_name
_imap01.log
, located in the ORACLE_HOME
\office\log\
SID
directory while the system is in use, to determine whether or not the protocol servers are adequately configured.
Perform the following steps to import the statistics file:
ORACLE_HOME
by entering the following command:
C:\>set ORACLE_HOME=ORACLE_HOME
C:\>ORACLE_HOME
\office\admin\pckg\apply_stats.cmdsystem_password
The Oracle Enterprise Manager (OEM) Capacity Monitoring Pack allows an administrator to monitor e-mail traffic on the server.
A status dialog box will tell you when a node is discovered. Discovered nodes will appear on the Navigator Tree.
Use the Discover Node function for nodes that have an Intelligent Agent. If you add services to these nodes, you must restart the agent on the nodes before discovering the new services.
|
Copyright © 1996-2001 Oracle Corporation. All Rights Reserved. |
|