IBM Connections 4.5: Error while accessing IBM Content Manager Library

A customer reported an error while accessing an IBM Content Manager Library within communities. The user got the error message “We are unable to process your request. The library you are trying to access is not available. You can try to load the library again. If this doesn’t work, the library may have been deleted or modified to no longer be visible to you.”

Within the Websphere logs you see java exceptions. The most important ones were:

“CQL5936:  The server is currently unavailable.  The configured object store, ICObjectStore, was not found on the P8 domain ICDomain at corbaloc:rir:/cell/clusters/Cluster1/CCM/Engine.  Contact your system administrator for assistance. ”

and

“FNRCA0031E: API_UNABLE_TO_USE_CONNECTION: The URI for server communication cannot be determined from the connection object  Class=com.filenet.apiimpl.core.ConnectionImpl URI=corbaloc:rir:/cell/clusters/Cluster1/CCM/Engine Parameters={}.”

Solution:

There might be two possible configuration problems:

  1. Make sure that the name of the SSO token is correct.In Websphere Solution Console go to “Security -> Global Security -> Web and SIP Security ->Single Sign-on (SSO)”.

    Check “LTPA V1 cookie name” and “LTPA V2 cookie name”. It must be “LtpaToken” resp. “LtpaToken2”. No other names are allowed and the entry is case sensitive. So make really sure, it looks like that.

  2. Make sure the Generic JVM properties of all servers where the Filenet application is running is set to the same values on all nodes. It can happen that on the secondary nodes some statements are missing.In Websphere Solution Console go to “Servers -> Server Types -> Websphere Application Servers -> <name of the server where Content Manager is running, e.g. “Cluster1_server1″>”. Within the server go to “Server Infrastructure -> Java and Process Management -> Process Definiton -> Additional Properties -> Java Virtual Machines” and check the value in “Generic JVM arguments”.

    It should be the same for this server on all nodes and should look like

    ” -Xgcpolicy:gencon -Djava.awt.headless=true   -Xsoftrefthreshold16     -Xgcpolicy:gencon -Djava.awt.headless=true -DFileNet.EJB.ContextProperties=java.naming.provider.url=! -Dibm.filenet.security.vmmProvider.waltzImpl=true -DenableWaltzIdConversion=true -Dcom.ibm.connections.directory.services.j2ee.security.principal=uid”

    If the statements are missing, add it. Make sure: These statements are only on the server where IBM Content Manager / Filenet applications are running. So you only need to add it there.

After doing a resync of all nodes and restart all servers, the issue should be solved.

Tivoli Directory Integrator: Change UI and Log Language

If you install Tivoli Directory Integrator on a Windows machine where you have set the regional settings to another language than English, the UI and all log messages of TDI appear in the local language instead of English. If you want to change that so that all messages appear in English again you need to to the following steps:

  1. Open “<TDI Program Dir>\ibmditk.bat” in a text editor
  2. Look for the two lines where “eclipsece\miadmin” is called and add “-Duser.language=en” at the end of these lines. They will then look similar to the following lines: 
    

    [codesyntax lang=”dos”]
    

    "%TDI_HOME_DIR%\ce\eclipsece\miadmin" -tdishutdown -noSplash %* -vm "%TDI_JAVAW_PROGRAM%" -vmargs -Dcom.ibm.di.loader.IDILoader.path="%TDI_HOME_DIR%" -Duser.language=en
...
start /B "Tivoli Directory Integrator" "%TDI_HOME_DIR%\ce\eclipsece\miadmin" %* -vm "%TDI_JAVAW_PROGRAM%" -vmargs -Dcom.ibm.di.loader.IDILoader.path="%TDI_HOME_DIR%" -Duser.language=en
    

    [/codesyntax]
    

    

    3. 

  3. Now open “<TDI Program Dir>\ibmdisrv.bat” in a text editor
    4. 

  4. Look for the line starting with “SET LOG4J=” and add ” -Duser.language=en” at the end of this line so it will look similar to[codesyntax lang=”dos”]

    set LOG_4J=-Dlog4j.configuration="file:etc\log4j.properties" -Duser.language=en
    

    [/codesyntax]
    5. 



