planning & completing an ibm connections upgrade
TRANSCRIPT
![Page 1: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/1.jpg)
UKLUG 2012 – Cardiff, Wales
Gabriella Davis The Turtle Partnership http://turtleblog.info [email protected]
Planning and Completing An IBM Connections Upgrade
![Page 2: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/2.jpg)
• Admin of all things and especially quite
complicated things where the fun is
• Working with security , healthchecks,
single sign on, design and deployment
of Domino, ST, Connections and things
that they talk to
• Stubborn and relentless problem solver
• Lives in London about half of the time
Let’s talk about me for a minute
![Page 3: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/3.jpg)
Where to start?
![Page 4: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/4.jpg)
Fixes CR Release Upgrade
Goals Critical Features Bugs
Plan Risk Assess Test
WHY
DELIVERABLES?
WHEN?
?
![Page 5: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/5.jpg)
• Register for support updates so you get notified of problems and fixes
• If you have a problem that is resolved by a fix -‐ apply the fix
• If you don't have a problem you have more time to plan
Deciding When / If To Upgrade
![Page 6: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/6.jpg)
• Register for subscriptions • http://www-‐01.ibm.com/software/support/einfo.html • RSS Feed for Connections notifications
Search Fix Central for any updates
![Page 7: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/7.jpg)
Subscription Options By Product
![Page 8: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/8.jpg)
Backup.. backup.. backup.. beep beep
![Page 9: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/9.jpg)
DB2
CUSTOMISATION FOLDER
CONNECTIONS SHARE
WAS DMGR
Backing Up Connections Means Backing Up
TDI
db2 backup database peopledb to d:\ with 2 buffers buffer 1024 parallelism 1 compress without prompting
profiles\dmgr\bin\backupConfig.sh/bat d:\filename.zip -‐nostop
![Page 10: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/10.jpg)
Working With Installation Manager
![Page 11: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/11.jpg)
IM controls all installs and updates to your software
Once you’ve installed something via IM you can’t delete IM without first uninstalling all software it manages
Install the right version of IM in the right directory You can’t move or uninstall it once you start using it
Working With Installation Manager
![Page 12: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/12.jpg)
Reviewing installed software
![Page 13: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/13.jpg)
Installation Manager -‐ View Installed Packages
Reviewing installed software
![Page 14: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/14.jpg)
Installation Manager -‐ Modify, Rollback, Uninstall
![Page 15: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/15.jpg)
Upgrading The Infrastructure
![Page 16: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/16.jpg)
Applying DB2 Fixes• Download the DB2 fix for the fixpack you need from FixCentral
• I prefer to use the Universal server fixpack
• Extract the downloaded file
• for Linux run installFixPack (from universal directory)
• for Windows run setup.exe (from the ESE directory)
Applying WAS Fixes• Using online repository via
Installation Manager
• Downloading fix files from Fix Central
• Apply to every server
• Rolling back fixes
Applying TDI Fixes• Download the fixpack you need from Fix Central
• Extract the zip file into a folder where there should be a new UpdateInstaller.jar
• copy that file into \IBM\TDI\V7.1\maintenance
• Run applyUpdates.bat/sh from \IBM\TDI\V7.1\bin
• -‐queryreg (current components and versions)
![Page 17: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/17.jpg)
db2level
Verifying DB2
![Page 18: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/18.jpg)
Verifying DB2
db2licm -‐l
![Page 19: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/19.jpg)
• applyUpdates.bat/sh -‐update locationofzipfixfile • when all components are updated run query fix again to confirm
Applying TDI Fixes
![Page 20: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/20.jpg)
Applying IBM Connections Application Fixes
01Download the fixes from Fix Central
copy to a “fixes” directory under \IBM\Connections\UpdateInstaller
02From the AppServer\bin directory run setupCmdLine.sh /bat
03Go to a command line and from the UpdateInstaller directory run “updateWizard.bat/sh”
The installer will ask you if you have backed up your customizations -‐ don’t lie to it :-‐)
![Page 21: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/21.jpg)
Updating Connections -‐ Cumulative Releases
![Page 22: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/22.jpg)
• There should be an IBM technote with details of the release • For v5 all the CRs are referenced from the same technote • http://www-‐01.ibm.com/support/docview.wss?uid=swg21683118
• The technote contains details of all the CRs
Planning a Cumulative Release Fix
![Page 23: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/23.jpg)
• The CR update document has things you MUST do and things you CAN do
• MUST DO • Application Updates • DB Schema Updates • Any Filenet or Cognos Updates
MUST Do
![Page 24: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/24.jpg)
• There will also be a list of supported versions for your DB server, for WAS, for LDAP, for Linux and Windows • also check detailed system requirements http://www-‐01.ibm.com/support/docview.wss?uid=swg27042395
CAN Do
![Page 25: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/25.jpg)
WEBSPHERE
OptionalVerify you also install any iFixes with your WAS fix packs
DB2Optional Is your DB2 server used for anything else?
DB2 SCHEMA CHANGES
CONNECTIONS APPLICATIONS
FILENET COGNOS
Required when required, otherwise
never upgrade
![Page 26: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/26.jpg)
WebSphere
from \profiles\Dmgr01\bin\backupConfig.xx <filename> -
nostop
21 3
Customizations
\data\shared\customizations
Databases
db2 backup database peopledb to d:\ with 2
buffers buffer 1024 parallelism 1 compress
without prompting
Updating Connections -‐ Backing Up
![Page 27: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/27.jpg)
• via Installation Manager • Unzip the CR update file e.g. 5.0.0.0-‐IC-‐Multi-‐CR03-‐LO84244.zip (there is a single file for multiple OS)
Updating Connections Applications
![Page 28: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/28.jpg)
Updating Connections Via Installation Manager
![Page 29: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/29.jpg)
Updating Connections Via Installation Manager
![Page 30: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/30.jpg)
• Before starting any Connection servers • Check the logs • c:\programdata\IBM\InstallationManager • \IBM\Connections\version\log • Dmgr SystemOut.log
Verifying The Install Step 1
![Page 31: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/31.jpg)
• The nodeagent on the application server profiles should be started • Dmgr will deploy the updated apps to each node • Monitor SystemOut.log on the Dmgr to verify when the apps are fully deployed
• The actual files are deployed from • \dmgr\config\cells\cellname\applications To • \profilename\config\cells\cellname\applications • the file date/time stamps should match
Verifying The Install Step 2.
![Page 32: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/32.jpg)
• Now is the time to apply the DB schema changes • Download the database updates zip file linked to from the update document http://www-‐01.ibm.com/support/docview.wss?uid=swg21683118 • Use the readme in the SQL directory to find the commands to run • make sure you are logged in as the DB2 administrator • I like to pipe the command to a text file so I can review the output by adding >[outputfile] after each line
Step 3. Stop Here Before Starting Any Connections
![Page 33: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/33.jpg)
If you don’t update the DB Schema the application servers will still start
the applications just won’t work
check SystemOut.log for errors relating to versions of the db schema
![Page 34: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/34.jpg)
• Sync the nodes • Start each server individually, monitoring the SystemOut.log for any errors
• Test every URL works • /files • /blogs • /communities etc • Test the search works by using the search validation URL • <hostname>/search/serverStatus (case sensitive)
After Any Fixes Or Updates
![Page 35: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/35.jpg)
Upgrading Connections -‐ New Releases
![Page 36: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/36.jpg)
Side by Side vs In Place Upgrades
![Page 37: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/37.jpg)
• In place upgrades mean more downtime • No opportunity to test prior to cutover • Any issues that occur in Connections post upgrade have to be fixed immediately
• Test servers enable you to create the data migration xml and bat/sh files first and minimise your downtime when cutting over production
Risks…
![Page 38: Planning & Completing An IBM Connections Upgrade](https://reader033.vdocuments.us/reader033/viewer/2022061306/58adc2541a28ab56468b580d/html5/thumbnails/38.jpg)
Questions