Integrations/ibm/ibm.tnpm pimB - Revision history

imported>Mylene.stolpe: moved integrations/ibm/ibm.tnpm pimA to integrations/ibm/ibm.tnpm pimB

2015-04-15T16:06:03Z

moved integrations/ibm/ibm.tnpm pimA to integrations/ibm/ibm.tnpm pimB

← Older revision	Revision as of 16:06, 15 April 2015
(No difference)

imported>Mylene.stolpe at 16:03, 15 April 2015

2015-04-15T16:03:08Z

imported>Jason.nicholls: moved Netcool Performance Manager pimA to integrations/ibm/ibm.tnpm pimA

2014-07-25T06:05:12Z

moved Netcool Performance Manager pimA to integrations/ibm/ibm.tnpm pimA

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

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

2014-06-24T16:35:45Z

← Older revision		Revision as of 16:35, 24 June 2014
Line 1:		Line 1:
	{{DISPLAYTITLE:IBM Tivoli Netcool Performance Manager TNPM pimA}}		{{DISPLAYTITLE:IBM Tivoli Netcool Performance Manager (TNPM) pimA}}
	[[Category:Integrations]]		[[Category:Integrations]]
	This page documents the enPortal integration for IBM Tivoli Netcool Performance Manager.		This page documents the enPortal integration for IBM Tivoli Netcool Performance Manager (TNPM).

	* <b>Vendor</b>: IBM		* <b>Vendor</b>: IBM
	* <b>Product</b>: Tivoli Netcool Performance Manager (TNPM)		* <b>Product</b>: IBM Tivoli Netcool Performance Manager (TNPM)
	* <b>Supported Version(s)</b>: 1.3.1		* <b>Supported Version(s)</b>: 1.3.1
	* <b>Name of enPortal Integration Package</b>: ibm.tnpm_pimA		* <b>Name of enPortal Integration Package</b>: ibm.tnpm_pimA

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

2014-02-06T19:24:06Z

← Older revision		Revision as of 19:24, 6 February 2014
Line 1:		Line 1:
			{{DISPLAYTITLE:IBM Tivoli Netcool Performance Manager TNPM pimA}}
			[[Category:Integrations]]
	This page documents the enPortal integration for IBM Tivoli Netcool Performance Manager.		This page documents the enPortal integration for IBM Tivoli Netcool Performance Manager.

imported>Teri.roberts: /* Installation */

2013-07-29T23:14:49Z

Installation

← Older revision		Revision as of 23:14, 29 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.tnpm_pimA.txt"		# Confirm that the following message is displayed: "Import completed; loaded the following file(s): load_ibm.tnpm_pimA.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		# 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		# Right-click on the “Manage Proxy” channel and select <b>Open</b> to launch the channel

imported>Teri.roberts: /* Installation */

2013-07-29T20:53:59Z

Installation

← Older revision		Revision as of 20:53, 29 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.tnpm_pimA.txt"		# Confirm that the following message is displayed: "Import completed; loaded the following file(s): load_ibm.tnpm_pimA.txt"
			# 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

	== Integration Details ==		== Integration Details ==

imported>Cmace: changed support matrix line

2012-08-30T15:14:50Z

changed support matrix line

← Older revision		Revision as of 15:14, 30 August 2012
Line 11:		Line 11:

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

imported>Cmace: copied from internalwiki

2012-05-29T14:50:54Z

copied from internalwiki

New page

This page documents the enPortal integration for IBM Tivoli Netcool Performance Manager.

* Vendor: IBM
* Product: Tivoli Netcool Performance Manager (TNPM)
* Supported Version(s): 1.3.1
* Name of enPortal Integration Package: ibm.tnpm_pimA
* Required enPortal Version: 4.6.1 and above (with support for cookie manager)

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

== Support Matrix ==
The following 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 TNPM PIM:
# Install AppBoard/enPortal as detailed in the [[Installation|Installation]] documentation
# Download the file ibm.tnpm_pimA.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 TNPM 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.tnpm_pimA.txt"

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

=== Channel Types ===

* Home - Channel that displays the top-level Home page of the TNPM application
* TNPM - Channel that displays TNPM content view (DiagnosticsView and DefinedResourceView)
* DataViewNavigator - Channel that defines a Java Web Start application: DataView Navigator which can be used to create TNPM custom reports and style sheets.

=== Configuration ===

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

