This file contains information on installing and using the current release of Dimensions RM.
·
To check for an updated
version of this file, go to:
https://www.microfocus.com/documentation/dimensions-rm/
·
To contact technical
support, go to:
http://supportline.microfocus.com
Part 1: Core System Requirements
Part 2: Core Dimensions RM
Part 3: Dimensions CM Integration
Part 4: Prototype Composer Integration
Part 5: ALM/Quality Center Integration
Part 7: Copyrights, Trademarks, and Acknowledgements
|
Part 1: Core System Requirements |
For current supported platform information please see the online support
matrix at https://www.microfocus.com/documentation/dimensions-rm/.
Note: SLM is no longer supported, Open Text license management solution Autopass must be used instead.
For AutoPass installation instructions see
https://docs.microfocus.com/itom/AutoPass_License_Server:latest/Home
For hardware requirements please see System Requirements chapter in the drm_support_matrix.pdf at https://www.microfocus.com/documentation/dimensions-rm/ .
Dimensions RM should work correctly behind a hardware load balancer with the sticky bit set. However, Open Text does not test or document the use of Dimensions RM with a load balancer.
Since the Dimensions RM Application Server scales well, OpenText recommends increasing the capacity of the Web Server, if possible, rather than running a load balancer. Given the choice between running four 2-processor web servers behind a load balancer or a single server with 8 processors, it would be recommended to run the single, larger server. User experience shows that a single larger server delivers the best performance and is easier to maintain.
Dimensions RM supports Unicode characters.
To fully store these Unicode characters in the Dimensions RM Oracle database, you MUST configure the Oracle database instance with the UTF8 database character set (Oracle recommends AL32UTF8). Using an Oracle UTF8 database ensures that RM Import can store all the Unicode characters in the Dimensions RM database.
If you use any other database character set (such as Western European [WE8MSWIN1252]), RM Import cannot fully store all of these Unicode characters. Data loss occurs when RM Import attempts to store these Unicode characters in a non-UTF8 database. The non-UTF-8 database does not include these characters in its character set, so it substitutes an unknown conversion character, which is usually the upside-down question mark.
If you have a Dimensions RM Oracle database that is configured with a character set other than UTF8, and you want to use RM Import without any loss of data, you must convert your existing Oracle database to use a UTF8 database character set. Please see the "Globalization Support Guide" available from Oracle for information and instructions.
|
Part 2: Core Dimensions RM |
1. Stop
the Dimensions RM Common Tomcat service.
2. Open <RM_Installdir>\Dimensions 24.4\Common Tools 2.4.0.0\tomcat\9.0\webapps\rtmBrowser\WEB-INF\web.xml with a text editor, e.g. Notepad.
3. Secure Flag for cookies should be set to false:
<cookie-config>
<secure>false</secure>
</cookie-config>
4. HTTP Strict Transport Security header should be set to false:
<init-param>
<param-name>hstsEnabled</param-name>
<param-value>false</param-value>
</init-param>
5. Save the file.
6. Start the Dimensions RM Common Tomcat service.
Upgrade feature of the installer is disabled. The previous release of RM must be uninstalled before installing the new release.
7.2 When using the WIRIS editor, upgrading from
24.3 and lower versions requires updates to web.xml settings
As of 24.4 RM is installed with a secure web.xml configuration. To use the WIRIS editor for html fields, the following changes must be applied:
1.
Stop the Dimensions RM Common Tomcat service.
2. Open <RM_Installdir>\Dimensions 24.4\Common Tools 2.4.0.0\tomcat\9.0\webapps\rtmBrowser\WEB-INF\web.xml with a text editor, e.g. Notepad.
3. Find param: contentSecurityPolicy and change it have the following value:
<init-param>
<param-name>contentSecurityPolicy</param-name>
<param-value>frame-ancestors 'self'; form-action 'self';
default-src 'self' http://www.wiris.net https://www.wiris.net 'unsafe-inline'
'unsafe-eval' data: blob:;</param-value>
</init-param>
4. Save file.
5. Start the Dimensions RM Common Tomcat service.
As of RM 25.2, when configure WIRIS integration
following plugin should be downloaded for integration:
Mathtype for TinyMCE,
Java Jakarta (not Java) integration zip.
7.3 When using custom forms for requirements,
upgrading from 24.4 and lower versions requires adding the Category attribute
to the forms
7.4 As
of 25.4, banners configuration moved to RM Browser
-> Administration
As of 25.4, RM no longer use configuration of banners from … \rtmBrowser\WEB-INF\web.xml
Customers who used header/footer before have to reconfigure the header and footer in the RM Browser -> Administration -> Administrative tools -> Banners. Example of configuration is available there.
afterwards Grant admin consent for Default Directory: Return to Contents
As of 24.4, RM is installed, by default, with secure configuration of web.xml. To use the WIRIS editor for html fields, the following change must be applied:
1. Stop
the Dimensions RM Common Tomcat service.
2. Open <RM_Installdir>\Dimensions 24.4\Common Tools 2.4.0.0\tomcat\9.0\webapps\rtmBrowser\WEB-INF\web.xml with a text editor, e.g. Notepad.
3. Find param: contentSecurityPolicy and change it have the following value:
<init-param>
<param-name>contentSecurityPolicy</param-name>
<param-value>frame-ancestors 'self'; form-action 'self';
default-src 'self' http://www.wiris.net https://www.wiris.net 'unsafe-inline'
'unsafe-eval' data: blob:;</param-value>
</init-param>
4. Save file.
5. Start the Dimensions RM Common Tomcat service.
As of RM 25.2, when configure WIRIS integration
following plugin should be downloaded for integration:
Mathtype for
TinyMCE, Java Jakarta (not Java) integration zip.
Do NOT use the QLARIUS, RMDEMO, ALM_DEMO, AGILE_RMDEMO or ISO26262 sample instances as a starting point for an actual production instance. Always start with the new instance or a template of your own that was created from the new instance and then saved (see the Saved Instances tab).
When upgrading the version of database (Oracle, MS SQL or PostgreSQL) used to support Dimensions RM, RM must be uninstalled following the Upgrade Scenarios documented in the Installation Guide.
RM Browser uses session cookies to process your login and recode your session authorization. Your browser and network security should be set at a minimum to "allow session cookies" for RM Browser. RM Browser does not allow you to log in with all cookies disallowed.
RM Browser can also use long-term cookies to store information about your defaults and use of RM Browser features. RM Browser does not require long-term cookies in order to operate correctly, but you have a more user friendly interface if all cookies are enabled for RM Browser.
Cookies can be enabled either in the options for the Web browser or in the settings of an external application that blocks cookies (such as a cookie manager or a personal firewall).
You can download the latest Dimensions RM documentation from the following location:
https://www.microfocus.com/documentation/dimensions-rm/
The manuals, readme, and release notes are no longer installed with the product.
Disabling the SSO login source with RM Manage should hide the login options (User Credentials; SSO; Smart Card) in all login dialogs. However, the options are not hidden for the Class Definition tool if SSO is disabled in some databases but enabled in others.
An error occurs in RM Import during import when the cell containing the specified keyword is the last cell in the table. This situation occurs when the template in RM Import Designer has Column next to keyword selected under Attribute Value on the Class Rules tab for the Section or Keyword option.
When administrators define new passwords for users, the passwords do not follow the password rule that new passwords differ by "n" number of characters from the old password. This rule applies only when users change their own passwords.
As of RM 26.2, RM Mail Configuration is moved to RM Browser Administration -> Administrative tools -> Mail Configuration. Old RM Mail Configuration tool is no longer available on the RM server.
There are situations in which you may receive the
"Password May be Incorrect in Security File or Security File May Not be
Found" error when logging in to a Dimensions RM tool. The following
table describes such scenarios and provides ways you can correct the problem.
For more information about database password encryption, refer to the Dimensions RM
Administrator’s Guide.
|
Case |
Potential Problem |
Troubleshooting Procedure |
|
1 |
No Dimensions RM instance exists on
the server. |
Make sure you have a Dimensions RM
instance on the server. You can test for this by selecting your database
instance in RM Manage, right-clicking, and selecting Change
User from the context menu. If you get the same error message again
instead of a prompt to log in, then there is probably no RM instance in the
database instance. |
|
2 |
You know a Dimensions RM instance
exists. The security file could be in the wrong location. |
In RM Explorer or RM Manage,
select Workspace > Options. Click the Security tab and
verify the location and name of the security file. |
|
3 |
You know the security file is in the
correct location. The database instance could need to be updated to match the
current security settings. |
In RM Manage, select the database
instance, right-click, and select Convert Database. When the database
validation tool starts, select your instance and click Upgrade. When
it prompts whether you want to recreate the stored procedures, click Yes. |
|
4 |
The ICADMIN or ICPROJECT account could
be locked. |
In
SQL Plus, try to log in as ICADMIN by typing the following text: sqlplus icadmin/<dummy password>@<database instance> If Oracle
returns a message that the account is locked, type the following text to
unlock it: sqlplus icdba/icdba@<database instance> alter user icadmin account unlock; exit Perform the same
procedure to check and unlock ICPROJECT. |
|
5 |
The Dimensions RM or Oracle path
could be wrong. |
In RM Explorer or RM Manage,
select Workspace > Options. Click the Mandatory tab, and
confirm that the RTM_HOME and ORACLE_HOME values are correct. |
At present, the Backup/Restore of schemas functionality does not work with MS SQL Server databases; the Deploy feature could be used instead
After installation of Dimensions RM with SSO (if it is an
upgrade from previous versions of RM), please make the following changes to
configuration:
1. Stop Dimensions RM Common Tomcat
2. Go to the C:\Program
Files\Open Text\Dimensions 25.4\Common Tools
2.5.0.0\tomcat\10.1\alfssogatekeeper\conf
3. Edit
gatekeeper-services-config.xml
4. In the
beginning of the file add following string (if not already in place):
|
Part 3:
Dimensions CM Integration |
For current supported platform information please see the online support matrix at https://www.microfocus.com/documentation/dimensions-rm/.
Installation of Dimensions CM client is required on the RM server environment.
NOTE: If there is a patch for your version, it is available in a knowledgebase (KB) article on the Micro Focus Support Web site.
16.1 CM / RM User
Names and Passwords Must Match and are Case Sensitive
In the ALM integration, the user name and
password must be the same for both Dimensions RM and
Dimensions CM. The user name and
password are case sensitive.
16.2 Unicode support for
integration
If you intend to use Dimensions RM/CM integration with non-English characters please sure that Windows locale on RM server is set to that language.
(e.g. set Japanese locale to support transfer data with Japanese symbols).
Note that for CM product, stream/project names you still should use ASCII characters
16.3 Automatic logon no
longer supported when open requirement from CM clients
With security enhancements no longer possible to support automatic logon from CM to RM Browser when open requirement or RM Browser Home view from CM clients.
User will be prompted to logon and afterwards can see content in RM Browser.
|
Part 4: Prototype Composer Integration |
For current supported platform information please see the online support matrix at https://www.microfocus.com/documentation/dimensions-rm/.
|
Part 5: ALM/Quality Center Integration |
For current supported platform information please see the online support matrix at https://www.microfocus.com/documentation/dimensions-rm/.
ALM OTA API is not compatible with 64-bit applications by default since ALM OTA API is a 32 bit COM component. Since RM 12.8.1 there are additional steps should be performed on the RM server host:
6. Install
the OTA client
(http://<server_name>:<port>/qcbin/start_a.jsp?common=true)
7. Open the
OLEView tool (OLE/COM Object Viewer) for Windows. Located under \Program Files
(x86)\Windows Kits\<x.x (depends on OS)>\bin\x86\ folder (NOTE: Manually
install OLEView tool for windows if OLEView.exe is not available under Windows
Kits.)
8. In the
left pane of the viewer, under “Object Class”, expand “All Objects” and select
“Mercury OTA Client”. The implemented interfaces are displayed in the Registry
tab in the right pane
9. Click the
Implementation tab and select the “User Surrogate Process” checkbox
Please note that for the synchronization of date attributes the config file (that was used with Dimensions RM versions below 12.10) should be edited, and the classpath value should be `````````````````````````````````````changed to the proper log4j version and should include both log4j-api-2.17.1.jar and log4j-core-2.17.1.jar
Example of classpath param value:
IMPORTANT! If the synchronization fails for any reason, extraneous issues starting with the text NewRequirement may appear in Quality Center and attempts to synchronize requirements linked to these items may fail. If you encounter these items in Quality Center, delete them and run a fresh synchronization.
|
Part 6: Other Integrations |
For current supported platform information please see the online support matrix at https://www.microfocus.com/documentation/dimensions-rm/.
Based on ease-of-use, the Micro Focus Connect
application is now the integration tool of choice.
As of RM 25.4, when use Dimensions RM Integration with ChatGPT gpt-5
or Gemini google/gemini-2.5-pro models, following configuration changes are
required:
Increase Max token value for ChatGPT and Gemini
System environment variables added to the RM
server host
Example
of new configuration for Chat GPT:
Endpoint:
<endpoint_value>
Key:
<key_value>
Model:gpt-5
Max
token: 60000
Example
of new configuration for Gemini:
Model:
google/gemini-2.5-pro
Max
token: 60000
Note.
for Gemini also need to have env variables added to host:
GEMINI_VERTEX_BASE_URL
(url
path to project endpoint)
GEMINI_VERTEX_SA_CREDS_PATH
(path
to json file with credentials)
|
Part 7:
Copyrights |
Copyright 2026 Open Text.
The only warranties for products and services of
Open Text and its affiliates and licensors (“Open Text”) are as may be set
forth in the express warranty statements accompanying such products and
services. Nothing herein should be construed as constituting an additional
warranty. Open Text shall not be liable for technical or editorial errors or
omissions contained herein. The information contained herein is subject to
change without notice.
Except as specifically indicated otherwise, this
document contains confidential information and a valid license is required for
possession, use or copying. If this work is provided to the U.S. Government,
consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer
Software Documentation, and Technical Data for Commercial Items are licensed to
the U.S. Government under vendor's standard commercial license.
End Readme