7/23/2019 Integration Broker Setup and Verification

1/15

Integration Broker

Setup & VerficationPeopleTools Release 8.4x

Last Updated 05/14/2003

7/23/2019 Integration Broker Setup and Verification

2/15

Table of Contents

Section 1 General Setup

Section 2 PING Verify Environmental Setup

Section 3 Troubleshootin

7/23/2019 Integration Broker Setup and Verification

3/15

Section 1

nte!"ation #ate$a% Set&p

Step 1 C"eate a #ate$a% $it'in t'e nte!"ation ("o)e"This proce!ure "ill create a Gate"ay in the Interation #ro$er% The Interation #ro$er& pub'sub re(uires a

Gate"ay !efinition be create! before any transactions can occur usin the Interation Gate"ay%

*ote+ T'e follo$in! steps s'o&ld be pe"fo",ed in o"de"- eac' step b&ilds &pon t'e p"eio&s step.

o" o&" p&"poses 'e"e $e $ill be &sin! a p"edefined and delie"ed #ate$a% definition.

Naviate toPeopleTools>Integration Broker >Gateways

)lic$ the Find an Existing Valuetab or lin$

EnterLOCALas the Gate"ay I*

*T+ f %o& a"e addin! a "e,ote !ate$a%- do not Select Local /* c'ec) box if t'e"e is al"ead% a

local !ate$a% p"esent onl% one local !ate$a% allo$ed pe" database

)lic$ the button%

7/23/2019 Integration Broker Setup and Verification

4/15

*T+ e delie" standa"d connecto"s $it' t'e LC6L #ate$a% 7. T'e% ,&st be loaded to t'e

ne$l% defined !ate$a%. o& ,&st sae t'e #ate$a% URL fi"st t'en load t'e connecto"s.

+o!ify the Gate"ay ,-.% Enter http/''.0).0ST'PSIG'PeopleSoft.istenin)onnector

*T+ 'en t'is URL is pasted in t'e ("o$se" t'e follo$in! ,essa!e s'o&ld appea"+

)lic$ the button%

)lic$ the button%

)lic$ O

http://lrobinso7100d/PSIGW/IBListeningConnectorhttp://lrobinso7100d/PSIGW/IBListeningConnector

7/23/2019 Integration Broker Setup and Verification

5/15

)lic$ the button%

Step 2 odif% t'e nte!"ation#ate$a%.P"ope"ties file to add Ta"!et *ode

info",ation

*ote+ 'en ,odif%in! t'is p"ope"ties file- it is c"itical to !et all t'e data ente"ed co,pletel%

and co""ectl%. T'is $o&ld be one a"ea to e"if% if PU(/SU( fails to p"ocess co""ectl%. 7ata

,&st be ente"ed exactl% as s'o$n belo$ in bl&e. 'en ,odif%in! t'e

nte!"ation#ate$a%.P"ope"ties file- please "e,e,be" t'at t'e ent"ies &sed in t'is doc&,ent

a"e exa,ples onl%.

4 5555555555555555555555555555555555555555555555555555555555555555555555555554 )onfi!entiality Information/ 54 54 This mo!ule is the confi!ential an! proprietary information of 54 PeopleSoft6 Inc%7 it is not to be copie!6 repro!uce!6 or 54 transmitte! in any form6 by any means6 in "hole or in part6 54 nor is it to be use! for any purpose other than that for "hich 54 it is e8pressly provi!e! "ithout the "ritten permission of 54 PeopleSoft6 Inc% 54 54 )opyriht 9c: 1;

7/23/2019 Integration Broker Setup and Verification

6/15

4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 444 This file6 "hich conforms to the Bava%util%Properties file !efinition64 confiures the Peopletools Interation Gate"ay%

444 Interation Gate"ay VE-SI0N Section4

4 Versionin / The entry belo" is re(uire! as it is use! to !etermine the4 version of your Interation Gate"ay%It is also use! as an4 in!icator of "hether this file has been rea! by the Gate"ay%i%versionC1%=

444 En! of Interation Gate"ay VE-SI0N Section4

444 Interation Gate"ay *+INIST-T0- ,SE- an! PSS0-* Section

4

i%a!min%userCa!mini%a!min%pass"or!Cpsft

444 En! of Interation Gate"ay *+INIST-T0- ,SE- an! PSS0-* Section4

444 Interation Gate"ay ).SS INST..TI0N Section4

4 *irectory "here your Interation Gate"ay classes are installe!% This4 information is use! on introspection calls to !etermine the location6 name4 an! properties of taret connectors%i%install!irC)/DDbeaDD"lserver%1DDconfiDDpeoplesoftDDapplicationsDDPsi"DDeb&infDDclasses

444 En! of Interation Gate"ay ).SS INST..TI0N Section4

444 *E.IVE-E* )0NNE)T0- )0NAIG,-TI0N Section4

4 ,-I prefi8 prepen!e! to any )onnector namei%connector%prefi8Ccom%peoplesoft%pt%interationate"ay%taretconnector%

4 *efault )onnector use! to connect to -emote Interation Gate"ay9s: 9shoul! not be mo!ifie!:i%connector%!efaultremoteconnectorCttpTaret)onnector

4 *efault )onnector use! by the Interation Gate"ay to connect to the Interation Server4 )ore runnin on the pplication Server 9shoul! not be mo!ifie!:i%connector%ibtaretconnectorCPeopleSoftTaret)onnector

7/23/2019 Integration Broker Setup and Verification

7/15

4 S+TP host use! by the S+TP Taret )onnector4 E8ample/4i%connector%smtptaretconnector%hostCpsp&smtp&=2i%connector%smtptaretconnector%hostCFmailServerName

444 H0.T connect strin settin for optional *efault pplication Server% *o N0T specify aN0*EN+E%44 E8ample/4i%isc%server,-.C''+@SE-VE-/;===4i%isc%useri!C+@,SE-I*4i%isc%pass"or!C+@PSS0-*4i%isc%tools-elCLC6L.se"e"URL9//LR(*S?1007+:001

i!.isc.=>LC6L.&se"id9;P1

i!.isc.=>LC6L.pass$o"d9;P1

i!.isc.=>LC6L.toolsRel98.40U*7R7#.se"e"URL9//LR(*S082301+:500

i!.isc.=>U*7R7#.&se"id9;P1

i!.isc.=>U*7R7#.pass$o"d9;P1

i!.isc.=>U*7R7#.toolsRel98.40

7/23/2019 Integration Broker Setup and Verification

8/15

4 pplication+essain.istenin)onnector must specify one of the no!e names belo"EL)T.@%@

AAAAAAAAAAAAAAAAA

AAAAAAAAAAAA

*odes Set in t'e nte!"ation#ate$a%.p"ope"ties file

6. 7efa&lt *ode

ithin any inboun! messae6 the only information the interation ate"ay re(uires is thenames of the messae an! the sen!in no!e% If the messae "as sent by an Interation #ro$ersystem6 it also inclu!es the name of the taret no!e% The ate"ay searches theinterationGate"ay%properties file for the Holt connect strin properties for the specifie! taretno!e6 so it can properly !irect the messae%

o"ever6 the interation ate"ay can fail to !etermine the correct taret no!e in thefollo"in situations/

The sen!in no!e isnMt a PeopleSoft Interation #ro$er system6 or it !oesnMt

specify a taret no!e% The Holt connect strin settins for the specifie! taret no!e are missin from the

interationGate"ay%properties file% The messae format !oesnMt allo" for a taret no!e specification%

To han!le these cases6 you can specify a !efault taret no!e for the ate"ay to use if no vali!taret no!e can be !etermine!% ,se the !efault Holt connect strin properties/

(. *on

7/23/2019 Integration Broker Setup and Verification

9/15

This is the lin$ to the release !oc for

7/23/2019 Integration Broker Setup and Verification

10/15

Section 2

P*# ;e"if% ni"on,ental Set&p

fter any No!e setup is complete6 the PING shoul! be e8ercise! an! lo results verifie! to !etermine if theenvironmental confiuration is correct% If the PING !oes not result in a S,))ESS status ST0PW !o notpublish% #ein troubleshootin activities to correct interation issues%

Step 1 Lo!in to P6

Step 2 *ai!ate to t'e 6pplication essa!e/nte!"ation ("o)e" onito"

Step 3 Clic) on t'e *ode Stat&s Tab

Step 4 Select t'e app"op"iate *ode *a,e

Step 5 Clic) t'e P*# b&tton

7/23/2019 Integration Broker Setup and Verification

11/15

Step D ;e"if% Res&lts a"e SUCCSS

Section 3

T"o&bleS'ootin!

T'e Lo! iles fo" t'e nte!"ation#ate$a%- ,s!Lo!.'t, and ""o"Lo!.'t,- a"e located at

E$lse"e"D.1 'o,eFGconfi!GpeoplesoftGapplicationsGPS#G.

Each )onnector processes both a re(uest an! a response% .istenin )onnectors receive are(uest imme!iately6 an! later in processin return a synchronous response to there(uestor% Taret )onnectors enerate a re(uest6 sen! it6 an! "ait for a response from thee8ternal system%

PeopleSoft&!elivere! )onnectors conform to an implementation in "hich each )onnector

must lo the actual6 ra" re(uest an! response sent'receive!% )onnectors also create loentries "hen an error con!ition is encountere!%

Each section of the lo file "ill be !escribe! belo"%

)e(tion $

This lo entry "as create! "hen the I#.istenin)onnector receive! a re(uest most li$ely from the #ro$erEnine runnin on the PS pplication Server% Note that the format is not L+.6 but +I+E 9the internalmessain stan!ar! for the Interation #ro$er:%

)e(tion *

7/23/2019 Integration Broker Setup and Verification

12/15

+irrorin the USection 1 entry above6 the I#.istenin)onnector has loe! the actual response that it sent

bac$ to the re(uestin system6 most li$ely a #ro$er Enine on the PS pplication Server%

)e(tion +

n error con!ition has been encountere!6 an! thus a lo entry is enerate!% Note that this lo !iffers fromstan!ar! messae loin6 such as USection 2 above% The Hava stac$ trace is !isplaye! for !ebuinpurposes% lso6 if an! "hen possible the internal UI#-e(uest or UI#-esponse is !isplaye! to help intrac$in !o"n "hy a problem has be

7/23/2019 Integration Broker Setup and Verification

13/15

Co,,on ""o"s+

Scena"io ne f t'e So&"ce *ode is not defined on t'e Ta"!et S%ste, P*# $ill

"es&lt in t'e follo$in! e""o"+

)orrection Proce!ure Enter the Source No!e *efinition on the Taret System an! re&PING%

Verify -esults C S,))ESS

Scena"io T$o f t'e ebSe"e"/#ate$a% is do$n P*# $ill "es&lt in t'e follo$in!

e""o"+

7/23/2019 Integration Broker Setup and Verification

14/15

)orrection Proce!ure Enter boot the "eb server an! re&PING%

Verify -esults C S,))ESS

Scena"io T'"ee f t'e Ta"!et 6ppSe"e" is do$n P*# $ill "es&lt in t'e follo$in!

e""o"+

7/23/2019 Integration Broker Setup and Verification

15/15

)orrection Proce!ure Enter boot the ppServer an! re&PING%

Verify -esults C S,))ESS