A Step-By-Step Guide To Configuring A WebSphere Portal

A Step-By-Step Guide to Configuring a WebSphere Portal
v6.1.0.36.1.! Clu"ter
Hunter Tweed
WebSphere Portal Level 2 support Team Lead
IBM Raleigh Lab
November 2!!"
# $op%right International Business Ma&hines $orporation 2!!"' (ll rights reserved'
This guide des&ribes a &omprehensive pro&edure )or installing &on)iguring and building an IBM*
WebSphere* Portal v+','!'-.+','/ &luster using0
IBM WebSphere (ppli&ation Server 1'!'!'/ 2 -23bit
Red Hat 4nterprise Linu5 6'! update 7
8B2 v"', )p / Server
IBM Tivoli 8ire&tor% Server v+',
IBM HTTP Server +',
,
Table of Contents
( Step3B%3Step 9uide to $on)iguring a WebSphere Portal v+','!'-.+','/ $luster''''''''''''''''''''''''''''''''''',
Table o) $ontents'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''2
Introdu&tion'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''-
Be)ore %ou begin'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''/
Install WebSphere (ppli&ation Server v1 on the )uture Portal Primar% Node''''''''''''''''''''''''''''''''''''''+
Install the Primar% Portal Node''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''',1
Install IBM Support (ssistant Lite''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''2-
Install the 8eplo%ment Manager'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''26
$on)igure the 8eplo%ment Manager'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''-+
$on)igure the Primar% Portal node to an e5ternal database''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''6,
:ederate and $luster the Primar% Node''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''6+
Install WebSphere (ppli&ation Server v1 on the )uture Portal Se&ondar% Node''''''''''''''''''''''''''''''''/!
Install the Se&ondar% Portal Node'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''+,
Install IBM Support (ssistant Lite''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''++
:ederate and $luster the Se&ondar% Portal node'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''+1
$on)igure the Portal $luster )or Se&urit%''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''1,
$on)igure the Portal $luster with an e5ternal web server'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''16
(ppendi5 ( 2 $reate a 8eplo%ment Manager pro)ile on the Primar% Portal node'''''''''''''''''''''''''''''7!
(ppendi5 B 2 S;L S&ript to $reate 8B2 8atabases''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''76
(ppendi5 $ 2 (dding a <erti&al $luster member'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''77
(ppendi5 8 2 (dding a new se&ondar% node to an e5isting &luster'''''''''''''''''''''''''''''''''''''''''''''''''''"2
(ppendi5 4 2 Running IBM Support (ssistant Lite'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''"+
(ppendi5 : 2 $ommon Problems'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''"7
2
Introduction
Building and &on)iguring a &luster &an be a ver% &omple5 tas=' >ou &an build portal &lusters in various
wa%s' This arti&le provides a best pra&ti&e approa&h )or building a &luster environment using
WebSphere Portal version +','!'-.+','/' This e5ample produ&es a two3node hori?ontal &luster as
shown in :igure ,' >our environment might re@uire spe&ial &onsiderations but %ou should still )ollow
this step3b%3step approa&h as an overall guide'
Higher Versions of Portal
(lthough this guide is spe&i)i&all% written )or -23bit Portal v+','!'-.+','/ and WS(S v1'!'!'/ the same
approa&h will appl% to an% Portal v+','!'- version or higher and an% WS(S v1'!'!'5 version -2 or +63
bit'
WebSphere Application Server v6.1.0.27 or higher
>ou ma% also use W(S v+','!'21 and higher as well as long as %ou understand the )ollowing0
3 >ou have the option o) installing W(S v+','!'21 as part o) the Portal v+','!'-.+','/ installation so
there is no need to manuall% install it be)orehand Aunli=e W(S v1B' There)ore the Primar% Node
Se&ondar% Node and 8eplo%ment Manager installation steps ma% be slightl% di))erent )or %ou'
3 S&reenshots and paths within the 8eplo%ment Manager (dministrative &onsole ma% var% between
W(S v+', and W(S v1' S&reenshots and paths in this guide are )rom W(S v1'
Windows!ni" #ifferences
This guide was written using Linu5 as the base operating s%stem however the steps.&on&epts listed in
this guide are independent o) operating s%stem' That is %ou &an )ollow these same steps on an%
operating s%stem and a&hieve the same result'
The onl% signi)i&ant di))eren&e is that )or Windows %ou must use the bat&h )ile &ommands instead o)
the CNID shell &ommands listed in this guide' :or e5ample0
!$%&0 '.startServer'sh WebSphereEPortal
Windows' startServer'bat WebSphereEPortal
or
!$%&' '.$on)ig4ngine'sh &luster3node3&on)ig3&luster3setup
Windows' $on)ig4ngine'bat &luster3node3&on)ig3&luster3setup
-
:igure , 2 Target Portal $luster
In the instru&tions )or &on)iguring Portal with the database and L8(P s&reens
shots show valid e5amples' Cse values whi&h are appropriate )or %our database
and L8(P'
6
Before you begin
This guide does $() &over the )ollowing0
Installing 8B2
Installing IBM Tivoli 8ire&tor% Server
$on)iguring the &luster with Web $ontent Management
$on)iguring the &luster with WebSphere Pro&ess Server
$on)iguring a d%nami& &luster using WebSphere (ppli&ation Server D8
$reating multiple &lusters in a single &ell
:or more in)ormation on these and other topi&s please visit the IBM WebSphere Portal v+','!
In)ormation $enter0
http0..publib'boulder'ibm'&om.in)o&enter.wpdo&.v+r,.inde5'FspG
topi&H.&om'ibm'wp'ent'do&Ev+,/.wel&omeEmain'html
To per)orm the tas=s des&ribed in this do&ument %ou need basi& WebSphere Portal and WebSphere
(ppli&ation Server =nowledge and administration s=ills' Some steps might re@uire the assistan&e o)
another s%stem administrator su&h as the database administrator or L8(P administrator'
The )ollowing re)eren&es to WebSphere Portal and WebSphere (ppli&ation Server )ile paths will be
used throughout the guide0
I(ppServer rootJ 3 The root path o) the (ppServer dire&tor% )or e5ample0
.opt.WebSphere.(ppServer
IPortalServer rootJ 3 The root path o) the PortalServer dire&tor% )or e5ample0
.opt.WebSphere.PortalServer
IwpEpro)ileJ 3 The root path o) the wpEpro)ile dire&tor% )or e5ample0
.opt.WebSphere.wpEpro)ile
IdmgrEpro)ileJ 3 The root path o) the dmgr pro)ile dire&tor% )or e5ample0
.opt.WebSphere.(ppServer.pro)iles.8mgr!,
Iplugin rootJ 3 The root path o) the WebSphere Plugin dire&tor% )or e5ample0
.opt.WebSphere.Plugins
/
Install WebSphere Application Server v7 on the future Portal Primary Node
In this se&tion %ou will install WebSphere (ppli&ation Server v1'!'!'! on the )uture Portal primar%
Node and upgrade it to v1'!'!'/' WebSphere (ppli&ation Server v1 is NKT provided with the
WebSphere Portal v+','/ bundle so %ou must obtain the installation media and li&ense elsewhere'
1. :rom the W(S v1 installation $8 or image laun&h the installer lo&ated in the W(S dire&tor%0
'.install
2. $li&= LNe5tL on the Wel&ome S&reen0
+
3. (&&ept the li&ense and &li&= LNe5tL0
4. $li&= LNe5tL on the S%stems Prere@uisite $he&= s&reen0
1
5. #o not sele&t an% options &li&= LNe5tL'
6. Sele&t %our installation dire&tor% and &li&= LNe5tL0
7
7. #o not sele&t to &reate a pro)ile'
$ote' The WebSphere Portal installer will &reate its own W(S pro)ile so there is no need to
&reate a pro)ile here' I) %ou do &reate a pro)ile WebSphere Portal will not use it'
8. $li&= L>esL on the warning that pops up when %ou sele&t no pro)ile0
"
9. $he&= the option to &reate a repositor% )or $entrali?ed Installation Managers i) %ouLd li=e and
&li&= Ne5t' In this guide the option is not &he&=ed0
10. Review the in)ormation on the summar% s&reen and &li&= LNe5tL to begin the installation'
11. ()ter the installation &ompletes un&he&= the option to &reate a new pro)ile and &li&= L:inishL to
e5it the installation program'
12. 8ownload the WebSphere (ppli&ation Server v1 Cpdate Installer0
http0..www3!,'ibm'&om.support.do&view'wssGrsH,7!MuidHswg26!2!66+
13. 45tra&t the download into a temporar% dire&tor% and laun&h the installer lo&ated in the Itemp
lo&ationJ.CpdateInstaller dire&tor%0
'.install
,!
15. (&&ept the li&ense and &li&= LNe5tL0
,,
16. $li&= LNe5tL on the S%stem Pre3re@uisite &he&= s&reen'
17. Sele&t the path where %ou would li=e to install the W(S Cpdate Installer0
18. ()ter the installation &ompletes un&he&= the LLaun&hL button and &li&= :inish to e5it the
installer'
19. 8ownload the W(S 1'!'!'/ )i5pa&= and the &orresponding N8O upgrade0
http0..www3!,'ibm'&om.support.do&view'wssGrsH,7!MuidHswg26!2-1!/
http0..www3!,'ibm'&om.support.do&view'wssGrsH,7!MuidHswg26!2-1!7
20. $op% the 1'!'!'/ )i5pa&= and the N8O upgrade to the ICpdateInstaller rootJ.maintenan&e
dire&tor% where ICpdateInstaller rootJ is the lo&ation %ou sele&ted in step ,1'
21. Laun&h the W(S Cpdate Installer )rom the CpdateInstaller dire&tor% %ou set )rom step ,10
'.update'sh
,2
23. Sele&t the WebSphere (ppli&ation Server dire&tor% %ou wish to upgrade and &li&= LNe5tL0
,-
24. Sele&t the LInstall Maintenan&e pa&=ageP option and &li&= LNe5tL0
25. Sele&t the dire&tor% that &ontains the 1'!'!'/ and N8O pa&=ages0
,6
26. $he&= the bo5es )or the 1'!'!'/ and N8O pa&=ages and &li&= LNe5tL0
27. Kn the installation summar% s&reen &li&= LNe5tL to begin the upgrade'
28. ()ter the upgrade &ompletes &li&= L:inishL to e5it the update installer'
29. 8ownload the re@uired WebSphere (ppli&ation Server interim )i5es )or W(S v1'!'!'/ when
using WebSphere Portal v+','!'-.+','/ )rom the WebSphere Portal Support site0
http0..www3!,'ibm'&om.support.do&view'wssGrsH+77MuidHswg26!2-,67
,/
30. 8ownload the )i5es into a temporar% dire&tor%' This should in&lude the )ollowing interim
)i5es0
PO"!-6-
PO",+"7
PO"2!61
PO"-"/2
PO"+21/
PO"1-2,
PO"7-!2
PO"716,
PO""171
PM!!+"2
31. $op% the )i5es into the ICpdateInstaller rootJ.maintenan&e dire&tor% where ICpdateInstaller
rootJ is the lo&ation %ou sele&ted in step ,1'
32. Repeat steps 2,327 to install the interim )i5es' ANote that )or step 2+ %ou will sele&t to install
the interim )i5es listed in Step -! not the 1!!/ and N8O )i5pa&=sB'
,+
Install the Primary Portal Node
In this se&tion %ou will install the primar% Portal node' >ou will use the W(S v1!!/ that %ou installed
)rom the previous se&tion as the base )or this Portal installation' (ll o) the steps in this se&tion will be
done on the server %ou intend to use as %our primar% node'
,' Kpen a terminal window and enter0
ping yourserver.yourcompany.com
where %ourserver'%our&ompan%'&om is %our a&tual )ull% @uali)ied hostname'
2' 4nter0
ping localhost
to veri)% the Qlo&alhostP networ= settings are &on)igured properl% on %our ma&hine'
-' :rom the IL3Setup $8 laun&h the WebSphere Portal installer0
'.install'sh
6' $li&= LNe5tL on the Wel&ome s&reen'
,1
/' (&&ept the li&ense agreement and &li&= LNe5tL0
+' Kn the installation t%pe s&reen sele&t L:ullL and &li&= LNe5tL
$()*0 Sele&t (dministration to install onl% administrative portlets'
,7
1' Sele&t to install to on top o) an e5isting W(S installation0
7' Sele&t the path o) the e5isting W(S installation0
,"
"' Sele&t the desired path )or the WebSphere dire&tor% and &li&= LNe5tL
$()*0 Both the pro)ile dire&tor% and the PortalServer dire&tor% will be &reated in this
WebSphere dire&tor%'
,!' 4nter a node name and the )ull% @uali)ied hostname o) %our server and &li&= LNe5tL'
$()*' The value )or node name will also be used as the &ell name in the standalone
environment'
2!
,,' Se&urit% is enabled )or Portal b% de)ault' 4nter a user I8 and password %ou wish to use' This
I8 will be used to a&&ess both server, and WebSphereEPortal a)ter installation &ompletes'
,2' <eri)% the in)ormation is a&&urate in the summar% s&reen and &li&= LNe5tL to begin the
installation'
2,
,-' Kn&e the installation )inishes un&he&= Laun&h :irst Steps and Laun&h the $on)iguration
Wi?ard' $li&= L:inishL'
,6' <eri)% %ou &an a&&ess Portal in a web browser' The de)ault CRL is0
http0..%ourserver'%our&ompan%'&om0,!!-".wps.portal
(t this point %ou have su&&ess)ull% installed WebSphere Portal v+','!'- on WebSphere
(ppli&ation Server v1'!'!'/'
22
Install IB Support Assistant !ite
In this se&tion %ou will install IBM Support (ssistant Lite )or WebSphere Portal AIS(LiteB' This step
is optional but highl+ re&ommended' IS(Lite provides automati& log &olle&tion and s%mptom anal%sis
support )or WebSphere Portal problem determination s&enarios' Installing this tool now &an save %ou
time in the )uture i) %ou have an% problems with WebSphere Portal that re@uire %ou to &onta&t support'
,' <isit the website below and download IS(Lite )or WebSphere Portal v+', to a temporar%
dire&tor%0
http0..www3!,'ibm'&om.support.do&view'wssGrsH+77MuidHswg26!!7++2
2' 45tra&t the downloaded ?ip )ile into the wpEpro)ile.PortalServer dire&tor%' This will &reate a
dire&tor% &alled IS(Lite'
-' The tool is installed and read% )or use' I) %ou have an issue with WebSphere Portal and re@uire
remote te&hni&al support instru&tions )or using this tool &an be )ound in (ppendi5 8'
2-
Install the "eployment anager
In this se&tion %ou will install the 8eplo%ment Manager' (ll o) the )ollowing steps will be &ompleted
on the server %ou intend to use as %our deplo%ment manager'
(lternativel% %ou &an use the e5isting W(S v1 installation to &reate a 8eplo%ment Manager pro)ile on
the same server as %our primar% Portal node' I) %ou would li=e to do that instead please )ollow
(ppendi5 ( then return to the L$on)igure the 8eplo%ment ManagerL se&tion'
,' :rom the W(S v1 installation $8 or image laun&h the installer )rom the W(S dire&tor%0
'.install
2' $li&= LNe5tL on the Wel&ome S&reen0
26
-' (&&ept the li&ense and &li&= LNe5tL0
6' $li&= LNe5tL on the S%stems Prere@uisite $he&= s&reen0
2/
/' #o not sele&t an% options &li&= LNe5tL'
+' Sele&t %our installation dire&tor% and &li&= LNe5tL0
2+
1' Sele&t to &reate a ,anage-ent pro)ile'
7' :or Server T%pe sele&t 8eplo%ment Manager0
21
"' :or the L4nable (dministrative Se&urit%L s&reen chec. the bo5 to enable se&urit% and provide a
user I8 and Password' !se the sa-e /ser %# and password +o/ specified for the
WebSphere Portal installation.
,!' $he&= the option to &reate a repositor% )or $entraili?ed Installation Managers i) %ouLd li=e and
&li&= Ne5t0
27
,,' Review the in)ormation on the summar% s&reen and &li&= LNe5tL to begin the installation'
,2' ()ter the installation &ompletes &li&= L:inishL to e5it the installation program'
,-' 8ownload the WebSphere (ppli&ation Server v1 Cpdate Installer0
,6' 45tra&t the download into a temporar% dire&tor% and laun&h the installer lo&ated in the Itemp
'.install
2"
,/' $li&= LNe5tL on the Wel&ome S&reen0
,+' (&&ept the li&ense and &li&= LNe5tL0
,1' $li&= LNe5tL on the S%stem Pre3re@uisite &he&= s&reen'
-!
,7' Sele&t the path where %ou would li=e to install the W(S Cpdate Installer0
,"' ()ter the installation &ompletes &li&= :inish to e5it the installer'
2!' 8ownload the W(S 1'!'!'/ )i5pa&= and the &orresponding N8O upgrade0
2,' $op% the 1'!'!'/ )i5pa&= and the N8O upgrade to the ICpdateInstaller rootJ.maintenan&e
dire&tor% where ICpdateInstaller rootJ is the lo&ation %ou sele&ted in Step ,7'
22' Laun&h the W(S Cpdate Installer )rom the CpdateInstaller dire&tor% %ou set )rom step ,70
'.update'sh
-,
2-' $li&= LNe5tL on the Wel&ome S&reen0
26' Sele&t the WebSphere (ppli&ation Server dire&tor% %ou wish to upgrade and &li&= LNe5tL0
-2
2/' Sele&t the LInstall Maintenan&e pa&=ageP option and &li&= LNe5tL0
2+' Sele&t the dire&tor% that &ontains the 1'!'!'/ and N8O pa&=ages0
--
21' $he&= the bo5es )or the 1'!'!'/ and N8O pa&=ages and &li&= LNe5tL0
27' Kn the installation summar% s&reen &li&= LNe5tL to begin the upgrade'
2"' ()ter the upgrade &ompletes &li&= L:inishL to e5it the update installer'
-!' 8ownload the re@uired WebSphere (ppli&ation Server interim )i5es )or W(S v1'!'!'/ when
-6
-,' 45tra&t the ?ip )ile into a temporar% dire&tor%' This should in&lude the )ollowing interim )i5es0
PO"!-6-
PO",+"7
PO"2!61
PO"-"/2
PO"+21/
PO"1-2,
PO"7-!2
PO"716,
PO""171
PM!!+"2
-2' $op% the )i5es into the ICpdateInstaller rootJ.maintenan&e dire&tor% where ICpdateInstaller
--' Repeat steps 2232" to install the interim )i5es' ANote that )or step 21 %ou will sele&t to install
the interim )i5es listed in Step -, not the 1!!/ and N8O )i5pa&=sB'
(t this point the 8eplo%ment Manager has been installed and the 8M9R pro)ile has been &reated'
-/
Configure the "eployment anager
In this se&tion %ou will &on)igure the 8eplo%ment Manager and prepare it )or the )uture Portal &luster'
(ll o) the )ollowing steps will be &ompleted on the server %ou intend to use as %our deplo%ment
manager'
,' :rom a &ommand window navigate to IdmgrEpro)ileJ.bin
2' 45e&ute the )ollowing &ommand to start the 8eplo%ment Manager0
./startManager.sh
-' Kn&e the 8M9R is open )or e3business laun&h a web browser and a&&ess the 8M9R
(dministrative $onsole0
http0..I%ourhostnameJ0"!+!.ibm.&onsole
$()*' The de)ault port is "!+!'
6' 4nter the Cser I8 and Password %ou used during the 8eplo%ment Manager installation and
&li&= LLog inL
/' In&rease the HTTP $onne&tion timeouts )or the deplo%ment manager0
aB Navigate to S+ste- Ad-inistration 01 #eplo+-ent ,anager 01 Web 2ontainer
)ransport 2hains
bB :or ea&h entr% in the table AW$Inbound(dmin and W$Inbound(dminSe&ureB &omplete
the )ollowing0
,' $li&= HTTP Inbound $hannel
2' $hange Read Timeout to ,7!
-' $hange Write Timeout to ,7!
6' $li&= KO
/' Save &on)iguration &hanges
-+
+' $hange the timeout re@uest period )or the Nava Management 45tensions ANMDB &onne&tor'
aB Navigate to S+ste- Ad-inistration 01 #eplo+-ent ,anager 01 Ad-inistration Services
01 3,& connectors 01 S(AP2onnector 01 2/sto- Properties
bB Sele&t the re@uestTimeout propert% and in&rease the value )rom 600 to 6000'
&B Save &on)iguration &hanges'
1' Cpdate the ma5imum Nava heap si?e used b% the deplo%ment manager0
aB $li&= S%stem administration J 8eplo%ment manager J Nava and Pro&ess Management J
Pro&ess 8e)inition J Nava <irtual Ma&hine'
bB Spe&i)% 246 )or %nitial Heap Si5e and 1026 )or ,a"i-/- Heap Si5e'
:or in)ormation about appropriate heap si?es see the do&umentation )or %our operating
s%stem and the Per)orman&e 9uides lo&ated on the WebSphere Portal and Web $ontent
Management Produ&t 8o&umentation page'
$()*0 I) using a -23bit operating s%stem %ou will need to set the heap si?e to a lower si?e
than a +63bit operating s%stem'
&B $li&= KO and then save %our &hanges'
7' Kne signi)i&ant &hange to the wa% &lusters are &reated in Portal v+', is the se&urit%
&on)iguration' The node will inherit the se&urit% settings o) the 8M9R when it is )ederated' I)
%ou have been )ollowing the re&ommendations in this guide then %ou alread% have the Portal
(dministrative Cser I8 &reated in the 8eplo%ment Manager &on)iguration AwpadminB' We will
need to &reate a Portal (dministrative 9roup in the &urrent 8M9R se&urit% &on)iguration and
add the Portal (dministrative Cser to it' These se&urit% settings will ultimatel% be used on&e
our Portal node is )ederated'
Navigate to !sers and 7ro/ps 01 ,anage 7ro/ps
"' $li&= $reate
,!' $reate a group &alled wpsad-ins' 8o not use a di))erent group name'
,,' Navigate to !sers and 7ro/ps 01 ,anage !sers
,2' Sear&h )or the user %ou &reated during 8M9R pro)ile &reation'
-1
,-' (dd the user to the wpsadmins group0
aB $li&= the blue lin= )or the user I8 LwpadminL in the table
bB Kn the ne5t s&reen &li&= the 9roups tab
&B $li&= the (dd button
-7
dB Sear&h )or the group name %ou previousl% &reated in Step ,!'Highlight the group
LwpsadminsL and &li&= L(ddL
eB ()ter the user is su&&ess)ull% added &li&= the L$loseL button
,6' Logout o) the 8eplo%ment Manager (dmin $onsole and &lose the browser'
,/' 4dit the soap'&lient'props )ile )rom the IdmgrEpro)ileJ.properties dire&tor% in a te5t editor'
,+' $hange the &om'ibm'SK(P'timeout entr% to +!!!0
com.ibm.SOAP.requestTimeout=6000
-"
,1' Save the )ile
,7' Restart the 8M9R b% issuing the )ollowing &ommands in a terminal window )rom the
IdmgrEpro)ileJ.bin dire&tor%0
./stopManager.sh -user wpadmin -password wpadmin
./startManager.sh
(t this point %ou have su&&ess)ull% prepared the 8eplo%ment Manager pro)ile )or Portal )ederation'
6!
Configure the Primary Portal node to an e#ternal database
In this se&tion Portal will be &on)igured to use an e5ternal database' :or the purposes o) this
do&ument 8B2 will be used as the e5ternal database with T%pe 6 drivers' This ma% var% in %our
environment' :or more in)ormation about other databases that &an be used with Portal please visit the
WebSphere Portal v+','! In)ormation $enter )or &on)iguring e5ternal databases at this lin= and )ollow
the instru&tions there as appropriate0
topi&H.&om'ibm'wp'ent'do&Ev+,/.&on)ig.linu5EremoteEdb'html
In the environment used )or this guide + databases were &reated )ollowing the instru&tions in the
In)ormation $enter0
R4L8B
$KM8B
$CS8B
N$R8B
:8BO8B
LM8B
In addition the database administrator user Qdb2inst,P will be used as the user I8 )or ea&h database'
I) %ou &hoose to use 8B2 the &ontents o) the S;L )ile used to &reate and prepare the databases is
in&luded in Appendi" 8.
,' :rom the primar% Portal node ensure the WebSphereEPortal and server, servers are stopped b%
e5e&uting the )ollowing &ommands )rom the terminal window in the IwpEpro)ileJ.bin
dire&tor%0
./stopSerer.sh !ebSphere"Porta# -user $admin user% -password $admin pwd%
./stopSerer.sh serer& -user $admin user% -password $admin pwd%
2' 4nsure the database &lient is installed and &on)igured on the node' Sin&e we are using T%pe 6
drivers )or 8B2 all that is needed is to &op% the db2F&&'Far and db2F&&Eli&enseE&u'Far )iles )rom
the 8B2 server to some dire&tor% on the primar% Portal server'
-' 4nsure the remote 8B2 server is started'
6,
6' :rom the IwpEpro)ileJ.$on)ig4ngine.properties dire&tor% ma=e a ba&=up o) the )ollowing
)iles0
w=pl&'properties
w=pl&Edbt%pe'properties
w=pl&E&omp'properties
/' 4dit the w=pl&Edbt%pe'properties )ile and ma=e the )ollowing &hanges0
db'.(b(rier=com.ibm.db'.)cc.(*'(rier
db'.(b+ibrar,=/opt/ibm/db'/-..&/)aa/db')cc.)ar//opt/ibm/db'/-..&/)aa/db')cc
"#icense"cu.)ar
db'.0dbcProider1ame=wpdb0(*2"db'
$()*0 The entr% )or db2'8bLibrar% is an e5ample onl%' Please ensure this is a valid path on
%our s%stem'
+' 4dit the w=pl&E&omp'properties )ile and ma=e the )ollowing &hanges0
3eedbac4.(bT,pe=db'
3eedbac4.(b1ame=3db4db
3eedbac4.(bSchema=566(*A27
3eedbac4.(ataSource1ame=wpdb(S"3db4
3eedbac4.(b8r#=)dbc/db'///m,dbserer.ibm.com/90000/3db4db/returnA#ias=0:
3eedbac4.(b8ser=db'inst&
3eedbac4.(bPassword=password
#i4eminds.(bT,pe=db'
#i4eminds.(b1ame=#mdb
#i4eminds.(bSchema=#i4eminds
#i4eminds.(ataSource1ame=wpdb(S"#mdb
#i4eminds.(b8r#=)dbc/db'///m,dbserer.ibm.com/90000/#mdb/returnA#ias=0:
#i4eminds.(b8ser=db'inst&
#i4eminds.(bPassword=password
re#ease.(bT,pe=db'
re#ease.(b1ame=re#db
re#ease.(bSchema=re#ease
re#ease.(ataSource1ame=wpdb(S"re#db
re#ease.(b8r#=)dbc/db'///m,dbserer.ibm.com/90000/re#db/returnA#ias=0:
re#ease.(b8ser=db'inst&
re#ease.(bPassword=password
communit,.(bT,pe=db'
communit,.(b1ame=comdb
communit,.(bSchema=communit,
communit,.(ataSource1ame=wpdb(S"comdb
communit,.(b8r#=)dbc/db'///m,dbserer.ibm.com/90000/comdb/returnA#ias=0:
communit,.(b8ser=db'admin
communit,.(bPassword=password
62
customi;ation.(bT,pe=db'
customi;ation.(b1ame=cusdb
customi;ation.(bSchema=customi;ation
customi;ation.(ataSource1ame=wpdb(S"cusdb
customi;ation.(b8r#=)dbc/db'///m,dbserer.ibm.com/90000/cusdb/returnA#ias=0:
customi;ation.(b8ser=db'inst&
customi;ation.(bPassword=password
)cr.(bT,pe=db'
)cr.(b1ame=)crdb
)cr.(bSchema=)cr
)cr.(ataSource1ame=wpdb(S")crdb
)cr.(b8r#=)dbc/db'///m,dbserer.ibm.com/90000/)crdb/returnA#ias=0:
)cr.(b8ser=db'inst&
)cr.(bPassword=password
1' $op% the )ollowing )iles )rom the WebSphere Portal server to a temporar% dire&tor% on the 8B2
server0
IPortalServer rootJ.F&r.prere@'F&r.&on)ig.&ollation'Far
IPortalServer rootJ.F&r.prere@'F&r.&on)ig.register$ollationC8:Template's@l
7' :rom the 8B2 server open a terminal window and &hange dire&tories to0
Idb2 instan&e homeJ.s@llib.)un&tion
"' :rom the 8B2 server 45e&ute the )ollowing &ommand0
Far 35v) Itemporar% lo&ationJ.&ollation'Far
$()*' In order )or the above &ommand to wor= %ou must have Fava installed on the 8B2
server and the N(<(EHKM4 environment variable set to the Fava root dire&tor%'
,!' :rom the 8B2 server edit the Itemporar% lo&ationJ.register$ollationC8:Template's@l )ile in a
te5t editor'
,,' $hange all SCHEMA re)eren&es in this )ile to the value %ou set )or F&r'8bS&hema in
w=pl&Edbdomain'properties' In this &ase the s&hema value is LF&rL'
6-
,2' $hange the )ollowing line0
<-A+86 -A=2>A=?@'6A'BC<
to
<-A+86 -A=2>A=?&00BC<
,-' $hange the )ollowing line0
<=6T8=1S -A=2>A=?@'6A'B 5O= *DT (ATA<
to
<=6T8=1S -A=2>A=?&00B 5O= *DT (ATA<
,6' Save the register$ollationC8:Template's@l )ile
,/' :rom the 8B2 server &onne&t to the N$R database b% e5e&uting the )ollowing &ommand in a
terminal window0
db' connect to )crdb using db'inst& using password
,+' :rom the same terminal window e5e&ute the S;L s&ript b% running the )ollowing &ommand0
db' -t3 $temporar, #ocation%/register2o##ation8(5Temp#ate.sq#
,1' 8is&onne&t )rom the N$R8B and restart the 8B2 instan&e'
,7' Swit&h over to the Primar% Portal node and )rom a terminal window &hange dire&tories to
IwpEpro)ile rootJ.$on)ig4ngine
,"' 45e&ute the )ollowing $on)ig4ngine s&ripts to validate the database properties0
./2on3ig6ngine.sh a#idate-database-drier -(!asPassword=$password%
./2on3ig6ngine.sh a#idate-database-connection -(!asPassword=$password%
2!' 45e&ute the )ollowing $on)ig4ngine s&ript to trans)er the database )rom 8erb% to 8B20
./2on3ig6ngine.sh database-trans3er -(Porta#AdminPwd=$password%
-(!asPassword=$password%
66
2,' ()ter the database3trans)er &ompletes &hange dire&tories to IwpEpro)ileJ.bin and e5e&ute the
)ollowing &ommand to start the Portal server0
./startSerer.sh !ebSphere"Porta#
22' <eri)% that %ou &an render Portal su&&ess)ull% in a web browser'
http0..m%server'm%&ompan%'&om0,!!-".wps.portal
(t this point %ou have su&&ess)ull% installed WebSphere Portal and &on)igured it to use an
e5ternal database'
6/
$ederate and Cluster the Primary Node
The ne5t step is to )ederate and &luster the WebSphere Portal node' The &lustering pro&ess has &hanged
signi)i&antl% )rom Portal v+'! to v+',' >ou are no longer re@uired to manuall% e5e&ute the (ddNode
&ommand to add the node to the 8eplo%ment Manager &ell' Instead a $on)ig4ngine s&ript has been
&reated that does this among other things )or %ou' ()ter the )ollowing steps have been &ompleted %ou
will have a one node &luster'
,' :rom the primar% node open a &ommand window and &hange dire&tories to the
IwpEpro)ileJ.$on)ig4ngine dire&tor%'
2' $olle&t )iles )rom the Portal node that will need to be added to the 8eplo%ment Manager )ile
stru&ture' To &olle&t the )iles e5e&ute the )ollowing $on)ig4ngine s&ript0
./2on3ig6ngine.sh co##ect-3i#es-3or-dmgr -(!asPassword=$password%
This will &reate a ?ip )ile &alled )iles)or8mgr'?ip in the IwpEpro)ile rootJ.)iles)or8mgr
dire&tor%'
-' $op% the )iles)or8mgr'?ip )ile )rom %our primar% node to a temporar% dire&tor% on %our
8eplo%ment Manager server'
6' 45tra&t the )iles)or8mgr'?ip into a temporar% dire&tor% on the 8eplo%ment Manager server'
/' 9e-ote #,79 onl+. :rom the temporar% dire&tor% on %our 8eplo%ment Manager &op% the
(ppServer.lib.w=pl&'&omp'registr%'Far and wp'wire'Far into %our I(ppServer rootJ.lib
dire&tor%'
+' :rom the temporar% dire&tor% on %our 8eplo%ment Manager &op% the
(ppServer.plugins.&om'ibm'ws'portlet&ontainer'deplo%tas=E+','!'Far and wp'base'Far )ile into
%our I(ppServer rootJ.plugins dire&tor%'
1' :rom the temporar% dire&tor% on %our 8eplo%ment Manager &op% the
(ppServer.pro)iles.8mgr!,.&on)ig.'repositor%.metadataEw=pl&'5ml )ile into %our Idmgr
pro)ileJ.&on)ig.'repositor% dire&tor%'
7' Stop the deplo%ment manager b% issuing the )ollowing &ommand )rom the Idmgr pro)ileJ.bin
dire&tor%0
./stopManager.sh -user $admin user% -password $admin pwd%
"' Start the deplo%ment manager b% issuing the )ollowing &ommand )rom the Idmgr pro)ile
rootJ.bin dire&tor%0
./startManager.sh
,!' Stop WebSphereEPortal and server, b% e5e&uting the )ollowing &ommands )rom the
IwpEpro)ile rootJ.bin dire&tor%0
6+
,,' Kn the primar% node edit the IwpEpro)ileJ.$on)ig4ngine.properties.w=pl&'properties )ile and
ensure all o) the )ollowing properties are set appropriatel% )or %our enviornment0
!as8serDd=$(ME= admin user D(%
!asPassword=$(ME= admin password%
Porta#AdminPwd=$password%
!as=emote>ost1ame=$3u##, qua#i3ied hostname o3 (ME=%
!asSoapPort=$soap port 3or (ME=: de3au#t is FFA.%
Serer1ame=!ebSphere"Porta#
Primar,1ode=true
2#uster1ame=Porta#2#uster
$()*' This guide was written spe&i)i&all% )or Portal v+','!'- and higher' I) %ou are using
WebSphere Portal v+','!'! +','!', or +','!'2 then %ou -/st leave the !as8serDd and
!asPassword properties set to the standalone server admin values NKT the 8M9R values'
$()*' :or the primar% node %ou -/st leave ServerName as WebSphereEPortal' 8o not
&hange it to an% other value'
,2' 4dit IwpEpro)ileJ.$on)ig4ngine.properties.w=pl&E&omp'properties and ensure all database
user I8s and passwords are a&&urate'
,-' 4nsure that the operating s%stem time on the 8eplo%ment Manager server and the time on the
primar% node are within / minutes o) ea&h other' This is ne&essar% )or Steps ,63,/ to &omplete
su&&ess)ull%'
,6' In a terminal window )rom the primar% node &hange dire&tories to
IwpEpro)ileJ.$on)ig4ngine
61
,/' (dd the node to the deplo%ment manager &ell b% e5e&uting the )ollowing $on)ig4ngine s&ript0
./2on3ig6ngine.sh c#uster-node-con3ig-pre-3ederation -(!asPassword=password
$()*' I) %ou are prompted to a&&ept an SSL &erti)i&ate t%pe > and press 4nter to &ontinue
$()*0 This guide was written spe&i)i&all% )or Portal v+','!'- and higher' I) %ou are using
WebSphere Portal v+','!'! +','!', or +','!'2 then %ou -/st spe&i)% 388MgrCserid and
388MgrPassword parameters when running the &luster3node3&on)ig3pre3)ederation tas=' :or
e5ample0
./2on3ig6ngine.sh c#uster-node-con3ig-pre-3ederation -((Mgr8serid=$(ME=8ser%
-((MgrPassword=$password%
%,P(9)A$)0 I) %ou re&eive a BCIL8 :(IL48 )or the &luster3node3&on)ig3pre3)ederation
s&ript %ou MCST do the )ollowing be)ore running the s&ript again0
,' 45e&ute the )ollowing $on)ig4ngine s&ript to &lean up the W(S registr%0
./2on3ig6ngine.sh -(!as=emote>ost1ame=$standa#one hostname%
-(!asSoapPort=$standa#one soap port%
)or e5ample0
./2on3ig6ngine.sh -(!as=emote>ost1ame=#oca#host -(wasSoapPort=&00@@
I) %our WasCserId and WasPassword values are di))erent )or the 8M9R and the
standalone instan&e then %ou must also add the )ollowing to the $on)ig4ngine
&ommand0 38WasCseridHIstandalone I8J 38WasPasswordHIstandalone passwordJ
2' Remove the node in &ase (ddNode portion o) the s&ript went through su&&ess)ull%
-' Login to the 8M9R and do the )ollowing Athese ma% not e5ist depending on where the
)ailure o&&urredB0
aB Remove all 4nterprise appli&ations
bB Remove the WebSphereEPortal server de)inition
&B Remove the N8B$ Provider in)ormation )or WebSphereEPortal
67
,+' ()ter the previous step &ompletes %our node will be part o) the deplo%ment manager &ell' The
node is now using the 8eplo%ment Manager se&urit% &on)iguration and &ell name' The original
W(S I8 that had been used in the standalone environment will no longer be used'
4dit the IwpEpro)ileJ.$on)ig4ngine.properties.w=pl&'properties )ile and ensure the )ollowing
properties are all set &orre&tl%0
!as8serDd=$dmgr admin user id%
!asPassword=$dmgr password%
2e##1ame=$dmgr ce## name%
,1' Cpdate the deplo%ment manager &on)iguration )or the new WebSphere Portal server b%
e5e&uting the )ollowing $on)ig4ngine s&ript0
./2on3ig6ngine.sh c#uster-node-con3ig-post-3ederation
-(!asPassword=$password%
,7' $reate the &luster de)inition and add the WebSphereEPortal server as a &luster member b%
./2on3ig6ngine.sh c#uster-node-con3ig-c#uster-setup -(!asPassword=$password%
,"' 4nsure that the &luster de)inition was &reated &orre&tl% b% logging into the 8M9R (dmin
$onsole and browse to Server 3J $lusters 3J WebSphere (ppli&ation Server $lusters' (n entr%
)or %our Portal &luster should be present'
2!' <eri)% Portal is )un&tional b% a&&essing it in %our web browser0
http0..m%server'm%&ompan%'&om0,!!-".wps.portal
6"
Install WebSphere Application Server v7 on the future Portal Secondary
Node
In this se&tion %ou will install WebSphere (ppli&ation Server v1'!'!'! on the )uture Portal se&ondar%
Node and upgrade it to v1'!'!'/' WebSphere (ppli&ation Server v1 is NKT provided with the
WebSphere Portal v+','/ bundle so %ou must obtain the installation media and li&ense elsewhere'
,' :rom the W(S v1 installation $8 or image laun&h the installer )rom the W(S dire&tor%0
'.install
/!
-' (&&ept the li&ense and &li&= LNe5tL0
6' $li&= LNe5tL on the S%stems Prere@uisite $he&= s&reen0
/,
/' #o not sele&t an% options &li&= LNe5tL'
+' Sele&t %our installation dire&tor% and &li&= LNe5tL0
/2
1' #o not sele&t to &reate a pro)ile'
$ote' The WebSphere Portal installer will &reate its own W(S pro)ile so there is no need to
&reate a pro)ile here' I) %ou do &reate a pro)ile WebSphere Portal will not use it'
7' $li&= L>esL on the warning that pops up when %ou sele&t no pro)ile0
/-
"' $he&= the option to &reate a repositor% )or $entrali?ed Installation Managers i) %ouLd li=e and
&li&= Ne5t' In this guide the option is not &he&=ed0
,!' Review the in)ormation on the summar% s&reen and &li&= LNe5tL to begin the installation'
,,' ()ter the installation &ompletes un&he&= the option to &reate a new pro)ile and &li&= L:inishL to
e5it the installation program'
,2' 8ownload the WebSphere (ppli&ation Server v1 Cpdate Installer0
,-' 45tra&t the download into a temporar% dire&tor% and laun&h the installer lo&ated in the Itemp
'.install
/6
,6' $li&= LNe5tL on the Wel&ome S&reen0
,/' (&&ept the li&ense and &li&= LNe5tL0
,+' Kn the s%stem prere@uisite s&reen &li&= LNe5tL'
//
,1' Sele&t the path where %ou would li=e to install the W(S Cpdate Installer0
,7' ()ter the installation &ompletes &li&= :inish to e5it the installer'
,"' 8ownload the W(S 1'!'!'/ )i5pa&= and the &orresponding N8O upgrade0
2!' $op% the 1'!'!'/ )i5pa&= and the N8O upgrade to the ICpdateInstaller rootJ.maintenan&e
dire&tor% where ICpdateInstaller rootJ is the lo&ation %ou sele&ted in step ,1'
2,' Laun&h the W(S Cpdate Installer )rom the CpdateInstaller dire&tor% %ou set )rom step ,10
'.update'sh
/+
2-' Sele&t the WebSphere (ppli&ation Server dire&tor% %ou wish to upgrade and &li&= LNe5tL0
/1
26' Sele&t the LInstall Maintenan&e pa&=ageP option and &li&= LNe5tL0
2/' Sele&t the dire&tor% that &ontains the 1'!'!'/ and N8O pa&=ages0
/7
2+' $he&= the bo5es )or the 1'!'!'/ and N8O pa&=ages and &li&= LNe5tL0
21' Kn the installation summar% s&reen &li&= Ne5t to begin the upgrade'

27' ()ter the upgrade &ompletes &li&= L:inishL to e5it the update installer'
2"' 8ownload the re@uired WebSphere (ppli&ation Server interim )i5es )or W(S v1'!'!'/ when
/"
-!' 45tra&t the ?ip )ile into a temporar% dire&tor%' This should in&lude the )ollowing interim )i5es0
PO"!-6-
PO",+"7
PO"2!61
PO"-"/2
PO"+21/
PO"1-2,
PO"7-!2
PO"716,
PO""171
PM!!+"2
-,' $op% the )i5es into the ICpdateInstaller rootJ.maintenan&e dire&tor% where ICpdateInstaller
-2' Repeat steps 2,327 to install the interim )i5es' ANote that )or step 2+ %ou will sele&t to install
the interim )i5es listed in Step -! not the 1!!/ and N8O )i5pa&=sB'
+!
Install the Secondary Portal Node
In this se&tion %ou will install the se&ondar% Portal node' >ou will use the W(S v1!!/ that %ou
installed )rom the previous se&tion as the base )or this Portal installation' (ll o) the steps in this se&tion
will be done on the server %ou intend to use as %our primar% node'
,' Kpen a terminal window and enter0
ping yourserver.yourcompany.com
where %ourserver'%our&ompan%'&om is %our a&tual )ull% @uali)ied hostname'
2' 4nter0
ping localhost
to veri)% the networ= settings are &on)igured properl% on %our ma&hine'
-' :rom the IL3Setup $8 laun&h the WebSphere Portal installer0
'.install'sh
6' $li&= LNe5tL on the Wel&ome s&reen'
/' (&&ept the li&ense agreement and &li&= LNe5tL0
+,
+' Kn the installation t%pe s&reen sele&t L:ullL and &li&= LNe5tL
$()*0 Sele&t (dministration to install onl% administrative portlets'
+2
1' Sele&t to install to on top o) an e5isting W(S installation0
7' Sele&t the path o) the e5isting W(S installation0
+-
"' Sele&t the desired path )or the WebSphere dire&tor% and &li&= LNe5tL
$()*0 Both the pro)ile dire&tor% and the PortalServer dire&tor% will be &reated in this
WebSphere dire&tor%'
,!' 4nter a node name and the )ull% @uali)ied hostname o) %our server and &li&= LNe5tL'
$()*' The value )or node name will also be used as the &ell name in the standalone
environment'
+6
,,' Se&urit% is enabled )or Portal b% de)ault' 4nter the sa-e user I8 and password %ou used )or the
Primar% node installation'
,2' <eri)% the in)ormation is a&&urate in the summar% s&reen and &li&= LNe5tL to begin the
installation'
,-' Kn&e the installation )inishes un&he&= Laun&h :irst Steps and Laun&h the $on)iguration
Wi?ard' $li&= L:inishL'
,6' <eri)% %ou &an a&&ess Portal in a web browser' The de)ault CRL is0
http0..%ourserver'%our&ompan%'&om0,!!-".wps.portal
+/
Install IB Support Assistant !ite
In this se&tion %ou will install IBM Support (ssistant Lite )or WebSphere Portal AIS(LiteB' This step
is optional but highl+ re&ommended' IS(Lite provides automati& log &olle&tion and s%mptom anal%sis
support )or WebSphere Portal problem determination s&enarios' Installing this tool now &an save %ou
time in the )uture i) %ou have an% problems with WebSphere Portal that re@uire %ou to &onta&t support'
,' <isit the website below and download IS(Lite )or WebSphere Portal v+', to a temporar%
dire&tor%0
http0..www3!,'ibm'&om.support.do&view'wssGrsH+77MuidHswg26!!7++2
2' 45tra&t the downloaded ?ip )ile into the wpEpro)ile.PortalServer dire&tor%' This will &reate a
dire&tor% &alled IS(Lite'
-' The tool is installed and read% )or use' I) %ou have an issue with WebSphere Portal that re@uires
support instru&tions )or using this tool &an be )ound in (ppendi5 8'
++
$ederate and Cluster the Secondary Portal node
This se&tion &overs adding the se&ondar% node to the 8eplo%ment Manager &ell and adding its
WebSphereEPortal server as a se&ondar% member to the previousl% &reated &luster' Kn&e this se&tion is
&ompleted %ou will have a )un&tional two3node &luster using the de)ault <MM se&urit% &on)iguration
and &on)igured to an e5ternal database'
,' 4nsure the database &lient is installed and &on)igured on the se&ondar% node' :or 8B2 with
T%pe 6 drivers &op% the db2F&&'Far and db2F&&Eli&enseE&u'Far )iles )rom the 8B2 server to some
dire&tor% on the se&ondar% Portal server'
)iles0
w=pl&'properties
-' $op% the w=pl&E&omp'properties and w=pl&Edbt%pe'properties )rom Node, to Node2 to ensure
the same database &on)iguration'
$()*' 4nsure that the value o) db2'8bLibrar% and derb%'8bLibrar% in
w=pl&Edbt%pe'properties &ontain valid dire&tor% paths )or this node'
6' Kn the se&ondar% node edit the IwpEpro)ileJ.$on)ig4ngine.properties.w=pl&'properties )ile
and ensure all o) the )ollowing properties are set appropriatel% )or %our enviornment0
!as8serDd=$(ME= admin user D(%
!asPassword=$(ME= admin password%
Porta#AdminPwd=$password%
Primar,1ode=3a#se
$()*' This guide was written spe&i)i&all% )or Portal v+','!'- and higher' I) %ou are using
WebSphere Portal v+','!'! +','!', or +','!'2 then %ou -/st leave the !as8serDd and
!asPassword properties set to the standalone server admin values NKT the 8M9R values'
$()*' 4nsure that the value )or $lusterName mat&hes the value )or $lusterName on the
primar% node'
+1
/' Stop WebSphereEPortal and server, b% e5e&uting the )ollowing &ommands )rom the
+' 4nsure the 8M9R is ST(RT48 b% running the )ollowing &ommand )rom the
IdmgrEpro)ileJ.bin dire&tor%'
./startManager.sh
1' In a &ommand window )rom the se&ondar% node &hange dire&tories to
7' (dd the node to the deplo%ment manager &ell b% e5e&uting the )ollowing $on)ig4ngine s&ript0
./2on3ig6ngine.sh c#uster-node-con3ig-pre-3ederation -(!asPassword=password
e5ample0
-((MgrPassword=$password%
%,P(9)A$)0 I) %ou re&eive a BCIL8 :(IL48 )or the &luster3node3&on)ig3pre3)ederation
s&ript %ou MCST run the )ollowing $on)ig4ngine s&ript to &lean up the W(S registr%0
./2on3ig6ngine.sh -(!as=emote>ost1ame=$standa#one hostname%
-(!asSoapPort=$standa#one soap port%
)or e5ample0
./2on3ig6ngine.sh -(!as=emote>ost1ame=#oca#host -(!asSoapPort=&00@@
"' ()ter the previous step &ompletes %our node will be part o) the deplo%ment manager &ell' (s a
result this node is now using the 8eplo%ment Manager se&urit% &on)iguration and &ell name'
The original W(S I8 that had been used in the standalone environment will no longer be used'
4dit the IwpEpro)ileJ.$on)ig4ngine.properties.w=pl&'properties )ile and ensure the )ollowing
properties are set &orre&tl%0
+7
!as8serDd=$dmgr admin user%
!asPassword=$dmgr password%
,!' Cpdate the deplo%ment manager &on)iguration )or the new WebSphere Portal server b%
./2on3ig6ngine.sh c#uster-node-con3ig-post-3ederation -(!asPassword=password
,,' 4nsure the Node(gent is started on this node b% running the )ollowing &ommand )rom the
IwpEpro)ileJ.bin dire&tor%0
'.start1ode.sh
,2' Spe&i)% the name o) the )uture se&ondar% &luster member'
4dit the IwpEpro)ileJ.$on)ig4ngine.w=pl&'properties )ile and &hange the )ollowing propert%0
Serer1ame=$name o3 new c#uster member%
$()*' When %ou open the properties )ile %ou should see WebSphereEPortalEnodename' >ou
&an use this value i) %ou li=e' Ktherwise %ou &an &hange this to an%thing 4D$4PT
LWebSphereEPortalL' 8K NKT use the value o) LWebSphereEPortalL )or %our se&ondar% &luster
member'
,-' 4nsure that the operating s%stem time on the 8eplo%ment Manager server and the time on the
primar% node are within / minutes o) ea&h other' This is ne&essar% )or Steps ,2 to &omplete
su&&ess)ull%'
,6' (dd this newl% )ederated WebSphereEPortal server as a &luster member to the e5isting &luster
b% e5e&uting the )ollowing $on)ig4ngine s&ript0
'.2on3ig6ngine.sh c#uster-node-con3ig-c#uster-setup -(!asPassword=password
$()*' This will automati&all% add a se&ondar% &luster member to %our e5isting &luster based
on whatever value %ou set )or ServerName in step ,!' In this e5ample the de)ault value was
used' The node name is wpNode2 so our &luster member will be &alled
WebSphereEPortalEwpNode2'
,/' (llow :0 -in/tes )or ear e5pansion to &omplete on the se&ondar% node' :ailure to do so ma%
result in several appli&ations being unavailable on this node'
+"
,+' Start the new &luster member WebSphereEPortalEnodename )rom the wpEpro)ile.bin dire&tor%0
'.startSerer.sh !ebSphere"Porta#"nodename
,1' To veri)% that the &luster was &reated su&&ess)ull% log in to the 8M9R (dministrative $onsole
and browse to0
Serers -% 2#usters -% !ebSphere App#ication Serer 2#usters -% ClusterName
-% 2#uster Members
(n entr% )or WebSphereEPortalEnodename should be available'
$()*0 In this e5ample the WebSphereEPortalEwpNode2 server is a new server in this
&on)iguration' The original WebSphereEPortal server )rom the se&ondar% node gets removed
during the &luster3node3&on)ig3&luster3setup $on)ig4ngine s&ript' (s a result new port
numbers have been assigned to the WebSphereEPortalEnodename server' To &he&= what ports
are in use with this server navigate to0
Serers -% Serer T,pes -% App#ication Serers -% !ebSphere"Porta#"nodename
-% Ports
The W$Ede)aulthost is the port used to a&&ess Portal' The de)ault port in this &ase is ,!!/!'
I) %ou need to &hange these port numbers %ou &an do so )rom this s&reen' (lternativel%
$on)ig4ngine s&ripts are provided to modi)% port numbers' 8etails &an be )ound in Step " o)
the In)ormation $enter instru&tions )ound here0
topi&H.&om'ibm'wp'ent'do&Ev+,/.install.linu5EinstEwpE&lus'html
1!
,7' <eri)% )un&tionalit% o) the se&ondar% node b% a&&essing it in a web browser0
http0..m%&ompan%'m%server'&om0,!!/!.wps.portal
(t this point %ou have su&&ess)ull% built a two3node WebSphere Portal &luster using a remote database
and <MM )ile )ederated se&urit%'
1,
Configure the Portal Cluster for Security
This se&tion &overs &hanging the se&urit% &on)iguration )rom the de)ault user registr% to a standalone
L8(P Server' :or more details about L8(P.Se&urit% &on)iguration please re)er to the In)ormation
$enter0
http'p/blib.bo/lder.ib-.co-infocenterwpdocv6r1inde".;sp<
topic=co-.ib-.wp.ent.doc>v614installlin/">cfg>wp>/reg>cl/s.ht-l
Se&urit% &on)iguration has &hanged signi)i&antl% in Portal v+','!'5' The Ldisable3se&urit%L s&ript )rom
Portal v/','5 and v+'!'5 no longer e5ists' Instead a single $on)ig4ngine s&ript is e5e&uted to &hange
)rom one user registr% to another or to update an e5isting user registr%' There are several di))erent
options )or se&urit% &on)iguration and we en&ourage %ou to review all options in the In)ormation $enter
)rom the lin= above to determine what is best )or %our environment'
In this guide we will &on)igure se&urit% in our &luster to a standalone ldap server using IBM Tivoli
8ire&tor% Server v+','
,' :rom the primar% node edit the wpEse&urit%Eids'properties )ile in the
IwpEpro)ileJ.$on)ig4ngine.&on)ig.helpers dire&tor%'
2' Modi)% the )ollowing properties in this helper )ile to mat&h %our L8(P &on)iguration' The
values used in this guide are listed below0
standa#one.#dap.id=Porta#+dap
standa#one.#dap.host=m,#dapserer.rtp.ra#eigh.ibm.com
standa#one.#dap.port=@F.
standa#one.#dap.bind(1=uid=wpbindCcn=usersCdc=ibmCo=com
standa#one.#dap.bindPassword=wpbind
standa#one.#dap.#dapSererT,pe=D(S
standa#one.#dap.userDdMap=G/uid
standa#one.#dap.groupDdMap=G/cn
standa#one.#dap.groupMemberDdMap=ibm-a##Eroups/member:ibm-
a##Eroups/uniqueMember
standa#one.#dap.user5i#ter=?H?uid=IB?ob)ectc#ass=inetOrgPersonBB
standa#one.#dap.group5i#ter=?H?cn=IB?ob)ectc#ass=groupO38nique1amesBB
standa#one.#dap.sererDd=uid=wpbindCcn=usersCdc=ibmCo=com
standa#one.#dap.sererPassword=wpbind
standa#one.#dap.rea#m=Porta#=ea#m
standa#one.#dap.primar,AdminDd=uid=wpadminCcn=usersCdc=ibmCo=com
standa#one.#dap.primar,AdminPassword=wpadmin
standa#one.#dap.primar,Porta#AdminDd=uid=wpadminCcn=usersCdc=ibmCo=com
standa#one.#dap.primar,Porta#AdminPassword=wpadmin
standa#one.#dap.primar,Porta#AdminEroup=cn=wpsadminsCcn=groupsCdc=ibmCo=com
standa#one.#dap.base(1=dc=ibmCo=com
12
standa#one.#dap.et.group.search5i#ter=ob)ectc#ass=groupO38nique1ames
standa#one.#dap.et.group.ob)ect2#asses=groupO38nique1ames
standa#one.#dap.et.group.ob)ect2#asses5or2reate=
standa#one.#dap.et.group.search*ases=cn=groupsCdc=ibmCo=com
standa#one.#dap.et.personaccount.search5i#ter=ob)ectc#ass=inetOrgPerson
standa#one.#dap.et.personaccount.ob)ect2#asses=inetOrgPerson
standa#one.#dap.et.personaccount.ob)ect2#asses5or2reate=
standa#one.#dap.et.personaccount.search*ases=cn=usersCdc=ibmCo=com
standa#one.#dap.gm.groupMember1ame=uniqueMember
standa#one.#dap.gm.ob)ect2#ass=groupO38nique1ames
standa#one.#dap.gm.scope=direct
standa#one.#dap.gm.dumm,Member=uid=dumm,
standa#one.#dap.personAccountParent=cn=usersCdc=ibmCo=com
standa#one.#dap.groupParent=cn=groupsCdc=ibmCo=com
standa#one.#dap.personAccount=dnProperties=uid
standa#one.#dap.group=dnProperties=cn
$()*' The properties in the L(dvan&ed PropertiesL se&tion o) the helper )ile were not modi)ied
)rom the de)aults in this e5ample'
-' :rom a terminal window &hange dire&tories to the IwpEpro)ileJ.$on)ig4ngine dire&tor% and
e5e&ute the )ollowing $on)ig4ngine s&ript to validate the properties0
'.2on3ig6ngine.sh a#idate-standa#one-#dap
-(parentProperties=$wp"pro3i#e%/2on3ig6ngine/con3ig/he#pers/wp"securit,"ids.p
roperties -(saeParentProperties=true -(!asPassword=$password%
$()*' B% using the
roperties -(saeParentProperties=true )lags $on)ig4ngine will automati&all% save the
properties )rom the helper )ile into the w=pl&'properties )ile'
$()*' WasPassword should be the c/rrent W(S password NKT %our intended L8(P user
password'
6' 45e&ute the )ollowing $on)ig4ngine s&ript to modi)% the se&urit% settings )rom the de)ault
<MM )ile se&urit% settings to the new L8(P settings0
'.2on3ig6ngine.sh wp-modi3,-#dap-securit,
$()*' This s&ript will automati&all% &hange WasCserId Portal(dminId and
Portal(dmin9roupId in w=pl&'properties to mat&h that o) standalone'ldap'primar%(dminId
standalone'ldap'primar%Portal(dminId and standalone'ldap'primar%Portal(dmin9roup'
1-
/' Restart the 8M9R all Node(gents and all $luster Members'
+' In the w=pl&'properties on the se&ondar% node edit the )ollowing properties to re)le&t %our
L8(P values0
!as8serid
!asPassword
Porta#AdminDd
Porta#AdminDdPwd
Porta#AdminEroupDd
1' $op% the wpEse&urit%Eids'properties )rom the IwpEpro)ileJ.$on)ig4ngine.&on)ig.helpers
dire&tor% on %our Primar% node to the IwpEpro)ileJ.$on)ig4ngine.&on)ig.helpers dire&tor% on
the se&ondar% node'
7' :rom the se&ondar% node &op% the &ontents o) the helper )ile into the main w=pl&'properties
)ile b% running the )ollowing &ommand Aall on one lineB0
'.2on3ig6ngine.sh
roperties -(saeParentProperties=true -(!asPassword=$+(AP Password%
"' Cpdate the Portal se&urit% in)ormation on the se&ondar% node b% e5e&uting the )ollowing
$on)ig4ngine s&ript )rom the IwpEpro)ileJ.$on)ig4ngine dire&tor% on %our se&ondar% node0
./2on3ig6ngine.sh enab#e-)cr-securit, -(!asPassword=$+(AP password%
,!' Restart the se&ondar% nodeLs WebSphereEPortal server b% e5e&uting the )ollowing &ommands
)rom the IwpEpro)ileJ.bin dire&tor% on the se&ondar% node0
./stopSerer.sh !ebSphere"Porta#"nodename -user $!AS user D(% -password
password
./startSerer.sh !ebSphere"Porta#"nodename
16
Configure the Portal Cluster %ith an e#ternal %eb server
This se&tion des&ribes how to &on)igure the Portal &luster with an e5ternal web server' :or more details
about web server &on)iguration please visit the WebSphere Portal Server In)ormation $enter at this
lin=0
topi&H.&om'ibm'wp'ent'do&Ev+,/.install.linu5EprepEihs'html
In this guide we will &on)igure the Portal &luster with IBM HTTP Server v+','
,' :rom $8 IL3,- navigate to RIHSR and run the )ollowing &ommand0
./insta##
$()*' The $8.image that &ontains the IHS installer will var% on ea&h operating s%stem' The
title o) the $8.image is Q4dge $omponents )or WebSphere (ppli&ation Server Networ=
8eplo%mentP'
2' Kn the Wel&ome s&reen &li&= Ne5t'
1/
(&&ept the li&ense agreement and &li&= Ne5t'
-' Sele&t the installation path )or the web server and &li&= Ne5t'
1+
6' $hange the port numbers i) needed and &li&= Ne5t'
/' $reate a user I8 and password to be used )or authenti&ation to the IBM HTTP (dministration
server and &li&= Ne5t'
11
+' !ni" onl+' Sele&t to setup an IBM HTTP (dministration Server i) %ouLd li=e' :or this guide
this option was /nchec.ed' $li&= Ne5t'
1' Sele&t the &he&=bo5 to install the Web Server plugin as part o) the Web Server installation'
Sele&t a web server de)inition value and ensure the hostname is &orre&t )or this server' $li&=
Ne5t'
17
7' Kn the summar% s&reen ensure ever%thing is &orre&t and &li&= Ne5t to begin the installation'
"' Kn&e the installation )inishes &li&= :inish to e5it the installer'
,!' Navigate to Iplugin rootJ.bin and )ind the &on)igurewebservername'sh s&ript where
webservername is the web server de)inition name %ou de)ined on step 7' In this &ase we used
webserver, so our s&ript is &alled0
&on)igurewebserver,'sh
,,' $op% the &on)igurewebserver,'sh s&ript )rom the Iplugin rootJ.bin dire&tor% to the
IdmgrEpro)ileJ.bin dire&tor% on %our 8eplo%ment Manager server'
,2' 4nsure that the 8M9R is running'
,-' In a &ommand line )rom the IdmgrEpro)ileJ.bin dire&tor% run the )ollowing &ommand0
'.con3igurewebserer&.sh -user $was"admin"user% -password password
$()*' This s&ript will &reate the web server de)inition in the 8M9R &on)iguration and map
all o) the installed appli&ations to the web server'
1"
,6' Regenerate the web server plugin b% per)orming the )ollowing steps0
,' Login to the 8M9R (dmin $onsole
2' Navigate to Servers 3J Server T%pes 3J Web Servers
-' Sele&t the $he&=bo5 )or the new web server de)inition
6' $li&= the Q9enerate Plug3inP button
$()*' This will be written to the
IdmgrEpro)ileJ.&on)ig.&ells.I&ellnameJ.nodes.InodenameJ.servers.webserver,.plugin3
&)g'5ml )ile'
,/' $op% the plugin3&)g'5ml )ile to the remote web server at the )ollowing dire&tor% overwriting
the e5isting one0
IpluginErootJ.&on)ig.webserver,
,+' Restart the 8M9R web server and &luster'
,1' <eri)% that %ou &an a&&ess the Portal &luster via the web server0
http0..m%webserver'hostname'&om.wps.portal
Conclusion
In this guide %ou saw how to build a )ull% )un&tional WebSphere Portal v+','!'-.+','/ &luster using an
e5ternal database and a L8(P )or se&urit%' >ou also saw how to &on)igure a web server to allow )or
load balan&ing'
7!
Appendi# A & Create a "eployment anager profile on the Primary Portal
node'
In this se&tion %ou will &reate a deplo%ment manager pro)ile on that same server that &ontains %our
WebSphere Portal primar% node' This is an optional se&tion and is meant to be an alternative to
installing the 8eplo%ment Manager on a separate server'
(ll o) these steps will be &ompleted on the server %ou intend to use as both %our Primar% Portal Node
and 8eplo%ment Manager'
,' Laun&h a terminal window and navigate to the I(ppServer rootJ.bin.Pro)ileManagement
dire&tor%'
2' Laun&h the Pro)ile Management Tool0
'.pmt'sh
-' Kn the Wel&ome S&reen &li&= the button )or QLaun&h Pro)ile ManagementP0
6' $li&= the button )or Q$reateP to &reate a new pro)ile0
7,
/' Kn the L4nvironment Sele&tionL s&reen sele&t LManagementL and &li&= Ne5t0
+' Kn the LServer T%peL s&reen sele&t L8eplo%ment ManagerL and &li&= Ne5t0
72
1' Kn the LPro)ile $reation KptionsL s&reen %ou &an sele&t either T%pi&al or (dvan&ed' In this
e5ample we use LT%pi&alL' $li&= Ne5t0
7' Kn the L(dministrative Se&urit%L s&reen sele&t the &he&=bo5 to enable se&urit% and enter the
sa-e &redentials %ou used )or the WebSphere Portal installation' $li&= Ne5t'
7-
"' Kn the summar% s&reen review the in)ormation and &li&= $reate'
,!' When the pro)ile &reation &ompletes un&he&= the bo5 )or LLaun&h :irst StepsL and &li&= :inish'
(t this point the 8eplo%ment Manager pro)ile has been &reated on the same server as %our primar%
node' >ou &an &ontinue building %our &luster starting at the L$on)iguring the 8eplo%ment ManagerL
se&tion'
76
Appendi# B & S(! Script to Create "B) "atabases
The )ollowing se&tion &ontains the &ontents o) the S;L s&ript used to &reate the WebSphere Portal 8B2
databases' To use this s&ript &omplete the )ollowing steps0
,' $op% the &ontents o) this se&tion into a te5t )ile
2' 4dit the database names user names and passwords in the )ile to mat&h those o) %our intended
environment' #o $() &hange the N$R bu))erpool or tablespa&e names' These -/st be the
values listed here'
-' Save the )ile as a 's@l )ile A)or e5ample $reate8atabases's@lB
6' $op% the )ile to a temporar% dire&tor% on the 8B2 server'
/' (s the database administrator e5e&ute the s&ript0
db2 3tv) Itemporar% lo&ationJ.$reate8atabases's@l
This s&ript does all o) the )ollowing0
$reates and updates si5 databases A%ou ma% &hange these namesB0 reldb &omdb &usdb' F&rdb
lmdb )db=db
$reates bu))erpools )or F&rdb' #( $() &hange these names0 I$MLS:R4;BP6
I$MLS<KL(TIL4BP6 I$MLSM(INBP-2 $MBM(IN6'
$reates tablespa&es )or F&rdb' #( $() &hange these names0 I$ML:;-2 I$MLN:-2
I$M<:;!6 I$MS:;!6 $MBIN<!6 I$MLSS>STSP($4-2 I$MLSS>STSP($46
HHHHHHHB49IN $KP> H4R4HHH8K NKT IN$LC84 THIS LIN4HHHHHHHHHH
2=6AT6 (* re#db using codeset 8T5-F territor, us PAE6SDJ6 F&.':
8P(AT6 (* 25E 5O= re#db 8SD1E app#heaps; K0.6:
8P(AT6 (* 25E 5O= re#db 8SD1E app"ct#"heap"s; &0'K:
8P(AT6 (* 25E 5O= re#db 8SD1E stmtheap @'A6F:
8P(AT6 (* 25E 5O= re#db 8SD1E dbheap 'K00:
8P(AT6 (* 25E 5O= re#db 8SD1E #oc4#ist &000:
8P(AT6 (* 25E 5O= re#db 8SD1E #og3i#si; K000:
8P(AT6 (* 25E 5O= re#db 8SD1E #ogprimar, &':
8P(AT6 (* 25E 5O= re#db 8SD1E #ogsecond '0:
8P(AT6 (* 25E 5O= re#db 8SD1E #ogbu3s; @':
8P(AT6 (* 25E 5O= re#db 8SD1E ag"app#s 9:
8P(AT6 (* 25E 5O= re#db 8SD1E #oc4timeout @0:
8P(AT6 (* 25E 5O= re#db using A8TO"MAD1T o33:
7/
2=6AT6 (* comdb using codeset 8T5-F territor, us PAE6SDJ6 F&.':
8P(AT6 (* 25E 5O= comdb 8SD1E app#heaps; K0.6:
8P(AT6 (* 25E 5O= comdb 8SD1E app"ct#"heap"s; &0'K:
8P(AT6 (* 25E 5O= comdb 8SD1E stmtheap @'A6F:
8P(AT6 (* 25E 5O= comdb 8SD1E dbheap 'K00:
8P(AT6 (* 25E 5O= comdb 8SD1E #oc4#ist &000:
8P(AT6 (* 25E 5O= comdb 8SD1E #og3i#si; K000:
8P(AT6 (* 25E 5O= comdb 8SD1E #ogprimar, &':
8P(AT6 (* 25E 5O= comdb 8SD1E #ogsecond '0:
8P(AT6 (* 25E 5O= comdb 8SD1E #ogbu3s; @':
8P(AT6 (* 25E 5O= comdb 8SD1E ag"app#s 9:
8P(AT6 (* 25E 5O= comdb 8SD1E #oc4timeout @0:
8P(AT6 (* 25E 5O= comdb using A8TO"MAD1T o33:
2=6AT6 (* cusdb using codeset 8T5-F territor, us PAE6SDJ6 F&.':
8P(AT6 (* 25E 5O= cusdb 8SD1E app#heaps; K0.6:
8P(AT6 (* 25E 5O= cusdb 8SD1E app"ct#"heap"s; &0'K:
8P(AT6 (* 25E 5O= cusdb 8SD1E stmtheap @'A6F:
8P(AT6 (* 25E 5O= cusdb 8SD1E dbheap 'K00:
8P(AT6 (* 25E 5O= cusdb 8SD1E #oc4#ist &000:
8P(AT6 (* 25E 5O= cusdb 8SD1E #og3i#si; K000:
8P(AT6 (* 25E 5O= cusdb 8SD1E #ogprimar, &':
8P(AT6 (* 25E 5O= cusdb 8SD1E #ogsecond '0:
8P(AT6 (* 25E 5O= cusdb 8SD1E #ogbu3s; @':
8P(AT6 (* 25E 5O= cusdb 8SD1E ag"app#s 9:
8P(AT6 (* 25E 5O= cusdb 8SD1E #oc4timeout @0:
8P(AT6 (* 25E 5O= cusdb using A8TO"MAD1T o33:
2=6AT6 (* )crdb using codeset 8T5-F territor, us PAE6SDJ6 F&.':
8P(AT6 (* 25E 5O= )crdb 8SD1E app#heaps; K0.6:
8P(AT6 (* 25E 5O= )crdb 8SD1E app"ct#"heap"s; &0'K:
8P(AT6 (* 25E 5O= )crdb 8SD1E stmtheap @'A6F:
8P(AT6 (* 25E 5O= )crdb 8SD1E dbheap 'K00:
8P(AT6 (* 25E 5O= )crdb 8SD1E #oc4#ist &000:
8P(AT6 (* 25E 5O= )crdb 8SD1E #og3i#si; K000:
8P(AT6 (* 25E 5O= )crdb 8SD1E #ogprimar, &':
7+
8P(AT6 (* 25E 5O= )crdb 8SD1E #ogsecond '0:
8P(AT6 (* 25E 5O= )crdb 8SD1E #ogbu3s; @':
8P(AT6 (* 25E 5O= )crdb 8SD1E ag"app#s 9:
8P(AT6 (* 25E 5O= )crdb 8SD1E #oc4timeout @0:
8P(AT6 (* 25E 5O= )crdb using A8TO"MAD1T o33:
2=6AT6 (* #mdb using codeset 8T5-F territor, us PAE6SDJ6 F&.':
8P(AT6 (* 25E 5O= #mdb 8SD1E app#heaps; K0.6:
8P(AT6 (* 25E 5O= #mdb 8SD1E app"ct#"heap"s; &0'K:
8P(AT6 (* 25E 5O= #mdb 8SD1E stmtheap @'A6F:
8P(AT6 (* 25E 5O= #mdb 8SD1E dbheap 'K00:
8P(AT6 (* 25E 5O= #mdb 8SD1E #oc4#ist &000:
8P(AT6 (* 25E 5O= #mdb 8SD1E #og3i#si; K000:
8P(AT6 (* 25E 5O= #mdb 8SD1E #ogprimar, &':
8P(AT6 (* 25E 5O= #mdb 8SD1E #ogsecond '0:
8P(AT6 (* 25E 5O= #mdb 8SD1E #ogbu3s; @':
8P(AT6 (* 25E 5O= #mdb 8SD1E ag"app#s 9:
8P(AT6 (* 25E 5O= #mdb 8SD1E #oc4timeout @0:
8P(AT6 (* 25E 5O= #mdb using A8TO"MAD1T o33:
2=6AT6 (* 3db4db using codeset 8T5-F territor, us PAE6SDJ6 F&.':
8P(AT6 (* 25E 5O= 3db4db 8SD1E app#heaps; K0.6:
8P(AT6 (* 25E 5O= 3db4db 8SD1E app"ct#"heap"s; &0'K:
8P(AT6 (* 25E 5O= 3db4db 8SD1E stmtheap @'A6F:
8P(AT6 (* 25E 5O= 3db4db 8SD1E dbheap 'K00:
8P(AT6 (* 25E 5O= 3db4db 8SD1E #oc4#ist &000:
8P(AT6 (* 25E 5O= 3db4db 8SD1E #og3i#si; K000:
8P(AT6 (* 25E 5O= 3db4db 8SD1E #ogprimar, &':
8P(AT6 (* 25E 5O= 3db4db 8SD1E #ogsecond '0:
8P(AT6 (* 25E 5O= 3db4db 8SD1E #ogbu3s; @':
8P(AT6 (* 25E 5O= 3db4db 8SD1E ag"app#s 9:
8P(AT6 (* 25E 5O= 3db4db 8SD1E #oc4timeout @0:
8P(AT6 (* 25E 5O= 3db4db using A8TO"MAD1T o33:
2O1162T TO )crdb 8S6= db'inst& 8SD1E password:
2=6AT6 *8556=POO+ D2M+S5=6L*PK SDJ6 &000 PAE6SDJ6 K 7:
2=6AT6 *8556=POO+ D2M+S-O+ATD+6*PK SDJ6 F000 PAE6SDJ6 K 7:
71
2=6AT6 *8556=POO+ D2M+SMAD1*P@' SDJ6 F000 PAE6SDJ6 @' 7:
2=6AT6 *8556=POO+ 2M*MAD1K SDJ6 &000 PAE6SDJ6 K 7:
2=6AT6 =6E8+A= TA*+6SPA26 D2M+5L@' PAE6SDJ6 @' 7 MA1AE6( *M SMST6M 8SD1E
?ND2M+5L@'NB *8556=POO+ D2M+SMAD1*P@':
2=6AT6 =6E8+A= TA*+6SPA26 D2M+15@' PAE6SDJ6 @' 7 MA1AE6( *M SMST6M 8SD1E
?ND2M+15@'NB *8556=POO+ D2M+SMAD1*P@':
2=6AT6 =6E8+A= TA*+6SPA26 D2M-5L0K PAE6SDJ6 K 7 MA1AE6( *M SMST6M 8SD1E
?ND2M-5L0KNB *8556=POO+ D2M+S-O+ATD+6*PK:
2=6AT6 =6E8+A= TA*+6SPA26 D2MS5L0K PAE6SDJ6 K 7 MA1AE6( *M SMST6M 8SD1E
?ND2MS5L0KNB *8556=POO+ D2M+S5=6L*PK:
2=6AT6 =6E8+A= TA*+6SPA26 2M*D1-0K PAE6SDJ6 K 7 MA1AE6( *M SMST6M 8SD1E
?N2M*D1-0KNB *8556=POO+ 2M*MAD1K:
2=6AT6 SMST6M T6MPO=A=M TA*+6SPA26 D2M+SSMSTSPA26@' PAE6SDJ6 @' 7 MA1AE6( *M SMST6M
8SD1E ?Nicm#ss,stspace@'NB *8556=POO+ D2M+SMAD1*P@':
2=6AT6 SMST6M T6MPO=A=M TA*+6SPA26 D2M+SSMSTSPA26K PAE6SDJ6 K 7 MA1AE6( *M SMST6M
8SD1E ?Nicm#ss,stspaceKNB *8556=POO+ D2M+S-O+ATD+6*PK:
(DS2O1162T )crdb:
T6=MD1AT6:
HHHHHHH4N8 $KP> H4R4HHH8K NKT IN$LC84 THIS LIN4HHHHHHHHHH
77
Appendi# C & Adding a *ertical Cluster member
()ter &reating %our &luster %ou ma% need to add additional members to the &luster' This se&tion will
des&ribe how to properl% add a verti&al &luster member to %our &luster'
,' :rom a &ommand window navigate to I(ppServer rootJ.pro)iles.8mgr!,.bin
2' 45e&ute the )ollowing &ommand0
'.startManager.sh
-' Kn&e the 8M9R is open )or e3business laun&h a web browser and a&&ess the 8M9R
(dministrative $onsole0
http0..I%ourhostnameJ0"!+!.ibm.&onsole
6' Navigate to Servers 3J $lusters 3J WebSphere (ppli&ation Server &lusters 3J PortalCluster 3J
$luster Members
/' $li&= LNewL
7"
+' Kn the ne5t s&reen enter the )ollowing in)ormation0
Member Name 3 The new member name A)or e5ample WebSphereEPortalE-B
$()*' #o not /se an+ na-e that contains a space
Sele&t Node 2 Sele&t a node that is part o) %our &luster
9enerate Cni@ue HTTP Ports 2 4nsure this is &he&=ed
1' $li&= Q(dd MemberP
7' $li&= QNe5tP
"!
"' Review the summar% s&reen and &li&= :inish'
,!' Save the &hanges
,,' Navigate to Server T%pes 3J WebSphere (ppli&ation Servers 3J WebSphere_Portal_ 3J Ports
and note the )ollowing two port values0
W$Ede)aulthost
W$Ede)aulthostse&ure
,2' Cpdate the <irtual Hosts to in&lude these two ports i) the% are not alread% present0
aB Navigate to 4nvironment 3J <irtual Hosts 3J de)aultEhost 3J Host (liases
bB $li&= QNewP
&B Set Hostname to S
dB Set Port to the value o) W$Ede)aulthost
eB $li&= QKOP
)B Repeat a3e )or W$Ede)aulthostEse&ure
gB Save &hanges
",
,-' 4nable 8%nami& Repli&ation on the new &luster member'
aB Navigate to Server )+pes 01 WebSphere Application Servers 01 WebSphere_Portal_3 01
2ontainer Services 01 #+na-ic 2ache Service
bB Set $a&he Si?e to -!!! entries
&B $he&= the 4nable $a&he Repli&ation Bo5
dB Sele&t QNot SharedP )rom the Repli&ation T%pe drop3down menu
eB $li&= QKOP and save &hanges'
,6' :rom the Portal node that %ou &reated the verti&al &luster member on open a terminal window
and &hange dire&tories to the IwpEpro)ile rootJ.$on)ig4ngine dire&tor%'
,/' 45e&ute the )ollowing $on)ig4ngine s&ript to remove server3s&oped entries )rom the new
&luster member0
%,P(9)A$)' :ailure to do this step will result in an inoperable verti&al &luster member
./2on3ig6ngine.sh c#uster-node-con3ig-ertica#-c#uster-setup
-(Serer1ame=WebSphere_Portal_3 -(!asPassword=password
where ServerName is set to %our new verti&al &luster member name' In this &ase
WebSphereEPortalE- is m% new verti&al &luster member'
,+' S%n&hroni?e the nodes and restart the 8M9R nodeagents and &luster members'
,1' <eri)% %ou &an a&&ess %our new &luster member in a CRL using the port de)ined )or
W$Ede)aulthost in step ,,0
http0..hostname0,!!/!.wps.portal
"2
Appendi# " & Adding a ne% secondary node to an e#isting cluster
>ou ma% need to add a new node to %our &luster in the )uture' In this se&tion we will add a new node
to an e5isting &luster that alread% has standalone L8(P se&urit% enabled'
,' Install %our new Portal )ollowing the se&tion LInstall the Se&ondar% Portal nodeL'
$()*' (t this point %ou have a standalone Portal server using the de)ault <MM )ederated )ile
registr% se&urit%'
2' $op% the wpEse&urit%Eids'properties )rom the IwpEpro)ileJ.$on)ig4ngine.&on)ig.helpers
dire&tor% on %our Primar% node to the IwpEpro)ileJ.$on)ig4ngine.&on)ig.helpers dire&tor% on
the se&ondar% node'
-' :rom the se&ondar% node &op% the &ontents o) the helper )ile into the main w=pl&'properties
)ile b% running the )ollowing &ommand Aall on one lineB0
'.2on3ig6ngine.sh
roperties -(saeParentProperties=true
$()*' I) %ou did not use a helper )ile when setting up se&urit% then manuall% update the
standalone'ldap values in the w=pl&'properties )ile to mat&h those o) %our e5isting nodes'
6' 4nsure the database &lient is installed and &on)igured on the se&ondar% node' :or 8B2 with
T%pe 6 drivers &op% the db2F&&'Far and db2F&&Eli&enseE&u'Far )iles )rom the 8B2 server to some
dire&tor% on the se&ondar% Portal server'
/' Stop WebSphereEPortal and server, b% e5e&uting the )ollowing &ommands )rom the
+' 4nsure the 8M9R is ST(RT48 b% running the )ollowing &ommand )rom the
IdmgrEpro)ileJ.bin dire&tor%'
./startManager.sh
"-
)iles0
w=pl&'properties
7' $op% the w=pl&E&omp'properties and w=pl&Edbt%pe'properties )rom the primar% node to the
new node to ensure the same database &on)iguration'
$()*' 4nsure that the values )or db2'dbLibrar% and derb%'8bLibrar% in
w=pl&Edbt%pe'properties &ontain valid dire&tor% paths )or this node'
"' :rom the IwpEpro)ileJ.$on)ig4ngine.properties dire&tor% edit the w=pl&'properties )ile and
&hange the )ollowing entries0
!as8serid=$(ME= 8ser D(%
!asPassword=$(ME= password%
Porta#AdminPwd=password
Primar,1ode=3a#se
$()*' 4nsure that the value )or $lusterName mat&hes the value )or $lusterName on the
primar% node'
,!' In a terminal window )rom the se&ondar% node &hange dire&tories to
"6
,,' (dd the node to the deplo%ment manager &ell b% e5e&uting the )ollowing $on)ig4ngine s&ript0
'.2on3ig6ngine.sh c#uster-node-con3ig-pre-3ederation
-(!asPassword=$(ME= password%
$()*' 4nsure that the time on the 8eplo%ment Manager server and the time on the primar%
node are within / minutes o) ea&h other' :ailure to do so &an &ause this step to )ail' This will
also &reate the Node(gent server )or %ou on %our node'
e5ample0
-((MgrPassword=$password% -(!asPassword=$#oca# !AS password%
,2' ()ter the previous step &ompletes %our node will be part o) the deplo%ment manager &ell' (s a
result this node is now using the 8eplo%ment Manager &ell name'
4dit the IwpEpro)ileJ.$on)ig4ngine.w=pl&'properties )ile and ensure the )ollowing propert% is
set &orre&tl%0
,-' Cpdate the deplo%ment manager &on)iguration )or the new WebSphere Portal server b%
'.2on3ig6ngine.sh c#uster-node-con3ig-post-3ederation -(!asPassword=password
,6' 4nsure the Node(gent is started on this node b% running the )ollowing &ommand )rom the
IwpEpro)ileJ.bin dire&tor%0
./start1ode.sh
"/
,/' Spe&i)% the name o) the )uture se&ondar% &luster member'
4dit the IwpEpro)ileJ.$on)ig4ngine.w=pl&'properties )ile and &hange the )ollowing propert%0
Serer1ame=$name o3 new c#uster member%
$()*' When %ou open the properties )ile %ou should see WebSphereEPortalEnodename' >ou
&an use this value i) %ou li=e' Ktherwise %ou &an &hange this to an%thing 4D$4PT
LWebSphereEPortalL' 8K NKT use the value o) LWebSphereEPortalL )or %our se&ondar% &luster
member'
,+' (dd this newl% )ederated WebSphereEPortal server as a &luster member to the e5isting &luster
b% e5e&uting the )ollowing $on)ig4ngine s&ript0
'.2on3ig6ngine.sh c#uster-node-con3ig-c#uster-setup -(wasPassword=$password%
$()*' This will automati&all% add a se&ondar% &luster member to %our e5isting &luster based
on whatever value %ou set )or ServerName in step ,!' In this e5ample the de)ault value was
used' The node name is wpnode- so our &luster member will be &alled
WebSphereEPortalEwpnode-'
"+
,"' (llow :0 -in/tes )or ear e5pansion to &omplete on the se&ondar% node' :ailure to do so ma%
result in several appli&ations being unavailable on this node'
2!' Be&ause the se&urit% &on)iguration )or the Portal node &hanged when we )ederated the node we
need to update the Portal &on)iguration to re)eren&e the new Portal (dmin I8 and group b%
running the )ollowing $on)ig4ngine s&ript0
'.2on3ig6ngine.sh wp-change-porta#-admin-user -(newAdminDd=$3u## (1 o3 Porta#
admin D(% -(newAdminPwd=$new password% -(newAdminEroupDd=$3u## (1 o3 Porta#
Admin Eroup D(% -(s4ip.#dap.a#idation=true
$ote' The 38s=ip'ldap'validationHtrue )lag &an be used i) the s&ript )ails during ldap validation'
2,' Start the new &luster member WebSphereEPortalEnodename )rom the IwpEpro)ileJ.bin
dire&tor% o) the new node0
'.startSerer.sh !ebSphere"Porta#"nodename
22' <eri)% %ou &an a&&ess %our new &luster member in a CRL0
http0..hostname0,!!/!.wps.portal
"1
Appendi# + & ,unning IB Support Assistant !ite
(t some point %ou ma% run into a )ailure when e5e&uting WebSphere Portal and re@uire assistan&e
)rom IBM Remote Te&hni&al Support' In order to save time with troubleshooting %our issue IBM
Support strongl% re&ommends %ou use IS(Lite to &olle&t the logs and &on)iguration in)ormation )rom
%our s%stem'
These instru&tions assume %ou alread% installed the IS(Lite tool )rom earlier in this guide'
To wat&h a video demonstration o) the tool please visit the WebSphere Portal Wi=i at this CRL0
http0..www3,!'lotus'&om.ldd.portalwi=i'ns).d5.demo3isalite3)undamentals3version3,'-'-3)or3ibm3
websphere3portal
,' Kpen a &ommand prompt and &hange dire&tories to IwpEpro)ile rootJ.PortalServer.IS(Lite'
2' Laun&h the tool b% e5e&uting the )ollowing &ommand0
runIS(Lite'bat
-' When the tool laun&hes %ou should see a window similar to the )ollowing0
"7
6' 45pand WebSphere Portal and sele&t %our problem t%pe' I) %ou are unsure o) what %our
problem t%pe is sele&t one o) the )ollowing0
WebSphere Portal 01 7eneral 01 Portal 7eneral Proble-

WebSphere Portal 01 7eneral 01 Portal 7eneral ?ile 2ollection
/' In the Kutput :ilename )iled spe&i)% the path and name o) the ?ip )ile that will be &reated b% the
tool' I) %ou have a PMR number please use in&lude this number in the ?ip name' :or e5ample0
$0.temp.,2-6/',2-'!!!'PortalProblem'?ip
+' $li&= the button )or Q$olle&t 8ataP
1' >ou will re&eive several prompts as the s&ript runs' (nswer all @uestions %ou see as a&&uratel%
as possible' This in&ludes PortalServer and (ppServer root W(S &redentials and whether or
not the server is part o) a &luster'
$ote' I) %ou sele&ted the @Portal 7eneral ?ile 2ollectionA problem t%pe %ou will not see
these prompts' This option is onl% available in versions ,'-'- and higher and re@uires minimal
user intera&tion'
7' Sele&t to :TP the logs when prompted' I) %ou &hoose not to do so here or are unable to do this
%ou &an do so manuall% )ollowing the instru&tions in this lin=0
http0..www3!,'ibm'&om.support.do&view'wssGrsH+77MuidHswg2,2!,/1,
""
Appendi# $ & Common Problems
This se&tion will dis&uss &ommon problems en&ountered when building &lusters and the
troubleshooting steps and.or resolutions to them'
P9(8B*,' (ll or an% $on)ig4ngine s&ript )ails immediatel% with e5&eptions su&h as0
2reated con3ig Serice ProO,/
com.ibm.websphere.management.con3igserice.2on3igSericeProO,P@6K&@6K&
26++/ dmgr2e##
1O(6/ wp1ode&
com.ibm.websphere.management.eOception.2on3igSerice6Oception/
)aaO.management.0M=untime6Oception/ A(M100''6/ Access is denied 3or the reso#e
operation on 2on3igSerice M*ean because o3 insu33icient or empt, credentia#s.
.
.
.
=egistr, cou#d not be #oaded 3rom !AS using current connection in3ormation.
P#ease eri3, ,our !AS connection properties and retr, the operation. 2urrent
input/
!as8serDd/ uid=wpadminCcn=usersCdc=ibmCo=com
!asPassword/ PASS!O=("=6MO-6(
!as=emote>ost1ame/ m,(mgrSerer.ra#eigh.ibm.com
!asSoapPort/ FFA.
2e##1ame/ dmgr2e##
1ode1ame/ wp1ode&
2A!S*0 The $on)ig4ngine registr% is stored within the W(S &on)iguration' 4a&h time $on)ig4ngine
is e5e&uted it must &onne&t to the W(S &on)iguration and retrieve the registr%' This depends on the
)ollowing0
,' The )ollowing values being &orre&t in w=pl&'properties0
!as8serDd
!asPassword
!as=emote>ost1ame
!asSoapPort
2e##1ame
1ode1ame
So that the )ollowing senten&e would be valid0
Q$onne&t to the !as=emote>ost1ame at !asSoapPort using !as8serid and !asPassword to veri)% the
2e##1ame and 1ode1ame are valid'P
2' I) in a &luster the 8M9R must be running'
9*S(B!)%($' 4nsure the properties listed in the Q$auseP are &orre&t and i) in a &luster ensure the
8M9R is running' ()ter %ou have done this e5e&ute the $on)ig4ngine tas= again'
,!!
P9(8B*,0 ()ter &reating a &luster with m% primar% node I &annot a&&ess Portal in a web browser'
I see the )ollowing message in the web brower0
A !ebEroup/-irtua# >ost to hand#e /wps/porta# has not been de3ined.
or
6rror K0K/ 1o target ser#et con3igured 3or uri/ /wps/porta#
2A!S*0 The &luster3node3&on)ig3pre3)ederation s&ript )ailed at some point and the 8eplo%ment
Manager was not properl% &leaned up be)ore e5e&uting the s&ript again' :ailure to remove the
enterprise appli&ations )rom the 8M9R will &ause the target mappings between the appli&ation and the
WebSphereEPortal server to be&ome bro=en'
9*S(B!)%($' Remove the node )rom the &luster and per)orm the )ollowing steps in the 8M9R0
Remove all 4nterprise appli&ations
Remove the WebSphereEPortal server de)inition
Remove the N8B$ Provider in)ormation )or WebSphereEPortal
Start with &luster3node3&on)ig3pre3)ederation and add the node ba&= to the 8M9R'
,!,
P9(8B*,' L&luster3node3&on)ig3pre3)ederationL )ails with invalid &redentials when stopping all
servers0
HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH
action-c#uster-node-3ederation/
QechoR 5ederating node N!ebSphere"Porta#N to Nm,dmgr.ra#eigh.ibm.comN using
port NFFA.N
QechoR 2a##ing add1ode with the 3o##owing credentia#s / -username wpadmin
-password ?Password=emoedB -inc#udeapps
QeOecR A(M80&&6D/ Too# in3ormation is being #ogged in 3i#e
QeOecR 2/S!ebSphereSwp"pro3i#eS#ogsSadd1ode.#og
QeOecR A(M80&'FD/ Starting too# with the wp"pro3i#e pro3i#e
QeOecR 2!P7D0@0.D/ A## signers 3rom remote 4e,store a#read, eOist in #oca#
4e,store.
QeOecR A(M8000&D/ *egin 3ederation o3 node node& with (ep#o,ment Manager at
QeOecR m,dmgr.ra#eigh.ibm.com/FFA..
QeOecR A(M8000&D/ *egin 3ederation o3 node node& with (ep#o,ment Manager at
QeOecR m,dmgr.ra#eigh.ibm.com/FFA..
QeOecR A(M8000.D/ Success3u##, connected to (ep#o,ment Manager Serer/
QeOecR m,dmgr.ra#eigh.ibm.com/FFA.
QeOecR A(M80909D/ Serers 3ound in con3iguration/
QeOecR A(M80906D/ Serer name/ serer&
QeOecR A(M80906D/ Serer name/ !ebSphere"Porta#
QeOecR A(M8'0&0D/ Stopping a## serer processes 3or node node&
QeOecR A(M800'A6/ An error occurred during 3ederation A(M100''6/ Access is
denied 3or
QeOecR the stop operation on Serer M*ean because o3 insu33icient
or empt,
QeOecR credentia#s.: ro##ing bac4 to origina# con3iguration.
QeOecR A(M80'&&D/ 6rror detai#s ma, be seen in the 3i#e/
QeOecR A(M80&&@6/ Program eOiting with error/
QeOecR com.ibm.websphere.management.eOception.Admin6Oception/
QeOecR )aaO.management.0M=untime6Oception/ A(M100''6/ Access is
denied 3or
QeOecR the stop operation on Serer M*ean because o3 insu33icient
or empt,
QeOecR credentia#s.C resu#ting 3rom/ A(M100''6/ Access is denied
3or the
QeOecR stop operation on Serer M*ean because o3 insu33icient or
empt,
QeOecR credentia#s.
QeOecR A(M8K&&@6/ -eri3, that username and password in3ormation is correct.
D3
QeOecR running too# 3rom the command #ineC pass in the correct
-username
QeOecR and -password. A#ternatie#,C update the
$connt,pe%.c#ient.props
QeOecR 3i#e.
QeOecR A(M8&'&&D/ To obtain a 3u## trace o3 the 3ai#ureC use the -trace
option.
QeOecR A(M80'&&D/ 6rror detai#s ma, be seen in the 3i#e/
Target 3inished/ action-c#uster-node-3ederation
Target 3inished/ c#uster-node-con3ig-pre-3ederation
HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH
,!2
2A!S*0 This e5&eption will o&&ur during the &luster3node3&on)ig3pre3)ederation s&ript i) the
)ollowing two &onditions are met0
3 The 8M9R &redentials are di))erent )rom the lo&al W(S &redentials
3 The servers on the node AWebSphereEPortal and server,B are running
9*S(B!)%($' To resolve this issue %ou must manuall% stop WebSphere Portal and server on the
node prior to running this s&ript'
,!-
P9(8B*,' When I e5e&ute L&luster3node3&on)ig3pre3)ederationL a se&ond time the $on)ig4ngine
s&ript )ails immediatel% with this e5&eption0
HHHHHHHHHHHHHHHHHHHHHHHHH
=egistr,S,nchroni;ed/ 3a#se
=egistr, out o3 s,nc with !ebSphere... s,nchroni;ing...
Q&'/0A/0. &6/'@/&F.K9. 26TR ss#.de3au#t.password.in.use.2!P7D00K&!
Q&'/0A/0. &6/'@/&F.6&9 26TR ss#.disab#e.ur#.hostname.eri3ication.2!P7D00'AD
2reated admin c#ient/ com.ibm.ws.management.Admin2#ientDmp#P@A'F@A'F
2reated con3ig Serice ProO,/
com.ibm.websphere.management.con3igserice.2on3igSericeProO,PK@AKK@AK
26++/ 1odoTest
1O(6/ 1odoTest
26++/ 1odoTest
)aa.#ang.Arra,DndeOOutO3*ounds6Oception/ Arra, indeO out o3 range/ 0
at
com.ibm.w4p#c.was.registr,.Admin2on3ig=egistr,.create1ew=egistr,?Admin2on3ig=egistr
,.)aa/'@0B
at
com.ibm.w4p#c.mode#s.compregistr,.=esource!idget.sae=esourceToAdmin2on3ig?=esource
!idget.)aa/@60B
.+oca# registr, is out o3 the s,nc with the app#ication serer. S,nchroni;ation
must be per3ormed be3ore an, con3iguration can continue.
P#ease eri3, ,our !AS connection properties and retr, the operation. 2urrent
input/
!as8serDd/ wasadmin
!asPassword/ PASS!O=("=6MO-6(
!as=emote>ost1ame/ m,dmgr.ibm.com
!asSoapPort/ FFA.
2e##1ame/ m,1ode
1ode1ame/ m,1ode
HHHHHHHHHHHHHHHHHHHHHHHHH
2A!S*0 This e5&eption o&&urs be&ause o) a uni@ue &ondition within the &luster3node3&on)ig3pre3
)ederation s&ript' (t the end o) ever% $on)ig4ngine s&ript an attempt is made to s%n&hroni?e the
$on)ig4ngineLs registr% with the W(S &on)iguration' I) &luster3node3&on)ig3pre3)ederation )ails this
attempt to s%n&hroni?e the registr% at the end )ails as well be&ause o) a mismat&h between the
WasRemoteHostName and $ellName properties in w=pl&'properties' Kn an% subse@uent $on)ig4ngine
s&ript an attempt to s%n&hroni?e the registr% is made at the ver% beginning' The mismat&h between the
WasRemoteHostName and $ellName still e5ists as it is needed )or &luster3node3&on)ig3pre3)ederation
so the s%n&hroni?ation &ontinues to )ail'
9*S(B!)%($' To resolve this problem %ou must run the )ollowing $on)ig4ngine s&ript be)ore
e5e&uting &luster3node3&on)ig3pre3)ederation0
'.$on)ig4ngine'sh 38WasRemoteHostNameHIstandalone hostJ 38WasSoapPortHIstandalone soap
portJ
The interim )i5 PM!2"21 was &reated to address this issue but it will onl% prevent the error )rom
o&&urring again' I) %ou have %ou not applied PM!2"21 and %ou hit this error %ou must still run the
a)orementioned $on)ig4ngine s&ript then appl% PM!2"21'
,!6
P9(8B*,' ()ter &reating m% verti&al &luster member I &annot a&&ess it in a web browser' I see L6!6
Initiali?ation o) one or more servi&es )ailed'L In the S%stemKut'log the )ollowing e5&eption &an be
seen re)eren&ing m% old I80
60P5(00&66/ Dnitia#i;ation o3 serice 3ai#ed.
com.ibm.wps.ac.(omainAdministrator1ot5ound6Oception/ 60PS*0&0A6/
6Oception occurred whi#e retrieing the identit, o3 the domain admin
user/admingroup uid=wpsadminCo=de3au#t!DM5i#e*ased=ea#m.
2A!S*0 This e5&eption o&&urs i) the L&luster3node3&on)ig3verti&al3&luster3setupL s&ript was not
e5e&uted &orre&tl% i) at all'
When %ou initiall% &reate a &luster a server template is made o) the )irst &luster member Ain our &ase
the WebSphereEPortal server )rom the primar% nodeB in&luding all o) its resour&es' (t the time this
server has all o) its resour&es stored at the server s&ope' Kne o) these resour&es is a Resour&e
4nviornment Provider &alled WP (&&ess$ontrol8ataManagementServi&e' This is where the Portal
(dministrator I8 is stored' ()ter the &luster is &reated these resour&es are &opied to the &luster s&ope'
I) %ou were )ollowing the steps o) this guide at the time this is done the I8 is
uidHwpsadminoHde)aultWIM:ileBasedRealm' L&luster3node3&on)ig3&luster3setupL subse@uentl%
removes an% le)tover resour&es )rom the server s&ope'
When %ou run the Portal $on)ig4ngine s&ripts to &hange se&urit% the I8 is updated in WP
(&&ess$ontrol8ataManagementServi&e at the &luster s&ope'
When %ou &reate a new verti&al &luster member a new server is &reated based on the a)orementioned
template' This results in a new server that has resour&es de)ined at the server s&ope mat&hing the
resour&es that e5isted at the time the &luster was initiall% &reated' In other words %ou have a new
&luster member that has WP (&&ess$ontrol8ataManagementServi&e de)ined at the server s&ope (N8
at the &luster s&ope' The &luster s&ope has the &orre&t L8(P I8T the server s&ope has the original I8'
The server s&ope is what is being read when this &luster member starts up'
The &luster3node3&on)ig3verti&al3&luster3setup s&ript removes all o) the server s&oped resour&es )rom
the verti&al &luster member'
9*S(B!)%($0 4nsure %ou have &orre&tl% e5e&uted the &luster3node3&on)ig3verti&al3&luster3setup
and passed in the &orre&t ServerName0
./2on3ig6ngine.sh c#uster-node-con3ig-ertica#-c#uster-setup -(Serer1ame=$new
member name% -(!asPassword=$password%
This &ommand is case0sensitive. 38serverName is NKT the same as 38ServerName'
,!/
P9(8B*,' ()ter updating se&urit% in the &luster se&ondar% nodes throw Cser I8 e5&eptions )or the
N$R appli&ation during startup0
HHHHHHHHHHHHHHHHHHHHHHHHHH
Q&&/&6/0. &0/9./KF/99@ 6STR 000000@0 App#icationMg A !S-=0'00D/ Starting
app#ication/ )crear
.
Q&&/&6/0. &0/9./90/&6& 6STR 000000@0 ser#et 6
com.ibm.ws.webcontainer.ser#et.Ser#et!rapper init S=-60&006/ 8ncaught init?B
eOception created b, ser#et DnitSer#et in app#ication )crear/
)aaO.ser#et.Ser#et6Oception/ )aaO.)cr.=epositor,6Oception/ 8nab#e to initia#i;e
=epositor,5actor, due to eOception o3 t,pe/ )aa.securit,.Prii#egedAction6Oception
with message/ com.ibm.wps.um.eOceptions.imp#.Member1ot5ound6OceptionDmp#/
com.ibm.porta#.puma.Member1ot5ound6Oception/ 60PSE000'6/ =equested Member does not
eOist.uid=wpadminCo=de3au#t!DM5i#e*ased=ea#m/nu##.
at com.ibm.icm.)cr.init.DnitSer#et.init?DnitSer#et.)aa/9AB
at )aaO.ser#et.EenericSer#et.init?EenericSer#et.)aa/'K&B
.
2aused b,/ )aaO.)cr.=epositor,6Oception/ 8nab#e to initia#i;e =epositor,5actor,
due to eOception o3 t,pe/ )aa.securit,.Prii#egedAction6Oception with message/
com.ibm.wps.um.eOceptions.imp#.Member1ot5ound6OceptionDmp#/
com.ibm.porta#.puma.Member1ot5ound6Oception/ 60PSE000'6/ =equested Member does not
eOist.uid=wpadminCo=de3au#t!DM5i#e*ased=ea#m/nu##.
at com.ibm.icm.)cr.=epositor,5actor,.init?=epositor,5actor,.)aa/@0FB
at
com.ibm.icm.)cr.=epositor,5actor,.get=epositor,?=epositor,5actor,.)aa/660B
HHHHHHHHHHHHHHHHHHHHHHHHHH
2A!S*' There is an additional $on)ig4ngine step that needs to be e5e&uted on se&ondar% nodes a)ter
enabling se&urit% in a &luster0
'.$on)ig4ngine'sh enable3F&r3se&urit%
:ailure to run this step will result in this issue )or all se&ondar% nodes'
,!+
9*S(B!)%($' $omplete the )ollowing steps to &orre&t this issue0
,' $op% the se&urit% properties in w=pl&'properties )rom the primar% node to all se&ondar% nodes
2' 45e&ute the )ollowing $on)ig4ngine s&ript to &omplete the se&urit% &on)iguration0
./2on3ig6ngine.sh enab#e-)cr-securit, -(!asPassword=$password%
$()*' This onl% applies to v+','!'- or higher' In lower +','!'5 versions %ou must run a di))erent
s&ript on the se&ondar% nodes0
'.2on3ig6ngine.sh wp-change-porta#-admin-user -(newAdminDd=$3u## (1 o3 Porta#
admin D(% -(newAdminPwd=$new password% -(newAdminEroupDd=$3u## (1 o3 Porta#
Admin Eroup D(% -(s4ip.#dap.a#idation=true
,!1

A Step-By-Step Guide To Configuring A WebSphere Portal

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

A Step-By-Step Guide To Configuring A WebSphere Portal

Caricato da

Copyright:

Formati disponibili

A Step-By-Step Guide to Configuring a WebSphere Portal

Potrebbero piacerti anche