Administering IBM WebSphere Portal 8.0: A comprehensive workshop

8/12/2019 Administering IBM WebSphere Portal 8.0: A comprehensive workshop

1/136

Administering IBM WebSphere Portal 8.0: Acomprehensive workshop

homas !"rek([email protected] ), Software Architect, IBM

#alk Posch([email protected]), Software E!ieer, IBM

"ctober #$%#

& 'ori!ht Iteratioal Busiess Machies 'ororatio #$%#. All ri!hts reser*ed.

S"mmar$: +he !oal of this white aer is to elai the *arious admiistratio adcofi!uratio tools offered b IBM -ebShere Portal .$. /ear about which tool to use forwhich task ad about the ew caabilities of -ebShere Portal .$, ad uderstaddiffereces from re*ious *ersios of -ebShere Portal. -e take ou throu!h eercises foreach tool so ou ca lear hads0o how to use them.

able o% &ontents

% Itroductio..............................................................................................................................## -hat is -ebShere Portal1....................................................................................................2

#.% 'ofi!uratio iformatio.................................................................................................3#.# Preari! to istall -ebShere Portal.............................................................................4

2 Istalli! -ebShere Portal....................................................................................................43 5derstadi! the -ebShere Portal file sstem structure..................................................#2

4 Istalli! the latest 'ombied 'umulati*e Fi.......................................................................#67 'ommad lie tools...............................................................................................................2

7.% 'ofi!E!ie.................................................................................................................27.# 'ofi!-i8ard.................................................................................................................3%7.2 'ommad lie tools9 -AS scriti!...............................................................................3:7.3 ;M/Access....................................................................................................................4$7.4 -ebShere Portal scriti!...........................................................................................477.7 irtual Portal Maa!er...........................................................................:$

:.3 Admiistratio =5I?s9 Maa!ed Pa!es...........................................................................:3:.4 +a!!i! ad rati!.........................................................................................................6$:.7 Admi ortlets9 -eb Alicatio Brid!e.........................................................................67:.: Persoali8atio rules....................................................................................................%%2:. -ebA>......................................................................................................................%##

-AS Admi user iterface...................................................................................................%#76 'oclusio...........................................................................................................................%27%$


2/136

' Introd"ctionI this white aer, we elore the ewl added ad alread eisti! admiistratio tools formaa!i! IBM -ebShere Portal .$ o IBM -ebShere Alicatio Ser*er .$.

+he eercise is searated ito the followi! sectios9

Briefl itroduce -ebShere Portal ad how cofi!uratio iformatio is used. Ste throu!h istalli! -ebShere Portal. A o*er*iew of the ew File Sstem structure. Istall the latest maiteace. 5se the 'ofi!E!ie to list *irtual Portals. 5se the 'ofi!uratio -i8ard to elore how to modif Portal securit. 5se -ebShere Alicatio Ser*er (-AS) scriti!. 'reate a a!e usi! the Portal Scriti! iterface, i which a baselie is created with ;M/

Access ad ;M/ Access is used to delo a ortlet. 5se the ), a ewl

suorted stadard to udate Portal setti!s. /ear how to use the -AS Admi 'osole.

If ou are more iterested i the commad lie tools, the ou ca start with Sectio 7C if ou aremore iterested with the user iterface, ou could start directl with Sectio :.

#ormatting(hints+he followi! color codes are used i this aer9

Magenta:A file or directoryBlue:A command to be executedGreen: A name, title, value, file content, or program outputRed:An important value

)*+:+hese colors are helful to see the differet tes uickl, but the are ot ecessar touderstad the meai!. So if ou are usi! black ad white, that will work as well. "ur ser*erame here is localhost.


3/136

/ets ou choose the Istallatio directorC for eamle, C:\ibm\PortalServeror/opt/WebSphere(ou ca choose aother director, but ou the must adDust refereces ithis documet accordi!l)

'reates the erb database, which cotais the -ebShere Portal tables Eables file0based securit after the istall 'reates the Portal Admiistrati*e user,wpsadminwpsadmin(ou ca choose aother

assword duri! istall, but the ou must adDust refereces i this aer accordi!l)

Samle files used here are ro*ided i the PortalAdminSampleiles!"ipfile as a owload.

, What is WebSphere Portal-/et?s be!i with the marketi! messa!e9 IBM -ebShere Portal software ro*ides a comositealicatio or busiess mashu framework ad the ad*aced tooli! eeded to build fleible,S"A0based solutios, as well as the umatched scalabilit reuired b a si8e or!ai8atio.

uite siml, -ebShere Portal is a framework that lets ou easil build a stadardi8ed, rich -eb(Portal) solutio. It is istalled o to of -AS, which cotais the Ga*a+M


4/136

'liets as browsers or mobile de*ices !ai access to the ortal *ia the H++P rotocol, ad thereuest arri*es at -AS, which routes it to the -ebShere Portal ser*lets, ortlets, ad wid!ets.

+he -ebShere Portal ser*lets, ortlets, ad wid!ets build a -eb a!e b a!!re!ati!iformatio from the Portal cofi!uratio ad backeds *ia APIs ad coectios. +he ewl built-eb a!e is the set *ia the H++P rotocol back to the cliet de*ice, which reders theresose ad, deedi! o the cliet, the resose ca be retured i the form of html, wml, etc.

