MindManager X5 Pro Large-Scale Deployment Strategiesdownload.mindjet.com/static/pdf/eng/MindManager_X5...MindManager X5 Pro Large-Scale Deployment Strategies Abstract MindManager X5

Copyright © 2004 Mindjet LLC MindManager X5 Pro Large-Scale Deployment Strategies Page 1 of 40All Rights Reserved Document v1.1

MindManager X5 ProLarge-Scale Deployment Strategies

AbstractMindManager X5 Pro is designed using industry-standard setup technology to make it easy forLarge-Scale Deployment throughout an organization. This document describes various Large-Scale Deployment strategies, their advantages and disadvantages. In addition, information usefulfor systems administrators of large organizations is described.

Table of Contents1 Deployment Strategies

1.1 Run the Standard Setup Manually or Automatically (Supported)1.2 Run the Admin Setup Manually or Automatically (Supported)1.3 Install the Program on a Windows Terminal Server (Supported)1.4 Use System Management Software and a Custom Setup (Limited Support)1.5 Install the Program on a Shared Network Drive (Not Supported)

2 The Admin Setup2.1 Differences Between the Standard and Admin Setups2.2 Running the Admin Setup – The Essentials

2.2.1 Setup Command-Line Options2.2.2 Sample Setup Commands

2.2.2.1 Simple Install2.2.2.2 Silent Install2.2.2.3 Uninstall

2.2.3 Installing Library Files to a Network Folder to Reduce Hard Disk Footprint, InstallationTime

2.2.3.1 Using the Interactive "Deploy user data files" Dialog2.2.3.2 Using Registry Settings Instead of the "Deploy user data files" Dialog

2.2.4 Separate Tutorials Setup2.2.5 Other Utility Software Used By MindManager

2.2.5.1 Macromedia Flash Player2.2.5.2 Adobe Reader

2.3 What the Setup Does – A General Overview2.3.1 The Two Phases of Setup: Machine and User

2.3.1.1 Per-Machine Setup2.3.1.2 Per-User Setup

2.3.2 Components


2.3.2.1 Program2.3.2.2 Library2.3.2.3 Dictionaries2.3.2.4 PDF Writer2.3.2.5 TabletOS2.3.2.6 SOAP2.3.2.7 NonTabletOS2.3.2.8 Tutorials

2.3.3 Installed Files and Folders, Registry Keys, Shortcuts and Menu Items2.3.3.1 Files and Folders2.3.3.2 Registry Keys2.3.3.3 Shortcuts and Start Menu Items

2.3.4 Required Permissions and Privileges3 Windows Terminal Server Installation

3.1 Windows Server 20033.2 Windows 2000 Server3.3 Citrix MetaFrame Presentation Server

3.3.1 Basic Installation for Use with the Citrix Desktop3.3.2 Advanced Installation of a "Seamless" Window

4 Other Systems Administrator Topics4.1 Administrative Registry Settings

4.1.1 HKEY_LOCAL_MACHINE Settings4.1.2 HKEY_CURRENT_USER Settings

4.2 Add-In Registration4.2.1 Registering or Unregistering Add-Ins4.2.2 Disabling or Removing Add-Ins

4.2.2.1 The Registry Add-In List4.2.2.2 How to Remove (or Restore) an Add-In4.2.2.3 How to Disable (or Enable) an Add-In4.2.2.4 The MindManager Office Add-Ins

4.3 Event Macros4.4 Policies Support4.5 License Management

4.5.1 Per-User vs. Per-Machine License Key Administration

1 Deployment StrategiesThere are a number of popular ways to distribute software to users in a large organization. Onlysome of these work well with MindManager X5 Pro and are officially supported at this time. TheLarge-Scale Deployment strategies that are discussed include:

1.1 Run the Standard Setup Manually or Automatically (Supported)1.2 Run the Admin Setup Manually or Automatically (Supported)1.3 Install the Program on a Windows Terminal Server (Supported)1.4 Use System Management Software and a Custom Setup (Limited Support)1.5 Install the Program on a Shared Network Drive (Not Supported)

These are described in more detail in each section below.