# Click on the Applications tab
# Right-click on the name "sample" in the row labeled "IBM Tivoli Network Performance Manager" and select "Modify"
# Fill in the items in the Modify Application Wizard dialog:
## Select the protocol used to access your TNPM server (http or https)
## Change the host name from "changeme" to the hostname or ip address that will resolve to your TNPM server
## Change the port to the port number of your TNPM server
# Click on the Integrations tab
# In the Explorer, under Packages, expand the ibm.tnpm_pimA tree and click on the Sample target. Confirm that the information you entered is displayed for your TNPM 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 TNPM application in a browser. Confirm that the TNPM Home page is displayed.
# In order for DataViewNavigator channel to work, Appboard/enPortal needs to be re-started to set the <tt>com.edgetech.eportal.dispatch.WebStartRequestAccessor</tt> as default request accessor.

=== Create Channels ===

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

# Click on the Applications tab
# Right-click on the name "sample" in the row labeled "IBM TNPM" 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.tnpm_pimA 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.

=== Known Issues ===

*After this pim is installed, AppBoard/enPortal needs to be re-started to load the request accessor class that would allow <tt>DataViewNavigator</tt> channel to run successfully.

=== Version Support ===

The following matrix details the supported TNPM 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" | TNPM Version
|-
| ibm.tnpm_pimA
| 4.6.1+
| IBM Tivoli Netcool Performance Manager version 1.3.1
|}

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

== TNPM Upgrades ==

=== Upgrading from an older version of TNPM to TNPM 1.3.1 ===

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

=== Upgrading from TNPM 1.3.1 to a newer version of TNPM ===

Perform the following steps when the TNPM 1.3.1 server is upgraded to a newer version of TNPM:

# Check the AppBoard/enPortal PIM online documentation to see if the new TNPM version is supported by the existing ibm.tnpm_pimA PIM
## If the new TNPM 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 TNPM server and select "Modify"
### Update the protocol, host, and port to reference the server where the new version of TNPM is running
## If the new TNPM 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 TNPM 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.tnpm_pimA PIM will break all of the channels in your AppBoard/enPortal system that reference this integration.}}

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

# Click on the Integrations tab
# In the Explorer, under Packages, locate the ibm.tnpm_pimA integration
# Right click on the integration name, and select "Delete"
# Click "Ok" to confirm that you want to delete the integration package
# [Optional] Stop AppBoard/enPortal. Go to AppBoard/enPortal file system and delete <tt>pkg-ibm.tnpm_pimA.properties</tt> file in <tt>${ApplicationHome}/WEB-INF/config</tt> directory and <tt>pkg-tnpm_pimA.jar</tt> in <tt>ApplicationHome}/WEB-INF/lib</tt> directory

← Older revision		Revision as of 16:03, 15 April 2015
Line 1:		Line 1:
	{{DISPLAYTITLE:IBM Tivoli Netcool Performance Manager (TNPM) ~~pimA~~}}		{{DISPLAYTITLE:IBM Tivoli Netcool Performance Manager (TNPM) pimB}}
	[[Category:Integrations]]		[[Category:Integrations]]
	This page documents the enPortal integration for IBM Tivoli Netcool Performance Manager (TNPM).		This page documents the enPortal integration for IBM Tivoli Netcool Performance Manager (TNPM).
Line 6:		Line 6:
	* <b>Product</b>: IBM Tivoli Netcool Performance Manager (TNPM)		* <b>Product</b>: IBM Tivoli Netcool Performance Manager (TNPM)
	* <b>Supported Version(s)</b>: 1.3.1		* <b>Supported Version(s)</b>: 1.3.1
	* <b>Name of enPortal Integration Package</b>: ibm.~~tnpm_pimA~~		* <b>Name of enPortal Integration Package</b>: ibm.tnpm_pimB
	* <b>Required enPortal Version</b>: 4.6.1 and above (with support for cookie manager)		* <b>Required enPortal Version</b>: 4.6.1 and above (with support for cookie manager)

Line 32:		Line 32:
	Perform the following steps to install the TNPM PIM:		Perform the following steps to install the TNPM PIM:
	# Install AppBoard/enPortal as detailed in the [[Installation\|Installation]] documentation		# Install AppBoard/enPortal as detailed in the [[Installation\|Installation]] documentation
	# Download the file ibm.~~tnpm_pimA~~.jar		# Download the file ibm.tnpm_pimB.jar
	# Start enPortal and login as an administrator		# Start enPortal and login as an administrator
	## User Name: administrator		## User Name: administrator
Line 43:		Line 43:
	# Under the <b>Advanced</b> tab, select <b>XMLImport</b>		# Under the <b>Advanced</b> tab, select <b>XMLImport</b>
	# 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.~~tnpm_pimA~~.txt"		# Confirm that the following message is displayed: "Import completed; loaded the following file(s): load_ibm.tnpm_pimB.txt"
	# Under the <b>Advanced</b> tab, select <b>Explore System</b>		# Under the <b>Advanced</b> tab, select <b>Explore System</b>
	# Navigate to the /Directory/system/proxy/ folder and locate the “Manage Proxy” channel		# Navigate to the /Directory/system/proxy/ folder and locate the “Manage Proxy” channel
