Installation Reference & FAQ


30.1 General Questions

30.1.1. Q: Can I be kept up to date about new releases?

Yes, just send an email or contact us.

30.2. Installation questions

30.2.1. Q: Can I Install and run BowTieXP on Apple Mac (OSX)?

The BowTieXP software is built for the Microsoft Windows operating system. Unfortunately, BowTieXP is not Apple Mac (OSX) compatible. Macs nowadays do have the ability to run Windows software on them. There are two main ways to go about that:

1. Actually install Microsoft Windows on your Mac using Boot Camp. You can switch between Windows and OSX, but it requires rebooting.


2. Emulate Microsoft Windows via a program such as Parallels.


Our advice is to run BowTieXP on the Microsoft Windows operating system (not emulated) as we support this option and it works best, but we have seen clients successfully use BowTieXP on their Mac by emulating Windows using products such as parallels.

If cross platform support and device support is of interest to you, you might want to make your bowties easily accessible for viewing by (all) the employees in your organization by using our web viewer – a part of BowTieServer. The web viewer (for viewing only, not editing) is independent of operating system, as it is a web solution which runs on your browser. Therefore, it runs on Microsoft Windows, Apple Mac OSX, but also your iPads

30.2.2. Can I install BowTieXP on a server?

That depend Q: s on what is meant exactly – see the questions below regarding network shares and Terminal Server / Citrix.

30.2.3. Q: Can BowTieXP run off a network share?

Yes, provided the client computers are running Windows Vista or Higher. If the clients are running Windows XP, a change has to be made to the .NET security configuration.

30.2.4. Q: Can BowTieXP run under Terminal Server or Citrix Server?

Yes, BowTieXP is fully compatible with Terminal Server and we have reports from customers it runs flawlessly on Citrix. You will need a group locked activation – host locked activation is not supported in this scenario.

30.2.5. Q: Does BowTieXP support virtualization?

This depends on what is meant with virtualization: Page 238 of 245

 If with virtualization you mean running the software on a remote server and showing the app via the network (also known as desktop virtualization/VDI), then the answer is yes –for Microsoft Terminal Server. See the questions about Terminal Server and Citrix.

 If virtualization refers to portable application generators like Spoon studio or VMware ThinApp, the answer is no, but this does not mean it will not work – just that we cannot support that scenario. Should any issues present, we will of course try to resolve those but we cannot guarantee we can – some of those applications do some very complex things to the software. We know, we used some of those tools for previous BowTieXP versions.

30.2.6. Q: What rights/access does BowTieXP need on the computer to run / can BowTieXP be used in a no-touch deployment situation / is a portable version available?

BowTieXP requires only regular user rights to function. BowTieXP adheres to the Microsoft standards about where to store data. In practice this means:

Configuration files are stored in the user’s application profile (in %APPDATA%\Governors\BowTieXP).

Activation data is stored in the local part of the profile (%LOCALAPPDATA%\Governors\BowTieXP).

If BowTieXP has admin rights it will store activation data in the all users profile / application data path (%ALLUSERSPROFILE%\Governors\BowTieXP).

If allowed, a registry entry will be added to HKCR for the file association and protocol handler. The association is stored in HKLM if allowed, else in HKCU.

30.2.7. Q: How can I deploy activation keys along with the application / when scripting the application?

You can place the codes in a text file names activationcodes.dat and place that next to the exe. They will be picked up automatically. Note that all files which start with activation and end with .dat are considered (activation*.dat). The first working code which is found is used.

Activation codes for plugins can also be placed next to the exe. The files must conform to the pluginactivation*.dat search pattern.

You can copy the plugin activation codes file ("pluginactivation.dat") from one of the below folders and copy it next to the exe:

 %PROGRAMDATA%\Governors\BowTieXP\pluginactivation.dat or

 %APPDATA%\Governors\BowTieXP\pluginactivation.dat

That ensures the correct format.

30.2.8. Q: Activating all the licenses we bought one computer at a time is too much work. Is there an alternative?

Yes – if your computers are domain computers you can activate the software by making the users members of a dedicated active directory group.

The group has to be a global or universal security group. A code is generated for this group. The code works for all members of that group.

The code contains a maximum number of users. If there are more users in the group than the maximum, the software will not run.

30.2.9. Q: Group locked - if I change the number of licensed users or the type of license, do I need to update each computer?

Yes - if you purchase additional licenses, you will be issued a new activation code. This code has to be deployed to each computer where BowTieXP is installed. This can be done by IT updating the scripted installation package or by mailing the users so they can enter the new code manually.

