Webmethods Ebxml Module Installation Guide Version 6.0.1 � � � 3

webMethods ebXML Module Installation Guide

VERSION 6.0.1

webMethods, Inc. 3930 Pender Drive Fairfax, VA 22030 USA 703.460.2500 http://www.webmethods.com

webMethods Administrator, webMethods Broker, webMethods Developer, webMethods Installer, webMethods Integration Server, webMethods Mainframe, webMethods Manager, webMethods Modeler, webMethods Monitor, webMethods Workflow, webMethods Trading Networks, and the webMethods logo are trademarks of webMethods, Inc. “webMethods” is a registered trademark of webMethods, Inc. Acrobat, Adobe, and Reader are registered trademarks of Adobe Systems Incorporated. Amdocs and ClarifyCRM are registered trademarks of Amdocs Ltd. Ariba is a registered trademark of Ariba Inc. Baan is a registered trademark of Baan Development NV. BEA is a registered trademark, and WebLogic Platform and WebLogic Server are trademarks of BEA Systems, Inc. BMC Software and PATROL are registered trademarks of BMC Software, Inc. BroadVision is a registered trademark of BroadVision, Inc. Chem eStandards and CIDX are trademarks of Chemical Industry Data Exchange. Unicenter is a registered trademark of Computer Associates International, Inc. Kenan and Arbor are registered trademarks of CSG Systems, Incorporated. SNAP-IX is a registered trademark, and Data Connection is a trademark of Data Connection Ltd. DataDirect, DataDirect Connect, and SequeLink are registered trademarks of DataDirect Technologies. D&B and D-U-N-S are registered trademarks of D&B, Inc. Hewlett-Packard, HP, HP-UX, and OpenView are trademarks of Hewlett- Packard Company. i2 is a registered trademark of i2 Technologies, Inc. AIX, AS/400, CICS, DB2, IBM, Infoprint, Informix, MQSeries, OS/390, OS/400, RACF, RS/6000, SQL/400, S/390, System/390, VTAM, and WebSphere are registered trademarks; and Communications System for Windows NT, IMS, MVS, SQL/DS, Universal Database, and z/OS are trademarks of IBM Corporation. JBoss and JBoss Group are trademarks of Marc Fleury under operation by JBoss Group, LLC. J.D. Edwards and OneWorld are registered trademarks, and WorldSoftware is a trademark of J.D. Edwards. Linux is a registered trademark of Linus Torvalds and others. X Window System is a trademark of Massachusetts Institute of Technology. Merant is a registered trademark of Merant, Inc. MetaSolv is a registered trademark of Metasolv Software, Inc. ActiveX, Microsoft, Outlook, Visual Basic, Windows, and Windows NT are registered trademarks; and SQL Server is a trademark of Microsoft Corporation. Netscape is a registered trademark of Netscape Communications Corporation. New Atlanta and ServletExec are trademarks of New Atlanta Communications, LLC. CORBA is a registered trademark of Object Management Group, Inc. UNIX is a registered trademark of Open Group. Oracle is a registered trademark of Oracle Corporation. PeopleSoft and Vantive are registered trademarks, and PeopleSoft Pure Internet Architecture is a trademark of PeopleSoft, Inc. Infranet and Portal are trademarks of Portal Software, Inc. RosettaNet is a trademark of “RosettaNet,” a non- profit organization. SAP and R/3 are trademarks or registered trademarks of SAP AG. Siebel is a trademark of Siebel Systems, Inc. EJB, Enterprise JavaBeans, Java, JavaServer Pages, JDBC, JSP, J2EE, Solaris, SPARC, SPARCStation, Sun, Sun Microsystems, and SunSoft are trademarks of Sun Microsystems, Inc. SWIFT and SWIFTNet are trademarks of S.W.I.F.T. SCRL. Sybase is a registered trademark of Sybase, Inc. UCCnet is a trademark of UCCnet. VERITAS, VERITAS SOFTWARE, and VERITAS Cluster Server are trademarks of VERITAS Software. W3C is a registered trademark of World Wide Web Consortium. All other marks are the property of their respective owners.

Chapter 1. About This Book ...... 5 Welcome! ...... 6 Conventions ...... 6 Typographical Conventions ...... 6 Program Code Conventions ...... 8 Related Documentation ...... 8 webMethods ebXML Module Documentation ...... 8 webMethods Integration Server Documentation ...... 9 Viewing this Document ...... 9 Printing this Guide ...... 9

Chapter 2. System Requirements ...... 11 Overview ...... 12 Platform and Operating System Requirements ...... 12 Software Requirements ...... 12 webMethods Components ...... 12 Hardware Requirements ...... 12

Chapter 3. Installing webMethods ebXML Module 6.0.1 ...... 13 Overview ...... 14 Running the webMethods Installer ...... 14 Installing Using a Proxy Server, Installation Script, or Installation Image ...... 15 Language Packs ...... 16 Completing the Installation ...... 16 Install on a Windows System ...... 16 Before You Begin ...... 16 Install Using the Wizard ...... 17 Install on a UNIX, AS/400, or OS X System ...... 22 Before You Begin ...... 23 Install Using the Wizard ...... 24 Install Using Console Mode ...... 29 Overwrite webMethods ebXML Module 6.0.1 ...... 33 Before You Begin ...... 34 Overwrite Using the Wizard ...... 34 Overwrite Using Console Mode ...... 35

webMethods ebXML Module Installation Guide Version 6.0.1 3

Contents

Chapter 4. Uninstalling webMethods ebXML Module 6.0.1 ...... 37 Overview ...... 38 Uninstall on a Windows System ...... 38 Uninstall on a UNIX, AS/400, or OS X System ...... 39

Index...... 41

4 webMethods ebXML Module Installation Guide Version 6.0.1

CHAPTER 1

About This Book

Welcome! ...... 6 Conventions ...... 6 Related Documentation ...... 8 Viewing this Document ...... 9 Printing this Guide ...... 9

