Installing WebLogic Integration - Business Connect

System Requirements

The following topics are provided regarding the hardware, software, communications, and interfaces required for installing WebLogic Integration - Business Connect.

Concepts

Note: For supplemental information about system requirements and installation, we strongly recommend that you review the WebLogic Integration - Business Connect Release Notes at:

http://download.oracle.com/docs/cd/E13215_01/wlibc/docs81/relnotes/index.html

Windows Requirements

The following topics provide the hardware and software requirements for running WebLogic Integration - Business Connect on computers with Microsoft Windows operating systems.

Hardware on Windows

A Windows computer must have the following minimum configuration.

A Pentium-class processor running at 400 MHz or faster
Random Access Memory (RAM)

256MB recommended
128MB minimum

250MB available hard drive space

Note: We recommend at least a 1 GB hard drive for both the application and the documents you exchange.

SVGA monitor
CD-ROM drive (for installation)
TCP/IP network interface
Local area network (LAN) card and persistent Internet connection is required.

Software on Windows

A Windows computer must have the following minimum software configuration.

Operating System

WebLogic Integration - Business Connect supports the following Windows operating systems: Windows NT 4.0 and Windows 2000.

To use Windows NT 4.0, you also must have installed the domestic United States version of Service Pack 4 or later with the associated bug fixes.

Note: Apache as the mediated web server is not supported when configured on Windows NT or Windows 2000.

Internet Browser

Internet Explorer 4.0.1 or later must be installed on your Windows computer before installing WebLogic Integration - Business Connect. Internet Explorer is required because the installation process uses IE scripts to create shortcuts. After installation you can use Internet Explorer 4.0.1 or later or Netscape Navigator 4.0 or later as the browser.

Administrator Rights for Windows NT and 2000

For Windows NT or 2000, you must have administrator rights to successfully install the application. If you are not sure whether you have administrator rights for a machine, check with your system administrator.

Recommended Software for Windows

Although Internet Explorer 4.0.1 or later must be installed to successfully install WebLogic Integration - Business Connect, after installation you can use Internet Explorer 4.0.1 or later or Netscape Navigator 4.0 or later. You use a browser to read WebLogic Integration - Business Connect online help files and to obtain third-party certificates from certificate authorities such as VeriSign, Inc.

In addition, you need Adobe Acrobat Reader to view and print Using WebLogic Integration - Business Connect, which is provided in portable document format (PDF) files. The PDFs are in the userdoc directory on the installation CD and in the doc subdirectory after you install the application. Acrobat Reader is available free from Adobe Systems Inc., www.adobe.com.

UNIX Requirements

The following topics provide the hardware and software requirements for running WebLogic Integration - Business Connect on UNIX computers.

Hardware on UNIX

Your computer must have the following minimum configuration to successfully install WebLogic Integration - Business Connect on a UNIX platform.

Random Access Memory (RAM)

256MB recommended
128MB minimum

250MB available hard drive space (see note)
CD-ROM drive
TCP/IP network interface
A persistent Internet connection.

Note: We recommend at least a 1 GB hard drive for both the application and the documents you exchange.

Software on UNIX

This topic lists the operating systems and other software necessary to install and configure WebLogic Integration - Business Connect on UNIX platforms.

X Windows and Operating Systems

Your system requires X Windows and any of the following UNIX operating systems:

Hewlett-Packard HP-UX 11.0
IBM AIX 4.3.3
Sun Solaris 2.7 or 2.8

OS Patches

Patches for some operating systems are required to support the Java technology that WebLogic Integration - Business Connect uses. For information about recommended patches, see the WebLogic Integration - Business Connect Release Notes at:

http://download.oracle.com/docs/cd/E13215_01/wlibc/docs81/relnotes/index.html

Recommended Software for UNIX

You should have Internet Explorer version 4.0.1 or later or Netscape Navigator version 4.0 or later. You use a browser to read WebLogic Integration - Business Connect online help files and to obtain third-party certificates from certificate authorities such as VeriSign, Inc.

In addition, you need Adobe Acrobat Reader to view and print the Using WebLogic Integration - Business Connect, which is provided in portable document format (PDF) files. The PDFs are in the userdoc directory on the installation CD and in the doc subdirectory after you install the application. Acrobat Reader is available free from Adobe Systems Inc., www.adobe.com.

Notes for users of HP-UX

Default values in HP-UX 11.0 and 11i for threads and other processes are too low for a Java application like WebLogic Integration - Business Connect. We recommend using the SAM tool to adjust kernel parameters to the values in the following table. We recommend that you involve your organization's UNIX administrator in making these changes.

Parameter	New value	Description
max_thread_proc	1024	Maximum number of threads allowed in each process.
maxfiles	256	Soft file limit per process.
maxusers	256	Affects other parameters.
nkthread	3635	Total number of kernel threads available.
nproc	2068	Maximum number of proc table entries.
ncallout	2084	Maximum number of pending time-outs.

Possible Port Conflicts

Some transports and database types have default port assignments in WebLogic Integration - Business Connect. It is possible a default port assignment might conflict with a port already in use on your system. You can execute a command to check for possible conflicts. You can use the command before installing WebLogic Integration - Business Connect to eliminate possible port conflicts or after installing if you encounter a problem.

