Showing posts with label IBM Connections. Show all posts
Showing posts with label IBM Connections. Show all posts

Monday, May 28, 2012

IBM Connection 3.0.1.1 update to CR1

See my notes from installing Cumulative Refreshe 1  (CR1)

I did not make any changes in themes or other LC files so I do not need to backup them, before installation.

IBM page with CR1: http://www-304.ibm.com/support/docview.wss?uid=swg21595154&myns=swglotus&mynp=OCSSYGQH&mync=E

  1. It is good idea to make a shapshot of your servers (I made snapshots for my DB and WAS server)
  2. I started DB server and DMGR ... it must be started during installation
  3. I used latest Update installer Download Update Installer 3.0.1.x-IC-Multi-UPDI-20120403 (downloaded from IBM FixCentral).
  4. Ok, after you download Update Installer, delete or backup /opt/IBM/LotusConnections/updateInstaller and extract updateinstaller in  /opt/IBM/LotusConnections/ - it will make folder updateinstaller again. 
  5. Download all (depends what parts of LC did you install) CR jar/zip files in to /opt/IBM/LotusConnections/updateInstaller/fixes. If there are any zip, extract them.
  6. To run /opt/IBM/LotusConnections/updateInstaller/updateWizard.sh add execute permissnion on this file
    1. [root@ic ~]# cd /opt/IBM/LotusConnections/updateInstaller
    2. [root@ic updateInstaller]# chmod +x updateWizard.sh
    3. Make sure you have xserver started - you will be able to run graphic installation wizard.
    4. Setup was home path: [root@ic updateInstaller]# cd /opt/IBM/WebSphere/AppServer/bin
    5. Run: [root@ic bin]#. ./setupCmdLine.sh
    6. [root@ic updateInstaller]# cd -
    7. [root@ic updateInstaller]# ./updateWizard.sh
  7. Update Wizard for Lotus Connections 3.0.1.1 will be launched. 
    1. Click NEXT
    2. Select Install updates and make sure there is path in to folder with jar files sfom step 5.
    3. Click NEXT, on Update Selection page, depends on your installation, select what you want to install (In my case wizard selected all). Click NEXT.
    4. I selected "I have not made any changes to IBM Connections application files." >> OK
    5. Fill in your DMGR admin account and password. Click NEXT and wait for Validation success >> Click OK
    6. Click INSTALL and go with your dog for a walk ... it will take some time to install.
    7. After successful update installation start all nodes and node agents and perform a full synchronization to push the update to all nodes. 

Wednesday, April 25, 2012

IBM Connections - CLFRW0493E: Unable to start the document indexing service

I found in IBM Connectios 3.0.1.1 log this error:


000014ef DocumentIndex E com.ibm.lotus.connections.search.service.files.impl.DocumentIndexingServiceImpl isEnvironmentValid CLFRW0493E: Unable to start the document indexing service, please ensure that the PATH environment variable has been set.

After some Googling, I found this post where author set up paths as follows:

export PATH=/opt/IBM/LotusConnections/data/search/stellent/dcs/oiexport:$PATH
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/IBM/LotusConnections/data/search/stellent/dcs/oiexport



Sinc I have only one node cluster I will use path containing shared folder:


export PATH=/opt/IBM/LotusConnections/data/shared/search/stellent/dcs/oiexport:$PATH
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/IBM/LotusConnections/data/shared/search/stellent/dcs/oiexport


So I edited /opt/IBM/WebSphere/AppServer/bin/setupCmdLine.sh and added this two lines on the end of the file. I stopped websphere/connections and servers OS too.



Tuesday, April 17, 2012

How to change notification e-mail sender address - IBM Connections

How to change notification e-mail sender address - IBM Connections

You must export notification-config.xml file and edit email information in it and import file in to configuration again.
  • [root@ic bin]# cd ../profiles/Dmgr01/bin/
  • [root@ic bin]# ./wsadmin.sh -lang jython
  • wsadmin>execfile("connectionsConfig.py")
    • wsadmin>LCConfigService.checkOutNotificationConfig("/root/","icCell01")
    • change email in exported xml file ans import it again
    • wsadmin>LCConfigService.checkInNotificationConfig("/root/","icCell01")
    • wsadmin>synchAllNodes()
    • wsadmin>quit

Friday, April 13, 2012

IBM Connections - Duplicate headers recivied from server error

There is bug when you using Chrome and try to download any file from IBM Connections 3.0.1:



Browser error:
Duplicate headers recivied from server


Problem is in not valid (RFC) header, which including a ","  but there should be a ";" 



Response.AddHeader("Content-Disposition", "attachment, filename=\"" + filename + "\"");
Response.AddHeader("Content-Disposition", "attachment; filename=\"" + filename + "\"");

Fast solution is to put directive command in to Apache/IHS httpd.conf file:

Header edit Content-Disposition ^(.*)creation-date=(.*);\smodification-date=(.*);$ "$1creation-date=\"$2\"; modification-date=\"$3\";"



Or install IBM Connections 3.0.1 FixPack 1


IBM Connections 3.0.1 and iPad/iPhone native application

Hi there,

After I installed IBM Lotus Connections, I tried to install  native application for iPad - IBM Connections 3.1.1. The installation was easy, I fill my connection server hostname, my user name and password, after this I got an error:

The URL <hostname> is not a valid IBM Connections Mobile server.

I sent a logs file from my iPad (click on Info icon under the login form and click Send Logs) You will get it by email.

In log I found root problem:
"Received response. HTTP response http://<hostname>/homepage/Configuration Status: 404 (not found)"

And the solution is:
install this FixPack and Interim Fix




