Professional Documents
Culture Documents
Author:
CTS
17 Nov 2010
Draft 1a
Approvals
Name
Position
Approved by:
Approved by:
Approved by:
Signatur
e
Date
Document Control
Change Record
Date
15 Nov 2010
15 Dec 2010
08 Feb 2011
Change Originator
Somesh Purohit
Soumyoshis
Poddar
Somesh Purohit
Version
Initial
Description of change
Initial version created
Worklist DVM Creation added
Reviewed by
Date
Name
Position
Reviewed by:
Reviewed by:
Reviewed by:
Distribution
Copy No.
1.
Name
Library Master
Location
IRI Program Library
Related Documents
Document Reference
Contents
Document Control................................................................................................... ii
Contents................................................................................................................. iii
1
Introduction..................................................................................................... 4
1.1 Topical Essay...............................................................................................4
1.2 Scope of this document...............................................................................4
2
Pre-requisites for the SOA migration...............................................................5
2.1 JMS Configuration in Weblogic Console........................................................5
2.2 DB Adapter Configuration in Weblogic Console...........................................8
2.3 FTP Adapter Configuration in Weblogic Console..........................................8
2.4 Deployment should be completed for the common services such as the
worklist, Email Services.......................................................................................8
3
AIA-MDS Repository update for Custom EBOs.................................................9
3.1 Setting up the AIA_HOME environment........................................................9
3.2 Migrate the Custom EBOs to AIA File system repository..............................9
3.3 Update the Custom EBOs to AIA MDS........................................................10
4
Configuration Plan......................................................................................... 11
4.1 Generating the configuration plan.............................................................11
4.2 Editing the generated configuration plan..................................................12
5
SOA Composite Migration..............................................................................18
5.1 Inbound Composite List.............................................................................18
5.2 Outbound Composite List..........................................................................21
5.3 Common FTP Composite List.....................................................................24
5.4 Order of Deployments...............................................................................24
5.5 Deployment of the composites through Ant..............................................24
6
Configurable variables of the composite.......................................................27
6.1 Inbound Operations...................................................................................27
6.2 Outbound Operations................................................................................28
6.3 Common Operations..................................................................................30
6.4 How to change the above from EM Console...............................................31
6.5 Variables and their default values.............................................................34
7
Worklist DVM Set up in SOA Composer..........................................................35
7.1 IR_WORKLIST_SUPPORT_GROUP S DVM Entry............................................35
8
Post Deployment changes to be done manually............................................40
1 Introduction
1.1
Topical Essay
In order to migrate the SOA composites to various environments there is a
need to develop a deployment guide. This document will be referred by the
server administrators to migrate the composites to the required
environment. Also this can be referred by the people who want configure
the JCA properties for the file and ftp adapters if required.
1.2
WhcInJMSModule
eis/wls/whcInQ
Type
JNDI Name
Subdeployment
Targets
3PLJMSPackQSource
Queue
eis/wls/3PLPackJMSQ
3PLJMSPackQSource
WhcJMSSer
ver
CAPSJMSInvQSource
Queue
eis/wls/CAPSInvJMSQ
CAPSJMSInvQSource
WhcJMSSer
ver
CAPSJMSOnHandQSo
urce
Queue
eis/wls/CAPSOnHandJMSQ
CAPSJMSOnHandQSo WhcJMSSer
urce
ver
CAPSJMSPackQSourc
e
Queue
eis/wls/CAPSPackJMSQ
CAPSJMSPackQSourc
e
WhcJMSSer
ver
CAPSJMSPOQSource
Queue
eis/wls/CAPSPOJMSQ
CAPSJMSPOQSource
WhcJMSSer
ver
CAPSJMSShipQSourc
e
Queue
eis/wls/CAPSShipJMSQ
CAPSJMSShipQSourc
e
WhcJMSSer
ver
CAPSJMSWorkOrderQ
Source
Queue
EbizJMSPackQSource
Queue
eis/wls/EbizPackJMSQ
EbizJMSPackQSource
WhcJMSSer
ver
EbizJMSShipQSource
Queue
eis/wls/EbizShipJMSQ
EbizJMSShipQSource
WhcJMSSer
ver
InvCAPSConnFactory
Connect
eis/wls/InvCAPSConnFactor
ion
InvCAPSConnFactory
y
Factory
WhcJMSSer
ver
InvITSConnFactory
Connect
ion
eis/wls/InvITSConnFactory
Factory
WhcJMSSer
ver
InvTRMConnFactory
Connect
ion
eis/wls/InvTRMConnFactory InvTRMConnFactory
Factory
WhcJMSSer
ver
InvTROConnFactory
Connect
ion
eis/wls/InvTROConnFactory InvTROConnFactory
Factory
WhcJMSSer
ver
ITSJMSInvQSource
Queue
eis/wls/ITSInvJMSQ
ITSJMSInvQSource
WhcJMSSer
ver
ITSJMSOnHandQSour
ce
Queue
eis/wls/ITSOnHandJMSQ
ITSJMSOnHandQSour
ce
WhcJMSSer
ver
InvITSConnFactory
WhcJMSSer
ver
ITSJMSPOQSource
Queue
eis/wls/ITSPOJMSQ
ITSJMSPOQSource
ITSJMSWorkOrderQSo
urce
Queue
eis/wls/ITSWorkOrderJMSQ
ITSJMSWorkOrderQSo WhcJMSSer
urce
ver
OnHandCAPSConnFa
ctory
Connect
eis/wls/OnHandCAPSConnF OnHandCAPSConnFa
ion
actory
ctory
Factory
WhcJMSSer
ver
OnHandITSConnFact
ory
Connect
eis/wls/OnHandITSConnFac OnHandITSConnFact
ion
tory
ory
Factory
WhcJMSSer
ver
OnHandTRMConnFac
tory
Connect
eis/wls/OnHandTRMConnFa OnHandTRMConnFac
ion
ctory
tory
Factory
WhcJMSSer
ver
OnHandTROConnFac
tory
Connect
eis/wls/OnHandTROConnFa OnHandTROConnFac
ion
ctory
tory
Factory
WhcJMSSer
ver
OTMJMSPackQSource
Queue
eis/wls/OTMPackJMSQ
OTMJMSPackQSource
WhcJMSSer
ver
OTMJMSShipQSource
Queue
eis/wls/OTMShipJMSQ
OTMJMSShipQSource
WhcJMSSer
ver
Pack3PLConnFactory
Connect
eis/wls/Pack3PLConnFactor
ion
Pack3PLConnFactory
y
Factory
WhcJMSSer
ver
PackCAPSConnFactor
y
Connect
eis/wls/PackCAPSConnFact
ion
ory
Factory
PackCAPSConnFactor WhcJMSSer
y
ver
PackEbizConnFactory
Connect
eis/wls/PackEbizConnFacto
ion
ry
Factory
PackEbizConnFactory
PackOTMConnFactor
y
Connect
eis/wls/PackOTMConnFacto PackOTMConnFactor
ion
ry
y
Factory
PackTRMConnFactory
Connect
eis/wls/PackTRMConnFacto
WhcJMSSer
ion
PackTRMConnFactory
ry
ver
Factory
POCAPSConnFactory
Connect
eis/wls/POCAPSConnFactor
ion
y
Factory
POCAPSConnFactory
WhcJMSSer
ver
POITSConnFactory
Connect
ion
eis/wls/POITSConnFactory
Factory
POITSConnFactory
WhcJMSSer
ver
POTRMConnFactory
Connect
ion
eis/wls/POTRMConnFactory POTRMConnFactory
Factory
WhcJMSSer
ver
POTROConnFactory
Connect
ion
eis/wls/POTROConnFactory POTROConnFactory
Factory
WhcJMSSer
ver
ShipCAPSConnFactor
y
Connect
eis/wls/ShipCAPSConnFact
ion
ory
Factory
ShipCAPSConnFactor
y
WhcJMSSer
ver
ShipEbizConnFactory
Connect
eis/wls/ShipEbizConnFactor
ion
ShipEbizConnFactory
y
Factory
WhcJMSSer
ver
ShipOTMConnFactory
Connect
eis/wls/ShipOTMConnFacto
WhcJMSSer
ion
ShipOTMConnFactory
ry
ver
Factory
WhcJMSSer
ver
WhcJMSSer
ver
ShipTRMConnFactory
Connect
eis/wls/ShipTRMConnFacto
ion
ry
Factory
ShipTRMConnFactory
WhcJMSSer
ver
TRMJMSInvQSource
Queue
eis/wls/TRMInvJMSQ
TRMJMSInvQSource
WhcJMSSer
ver
TRMJMSPackQSource
Queue
eis/wls/TRMPackJMSQ
TRMJMSPackQSource
WhcJMSSer
ver
TRMJMSPOQSource
Queue
eis/wls/TRMPOJMSQ
TRMJMSPOQSource
WhcJMSSer
ver
TRMJMSShipQSource
Queue
eis/wls/TRMShipJMSQ
TRMJMSShipQSource
WhcJMSSer
ver
TRMJMSWorkOrderQ
Source
Queue
eis/wls/TRMWorkOrderJMS
Q
TRMJMSWorkOrderQ
Source
WhcJMSSer
ver
TRMOnHandJMSQ
Queue
eis/wls/TRMOnHandJMSQ
TRMOnHandJMSQ
WhcJMSSer
ver
TROJMSInvQSource
Queue
eis/wls/TROInvJMSQ
TROJMSInvQSource
WhcJMSSer
ver
TROJMSPOQSource
Queue
eis/wls/TROPOJMSQ
TROJMSPOQSource
WhcJMSSer
ver
TROOnHandJMSQ
Queue
eis/wls/TROOnHandJMSQ
TROOnHandJMSQ
WhcJMSSer
ver
WorkOrderCAPSConn
Factory
Connect
eis/wls/WorkOrderCAPSCo
ion
nnFactory
Factory
WorkOrderCAPSConn WhcJMSSer
Factory
ver
WorkOrderITSConnFa
ctory
Connect
eis/wls/WorkOrderITSConn
ion
Factory
Factory
WorkOrderITSConnFa WhcJMSSer
ctory
ver
WorkOrderTRMConnF
actory
Connect
eis/wls/WorkOrderTRMCon
ion
nFactory
Factory
WorkOrderTRMConnF WhcJMSSer
actory
ver
WhcJMSModule
eis/wls/whcQ
Type
ASNConnFactory
JNDI Name
Subdeployment
Targets
Connect
ion
eis/wls/ASNConnFactory
Factory
ASNConnFactory
WhcJMSSer
ver
POConnFactory
Connect
ion
eis/wls/POConnFactory
Factory
POConnFactory
WhcJMSSer
ver
ShippingConnFactory
Connect
eis/wls/WhcShippingConnF
WhcJMSSer
ion
ShippingConnFactory
actory
ver
Factory
WhcConnFactory
Connect
ion
eis/wls/WhcConnFactory
Factory
WhcConnFactory
WhcJMSSer
ver
WhcJMSASNQSource
Queue
eis/wls/WhcASNJMSQ
WhcJMSASNQSource
WhcJMSSer
ver
WhcJMSPOQSource
Queue
eis/wls/WhcPOJMSQ
WhcJMSPOQSource
WhcJMSSer
ver
2.2
WhcJMSSer
ver
WhcJMSQSource
Queue
eis/wls/WhcJMSQ
WhcJMSQSource
WhcJMSShippingQSo
urce
Queue
eis/wls/WhcShippingJMSQ
WhcJMSShippingQSo WhcJMSSer
urce
ver
WhcJMSWorkOrderQ
Source
Queue
eis/wls/WhcWorkOrderJMS
Q
WhcJMSWorkOrderQ
Source
WorkOrderConnFacto
ry
Connect
eis/wls/WhcWorkOrderCon
ion
nFactory
Factory
WhcJMSSer
ver
WorkOrderConnFacto WhcJMSSer
ry
ver
The following JNDI should be created for the DB Adapters in the target
environment through weblogic console.
3PL Database: eis/DB/IrWhc3PL
Mercury Database: jdbc/CCT_MERCURY_8i_DB
E-Biz Database: eis/DB/IrWhcEbizDB
2.3
In this step, AIA_HOME will be set up to execute MDS update ant scripts.
i.
Log into SOA middleware application tier back end with user credentials having
R/W/X permission in AIA_HOME.
ii.
Move to $AIA_HOME/aia_instances/<aia instance>/bin .
iii.
Set up the environment variables by running he following script - . aiaenv.sh
3.2
In this step the custom EBOs (attached below in the zip file) will be migrated to the AIA file system
repository. Below are the paths where the corresponding EBOs will be migrated:-
1.CustomCommonComponents
$AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/Commo
n/V2
2.CustomItem
$AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/Commo
nEBO/V1
3.CustomShipmentRequestEBO
$AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/EBO/S
hipmentRequest/V1
4.CustomPurchaseOrderEBO
$AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/EBO/P
urchaseOrder/V1
5.CustomWorkOrderEBO
$AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/EBO/W
orkOrder/V1
6.CustomAdvanceShipmentNoticeEBO
$AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/EBO/A
dvanceShipmentNotice/V1
7.CustomInventoryTransactionEBO
$AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/EBO/In
ventoryTransaction/V1
SOA Deployment - User Guide
9
Company Confidential For internal use only
8.CustomItemBalanceEBO
$AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/EBO/It
emBalance/V1
9.CustomShipmentReceiptEBO
$AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/Custom/EBO/S
hipmentReceipt/V1
EBO_TO_UPLOAD.zi
p
3.3
Step 1: Move to the path mentioned below to execute the ant script:$AIA_HOME/Infrastructure/Install/scripts
Step 2: Execute the script mentioned below:ant -f $AIA_HOME/Infrastructure/Install/AID/AIAInstallDriver.xml
-DDeploymentPlan=$AIA_HOME/config/UpdateMetaDataDP.xml
-DPropertiesFile=$AIA_HOME/aia_instances/<aia
instance>/config/AIAInstallProperties.xml
N.B. Please modify the directory name <aia instance> with the original aia instance
name. E.g. <aia instance> = aiauat
4 Configuration Plan
4.1
In this step generate the configuration plan for the required environment e.g. Test environment. Please
refer the below screenshots.
Screenshot -1
Screenshot -2
Click on OK. The required configuration plan is generated in the < PROJECT-HOME
> directory where PROJECT-HOME is your required project folder.
SOA Deployment - User Guide
11
Company Confidential For internal use only
4.2
The required configuration plan is generated in the previous step needs to be edited for the required
target environment.
For example, CreateWorkOrderCapsMfgProReqABCSImpl_TEST_cfgplan.xml.
When this plan is generated from the dev environment it contains the url and the
properties related to the dev environment. But for migration of this composite to
the next level environment, we need to edit this plan as below.
Step 1: Editing the import section of the configuration plan.
<import>
<searchReplace>
<search>Source-environment URL</search>
<replace>Target-environment URL</replace>
</searchReplace>
<searchReplace>
<search>Source-environment Port No </search>
<replace>Target-environment Port No </replace>
</searchReplace>
</import>
SOA Deployment - User Guide
12
Company Confidential For internal use only
Where
Source-environment URL= URL of the source environment (e.g. Dev)
Target-environment URL= URL of the Target environment (e.g. Test)
Source-environment Port No= Port no of the source environment (e.g. Dev)
Target-environment Port No= Port no of the source environment (e.g. Test)
Please refer the below screenshot for more details.
It replaces the input, output and archive file path sections of composite.xml file.
Please see the below screenshot for your reference.
5.2
5.3
5.4
Order of Deployments
Each of the above composite of the respective interface should be deployed in the following
order.
Step 1: The provider
Step 2: The JMSProvider
Step 3: The JMSPush
Step 4: The Requester
For example, please refer the below section.
5.5
Inbound Operations
ShipConfirmProvABCSImpl
CallCAPSFileWriteService
Write
Configurable properties
Naming Pattern
INT181SHIPCNF_%yyMMddHHmmssSS%.txt
OTMResponsePackConfirmProvABCSImpl
CallPackConfirmFileAdapter
Write
Configurable properties
Naming Pattern
INT181_%ddMMyyyyHHmmss%.txt
CreatePOASNRMAProvABCSImpl
CallCAPSFileService
Write
Configurable properties
Naming Pattern
INT183POASNRMACAPS_%SEQ%.txt
Oracle3PLWorkOrderProvABCSImpl
CallWriteFileService
Write
Configurable properties
Naming Pattern
INT186%yyMMddHHmmssSS%.txt
Composite Name
SOA Deployment - User Guide
26
Company Confidential For internal use only
mpl
CAPSMfgproOnHandBalFileService
Write
Configurable properties
Logical Output Directory
Naming Pattern
CAPSMfgproOnHandBalFilePath
INT_187_%ddMMyyyyHHmmss%.txt
FileAdapterServiceName
Operation
CreateInvTxactionProvABCSImpl
CallInvTxactionFileAdater
Write
Configurable properties
Naming Pattern
INT188_%ddMMyyyyHHmmss%.txt
6.2
Outbound Operations
Composite Name
FileAdapterServiceName
Operation
Logical Intput
Directory
InputDirectory
Logical
Archive
Directory
ArchiveDirecto
ry
Configurable properties
Naming Pattern
Delete File
INT179.*\.txt
true
Polling
Freq
(Sec)
10
Min File
Age
(Sec)
6
Composite Name
FileAdapterServiceName
Operation
Logical Intput
Directory
ShipmentRequestIn
putDir
Logical
Archive
Directory
ShipmentReque
stArchiveFileD
Configurable properties
Naming Pattern
Delete File
INT180.*\.txt
true
Polling
Freq
(Sec)
10
Min File
Age
(Sec)
6
ir
Interface No: INT182
Name: PO and RMA Interface Data going to 3PL
CreatePOCAPSMfgProReqABC
SImpl
CreatePO
Read
Composite Name
FileAdapterServiceName
Operation
Logical Intput
Directory
INT182POInDir
Logical
Archive
Directory
INT182POArc
Dir
Configurable properties
Naming Pattern
Delete File
INT182_PO.*\.txt
FileAdapterServiceName
Operation
INT182RMAInDir
Min File
Age
(Sec)
0
CreateRMACAPSMfgProReqAB
CSImpl
RcvRMAFile
Read
Composite Name
Logical Intput
Directory
true
Polling
Freq
(Sec)
5
Logical
Archive
Directory
INT182RMAA
rcDir
Configurable properties
Naming Pattern
Delete File
INT182_RMA.*\.
txt
true
Polling
Freq
(Sec)
5
Min File
Age
(Sec)
0
Composite Name
FileAdapterServiceName
Operation
Logical Intput
Directory
InputDirectory
Logical
Archive
Directory
ArchiveDirecto
ry
Configurable properties
Naming Pattern
Delete File
INT184.*\.txt
true
Polling
Freq
(Sec)
10
Min File
Age
(Sec)
5
Where
Value of Logical Input Directory = /u02/tmp/OUTBOUND/OUTBOUND _<ENV>_CAPSFILES for
all the outbound interfaces.
Value of Logical Archive Directory = /u02/tmp/OUTBOUND/OUTBOUND _<ENV>_ARCHIVE for
all the outbound interfaces.
<ENV> = Target environment name
6.3
Common Operations
Composite Name
FileAdapterServiceName
Operation
Logical Intput
Directory
InputDirectory
Logical
Archive
Directory
ArchiveD
irectory
Configurable properties
Logical
Naming
Delete File
Outtput
Pattern
Directory
None
INT.*\.txt
true
None
Logical
Archive
Directory
None
Configurable properties
Logical
Naming
Delete File
Outtput
Pattern
Directory
OutputDir INT_
None
ectory
%yyMMddH
Hmmss%.txt
InputDirectory
Logical
Archive
Directory
ArchiveD
irectory
Configurable properties
Logical
Naming
Delete File
Outtput
Pattern
Directory
None
INT.*\.txt
true
None
None
Min File
Age
(Sec)
None
Polling
Freq (Sec)
10
Min File
Age
(Sec)
0
CapsMfgProFTPService
CapsMfgProOutFileService
Write
Composite Name
FileAdapterServiceName
Operation
Logical Intput
Directory
Polling
Freq (Sec)
CapsMfgProFTPService
CapsMfgProOutFTPService
Get
Composite Name
FileAdapterServiceName
Operation
Logical Intput
Directory
10
Min File
Age
(Sec)
6
CapsMfgProFTPService
CapsMfgProInFTPService
Put
Composite Name
FileAdapterServiceName
Operation
Logical Intput
Directory
Polling
Freq (Sec)
Logical
Archive
Directory
None
Configurable properties
Logical
Naming
Delete File
Outtput
Pattern
Directory
OutputDir INT_
None
ectory
%yyyyMMd
d%
Where
Value of Logical Input Directory in case of Get= Path in the CAPS Server.
Value of Logical Archive Directory in case of Get= Path in the CAPS Server
Value of Logical Input Directory in case of Read =
/u02/tmp/INBOUND/INBOUND_<ENV>_CAPSFILES.
Value of Logical Archive Directory in case of Read =
SOA Deployment - User Guide
29
Company Confidential For internal use only
Polling
Freq (Sec)
None
Min File
Age
(Sec)
None
/u02/tmp/INBOUND/INBOUND_<ENV>_ARCHIVE
Value of Logical Output Directory in case of Write = /u02/tmp/OUTBOUND/OUTBOUND
_<ENV>_CAPSFILES.
Value of Logical Output Directory in case of Put = Path in the CAPS Server
<ENV> = Target environment name
6.4
Login to the EM Console of the required environment. Click on the + sign of the desired partition.
Inside that select your required composite by clicking on it. Then go towards the bottom of the page
and find the Services and References in the right hand side. There check your required File Service in
the Name column and click on it. Please refer the below screenshot.
*Note: The values changed here and saved are reset to their default values on server restart. So
after server restart again the required changes if any should be done.
SOA Deployment - User Guide
31
Company Confidential For internal use only
6.5
IR_inbound_and_Ou
tbound_Variable_List.xlsx
INTERFACE
INT187Tech
INT187CAPSTech
INT187TRMTech
INT179
INT179CapsTech
INT179Tech
INT179TrmTech
INT179TroTech
INT187TROTech
INT179Tro
INT187TRO
WORKLIST_GROUP
EbizITSTechnicalSupportGr
p
MfgproCapsTechnicalSuppo
rtGrp
TRMTechnicalSupportGrp
EbizITSInventorySupportGr
p
MfgproCapsTechnicalSuppo
rtGrp
EbizITSTechnicalSupportGr
p
TRMTechnicalSupportGrp
TROTechnicalSupportGrp
TROTechnicalSupportGrp
TROInventorySupportGrp
TROInventorySupportGrp
Step 1
Login to the SOA composer in PROD with administration credentials in the below URL.
http://fmwprd.ingerrand.com:48001/soa/composer/faces/login.jspx
Step 2
Click on OPEN. Then Open DVM.
Step 3
Select the IR_WORKLIST_SUPPORT_GROUPS.dvm from the Pop up and click on OPEN.
Step 4
In the next page click on edit to edit the dvm entry list.
Step 5
In the next page click + to add the required dvm entry to the list.
Step 6
In the pop up please give the requires interface name and the support group and click on OK. Then add
the other required dvms in the same way as stated.
Step 7
Then click on Save.
Step 8
Then click on Commit.