Sun B2B Suite ASC X12 OTD Library User's Guide

Chapter 3 Installing the ASC X12 OTD Library

This chapter describes how to install the X12 OTD Library and its documentation. This chapter also includes the system requirements and supported operating systems for the ASC X12 OTD Library. This chapter contains the following topics:

System Requirements

Each X12 OTD .sar file requires approximately 8 MBytes disk space; the combined disk space required to load all .sar files is approximately 140 MBytes.

Due to the size of the X12 OTDs, increasing the heap size property of the Enterprise Designer is advisable. For information, refer to Increasing the Enterprise Designer Heap Size.

Other than that, the system requirements for the X12 OTD Library are the same as those for eGate Integrator and eXchange Integrator. For information, refer to the Sun Java Composite Application Platform Suite Installation Guide.

Supported Operating Systems

For information about supported operating systems, refer to the B2B Readme file.

Installing the ASC X12 OTD Library

During the ASC X12 OTD Library installation process, the Enterprise Manager, a Web-based application, is used to select and upload products as .sar files from the Sun Java Composite Application Platform Suite installation CD-ROM to the Repository.

The installation process includes the following steps:

Follow the instructions for installing eGate Integrator in the Sun Java Composite Application Platform Suite Installation Guide, and include the steps below to install the ASC X12 OTDs. You must have uploaded a Product_List.sar to the CAPS Repository that includes a license for the ASC X12 OTD Library.

ProcedureTo Install the ASC X12 OTD Library

  1. After uploading the eGate.sar file to the eGate Repository, select and upload the following items below as described in the Sun Java Composite Application Platform Suite Installation Guide:

    • The eXchange.sar file

    • The SEF_OTD_Wizard.sar file to install the SEF OTD wizard that allows you to build ASC X12 OTDs from SEF files and is optional

    • The X12_Manager.sarfile

    • The *_Validation_BP.sar file corresponding to each OTD library you upload, such as X12_v4050_OTD_Validation_BP.sar file.

    • The X12_OTD_Docs.sar file to install the user’s guide

  2. Click the DOCUMENTATION page. Click ASC X12 OTD Library in the left pane. Click Sun B2B Suite ASC X12 OTD Library User’s Guide to download the documentation in PDF form.

  3. Start or restart the Enterprise Designer, and click Update Center from the Tools menu.

    The Update Center lists the components that are ready for updating.

  4. Click the Add All button (the button with a doubled chevron pointing to the right).

    All modules move from the Available/New pane to the Include in Install pane.

  5. Click Next. In the license agreement, click Accept.

  6. When the progress bars indicate the download has ended, click Next.

  7. Review the certificates and installed modules, and click Finish.

  8. When prompted to restart Enterprise Designer, click OK.

Increasing the Enterprise Designer Heap Size

Due to the size of the ASC X12 OTDs, you might need to increase the heap size property of Enterprise Designer. If the heap size is not increased, out-of-memory errors could occur.

ProcedureTo Increase the Enterprise Designer Heap Size

  1. Start the enterprise Designer.

  2. On the Tools menu in Enterprise Designer, click Options.

    The Options Setup dialog box appears.

  3. Set the configured heap size for Enterprise Designer, OTD Tester, and JCE Tester to no less than 512 MBytes, and click OK.

    Figure 3–1 Increasing Enterprise Designer Heap Size

    Increasing Enterprise Designer Heap Size

  4. Restart Enterprise Designer.

Resolving Memory Errors at Enterprise Designer Startup

If an out-of-memory error occurs at Enterprise Designer startup, change the setting in the heapSize.bat file. This file is resides in the folder jcaps51\edesigner\bin, where jcaps51 is the folder where Enterprise Designer is installed.

Procedure To Resolve Memory Errors

  1. Open the heapSize.bat file with a text editor.

  2. Change the heap size settings to no less than 512 MBytes.

  3. Save the file.

  4. Restart the Enterprise Designer.