This is a result of having a licensing mechanism without a central server. Not having a central licensing server has advantages and disadvantages. Having to deploy new codes is a disadvantage as it takes more work. Not having to install a license server, adjusting firewalls, and having trouble with people going off the network is an advantage.

30.2.10. Q: What are the steps to create this group-locked activation code?

This is also covered in-depth in our software manual.

Short list of steps:

1. Create group in AD

2. Make all licensed users members of this group

3. Send group SID or site id to us

4. We respond with an activation key

Here are the detailed instructions for doing so:

1. Create a user group in Active Directory to hold the licensed accounts: e.g. "BowTieXPUsers". This can be done on a domain controller using the "Active Directory Users and Computers" MMC applet.

2. Add all the user accounts which will be licensed into the group.

3. We will need the group SID/site id (internal numerical group code) in order to calculate an activation code for this group. We will store this code into a small text file called activation.dat, which must be placed next to the BowTieXP executable so it can be found.

The next step is retrieving this SID/site id. This can be done via BowTieXP, unless the number of groups on the server is very large. Then we recommend using the command line.

A. Via BowTieXP: Start BowTieXP. The activation dialog will appear. If not, go to Help->Activation Codes. Click the blue link to show site licensing options also. Select the BowTieXPUsers group from the drop down. Send the site id to us.

B. Via the command line. Open up the command line and issue the following command for your own BowTieXP users group:

wmic group where name='BowTieXPUsers' get sid

and mail the SID (S-1-5-21-....) back to us.

4. After receiving the code, we will create an unlock code for you and send this back in a small text file, called activation.dat, which must be placed next to the BowTieXP executable. After this, all members in the group should be able to run BowTieXP.

Tips for testing:

 Make sure the test user is actually a member of the group (this is often forgotten),

 Group membership changes take effect after log-off and log-on.

30.2.11. Q: Will group activation still function if my computer is without network access for a long period of time?


30.2.12. Q: I am testing BowTieXP group activation but I get the following error: "Activation code does not match any of the current user’s group memberships".

Ensure the current user is a member of the activated group. You can verify this by letting BowTieXP show you the current user’s group membership.

30.2.13. Q: The user is added to the group in active directory, but BowTieXP does not pick up this change.

There are several reasons why the change might not have taken effect yet:

 Active directory servers need to sync before changes are applied. The default schedule is two hours. Wait at least this long and try again, or ask the AD admins to force a sync.

 The group membership info for the current user is only updated when logging on. Please log off and back on again to update the user’s group memberships (the security ‘token’).

 If the activated group is a distribution group BowTieXP will not see it. Ensure it is a security group. You can double check this in AD users and computers by viewing the group properties. Security groups are the default group type.

30.2.14. Q: Activation error: Activation code does not match the activated or current host id.

Before you entered the activation key, the hardware was changed. Perhaps a laptop docking station was attached or detached.


1. Restore the original hardware situation. You need to close and open BowTieXP after changing this.

a. If the docking station is connected, unplug the docking station and try again.

b. If it is disconnected, try connecting it.

2. If that does not work: Select "lock to this computer with an old host id".

a. If the box is empty: enter the original host id sent to us in the activated host id box.

b. If it is not empty: Try clearing it.

3. If both fail: Contact us for a new key.

30.2.15. Q: How can I script the installation?

The msi can be with the regular command line options:

msiexec.exe /i <msifile> /qb

If you want to also deploy the dat license file you might need to capture changes to create a deployment script, or manually make sure the dat file is placed next to the exe. Another option is for end-users to enter it manually. Note that BowTieXP has no dependencies other than having the framework 3.5 SP1 or higher installed. Deployment is xcopy deployment; all the msi does is:

1. Copy the bowtie.exe file to C:\Program Files\BowTieXP\

2. Add a shortcut to the start menu and the desktop.

A sample script could look like this:

msiexec.exe /i "%~dp0bowtiexp-5.0.8.msi" /qb

copy "%~dp0activation.dat" "C:\Program Files\BowTieXP\activation.dat" /y

The variable %0 in a batch script is set to the name of the executing batch file. The ~dp special syntax between the % and the 0 basically says to expand the variable %0 to show the drive letter and path, which gives you the current directory containing the batch file.

Note: This sample does not know the difference between 32 bit and 64 bit systems so you might want to take that into account (i.e. copy file to the "Program Files (x86)" folder instead of to the regular "Program Files" folder).

30.2.16. Q: What prerequisites / dependencies does BowTieXP have?

