Open Mic IBM connections and IBM Verse on premise integration

Open Mic IBM connections and IBM Verse on premise integration

1. IBM Collaboration Solutions
Open Mic
Date:
IBM Connections and IBM Verse
On Premise Integration
10-08-2017

2. IBM Corporation ©2015
2
Open Mic Team
 Jayesh Parmar - IBM Advisory Software engineer
 Presenter
 Sandeep Deshpande- IBM Staff Software engineer
 Presenter
 Vinayak Tavargeri - IBM Senior Manager and facilitator for Open Mics
2

3. IBM Corporation ©2015
Agenda
 Prerequisite for integration
 Why to integrate ?
 Modifying the configurations
Adding IBM Verse link in connections “Apps”
 Demo
 Q&A
3

4. IBM Corporation ©2015
Prerequisite for integration
IBM Connections 5.5 CR1 (Recommended ) or later
IBM Domino 9.0.1 Fix Pack 7 and above
VOP installed and already configured
Refer the below link for more details
Link->
https://www.ibm.com/support/knowledgecenter/SS4RQV_1.0.0/admin/topics/vop_configuring_ser
ver.html
IHS (IBM HTTP server) installed and configured for SSL
Refer the below link for more details.
Link->
https://www.ibm.com/support/knowledgecenter/en/SSYGQH_5.5.0/admin/install/c_add_ihs_over.
html
4

5. IBM Corporation ©2015
Why to integrate ?
To get images on the people bubbles from your connections profiles
Sharing the files in emails, directly from the
IBM connections
Show business card from IBM connections
5

