IntegrationWhereToStart < Deployment

Engineering Lifecycle Management Wiki - Deployment

Community information and contribution guidelines

TWiki > Deployment Web > IntegrationWhereToStart

Revision 26 - 2015-08-24 - 20:09:08 - Main.asilber

<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%">
---+!!Integration: Where to start?
%DKGRAY% Cross-cutting theme technical leaders and senior editors: Main.AmySilberbauer, Main.DaleHobill <br>
%ENDCOLOR%</div></sticky>

<!-- Page contents top of page on right hand side in box -->
<sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;">
%TOC{title="Page contents"}%
</div></sticky>

<sticky><div style="margin:15px;"></sticky>

---++ Getting Started
The Integration topics here and in related sections are intended to provide information about integrations supported in the Collaborative Lifecycle Management and Systems and Software Engineering solutions in terms of technology, maturity, and ability to support high priority usage scenarios identified by our customers. We will focus initially on the *ALM Core* and *ALM Middleware Core* solution set of products, ensuring that the integrations are accurately and completely documented and validated for the scenarios identified. Our focus will grow over time to include integrations with other IBM tools in the context of [[http://www.ibm.com/ibm/devops/us/en/community][IBM DevOps]], and with third-party tools that have been identified as high priority by customers. 

*Please visit this page often for updates as we expand the information as well as the focus.* 

---+++ How to navigate this topic
   * In the first section, you can review what we mean when we say *ALM Core* in the context of the Integration topic. To see what is in the scope of the *ALM Middleware Core*, review the information and extensive scenarios on the  [[IntegrationSystemsCore][ALM Middleware Core]] page.  
   * If you are planning an installation or upgrade and need to understand how best to proceed to understand how integrations must be considered, go directly to the _Install/Upgrade Cookbook_ section for step-by-step guidance. 
   * To review the *high priority* usage scenarios we are addressing via improvements in documentation, validation and identification of product and integration gaps, navigate to the [[IntegrationHighPriorityScenarios][Golden Integration Scenarios]] where you can review scenarios that are our current focus. 

---++ ALM Core Solution - Our Initial Integration Focus 
The vast majority of customers use the IBM ALM solution along with some Reporting capability; some use subsets of these solutions. We refer collectively to the combined set of products as the *ALM Core* solution and the integrations within this context are our key focus. For the solution set of products, we will ensure that integration specifications and requirements are well documented and tested. Specifically in the context of the top scenarios identified, we want to ensure that this core set of products work together as required by those scenarios. Further, we want to ensure that documentation for installing, upgrading and configuring the core set of products is complete and accurate from the perspective of the integrations required. 

We start with a description of *ALM Core*. 

<style> table.equalDevide tr td { width:50%; } </style><table class="equalDevide" cellpadding="0" cellspacing="15" width="100%" border="10"><tr><td valign="top">
<br>
<img src="%ATTACHURLPATH%/ScenarioDesigns_IntegratedSolutions.png" alt="ScenarioDesigns_IntegratedSolutions.png" width="700" height="600" />


</td><td valign="top"><br>
Integration technology within the *ALM Core* solution set of products varies, providing different capabilities: 
   * *OSLC*: Supports linked data, allowing traceability and collaboration across the products within the solution
   * *TRS Feeds*: Provides integrated data transfer through feeds
   * *Data Collection*: Provides integrated data transfer through ETL
   * *Data Transfer*: Provides data transfer via import/export or synchronization
Beyond *ALM Core*, integrations with other IBM and third-party tools follow this same model, with a variety of integration technologies in use. 

Integrations are described in more detail in the IBM Knowledge Center: 
   * [[http://www-01.ibm.com/support/knowledgecenter/SSYMRC_6.0.0/com.ibm.help.common.jazz.calm.doc/topics/c_node_integrating.html][Rational solution for Collaborative Lifecycle Management solution > Integrating]]
   * [[http://www-01.ibm.com/support/knowledgecenter/SSQQC5_6.0.0/com.ibm.rational.sse.doc/topics/c_node_integrating.html][Rational solution for Systems and Software Engineering > Integrating]]

       </td>
   </tr>
</table>
---++ Install and Upgrade - *Start Here!*
If you are planning an installation or upgrade, you must consider how your ALM solution integrates with products that are part of that solution, which may include integration within and outside the *ALM Core* set of products. Start here to understand the recommended steps, verified through collaboration with our customers, for producing a plan for an installation or upgrade. These steps specifically take into consideration the information you must gather to perform an installation or upgrade that requires integration across products. 

---+++ Produce an install/upgrade plan

<style> table.equalDevide tr td { width:50%; } </style><table class="equalDevide" cellpadding="0" cellspacing="15" width="100%" border="10"><tr><td valign="top">
<br>
 <img src="%ATTACHURLPATH%/ProduceInstallationUpgradePlan.png" alt="ProduceInstallationUpgradePlan.png" width="700" height="600" border="10" />
</td><td valign="top"><br>
*Input:* Target product/solution and release for installation or upgrade, for example CLM 6.0, RTC 6.0, etc., and set of products in your environment that must be integrated. <br/>
<br/>
*1.* Understand product and solution requirements <br/>
*2.* Utilize the Software Product Compatibility Reports  <br/>
*3.* Use the Interactive Installation Guides available in the online help <br/>
   * [[http://www-01.ibm.com/support/knowledgecenter/SSYMRC_6.0.0/com.ibm.jazz.install.doc/topics/roadmap_form.html][CLM Interactive Installation Guide]]
   * [[http://www-01.ibm.com/support/knowledgecenter/SSYMRC_6.0.0/com.ibm.jazz.install.doc/topics/roadmap_clm_upgrade.html][CLM Interactive Upgrade Guide]]
   * [[http://www-01.ibm.com/support/knowledgecenter/SSQQC5_6.0.0/com.ibm.rational.sse.install.doc/topics/c_roadmap_over_product.html][SSE Installation Roadmap]]
*4.* Refer to the general integration information available in the Deployment wiki <br/> 
*5.* Take advantage of Troubleshooting information <br/>
<br/>
*Output:* Installation/Upgrade Plan  
Details for each of these steps are below. 
      </td>
   </tr>
</table>

---++++1. Understand product and solution requirements
Based on your starting point, refer to the appropriate System Requirements pages specified on the [[DeploymentInstallingUpgradingAndMigrating][Installing and upgrading]] page of the Deployment Wiki, in the *System requirements* section. 

*Output:* Understanding of ALM Core integration system requirements based on target product/solution and release starting point. 

---++++2. Utilize the Software Product Compatibility Reports 
The Software Product Compatibility Reports can provide you with additional details about software pre-requisites or co-requisites, such as Eclipse versions, browser requirements, subsystem requirements, etc.. These reports also provide you with software and version compatibility information for related software. You can create reports simply and quickly by following these steps: 

   * (a) Navigate to [[http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.jsp][IBM Software Product Compatibility Reports]]
   * (b) Select to create a high-level related software report, as shown here: <br/>

     <img src="%ATTACHURLPATH%/SPCR_-_Start_Here.png" alt="SPCR_-_Start_Here.png" width="500" height="300" border="10"/>

   * (c) Enter the name of the product that is your starting point, for example *collaborative lifecycle management* (note that you can use acronyms): <br/> 

      <img src="%ATTACHURLPATH%/SPCR_-_Specify_Product.png" alt="SPCR_-_Specify_Product.png" width="500" height="500" border="10" />

   * (d) Indicate scope of report (select all capabilities by default) and click *Submit* to generate the report

Sample reports are available as attachments to this topic for: 
   * [[%ATTACHURL%/CLM_6.0_Compatibility_Report.pdf][CLM_6.0_Compatibility_Report.pdf]]

   * [[%ATTACHURL%/RDNG_6.0_Compatibility_Report.pdf][RDNG_6.0_Compatibility_Report.pdf]]

   * [[%ATTACHURL%/RTC_6.0_Compatibility_Report.pdf][RTC_6.0_Compatibility_Report.pdf]]

*Output:* Comprehensive report specifying the set of software co-requisites, pre-requisites, and related software that may be part of your environment, to use as input for your Installation/Upgrade Plan. 

---++++3. Use the Interactive Installation Guides available in the online help

   * [[http://www-01.ibm.com/support/knowledgecenter/SSYMRC_6.0.0/com.ibm.jazz.install.doc/topics/roadmap_form.html][CLM Interactive Installation Guide]]
   * [[http://www-01.ibm.com/support/knowledgecenter/SSYMRC_6.0.0/com.ibm.jazz.install.doc/topics/roadmap_clm_upgrade.html][CLM Interactive Upgrade Guide]]
   * [[http://www-01.ibm.com/support/knowledgecenter/SSQQC5_6.0.0/com.ibm.rational.sse.install.doc/topics/c_roadmap_over_product.html][SSE Installation Roadmap]]

---++++4. Refer to the general integration information available in the Deployment wiki

   * [[DeploymentIntegrating][Integrating]]

---++++5. If you have problems, look at our troubleshooting pages

   * [[IntegrationsTroubleshooting][Integration troubleshooting]]


---+++++!! Related topics: [[Deployment/WebHome][Deployment web home]]

---+++++!! External links:          

   * [[https://www.ibm.com][IBM]]
   * [[http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.jsp][IBM Software Product Compatibility Reports]]

---+++++!! Additional contributors: Main.IanCompton, Main.MarianneHollier, Main.MarioMaldari, Main.ChristopherFleischer

<sticky></div></sticky>

Attachments

Topic attachments
I	Attachment	Action	Size	Date	Who	Comment
pdf	CLM_6.0_Compatibility_Report.pdf	manage	1066.5 K	2015-06-30 - 20:01	UnknownUser	CLM 6.0 Software Compatibility Report
png	ProduceInstallationUpgradePlan.png	manage	98.7 K	2014-09-19 - 18:20	UnknownUser	Produce an install/upgrade Plan
pdf	RDNG_6.0_Compatibility_Report.pdf	manage	729.3 K	2015-06-30 - 20:02	UnknownUser	RDNG 6.0 Software Compatibility Report
pdf	RTC_6.0_Compatibility_Report.pdf	manage	1372.2 K	2015-06-30 - 20:04	UnknownUser	RTC 6.0 Software Compatibility Report
png	SPCR_-_Specify_Product.png	manage	31.6 K	2015-06-30 - 20:06	UnknownUser	Specify product for Software Product Compatibility Report
png	SPCR_-_Start_Here.png	manage	117.5 K	2014-06-16 - 16:31	UnknownUser	Screen shot of starting point for generating Software Product Compatibility Reports tool
png	ScenarioDesigns_IntegratedSolutions.png	manage	110.3 K	2015-08-21 - 18:00	UnknownUser	ALM Core set of products for integration consideration

Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.