webMethods ebXML Module Installation Guide Version 6.0.1 5

CHAPTER 1 About This Book

Welcome!

This guide provides system requirements for webMethods ebXML Module 6.0.1 and explains how to install, upgrade to, and uninstall webMethods ebXML Module 6.0.1.

Important! The information in this guide might have been updated since the guide was published. Go to the webMethods Advantage Web site at http://advantage.webmethods.com for the latest version of the guide.

If you are installing the webMethods ebXML Module with webMethods Integration Platform components such as webMethods Integration Server, see the webMethods Integration Platform Installation Guide for instructions on installing those components.

Note: If you are upgrading from webMethods ebXML Module 4.6 to webMethods ebXML Module 6.0.1, follow the upgrade procedures for webMethods Integration Server and webMethods Trading Networks. Backwards compatibility between webMethods ebXML Module 4.6 and webMethods ebXML Module 6.0.1 is not guaranteed.

Conventions

Typographical Conventions

This document uses the following typographical conventions: Convention Example

Procedures are designated by a blue To create a flow service box in the left column. Procedures are presented as a series of numbered steps. 1 On the File menu, click New. Terms that identify elements, The Service field on the Properties tab specifies options, selections, and commands the name of the requested service. on the screen are shown in bold. Storage locations for services on the pub.client:smtp sets a MIME-type e-mail message. Integration Server are shown in a narrow font using the convention folder.subfolder:service. Characters that you must type Type: *Administrators* exactly are shown in a typewriter font.

6 webMethods ebXML Module Installation Guide Version 6.0.1 Conventions

Convention Example Variable information that you must Log on to the proxy server with: change (based on your specific situation or environment) is shown USER proxy_user in italics. PASS proxy_password Input and output variables for a A service in the flow takes a Record List called service are shown in italics. LineItems. Messages that the system displays The server returns the following error to the on the console are shown in a user: typewriter font. Server has reached client limit. Keyboard keys are shown in Press ENTER; then press TAB. uppercase. Keys that you must press Press CTRL+ALT+M. simultaneously are joined with the “+” symbol. Directory paths are shown with the webMethods6\IntegrationServer\config “\” directory delimiter unless the subject is UNIX specific. In these cases, the “/” is used. If you are working in a UNIX environment, substitute a “/” for the “\” shown in the procedures in this book. Information that you must read before beginning a procedure or Important! If the folder is not already that alerts you to negative open in the Navigation Panel, open it consequences of certain actions is before you start the following presented using this notation. procedure.

Notes that provide related, but non- critical, information are presented Note: When you start the product, you using this notation. are prompted to log on to a webMethods Integration Server.

Helpful information (such as shortcuts and alternatives) is Tip! You can also use CTRL+C to copy presented using this notation. an object.

webMethods ebXML Module Installation Guide Version 6.0.1 7

CHAPTER 1 About This Book

Program Code Conventions

For programming code and command syntax, this document uses the following typographical conventions:

Convention Example

Keywords and values that you must type %CoSymbol% exactly as printed are shown in typewriter font. Variable values or parameters that you %VarName% must supply are shown in italics. Keywords or values that are optional are %loop LoopVar [null=NullValue]% enclosed in [ ]. Do not type the [ ] symbols in your own code.

Related Documentation

This sections lists the documentation that webMethods provides with the webMethods ebXML Module. In addition, it lists installation documentation provided with the webMethods Integration Server that you might find useful.

webMethods ebXML Module Documentation

Refer to this book... For... webMethods ebXML Information about the built-in services and IS document types Module Built-In that are contained in the webMethods ebXML Module. Services Reference You will find this book at: Guide webMethods6\IntegrationServer\packages\WmebXML\pub\doc\ wmebXML_BuiltInServices.pdf webMethods ebXML Information about and instructions for running the sample Sample Guide that is included with the webMethods ebXML Module. Before going into production, you should delete the WmebXMLSample package. You will find this book at: webMethods6\IntegrationServer\packages\WmebXML\pub\doc\ wmebXML_SampleGuide.pdf

8 webMethods ebXML Module Installation Guide Version 6.0.1 Viewing this Document

Refer to this book... For... webMethods ebXML Information about how to implement the ebXML Message Module User’s Guide Service Protocol. You will find the book at: webMethods6\IntegrationServer\packages\WmebXML\pub\doc\ wmebXML_UsersGuide.

webMethods Integration Server Documentation

Refer to this book... For... webMethods Information about and instructions for how to install the Integration webMethods Integration Server and related components. Platform You will find this book at: Installation Guide webMethods Advantage Web site at http://webmethods.advantage.com

Viewing this Document

To view this document, which is in PDF format, you must have Acrobat Reader™ 4.0 or later installed on your system. If you have an earlier version of Acrobat Reader, you will receive the following error message when you open this document and Acrobat Reader will not display the images in this document: Could not find the ColorSpace named ‘Cs8.’ If you do not have this software or you do not have the correct version, you can download a free copy from: http://www.adobe.com/supportservice/custsupport/download.html.

Printing this Guide

To produce a hard copy of this guide, print this document from Acrobat Reader.

webMethods ebXML Module Installation Guide Version 6.0.1 9

CHAPTER 1 About This Book

10 webMethods ebXML Module Installation Guide Version 6.0.1

CHAPTER 2

System Requirements

Overview ...... 12 Platform and Operating System Requirements ...... 12 Software Requirements ...... 12 Hardware Requirements ...... 12

webMethods ebXML Module Installation Guide Version 6.0.1 11

CHAPTER 2 System Requirements

Overview

This chapter provides system requirements for webMethods webMethods ebXML Module 6.0.1.

Important! The information in this chapter might have been updated since the guide was published. Go to the webMethods Advantage Web site at http://advantage.webmethods.com for the latest version of the guide.

Platform and Operating System Requirements

