Before you start the import engine, you must set it up
correctly. Configuring the import engine typically occurs once for
each computer. For example, if your team has five separate computers
that contain model content for the Design
Management Server,
your team must configure the import engine on each of the individual
computers.
Before you begin
Note: You must add a dedicated domain
extension server to ensure that the Design
Management Server displays Rational® Software Architect content
such as diagrams, data from the Explorer view, import functionality,
and properties. The extension server is a separate installation package
that you can install with the Design
Management Server.
You can also install the server by itself on a separate server and
register it manually.
Before you configure the
import engine, you must ensure that the
Jazz™ Team Server to
which to import the models is started. To start the server, click . In the
Tomcat command window, wait for this message:
INFO: Server
startup in # ms. This step might take a while to complete
the first time that you start the server; however, on subsequent instances,
the server starts faster.
Before you import a model, you must create
and define a configuration space. A configuration space is a group
of configurations (a unique set of versions). Each design management
project area is associated with a configuration space; multiple project
areas can be related to the same configuration space and can share
configurations.
Procedure
- Click .
- In the import engine, in the Front Server URL field,
enter the fully qualified host name of the Design
Management Server server
URL, such as https://[fully_qualified_hostname]:9443/dm.
The front server URL must point to the computer that hosts the imported
model content.
- Specify the Jazz user
account and Jazz user password.
You might consider creating an administrator or functional user who
is responsible for placing model content on the server.
Note: The Jazz user ID and password can be
for any user account that has at least guest permissions.
- In the Import Engine Name field,
enter a name, such as DM_Import_Def that symbolically
represents the computer on which the import engine runs; many import
definitions can use the same import engine name. All import engine
names are case sensitive. You need the import engine name when you
import model content to the Design
Management Server.
- In the Eclipse Installation Directory field,
ensure that the directory path points to the default installation
directory for the import engine: C:/Program Files/IBM/RSADMImportEngine.
In the default installation directory, you can import workspaces from
standard Eclipse installations; that is, Eclipse installations that
use CVS or no source control management system. However, if you have
model content that resides in a Rational Team Concert™ workspace,
or in a workspace that is connected to any other software configuration
management (SCM) system that requires support beyond standard Eclipse,
you must specify a value in the Eclipse Installation Directory field
that points to the location of the Rational Team Concert Eclipse
client installation or the installation directory of the SCM system.
Important: If your workspace has multiple projects
that contain modeling elements, and a subset of those projects reside
under Rational Team
Concert source control, you must ensure that the Eclipse Installation
Directory field points to the installation location of Rational Software Architect with Rational Team Concert.
Otherwise, if you specify the default location of the import engine,
after the import process, you can only view model content that is
not under source control. Rational Team Concert stores
projects in a way that standard Eclipse cannot discover.
- Ensure that Design
Management Server is
running, and test the configuration by clicking Test Configuration. The test and configuration might take several minutes
to complete.
- Click OK. The import engine starts,
and an icon for the import engine is added to the system tray.
Results
After you configure the import engine, it starts automatically.
The import engine is a background process that runs until you stop
it. To start the import engine, click . The Start
menu also contains an option to stop the import engine.
You can
also start and stop the import engine from the system tray icon: click
the icon and use the pop-up menu to start, stop, reconfigure, or exit
the import the engine.