BowTieXP requires the .NET Framework 3.5 SP1 or higher to be installed. Windows 7 and later come with the .NET Framework version 3.5 SP1 already installed out of the box, or will detect the need and install automatically. On Windows Vista, you need to do this manually.

In Windows XP and Vista you will need to install the framework if not yet installed.

See here for an overview:

If you want to use the import from Thesis function you will need MDAC 2.71 or higher. If you are running Vista or higher this should already be present on your system.

In Windows XP there’s a tiny chance you might have to update the component.

Microsoft MDAC FAQ:

30.2.17. Q: Can I deploy templates along with the software?

Yes, just place the btf files in a directory called "Templates" located next to the executable. They will be automatically picked up and built-in templates will be automatically hidden.

30.2.18. Q: Can I install mutiple versions side by side? I need to support files which must stay in an old file format.

Some people, for example consultants, need to run different versions of BowTieXP side by side in order to keep files in the file format their clients use. We have made sure that you can run different versions side by side, and from version 3.6.4 and onwards, we have added some more support in the software for this scenario: you can view the version in which a file was last saved.

To view in which version a file was last saved, open it in BowTieXP and choose File->Properties.

For example, assume we see that the file was written using a 3.6 version. Since all 3.6 versions share the same file format, we can edit this file using the latest 3.6 version and send it back to the person we got it from, and they will be able to read it without having to upgrade to the latest version.

In order to run different versions of BowTieXP side by side, all we have to do is to download the different versions we want and make sure to grab the versions for manual installation (the zip files).

All BowTieXP versions needed to support every file format version ever released, are available on the download page located at

Let’s show by means of an example (the 2.3.0 file) how to install the correct version. We need BowTieXP 2.3.0 to edit this file without upgrading the file format. Go to the download page and locate 2.3.0.

Download the executable ("in a zip file, for manual installation"). This zip file contains the bowtie.exe version 2.3.0. Unzip it to a suitable location, such as your desktop. You probably want to rename it to reflect the version number.

After starting the older BowTieXP version, you might be confronted with an activation dialog. Contact us for an older key – we can put this into a small file called activation.dat which is automatically picked up by BowTieXP, so you do not need to enter the key manually. Just make sure the file is located next to the executable.

30.2.19. Q: How does the auto update work?

The behavior of the auto-update depends on the way in which BowTieXP was installed.

BowTieXP can be installed in two ways:

1. Via the msi

2. By placing the exe somewhere on the system

If an update is available, the following will happen if the user requests it / clicks the notification:

In the first case (msi installed), BowTieXP will download the msi and ask windows to install it, upgrading the old installation. Windows will ask for admin credentials if the current user is not an administrator.

In the second case (installed from zip file), BowTieXP will download the new exe and replace the current one. If the user has no write access to the exe no attempt will be made (i.e. the update check is notification only, auto-upgrade is not possible).

30.2.20. Q: How can I disable the auto-update?

To disable the auto-update, the read-only bit on the file can be set. This will disable all upgrade functionality. In this case the software will still check for updates (if requested or if the periodic check is enabled), but it will only be a notification, no attempt at auto-upgrading is done.

30.2.21. Q: How often are updates and upgrades released? What is your release schedule?

BowTieXP has regular updates, addressing bugs. These versions are recognizable by having the same first two numbers but a new third number. E.g. if you have 5.2.2, then version 5.2.3 will have the exact same functionality but less bugs. The same goes for versions 5.2.4, 5.2.5 etc.

Once or twice per year we also bring out a new version with new functionality. The version with new functionality will have a new file format to accommodate the new features. To indicate this, we change the first and/or second version numbers. E.g. we go from 5.0 to 5.2.

If keeping up with the new versions is a challenge, it is advisable to pick a version to stay with for a longer time. Only when users are running into bugs or if critical bugs are discovered and fixed, should a new version with fixes be deployed. To prevent this, it is advisable to wait a while when a new version with new functionality is released before deploying it, allowing more time for bugs to be fixed before that version is deployed.

30.2.22. Q: I get an exception about "no more files" on startup when trying to run BowTieXP deployed/virtualized with App-V

We have seen this problem when during scripting, one of the directories used by BowTieXP was monitored and should have been excluded. In that case the directory which should have been excluded was:


After excluding this directory, the software worked correctly. See here for someone with a similar problem, but for a different software product (not related to us):

30.2.23. Q: Plugins do not seem to load, but are placed in the right location.

Please check to see if you are running BowTieXP from a network location. Plugins can only be loaded from the local hard disk, not from a network drive.

