A Frequently Asked Questions

This appendix provides answers to frequently asked questions about the SMTP adapter.

How do I know the SMTP adapter started properly?
The SMTP adapter did not start properly: what is wrong?
The SMTP adapter is not starting. What could be the reason?
Is it possible to edit the SMTP adapter configuration settings created during installation?
When I change an element in iStudio, such as mappings, it seems like the SMTP adapter uses old information. What is happening?
How do I secure my passwords?
How can I deliver a message to a specific partition of the publishing adapter?

How do I know the SMTP adapter started properly?

View the log.xml file located in the time-stamped subdirectory of the SMTP adapter logs directory.

On...	Change to...
UNIX	`ORACLE_HOME/integration/interconnect/adapters/Application/logs/timestamp_in_milliseconds`
Windows	`ORACLE_HOME\integration\interconnect\adapters\Application\logs\timestamp_in_milliseconds`

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

View the exceptions in the adapter log file (log.xml). The exceptions should provide information about what went wrong. It is possible that the SMTP adapter is unable to connect to the repository. Ensure the repository is started properly. The SMTP adapter will connect to the repository once it is started properly. You do not need to restart the Adapter.

The SMTP adapter is not starting. What could be the reason?

One reason can be that Oracle Wallet does not contain the password information corresponding to your application name. For example, during installation you defined the application name as mySMTPApp. Later, you changed the application name in iStudio to SMTPApp. In such case, you need to specify the password corresponding to the new application name SMTPApp in the Oracle Wallet. You can create password by using the oraclewallet command.

Is it possible to edit the SMTP adapter configuration settings created during installation?

Yes, edit the parameters in the adapter.ini file in the following directory:

Platform	Directory
UNIX	`ORACLE_HOME/integration/interconnect/adapters/Application/`
Windows	`ORACLE_HOME\integration\interconnect\adapters\Application\`

Note:

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

When I change an element in iStudio, such as mappings, it seems like the SMTP adapter uses old information. What is happening?

The SMTP adapter caches information from iStudio. The information is stored in the repository locally. If you change something in iStudio and want to view the change in the runtime, then you need to stop the SMTP adapter, delete the SMTP adapter cache files, and restart the SMTP adapter.

The SMTP adapter has a persistence directory which is located in the SMTP adapter directory. Deleting this directory when the SMTP adapter has been stopped should make it obtain the new metadata from the repository when started.

How do I secure my passwords?

OracleAS Integration InterConnect uses Oracle Wallet Manager to maintain system passwords. When you install OracleAS Integration InterConnect, Oracle Wallet Manager is also installed and a password store is created. All passwords used by OracleAS Integration InterConnect components are stored in the password store. The password is stored in the Oracle Wallet in the following format:

ApplicationName/password

The ApplicationName is the name of the application, which is extracted from the adapter.ini file of the corresponding adapter. In the adapter.ini file, the application parameter specifies the ApplicationName to which this adapter connects. The password for the application is also retrieved from the adapter.ini file.

The number of entries is dependent on the type of adapter. For example, Database adapter needs two entries whereas AQ Adapter needs only one entry. The following table lists the entries that will be created for each adapter:

Adapter	Entry In Oracle Wallet
AQ	`ApplicationName`/`aq_bridge_password`
HTTP	`ApplicationName`/`http.sender.password`
HTTP	`ApplicationName`/`sender.wallet_password`
SMTP	`ApplicationName`/`smtp.receiver.password`
MQ	`ApplicationName`/`mq.default.password`
FTP	`ApplicationName`/`file.sender.password`
FTP	`ApplicationName`/`file.receiver.password`
DB	`ApplicationName`/`db_bridge_schema1_password`
DB	`ApplicationName`/`db_bridge_schema1_writer_password`

You can create, update, and delete passwords using the oraclewallet command. When you run the command, it prompts you for the admin password.

You can use the following commands to manage your passwords:

List all passwords in the store
```
oraclewallet -listsecrets
```

Create a password

oraclewallet -createsecret passwordname

For example, to create a password for the hub schema:

oraclewallet -createsecret hub_password

View a password

oraclewallet -viewsecret passwordname

For example, to view the password for the hub schema:

oraclewallet -viewsecret hub_password

Update a password

oraclewallet -updatesecret passwordname

For example, to update the password for the hub schema:

oraclewallet -updatesecret hub_password

Delete a password

oraclewallet -deletesecret passwordname

For example, to delete the password for the hub schema:

oraclewallet -deletesecret hub_password

How can I deliver a message to a specific partition of the publishing adapter?

Scenario: SMTP adapter has two partitions PAR1 and PAR2. You want to deliver event create_customer to partition PAR1 and add_customer event to partition PAR2.

Perform the following tasks:

Assign event create_customer to partition PAR1 and event add_customer to partition PAR2.
Configure two users in IMAP or POP3 server. For example USER1 and USER2.
Configure the adapter with partition name PAR1 to receive mails from USER1 and adapter with partition name PAR2 to to receive mails from USER2.
Publish the message for event create_customer to USER1 and the event add_customer to USER2.