Oracle9iAS InterConnect Adapter for HTTP Installation and User's Guide Release 2 (9.0.2) Part Number A95445-01 |
|
This chapter describes Hypertext Transfer Protocol (HTTP) adapter installation and configuration.
This chapter contains these topics:
This section contains these topics:
The HTTP adapter must be installed in one of the following Oracle homes:
Consult the Oracle9i Application Server Installation Guide before proceeding with HTTP adapter installation. This guide includes the following information:
To install the HTTP adapter:
The File Locations screen appears.
The Installation Types screen appears.
The Available Product Components screen appears.
The Oracle9iAS Metadata Repository stores metadata used by Oracle9iAS InterConnect to coordinate communication between components.
The Oracle9iAS InterConnect HTTP Adapter Configuration screen appears.
The Oracle9iAS InterConnect HTTP Adapter usage screen appears.
adapter.ini
file.
If You Select... | Then Click Next and Go to Step... |
---|---|
Configure for both sending and receiving messages |
|
Configure for sending messages ONLY |
|
Configure for receiving messages ONLY |
The installation screen that appears next is based on the selection you made in Step 10:
If You Selected... | Then Go to Step... |
---|---|
Configure for both sending and receiving messages |
|
Configure for sending messages ONLY |
When finished, the Summary screen appears.
Platform | Directory |
---|---|
Windows |
|
UNIX |
|
Application
is the value you specified in Step 8. A webapps
subdirectory is created in the Application
directory identified in Step 16. webapps
includes the following files created for the HTTP application:
HTTP adapter installation creates an adapter.ini
file that consists of configuration parameters read by the HTTP adapter at startup. The configuration parameter settings are appropriate for most HTTP application environments. If you want to customize some adapter.ini
file parameter settings for the HTTP application, see the following sections:
Payload data is the data sent between applications. If you want to change the payload datatype from the default of XML to the data definition description language (D3L), edit the following parameters in the adapter.ini
file.
To customize the payload datatype:
ota.type
parameter to the payload type D3L
. For example:
ota.type
=D3L
adapter.ini
file is located.
ota.d3ls
parameter to specify the D3L files associated with the HTTP application. For example:
ota.d3ls=person1.xml,person2.xml
If you want to customize the behavior of the sending endpoints (destinations) for messages, edit the following parameter in the adapter.ini
file.
To customize the sending endpoints:
http.sender.timeout
parameter to the timeout interval in milliseconds for HTTP connections. This parameter automatically defaults to a value of 60000
during installation. For example:
http.sender.timeout
=10000
See Also:
http.sender.timeout parameter description for additional information |
If you want to use an authentication scheme, edit the following parameters in the adapter.ini
file. These parameters are not automatically set to default values during installation.
To customize the authentication scheme:
http.sender.authtype
parameter to the authentication type to use. For example:
http.sender.authtype
=basic
http.sender.realm
parameter to the realm for the authentication scheme. For example:
http.sender.realm
=ipt
http.sender.username
parameter to the authentication username. For example:
http.sender.username
=joe
http.sender.password
parameter to the authentication password. For example:
http.sender.password
=100100101
See Also:
The following parameter descriptions for additional information:
|
If you want to use a proxy host, edit the following parameters in the adapter.ini
file. These parameters are not automatically set to default values during installation.
To customize a proxy host:
http.sender.proxy_host
parameter to the hostname of the proxy server. For example:
http.sender.proxy_host
=www-proxy.foo.com
http.sender.proxy_port
parameter to the port number of the proxy server. For example:
http.sender.proxy_port
=80
If you want to use the secure socket layer (SSL) environment for sending messages, edit the following parameters in the adapter.ini
file. These parameters are not automatically set to default values during installation.
To customize a secure socket layer environment:
http.sender.wallet_location
parameter to the directory path and name of the wallet file. For example:
http.sender.wallet_location
=/private/foo/certdb.txt
http.sender.wallet_password
parameter to the Oracle Wallet Manager password. For example:
http.sender.wallet_password
=4341193845566
http.sender.cipher_suites
parameter to the cipher suites used in the secure connection. For example:
http.sender.cipher_suites
=SSL_RSA_WITH_NULL_SHA,SSL_RSA_WITH_3DES_EDE_CBC_
SHA
See Also:
The following parameter descriptions for additional information:
|
If you want to customize the behavior of receiving endpoint messages, edit the following parameter in the adapter.ini
file.
To customize the receiving endpoints:
http.receiver.registry_port
parameter to the remote method invocation (RMI) registry port for communicating with the servlet. This parameter automatically defaults to a value of 9901
during installation. For example:
http.receiver.registry_port
=3500
See Also:
http.receiver.registry_port parameter description for additional information |
If the Oracle9iAS Containers for J2EE (OC4J) is installed on a separate computer from the HTTP adapter, you must manually:
To manually deploy an EAR file:
cd myHTTPapphome
where myHTTPapphome
is the directory in which the HTTP application is installed and the value you defined in Step 8.
oai.ear
file:
jar xvf oai.ear
oai.war
file:
jar xvf oai.war
cd WEB-INF
web.xml
file:
web.xml
specifies the RMI information that must match with the setting in the adapter.ini
file. For example, rmiHost
must match the hostname of the computer on which the HTTP adapter is installed. The HTTP adapter serves as the RMI server. The transport servlet makes an RMI call to submit the requests sent by the external application. You can also edit the logging options that are turned off by default.
The following web.xml
file shows the rmiHost
parameter with a computer hostname setting of prodserver10
:
<init-param> <param-name>rmiHost
</param-name> <param-value>prodserver10
</param-value> </init-param> <init-param> <param-name>rmiPort</param-name> <param-value>9901</param-value> </init-param> <init-param> <param-name>instanceName</param-name> <param-value>oai</param-value> </init-param> <!-- set the following parameters if logging is needed. --> <init-param> <param-name>isLogOn</param-name> <!-- enter true/false --> <param-value>false</param-value> </init-param> <init-param> <param-name>logDir</param-name> <!-- directory where log file is placed. --> <param-value></param-value> </init-param> <init-param> <param-name>logLevel</param-name> <!-- choose one of the levels: debug, status, or error --> <param-value></param-value> </init-param>
cd myHttpApphome
oai.war
and oai.ear
files:
jar cvf oai.war WEB-INF jar cvf oai.ear META-INF/ oai.war
Table 2-2, Table 2-3, and Table 2-4 describe executable files, configuration files, and directories. These files and directories are accessible from the directory shown in Table 2-1:
On... | Go to... |
---|---|
UNIX |
|
Windows |
|
This section contains these topics:
The agent component of the HTTP adapter reads the adapter.ini
file at runtime to access HTTP adapter parameter configuration information. Table 2-5 lists the parameter name, a description for each parameter, the possible and default values, and an example.
Table 2-6 lists the parameters specific to the HTTP adapter.
Parameter | Description | Example |
---|---|---|
|
Specifies the entry class for the HTTP adapter. A value must be specified and cannot be modified later. A possible value is oracle.oai.agent.adapter.technology.TechBridge. There is no default value. |
|
|
Defines the sending endpoint URL for the HTTP adapter. There is no default value. The URL is of the form:
|
|
|
Defines the receiving endpoint URL for the HTTP adapter. There is no default value. The URL is of the form:
|
|
|
Defines the message payload type the HTTP adapter handles for both incoming and outgoing messages. The options are |
|
|
Times out an HTTP connection. The unit is in milliseconds. The default is set to |
|
|
Set if authentication is needed. The valid options are |
|
|
Specifies the realm for the authentication scheme. There is no default value. |
|
|
Specifies the authentication username. There is no default value. |
|
|
Specifies the password used in the See Also: "How do I make the adapter.ini file password parameters secure?" for instructions on encrypting the user password |
|
|
Specifies the proxy hostname. There is no default value. |
|
|
Specifies the port number for the proxy host. This is needed if the proxy host is set. There is no default value. |
|
|
Needed if SSL is used. This specifies the path and name of the wallet file. There is no default value. |
|
|
Needed if SSL is used. This specifies the password for the Oracle Wallet Manager. There is no default value. This password can also be encrypted by running the encrypt tool and renaming this parameter to See Also: "How do I make the adapter.ini file password parameters secure?" for instructions on encrypting the wallet password |
|
|
Optional parameter for choosing the cipher suites. The selections are:
|
|
|
Specifies the RMI port used by the HTTP receiver. The default is |
|
|
Specifies the instance name of the HTTP receiver. The default is |
|
|
Specifies the class name for customizing the HTTP response. |
|
|
Specifies the list of D3L XML files used by this bridge. Each business event handled by the bridge must have its own D3L XML file. When a new D3L XML file is imported in iStudio for use by an application using the HTTP adapter, the parameter must be updated and the HTTP adapter restarted. |
|
|
![]() Copyright © 2002 Oracle Corporation. All Rights Reserved. |
|