Webmethods Rosettanet Module Installation Guide

webMethods RosettaNet 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.

Contents

Chapter 1. About This Book ...... 5 Welcome! ...... 6 Conventions ...... 6 Typographical Conventions ...... 6 Program Code Conventions ...... 7 Viewing this Document ...... 8 Printing this Guide ...... 8

Chapter 2. System Requirements ...... 9 Overview ...... 10 Platform and Operating System Requirements ...... 10 Software Requirements ...... 10 webMethods Components ...... 10 Hardware Requirements ...... 10

Chapter 3. Installing webMethods RosettaNet Module 6.0.1 ...... 11 Overview ...... 12 Running the webMethods Installer ...... 12 Installing Using a Proxy Server, Installation Script, or Installation Image ...... 13 Language Packs ...... 14 Completing the Installation ...... 14 Install on a Windows System ...... 14 Before You Begin ...... 14 Install Using the Wizard ...... 15 Install from an Installation Script ...... 19 Install on a UNIX, AS/400, or OS X System ...... 19 Before You Begin ...... 20 Install Using the Wizard ...... 21 Install From an Installation Script that Uses the Wizard ...... 25 Install Using Console Mode ...... 25 Overwrite webMethods RosettaNet Module 6.0.1 ...... 29 Before You Begin ...... 29 Overwrite Using the Wizard ...... 29 Overwrite From an Installation Script that Uses the Wizard ...... 30 Overwrite Using Console Mode ...... 30 What About RosettaNet PIP Archives? ...... 31

webMethods RosettaNet Module Installation Guide Version 6.0.1 3

Contents

Chapter 4. Upgrading to webMethods RosettaNet Module 6.0.1 ...... 33 Overview ...... 34 Upgrade from webMethods RosettaNet Module 4.x ...... 34 Upgrade from webMethods RosettaNet Module 1.x ...... 38

Chapter 5. Uninstalling webMethods RosettaNet Module 6.0.1 ...... 41 Overview ...... 42 Uninstall on a Windows System ...... 42 Uninstall on a UNIX, AS/400, or OS X System ...... 43

Index...... 45

4 webMethods RosettaNet Module Installation Guide Version 6.0.1 CHAPTER 1

About This Book

Welcome! ...... 6 Conventions ...... 6 Viewing this Document ...... 8 Printing this Guide ...... 8

webMethods RosettaNet Module Installation Guide Version 6.0.1 5

CHAPTER 1 About This Book

Welcome!

This guide provides system requirements for the webMethods RosettaNet Module Version 6.0.1 and explains how to install, upgrade to, and uninstall webMethods RosettaNet Module Version 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 RosettaNet Module with webMethods Integration Platform components, such as the webMethods Integration Server, see the webMethods Integration Platform Installation Guide for instructions to install those components.

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. 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.

6 webMethods RosettaNet Module Installation Guide Version 6.0.1 Conventions

Convention Example 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 webMethods\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.

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.

webMethods RosettaNet Module Installation Guide Version 6.0.1 7

CHAPTER 1 About This Book

Convention Example

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.

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.

8 webMethods RosettaNet Module Installation Guide Version 6.0.1 CHAPTER 2

System Requirements

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

webMethods RosettaNet Module Installation Guide Version 6.0.1 9

CHAPTER 2 System Requirements

Overview

This chapter provides system requirements for the webMethods RosettaNet Module.

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 RosettaNet 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 RosettaNet Module. The table also lists the webMethods components you must install at some point for the webMethods RosettaNet 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 Modeler 6.0.1 Monitor 6.0.1

Hardware Requirements

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

10 webMethods RosettaNet Module Installation Guide Version 6.0.1 CHAPTER 3

Installing webMethods RosettaNet Module 6.0.1

Overview ...... 12 Install on a Windows System ...... 14 Install on a UNIX, AS/400, or OS X System ...... 19 Overwrite webMethods RosettaNet Module 6.0.1 ...... 29 What About RosettaNet PIP Archives? ...... 31

webMethods RosettaNet Module Installation Guide Version 6.0.1 11

CHAPTER 3 Installing webMethods RosettaNet Module 6.0.1

Overview

This chapter explains how to install the webMethods RosettaNet Module.