refresh pack: 3.0.1.0-IC-Multi-Mobile-IFLO67638 (12.28 MB)


  1. Stop a cluster from WAS integrated solition console or from a command line
  2. [root@ic updateInstaller]# cd /opt/IBM/WebSphere/AppServer/bin/
  3. [root@ic bin]# . ./setupCmdLine.sh
  4. [root@ic bin]# cd /opt/IBM/LotusConnections/
  5. [root@ic LotusConnections]# mv updateInstaller/ updateInstaller-old/
  6. [root@ic LotusConnections]# mv /opt/install/FIX/3.0.1.0-IC-Multi-UPDI-20120220.zip .
  7. [root@ic LotusConnections]# unzip 3.0.1.0-IC-Multi-UPDI-20120220.zip
  8. [root@ic LotusConnections]# cd updateInstaller/
  9. [root@ic updateInstaller]# cd fixes/
  10. [root@ic fixes]# mv /opt/install/FIX/3.0.1.0-IC-Multi-Mobile-IFLO67638.zip .
  11. [root@ic fixes]# unzip 3.0.1.0-IC-Multi-Mobile-IFLO67638.zip
  12. [root@ic /]# cd /opt/install/FIX/updateInstaller/
  13. [root@ic updateInstaller]# chmod +x update*
  14. [root@ic updateInstaller]#./updateWizard.sh
  15. Select option: Install Updates > click NEXT > select our fix > click NEXT > enter administrator user name and password > and continue to install it.
  16. After resynchronize all nodes and the start cluster




Wednesday, April 11, 2012

IBM Connections 3.0.1 on RHEL - how to install - 9. Post-Installation Tasks

Post-Installation Tasks


Finally, we have installed IBM Lotus Connections product, but there are some more important post installation steps! Lets go to finish them!

  1. Configure HTTP server
    1. Open  http://ic.ys.cz:9060/admin and log in as wasadmin
    2. [root@ic bin]# cd /opt/IBM/HTTPServer/bin/
    3. start Administration server: [root@ic bin]# ./adminctl start
    4. Create new node to manage http server with dmgr server ... navigate to System administration > Nodes > click Add Node 
      1. select  Unmanaged node click NEXT
      2. Name: webserver1node
      3. HostName: <FQDN>
      4. Platform Type: Linux > OK > SAVE
    5. Go to create a new WebServer definition ... navigate to Servers > Server Types > Web servers > and click New
      1. Select node: webserver1node
      2. Server name: webserver1
      3. Type: IBM HTTP Server
      4. Click NEXT > NEXT
      5. Port: 80
      6. Web server installation root: /opt/IBM/HTTPServer
      7. Plug-in installation root: /opt/IBM/HTTPServer/Plugins
      8. Administration Server Port: 8008
      9. Username: ihsadmin
      10. Password: <yourpass>
      11. Confirm password:  <yourpass>
      12. Click NEXT
      13. Click FINISH ans SAVE
    6. Check webserver1 checkbox and click Start button - it should start the server. If not you can reset password:
      1. Switch to the HTTPServer_installdir/bin directory on your machine.
      2. Type the following command:
      3. ./htpasswd -b ../conf/admin.passwd user password
      4. where user and password are the user ID and password that you want to have administrative authority for IBM HTTP Server. 
    7. Resynchronize all nodes.
    8. Generate plug-in configuration file ... navigate again to the webservers (same as step 5).
      1. Select webserver1 and click Generate Plug-in and them click Propagate Plug-in
      2. Note: Make sure, you will see in a Message dialog box same path to plugin-cfg.xml as is in IHS httpd.conf (last line of the file) file saved in /opt/IBM/HTTPServer/conf/httpd.conf 
      3. Restart webserver
    9. Navigate to Servers > Web servers > webserver1 > Plug-in properties and click Copy to Web server key store directory
    10. Setup HTTP over SSL with self signed certificate
      1. [root@ic ~]# cd /opt/IBM/HTTPServer/
      2. [root@ic ~]# mkdir  keyfiles
      3. [root@ic ~]# cd bin
      4. [root@ic bin]# ./ikeyman
      5. In IBM Key Management click New
        1. Key database type: CMS
        2. File Name: webserver-key.kdb
        3. Location: /opt/IBM/HTTPServer/keyfiles
        4. Click OK
        5. Enter your password and select Stash password to a file
        6. Click OK
      6. In IBM Key Management click Create a new self-signed certificate
        1. Key Label: LC Self Signed
        2. Version: X509 V3
        3. Key Size: 1024
        4. Signature Algorithm: SHA1WithRSA
        5. Other options are optional (set them as you wish) 
        6. Click OK and close ikeyman
      7. Stop HTTP server and edit httpd.conf file
        1. [root@ic bin]# cd ../conf/
        2. backup file: [root@ic conf]# cp httpd.conf httpd.conf.bak
        3. Edit file and add following lines to the bottom of the file:
          LoadModule ibm_ssl_module modules/mod_ibm_ssl.so
          <IfModule mod_ibm_ssl.c>
            Listen 0.0.0.0:443
            <VirtualHost *:443>
              ServerName ic.ys.cz
              SSLEnable
            </VirtualHost>
          </IfModule>
          SSLDisable
          Keyfile "/opt/IBM/HTTPServer/keyfiles/webserver-key.kdb"
          SSLStashFile "/opt/IBM/HTTPServer/keyfiles/webserver-key.sth"
        4. start HTTP server and test https url on port 80
          1. [root@ic conf]# ../bin/apachectl -k start
          2. Open browser and go to https://<yourhostname>
          3. You should get info about certificate - it is not a trusted certificate (because it is self-signed certificate)
      8. Add our cert among trusted ones in WAS Trust Store
        1. Navigate in Security > SSL Certificate and Key Management > Key stores and certificates
        2. Click on link  CellDefaultTrustStore
        3. Click on link Signer certificates
        4. Click Retrieve from port
          1. Host: <IHS hostname>
          2. Port: 443
          3. Alias: webserver-ssl
          4. And click Retrieve signer information
          5. Check if it is correct
          6. OK > SAVE
    11. Update Connections URL to use SSL
      1. [root@ic conf]# cd /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin/
      2. [root@ic bin]# ./wsadmin.sh -lang jython
      3. wsadmin> execfile("../config/bin_lc_admin/connectionsConfig.py")
      4. wsadmin> LCConfigService.checkOutConfig("/root/","icCell01")
        • Note: Make sure that you have correct cell name in command
      5. Edit exported file and delete all occurrences of port in href or ssl_href
        1. I deleted all occurrences of  :9081 and :9444 in the file.
      6. Run wsadmin> LCConfigService.checkInConfig()
      7. Run wsadmin> synchAllNodes()
    12. You no what? You are done! Congratulations!  now you can take a look in to documentation how to tuneup your Connections

