!

!
!
!
!
Installation!Guide!!
Single!Server!Demo!environment!of!
IBM!Connections!5.0!and!IBM!Docs!1.0.7!
!

Written!by:!

Martti!Garden!
European!Technical!Lead!IBM!Docs!

martti.garden@de.ibm.com!

Version!1.0!

March!15th!2015!

!
Inhaltsverzeichnis!

INTRODUCTION) 3!

INSTALLING)AND)SETTING)UP)IBM)DOMINO)AS)LDAP)AND)SMTP)SERVER) 5!

INSTALLATION)OF)IBM)DB2) 44!

INSTALLATION)AND)CONFIGURATION)OF)THE)WEBSPHERE)APPLICATION)SERVER) 59!

INSTALLATION)OF)THE)IBM)TIVOLI)DIRECTORY)INTEGRATOR) 102!

IBM)CONNECTIONS)DATABASE)CREATION)AND)USER)POPULATION) 111!

INSTALLATION)OF)IBM)CONNECTIONS)5.0) 122!

IBM)CONNECTIONS)POST)INSTALLATION)CONFIGURATION)STEPS) 140!
INITIAL)DEPLOYING)OF)ALL)APPLICATIONS)TO)THE)CONNECTIONS)CLUSTER) 140!
CONFIGURING)WAS)TO)USE)THE)IBM)HTTP)SERVER) 148!
CONFIGURING)FILENET) 176!
INSTALLATION)OF)COGNOS) 187!

INSTALLATION)OF)IBM)DOCS)1.0.7) 210!
CREATING)THE)IBM)DOCS)DATABASE) 215!
INSTALLATION)OF)IBM)DOCS)1.0.7) 220!
VERIFYING)THE)DOCS)INSTALLATION) 238!
!

! 2!
Introduction!
!

This!document!was!created!while!installing!a!classroom!education!environment!with!IBM!
Connections!5.0!including!Cognos,!Filenet!and!IBM!Docs.!!This!document!can!help!and!aid!you!in!your!
own!installation!but!always!keep!in!mind,!that!for!this!virtualized!environment!everything!runs!in!a!
single!VM,!which!is!not)supported.!Also!Keep!in!mind,!that!not!all!required!patches!for!a!production!
environment!have!been!applied!here.!For!now!IBM!Docs!does!not!work!in!CCM!Libraries!for!the!
moment!as!CR2!is!not!deployed.!This!will!be!added!later!to!this!guide.!

This!installation!guide!covers:!

1.! Installing!and!setting!up!a!Domino!Server!as!LDAP!
2.! Installing!and!setting!up!DB2!
3.! Installing!and!setting!up!WebSphere!
4.! Installing!and!setting!up!Tivoli!Directory!server!
5.! Installing!and!setting!up!IBM!Connections!5.0!
6.! Setting!up!Filenet!
7.! Setting!up!Cognos!
8.! Installing!and!setting!up!IBM!Docs!

This!installation!was!run!on!a!notebook!with!16!GB!of!RAM!with!13,5!GB!assigned!to!the!VMWare!
with!Windows!2008!R2!64!Bit!running!as!the!server!environment.!120!GB!have!been!assigned!for!the!
virtual!hard!drive.!!13,5!GB!of!RAM!will!get!the!system!started!up,!but!do!not!expect!to!be!working!
with!more!than!a!single!user!on!it,!as!the!memory!is!really!constrained.!Also!I!suggest!you!do!use!a!
SSD!for!the!installation.!I!am!not!sure,!if!a!regular!HDD!in!a!notebook!is!fast!enough.!

As!you!can!see!in!the!following!screenshot,!with!all!services!running!and!no!one!working!with!the!
products!the!servers!will!take!up!around!12,8!GB!of!RAM.!So!if!you!can,!assign!at!least!16!GB!RAM.!

! 3!
!

The!following!Software!has!been!used!for!this!installation:!

IBM Installation Manager:

IBM Installation Manager 1.8.1 Windows x64

DB2:

DB2_10.1_FP4_INSTALL_Winx64

Tivoli Directory Integrator:

TDI_7.1.1_WindowsX64 + TDI_7.1.1_FP3

IBM Connections:

IC_50_COGNOS_INSTALL_WIZARD.exe, IC_50_DB_WIZARDS.exe, IBM_Connections_5.0_winx64,

FileNet:

2.0.0.1-FNCS-IF001-WIN.exe, 5.2.0.3-P8CPE-CLIENT-WIN-FP003.EXE, 5.2.0.3-P8CPE-WIN-

FP003.EXE and 5.2.0-P8CE-WIN.EXE

Domino:

Domino_Admin_Designer_Notes_901_w32_EN.exe, Domino_9.0.1_W64.exe

WebSphere Application Server:

WAS_855_1of3, WAS_855_2of3, WAS_855_3of3, WAS_855_Supplements_1of3,

WAS_855_Supplements_2of3, WAS_855_Supplements_3of3

IBM Docs:

IBM Docs 1.0.7

Cognos:)

IBM!Cognos!Business!Intelligence!Server!64Zbit!10.1.1!!!!

IBM!Cognos!Intelligence!Transformer!10.1.1!

Partnumbers:)

All!Partnumbers!can!be!found!here:!!

http://wwwZ01.ibm.com/support/docview.wss?uid=swg24037654!

! 4!
Installing!and!setting!up!IBM!Domino!as!LDAP!and!SMTP!server!
!

First!we!need!to!install!the!IBM!Domino!server.!Run!the!installer.!

!
!

The!files!will!now!be!unzipped.!

! 5!
Now!the!installer!starts!and!we!click!next.!

!
Now!we!need!to!accept!the!license!agreement!and!click!next.!!

!
!

! 6!
Choose!a!path!to!install!IBM!Domino!to.!In!all!of!the!installation!parts!I!will!install!into!C:\IBM!and!
always!remove!the!“Program!Files”.!I!strongly!suggest!you!do!so,!too,!to!avoid!issues!with!the!Space!
in!“Program!Files”!and!keep!the!directory!length!name!as!short!as!possible.!

!
Choose!the!data!directory:!!!

!! !
!

! 7!
Choose!Domino!Enterprise!Server:!

!
Click!next!at!the!summary!screen.!

!
The!installation!will!now!begin.!

! 8!
Once!the!installation!is!done,!it!should!only!take!a!couple!of!minutes,!click!Finish.!

!
!

Now!we!install!the!IBM!Notes!Admin!client.!

!
The!first!option!will!unpack!the!files!and!delete!them!after!the!installation.!

! 9!
Once!the!installer!has!started!click!next.

!
Accept!the!licence!agreement!and!click!Next.

!
!

! 10!
Now!choose!the!path!for!the!installation!and!the!data!directory.!I!suggest!to!remove!the!“Program!
Files”!part.!

!
Click!next!to!continue.!

! 11!
Now!we!need!to!add!the!IBM!Domino!Administrator!to!the!feature!being!installed.!Then!click!Next.

! 12!
You!can!leave!all!options!ticked.!Click!Install!to!start!the!installation.

!
Once!the!installation!is!done!click!Finish.!

!
!

! 13!
Now!we!start!the!Domino!server!for!the!first!time!to!configure!it.!

!
On!the!start!up!screen!click!Next.!

! 14!
We!are!going!to!install!our!first!server!and!it!will!be!a!standZalone!server,!therefore!we!just!click!Next.

Here!we!give!the!Server!a!name!and!title.!I!suggest!you!keep!the!standard.!You!can!choose!freely!
though,!but!if!you!choose!your!own,!make!sure!to!write!it!down,!as!you!will!need!it!later.!Then!click!
Next.!

! 15!
Now!we!choose!an!organization!name!and!a!password!for!the!Certifier.!Choose!ibmdemo!for!the!
Organization!name!and!Passw0rd!for!the!password.

!
!

One!the!next!screen!the!Domino!Domain!name!should!be!ibmdemo.

!
!

! 16!
Now!we!will!create!the!Domino!Administrator.!Just!choose!Administrator!for!the!last!name!and!
Passw0rd!as!password.!You!may!want!to!select!to!save!a!local!copy!of!the!ID!file!to!have!access!to!it.!
Click!next.

! 17!
While!we!do!not!want!the!HTTP!Services!set!up!(we!will!use!the!IBM!HTTP!Server!later!on)!we!need!
the!Internet!Mail!Clients!for!SMTP!and!the!Directory!services!selected!for!LDAP.!Click!Next.

!
!

! 18!
On!the!next!screen!you!may!have!to!add!the!hostname.!Click!Customize.!

!
Add!the!Host!Name!of!you!machine!(e.g.!ics.ibmdemo.com)!to!the!qualified!hostname!and!click!OK.!

!
Click!OK.!

! 19!
 !
Again,!just!click!next.

! 20!
Now!at!the!summary!screen!click!on!Setup.!

!
Once!the!setup!is!done!click!on!Finish.

!
!

! 21!
Now!we!start!the!Domino!server!again.!

!
I!suggest!to!have!the!Domino!Server!always!started!as!a!Windows!service!as!system!startup,!as!we!
will!need!it!whenever!we!start!WebSphere,!IBM!Connections!and!IBM!!Docs.!Then!click!OK.!

!
Optional:!Since!the!Domino!server!is!started!as!a!system!service!we!cannot!see!if!it!working!and!what!
is!doing!at!the!moment.!If!you!would!like!to!use!the!console!and!see!the!current!activity!of!the!server!
start!the!IBM!Domino!Console:!

