TeamcenterKnowledge

Installing and configuring MBSE > Configuring MBSE

Requirements engineering configuration process

Note: this topic is an installation/configuration overview for Requirements Management. Detailed sub-topics for RM microservice configuration, Excel round-trip, and trace-link configuration are covered in the "Systems Engineering - Deployment and Rich Client Usage" book (requirements-management/ folder) and are not duplicated here.

Prerequisites

Ensure that the following are installed before you begin the Requirements Management installation and configuration:

  • Microsoft .NET Framework
  • Microsoft Office with primary interop assemblies (PIAs) for Microsoft Office

The ReqMgtWordToHtml and ReqMgmtHtmlToWord translators require:

  • Microsoft .NET Framework
  • Microsoft Windows

The ReqMgmtPerformOperation and CompareTranslator translators require:

  • Microsoft .NET Framework
  • Microsoft Windows
  • Microsoft Word

The REQ_BootstrapClientIP environment variable must be added in the microservice json/yml file. This specifies the FMS bootstrap client IP address to be used for the assignment. On Linux hosts, enter the internal IP address of the machine where the import/export microservice is running. A single IP address is supported. When migrating from TEM to DC, this environment variable may not get populated; in that case update it manually.

Note: For supported versions of third-party software, see the Hardware and Software Certifications knowledge base article on Support Center.

For planning purposes, plan to install these components on the same server where you install the Dispatcher. For more information, see Dispatcher - Deployment and Administration in the Teamcenter documentation.

Installation

Unless otherwise noted, perform the configuration in the order indicated. Follow these steps to install Requirements Management on Active Workspace:

  1. (Required for Export to Excel and Baselining capabilities) Enable AsyncService. See Dispatcher - Deployment and Administration.

  2. Install translators that support requirements capabilities.

  3. (Required for importing requirements) Ensure the dispatcher is started. See the Dispatcher Server guide.

  4. (Required to export from Microsoft Word back to Active Workspace) Install the ReqMgmtWordToHTML and ReqMgmtHTMLToWord translators. See the Dispatcher Server guide.

    Note: You can selectively convert requirement content in HTML format to Microsoft Word format (or the reverse) depending on the option selected using the req_word_html_converter utility.

  5. (Required for suspect trace link notification management) Install the Async translator. See the Dispatcher Server guide.

  6. Enable full text searches.

Additional Requirements Management instructions and preferences

Follow these steps to install Requirements Management into Active Workspace:

  1. Configure trace links.
  2. Configure HTML object templates.
  3. Update custom Microsoft Word templates.
  4. (Optional) Install the Active Workspace Launcher using Teamcenter Environment Manager (TEM) or with a standalone installer.
  5. (Required for Excel Live functionality) Install the Teamcenter Extensions for Microsoft Office extensions.
  6. Configure the requirement management preferences for: general requirements management preferences; importing Microsoft Word documents; Microsoft Word editing; converting requirements from Microsoft Word to HTML; suspect trace link notification management.

Settings for comparing requirements

These preferences must be set by your system administrator to generate and compare specification history:

  • REQ_CompareSpecificationHistory=true - must be set to true to generate specification history; otherwise historic versions and version information are unavailable.
  • REQ_Microservice_Installed=true

The following also applies:

  • The req_perform_operation must be installed.
  • The compare microservice must be installed.
  • The History tab is available when using Teamcenter 12.4 and above, regardless of Active Workspace version.