Friday, April 6, 2012

IBM Connections 3.0.1 on RHEL - how to install - 8. Install Connections

Create IBM Connections DBs

Here we will prepare DB and populate profiles from LDAP
You will need:
  • CZVR1ML  IBM Connections 3.0.1 wizards for Linux x86
  • CZVQ0ML IBM Connections 3.0.1 for Linux x86
  • CZVQ0ML  IBM_Connections301_LinAIX_CZVQ0ML.tar
  1. On database server save these package
    1. Create folder: [root@icdb ~]# cd /opt/install/
    2. [root@icdb install]# mkdir LCWizards
    3. [root@icdb install]# cd /opt/install/LCWizards
    4. [root@icdb LCWizards ]# tar xvf IBM_Connection301_Wzd_zLinux_CZVR1ML.tar
  2. Log-in as db2inst1 (in to graphic xserver)
    1. [root@db2inst1 ~]# cd /opt/install/LCWizards/Wizards/
    2. [root@db2inst1 ~]# ./dbWizard30.sh
      1. Wizard is open click NEXT > select Create click NEXT
      2. in Default installation location: /opt/ibm/db2/V9.7
      3. in database instance: db2inst1 > NEXT
      4. Select all > NEXT > CREATE > EXECUTE
      5. All DBs should finished without no errors, is there any error, try to run the wizard again and select only DB where your error occurred. Note: In my installation I had some error during Bookmarks db creation, so I run wizard again only for Bookmarks DB with success.
  3. We will populate Lotus Connections Profiles from the Domino LDAP directory in next steps:
    1. As root user, go to 
    2. [root@icdb ~]# /opt/install/LCWizards/Wizards
    3. [root@icdb  Wizards]#./populationWizard.sh
    4. Profile population wizard is launched
      1. Click NEXT
      2. Select DB2 Universal Database(TM)
      3. In Profiles database properties set
        1. Host name: icdb.ys.cz  - it is hostname of your db server
        2. Port: 50000
        3. Database name: PEOPLEDB
        4. JDBC driver library path: /home/db2inst1/sqllib/java
        5. User ID: db2inst1
        6. Password: <db2inst1 password>
        7. Click NEXT
      4. In LDAP server connection
        1. LDAP server name: <your ldap hostname>
        2. LDAP server port: 389
        3. Do not check Use SSL communication if it is not configured on LDAP
        4. Click NEXT
      5. LDAP autentication propertise
        1. Bind distinguished name (DN): bind user  / do not put name in format CN=<name>,O=<org>,C=<country>
        2. Enter bind password
        3. Click NEXT
      6. In Base distinguished name and filter for search  enter:
        1. LDAP user search base: c<yourcompany>,o=cz
        2. LDAP user search base: (&(uid=*)(objectclass=inetOrgPerson))
        3. Click NEXT
      7. In Profile database mapping leave all in default, or change mapping as you need. Click NEXT
      8. In Optional database tasks  leave all in default, or change as you need.
        1. select Yes to run the task
        2. Click NEXT 
      9. Click CONFIGURE
      10. Summary could contain some errors ... to determinate what is going on see logs in /opt/install/LCWizards/Wizards/TDIPopulation/TDISOL/linux/logs/PopulateDBFromDNFile.log  or in ibmdi.log


In my case, I had 23 success, 116 duplicate records  (because I run it again - so db table already had users 116 entries), and there is  one failure record (after some investigation, I found there is a wrong value in my Domino filed named "Office Number"). 

I had this in my PopulateDBFromDNFile.log :

CLFRN0209W: WARNING: Validation failed for field officeName. Value is BlablalaSomethingLongerThan32Characters
WARNING: Validation failed for entry CN=Tomas Marny,ou=kotelna,o=ys,c=cz

The value is longer then created column for  officeName  in DB2 ... PROF_PHYSICAL_DELIVERY_OFFICE   is   VARCHAR   with Length 32

To show database description run as db2inst1 this command
  • [root@db2inst1 ~]# db2
  • db2 => connect to database peopledb
  • db2 => describe table empinst.employee

Install IBM Lotus Connections

