Installing IBM webMethods Module for SWIFT

Edit online

Overview

Edit online

This chapter explains how to install, upgrade, and uninstall IBM webMethods Module for SWIFT. The instructions use the IBM webMethods Installer and the IBM webMethods Uninstaller wizards. For complete information about the wizards or other installation methods, or to install other webMethods products, see Installing IBM webMethods Products .

Requirements

Edit online

For a list of the operating systems and webMethods products supported by webMethods Module for SWIFT, see IBM webMethods eStandards Modules System Requirements . webMethods Module for SWIFT has no hardware requirements beyond those of its host Integration Server.

Depending on the type of transport you use, you will need either the MQ Host Adapter (MQHA) or the Remote API Host Adapter (RAHA). If you are using the SWIFTNet component of webMethods Module for SWIFT for a server application, you must install RAHA or MQHA on the same machine as SWIFT Alliance Gateway.

Regardless of whether you are using the SWIFTNet component for a client or server application, you must install a Remote Access (RA) client on your Integration Server. The RA client, RAHA, and MQHA are provided by SWIFT. For more information, see your SWIFT documentation or go to http://www.swift.com.

If you are using CASmf as the interface to SWIFT, you must install a CASmf client (provided by SWIFT) on the same machine as your Integration Server. For more information, see your SWIFT documentation or go to http://www.swift.com.

webMethods Module for SWIFT references SWIFT Alliance Access and SWIFT Alliance Gateway through the interfaces provided by SWIFT. SWIFT Alliance Access and SWIFT Alliance Gateway use SWIFTNet Link to communicate with SWIFT.

The Integration Server Home Directory

Edit online

This guide uses the packages_directory as the home directory in Integration Server classpaths. For Integration Server 10.1 and above, The packages_directory is Integration Server_directory \instances\instance_name\packages directory.

Installing IBM webMethods Module for SWIFT

Edit online

About this task

Note: If you are installing webMethods Module for SWIFT in a clustered environment, you must install it on each Integration Server in the cluster, and each installation must be identical. For more information about working with webMethods Module for SWIFT in a clustered environment, see Administering IBM webMethods Module for SWIFT in a Cluster.

To install webMethods Module for SWIFT

Procedure

  1. Download IBM webMethods Installer from the Empower Product Support Web site at https://empower.softwareag.com.
  2. If you are installing webMethods Module for SWIFT on an existing Integration Server, shut down the Integration Server.
  3. Start the IBM webMethods Installer wizard.
  4. Choose the webMethods release that includes the Integration Server on which you want to install the adapter.
    Note: If Integration Server and Trading Networks are already installed from a previous installation, Installer does not reinstall these products.
  5. Specify the installation directory as follows:
    • If you are installing on an existing Integration Server, specify the webMethods installation directory that contains the host Integration Server.
    • If you are installing both the host Integration Server and the adapter, specify the installation directory to use.
  6. In the product selection list, navigate to eStandards > webMethods Module 7.1 SP14 for SWIFT. You can also choose to install any required products indicated in the IBM webMethods eStandards Modules System Requirements .

    You can choose to install the package in the default instance of Integration Server. In this case, IBM webMethods Installer installs the adapter in both locations, Integration Server_directory \packages and the default instance packages directory located in Integration Server_directory \instances\default\packages.

    Installer installs the following components:

    • IBM webMethods Integration Server
    • IBM webMethods B2B Trading Networks
    • eStandards Common Library
    webMethods Module for SWIFT installs the following packages in the packages_directory :
    • WmFIN
    • WmSWIFTCommon
    • WmSWIFTNetClient
    • WmSWIFTNetServer
  7. After Installer completes the installation, close it.
  8. Start the host Integration Server.
  9. If you are using Integration Server with IBM webMethods Broker, enable publication of messages to IBM webMethods Broker as follows:
    1. Navigate to the Integration Server_directory \packages\WmFIN\config directory.
    2. Open the fintransport.cnf file in a text editor and change the fin.message.publishLocal parameter to false.
    3. Save and close the file.
  10. To download the documentation for the adapter, go to Software AG Documentation website.

Installing the webMethods Module for SWIFT Samples Package

Edit online

About this task

The webMethods Module for SWIFT samples package (WmSWIFTSamples) contains the sample services to run webMethods Module for SWIFT. The samples package is not installed with webMethods Module for SWIFT. To download the WmSWIFTSamples package and webMethods SWIFT Module Samples Guide, go to the Technical Community for webMethods at https://tech.forums.softwareag.com/t/webmethods-swift-module-sample-package/238981 and see the Code Samples.

Upgrading to webMethods Module for SWIFT

Edit online

About this task

This section provides instructions to upgrade to a newer version of the webMethods Module for SWIFT from 7.1 SPx where, x refers to the current version of the 7.1 Service Pack installed on your machine.

Before You Begin

Edit online

About this task

