XML PORTAL CONNECTOR (XPC)¢â€‍¢ - Oracle XML PORTAL CONNECTOR (XPC)¢â€‍¢ INSTALLATION AND ADMINISTRATION

  • View
    4

  • Download
    0

Embed Size (px)

Text of XML PORTAL CONNECTOR (XPC)¢â€‍¢ - Oracle XML PORTAL CONNECTOR...

  • XML PORTAL CONNECTOR (XPC)™

    INSTALLATION AND ADMINISTRATION GUIDE

    Version 4.0

    Commerce One Corporate Headquarters 4440 Rosewood Drive Pleasanton, CA 94588-3050

  • XPC Installation and Administration Guide, Version 4.0

    Copyright © 2000, 2001 Commerce One, Inc. All rights reserved.

    February 2001

    COMMERCE ONE, Inc. Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted.

    This documentation and the software described constitute proprietary and confidential information protected by copyright laws, trade secret, and other laws. No part of this publication may be reproduced or distributed in any form or by any means, or stored in a database or retrieval system, without the prior written permission of Commerce One, Inc.

    Commerce One, Many Markets. One Source. Global Trading Web, Commerce One.net, BuySite, MarketSite, Global Trading Platform, Common Business Library, xCBL, XML Development Kit, XML Commerce Connector, MarketSite Builder, and SupplyOrder are either trademarks or registered trademarks of Commerce One, Inc. Enterprise Buyer and MarketSet are trademarks of Commerce One, Inc. and SAPMarkets. All other company, product, and brand names may be trademarks of their respective owners.

  • Contents

    Preface.....................................................................................................v Purpose of This Guide ............................................................................................... v Audience.................................................................................................................... v Related Information .................................................................................................. vi How to Use This Guide............................................................................................. vi Documentation Conventions.................................................................................... vii If You Need Help .................................................................................................... viii

    1. Installing XPC on Windows NT..................................................... 1-1 Summary of Setup Steps ....................................................................................... 1-1 System Requirements ............................................................................................ 1-2

    Hardware Requirements .................................................................................. 1-3 Software Prerequisites ..................................................................................... 1-3

    Removing a Previous XPC Installation .................................................................. 1-4 Adding JDK to Path Variable ................................................................................. 1-4 Installing XPC ........................................................................................................ 1-4 Testing the Installation Locally ............................................................................... 1-6

    2. Connecting to MarketSite.............................................................. 2-1 Which Version of MarketSite? ................................................................................ 2-2 Registering in MarketSite 3.x ................................................................................. 2-2 Registering in MarketSite 4.0 ................................................................................. 2-3 Receiving Confirmation Emails .............................................................................. 2-3

    Trading Partner Registration Email .................................................................. 2-3 SonicMQ Broker Registration Confirmation ..................................................... 2-6

    Configuring XPC .................................................................................................... 2-7 Testing Your Installation ........................................................................................ 2-9

    3. Security for Production Systems ................................................. 3-1 Firewall and Network Requirements ...................................................................... 3-1

    Planning for XPC Deployment ......................................................................... 3-2 Internal Firewall Requirements ........................................................................ 3-2 Proxy Firewall Requirements ........................................................................... 3-2

    i

  • Certificate Manager ................................................................................................ 3-3 Authentication for Production Using https .............................................................. 3-3

    Preparation for Authentication .......................................................................... 3-3 Following the Steps .......................................................................................... 3-3

    Authentication for Production Using SonicMQ ....................................................... 3-9 Preparation for Authentication .......................................................................... 3-9 Following the Steps .......................................................................................... 3-9

    Testing Your Production Installation .................................................................... 3-13

    4. Advanced Configuration ............................................................... 4-1 Planning for Special Options .................................................................................. 4-1

    Adjusting Java Heap Size ................................................................................ 4-1 Using Forward Proxy ........................................................................................ 4-2 Using the Versioning Library ............................................................................ 4-2

    Enabling and Disabling the Versioning Library ...................................................... 4-4 Configuring Additional Options .............................................................................. 4-5

    5. Administration................................................................................ 5-1 Starting and Stopping the XPC Server .................................................................. 5-1

    Running XPC as an NT Service ....................................................................... 5-1 Backing Up SonicMQ Keystore .............................................................................. 5-2 XPC Envelope Archive ........................................................................................... 5-3

    XPC Invoker and the Envelope Archive ........................................................... 5-3 Using the XPC Invoker ........................................................................................... 5-4

    XPC Invoker User Interface ............................................................................. 5-4 Transaction Filter ............................................................................................ 5-6 Archive Display ............................................................................................... 5-6 Transaction Table ........................................................................................... 5-6 Envelope ......................................................................................................... 5-7

    Working with Pending Documents ......................................................................... 5-8 Maintaining the XPC Server ................................................................................... 5-9

    Clearing the XPC Log Files .............................................................................. 5-9 Clearing the Archive Directory ....................................................................... 5-10

    Checking Security Certificate for Expiration ......................................................... 5-10

    6. Troubleshooting............................................................................. 6-1 XPC Logging .......................................................................................................... 6-2

    ii

  • Reading Debug Messages ...............................................................................6-2 Reading Event Output ......................................................................................6-4

    Avoiding Known Problems .....................................................................................6-5 XPC Invoker Connection Refused ..........................................................................6-6 Troubleshooting the Versioning Library Service .....................................................6-7

    Verifying Versioning Library ..............................................................................6-7 Versioning Library Transformations ..................................................................6-7 Testing Versioning Library Transformations .....................................................6-8 Document Transformation Tool .......................................................................6-8 Envelope Transformation Tool ........................................................................6-9

    Certificate Manager Keystore ...............................................................