6. IBM Corporation ©2015
Modifying the configurations
6
IBM HTTP Server Changes
Make a backup copy of httpd.conf
Edit the IBM HTTP Server httpd.conf file and make the following changes
 Remove any comment symbols (#) from the following lines:
LoadModule headers_module modules/mod_headers.so
LoadModule rewrite_module modules/mod_rewrite.so
 Find the following the string <VirtualHost *:443> in the httpd.conf file

7. IBM Corporation ©2015
Modifying the configurations Continued..
7
IBM HTTP Server Changes…
 Copy the following lines and paste them directly in between <VirtualHost *:443> and </VirtualHost>
RewriteEngine on
# Minor change to adjust for Cloud vs On-Premises API variation of parameter name
RewriteCond %{REQUEST_METHOD} PUT
RewriteCond %{QUERY_STRING} ^(.*)uid=(.*)
RewriteRule ^/profiles/photo.do /profiles/photo.do?%1userid=%2 [L]
# Added necessary CORS headers when Origin header present
Header unset Access-Control-Allow-Origin
SetEnvIf Origin "^https://(vop_server_hostname\.)?(domain_name)$" origin_is=$0
Header always set Access-Control-Allow-Origin %{origin_is}e env=origin_is
Header always set Access-Control-Allow-Credentials "true" env=origin_is
Header always set Access-Control-Allow-Headers "X-Requested-With, Content-Type, slug"
env=origin_is
Header always set Access-Control-Allow-Methods "POST, GET, OPTIONS, DELETE, PUT"
env=origin_is
Header always set Access-Control-Max-Age "1000" env=origin_is
Header always set Access-Control-Allow-Methods "POST, GET, OPTIONS, DELETE, PUT"
env=origin_is
# Header always set Access-Control-Allow-Headers "X-Requested-With, Content-Type, Origin,
Authorization, Accept, Client-Security-Token, Accept-Encoding, slug" env=origin_is
Header always set Access-Control-Allow-Headers "X-Requested-With, Cache-Control, Content-
Language, Content-Type, Expires, Last-Modified, Pragma, slug, X-Update-Nonce" env=origin_is
Header always set Access-Control-Expose-Headers "Content-Disposition, Content-Encoding,
Content-Length, Date, Transfer-Encoding, Vary, ETag, Set-Cookie, Location, Connection, X-UA-
Compatible, X-LConn-Auth, X-LConn-UserId" env=origin_is
# Added a rewrite to respond with a 200 SUCCESS on every OPTIONS request.
RewriteCond %{REQUEST_METHOD} OPTIONS
RewriteRule .* - [R=200,L]
# Remove the Origin header if it exists for other requests (POST, GET, DELETE, PUT). Causes
problems with Connections returning 403 response.
RequestHeader unset Origin env=origin_is

8. IBM Corporation ©2015
Modifying the configurations Continued..
8
IBM HTTP Server Changes…
 Find the following line in the pasted text:
SetEnvIf Origin "^https://(vop_server_hostname\.)?(domain_name)$" origin_is=$0

Edit this line:
Replace vop_server_hostname with the host name portion of the Verse On-Premises mail server name.
Replace domain_name with the domain of the Verse On Premises mail server.
Escape with a backslash (\) any periods in the names. Add a separate line for each of your mail servers. For example, assume
that your Connections server is https://connections.renovations.com and that your mail servers are:
https://mail1.uk.renovations.com
https://mail2.us.renovations.com
https://mail3.jp.renovations.com
In this case we have SetEnvIf Origin "^https://(connect\.)?(in\.ibm\.com)$" origin_is=$0

9. IBM Corporation ©2015
Modifying the configurations Continued..
9
IBM Domino Server Changes…
 To enable Verse users to connect to the Connections server, add the following line to the to
the Domino servers notes.ini
VOP_LLN2_BSSUIServer_URL=https://ibm_http_server_hostname
Notes: If the setting is the last line in the notes.ini file, press ENTER after the line.
Restart the Domino server by issuing the below command
Restart server
In this case we have VOP_LLN2_BSSUIServer_URL=https://sjconnect.in.ibm.com

10. IBM Corporation ©2015
Adding IBM Verse link in connections “Apps”
10
Customizing IBM connections navigation bar.
 Create following directory in the IBM connections customization common folder
nav\template\menu
Copy the header.jsp and apps.jsp from the below directory of installed IBM connections folder
WebSphere\AppServer\profiles\AppSrv01\installedApps\SJCell01\Homepage.ear\homepage.war\nav\templates
WebSphere\AppServer\profiles\AppSrv01\installedApps\SJCell01\Homepage.ear\homepage.war\nav\templates\menu
Adding “IBM Verse” within connections
navigation bar in “Apps” menuAd

11. IBM Corporation ©2015
Adding IBM Verse link in connections “Apps” continued..
11
Open the apps.jsp file and insert the below code
Note: The url are your Domino server and image source is on the
Domino server. Image of the verse can go in
Domino\data\domino\html. Verse image as shown above can be
used
Copied files shows as below
Code to append:
IBM Verse

--%><tr><%--
--%><th scope="row" class="lotusNowrap"><%--
--%><img src="https://connect.in.ibm.com/verse.png" /><%--
--%><a href="<c:out value="https://connect.in.ibm.com" />/"><%--
--%><strong>IBM Verse</strong><%--
--%></a><%--
--%></th><%--
--%></tr><%--

12. IBM Corporation ©2015
Adding IBM Verse link in connections “Apps” continued..
12
Changes in the apps.jsp looks as below
Save the changes and restart the IBM connections application server post restart it will take the
changes and shows IBM Verse in the Apps menu.

13. IBM Corporation ©2015
3/4/15
DEMO

14. IBM Corporation ©2015
References
VOP Integrating with Connections
https://www.ibm.com/support/knowledgecenter/SS4RQV_1.0.0/admin/topics/vop_integrating_with_
connections.html
IBM Domino VOP Installation and configuration
https://www.ibm.com/support/knowledgecenter/SS4RQV_1.0.0/welcome/vop_welcome.html
14

15. IBM Corporation ©2015
Questions?
Visit our Support Technical Exchange page or our Facebook page for
details on future events.
To help shape the future of IBM software, take this quality survey and share
your opinion of IBM software used within your organization:
https://ibm.biz/BdxqB2
15
IBM Collaboration Solutions Support page
http://www.facebook.com/IBMLotusSupport
IBM Collaboration Solutions Support
http://twitter.com/IBM_ICSSupport
15

16. IBM Corporation ©2015
Thank You