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.

No comments: