imported>Jason.nicholls: moved Tivoli Service Request Manager pimB to integrations/ibm/ibm.tsrm pimB

2014-07-25T06:25:18Z

moved Tivoli Service Request Manager pimB to integrations/ibm/ibm.tsrm pimB

← Older revision	Revision as of 06:25, 25 July 2014
(No difference)

imported>Teri.roberts at 16:43, 24 June 2014

2014-06-24T16:43:55Z

← Older revision		Revision as of 16:43, 24 June 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:IBM Tivoli Service Request Manager (TSRM) pimB}}		{{DISPLAYTITLE:IBM Tivoli Service Request Manager (TSRM) pimB}}
	[[Category:Integrations]]		[[Category:Integrations]]
	This page documents the enPortal integration for IBM Tivoli Service Request Manager.		This page documents the enPortal integration for IBM Tivoli Service Request Manager (TSRM).

	* <b>Vendor</b>: IBM		* <b>Vendor</b>: IBM
	* <b>Product</b>: Tivoli Service Request Manager (TSRM)		* <b>Product</b>: IBM Tivoli Service Request Manager (TSRM)
	* <b>Supported Version(s)</b>: 7.2		* <b>Supported Version(s)</b>: 7.2
	* <b>Name of enPortal Integration Package</b>: ibm.tsrm_pimB		* <b>Name of enPortal Integration Package</b>: ibm.tsrm_pimB

imported>Teri.roberts at 19:29, 6 February 2014

2014-02-06T19:29:35Z

← Older revision		Revision as of 19:29, 6 February 2014
Line 1:		Line 1:
			{{DISPLAYTITLE:IBM Tivoli Service Request Manager (TSRM) pimB}}
			[[Category:Integrations]]
	This page documents the enPortal integration for IBM Tivoli Service Request Manager.		This page documents the enPortal integration for IBM Tivoli Service Request Manager.

imported>Mike.berman: add instructions for resetting proxy rules after installation

2013-07-12T15:16:16Z

add instructions for resetting proxy rules after installation

← Older revision		Revision as of 15:16, 12 July 2013
Line 42:		Line 42:
	# Click the <b>Start</b> button to load the PIM into the system		# Click the <b>Start</b> button to load the PIM into the system
	# Confirm that the following message is displayed: "Import completed; loaded the following file(s): load_ibm.tsrm_pimB.txt"		# Confirm that the following message is displayed: "Import completed; loaded the following file(s): load_ibm.tsrm_pimB.txt"
			# Under the <b>Advanced</b> tab, select <b>Explore System</b>
			# Navigate to the /Directory/system/proxy/ folder and locate the “Manage Proxy” channel
			# Right-click on the “Manage Proxy” channel and select <b>Open</b> to launch the channel
			# In the Manage Proxy tool, click “Reset All”
			# Refresh the browser

imported>Cmace: copied from internal

2012-10-18T05:22:06Z

copied from internal

New page

This page documents the enPortal integration for IBM Tivoli Service Request Manager.

* Vendor: IBM
* Product: Tivoli Service Request Manager (TSRM)
* Supported Version(s): 7.2
* Name of enPortal Integration Package: ibm.tsrm_pimB
* Required enPortal Version: 4.6.1 and above (with support for cookie manager)

The following section documents supported platforms, installation, and configuration of the TSRM Product Integration Module on enPortal versions 5.0 and above.

== Support Matrix ==
The following Operating System, Database, and Web Browser platforms are supported:

=== Operating System ===
Please see the list of supported Operating Systems on the [[System_Requirements|System Requirements]] page.

=== Database ===
A special database is not required to implement this integration module. The AppBoard/enPortal database is used to store all configurations related to this integration module.

=== Web Browser ===
Please see the list of supported Web Browsers on the [[System_Requirements|System Requirements]] page.

== Installation ==

Perform the following steps to install the TSRM PIM:
# Install AppBoard/enPortal as detailed in the [[Installation|Installation]] documentation
# Download the file ibm.tsrm_pimB.jar
# Start enPortal and login as an administrator
## User Name: administrator
## Password: administrator
## Domain: System
# Under the Advanced tab, select PIMImport
# Click the Browse... button
# Locate the TSRM package.jar file in the Open dialog
# Click the Start button to extract the files from the PIM .jar archive
# Under the Advanced tab, select XMLImport
# Click the Start button to load the PIM into the system
# Confirm that the following message is displayed: "Import completed; loaded the following file(s): load_ibm.tsrm_pimB.txt"

== Integration Details ==
This sections provides special details for configuring the integration module after installation.

=== Channel Types ===