The webMethods ebXML Module supports the same platforms as webMethods Integration Server and uses the JRE you install for Integration Server.

Software Requirements

webMethods Components

The table below lists the webMethods components you must install before or at the same time you install the webMethods ebXML Module. The table also lists the webMethods components you must install at some point for the webMethods ebXML Module to operate fully.

Required for Installation Required for Operation Integration Server 6.0.1 Developer 6.0.1 Trading Networks Server 6.0.1 Trading Networks Console 6.0.1

Hardware Requirements

The webMethods ebXML Module has no hardware requirements beyond those of webMethods Integration Server.

12 webMethods ebXML Module Installation Guide Version 6.0.1

CHAPTER 3

Installing webMethods ebXML Module 6.0.1

Overview ...... 14 Install on a Windows System ...... 16 Install on a UNIX, AS/400, or OS X System ...... 22 Overwrite webMethods ebXML Module 6.0.1 ...... 33

webMethods ebXML Module Installation Guide Version 6.0.1 13

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

Overview

This chapter explains how to install webMethods webMethods ebXML Module 6.0.1.

Running the webMethods Installer

You install the webMethods ebXML Module using the webMethods Installer. You can run the installer using different modes, as follows: System Mode Windows wizard or an installation script that uses the wizard UNIX or OS X wizard, an installation script that uses the wizard, or console mode AS/400 console mode

To install using the wizard on a UNIX system, your system must have an X-Windows environment. If errors or warnings occur during the installation, the installer writes the errors and warnings to a file named WmInstallLog.txt and stores the file in the main installation directory (by default, drive:\Program Files\webMethods6 for Windows systems or /opt/webMethods6 for UNIX systems).

Note: Typically, to install webMethods ebXML Module 6.0.1, you download the webMethods Installer and the files for the webMethods ebXML Module from the webMethods Advantage Web site. The Web site, at http://advantage.webmethods.com, is a secure Web site accessed through the Internet. If you are unable to download software, webMethods Customer Operations can provide the webMethods ebXML Module on a CD or through a private FTP site. Contact webMethods Customer Operations at [email protected].

14 webMethods ebXML Module Installation Guide Version 6.0.1 Overview

Installing Using a Proxy Server, Installation Script, or Installation Image

The installer offers advanced options you can use to install, as follows: If your company connects to the Internet through an HTTP or Socks proxy server, you must use that proxy server to install. Your network administrator can provide information on your company’s proxy servers. If you need to create identical installations on multiple machines, you can install from an installation script. To create a script, you run the installer and choose the components and installation options (for example, the installation directory) you want to use on the machines. To install from the script, you enter an installation command that identifies the script; the script downloads the components and creates the installation using the options you specified without any further input from you.

Note: If you need to modify an installation script you have created, contact webMethods Technical Services.

If you need to create installations on machines that cannot go outside your corporate firewall to the webMethods Advantage Web site, you can install from an installation image. When you use this option, you only download the components once, to create the image; no downloading is necessary when you install from the image. To create an image, you run the installer and choose the webMethods components you want to include in the image. If you need only a subset of components (for example, you want the image to include only the webMethods ebXML Module and Integration Server), you can choose just that subset for inclusion. You do not specify any installation options when creating the image. To install from the image, you run the installer and identify the image you want to use. The installer allows you to choose only from the components included in the image, but for each machine on which you install you supply installation options that are appropriate for that machine. You can also use the advanced options in combination, as follows: You can use a proxy server and create a script.

You can use a proxy server and create an image.

You can create a script of installing from an image.

You can use a proxy server and create a script of installing from an image.

webMethods ebXML Module Installation Guide Version 6.0.1 15

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

Language Packs

The webMethods Installer always installs the U.S. English files necessary to run webMethods components. However, for many components, you can also install language packs that provide translated user interfaces, messages, help, and documentation. Most components support multiple languages; you can install as many language packs as you want for those components, and all of the languages installed, including English, will be available to users. Some components, however, support only one language; you can use English, or you can install one language pack for those components, and only that language will be available to users.

Completing the Installation

After you finish installing the webMethods ebXML Module, you should create one or more separate packages on the webMethods Integration Server to contain any custom code that you might write. You can place any custom services into these packages. webMethods recommends that you segregate your code this way whenever possible to make maintenance and future upgrades as simple and straightforward as possible. See the webMethods Integration Server Administrator’s Guide for information about how to create and export packages, and so on.

Install on a Windows System

This section explains how to do the following on a Windows system: Install, create an installation script or image, or install from an installation image using the webMethods Installer wizard Install from an installation script that uses the wizard

Before You Begin

To install the webMethods ebXML Module, you must have Windows system administrator privileges.

Before you begin:

1 Go to the webMethods Advantage Web site at http://advantage.webmethods.com and log in. Click Product Downloads, then download the webMethods Installer for Windows to your machine. The default file name for the installer is webMethodsInstaller601.exe. Your company has at least one license agreement with webMethods. If you are the first person under a particular agreement to try to download webMethods Installer

16 webMethods ebXML Module Installation Guide Version 6.0.1 Install on a Windows System

6.0.1, your browser will display a license agreement. Read the agreement and indicate whether you consent to its terms. If you consent, you can download the installer. 2 Make sure the machine has enough available disk space and virtual memory to run the installer. The installer requires that the machine have about 50MB of available disk space in its system temp directory and about 80MB of available virtual memory. If you are going to install from an image, the machine must have enough additional available disk space to accommodate the image. For example, if the image is 200MB, the machine must have at least 250MB of available disk space in its system temp directory. 3 After you select components to install, the webMethods Installer will download the component files. If your machine is running anti-virus software, the software will scan all the files the installer downloads. This activity can take a long time. If you do not want the software to scan the files, shut down the anti-virus software. 4 Shut down all webMethods components and all other applications that are running on your machine.

Install Using the Wizard