You can use the netstat command to generate a list of ports in use on your system. The command is executed in the following ways.

Windows

In a command prompt or DOS window, type netstat -a to display a list of ports in use. You can instead type netstat -a | more to page through the list.

UNIX

On a command line, type netstat - a to display a list of ports in use. Or, to find whether a specific port is in use, type netstat -a | grep port_number.

List of Default Ports

The following table lists the default port assignments in WebLogic Integration - Business Connect. The table says where you can change a port number.

If there is a conflict, you can free the port for use by WebLogic Integration - Business Connect. Alternately, you can configure WebLogic Integration - Business Connect to use an inactive port above 1024 that is not listed in the output of the netstat command.

Description	Default port	Where to change it
RMI	1099	Section 3 of DB.properties file. The RMI.Port property has a null value by default, which means 1099.
Oracle	1521	Section 2C of DB.properties file.
Sybase	2638	Section 4 of DB.properties file.
DB2	50000	Section 2C of DB.properties file.
MS SQL	1433	Section 2C of DB.properties file.
Bundled HTTP	4080	Ports tab in Tools—>Preferences in Administrator.
Bundled HTTPS	1443	HTTPS Transport Options window, which is accessed from the Company Profile window Inbound Protocols tab for users of the AS2 protocol.
SOAP	4081	Ports tab in Tools—>Preferences in Administrator.
SMTP	4025	Ports tab in Tools—>Preferences in Administrator.
SMTP SSL	4026	Ports tab in Tools—>Preferences in Administrator.

The DB.properties file mentioned in the previous table is in the WebLogic Integration - Business Connect installation directory. Before editing the DB.properties file, we recommend that you copy the file and rename it as a backup. For example, rename the file DB.properties_old.

About the User License File

A file named license.xml contains the permissions for using specific functionality of WebLogic Integration - Business Connect. If you purchased WebLogic Integration - Business Connect, you received a production version of license.xml from BEA. Copy this file to a location that will be accessible during installation. You will be prompted to provide the path to the license file during the installation process. If you are evaluating WebLogic Integration - Business Connect leave the location of the license file blank when prompted; the installer will automatically generate a license.xml which allows you evaluate all functionality of WebLogic Integration - Business Connect for 30 days.

The license.xml file is installed in your WebLogic Integration - Business Connect installation directory. Each time you start a system component, such as Server, Administrator or Tracker, the system checks for the presence of this file in the installation directory. The license.xml file makes available the functionality you are authorized to use under your user license. You cannot use the application unless the file is present.

Do not delete the license.xml file from the installation directory. Do not rename the file or attempt to alter the contents in any way as this will make your system inoperable. The file is hashed and signed to protect it from tampering.

If you have purchased WebLogic Integration - Business Connect, we recommend that you keep a copy of the license.xml file in a secure place other than the installation directory in the event you need to re-install the application on the same or a different computer.

Security Considerations

To ensure the integrity of data processed by WebLogic Integration - Business Connect, we recommend that you adhere to the following security measures in addition to your company's own security policies. Although the risks are possibly remote, failure to institute minimum security measures may result in compromised data.

Install WebLogic Integration - Business Connect in the data layer behind a firewall and not in an area unprotected from exposure to the Internet.

Do not install or run WebLogic Integration - Business Connect under a privileged account. This includes root in UNIX and administrator or system accounts in Windows NT.

Do not view a binary document in Tracker that has been received by WebLogic Integration - Business Connect without first scanning the document for viruses.

Institute a policy for periodically changing the passwords for accessing Administrator, Tracker and the Server Monitor web page that is viewed in a browser by selecting Tools—>Launch Server Monitor in Administrator.

Control access to the computer running WebLogic Integration - Business Connect to authorized users.

If your manually distribute your certificate to partners, do so via a secure means. Encourage your partners to do likewise.

Restrict access via the firewall to the WebLogic Integration - Business Connect SOAP port only to authorized clients or networks.

Hardware Scalability

Scalability is the ability to support greater data load or throughput by increasing hardware resources without degrading processing time or system stability. In other words, scalability is the system's ability to cope with an increase in the data when the increase is matched by a proportional increase in hardware resources. If processing time degrades, despite the addition of hardware resources in proportion to the increase in load, then the system is not scalable.

To meet increased load, you can increase one or more of the following: central processing units (CPUs), memory or the number of machines.

Like most solutions, WebLogic Integration - Business Connect does not scale linearly with an increase in CPUs. A system processing 10,000 1 kilobyte transactions a day, for example, will not necessarily be capable of processing 20,000 1 KB transactions with the addition of another CPU. This characteristic must be considered before deciding to increase processing hardware.

Before adding hardware resources, tune the WebLogic Integration - Business Connect configuration for the best performance possible. Remember, processing power is not just adding processors. It is a combination of processors, memory, network speed, transport server performance, disk speed, database performance, and other elements that can affect your system.

For information about tuning the application to improve performance, see Using WebLogic Integration - Business Connect.