Sun B2B Suite ASC X12 Protocol Manager User's Guide

Chapter 3 Installing ASC X12 PM

This chapter explains how to install ASC X12 PM, as well as pre- and post-installation procedures.

This chapter contains the following topics:

Supported Operating Systems and Prerequisites

This section describes the ASC X12 PM supported operating systems and the prerequisites you need for its use.

Supported Operating Systems

ASC X12 PM supports all operating systems supported by eGate and eXchange versions compliant with this release. See the eXchange Integrator User’s Guide for a complete list.

System Prerequisites

ASC X12 PM requires the following Sun SeeBeyond products (compliant with this release) for its correct operation:

See the eXchange README file for a list of the Sun SeeBeyond products compliant with this release.

Third-party Application Requirements

There are no third-party application requirements.

Getting Started With Installation

Open and review the README file for Java CAPS to gain current information you may need, for example for eGate or eInsight, before installing ASC X12 PM. You can find this file in the root directory of the Java CAPS installation’s Repository CD-ROM.

Also, ASC X12 PM has its own ASC_X12_Manager_Readme.txt file that contains additional information specific to this application, including required ESRs.


Note –

See the SeeBeyond Java CAPS Installation Guide for details on how to obtain the README and documentation files.


This version of ASC X12 PM is compatible with Java CAPS version 5.1.2 (eGate and eInsight).

Configuring eGate Projects for Large Messages

If an eGate Project uses Sun SeeBeyond Java Messaging Service (JMS) IQ Manager and is estimated to process messages or transactions over 8 MByts for Windows, or 16 MBytes for UNIX, you must increase the Segment Size property of JMS IQ Manager as explained in the eGate Integrator JMS Reference Guide.

Installing ASC X12 PM Product Files

During the Java CAPS installation operation, use Enterprise Manager, a Web-based application, to select and upload ASC X12 PM and add-on application .sar files from the Java CAPS installation CD-ROM to the Repository.

When the Repository is running on a UNIX operating system, you must still install ASC X12 PM using Enterprise Manager and Microsoft Internet Explorer on a Windows computer connected to the Repository server.

Basic Installation Procedures

Follow the general instructions for installing Java CAPS, which you can find in the Java CAPS Installation Guide. You must begin by installing eGate. For more information, see the eGate Integrator System Administration Guide.


Note –

Create and configure the eXchange database using the Oracle510.zip file. For complete information on how to perform this and other eXchange setup operations, see the eXchange Integrator User’s Guide.


In this document, the examples and illustrations show a Repository named repB2B, installed under the base installation directory and using the default ports (12000-12009).

ProcedureTo Install the Repository and Product .sar Files

  1. Install the Repository by running either of the following scripts:

    • (for Windows)


       … \Repository\install.bat
    • (for UNIX)


       sh … /Repository/install.sh
  2. Upon completion of the installation, start the Repository by running the following script:


    C:\ ... repository\startserver.bat
  3. Start a new browser session and point your browser at this URL:


    http://localhost:12000
  4. In the Java CAPS Login window of the Java CAPS Installer, supply the following values:

    • username: Administrator

    • password: STC

    Java CAPS Installer
  5. Use the Java CAPS Installer’s Administration tab to install the following file: eGate.sar

    This installation may require approximately 15 minutes.


    Note –

    Ensure that, to duplicate the sample shown in this document, you have named your Repository repB2B.


  6. Click the link to install additional products, and then browse to the current product list and submit it: Product_List.sar

  7. Stage and install the files listed under this step (installing both together may require approximately 15 minutes).

    From the Core Product category: eInsight.sar

    From the Enterprise Manager category:


    yourOS-type\Enterprise_Manager-yourOS-Platform.sar
  8. Stage and install the following product file, from the Logical Host category:


    yourOS-type\logicalhost-yourOS-platform.sar
  9. Stage and install the following product files, from the eWay category:

    • BatcheWay.sar

    • FileeWay.sar

    • HTTPeWay.sar

    • LDAPeWay.sar

    • OracleeWay.sar

  10. Stage and install the following product files from the Core Product category:

    • eXchange.sar

    • SEF_OTD_Wizard.sar


    Note –

    You must finish installing eXchange.sar before you start to install X12_Manager.sar.


  11. Stage and install the following product file, from the OTD category: X12_v4010_OTD.sar


    Note –

    You must finish installing this file before you start to install X12_Manager.sar.


  12. Stage and install the following product file, from the Core Product category: X12_Manager.sar

  13. Finally, stage and install the following product file, from the OTD category: X12_v4010_OTD_Validation_BP.sar

After You Install

Once ASC X12 PM is installed and configured, it must then operate in conjunction with an eGate Project before it can perform its intended functions. You must create these Projects specifically for ASC X12 PM, or you must import one or more ASC X12 PM Projects.

See the eXchange Integrator User’s Guide and eGate Integrator User’s Guide for detailed information on incorporating these types of Projects into eGate. See Chapter 5, Quick Start for ASC X12 PM (overview and quick start) and Chapter 6, ASC X12 PM Sample Scenario Tutorial (detailed tutorial) for information on a sample business scenario with Projects already created, using eXchange and ASC X12 PM.