Installation guide

IBM(R) WebSphere(R) Business Integration Collaborations for Telecommunications consists of the following collaborations:

This document describes how to install these collaborations on machines running the Windows operating system.

Related documents

In order to implement a solution using WebSphere Business Integration Collaborations for Telecommunications, you may need to refer to one or more of the following documents:

Naming conventions

In this document, the following notations are used to refer to directories, names, IDs, and passwords:

Notations
Notation Description Example
<WICS> Directory where the IBM WebSphere InterChange Server product is installed C:\IBM\WebSphereICS
<MQWF> Directory where the WebSphere MQ Workflow product is installed C:\Program Files\IBM WebSphere MQ Workflow
<WBIT> Directory where WebSphere Business Integration for Telecommunications is installed C:\IBM\ESD
<WICSSERVER> Server name where IBM WebSphere InterChange Server is installed wicsserver
<WICSADMINID> Administrator ID for IBM WebSphere InterChange Server admin
<WICSADMINPWD> Administrator password for IBM WebSphere InterChange Server null
<MQWFADMINID> Administrator ID for WebSphere MQ Workflow ADMIN
<MQWFADMINPWD> Administrator password for WebSphere MQ Workflow password

Software prerequisites

IBM WebSphere InterChange Server (version 4.2.0 or higher) and its prerequisites should be installed appropriately for your platform, as documented in the IBM System Installation Guide. Prerequisites include IBM WebSphere MQ, the chosen database server, the IBM WebSphere Business Integration Visibroker orb, and the InterChange Server.

The WebSphere MQ Workflow product also should be installed as documented in the WebSphere MQ Workflow Installation Guide

Preparation