You should have done: 
  • Installed and fixed DB2 server v9.7.0.2
  • Installed TDI
  • Installed WAS 7.0 with FP 19 and IHS and plugin too 
  • WAS is configured with LDAP (federated repositories)
  • Configured DB2 
  • You must have already populated LDAP profiles to DB2 database
  • It is good idea to make a backup of servers
  • Now we will install Lotus Connections
  1. Start dmgr and node agent
  2. login to application server as root and 
    1. [root@ic ~]# /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin/startManager.sh 
    2. [root@ic ~]# /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/startNode.sh
  3. Try to ping your db server ... if you are unable to resolve db server hostname, add in to /etc/hosts a new line <ip od db server> <FQND> <hostname> and save file. Try again.
  4. Copy JDBC drivers from db server to application server
    1. [root@ic ~]# cd /opt/IBM/
    2. [root@ic ~]# mkdir JDBC
    3. [root@ic IBM]# cd JDBC/
    4. [root@ic JDBC]# scp -r root@192.168.50.128:/home/db2inst1/sqllib/java/* .
  5. Start Connection installer
    1. On application server unpack installer package 
    2. [root@ic CONN]# tar xvf IBM_Connections301_LinAIX_CZVQ0ML.tar
    3. [root@ic CONN]# cd Lotus_Connections_Install/
    4. [root@ic Lotus_Connections_Install]# ./launchpad.sh
    5. In launchpad click Install Lotus Connection 3.0.1
      1. Click Launch the Lotus Connection 3.0.1 install wizard
      2. Ensure that Lotus Connection and  Installation Manager are selected
      3. Click NEXT and click agree license > NEXT
      4. Leave Install Packages in default (/opt/IBM/...) click NEXT > click NEXT
      5. Install all Features click NEXT
      6. Websphere applicatiopn server configuration 
        • Click Browse and  select /opt/IBM/WebSphere/AppServer/
        • Select Dmgr01
        • Enter hostname of application server 
        • Enter Administrator user ID: wasadmin
        • Enter Administrator password: <your password>
        • SOAP port number: 8879
        • Click Validate > in Validation successful dialog Click OK
        • Click NEXT
      7. Topology Configuration
        1. Select SmallDeployment - for production it is recommended to use Medium or Large Deployment
        2. Write in to select list Cluster Name: LCCluster
        3. In Node selection Select your node
        4. Click NEXT
      8. Database Configuration
        1. Enter Database server hostname: <your db host name>
        2. Port: 50000
        3. Specify JDBC Driver to folder from previous step 4 (/opt/IBM/JDBC)
        4. Specify users and  passwords for all DBs (we used db2inst1 user)
        5. Click Validate > in Validation successful dialog Click OK
        6. Click NEXT
      9. Content Store Configuration
        1. Leave in defaults and click Validate
      10. Notification configurations
        1. We will used our Domino as SMTP server too. Configure your SMTP and click NEXT
      11. See summary and click INSTALL
        1. You can watch detailed log:  /opt/IBM/LotusConnections/logs/
        2. After about 30-60 min it should finished vith success and click FINISH
  6. Go to  http://ic.ys.cz:9060/admin
    1. Navigate to  System administration > Nodes > check icNode01 and click Full Resynchronize
      1. to watch status  
      2. [root@ic bin]# tail -f /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/nodeagent/SystemOut.log
  7. Restart DMGR
    1. [root@ic bin]# /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/stopNode.sh
    2. [root@ic bin]# /opt/IBM/WebSphere/AppServer/bin/stopManager.sh
    3. [root@ic bin]# /opt/IBM/WebSphere/AppServer/bin/startManager.sh
    4. [root@ic bin]# /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/startNode.sh
Next post is about important post-installation tasks

Wednesday, April 4, 2012

IBM Connections 3.0.1 on RHEL - how to install - 7. Connect Domino LDAP

In our infrastructure, we already have Domino server installed, so here I am going to show how to configure Federated Repository (add Domino LDAP).

What you will need:

  • You must know FQND or IP of your Domino server
  • LDAP port 389 as standard
  • If your LDAP need to authenticate to reed content, you mast know some account DN and password - this will be used as bind user to bind in to LDAP
  • You should have installed WAS (see previous posts)
  1. Show status of dmgr server 
    1. [root@ic bin]# cd /opt/IBM/WebSphere/AppServer/bin/
  2. [root@ic bin]# ./serverStatus.sh -all -user wasadmin -password Pass4conn
  3. If it is not started already, run: 
    1. [root@ic bin]# cd /opt/IBM/WebSphere/AppServer/bin/startManager.sh
  4. Backup your  wimconfig.xml file before doing any changes in the federated repository configuration
    1. [root@ic bin]# cd /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/config/cells/icCell01/wim/config/
    2. [root@ic config]# cp wimconfig.xml wimconfig.xml.bak
  5. Open web browser and go to  http://<hostname>:9060/admin  
  6. Login with administrator account wasadmin and your password
    1. go to Security > Global security  and in User account repository click Configure... button
    2. In Repositories in the realm table click Add Base entry to Realm...
    3. Click Add Repository and fill
      1. Repository identifier (enter MyLDAP)
      2. Select Directory type: IBM Lotus Domino
      3. Enter Primary host name of your domino server
      4. If you need bind enter bind and password
      5. In Login properties you can add more options to login, I added email so there is uid;mail in the field
      6. Click OK  and enter in to field with label:  Specifies the Lightweight Directory Access Protocol (LDAP) distinguished name (DN) that uniquely identifies this set of entries in the realm root of your Domino LDAP ... I have o=ys,c=cz
      7. Click OK and SAVE
    4. Restart dmgr server:
      1. [root@ic bin]# /opt/IBM/WebSphere/AppServer/bin/stopManager.sh -user wasadmin -password Pass4conn
      2. [root@ic bin]# /opt/IBM/WebSphere/AppServer/bin/startManager.sh -user wasadmin -password Pass4conn
    5. Login again in to web Integrated Solutions Console
      1. Navigate in to Users and Groups > Manage Users
      2. Click on Search button. If the expected set of users is returned then LDAP is configured correctly! Make the same for groups and be sure that members of groups are correct.
    6. Setup SSO
      1. Go to Security > Global security in Authentication expand Web and SIP security and click Single sign-on (SSO)
      2. enter  .ys.cz ... so .<domain>.com  It must start with a dot and continue with domain
      3. Check  Interoperability Mode
      4. OK and SAVE
      5. Go to Security Global security and click on Enable application security 
      6. OK and SAVE
    7. Sync nodes
      1. [root@ic bin]# cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
      2. [root@ic bin]# ./syncNode.sh ic.ys.cz 8879 -username wasadmin -password <your password>
Ok now we will go to Populate Profiles from the LDAP into DB2 tables.

IBM Connections 3.0.1 on RHEL - how to install - 6. Fix WAS, IHS and Plug-in

Because IBM Connections needs to have specific WebSphere Application Server fix pack level (5 or 19), (as you can see in supported HW and SW document) we will install them in this post.

