Using WebLogic Integration - Business Connect

Introduction

System Overview

How the System Works

Outbound Processing

Inbound Processing

Document Sizes

System Administrator Duties

Configuration

Configuration Quick Reference Outline

Security Considerations

Frequently Asked Questions

Maintenance Considerations

Getting Started

Starting Administrator or Tracker

Starting the Server Application

Starting the Server on Windows

Starting the Server on UNIX

Monitoring the Server Application

Viewing the server.log File in Windows and UNIX

Viewing Processes on UNIX

Monitoring the Server with a Browser

Description of the Server Monitor Web Page

Paused Server Processing

Closing Applications

Closing the Server on Windows

Closing the Server on UNIX

Stopping All Processes on UNIX

Closing Administrator or Tracker

Printing Administrator or Tracker Records

User Interface and Online Help

User Interface Components and Icons

Administrator Icons

Tracker Icons

Window Descriptions

Information Viewers

Tab Windows

Dialog Boxes

Wizards

Message Boxes

Status Symbols

Navigating the Application

Tool Bar Text

Required Fields

Tab and Ctrl-Tab

Ctrl Keys

Alt Keys

Sorting, Arranging, and Hiding Columns of Data

Sorting Information Viewers by Columns

Arranging Columns

Hiding and Showing Columns

Using Online Help

Accessing Help

Navigating Help

Searching for Help Topics

Overview of Profiles

How Profiles Work

Company Profiles

Partner Profiles

Company and Partner Profile Relationship

Company Profiles

Company Profile Overview

The Difference Between POP and SMTP

Inbound Fall-Off Algorithm

Distributing Profiles to Partners

Supported Formats for Profile IDs

Alphanumeric Characters in Profile IDs

Non-Alphanumeric Characters in Profile IDs

EDI Format for Profile IDs

Spaces in Profile IDs

Editing URLs to compensate for firewalls

Adding, Cloning, or Changing a Company Profile

Exporting a Company Profile to a File

Importing a Backed Up Company Profile

Changing All System Directories at Once

Deleting a Company Profile

Company Profile Identity Tab

Company Profile Preferences Tab

Company Profile Inbound Protocols Tab

Supported Protocols and Transports

Adding, Editing, and Removing Inbound Protocols

Transport Selection Considerations

SMTP Inbound Transport

Field Description

Bundled HTTP Inbound Transport

Field Description

Bundled HTTPS Inbound Transport

POP Inbound Transport

Company Profile XML Tab

Company Profile System Directories Tab

Company Profile Integration Tab

IBM MQSeries Options Window

FTP Options Window

JMS Options Window

Inbound Post-Processing Options Windows

Post-Processing Configuration Details

Company Profile Tuning Tab

Tuning Tab Description

Document Polling Rates

Inbound Protocols Tuning

Outbound Documents Tuning

Tuning Guidelines

Asynchronous and Synchronous Unpackaging

Keys and Certificates

What Is PKI?

PKI options

The Role of Trust in PKI

Scalability

Certificate revocation

Dual-Key Pairs

Why Use Encryption and Digital Signatures?

WebLogic Integration - Business Connect Encryption Method

Symmetric Key Encryption Algorithms

Symmetric Key Lengths

Public-Private (Asymmetric) Key Algorithms

Public-Private (Asymmetric) Key Lengths

Summary of Algorithms and Key Lengths

Support for Dual Keys

Encryption and Signing Summary

Outbound Documents

Inbound Documents

Certificate Basics

Where Certificates and Keys Are Stored

ConfigDB.db

keys.db

Certificate Status

Active Certificate (Yellow Bulb)

Valid or Inactive Certificate (Blue Bulb)

Pending Certificate (Red Bulb)

Retired Certificate (Clear Bulb)

Exchanging Profiles and Certificates

Exchanging Certificate Information with WebLogic Integration Trading Partners

Self-Signed or CA Certificates

When to Get Certificates

Replacing a Certificate for Non HTTPS Encryption

Replacing a Certificate for Bundled HTTPS with Authentication

Certificates Information Viewer

Certificate Window

Setting Up Certificates for a Company Profile

Generating Self-Signed Certificates

Importing Entrust Certificates

Importing RSA Keon Certificates

Importing VeriSign XKMS Certificates

Importing Third-Party CA Certificates

Importing Certificates for Partners

Exporting Your Certificate for Backup or Distribution

Deleting Certificates

Certificate Profile Window

Viewing Certificate Information

Viewing the Certificate Path

Activating a Pending or Valid Certificate

Retiring a Certificate

Un-Retiring a Certificate

Trusted Roots

Viewing, Editing or Importing Trusted Roots

Using Certificate Revocation Lists

Adding CRLs

Deleting CRLs

Turning CRL Checking On and Off

