26 February 2018
Integrate Systems Engineering Ltd
This file contains last-minute information about KeyApps® 1.3.4 for DOORS.
The file is divided into the following sections:
To run KeyApps for DOORS you need:
The minimum system requirements for KeyApps 1.3.4 for DOORS are the same as the recommended requirements for the version of the DOORS client that you have installed. These requirements can be downloaded from the IBM Rational software support site.
back to top
KeyApps for DOORS is compatible with the following IBM® Telelogic® DOORS® and IBM® Rational® DOORS® products:
back to top
You must not install KeyApps for DOORS in the
folder. If you do, KeyApps will fail to run.
The KeyApps installation includes a license file. Whenever any change is made to license settings, KeyApps updates the license file to record this change. This means that KeyApps must have write access to the license file. You should therefore install KeyApps in a folder to which (at a minimum) KeyApps administrators have write access.
Note that, in the case of network installations, all DOORS clients must access the KeyApps installation via the same network path.
Once you have downloaded the software, follow the instructions below to install KeyApps for DOORS on a local machine:
C:\Documents and Settings\username\My Documents\Integrate\KeyApps 1.3(or
C:\Users\username\Documents\Integrate\KeyApps 1.3on Windows 7), where
usernameis your operating system user name. You can change this to any folder to which you have write access.
Once you have downloaded the software, follow the instructions below to install KeyApps for DOORS to a network location:
msiexec /a "d:\msipath\msiname.msi" TARGETDIR="targetpath"
dis the drive on which the installer is located
msipathis the path to the installer file
msinameis the name of the installer
targetpathis the network path for the installation
msiexec /a "C:\downloads\KeyApps_1_3_3_IBM.msi" TARGETDIR="\\MyShare\DoorsApps"
KeyApps for DOORS is a DOORS addin extension, and so DOORS must know where to
find the KeyApps software files. Since KeyApps is installed outside of the
standard DOORS installation path, the location of the KeyApps installation must
be added to the DOORS
These paths can be specified in two different ways:
Instructions for each of these options are as follows:
Do the following...
Open DOORS using a shortcut or command line in the following format:
Set the appropriate string values in the Windows registry key
Note: direct editing of the Windows registry is potentially hazardous and should only be undertaken by experienced systems administrators.
In both cases, the
may refer only to the KeyApps installation, or they may be a semicolon-separated
list of paths to both KeyApps and other DXL programs.
For more information about DOORS
PROJECTADDINS paths, see 'The DXL Library and Addins menus' in the
DXL Reference Manual or online DXL help, and 'Using the command line' in
Using DOORS or online DOORS help.
The installed KeyApps software provides a generic platform for process-centred productivity environments in DOORS. The appearance and behaviour of the KeyApps user interface is controlled by a configuration file that is specific to a given client or a given DOORS project.
Note: To access KeyApps, a given user must be authorized as a KeyApps user. See Managing KeyApps users for information on how to authorize users.
KeyApps is a collection of small tools and utilities, not all of which are relevant to a particular user or organisation. KeyApps is therefore supplied with the Manage KeyApps function to select which Apps are available and set user permission for each.
back to top
For KeyApps to run, you must have a valid license. This license defines how many users can access KeyApps and the period of validity (where appropriate). In addition, the license defines whether KeyApps may be used on many DOORS databases or whether it is restricted to run on a single DOORS database.
You can freely download and install KeyApps for DOORS on your computer for evaluation purposes. This allows you to try KeyApps without any cost or obligation before you purchase it for a period of 30 days after the installation. After the evaluation period ends, you will no longer be able to run KeyApps until you purchase and install a KeyApps license.
For more information about KeyApps licensing options contact us.
You can check your license in the KeyApps About dialog box. This dialog is also used to install new license keys and manage licensed users.
The About dialog gives product details, license details and copyright information. The license details section shows the installed license key, the license type and expiry date (if any), the number of licensed users and the license mode. This section also shows the license status. If the license is valid and you are an active, authorized user, the status is shown as 'Valid'. Otherwise a license error is shown.
You can install a new license key by clicking on the Install Key button in the About dialog.
Note: to install a license key, you must be logged on to DOORS as a Database Manager (or a Custom user who has the power to manage the database), and you must also have write access to the KeyApps installation folder.
Enter your new license key in the Install New License dialog, then click Install. KeyApps will check and install the license key, and then update the About dialog to show the new license details.
Your KeyApps license defines the maximum number of uses that can access KeyApps at any one time - this is known as the licensed user quota.
To access KeyApps, a given user must be authorized as a KeyApps user. KeyApps administrators have complete control over the list of authorized users and can change its membership at any time. In addition, if you have a multi-database license, you can share the licensed user quota flexibly across multiple databases.
There are three steps to allow a given user of a given database to access KeyApps, namely:
You manage KeyApps users by clicking the Manage Users button in the About dialog.
Note: to manage KeyApps users, you must be logged on to DOORS as a Database Manager (or a Custom user who has the power to manage the database), and you must also have write access to the KeyApps installation folder.
When you first run KeyApps after installation, the program allocates a single user to the current database, adds you to the list of authorized users, and enables you as an active user. All subsequent changes to the user licensing configuration are made manually.
back to top
back to top
For further support, please visit our support website at http://support.integrate.biz/.
back to top
KeyApps for DOORS copyright © 2012-2017 integrate systems engineering ltd.
KeyApps is a trademark of integrate systems engineering ltd.
IBM®, Telelogic® and DOORS® are registered trademarks of IBM Corporation.
Microsoft, Windows, Windows XP, Windows Vista, Visio and/or other Microsoft products referenced herein are either trademarks or registered trademarks of Microsoft Corporation.
Mindjet® and MindManager® are registered trademarks of Mindjet LLC in the United States and other countries.