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

No comments: