bp112 twelve things your mother never told you about installing ibm lotus connections
DESCRIPTION
My main session from Lotusphere 2010, delivered with Rob Wunderlich."It's a classic case of the "bark is worse than the bite." Installing Lotus Connections - admittedly - is a complex process, with many pre-requisites to be met, environment-specific decisions to be taken and almost endless opportunities for customization and integration. It might appear daunting at first; but don't fret just yet. This session will make it a whole lot easier! We'll use our in-depth real-world experience of installing Lotus Connections at many organizations in the US and Europe to explore a dozen lesser-known details of the installation process that are key to successful deployment. We'll show tips and tricks, "cheat sheets," install checklists and share the stuff that isn't in the manual. Priceless resources! Stuff even Mom never told you!"TRANSCRIPT
SESSION BP112:12 Things Your Mother Never Told You About Installing Lotus ConnectionsStuart McIntyre | Technical Director, Collaboration MattersRob Wunderlich | Independent Consultant
Monday, 18 January 2010
2
About this session● Frankly, we think Lotus Connections has gotten something of a bad rap when it
comes to “difficulty to install.”
● Installing Lotus Connections – admittedly – is a complex process, but this session will make it a whole lot easier!
● We’ll show tips and tricks, “cheat sheets,” install checklists and share the stuff that isn’t in the manual.
Monday, 18 January 2010
3
About Rob Wunderlich● Notes/Domino consultant since early '90s. Certified developer, system admin
and Lotus instructor (although probably lapsed in most by now)● Held positions at several Detroit-area IBM/Lotus business partners prior to
joining IBM itself in 2006.● Went “independent” in 2009 (meaning, I'm available!), targeting social
technology, Notes/Domino and Lotus Connections● Infrequently updates www.dominounplugged.com● Twitter: rwunder● email: [email protected]
Monday, 18 January 2010
4
About Stuart McIntyre● Technical Director of Collaboration Matters (UK-based Lotus business partner),
a social software evangelist and Lotus Connections specialist. ● Has been working with Lotus software for 18 years, and focused on Lotus
Connections since 2007 launch, presenter at conferences such as Lotusphere, UKLUG and Collaboration University.
● Authors the Connections Blog: lotusconnectionsblog.com (amongst others)● Twitter: stuartmcintyre● Email: [email protected]
Monday, 18 January 2010
5
Agenda● Introductions, housekeeping, etc.
● The “12 Things”
● Summary
Monday, 18 January 2010
6
Agenda● Introductions, housekeeping, etc.
● Evaluations, please!
Monday, 18 January 2010
7
Agenda● Introductions, housekeeping, etc.
● The “12 Things”
● Summary
Monday, 18 January 2010
8
The “12 Things” list● In the spirit of full disclosure:
In all honesty, my mother never mentioned Lotus Connections to me at all, much less anything about installing it.
Monday, 18 January 2010
● Some key points:Connections does have a lot of moving parts, but they go together relatively easilyVery limited expertise in each of the framework products - WebSphere, DB2, TDI - is required to just install a basic Lotus
Connections 2.5 systemThere is a wizard-driven Pilot install option for test/demonstration
environments, but it is very limited - better to stick to the full install optionDon’t be frightened by the scary multi-node clustered install scenarios on the
Connections Wiki and in some Lotusphere presentations - they are not needed in 80-90% of environments
9
#1) It’s easier than you think!
Monday, 18 January 2010
#1) It’s easier than you think!
10
● It doesn’t have to be like this!
Monday, 18 January 2010
11
● The installation process:▬ Has gotten easier over the versions, 1 -> 2 -> 2.5, big improvements in Lotus Connections
2.5, particularly in clustered environments▬ Is mostly wizard-driven▬ Is clearly documented in the Infocenter, though the correct order is not always clear
● Your first installation:▬ A standard Microsoft Windows 2003 32-bit environment is ideal for your first install
experience - Connections 2.5 will install fine on a single 2-CPU 4GB system, though two systems are better
▬ Allow a significant period of uninterrupted time - at least 2 days for a full installation and configuration
▬ Gather all the pre-requisite information before starting - LDAP server/bind information, hostnames etc.
▬ Take it step by step, and take backups and/or snapshots at all major changes▬ Document everything!
#1) It’s easier than you think!
Monday, 18 January 2010
12
● But...▬ Do not try to build a production environment as your first Lotus Connections install,
there are too many places where mistakes can (and will) be made▬ Don’t use the Pilot install package unless you really understand the limitations▬ You need to read and understand the instructions very carefully - don’t make
assumptions!▬ Be ready to learn a lot from the experience and to install a second time to correct
from the lessons learnt!
#1) It’s easier than you think!
Monday, 18 January 2010
13
#2) Read the $!@#%&# instructions !!● Obviously, this is good advice for virtually ANY software product, but for Lotus
Connections, it's even more critical
▬ Infocenter can be difficult to follow▬ Lots of moving parts, key to know what changes in one application affect
others▬ Suggest building own set of instructions* based on your own experience,
specific environment and install methodology (Mindmaps are great for this)▬ Read all the way through before starting step one (seriously, trust us on
this!)
*also commonly known as 'cheatsheets' – and we'll share one with you later!
Monday, 18 January 2010
14
#2a) Correct order becomes important● Some install steps will simply not work unless pre-requisites and co-requisites
have been completed (examples, securing Websphere, creating plugin configuration)
● KISS methodology is critical, would suggest building test environment first, then production
Monday, 18 January 2010
15
#2a) Correct order becomes important● Some install steps will simply not work unless pre-requisites and co-requisites
have been completed (examples, securing Websphere, creating plugin configuration)
● KISS* methodology is critical, would suggest building test environment first, then production
*KISS = well known rock band of the 1980's
Monday, 18 January 2010
16
#2a) Correct order becomes important● Some install steps will simply not work unless pre-requisites and co-requisites
have been completed (examples, securing Websphere, creating plugin configuration)
● KISS* methodology is critical, would suggest building test environment first, then production
*KISS = well known rock band of the 1980's
*KISS = Keep It Simple Stupid
Monday, 18 January 2010
17
#2a) Correct order becomes important● Some install steps will simply not work unless pre-requisites and co-requisites
have been completed (examples, securing Websphere, creating plugin configuration)
● KISS methodology is critical, would suggest building test environment first, then production
● Even in setting up and then starting services, there IS an order of dependencies ...
Monday, 18 January 2010
#3) The Secret is in the Preparation
18
● Some key points:▬ There are a lot of components required for the install - products, update installers, patches, fixes▬ Many components are larger than 500MB in size, at least 2GB in total▬ Preparation is particularly important if no direct access to servers - images and fixes can take a very
long time to copy if waiting▬ Check and double-check ports and firewalls before starting - they may cause many and varied issues
during and after install▬ Install process is very disk intensive - slow disks (e.g. in VMWare environment) can more than
double install duration
Monday, 18 January 2010
#3) The Secret is in the Preparation● What comes in the box? (Oh, alright then, in the eAssembly!)
19
Lotus Connections 2.5 InstallerLotus Connections 2.5 Wizards
WebSphere Application Server Network Deployment 6.1
WebSphere Application Server Network Deployment Supplements 6.1
WebSphere Application Edge Components 6.1 (Optional)
DB2 9.5 (Optional)
Tivoli Directory Integrator 6.1.1Tivoli Directory Server 6.0 (Optional)
Monday, 18 January 2010
#3) The Secret is in the Preparation● What you REALLY need!
20
LC 2.5 InstallerLC 2.5 Wizards
LC 2.5 UpdateInstallerAll current LC2.5 Fixes
WAS ND 6.1WAS ND Supplements 6.1
WebSphere UpdateInstaller 7.0.0.5WAS 6.1.0.23
DB2 9.5 FP3 orDB2 9.1 FP6
Oracle 10g Enterprise 10.2.0.4
MS SQL Server 2005 Enterprise
SP2
Domino 7.0.2Domino 8.0.2Domino 8.5.x
MS Active Directory 2003
SP2+
Novell eDirectory 8.8
Sun Java Directory Server 5.2, 6.0
TDI 6.1.1TDI 6.1.1 FP6
Tivoli Directory Server 6.0 FP3
FCFC
FC = FixCentral http://ibm.com/support/fixcentral
PA/PW = Passport Advantage (Customers) or PartnerWorld (Partners)
FC
FC
FC
PA/PW
PA/PWPA/PW
PA/PW
FCTN
TN = UpdateInstaller TechNote http://www-01.ibm.com/support/docview.wss?rs=180&uid=swg24020212
PA/PW
Monday, 18 January 2010
#3) The Secret is in the Preparation● Supported Server Platforms:
▬ Check OS requirements carefully - WAS/DB2 etc. are supported on more platforms than Lotus Connections
21
AIX5L 5.3 TL4Windows 2008 Server (64 Bit only)Windows 2003 Server SP2 (32 Bit only)
RHEL AS/ES 4.7 (32-bit only) SUSE Linux Enterprise Server 10 (32-bit only)
Monday, 18 January 2010
#3) The Secret is in the Preparation
22
● Lessons learnt:▬ If you are going to use a trusted SSL certificate, get it before installation - save you much pain later!▬ Check and double-check the detailed system requirements▬ Make your SysAdmins understand how important these pre-reqs are!▬ Do not let them take Windows system updates automatically!
Monday, 18 January 2010
#4) Plan twice thrice, install once!
23
● A lot of planning and design decisions taken early on in the install process can return to haunt you later, so get them right first time - WebSphere is much less forgiving than Domino in this regard
● It tends to be easier to scale ‘up and out’ than to drop components at a later date:▬ start small and correct, then build...▬ rather than creating a grandiose server architecture that has issues and have to scale down to fix
● Set up your naming conventions early on:▬ nodes▬ servers▬ clusters▬ web servers
● Make life easy if you need to move physical servers or domains later:▬ Always use short names for servers/hostnames - e.g. lcnode01 not lcnode01.myorg.com▬ Always use logical names not physical/virtual machine names, e.g. lcnode01 not lcvm1n23p86!▬ Even on simple one/two server installs, add aliases to hosts file(s)...
Monday, 18 January 2010
#4) Plan twice thrice, install once!● Think very carefully about the feature:server/cluster ratio
▬ 11 features : 11 WAS servers (JVMs) is usually too many▬ wasted memory, hard to maintain, difficult to tie up errors across servers
▬ 11 features : 1 WAS server is often too few▬ log files get very very busy, administration not granular enough, takes too long to start/stop
● 3-6 servers works best● This is my favoured model:
▬ pcserver ▬ Profiles and Communities
▬ infraserver▬ Homepage, News, Search and Mobile
▬ appsserver▬ Activities, Blogs and Dogear (Bookmarks)
▬ fwserver▬ Files and Wikis
● Keeps co-dependent features together, scale/tune based on load/users/volumes, allow fast start/stop if customising
24
Monday, 18 January 2010
#4) Plan twice thrice, install once!
25
WAS Server (physical/virtual machine)
lcnode01
lcprofile
lcdmgr
appscluster
appsserver
dogear
blogs
activities
pccluster
pcserver
profiles
fwcluster
fwserver
files wikis
infracluster
infraserver
homepage search
newsmobile
lcdmgrdmgr
WAS Node WAS Profile WAS Cluster WAS Server
LC feature
IHS server
communities
● An example, four WAS server, single-node environment
Monday, 18 January 2010
#4) Plan twice thrice, install once!● DO NOT use the ‘advanced standalone’ option, ever!
▬ If using multiple profiles and WAS Standalone in Connections 2.0.x, migrate at upgrade time● If in doubt, cluster!
▬ Cluster using co-resident Deployment Manager and Node from day one▬ Ready to scale horizontally or vertically later▬ Get into the clustered administration mindset before habits are set
● Sizing and tuning are important, but:▬ IBM runs its TAP environment on just two nodes, one of which can take the load▬ Therefore, do not get pushed into complex infrastructures for simple/small environments▬ Often a well configured, well-specified single node WAS environment will be sufficient
● DB2 should be your default RDBMS option:▬ Often ease of support and bundled licence override lack of specific DB2 skills
26
Monday, 18 January 2010
#4) Plan twice thrice, install once!● Focus on Profiles!
▬ Spend at least three times as long planning Profiles population, integration and customisation as planning the Connection environment itself
▬ Can be a massive area for scope-creep - define, document and stick to plan!▬ Involve all the relevant stake-holders at an early stage
▬ Particularly Human Resources, Communications/Marketing, Reception/Telephony groups etc.▬ Phase your Profiles rollout - often feedback from pilot groups can be opposite to expectations▬ Profiles population usually the most important factor influencing Lotus Connections adoption▬ Pre-populate Profiles photos, no matter what it takes!▬ Consider using TDI to populate LDAP then populate Profiles▬ Plan for business card use elsewhere, and for Sametime presence awareness
27
Monday, 18 January 2010
28
#5) Ports ● Lotus Connections uses ports, ports and more ports
● LOTS of ports
● This becomes critical to know (and to know what Connections service has to talk to what enterprise service [e.g., LDAP, SMTP, etc])
● Be aware that clusters screw up ports
Monday, 18 January 2010
29
#5) Ports
Monday, 18 January 2010
30
#5) Ports
Monday, 18 January 2010
#6) Batten down the hatches
31
● Security is a very big deal in Lotus Connections, particularly with regard to Profiles data
● Unless you have a very good reason not to, restrict access to all Connections features to just authenticated users:▬ ISC: Applications/Enterprise Applications/<Feature>/Security Role to User\Group Mapping▬ Change Reader from ‘Everyone’ to ‘All Authenticated’:
▬ OK, repeat for all features, Save▬ Restart server(s)▬ Has knock-on effect that API/REST calls will also need authentication▬ Places a greater onus on SSO integration
Monday, 18 January 2010
#6) Batten down the hatches
32
● SSO between Lotus Connections and Domino▬ Well documented in the Infocenter and LC Wiki - http://tinyurl.com/lc-ld-sso▬ Essentially...
▬ Export SSO LTPA token from WAS ISC▬ Create new SSO configuration in Domino▬ Import WAS LTPA token▬ Assign new SSO configuration to Domino server
▬ But... there are some gotchas:▬ Realm Name must be set to allow LTPA to be correctly imported into
Domino - http://tinyurl.com/lc-ld-realm▬ ISC: Security/Secure administration, applications, and infrastructure
/Configure▬ Set Realm name to be <host_name>:<port> of the LDAP server
▬ and:▬ Turn off LTPA key rollover▬ ISC: SSL certificate and key management/Key set groups/
CellLTPAKeySetGroup▬ Disable “Automatically generate keys”
Monday, 18 January 2010
#6) Batten down the hatches
33
● But some Connections security can get onerous and be unnecessary● e.g. needing to enter username/password when stopping server or accessing
wsadmin● So, assuming your physical system and O/S are properly secured, disable
this:▬ In $WAS_HOME/profiles/<profile>/properties▬ Edit soap.client.props▬ Change:
com.ibm.SOAP.securityEnabled=falsecom.ibm.SOAP.loginUserid=com.ibm.SOAP.loginPassword=
▬ To:com.ibm.SOAP.securityEnabled=truecom.ibm.SOAP.loginUserid=wasadmincom.ibm.SOAP.loginPassword=mypassword
● Can save a massive amount of time over a Connections rollout project...
Monday, 18 January 2010
#7) TDI is a powerhouse you need to know how to handle
34
● TDI is an incredibly powerful product in its own right● Bundled with Lotus Connections 2.5 and Lotus Domino 8.5 (limited licences)● Principally use TDI through Population Wizard and pre-built Lotus Connections
scripts, e.g.:▬ collect_dns.[bat/sh]▬ populate_from_dn_file.[bat/sh]▬ sync_all_dns.[bat/sh]▬ mark_managers.[bat/sh]
● However, useful to get to know what’s under the covers...
Monday, 18 January 2010
#7) TDI is a powerhouse you need to know how to handle
35
● First, make sure TDI is correctly configured - http://tinyurl.com/lc-tdi-config:▬ Install without Working Directory, and simple install location (e.g. c:\IBM\TDI or /opt/IBM/TDI)▬ Patched to 6.1.1.6▬ Copy TDIPopulation\TDISOL directory from LC2.5 Wizards install package into $TDI_HOME (e.g.
into c:\IBM\TDI\TDISOL)▬ Rename subdirectory to be TDI (e.g. c:\IBM\TDI\TDISOL\win becomes c:\IBM\TDI\TDISOL\TDI)▬ Increase JVM size:
▬ Edit $TDI_HOME/ibmdisrv (Unix) or $TDI_HOME\ibmdisrv.bat (Windows)▬ Change last line:
java" -cp ...▬ to:
java" -Xms256M -Xmx1024M -cp ...▬ Set TDI Solution directory:
▬ Edit $TDI_HOME/TDISOL/TDI/tdienv.[bat/sh]▬ Ensure TDIPATH is set correctly, e.g.
export TDIPATH=/opt/IBM/TDI/▬ or:
SET TDIPATH=C:\IBM\TDI\● There is a temptation to run TDI from Wizards package - don’t!
Monday, 18 January 2010
#7) TDI is a powerhouse you need to know how to handle
36
● Then set options files correctly:▬ profiles_tdi.properties▬ map_dbrepos_from_source.properties
● Use combination of:▬ collect_dns.[bat/sh] and populate_from_dn_file.[bat/sh] to populate new users▬ sync_all_dns.[bat/sh] to sync changes/deletions from LDAP [watch for new
‘perform_deletion_for_sync’ parameter that is part of FixPack 1 or fix LO46673]▬ Recommend the scheduling of these tasks nightly using CRON (Unix) or Scheduled Tasks
(Windows)▬ Check the logs!
Monday, 18 January 2010
#7) TDI is a powerhouse you need to know how to handle
37
● But that is just the start!● Open TDI Config Editor on Windows servers, or install TDI on a Windows
desktop/VM
● Make a backup of profiles_tdi.xml and open the new copy● Get to understand the concepts of Assembly Lines and Connectors● Try creating a modifed version of Assembly Line to import from other resources
(CSV files, databases etc.)● The world is your oyster!● Attend the many TDI sessions at Lotusphere 2010...
Monday, 18 January 2010
38
#8) Install Tricks● Create a "cheat sheet"
▬ You'll find you're doing certain tasks over and over – create a cheat sheet that has all the instructions already typed out so you can simply copy and paste
▬ Perfect example:
Editing config files
Monday, 18 January 2010
39
#8) Install Tricks● Steps (and text to paste
in) to check out, modifyand check back in XMLconfiguration files
Monday, 18 January 2010
40
#8) Install Tricks● Mind Maps
Monday, 18 January 2010
41
#9) Don't let config files scare you ● Particularly for an admin new to the world of WebSphere applications, the
sheer number of configuration files can seem daunting.
● Turns out, there are essentially three different types of config files we need to worry about:
▬ LotusConnections-config.xml▬ notification-config.xml▬ <service>-config.xml (e.g., profiles-config.xml, blogs-config.xml)
Monday, 18 January 2010
42
#9) Don't let config files scare you ● LotusConnections-config.xml
▬ Handles the duties at the “Connections Server” level (a Domino equivalent would be the notes.ini for the server)
▬ Basically, tells the server what services are turned on for any particular instance, and what their address is
Monday, 18 January 2010
43
#9) Don't let config files scare you ● notification-config.xml
▬ As you might suspect, this handles notification information – what SMTP server to use, what to send notifications about, etc.
Monday, 18 January 2010
44
#9) Don't let config files scare you ● <service>-config.xml
▬ You'll have one of these for each of the Connections services you're running on a particular machine:
▬ profiles-config.xml▬ blogs-config.xml▬ activities-config.xml▬ etc.
▬ Each of these handle configuration information specific to the particular service
Monday, 18 January 2010
45
#9) Don't let config files scare you ● To work with them, you simply check them out, edit what you need to edit, and
check them back in
cd /optware/WebSphere/AppServer/profiles/AppSrv01/bin./wsadmin.sh -lang jython -user wasadm -password passw0rd -port 8880execfile("connectionsConfig.py")LCConfigService.checkOutConfig("/optware/tmp","yourserverdev01Node01Cell")
<modify file from another shell connection>
LCConfigService.checkInConfig()
● Then, restart the server
Monday, 18 January 2010
46
#10) Fixes: Fixpacks and iFixes - They are your friends ● The good news is that IBM is continually fixing things
● The bad news is there's a constant stream of new fixes to install
● The good news is that iFixes (Interim Fixes) are periodically rolled up into FixPacks, and installing ONE of those can eliminate installing a bunch of iFixes
▬ For example, Fixpack 1 for Connections 2.0.1 contained 72 iFixes
Monday, 18 January 2010
47
#10) Fixes: Fixpacks and iFixes - They are your friends ● Good news: There is a “Wizard” that you can use to install
iFixes and Fixpacks
● Bad news: The Wizard can only install one iFix at a time (if there are dependencies)
● Good news: You can install multiple iFixes via the command line
Monday, 18 January 2010
48
#10) Fixes: Fixpacks and iFixes - They are your friends ● Good news: There is a “Wizard” that you can use to install
iFixes and Fixpacks
● Bad news: The Wizard can only install one iFix at a time
● Good news: You can install multiple iFixes via the command line
● Bad news, the syntax for that command looks like this:
(ready?)
Monday, 18 January 2010
49
/usr/IBM/WebSphere/LotusConnections/update>
chmod +x updateLC.sh
./updateLC.sh -fix -installDir /usr/IBM/WebSphere/LotusConnections
-fixDir /usr/IBM/WebSphere/LotusConnections/update/fixes
-install -fixes <APAR_number_of_fix>
-wasUserId <AdminUserID> -wasPassword <AdminPassword>
Monday, 18 January 2010
#11) Themes belong on the HTTP Server!
50
● Almost every organisation wants to change the default ‘OneUI’ theme colours, or at least the Lotus Connections logo
● In default ‘all features’ install, there are 8 copies of the theme, stored within features on WAS servers
● Editing is therefore tricky to do consistently, unless...
● The theme is moved to the HTTP server▬ Only one set of HTML, CSS and images to customize▬ Access can be given to web designer without need to access WAS server▬ Caching of theme content becomes easier, and thus access faster
Monday, 18 January 2010
#11) Themes belong on the HTTP Server!● A theme is made up of multiple components:
▬ CSS, header.html, footer.html and images● CSS:
▬ Controls all of the colours and background images▬ Allows Web Designer to make changes to elements like link colours and background images▬ <Profile_Home>/installedApps/<nodename>/<feature EAR>/<feature WAR>/nav/common/styles/
defaultTheme/defaultTheme.css● Header.html:
▬ Controls appearance of banner, including logo and feature tabs▬ May include link to CSS file▬ Found in: <Profile_Home>/installedApps/<nodename>/<feature EAR>/<feature WAR>/nav/
templates/header.html● Footer.html
▬ Controls appearance of footer▬ Great place to add links to other corporate sites, resources or tools▬ Default has many IBM-specific links▬ Found in: <Profile_Home>/installedApps/<nodename>/<feature EAR>/<feature WAR>/nav/
templates/footer.html
51
Monday, 18 January 2010
#11) Themes belong on the HTTP Server!● Images:
▬ Directory contains 400+ images used to build a Connections page▬ Found in <Profile_Home>/installedApps/<nodename>/<feature EAR>/<feature WAR>/nav/common/
styles/images▬ Many images are transparent and can be used across all themes▬ Others are closely tied to default theme colour scheme,and must be regenerated - not so many with
2.5
52
2.0.x vs. 2.5
Monday, 18 January 2010
#11) Themes belong on the HTTP Server!● Five step process:
▬ Move default theme to HTTP Server▬ Configure LC2.5 to use HTTP-based theme▬ Test▬ Customise theme▬ Test
● Create directory on HTTP server for theme:▬ e.g. c:\IBM\HTTPServer\htdocs\en_US\mytheme, /opt/IBM/HTTPServer/htdocs/en_US/mytheme
● Create sub-directory for css and html:▬ e.g. c:\IBM\HTTPServer\htdocs\en_US\mytheme\css_html, /opt/IBM/HTTPServer/htdocs/en_US/
mytheme/css_html● From profiles application:
▬ Copy across header.html, footer.html, defaultTheme.css and themeImages directory into mytheme/css_html
● Copy images directory into mytheme/images▬ e.g. c:\IBM\HTTPServer\htdocs\en_US\mytheme\images, /opt/IBM/HTTPServer/htdocs/en_US/
mytheme/images
53
Monday, 18 January 2010
#11) Themes belong on the HTTP Server!● Move default theme to HTTP Server
▬ Create directory on HTTP server for theme:▬ e.g. c:\IBM\HTTPServer\htdocs\en_US\mytheme,
/opt/IBM/HTTPServer/htdocs/en_US/mytheme▬ Create sub-directory for css and html:
▬ e.g. c:\IBM\HTTPServer\htdocs\en_US\mytheme\css_html, /opt/IBM/HTTPServer/htdocs/en_US/mytheme/css_html
▬ From profiles application:▬ Copy across header.html, footer.html, defaultTheme.css and themeImages directory into
mytheme/css_html ▬ Copy images directory into mytheme/images
▬ e.g. c:\IBM\HTTPServer\htdocs\en_US\mytheme\images, /opt/IBM/HTTPServer/htdocs/en_US/mytheme/images
▬ Check you can access the files via a browser, e.g.:▬ http://connections.myorg.com/mytheme/images/logo.png▬ http://connections.myorg.com/mytheme/css_html/header.html▬ http://connections.myorg.com/mytheme/css_html/footer.html▬ http://connections.myorg.com/mytheme/csss_html/defaultTheme.css
54
Monday, 18 January 2010
#11) Themes belong on the HTTP Server!● Configure Connections to use HTTP-based theme
▬ Edit LotusConnections-config.xml *▬ Search for ‘style enabled’, change lines:
▬ to:
▬ Save file
55
<style enabled="false"><!-- leave "admin_replace" for any fields you do not wish to override --><header url="admin_replace"/><footer url="admin_replace"/><images ssl_url="admin_replace" url="admin_replace"/><caching value="private, max-age=3601"/></style>
<style enabled="true"><!-- leave "admin_replace" for any fields you do not wish to override --><header url="http://connections.myorg.com/mytheme/css_html/header.html"/><footer url="http://connections.myorg.com/mytheme/css_html/footer.html"/><images ssl_url="https://connections.myorg.com/mytheme/images" url="http://connections.myorg.com/mytheme/images"/><caching value="private, max-age=3601"/></style>
* Using appropriate wsadmin commands to checkin/checkout
Monday, 18 January 2010
#11) Themes belong on the HTTP Server!● Configure Connections to use HTTP-based theme
▬ Tell Connections to use CSS from mytheme directory▬ Edit mytheme/css_html/header.html, add relative (not absolute) link to CSS file just below
<div class=”lotusInner”>:
▬ Save file. Restart WAS. Restart HTTP.● Test
▬ Access the site via a browser▬ Should see Connections appearing same as previously, but with
images, header and footer from HTTP site ▬ Test by ‘View Image’ on Lotus Connections logo, or by adding
comment to HTML files and using ‘View Source’● Now you’re ready to customise the theme! ● (Look out for session AD301 Customizing Lotus
Connections, Tuesday 11:15 in SWAN 5-6)
56
<div class="lotusRightCorner"><div class="lotusInner"><link rel="stylesheet" href="/mytheme/css_html/defaultTheme.css" type="text/css">
Monday, 18 January 2010
#12) Ssshh! You can get away with a lot if you’re careful!
57
● The Lotus Connections 2.5 Infocenter is insistent in the regard that things must be done properly, e.g. all edits to XML files must be done via CheckOut/CheckIn, e.g.:
http://publib.boulder.ibm.com/infocenter/ltscnnct/v2r0/topic/com.ibm.connections.25.help/c_admin_profiles_configure_widgets.html
Checking out the widgets-config.xml file for ProfilesTo configure settings in the widgets-config.xml file for Profiles, complete the following steps:1. Use the wsadmin client to access the Profiles configuration files. Use one of the following commands to access the Profiles configuration files: * Stand-alone deployment: execfile("profilesAdmin.py") * Network deployment: execfile("<$WAS_HOME>/profiles/<DMGR>/config/bin_lc_admin/profilesAdmin.py")2. Use the following command to check out the widget configuration file: ProfilesConfigService.checkOutWidgetConfig("<working_directory>", "<cell_name>") where: * <working_directory> is the temporary working directory to which the configuration XML and XSD files will be copied. The files are kept in this working directory while you make changes to them. * <cell_name> is the name of the WebSphere Application Server cell hosting the Profiles feature. This argument is required even in stand-alone deployments. For example: ProfilesConfigService.checkOutWidgetConfig("/wsadminoutput", "jdoe30Node02Cell")3. Navigate to the temporary directory in which you saved the widgets-config.xml file, and then open the file in a text editor and make the required changes.4. Save your changes and check the widgets-config.xml file back in using the following command: ProfilesConfigService.checkInWidgetConfig()
Monday, 18 January 2010
#12) Ssshh! You can get away with a lot if you’re careful!● This takes a long time, but does cut out a lot (thought not all) mistakes● For newcomers, stick to the Infocenter advice!
58
Monday, 18 January 2010
#12) Ssshh! You can get away with a lot if you’re careful!
59
● For more experienced folks:▬ Take a backup of the XML file (do NOT leave it with a .xml extension!)▬ Edit the XML▬ Check the XML for validity, using a command line tool, web-based tester or by opening in a web
browser (this is the default behaviour for .xml files on Windows anyway)▬ Once satisfied of the validity of your changes, then synchronize node (if appropriate) and stop/start
servers● Saves a significant amount of time● But beware! A mistake in an XML file can cause an entire server or (in the case
of LotusConnections-config.xml) the whole of Connections to fail to start
Monday, 18 January 2010
#12) Ssshh! You can get away with a lot if you’re careful!● Other areas for possible corner cutting...● Editing JSP elements requires unpacking and repacking of .jar files
▬ There are Java tools to do this, but on Windows it can be easier to:▬ Change extension to .zip▬ Unpack using WinZip or Extract All Files▬ Make the changes you need▬ Repack with WinZip or Send To/Compressed File▬ Rename to replace original .jar file
▬ But... There is no testing as part of this process, so you are strongly advised to test on a separate Connections system and then promote to live under change control
● Editing of CSS files▬ There are some great CSS editing tools out there, particularly from Adobe▬ However, nothing beats being able to edit and preview CSS changes on a live site...▬ Strong recommended to install and use FireBug in the Firefox browser - a free plugin that makes
editing CSS a cinch!
60
Monday, 18 January 2010
61
Agenda● Introductions, housekeeping, etc.
● The “12 Things”
● Summary
Monday, 18 January 2010
62
Summary ...● Installing Lotus Connections really isn't as complicated as it seems ...● Installing 2.5 is much more straightforward than 2.0.x (and light years better
than 1.0.x)● RTFM & Be Prepared● There are some real time-savers (like the check-out/check-in cheat sheet) that
can simplify things dramatically● There is no better way than to test your install process multiple times
● There are LOTS of great sessions this week, so be sure to check them out
Monday, 18 January 2010
Monday, 18 January 2010
64
Contact us ...● We're both ready, willing and (hopefully) able to answer questions.● We're both VERY interested in assisting you on your projects (see, like, ya
know, this is what we do for a living ...)● Contact us!
▬ Stuart [email protected]: stuart_mcintyreTwitter: stuartmcintyre
▬ Rob [email protected]: rob_wunderlichTwitter: rwunder
● Don’t forget your evaluations!
Monday, 18 January 2010
Thank you!
Monday, 18 January 2010
66
Legal Disclaimer© IBM Corporation 2010. All Rights Reserved.
The information contained in this publication is provided for informational purposes only. While efforts were made to verify the completeness and accuracy of the information contained in this publication, it is provided AS IS without warranty of any kind, express or implied. In addition, this information is based on IBM’s current product plans and strategy, which are subject to change by IBM without notice. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, this publication or any other materials. Nothing contained in this publication is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software.
References in this presentation to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in this presentation may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. Nothing contained in these materials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specific sales, revenue growth or other results.
IBM, the IBM logo, Lotus, Lotus Notes, Notes, Domino, Quickr, Sametime, WebSphere, UC2, PartnerWorld and Lotusphere are trademarks of International Business Machines Corporation in the United States, other countries, or both. Unyte is a trademark of WebDialogs, Inc., in the United States, other countries, or both.
IAdobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.IJava and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
IMicrosoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.
Intel, Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.If you reference Linux® in your presentation, please mark the first use and include the following; otherwise delete:Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.Other company, product, or service names may be trademarks or service marks of others.
Monday, 18 January 2010