Академический Документы
Профессиональный Документы
Культура Документы
0 for Windows
1. 2. 3. 4. 4.1. 4.2. 4.3. 4.4. 5. 6. 7. 8. 8.1. 8.2. 8.3. 8.4. 9. 9.1. 9.2. 10. 10.1. 10.2. 10.3. 10.4. 11. 11.1. 11.2. 11.3. 11.4. 11.5. 11.6. 11.7. 12. 13. 14. 14.1. 15. 15.1. 15.2.
INTRODUCTION PREAMBLE DISCLAIMER REQUIRED SOFTWARE Base required software Additional software required for Active Directory install Additional software required for Tivoli Directory install Additional software required for Profiles REQUIRED INFORMATION EXTRA INFORMATION REQUIRED FOR TIVOLI SET NETWORK NAME
4 4 4 5 5 6 6 6 7 8 8
TIVOLI ONLY - SET UP TIVOLI DIRECTORY INCLUDING DB2 11 Install Tivoli Directory Set up Tivoli Directory Add users Update users ACTIVE DIRECTORY ONLY - SET UP DB2 Install DB2 Apply Daylight Saving fix ACTIVE DIRECTORY ONLY - SET UP ACTIVE DIRECTORY Set up static IP address Set up DNS Install Active Directory Create some users SET UP WEBSPHERE APPLICATION SERVER Install WebSphere Application Server Install HTTP Server Updating WebSphere Application Server Start WebSphere Configure WebSphere for Federated repositories Configure WebSphere to manage HTTP Server Configure IBM HTTP Server for SSL CREATE WEBSPHERE SERVERS CREATE THE DATABASES INSTALL LOTUS CONNECTIONS Configure Blogs INSTALL PROFILES Create Active Directory sample users Create Tivoli sample users 11 17 30 32 37 37 42 44 44 47 60 73 78 78 82 86 97 99 122 125 134 134 135 180 190 190 193 2
Trovus rewarding dialogue Installation guide to Lotus Connections Install Tivoli Directory Integrator 15.3. 15.4. Set up Tivoli Directory Integrator Map Profiles to HTTP Server 195 203 212
1. Introduction
At Trovus we are passionate about the power of the Internet to drive Social Networking. We are very excited that IBM, amongst others, have released enterprise class software which supports all of the concepts and ideas that Trovus has been talking to customers about for a long time. Trovus is keen to understand what IBM customers think of Lotus Connections and how it will help them in their drive toward becoming a more collaborative and innovative business. To this end we have written this guide in the hope that people trying Lotus Connections out will find it useful, and then give us a call to discuss how Trovuss vendor neutral methods and techniques for Social Software can be applied to Lotus Connections. In the spirit of collaboration, please feel free to edit, correct, improve or otherwise comment on this document either on our blog at http://www.rewardingdialogue.co.uk or contact the author directly at jon.mell@trovus.co.uk. He can also be found on Facebook here http://www.facebook.com/p/Jon_Mell/657095205
2. Preamble
This document is intended to assist those interested in IBM Lotus Connections to get the software up and running on a single Windows machine using either Tivoli Directory server or Active Directory. In our experience, we found Active Directory the best option to get up and running quickly, but Active Directory mandates Windows 2003 XP or Vista wont cut it. Tivoli works fine on an XP Service Pack 2 environment. Note this document assumes a stand-alone/test install. It makes changes to your system settings. For this reason it is strongly recommended that you use virtualisation software such as VMWare to protect your machine and the network it sits on from adverse affects. This is not intended to provide you with a robust guide for a production setup but rather a test or proof of concept environment. You can apply the concepts here though to a production install.
3. Disclaimer
1. Trovus takes no responsibility for either the material contained within this document or how such material may be interpreted or used; Trovus does not accept liability for anything which may arise from or be said to arise from material contained within this document; Copyright of the material contained within this document shall remain vested in Trovus at all times; This document and the material contained within it may not be reproduced, in whole or in part, except with the consent in writing of Trovus; Any communication with Trovus whether oral or in writing which arises from this document or the material contained within it shall not be deemed to mean that Trovus has taken on any responsibility or liability which has been excluded by virtue of paragraphs 1 and 2. 2.
3. 4.
5.
Part C1076EN from IBM Passport Advantage http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24012718 This file is usually in the format download.updii.6109.windows.ia32.zip http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24013830 (download 32-bit x86 AMD/Intel AppServer, 32-bit x86 AMD/Intel Plug-ins and 32-bit x86 AMD/Intel IBM HTTP Svr from this page)
Currently located here but IBM may change location. ftp://ftp.software.ibm.com/software/tivoli_support/patches/patches_6.1.0/6.1.0TIV-TDI-FP0001/6.1.0-TIV-TDI-FP0001.zip If you have to search for this file ensure you get Fixpack 1 for 6.1.0 (ie 6.1.0.1) not version 6.1.1
5. Required information
You will also need the following information. It is useful to print this sheet out and refer to it during the installation. Where these tags appear in the document they need to be replaced with you values. If in doubt use the sample values in this document.
Name <wasadminuser>
<wasadminpwd> <winadminuser>
<httpinstall>
<tdisol>
Description Administrative userid to use for the WebSphere console eg wasadmin Password for <wasadmin> eg wasadmin Administrator user id for Windows 2003 eg Administrator Passwoord for <winadminuser> Computer hostname eg connections Network domain for computer eg trovus.co.uk Fully qualified hostname of computer <hostname>.<domain> eg connections.trovus.co.uk The location of your DB2 installation eg C:\SQLLIB DB2 username eg db2admin Password for <db2user> Your current IP address Your current subnet mask Your current TCP/IP gateway Your current DNS servers Location of your WebSphere installation eg C:\WebSphere\AppServer Location of you HTTP server installation eg C:\HTTPServer Username to administer HTTP Server eg httpadmin Password for <httpuser> Installation path for Tivoli Directory Server if using Profiles. Eg C:\TDI The TDI sub-directory of where you extracted TDISOL.zip from the Lotus Connections installation media (Profiles only)
Value
Name <ldapadminpwd>
<idsinstpwd>
<ldapinstall>
<organisation>
Description Password for cn=root eg password (required for Tivoli only) Password for idsinst eg password (required for Tivoli only) LDAP Installation directory eg C:\LDAP (required for Tivoli only) The name of your organisation to store the LDAP users eg trovus
Value
Trovus rewarding dialogue Installation guide to Lotus Connections Under computer name enter <hostname> eg connections.
Click more and now enter the <domain> eg trovus.co.uk. Do not leave this blank and do not include <hostname>.
Trovus rewarding dialogue Installation guide to Lotus Connections Press OK and OK again and you should be back at the Computer name tab showing your full hostname and domain name. This should be the same as <fullyqualifiedname>.
Press OK and you will need to restart your machine. If you are using Tivoli now complete section 8. Skip sections 9 and 10 and follow section 11 through to the end of the document. If you are using Active Directory, skip section 8 and follow section 9 through to the end of the document.
10
8. Tivoli only - Set up Tivoli Directory including DB2 8.1. Install Tivoli Directory
Extract the three Tivoli downloads into the same directory. This should create a single tdsV6.1 directory. From the tds subdirectory run install_tds.bat Click Next on the welcome screen Accept the terms and click Next Set the installation directory to something easy to access from the command line and press Next. This is <ldapinstall>
11
Trovus rewarding dialogue Installation guide to Lotus Connections Select Custom and click next
12
Trovus rewarding dialogue Installation guide to Lotus Connections Enter values for <db2user> and <db2pwd>. This does not have to be an existing user id. Click next
13
Trovus rewarding dialogue Installation guide to Lotus Connections Check the Summary screen and press install. Note the directory into which DB2 is being installed. This is <db2install>. Remember this as you will need it later.
14
Trovus rewarding dialogue Installation guide to Lotus Connections Leave Create default instance selected and press Next
Enter a value to set as <idsinstpwd>as the User password Enter 1234567890abcdef as the Encryption seed Enter a value to set as <ldapadminpwd>as the Administrator DN Password Press Next
15
Trovus rewarding dialogue Installation guide to Lotus Connections Press Finish to create the LDAP instance. When you see the Activity screen like this the process has finished
The Administration Tool should now have the instance configured. Close the results window and the Administration Tool.
16
Trovus rewarding dialogue Installation guide to Lotus Connections Press Finish on the installation window
17
Trovus rewarding dialogue Installation guide to Lotus Connections Click Console administration and Manage console servers.
18
Trovus rewarding dialogue Installation guide to Lotus Connections Click OK. Click OK again and then click Logout. Click to log in again. You should now be able to log in to your Directory server. Enter cn=root as username and <ldapadminpwd>as password and click the Login button (not the link)
19
Trovus rewarding dialogue Installation guide to Lotus Connections Click Start and wait for the green triangle to light up
20
Trovus rewarding dialogue Installation guide to Lotus Connections Click Manage server properties on the left hand side and click Suffixes. Enter o=<organisation> for Suffix DN: Eg o=trovus
21
Trovus rewarding dialogue Installation guide to Lotus Connections Press Add and check that your new organisation appears under sample. Press OK on this screen. You must press OK or changes are not saved!
22
Trovus rewarding dialogue Installation guide to Lotus Connections Click Directory management and Add an entry. Select organization under Structural object classes. Click Next
23
Trovus rewarding dialogue Installation guide to Lotus Connections Do not select any auxiliary object classes. Click Next
24
Trovus rewarding dialogue Installation guide to Lotus Connections For Relative DN: enter o=<organisation> (eg o=trovus) For o: enter <organisation> (eg trovus) Click Next
25
Trovus rewarding dialogue Installation guide to Lotus Connections Do not fill in any optional attributes. Click Finish
Check that the entry has been successfully added but press no when asked to add a similar entry
26
Trovus rewarding dialogue Installation guide to Lotus Connections Click Realms and templates -> Add user template Enter template1 as User template name: Enter o=<organisation>as Parent DN: Click Next
27
Trovus rewarding dialogue Installation guide to Lotus Connections Select uid as the naming attribute and press Finish
Click Realms and templates -> Add realm Enter realm1 as the realm and o=<organisation> as Parent DN: Click Next
28
Trovus rewarding dialogue Installation guide to Lotus Connections Leave all the settings as they are, except for the dropdown where you select the template you just created. Click Finish
29
30
Trovus rewarding dialogue Installation guide to Lotus Connections Enter details for a Lotus Connection user. Uid will be the name you use to log in, so be sure to remember this. sn is the users surname and cn is the full name. Click Finish
31
Click the plus icon next to your organisation (in this case o=trovus)
32
Trovus rewarding dialogue Installation guide to Lotus Connections Click the plus icon next to your realm (realm1)
33
Trovus rewarding dialogue Installation guide to Lotus Connections Click Next. Scroll down and enter an email address for mail (it does not need to be valid). Also add a password for userPassword.
34
35
Trovus rewarding dialogue Installation guide to Lotus Connections Click Finish Click Logout and close the browser. Shut down the web admin tool. From a command line run <ldapinstall>\appsrv\bin\stopserver server1
If you ever reboot neither Directory Server nor the web admin tool are started automatically. You must start the directory server for Connections to work. You can start the web admin tool by running: <ldapinstall>\appsrv\bin\startserver server1
Then start the server using the web tool as described above. This appears to be the most reliable way of starting Tivoli Directory Server. Now skip the Active Directory sections below and proceed to Set up WebSphere Application Server.
36
Click Install DB2 Enterprise Server Edition on this computer and click next.
37
Trovus rewarding dialogue Installation guide to Lotus Connections I tend to change the install directory to something more user friendly - either change it or keep the default and press next. This value is <db2install>. On Set user information set Domain to "None - use local account" and enter the values you chose for your DB2 user (<db2user> and <db2pwd>). These users do not have to already exist. Ensure that the check box to use the same user name and password for the remaining DB2 services is selected. Click next
38
Trovus rewarding dialogue Installation guide to Lotus Connections Leave Prepare the DB2 tools catalog unselected and press next
Deselect Set up your DB2 server to end notifications and press next
39
Trovus rewarding dialogue Installation guide to Lotus Connections Deselect Enable operating system security for DB2 objects and click Next
40
Trovus rewarding dialogue Installation guide to Lotus Connections On the summary screen click install
41
Trovus rewarding dialogue Installation guide to Lotus Connections On successful install you should see a screen like the following. Click Finish.
From the DB2 First Steps screen that launches you can test your install if you wish by clicking Database Creation on the left hand side and click Create SAMPLE Database. Exit the First Steps screen when done.
42
Browse to the same directory that you set JAVA_HOME to (<db2install>\java\jdk\jre) and press update
43
Trovus rewarding dialogue Installation guide to Lotus Connections Click OK to accept the warning if it appears. After a while you should see this message. Press ok
Click Exit.
10.1.
From a command prompt run ipconfig /all and make a note of the following information: IP Address note this as <ipaddress> Subnet mask note this as <subnet> Default gateway note this as <gateway> DNS Servers note this as <dns>
44
Trovus rewarding dialogue Installation guide to Lotus Connections Click Start -> Control Panel -> Network Connections -> Local Area Connection.
Click Properties
Click Internet Protocol (TCP/IP) and click Properties. Click the "Use the following IP address" radio button and the "Use the following DNS Server addresses" radio button Enter: IP Address with <ipaddress> Subnet mask with <subnet> Default gateway <gateway> DNS <ipaddress> Do not fill in the DNS Server with <dns>. Instead this should be <ipaddress>.
45
46
10.2.
Set up DNS
Active directory requires you to have a Domain Name Server (DNS) service running on your machine. Click Start -> Control Panel -> Add or Remove Programs On the left hand side click Add/Remove Windows Components Select Networking Services and press Details
47
Trovus rewarding dialogue Installation guide to Lotus Connections Select Domain Name System (DNS) and press OK
48
Trovus rewarding dialogue Installation guide to Lotus Connections Networking services should now have a grey checked box. Press Next. Set up may require you to enter the location of your Windows 2003 media or install image during this step.
49
Trovus rewarding dialogue Installation guide to Lotus Connections After a few moments you should see a successful completion screen. Press Finish.
50
Trovus rewarding dialogue Installation guide to Lotus Connections Click Start -> Administrative Tools -> DNS Expand your server (in this case CONNECTIONS)
Left click Forward Lookup Zones. Right click Forward Lookup Zones and click New Zone...
51
Trovus rewarding dialogue Installation guide to Lotus Connections On the Zone Type screen keep Primary Zone selected and press next.
52
Trovus rewarding dialogue Installation guide to Lotus Connections In Zone name enter <domain>. This should just be the domain name (eg trovus.co.uk) and not include the hostname (eg connections). Click Next.
53
Trovus rewarding dialogue Installation guide to Lotus Connections Leave the Zone file settings as the default and press Next
54
Trovus rewarding dialogue Installation guide to Lotus Connections Select Allow both nonsecure and secure dynamic updates and press Next
55
Trovus rewarding dialogue Installation guide to Lotus Connections On the summary screen press Finish
56
Trovus rewarding dialogue Installation guide to Lotus Connections You should have a zone created that looks like the following
57
Trovus rewarding dialogue Installation guide to Lotus Connections If you want to enable your machine to still use a 'real' DNS server then right click on your server (eg CONNECTIONS) on the left hand tree and click properties. Click the Forwarders tab on the properties screen
58
Trovus rewarding dialogue Installation guide to Lotus Connections Enter <dns> in the Seleced domain's forwarder IP address list box and press Add.
59
10.3.
From a command prompt again run dcpromo You should see the Active Directory installation wizard welcome screen. Click Next. You will then see a screen about Operating System Compatibility. Click Next. On the Domain Controller Type screen leave Domain controller for a new domain selected and press Next.
60
Trovus rewarding dialogue Installation guide to Lotus Connections On the Create New Domain screen leave Domain in a new forest selected and press Next
61
Trovus rewarding dialogue Installation guide to Lotus Connections In New Domain Name enter <domain> (eg trouvs.co.uk). Click Next.
62
Trovus rewarding dialogue Installation guide to Lotus Connections Accept the default Domain NetBIOS name and press Next
63
Trovus rewarding dialogue Installation guide to Lotus Connections Accept the default Database and Log folders and click Next
64
Trovus rewarding dialogue Installation guide to Lotus Connections Accept the default Shared System Volume and press next
65
Trovus rewarding dialogue Installation guide to Lotus Connections Check you have a successful DNS Registration Diagnostic and press Next
66
Trovus rewarding dialogue Installation guide to Lotus Connections On the Permissions screen leave Permissions compatible only with Windows 2000 or Windows Server 2003 operating systems and press Next.
67
Trovus rewarding dialogue Installation guide to Lotus Connections Enter a memorable restore password and press Next
68
Trovus rewarding dialogue Installation guide to Lotus Connections On the Summary screen click Next.
Active Directory configuration should start. This should only take a few minutes.
69
Trovus rewarding dialogue Installation guide to Lotus Connections You should see a successful completion screen. Click Finish.
You will then be asked to restart your machine. Note in future restarts you will have to change the Domain on the log in screen before entering your username and password!
70
Trovus rewarding dialogue Installation guide to Lotus Connections Log back in as the Administrator and go to Start -> Administrative Tools -> Active Directory Users and Computers
71
Trovus rewarding dialogue Installation guide to Lotus Connections Expand your domain and click on Users to confirm that your <winadminuser> and <db2user> are present in the Active Directory
72
10.4.
73
Trovus rewarding dialogue Installation guide to Lotus Connections Add some users so that we have some people to log in once Connections is installed. Note that their login will just be their User logon name, not with the email domain appended. So here the Lotus Connections login name is jonmell not jonmell@trovus.co.uk. Click next
74
Trovus rewarding dialogue Installation guide to Lotus Connections Enter a password and use the following settings. Note Active Directory requires 8 digit passwords with a number, a lowercase character and an uppercase character.
75
Trovus rewarding dialogue Installation guide to Lotus Connections Double click on your newly created user
76
Trovus rewarding dialogue Installation guide to Lotus Connections Add an email address (it does not have to be valid). Note that all Connections users must have an email address. They will not be able to log in without one. Jon.
Click OK and create some more users if you wish, but remember to give them email addresses after you create them. The fact that the user login is in the form of an email address does not count!
77
11. Set up WebSphere Application Server 11.1. Install WebSphere Application Server
Click Launch the installation wizard for WebSphere Application Server When the wizard launches click Next on the welcome screen. Accept the license terms and click Next
78
Trovus rewarding dialogue Installation guide to Lotus Connections Your system should then pass a System Prerequisites check - click Next
Do not choose to Install the sample applications (unless you really want to!) and click Next
79
Trovus rewarding dialogue Installation guide to Lotus Connections In the installation directory, you can choose something more user friendly. This is <wasinstall>.
Ensure that Enable administrative security is not selected and click Next
80
Trovus rewarding dialogue Installation guide to Lotus Connections Review the Installation Summary and click Next
81
11.2.
Now on the Launchpad click Launch the installation wizard for IBM HTTP Server. This will ask you for the location of the WebSphere Supplemental disk you should have downloaded or received with your Lotus Connections media. Once the wizard launches click Next on the Welcome screen. Accept the license terms and click next. Your system should then pass a System Prerequisites check - click Next
82
Trovus rewarding dialogue Installation guide to Lotus Connections Accept the default installation location or change it to something easier. This is <httpinstall>. Press Next.
83
Trovus rewarding dialogue Installation guide to Lotus Connections Set the service to log on as a local system account and press next
Enter values for <httpuser> and <httppwd> as user id and password for HTTP Administration (eg httpadmin). This does not have to be an existing user. Click Next.
84
Trovus rewarding dialogue Installation guide to Lotus Connections Leave the settings enabled to install the HTTP Server plug-in and press Next.
85
Trovus rewarding dialogue Installation guide to Lotus Connections Check you get a successful install message like the one below and press Finish.
86
Trovus rewarding dialogue Installation guide to Lotus Connections Click Next on the Welcome Screen of the wizard Select <wasinstall> on the Product Selection screen as the Directory path and click next
87
Trovus rewarding dialogue Installation guide to Lotus Connections Select Install maintenance package and click Next
Browse to the directory you copied the .pak files to and click Next
88
Trovus rewarding dialogue Installation guide to Lotus Connections Ensure that the fixes listed below are selected and press Next
89
Trovus rewarding dialogue Installation guide to Lotus Connections You should see the following success screen. Click Relaunch
90
Trovus rewarding dialogue Installation guide to Lotus Connections Select Install maintenance package and click next
Browse to the directory where you copied the .pak files and click Next
91
Trovus rewarding dialogue Installation guide to Lotus Connections Ensure the fix pack selected in the screen shot below is selected and click Next
92
Trovus rewarding dialogue Installation guide to Lotus Connections You should see another success screen. Click relaunch.
93
Trovus rewarding dialogue Installation guide to Lotus Connections Select Install maintenance package and click next
Browse to the directory where you copied the .pak files and click Next
94
Trovus rewarding dialogue Installation guide to Lotus Connections Ensure the fix pack shown below is selected and click Next
95
Trovus rewarding dialogue Installation guide to Lotus Connections On the success screen click Finish.
96
11.4.
Start WebSphere
Set WebSphere server1 startup to manual Click Start -> Control Panel -> Administrative Tools -> Services Scroll down to IBM WebSphere Application Server 6.1 - <hostname>Node01
97
Trovus rewarding dialogue Installation guide to Lotus Connections Right click on this service, click properties and set the Startup type to Manual
98
99
Trovus rewarding dialogue Installation guide to Lotus Connections In Available realm definitions change from Local operating system to Federated Repositories
100
Trovus rewarding dialogue Installation guide to Lotus Connections Click Configure next to Federated repositories
101
Click Add.
102
Trovus rewarding dialogue Installation guide to Lotus Connections Enter LDAP as the Repository identifier Enter localhost as the Primary host name. For Tivoli: Select IBM Tivoli Directory Server Version 6 as the Directory type Bind distinguished name is cn=root Bind password is <ldapadminpwd> For Active Directory: Select Microsoft Windows Server 2003 Active Directory as the Directory type Bind distinguished name is the format cn=<winadminuser>,cn=Users,dc=<domain1>,dc=<domain2>,... Where <domain1> = the first part of <domain> (eg trovus) Where <domain2> = the second part of <domain> (eg co) Where this continues until you have all of <domain> broken down. For example, my setting is cn=Administrator,cn=Users,dc=trovus,dc=co,dc=uk The Bind password is <winadminpwd> Here is a screen shot for Active Directory settings
103
Trovus rewarding dialogue Installation guide to Lotus Connections And here is one for Tivoli
Click Apply. If there are no errors click OK. If there is a problem you will see a message like this. If you see this double check your entries (most likely cause is an invalid form of the Bind distinguished name) and try again.
104
Trovus rewarding dialogue Installation guide to Lotus Connections When you have no red text and press OK you will see this screen.
105
106
In the drop down ensure the LDAP repository is selected For Active Directory the Distinguished name of a base entry that uniquely identifies this set of entries in the realm is o=<hostname> - eg o=connections (this is a lower case O not the number zero). For Active Directory the Distinguished name of a base entry in this repository is <domain> broken out into dc= again. Eg dc=trovus,dc=co,dc=uk For Tivoli both values are o=<organisation> Here is a screenshot for Active Directory
107
Trovus rewarding dialogue Installation guide to Lotus Connections And here is one for Tivoli
Click OK
108
Trovus rewarding dialogue Installation guide to Lotus Connections Enter <wasadminuser> as the Primary administrative name. This name must not exist in Active Directory or Tivoli directory or be an existing name in the operating system user registry.
109
Trovus rewarding dialogue Installation guide to Lotus Connections Enter <wasadminpwd> for the password and click OK Note - <wasadminuser> and <wasadminpwd> must be used when stopping the server from the command line.
110
Trovus rewarding dialogue Installation guide to Lotus Connections You will return to this screen.
111
Trovus rewarding dialogue Installation guide to Lotus Connections Change Available Realm Definitions back to Federated Repositories. Click Set as current
112
Trovus rewarding dialogue Installation guide to Lotus Connections Expand Web Security on the right hand side
113
Trovus rewarding dialogue Installation guide to Lotus Connections Click General Settings. Check Use available authentication data when an unprotected URI is accessed.
Click OK.
114
Click Web security on the right hand side again and click single sign-on (SSO) and enter <domain> for Domain name
Click OK
115
Trovus rewarding dialogue Installation guide to Lotus Connections Click Enable administrative security
116
Trovus rewarding dialogue Installation guide to Lotus Connections Deselect Use Java 2 security to restrict application access to local resources. Ensure your screen looks like the screen below (especially that Federated Repositories is selected under Current realm definition as well as Available realm definitions)
Press Apply.
117
Trovus rewarding dialogue Installation guide to Lotus Connections Your screen should look like this:
118
Trovus rewarding dialogue Installation guide to Lotus Connections Click Save at the top of the screen. You will see this screen. Click Logout and close the browser
119
Trovus rewarding dialogue Installation guide to Lotus Connections From the Services screen right click IBM WebSphere Application Server 6.1 - <hostname>Node01 and select stop.
Note - this is the last time you will stop WebSphere from the services screen. It now needs a password therefore you will run the following from <wasinstall>\bin stopserver server1 -username <wasadminuser> -password <wasadminpwd> From the Services screen right click IBM WebSphere Application Server 6.1- <hostname>Node01 and select start Relauch the Administrative console from the Start menu. You may receive warnings about viewing a page over a secure connections - accept these Now you will need to enter <wasadminuser> and <wasadminpwd> to log in
120
Trovus rewarding dialogue Installation guide to Lotus Connections Click Users and Groups then Manage Users
Click Search. If the setup has been selected you should see your LDAP users in either Active Directory or Tivoli as well as <wasadminuser> that has been stored in a local repository. This confirms Federated Repositories setup has been successful.
121
Click New Enter webserver1 for Server name and <fullyqualifiedname> for host name. Click Next.
122
Trovus rewarding dialogue Installation guide to Lotus Connections Accept the default template and click Next
Enter the <httpuser> and <httppwd> as username and password and ensure the Web server installation location and Plug-in installation location point to <httpinstall> and <httpinstall>\plugins respectively
Click Finish
124
11.7.
On the left hand side click Security and SSL certificate and key management
Click Key stores and certificates. You will see the screen below.
125
Trovus rewarding dialogue Installation guide to Lotus Connections Click NodeDefaultKeyStore. You will see the screen below.
Click Personal certificates Select default and press Extract (you may need to scroll along to see the Extract button)
126
Trovus rewarding dialogue Installation guide to Lotus Connections For Certificate file name use waskey.arm and place it in <httpinstall>
127
From the menu select Key Database File and Open. Change the Key database type to CMS and browse to <httpinstall>\Plugins\config\webserver1 and select plugin-key.kdb (eg c:\httpserver\plugins\config\webserver1\plugin-key.kdb)
128
129
Trovus rewarding dialogue Installation guide to Lotus Connections Change Personal Certificates to Signer Certificates
Click Add
130
Trovus rewarding dialogue Installation guide to Lotus Connections Click browse and select the key you exported before you stopped WebSphere in <httpinstall> (eg waskey.arm). Click Open
Click OK
131
Trovus rewarding dialogue Installation guide to Lotus Connections You should see it added
Close the utility (you do not need to save these key files) Open the httpd.conf file in <httpinstall>\conf Search for the line #LoadModule headers_module modules/mod_headers.so and delete the # to enable headers Search for the line #LoadModule rewrite_module modules/mod_rewrite.so and delete the # to enable rewriting At the end of the file - add the following: RewriteEngine on LoadModule ibm_ssl_module modules/mod_ibm_ssl.so Listen 0.0.0.0:443 <VirtualHost *:443> RewriteEngine on SSLEnable SSLProxyEngine on ServerName <fullyqualifiedname> </VirtualHost> SSLDisable Keyfile "<httpinstall>\plugins\config\webserver1\plugin-key.kdb" SSLStashFile "<httpinstall>\plugins\config\webserver1\plugin-key.sth" Remember that <fullyqualifiedname> needs to be substituted with your fully qualified hostname. Eg: ServerName connections.trovus.co.uk Keyfile "c:\httpserver\plugins\config\webserver1\plugin-key.kdb" SSLStashFile "c:\httpserver\plugins\config\webserver1\plugin-key.sth"
132
Save the httpd.conf file. Click Start -> All Programs -> IBM HTTP Server 6.1 -> Stop HTTP Server Click Start -> All Programs -> IBM HTTP Server 6.1 -> Start HTTP Server Note I often have problems starting and restarting HTTP Server with the process hanging. If this happens launch the task manager (press CTRL-ALT-DEL and select Task Manager) and end all the Apache.exe processes then try starting the HTTP server again. Check you can access your HTTP Server from http://localhost and https://localhost
133
Remember to replace <hostname> with your hostname eg: $AdminTask createApplicationServer connectionsNode01 {-name ActivitiesServer}
134
135
Trovus rewarding dialogue Installation guide to Lotus Connections Run the install.bat command from the Lotus Connections installation media Click next on the Welcome screen Accept the terms and conditions and press Next Do not save your settings in a response file - click next
136
Trovus rewarding dialogue Installation guide to Lotus Connections Select Activities and press next
137
Trovus rewarding dialogue Installation guide to Lotus Connections Select the WebSphere Application Server instance and press Next
138
Trovus rewarding dialogue Installation guide to Lotus Connections Select the ActivitiesServer and press Next
139
Trovus rewarding dialogue Installation guide to Lotus Connections Enter <wasadminuser> and <wasadminpwd> and press Next
140
141
Trovus rewarding dialogue Installation guide to Lotus Connections Select DB2 and press Next
142
Trovus rewarding dialogue Installation guide to Lotus Connections Enter localhost as the Host name and then <db2user> and <db2pwd> for username and password Check the JDBC Driver library points to the correct path <db2install>\java. Note if using Tivoli this is hard coded as C:\Program Files\IBM\tdsdb2V9.1\java
143
Trovus rewarding dialogue Installation guide to Lotus Connections Accept the default location for statistics and press Next
144
Trovus rewarding dialogue Installation guide to Lotus Connections Select Network or operating system file system and press Next
145
Trovus rewarding dialogue Installation guide to Lotus Connections Accept the default content store and press Next
146
Trovus rewarding dialogue Installation guide to Lotus Connections Do not select an SMTP messaging server and press Next
147
Trovus rewarding dialogue Installation guide to Lotus Connections Ensure that both check boxes are selected but remove any port information from the URLs as shown. Click Next
148
Trovus rewarding dialogue Installation guide to Lotus Connections Check the Summary screen and press Next
149
Trovus rewarding dialogue Installation guide to Lotus Connections You should get a successful message. Click Finish.
150
Trovus rewarding dialogue Installation guide to Lotus Connections Run the installation again but this time select the Blogs feature to install.
151
Trovus rewarding dialogue Installation guide to Lotus Connections As per the Activities installation you can accept the defaults as you go through the install. The only screens you need to watch are the Application Server screen (select BlogsServer)
152
Trovus rewarding dialogue Installation guide to Lotus Connections The WebSphere administrative ID screen
153
Trovus rewarding dialogue Installation guide to Lotus Connections and the DB2 screen (it should remember everything except the user id password)
154
Trovus rewarding dialogue Installation guide to Lotus Connections Also remember to check the HTTPS setting and remove any ports
155
Trovus rewarding dialogue Installation guide to Lotus Connections Apart from these screens you can safely click Next through to installation. Once it has completed run the installation again, this time for Communities.
156
Trovus rewarding dialogue Installation guide to Lotus Connections Again defaults can be accepted apart from the same screens as per above.
157
158
159
Trovus rewarding dialogue Installation guide to Lotus Connections And finally we do the same for Dogear. We will add Profiles once we have the core site up and running.
160
161
162
163
From Start -> Control Panel -> Administrative Tools -> Services right click IBM WebSphere Application Server V6.1 - <hostname>Node01 and press Start. Once the service has started launch the Administrative Console from the Start menu. Log on to the console with <wasadminuser> and <wasadminpwd>. Click Applications and the left hand side and then Enterprise Applications
164
165
Trovus rewarding dialogue Installation guide to Lotus Connections Click Manage Modules
166
Trovus rewarding dialogue Installation guide to Lotus Connections Select both Activities WebUI and Connections Navigation Under clusters and servers select the entry ending ActivitiesServer - also select webserver1 whilst holding down Control so both are selected.
167
168
Trovus rewarding dialogue Installation guide to Lotus Connections Click Apply. You should see webserver1 added to the Server list for both modules
169
Trovus rewarding dialogue Installation guide to Lotus Connections Click OK. You should be taken back to this screen.
170
Trovus rewarding dialogue Installation guide to Lotus Connections Click Enterprise Applications Click Blogs then Manage Modules Repeat the same activity - selecting Roller Weblogger and Connections Navigation and applying BlogsServer and webserver1 to those modules
171
Click OK. Select Enterprise Applications -> Communities -> Manage modules
172
Trovus rewarding dialogue Installation guide to Lotus Connections Select Communities WebUI and Connections Navigation and apply CommunitiesServer and webserver1 to these modules
173
Press OK. Click Enterprise Applications -> Dogear -> Manage modules
174
Trovus rewarding dialogue Installation guide to Lotus Connections Select Dogear Application and Connections Navigation and apply DogearServer and webserver1 to these modules
175
Click OK
176
Trovus rewarding dialogue Installation guide to Lotus Connections You will be taken back to this screen.
177
Trovus rewarding dialogue Installation guide to Lotus Connections Click Servers on the left hand side of the screen and select Web Servers
178
Trovus rewarding dialogue Installation guide to Lotus Connections Select webserver1 again and click Propagate Plug-in
Check the message above shows the file has been copied to the correct location.
179
14.1.
Configure Blogs
180
Trovus rewarding dialogue Installation guide to Lotus Connections Click Security role to user/group mapping
181
Trovus rewarding dialogue Installation guide to Lotus Connections Click Look up users
182
Trovus rewarding dialogue Installation guide to Lotus Connections Click Search. Your LDAP users should appear. Click one of the users you created earlier that will be logging into Connections (and has an email address) and click the arrow to move that user across as an Administrator.
Click OK.
183
Trovus rewarding dialogue Installation guide to Lotus Connections You will be taken back to this screen. Check that the user (in this case jonmell) is set as a mapped user to the admin role.
Click OK Click Save at the top of the screen. Log out of the console and close the browser. From the Start menu run Stop HTTP Server and then Start HTTP Server From the command line navigate to <wasinstall>\bin (eg c:\WebSphere\AppServer\bin) Run the following commands: Stopserver server1 user <wasuser> -password <waspassword> Startserver ActivitiesServer Startserver BlogsServer Startserver CommunitiesServer Startserver DogearServer
184
Trovus rewarding dialogue Installation guide to Lotus Connections In a web browser navigate to http://<yourfullyqualifiedname>/blogs eg http://connections.trovus.co.uk/blogs
Click New Blog Creation Page Log in using the userid you just mapped to be an administrator (in my case jonmell)
185
Trovus rewarding dialogue Installation guide to Lotus Connections Enter a name and handle. Change the theme from Blog to Homepage
186
Trovus rewarding dialogue Installation guide to Lotus Connections Click Create Blog. Your blog should be created.
Click Set this blog to be your primary blog Click Server Administration. Enter the handle of your blog as Handle of blog to server as frontpage blog
Click OK. You should see links to Dogear, Activities and Communities as well. You should now be able to click on these to use these features without having to sign in again.
187
188
189
190
Trovus rewarding dialogue Installation guide to Lotus Connections Double click on all these users and add an email address and a telephone number:
191
Trovus rewarding dialogue Installation guide to Lotus Connections Click Organization and add the following information Set the Line Managers Manager Name to Chief Executive Set Employee One and Employee Twos Manager name to Line Manager
192
15.2.
Follow this section only if using Tivoli directory. Start the web admin tool by running <ldapinstall>\appsrv\bin\startserver server1 Open a browser and navigate to http://localhost:12100/IDSWebApp/IDSjsp/Login.jsp Log in using cn=root and <ldapadminpwd> If the server is not started, click the triangle at the top of the screen to start the server. Wait for it to turn green. Click Users and groups and click Add user. Follow the instructions above under Add Users in the Set up Tivoli Directory server section to create the following users: uid=ceo sn=Executive cn=Chief Executive uid=manager sn=Manager cn=Line Manager uid=employee1 sn=One cn=Employee One uid=employee2 sn=Two cn=employee2
193
Trovus rewarding dialogue Installation guide to Lotus Connections Follow the instructions above under Update Users to give ceo, manager, employee1 and employee2 the following values ceo givenName: Chief mail: ceo@<domain> userPassword: password manager givenName: Line mail: manager@<domain> manager: uid=ceo,cn=realm1,o=<organisation> userPassword: password employee1 givenName: Employee mail: employee1@<domain> manager: uid=manager,cn=realm1,o=<organisation> userPassword: password employee2 givenName: Employee mail: employee2@<domain> manager: uid=manager,cn=realm1,o=<organisation> userPassword: password Remember to replace <domain> and <organisation> with your values.
Note you must have the full entry including the realm and the organisation for report to chains to work. Whilst on these screens you can also fill in telephoneNumber to see how this appears in Profiles.
194
195
Trovus rewarding dialogue Installation guide to Lotus Connections Enter a installation path and press Next. Make a note of this path as this is <tdiinstall>
Click Do not specify. Use current working directory at startup time. Click Next
196
Trovus rewarding dialogue Installation guide to Lotus Connections Review the summary and press Install
197
Unzip 6.1.0-TIV-TDI-FP0001.zip (see required software for location) Run C:\Program Files\IBM\Common\ci\gmi\bin\gmi.cmd Click Next on the welcome screen Select Install maintenance packages such as fixes, fix packs or refresh packs. Press Next.
198
Trovus rewarding dialogue Installation guide to Lotus Connections Ensure IBM Tivoli Directory Integrator v6.1 is selected and press Next
199
Trovus rewarding dialogue Installation guide to Lotus Connections Select the directory where you unzipped 6.1.0-TIV-TDI-FP0001.zip and click Add
200
Trovus rewarding dialogue Installation guide to Lotus Connections Select the check box next to the fixpack and press Next
201
Trovus rewarding dialogue Installation guide to Lotus Connections Review the summary screen and press Install
202
15.3.
Copy the TDISOL directory from the Lotus Connections installation media to your hard drive. Unzip tdisol.zip into a directory. This creates a TDI subdirectory. This is <tdisol>. From within <tdisol> open tdienv.bat and change SET TDIPATH to point to <tdiinstall>. Save and close the file. From <tdisol> edit the map_dbrepos_from_source.properties file This is where you map the database fields here to fields in your LDAP server. For Tivoli: set PROF_GUID=ibm-entryUuid set PROF_UID=uid For Active Directory: set PROF_GUID={function_map_from_objectGUID} set PROF_UID=sAMAccountName You can also update other fields. For example the telephone number field is as follows for both Tivoli and Active Directory: PROF_TELEPHONE_NUMBER=telephoneNumber Repeat this for other properties you wish to show. Save and close this file. Edit <tdisol>\profiles_tdi.properties Set the following values source_ldap_url=ldap://<fullyqualifiedname>:389 dbrepos_username=<db2user> {protect}-dbrepos_password=<db2pwd> For Active Directroy: source_ldap_user_login=cn=<winadminuser>,cn=Users,dc=<domain1>,dc=<domain2>,... {protect}source_ldap_user_password=<winadminpwd> source_ldap_search_base=cn=Users,dc=<domain1>,dc=<domain2>,... source_ldap_search_filter=(objectClass=User) eg: source_ldap_user_login=uid=Administrator,cn=Users,dc=trovus,dc=co,dc=uk source_ldap_search_base=cn=Users,dc=trovus,dc=co,dc=uk For Tivoli: source_ldap_user_login=cn=root {protect}source_ldap_user_password=<ldapadminpwd> source_ldap_search_base=o=<organisation> source_ldap_search_filter=(objectClass=iNetOrgPerson) Save and close the file
203
Trovus rewarding dialogue Installation guide to Lotus Connections Copy <db2install>\java\db2jcc_license_cu.jar to <tdiinstall>\jvm\jre\lib\ext Edit <tdiinstall>\ibmdisrv.bat and at the end of the file where the java command is add -Xms256M -Xmx1024M before classpath So the command should look like: "<tdiinstall>\jvm\jre\bin\java" -Xms256M -Xmx1024M classpath ... Save and close the file Open a DB2 command line by running db2cmd. Change directory to <db2install>\bnd Run db2 tvf <tdisol>\peopledb.db2 Change directory to <db2install>\misc Run db2 connect to PEOPLEDB Run db2 tvf explain.ddl Run db2 disconnect PEOPLEDB Change directory to <tdisol>. Run the following commands: collect_dns.bat populate_from_dn_file.bat (ensure you get a message showing successful import of records) mark_managers.bat Note that this performs a one-time migration from LDAP to the Profiles database. Updates to a users profile are not propagated to the LDAP or vice versa. To enable this requires complex setup of your LDAP server and should only be performed by an experienced LDAP administrator. See the Lotus Connections InfoCenter for more details.
204
Install Profiles
Run install from the Lotus Connections media Click Next on the welcome screen Accept the license agreement and click next. Do not save your settings in a response file click Next. Select Profiles click Next
205
Trovus rewarding dialogue Installation guide to Lotus Connections Select the WebSphere Application Server instance click Next
206
Trovus rewarding dialogue Installation guide to Lotus Connections Ensure <fullyqualifiedname> is set correctly and press Next
207
Trovus rewarding dialogue Installation guide to Lotus Connections Set the DB2 values as per the other Lotus Connections features and press Next
208
Trovus rewarding dialogue Installation guide to Lotus Connections Select the Enable HTTPS check box and remove any port information. Click Next
209
Trovus rewarding dialogue Installation guide to Lotus Connections On the summary screen click Next.
210
211
15.4.
From Start -> Control Panel -> Administrative Tools -> Services right click IBM WebSphere Application Server V6.1 - <hostname>Node01 and press Start. Once the service has started launch the Administrative Console from the Start menu. Log on to the console with <wasadminuser> and <wasadminpwd>. Click Applications and the left hand side and then Enterprise Applications. Click Profiles
212
Trovus rewarding dialogue Installation guide to Lotus Connections Click Manage Modules
213
Select Profiles, Semantic Tag Service and Connections Navigation. Under Clusters and Servers select webserver1, hold down the Control key, scroll down to Profiles Server and select that too.
214
Trovus rewarding dialogue Installation guide to Lotus Connections Click Apply and ensure that webserver1 is added under the server row of the table
215
Trovus rewarding dialogue Installation guide to Lotus Connections Click Servers on the left hand side and click Web Servers
Select webserver1 and click Generate Plug-in Select webserver1 again and click Propogate Plug-in Click Logout and close the browser. From the start menu run Stop HTTP Server and then run Start HTTP Server From the command line navigate to <wasinstall>\bin (eg c:\WebSphere\AppServer\bin) Run the following commands: Stopserver server1 user <wasuser> -password <waspassword> Startserver ActivitiesServer Startserver BlogsServer Startserver CommunitiesServer Startserver DogearServer Startserver ProfilesServer
216
Trovus rewarding dialogue Installation guide to Lotus Connections Open a browser and go to http://<fullyqualifiedname>/profiles Search for the users you created and check the reporting line is correct
217
218