1.1 Run the Standard Setup Manually orAutomatically (Supported)Running the MindManager X5 Pro standard setup (available on CD or from the Mindjet web siteat http://www.mindjet.com/) on each user's system is an "officially supported" method of installingMindManager X5 Pro. You can run the setup either from the original CD or copy the setup tosome centrally accessible server and run it from there. It can be run manually by the user or aspart of a log-on script.

The standard setup is designed to be robust, interactive and user-friendly. However, it does notoffer the flexibility, customizability and control required for professional large-scale deployment bysystem administrators. For example, the standard MindManager X5 Pro setup does not support a"silent" installation mode. Please see information about the admin setup for this and otheroptions.

The advantages of the standard setup approach are:

• The program will install and operate properly on supported systems.• No additional software or server resources are required.• Users can install updates themselves with the “Help”, “Check for Updates” command (but

by default this command is only visible if they have “write permission” for theHKEY_LOCAL_MACHINE section of the Windows registry).

The disadvantages are:

• Manual installation can be a time-consuming process.• The installed software uses up disk space on each user's system.• It is not well suited to centralized control and maintenance.

1.2 Run the Admin Setup Manually or Automatically(Supported)Mindjet offers a special MindManager X5 Pro admin setup program (available on CD or from theMindjet web site at http://www.mindjet.com/) that gives systems administrators more control overan installation. Running the admin setup on each user's system is an "officially supported"method of installing MindManager X5 Pro. System administrators can run the admin setup fromsome centrally accessible server manually or via a log on script. On systems using WindowsActive Directory, Group Policy and IntelliMirror, the admin setup can be used to install theprogram automatically on groups of users' systems. Or the admin setup can be transformed anddelivered more automatically via system management software (described later).

The advantages of the admin setup approach are:

• The program will install and operate properly on supported systems.• No additional software or server resources are required.• There is greater control over the installation process.• The setup can be run silently.• The installer isn't cached locally on the client machine.• It is possible to reduce the use of local machine disk space.


http://www.mindjet.com/)



• It does not support “update patches” for upgrades; the full admin setup is used to do anyupgrades.

• Access to the original installer is required for Repair and other setup operations to workcorrectly.

See 2 The Admin Setup for more details.

1.3 Install the Program on a Windows TerminalServer (Supported)Another potential solution to the large-scale deployment of software is to use a terminal server inconjunction with “thin” client computers. In this model, the application is run on the terminal serverbut is displayed and operated by a client computer. With this client/server architecture it ispossible, for example, to "run" a Windows XP application on a Windows 98 client machine, whereone server services many clients.

Companies that wish to decrease the total cost of software ownership are looking at terminalserver solutions since thin client computers are much less expensive than more powerful desktopworkstation computers required to run many modern applications.

Mindjet supports running MindManager X5 Pro SP3 or later with Windows 2003 ServerTerminal Services or Citrix MetaFrame Presentation Server with clients running in 16-bitcolor mode or greater. MindManager X5 Pro runs in full color mode and does not support 256-color mode. Therefore we highly recommend that terminal server clients be run in full color modeas well. Full color mode is not supported by Windows 2000 Server Terminal Services, but it issupported by Windows Server 2003 Terminal Services.

The recommended procedures for installing MindManager X5 on a Windows Terminal Server aredescribed in section 3 Windows Terminal Server Installation.

1.4 Use System Management Software and aCustom Setup (Limited Support)There are a variety of software programs that help system administrators automatically install andmanage software on users' systems. In general, we call this system management software. Anexample of this type of software is the Microsoft Systems Management Server(http://www.microsoft.com/smserver/).

The general procedure when using system management software is to:

1. Install MindManager on a special "observer" machine that records what goes on duringthe installation process.

2. Customize this recorded information as necessary perhaps allowing for different usernames, initial registry settings, etc.

3. Create a custom setup.4. Automatically deploy the application using the custom setup.

System management software can be used today with MindManager X5 Pro. However, there isno specialized support for this in MindManager X5 Pro. While Mindjet cannot help diagnose andsolve problems with custom setups that you create, we do provide a wealth of related informationthroughout this document.

http://www.microsoft.com/smserver/).


The advantages of the system management software approach are:

• The program can be installed on many systems with one command.• Different setups can be created for different groups of users.• The same technology can be used to automatically distribute updates when available.• May provide more centralized control of users' systems.


• The company must invest in system management software.• It takes time to create the custom setup.• The installed software uses up disk space on each user's system.

1.5 Install the Program on a Shared Network Drive(Not Supported)Installing a program once on a single shared network drive and having all users run it from therewill work for simple utility programs. This keeps the program storage footprint small and makes iteasy to maintain and update since the program is only on one machine.

However, this approach does not work for more complex, full-featured applications likeMindManager X5 Pro that interoperate with a number of other programs and components tofunction properly. There are numerous components that the MindManager X5 Pro setup programinstalls and registers. Without these components and proper registry settings on the user'smachine, MindManager X5 Pro will not run. Therefore, Mindjet does not support installingMindManager X5 Pro on a shared network drive and having users run it directly from there(without actually installing the program on each user's machine).

2 The Admin SetupMindjet offers a special MindManager X5 Pro admin setup program (available on CD or from theMindjet web site at http://www.mindjet.com/) that gives systems administrators more control overan installation.

The admin setup is distributed in a .zip archive file named, for example:

MindManager X5.2.324 Pro ENG Admin.zip

that contains the files:

MindManager X5 Pro Admin.msiisscript8.msiinstmsiW.exe

The "MindManager X5 Pro Admin.msi" file is the Microsoft installer script for the MindManager X5program. The isscript8.msi file is the InstallShield scripting engine (version 8). The instmsiW.exefile is the Microsoft Windows Installer setup program.

In this section, you can read about:

2.1 Differences Between the Standard and Admin Setups2.2 Running the Admin Setup – The Essentials

2.2.1 Setup Command-Line Options2.2.2 Sample Setup Commands



2.2.3 Installing Library Files to a Network Folder to Reduce Hard Disk Footprint, InstallationTime2.2.4 Separate Tutorials Setup2.2.5 Other Utility Software Used By MindManager

2.3 What the Setup Does – A General Overview2.3.1 The Two Phases of Setup: Machine and User2.3.2 Components2.3.3 Installed Files and Folders, Registry Keys, Shortcuts and Menu Items2.3.4 Required Permissions and Privileges

End-users should not use the admin setup; it should only be used by professional systemadministrators for deployment of MindManager X5 Pro to a significant number of workstations. Inorder to ensure proper setup operation, a number of preconditions must be met and the personinstalling the setup should be familiar with the Windows installer technology.

2.1 Differences Between the Standard and AdminSetupsThe MindManager X5 Pro admin setup is based on the standard setup with a number ofimportant differences:

• Caching: The admin setup will not cache the setup on the computer where it is beinginstalled. Instead the setup should be run from a network location that will continue to beaccessible from the workstation at all times. This will ensure proper operation of theModify, Repair and Remove entries in the “Add/Remove programs” Control Panel appletand avoid duplication of the installation source on every system where MindManager X5Pro is installed.

• SOAP: The SOAP merge module is not included in the admin setup. This particularmerge module installs a Microsoft hotfix “without asking”. Therefore, the installation of thehotfix is very unpopular among system administrators and hence we don’t include thismodule at all with MindManager X5 Pro admin setup. More information about the SOAPToolkit is available on the Microsoft web site:http://msdn.microsoft.com/webservices/building/soaptk/

• Patching: Admin setups are only delivered as full setups, not patch setups. The reasonfor this is that system administrators might modify the admin setup to suit the needs oftheir individual company. If the installation database is transformed in this way, a futureMindManager X5 Pro patch will not be able to properly update the installation. We avoidthis problem by not delivering patch updates at all for our admin setups.

• Packaging: Since we are delivering the admin setup to system administrators and ITprofessionals, we can exclude a number of components that we normally include with thesetup. Specifically we can exclude the Windows installer engine.

• User Data: The admin setup (as well as the standard setup) includes extra user dataoptions for the administrator to specify the location where user data will be put. There isalso an option to have MindManager X5 Pro extract the user data (as usual) or to havethe administrator set this up "manually" ahead of time. This is described in more detail in2.2.3 Installing Library Files to a Network Folder.

http://msdn.microsoft.com/webservices/building/soaptk/


2.2 Running the Admin Setup – The EssentialsThis section describes the essential information a system administrator needs to run theMindManager X5 setup and install the program as desired for their users.

For more a more in-depth look at what the MindManager setup program actually does, pleasesee 2.3 What the Setup Does – A General Overview.

2.2.1 Setup Command-Line Options

The general syntax and command line options for the Microsoft installer can be found in theMicrosoft documentation at:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/command_line_options.asp

The MindManager admin setup supports a number of public properties whose values can be setwith command-line options. These properties are:

Parameter Description of Values

INSTALLDIR Specifies where the program should be installed. For example:

"C:\Program Files\Mindjet\MindManager 5"

EULA_REGION Specifies the license agreement to install. The allowed values differbetween English and German setups:

English:

"1" = US

"2" = UK,

"3" = Europe

"4" = other country (installs EULA for US)

German:

"5" = German (only valid value for German setups)

Setting any other value than 5 in a German setup, or any other valuethan 1, 2, 3 or 4 for an English setup is an error.

ISX_SERIALNUM Specifies the license key for your MindManager X5 Pro installation.Note: No validation is performed for this key, it is simply written to theregistry. If the license key is not valid, MindManager X5 Pro will run in arestricted (trial) mode.

USERNAME Specifies the User Name that will be used to register MindManager.This is an optional parameter; the Windows User Name will be used ifthis parameter is not supplied.

COMPANYNAME Specifies the Company Name that will be used to registerMindManager. This is an optional parameter; the Windows CompanyName will be used if this parameter is not supplied.

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/command_line_options.asp


2.2.2 Sample Setup Commands

Below are some sample command lines to demonstrate various uses of the admin setup.

2.2.2.1 Simple Install

This command simply runs the installer in the usual interactive mode.

Msiexec.exe /i "MindManager X5 Pro Admin.msi"

The same effect can be achieved by simply opening (running) the "MindManager X5 ProAdmin.msi" file from Windows Explorer.

2.2.2.2 Silent Install

This command silently runs the installer, supplying values for all required parameters.

Msiexec.exe /i "MindManager X5 Pro Admin.msi" /qn INSTALLDIR="C:\ProgramFiles\Mindjet\MindManager 5" EULA_REGION="1" ISX_SERIALNUM="MP5M-MM1-xxxx-xxxx-xxxx" USERNAME=”John Doe” COMPANYNAME=”Acme, Inc.”

Note that the "xxxx-xxxx-xxxx" portion of the license key must be replaced with a valid key.

2.2.2.3 Uninstall

This command uninstalls the program.

Msiexec.exe /x "MindManager X5 Pro Admin.msi"

2.2.3 Installing Library Files to a Network Folder to Reduce HardDisk Footprint, Installation Time

MindManager installs a "Library" folder containing sub-folders of:

• Background images• Icons• Clip art images• Map parts• Shapes• Styles• Templates• Web export templates

amounting to 15 MB or more of data files.

Typically, these files are stored on a per-user basis in a user's Documents and Settings sub-folder such as:

C:\Documents and Settings\UserName\Local Settings\ApplicationData\Mindjet\MindManager\5\Library\ENU

where UserName is the current user's logon name. However, administrators may want to storethese libraries in a network folder for various reasons including to:

• Save space on users' systems

• Decrease the time required to run the program the first time


• Allow roaming users access to their customized libraries

• Assure that all users have a fixed, easily updatable set of library files

To facilitate this, the MindManager admin setup program installer has an option to specify analternate location for these library files.

Depending on your organization's usage of MindManager X5 Pro, these files can be installedonce to a common location (perhaps in a read-only folder) and shared by multiple users or by thesame user if they use MindManager on multiple machines. MindManager X5 Pro is designed sothat an advanced user can open, modify and save these kinds of files from other folders (withread-write privileges) if the user really needs to edit these kinds of files.

2.2.3.1 Using the Interactive "Deploy user data files" Dialog

The "Deploy user data files" dialog (below) can be accessed during an interactive setup bychoosing the "Custom" "Setup Type", pressing "Next" and then "Advanced…" in the "CustomSetup" dialog. (A non-interactive option is described later.)

The "Deploy user data files" dialog

To use this dialog from the interactive setup:

1. Select "Deploy user data on server" to customize the installation of user data files.

2. To set the "Server base path", select the Browse button and navigate to the folder wherethe user data should be stored (e.g. "N:\User Data\All Users\Mindjet\MindManager\5").You must create this folder before you can browse to it.

Note for Windows NT 4 users: NT 4 does not support the "Browse for Folder" dialogthat is supplied with Windows 2000 and XP. Therefore, the Browse button in the "Deploy


user data files" dialog will not work on NT 4. Instead, please use the registry settingsdescribed below to achieve the same effect.

Important note for all users: There is a known issue that "Server base path:" edit box isnot immediately updated after selecting a folder with the Browse button. You can see thepath that will be used by pressing the Preview Path button. Also, pressing the Cancelbutton when browsing for a folder will erase the current folder setting (even though theprevious path is displayed in the "Server base path:" edit box). So the basic rule is just"browse for a path and press OK". We apologize for any confusion this causes.

3. Check "Extract user data to the server path the first time MindManager X5 Pro starts" ifthe data files should be extracted when the user runs the program for the first time. Thisis the usual way to install the Library files.

Leave this unchecked if you have already set up the data files for the user. This will savetime when the user starts up since the per-user Library files do not have to be unpackedand installed to the target folder. It also gives you the chance to make these files andfolders read-only, if desired. Please note that if you uncheck the “Extract user data…”option, then you must make sure that the library files are actually in the specifiedlocation before any user installations are done. Typically, the administrator will installone copy of MindManager “manually” with “Extract user data” checked to get the userdata files in the desired location.

4. (Optional) Check "Use separate folders per user" if you want to install data on a per-userbasis. Checking this option adds "\%USERNAME%" to the server base path (e.g."N:\User Data\%USERNAME%") where %USERNAME% is replaced by the actuallogged on user name when the installer is run.

If you check this option, you may want to use "Append sub-path (optional)" to add atrailing path to the overall path. For example, if you set the sub-path to"Mindjet\MindManager\5", then the full path might be " N:\UserData\%USERNAME%\Mindjet\MindManager\5".

You can use the "Preview Path" button to see the complete path that will be used.

2.2.3.2 Using Registry Settings Instead of the "Deploy user data files"Dialog

The same options available in the "Deploy user data files" dialog of the installer can be usedduring a silent (non-interactive) installation by setting some registry values on the user's systemin the registry key before running the installer:

HKEY_LOCAL_MACHINE\Software\Mindjet\MindManager\5\Installer

The table below describes the various values (LSD stands for "Large-Scale Deployment):


Registry Value Data Value

LSDLocalOrNetwork 0 = Deploy user data on server1 = Install user data files on local disk

LSDUserDataPath See "Server base path", above

Examples: N:\User Data\All Users\Mindjet\MindManager\5or N:\User Data (if LSDUserDataPerUser is set to 1)

LSDUserDataExtract 0 = Do not extract user data files1 = Extract user data files

LSDUserDataPerUser 0 = Do not use separate folders per user1 = Do use separate folders per user

LSDUserDataPathSuffix See "Append sub-path", above

Example: Mindjet\MindManager\5

Only applies if LSDUserDataPerUser is set to 1

For example, if you want to share one set of read-only Library files for your whole organization,you might create a registry file named "MindManager Large-Scale Deployment Options.reg" likethis:

REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet]

[HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager]

[HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5]

[HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5\Installer]"LSDLocalOrNetwork"=dword:00000000"LSDUserDataPath"="N:\\User Data\\All Users\\Mindjet\\MindManager 5""LSDUserDataExtract"=dword:00000000"LSDUserDataPerUser"=dword:00000000"LSDUserDataPathSuffix"=""

Then create a batch file like this:

regedit /s "MindManager Large-Scale Deployment Options.reg"

Msiexec.exe /i "MindManager X5 Pro Admin.msi" /qn INSTALLDIR="C:\ProgramFiles\Mindjet\MindManager 5" EULA_REGION="1" ISX_SERIALNUM="MP5M-MM1-xxxx-xxxx-xxxx"

to do the installation on each user's system.


Note that, for the above to work, the folder "N:\User Data\All Users\Mindjet\MindManager5" must already exist and contain the MindManager "Library" sub-folder. The typical way toachieve this is to run the MindManager installer once interactively being sure to check the"Extract user data to the server path the first time MindManager X5 Pro starts" option and thenrunning MindManager one time (as the administrator) to install the library files in the desiredlocation.

Also, in the above example, "xxxx-xxxx-xxxx" must be replaced with a valid license key.

2.2.4 Separate Tutorials Setup

To keep the overall MindManager X5 setup program size down, the setup programs do notinclude all the on-screen tutorials (viewlets) that are accessible via the Learning Center taskpane. If the user clicks to view a tutorial and it is not available locally, it is copied via the Internetfrom the Mindjet web site to a sub-folder of the MindManager program folder. However, in someorganizations this is not possible or desirable because of restricted Internet access or becausethe program folder is marked as read-only for users.

To avoid the downloading of MindManager tutorials, we recommend that organizations use theTutorial installer (currently about 17 MB in size):

mmx5tutorials.exe

that can be found either on the MindManager CD or for download from the Mindjet web site. Thetutorials should be installed right after the program is installed.

2.2.5 Other Utility Software Used By MindManager

MindManager uses a few other utility programs that are usually already installed on mostsystems. However, if they are not on your systems, you may want to install them for use withMindManager.

2.2.5.1 Macromedia Flash Player

The Macromedia Flash Player is used by the MindManager Tutorials accessed via the LearningCenter task pane. The reader is automatically installed whenever a tutorial is run. However, thiswill not work for restricted users without administrative rights. Instead, they will see the followingdialog about a missing SWFLASH5.OCX:

To avoid this problem, the administrator should either:

1. Start up a MindManager tutorial file after installing MindManager. For example, run:

C:\Program Files\Mindjet\MindManager 5\ENG\building_a_map.exe

from Windows Explorer after installing MindManager. Note that the "ENG" in the pathname is for the English version of MindManager. Other language users would navigate tothe appropriate folder for their language (e.g. "GER" for German).


or

2. Install Flash on the system. See the Macromedia website at http://www.macromedia.com/for more details.

2.2.5.2 Adobe Reader

MindManager has the ability to print a map as a PDF file. After the file is saved, it can be viewedif an appropriate reader is available on the system. If system does not have a reader installed,you can download one free from Adobe at http://www.adobe.com/.

2.3 What the Setup Does – A General OverviewThis section gives a general overview of what the setup program does. This will help systemsadministrators get a better feeling of what goes on during setup and how the setup might need tobe tailored for special circumstances.

2.3.1 The Two Phases of Setup: Machine and User

There are two phases to the MindManager X5 setup:

1. Per-Machine Setup (done once on each machine)

2. Per-User Setup (done once each time a new user starts the program on a givenmachine)

These are described in more detail below.

2.3.1.1 Per-Machine Setup

The MindManager X5 setup program is really the "per-machine setup program". It installs theprogram on the machine and only sets per-machine registry settings in theHKEY_LOCAL_MACHINE and HKEY_CLASSES_ROOT registry keys. It does not directly createor set any registry keys or values in the HKEY_CURRENT_USER registry key.

The MindManager X5 installer typically installs all program files to the program folder (e.g."C:\Program Files\Mindjet\MindManager 5").

Administrator privileges are required to install any Windows software, including MindManager X5.

See 2.3.3 Installed Files and Folders, Registry Keys, Shortcuts and Menu Items for more detailsabout what is installed on a per-machine basis.

2.3.1.2 Per-User Setup

Whenever MindManager is run, it checks to see if the current user has ever run this version ofMindManager before and if any per-user files need to be installed. This is described in more detailbelow.

Each time MindManager is run, it checks the file UserData.ini, typically located in:

C:\Documents and Settings\UserName\Local Settings\ApplicationData\Mindjet\MindManager\5

http://www.macromedia.com/

http://www.adobe.com/.


to see if a per-user setup needs to be done. If this file is missing or if the version of MindManagerinstalled is newer than the version the user last ran, then MindManager prepares for a "new" per-user installation by deleting the following registry key:

HKEY_CURRENT_USER\Software\Mindjet\MindManager\5\User Interface

Each time MindManager is run, it detects if the per-user application data files (outline printtemplates and spell check auto-correct dictionaries) are present. If not, it copies them from an "AllUsers" folder, typically:

C:\Documents and Settings\All Users\Application Data\Mindjet\MindManager\5

Finally, MindManager determines if the per-user Library files need to be installed using the sameUserData.ini algorithm described above and checking that the LSDUserDataExtract registrysetting is not set to 0. If so, then a separate background task/program is run to unzip the libraryfiles from a MindManager sub-folder, for example:

C:\Program Files\Mindjet\MindManager 5\sys\ENU

See 2.3.3 Installed Files and Folders, Registry Keys, Shortcuts and Menu Items for more detailsabout what is installed on a per-user basis.

2.3.2 Components

The MindManager program is comprised of a variety of installable components. Each componentis described below.

Some components are required; others are optional. When you drop down the menu for acomponent, you will see a menu similar to the following (not all choices will be available for allcomponents):


2.3.2.1 Program

The Program component installs the MindManager program and all core files and DLLs. It is arequired component.

2.3.2.2 Library

The Library component consists of two sub-components: Images and Template Organizer. Theseare optional but highly recommended components. Images are a library of pictures used to helpmake maps more memorable. The Template Organizer contains a variety of map templates, webtemplates etc. to help create good looking maps and output more quickly. You might not installthese components to save space.

2.3.2.3 Dictionaries

The Dictionaries component contains all the spell check dictionaries available for MindManager.Some dictionaries are required and some are optional. You might choose to install some of theoptional dictionaries if they are appropriate for your organization.

2.3.2.4 PDF Writer

The PDF Writer component allows users to export (print) maps as PDF files from MindManager(but not other programs). This is an optional component. You might choose not to install it if youhave another PDF driver already installed or don't wish to create PDF files.

2.3.2.5 TabletOS

The TabletOS component is only needed when MindManager is installed on a Tablet PC (whereit is installed by default). Installing this component on a non-Tablet PC will not give it Tablet PCcapabilities.

2.3.2.6 SOAP

The SOAP component installs the SOAP toolkit used to add XML Web Service functionality foruse with some Smart Map Parts. If this is not installed, then the RSS News Feed Smart MapParts (and possibly other third-party Smart Map Parts) will not function. However, other SmartMap Parts will operate correctly. For more information about a possible problem with the SOAPmodule, please see 2.1 Differences Between the Standard and Admin Setups.

2.3.2.7 NonTabletOS

The NonTabletOS component is only needed when MindManager is installed on a non-Tablet PC(where it is installed by default). It contains the GDI+ library along with Ink support libraries fornon-Tablet PCs.


2.3.2.8 Tutorials

The Tutorials component is an optional component that contains some (but not all) of theanimated tutorials referenced in the Learning Center Task Pane in MindManager. You might notinstall this component to save disk space (especially for experienced users). For moreinformation, please see 2.2.4 Separate Tutorials Setup.

2.3.3 Installed Files and Folders, Registry Keys, Shortcuts andMenu Items

The MindManager X5 setup creates files and folders, registry keys and shortcuts and menu itemsin the standard suggested Windows locations.

2.3.3.1 Files and Folders

In general, when the MindManager X5 setup program runs, it installs files in the per-machineMindManager X5 Program Files folder, for example:

C:\Program Files\Mindjet\MindManager 5

These are all the files that are needed on a per-machine basis including MindManager.exe andthe MindManager add-in DLLs. No per-user files are stored in this folder.

If MindManager X5 requires certain system components that are not already installed, they will beinstalled in the location dictated by their Microsoft merge module. This table summarizes thesemodules and where certain files might be installed on a "clean" system. These files might beinstalled in different locations on different versions of Windows; this is not controlled by theMindManager installer.

System Component Folders¹ and Files

Tablet PC and ink related files %CommonProgramFiles%\MicrosoftShared\Ink

• InkObj.dll• tpcps.dll• PIPanel.dll• PIPanel.exe*• GdiPlus.dll

%WINDIR%\system32• InkEd.dll• PipRes.dll*• wisptis.dll*

* Only installed on Tablet PC

SOAP library files %CommonProgramFiles%\MSSoap\Binaries• MSSOAP30.dll• SOAPIS30.dll• WHSC30.dll• WISC30.dll


• Resources\LanguageID\MSSOAPR3.dll

%SystemDrive%\Binaries• _svdir.VBS• SOAPVDIR.CMD

XML related files %WINDIR%\system32• msxml4.dll• msxml4r.dll

C++ runtime libraries %WINDIR%\system32\Redist\MS• msvcp60.dll• msvcrt.dll

¹ Environment variable names (e.g. "%CommonProgramFiles%") are expanded to their actualvalues (e.g. "C:\Programs Files\Common") by the installer.

The first time a given user runs MindManager X5, any per-user files are copied or created in theMindManager X5 per-user Local Settings folder, for example:

C:\Documents and Settings\UserName\Local Settings\ApplicationData\Mindjet\MindManager\5

where UserName is the currently logged on user name. Examples of files and folders put in thisfolder include:

• The AutoRecovery folder with recoverable copies of maps used in the event of aprogram or system crash.

• Libraries of images, templates, etc. that can be customized or added to by the user.

• Spell check auto-correct files that can be modified and added to by the user.

The first time a given user starts MindManager X5, the application also searches to see if aMicrosoft Office custom dictionary exists for that user (e.g. "C:\Documents andSettings\UserName\Application Data\Microsoft\Proof\CUSTOM.DIC"). If the user-specificMicrosoft Office custom dictionary is found, a reference to that dictionary is added to the list ofspelling dictionaries used by MindManager X5.

Note: In versions of MindManager X5 prior to Service Pack 2, some files were stored in theroaming per-user Application Settings folder (e.g. "C:\Documents andSettings\UserName\Application Data\Mindjet\MindManager\5"). MindManager X5 Service Pack 3(SP3) no longer uses this folder.

Following the Windows guidelines, MindManager X5 assumes that users will store their maps in a"My Maps" sub-folder of their "My Documents" folder, for example:

C:\Documents and Settings\UserName\My Documents\My Maps

2.3.3.2 Registry Keys

When the MindManager X5 setup program runs, it places any per-machine MindManager X5registry settings in or below the key:

HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5

These are the settings used by MindManager and its add-ins on a per-machine basis. No per-user values are stored in this key.

Following the Windows guidelines, MindManager registers its associated file types, COM objectsetc. in sub-keys of HKEY_CLASSES_ROOT. This includes the following keys:


HKEY_CLASSES_ROOT\.mmap

HKEY_CLASSES_ROOT\Mindjet.MindManager.Document.5

HKEY_CLASSES_ROOT\.mmas

HKEY_CLASSES_ROOT\Mindjet.MindManager.Style.5

HKEY_CLASSES_ROOT\.mmat

HKEY_CLASSES_ROOT\Mindjet.MindManager.Document.Template.5HKEY_CLASSES_ROOT\.mmbas

HKEY_CLASSES_ROOT\Mindjet.MindManager.Macro.5

HKEY_CLASSES_ROOT\.mmmp

HKEY_CLASSES_ROOT\Mindjet.MindManager.MapPart.5

HKEY_CLASSES_ROOT\.mmms

HKEY_CLASSES_ROOT\Mindjet.MindManager.MapMarkerSet.5

HKEY_CLASSES_ROOT\Mindjet.Mm5GenericSmartMapPart.AddIn

HKEY_CLASSES_ROOT\Mindjet.Mm5Numbering.AddIn

HKEY_CLASSES_ROOT\Mindjet.Mm5Outlook.AddIn

HKEY_CLASSES_ROOT\Mindjet.Mm5OutlookLinker.AddIn

HKEY_CLASSES_ROOT\Mindjet.Mm5PPExport.AddIn

HKEY_CLASSES_ROOT\Mindjet.Mm5Project.AddInHKEY_CLASSES_ROOT\Mindjet.Mm5Sort.AddIn

HKEY_CLASSES_ROOT\Mindjet.Mm5WebExport.AddIn

HKEY_CLASSES_ROOT\Mindjet.Mm5Word.AddIn

Uninstall information for the program is stored in a sub-key of:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall

The name of the sub-key is the Globally Unique Identifier (GUID) for the program (which changeswith each release). If necessary, you can find it by using the RegEdit utility to search for"MindManager" in the Uninstall key.

When a given user runs MindManager X5, any per-user registry settings are stored in or belowthe key:

HKEY_CURRENT_USER\Software\Mindjet\MindManager\5

The sub-keys and values in this key are too numerous to document. Most are self-explanatoryand are accessible via the MindManager user interface.

2.3.3.3 Shortcuts and Start Menu Items

The MindManager X5 installer puts a shortcut to the program on the Windows Desktop, WindowsSend To menu and in the main Start menu and creates a "MindManager X5" folder in the Start ->Programs folder with a shortcut to MindManager in it.

The MindManager X5 shortcut is an "advertised shortcut" to the MindManager program thatautomatically checks to see if the program needs to be repaired before it is run. If a repair isneeded, it is done before the program is run. Otherwise, the program runs directly.


This self-repairing feature depends on a cached version of the setup program (standard setup) orthe original setup program (admin setup) being accessible when the program is run.

If for some reason, you do not want to use this self-repairing feature, you can create a shortcutdirectly to the MindManager.exe file and use that instead.

2.3.4 Required Permissions and Privileges

Administrator privileges are required to install any Windows software including MindManager X5.

No special privileges or disk permissions are required to run the MindManager X5 program. Theprogram can be run as a restricted user, "normal" user, power user or administrator. The programdoes assume that it has read/write/create privileges in the HKEY_CURRENT_USER registry keyas well as the user profile section of the hard disk (e.g. "C:\Documents and Settings\UserName")and below.

If a user does not have write privileges in the HKEY_LOCAL_MACHINE registry key, then:

• The Help -> Check for Updates command is removed for that user. Then ensures thatthey won't try to perform an upgrade that they are not authorized to do.

• MindManager will not repair any broken registry file associations and other local machineregistration settings on startup.

3 Windows Terminal ServerInstallationMindManager X5 can be installed on a Windows Terminal Server (WTS) machine and then usedby a variety of client machines. To do this, you need:

• MindManager X5 Pro SP3 or later

• Windows 2003 Server running Windows Terminal Services

• Remote Desktop Connection clients running in 16-bit color (full-color) mode or greater

MindManager X5 Pro runs in full color mode and does not support 256-color mode. Therefore wehighly recommend that terminal server clients be run in full color mode as well.

In many ways, installing MindManager on a Windows Terminal Server is similar to installing it ona desktop machine. Therefore, before you get started, you may want to read these sections ofthis document (if you haven't already):

• 2 The Admin Setup

• 2.2.3 Installing Library Files to a Network Folder to Reduce Hard Disk Footprint,Installation Time

• 2.2.4 Separate Tutorials Setup (important!)

• 2.2.5 Other Utility Software Used By MindManager (important!)

• 4.5 License Management


3.1 Windows Server 2003Here are the basic instructions to install MindManager X5 on a Windows Server 2003 runningWindows Terminal Services (WTS):

1. Log on to the Windows Terminal Server as an administrator.

2. Make sure the standard MindManager setup program (e.g. “MMX52-E-324.exe”) issomewhere accessible to the server machine.

3. Start the Add/Remove Programs applet in the Windows Control Panel (Start -> Settings -> Control Panel -> Add/Remove Programs).

(Do not run the installer directly from Windows Explorer unless you are familiar with usingthe "change user /install" and "change user /execute" commands.)

4. Select “Add New Programs” and then “CD or Floppy”. Follow the instructions on-screen.The automatic procedure will not find the MindManager setup program. When you seethe “Run Installation Program” dialog, select the “Browse” button. In the Browse dialog:

a. Change “Files of type” from “Setup Programs” to “Programs” to see all the .exe files b. Navigate to the location of the MindManager installer, select it and press Open. c. Press Next to start the installer.

5. When the MindManager installer runs, follow the instructions on-screen.

A. In the Customer Information step:

1. Leave the User Name field blank or chose a "generic" name. The user cancustomize this in MindManager if desired.

2. Enter an Organization name.

3. Enter your MindManager license key. Please remember you must purchase enoughlicenses for all your users even though you only enter one key here. If you wish to useper-user license key management, please see 4.5.1 Per-User vs. Per-Machine LicenseKey Administration.

B. In the Setup Type step, you can choose the Complete or Custom choice as desired.

(Choose the Custom choice to install the Library files only once per machine, forexample. See 2.2.3 Installing Library Files to a Network Folder to Reduce Hard DiskFootprint, Installation Time for more details. For a WTS installation, you can install thelibrary to a folder on the server itself that is accessible to all users such as "C:\Documentsand Settings\All Users\Local Settings\Application Data\Mindjet\MindManager\5". Youhave to create this folder before you browse to it in the Advanced dialog.)

C. Select the Install button.

There may be a slight delay before the installer appears. You can complete theinstallation with the standard settings or customize them as desired. Once the installationis done and the "InstallShield Wizard Completed" message is displayed, press the Finishbutton.

6. Once the MindManager installer is done, the Windows "After Installation" dialog willappear. Press the Next button to get to the Finish Admin Install. Finally press the Finishbutton to complete the installation.


Users can now run MindManager on the server using the Windows Remote DesktopConnection client program.

Information about any known issues running MindManager X5 Pro on a Windows TerminalServer machine will be posted in the Mindjet Knowledge Base Article titled Known IssuesRunning MindManager X5 Pro on a Windows Terminal Server or Citrix MetaFrame PresentationServer at http://www.mindjet.com/support_engl/question.php?qstId=230.

3.2 Windows 2000 ServerWindows 2000 Server Terminal Services is not considered a supported platform. It does notsupport full color mode clients and it may have other installation and deployment issues.Therefore we do not recommend its use. However, our informal testing on this platform showsthat it is possible to install and run the program if desired by following the instructions for theWindows Server 2003, above. Further information, if any, will be posted in the Mindjet KnowledgeBase Article titled Installing MindManager X5 Pro on a Windows 2000 Terminal Server athttp://www.mindjet.com/support_engl/question.php?qstId=206.

3.3 Citrix MetaFrame Presentation ServerThe Citrix MetaFrame Presentation Server is a sophisticated terminal server environment built ontop of the Windows Terminal Services provided by Windows Server. The instructions below applyto Windows Server 2003 and Citrix MetaFrame Presentation Server 3.0. This is currently the onlytested and supported Citrix platform for MindManager (although other combinations may work).

3.3.1 Basic Installation for Use with the Citrix Desktop

The basic instructions for installing MindManager on a Citrix MetaFrame Presentation Server arethe same as those described in 3.1 Windows Server 2003. You might consider installingMindManager to a non-system drive (i.e. something other than the C: drive) for better Citrixperformance.

Once you are done with this installation, MindManager appears as part of the Citrix Desktop – asingle window containing icons for all the published applications.

3.3.2 Advanced Installation of a "Seamless" Window

To install MindManager as a "seamless" individual application window published to Citrix clients(as opposed to part of the Citrix Desktop, described above), you must:

1. Follow the basic instructions for installing MindManager on a Terminal Server asdescribed in 3.1 Windows Server 2003. You might consider installing MindManager to anon-system drive (i.e. something other than the C: drive) for better Citrix performance.

2. Select the Presentation Server Console button from the Citrix toolbar and log on tothe server:

http://www.mindjet.com/support_engl/question.php?qstId=230.




3. In the Management Console tree on the left-hand pane, right-click on the Applicationsitem

and choose Publish Application to see the Application Publishing Wizard. Enter the nameand description of the application:


4. Specify what to publish:


5. Set the Program Neighborhood Settings to determine where the program shortcut will bepublished on client systems.


6. Set the Application Appearance options. Making the Session Window Size a percentageof the client desktop size is often desirable. You should set Colors to either "High Color(16 bit)" or "True Color (24 bit)" for the proper appearance of MindManager. While the"256 colors" setting will reduce the bandwidth requirement of the application, it will notdisplay MindManager's high-quality graphics – an important aspect of this visual program.


7. Specify any special client requirements. The default settings work fine for MindManager.


8. Specify the number of MindManager licenses you have purchased in the "Maximuminstances" field of the Application Limits page. Note that while MindManager only allowsone instance of the program per user per machine, in a Citrix environment a single usercould run MindManager on various servers. Check the "Allow only one instace ofapplication for each user" box to avoid this, if desired.


9. Specify what servers offer MindManager.


10. Specify who is allowed to use the program. We strongly recommend doing this by group,not by user, for ease of administration when adding users to a group.


11. You can leave the File Type Associations page empty or customize it if desired.MindManager is already registered to open its own files (e.g. .mmap files) on the server.

Once you are done, you should see the MindManager application in the Applications section:


In addition, the MindManager icon will now appear in authorized users' Citrix ProgramNeighborhood (and on their Desktop and Start menu if those options were chosen).

For more configuration options, please consult your Citrix documentation.

Information about any known issues running MindManager X5 Pro on a Citrix Presentation Servermachine will be posted in the Mindjet Knowledge Base Article titled Known Issues RunningMindManager X5 Pro on a Windows Terminal Server or Citrix MetaFrame Presentation Server athttp://www.mindjet.com/support_engl/question.php?qstId=230.

4 Other Systems AdministratorTopicsIn this section, you can read about other topics of interest to systems administrators including:

4.1 Administrative Registry Settings4.1.1 HKEY_LOCAL_MACHINE Settings4.1.2 HKEY_CURRENT_USER Settings

4.2 Add-In Registration4.2.1 Registering or Unregistering Add-Ins4.2.2 Disabling or Removing Add-Ins

4.3 Event Macros4.4 Policies Support4.5 License Management


4.1 Administrative Registry SettingsMindManager X5 Pro supports registry settings to make it easier for system administrators tocontrol the MindManager environment presented to their users. Most MindManager X5 Proregistry settings can be set via the MindManager X5 Pro user interface. Listed below are all theregistry settings relevant to Large-Scale Deployment that are not available from the MindManagerX5 Pro user interface. See also the user data options, which can also be set via registry settings.



4.1.1 HKEY_LOCAL_MACHINE Settings

The following MindManager X5 registry settings are used on a per-machine basis in values underthe key

HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5\Registration

in the registry:

Value Name Type Value Data

ShowLicense REG_DWORD 0 to not show the MindManager user the license key being usedor allow it to be changed.

1 to show the license key.

ChangeLicense REG_DWORD 0 to not allow the user to change the MindManager license keybeing used.

1 to allow the license key to be changed.

The following MindManager X5 registry settings are used on a per-machine basis in values underthe key

HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5\Settings

in the registry:


LocalUserDataDirectory REG_SZ Path to copy user data files (e.g. Image Library files, etc.)to when a new user first starts MindManager. May containenvironment variables. For example:

N:\UserData\%USERNAME%\MindManager 5

If no path is specified, then:

%USERPROFILE%\Local Settings\ApplicationData\MindManager\5

is assumed.

This setting can be overridden by the same setting inHKEY_CURRENT_USER (see below) or by theLSDUserDataPath setting described earlier.

PerUserInstallation DWORD 0 for per-machine license key management.

1 for per-user license key management.

For information about this setting, please see 4.5.1 Per-User vs. Per-Machine Licens.

4.1.2 HKEY_CURRENT_USER Settings

The following MindManager X5 registry settings are used on a per-user basis in values under thekey

HKEY_CURRENT_USER\SOFTWARE\Mindjet\MindManager\5\Settings


in the registry:


AllowUpdateCheck REG_DWORD 0 to hide the Help, Check for Updates command.

1 to show this command.

2 to show this command only if the user has writeprivileges to HKEY_LOCAL_MACHINE (default)

DisableAnimation REG_DWORD 0 to allow animation of maps for smoother scrolling butmore graphics intensive.

1 to disable animation of maps for one-jump scrollingwhich is less graphics intensive and perhaps moredesirable in a low-bandwidth Windows TerminalServer environment.

LocalUserDataDirectory REG_SZ Path to copy user data files (e.g. Image Library files,etc.) to when a new user first starts MindManager.May contain environment variables. For example:

N:\UserData\%USERNAME%\MindManager 5

If no path is specified, then:

%USERPROFILE%\Local Settings\ApplicationData\MindManager\5

is assumed.

This setting can be overridden by theLSDUserDataPath setting described earlier.

4.2 Add-In RegistrationMindManager uses a number of add-in DLLs to implement certain features such as integrationwith Microsoft Word, Outlook and Project. The add-ins are automatically registered whenMindManager is installed. On startup, the add-ins check for any other required resources (e.g. thesupported version(s) of Microsoft Word) and will enable or disable themselves automatically asappropriate. If an add-in fails to start, it is automatically removed from the MindManager list ofadd-ins (but not from disk).

This section describes how to manually register, unregister, enable or disable add-ins if theautomatic behavior needs to be modified.

4.2.1 Registering or Unregistering Add-Ins

You can unregister an add-in to make it completely "invisible" to MindManager by running the "regsvr32"command with the "/u" switch. For example, to unregister the MindManager Word add-in, click on Start ->Run and then enter the command:

regsvr32 /u "C:\Program Files\Mindjet\MindManager 5\Mm5Word.dll"

To restore a removed (unregistered) add-in, run the regsvr32 command. For example:

regsvr32 "C:\Program Files\Mindjet\MindManager 5\Mm5Word.dll"


4.2.2 Disabling or Removing Add-Ins

Users can enable and disable add-ins via the MindManager Tools -> Add-Ins command.However, if desired it is possible to disable or remove individual MindManager add-ins via theWindows Registry.

4.2.2.1 The Registry Add-In List

The list of add-ins that MindManager loads at startup is in the Registry at:

HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5\AddIns

where you find one subkey per add-in, for example:

4.2.2.2 How to Remove (or Restore) an Add-In

To remove a MindManager add-in (i.e. make it "invisible" to MindManager) delete its registrysubkey. For example, to remove the Word add-in, delete the key:

HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5\AddIns\Mindjet.Mm5Word.AddIn.1

This makes the add-in "invisible" to MindManager so it will not be loaded on program startup and will not beseen in the list of add-ins in the Tools -> Add-Ins dialog. However, the add-in DLL files still exist on the harddrive along with MindManager.

Another way to remove an add-in is to unregister it as described in 4.2.1 Registering or UnregisteringAdd-Ins. That section also describes how to re-register an add-in to restore a deleted registry entry.

We do not recommend deleting the add-in's DLLs since they will be restored automatically the next time theprogram is run via its shortcut.


4.2.2.3 How to Disable (or Enable) an Add-In

Users can disable or enable a given add-in directly from MindManager via the Tools -> Add-Inscommand. Add-ins can also be disabled via the Windows Registry as described below.

There are two keys to consider when disabling an add-in for a given user:

HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5\AddIns\AddInName

HKEY_CURRENT_USER\SOFTWARE\Mindjet\MindManager\5\AddIns\AddInName

where AddInName is the actual name of the add-in (e.g. Mindjet.Mm5Word.AddIn.1).

When a given user starts MindManager, the program checks first in the HKEY_CURRENT_USERsubkey for a "LoadBehavior" value. If it exists, it is used.

If it does not exist, MindManager copies the LoadBehavior value from theHKEY_LOCAL_MACHINE subkey to the HKEY_CURRENT_USER subkey and then uses thatvalue.

Therefore, to disable an add-in for the current user, set the LoadBehavior value in theHKEY_CURRENT_USER subkey to 0.

To disable the add-in for all new users, set the LoadBehavior value in theHKEY_LOCAL_MACHINE subkey to 0. Note: This will have no effect on users that have alreadyrun MindManager at least once. For them you must set LoadBehavior in theHKEY_CURRENT_USER subkey.


Similarly, setting LoadBehavior to 2 enables the add-in again.

4.2.2.4 The MindManager Office Add-Ins

When MindManager is installed, it detects if certain Microsoft programs are available (e.g. Wordand Outlook) and registers some add-ins for them as well.

The location of this add-in registration in the Windows Registry depends on the application andthe add-in. For example, the MindManager add-in for Microsoft Word is registered on a per-machine basis (so all users of the machine will have it) at:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Word\Addins\Mindjet.Mm5Word.AddIn

Note that Word handles the Tools -> "COM Add-Ins" command and user interface differently thanMindManager. In Word, if an add-in is registered in HKEY_LOCAL_MACHINE (HKLM), then it isnot displayed in the COM Add-Ins dialog. If an add-in is registered in HKEY_CURRENT_USER(HKCU), it is displayed in the dialog and can be turned off and on. If the add-in is registered bothin HKLM and HKCU, Word ignores the HKCU entry and just uses the HKLM entry.

The registry data values for the Microsoft program add-ins are the same as described for theMindManager add-ins and can be edited in a similar fashion.

4.3 Event MacrosMindManager X5 Pro can trigger certain Event Macros that can help system administratorsmonitor the usage of the program more carefully. MindManager X5 Pro currently fires thefollowing macro events:

Event Name When Fired

OnApplicationStarted At the end of InitInstance, only when started in "normal"mode, not /RegServer, /UnregServer, etc.)

OnExpiredTrialStarted Just before the "Trial Expired" dialog

OnFirstUse Just before we install "per-user data"

OnBuyButtonPressed Just before the "Buy MindManager" dialog is displayed

When a macro event is fired, 0 or more macros are run. The mapping of macro event names tomacro filenames is determined on startup.

On startup, MindManager X5 Pro looks in the registry at

HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5

for a key named Event Macros. If it is found, we might expect to find keys such as these:

Event Macros\

OnApplicationStarted\

EventMacro_OnApplicationStarted.mmbas

EventMacro_OnApplicationStartedTwo.mmbas

Path="C:\Temp\EventMacro_OnApplicationStartedTwo.mmbas"

OnBuyButtonPressed\


EventMacro_OnBuyButtonPressed.mmbas

OnExpiredTrialStarted\

EventMacro_OnExpiredTrialStarted.mmbas

OnFirstUse\

EventMacro_OnFirstUse.mmbas

Each event key can have 0 or more macro key names.

Each macro key can have an optional "Path" value. If the "Path" value is not there, then the keyname is the path. If the path is a relative path (e.g. "EventMacro_OnApplicationStarted.mmbas"),it is converted to an absolute path relative to the default macro folder for the user (e.g."C:\Documents and Settings\UserName\Local Settings\ApplicationData\Mindjet\MindManager\5\macros").

If the "Event Macros" key is not in the registry, then MindManager looks for event macros in thedefault macro folder (see above) with a name of the form:

EventMacro_<EventName>.mmbas

For example:

EventMacro_OnApplicationStarted.mmbas

Therefore, it is possible to get macro events to run a macro simply by putting macros with theproper name in the user's macro folder. However, for most typical IT use, the "Event Macros" keywill be used since this can point to macros on some network drive, for example.

For example, this "EventMacro_OnApplicationStarted.mmbas" macro uses the Outlook objectmodel to send a notification email:

'#Uses "EventMacro_Utilities.mmbas"Sub Main SendNotificationEmail "MindManager event: Application Started"End Sub

Where the "EventMacro_Utilities.mmbas" file contains:

' Utilities for use with MindManager event macros

Public Sub SendNotificationEmail(eventString As String) ' Sends the subject string to the appropriate IT person ' to notify them of the MindManager event that just occurred

' Get access to our email program Dim outlookApp As Outlook.Application Set outlookApp = New Outlook.Application

' Create a message Dim message As Outlook.MailItem Set message = outlookApp.CreateItem(olMailItem) message.To = "System Administrator" message.Subject = eventString message.Body = eventString

' Send the message message.Send


End Sub

Please note that these macros are for demonstration purposes only. You will have to customizethese macros for your own network and email environment.

Note: Since the release of Outlook 2002, Microsoft added the Outlook Object Model Guard whichforces the display of a message box telling the user that some program is trying to send amessage via Outlook automation. The user must approve the send for it to go through. Thisbehavior can be controlled by Outlook system policies.

4.4 Policies SupportWindows Policies allow system administrators to control a portion of the registry on users'machines that cannot be edited by the users themselves. System administrators can then specifymandated settings, which are settings the user must abide by and cannot change in the registry.System administrators can also specify administrative defaults to allow default values forsettings that override the defaults that are built into a program. Users can save new registryvalues to override the "administrative default" settings if desired.

MindManager X5 Pro does not currently offer Windows Policies support.

4.5 License ManagementEach MindManager X5 Pro user must have a license to use the software. Please contact yourreseller or MindManager X5 Pro sales representative for licensing terms appropriate for Large-Scale Deployment. MindManager X5 Pro does not include any special support for proprietarythird-party license management software.


MindManager can be set up to check and administer license keys on either a per-user or per-machine basis. MindManager first looks for a license key in

HKEY_CURRENT_USER\SOFTWARE\Mindjet\MindManager\5\Registration\LicenseKey

and if one is not found, then it looks inHKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5\Registration\LicenseKey

The default MindManager installation administers license keys on a per-machine basis. A licensekey is entered when the program is installed on a machine and all users of that machine haveaccess to the program via that license key.

To achieve per-user license key administration for MindManager:

1. The program should be installed with no license key. The administrator should check the"Use per license management, instead of per machine license management" setting inthe Admin installer:


or set the registry key:

HKEY_LOCAL_MACHINE\SOFTWARE\Mindjet\MindManager\5\Settings\PerUserInstallation

to 1 after installation.

This setting instructs MindManager to save any license key the user enters in theprogram to the HKCU setting instead of the HKLM setting.

2. The administrator should put the user's license key in the user's HKCU registry setting,above, or communicate the user's license key to them and let the user enter the licensekey in the license key dialog that is automatically displayed when MindManager startswithout a license key.

Last Updated: 9/22/2004