You will need following FixPacks


  1. Create new dir on your application server
    1. [root@ic install]# mkdir WASFix/
    2. Download all FPs running command for each:
    3. [root@ic WASFix]# wget <url from above list>
    4. After you will get all FPs, you shold see
    5. [root@ic WASFix]# ls -al
      drwxr-xr-x 2 root root      4096 Apr  3 17:53 .
      drwxr-xr-x 7 root root      4096 Apr  3 17:38 ..
      -rw-r--r-- 1 root root 110619051 Apr  3 17:57 7.0.0.21-WS-UPDI-LinuxAMD64.tar.gz
      -rw-r--r-- 1 root root  26391437 Apr  3 17:44 7.0.0-WS-IHS-LinuxX64-FP0000019.pak
      -rw-r--r-- 1 root root  43223029 Apr  3 17:48 7.0.0-WS-PLG-LinuxX64-FP0000019.pak
      -rw-r--r-- 1 root root 701712259 Apr  3 18:52 7.0.0-WS-WAS-LinuxX64-FP0000019.pak
      -rw-r--r-- 1 root root  88257374 Apr  3 17:54 7.0.0-WS-WASSDK-LinuxX64-FP0000019.pak total 948444

    6. Make sure, all app servers are shouldtown
      1. To stop DMGR run:
      2. [root@ic WASFix]#  /opt/IBM/WebSphere/AppServer/bin/stopManager.sh -user wasadmin -password <your password>
      3. Make a new folder UPDI under the WASFix folder for extracting the Updateinstaller, and extract it:
      4. [root@ic UPDI]# tar xvfz 7.0.0.21-WS-UPDI-LinuxAMD64.tar.gz
      5. [root@ic UPDI]# cd UpdateInstaller
      6. [root@ic UPDI]# ./install
        1. Installation wizard is opend, click NEXT
        2. Accept license and click NEXT
        3. System prerequisites check should Passed > NEXT
        4. Leave direcotry path in default (/opt/IBM/WebSphere/UpdateInstaller) > NEXT > NEXT to install
        5. After Installation Complete with status Success > Click FINISH
        6. The UpdateInstaller will be launched
      7. [root@ic UPDI]# mkdir /opt/IBM/WebSphere/UpdateInstaller/maintenence
      8. [root@ic UPDI]# cd ..
      9. [root@ic WASFix]# mv 7.0.0-WS-* /opt/IBM/WebSphere/UpdateInstaller/maintenance/
      10. Go back in to launched UpdateInstaller click NEXT
      11. In Product Selection Select AppServer (opt/IBM/WebSphere/AppServer) and click NEXT
      12. Select Install maintenence package and click NEXT
      13. In Maintenence Package Directory Selection leave default (it should be  /opt/IBM/WebSphere/UpdateInstaller/maintenance/) click NEXT 
      14. WASSDK and WAS package should be preselected, click NEXT
      15. Do not select Verify my permissions and click NEXT, after a few minutes, our installation should finished with Success status:
      16. Click RELAUNCH and install fixpacks for IHS and Plug-in - go over 11. to 15 but select in 11. IHS and then Plug-in. 
Actually I was little confused when I tried to install IHS and Plug-in fixpacks. First there is a mistake in IBM Connections 3.0.1 download document. Part Numbers are wrong for 64bit versions of Supplemental packages. Anyway I download the correct ones ... 64bit WAS Supplemental 1 and 2 are C1G36ML and  C1G37ML and not C1G33ML and C1G34MLBut after I installed IHS from 64bit package, command for determining installed version show 32bit again! You can run it as /opt/IBM/HTTPServer/bin/versionInfo.sh
I am afraid there is mistake in versioninfo.sh, because I successfully installed WASJDK, IHS and Plugin FixPack 19 x64 over this IHS and Plug-in also.
We've now finished the “pre-requisite” software install part - all the foundational software we need for Connections is now in place.

Go to next post to configure federated repository with Domino LDAP.


Sunday, April 1, 2012

IBM Connections 3.0.1 on RHEL - how to install - 5. Tivoli Directory Integrator

A content of this post is about installing Tivoli Directory Integrator 7.0 which will be used in IBM Connections instalation.


You will need:
installation packages
and already installed RHEL 5.4 server with graphic environment.

Documentation TDI 7.0
http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.0/welcome.htm

Server FQDN: icdb.ys.cz

TDI installation + FixPack 5 installation

  1. Log in as root and create TDI folder for installation package
    1. [root@icdb ~]# mkdir /opt/install/TDI
    2. [root@icdb ~]# chmod 777 /opt/install/TDI
    3. Download or copy  C1IF4ML.tar  in to created folder TDI
    4. [root@icdb TDI]# cd  /opt/install/TDI/
    5. [root@icdb TDI]# tar xvf C1IF4ML.tar
    6. [root@icdb TDI]# ./launchpad.sh
      1. Launchpad window is opened 
      2. Click to Install IBM Tivoly Directory Integrator in left menu
      3. Click Tivoli Directory Integrator 7.0 installer
      4. Select your preferred language
      5. Click NEXT > NEXT > Accept license > NEXT
      6. Leave installation directory in default
      7. Select Typical installation > NEXT
      8. Select Do not specify > NEXT
      9. Leave ports in default
        • HTTP: 13100
        • HTTPS: 13101
        • Action manager API: 13104
      10. NEXT  > NEXT >
      11. Summary will appear > INSTALL
      12. Uncheck Start the Configuration Editor > FINISH
  2. Apply TDI FixPack 5 - supported by IBM Lotus Connections 3.0.1
    1. [root@icdb ~]# mkdir /opt/install/TDIFix
    2. [root@icdb ~]# cd  /opt/install/TDIFix
    3. [root@icdb TDIFix]# wget ftp://dispsd-8.boulder.ibm.com/ecc/sar/CMA/TIA/00zbo/1/7.0.0-TIV-TDI-FP0005.zip
    4. [root@icdb TDIFix]# unzip 7.0.0-TIV-TDI-FP0005.zip
    5. [root@icdb TDIFix]# cd 7.0.0-TIV-TDI-FP0005
    6. [root@icdb 7.0.0-TIV-TDI-FP0005]# cp UpdateInstaller.jar
    7. [root@icdb 7.0.0-TIV-TDI-FP0005]# cp UpdateInstaller.jar /opt/IBM/TDI/V7.0/maintenance/
      • overwrite existing UpdateInstaller.jar
    8. [root@icdb 7.0.0-TIV-TDI-FP0005]# cd /opt/IBM/TDI/V7.0/bin/
    9. [root@icdb bin]# ./applyUpdates.sh -update /opt/install/TDIFix/7.0.0-TIV-TDI-FP0005/TDI-7.0-FP0005.zip
    10. Check information about fixpack running command:
      • [root@icdb bin]# ./applyUpdates.sh -queryreg