If you are installing the webMethods RosettaNet Module with the webMethods integration platform components, such as the webMethods Integration Server, see the webMethods Integration Platform Installation Guide for instructions to install those components.

Running the webMethods Installer

You install the webMethods RosettaNet 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 RosettaNet Module 6.0.1, you download the webMethods Installer and the files for the webMethods RosettaNet Module from the Advantage Web site, a secure Web site accessed through the Internet. If you are unable to download software, webMethods Customer Operations can provide the webMethods RosettaNet Module on a CD or through a private FTP site. Contact webMethods Customer Operations at [email protected].

12 webMethods RosettaNet 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 Advantage Web site, you can install from an installation image. When you use this option, you download the components from the Advantage Web site once to create the image. It is not necessary to download anything 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 RosettaNet 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 that 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 also can 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 RosettaNet Module Installation Guide Version 6.0.1 13

CHAPTER 3 Installing webMethods RosettaNet 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 also can 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 RosettaNet 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 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 RosettaNet Module User’s Guide and 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 (see “Install Using the Wizard” on page 15 in this chapter) Install from an installation script that uses the wizard (see “Install from an Installation Script” on page 19 in this chapter)

Before You Begin

To install the webMethods RosettaNet 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, and 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

14 webMethods RosettaNet 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 that 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 RosettaNet Module Installation Guide Version 6.0.1 15

CHAPTER 3 Installing webMethods RosettaNet 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 13 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 and the If you have created your own server from which to webMethods platform to download webMethods integration platform install components, select the Specify webMethods Installer server and platform manually check box. 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 server to Select the Use proxy server check box, then click HTTP install proxy. 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 server to Select the Use proxy server check box, then click Socks install proxy. 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.

16 webMethods RosettaNet 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 image Select the Use installation image check box, then click Install from 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 installation For more information about overwriting webMethods by overwriting all files, components, see the webMethods Integration Platform including user data Installation Guide.

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 RosettaNet Module to install on the Advanced Options dialog box, choose the version of the webMethods RosettaNet Module to install (6.0.1), then choose the webMethods Installer server from which you want to download platform 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.

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 the webMethods RosettaNet Module in the webMethods installation directory (by default, drive:\Program Files\webMethods6). The installer will automatically install the webMethods RosettaNet Module in the Integration Server 6.0.1 installation directory. Click Next. The installer displays the Component Selection panel.

webMethods RosettaNet Module Installation Guide Version 6.0.1 17

CHAPTER 3 Installing webMethods RosettaNet Module 6.0.1

5 Choose to install webMethods RosettaNet Module, webMethods RosettaNet Module documentation, and any required webMethods components. The installer lists components using a tree structure, as illustrated in the following figure.

Component Selection Panel

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 want to install all items listed under a component heading, select the check box next to the component heading (for example, select the check box for the webMethods RosettaNet Module). The installer automatically selects the check box (D) for every item listed under the component. If you want to install only certain items listed under a component heading, select the check box (D) for each of the items (for example, select the check boxes for Program Files and Documentation under webMethods RosettaNet Module). The installer also grays out the check box next to the component heading. When you are done selecting the webMethods RosettaNet 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 RosettaNet Module or for other components you are installing or have already installed, the installer displays the Language Packs panel. Select the packs to install. The webMethods RosettaNet Module supports only one language. You can use the default, English, or you can install one language pack, and only that language will be available to users. When you are done, click Next. The installer displays the Release Information panel.

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

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 RosettaNet 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.

Install from an Installation Script

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

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

To install from an installation script

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 you want to install: webMethodsInstaller601.exe -silent script_file The installer displays the installation panels as it runs the script.

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

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.

webMethods RosettaNet Module Installation Guide Version 6.0.1 19

CHAPTER 3 Installing webMethods RosettaNet Module 6.0.1

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

Important! 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.

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 RosettaNet Module on a remote machine and you want to install using the wizard or an installation script, 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 want to install: xhost +remote_host

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

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 RosettaNet Module.

Install Using the Wizard

This section explains how to install, create an installation script or image, or install from an installation image using the webMethods Installer 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 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

webMethods RosettaNet Module Installation Guide Version 6.0.1 21