Partner Profiles

Importing a Profile from a Partner Who Uses WebLogic Integration

Adding, Cloning, or Changing a Partner Profile

Partner Profile Identity Tab

Identity, Primary Tab

Identity, Secondary Tab

Partner Profile Preferences Tab

Partner Profile Outbound Protocols Tab

Selecting an Active Outbound Protocol

Adding an Outbound Protocol

Editing an Outbound Protocol

Removing an Outbound Protocol

SMTP Outbound Transport

Bundled HTTP Outbound Transport

Field Description

Bundled HTTPS Outbound Transport

POP Outbound Transport

Partner Profile Firewall Tab

Getting Your Partner's Firewall Information

Firewall Details

HTTP and HTTPS for Firewalls and Proxy Servers

Commands Sent to Firewalls

Firewall Authentication Methods

Partner Profile Security Tab

Partner Profile Binary Directories Tab

Delete a Partner Profile

Document Send and Archive Schedules

Overview of Schedules

Send Schedule

Archive Schedule

Changing the Send Schedule

Changing the Archive Schedule

Tools and Preferences

Change Password Window

Remove Record Locks Window

Preferences General Tab

Preferences Ports Tab

Preferences Outbound SMTP Tab

Preferences Monitoring Tab

Using ebXML

ebXML Overview

ebXML with MCD Interface

ebXML with File System Interface

Validation of Inbound ebXML Documents

Using Message Control Documents

MCDs for ebXML

MCD Element Descriptions

Optional ebXML MessageAgentInfo Elements

Optional User-Defined Meta-Data for ebXML

ebXML Document Processing Settings

Outbound ebXML Document Processing Settings

Inbound ebXML Document Processing Settings

ebXML Processing Settings at a Glance

MCD Example for ebXML

Application Security

SOAP-RPC HTTPS Security

Default SOAP-RPC HTTPS Security

Optional SOAP-RPC HTTPS Security

Configuring Administrator and Tracker to Authenticate the SOAP-RPC Server

Configuring the SOAP-RPC Server to Authenticate Administrator or Tracker

API HTTPS Security

API Security Summary

Optional API Security

Configuring an API Client to Use HTTPS

Configuring an API Client to Authenticate the API Server

Configuring the API Server to Authenticate an API Client

Certificate Tool (certloader)

The Default RPC Certificate

Using certloader

Description of certloader Parameters

SOAP Configuration Tool (soapconfig)

Using soapconfig as a Command Line Tool

Using soapconfig with the User Interface

Exporting and Importing Data

Exporting Administrator Data

Exporting Tracker Data

Importing Data

Document Generator

Create EDI or XML Test Documents

Run Document Generator From a Command Line

Command Line Parameters

Command Line Format

Overview of APIs

APIs at a Glance

Sample Code

Required Tools

Required Knowledge and Skills

Technical Documentation

Support for Correlation IDs

User-Defined Meta-Data for ebXML

Example of Packaged ebXML Message

Outbound Integration via HTTP or HTTPS

Outbound Integration via RMI

Inbound Integration via RMI

User-Defined Meta-Data in MCDs

API Authentication

Document and Event APIs

Java RMI Event Listening

Application Configuration

Semantics

Scenario

Sample Code

JMS Integration for Events

Application Configuration

Semantics

Scenario

Sample Code

Local Java RMI Client for Document Exchange

Application Configuration

Semantics

Scenarios

Sample Code

HTTP Client for Document Exchange

Application Configuration

Semantics

Scenarios

Sample Code

Global JMS Document Integration

Global Versus Company JMS Integration

Application Configuration

Semantics

Scenarios

Sample Code

JMS Document Integration by Company

Application Configuration

Semantics

Scenarios

Sample Code

Profile Management API

Profile Management Overview

Profile Management Client Session

Create a Client Session

End a Client Session

Profile Management Functions

SetCompanyProfiles and SetPartnerProfiles

FindCompanies and FindPartners

GetCompanyProfiles and GetPartnerProfiles

RemoveCompanyProfiles and RemovePartnerProfiles

Disposition Codes

Company Disposition Codes

Company Validation Message Schema

Partner Disposition Codes

Partner Validation Message Schema

Profile Management Scenario

Profile Management Sample Code

Tracker

Overview of Tracker

Alerts

Traffic

Transactions

Refreshing the Tracker Display

Filtering Tracker Records

Printing Tracker Records

Guidelines for Finding and Reprocessing

Reprocessing Only the Most Recent Document

Reprocessing Unacknowledged Documents

Reprocessing Rejected Documents

Reprocessing by Control ID

Reprocessing by Partner

Logging on to Tracker

Manually Archiving Database Records

Clearing Tracker Database Records

Finding and Reprocessing Documents

