Tuesday, September 27, 2011

How To Search Sametime Chats by Date and User Using IMtegrity

Recently, a customer requested information on how to search the IBM Lotus Sametime chat repository using Instant IMtegrity and the Lotus Notes advanced search options. The following example shows how an advanced search may be used to in order to perform a custom search of the Sametime chat repository.  

Here is an example below searching by Date and User.


Locate the "More" tab to open up the functionality.




Within this tab, there are a number of search conditions to choose from:





These choices allow for many different scenarios. 



Search criteria are then listed for review: 




Results are returned in a standard format:






Instant IMtegrity is flexible and can supply quick results based on your criteria.  This can be a valuable time saving technique, with the right adjustment.  Instant IMtegrity, combined with the native search and discovery tools provided by Lotus Notes, creates a powerful application to capture, search, and discover IBM Lotus Sametime based chat conversations.

Thursday, September 22, 2011

IQMV4 Websphere 7 Installation Guide

 

Install EAR file

To install your EAR file and run your application, complete the following steps:
  1. Ensure that the server is started.
  2. On the welcome page of Web Sphere Application Server, expand Applications and select Install New Application.
image001

3. Click Browse to navigate to the EAR file that you want to install and then click next.

image002

4. Select Local file system and browse.

image003

5. Select Fast Path and Click Next again.

image004

6. Click Next again until the page Install New Application, which lists the steps for installation, appears

image005

image006

7. Click Save when prompted to save your workspace to the master configuration. After you save installing your EAR file, the welcome page opens.

image007

8. On the welcome page, expand Applications > Enterprise Application.

9. Select the checkbox of the new application that you just installed and click Start to run your application.

image008

10. Selected application started and Icon color changes to green

image009

11. Select the checkbox of the new application that you just installed and click Stop to stop application.

image010

Manage required files and folders

Manage required files and folders
1. Create a folder “C:\TestData” or any other relative path we use to save XML files

2. Paste the following files and folder in it
      a. settings.xml
      b. LdapSettings.xml
      c. ScriptLoadList.xml
      d. ServiceLoadList.xml
      e. Groovy
      f. Templates

3. Browse the following directory of web sphere installed directory
<<Installed directory>>\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\ST852Node01Cell\IQMv4.ear\ITFramework.war\WEB-INF

4. Open the following file in system editor “InterviewContext_script.xml”.

image011

5. Set the folder paths which contain all xml file we save in step 11 and 12 in “InterviewContext_script.xml” file.

image012

image013
Steps to configure XML files
1. Stop the Web Sphere Application Server.

2. Browse the ITQconnect database from Internet explorer.

image014

3. Enter login credential to login database.

4. After successfully Login click
Admin Tab >> Settings link >> GENERAL tab

image015

5. Using scroll bar scroll the page to bottom

6. Copy the selected URL

image016

7. Open the following “C:\TestData\ScriptLoadList.xml” file in system text editor.

image017

8. Replace the following selected url in doc with URL copied in step 6

image018

9. Replace “&” with “&amp;” in Load URL we paste.

image019

10. Also update User Name and Password used to fetch queue definition

image020

11. Save the file “C:\TestData\ScriptLoadList.xml”.

12. Copy the selected URL to start Interviews.

image021

13. Open the following “C:\TestData\ ServiceLoadList.xml” file in system text editor.

image022

14. Replace the following selected url in doc with URL copied in step 12

image023

15. Replace “&” with “&amp;” in Load URL we paste.

image024

16. Also update User Name and Password used to fetch Interview definition

image025

17. Save the file “C:\TestData\ ServiceLoadList.xml”.

Web client configuration steps.

1. Download the Sample web client from below link
http://174.129.5.6/webclient.zip

2. Unzip the folder at specified loction
<<Installed directory>>\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\ST852Node01Cell\IQMv4.ear\ITFramework.war\

3. Browse the following file in system text editor
<<Installed directory>>\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\ST852Node01Cell\IQMv4.ear\ITFramework.war\webclient\properties.js

4. Enter the same time server name here

image026

5. Enter the Web Sphere Application Server Hosting url with running Port number here

image027

6. Save the document after editing.

Steps to start and Stop Web Sphere Application Server

1. To start the Web Sphere Application Server click
start >> All Programs >> IBM WebSphere >> Application Server V7.0 >> Profiles >> AppSrv01 >> Start the server

2. To stop the Web Sphere Application Server click
start >> All Programs >> IBM WebSphere >> Application Server V7.0 >> Profiles >> AppSrv01 >> Stop the server

3. Steps to open administrative console
start >> All Programs >> IBM WebSphere >> Application Server V7.0 >> Profiles >> AppSrv01 >> Administrative console

image028

4. Enter the login credentials

5. After succesfully login

6. On the welcome page, expand Applications > Enterprise Application.

7. Select the checkbox of the new application that you just installed and click Start to run your
application.

image008[1]

8. Selected application started and Icon color changes to green

image009[1]

9. Select the checkbox of the new application that you just installed and click Stop to stop application.

image029

Trouble shooting

Location of log files

1. Browse following directory
<<Installed directory>>\IBM\WebSphere\AppServer\profiles\AppSrv01\logs\server1\

image030

2. Open SystemOut.log or SystemErr.log to read exceptions