! 22!
 !

!
Once!you’re!done!you!can!just!close!the!console.!It!will!not!stop!or!shutdown!the!Domino!server.!

! 23!
Now!we!need!to!create!some!users!and!configure!some!setting!in!the!Domino!Server.!To!do!so!please!
start!the!IBM!Domino!Admin!Client:!

!
Since!this!is!the!first!start,!we!will!need!to!configure!the!Notes!Admin!client.!Click!next.!

! 24!
Enter!Administrator!as!your!name!and!the!Domino!Server!name!you!chose.!If!you!used!the!same!as!in!
my!instructions!and!screenshots!it!will!be!ics!.!Now!click!next.

!
Now!enter!Passw0rd!and!click!Log!In!(or!use!the!password!you!chose).!

!
We!do!not!have!Sametime!installed!and!therefore!unselect!“Setup!instant!messaging”!and!click!next.!

! 25!
 !
On!the!next!screen!just!click!Finish.!

!
!

With!clicking!OK!the!Notes!Admin!client!is!set!up.!

! 26!
You!now!will!be!greeted!by!an!information!screen.!Select!“Don’t!show!this!again”!and!then!close!this!
welcome!screen.

! 27!
Now!on!the!People!&!Groups!Section!click!on!People.

!
On!the!right!side!click!on!the!Triangle!next!to!people!to!open!more!options.

! 28!
Now!click!on!Register!to!create!some!users!to!administer!and!use!IBM!Connections!and!IBM!Docs!
with.

!
Now!click!on!Certifier!ID!and!select!it.!You!will!find!the!ID!File!in!C:\IBM\Domino\data\cert.id!if!you!
followed!the!screenshots.!

! 29!
 !

! 30!
 !
Now!click!OK.!

! 31!
The!Passw0rd!for!the!Certifier!is!Passw0rd,!if!you!did!not!choose!a!different!one!earlier!on.

!
Now!we!register!the!users.!Select!Advanced!to!have!some!more!options.!

! 32!
Enter!Firstname,!Last!Name!and!a!password!(I!always!choose!Passw0rd!for!this!environment).!Then!
click!on!Password!Options.

!
Now!lower!the!Password!Quality!Scale!(do!this!only,!if!this!is!a!test!environment)!and!select!Set!
internet!password.!Now!the!Notes!password!will!also!be!used!to!set!the!internet!password.!Not!
setting!this!will!result!in!users!being!unable!to!log!in!into!IBM!Connections.

! 33!
 !
In!the!Address!settings!you!can!change!the!email!address!to!a!different!value.

! 34!
Optional!you!can!also!have!the!ID!file!for!the!user!stored!locally.

! 35!
Now!click!on!the!green!check!mark!to!have!the!user!added!to!the!list!of!people!to!create!and!register.

!
!

! 36!
Click!on!Basics!to!create!the!next!user.!

!
Create!some!more!users.!Important:!Also!create!two!more!users:!Cognos!Admin!and!Filenet!Admin.!
They!automatically!should!have!the!short!names!cadmin!and!fadmin.!I!suggest!to!give!them!the!
password!Passw0rd,!if!you!want!to!follow!the!instructions.!Otherwise!write!them!down,!as!they!will!
be!needed!later.!

! 37!
 !
!

Once!you!are!done!click!on!Register!All!and!click!OK!on!the!following!popZup.

! 38!
 !
You!can!now!close!the!user!creation!screen!by!clicking!on!Done.

!
!

! 39!
By!default!users!can!only!log!in!with!limited!variations!in!their!name.!!We!want!them!to!be!able!to!log!
in!with!their!name,!short!name!and!emailZaddress!alike,!therefore!we!need!to!change!a!security!
setting,!which!prevents!users!from!doing!this.!To!do!so,!click!on!the!Configuration!tab.

!
Now!open!the!Server!section!on!the!left!side!and!click!on!Current!Server!Document.

! 40!
In!there!select!the!Security!tab.

!
Now!click!on!Edit!Server.

! 41!
Now!search!for!the!Section!“Internet!Access”!and!change!the!setting!for!Internet!Authentication!to!
More!name!variations!with!lower!security.

! 42!
Then!click!on!Save!&!Close

!
With!that!we!can!close!the!Domino!Administration!client.

! 43!
Installation!of!IBM!DB2!
!

In!the!next!step!we!are!going!to!install!IBM!DB2.!DB2!will!be!used!to!store!information!and!user!data!
from!IBM!Connections!and!IBM!Docs.!There!is!no!need!to!install!DB2!10!first!and!then!the!Fixpack.!
You!can!install!the!Fixpack!right!away,!as!it!also!contains!all!basic!packages.!

Now!start!the!setup!program.!

!
Click!on!Install!a!Product.!

!
!

! 44!
Now!click!on!Install!New!underneath!the!DB2!Enterprise!Server!Edition!Version!10.1!Fix!!Pack!4!
section.!This!will!start!the!installer.!

!
Click!Next.

! 45!
Accept!the!license!agreement!and!click!next.

!
Click!next.

! 46!
Again,!click!next.

!
Remove!the!Program!Files!part.

!
!

! 47!
Then!click!next.!

!
Again!change!the!path.

!
Click!Next.!

! 48!
 !
We!use!db2admin!as!the!Admin!user!for!DB2!and!choose!the!password!Passw0rd.!

!
Click!Next.!

! 49!
 !
We!do!not!want!to!setup!notifications,!therefore!unselect!it!and!click!next.

! 50!
 !
The!defaults!are!fine,!therefore!click!next.

! 51!
Now!with!clicking!Finish!we!can!start!the!installation.!This!will!take!a!few!moments.

!
After!the!installation!click!Next.!

!
!

! 52!
And!now!Finish.!

!
Now!we!need!to!add!the!license!file.!Otherwise!DB2!will!stop!working!after!90!days.!The!license!is!
provided!as!part!of!IBM!Connections,!but!needs!to!be!downloaded!together!with!all!other!IBM!
Connections!packages.!In!my!case!the!file!is!under!C:\Install\Connections5.0\Db2\ese_o\license!.!

!
!

! 53!
From!there!we!start!the!following!command!to!register!the!license:!db2licm!–a!db2ese_o.lic!!

!
You!will!then!see!that!the!license!has!been!added!successfully.!

!
Now!we!will!create!a!local!user!with!limited!access!to!the!Connections!databases.!While!we!can!use!
the!db2admin!for!that,!it!is!highly!recommended!to!use!a!user!without!full!admin!rights.!To!do!so,!
right!click!on!the!Computer!icon!on!the!desktop!and!click!on!!Manage.!

! 54!
The!open!Configuration!in!the!left!pane!and!click!on!Local!Users!and!Groups,!and!then!double!click!on!
Users.!

! !
Now!do!a!right!click!in!the!middle!pane!and!select!New!User..!

!
!

! 55!
Name!the!user!lcuser!and!enter!a!full!name!and!description.!For!this!installation!I!suggest!using!the!
password!Passw0rd.!Select!User!cannot!change!password!and,!this!very!important,!Password!never!
expires.!If!you!do!not!set!this,!windows!policies!may!disable!the!password!if!it!is!not!changed!after!a!
certain!amount!of!time!–!with!the!result!of!IBM!Connections!not!working!anymore,!as!it!cannot!
access!its!databases.!The!click!Create.!

!
Now!close!this!window!by!clicking!Close.!

!
!

! 56!
Next!we!need!to!add!this!user!to!the!DB2USERS!group.!Double!click!on!Local!Users!and!Groups!in!the!
left!pane!and!then!click!on!Groups.!In!the!middle!pane!double!click!now!on!DB2USERS.!

!
This!brings!up!the!group!membership!panel.!Click!on!Add..!

! 57!
Now!type!lcuser!and!then!click!on!Check!Names.

!
The!user!should!be!found.!Now!click!OK!to!add!it!to!the!group.!

!
Last!but!not!least!click!okay!to!close!the!group!membership!panel.!

!
!

! 58!
Installation!and!configuration!of!the!WebSphere!Application!Server!
!

IBM!Connections!as!well!as!IBM!Docs!run!as!applications!within!the!IBM!WebSphere!Application!
Server!(WAS).!To!install!both!solutions!we!will!need!to!install!WAS!as!a!Network!Deployment!with!a!
Deployment!Manager!as!well!as!a!first!Application!Server!Node.!

To!install!WAS!we!first!need!to!install!the!IBM!Installation!Manager,!which!handles!all!packages!that!
need!to!be!installed.!You!can!either!download!it!separately!or!use!the!one!that!comes!as!part!of!the!
IBM!Connections!package.!There!you!can!find!it!in!the!ConnectionsInstallPackage\IM\windows!
folder.!!

Better!would!downloading!a!current!version!of!the!Installation!Manager,!though!(such!as!1.8.1).!

Start!the!install!program.!!

!
!

! 59!
!

Click!next.!

!
Accept!the!terms!and!conditions!and!click!next.!

!
!

! 60!
!

Remove!the!Program!Path!part!of!the!path!and!click!next.!

!
!

! 61!
!

Now!click!Install.!

!
Now!click!on!Restart!Installation!Manager!to!start!the!installation!of!WAS!8.5.5!

!
!

! 62!
!

