Highlights Overview topology of the main build-related interactions between the IBM UrbanCode Deploy and Rational Team Concert servers. Overview of two common build and deployment processes for mainframe and non-mainframe files Build integration overview: Rational Team Concert and IBM UrbanCode Deploy Topology introduction The topology diagram on the next page is a summary of the main interactions between the IBM Rational Team Concert (RTC) and IBM UrbanCode Deploy (UCD) systems and their various components and target platforms during different types of build process. Arrows show the main points of communication during build and deployment phases, though many other parts communicate at other times. At the top, several types of clients access the RTC and UCD servers, including users on web browsers and command-line clients. Below the clients, the CLM system contains the Jazz Team Server and Change and Configuration Management (what most people call RTC) systems. The RTC system contains source code that is stored in components, which are stored in streams. The RTC server also maintains build definitions, which describe how to build deployable packages from source code, and build engines, which are virtual representations of the build agents that build the source code. These build agents, including Build Forge Agents and Jazz Build Engines, are shown below the RTC server. The UCD server is shown to the right of the RTC server. It contains virtual representations of applications and of the components themselves. On the RTC server, the components contain source code, but on the UCD server, components represent built deployable artifacts and the automated processes that deploy them. At the right-hand side of the topology, a UCD agent connects to the UCD server. UCD agents like this one run on the target environments that host the applications and their components. Copyright International Business Machines Corporation 2016-2017. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Figure 1: Overview topology of UCD-RTC build integration 2
Standard build and deployment process Building non-mainframe files, such as WSDL and JAR files, as well as some mainframe files, such as USS files, follows this general process: 1. A client requests a build from RTC. 2. Using the build definition for instructions, the Jazz Build Engine retrieves source code from the stream and builds a deployable package. 3. The UCD component, which contains information about where to retrieve the deployable artifacts, triggers a manual or an automatic version import. 4. The UCD agent that is designated in the UCD component definition retrieves the deployable artifacts from RTC. 5. The agent creates a UCD component version that includes the artifacts. 6. A client requests an application deployment from the UCD server. 7. The specified UCD agent for the deployment checks in with the server. 8. The application process runs, delivering deployable artifacts and automation instructions (in the form of component processes) to one or more agents. 9. The agents run the automation instructions to deploy the application components. See Figure 2: Workflow for standard build and deployment process on page 4. 3
Figure 2: Workflow for standard build and deployment process 4
z/os build process When the RTC server builds mainframe packages, it creates deployable packages that it pushes to component versions on the UCD server. 1. A client requests a build from RTC. 2. RTC builds the artifacts with a z/os dependency build. 3. RTC stores the results as a deployable package in RTC. 4. Using the UCD z/os toolkit, the RTC server pushes the deployable package to a component version in UCD. 5. A client requests an application deployment from the UCD server. 6. The specified UCD agent for the deployment (in this case, an agent on z/os) checks in with the server. 7. The application process runs, delivering deployable artifacts and automation instructions (in the form of component processes) to one or more agents. 8. The agents run the automation instructions to deploy the application components. See Figure 3: Workflow for z/os build process on page 6. 5
Figure 3: Workflow for z/os build process 6
Notices Copyright International Business Machines Corporation 2016-2017. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. This information was developed for products and services offered in the US. This material might be available from IBM in other languages. However, you may be required to own a copy of the product or product version in that language in order to access it. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user s responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY 10504-1785 US For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions; therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY 10504-1785 US 7
Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. The performance data and examples cited are presented for illustrative purposes only. Actual performance results may vary depending on specific configurations and operating conditions. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. Statements regarding IBM s future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at Copyright and trademark information at www. ibm.com/legal/copytrade.shtml. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Please Recycle 8