Installing WebLogic Integration - Business Connect

Installation on Windows

The following topics are provided for installing the WebLogic Integration - Business Connect server and client applications on computers with Microsoft Windows operating systems.

Procedures

Installing on Windows

Use this procedure to install WebLogic Integration - Business Connect from the installation CD.

Note: If you plan to upgrade from an earlier version of WebLogic Integration - Business Connect, see Upgrading, before installing.

Before installing WebLogic Integration - Business Connect, see System Requirements, to ensure your hardware, software and communications are ready.

Optionally, we recommend that you create a Windows user ID and password to be used by all persons who work with WebLogic Integration - Business Connect. Use this user ID for all installation, configuration, maintenance or monitoring of the Administrator, Server and Tracker applications. See your systems administrator for information and assistance.

Steps

Close any applications that might be running on your local machine.

Place the installation CD in the CD-ROM drive. When the CD menu appears, click Windows to launch the installation wizard.

If the CD menu does not appear after you insert the CD in the CD-ROM drive, use Windows Explorer and double-click the install.bat file in the windows directory on the CD.

Follow the on-screen prompts for installing the application.

If you have purchased a license from BEA, provide the complete path to the license.xml file you received when prompted. If you are evaluating the software, leave the path blank and click Next to continue. A a 30-day evaluation license will be created for you. See About the User License File.
You are also prompted to enter the fully qualified domain name or IP address of the computer where the Server application is installed. The Server application does not need to be running while you are installing the client.
When prompted to select an installation directory, be advised that you cannot use a directory name that includes blank spaces.
When you are prompted to click Install, a window appears that shows the progress of the installation. When the installation is completed, an installation summary window appears.

Click Exit to exit the window.

The installation process adds the WebLogic Integration - Business Connect program group to the Start menu. The icons are shown in the following table. Table 2-1 Program Icons Administrator Start Server Tracker View Server Log Stop Server Document Generator
There also are icons for opening the PDF file for Using WebLogic Integration - Business Connect and the help systems for Administrator and Tracker.

Select Start—>Programs—>BEA WebLogic Integration - Business Connect 8.1—>Administrator to log on to Administrator. See Getting Started in Using WebLogic Integration - Business Connect.

Improper Display of Icons on Windows

If you are installing the application as an upgrade of an earlier version, Windows might display the incorrect application icons on the Start menu. Windows caches the icons from the previously installed application. This situation does not affect the application or impair performance in any way. But if you encounter this and want to remedy it, follow these steps to clear the cache so Windows uses the new icons.

Steps

On an empty area of your Windows desktop, right-click to display a pop-up menu.

Select Properties at the bottom of the menu to open the Display Properties window.

Select the Appearance tab.

Select Icon from the Item drop-down list.

See the Size field to the right of the Item field. Make a note of the value.

Change the Size field value. For example, change 32 to 33.

Click Apply. Your desktop icons will disappear momentarily while the icon cache is rebuilt.

Change the value in the Size field back to the original value. For example, change 33 back to 32.

Click Apply. Your desktop icons will reappear after a short delay. The application icons also will display correctly.

Click OK to close the Display Properties window.

Configuring as a Windows Service

Running WebLogic Integration - Business Connect as a service in Windows NT or Windows 2000 provides the following functionality:

Windows can start the Server application during the Windows system initialization process and stop the application when Windows is shut down.
The Windows system administrator can use Windows services to manually start or stop the service from the local machine that hosts WebLogic Integration - Business Connect.

Note: While the Server application is set up as an Windows service, you should not start the application from the Start menu.

The following topics are provided for using WebLogic Integration - Business Connect as a Windows service.

Installing the ECEngine Utility to Support Configuration as a Windows Service

Use this procedure to install the ECEngine utility to enable you to configure WebLogic Integration - Business Connect as a service in Windows NT or Windows 2000.

Steps

Click Start in Windows and then open an MS-DOS command prompt window.

Use the cd command to change the current directory to the following:

installation_directory\util\NT Service

Then type the following:

ECEngine.exe -i

Press Enter. Wait for the prompt to reappear.

Close the MS-DOS command prompt window.

Go to Configuring as a Windows NT Service or Configuring as a Windows 2000 Service.

Configuring as a Windows NT Service

Use this procedure to configure WebLogic Integration - Business Connect as a service in Windows NT.

Install the ECEngine utility. See Installing the ECEngine Utility to Support Configuration as a Windows Service.

In the Windows NT Control Panel, double-click the Services icon. The Services dialog box opens.

In the Services dialog box, select ecengine and click the Startup button. The Service dialog box opens.

In the Logon As box, select the This Account option. Type Administrator, or select it from the list (click the More button to see the list). Type the Administrator's password in the fields.