To install, create an installation script or image, or install from an installation image using the wizard: 1 Open Microsoft Explorer, navigate to the directory that contains the webMethods Installer, and start the installer by double-clicking the webMethodsInstaller601.exe file.

Note: By default, the webMethods Installer launches with the JVM options -Xincgc and -Xmx256m. The -Xincgc option enables incremental garbage collection. The -Xmx option allows Java to use more memory than it uses by default, in case you are installing many components or are creating an installation image. If you are creating an installation image for a platform that is different from the one on which you are running the installer (for example, you are going to create an image for a Solaris platform and you are running the installer on a Windows platform), the installer needs still more memory.

If you want to allow Java to use more than 256MB of memory, open a command window, navigate to the directory that contains the webMethods Installer, and start the installer using a command that specifies the amount of memory to allow. For example, enter this command:

webMethodsInstaller601.exe -Xmx512m -Xincgc

The installer displays the Welcome panel.

webMethods ebXML Module Installation Guide Version 6.0.1 17

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

2 If you want to install without using any advanced options, click Next. The installer displays the User Name and Password panel. If you want to use advanced options, click Advanced Options. The installer displays the Advanced Options dialog box. Choose from the options listed below. (For information on each option and on the options you can use together, see “Installing Using a Proxy Server, Installation Script, or Installation Image” on page 15 in this guide.)

Important! If your company connects to the Internet through an HTTP or Socks proxy server, you must use that proxy server to install. Your network administrator can provide information on your company’s proxy servers.

