Configuring the import engine

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 Start > All Programs > Design Management > Start the Jazz Team Server and CLM applications. 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

  1. Click Start > Programs > Rational Software Architect Design Manager Import Engine > Configure import engine.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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 Start > Rational Software Architect Design Manager Import Engine > Start import engine. 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.


Feedback