Now!we!need!to!add!the!WAS!8.5.5!installation!repositories!as!well!as!the!supplemental!installation!
repositories!to!the!installer.!The!supplemental!contains!for!example!the!IBM!HTTP!Server!as!well!as!
the!WebServer!Plugin!for!configuring!the!IBM!HTTP!Server!from!WAS.!

Click!on!File,!then!preferences.!

!
Now!deselect!the!already!existing!repository.!

!
!

! 63!
!

Next!you!click!on!Add!repository..!

!
..!and!click!on!browse..!

!
…!and!select!the!repository.config!from!your!WAS!installation!folder.!Now!click!Open.!

! 64!
 !
Next!you!click!OK.!

!
Now!we!add!the!repository!for!the!WAS!Supplementals.!Click!on!Add!Repository!again…!

!
..!and!then!browse!..!

! 65!
 !
..!and!navigate!to!the!repository.config!from!your!WAS!Supplemental!install!directory.

!
Then!click!OK.!

!
!

! 66!
Now!we!also!add!the!repositories!for!the!Fixpacks!for!WAS!and!the!WAS!Supplementals!the!same!
way!as!we!did!before.!You!should!then!have!four!repositories!in!your!list.!Click!OK!to!continue.!

!
!

Now!click!on!Install.!

!
!

! 67!
!

The!installer!will!now!ask!you,!which!Software!you!would!like!to!install.!Select!the!IBM!HTTP!Server,!
IBM!WebSphere!Application!Server!Network!Deployment,!Web!Server!Plugin!as!well!as!the!
WebSphere!Customization!Toolbox.!!Then!click!Next.!

!
Now!accept!the!license!agreements.!

!
!

! 68!
!

Remove!the!Program!Files!part!of!the!path!and!click!Next.!

!
!

! 69!
Attention!!On!this!screen!you!will!need!to!select!each!component!after!the!other!and!remove!the!
Program!Files!part!in!each!of!the!parts.!After!you!did!this!4!times,!click!Next.!

! 70!
 !

!
!

! 71!
On!the!next!screen!click!on!Next.!I!do!not!suggest!selecting!other!languages!packages!then!English,!as!
this!may!trigger!the!log!files!to!be!written!in!a!language!other!than!English.!As!IBM!Connections!and!
IBM!Docs!a!perfect!solutions,!you!will!never!have!to!provide!log!files!to!the!Support!team.!But!in!the!
unlikely!case!of!this!happening,!having!the!log!files!in!Hungarian!for!example!does!not!make!the!job!
for!the!Support!team!easier.!;Z)!

!
All!packages!should!be!selected.!Click!Next.!

!
!

! 72!
Now!the!installer!wants!to!get!some!information!for!the!IBM!HTTP!Server.!Make!sure,!that!the!screen!
is!set!as!in!the!screenshot!below!and!click!Next.!

!
At!the!summary!screen!click!Install.!The!installation!will!start!now.!Depending!on!the!machine!and!
HDD!speed!the!installation!can!take!a!few!minutes.!

! 73!
Once!the!installation!has!finished!successfully!select!the!Profile!Management!Tool!and!click!Finish!to!
close!the!installer.!

!
!

So!far!we!have!just!installed!an!empty!hull.!We!now!need!to!create!the!Deployment!Manager!as!well!
as!the!first!node.!For!that!we!click!Create…!

!
!

! 74!
Then!select!Cell!(deployment!manager!and!a!federated!application!server)!and!click!Next.!

!
!

Choose!Typical!profile!creation!and!click!Next.!

! 75!
At!the!next!screen!choose!wasadmin!for!the!user!name!and!to!follow!this!guide!I!suggest!choosing!
Passw0rd!as!password.!Then!click!Next.!

!
!

At!the!summary!screen!click!Create.!This!may!take!a!few!moments.!

! 76!
 !
Once!it!is!done!deselect!the!Launch!of!the!First!steps!console!and!click!on!Finish.!

! 77!
 !
We!will!later!use!it!again!to!create!another!Applications!server!for!Cognos.!Now!close!the!application.!

!
!

! 78!
Now!start!the!WebSphere!Customization!Toolbox!und!Start!/!All!Programs!/!IBM!WebSphere!/!
WebSphere!Customization!Toolbox!V8.5!

On!the!new!screen!click!on!Add..!

!
!

Now!choose!a!name!like!webserver1!and!browse!to!the!location!where!the!Plugin!was!installed!and!
select!it!(C:\IBM\WebSphere\PlugIns!)!and!click!Finish.!

! 79!
 !

!
Now!we!need!to!create!the!plugZin!configuration.!To!do!so!click!on!Create..!

! 80!
 !
Now!choose!the!IBM!HTTP!Server!V8.5!and!click!Next.!

!
!

Point!to!the!folder!where!the!http.conf!is!located.!If!you!followed!the!guide!you!will!only!need!to!
remove!the!Program!Files!part!of!the!path!and!then!click!Next.!

! 81!
 !

!
!

The!next!screens!will!configure!the!IBM!HTTP!Server!Administration!Server.!It!allows!you!to!configure!
and!start!/!restart!the!HTTP!Server!remotely!using!the!WAS!Web!interface.!The!port!8008!should!be!

! 82!
fine.!Now!enter!a!HTTP!Admin!as!well!as!a!password.!For!our!environment!I!suggest!using!wasadmin!
for!the!user!and!Passw0rd!for!the!password.!Then!click!Next.!

!
The!admin!task!should!run!as!a!windows!service!and!should!be!logged!on!as!a!local!system!account.!
For!our!environment!the!Startup!type!Automatic!is!good,!too.!For!security!reasons!this!should!be!set!
to!manual!in!production!environments.!

!
!

! 83!
Now!the!Web!Server!needs!a!name.!Use!webserver1!and!click!Next.!

!
On!the!next!screen!select!(Local),!as!we!have!everything!installed!on!a!single!server.!Browse!to!
C:\IBM\WebSphere\AppServer!and!select!it.!Then!click!on!Next.!

! 84!
 !

!
!

! 85!
From!the!Dropdown!menu!make!sure!that!AppSrv01!is!selected,!not!the!Deployment!Manager!
(Dmgr01).!Then!click!Next.!

!
You!now!get!another!summary!screen.!Click!Configure!to!start!the!configuration.!

!
!

! 86!
Once!the!configuration!is!finished!you!should!see!a!green!Success.!Click!Finish!to!close!the!panel.!

!
You!can!also!quit!the!Customization!Tool!now.!

!
!

! 87!
Now!we!need!to!start!the!Deployment!Manager!as!well!as!the!Nodeagent!to!configure!the!security!
details!for!our!WebSphere!environment.!Start!the!Services!panel!from!Start!/!Administrative!Tools!/!
Services.!

!
Then!start!the!IBM!WebSphere!AppServer!service.!This!will!start!the!Deployment!Manager.!

!
Next!we!start!a!Command!Prompt!to!start!the!nodeagent.!

! 88!
Go!to!C:\IBM\WebSphere\AppServer\profiles\AppSrv01\bin!and!start!the!startNode.bat!command.!

!
!

! 89!
Once!the!you!get!the!message!“Server!nodeagent!open!for!eZbusiness”!start!the!WebSphere!
Administrative!console.!

!
The!browser!will!now!open!and!present!you!with!a!warning!about!an!untrusted!SSL!certificate.!Since!
WAS!uses!a!selfsigned!certificate!in!our!environment!this!is!to!be!expected.!Open!the!I!Understand!
the!Risk!section!and!click!on!Add!Exception..!(The!error!message!and!wording!may!be!different!
depending!on!the!default!browser!on!your!system.!The!example!shown!is!from!Firefox.)!

!
!

! 90!
Now!click!on!Confirm!Security!Exception!on!the!following!screen.!

!
Now!the!WebSphere!Login!screen!should!appear.!Log!in!as!wasadmin!using!Passw0rd!as!password.!

!
!

! 91!
On!the!left!hand!click!on!System!administration.!

!
Now!click!on!Console!preferences.

!
Now!select!Synchronize!changes!with!Nodes!and!click!Apply.!This!will!ensure,!that!all!changes!made!
are!automatically!synched!down!to!all!nodes!(assuming,!that!the!nodeagents!are!running).!

!
!

! 92!
Next!click!on!Security!on!the!left!side,!followed!by!Global!security.!

!
On!the!right!side!click!now!Web!and!SIP!security!and!then!Single!signZon!(SSO).!Here!we!will!set!the!
SSO!settings!for!our!environment.!

!
!

! 93!
For!the!domain!name!choose!.ibmdemo.com!(with!a!leading!Dot)!and!select!Interoperability!mode.!
For!the!LTPA!V1!cookie!name!use!LtpaToken!and!for!LTPA!V2!type!LtpaToken2!(spelled!exactly!like!
that).!Then!click!OK.!

!
Now!click!on!Configure!at!the!bottom!of!the!middle!pane.!

!
For!single!sign!on!with!other!servers!such!as!Domino!we!need!to!change!the!realm!name.!SSO!with!
Domino!will!be!used!for!example!for!integrating!Social!Mail!(not!part!of!this!installation!guide,!
though).!

!
!

! 94!
The!realm!name!must!be!the!hostname!of!the!LDAP!server!including!the!port.!In!our!case!type:!

Ics.ibmdemo.com:389!then!click!Apply.!