When you upgrade to a newer version of Trading Networks, make sure you backup the webMethods Module for SWIFT packages that contain Trading Networks-specific data. For more information about how to upgrade Trading Networks, see Upgrading IBM webMethods Products On Premises .

Upgrading from webMethods Module for SWIFT 7.1 SPx

Edit online

About this task

To upgrade from webMethods Module for SWIFT 7.1 SPx

Procedure

  1. Back up your existing webMethods Module for SWIFT installation, including the WmFIN, WmSWIFTNetClient, WmSWIFTNetServer, and WmSWIFTCommon packages, as well as all custom packages that are used by the webMethods Module for SWIFT.
  2. Export all webMethods Module for SWIFT 7.1 SPx Trading Networks information (profiles, TN document types, processing rules, TPAs and TN attributes) from Trading Networks using IBM My webMethods Server. For information about exporting Trading Networks assets, see IBM webMethods Trading Networks Administrator’s Guide .
  3. Shut down Integration Server if it is running.
  4. Uninstall the current version of the webMethods Module for SWIFT. For instructions, see Uninstalling webMethods Module for SWIFT.
  5. Install IBM webMethods Module for SWIFT 7.1 SP14 on a supported version of Integration Server. For instructions, see Installing IBM webMethods Module for SWIFT. For a list of supported Integration Server versions, see IBM webMethods eStandards Modules System Requirements .
  6. If you want to preserve the previous configuration values, replace the following files under \WmFIN\config directory with the files from your current installation of the webMethods Module for SWIFT.
    • wmcasmf.cnf
    • fintransport.cnf
  7. If you want to use any of the previous configuration values for the RAHA transport, you must configure the SWIFTNet server application and client applications.
    1. In Integration Server Administrator, select Adapters > SWIFT.
    2. Using information from the current webMethods Module for SWIFT 7.1 SPx installation, configure the SWIFTNet server:
      1. From the SWIFT navigation area, select SWIFTNet Server Config > Edit.
      2. In the SWIFTNet Remote Process Connection Configuration section, enter the values from the backup of the \WmSWIFTNetServer\config\connect.cnf file. This file stores the password handle for the user password that you need to connect to Integration Server.
      3. In the SWIFTNet Server Environment Information section, enter the values from the backup of the \WmSWIFTNetServer\config\env.cnf file.
      4. In the SWIFTNet Server SAG Connection Properties section, enter the values from the backup of the \WmSWIFTNetServer\config\snl.cnf file.
      5. Click Save when you are done.
    3. Using information from the current webMethods Module for SWIFT 7.1 SPx installation, configure the SWIFTNet client:
      1. From the SWIFT navigation area, select SWIFTNet Client Config > Edit.
      2. In the SWIFTNet Client Environment Information section, enter the values from the backup of the \WmSWIFTNetClient\config\env.cnf file.
      3. In the SWIFTNet Client SAG Connection Configuration section, enter the values from the backup of the \WmSWIFTNetClient\config\snl.cnf file.
      4. Click Save when you are done.

      For information about the fields in the SWIFTNet Server and Client Configuration screen and how to configure the SWIFTNet server application and client application over RAHA, see Configuration Steps for InterAct and FileAct Messaging Services over SAG RAHA.

  8. Start Integration Server, Integration Server Administrator, and IBM My webMethods Server.
  9. Import the custom webMethods Module for SWIFT 7.1 SPx Trading Networks information that you exported in step 2 into Trading Networks. For instructions about how to import Trading Networks information, see IBM webMethods Trading Networks Administrator’s Guide .
  10. In Designer > Package Navigator, run the wm.fin.dev:importFINItems service to re-import all message types that you have been using with webMethods Module for SWIFT 7.1 SPx.

Uninstalling webMethods Module for SWIFT

Edit online

About this task

Important: Before you uninstall webMethods Module for SWIFT, stop all RMI Registry services that are running.

To uninstall webMethods Module for SWIFT

Procedure

  1. Uninstalling webMethods Module for SWIFT removes all components in the webMethods Module for SWIFT packages. If you want to keep certain records or services from the existing webMethods Module for SWIFT packages on your Integration Server, export them to a new package.

    To do so, open Designer, select the package or the service you want to export, and select File > Export.

    • If you select a package, the entire package is exported.
    • If you select a service, only the selected service is exported.
  2. Shut down the Integration Server that hosts webMethods Module for SWIFT.
  3. Start IBM webMethods Uninstaller, selecting the webMethods installation directory that contains the host Integration Server. In the product selection list, select eStandards > webMethods Module 7.1 SP14 for SWIFT and any other products and items you want to uninstall.
  4. Restart the host Integration Server.

    IBM webMethods Uninstaller removes all IBM webMethods Module for SWIFT 7.1 SP14-related files that were installed. However, Uninstaller does not delete files created after you installed the module (for example, user-created files or configuration files), nor does it delete the module directory structure. You can navigate to the Integration Server_directory \packages directory and Integration Server_directory \instances\default\packages directory. Delete the WmSWIFT-related directories.