CHAPTER 3 Installing webMethods RosettaNet Module 6.0.1

on each option and on the options you can use together, see “Installing Using a Proxy Server, Installation Script, or Installation Image” on page 13.)

Option Action Identify your server If you have created your own server from which to download and the webMethods integration platform components, select the webMethods Specify webMethods Installer server and platform manually check platform to install box. 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. 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.

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

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 For more information about overwriting webMethods installation by components, see the webMethods Integration Platform overwriting all files, Installation Guide. 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 RosettaNet Module in the webMethods installation directory (by default, /opt/webMethods6), then click Next. The installer will automatically install the webMethods RosettaNet Module in the Integration Server 6.0.1 installation directory. Click Next. The installer displays the Component Selection panel. 5 Choose to install webMethods RosettaNet Module, related items like documentation, and any required webMethods components. The installer lists components using a tree structure, as illustrated in the following figure.

webMethods RosettaNet Module Installation Guide Version 6.0.1 23

CHAPTER 3 Installing webMethods RosettaNet Module 6.0.1

Component Selection Panel

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

8 Review the list of items you have chosen to install. If the list is correct, click Next. The installer installs the items, then displays the Installation Complete panel. 9 Click Close.

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 21.

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

To install from an installation script that uses the wizard:

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 installation 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 webMethodsInstaller60.jar -console

enables garbage collection

webMethods RosettaNet Module Installation Guide Version 6.0.1 25

CHAPTER 3 Installing webMethods RosettaNet Module 6.0.1

If you want to 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 13.