30.3. Q: Software questions

30.3.1. Q: Can I convert diagrams to pdf?

Yes – either copy the diagram to the clipboard, paste in Word/Excel/Visio 2007 or higher. You can save the file as a pdf from Office.

Another option is to print to a pdf printer, but in our experience the Office route offers better image quality.

30.3.2. Q: Which Office versions does BowTieXP support?

We support all office versions higher than Office 2000.

30.3.3. Q: Which Visio versions does BowTieXP support?

We support Visio 2002 and higher. See paragraph 13.4 for Visio diagram exporting details.

30.3.4. Q: Can I save files to an older file format?

This is unfortunately not possible. You might be able to convert a file back to an older version by means of the scrap book – the scrap book has somewhat better forward compatibility due to the fact that the scrapbook exchange file format is being kept as constant as possible.

Unfortunately, after the introduction of BowTieServer some scrapbook file format changes had to be made. Introducing a new file format always leads to the situation where "old" versions of the software will not be able to read the "new" scrap book file format. The "old" scrap book format is supported up to versions 6.2.6 of BowTieXP. The new scrap book exchange format was introduced in version 6.2.7 of BowTieXP.

Note: be sure to use the latest version of the target version (i.e. if you need to convert to file format 4.2, be sure to use the latest 4.2 version in this case 4.2.9).

For example, here are the steps to take to down-convert a file from v5.2 to v5.0

1. Open 5.2 and 5.0 side by side and ensure you are running BowTieXP Advanced. Ensure the scrapbook is visible in both. Open 5.2 on the left, 5.0 on the right.

2. Open the file to convert in 5.2. Create a new file in 5.0 on the right. Empty ALL the lookup table entries in the destination file.

How to move items from 5.2 on the left to 5.0 on the right:

a. Drag items from the tree view onto the scrapbook in 5.2 (left) onto the scrapbook. Save the scrapbook. In 5.0 on the right, click the load scrapbook button and open the file.

b. Drag the items in 5.0 (right) to the correct bowtie group in the tree view.

Note: this mini guide is not verified for completeness / i.e. it might not be an exhaustive list!

3. Transfer the contents of all lookup tables, starting from the top and working your way down. Include activities, document links, etc.

4. Manually recreate the risk matrices. This has to be done by hand.

a. Recreate the categories.

b. Recreate the matrices themselves.

c. Use the copy matrix function where possible.

5. Terminology. Export the terminology from 5.2 to Excel. Try to import in 5.0. Errors will be given, fix each by hand and try until it succeeds. Fixing involves removing lines of terminology which 5.0 does not understand.

6. Transfer all incidents and bowtie groups using the scrapbook. This is done in the same manner as the lookups.

7. Save the spreadsheet if any. Load into 5.0. Check for moved columns and adjust accordingly until the calculations are in order again.

8. Verify completeness using the case file compare function.

9. Check the following and transfer manually if needed:

a. Null value descriptions and colors.

b. File property fields (File->Properties).

c. Treeview filter profiles.

d. Treeview tooltips.

e. Diagram display profiles.

f. Verify font settings.

g. Header and footer layout.

Now most items should be transferred.

30.4. Q: Software problems

30.4.1. Q: Printing does not work/crashes.

There are some incompatibilities between .NET and some printer drivers, which unfortunately we can do nothing about. If printing does not work for you, please copy the diagram to the clipboard and paste in Word, Excel or Visio and print for there. Excel has very good multi-page printing support.

30.4.2. Q: Startup of the software takes very long.

We have reports from Sophos users that starting the software the first time takes quite long – apparently Sophos wants to take a detailed look. This problem goes away by itself. Otherwise you can whitelist the application in Sophos.

Note: BowTieXP normally starts in a couple of seconds.

30.4.3. Q: When opening BowTieXP, I get an error message about fonts.

Please install the Microsoft European Union Expansion Font Update:

30.4.4. Q: I can no longer save documents as pdf if they have bowtie images in it (Office 2007)

This is a known incompatibility with Office 2007 – the images generated by BowTieXP version 5.0 or earlier cannot be converted to pdf by the Office 2007 pdf add-in.

This used to work okay but stopped working due to a change in Office, by means of Windows Update, and started in April 2012. Office was changed and now no longer can make pdfs of those documents.

There are several resolutions, listed in order of preference:

 Upgrade to Office 2010. Office 2010 does not have this problem.

 Use an external PDF printer - free ones exist such as

 Upgrade to BowTieXP v5.2 and redo the graphics.