Output of the command should be similar
Information from .registry file in: /opt/IBM/TDI/V7.0
Edition: Identity
Level: 7.0.0.5
License: None

Fixes Applied
=-=-=-=-=-=-=
TDI-7.0-FP0005(7.0.0.0)

Components Installed
=-=-=-=-=-=-=-=-=-=
BASE
SERVER
   -TDI-7.0-FP0005
CE
   -TDI-7.0-FP0005
JAVADOCS
EXAMPLES
   -TDI-7.0-FP0005
EMBEDDED WEB PLATFORM
AMC
   Deferred: false

Ta daaa ...  you are done with TDI!

Next part is here: how to install Fix WAS, IHS and Plug-in

Saturday, March 31, 2012

IBM Connections 3.0.1 on RHEL - how to install - 4. Database Server DB2

Now we will prepare our DB2 server for IBM Connections.


You will need:
installation packages

  • CZ19NEN  IBM DB2 Enterprise Server Edition V9.7 for Linux x86-64​
  • CZ381ML   DB2_ESE_Restricted_QS_Activation_97.zip
  • v9.7fp2_linuxx64_universal_fixpack.tar.gz

and already installed RHEL 5.4 server with graphic environment.

FQDN: icdb.ys.cz

DB2 Installation pre-requisites 

  1.  After standart installation disable SELinux and Firewall
  2. Change hostname 
    1. run command:  [root@icdb ~]# system-config-network 
    2. and change hostname to icdb.ys.cz
  3. Create installation directory
    1. [root@ icdb   ~]# mkdir -p /opt/install/DB2
    2. [root@ic ~]# chmod 777 -R /opt/install/
  4. OPTIONAL - If you run in vmware infrastructure install vmware tools
    1. Mount vmware tools image and install it
    2. [root@icdb media]# mkdir -p /media/cdrom
    3. [root@icdb media]# mount /dev/hdc /media/cdrom
    4. [root@icdb install]# cd /opt/install/
    5. [root@icdb install]# tar xvzf  /media/cdrom VMwareTools-8.3.7-341836.tar.gz
    6. [root@icdb install]# cd vmware-tools-distrib/
    7. [root@icdb vmware-tools-distrib]# ./vmware-install.pl
    8. Leave all options in default during installation wizard and run  [root@ic vmware-tools-distrib]# reboot
  5. Check installed libs and rpms   http://publib.boulder.ibm.com/infocenter/db2luw/v9r7/topic/com.ibm.db2.luw.qb.server.doc/doc/r0008865.html Try to find all listed files like libpam.so.0 in /lib  or /usr/lib/ direcotry

Install DB2 Server

  1. After download from, save tar in to /opt/install/DB2
  2. extract tar.gz file 
    1. [root@icdb media]# cd /opt/install/DB2
    2. [root@icdb media]# tar xvfz DB2_ESE_Restricted_QS_Activation_97.zip
  3.  Run install wizard (you must be in X or your putty must have in "Categorry> Connection> SSH> X11> checked Enable X11 forwarding" and you must running Xming server on your local Windows workstation)
    1. [root@icdb ese]# ./db2setup
    2. Go trough wizard as follow:
      1. Introduction > NEXT
      2. Software License Agreement > Accept > NEXT
      3. Installation type > Typical > NEXT
      4. Installation action > NEXT
      5. Installation directory > we used /opt/IBM/db2/V9.7  > NEXT
      6. SA MP > Check Do not instal SA MP > NEXT
      7. DAS user> 
        1. Username: dasusr1
        2. Group name: dasadm1
        3. Password: Pass4conn > NEXT
      8. Instance setup > Choose Create a DB2 instance > NEXT
      9. Partitioning option > Single partition instance > NEXT
      10. Instance owning user > 
        1. User name: db2inst1
        2. Group name: db2iadm1
        3. Password:  Pass4conn  > NEXT
      11. Fenced user >
        1. User name: db2fenc1
        2. Group name: db2fadm1
        3. Password:  Pass4conn > NEXT
      12. Tools catalog > Choose Prepare the DB2 tools catalog > NEXY
      13. Notification setup > Do not set up your DB2 server to send notifications at this time > NEXT
      14. Summary > Make sure, that all is ok > FINISH
    3. Setup path to root as db2inst1 has in .bashrc - to be able to run db commands as root
      1. [root@icdb ~]# less /home/db2inst1/.bashrc
      2. Copy following lines
      3. # The following three lines have been added by UDB DB2.
        if [ -f /home/db2inst1/sqllib/db2profile ]; then
            . /home/db2inst1/sqllib/db2profile
        fi
      4. and paste it in to a /root/.bashrc
      5. [root@icdb ~]# vim /root/.bashrc
    4. Reconfigure DB2 installation
    5. Then configure TCPIP communications:
    6. Edit /etc/services (as root), add to bottom of file:
    7. db2inst1 50000/tcp
      DB2_d2binst1_2 60002/tcp
      DB2_db2inst1 60003/tcp
      DB2_db2inst1_1 60004/tcp
      DB2_db2inst1_2 60005/tcp
      DB2_db2inst1_END 60006/tcp
    8. Setup DB2 communications (as db2inst1)
      1. [root@icdb ~]# su - db2inst1
      2. [db2inst1@icdb ~]# cd ~/sqllib
      3. [db2inst1@icdb ~]# . ./db2profile
      4. [db2inst1@icdb ~]# db2 update database manager configuration using svcename db2inst1
      5. [db2inst1@icdb ~]# db2stop;db2start
      6. [db2inst1@icdb ~]# db2 get database manager configuration
      7. [db2inst1@icdb ~]# db2 db2set DB2COMM=tcpip
      8. [db2inst1@icdb ~]# db2stop;db2star
      9. [db2inst1@icdb ~]# telnet localhost 50000
      10. [db2inst1@icdb ~]# exit
    9. Also need to configure DB2 to start automatically, e.g.:
      1. Edit /etc/rc.local as root, add the following:
        #START DB2 for LOTUS CONNECTIONS
        DB2LOG=/tmp/startDB2.out.`date +"%y%m%d"`
        su db2inst1 -c /home/db2inst1/sqllib/adm/db2start >> $DB2LOG 2>&1