Before following the installation procedure, make sure you have downloaded the software you want to install from Passport Advantage (http://www.lotus.com/passportadvantage) and extracted it into an appropriate directory. Refer to Passport Advantage for downloading instructions.

Solution contents

This section lists the contents of the WebSphere Business Integration Collaborations for Telecommunications solution. All the files described in this section are located in the <WBIT> directory. They should have been copied to this location at the previous Preparation step.

WebSphere Business Integration for Telecommunications contents use the following naming conventions:

Naming conventions
Name Description
BIA_XXXXX.zip IBM WebSphere Business Integration Modeler (formally called Holosofx BPM Workbench) organization file
BIA_BO_XXXXX.jar IBM WebSphere Business Integration Business Object repository file
BIA_XXXXX.fdl WebSphere MQ Workflow FDL (Flow Definition Language) file
BIA_CT_XXXXX.jar IBM WebSphere Business Integration Collaboration Template repository file

The contents of the WebSphere Business Integration for Telecommunications solution are listed in the following tables:

Common Generic Business Object
File name Description
BIA_BO_TelcoBusinessObjects.jar Generic Business Object (GBO) repository file which is commonly used for WebSphere Business Integration for Telecommunications

IBM WebSphere Business Integration Collaboration for Product Development and Retirement
File name Description
BIA_ProductDevelopmentAndRetirement.fdl WebSphere MQ Workflow Flow Definition File (FDL)
BIA_CT_ReturnTelcoProducts.jar
BIA_CT_TelcoProductManager.jar
IBM WebSphere Business Integration Collaboration Template repository files

IBM WebSphere Business Integration Collaboration for Customer Order Handling
File name Description
BIA_CustomerOrderHandling.fdl WebSphere MQ Workflow Flow Definition File (FDL)
BIA_CT_ReturnTelcoProducts.jar
BIA_CT_SalesOrderManager.jar
BIA_CT_ReturnSalesOrders.jar
BIA_CT_TelcoCustomerAccountManager.jar
BIA_CT_ReturnParties.jar
BIA_CT_PartyManager.jar
BIA_CT_PrequalifyProduct.jar
BIA_CT_ServiceOrderManager.jar
BIA_CT_BillingAccountManager.jar
BIA_CT_BillableItemManager.jar
BIA_CT_AcknowledgementReceiver.jar
BIA_CT_AddressValidation.jar
BIA_CT_LoopPrequalify.jar
BIA_CT_LoopPrequalifyResponder.jar
IBM WebSphere Business Integration Collaboration Template repository files

IBM WebSphere Business Integration Collaboration for Customer Service Configuration and Activation
File name Description
BIA_CustomerServiceConfiguration.fdl WebSphere MQ Workflow Flow Definition File (FDL)
BIA_CT_SalesOrderManager.jar
BIA_CT_ServiceOrderManager.jar
BIA_CT_ConfigRecordManager.jar
BIA_CT_DSLServiceSetup.jar
BIA_CT_IDCServiceSetup.jar
BIA_CT_WirelessServiceSetup.jar
BIA_CT_TestDSLServiceProcessing.jar
BIA_CT_ServiceRequestInitiator.jar
BIA_CT_IDCServiceActivate.jar
BIA_CT_ServiceRequestResponder.jar
BIA_CT_AcknowledgementReceiver.jar
BIA_CT_DesignManager.jar
BIA_CT_CompleteDesign.jar
BIA_CT_LoopServiceRequestInitiator.jar
BIA_CT_ReturnTestResult.jar
IBM WebSphere Business Integration Collaboration Template repository files

IBM WebSphere Business Integration Collaboration for Resource Provisioning and Allocation
File name Description
BIA_CustomerResourceProvisioning.fdl WebSphere MQ Workflow Flow Definition File (FDL)
BIA_CT_ServiceOrderManager.jar
BIA_CT_ConfigRecordManager.jar
BIA_CT_FieldServiceElementManager.jar
IBM WebSphere Business Integration Collaboration Template repository files

IBM WebSphere Business Integration Collaboration for Customer Billing Management
File name Description
BIA_CustomerBillingManagement.fdl WebSphere MQ Workflow Flow Definition File (FDL)
BIA_CT_TelcoCustomerAccountManager.jar
BIA_CT_ReturnParties.jar
BIA_CT_BillingAccountManager.jar
BIA_CT_ReturnAccounts.jar
BIA_CT_ActivateBillingCycle.jar
BIA_CT_BillableItemManager.jar
BIA_CT_InvokeProcessWithServiceOrder.jar
IBM WebSphere Business Integration Collaboration Template repository files

IBM WebSphere Business Integration Collaboration for Customer Problem Handling
File name Description
BIA_CustomerProblemHandling.fdl WebSphere MQ Workflow Flow Definition File (FDL)
BIA_CT_TelcoCustomerAccountManager.jar
BIA_CT_ReturnParties.jar
BIA_CT_PartyManager.jar
BIA_CT_ProblemRecordManager.jar
BIA_CT_ReturnProblemRecords.jar
IBM WebSphere Business Integration Collaboration Template repository files

IBM WebSphere Business Integration Collaboration for Service Usage
File name Description
BIA_CT_ValidateCredit.jar
BIA_CT_UsageManager.jar
BIA_CT_ProvisionForContents.jar
BIA_CT_BillableItemManager.jar
IBM WebSphere Business Integration Collaboration Template repository files

IBM WebSphere Business Integration Collaboration for Fault Resolution
File name Description
BIA_FaultResolution.fdl WebSphere MQ Workflow Flow Definition File (FDL)
BIA_FaultResolution.zip IBM WebSphere Business Integration Modeler (formally called Holosofx BPM Workbench) organization file
BIA_CT_ValidateCredit.jar
BIA_CT_UsageManager.jar
BIA_CT_ProvisionForContents.jar
BIA_CT_BillableItemManager.jar
IBM WebSphere Business Integration Collaboration Template repository files

Installing WebSphere Business Integration Collaborations for Telecommunications on Windows

To install WebSphere Business Integration for Telecommunications on a Windows machine, complete the steps listed below:

Step 1: Install the contents of the WebSphere Business Integration Collaborations for Telecommunications solution

To install and contents of the WebSphere Business Integration Collaborations for Telecommunications solution, complete the following steps:

  1. From the ESD image, run the installer and select the Telecommunications Industry Collaborations.  After installation, the contents of the Telecommunications solution are in the <WBIT> directory.
  2. Import entire contents of the <WBIT> directory into a System Manager library.
  3. Ensure that the WebSphere InterChange Server is started and set to run in Design mode. (Use the -design parameter to set the mode.)
  4. Connect the System Manager to the Interchange Server.
  5. Back up your existing WebSphere InterChange Server using the repos_copy command. (See the System Administration Guide for instructions on using the repos_copy command to save a complete repository image.) For example:
    repos_copy -oicsBackup.out -s<WICSERVER> -u<WICSADMINID> -p<WICSADMINPWD>
  6. Create and configure any other components that you require, such as collaborations objects.
  7. Deploy the contents to the InterChange Server

Step 2: Install FDL files

Open a command prompt and issue the following command at the machine on which WebSphere MQ Workflow is installed. Note that the -o option causes any existing objects to be overwritten:

fmcibie -u<MQWFADMINID> -p<MQWFADMINPWD> -oti<WBIT>\BIA_xxxxxxxx.fdl

Note: BIA_xxxxxxxx.fdl is the collaboration name for which you have a license.

Repeat the above command for each collaboration for which you have a license.

Step 3: Install WBI Modeler Organization file

Log in to the machine on which IBM WebSphere Business Integration Modeler is installed, and extract the contents of  BIA_XXXX.zip. Start IBM WebSphere Business Integration Modeler. Open an organization file (*.org) by pointing at the file in the directory where you extracted the files.

Deploying WebSphere Business Integration Collaborations for Telecommunications on UNIX operating systems

The WebSphere Business Integration for Telecommunications solution cannot be directly installed on a UNIX operating system.  Instead, the solution must be installed on a Windows operation system and then deployed to the InterChange Server on a UNIX system by using the WebSphere Business Integration System Manager.  The WBI Modeler Organization and FDL files must be moves to the UNIX system manually.

Step 1: Install the contents of the WebSphere Business Integration Collaborations for Telecommunications solution on a Windows machine

Follow the instructions in Step 1 of Installing WebSphere Business Integration for Telecommunications on Windows.  Deploy the contents to the InterChange Server on the UNIX machine.

Step 2: Install FDL files

Login to the machine on which WebSphere MQ Workflow is installed as WebSphere MQ Workflow administrator ID or su to the administrator ID, open a command prompt, and issue the following command. Note that the -o option causes any existing objects to be overwritten:

fmcibie -u<MQWFADMINID> -p<MQWFADMINPWD> -oti<WBIT>/BIA_xxxxxxxx.fdl

Note: BIA_xxxxxxxx.fdl is the collaboration name for which you have a license.

Repeat the above command for each collaboration for which you have a license.

Step 3: Install WBI Modeler Organization file

Log in to the machine on which IBM WebSphere Business Integration Modeler is installed, and extract the contents of  BIA_XXXX.zip. Start IBM WebSphere Business Integration Modeler. Open an organization file (*.org) by pointing at the file in the directory where you extracted the files.

Copyright IBM Corp. 2002, 2003