2.1 Configuration information+he cofi!uratio iformatio is stored as follows (see fi!ure #)9

-ebShere Portal uses the uderli! -AS to ser*e reuests -ebShere Portal cofi!uratio data is stored i both the databases ad the file sstem -AS uses ol the file sstem for its cofi!uratio data (thou!h there are some ecetios to

this rule, such as sessio ersistece) +he 'ofi!uratio +ools modif the cofi!uratio data i the differet reositories

#ig"re ,. &on%ig"ration in%ormation storage

ou ma wat to cha!e the -ebShere Portal cofi!uratio to ite!rate ito our e*irometCfor eamle, to coect to our databases or /AP Ser*er(s), to IBM /otus6omio6mailser*ers, to IBM/otus Sametime6ser*ers, or to do the followi!9

customi8e the look ad feel

make the solutio secure achie*e hi!h a*ailabilit tue erformace delo our code eable or disable additioal features erform maiteace

-ebShere Portal is uite fleible ad, deedi! o our use case, more tha oe tool ca beused to achie*e our !oals.

3


5/136

2.2 Preparing to install WebSphere Portal+he refereces to directories i this documet are for the Microsoft -idows .$ istall media, which ca be retrie*ed from, for eamle,

the IBM Passort Ad*ata!e-eb site.

Sectio 2 ro*ides a ste0b0ste !uide throu!h the istall of -ebShere Portal. If ou alreadha*e a istall, ou ca start directl with Sectio 7.

7 Installing WebSphere PortalI this sectio we show how to istall -ebShere Portal. If ou ha*e alread istalled -ebSherePortal , ou ca ski this chater or Dust read o*er the fi!ures to better uderstad how toerform the istall.

IIM is a Eclise0based tool that is used to istall -ebShere Portal, as well as se*eral other IBMroducts. 'ustomers who alread ha*e this tool (at the *%.4.# le*el or later) ca use it to istall

-ebShere Portal directl from Passort Ad*ata!e. Howe*er, ou ca also dowload electroicima!es or reuest hsical >s that ro*ide e*erthi! ou will eed if starti! from scratch.+he ima!e> will istall IM, if it is ot alread reset, ad the lauch IM to istall9

-AS, icludi! the Ga*a >irtual Machie


6/136

IIM for


7/136

Select &nstall &BM &nstallation Manager onl+to istall Dust the IIM tool o its owad the istall -ebShere Portal from it.

#ig"re ;. riggering the installation

2. If ou do ot ha*e IIM istalled, the istall will romt ou to istall it. 'lick Nexti the IstallPacka!es widow (see fi!ure 4).

:


8/136

#ig"re


9/136

#ig"re =. Accept the IIM license

6


10/136

4. I the et widow choose a istallatio director for the IIM ad click,e#t (see fi!ure :).

#ig"re >. &hoose a location %or the IIM

%$


11/136

7. I the Summar widow, *erif the iformatio ad click &nstall(see fi!ure ).

#ig"re 8. 5eri%$ the IIM installation in%ormation

:. After the istall fiishes a Status widow dislas. 'lick Restart &nstallation Managerto tri!!er the istall of Portal.

%%


12/136

#ig"re ?. Stat"s o% the IIM installation

. After the IIM has restarted, the Start widow dislas. ou ca istall roducts, modif theistallatio of the roducts (for eamle, b addi! ew features), udate the roducts (for

eamle, al ifies or fi acks), udo cha!es, maa!e liceses, or uistall roducts.Select &nstallto tri!!er the istall of Portal.

%#


13/136

#ig"re '0. IIM Start window

6. +he Istall Packa!es widow lets ou select the acka!es ou wat to istall (see fi!ure %%).Sice we do ot ha*e a eisti! istall of -AS .$.$.2, we select ot ol -ebShere PortalSer*er but also -AS. -ebShere Portal Eted is a additioal acka!e to the -ebSherePortal acka!e, addi! a additioal cotet feature that the Portal Ser*er acka!e does oticlude. After selecti! all check boes, click,e#tto tri!!er the Portal istall.

%2


14/136

#ig"re ''. Select packages to install

%$. I the et widow, select the -AS .$.$.2 Jetwork elomet (J) fies that arerecommeded to be istalled as a art of the -AS .$.$2 J istallatio for -ebSherePortal acka!es. After selecti! all check boes, click,e#tto tri!!er the Portal istall (seefi!ure %#).

%3


15/136

#ig"re ',. Select %i@es to be installed

%%. I the et widow, select the locatio where IIM is stori! shared resourcesC click,e#t(seefi!ure %2).

%4


16/136

#ig"re '7. Select shared director$

%#. I the et widow, select the locatio where -ebShere Portal ad -AS will be istalledCclick,e#t(see fi!ure %3).

%7


17/136

#ig"re ';. Select directories %or WebSphere Portal and WAS

%:


18/136

%2. Select additioal la!ua!e acka!es that eed to be istalledC click,e#t(see fi!ure %4).

#ig"re '


19/136

#ig"re '=. Select components

%4. I the et widow, select the Profile +emlate +e9 Full, Base, or 'ustom (see fi!ure %:)9

'hoose Full to elore all samle ortlets. 'hoose Base to istall a miimal features. -ith 'ustom, ou ca create a ew Portal Ser*er with our ow rofile temlates istead of

Full or Base. ou would eed our ow custom rofile temlates if this otio is selected. +hecustom temlates ca be created o aother Portal istallatio.

'otiue with,e#t.

%6


20/136

#ig"re '>. &hoose between #"ll and Base installation

%7. Select either Stadard or Ad*aced 'ofi! mode (see fi!ure %). Select Stadard for ourP"' istallatio or Ad*aced for our roductio istallatio.

Eter the ode ame (it ca be a uiue ame) ad the full ualified host ame o whichou are erformi! the istall, as well as the cell ame of the -ebShere cell i which Portalis created. +he ode ame is rele*at for oeratios iside -AS whe buildi! a cluster(multile Portals). For the latter eercises ou will eed the host ame.

Also, eter the admiistrati*e userid ad assword. For this eercise we ha*e usedwpsadminas userid adwpsadminas assword.

#$


21/136

#ig"re '8. Select the node host cell and "ser name

%:. I the Ad*aced mode ou ca secif a custom cotet root (istead of wsortal) ad

custom orts, as well as a custom director for the rofile ad rofile ame (see fi!ure %6).'otiue with,e#t.

#ig"re '?. Advanced &on%ig"ration options

#%


22/136

%4. +he fial widow shows a summar of what will be istalled (see fi!ure #$). If the *alues areas ou would like, click &nstallfor the istall to start.

#ig"re ,0. 1eviewing the Installation settings

%7. "ce the istall fiishes successfull, the widow i fi!ure #% will disla (-idows samle).'lick inishto ed the istall. If ou select /auch First Stes a additioal ael withactios to lauch a browser istace with Portal or starti! stoi! will be dislaed.

ou ca also create a additioal rofile with the rofile maa!emet tool or a Portalde*elomet rofile.

##


23/136

#ig"re ,'. #inishing the installation

; 9nderstanding the WebSphere Portal %ile s$stem str"ct"reI this sectio, we discuss the director structure of -ebShere PortalC secificall, the locatio ofthe commad lie tools, biaries, ad cofi!uratio of the roduct.

+hese are the use cases for which ou wo"ldwork with the -ebShere Portal file sstem9

'ofi!uratio cha!es like modifi! roerties files, etc. Starti! ad stoi! the ser*er Starti! ad stoi! commad lie tools >iew lo! files Istall udates

ou wo"ld notuse the -ebShere Portal file sstem for modifi! iteral cofi!uratio files

directl, bassi! admiistratio cofi!uratio tools. Jearl all the alterati*e tools metioed ithis toic modif the file sstem i some wa.

I the followi! a!es we will elore the -ebShere Portal file sstem structure, icludi! thefollowi!9

ASer*er director PortalSer*er director Profile director

#2


24/136

Profile director lo!s Profile director L -IM>MM 'ofi!E!ie director 'ofi!-i8ard rofile director Istallatio Maa!er irector

%. "e a File Elorer ad a*i!ate to /opt/WebSphere/AppServer. +he followi! are afew of the directories i fi!ure ## that are imortat whe worki! with -ebShere Portal9

+he AppServerdirector, cotaii! the biaries of -AS as well as temlates, utilities,ad the Ga*a e*eloer Kit.

+hebindirector, cotaii! the -AS commad lie tools that are ideedet of therofile.

+he erb database biaries, foud i the derbydirector. +he Javadirector, cotaii! the Ga*a e*eloer Kit %.7, icludi! the Ga*a


25/136

#. "e a File Elorer Elorer ad a*i!ate to /opt/WebSphere/PortalServer. +hedirectories worth oti! i fi!ure #2 are9

+he PortalServerdirector, cotaii! mail the biaries for -ebShere Portal. I-ebShere Portal the biaries ad the cofi!uratio ad tools are searatedC therefore,the PortalServerdirector o lo!er eeds to be touched.

+hebinsubdirector, cotaii! ;M/Access,


26/136

+he bindirector cotais all the commad lie tools related to the rofile, for eamle,for starti! ad stoi! the ser*er.

+he configdirector holds the cofi!uratio for the -AS. 'ofi!E!ie is the commad lie tool to tri!!er cofi!uratio tasks i -ebShere Portal

(it relaces the -PS'ofi! tool used i re*ious releases). +he log director iside the

ConfigEngine director cotais the Portal Istall ad 'ofi!uratio /o!s. +he installedApps director holds the Istalled G#EE alicatios, icludi! ortlets. +he PortalServer director cotais the Portal commad lie tools i the bindirector,

cofi!uratio files i the cofi! folder, ad the erb database i the derbydirector. +heSolutio Istaller o lo!er eeds to be istalled from the -ebL it is laid dow at Istalltime.

All the tools are used later i this documet.

#ig"re ,;. Pro%ile director$

3. +he rutime lo!s of -ebShere Portal ca be foud iside the log director (see fi!ure #4)."e a File Elorer ad a*i!ate to/opt/WebSphere/wp-pro(ile/logs/WebSphere-Portal.

#7


27/136

+he log director cotais a director for e*er ser*er istace. For a stadaloe setu thedirector ame is ebSphere!Portal. +he followi! files are of iterest i this director9

Sstem"ut.lo!, cotaii! the sstem messa!es, icludi! wari!s ad startu iformatioof the ser*er.

SstemErr.lo!, cotaii! errors ad ecetios. ati*estderr.lo!, cotaii! the G>M messa!es, icludi! !arba!e collectio data if *erbose

!arba!e collectio is eabled. It?s ossible to cofi!ure a searate file to cotai the *erbose!arba!e collectio data, which would ha*e a custom ame, for eamle, >erbose!c.

#ig"re ,irtual Member Maa!er (>MM) configdirector (see fi!ure #7). Ja*i!ate to

/opt/WebSphere/wp-pro(ile/con(ig/cells/cell/wim/con(ig.

It cotais the user reositor cofi!uratio data. I some re*ious releases the cofi!uratiowas stored i the -ebShere Member Maa!er 'ofi!uratio files (wmm.ml).

#:


28/136

#ig"re ,=. Pro%ile director$ WIM(5MM

+he 'ofi!E!ie director eists twice i the istallatio, oe time iside the rofile ad oceoutside it (see fi!ure #:). +he reaso for the 'ofi!E!ie i the root istallatio director is to beable to create ad maa!e additioal rofiles ideedet of the eisti! rofile or for a biar0ol istallatio i which o 'ofi!E!ie eists. Ja*i!ate to /opt/WebSphere/Con(ig.ngine.

#ig"re ,>. &on%ig+ngine director$

+he last director we wat to oit out is the"nstallation #anagerdirector (see fi!ure #).+he Istallatio Maa!er is the cetral tool to istalluistall udates ad also ro*ides some

co*eiece otios like creati! a M!r rofile ad federati!clusteri! Portal.

ou ca ot ol istall -ebShere Portal ad -AS udates with it but also hadle other IBMroducts like, for eamle, IBM


29/136

#ig"re ,8. Installation Manager director$

< Installing the latest &ombined &"m"lative #i@I this sectio, we discuss how to u!rade -ebShere Portal ad -eb 'otet Maa!er to thelatest a*ailable 'ombied 'umulati*e Fi (''F).

-ebShere Portal re!ularl ro*ides maiteace i form of ''Fs, which are a rollu of si!lefies budled as a si!le tested acka!e. +he acka!es are cumulati*e, meai! ou ca istallthe latest a*ailable ''F without ha*i! to istall a ''Fs i betwee. ''Fs cotai si!le fiesfrom all comoets9 -ebShere Portal Base, -eb 'otet Maa!er, Persoali8atio, etc.

Starti! with *ersio the maiteace acka!es ca be istalled i the followi! two was9

5si! the IIM 5ser Iterface 5si! the commad lie otios of the IIM, either assi! arameters *ia the commad lie

or *ia a resose file

I this eercise we will istall the latest ''F with the IIM 5ser Iterface. At the time this documetis writte, the latest ''F for -ebShere Portal is ''F $%C howe*er, be aware that a later ''Fmi!ht be a*ailable as ou read this. -e recommed to take the latest a*ailable ''F. For theistructios for istalli! a ''F, refer to the IBM Suort +echdoc N:$#:#$$, OIBM -ebSherePortal .$.$.$ 'ombied 'umulati*e Fi


30/136

%. +he Portal Ser*er must be stoed to istall maiteace. +o do this, oe a commadwidow, switch to the director /opt/WebSphere/wp-pro(ile/bin, ad the eecute thefollowi! commad (see fi!ure #6)9

!/stopServer!sh WebSphere-Portal user wpsadmin password wpsadmin

" -idows ou would ru stopServer!bat WebSphere-Portal user wpsadminpassword wpsadmin

#ig"re ,?. Stopping WebSphere Portal

#. Start the IIM 5ser Iterface b tri!!eri! (o -idows) the eecutable &nstallationManager\eclipse\&BM&M!e#eor, o /iu,/opt/&BM/&nstallationManager/eclipse/&BM&M

+he IIM -elcome widow dislas (see fi!ure 2$)C click the 0pdatebutto.

2$


31/136

#ig"re 70. Starting the IIM %or 9pdate

2. I the et widow, ou ca select which acka!es to udate (see fi!ure 2%). I our case wewat to udate -ebShere Portal to ''F$%. Select &BM WebSphere Portal Server v1

ad select,e#t.

2%


32/136

#ig"re 7'. Select the prod"ct to be "pdated

After selecti! the roduct, IIM coects to the IBM Maiteace ad Suort site ad searchesfor fies that are alicable to the istalled *ersio (see fi!ure 2#). Select the latest a*ailable ''F,

i our case, ''F%, ad click,e#t.

2#


33/136

#ig"re 7,. Select the &

22


34/136

3. +he /icese a!reemet dislasC clickAcceptad click,e#t.

#ig"re 77. icense window

4. +he 5date Packa!es widow lets ou select certai features of Portal to be udated (seefi!ure 23). o ot cha!e the selectioC Dust click,e#t.

23


35/136

#ig"re 7;. 9pdate Packages window

7. I the et widow (see fi!ure 24), eter the Portal ad -AS userids ad asswordsC i ourcase, all *alues arewpsadmin.

24


36/136

#ig"re 7erif the iformatio i the Summar widow ad the click 5date, to tri!!er the udaterocess (see fi!ure 27).

27


37/136

#ig"re 7=. S"mmar$ window

+he udate rocess i*ol*es dowloadi! the fi ack, ali! the udates to the biar files,ad the rui! se*eral cofi!uratio tasks to udate the deloed .ear files ad ossibl alsoerform database udates.

If the u!rade was successful ou should see a success widow as show i fi!ure 2:C clickinishto comlete the u!rade rocess.

2:


38/136

#ig"re 7>. #inal "pdate window

At the ed of the rocess Portal is left started, so ou ca cotiue with the et eercise.

= &ommand line toolsJow let?s focus o the commad lie tools.

6.1 ConfigEngine+he 'ofi!E!ie commad lie tool is used to eecute all -ebShere Portal 'ofi! tasks. 5sethe tool for cofi!uratio cha!es such as securit cofi!uratio, eabli!disabli! comoets,clusteri!, ad *irtual ortals, or if automatio is eeded.

It caot be used for all cofi!uratio cha!es, some of which are ossible ol i -AS Admi'osole Scriti!.

Alterati*e +ools iclude the 'ofi!-i8ard, -AS Scriti!, ad -AS Admi 'osole (limited setof tasks).

As a eamle task, let?s list all a*ailable *irtual ortals. +he 'ofi!E!ie takes iut arametersfrom the commad lie, roert files, ad the aret roerties file (see fi!ure 2).

2


39/136

#ig"re 78. &on%ig+ngine Inp"t val"es via propert$ %iles

+he most imortat iut roert files are9

+hew*plc!propertiesfile, which is the mai cofi!uratio file w*plc-comp!properties, cotaii! Ad*aced Securit, Process Ite!ratio, 5


40/136

Eecute the commad i the director, /opt/WebSphere/wp-pro(ile/Con(ig.ngine, asfollows (see fi!ure 2)9

!/Con(ig.ngine!sh listallvirtualportals 2PortalAdminPwd3wpsadmin2WasPassword3wpsadmin

#ig"re 7?. riggering the &on%ig+ngine command

where the sta is as follows9

Con(ig.ngine!bat Con(ig.ngine!sh 'ofi! task to be eecuted (i this case, listallvirtualportals) Proerties ot secified i the roerties files or roerties to be o*erwritte listallvirtualportalslists all eisti! *irtual Portals i the commad lie

Fi!ure 3$ shows the outut of the commad.

#ig"re ;0. &on%ig+ngine command o"tp"t

3$


41/136

6.2 ConfigWizard+he 'ofi!-i8ard commad lie tool lets ou eecute 'ofi! tasks from a eas0to0use 5I. 5se itfor wi8ard0stle cofi!uratios for9

>iew -orkflows, for eamle9

atabase +rasfer Securit


42/136

#ig"re ;,. IS& ogin screen

2. 'lick Con(iguration Wi"ardto see the 'ofi!uratio -i8ard -elcome widow(see

fi!ure 32).

3#


43/136

#ig"re ;7. &on%ig"ration Wi2ard Welcome window

3. 'hoose8iew Wor*(lows, select the .nable standalone 72AP securit+check

butto, ad click the Customi"e Wor*(lowbutto (see fi!ure 33).

32


44/136

#ig"re ;;. &on%ig"ration Wi2ard Work%low selection

33


45/136

4. Kee the default oerati! sstem 7inu#ad cofirm with,e#t(see fi!ure 34).

#ig"re ;


46/136

7. 'ofirm default setti!sC click,e#t(see fi!ure 37).

#ig"re ;=. &on%irm de%a"lt settings

:. I the et widow (see fi!ure 3:), all the detailed iformatio for our /AP must beiserted. As this should demostrate ol the ew 'ofi!uratio -i8ard, click Cancel(otherwise, we?d reuire a /AP ser*er).

37


47/136

#ig"re ;>. &ancel the Add #ederated /AP 1epositor$ option

6.3 Command line tools: WAS sripting+his commad lie tool is used whe creati!, modifi!, or deleti! -AS setti!s like damiccache setti!s ad thread ools, or whe automatio is reuired. It is ot for use whe modifi!-ebShere Portal rutime data like a!es or ortlets.

Alterati*e tools are 'ofi!-i8ard, 'ofi!E!ie, ad -AS Admi 'osole.

Fi!ure 3 shows the -AS Scriti! sta, where we do the followi!9

'ha!e to /opt/WebSphere/wp-pro(ile/binEter !/wsadmin!sh h

3:


48/136

#ig"re ;8. WAS Scripting s$nta@

For our samle eercise, let?s eable traci! for the -ebShere Portal Ser*er with wsadmi9

%. Eter the followi! commad to coect to the ser*er (see fi!ure 36)9

!/wsadmin!sh host localhost port 4669 user wpsadmin passwordwpsadmin

#ig"re ;?. &onnect to the server

3


49/136

+he commad coects to the ser*er o the !i*e ort, usi! the credetials of thewsadmi user, ad ow that we?re coected to the ser*er rocess, we ca tri!!ercommads.

#. Eter the followi! commads to eable traci! (see fi!ure 4$)9

;AdminControl completeraceService)node3wpsbvt)process3WebSphere-Portal)?

set ts @;AdminControl completeraceService)process3WebSphere-Portal)?

;AdminControl setAttribute ;ts traceSpeci(icationcom!ibm!wps!engine!?3all

#ig"re


50/136

#ig"re


51/136

#ig"re


52/136

Fi!ure 43 shows samle files i /opt/WebSphere/PortalServer/doc/#mlsamples.

#ig"re


53/136

+he file defies the ;M/ sta used b ;M/Access to eort the release data of -ebSherePortal.

%. First, cha!e to the /opt/WebSphere/wp-pro(ile/PortalServer/bin/director, adthe tri!!er the eort *ia the followi! commad (see fi!ure 47)9

!/#mlaccess!sh in /opt/WebSphere/PortalServer/doc/#mlsamples/.#portRelease!#ml out &nitialRelease!#ml urlhttp://localhost:4665/wps/con(ig user wpsadmin password wpsadmin

#ig"re


54/136

#ig"re


55/136

isting '. CMAccess scriptDE#ml version34!6 encoding30>1EFDreuest #mlns:#si3http://www!w!org/9664/HM7Schemainstance #si:no,amespaceSchema7ocation3PortalCon(ig-1!6!6!#sd t+pe3update createoids3trueF

Dportal action3locateF Dwebapp action3update active3trueuid3SPStandardStoc*Iuote!war!webmodF

DurlF(ile:///;server-root;/installableApps/SPStandardStoc*Iuote!warD/urlF

Dportletapp action3update active3trueuid3SPStandardStoc*Iuote!warF

Daccesscontrol e#ternali"ed3(alse owner3unde(inedprivate3(alseF

Drole actionset3Privileged 0ser update3setF Dmapping sub=ectid3all authenticated portal users

sub=ectt+pe3user-group update3set/F D/roleF D/accesscontrolF

D/portletappF D/webappF D/portalF

D/reuestF

+he ortlet SPFStadardStockuote.war will be imorted from the ath (ile:///;server-root;/installableApps/, ad ou ca use the samle file,2eplo+Portlet!#ml,that is art of the PortalAdminSampleiles!"ipfile. +he fileSPStandardStoc*Iuote!waris also art of the PortalAdminSampleiles!"ipfilesulied with the article.

%. "e commad lie, cha!e to /opt/WebSphere/wp-pro(ile/PortalServer/bin,

co the war file ad 2eplo+Portlet!#mlmlaccess file i the eected locatio, adtri!!er followi! commad (see fi!ure 46)9

!/#mlaccess!sh in J/2es*top/sample/2eplo+Portlet!#ml out2eplo+Portlet-out!#ml url http://localhost:4665/wps/con(ig user

wpsadmin password wpsadmin

#ig"re


56/136

#. 'heck the outut file, 2eplo+Portlet-out!#mli the/opt/WebSphere/wp-pro(ile/PortalServer/bindirector (see fi!ure 7$).

#ig"re =0. 1es"lt o% import

+he ortlet is ow imorted ad ca be used i our et eercises.

6.% WebSphere Portal sripting+his wsadmi0based tool is used to create ad modif -ebShere Portal artifacts limited b theroles of the user. ou ca use it whe9

'reati! or modifi! a limited set of -ebShere Portal resources like a!es or ortlets 'ombii! with wsadmi -AS scrits to modif -AS setti!s at the same time

Also, the tool is useful if admiistratio is dele!ated to sub0Admis.

o ot use it whe mo*i! cofi!uratio cha!es betwee e*iromets or whe eorti!-ebShere Portal artifacts ad deloi! ortlets.

Alterati*e tools are Portal ;M/ Access ad Portal Admi Portlets (limited set of tasks).

WebSphere Portal Scripting modes

+here are two modes i -ebShere Portal Scriti!9

+he first is Interactive mode, which allows us to tri!!er si!le commads ad whoseresose is directl *isible.

+he secod is Scriptingmode, which allows us to eecute a comlete, reared scritcosisti! of se*eral actios.

Interactive modeAs a eamle task, we create a samle ortal a!e, usi! the Iteracti*e mode9

%. "e a commad romt ad cha!e to the director9

/opt/WebSphere/wp-pro(ile/PortalServer/bin

#. I*oke the scriti! iterface, usi! the Dtho scriti! la!ua!e9

!/wpscript!sh lang =+thon

2. I the /o!i at the +ar!et Ser*er widow (see fi!ure 7%), eterwpsadmini both the 5serIdetit ad 5ser Password fieldsC cofirm b clicki!


57/136

#ig"re ='. ogin at the arget Server window

3. /o! o to the ortal, usi! the followi! scrit commad (see fi!ure 7#)9

Portal!loginLwpsadmin)wpsadminN

#ig"re =,. og on to the portal

4. Select the aret a!e of our ew a!e b first fidi! the aret a!e (see fi!ure 72)

Content!(indLall) uniuename) ibm!portal!OomeN

ad the selecti! the a!e9

Content!selectL$-CGAO%Q76617G6&AO0R5I6AN

#ig"re =7. #ind and select page

7. 'reate a emt a!e ad immediatel select this ew a!e (see fi!ure 73)9

Content!createLpage)>estPage)html)public)selectN

4:


58/136

#ig"re =;. &reate and select empt$ page

:. Set a uiue ame for this a!e (see fi!ure 74).

Content!setLuniuename)wp!test!pageN

#ig"re =


59/136

print ! create control with stoc* portlet! logout againPortal!logoutLN

print $! logout!printprint Processing done!

where O deotes a commet, Oprint rits a messa!e to the commad lie, ad theseuece of the scrit is9

/o!i/ocate the a!e'reate a cotaier o the a!e to hold the ortletPut the ortlet ito the cotaier/o!out

+he scrit will udate the a!e we created earlier with the Iteracti*e mode, ad the ortletdeloed earlier with ;M/Access will be added to the a!e.

#. I*oke the scrit to set the laout for the ew test a!e (see fi!ure 7:)9

!/wpscript!sh user wpsadmin password wpsadmin lang =+thon (0pdate7a+out!p+

#ig"re =>. Invoke script

+he commad eecutes the scrit cotaied i 0pdate7a+out!p+uder the user idetitwsadmi.

6.6 &elease'uilder+his commad lie tool comares differet ;M/Access eorts take o*er time, !eerati! a

differece ;M/Access file that ca be used to mo*e the cha!es made to the et e*iromet.+he tool is used i sta!i! to roductio scearios.

It?s ot to be used to comare ;M/Access eorts betwee differet e*iromets or for othertasks.

Alterati*e tools are Portal ;M/Access (limited sceario to mo*e si!le resources) ad PortalAdmi 'osole L Maa!ed a!es feature.

46


60/136

ou use


61/136

#ig"re >0. Start releaseb"ilder

#. Jow we !eerate the differece betwee the release eort we did at the be!ii! of thisaer ad the release eort we Dust created. +o do this, eecute the followi! commad (seefi!ure :%)9

!/releasebuilder!sh in


62/136

#ig"re >,. 1es"lting 1elease/i%%.@ml

Jotice that the file cotais the -eb alicatio (web0a) defii! the ortlet (ortlet) as wellas the a!e (cotet0ode) ad the ortlet o the a!e (ortletistace).

3. Jow check for the a!e we created (+estPa!e) ad the ortlet (SPFStadardStockuote.war)

we deloed after the iitial eort.

+he Release2i((!#ml file ca be used to imort our cha!es to aother sstem that?sreared to recei*e these cha!es.

7#


63/136

> Administration "ser inter%ace: Admin portlets+he Admi ortlets are a*ailable with the -ebShere Portal istallatio ad are laced i thePortal Admiistratio area. B default, as admiistrator, ou ha*e access to these ortlets.Here are some eamles of what ou ca do with the Admi ortlets (see fi!ure :2)9

adat the user iterface (hierarch of a!es, a!e laout)

admiister -eb alicatios ortlets (for eamle, ro*ide ortlets for or cosumeortlets from other -ebShere Portal ser*ers)

cha!e the access cotrol (users ad !rous, credetial *ault, olicies) modif -ebShere Portal setti!s (for eamle, 5


64/136

Portlets related to -eb 'otet Maa!emet, Persoali8atio


65/136

#ig"re >=. ogin to Portal

74


66/136

After the lo!i the default =etti! Started a!e dislas, which cotais a ortlet dislai! somewelcome iformatio. +he structure of the -eb site is defied b the theme L which liks aredislaed, how the a*i!atio looks like, the colors, bradi!, etc. (see fi!ure ::).

#ig"re >>. A"thenticated Area a%ter Portal ogin

Currently SelectedRoot Page

Other

Root Pages

Currently

Logged In

User

Managed

Pages

Settings

Page

Edit

Mode

Search Bar

Currently

Selected

Page

Other

Pages below

Home

Logout Lin

Portlet on

Selected

Page

!dditional

!ctionsLie Rating

(.2 Admin portlets: #anage )sers and *roupsI this toic we use the Maa!e 5sers ad =rous ortlet (see fi!ure :) to add a o0admiistratio user. Jote that Permissios ca be !rated to users or !rous, ad there is ahierarchical access cotrol model (for eamle, alo! the a!e hierarch).

77


67/136

#ig"re >8. Manage 9sers and Ero"ps portlet

/ater, the o0admi user is used to demostrate the Imersoatio fuctioalit.

Alterati*el, ou ca create users b usi! ;M/Access or directl i the /AP, or i the -ASAdmi 'osole.

+o create a ew user with the Admi ortlet9

%. "e a browser with http://localhost:4665/wps/portalad lo! i with useridwpsadminad asswordwpsadmin.

#. SelectAdministration000Access000 0sers and Groups, ad click the,ew 0serbutto (see fi!ure :6).

#ig"re >?. &reate new "ser

7:


68/136

2. Eter at least followi! iformatio to create a user (see fi!ure $)9

0ser &2PasswordCon(irm Password7ast ,ame

#ig"re 80. +nter "ser in%ormation

3. 'ofirm the user creatio b clicki!


69/136

#ig"re 8'. S"ccess message

(.3 Admin portlets: +irtual Portal #anager-e use this admi ortlet to create a ew *irtual ortal (see fi!ure #) that ca be used, foreamle, to host ma ortals withi oe istallatio, or as a sta!i! sstem, or to host differetortals with differet user iterfaces ad user !rous.

#ig"re 8,. 5irt"al Portal Manager portlet

Jote that ou ca also create *irtual ortals b usi! the scriti! iterface ad the usi!;M/Access to fill the *irtual ortal. +o create the ew *irtual ortal9

%. SelectAdministration0008irtual Portals000Manage 8irtual Portals, ad theclick the,ew 8irtual Portalbutto (see fi!ure 2).

76


70/136

#ig"re 87. &reate new virt"al portal

#. 'omlete the *irtual ortal?s iformatio as follows (see fi!ure 3) ad click irtual ortal ame9 accounts>irtual ortal descritio9 >he accounts 8irtual Portal5


71/136

#ig"re 8;. +nter virt"al portalFs in%ormation

ou should see the created successfull messa!e ad our ew +he Accouts >irtual Portallisted i the ortlet (see fi!ure 4).

:%


72/136

#ig"re 8irtual Portal (see fi!ure 7) b secifi! the 5


73/136

#ig"re 8>. Administration area o% a virt"al portal

(.! Administration *),-s: #anaged PagesMaa!ed a!es streamlie site maa!emet i our ortal b simlifi! how ou create a!esad add cotet. Because a!e iformatio ad cotet are stored i web cotet libraries, ouca more easil coordiate ad ublish cha!es with sdicatio.

Maa!ed a!es are ortal a!es that are stored i IBM -eb 'otet Maa!er. B maa!i!ortal a!es from withi -eb 'otet Maa!er, ou ca al features like workflow, *ersiocotrol, ad sdicatio to ortal a!es. -he ou erform a ew istallatio of IBM -ebSherePortal, maa!ed a!es are eabled b default.

+he followi! admiistrati*e caabilities are eosed iside the theme without ha*i! to use theAdmi ortlets uder the Admiistratio tabC the followi! alread eist withi Portal :9

'reati! a Pa!e, eleti! a Pa!e, Mo*i! a Pa!e Modifi! a a!e9 Addi! or remo*i! ortlets Modifi! ortlet roerties ad setti!s 'ha!i! the stle 'ha!i! the laout Assi! Permissios +a!!i! ad


74/136

+hese are ew with Portal 9

'reati! ad maa!i! a roDect Aaltics Pre*iew Aro*al

+he a!e maa!emet ow occurs as art of a -'M roDect. ou ca combie -'M ad Portala!e modificatios ito the same roDect. ProDects ha*e their ow life ccle i that the follow aaro*al rocess ad allow ou to use *ersios.

A test user must be re*iousl created, ad alterati*e tools are ;M/ Access ad the Maa!ePa!es ortlet. -e will first create a roDect that we will use to make the a!e cha!es with.

+o create a roDect9

%. If still lo!!ed i to the *irtual ortal, lo! out.#. /o! i to the default Portal aswpsadmin(http://localhost:4665/wps/portal)2. Select the Published Sitelik.

3. 'lick the,ew Pro=ectbutto (see fi!ure ).

#ig"re 88. rigger proGect creation

4. Eter a ame ad isla +itle for the roDect ad re*iew the Publish "tios ad Aro*alsectios (see fi!ure 6). +he Publish otios ifluece how a *ersio of a roDect itembecomes ublicl *isible (cha!es from draft to ublished mode). +he Aro*al sectiodetermies who ca aro*e a roDect to be ublic *isible. 'lick the Save and Closebutto.

:3


75/136

#ig"re 8?. &reating a proGect

After creati! the roDect the +heme directl switches to the Edit mode of the curret a!e. Jotethat there is a lik ow to Dum back to the >iew mode, to *iew the cha!es ou ha*e made. Alsoote that the disla ow occurs as art of the roDect we created. +he roDect MFirstProDect isselected.

-e wat to create a ew a!e et.%. Select theMorebutto ad, i the Jew widow select the,ew Sibling Pageotio. A

a!e is created at the same le*el as the curretl selected a!e.

#. I the o0u widow, eter a a!e ame ad click Create. Jote the Pa!e +emlate otio(see fi!ure 6$). A a!e temlate defies a structure ad setti!s for a a!e, for eamle, the

assi!ed -eb 'otet Maa!emet Site /ibrar or the ortlets o the a!e. ou ca createour ow temlates ad reuse them later.

:4


76/136

#ig"re ?0. &reating an empt$ page

2. See the ewl created a!e bei! dislaed ad selected (see fi!ure 6%). At the mometthere is o cotet o the a!e. Select the Contenttab, to add cotet to the a!e.

:7


77/136

#ig"re ?'. +dit the empt$ page

3. SelectWeb Contentad select the 7ist o( Articlesortletcotet (see fi!ure 6#).

#ig"re ?,. +dit the empt$ page

4. Select Communicationsad select the eedortlet. Jote that the /ist of Articles ortlet wasadded earlier to the a!e (see fi!ure 62).

::


78/136

#ig"re ?7. Add a %eed portlet

7. I the o0u widow (see fi!ure 63), secif a +itle for our feed ortlet ad the 5


79/136

:. After ha*i! added the feed ortlet to the a!e, ou ca see that both ortlets were addedbelow each otherC use dra!0ad0dro to mo*e the ortlets beside each other. Jow sa*e thea!e as draft b selecti! the Save 2ra(tbutto (see fi!ure 64).

#ig"re ?


80/136

%. SelectMore000 Preview000As 0ser(see fi!ure 67).

#ig"re ?=. Previewing the Page

#. I the et widow, select a user to imersoate b eteri! the ame of the user we createdearlier (user%) i the Search field ad clicki! the Search ico (see fi!ure 6:).

Select the radio butto i frot of the user ad click the Imersoate butto. -ith that, oueffecti*el become this user ad ca re*iew what he will see after the a!e has beeublished.

$


81/136

#ig"re ?>. Impersonating a "ser

2. After tri!!eri! the Imersoatio ou ca see the a!e as the user would see it. Jote theselected roDect. Also ote the userid that is dislaedC ou ow show as user%, whom ouimersoated. 'lick the Stop Previewingbutto to udo the imersoatio ad becomethe admi user a!ai (see fi!ure 6).

%


82/136

#ig"re ?8. Previewing the page as impersonated "ser

#


83/136

Jow that we are the admi user a!ai we wat to cotiue modifi! our a!e9

%. Select the St+lesectio ad select a stle (see fi!ure 66).

#ig"re ??. Select a st$le

#. +he laout of the a!e determies which cotet is dislaed where o the a!e. Select the7a+outtab ad select a differet laout (see fi!ure %$$).

2. Afterward we will create some -'M cotet as art of the roDect. Select the Ilie Editi!lik i the /ist of Articles sectio b clicki! Create ,ew Article.

2


84/136

#ig"re '00. Select a la$o"t

3. I the Jew ilie editi! widow, set a ame ad eter some cotet i the bod. +he clickSave and Close(see fi!ure %$%).

3


85/136

#ig"re '0'. &reate an article

4. 'lick the Save 2ra(tbutto whe doe ad retur to the >iew mode b clicki! the8iewMode butto (see fi!ure %$#).

#ig"re '0,. Save the page

I >iew mode ou ca see how the a!e will look. Jote that ou see the a!e *ersio as it isart of the roDect ou created. It is still a draft a!e.

7. Select the roDect ad select the Published Site state to see how the a!e looked before themodificatios we made (see fi!ure %$2).

4


86/136

#ig"re '07. 5iew the page

I the ublished state we ca see that the a!e does ot e*e eist. /et?s !o back to the roDectad ublish it9%. Select Published Sitead select our roDect (see fi!ure %$3).

#ig"re '0;. 5iew the p"blished state

7


87/136

#. Select the ProDect at the to ad click the Maa!e lik (see fi!ure %$4).

#ig"re '0


88/136

3. Jotice that after the Aro*al, the documets a!e are ow i Publish Pedi! state. -ewill ow ublish the roDect b clicki! the Publish Pro=ectbutto (see fi!ure %$:).

#ig"re '0>. P"blish the proGect

4. -e ow ha*e ublished the a!e, ad the ew a!e is showi! i the Published Site state.Select the ew a!e ad ha*e a look (see fi!ure %$).


89/136

#ig"re '08. 5iew the modi%ied page a%ter p"blication

(.% agging and rating-ebShere Portal : itroduced ta!!i! ad rati! of resources such as a!es ad ortlets. 5sersca ta! ad rate resources, if ou allow them to. +he +a! 'eter lets ou elore the eisti! ta!sad maa!e them. -ebShere Portal eoses a similar 5ser Iterface.

I this sectio, ou tr out ta!!i! ad rati!9

%. /o! i to Portal as admi (wpsadminwpsadmin).#. Select oe of the a!es uder the Oomelabel.2. SelectActions000 >ag(see fi!ure %$6).

6


90/136

#ig"re '0?. Select to tag a page

3. Add some ta!s (like Support Articles irstPage) for the Pa!e ad click Save(seefi!ure %%$).

6$


91/136

#ig"re ''0. Adding tags to a page

4. "ce Sa*ed, ou see the ta!s ou created. 'lick Closeto lea*e the widow (see fi!ure %%%).

#ig"re '''. Saving tags %or a page

6%


92/136

7. /o! out ad lo! i a!ai as aother user (for eamle, user4), usi! the 7og outad 7oginbuttos (see fi!ure %%#).

#ig"re '',. og back in

:. After lo!i, click the >ag Centerbutto i the baer of the a!e (see fi!ure %%2).

#ig"re ''7. ag &enter b"tton

. I the +a! 'eter ou ca see all eisti! ta!s ad select them (for eamle, Support) todisla resources ta!!ed with them (see fi!ure %%3). "e result was foud for the ta! Suortthat ou Dust selected.

#ig"re '';. +@ploring the ag &enter

6#


93/136

6. Jobod seems to ha*e rated the a!e et, as ou ca see from the little star icos o theri!ht0had side of the a!eC select the a!e likM+irstPage. (see fi!ure %%4).

#ig"re ''


94/136

#ig"re ''>. 1ating a page

%#. "ce sa*ed, ou ca see the a!e rati! statistics, as show i fi!ure %%. 'lick Closetoretur to the >iew mode of the a!e itself.

#ig"re ''8. 1eview the page ratings

63


95/136

(.6 Admin portlets: Web Appliation 'ridge+he -eb Alicatio Brid!e uses re*erse0ro techolo! to ite!rate -eb0based cotetro*iders, such as the Microsoft SharePoit #$$: ser*er, with IBM -ebShere Portal.

Admiistrators must first defie the *irtual -eb alicatios or cotet ro*iders.

A li!htwei!ht iFrame ortlet dislas the cotet from the backed alicatios. 5sers ca the

access the iFrame o a a!e without reuiri! direct etwork access to the backed alicatio. Asecial e!ie mas 5iform


96/136

#. For both the 5ser I ad Password fields, eterwpsadminC click the 7og inbutto.

#ig"re ',0. ogin screen

2. SelectApplications V Application >+pes V WebSphere .nterpriseApplications!'lick the Show Filter Fuctio butto, eter w.*wat.ser*let.ear, ad click

=o (see fi!ure %#%).

67


97/136

#ig"re ','. Applications Start window

3. I the et widow ou see the w.*wat.ser*let.ear file for which ou searched. 'lick the .earfile to access the roerties of the alicatio (see fi!ure %##).

#ig"re ',,. Applications Search 1es"lt window

4. I the roerties widow for the .ear file, locate ad select the Conte#t Root (orModuleslik (see fi!ure %#2).

6:


98/136

#ig"re ',7. Application Properties window

7. 'ha!e the 'otet


99/136

:. " the et widow (see fi!ure %#4), click Save'

#ig"re ',


100/136

#ig"re ',>. Start the application

%$. >erif that ou see the successful start messa!e ad the lo! out of the cosole b clicki!the 7ogoutbutto (see fi!ure %#).

#ig"re ',8. Start the application and log o%%

%$$


101/136


102/136

4. Jet, we create the backed site b selecti!,ewQApplication Component(see fi!ure%2%).

#ig"re '7'. Web Application Bridge Admin portlet

7. I the >irtual Alicatio Maa!er Portlet widow (see fi!ure %2#), eter the followi!

iformatio for the ew cotet ro*ider9

5>P Host9 lucene!apache!org 'otet


103/136

#ig"re '7,. In%ormation %or backend site

:. -e ha*e created the defiitio for the backed siteC i the widow, ead the Public WebSites'ate!or to see the descritor we Dust created (see fi!ure %22).

%$2


104/136

#ig"re '77. 1es"lt window

+he et ste i the rocess is to create aother Portal a!e ad add the -eb ock ortlet to it9

%. Switch back to Oome, make sure that Published Site is selected, ad click the .dit Modebutto (see fi!ure %23).

#ig"re '7;. Switch to !ome and p"t in +dit mode

#. +his time we create the a!e outside of a roDectC the cha!e is *isible immediatel. I theEdit mode of the a!e, selectMoreQ,ew Sibling Page(see fi!ure %24).

%$3


105/136

#ig"re '7


106/136

3. Switch to the /aout area ad select the 4 Columnlaout (see fi!ure %2:).

#ig"re '7>. &hange the la$o"t o% a page

4. After the a!e laout has bee modified, switch to 'otet ad search for the -eb ockPortlet. 'lick the Plus ico besides the ortlet to add it to the a!e (see fi!ure %2).

#ig"re '78. Add a portlet to the page

7. I the et widow, click the Savebutto (see fi!ure %26). Jote that the error to the effect thatthe rofile associated with the theme that is assi!ed to the a!e does ot ro*ide certaicaabilities that this ortlet reuires to work.

%$7


107/136

#ig"re '7?. Save the page

Itroduced with -ebShere Portal :.$.$.#, the theme modulari8atio work is iteded todecoule feature eablemet from the theme code itself. +his allows themes to be de*eloedmore easil from a outside i aroach with little kowled!e about the details of howuderli! code for a articular feature i Portal works.

+he result of this work is to ro*ide lo!ical oits where modules ca cotribute data ito atheme at rutime ad to otimi8e those cotributios b combii! them whe ossible.

-e eable the full rofile for this articular a!e. I a later sectio we will elore how tocustomi8e theme rofiles.

:. 'lick


108/136

#ig"re ';'. +dit page properties

Jow we ca re0add the ortlet to the a!e9

%. Select 'otet ad erform the same stes as before to add theWeb 2oc*ortlet to thea!e. 'lick SaveC this time o error should aear (see fi!ure %3#).

%$


109/136

#ig"re ';,. Add a portlet to the page

#. 'ofi!ure theWeb 2oc*ortlet to oit to the re*iousl created backed cofi!uratio.'lick the little ico at the uer0ri!ht corer of the ortlet (see fi!ure %32) ad select .ditShared Settings. +his bri!s us to the Edit mode of the ortlet. 'ha!es made i thatmode al to all users of the ortlet (whereas Persoali8e will make the cha!e ol for thelo!!ed0i user).

%$6


110/136

#ig"re ';7. rigger the portlet modi%ication

2. I the Edit mode of the -eb ock ortlet, eter the followi! *alues to oit to the backedad set the *isual setti!s (hei!ht ad widthC see fi!ure %33)9

5


111/136

#ig"re ';;. +dit the Web /ock portlet settings

3. Switch back to the >iew mode ad see the ite!rated backed site that is ow roied *iaPortal. 'heck the liks o the a!e ad ote that the oit to the Portal Ser*er ad ot to the

Aache site (see fi!ure %34).

#ig"re ';


112/136

(.( Personalization rules-ebShere Portal Persoali8atio ro*ides automatic customi8atio of -eb site cotet foridi*idual users ad user !rous. Persoali8atio ca reco!i8e a secific user based o a rofileor ca determie characteristics of a user based o re*ious urchases, roducts, a!es *iewed,ad so forth. Persoali8atio the selects cotet that is aroriate for that rofile.

For eamle, if a erso has a hi!h salar ra!e, Persoali8atio ca be cofi!ured to retrie*eiformatio about a commercial -eb site remium roduct. If a idi*idual belo!s to a articular!eo!rahic re!io, cotet secific to that re!io ma be tar!eted to the idi*idual. -he thea!e is assembled with the roer ersoali8ed iformatio, users see their ersoali8ed a!e.

I this simle samle case we create a *isibilit rule that cotrols that a a!e is dislaed ol oa certai da of the week.

-e use the Persoali8atio Ja*i!ator ad Editor admi ortlets to create the rule ad the usethe Maa!e Pa!es ortlet to associate the rule with the a!e. Istead of usi! the admiistratioortlets it is also ossible to eort ad imort rules usi! the 8load commad lie utilit. I thiseercise we focus o the admi ortlets.

%. /o! i to Portal as Admiistrator (wsadmiwsadmi) ad cha!e the selectio toApplications () Personali*ation () +usiness &ules' +he Persoali8atioJa*i!ator lists all the defied Persoali8atio obDects ad allows ou to create, edit, addelete Persoali8atio obDects like rules (see fi!ure %37).

#ig"re ';=. B"siness 1"les tab

%%#


113/136

#. Select Ne% () &ule, to bri! u the widow to create a ew rule (see fi!ure %3:).

#ig"re ';>. &reate a new B"siness r"le

2. I the et widow, defie the followi! (see fi!ure %3)9

Jame of the


114/136

#ig"re ';8. &on%ig"re a new B"siness r"le

3. I the et widow ou ca see that our Moda


115/136

#ig"re ';? contin"ed

Jow that we ha*e created the rule we wat to associate it with oe of our a!es ad test that itworks9

%. +o associate the a!e with the rule, click select Administration #anage Pages,adthe select 'otet


116/136

#. I the Edit Pa!e roerties widow (see fi!ure %4%), scroll dow, ead the Ad*acedotios meu, ad click the little ico to ma a rule. I the o0u meu, select the Select


117/136

2. I the Select


118/136

4. >erif that the rule works b a*i!ati! to Home ad checki! which a!es are dislaedC ifou are doi! this eercise o a Moda, the a!e should aear. " all other das the a!eshould ot disla as show i fi!ure %43C istead, the et a!e is selected ad dislaed.

#ig"re '


119/136

#ig"re '


120/136

#ig"re '


121/136

+he Persoali8atio


122/136

Jote that there are multile etr oits with -eba* for Portal9

/themelist Admiistratio of themes +itle, descritio, metadata (mas directl to B)

/s*inlist Admiistratio of skis +itle, descritio, metadata (mas directl to B)

/(st+pe4 Modif static resources directl +hemes, skis, laouts, commo resources, iwid!ets

/contentmodel Portal a!es

/content -eb 'otet Maa!er data

#. For our eercise we will coect to the themelistetr oit ad elore the ew rofilecofi!uratio. For eamle, with /iu usi! autilus, click ile0Connect to Server.(see fi!ure %46)9

Ser*er9 localhostPort9 4665Folder9 /wps/m+contenthandler/dav/themelist/5ser Jame9 wpsadminJame to use for coectio9 Tuse a commet, e.!.9Web2A8->heme7ist

'lick Connect.

%##


123/136

#ig"re '


124/136

#ig"re '=0. oading the pro%iles

. Jow oe the J/temp/folder o the deskto ad use geditor aother tool to look at the

rofiles. +he structure defies the differet modules that are loaded as art of the model. +heli!htwei!ht rofile defies ol a miimum set of comoets (see fi!ure %7%). +he full rofiledefies all the comoets, the admi rofile is used for the admi sectio of Portal, ad thedeferred rofile loads certai modules whe reuested.

%#3


125/136

#ig"re '='. 1eview the pro%ile de%initions

8 WAS Admin "ser inter%ace-e use the user iterface (5I) to modif -AS cofi!uratios whe creati!, modifi!, or deleti!-AS setti!s, such as damic cache setti!s ad thread ools, or for maa!i! a cluster orremote odes.

It caot be used for modifi! -ebShere Portal rutime data like a!es ad ortlets.

Alterati*e tools are -AS Scriti!, 'ofi!-i8ard, or 'ofi!E!ie.

I our samle tasks we elore the ew features of -AS such as the ew securit domais,icludi! the >MM cofi!uratio, hi!h0erformace lo!!i!, ad ite!rated feature acks.

%. +o lo! i to the Ite!rated Solutios 'osole (see fi!ure %7#)9

a) "e a browser ad eter https://localhost:4669/ibm/console/logon!=spb) For both the 5ser I ad Password fields, eterwpsadminC click the 7og inbutto.

%#4


126/136

#ig"re '=,. ogin window

#. Jotice some of the ew features i -AS , for eamle, the ew automatic directordelomet (see fi!ure %72). SelectApplications()Global deplo+ment settings to!et to the ew feature. It lets ou secif a director that -AS re!ularl scas for .ear filesad automaticall delos them, if the eist, or remo*es them whe deleti! them000whichca sa*e uite a lot of admiistratio effort.

%#7


127/136

#ig"re '=7. A"tomatic director$ deplo$ment mode

Aother ew feature of -AS is the suort for multile securit domais iside a cell.

Althou!h -AS : had itroduced the feature, it did ot co*er suort for >MM. -ebShereAlicatio Ser*er has added >MM. -ebShere Portal does ot full suort this featurecurretl sice the cofi!uratio tasks are ot aware of the ew cofi!uratio otios.

+he use case for this eists, for eamle, whe usi! multile clusters i a cell or reuiri!sli!htl differet setti!s for, sa, the M!r.

2. Select Securit+Q Securit+ 2omains0 Cop+ Global Securit+to create a ewdomai based o the curret !lobal setti!s (see fi!ure %73).

%#:


128/136

#ig"re '=;. &reate a new sec"rit$ domain

3. Select a ame for the ew securit domai, for eamle,m+serversecurit+C click


129/136

#ig"re '=


130/136

4. 'lick Saveto sa*e the cha!es to the master reositor (see fi!ure %77).

#ig"re '==. Save the new sec"rit$ domain

7. Select the ewl created securit domai ad ead the twisties to see all the cofi!uratiocha!es ou ca erform. Fi!ure %7: shows how, below the 0ser Realmsectio, ou camake cha!es to the >MM cofi!uratio.

%2$


131/136

#ig"re '=>. 5alidating and changing a sec"rit$ domain

Jow that we ha*e created a custom securit domai we ca assi! it to the ser*er for it to takeeffect9

%. Select the Securit omai ad the ead the Cell Q,odes Q ode ame Q ServersQWebSphere Portalad select it. +he click


132/136

#ig"re '=8. Assign a sec"rit$ domain

#. >erif the setti! b checki! the securit domai i the ser*er cofi!uratio. Select ServersQ Server >+pesQWebSphere Application Servers QWebSphere Portal. +hewidow show i fi!ure %76 dislas. Jote the ew 'ommuicatios Eabled AlicatiossectioC se*eral of the re*ious a*ailable feature acks ha*e bee ite!rated ito -AS ,amo! them, "S=i alicatios, Ser*ice 'omoet Architecture (S'A), Ga*a Batch,'ommuicatio Eabled Alicatios, ad ;M/ feature acks.

2. Select the Securit domai lik at the bottom ad ote that ou are set to the ew securitdomai we Dust created.

%2#


133/136

#ig"re '=?. Server con%ig"ration

As art of the Ga*a Batch Feature ack ite!ratio ou ca ow schedule batch Dobs from withithe -AS b clicki! S+stem Administration Q ob Schedulerto !et to the Dob scheduler(see fi!ure %:$).

%22


134/136

#ig"re '>0. ob sched"ler

Aother ew feature we wat to oit out is the ew Hi!h Performace Etesible /o!!i!, whichseeds u lo!!i! ad traci!, ad ro*ides more fleible access to lo! ad trace data9'ommad lie access to filter ad formatC Admiistrati*e cosole =5I to filter ad format local orremote lo!s ad trace, e*e whe the remote ser*er is dowC Pro!rammatic access to filter,format, ad mer!e local or remote lo!s ad trace.

%23


135/136

Select >roubleshootingQ 7ogs and >raceQWebSphere Portal (see fi!ure %:%).

#ig"re '>'. ogging and tracing

? &oncl"sionAs a -ebShere Portal admiistrator, ou ca use differet tools to modif admiistratio adorcofi!uratio data. +he decisio as to which tool to use deeds o the task to be erformed ad

o the refereces of the admiistrator. For reeatable tasks, it?s alwas recommed to usecommad lie tools.

'0 1eso"rcesde*eloer-orks -ebShere Portal 8oe9htt9www.ibm.comde*eloerworkswebshere8oesortal

-ebShere Portal Famil wiki9htt9www0%$.lotus.comlddortalwiki.sf

-ebShere Portal ad /otus -eb 'otet Maa!er roduct documetatio9htt9www.ibm.comde*eloerworkswebshere8oesortalroddoc.html

-ebShere Portal ad /otus -eb 'otet Maa!er tui! !uide9htt9www0%$.lotus.comlddortalwiki.sfd+ueourser*ersw


136/136

Admiisteri! IBM -ebShere Portal :.$9 A comrehesi*e worksho9htt9www.ibm.comde*eloerworkswebshere8oesortalroddocortalworksho

'' A"thor biographies

homas !"rekis a Software Architect at IBM?s

Administering IBM WebSphere Portal 8.0: A comprehensive workshop

Documents

Transcript of Administering IBM WebSphere Portal 8.0: A comprehensive workshop