* The following notes don't apply if you're downloading NServiceBus Studio from the Visual Studio 2010 Online Gallery using the Extension Manager or if you don't have Visual Studio 11 Beta installed.

NSB Studio is a Visual Studio 2010 extension distributed using the VSIX packaging standard format. This format allows you to install it by simply double clicking on the file, which will launch the VSIXInstaller.exe application included as part of Visual Studio.

However, if you have Visual Studio 11 Beta installed in your machine, the .vsix file extension is associated by default to the newer VSIXInstaller included as part of Visual Studio 11 Beta. Unfortunately there are some issues updating vsix files with the beta version of VSIXInstaller, and if you try to update NServiceBus Studio in the future, you might end up with some disabled extensions and conflicts.

To avoid this issue, you can either:

1) Always uninstall all the NServiceBus extensions before installing a new version.

In Visual Studio 2010 you can go to the Extension Manager, and uninstall the extensions that are part of NServiceBus Studio:

You should uninstall NServiceBusHost, WebEndpoint, WebMVCEndpoint, NServiceBus Modeling and NServiceBus Studio. A Visual Studio restart will be required.

Now you can install the vsix file for the new version by just double clicking the vsix file.

2) Always use the Visual Studio 2010 VSIXInstaller instead of the beta for installing NServiceBusStudio.vsix.

Instead of just double clicking on the file, you can right click on it, and select "Open with".

On Windows 7 you will get the following window:

Please press "Browse" and look for the Visual Studio 2010 VSIXInstaller.exe file. This file is typically located on "C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

On Windows 8 Consumer Preview, you will need to:

• Select "Choose default program..." and you will get a new window "How do you want to open this type of file (.vsix)?"
• Please press the "See all..." link at the bottom of the window to expand more options
• Scroll down until you find a new link "Look for an app on this PC"
• Press on that link and browse for VSIXInstaller.exe on the Visual Studio 10.0 folder. Typically located on "C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE

Please use this method for any further installation of new NServiceBus versions.