If you now restart TDI the UI and all messages in the log files will be in English.

	


	
	


				
					
					


		

		

			IBM Sametime Meeting Help not accessable in Notes Sidebar
		

	


	

		
A customer was not able to access the online help for Sametime Meeting within the Notes embedded Sametime client. Neither the “Help Topics” link in the Meeting sideshelf nor the question mark button within a Meeting room did work. The help window appeared but it was empty.


The problem was because the customer had defined a proxy server within the Notes location document but did not exclude “localhost”. The help system tries to contact “http://localhost/…” which is not accessable via the proxy server. After I added “localhost” to the exclusion list, the help pages appeared again as expected.

	


	
	


				
					
					


				
					
					


		

		

			Connectivity Problem with DB2 V10.1 on Suse Linux
		

	


	

		
Today I tried to install IBM DB2 V10.1 on a Suse Enterprise Linux 10.1 SP2. However, although the installation went smoothly with no errors, I was unable to connect to the DB2 server via TCP/IP. The install program told me that the server is using port 50001 but there was no connect and a “netstat -an | grep LISTEN” showed that there was no process listening on port 50001.


I checked /etc/services and there was no entry for port 50001 as well.


Running the command “db2 get dbm cfg | grep “(SVCENAME)” showed that the service name did not seem to be correctly configured as the entry was empty.


So, to solve the problem I ran the following command: “db2 update dbm cfg using svcename db2c_db2inst1” to correctly configre the service name and also added the line “db2c_db2inst1  50001/tcp” to the file /etc/services.


Afterwards I stopped DB2 (“db2stop”) and restarted it again (“db2start”).


A quick check with netstat now shoed that there was a process listening on port 50001 now and I was also able to connect via TCP/IP to the database.


However I still have no glue what caused the problem as it should normally work without these steps.


Update:


Check also (with “db2set -all”) if the variable “DB2COMM=TCPIP” is set correctly. If not, set it with “db2set DB2COMM=TCPIP” and restart DB2 afterwards.

	


	
	


				
					
					


		

		

			IBM Redbook: Installing and Deploying IBM Connections
		

	


	

		
There is a new IBM Redbook available about installing and deploying IBM Connections. Currently it is only available online but a PDF version should be available soon.


Table of Contents:


0.0 Preface


1.0 IBM Connections overview


1.1 The software components and their roles

1.2 What is new in IBM Connections 4

1.3 Architecture Overview

2.0 General deployment considerations and requirements


2.1 Architecture considerations

2.2 Hardware requirements

2.3 Software requirements

2.4 Performance considerations

2.5 Deployment options

3.0 Planning the environment


4.0 Planning Profiles​


5.0 Preinstallation tasks


5.1 Verify software requirements

5.2 Setting up DNS and testing host names

5.3 Setting up LDAP and testing LDAP for data quality

5.4 Populating photo repository

5.5 Verifying operating system installation and disk space available

6.0 Product deployment


6.1 Setting up the Installation Manager

6.2 Installing the database management system

6.3 Installing Tivoli Directory Integrator

6.4 Installing WebSphere Application Server

6.5 Creating databases

6.6 Populating Profiles using propulation wizard

6.7 Installing Cognos Buisness Intelligence

6.8 Installing IBM Connections applications

6.9 Installing IBM HTTP Server

6.10 Postin installation environment configuration

6.10.1 Configuring IBM HTTP Server

6.10.2 Setting the single sign-on domain for future integration

6.10.3 Secure Sockets Layer encryption

6.10.4 Setting the Java Virtual Machine heap size

6.10.5 Creating additional administrator with the WebSphere Integrate Console Solution

6.10.6 Configuring Cognos Business Intelligence

6.11 Post installation IBM Connections configuration

6.11.1 Additional languages

6.11.2 Media components

