Before you begin, you may want to review this section for an overview of the installation and configuration process: Installation, setup, and configuration process overview.
(Optional) Reference: Using ANT scripts to pull model content onto the server
| Software component | Description |
|---|---|
| IBM Installation Manager, WS_Beta | Use IBM Installation Manager WS_Beta to install all of the beta components. Using the IBM Installation Manager, you can install the model server on a machine that can serve data, the collaboration client on any client desktop that has Rational Software Architect 8.0 or higher installed, and the import engine on a computer (or more than one computer) that has access to the model content you want to import. |
| IBM Rational Collaborative Architecture Management Model Server | This Jazz-based server hosts Rational Software Architect models so your team can add comments to models and mark up diagrams for collaboration purposes. |
| Rational Software Architect Import Engine | This utility imports Rational Software Architect model content onto the model server. The Import Engine must be installed and configured on any computer that contains Rational Software Architect models that you want to import onto the model server. |
| Rational Software Architect Collaboration client | This Rational Software Architect 8.0
extension allows you to access the search, commenting, markup, and
other services that the model server supports within Rational Software Architect.
This extension adds a Team Modeling view, a Comments view, and provides
additional fields that allow you to search a model repository. You may install the Rational Software Architect Collaboration client on multiple computers that have Rational Software Architect v8.0 or higher installed. |
| Rational Software Architect, version 8.0 (or 8.0.1). | Important: Rational Software Architect is
not included in the beta installation package. If you do not have Rational Software Architect version
8.0, you can download and install the trial version using the following
link: http://www14.software.ibm.com/webapp/download/search.jsp?pn=Rational+Software+Architect
|
| Optional installation | Download location |
|---|---|
| Rational Requirements Composer 3.0 | https://jazz.net/downloads/rational-requirements-composer/. |
| Rational Team Concert™ 3.0 | https://jazz.net/downloads/rational-team-concert/ |
| Rational Quality Manager 3.0 | https://jazz.net/downloads/rational-quality-manager/ |
| Simple Mail Transport Protocol (SMTP) server | If you want to explore e-mail notifications when someone enters a comment on a resource, you must have an SMTP server available. |
To modify the Sample Project:
You must install the import engine on any computer that contains the model data you want to place on the model server; however, this computer does not need to be the same computer that hosts the model server.
There are four parts to importing model data to the model server:
To view general guidelines on how you can write ANT scripts to pull model data from your source control management (SCM) system to the IBM Rational Collaborative Architecture Management model server, see this topic: (Optional) Reference: Using ANT scripts to pull model content onto the server
Using custom ANT scripts, you can pull the latest versions of model data into the file system of the computer on which the server has been told to retrieve the data. Using the Import Definition page within the Web UI, you specify where the IBM Rational Collaborative Architecture Management server retrieves the model data using the Eclipse workspace path or the workspace path and project directories. These paths must point to the file system of the same computer on which the Import Engine is installed and configured.
| IBM Rational Collaborative Architecture Management-Related Field | Description |
|---|---|
| The Ant Script Path field on the Import Definition page of the web UI for your project. | The Ant script path path points to
the location of the ANT script; this location must be on the same
file system as the computer on which the Import Engine is installed.
For example, an Ant script will do something like, "use these credentials
to log into my source control management (SCM) server, locate the
projects in my workspace, and retrieve the latest data". You can write
ANT scripts to do other tasks; however, at this time, there is no
need to use ANT for anything other than pulling model data from your
SCM system. Note: You can write an ANT script that does not require
the knowledge of workspaces. When you add an ANT script path to the
Import Definition, that ANT script is executed as the first step in
the import.
|
| The Eclipse Installation Directory field in the Import Engine Configuration window. | The Eclipse Installation Directory must point to an Eclipse installation that is able to interpret the ANT script provided in the Import Definition. If you have not provided an ANT script, this field should be left as the default, which points to the installation location of the Import Engine. While the Import Engine isn't a true Eclipse installation (it's really a rich client platform), it is designed to handle the import when there isn't an ANT script requires executing. |
When you write your Ant script, you can use basic Ant or you can use some tasks provided by your SCM such as Rational Team Concert. If you use special SCM tasks within your Ant script, your Eclipse Installation Path must point to an Eclipse installation of that SCM system.
While Rational Team Concert is an Eclipse installation, you can install Rational ClearCase plug-ins on top of a generic Eclipse installation. If you are using CVS tasks in your Ant script, you can point to your Rational Software Architect installation because CVS is bundled with Rational Software Architect.
When you are connected to a model repository, all projects that are available in the model repository are rendered from the server and are displayed and organized into different nodes and folders in the Team Explorer view. You can view the diagrams in the diagram editor. In addition, if you already have models in your Rational Software Architect workspace that also reside on the server, the models in the workspace are automatically linked to the models on the server when the server connection is established.
To uninstall the collaboration client extension, the import engine, and the model server:
© Copyright IBM Corporation 2011.
U.S. 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 U.S.A.
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 Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A.
Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 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 states 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 Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
Intellectual Property Dept. for Rational Software 3600 Steeles Avenue East Markham, ON Canada L3R 9Z7
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.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
This information is for planning purposes only. The information herein is subject to change before the products described become available.
Trademark acknowledgments
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 www.ibm.com/legal/copytrade.shtml.