DB2 FixPack Installation

  1. Download from FixCentral
  2. Untar v9.7fp2_linuxx64_server.tar.gz
  3. [root@icdb install]# tar xvfz v9.7fp2_linuxx64_server.tar.gz
  4. To stop all DB2 processes, perform the following steps:
  5. Determine which instances are associated with the DB2 copy In our case only db2inst1. Issue the command:
    1. [root@icdb ~]# su - db2inst1
    2. [db2inst1@icdb ~]$ . $HOME/sqllib/db2profile
    3. [db2inst1@icdb ~]$ db2 force applications all
    4. [db2inst1@icdb ~]$ db2 terminate
    5. [db2inst1@icdb ~]$ db2stop
    6. [db2inst1@icdb ~]$ db2licd -end
    7. [db2inst1@icdb ~]$ exit
  6. If the DB2 Administration Server (DAS) belongs to the DB2 copy that you are updating, stop the DAS:
    1. [root@icdb ~]# su - dasusr1
    2. [dasusr1@icdb ~]$ . $HOME/das/dasprofile
    3. [dasusr1@icdb ~]$ db2admin stop
    4. [dasusr1@icdb ~]$ exit
    5. [root@icdb server]# su - db2inst1
    6. [ db2inst1@icdb ~]# $HOME/sqllib/bin/ipclean
    7. [ db2inst1@icdb ~]# exit
  7. Run fix pack installation
    1. [root@icdb ~]# cd /opt/install/DB2Fix/universal
    2. [root@icdb  universal]# ./installFixPack -b /opt/ibm/db2/V9.7/
    3. Make sure, that installation finished with success and without any errors
    4. Note: If you will need to install an ealrier fix pack over currently installed (and higher) use -f level parameter to force db level check. So, go to step 5. and 6. again and then run ./installFixPack -f level -b /opt/ibm/db2/V9.7

License your DB2 

  1. Use IBM Passport Advantage web site to get license key or if you install it from a DVD media, you can find it on.
  2. Find package by Part Number CZ381ML.
  3. Download the part and extract the DB2_ESE_Restricted_QS_Activation_97.zip file in to folder  /opt/install/DB2lic/
  4. Log into DB2 using an db2inst1 admin.
  5. Open a command prompt, change to the directory where the license file is stored, and run the following command:
    • [db2inst1@icdb ~]$ db2licm -a /opt/install/DB2lic/ese_o/db2/license/db2ese_o.lic
  6. Verify that the license is registered by running the following command:
    • [db2inst1@icdb ~]$ db2licm -l 
    • If the license is correctly registered, the details of your DB2 installation are displayed.
  7. Restart DB2.

Setup DB2 instance to run after reboot

  • First you need to configure fault monitor to start during system (os) start:
  • [root@icdb ~]# db2fmcu -u -p /opt/IBM/db2/bin/db2fmcd
  • Now you can enable FMC to automatically start the instance when the system is booted. To enable this feature for instance DB2INST1, type the following command:
  • [db2inst1@icdb ~]$ db2iauto -on db2inst1
  • Try to reboot your server and check if db instance is runningYou can use telnet to localhost on port 50000 or ps -ax | grep db2

In the next chapter we will install TDI on this server

IBM Connections 3.0.1 on RHEL - how to install - 3. IBM HTTP Server and Plug-in

OK, we have installed WebSphere Application Server, so we need HTTP server to access IBM Connections page over port 80.

Install IHS and Plugin

  1. [root@ic ~]# cd /opt/install/WASSupp1
  2. [root@ic WASSupp1]# tar xvfz C1G33ML.tar.gz
  3. [root@ic WASSupp1]# cd IHS
  4. [root@ic IHS]# ./install
  5. Installation wizard is opened click 
    1. NEXT  > Accept license > NEXT 
    2. Your OS should pass compatibility check - see Passed > NEXT > 
    3. in Installation directory /opt/IBM/HTTPServer > NEXT > 
    4. in HTTP Server Administration Authentication 
      1. ihsadmin
      2. Pass4conn
    5. in Setup HTTP Server Administration Server
    6. Check all options
      1. User ID: ihsadmin
      2. Group:  ihsadmins
    7. in IBM HTTP Server Plug/in for IBM WebSphere Application Server
      1. check install plugin
      2. webServer Definition: webserver1
      3. Host name: ic.ys.cz
  6. Installation should finish with IHS and Plugin Success
In the next chapter we will install  DB2 server as db for IBM Connections.

IBM Connections 3.0.1 on RHEL - how to install - 2. Application Server

In this post I will demonstrate how to prepare a server for running WebSphere Application server as base runtime for IBM Connections.


You will need:
installation packages:
  • C1G35ML.tar.gz  WebSphere Application Server Network Deployment V7.0 for Linux on x86-64 bit
  • C1G33ML.tar.gz WebSphere Application Server Network Deployment Supplements V7.0 for Linux on x86-64 bit (1 of 2)​
  • C1G34ML.tar.gz WebSphere Application Server Network Deployment Supplements V7.0 for Linux on x86-64 bit (2 of 2)​
Oupsss!!!  I just tried to install FixPack 19 for IHS and Plugin and an UpdateInstaller is unable to install FP19 for 64bit - wrong architecture is in a log! when I run /opt/IBM/IBMHTTPSrv/bin/versionInfo.sh and it returned me it is 32 bit version ... but in download document they have 64bit.   After small investigation I found, there is mistake in download document! 
64bit WAS Supplemental 1 and 2 are C1G36ML and  C1G37ML and not C1G33ML and C1G34ML
I sent a feedback to IBM so it should be correct soon.
and already installed RHEL 5.4 server with graphic environment.