6.11.3 Configuring and creating search indexes

7.0 High availability and disaster recovery


7.1 Database management systems

7.2 Multiple LDAP servers

7.3 Edge Components Caching Proxy Server

7.3.1 Installing Edge Components Caching Proxy Server

7.3.2 Configuring Edge Components Caching Proxy Server

7.3.3 Configuring SSL support on Edge Components Caching Proxy Server

7.3.3.1 Creating an SSL certificate on Edge Components Caching Proxy server

7.3.3.2 Extracting personal self-signed SSL certificate from IBM HTTP Server

7.3.3.3 Importing an SSL certificate into Edge Components Caching Proxy server

7.3.3.4 Configuring the SSL certificate on the Edge Components Caching Proxy server

7.3.4 Configuring disk cache on Edge Components Caching Proxy server

7.4 Role of load balancers

7.4.1 Installing Load Balancer

7.4.2 Configuring Load Balancer

8.0 Working with IBM Connections mobile


9.0 IBM Connections metrics


10.0 IBM Connections mail


10.1 Features of IBM Connections mail

10.2 Configuring Mail for IBM Connections

11.0 Customizing IBM Connections user experience


12.0 Integrating with other software


13.0 Upgrading from previous versions


14.0 Administering IBM Connections


14.1 Introducing the Integrated Solutions Console

14.2 Working with servers

14.3 Finding and using server logs

14.4 Working with enterprise applications

14.5 Using wsadmin to modify and update application settings

14.6 Where is the IBM Connections data

14.7 Backing up and protecting data

15.0 Performance tuning


16.0 Troubleshooting IBM Connections


16.1 What can be found in WebSphere Application Server logs

16.2 How to troubleshoot IBM Connections Applications

16.3 Adding additional tracing to the logs

16.4 Gathering information for support

16.5 Using the IBM SWG Support Portal to upload files to a PMR

Appendix A.0 IBM Greenhouse


Appendix A.1 The IBM Greenhouse Collaborations Solutions Catalog

Appendix A.2 Searching the IBM Greenhouse Collaboration Solutions Catalog

Appendix A.3 Downloading from the IBM Greenhouse Collaboration Solutions Catalog

Appendix A.3.1 IBM Connections Plug-in for IBM Sametime (Standalone)

Appendix A.3.2 IBM Connections Desktop Plug-in for Microsoft Windows

Appendix B.0 Working with Tivoli Directory Integrator for custom Profiles


Appendix B.1 What is customizable?

Appendix B.2 Creating and using custom functions to manipulate data

Appendix B.3 Creating custom mapping

Appendix B.4 Setting up Tivoli Directory Integrator properties files

Appendix C. Downloading the software from Passport Advantage and PartnerWorld

	


	
	


				
					
					


		

		

			IBM Notes: Missing menu option “File – Application – Install”
		

	


	

		
If you are still missing the option “File -> Application -> Install”  in the menu of the Notes client although you already followed the instructions in this article, then try to set the value “enable.update.ui=true” in the file


[codesyntax  lang=”text”]


…\<notesdata>\Workspace\.metadata\.plugins\org.eclipse.core.runtime\.settings\com.ibm.notes.branding.prefs


[/codesyntax]


Make sure you have closed your Notes client before you make any changes in order to avoid that Notes will overwrite them again while closing.

	


	
	


				
					
					


				
					
					


		

		

			IBM Connections 4.0 CR3 Fixpack Published
		

	


	

		
Since yesterday you can download IBM Connections 4.0 CR3 fixpack from here.


The fix list is available via this link.


Update – 22-03-2013:


An additional fix(COMMON 4.0.0.0 CR3 – LO74465) has been published for CR3. So make sure you also download and install it as well (especially if you have clients accessing Connections 4 CR3 with IBM Notes 9 clients). I have updated the link above to include this as well.


Update – 28-03-2013:


Do not miss the necessary steps for upgrading the metrics database (starting with CR3) and homepage database (starting ith CR2)!