Note: Make sure the Interact with the desktop option is not selected.

Click OK.

You can now start the Server application. If at some time Windows NT stops and is restarted, Server is also restarted and runs in the background. You also can reboot the Windows NT server to have the Server application run in the background.

Note: The WebLogic Integration - Business Connect Windows NT service is set to Automatic mode as the default. If you want to start and stop the application manually, you should change the mode to Manual in the Windows NT Services panel. For more information see Changing the NT Service Start-Up Options.

Configuring as a Windows 2000 Service

Use this procedure to configure WebLogic Integration - Business Connect as a service in Windows 2000.

Install the ECEngine utility. See Installing the ECEngine Utility to Support Configuration as a Windows Service.

Right-click on the My Computer icon on the desktop and select the Manage option. On the Computer Management window, expand the Services and Applications path and select Services.

Double-click the ECEngine service to open the ECEngine Properties window.

Make sure that Automatic displays in the Startup type field on the General tab.

Select the Log On tab. Select the radio button for This account. In the field following This account, type Administrator or click Browse and select Administrator. Type the password for the Administrator user in the password and confirm password fields.

Click Apply and OK to save your changes and close the window.

Close the Computer Management window.

The next time you start Windows, the WebLogic Integration - Business Connect Server application will start. You can use the Startup type field on the ECEngine Properties window to disable the service or change startup of the Server application from automatic to manual.

Starting as a Service

After you have installed WebLogic Integration - Business Connect as a service on Windows NT or Windows 2000, the Server application starts every time you reboot the computer or after every system outage.

Because WebLogic Integration - Business Connect runs in the background, the Server Display window does not display as when you start the Server application from the Start menu. To view transactions and other events as the system writes them to the console log, open the View Server Log tool.

Note: You can stop the Server application in the current Windows session by selecting Programs—>BEA WebLogic Integration - Business Connect 8.1—>Stop Server on the Start menu. The next time you start Windows, the Server application starts again as a service.

Removing from the List of Services

Use this procedure to remove WebLogic Integration - Business Connect from the list of services in Windows NT or Windows 2000.

Steps

Click the Windows Start menu button and then open an MS-DOS command prompt window.

Use the cd command to change the current directory to the following:

installation_directory\util\NTService

Then type the following:

ECEngine.exe -u

Press Enter. The message "NT Service Uninstalled" appears.

Close the MS-DOS command prompt window.

Changing the NT Service Start-Up Options

The WebLogic Integration - Business Connect installation process installs the application as a service with an automatic start-up option. This means that the service is automatically started during Windows NT initialization. You can change this option if necessary.

Steps

In Windows click Start—>Control Panel to open the Control Panel.

Double-click the Services icon. The Services dialog box appears.

Select WebLogic Integration - Business Connect in the Services box and then click the Setup button. The Service dialog box appears.

Select one of the following depending on your needs:

Automatic
Select this option to have WebLogic Integration - Business Connect start when Windows NT starts.
Manual
Select this option if you want to start WebLogic Integration - Business Connect manually from your desktop.
Disabled
Select this option if you do not want to run WebLogic Integration - Business Connect manually or automatically. This option leaves the WebLogic Integration - Business Connect in the list of available NT services in a disabled state.

Note: Make sure the Interact with the desktop option is not selected. This option is located at Start—>Settings—>Control Panel —>Services—>Startup.

Click OK on the Service dialog box and then click Close on the Services dialog box.

Next Steps

After you have successfully installed WebLogic Integration - Business Connect, Using WebLogic Integration - Business Connect provides the information you need to configure the application.

To view a PDF version of Using WebLogic Integration - Business Connect, choose Start—>Programs—>BEA WebLogic Integration - Business Connect 8.1—>Administrator Guide.

Using WebLogic Integration - Business Connect is also available on the BEA corporate Web site at the following URL:

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

Uninstalling on Windows

Use this procedure to remove WebLogic Integration - Business Connect from your Windows computer using the installation CD.

Note: To uninstall WebLogic Integration - Business Connect manually, delete the WebLogic Integration - Business Connect installation directory and the Start Programs menu shortcuts.

Steps

Place the installation CD in the CD-ROM drive.

Click Start—>Settings—>Control Panel to open the Control Panel window.

Click the Add/Remove Programs icon to open the Add/Remove Programs Properties dialog box.

Select the WebLogic Integration - Business Connect program you want to remove and then click the Remove button.

The uninstall program removes some of the application files and directories and deletes the folder containing the application shortcuts and the Start Programs menu shortcuts. You can remove the remaining components by deleting the WebLogic Integration - Business Connect installation directory.