!
You!may!need!to!reZset!the!wasadmin!password:!Choose!Passw0rd!again!and!click!OK.!

!
Next!click!on!Add!repositories!(LDAP,!custom,!etc.)..!

!
!

! 95!
From!the!New!Repository!drop!down!menu!select!LDAP!repository.!

!
In!the!Repository!identifier!type!a!name!for!the!Repository.!It!can!be!any!name.!Choose!IBM!Lotus!
Domino!as!the!Directory!Type.!

!
In!the!primary!host!name!type!the!name!of!the!host!name!of!the!LDAP.!In!our!case:!ics.ibmdemo.com!

!
!

! 96!
The!bind!user!is!the!Domino!Administrator.!Therefore!enter!Administrator!and!Passw0rd!.!In!the!
Federated!repository!properties!for!login!you!can!add!other!means!of!logging!in!aside!from!from!the!
uid!/!short!name,!such!as!email!for!the!email!address.!Just!make!sure!to!let!uid!stand!in!the!first!
place,!as!this!is!needed!for!Filenet!to!work!without!further!customizing.!

!
!

Then!click!okay.!

!
In!the!next!screen!enter!root!in!the!Unique!distinguished!name!of!the!base!and!lock!OK.!

!
Then!click!OK!again.!

! 97!
On!the!main!security!page!set!the!check!mark!at!Enable!application!security!and!click!on!apply.!

!
Now!we!click!Save!at!the!top!of!the!page!to!write!the!changes!in!the!WAS!configuration.!

!
!

! 98!
The!changes!will!now!be!propagated!to!all!attached!nodes.!Once!you!see!that!the!synchronization!is!
complete!click!OK.!

!
Now!is!a!very!good!time!to!reboot.!Please!do!so.!

Once!the!machine!is!back!up!running!everything!we!need!should!be!started!automatically.!The!only!
thing!not!started!as!a!service,!yet,!is!the!nodeagent.!We!will!add!the!nodeagents!as!services!at!the!
end!of!the!installation.!Right!now!we!don’t!want!the!nodeagent!to!be!running,!though.!To!test!if!our!
WAS!configuration!against!the!LDAP!works!we!start!the!Administrative!console!again..!

!
!

! 99!
..!log!in!to!the!browser!window…!

!
..!and!click!on!Users!and!Groups..!

!
..!followed!by!Manage!Users!…!

!
!

! 100!
If!we!did!everything!right!we!should!now!see!the!users!we!have!in!our!LDAP.!

!
!

! 101!
Installation!of!the!IBM!Tivoli!Directory!Integrator!
!

To!import!the!user!data!from!the!LDAP!to!our!DB2!we!need!the!help!of!a!tool!called!IBM!Tivoli!
Directory!Integrator.!In!combination!with!the!Population!Wizard!it!will!populate!all!users!from!the!
LDAP!into!the!People!DB!in!DB2.!

To!start!the!installation!start!the!Launchpad.!

!
Then!click!on!Install!IBM!Tivoli!Directory!Integrator.!

!
!

! 102!
Then!click!on!Tivoli!Directory!Integrator!7.1.1!Installer.!

!
Choose!a!language!of!your!liking!and!click!OK.!

!
!

! 103!
Click!Next.!

!
Click!Next.!

!
!

! 104!
Accept!the!license!agreement!and!click!Next.!

!
Remove!the!Program!Files!part!of!the!path!and!click!Next.!

!
!

! 105!
Choose!a!Typical!installation!and!click!Next.!

!
Make!sure!to!select!Do!not!specify!–!use!current!working!directory!at!startup!time!,!then!click!Next.!

! 106!
 !
Click!Next.!

!
Click!Next.!

! 107!
Click!Next.!

!
Click!Next.!

!
At!the!summary!screen!click!Install.!

! 108!
Once!the!installation!has!finished!click!Done.

!
!

Now!we!need!to!apply!Fixpack!3.!Copy!the!TDIZ7.1.1ZFP0003.zip!and!the!UpdateInstaller.jar!files!from!
the!Fixpack!Install!Files!to!C:\IBM\TDI\V7.1.1\maintenance!.!

!
!

! 109!
Now!we!need!to!open!a!command!prompt!and!run!the!following!command:!!!

applyUpdates.bat!Zupdate!C:\IBM\TDI\V7.1.1\maintenance\TDIZ7.1.1ZFP0003.zip!

!
!

After!some!minutes!you!should!be!back!at!the!prompt.!!You!can!now!close!the!command!prompt.!

!
!

! 110!
IBM!Connections!Database!creation!and!user!population!
!

In!the!next!step!we!need!to!create!the!required!databases!and!fill!the!People!DB!with!the!user!data!
from!the!LDAP.!We!do!this!with!the!provided!Connections!Wizards.!!

Start!the!dbWizard.!

!
Click!Next!on!the!Welcome!screen.!

! 111!
!

Select!Create,!as!we!want!to!create!the!databases.!

!
Now!select!DB2!and!point!to!the!DB2!installation!location,!if!it!not!filled!out!automatically.!Click!Next.!

!
!

! 112!
!

Make!sure!all!databases!are!selected.!Click!Next.!

!
On!the!next!screen!click!Create.!

!
!

! 113!
!

The!following!screen!will!show!the!commands!the!DB!creation!wizard!will!run.!Click!execute!to!start!
the!creation.!

!
Now!it!is!time!to!be!patient,!as!the!database!creation!can!take!some!time.!This!can!be!anything!
between!5!minutes!and!20,!depending!on!the!speed!of!the!system.!

!
!

! 114!
!

At!the!end!the!database!creation!should!be!successful.!Click!Finish!to!close!the!wizard.!

!
Now!we!need!to!start!the!population!Wizard!to!import!the!user!data!to!the!DB2.!

!
!

! 115!
!

Click!Next!on!the!Welcome!screen.!

!
Enter!the!correct!path!to!the!TDI.!If!you!followed!the!instructions!you!should!only!need!to!remove!
the!Program!Files!part!of!the!path.!Click!Next.!

! 116!
 !
Choose!the!correct!database!type.!In!our!case:!DB2!

!
!

! 117!
Now!we!need!to!fill!out!the!host!name,!the!JDBC!driver!library!path!as!well!as!the!lcuser!password.!!In!
my!environment!the!hostname!is!ics.ibmdemo.com!,!the!JDBC!path!is!C:\IBM\SQLLIB\java!and!the!
password!of!lcuser!is!Passw0rd.!Click!Next.!

!
Now!we!need!to!enter!the!hostname!and!port!of!the!LDAP!Server.!In!this!case:!ics.ibmdemo.com!
with!port!389!.!!Click!Next.!

!
!

! 118!
The!LDAP!bind!user!is!Administrator!in!our!case!and!the!password!is!Passw0rd.!Click!next.!

!
The!search!base!in!our!environment!it!o=ibmdemo!.!The!search!filter!is!correct!and!works!in!most!
cases.!Click!Next.!

!
!

! 119!
In!the!profiles!database!mapping!we!can!map!the!fields!from!the!LDAP!to!the!fields!in!the!DB2!/!
Connections.!For!our!test!environment!the!default!is!fine.!Click!Next.!

!
Click!Next!on!the!following!panel.!

!
!

! 120!
Now!click!Configure!to!start!the!population.!

!
You!should!see!that!the!user!import!was!successful.!Then!click!Finish.!

!
!

Now!that!we!are!done!with!the!prerequisites!now!would!be!a!good!time!for!a!snapshot!/!backup.!

! 121!
Installation!of!IBM!Connections!5.0!
!

So!far!we!only!prepared!the!prerequisites!for!IBM!Connections.!You!will!notice!in!real!world!
installations!that!this!will!take!the!major!part!of!the!installation!time,!as!usually!different!
departments!will!need!to!be!involved.!

Now!we!start!the!IBM!Connections!Launchpad.!

! 122!
Click!on!Install!IBM!Connections!5.0.0.

!
Then!click!on!Start!the!IBM!Connections!5.0.0!installation!wizard.!

!
!

! 123!
Click!Next.!

!
Accept!the!license!agreement.!

!
!

! 124!
Remove!the!Program!Files!from!the!path!and!click!Next.!

!
!

! 125!
Scroll!down!and!also!select!the!AddZon!Features.!This!enables!the!installation!of!Filenet.!Keep!in!
mind,!that!the!normal!license!does!not!cover!Filenet,!unless!you!have!acquired!the!IBM!Connections!
Content!Manager!edition.!Click!Next.!

!
!

! 126!
Now!we!define!the!settings!for!the!WebSphere!Application!Server!Deployment!Manager.!Browse!to!
C:\IBM\WebSphere\AppServer!for!the!Installation!location!and!choose!Dmgr01!as!Deployment!
Manager!Profile.!The!hostname!in!our!case!is!ics.ibmdemo.com.!Then!you!need!to!enter!the!
wasadmin!with!Passw0rd!as!the!Administrator!data.!!After!that!click!on!Validate.!The!installer!will!
now!verify!the!data!supplied.!You!cannot!click!Next!until!that!verification!was!successful.!Click!Next!
once!you!got!the!successful!message.!

! 127!
 !

!
!

