4
Frequently Asked Questions

This chapter provides answers to frequently asked questions about the Simple Mail Transfer Protocol (SMTP) adapter.

SMTP Adapter Troubleshooting Questions

The following questions address troubleshooting issues for the SMTP adapter.

How do I know the SMTP adapter started properly?

View the oailog.txt file located in the appropriate timestamped subdirectory of the SMTP adapter logs directory.

On...	Go to...
UNIX	ORACLE_HOME/oai/9.0.4/adapters/Application/logs/timestamp_in_milliseconds
Windows	ORACLE_HOME\oai\9.0.4\adapters\Application\logs\timestamp_in_milliseconds

where Application is the value you defined in Step 3 and timestamp_in_milliseconds is the directory. If no exceptions are listed, the adapter started properly.

The SMTP adapter did not start properly - what is wrong?

View the exceptions in the adapter log file (oailog.txt). The exceptions provide information about inconsistencies. One possible reason is that the SMTP adapter did not connect to the repository. Make sure the repository is started properly and the SMTP adapter connects to the repository once it is started properly. You do not need to restart the adapter.

See Also: Oracle Application Server Installation Guide for instructions on starting the repository on UNIX and Windows

I changed an element in iStudio, but the SMTP adapter uses old information - what is happening?

The SMTP adapter caches the information from iStudio (the information that is stored in the repository) locally for better performance in a production environment. If you change information in iStudio and want to see the change in the runtime environment, you must perform the following tasks:

To see iStudio changes in the runtime environment:

1. Stop the affected adapters.

2. Delete the adapter cache files.

3. Restart the adapter.

Each adapter has a persistence directory located in the directory named after the Oracle SMTP application. Deleting this directory when the adapter has been stopped makes the adapter obtain the new metadata from the repository when started.

If I cannot answer some SMTP configuration questions or I make a mistake during installation, can I edit these settings later?

Yes, edit the parameters in the following file:

On...	Go to...
UNIX	ORACLE_HOME/oai/9.0.4/adapters/Application/adapter.ini
Windows	ORACLE_HOME\oai\9.0.4\adapters\Application\adapter.ini

Note: All configuration parameters with the exception of bridge_class can be edited more than once.

See Also: "Hub.ini Parameters" for parameter information

Can I install multiple SMTP adapters on the same computer?

The installer overwrites previous installations of the SMTP adapter if you try to install it a second time in the same Oracle home. However, you can have multiple Oracle homes on a computer and have one SMTP adapter in each Oracle home. When you install the SMTP adapter a second time, choose a different Oracle home from the first SMTP adapter.

How do I make the adapter.ini file password parameter secure?

In order to encrypt password values specified in the adapter.ini file, perform the following steps:

To encrypt password values:

1. Locate the password value to encrypt.

2. Run the encrypt utility to encrypt the password value. The encrypt utility is located in the ORACLE_HOME/oai/9.0.4/bin directory for UNIX and the ORACLE_HOME\oai\9.0.4\bin directory for Windows. For example, to encrypt the smtp.receiver.password parameter, enter the following:

   encrypt password
   
   

3. Prefix the name of the parameter in the adapter.ini file with encrypted_:

   encrypted_smtp.receiver.password
   
   

4. Replace the value with the new encrypted value created in Step 2. For example, to encrypt the password for the parameter smtp.receiver.password, replace the line

   smtp.receiver.password=smtpuser
   
   

   with the value you received from running the encrypt tool in Step 2. For example:

   encrypted_smtp.receiver.password=112411071071106510801094108410731070107110811069