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?

• 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?

• Can I install multiple SMTP adapters on the same computer?

• How do I secure my passwords?

How do I know the SMTP adapter started properly?

View the oailog.txt file located in the timestamped 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 (oailog.txt). 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.

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

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.

See Also: "hub.ini Files" for parameter information

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.

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 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

For example,

AQAPP/aq_bridge_schema_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.

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