! 128!
The!next!panel!will!cover!the!installation!of!Filenet.!We!will!create!a!New!deployment.!The!Filenet!
user!ID!we!created!is!fadmin!with!Passw0rd!as!password.!Last!you!need!to!provide!the!location!of!the!
install!files!and!fixpacks.!!In!my!demo!environment!it!is!C:\Install\Connections5.0\FileNet!.!Then!click!
validate!followed!by!Next!after!the!successful!validation.!

! 129!
 !

! 130!
Now!we!need!to!select!the!size!of!the!deployment.!Normally!I!do!not!suggest!using!a!small!
deployment.!But!since!we!are!very!constrained!on!resources!on!a!single!VM,!we!choose!it.!This!will!
install!all!component!in!a!single!Cluster.!Choose!a!name!for!the!Cluster!such!as!ConnectionsCluster.!
Then!click!Next.!

!
Now!we!need!to!provide!the!information!regarding!the!database.!!We!have!all!databases!in!the!same!
database!instance.!Our!Database!Type!is!DB2.!!

! 131!
Now!enter!the!hostname!of!the!databaseZserver.!In!my!case!it!is!ics.ibmdemo.com.!Next!we!need!to!
provide!the!location!of!the!JDBC!driver.!Since!we!have!DB2!installed!on!the!same!machine!you!can!
find!them!in!C:\IBM\SQLLIB\java!.!

!
Then!select!that!we!Use!the!same!password!for!all!applications.!When!using!the!Database!Creation!
Wizard!the!databases!will!all!be!accessed!by!the!lcuser.!Enter!the!password!chosen.!In!our!case:!
Passw0rd.!Then!click!Validate.!The!installer!will!now!try!to!access!each!of!the!databases.!Once!
successful!click!Next.!

! 132!
 !

! 133!
 !
The!next!panel!is!about!Cognos.!The!good!news!is,!that!the!process!of!installing!it!has!been!
completely!redesigned!and!makes!it!much!easier.!As!the!integration!will!take!place!after!the!
installation!of!IBM!Connections!via!a!Wizard!we!choose!Do!later.!Then!click!Next.!

! 134!
 !
Now!we!define,!where!the!shared!directory!for!IBM!Connections!data!will!be.!Remove!the!Program!
Files!path!parts!and!click!Validate!followed!by!Next.!

! 135!
 !

! 136!
 !
The!last!information!the!installer!needs!are!the!SMTP!notification!details.!For!our!environment!we!
Enable!Notifications!only!and!use!a!WebSphere!Java!Mail!Session.!The!hostname!of!our!SMTP!
messaging!server!is!ics.ibmdemo.com.!Click!Next.!

! 137!
This!is!the!final!summary!screen!before!the!installation.!Click!on!Install.

!
Now!it!is!a!good!time!to!grab!a!coffee,!take!a!nap!or!read!some!emails.!;)!The!installation!will!take!at!
least!60!minutes!(this!is!the!fastest!I!have!seen,!yet),!but!depending!on!HDD!and!computer!speed!this!
can!take!up!even!two!hours.!Before!installing!you!should!check!if!you!have!a!Antivirus!with!onZaccess!
scan!running.!If!so,!disable!it!if!possible.!I’ve!had!installations!taking!longer!than!8!hours!due!to!this.!

!
!

! 138!
Once!the!installation!is!done!check!that!all!components!are!reported!as!installed!successfully.!Then!
click!Finish.!

!
!

! 139!
IBM!Connections!post!installation!configuration!steps!
!

Initial!deploying!of!all!applications!to!the!Connections!Cluster!
!

Once!the!installation!is!finished,!there!are!still!some!steps!to!do,!before!we!can!use!it.!First!we!want!
to!restart!the!WebSphere!Application!Server!Deployment!Manager.!

!
Search!for!IBM!WebSphere!Application!Server!in!the!Services!panel!and!restart!it.!

!
! 140!
 !
Once!that!is!done!start!a!Command!Prompt!to!start!the!nodeagent!of!the!cluster!IBM!Connections!
was!installed!in!to!deploy!all!applications.!

! 141!
 !

!
!

! 142!
Once!the!nodeagent!is!started!it!will!sync!with!the!Deployment!Manager!and!get!all!Connections!
applications!pushed!down.!This!may!take!a!while.!I!suggest!to!go!to!
C:\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\{CellName_here_icsCell01}\!with!a!
File!Explorer!and!wait!until!no!further!folders!are!added.!Additionally!start!the!TaskManager!and!
watch!for!the!CPU!performance!–!it!will!go!down,!once!this!process!is!finshed.!This!can!take!10!or!
more!minutes.!

! 143!
 !
Now!we!want!to!start!the!WebSphere!Administrative!console!to!start!the!Connections!cluster!to!
check!functionality.!

!
!

!
! 144!
Log!in!as!wasadmin!/!Passw0rd!

!
Now!go!to!Servers!/!Clusters!/!WebSphere!application!server!clusters.!

!
Then!select!the!checkmark!in!front!of!the!ConnectionsCluster!and!click!Start.!

!
!

! 145!
Start!the!server!will!take!some!time.!I!suggest!watching!the!Task!Manager!again!and!wait!for!the!CPU!
Usage!to!slow!down.!Ultimately!you’d!be!watching!the!logfiles!and!checking!for!the!words!“open!for!
eZbuiness”!.!

!
Now!we!need!to!log!out!of!the!webconsole,!as!due!to!the!Single!Sign!on!we’d!log!into!Connections!as!
wasadmin,!who!is!not!a!valid!user,!as!he!is!not!part!of!the!LDAP!and!therefore!was!not!populated!into!
the!People!DB.!

!
!

! 146!
In!a!new!tab!we!now!can!go!to!the!IBM!Connections!URL.!As!we!have!not!yet!configured!the!HTTP!
Server!we!still!need!to!work!with!the!WAS!Ports.!!Go!to:!http://ics.ibmdemo.com:9081/profiles!.!You!
should!be!able!to!test!everything!now.!Once!you!are!done!log!out!and!go!back!to!the!WebSphere!
Administration!Server!console!tab!and!log!in!as!wasadmin!.!!

!
If!everything!seems!to!work!(except!of!course!for!Cognos!and!Filenet,!as!we!do!not!have!them!
configured!/!installed,!yet),!this!would!be!a!good!time!for!another!Backup!/!SnapShot.!

!
! 147!
Configuring!WAS!to!use!the!IBM!HTTP!Server!
!

Back!in!the!WebConsole!go!to!System!Administration!/!Nodes!.!

!
Click!on!Add!Node.!

!
For!the!integration!of!the!HTTP!Server!we!need!a!Unmanaged!node.!Select!it!and!click!Next.!

!
!

! 148!
Name!the!Node!webserver1!and!enter!the!correct!hostname!for!your!environment,!such!as!
ics.ibmdemo.com!.!Then!click!OK.!

!
Click!Save!to!have!all!changes!stored!and!propagated.!

!
Click!OK!once!the!the!sync!is!done.!

!
!

! 149!
Now!we!are!going!to!add!the!IBM!HTTP!Server.!Go!to!Servers!/!Web!servers.!

!
Click!on!New…!

!
Select!the!webserver1!node!we!just!created!and!enter!a!server!name,!I!suggest!webserver1!and!click!
Next.!

!
!

! 150!
On!the!next!screen!click!Next.!

!
Now!we!enter!the!properties!of!the!web!server.!The!port!80!is!correct.!The!Web!Server!installation!is!
C:\IBM\HTTPServer!,!if!you!followed!this!installation!guide.!The!Plugin!directory!must!be!changed!to!
C:\IBM\WebSphere\Plugins!.!

The!Administration!port!8008!is!correct!and!if!you!followed!my!guide!the!username!and!password!for!
the!HTTP!Admin!are!wasadmin!and!Passw0rd!.!

Once!you!have!double!checked!the!entries!click!Next.!

!
Now!click!Finish!to!end!the!HTTP!Server!definition!wizard.

!
!

! 151!
Click!Save!to!save!and!propagate!the!changes.!

!
Now!we!need!to!Generate!the!PlugZin:!

!
!

! 152!
Once!it!has!been!generated!click!Propagate!PlugZins:!

!
Now!click!on!webserver1!.!

!
On!the!next!screen!click!on!PlugZIn!properties!on!the!right!side.!

!
!

! 153!
Now!click!on!Copy!to!Web!server!key!store!directory.!This!will!copy!the!WebSphere!SSL!keystore!to!
the!Webserver!so!the!HTTP!Server!is!able!to!trust!the!WAS!for!SSL.!

!
Then!click!OK…!

!
…!followed!by!another!OK!on!the!next!page.!

!
!

! 154!
Then!click!Save!again!and!wait!for!the!changes!to!be!synched.!

!
Now!select!the!checkmark!in!front!of!the!webserver1!and!stop!the!server.!Once!stopped,!the!round!
symbol!on!the!right!should!turn!red.!

!
Now!select!it!again!and!start!the!server.!Once!it!is!started!the!symbol!to!the!right!should!turn!green!
again.!

!
!

! 155!
In!the!steps!before!we!copied!the!WAS!SSL!keys!to!the!webserver.!Now!we!need!to!create!a!key!store!
with!a!selfZsigned!SSL!certificate!for!the!IBM!HTTP!server!for!communicating!with!the!endZuser!
browsers!as!well!as!back!to!the!WAS.!To!do!so!start!the!Key!Management!Utility!(also!called!ikeyman)!

!
Then!click!on!Key!Database!File!and!then!New…!

