Sun B2B Suite ebXML Protocol Manager User's Guide

Chapter 4 Quick Start Guide

This chapter provides a basic, general description of how to successfully operate ebXML Protocol Manager in eXchange. Its purpose is to provide a summary of how to get started using ebXML Protocol Manager.

What’s in This Chapter

For more information on any of the topics discussed in this chapter, see the eXchange Integrator User’s Guide. You can also refer to the steps, as provided in Run-time Steps, for setting up the sample Projects that come with the ebXML Protocol Manager installation CD-ROM.

Overview: Basic Operations and Concepts

The following list describes the basic operations necessary to use ebXML Protocol Manager successfully:

This chapter briefly and generally describes the installation, setup, design, and run-time steps required to get an ebXML Protocol Manager Project and its ePM configuration set up and running. The chapter’s purpose is to provide a quick, easy set of procedures for reaching these goals, for the user who does not necessarily want or need all of the details.

For a complete, more detailed explanation of how to perform these steps, using the sample scenario provided with the CD-ROM with ebXML Protocol Manager, see Run-time Steps. The rest of this chapter describes, in general and without detail, how you can quickly perform the steps shown in the previous list.

Design Steps in Enterprise Designer

For ebXML Protocol Manager sample Project implementation, design-time procedures in Enterprise Designer consist of the following basic operations:

The rest of this section describes these operations.

Setting Up B2B Host Projects

You must create a B2B host Project for each ebXML Protocol Manager installation. This section provides a summary of this operation.

For complete information on how to perform these operations, see the eGate Integrator User’s Guide and the eXchange Integrator User’s Guide, as well as the sample scenario provided in Chapter 5, Implementation Scenario.

Using Projects

Before you can use the ebXML Protocol Manager with eXchange, perform the following actions:

The sample scenario provided in Chapter 5, Implementation Scenario assumes you use the sample Projects provided and the default configurations where possible.

Using Environments

Each ebXML Protocol Manager installation requires at least one Environment. The sample scenario provided in Chapter 5, Implementation Scenario assumes you use the sample Environments provided and the default configurations for all servers where possible.

You must also make any changes where needed, for example:

Each of the companies in the sample scenario has an eXchange installation with one Environment.

Creating B2B Host Projects’ Environments

Your first step is to create the Project’s Environment and its basic setup as follows:

Create the following external system instances:

Creating and Activating B2B Host Project DPs

Activating a Project DP creates an eXchange service that provides a connection to Enterprise Manager’s Message Tracking feature and the eXchange database.

The B2B host Project contains the following components:

Setting Up Oracle External System

You must set up an Oracle external system instance in a B2B host’s Environment in Enterprise Designer. Perform this operation using the following general steps:

For complete information on how to create a new external system and its instance in Enterprise Designer’s Environment, see the eGate Integrator User’s Guide. Also, see the Oracle eWay Intelligent Adapter User’s Guide.

The procedure in the rest of this section explains how to set up an Oracle external system instance for ebXML Protocol Manager.

ProcedureTo set up an Oracle external system instance

  1. In the Environment Explorer tree, navigate to the appropriate Project.

  2. Correctly configure the following properties in the eWay’s Properties dialog box:

    • DatabaseName

    • Delimiter

    • Description

    • Password

    • PortNumber

    • ServerName

    • User

      Note –

      Other properties are optional.

  3. When all properties have been configured correctly for your site, click OK.

See Also

The Project’s Environment now has its Oracle external system instance configured correctly for activation of the B2B host. For details, see the sample scenario explained in Run-time Steps.

Creating and Activating Project DPs

To run all ebXML Protocol Manager Projects, you must create, set up, and activate DPs for the following types of Projects:

Create, set up, and configure additional dpMain Projects in the same way as you do the Project for the B2B host. Keep in mind that details of these steps may vary, depending on the reason for and functioning of any additional Project.

Note –

Only the B2B host Project’s Environment requires an Oracle external system instance.

Use Enterprise Designer to activate each DP. See Run-time Steps and the eXchange Integrator User’s Guide for details.

Creating and Configuring TPs in ePM

This section describes the steps for creating and configuring TPs using ePM.

Basic ePM Steps

Before you begin this operation, your Repository and your eXchange Oracle database must be running and accessible to eXchange.

Note –

Enterprise Designer does not need to be running, and you do not need to have any Logical Hosts running.

Using ePM to create TPs includes the following basic operations:

For ePM configuration information, see Increasing the Oracle Number of Processes. For an implementation example, including importing and activating TPs, see the sample scenario in Run-time Steps.

Configuring eXchange Service With Cryptographic Features

Your use of the ebXML protocol assumes you are also using its cryptographic features (encryption, decryption, signatures, and verifications). Additional steps are required in setting up the eXchange service to use these features.

You must associate encryption information with each XDC eXchange service. For complete information on setting up an eXchange service with cryptographic features for Protocol Managers, see the eXchange Integrator User’s Guide. For specific examples, see the encryption setup used in the sample Project explained in Run-time Steps.

Run-time Steps

You run an ebXML Protocol Manager Project using the Logical Host. Running a Project requires the following basic steps:

You can check the output data either by checking the configured output file directory or using the eXchange Message Tracking feature, whichever is appropriate. For more information on Message Tracking, see Using Message Tracking.

Note –

You can use Enterprise Designer to make changes to a Project while it is running. See Applying Changes Without Shutting Down Logical Host for details.

Once you do these steps, your Project is active, and you are ready to send and receive data. For detailed information on these steps, see the sample scenario provided with ebXML Protocol Manager and supplied with the installation CD-ROM, as explained in Run-time Steps.