Install and configuring the Lotus Quickr library widgets 

Download the Lotus Quickr library widgets and then install and configure them.


Before starting


Before you can use the widgets:


Procedure

  1. In SiteMinder environments only, perform the follow tasks on the IBM connections server:

    1. Copy the US_export_policy.jar and local_policy.jar files from wherever you unpackaged the unrestricted.zip file when configuring SiteMinder. Paste them in the following directory, overwriting the existing versions of those files: 

        <websphere_application_server>/java/jre/Lib/Security

    2. Copy the sm_jsafe.jar and sm_jsafeJCE.jar files from the Siteminder ASA crypto-libraries installation directory. Paste them in the following directory, overwriting the existing versions of those files: 

        <websphere_application_server>/java/jre/lib/ext

  2. Download the Lotus Quickr Library widget war file from the IBM Lotus and WebSphere Portal Business Solutions Catalog web site.

  3. Install the widget war file.

    1. Log in to the WebSphere Administrative Console on the IBM Connections server.

    2. Navigate to Applications -> Application Types -> WebSphere enterprise applications.

    3. Click Install.

    4. Browse and select the comm.communitylibrary.war file, click Next, and then click Next again.

    5. In Step 1 of the installation wizard, click Next without changing anything.

    6. In Step 2, select the cluster and web server (if there is one), and then click Next.

    7. In Step 3 of the installation wizard, in the Target Resource JNDI Name column, click Browse and select communities. Then click Apply. The field is populated with the value jdbc/sncomm. Then check the box and click Next.

    8. In Step 4, check the box and then click Next without changing anything.

    9. In Step 5, type /quickr/connector in the Context Root field, and then click Next.

    10. In Step 6, click Finish.

    11. Click Save to save all changes.

        In clusters wait for synchronization to complete before continuing. Check the systemout.log in the /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/nodeagent directory (on Linux™ servers) to check for the synchronization completed successfully message.

    12. In the list of applications, select the Lotus Quickr Library widgets application and then click Start to start it.

  4. Create a J2C authentication alias for the Lotus Quickr administrator.

    1. On the IBM Connections server, log into the WAS admin console, expand Security, and then select Global Security.

    2. Expand Java Authentication and Authorization Service.

    3. Select J2C authentication data.

    4. Click New.

    5. Type an alias name (for example quickradmin), and specify the user ID and password credentials of a Lotus Quickr administrator.

        Note: If the Lotus Quickr administrative user is not available to IBM Connections (meaning not in the LDAP or defaultFileBasedRepository), then add them to the defaultFileBasedRepository. Navigate to Users and Groups -> Manage Users, and then create a user with the Lotus Quickr administrator ID and password.

      The server generates a J2C alias with a cell name and the alias name you provided, for example: cell01\quickradmin. You must use this generated alias, including the cell name.

  5. Copy the widget configuration files to the IBM Connections configuration directory.

    1. Navigate to the widget \resources_config directory: 

         \IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\<cell_name>\comm_communitylibrary_war.ear\comm.communitylibrary.war\resources_config

    2. Copy the communities-quickr-library-config.xml and communities-quickr-library-config.xsd files to the \LotusConnections-Config directory: 

        \IBM\WebSphere\AppServer\profiles\<profile_name>\config\cells\<cell_name>\LotusConnections-config

        In clustered deployments, copy the files to the \LotusConnections-Config directory on the deployment manager node.

  6. Add the widget resource bundle to LotusConnections-config.xml.

    1. Navigate to the widget \resources directory: 

        \IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\<cell_name>\comm_communitylibrary_war.ear\comm.communitylibrary.war\resources

        In clusters, navigate to the directory on any node.

    2. Copy the contents of the \resources directory to the IBM\LotusConnections\data\shared\customization\strings directory (in clusters, copy to the deployment manager computer).

    3. Check out and open LotusConnections-config.xml. See Edit configuration files.

    4. Add the following line of code into the <resources> element block to register the resource bundle for the Quickr Library widget: 

        <widgetBundle name="com.ibm.quickr.communitylibrary.resources" prefix="quickrCommunityLibrary_res" />

  7. Add the following widget xml definitions to the widgets-config.xml file, editing values to reflect your environment. In clustered deployments, edit the widgets-config.xml file on the deployment manager node. See steps and most attribute descriptions in the topic Enable custom widgets for Communities: 

      <widgetDef bundleRefId="quickrCommunityLibrary_res"
      defId="LinkedQuickrCommunityLib" description="LinkedQuickrCommunityLibDesc" primaryWidget="false" url="/quickr/connector/com.ibm.quickr.communitylibrary.xml" modes="view edit fullpage" iconUrl="{contextRoot}/nav/common/images/iconFiles16.png" uniqueInstance="true" displayLoginRequired="true" helpLink="http://www.lotus.com/ldd/lcwiki.nsf/dx/Using_the_Linked_Lotus_Quickr_library_widget_ic301"> <itemSet> <item name="iframeLoadTimeout" value="30000" /> </itemSet> </widgetDef> <widgetDef bundleRefId="quickrCommunityLibrary_res" defId="QuickrCommunityLib" description="QuickrCommunityLibDesc" primaryWidget="false" url="/quickr/connector/com.ibm.quickr.communitylibrary.xml" modes="view fullpage" iconUrl="{contextRoot}/nav/common/images/iconFiles16.png" uniqueInstance="true" displayLoginRequired="true" helpLink="http://www.lotus.com/ldd/lcwiki.nsf/dx/Using_the_Lotus_Quickr_library_widget_ic301"> <itemSet> <item name="iframeLoadTimeout" value="30000" /> </itemSet> <lifecycle remoteHandlerURL="<remoteHandlerURL>/quickr/connector/lifecycle" remoteHandlerAuthenticationAlias="<remoteHandlerAuthenticationAlias>"> <event>widget.added</event> <event>widget.removed</event> <event>community.members.added</event> <event>community.members.removed</event> <event>community.updated</event> <event>community.visibility.changed</event> <event>community.prepare.delete</event> <event>community.members.modified</event> </lifecycle> </widgetDef>

    Where:

    • In IBM Tivoli Access Manager environments the widgetDef url value must explicitly specify the Quickr server Tivoli Access Manager junction URL. For example, the sample above assumes a URL such as https:// <yourserver.com:port> /lotus and only the /quickr/connector/com.ibm.quickr.communitylibrary.xml part is specified. In Tivoli Access Manager environments specify the entire URL, for example https:// <tam.hostname.com:port> /lotus/quickr/connector/com.ibm.quickr.communitylibrary.xml.

    • The itemSet.item.value attribute is the number of milliseconds Internet Explorer browsers wait to determine if the Lotus Quickr library loaded successfully before showing an error. If Internet Explorer users are seeing only the error page, you can try increasing this value to resolve the issue, particularly if they can see the library in the Firefox browser.

    • {contextRoot} is a variable automatically populated with the Connections directory.

    • <remoteHandlerURL> is the URL of the Connections server on which the widget is installed, for example: https://yourserver.com:9443. If you have TAM enabled on the IBM Connections server, replace yourserver.com with the TAM sever hostname.

    • <remoteHandlerAuthenticationAlias> is the Connections J2C authentication alias used to talk to the servlet. The alias connectionsAdmin is the default for all widgets.

  1. On the IBM Connections server, open communities-quickr-library-config.xml and update the Lotus Quickr information for your environment, for example: 

      <host>quickr.example.com</host>
      <port>10040</port> <sslPort>10035</sslPort> <useSSL>false</useSSL> <authentry>cell01/quickradmin</authentry> <ownersRole>Managers</ownersRole> <membersRole>Editors</membersRole> <publicRole>Readers</publicRole>

      Where:

      • <host> is the Lotus Quickr server hostname. If you have TAM enabled on the Lotus Quickr server, replace yourserver.com with the TAM sever hostname.

      • <port> is the http port number of the Lotus Quickr server. Or if a web server is configured, <port> is the http port number of the web server.

      • <sslPort> is the https port number of the Lotus Quickr server. Or if a web server is configured, <port> is the http port number of the web server.

      • <useSSL> is whether or not to use http or https in communicating with the Lotus Quickr server. If this is set to "true", the Lotus Quickr server must have a certificate that is trusted by the IBM Connections server. See Secure communications using Secure Sockets Layer in the WAS 6.1 documentation for more information.

      • <authentry> is the full name of the J2C authentication alias for the Lotus Quickr administrator that you created in Step 3.

      • For <ownersRole>, <membersRole>, and <publicRole> the role names can be either the role title in English or the id field returned for the roles feed. If anonymous access is not allowed, the publicRole element should be omitted or empty. The publicRole is applied in both public and moderated communities, but is not in restricted communities

  2. In clustered environments, perform a full synchronization of the IBM Connections cluster.

  3. Restart IBM Connections.

  4. If you had IBM HTTP Server installed before you installed the Lotus Quickr widget, follow instructions in Mapping applications to IBM HTTP Server to map the Lotus Quickr widget application to the IBM HTTP Server.


Parent topic

IBM Lotus Quickr Library widgets for IBM Connections


Related tasks


Configure single sign-on between the Connections and Lotus Quickr servers
Add Connections URLs to the Lotus Quickr Resource Environment provider
Enable single sign-on for SiteMinder

+

Search Tips   |   Advanced Search