!
!

! 156!
The!key!database!type!must!be!CMS.!You!can!change!the!filename!but!I!suggest!you!leave!it!as!it!is.!I!
would!create!a!new!folder!underneath!C:\IBM\HTTPServer!called!Keys!and!have!the!keystore!created!
there:!

! 157!
 !

!
Give!the!Keystore!a!password.!The!standard!password!is!WebAS!(you!should!not!use!it!on!production!
environment,!as!this!is!widely!known,!but!for!this!test!environment!this!is!fine).!Also!select!Stash!
password!to!a!file.!Then!click!OK.!

!
!

! 158!
Now!that!we!have!created!the!keystore,!we!need!to!add!a!certificate.!Since!we!do!not!want!to!create!
a!real!one!we!click!on!New!SelfZSigned…!

!
Fill!in!at!least!the!Key!label!and!the!Common!Name.!I!suggest!to!prolong!the!time!this!certificate!is!
valid.!Then!click!OK.!

! 159!
The!certificate!is!saved!automatically,!so!you!can!just!close!the!program.

!
Now!we!need!to!configure!the!Webserver!to!use!SSL.!Edit!the!httpd.conf!in!C:\IBM\HTTPServer\conf\!
.!

!
!

! 160!
At!the!bottom!of!the!file!add!the!following:!

LoadModule ibm_ssl_module modules/mod_ibm_ssl.so

<IfModule mod_ibm_ssl.c>

Listen 0.0.0.0:443

<VirtualHost *:443>

ServerName ics.ibmdemo.com

#DocumentRoot C:\IBM\HTTPServer\htdocs

SSLEnable

</VirtualHost>

</IfModule>

SSLDisable

Keyfile "C:\IBM\HTTPServer\Keys\key.kdb"

SSLStashFile "C:\IBM\HTTPServer\Keys\key.sth"

! 161!
Then!save!the!file…

!
…!and!restart!the!webserver!in!the!web!admin!interface.!

!
! 162!
To!test!that!our!SSL!configuration!works!open!a!new!tab!in!the!browser!and!go!to:!
https//ics.ibmdemo.com!.!You!should!need!to!accept!the!certificate!and!then!see!the!webserver!
welcome!page.!

!
!

! 163!
 !
Now!we!need!to!import!the!HTTP!Server!SSL!key!into!the!WebSphere!key!store.!Go!back!to!web!
admin!console!and!go!to!Security!/!SSL!certificate!and!key!management.!

!
!

! 164!
On!the!right!side!click!on!Key!stores!and!certificates..!

!
..followed!by!clicking!on!CellDefaultTrustStore.!

!
!

! 165!
Now!click!on!Signer!certificates!on!the!right!side.!

!
Now!click!on!Retrieve!from!port!

!
Now!enter!the!Hostname!of!the!HTTP!Server!(ics.ibmdemo.com)!and!the!port!(443)!as!well!as!an!alias!
for!the!certificate.!Then!click!on!Retrieve!signer!information!followed!by!clicking!OK.!

! 166!
 !
Save!the!changes.!

!
!

! 167!
Now!we!need!to!define!how!the!HTTP!Server!handles!content.!To!so!edit!the!httpd.conf!again.!

!
Search!for!“LoadModule!deflate_module!modules/mod_deflate.so”!and!uncomment!the!line!by!
removing!the!#!at!the!beginning.!

!
We!do!the!same!with!the!line!“LoadModule!headers_module!modules/mod_headers.so“!
!

!
At!the!very!end!of!the!file!we!copy!the!following!lines:!
#Only the specified MIME types will be compressed.

AddOutputFilterByType DEFLATE application/atom+xml

AddOutputFilterByType DEFLATE application/atomcat+xml
AddOutputFilterByType DEFLATE application/javascript
AddOutputFilterByType DEFLATE application/json
AddOutputFilterByType DEFLATE application/octet-stream
AddOutputFilterByType DEFLATE application/x-javascript
AddOutputFilterByType DEFLATE application/xhtml+xml
AddOutputFilterByType DEFLATE application/xml
AddOutputFilterByType DEFLATE text/css
AddOutputFilterByType DEFLATE text/html
AddOutputFilterByType DEFLATE text/javascript
AddOutputFilterByType DEFLATE text/plain
AddOutputFilterByType DEFLATE text/xml
AddOutputFilterByType DEFLATE text/xsl
!

! 168!
# Ensures that images and executable binaries are not compressed
SetEnvIfNoCase Request_URI \\.(?:gif|jpe?g|png|exe)$ no-gzip dont-vary
!
# Ensure that proxies do not deliver the wrong content
Header append Vary User-Agent env=!dont-vary
!

!
Then!save!the!document.!

!
!

! 169!
Now!back!at!the!web!admin!console!restart!the!HTTP!Server.!

!
!

! 170!
Now!IBM!Connections!is!still!configured!to!use!the!WebSphere!Application!Server!ports.!To!change!
that!we!need!to!change!the!mapping.!Normally!you!need!to!check!out!the!file!using!the!wsadmin!
command,!but!we!take!the!shortcut!by!editing!the!file!directly.!Edit!the!LotusConnectionsZconfig.xml!
in!C:\IBM\WebSphere\AppServer\profiles\Dmgr01\config\cells\icsCells01\!.!!You!may!want!to!make!
a!copy!of!this!file!beforehand.!

!
Now!we!remove!all!WAS!ports.!In!our!Small!Deployment!we!only!have!Port!for!HTTP!and!one!for!
HTTPS.!Go!to!Replace!and!then!replace!:9081!with!nothing!and!do!replace!all.!

!
! 171!
 !
Then!do!the!same!with!port!number!:9444!.!

!
!

! 172!
Now!you!can!save!the!file.!

!
We!now!changed!the!configuration!stored!in!the!Deployment!Manager.!Since!we!did!the!change!
directly,!the!changes!will!not!be!noticed!by!the!Deployment!Manager!and!therefore!not!synched!
down!to!the!nodes.!If!you!would!start!Connections!now!the!node!would!still!have!the!old!file!and!
nothing!would!have!been!changed.!That’s!why!we!have!to!go!back!to!the!web!admin!console!and!do!
a!complete!sync!of!the!node:!

! 173!
 !
Wait!until!the!CPU!Usage!goes!down!again.!

!
Now!we!can!restart!the!Connections!cluster!again.!

!
! 174!
 !

!
Once!the!green!arrow!appears!log!out.!You!may!have!to!refresh!the!Status!once!in!a!while!to!see!the!
green!arrow!appear.!

!
Now!we!can!open!a!new!tab!in!Firefox!and!go!to!!ics.ibmdemo.com/profiles!.!IBM!!Connections!
should!load!now.!I!suggest!to!play!around!some!bit!to!make!sure!it!works.!

!
!

! 175!
Configuring!Filenet!
!

Now!we!need!configure!Filenet,!to!enable!the!libraries!in!Communities.!To!do!so!start!a!Command!
Prompt.!

!
Now!go!to!C:\IBM\Connections\addons\ccm\ccmDomainTool!

!
!

! 176!
There!run!the!createGCD.bat!batchfile.!

!
When!asked!enter!wasadmin!for!the!Deployment!Manager!admin:!

!
Now!enter!Passw0rd!for!the!password:!

!
!

! 177!
When!asked!if!you!want!to!regenerate!the!dminfo.properties!type!Y!and!hit!Enter!to!do!so.!Failing!to!
do!so!may!result!in!a!failed!installation,!if!some!wrong!data!is!in!this!file.!

!
When!asked!for!the!Groupname!just!hit!Enter.!

!
You!should!see!everything!being!done!successfully:!

!
!

! 178!
Now!we!need!to!create!the!ObjectStore.!Run!the!createObjectStore.bat!batchfile!to!start!the!process.!

!
Enter!wasadmin!when!asked!for!the!Dmgr!admin..!

!
..!and!Passw0rd!for!the!password.!

!
!

! 179!
Again!hit!Y!and!Enter!to!have!the!dminfo.properties!refreshed.!

!
Hit!enter!when!asked!for!the!group!name.!

!
You!will!then!see!some!Addons!being!installed!and!then!it!will!if!you!want!to!test!the!activity!stream:!
Just!hit!Enter!to!continue.!

!
!

!
! 180!
You!should!see!“Creating!Object!Store!finished.”!

!
!

Now!we!need!to!restart!both!of!the!Filenet!Applications.!In!the!WebSphere!Administration!Console!
go!to!!Applications!/!Application!Types!/!WebSphere!enterprise!applications!and!start!and!stop!the!
following!both!applications:!

!
!

Now!you!can!open!a!new!tab!in!the!browser!and!go!to!ics.ibmdemo.com/profiles!and!Log!In.!

!
You!may!have!to!accept!the!new!selfZsigned!certificate,!if!you!did!not!log!in!earlier.!

! 181!
 !

! 182!
 !

!
!

! 183!
Then!go!to!Communities..!

!
..and!create!a!new!Community.!

! 184!
 !
Then!click!on!Community!Actions!and!then!Add!Apps.!

!
Then!click!the!+!next!to!Library.!This!will!add!the!Filenet!Widget.!

!
!

! 185!
You!should!now!be!able!to!add!you!first!file.!Just!upload!any!file!to!test!if!it!works.!

!
! 186!
Installation!of!Cognos!
!