Option Action Identify your server If you have created your own server from which to download and the the webMethods components, select the Specify webMethods webMethods Installer server and platform manually check box. platform to install In the Server URL box, type the URL for your server (for example, http://machine/cgi-bin/script.cgi). In the webMethods platform box, click 6.0.1. Use an HTTP proxy Select the Use proxy server check box, then click HTTP proxy. server to install In the Host box, type the host name or fully qualified IP address of the proxy server. In the Port box, type the port used by the proxy server. In the User Name and Password boxes, type the user name and password for the installer to use to log on to the proxy server. Use a Socks proxy Select the Use proxy server check box, then click Socks proxy. server to install In the Host box, type the host name or fully qualified IP address of the proxy server. In the Port box, type the port used by the proxy server. Create a script Select the Create installation script check box. In the Script file name box, enter the fully qualified name of the file in which to save the script. If the file does not exist, the installer will create it for you. You can specify any name you want for the file, and you do not have to specify an extension.

18 webMethods ebXML Module Installation Guide Version 6.0.1 Install on a Windows System

Option Action Create an image Select the Use installation image check box, then click Create image. In the Image file name box, type the fully qualified name of the file in which to save the image. If the file does not exist, the installer will create it for you. You can specify any name you want for the file, and you do not have to specify an extension. In the Image platform list, click the platform for which you are creating the image. You can create an image for any platform from any platform. Install from an Select the Use installation image check box, then click Install from image image. In the Image file name box, type the fully qualified name of the file that contains the image from which you want to install. Replace corrupt See “Overwrite webMethods ebXML Module 6.0.1” on page 33 installation by in this guide. overwriting all files, including user data

Click OK. The installer closes the dialog box and returns to the Welcome panel. Click Next. The installer displays the User Name and Password panel. 3 If you did not specify your own server and the version of the webMethods ebXML Module to install on the Advanced Options dialog box, choose the version of the webMethods ebXML Module to install (6.0.1), then choose the webMethods Installer server from which you want to download webMethods components.

Important! Different servers are used for different platform versions, so you must choose the platform version to install before you choose the server to use.

Click Next. The installer displays the Component Selection panel.

webMethods ebXML Module Installation Guide Version 6.0.1 19

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

5 Choose to install the webMethods ebXML Module, related items like documentation, and any required webMethods components. The installer lists components using a tree structure. The two highest levels show general headings, the next level shows component headings, and the subsequent levels show the items that make up or are related to the component. For example: - webMethods Integration Platform - eStandards - webMethods ebXML Module - Documentation 6.0.1 - Program Files 6.0.1 - Samples 6.0.1 To display the headings or items under a particular heading, click the plus sign (+) next to the heading. To hide the headings or item under a particular heading, click the minus sign (-) next to the heading. If you have already installed an item in the specified root directory, the item and the check box next to the item are grayed out. If you want to install the minimum recommended set of items for a component, select the check box next to the component heading (for example, select the check box for webMethods ebXML Module). The installer automatically selects the check box for each of the recommended items. If you want to install only items you choose for a component, select the check box for each of the items (for example, select the check boxes for Program Files and Documentation under webMethods ebXML Module). The installer also selects the check box next to the component heading. When you are done selecting the webMethods ebXML Module and related items to install, click Next. If the directory into which you are installing does not include components that are required by the components you selected for installation, the installer asks whether you want it to select the required components for you. The panel that the installer displays next depends on the components you have chosen to install, as explained below. 6 If language packs are available for the webMethods ebXML Module or for other components you are installing or have already installed, the installer displays the Language Packs panel. Select the packs to install.

20 webMethods ebXML Module Installation Guide Version 6.0.1 Install on a Windows System

Important! The components on which the ebXML module is dependent (webMethods for Trading Networks, webMethods Integration Server, and webMethods Developer) have been certified and tested for international support. Users should refer to the Globalization section of those products's readme.txt files for information about the limitations of those products before using the ebXML module in an international environment.

The default character encoding for ebXML envelopes, as defined by the ebXML and XML 1.0 standards, is Unicode UTF-8. Although the underlying webMethods Integration Platform components that process the envelope support XML character encoding declarations correctly, this has not been tested in conjunction with the ebXML Module. Attempts to process ebXML envelopes that use other character encodings may not work correctly. As a result, ebXML envelopes in character encodings other than UTF-8 are not supported.

Each ebXML payload is handled as separate multi-part MIME content and is not processed directly by the ebXML Module. Instead it is passed as a byte stream to or from your service or application along with the MIME headers associated with it. Support for character encodings rests, therefore, entirely with your process model, application or Integration Server service. The MIME Content-Type will determine how each payload block should be processed. When working with textual data, setting the character encoding (charset) is an important way to ensure that the content is properly processed by the receiver. Please refer to the Integration Server and Developer user's guides and readme files for more information about working with character encodings in the webMethods Integration Platform.

When you are done, click Next. The installer displays the Release Information panel. 7 If you want to view the Release Notes or Global Support Statement for webMethods Integration Platform 6.0.1, or the readme for the webMethods ebXML Module or other components you are installing, click the appropriate link. When you are done, click Next. The installer displays the Installation Summary panel. 8 Review the list of items you have selected for install. If the list is correct, click Next. The installer installs the items, then displays the Installation Complete panel. 9 Click Close.

webMethods ebXML Module Installation Guide Version 6.0.1 21

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

Install from an Installation Script that Uses the Wizard

To install from an installation script, you must have already created the script using the instructions in “Install Using the Wizard” on page 17.

Important! If errors occur while an installation script is running, the installation fails.

To install from an installation script that uses the wizard:

1 Open a command window and navigate to the directory that contains the webMethods Installer. 2 Start the installer by entering the command shown below, where script_file is the fully qualified name of the file containing the installation script from which to install: webMethodsInstaller601.exe -silent script_file The installer displays the wizard’s panels as it runs the script.

Install on a UNIX, AS/400, or OS X System

This section explains how to do the following: Install, create an installation script or image, or install from an installation image using the webMethods Installer wizard. You can use the wizard to install on UNIX and OS X systems. Install from an installation script that uses the wizard. You can install from a script that uses the wizard on UNIX and OS X systems. Install from the webMethods Installer, create or install from an installation script, or create or install from an installation image using the webMethods Installer console mode. You can use console mode to install locally or remotely on UNIX and AS/400 systems; you can only use it to install locally on OS X systems. To install using the wizard on a UNIX system, your system must have an X-Windows environment.

Note: When you run the webMethods Installer on an AS/400 system, the installer experiences display problems. While these display problems will not adversely affect the installation process, webMethods strongly recommends that you minimize the problems by running the installer from an AS/400 client for Windows rather than from a telnet client.

22 webMethods ebXML Module Installation Guide Version 6.0.1 Install on a UNIX, AS/400, or OS X System

Before You Begin

To run the webMethods Installer on an AIX, AS/400, Linux, or OS X system, you must have JRE 1.3 installed. To run the installer on an HP-UX or Solaris system, you must have JRE 1.3.1 installed.

Before you begin:

1 Go to the webMethods Advantage Web site at http://advantage.webmethods.com and log in. Click Product Downloads, then download the webMethods Installer for UNIX to the local or remote machine on which you want to run the installer. The default file name for the installer is webMethodsInstaller601.jar. Your company has at least one license agreement with webMethods. If you are the first person under a particular agreement to try to download webMethods Installer 6.0.1, your browser will display a license agreement. Read the agreement and indicate whether you consent to its terms. If you consent, you can download the installer. 2 Make sure the machine on which you are going to run the installer has enough available disk space and virtual memory. The installer requires that the machine have about 50MB of available disk space in its temporary directory and about 80MB of available virtual memory. If you are going to install from an image, the machine must have enough additional available disk space to accommodate the image. For example, if the image is 200MB, the machine must have at least 250MB of available disk space in its temporary directory. 3 After you select components to install, the webMethods Installer will download the component files. If your machine is running anti-virus software, the software will scan all the files the installer downloads. This activity can take a long time. If you do not want the software to scan the files, shut down the anti-virus software. 4 If you are going to install the webMethods ebXML Module on a remote machine and you want to install using the wizard or an installation script that uses the wizard, follow these steps: a Enable the display of the local machine using the command shown below, where remote_host is the remote machine on which you are going to install: xhost +remote_host b Log on to the remote machine. c Set the DISPLAY variable on the remote machine to point to the local machine. For example, if you are using a bash shell and are installing from a local machine named installer and want to set the DISPLAY to the default device, enter: export DISPLAY=installer:0.0 5 Shut down all webMethods components and all other applications that are running on the machine on which you are going to install the webMethods ebXML Module.

webMethods ebXML Module Installation Guide Version 6.0.1 23

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

Install Using the Wizard

To install, create an installation script or image, or install from an installation image using the wizard: 1 Navigate to the directory that contains the webMethods Installer and start the installer by entering this command: java -jar webMethodsInstaller601.jar If you are going to install many components or create an installation image, the installer might need more memory than Java provides by default. If you are going to create an installation image for a platform that is different from the one on which you are running the installer (for example, you are going to create an image for an HP-UX platform and you are running the installer on a Solaris platform), the installer uses still more memory. On the command, specify parameters that allow Java to use more memory and enable incremental garbage collection as the first two parameters. For example, enter this command:

allocates more memory

java -Xmx512m -Xincgc -jar webMethodsInstaller601.jar

enables incremental garbage collection

The installer displays the Welcome panel. 2 If you want to install without using any advanced options, click Next. The installer displays the User Name and Password panel. If you want to use advanced options, click Advanced Options. The installer displays the Advanced Options dialog box. Choose from the options listed below. (For information on each option and on the options you can use together, see “Installing Using a Proxy Server, Installation Script, or Installation Image” on page 15 in this guide.)

24 webMethods ebXML Module Installation Guide Version 6.0.1 Install on a UNIX, AS/400, or OS X System

webMethods ebXML Module Installation Guide Version 6.0.1 25

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

Option Action Install from an Select the Use installation image check box, then click Install from image image. In the Image file name box, type the fully qualified name of the file that contains the image from which you want to install. Replace corrupt See “Overwrite webMethods ebXML Module 6.0.1” on page 33 installation by in this guide. overwriting all files, including user data

Important! Different servers are used for different platform versions, so you must choose the platform version to install before you choose the server to use.

In addition, supply the user name and password you use to log in to the Advantage Web site. Click Next. The installer displays the Installation Directory panel. 4 Specify that you want to install webMethods ebXML Module in the webMethods installation directory (by default, /opt/webMethods6), then click Next. The installer will automatically install the webMethods ebXML Module in the Integration Server 6.0.1 installation directory. Click Next. The installer displays the Component Selection panel. 5 Choose to install the webMethods ebXML Module, related items like documentation, and any required webMethods components. The installer lists components using a tree structure. The two highest levels show general headings, the next level shows component headings, and the subsequent levels show the items that make up or are related to the component. For example: - webMethods Integration Platform - eStandards - webMethods ebXML Module - Documentation 6.0.1 - Program Files 6.0.1 - Samples 6.0.1 To display the headings or items under a particular heading, click the plus sign (+) next to the heading. To hide the headings or item under a particular heading, click the

26 webMethods ebXML Module Installation Guide Version 6.0.1 Install on a UNIX, AS/400, or OS X System

minus sign (-) next to the heading. If you have already installed an item in the specified root directory, the item and the check box next to the item are grayed out. If you want to install the minimum recommended set of items for a component, select the check box next to the component heading (for example, select the check box for webMethods ebXML Module). The installer automatically selects the check box for each of the recommended items. If you want to install only items you choose for a component, select the check box for each of the items (for example, select the check boxes for Program Files and Documentation under webMethods ebXML Module). The installer also selects the check box next to the component heading. When you are done selecting the webMethods ebXML Module and related items to install, click Next. If the directory into which you are installing does not include components that are required by the components you selected for installation, the installer asks whether you want it to select the required components for you. The panel that the installer displays next depends on the components you have chosen to install, as explained below. 6 If language packs are available for the webMethods ebXML Module or for other components you are installing or have already installed, the installer displays the Language Packs panel. Select the packs to install.

webMethods ebXML Module Installation Guide Version 6.0.1 27

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

Install from an Installation Script that Uses the Wizard

To install from an installation script, you must have already created the script using the instructions in “Install Using the Wizard” on page 24.

Important! If errors occur while an installation script is running, the installation fails.

To install from an installation script that uses wizard:

28 webMethods ebXML Module Installation Guide Version 6.0.1 Install on a UNIX, AS/400, or OS X System

1 Navigate to the directory that contains the webMethods Installer. 2 Start the installer by entering the command shown below, where script_file is the fully qualified name of the file that contains the installation script from which to install: java -jar webMethodsInstaller601.jar -silent script_file The installer displays the wizard’s panels as it runs the script.

Install Using Console Mode

To install, create or install from an installation script, or create or install from an installation image using the console mode: 1 Navigate to the directory that contains the webMethods Installer and start the installer by entering this command: java -jar webMethodsInstaller601.jar -console If you are going to install many components or create an installation image, the installer might need more memory than Java provides by default. If you are going to create an installation image for a platform that is different from the one on which you are running the installer (for example, you are going to create an image for an HP-UX platform and you are running the installer on a Solaris platform), the installer uses still more memory. On the command, specify parameters that allow Java to use more memory and enable incremental garbage collection as the first two parameters. For example, enter this command:

allocates more memory

java -Xmx512m -Xincgc -jar webMethodsInstaller601.jar -console

enables incremental garbage collection

If you want to use a proxy server, create or run an installation script, create or run an installation image, or use some combination of these options, add the parameters listed below after java -jar webMethodsInstaller601.jar on the command. You do not have to specify the parameters for the advanced options in any particular order. For information on each option and on the options you can use together, see “Installing Using a Proxy Server, Installation Script, or Installation Image” on page 15.

webMethods ebXML Module Installation Guide Version 6.0.1 29

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

Option Variables Specify webMethods Installer server and platform -URLBase If you have created your own server from which to download the webMethods ebXML Module, URL for the server (for example, http://machine/cgi-bin/script.cgi). -serverVersion Version of the webMethods ebXML Module to install. Values are 4.6, 6.0, and 6.0.1. Use an HTTP proxy server to install -proxyHost host Host name or fully qualified IP address of the proxy server. -proxyPort port Number of the port used by the proxy server. -proxyUser username User name for the installer to use to log on to the proxy server. -proxyPassword password Password for the installer to use to log on to the proxy server. Use a Socks proxy server to install -socksProxyHost host Host name or fully qualified IP address of the proxy server. -socksProxyPort port Number of the port used by the proxy server. Create a script -createScript script_file Fully qualified name of the file in which to save the installation script. Install from a script -silent script_file Fully qualified name of the file that contains the installation script from which to install.

Important! If any errors occur while you are running an installation script, the installation fails.

30 webMethods ebXML Module Installation Guide Version 6.0.1 Install on a UNIX, AS/400, or OS X System

Option Variables Create an image -createImage image_file Fully qualified name of the file in which to save the installation image. -imagePlatform platform Platform for which you are creating the image. You can create an image for any platform from any platform. Valid value are as follows:

Platform Value

Windows WNT Solaris SOL AIX AIX HP-UX HP11 Linux LNX AS/400 AS400 Mac OS X

The default is the platform on which you are running the installer. Install from a image -launchImage image_file Fully qualified name of the file that contains the installation image from which to install.

2 If you did not specify your own server and the version of the webMethods ebXML Module to install on the command you used to start the installer, when prompted, choose the version of the webMethods ebXML Module to install. Then choose the webMethods Installer server from which you want to download the webMethods ebXML Module. 3 When prompted, provide the user name and password you use to log in to the webMethods Advantage Web site. 4 When prompted, specify that you want to install the webMethods ebXML Module in the webMethods installation directory (by default, /opt/webMethods6). The installer will automatically install the webMethods ebXML Module in the Integration Server 6.0.1 installation directory.

webMethods ebXML Module Installation Guide Version 6.0.1 31

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

5 When prompted, choose to install the webMethods ebXML Module, related items like documentation, and any required webMethods components. The installer lists components using a tree structure. The two highest levels show general headings, the next level shows component headings, and the subsequent levels show the items that make up or are related to the component. For example: - webMethods Integration Platform - eStandards - webMethods ebXML Module - Documentation 6.0.1 - Program Files 6.0.1 - Samples 6.0.1 The installer can display only a limited number of components at a time. To page forward through the list, enter a plus sign (+). To page backward through the list, enter a minus sign (-). If you have already installed an item in the specified root directory, the installer shows an I next to the item. If you want to install the minimum recommended set of items for a component, enter the number shown next to the component heading (for example, enter the number for webMethods ebXML Module). The installer shows an X next to each of the recommended items listed under the component. If you want to install only items you choose for a component, enter the number for each of those items (for example, enter the number for Program Files under webMethods ebXML Module). You must enter each number on a separate line. The installer shows an X next to each item you select. When all items are selected for a component, the installer shows an X next to the component heading. If only certain items are selected for a component, the installer shows a pound sign (#) next to the component heading. When you are done selecting the webMethods ebXML Module and related items to install, press ENTER twice. If the directory into which you are installing does not include components that are required by the components you selected for installation, the installer asks whether you want it to select the required components for you. 6 If language packs are available for the webMethods ebXML Module or for other components you are installing or have already installed, enter the number for each language pack you want to install.

32 webMethods ebXML Module Installation Guide Version 6.0.1 Overwrite webMethods ebXML Module 6.0.1

7 Review the list of items you have selected for install. If the list is correct, press ENTER. The installer installs the items.

Overwrite webMethods ebXML Module 6.0.1

If your webMethods ebXML Module installations has been corrupted, or if you accidentally deleted some files from a component directory, you can overwrite the components using the webMethods Installer.

Important! Only overwrite components in the most extreme cases. Overwriting not only overwrites the component installations, it overwrites all related files you have created or customized.

If the installation you are overwriting includes program files that are not included in the new version, those files remain (unused) in the installation.

webMethods ebXML Module Installation Guide Version 6.0.1 33

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

Before You Begin

Before you begin:

1 Shut down the webMethods components you are going to overwrite. 2 If you want to save files you have created or customized, copy them to a different directory.

Overwrite Using the Wizard

For more detailed instructions on tasks in this section, see the Windows section “Install Using the Wizard” on page 17 or the UNIX or OS X section “Install Using the Wizard” on page 24, as appropriate.

To overwrite using the webMethods Installer wizard:

1 If you want to overwrite from an installation image, create the image. 2 Start the webMethods Installer. 3 On the installer Welcome page, click Advanced Options. The installer displays the Advanced Options dialog box. 4 Complete the dialog box as follows: a Select the Replace corrupt installation by overwriting all files, including user data check box. b If you want to use a proxy server, select the Use proxy server check box and provide the required information. c If you are overwriting from an image, select the Use installation image check box and provide the required information. 5 Choose the components you want to overwrite. 6 Move any user-created or customized files you copied earlier back to the appropriate location in the new installation.

34 webMethods ebXML Module Installation Guide Version 6.0.1 Overwrite webMethods ebXML Module 6.0.1

Overwrite from an Installation Script that Uses the Wizard

For more detailed instructions on tasks in this section, see the Windows section “Install from an Installation Script that Uses the Wizard” on page 22 or the UNIX or OS X section “Install from an Installation Script that Uses the Wizard” on page 28, as appropriate.

Important! If errors occur while you are running an installation script, the installation fails.

To overwrite from an installation script using the webMethods Installer wizard:

1 Create the installation script from which you want to overwrite. 2 Start the webMethods Installer and identify the installation script, but add this parameter to the start command: -overwriteInstall 3 Move any user-created or customized files you copied earlier back to the appropriate location in the new installation.

Overwrite Using Console Mode

For more detailed instructions on tasks in this section, see “Install Using Console Mode” on page 29.

To overwrite using console mode:

1 If you want to overwrite from an installation script or image, create the script or image. 2 Start the webMethods Installer but add this parameter to the start command: -overwriteInstall If you want to use a proxy server, also specify the parameter for that option. If you are overwriting from an installation script or image, specify the parameter for that option as well.

Important! If errors occur while an installation script is running, the installation fails.

3 If you are not overwriting from an installation script, choose the components you want to overwrite. 4 Move any user-created or customized files you copied earlier back to the appropriate location in the new installation.

webMethods ebXML Module Installation Guide Version 6.0.1 35

CHAPTER 3 Installing webMethods ebXML Module 6.0.1

36 webMethods ebXML Module Installation Guide Version 6.0.1

CHAPTER 4

Uninstalling webMethods ebXML Module 6.0.1

Overview ...... 38 Uninstall on a Windows System ...... 38 Uninstall on a UNIX, AS/400, or OS X System ...... 39

webMethods ebXML Module Installation Guide Version 6.0.1 37

CHAPTER 4 Uninstalling webMethods ebXML Module 6.0.1

Overview

You uninstall the webMethods ebXML Module using the webMethods Uninstaller. The webMethods Installer installed all files needed to run the uinstaller. You can run the uninstaller using different modes, as follows: System Mode Windows wizard UNIX or OS X wizard or console mode AS/400 console mode

To uninstall using the wizard on a UNIX system, your system must have an X-Windows environment. If errors or warnings occur during the uninstallation, the uninstaller writes the errors and warnings to a file named WmUninstallLog.txt and stores the file in the main installation directory (by default, webMethods6).

Uninstall on a Windows System

To uninstall the webMethods integration platform, you must have Windows system administrator privileges.

To uninstall webMethods ebXML Module 6.0.1:

1 Shut down all webMethods components and all other applications that are running on your machine.

Important! If you do not shut down all webMethods components and applications, the uninstaller will not be able to remove key files that are locked by the operating system.

2 Use the Windows Add/Remove Programs utility, available from the Control Panel, to start the uninstaller. 3 Select webMethods 6.0.1 as the program to uninstall. 4 In the webMethods Uninstaller Welcome panel, click Next.

38 webMethods ebXML Module Installation Guide Version 6.0.1 Uninstall on a UNIX, AS/400, or OS X System

5 In the Component Selection panel, under eStandards, click webMethods ebXML Module, and then click Next. 6 Click Next. 7 In the Uninstall Complete panel, click Close. The uninstaller removes all webMethods ebXML Module-related files that were installed into the webMethods6\IntegrationServer\packages\WmebXML directory. The uninstaller does not delete files created after you installed the webMethods ebXML Module (for example, user-created or configuration files), nor does it delete the directory structure that contains the files. 8 If you do not want to save the files the uninstaller did not delete, navigate to the webMethods6\IntegrationServer\packages\WmebXML directory and delete the directory.

Uninstall on a UNIX, AS/400, or OS X System

To uninstall using the wizard on a UNIX system, your system must have an X-Windows environment.

Important! When you run the webMethods Uninstaller on an AS/400 system, the uninstaller experiences display problems. While these display problems will not adversely affect the installation process, webMethods strongly recommends that you minimize the problems by running the uninstaller from an AS/400 client for Windows rather than from a telnet client.

To uninstall webMethods ebXML Module 6.0.1:

1 Log on as the same user that installed the webMethods ebXML Module. 2 If the webMethods ebXML Module you are uninstalling is located on a remote machine and you want to use a graphical uninstaller, follow these steps: a Enable the display of the local machine using the command shown below, where remote_host is the remote machine from which to uninstall: xhost +remote_host b Log on to the remote machine. c Set the DISPLAY variable on the remote machine to point to the local machine. For example, if you are using a bash shell and are uninstalling from a local machine named uninstaller and want to set the DISPLAY to the default device, enter: export DISPLAY=uninstaller:0.0

webMethods ebXML Module Installation Guide Version 6.0.1 39

CHAPTER 4 Uninstalling webMethods ebXML Module 6.0.1

3 Shut down all webMethods components and all other applications that are running on the machine that contains the webMethods ebXML Module you are uninstalling.

Important! If you do not shut down all components and applications, or the uninstaller will not be able to remove key files that are locked by the operating system.

4 Navigate to the webMethods_directory/bin directory and enter the appropriate command, as follows: Uninstall Mode Command

Wizard uninstall Console mode uninstall -console

5 Select webMethods ebXML Module as the program to uninstall. The uninstaller removes all webMethods ebXML Module-related files that were installed into the webMethods6\IntegrationServer\packages\WmebXML directory. The uninstaller does not delete files created after you installed the webMethods ebXML Module (for example, user-created or configuration files), nor does it delete the directory structure that contains the files. 6 If you do not want to save the files the uninstaller did not delete, navigate to the webMethods6\IntegrationServer\packages\WmebXML directory and delete the directory.

40 webMethods ebXML Module Installation Guide Version 6.0.1 Index

A from an installation script on a Windows system 22 advanced options on a remote UNIX machine 23 description of 15 on a UNIX system using a wizard 28 use to install 18, 24, 29 on a UNIX system using console mode 29 valid combinations of 15 on a Windows system using a wizard 17 AS/400 systems on machines that cannot go outside firewall 15 uninstaller display problems 39 specify server to download from 18, 25, 30 use a proxy server to 15, 18, 25, 30 C installation image create 19, 25, 31 command line, use to install from an installation script on a description of 15 Windows system 22 extra memory required to create 17, 24, 29 console mode extra memory required to install from 17, 23 use to uninstall on a UNIX system 39 install from 19, 26, 31 console mode, use to install on a UNIX system 29 installation log file 14 conventions used in this document installation script program code conventions 8 create 18, 25, 30 corrupt installations, overwrite 33 description of 15 create install from on a UNIX system 29, 30 an installation image 19, 25, 31 install from on a Windows system 22 an installation script 18, 25, 30 installer install mode choices 14 D display problems on AS/400 systems 39 L documentation language packs 16 conventions used 6 log file printing 9 for installation 14 program code conventions used 8 for uninstallation 38 related manuals 8 viewing 9 M F Monitor uninstall 6.0 39, 40 firewall, install on machines that cannot go outside of 15 O I overwrite corrupt installations 33 install display problems on AS/400 systems 39 P from an installation image 19, 26, 31 from an installation script on a UNIX system 29, 30 PDF, viewing 9

webMethods ebXML Module Installation Guide Version 6.0.1 41

Index

printing this guide 9 use to install on UNIX systems 28 program code conventions 8 use to install on Windows systems 17 proxy server, use to install 15, 18, 25, 30 use to uninstall on a UNIX system 39 use to uninstall on a Windows system 38 R WmInstallLog.txt file 14 reinstall corrupt installations 33 WmUninstallLog.txt file 38 remote UNIX machine, install on 23 remote UNIX machine, uninstall from 39 replace corrupt installations 33

S script, description of 15

T typographical conventions 6

U uninstall Monitor 6.0 39, 40 on a remote UNIX machine 39 on a UNIX system using a wizard 39 on a UNIX system using console mode 39 on a Windows system using a wizard 38 uninstallation log file 38 uninstaller, uninstall mode choices 38

V viewing documentation in PDF format 9

W webMethods Installer install mode choices 14 server, specify 18, 25, 30 start as wizard on UNIX system 24 start as wizard on Windows system 17 start for UNIX console mode 29 webMethods Uninstaller run as a wizard on a UNIX system 39 run as a wizard on a Windows system 38 run in UNIX console mode 39 uninstall mode choices 38 wizard

42 webMethods ebXML Module Installation Guide Version 6.0.1