Installing BranchManager for DOORS®
BranchManager for DOORS is deployed as a standard DXL plugin for DOORS®. The deployment package is provided as a zip file. Simply unzip to any location on your hard drive and follow the launch instructions below. To add the tooling to your client installation, use one of the following methods.
DOORS launch with standard bat file
Launch the appropriate batch file found in the root of the deployed package (startDOORS.bat file).
Launch the appropriate batch file found in the root of the deployed package.
This will launch the DOORS client with the standard database including the BranchManager features. If you are using a different server/port, edit the launch command within the batch file to point to your database.
Update your launch scripts with the plugin location
BranchManager is integrated in the module menus and the DOORS project explorer menus.
There are two locations where menus must be added to the DOORS client. The Menus are added at the main level and at the project level.
Adding the main menus
In your launch script, add the parameter '-a path/to/standardmenus'. The standard menus can be found in '%PluginRoot%/menu/EN/addins'.
Adding the project menus
In your DOORS client launch script, add the parameter '-J path/to/projectmenus'. The standard menus can be found in '%PluginRoot%/menu/EN/projectaddins'.
Where %PluginRoot% refers to BranchManager install directory.
Update your Windows registry
As an alternative, if you have many DOORS launches that all need to use BranchManager, you can utilize the registry definitions. Depending on your OS version these will be in slightly different locations. Look for registry key 'HKEY_CURRENT_USER\Software\Telelogic\DOORS\9.3\Config'. In that location, add the location of your installation of your addins and project addins similar to the following...
addins = install_location\menu\EN\addins
projectaddins = install_location\menu\EN\projectaddins
If the addins/projectaddins value already exists, then these values need to be added to the existing value with a semicolon as a separator.
Important: For BranchManager to launch correctly, you need to add the source code path to either the addins or projectaddins. The illustration below shows the source code path and the addin path added to the Registry entry “addins”, and the projectaddins path added to the Registry entry “projectaddins”.
For example: |
For more details on how to centralize DOORS DXL scripts, please refers to http://www-01.ibm.com/support/docview.wss?uid=swg21324525
License Installation
BranchManager for DOORS® provides several levels of licenses as well as options for floating or node locked licenses. The instructions on configuring and deploying these licenses follows.BranchManager license types
BranchManager is FlexLM licensed. To use BranchManager you need a license file, that will be issued by IT-QBase for evaluation or after buying the product. BranchManager has three license types providing the following capabilities:
- Compare
The compare license provides the facilities to compare formal modules.
- Branch
The branch license provides the ability to create a branch of a project hierarchy into another project
- Merge
The merge license provides the ability to merge changes from matching formal modules across branches either using the integration or quick merge methods.
FlexLM features Floating and Node-Locked licenses.
When using floating licenses, on the start of the tools, a license or the corresponding feature will be checked out from the license server and will stay checked out for a fixed amount of time (two hours). If there is no available license the tools will not start and an error message will be given.
Installing Node Locked licenses.
Node locked licenses provide the ability to utilize BranchManager capabilities on the local machine.
Configuration is minimal.
- Store your license file on your local machine.
- Start DOORS with BranchManager enabled.
- On the BranchManager menu go to the License Information...
- In the following dialog provide the path to the intended license file.
 |
You are now ready to use your authorized BranchManager features.
Installing floating licenses
Floating licenses provide the ability to share BranchManager capabilities across multiple users.
If you do not have an existing FlexLM license manager installed on your Windows server machine, you can install IT-QBase License Manager. If you already have a FlexLM license manager, you can use it.Install IT-QBase License Manager
System Requirements
IT-QBase License Manager requires a Windows operating system. Other operating systems are not supported.
We provide an installer to easily install and configure the IT-QBase License Manager on a Windows server. This is the recommended option to install the license manager.
It can be downloaded from here:
IT-QBase License Manager
For details on installing the license server and the license file, please visit: Installation Manual
License File Installation
Once you receive a license file from IT-QBase, you must install this license:
- Rename the license file you received to mdw.lic and copy it into the folder licenses (you must overwrite the existing file).
- Click the Windows menu Start > All Programs > IT-QBase > License Manager > FlexNet Utilities (or run binlmtools.exe)
- Select the Start/Stop/Reread tab in the opened LMTOOLS application.
- Select the service IT-QBase License Manager in the FlexNet services list.
- Click Start Server.
Reuse a FlexLM license Manager
If you already have a FlexNet License Server Manager installed on a Windows server, and if you don’t want to install a second license manager, you have the option to add the IT-QBase FlexNet vendor daemon on top of your existing license server. Please refer to the “Managing Licenses from Multiple Vendors” chapter of the Flexera License Administration Guide for more information.
This option is available for administrators already familiar with FlexNet based products.
IT-QBase vendor daemon (Windows only) can be download here : IT-QBase Vendor Daemon
How can i run BranchManager for DOORS® in french ?
You have to do two things to run BranchManager for DOORS® in French:
- To launch French menus: In order to launch French menus, you have to modify the MENULANG variable from EN to FR. This variable can be modified in the startDOORS.bat. Note that in the instructions above, wherever the menu path is mentioned, you have to replace /EN/ with /FR/.
- To launch French documentation: In order to launch the documentation in French, you have to modify the variable -nl from "en" to "fr". This variable can
be found in the file eclipse.ini, into \src\tools\lic.