Now!we!need!to!install!and!configure!Cognos.!First!we!need!to!create!a!new!WebSphere!Application!
profile.!To!do!so,!start!the!Profile!Management!Tool.!

!
!

Now!click!Create..!

!
! 187!
Select!Application!Server!and!then!click!Next.!

!
As!we!have!a!Typical!profile!creation!click!Next.!

!
!

! 188!
You!must)choose!the!same!username!and!password!for!the!administrator!as!in!the!existing!
deployment,!otherwise!the!federation!of!the!WAS!into!the!cell!will!fail.!!So!use!wasadmin!and!
Passw0rd!for!this!guide.!Then!click!Next.!

!
Review!the!summary!screen!and!then!click!Create.!

!
!

! 189!
We!do!not!need!the!First!steps!console,!unselect!it!and!click!Finish!and!close!the!WebSphere!
Customization!Toolbox.!

!
!

! 190!
Now!we!start!the!newly!created!server.!Go!to!C:\IBM\WebSphere\AppServer\profiles\AppSrv02\bin!
and!run!startServer.bat!server1!.!

!
Then!go!to!the!Cognos!Windows!install!directory!and!start!the!install:!

!
!

! 191!
Click!Next.!

!
Accept!the!license!agreement!and!click!Next.!

!
!

! 192!
Change!the!path!to!C:\IBM\Cognos!and!then!click!Next.!

!
Make!sure!all!components!are!selected!except!for!the!secondary!BI!Server.!Then!click!Next.!

!
!

! 193!
Now!we!need!to!provide!the!information!about!WAS.!The!installation!location!is!
C:\IBM\WebSphere\AppServer!.!For!the!Local!node!profile!ensure!you!select!AppSrv02!and!the!
hostname!ics.ibmdemo.com!.!For!the!Administrator!ID!use!wasadmin!and!Passw0rd.!The!SOAP!port!
should!be!correct.!

!
Now!we!also!need!to!enter!the!data!of!the!Dmgr!we!deploy!the!AppSrv02!into.!Hostname!is!also!
ics.ibmdemo.com!with!the!SOAP!port!being!8879!by!default!and!the!Admin!user!also!being!wasadmin!
with!Passw0rd.!Then!click!Validate.!

! 194!
 !
If!the!Validation!was!successful!click!Next.!

!
It!is!now!asking!for!a!Web!Context!root.!You!can!choose!Cognos.!

!
!

! 195!
Now!Cognos!needs!to!know!how!to!access!the!two!databases!required.!Database!Type!is!DB2!and!
you!can!find!the!JDBC!driver!in!C:\IBM\SQLLIB\java,!as!we!are!on!the!same!server!where!DB2!is!
installed!on.!The!password!will!be!Passw0rd.!!For!the!name!of!the!Metrics!database!enter!Metrics.!
Then!click!validate.!

!
If!the!validation!was!successful!click!Next.!

!
!

! 196!
The!Cognos!installer!now!wants!to!know!the!Cognos!admin!which!is!cadmin!with!Passw0rd!as!
password.!

The!BI!Server!installer!can!be!found!in!C:\Install\Connections5.0\Cognos\BI\winx64h\issetup.exe!

!
For!the!PowerCubes!click!on!Browse!and!go!to!C:\IBM!and!create!a!folder!with!the!name!
PowerCubes.!

! 197!
 !

!
Then!click!Next.!

!
!

! 198!
Now!we!need!to!provide!the!location!of!the!Cognos!Transformer!install!file.!You!can!find!it!in!
C:\Install\Connections5.0\Cognos\Transformer\win32\issetup.exe!.!Then!click!Next.!

!
On!the!summary!screen!hit!Install.!

!
!

! 199!
A!while!later!you!will!see!the!success!screen.!Click!Finish!to!close!it.!

!
Now!we!need!to!copy!the!Websphere!keystore!again!to!the!IBM!HTTP!Server!since!a!new!SSL!
certificate!from!the!newly!added!WebSphere!server!has!been!added.!Go!to!the!web!administration!
console:!

! 200!
 !
Go!to!Servers!/!Server!Types!/!Web!servers..!

!
…!and!click!on!webserver1.!

!
!

! 201!
On!the!rights!side!click!on!PlugZin!properties.!

!
Now!click!Copy!to!Web!server!key!store!directory.!

!
Then!click!OK.!

! 202!
Now!click!Save!to!store!and!propagate!the!changes!done.!

!
Next!we!need!to!manually!run!the!task!to!create!the!PowerCubes,!as!it!only!runs!once!in!a!while!and!
we!don’t!want!to!wait!for!that!to!happen.!So!we!start!the!Windows!Task!Scheduler:!

!
!

! 203!
Click!on!Task!Scheduler!Library!on!the!left!and!then!right!click!the!MetricsCubeWeeklyRebuild!and!
click!Run.!

!
Now!it!is!a!good!idea!to!check!the!C:\IBM\CognosPowerCubes!folder!and!see!if!files!and!folders!are!
being!created.!

!
Once!no!changes!are!done!anymore!it!is!time!for!a!reboot.!

! 204!
Once!the!server!is!back!up!running!we!need!to!start!the!two!nodeagents!to!then!start!the!Application!
servers.!Open!a!command!prompt.!

!
Start!the!nodeagents!of!AppSrv01!and!AppSrv02:!

!
!

! 205!
Then!log!into!the!web!administration!console!…!

!
…!and!go!to!Servers!/!Clusters!/!WebSphere!application!server!clusters.!

! 206!
Now!we!start!the!CognosCluster.!!

!
Once!the!CPU!Usage!in!the!task!manager!idles!down!we!start!the!Connections!cluster.!

!
When!the!CPU!usage!has!idled!down!again!we!log!out!of!the!web!administration!console..!

!
…!and!log!into!Connections!using!cadmin!/!Passw0rd!in!a!new!browser!window.!

! 207!
 !
Now!we!click!on!Metrics!

!
Very!likely!you!will!have!no!available!data,!since!Connections!has!not!been!used,!yet.!You!can!try!to!
change!the!View!from!Last!4!weeks!to!Last!7!days,!as!the!Last!4!weeks!view!does!not!contain!the!
current!day.!

!
Once!done!log!out!again.!

!
With!this!we!are!done!installing!IBM!Connections!5.0!!Congratulations!!

! 208!
Before!we!start!to!install!IBM!Docs!we!should!switch!back!to!the!web!administration!console!and!
login!and!shut!down!the!CognosCluster!to!free!some!memory.!

!
!

! 209!
Installation!of!IBM!Docs!1.0.7!
!

First!we!need!to!create!two!shares!for!IBM!Docs.!We!create!them!in!C:\IBM!and!name!them!
DocsShare!and!ViewerShare.!!

!
!

! 210!
First!thing!we!need!to!install!is!Python.

!
We!can!install!it!for!all!users.!Click!Next.!

!
!

The!suggested!path!is!fine.!Click!Next.!

! 211!
 !
Make)sure)“Add)python.exe)to)Path”)is)selected!)Click!Next!again.!

!
And!now!click!Finish.!

!
!

! 212!
Check!if!the!Python!Path!variable!has!been!correctly!set:!

Right!click!on!Computer!on!the!Desktop!and!click!on!Properties.!

!
Then!click!on!Advanced!system!settings!..!

!
..!followed!by!Environment!Variables…!

! 213!
If!they!are!not!present!in!Path,!click!on!Edit.!

!
At!the!end!of!the!Variable!value!line!add!;C:\Python27!(pay!attention!to!the!leading!semicolon)!and!
click!OK.!

!
Click!OK!again!to!close!the!window.!

! 214!
Click!OK!for!one!more!time.!

!
!

Creating!the!IBM!Docs!database!
!

In!the!next!step!we!need!to!create!the!IBM!Docs!database.!!

To!do!so!we!first!need!to!unpack!the!Docs!component!:!../DocsInstallPack/native/DocsApp_1.0.7!

!
!

! 215!
Click!Extract:!

!
And!then!close!the!installer.!!Now!you!start!a!new!Command!Prompt.!

!
!

exit!

! 216!
Type!db2cmd!and!hit!enter!to!start!the!DB2!command!line!environment.!

!
In!the!newly!opened!window!navigate!to!the!newly!created!
directory../DocsInstallPack/native/DocsApp_1.0.7/setupDB!and!execute!the!created.bat!.!You!need!
to!be!patient,!it!may!appear!that!nothing!happens!for!a!few!minutes.!

!
!

Some!minutes!later!you!should!see!all!commands!have!been!completed!successfully.!Now!run!the!
updateDBSchema.bat!command.!

! 217!
 !
The!databases!have!been!created!with!access!rights!to!a!user!called!DocsUser.!As!we!want!to!use!the!
same!user!as!we!use!with!IBM!Connections,!we!need!to!grant!access!to!lcuser.!In!the!same!folder!edit!
appGrants.sql.!

!
!

! 218!
Replace!all!occurrences!of!DOCSUSER!with!LCUSER!and!save!the!document.!

!
Now!go!back!to!the!DB2!command!line!processor!and!run!the!following!command:!!

db2!–td@!Zf!appGrants.sql!

!
!

! 219!
You!should!see!all!command!being!run!successfully.!If!you!do!get!errors!make!sure!you!are!in!the!DB2!
command!line!processor!and!not!accidentally!back!in!the!Windows!Command!Line.!

