Open Mic IBM connections and IBM Verse on premise integration

IBM Collaboration Solutions

Open MicDate:

IBM Connections and IBM Verse On Premise Integration

10-08-2017

IBM Corporation ©20152

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


Agenda

Prerequisite for integration

Why to integrate ?

Modifying the configurations

Adding IBM Verse link in connections “Apps”

Demo

Q&A

3


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_server.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


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


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


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 nameRewriteCond %{REQUEST_METHOD} PUTRewriteCond %{QUERY_STRING} ^(.*)uid=(.*)RewriteRule ^/profiles/photo.do /profiles/photo.do?%1userid=%2 [L]

# Added necessary CORS headers when Origin header presentHeader unset Access-Control-Allow-OriginSetEnvIf Origin "^https://(vop_server_hostname\.)?(domain_name)$" origin_is=$0Header always set Access-Control-Allow-Origin %{origin_is}e env=origin_isHeader always set Access-Control-Allow-Credentials "true" env=origin_isHeader always set Access-Control-Allow-Headers "X-Requested-With, Content-Type, slug" env=origin_isHeader always set Access-Control-Allow-Methods "POST, GET, OPTIONS, DELETE, PUT" env=origin_is

Header always set Access-Control-Max-Age "1000" env=origin_isHeader 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_isHeader 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_isHeader 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} OPTIONSRewriteRule .* - [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 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 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


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


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><%--


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.


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


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 Supporthttp://twitter.com/IBM_ICSSupport

15


Thank You

Open Mic IBM connections and IBM Verse on premise integration

Technology

Transcript of Open Mic IBM connections and IBM Verse on premise integration