Option Variables Specify webMethods Installer server and platform -URLBase If you have created your own server from which to download webMethods RosettaNet Module components, URL for the server (for example, http://machine/cgi-bin/script.cgi). -serverVersion Version of the webMethods RosettaNet 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 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.

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

Option Variables 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 an installation script is running, the installation fails.

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 values are as follows: Platform Value Windows WNT Solaris SOL AIX AIX HP-UX HP11 Linux LNX AS/400 AS400 Macintosh OS X The default is the platform on which you are running the installer. Install from an 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 RosettaNet Module to install on the command you used to start the installer, when prompted, choose the version of the webMethods RosettaNet Module to install. Then choose the webMethods installer server from which you want to download the webMethods RosettaNet Module. 3 When prompted, provide the user name and password you use to log in to the Advantage Web site. 4 When prompted, specify that you want to install the webMethods RosettaNet Module in the webMethods installation directory (by default, /opt/webMethods6). The

webMethods RosettaNet Module Installation Guide Version 6.0.1 27

CHAPTER 3 Installing webMethods RosettaNet Module 6.0.1

installer will automatically install the webMethods RosettaNet Module in the Integration Server 6.0.1 installation directory. 5 When prompted, choose to install the webMethods RosettaNet Module, related items like documentation, and any required webMethods components. The installer lists components using a tree structure, as illustrated in the following figure.

Component Selection Panel

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 backwards 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 RosettaNet 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 RosettaNet 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 RosettaNet 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 RosettaNet Module or for other components you are installing or have already installed, the installer prompts you to choose the packs to install. The webMethods RosettaNet Module supports only one language. You can use the default, English, or you can install one language pack, and only that language will be available to users.

28 webMethods RosettaNet Module Installation Guide Version 6.0.1 Overwrite webMethods RosettaNet 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 RosettaNet Module 6.0.1

If your webMethods RosettaNet Module installation 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.

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 15 in this guide or the UNIX or OS X section “Install Using the Wizard” on page 21 in this guide.

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.

webMethods RosettaNet Module Installation Guide Version 6.0.1 29

CHAPTER 3 Installing webMethods RosettaNet Module 6.0.1

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.

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” on page 19 in this guide or the UNIX or OS X section “Install From an Installation Script that Uses the Wizard” on page 25 in this guide.

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

To overwrite using an installation script:

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 25 in this guide.

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

30 webMethods RosettaNet Module Installation Guide Version 6.0.1 What About RosettaNet PIP Archives?

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.

What About RosettaNet PIP Archives?

A PIP archive is a compressed file (.par), also called a process archive, that contains webMethods RosettaNet Module configuration information for a specific version of a particular PIP. You need to import a RosettaNet process archive to implement a RosettaNet conversation in the webMethods RosettaNet Module. PIP archives reside on the Advantage Web site at the URL provided to you by webMethods. Each PIP archive has a file name that reflects the PIP number and version. For example, the file name for the PIP 3A4 Manage Purchase Order, version 1.1, is PIP3A4v1.par. You can add new PIPs to your webMethods RosettaNet Module installation as they are released by webMethods, without having to upgrade your installation. You can implement different versions of the same PIP to support transactions between you and your trading partners when not all of your trading partners are using the same version of the same PIP. However, in any specific PIP conversation, you and your trading partner must be using the same version of the PIP. You cannot copy over the PIP archives for previous releases of the webMethods RosettaNet Module from one upgrade to the next. If you do not have customized PIPs and are upgrading to release 6.0.1, you should download and import the PIP archive. For information about upgrading customized PIPs, Chapter 4, “Upgrading to webMethods RosettaNet Module 6.0.1” in this guide.

webMethods RosettaNet Module Installation Guide Version 6.0.1 31

CHAPTER 3 Installing webMethods RosettaNet Module 6.0.1

32 webMethods RosettaNet Module Installation Guide Version 6.0.1 ROSETTANET MODULE

CHAPTER 4

Upgrading to webMethods RosettaNet Module 6.0.1

Overview ...... 34 Upgrade from webMethods RosettaNet Module 4.x ...... 34 Upgrade from webMethods RosettaNet Module 1.x ...... 38

webMethods RosettaNet Module Installation Guide Version 6.0.1 33

CHAPTER 4 Upgrading to webMethods RosettaNet Module 6.0.1

Overview

This chapter explains how to upgrade to the webMethods RosettaNet Module 6.0.1.

Upgrade from webMethods RosettaNet Module 4.x

Use the following procedure to upgrade webMethods RosettaNet Module 4.x to webMethods RosettaNet Module 6.0.1.

To upgrade webMethods RosettaNet Module 4.x to 6.0.1

1 Back up the Trading Networks database and export custom services, mappings, and PIPs (NS records only). For instructions to backup the database and export services and mappings, see the webMethods Integration Platform Upgrade Guide. For instructions to export processes, see the webMethods RosettaNet Module User’s Guide.

2 Download the RN_Chem_4.x_to_6.01_Migration.zip file from the webMethods Advantage Web site. The RN_Chem_4.x_to_6.01_Migration.zip contains following upgrade utilities that you use in subsequent steps of this procedure: Export_4x_Conv_Scripts.bat Export_4x_Conv_Scripts.sh Export_4x_Conv_Scripts.class Import_4x_Conv_Scripts.bat Import_4x_Conv_Scripts.sh Import_4x_Conv_Scripts.class Migrate_IPDocType_to_XMLDocType.bat Migrate_IPDocType_to_XMLDocType.sh Migrate_IPDocType_to_XMLDocType.class MigrateIPDocType.jar

34 webMethods RosettaNet Module Installation Guide Version 6.0.1 Upgrade from webMethods RosettaNet Module 4.x

3 From your 4.x Trading Networks database, export the information from your PIPs that is used by your 4.x webMethods RosettaNet Module.

To export the information from your processes, run the Export_4x_Conv_Scripts utility as follows:

a Copy the Export_4x_Conv_Scripts files to the webMethods\Integration4\packages\WmTN\bin directory where webMethods\Integration4 is where you installed your 4.x Integration Server.

If you are running on Windows, copy Export_4x_Conv_Scripts.bat and Export_4x_Conv_Scripts.class files.

If you are running on UNIX, copy Export_4x_Conv_Scripts.sh and Export_4x_Conv_Scripts.class files.

b Run the Export_4x_Conv_Scripts utility.

If you are running on Windows, run Export_4x_Conv_Scripts.bat from the command prompt.

If you are running on UNIX, run Export_4x_Conv_Scripts.sh.

The Export_4x_Conv_Scripts utility creates the convlist.xml file in the webMethods\Integration4\packages\WmTN\bin directory. 4 Install Trading Networks 6.0.1 and migrate the Trading Networks database to 6.0.1 format. For instructions, see the webMethods Integration Platform Upgrade Guide. 5 Install webMethods RosettaNet Module 6.0.1 on the same machine as Integration Server 6.0.1. Specify the installation directory as the webMethods installation directory (by default, webMethods6). The installer automatically installs webMethods RosettaNet Module in the Integration Server 6.0.1 installation directory. 6 Import the information that you exported in step 3 into the 6.0.1 Trading Networks database. (Your database should not yet be running.) This is the information from your processes in your 4.x Trading Networks database. To import the information from your processes, run the Import_4x_Conv_Scripts utility as follows:

a Copy the Import_4x_Conv_Scripts files to the webMethods\IntegrationServer\packages\WmTN\bin directory where webMethods\IntegrationServer is where you installed your 6.0.1 Integration Server.

If you are running on Windows, copy Import_4x_Conv_Scripts.bat and Import_4x_Conv_Scripts.class files.

If you are running on UNIX, copy Import_4x_Conv_Scripts.sh and Import_4x_Conv_Scripts.class files.

webMethods RosettaNet Module Installation Guide Version 6.0.1 35

CHAPTER 4 Upgrading to webMethods RosettaNet Module 6.0.1

b Copy the convlist.xml file created in your 4.x system as a result of running the Export_4x_Conv_Scripts utility to the webMethods\IntegrationServer\packages\WmTN\bin directory.

c Run the Import_4x_Conv_Scripts utility. This utility takes the convlist.xml file name as an input argument.

If you are running on Windows, run Import_4x_Conv_Scripts.bat from the command prompt, specifying convlist.xml as an input argument.

If you are running on UNIX, run Import_4x_Conv_Scripts.sh, specifying convlist.xml as an input argument. 7 Migrate the IP Doc Types to XML TN document types by running the Migrate_IPDocType_to_XMLDocType utility as follows:

a Copy the Migrate_IPDocType_to_XMLDocType files to the webMethods\IntegrationServer\packages\WmTN\bin directory where webMethods\IntegrationServer is where you installed your 6.0.1 Integration Server.

If you are running on Windows, copy Migrate_IPDocType_to_XMLDocType.bat and Migrate_IPDocType_to_XMLDocType.class files.

If you are running on UNIX, copy Migrate_IPDocType_to_XMLDocType.sh and Migrate_IPDocType_to_XMLDocType.class files.

b Copy the MigrateIPDocType.jar file to the webMethods\IntegrationServer\packages\WmTN\code\jars directory.

c Run the Migrate_IPDocType_to_XMLDocType utility.

If you are running on Windows, run Migrate_IPDocType_to_XMLDocType.bat from the command prompt.

If you are running on UNIX, run Migrate_IPDocType_to_XMLDocType.sh.

8 Delete the MigrateIPDocType.jar file from the webMethods\IntegrationServer\packages\WmTN\code\jars directory. 9 Install the package releases that you created in step 1 and that contain the custom services and mappings that you use in conversations.

a Copy the package releases (.zip files) from the replicate\outbound directory of your 4.x Integration Server to the replicate\inbound directory of your 6.0.1 Integration Server. b Start Integration Server 6.0.1 and open Integration Server Administrator. c Click Packages > Management, and then click Install Inbound Releases. The Install Inbound Releases page appears.

36 webMethods RosettaNet Module Installation Guide Version 6.0.1 Upgrade from webMethods RosettaNet Module 4.x

d In the Release file name list, select one of the package releases that you created, select the Activate upon installation check box, and then click Install Release. The system displays a message that says the package has been installed and activated. e Repeat these steps for each package release you created. f Restart Integration Server. 10 If you customized your 4.x conversation scripts, you need to add the customizations to the trading partner agreements (TPAs) in your 6.0.1 system. The import utility created the TPAs in Trading Networks when you imported the convlist.xml file in step 6. To add customizations to the TPAs, duplicate the TPA and modify it. For more information about working with TPAs, see the webMethods Trading Networks Building and Managing Your Trading Networks guide. For more information about using TPAs with the webMethods RosettaNet Module, see webMethods RosettaNet Module User’s Guide. 11 If you exported your PIPs as .par files, import them into the 6.0.1 webMethods RosettaNet Module using the webMethods RosettaNet Module Home Page in the Integration Server Administrator. For more information about importing process archives, see the webMethods RosettaNet Module User’s Guide. 12 On your 6.0.1 system, use webMethods Modeler to create process models for your conversation scripts. At this point, you have all the supporting information for your conversation scripts installed in the 6.0.1 system, and it is available for you to create a process model in the 6.0.1 system. For each conversation script, do the following: a Determine the number of actions in the conversation. b Based on the number of actions, import the corresponding process model template that is provided with the webMethods RosettaNet Module. c Customize the process model by doing the following: 1 Assign the correct TN document types to the process model steps that wait for documents. 2 If the process model is to process documents from specific senders and receivers, add filters to the step waiting for the initial document. 3 Edit the join conditions for steps that wait for documents. 4 Change the timeout values, if necessary. 5 Assign your custom services to the appropriate steps in the process models.

webMethods RosettaNet Module Installation Guide Version 6.0.1 37

CHAPTER 4 Upgrading to webMethods RosettaNet Module 6.0.1

d Generate the process model to create the run-time elements. For more information about how to generate a process model, see the webMethods Modeler User’s Guide. For detailed information about working with process models, see the webMethods RosettaNet Module User’s Guide. 13 You can restart conversations that had “Running” status in your 4.x system. To do so, invoke the wm.tn.admin.migrate:migrateLiveConversations service. This service completely restarts each conversation that had “Running” status and brings the conversation to the same step that it was in when the 4.x server shut down. To restart the conversation, the migrateLiveConversations service resubmits all documents that already have been received for the conversation in the order they were received. The process run time facility of the Integration Server begins the conversation again, this time using the 6.0.1 process model that replaces the 4.x conversation script.

Important! Documents that already have been received for a conversation in your 4.x system and that are being resubmitted will be processed a second time. For example, if your conversation invokes a service that sends the document to a partner, that partner will receive the document a second time, or if a service sends the document to a back-end system, it will be sent to the back-end system again.

Upgrade from webMethods RosettaNet Module 1.x

Use the following procedure to upgrade webMethods RosettaNet Module 1.x to webMethods RosettaNet Module 6.0.1.

To upgrade webMethods RosettaNet Module 1.x to 6.0.1

1 Export custom services, mappings, and PIPs (NS records only). For instructions to backup the database and export services and mappings, see the webMethods Integration Platform Upgrade Guide. For instructions to export PIPs, see the webMethods RosettaNet Module User’s Guide. 2 Download the webMethods Installer 6.0.1 from the webMethods Advantage Web site at http://advantage.webmethods.com. 3 Install Trading Networks 6.0.1 For instructions, see the webMethods Integration Platform Upgrade Guide. 4 Install webMethods RosettaNet Module 6.0.1 on the same machine as Integration Server 6.0.1. Specify the installation directory as the webMethods installation directory (by default, webMethods6). The installer automatically installs webMethods RosettaNet Module in the Integration Server 6.0.1 installation directory.

38 webMethods RosettaNet Module Installation Guide Version 6.0.1 Upgrade from webMethods RosettaNet Module 1.x

5 Install the package releases that you created in step 1 and that contain the custom services and mappings that you use in conversations.

a Copy the package releases (.zip files) from the replicate\outbound directory of your 3.x Integration Server to the replicate\inbound directory of your 6.0.1 Integration Server. b Start Integration Server 6.0.1 and open Integration Server Administrator. c Click Packages > Management, and then click Install Inbound Releases. The Install Inbound Releases page appears. d In the Release file name list, select one of the package releases that you created, select the Activate upon installation check box, and then click Install Release. The system displays a message that says the package has been installed and activated. e Repeat these steps for each package release you created. f Restart Integration Server. 6 If you exported your PIPs as .par files, import them into the 6.0.1 webMethods RosettaNet Module using the webMethods RosettaNet Module Home Page in the Integration Server Administrator. For more information about importing PIP archives, see the webMethods RosettaNet Module User’s Guide.

webMethods RosettaNet Module Installation Guide Version 6.0.1 39

CHAPTER 4 Upgrading to webMethods RosettaNet Module 6.0.1

40 webMethods RosettaNet Module Installation Guide Version 6.0.1 CHAPTER 5

Uninstalling webMethods RosettaNet Module 6.0.1

Overview ...... 42 Uninstall on a Windows System ...... 42 Uninstall on a UNIX, AS/400, or OS X System ...... 43

webMethods RosettaNet Module Installation Guide Version 6.0.1 41

CHAPTER 5 Uninstalling webMethods RosettaNet Module 6.0.1

Overview

You uninstall the webMethods RosettaNet Module using the webMethods Uninstaller. The webMethods Installer installed all files you need to run the uninstaller. 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 RosettaNet 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 installer will not be able to replace 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. 5 In the Component Selection panel, under eStandards, click webMethods RosettaNet Module, and then click Next.

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

6 Click Next. 7 In the Uninstall Complete panel, click Close. 8 If you do not want to save the files that the uninstaller did not delete, navigate to the Integration Server_directory\packages directory and delete the appropriate 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 RosettaNet Module 6.0.1

1 Log on as the same user that installed the webMethods RosettaNet Module. 2 If you are uninstalling on a remote machine, 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 want 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 3 Shut down all webMethods components and all other applications that are running on the machine that contains the webMethods RosettaNet Module you are uninstalling.

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

webMethods RosettaNet Module Installation Guide Version 6.0.1 43

CHAPTER 5 Uninstalling webMethods RosettaNet Module 6.0.1

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 RosettaNet Module as the program to uninstall. 6 If you do not want to save the files that the uninstaller did not delete, navigate to the Integration Server_directory/packages directory and delete the appropriate directory.

44 webMethods RosettaNet Module Installation Guide Version 6.0.1 Index

Index

A on a remote UNIX machine 20 advanced options on a UNIX system using a wizard 25 description of 13 on a UNIX system using console mode 25 use to install 16, 21, 26 on a Windows system using a wizard 15 valid combinations of 13 on machines that cannot go outside firewall 13 AS/400 systems specify server to download from 16, 22, 26 installer display problems 20 use a proxy server to 13, 16, 22, 26 uninstaller display problems 43 installation image create 17, 22, 27 C description of 13 extra memory required to create 15, 21, 25 command line, use to install from an installation script on a extra memory required to install from 15, 20 Windows system 19 install from 17, 23, 27 console mode installation log file 12 use to uninstall on a UNIX system 43 installation script console mode, use to install on a UNIX system 25 create 16, 22, 26 conventions used in this document description of 13 program code conventions 7 install from on a UNIX system 25, 27 create install from on a Windows system 19 an installation image 17, 22, 27 installer, install mode choices 12 an installation script 16, 22, 26 L D language packs 14 display problems on AS/400 systems 20, 43 log file documentation for installation 12 conventions used 6 for uninstallation 42 printing 8 program code conventions used 7 P viewing 8 PDF, viewing 8 F printing this guide 8 program code conventions 7 firewall, install on machines that cannot go outside of 13 proxy server, use to install 13, 16, 22, 26

I R install remote UNIX machine, install on 20 display problems on AS/400 systems 20, 43 remote UNIX machine, uninstall on 43 from an installation image 17, 23, 27 from an installation script on a UNIX system 25, 27 from an installation script on a Windows system 19

webMethods RosettaNet Module Installation Guide Version 6.0.1 45

Index

S script, description of 13

T typographical conventions 6

U uninstall on a remote UNIX machine 43 on a UNIX system using a wizard 43 on a UNIX system using console mode 43 on a Windows system using a wizard 42 uninstallation log file 42 uninstaller, uninstall mode choices 42 upgrade from 4.x 34, 38

V viewing documentation in PDF format 8

W webMethods Installer install mode choices 12 server, specify 16, 22, 26 start as wizard on UNIX system 21 start as wizard on Windows system 15 start for UNIX console mode 25 start to install from an installation script on a Windows system 19 webMethods Uninstaller run as a wizard on a UNIX system 43 run as a wizard on a Windows system 42 run in UNIX console mode 43 uninstall mode choices 42 wizard use to install on UNIX systems 25 use to install on Windows systems 15 use to uninstall on a UNIX system 43 use to uninstall on a Windows system 42 WmInstallLog.txt file 12 WmUninstallLog.txt file 42

46 webMethods RosettaNet Module Installation Guide Version 6.0.1