Alerts Information Viewer

Description of Alert E-Mail

Description of Notification E-Mail

Traffic Information Viewers

Reprocessing Documents

Copying, Viewing, or Deleting Records

Viewing Documents

Inbound and Outbound Traffic Field Descriptions

Rejected Traffic Field Descriptions

Transactions Information Viewer

Messages

Level 0 Debug Messages

Agent started

Backup file has been archived

Backup file has been deleted

Duplicate received (automated resend)

File backed up

Partner certificate updated

Partner Profile updated

SKey iteration count level has reached minimum allowable level for partner

Level 1 Transaction Messages

A Company profile has been removed

A Company profile has been updated

A new Company has been registered

A new Partner has been registered

A Partner profile has been removed

A Partner profile has been updated

API - NOTIFY - LOCAL

API - NOTIFY - REMOTE

API - RECEIVING - REMOTE

API - SENDING - LOCAL

API - SENDING - REMOTE

AQUIRED

Companies started

Companies starting

MDN RECEIVED

MDN SENT

NEW

PACKAGED

RECEIVED

SENT

Server configuration completed

Server configuration started

Server shutdown completed

Server shutdown started

TRANSFERRED

Level 2 Notification Messages

An Api document listener has been removed

An Api event listener has been removed

Duplicate MDN received

New Api document listener registered

New Api event listener registered

Received duplicate document

Received miscellaneous document

The currently Active certificate for Company [name] will expire on [date].

The returned Acknowledgement indicates a message delivery failure.

The returned Acknowledgement indicates a problem resolving a URI on the sent document.

The returned Acknowledgement indicates a SOAP Fault.

The returned Acknowledgement indicates an error in an element content or attribute value.

The returned Acknowledgement indicates an unknown error.

The returned Acknowledgement indicates that a XML element content or attribute value inconsistent with other elements or attributes.

The returned Acknowledgement indicates that a XML element content or attribute value not recognized.

The returned Acknowledgement indicates that a XML element or attribute not supported.

The returned Acknowledgement indicates that an unspecified error occurred processing the document (see the Acknowledgement MCD).

The returned Acknowledgement indicates that the contents of the RosettaNet headers were invalid (see the Acknowledgement MCD).

The returned Acknowledgement indicates that the message security checks failed.

The returned Acknowledgement indicates that the Message Time To Live Expired.

The returned MDN indicates that the partner could not authenticate the signature of the sent document

The returned MDN indicates that the partner could not decrypt the sent document

The returned MDN indicates that the partner could not process the sent document.

The returned MDN indicates that the partner could not validate the integrity of the sent document

The returned MDN indicates that the partner does not recognize the sender of the document.

The returned MDN indicates that the partner does not support the packaging format of the sent document.

The returned MDN indicates that the partner expected a signature on the sent document.

The returned MDN mic value was invalid

Warning: The product license is about to expire.

Level 3 Rejected Messages

ebXML SOAP FAULT

EDI parsing error

Insufficient security: not encrypted

Insufficient security: not signed

Invalid or untrusted certificate was needed to verify message signature

MDN received with no matching outbound document

No active partner or unknown partner

Packager certificate or signature related error

Packager decryption error

RosettaNet content validation error

Signature certificate is not in list of partner's active or valid certificates

The sender and receiver have the same Id

Unlicensed protocol

XML parsing error

Level 4 Error Messages

Network error

No active signer certificate

Resend limit reached

Retry limit reached

You are not licensed to configure profiles using the API.

You are not licensed to submit documents using the API.

Level 5 Network Error Message

Unable to send API Client a System event. Removing API Client from queue.

Level 6 Configuration Error Messages

Active transport for partner has been disabled

Incomplete transport configuration

Incomplete transport configuration for binary re-routing

No active transport

Level 7 Unexpected Error Messages

Crossworks exception

Password is null

Unable to archive

Unable to configure

Unable to configure Company Profiles

Unable to configure FTP Integration

Unable to configure IBM MQSeries Integration

Unable to configure JMS Integration

Unable to configure Partner Profiles

Unable to configure Post-processing

Unable to configure Schedules

Unable to configure System Integration

Unable to construct

Unable to get certificate

Unable to initialize

Unable to package

Unable to process documents

Unable to process FTP Integration inbound documents

Unable to process FTP Integration outbound documents

Unable to process IBM MQSeries Integration inbound documents

Unable to process IBM MQSeries Integration outbound documents

Unable to process inbound Post-processing document

Unable to process incomplete inbound documents

Unable to process incomplete outbound documents

Unable to process JMS Integration inbound documents

Unable to process JMS Integration outbound documents

Unable to receive documents

Unable to reject

Unable to run

Unable to send

Unable to send API Client an Inbound Document event. Removing API Client from queue.