Line 71:		Line 71:
	## Change the port to the port number of your TNPM server		## Change the port to the port number of your TNPM server
	# Click on the <b>Integrations</b> tab		# Click on the <b>Integrations</b> tab
	# In the Explorer, under Packages, expand the ibm.~~tnpm_pimA~~ tree and click on the <b>Sample</b> target. Confirm that the information you entered is displayed for your TNPM server		# In the Explorer, under Packages, expand the ibm.tnpm_pimB tree and click on the <b>Sample</b> target. Confirm that the information you entered is displayed for your TNPM server
	# Under the <b>Sample</b> target, click on the <b>Home</b> channel. A login prompt should be displayed.		# Under the <b>Sample</b> target, click on the <b>Home</b> channel. A login prompt should be displayed.
	# Log in using the same credentials you would use for accessing the TNPM application in a browser. Confirm that the TNPM Home page is displayed.		# Log in using the same credentials you would use for accessing the TNPM application in a browser. Confirm that the TNPM Home page is displayed.
Line 87:		Line 87:
	# Click <b>Finish</b>		# Click <b>Finish</b>
	# Click on the Integrations tab		# Click on the Integrations tab
	# In the Explorer, under Packages, expand the ibm.~~tnpm_pimA~~ tree and click on the Sample target. Confirm that the new channel is listed along with the other sample channels		# In the Explorer, under Packages, expand the ibm.tnpm_pimB tree and click on the Sample target. Confirm that the new channel is listed along with the other sample channels


Line 107:		Line 107:
	! width="150" \| TNPM Version		! width="150" \| TNPM Version
	\|-		\|-
	\| ibm.~~tnpm_pimA~~		\| ibm.tnpm_pimB
	\| 4.6.1+		\| 4.6.1+
	\| IBM Tivoli Netcool Performance Manager version 1.3.1		\| IBM Tivoli Netcool Performance Manager version 1.3.1
Line 125:		Line 125:
	Perform the following steps when the TNPM 1.3.1 server is upgraded to a newer version of TNPM:		Perform the following steps when the TNPM 1.3.1 server is upgraded to a newer version of TNPM:

	# Check the AppBoard/enPortal PIM online documentation to see if the new TNPM version is supported by the existing ibm.~~tnpm_pimA~~ PIM		# Check the AppBoard/enPortal PIM online documentation to see if the new TNPM version is supported by the existing ibm.tnpm_pimB PIM
	## If the new TNPM version is supported by the existing PIM that you have installed, perform the following steps:		## If the new TNPM version is supported by the existing PIM that you have installed, perform the following steps:
	### Click on the <b>Applications</b> tab		### Click on the <b>Applications</b> tab
Line 138:		Line 138:
	== Uninstall ==		== Uninstall ==

	{{Warning\|Uninstalling the ibm.~~tnpm_pimA~~ PIM will break all of the channels in your AppBoard/enPortal system that reference this integration.}}		{{Warning\|Uninstalling the ibm.tnpm_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.~~tnpm_pimA~~ PIM:		Perform the following steps to uninstall the ibm.tnpm_pimB PIM:

	# Click on the <b>Integrations</b> tab		# Click on the <b>Integrations</b> tab
	# In the Explorer, under Packages, locate the ibm.~~tnpm_pimA~~ integration		# In the Explorer, under Packages, locate the ibm.tnpm_pimB integration
	# Right click on the integration name, and select "Delete"		# Right click on the integration name, and select "Delete"
	# Click "Ok" to confirm that you want to delete the integration package		# Click "Ok" to confirm that you want to delete the integration package
	# [Optional] Stop AppBoard/enPortal. Go to AppBoard/enPortal file system and delete <tt>pkg-ibm.~~tnpm_pimA~~.properties</tt> file in <tt>${ApplicationHome}/WEB-INF/config</tt> directory and <tt>pkg-~~tnpm_pimA~~.jar</tt> in <tt>ApplicationHome}/WEB-INF/lib</tt> directory		# [Optional] Stop AppBoard/enPortal. Go to AppBoard/enPortal file system and delete <tt>pkg-ibm.tnpm_pimB.properties</tt> file in <tt>${ApplicationHome}/WEB-INF/config</tt> directory and <tt>pkg-tnpm_pimB.jar</tt> in <tt>ApplicationHome}/WEB-INF/lib</tt> directory