WAS Installation pre-requisites 

  1. After standard OS installation check hostname if you can ping by FQDN.
  2. Disable SELinux and Firewall!
  3. [root@ic ~]#ping ic.ys.cz   - should works
  4. Edit hosts table
    1. [root@ic ~]#vim /etc/hosts
    2. Add line 192.168.50.125 ic.ys.cz ic
  5. Check umask R
    1. run command: umask
    2. if there is 0022 it is OK, else run command: umask 022
  6. Set the ulimit on your Linux command shells by adding the command to your shell profile script. The shell profile script is usually found under your home directory:
    1. [root@ic ~]# cd ~
    2. [root@ic ~]# vim .bashrc
    3. Enter line: ulimit -n 20480 
    4. Lets save and exit file, and set ulimit to current session too. Run command: 
    5. [root@ic ~]#ulimit -n 20480
    6. You can now check values by command: 
    7. [root@ic ~]# ulimit -a
      core file size (blocks, -c) 0
      data seg size (kbytes, -d) unlimited
      scheduling priority (-e) 0
      file size (blocks, -f) unlimited
      pending signals (-i) 40960
      max locked memory (kbytes, -l) 32
      max memory size (kbytes, -m) unlimited
      open files (-n) 20480
      pipe size (512 bytes, -p) 8
      POSIX message queues (bytes, -q) 819200
      real-time priority (-r) 0
      stack size (kbytes, -s) 10240
      cpu time (seconds, -t) unlimited
      max user processes (-u) 40960
      virtual memory (kbytes, -v) unlimited
      file locks (-x) unlimited
  7. Create installation directory under opt directory
    1. [root@ic ~]# mkdir -p /opt/install/WAS
    2. [root@ic ~]# mkdir /opt/install/WASSupp1
    3. [root@ic ~]# mkdir /opt/install /WASSupp2
    4. [root@ic ~]# chmod 777 /opt/install/
  8. OPTIONAL - If you run in vmware infrastructure install vmware tools
    1. Mount vmware tools image and install it
    2. [root@ic media]# mkdir -p /media/cdrom
      [root@ic media]# mount /dev/hdc /media/cdrom
      [root@ic install]# cd /opt/install/
      [root@ic install]# tar xvzf  /media/cdrom VMwareTools-8.3.7-341836.tar.gz
      [root@ic install]# cd vmware-tools-distrib/
      [root@ic vmware-tools-distrib]# ./vmware-install.pl
  9. Leave all options in default during installation wizard and run  [root@ic vmware-tools-distrib]# reboot
  10. Install all required rpms from installation DVD or other source. See Preparing Red Hat Enterprise Linux 5 for installation http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/topic/com.ibm.websphere.installation.nd.doc/info/ae/ae/tins_linuxsetup_rhel5.html
  11. OPTIONAL - Configure yum to use DVD as a source of packages
    1. [root@ic ~]#  mkdir -p /media/cdrom
    2. [root@ic ~]#  mkdir -p /opt/RHELrepo
    3. [root@ic ~]#  chmod 777 -R /opt/RHELrepo
    4. [root@ic ~]#  cd /media/cdrom/Server
    5. [root@ic Server]#  rpm -ihv createrepo-0.4.4-2.fc6.noarch.rpm
    6. [root@ic RHELrepo]  cd /opt/RHELrepo
    7. [root@ic RHELrepo]  createrepo -vpo /opt/RHELrepo /media/cdrom/Server
    8. [root@ic RHELrepo]  ln -s /media/cdrom/Server Server
    9. Then create a file /etc/yum.repos.d/DVD.repo with the following content:
    10. [dvd]
      name=RHEL4 DVD
      baseurl=file:///opt/RHELrepo
      enabled=1
      gpgcheck=0
    11. run
    12. [root@ic RHELrepo]  yum clean all
    13. [root@ic RHELrepo]  yum update
    14. and you are done, you can use yum to install required rpms without manual solving of dependencies.

WebSphere Application Server 7 installation

  1. Untar WAS installation package and run installer in graphic mode
    1. [root@ic ~]# cd /opt/install/WAS
    2. [root@ic ~]# tar xvfz C1G35ML.tar.gz
    3. [root@ic ~]# ./launchpad.sh
  2. Previous step will open Launchpad in browser window (your terminal must support X). Click on "Launch the installation wizard of WebSphere Application Server network Deployment".
    1. Click NEXT, Accept License > NEXT > NEXT > NEXT >
    2. in Product Installation location set /opt/IBM/WebSphere/AppServer > NEXT
    3. in WebSphere Application Server Environments select Cell option > NEXT
    4. in Enable Administrativ Security set
      1. User name: wasadmin
      2. User name: Pass4conn  > NEXT
    5. > NEXT
    6. in Installation Summary > NEXT
    7. Installation must finish with Success! > FINISH
    8. No you have installed WAS! 
In the next chapter we will install IHS and WebSphere Application Server Plug-in.

IBM Connections 3.0.1 on RHEL - how to install - 1.Overview

Hi all,
This post is about installing a social document sharing software - IBM Connections in version 3.0.1 running on RedHat Enterprise Linux v5.

Architecture

I will install all on 2 servers with 4GB RAM  each. These servers are running in ESXi.
  1. Server ic.ys.cz will contain an application server with IBM Connections.
  2. Server icdb.ys.cz will be used as DB2 server.
  3. I will connect Connections with already installed Domino server (LDAP)

Important sources

IBM Connections 3.0.1 documentation
http://www-10.lotus.com/ldd/lcwiki.nsf/xpViewCategories.xsp?lookupName=IBM%20Connections%203.0.1%20documentation

Download document
http://www-01.ibm.com/support/docview.wss?uid=swg24029336


Connections 3.0.1 System Requirements
http://www-01.ibm.com/support/docview.wss?uid=swg27021342#Red_Hat_Enterprise_Linux_%28RHEL%29_Advanced_Platform

Detailed system requirements for IBM Connections
http://www-01.ibm.com/support/docview.wss?rs=899&uid=swg27012786

DB2 Documentation
http://publib.boulder.ibm.com/infocenter/db2luw/v9r7/index.jsp


TDI 7.0 Documentation
http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.0/welcome.htm


In the next chapter I will show how to prepare our Application Server (WAS) and our Database Server (DB2) as a pre-requisites for IBM Connections installation.