* Proxy - the base channel type for all the other channels.
* Home - Channel that displays the top-level Home page of the TSRM application
* Application - Channel that display the TSRM page based on application type. Possible application types are change, incident, solution, workorder (wotrack).
* ViewTicket - Channel that displays the search result based on the UID of a ticket (incident). This UID is usually a 7 digit number. It is different from the visual ID that is used in Query channel in pimA.

=== Configuration ===

After installing the TSRM PIM, perform the following steps to configure access to the host TSRM server:

# Click on the Applications tab
# Right-click on the name "sample" in the row labeled "IBM TSRM" and select "Modify"
# Fill in the items in the Modify Application Wizard dialog:
## Select the protocol used to access your TSRM server (http or https)
## Change the host name from "changeme" to the hostname or ip address that will resolve to your TSRM server
## Change the port to the port number of your TSRM server
# Click on the SSO token definition purple icon "ibm.tsrm_pimB"
# Enter the correct value for "appRoot". This is the context of the application. By default it is set to maximo.
# Click on the "Proxy" class icon
# Click on Fields tab on the class editor
# Select "appRoot" field and enter the correct value for it. The value should be consistent with the one above set in SSO token definition.
# Click on the Integrations tab
# In the Explorer, under Packages, expand the ibm.tsrm_pimB tree and click on the Sample target. Confirm that the information you entered is displayed for your TSRM server
# Under the Sample target, click on the Home channel. A login prompt should be displayed.
# Log in using the same credentials you would use for accessing the TSRM application in a browser. Confirm that the TSRM Home page is displayed.

=== Create Channels ===

After installing the TSRM PIM, and configuring access to the host TSRM server, perform the following steps to create channels to display TSRM content:

# Click on the Applications tab
# Right-click on the name "sample" in the row labeled "IBM TSRM" and select a channel type
# In the "Channel Name" box, enter the name you want to give to the new channel
# For "Channel Type", select "3rd Party Pims"
# Click Next
# Click Finish
# Click on the Integrations tab
# In the Explorer, under Packages, expand the ibm.tsrm_pimB tree and click on the Sample target. Confirm that the new channel is listed along with the other sample channels

Repeat the above steps to create additional channels. Select a different Channel Type in step 2 to create a different type of channel.

=== Version Support ===

The following matrix details the supported TSRM and compatible AppBoard/enPortal versions:

{| class="wikitable" border="1" style="background-color:#eeeeee;"
|+ align="bottom" style="color:#e76700;" |''Version Support''
|-
! width="150" | Package Name
! width="150" | enPortal Version
! width="150" | TSRM Version
|-
| ibm.tsrm_pimB
| 4.6.1+
| IBM Tivoli Service Request Manager version 7.2
|}

{{Tip|To see the current enPortal version, run the <tt>portal version</tt> command from the <tt>[AppBoard_Home]/server/bin</tt> directory.}}

== TSRM Upgrades ==

=== Upgrading from an older version of TSRM to TSRM 7.2 ===

Older versions of TSRM are not supported by this PIM, so this upgrade path is not supported

=== Upgrading from TSRM 7.2 to a newer version of TSRM ===

Perform the following steps when the TSRM 7.2 server is upgraded to a newer version of TSRM:

# Check the AppBoard/enPortal PIM online documentation to see if the new TSRM version is supported by the existing ibm.tsrm_pimB PIM
## If the new TSRM version is supported by the existing PIM that you have installed, perform the following steps:
### Click on the Applications tab
### Right-click on the row for the old TSRM server and select "Modify"
### Update the protocol, host, and port to reference the server where the new version of TSRM is running
## If the new TSRM version is not supported by the existing PIM that you have installed, perform the following steps to upgrade the PIM:
### Download the new PIM version from the PIM download site
### Follow the steps in the Installation section above to install and configure the new PIM version
### Re-create all TSRM channels to reference the new PIM
### [Optional] Perform the steps outlined in the Uninstall section below to remove the old PIM from the system

== Uninstall ==

{{Warning|Uninstalling the ibm.tsrm_pimB PIM will break all of the channels in your AppBoard/enPortal system that reference this integration.}}

Perform the following steps to uninstall the ibm.tsrm_pimB PIM:

# Click on the Integrations tab
# In the Explorer, under Packages, locate the ibm.tsrm_pimB integration
# Right click on the integration name, and select "Delete"
# Click "Ok" to confirm that you want to delete the integration package

Integrations/ibm/ibm.tsrm pimB - Revision history

imported>Jason.nicholls: moved Tivoli Service Request Manager pimB to integrations/ibm/ibm.tsrm pimB

imported>Teri.roberts at 16:43, 24 June 2014

imported>Teri.roberts at 19:29, 6 February 2014

imported>Mike.berman: add instructions for resetting proxy rules after installation

imported>Cmace: copied from internal