3. Other IQMV4 logs are available at
<<Installed directory>>\IBM\WebSphere\AppServer\profiles\AppSrv01\logs

image031

URL to web service

1. Browse the ITQconnect database from Internet explorer.

image032

2. Enter login credential to login database.

3. After successfully Login click

Admin Tab >> Settings link >> GENERAL tab
image033

4. Update the Web Service Wrapper Url
http://websphere:8080/ITFramework/ITApplicationManagerPort?wsdl
image034

5. Click test to check the web service url working or not.
image035

6. If url return result successfully click update.

URL to web client

1. Open Internet Explorer

2. Enter the following URL

image036

3. Webclient chat window open

image037

 

Enabling logging of chats to IQM Queue Logs database


By default logging of chat conversations is disabled. To enable logging take following steps:

1. Stop the Web Sphere Application Server.

2. Install Lotus Notes Client 6.5 or higher on the system running Web Sphere Application Server

3. Associate a Notes ID with the client which can access the Queue Logs database deployed on
Domino server

4. Copy Notes.jar file from Lotus Notes client installation folder to <<Apache Installation <<Installed directory>>\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\ST852Node01Cell\IQMv4.ear\ITFramework.war\WEB-INF \lib folder

5. Edit the InterviewContext_script.xml file located at <<Installed
directory>>\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\ST852Node01Cell\IQMv4.ear\ITFramework.war\WEB-INF folder using any text editor

6. Locate the following snippet
image038

7. Remove the highlighted text to activate the logging service

8. After the edits the snippet should look like the following screenshot
image039

9. Next save the changes and restart the Web Sphere Application Server.

Monday, September 12, 2011

IQMV4 – Linux Installation Steps

1. Download Apache Tomcat Server v6 from the following download URL:
http://mirrors.ibiblio.org/apache/tomcat/tomcat-6/v6.0.33/bin/apache-tomcat-6.0.33.zip

2. Unzip the Tomcat Server to a folder on Linux system

3. Download IQMV4 zip from Instant Technologies server

4. IQM V4 zip needs to be unzipped in the following folder location:
<<Apache Tomcat Directory>>/Tomcat 6.0/webapps/ITFramework

5. Configure Script & Service Load List XML file
These files (ScriptLoadList.xml, ServiceLoadList.xml) are located at the following folder location:
<<Apache Tomcat Directory>>/Tomcat 6.0/webapps/ITFramework

These files contain pointers to the Domino based database which holds the Queue and Interview definitions. It allows the IQM engine to load Queue and Interview definitions and run them.
ServiceLoadList.xml contains reference the URL which contains all the Interview definitions.
ScriptLoadList.xml contains reference the URL which contains all the Monitoring Queue definitions.

Open these files in any text editor to modify them.

Contents of ServiceLoadList.xml look like the following snippet:
<Load>
<NodeType>ServicePath</NodeType>
<AppName/>
<LoadUrl>http://serverFQDN/iqconnect.nsf/agGenerateInterviewServiceLoad?OpenAgent&amp;Key=All</LoadUrl>
<LoadUsername>User present in database ACL</LoadUsername>
<LoadPassword>password</LoadPassword>
</Load>
Contents of ScriptLoadList.xml look like the following snippet:

<Load>
<NodeType>ServicePath</NodeType>
<AppName/>
<LoadUrl>http://serverFQDN/iqconnect.nsf/agGenerateQueueServiceLoad?OpenAgent&amp;Key=Watched</LoadUrl>
<LoadUsername>User present in database ACL</LoadUsername>
<LoadPassword>password</LoadPassword>
</Load>
Update the highlighted text with values specific to your environment.

6. Update Spring bean XML file to contain correct path to IQMV4 configuration files
IQMV 4 contains following configuration XML files:
a) settings.xml
b) LdapSettings.xml
c) ServiceLoadList.xml
d) ScriptLoadList.xml

These files are located at the following folder location:
<<Apache Tomcat Directory>>/Tomcat 6.0/webapps/ITFramework

Path to these files need to be specified in the following file:
<<Apache Tomcat Directory>>/Tomcat 6.0/webapps/ITFramework/WEB-INF/InterviewContext_script.xml

Open InterviewContext_script.xml in any text editor and specify path to the above mentioned XML
files.

7. Configuring Lotus Notes Logging for IQM Chat Conversations
Install IBM Lotus Notes Client as per following FAQ:
http://faq.instant-tech.com/2011/08/installation-of-lotus-notes-client-on.html

Add path to Lotus Notes install folder to Linux environment variables using following FAQ:
http://faq.instant-tech.com/2011/08/configuring-linux-for-notes-api.html

Edit InterviewContext_script.xml to enable Notes Logging bean
Open file in any text editor and locate the following block of text:
<!--
<bean id="ITFDBLoggerService" singleton="true"
   class="com.instant.services.database.ITFDBLoggerService">
 </bean>
-->
Remove the highlighted text to uncomment the bean & make it functional.

8. Starting Apache Tomcat 6.0 server
After making the necessary configuration changes start the Apache Tomcat Server by executing the following file:
<<Apache Tomcat Directory>>/Tomcat 6.0/bin/startup.sh

9. Stopping Apache Tomcat 6.0 server
To stop Apache Tomcat Server execute following file:
<<Apache Tomcat Directory>>/Tomcat 6.0/bin/shutdown.sh