!
!

Installation!of!IBM!Docs!1.0.7!
!

IBM!Docs!now!comes!with!a!new!graphical!installer!based!on!IBM!Installation!Manager.!This!will!
make!the!installation!much!easier!for!us.!

We!now!need!to!start!the!Installation!Manager.!

!
!

! 220!
Click!on!File!/!Preferences!

!
Deselect!all!existing!repositories!and!click!on!Add!Repository!

!
!

! 221!
Click!on!Browse..!

!
!

!and!go!to!../DocsInstallPackage/repository.config!and!click!Open!

! 222!
Now!click!OK.!

!
And!OK!again.!

!
!

! 223!
Now!we!click!on!Install.!

!
Select!IBM!Connections!Docs!and!click!Next!

!
!

! 224!
Accept!the!license!terms.!

!
The!default!directory!is!fine!so!click!Next.!

! 225!
As!we!have!installed!IBM!Connections!as!CCM,!meaning!together!with!Filenet!select!Connections!and!
Content!Manager.!Deselect!the!Docs!Proxy!Server,!as!it!is!only!needed,!when!you!have!more!than!
one!Docs!Server.!Click!Next.!

!
On!the!information!panel!click!Next.!

!
!

! 226!
Now!enter!the!wasadmin!and!corresponding!password!(in!our!case!wasadmin!/!Passw0rd)!and!click!
on!browse.!

!
Go!to!C:\IBM\WebSphere\AppServer\Profiles\AppSrv01!and!click!OK.!

!
!

! 227!
Now!click!validate.!

!
You!will!get!no!confirmation!pop!up.!Once!the!Next!button!becomes!available!click!it.!

!
!

! 228!
Now!we!need!to!map!the!Nodes!to!the!Applications.!Map!all!application!to!the!first!node!and!the!
Webserver!to!webserver1!by!first!selecting!the!nodename!and!then!the!“>>”!button!at!the!proper!
application.!

!
Now!we!need!to!scroll!down!and!click!on!validate.!

!
!

! 229!
Again!you!will!get!no!notification!popup!when!the!validation!is!done.!Click!on!Next!once!it!comes!
available.!

!
Now!we!need!to!supply!the!local!Admin!username!and!password.!This!is!necessary!since!it!is!a!
remote!deployment!from!the!Deployment!Manager.!It!just!happens!to!be!on!the!same!machine!in!
our!case.!Enter!Administrator!and!Passw0rd!in!all!instances.!Then!click!Validate.!

!
!

! 230!
Click!Next!once!it!comes!available.!

!
On!the!next!screen!enter!the!following!values:!

http://ics.ibmdemo.com/fncmis!

http://ics.ibmdemo.com/dm!

fadmin!

http://ics.ibmdemo.com/communities!

!
!

! 231!
We!have!no!chat!installed,!so!we!just!click!Next.!

!
On!the!DB2!Panel!enter!the!following!values!and!then!click!Next:!

Database!server:!ics.ibmdemo.com!

User!Name:!lcuser!

Password:!Passw0rd!

Database!product:!DB2!!

Database!name!:!CONCORD!

JDBC!driver!Library!path!:!C:\IBM\SQLLIB\java!!

!
! 232!
 !
The!following!panel!is!a!bit!confusing!when!installing!everything!locally.!Fill!it!out!as!follows!and!click!
Next:!

Switch!NFS!to!CIFS!for!both!Docs!and!Viewer.!For!each!of!the!two!folder!settings!use!the!same!ones:!

C:\IBM\DocsShare!and!C:\IBM\VieweShare!

!
!

! 233!
Now!it!wants!to!know!where!to!install!the!Conversion!Server!and!how!many!CPU!cores!to!use.!For!
the!path!choose!C:\IBM\Conversion!and!reduce!the!cores!to!2.!The!port!should!be!fine.!

!
Choose!C:\IBM\Docs!for!the!installation!target!for!the!Docs!component!and!click!Next.!

!
!

! 234!
On!the!next!Panel!we!don’t!need!to!do!anything!and!can!click!Next.!

!
Now!we!need!to!provide!the!directories!for!the!Extension!and!Daemon!installation.!

For!the!Extension!directory!browse!to!C:\IBM\Connections\data\shared\provision\webresources!.!

The!Daemon!should!be!installed!in!C:\IBM\Connections\data\shared\!.!

Click!Next.!

!
!

! 235!
Now!we!can!choose!whether!the!Web!and!Connections!server!should!be!restarted!during!the!
installation.!This!is!useful!when!installing!IBM!Connections!Docs!in!production!environments!because!
it!allows!you!to!do!the!Docs!installation!at!any!time!and!to!the!Restart!of!the!production!Connections!
environment!in!a!specific!maintenance!time!frame.!!Of!course!setting!both!to!No!will!also!decrease!
the!installation!time!a!lot,!since!the!Connections!Server!do!not!get!restarted!once!with!each!feature!
installed.!

Since!time!does!not!matter!we!choose!Yes!for!both.!Click!Next.!

!
Click!Next!on!the!configuration!file!overview!panel.!

!
!

! 236!
!

Now!you!click!on!Install!and!grab!a!coffee!or!two.!!

!
!

During!the!installation!two!black!windows!will!pop!up.!This!is!expected!(and!annoying,!as!they!pop!up!
every!few!minutes).!These!are!the!conversion!tasks!running.!At!the!end!of!the!installation!we!will!
alter!the!Task!Scheduler!to!have!them!started!hidden.!So!long!just!minimize!them!once!they!pop!up.!

In!the!end!you!should!see!the!following!screen:!

!
!

! 237!
Verifying!the!Docs!installation!!
!

Log!out!of!the!web!administration!console!(if!you’re!still!logged!in).!

!
And!go!to!http://ics.ibmdemo.com/files!

!
Log!In..!

!
!

! 238!
..!and!create!a!new!Spreadsheet!to!test!if!the!Docs!Editor!component!is!working..!

!
Click!OK!on!the!welcome!message.!

!
!

! 239!
This!tells!us,!that!the!Docs!Editor!works.!Now!enter!some!data!and!then!click!on!File!/!Publish!
Version.!

!
Enter!a!description!and!click!Publish.!

!
!

! 240!
This!message!shows!you,!that!the!version!has!been!published.!For!this!to!work!the!Conversion!Server!
needs!to!be!working!properly,!which!we!tested!and!proved!now.!

!
!

Now!we!close!the!Docs!tab!and!upload!a!new!file:!

! 241!
 !
Then!go!to!this!file..!

!
..!and!click!on!View!to!see!if!the!Conversion!Server!and!the!Viewer!are!working:!

!
The!Viewer!should!open!and!display!the!content!of!the!file:!

! 242!
 !
!

If!all!of!this!worked!then!your!IBM!Docs!environment!has!been!set!up!successfully!!!Now!there!are!
only!two!last!things!to!do:!Change!some!settings!in!the!Task!scheduled!in!the!Task!Scheduler!and!
create!Windows!tasks!for!the!two!nodeagents:!

Go!to!the!Windows!Task!Scheduler:!

!
Double!Click!on!the!kill_timeout!task.!

! 243!
 !
Change!it!to!run!whether!the!user!is!logged!on!or!not!and!select!Do!not!store!password.!Also!select!
hidden!and!then!OK.!

!
!

We!do!the!same!with!the!sym_monitor:!Double!click!it…!

! 244!
 !
Change!it!to!run!whether!the!user!is!logged!on!or!not!and!select!Do!not!store!password.!Also!select!
hidden!and!then!OK.!

!
From!the!next!reboot!on!the!two!back!windows!should!not!appear!anymore.!

! 245!
To!create!the!windows!service!for!the!first!node!agent!go!to!C:\IBM\WebSphere\AppServer\bin!and!
run!the!following!command:!

WASService.exe!Zadd!nodeagent_con_docs!Zservername!nodeagent!ZprofilePath!
"C:\IBM\WebSphere\AppServer\profiles\AppSrv01"!ZstopArgs!"Zuser!wasadmin!Zpassword!
Password"!Zuserid!Administrator!Zpassword!Passw0rd!ZstartType!automatic!

!
For!the!second!nodeagent!run!this!command:!

WASService.exe!Zadd!nodeagent_cognos!Zservername!nodeagent!ZprofilePath!
"C:\IBM\WebSphere\AppServer\profiles\AppSrv02"!ZstopArgs!"Zuser!wasadmin!Zpassword!
Password"!Zuserid!Administrator!Zpassword!Passw0rd!ZstartType!automatic!

! 246!
 !
!

With!that!all!nodeagents!are!started!automatically!at!reboot.!For!our!environment!we!will!not!set!the!
Connections,!Cognos!and!IBM!Docs!servers!to!start!automatically,!as!with!our!limited!resources!in!
this!AllZInZOneZVMware!it!is!wise!to!only!start!the!server!needed!each!time.!

I!hope!you!were!successful!in!installing!everything!!!If!you!have!any!comments!please!feel!free!to!
contact!me!!I!also!invite!you!to!join!the!IBM!Docs!community!on!Greenhouse!to!ask!questions,!check!
for!latest!versions!of!this!document!and!many!more!information:!

https://greenhouse.lotus.com/communities/service/html/communitystart?communityUuid=d887a5
6fZf41bZ4b8eZaa34Zd1e2cad4e6ea!

Thank!you!!

! 247!